wave-8 decomposition — the release-readiness pass: eleven tasks (seven independent entries: frontmatter cleanup — 11 docs with invalid YAML frontmatter, the renumber sweep, crate docs, the class-1 window's last dispositions, N-1, Findings 2-3, the fired-trigger flake investigation; then deployment matrix -> README -> publish prep -> review-wave-8 gate); plan wave-8 row + task set + review-rounds entry
This commit is contained in:
1 parent
6524778593
commit
9e069ced59
12 files changed
+1004
-6
No files matched your search
@@ -0,0 +1,76 @@
|
||||
---
|
||||
id: release-deployment-matrix
|
||||
name: Deployment matrix final pass — all three engines, release text
|
||||
status: pending
|
||||
depends_on: [release-n1-growth-posture]
|
||||
scope: moderate
|
||||
risk: low
|
||||
impact: component
|
||||
level: implementation
|
||||
tags: [wave-8, docs, deployment]
|
||||
---
|
||||
|
||||
## Description
|
||||
|
||||
The plan's wave-8 "deployment matrix final pass (across all three
|
||||
engines now)": `docs/architecture/deployment.md` read row-by-row
|
||||
against the three implemented engines and finalized as release text —
|
||||
the document is ADR-016's honesty carrier (with the engine crates'
|
||||
own docs), so every row must be true as implemented, not as designed.
|
||||
|
||||
1. **Row-by-row verification**: host semantics, connection budgets
|
||||
(SQLite writer/reader/watcher; pg `max_size` + the non-pooled
|
||||
listener; mem's none), durability knobs, TLS posture (v1),
|
||||
toolchain/platform notes (incl. the mem wasm32 row), consumer-
|
||||
obligation notes on engine options, and the latency profile's
|
||||
"indicative, POC-measured" honesty (POC-measured numbers published
|
||||
as indicative — confirm the caveat text is still accurate or
|
||||
refresh it against the contract suite's existence).
|
||||
2. **The env-variable boundary pin** (review 003's explicit
|
||||
re-check-at-prepublish item): re-run the no-env-in-production grep
|
||||
across the workspace (review 003 §Env-variable boundary has the
|
||||
method + the prior result), confirm every `env::var` read still
|
||||
lives in a test target, and pin the boundary in one sentence in
|
||||
deployment.md (and the engine specs if the sentence belongs there
|
||||
too): "env reads are harness-only; production configuration is the
|
||||
opts-constructor surface."
|
||||
3. **Fold N-1's outcome**: the growth-posture acceptance
|
||||
(`release-n1-growth-posture`'s record) lands in the matrix's
|
||||
durability/growth text.
|
||||
4. **The mem rows' final honesty check**: ADR-024 landed them at
|
||||
adoption; the wave-6 gate read them true — this pass re-reads them
|
||||
as release text (ephemerality, isolation, wasm toolchain note).
|
||||
5. **Release-text quality**: the document should stand alone for a
|
||||
deployer sizing any of the three engines — no dangling references
|
||||
to waves/tasks/POCs that a consumer wouldn't have context for
|
||||
(POC-measured caveats stay, internal task pointers go).
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] Every deployment.md row verified true as implemented across the
|
||||
three engines; corrections landed
|
||||
- [ ] The env-boundary grep re-run (result recorded) + the boundary
|
||||
sentence pinned in deployment.md
|
||||
- [ ] N-1's acceptance folded into the growth/durability text
|
||||
- [ ] The mem rows re-read as release text
|
||||
- [ ] No internal-task/wave pointers remain in the release-facing text
|
||||
(POC-measured caveats excepted)
|
||||
- [ ] Workspace gates green (docs-only expected)
|
||||
|
||||
## References
|
||||
|
||||
- docs/architecture/deployment.md (the document)
|
||||
- docs/architecture/decisions/016-deployment-honesty.md (the carrier
|
||||
mandate)
|
||||
- docs/reviews/003-wave-5-general-review.md §Env-variable boundary
|
||||
(the re-check item + method)
|
||||
- tasks/release-n1-growth-posture.md (the input this pass folds)
|
||||
- docs/architecture/engine-mem.md (the mem rows' spec source)
|
||||
|
||||
## Notes
|
||||
|
||||
> To be filled by implementation agent
|
||||
|
||||
## Summary
|
||||
|
||||
> To be filled on completion
|
||||
Reference in new issue
Block a user