projection_document_inventory.v2.json (2175B)
1 { 2 "schema": "radroots.projection-document-inventory.v2", 3 "status": "implemented_candidate", 4 "supersedes_without_mutation": "radroots.projection-document-inventory.v1", 5 "owners": ["radroots_storage", "radroots_storage_sqlite"], 6 "selection": "Optional validated inclusive UTF-8 key intervals select one exact generation. Independently supplied identity, generation and interval bind provider-produced continuations. A validated after-key can seek within that exact selection without creating a retained session. Neither mechanism establishes frozen application scope or proves position existence.", 7 "bounds": {"page_records": 256, "metadata_lookahead": 1, "key_bytes": 512, "generation_bytes": 32, "digest_bytes": 32, "maximum_page_payload_bytes": 16777216, "minimum_caller_payload_budget": 1}, 8 "allocation": "A caller may lower the encoded payload budget within the existing maximum. Providers inspect scalar lengths before cloning or loading payloads. A first valid value that cannot fit returns SpaceInsufficient; exhaustion after admitted records returns a continuation. Metadata remains separately bounded by count plus one lookahead. Callers charge decoding, intermediate buffers and product work within their own envelope.", 9 "consistency": "Key ranges use bounded BTreeMap selection or SQLite primary-key predicates. Source-bound reads retain the exact canonical source, Ready health, registered promoted generation and expected-active checks under the same existing transaction or lock.", 10 "corruption": "Keep explicit bounded corrupt-record locators for invalid stored values; invalid key/generation prevents safe continuation. No malformed record or oversized valid value becomes empty complete success.", 11 "compatibility": "Default queries preserve the original full inventory, ordering, byte maximum and corruption rules. Historical v1 contract, stored bytes, migrations, features, dependencies and unsupported-provider refusals remain unchanged.", 12 "non_goals": ["application ranking or schema", "frozen product cursors", "new snapshots or leases", "garbage collection policy", "raw SQL escape hatch", "new database", "release qualification"] 13 }