Skip to content

docs(d1): reconcile technical-roadmap.md + canonical-vocabulary glossary#54

Merged
actools-pl merged 1 commit into
mainfrom
phaseD/D1-technical-roadmap-reconcile
Jun 14, 2026
Merged

docs(d1): reconcile technical-roadmap.md + canonical-vocabulary glossary#54
actools-pl merged 1 commit into
mainfrom
phaseD/D1-technical-roadmap-reconcile

Conversation

@actools-pl

Copy link
Copy Markdown
Owner

Phase D1 (Track D — doc-truth) · baseline 49b9a52 (#53).

Reconciles technical-roadmap.md — the keystone architectural-reference doc — against
the real 49b9a52 tree, and adds the canonical "Phase" glossary.

Corrections: drops the false "All Phases 1-4 complete" headline (only Phase 1 is
shipped/live; Phases 2-4 are quarantined experimental seeds; the health self-healing
and migrate modules were removed); fixes the counts to the measured 6 live modules
(+7 quarantined), 236 tests / 24 bats files (no "32" / "21"); strips the unmeasured
≤5-min failover and feature-tied <15min RTO, rewording the enterprise-grade RTO/RPO/
uptime targets as objectives with a measured-rehearsal note; relabels Galera and
automated failover to Phase 5. Adds a glossary disambiguating the two "Phase" axes
(product roadmap 1-4-4.5-5 vs the process P0-/Items; "P0- delivered the Phase 1
milestone"; Item N ≈ E-roster).

Doc-only; the source/test/golden closure is byte-identical to 49b9a52 (behavior-free).
REVIEW = APPROVE, DOC-CHECK = PASS (separate windows). Scope exactly 1 file (+38/-19),
tree e600f4b; author actools-pl, no Co-authored-by.

Pre-existing future-framed command examples + small residual cites are deferred to D1b.
No branch e2e (behavior-free) — merge on CI net green.

…ary (doc-only, no behavior change)

Reconcile the keystone architectural-reference doc against the 49b9a52 tree
and add a canonical "Phase" glossary. Doc-only; no code/test/module/golden
file is touched, so the live source-closure is byte-identical to 49b9a52
(behavior-free, no e2e).

Reconciliation (SPEC-D1 §3.1):
- Status header + Overview: drop "All Phases 1-4 complete" and "32 modular
  components"; state the live platform truthfully (6 live modules, 7
  quarantined experimental seeds, 236 tests across 24 bats, CI/CD); name
  observability/preview/assistant as experimental seeds; note health+migrate
  removed.
- Enterprise-grade defs: kept as aspirational target objectives, reworded so
  none asserts a current capability; added the measured-rehearsal/2x note.
- Phase-5 relabels: automated failover (5A target) and Galera (subsection +
  summary row) are Phase 5, not 4.5.
- Unmeasured numbers stripped: the <=5-min failover and the feature-tied
  <15min RTO (summary row + roadmap tree). The line-131 RTO measurement
  script and the summary Effort estimates are left untouched.
- NOW(v11.0) tree: Phase 1 [SHIPPED]; Phase 2/4 experimental; Phase 3 partial.

Glossary (SPEC-D1 §3.2): both "Phase" axes (product-roadmap vs process/program
tracking); Item N <-> E-roster mapping verified against shipped code comments.
@actools-pl actools-pl merged commit aa1d826 into main Jun 14, 2026
8 checks passed
@actools-pl actools-pl deleted the phaseD/D1-technical-roadmap-reconcile branch June 14, 2026 20:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant