indexed_visibility_reads.v1.json (2862B)
1 { 2 "schema_version": 1, 3 "decision_id": "radroots.storage.indexed_visibility_reads.v1", 4 "status": "implemented_not_published", 5 "owners": ["radroots_storage", "radroots_storage_sqlite"], 6 "runtime_version": 20, 7 "immutable_runtime_prefix": "versions 1 through 19", 8 "authority": "immutable canonical signed events and the existing visibility reducer", 9 "current_state": { 10 "head_membership": "highest unsigned created_at, then lowest event_id; verified unsupported heads retain authority", 11 "head_update": "refresh the previous and new selected member only", 12 "deletion": "retain authorized immutable targets and refresh affected event or selected address keys through a durable bounded queue", 13 "status": "one cached header read; never evaluate or decode source history", 14 "ordinary_admission": "a ready index advances inside the canonical source transaction; unfinished derived work remains dirty", 15 "empty_source": "atomic empty ready header on fresh source-generation insertion", 16 "legacy": "forward20 resets derived preparation once, then uses existing bounded source backfill and changed-epoch replay", 17 "readiness": "source backfill, changed replay and affected deletion keys all complete at one source fence", 18 "incomplete": "VisibilityRebuilding; no stale state advertised current" 19 }, 20 "bounded_reads": { 21 "maximum_generic_page_rows": 1000, 22 "selected_keys": "limit plus one length-only indexed keys", 23 "all_events": "forced source-generation/visible/sequence index", 24 "event_ids": "forced source-generation/event-id index; existing maximum 256 ids", 25 "maximum_logical_bytes": 16777216, 26 "charge": "4096 + (limit + 1) * 128 + sum(signed_bytes * 16 + 4096)", 27 "hydration": "only charged returned rows; byte exhaustion returns an honest continuation or SpaceInsufficient", 28 "consistency": "header, lengths and hydrated events share one read transaction or memory lock", 29 "fenced_api": "EventStore::query_visible_at checks expected EventSourceToken in that same read", 30 "stale": "SourceEpochChanged", 31 "unsupported_fenced_adapter": "BackendUnavailable" 32 }, 33 "maintenance": { 34 "maximum_total_source_and_affected_key_units": 64, 35 "maximum_logical_bytes": 16777216, 36 "affected_key_charge": "4096 + target_key_bytes * 16; inspect lengths before payload allocation", 37 "priority": "retained affected targets drain before new source work", 38 "progress": "processed_rows reports materialized source rows; processed_keys reports refreshed deletion keys", 39 "worker": "explicit caller-owned bounded calls; no hidden task" 40 }, 41 "diagnostics": "rebuild_visibility remains the explicit full semantic oracle", 42 "forbidden": ["private application policy", "second database", "full-source read fallback", "hidden worker", "protocol registry changes", "new host configuration"] 43 }