lib

Core libraries for Radroots
git clone https://radroots.dev/git/lib.git
Log | Files | Refs | README

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 }