docs: resolve OQ-04 — contract v1 pinned (ADR-008): surface partition, TxHandle-on-handle-trait, Wake/WakeReceiver, reserved __alkstore_ namespace, error taxonomy, engine-crate constructors, locks guarantee row

This commit is contained in:
glm-5.3-flash committed 2026-10-05 02:23:15 +00:00
1 parent 4391f6e879
commit 7ad8ac56bc
11 files changed
+650 -133

No files matched your search

@@ -2,8 +2,9 @@
## Status
Accepted (the contract skeleton the evidence supports); remaining
surface pinning is OQ-04's contract work against this ADR
Accepted (the contract skeleton the evidence supports); the surface
pinning is done — [ADR-008](008-contract-v1-pinning.md) §3/§4 pin the
wake type and the reserved strings
## Context
@@ -74,9 +75,9 @@ coalesced-but-complete re-read on SQLite).
The Postgres forwarder's synthetic reconnect-wake needs a reserved
channel namespace no consumer channel may collide with. The naming
convention for reserved/meta channels (and any internal queue/stream
names) is pinned in the core contract — exact strings are OQ-04
contract work; the *existence of a reserved namespace* is decided
here.
names) is pinned in the core contract — exact strings pinned by
[ADR-008](008-contract-v1-pinning.md) §4; the *existence of a reserved
namespace* is decided here.
### The caching-subscriber pattern rides the same contract
@@ -116,8 +117,8 @@ consumer-inventory-row-gated extension — not assumed now.
§"What feeds where"; `docs/research/poc-pg-posture-findings.md`
§Sub-module W.
- OQ-ST-04 (`docs/research/phase-0.md`) — de-risked by these
measurements; the contract remainder is OQ-04 +
`core-contract.md`.
measurements; the contract remainder resolved by
[ADR-008](008-contract-v1-pinning.md) over `core-contract.md`.
- [ADR-002](002-feature-scope.md) — notify/listen and streams are
first-class; the guarantee split is why both exist.
- [ADR-004](004-postgres-driver.md) — the forwarder owning the