Files
alkstore/tasks/review-wave-6.md
T
glm-5.3-flash 5abd351c86 Wave-6 decomposition (mem engine): eleven tasks per the pg-wave rhythm — foundations (crate scaffold, MemStore::new isolation, guarded state core, wake routing, wasm32 gate from birth), seam-tx (the load-bearing tx overlay: eleven staged _tx methods, commit-merge + wake-at-commit — pg-fix-tx-wake's discipline structural from the start, drop = discard trivial, with_tx panic posture), mechanisms mutually parallel (notify-listen close-at-engine-drop/no-replay/never-coalesced; queues = ADR-010 machine driver-free with the equal-jitter curve and opts resolution as ADR-012 §2's third owner; streams log+offsets+trim; locks TTL registry, no busy-path analog), scheduler-outbox (tick/catch-up-64/leadership through the __alkstore_scheduler lock, engine-uniform per ADR-009 §4; outbox over queues with the 60/5/5 seam stamp), integration (suite third StoreFactory column green on host under a current-thread flavor, wasm32 acceptance items, engine-mem.md to implementation-complete), and the review-wave-6 gate (born-pinned audit: conformance read, discharge-map wiring, wasm items, three-way equivalence green, class-1 window discipline). Window riders: suite-harness-current-thread — the wave's one suite-side pre-task, past_stamp_sleep's blocking sleep goes async per review 003's properties.rs:1683 posture note, enabling the current-thread flavor; pg-fix-scheduler-tick-seam — review 003 Finding 1, the cfg(test) transient-fault seam driving the real tick_with_retries through retry-then-success and exhaustion arms (the last uncovered wave-4 hardening arm, sqlite-commit-error-arm pattern). Task hygiene: pg-fix-open-path frontmatter fixed (unquoted 'max_size: 0' colon-space inside the name scalar broke YAML parsing — taskgraph validate had been red one-error since the wave-4 fix-batch decomposition; also restores review-wave-4-fixes' dependency resolution). implementation.md: wave-6 table row → decomposed, task-set listing with the parallelism note (rider + pre-task independent of the mem chain; rider closes before the gate), wave-6 decomposition bullet in the review-rounds record. Docs-only change; verified taskgraph validate (60 tasks, no cycles), cargo fmt --check, cross-reference read
2026-10-10 09:57:01 +00:00

81 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: review-wave-6
name: Review gate — wave 6 (mem engine)
status: pending
depends_on: [mem-engine-integration, pg-fix-scheduler-tick-seam]
scope: moderate
risk: low
impact: phase
level: review
tags: [wave-6, review]
---
## Description
The wave-6 review gate (the plan's §Review gates, wave 6; the
born-pinned gate). Code-read the `alkstore-mem` engine against the
contract and the pinned ADR-024 text, and audit:
1. **Conformance read**: engine-vs-contract line by line, mirroring
the wave-3/4 gate pattern — every trait surface against
core-contract.md and the pinning ADRs (007/008/009/010/015/019/
020/021/023), the tx overlay against ADR-024 + engine-mem.md §The
tx overlay (commit-merge atomicity, wake-at-commit, drop = discard,
panic-through-unwind).
2. **The third column as the compatibility instrument born pinned**:
the mem column's wiring read row-by-row against the discharge map
(which rows carry, which engine-shaped rows omit and why — the
asymmetry classification, ADR-024 §3); `PayloadTooLarge`
non-occurrence arm present; three-way arithmetic equivalence
actually asserted green (backoff curve, opts resolution — the
ADR-012 §2 one-owner rule's third owner), plus the derived-queue
naming row composing identically.
3. **wasm32 acceptance audit** (ADR-024 §5): the compile gate clean,
tokio feature subset verified on the manifest, no blocking calls
in mem internals, the current-thread flavor actually enforced by
the column's tests.
4. **engine-mem.md read against the implemented engine**; the
deployment matrix's mem rows (`deployment.md`, landed with ADR-024)
still true as implemented (honesty carriers: identity + docs +
matrix — nothing runtime invented). Gate may flip `engine-mem.md`
to `stable` if the read is clean.
5. **The rider closed**: `pg-fix-scheduler-tick-seam`'s arms verified
(review 003 Finding 1 discharged into this window; Findings 2–3
confirmed still parked for wave 7).
6. **Contract-window discipline**: the class-1 amend-in-place window
is still open — any wobble the third implementation surfaced must
appear as resolved ADR text (or be recorded as a finding with its
disposition), not as a silent divergence between suite row and
engine behavior.
## Acceptance Criteria
- [ ] Full conformance code-read recorded (findings + dispositions
inline in this task's Notes, mirroring review-wave-3/4 style)
- [ ] Suite mem column green on host, 25-row set wired per the
classification; three-way equivalence rows green
- [ ] wasm32 compile gate + feature-subset + current-thread flavor
verified, recorded
- [ ] The rider's arms verified; Finding 1 disposition recorded
- [ ] Workspace gates re-run green this session (`cargo build`,
`cargo test`, clippy `-D warnings`, fmt)
- [ ] `engine-mem.md` disposition decided (stable flip or follow-up)
and `implementation.md`'s wave-6 row updated
## References
- docs/plans/implementation.md §Wave 6, §Review gates (wave 6 entry)
- docs/architecture/decisions/024-mem-engine.md (the charter this
gate audits code against)
- docs/architecture/engine-mem.md
- tasks/review-wave-3.md / tasks/review-wave-4.md (the gate pattern)
- docs/reviews/003-wave-5-general-review.md (Finding 1's disposition
trail; Findings 2–3's wave-7 park)
## Notes
> To be filled by implementation agent
## Summary
> To be filled on completion