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

docs/architecture/README.md

@@ -1,6 +1,6 @@
 ---
 status: draft
-last_updated: 2026-10-04
+last_updated: 2026-10-05
 ---
 
 # alkstore — Architecture
@@ -24,11 +24,11 @@ pending architecture review and OQ resolution.
 | Doc | Status | Purpose | Key OQs |
 |---|---|---|---|
 | [overview.md](overview.md) | draft | Crate family, feature surface, non-goals, evidence base | — |
-| [core-contract.md](core-contract.md) | draft | The unified trait surface, delivery guarantees, tx seam | OQ-04, OQ-08, OQ-09, OQ-10 |
+| [core-contract.md](core-contract.md) | draft | The unified trait surface, delivery guarantees, tx seam | OQ-05, OQ-08, OQ-09, OQ-10 |
 | [engine-sqlite.md](engine-sqlite.md) | draft | SQLite engine: honker-core/rusqlite mapping | OQ-05, OQ-06, OQ-09 |
 | [engine-postgres.md](engine-postgres.md) | draft | Postgres engine: tokio-postgres/LISTEN mapping | OQ-05, OQ-08, OQ-09 |
 | [queues.md](queues.md) | draft | Queue/scheduler/outbox semantics depth frame | OQ-05, OQ-09 |
-| [deployment.md](deployment.md) | draft | Host semantics, connection budgets, knobs, matrix | OQ-04, OQ-08 |
+| [deployment.md](deployment.md) | draft | Host semantics, connection budgets, knobs, matrix | OQ-08 |
 | [open-questions.md](open-questions.md) | draft | OQ tracker (promoted from OQ-ST register) | — |
 
 ## Architecture Decision Records
@@ -42,22 +42,25 @@ pending architecture review and OQ resolution.
 | [005](decisions/005-dependency-ownership.md) | Published libraries by default, named fork triggers | Accepted |
 | [006](decisions/006-wake-and-delivery-contract.md) | Wake contract — opaque wake + re-read; notify-vs-streams split | Accepted |
 | [007](decisions/007-transactional-seam.md) | Transactional seam — caller-held `TxHandle`, `*_tx` methods | Accepted |
+| [008](decisions/008-contract-v1-pinning.md) | Contract v1 surface pinning — surface partition, `TxHandle` shape, wake type, reserved strings, error taxonomy | Accepted |
 
 ## Open Questions
 
 Tracked in [open-questions.md](open-questions.md) (OQ-01..NN; the
 Phase 0 register's OQ-ST-01..08 promote one-to-one — OQ-NN mirrors
 OQ-ST-NN — with new Phase 1 questions appended after). Highlights,
-in suggested resolution order (OQ-04 first):
+in suggested resolution order (OQ-04 resolved):
 
-- **OQ-04** (high): contract pinning — exact trait shape, handle
+- ~~**OQ-04** (high): contract pinning — exact trait shape, handle
   representation, error taxonomy, reserved strings, guarantee rows
-  for locks/scheduler.
+  for locks/scheduler~~ — **resolved** (2026-10-05,
+  [ADR-008](decisions/008-contract-v1-pinning.md); the scheduler
+  guarantee row transferred to OQ-09).
 - **OQ-05** (high): queue semantics depth — retry/backoff/dead-letter/
   sweep design.
-- **OQ-06** (high): honker-core quality read — fork-trigger gate.
 - **OQ-09** (medium): scheduler as first-class mechanism vs queues +
-  `schedule()`.
+  `schedule()`; owns the scheduler guarantee row.
+- **OQ-06** (high): honker-core quality read — fork-trigger gate.
 - **OQ-08** (medium): capability-surface shape.
 - **OQ-10** (medium): contract versioning across engine crates.