docs: add current-state context pack and actionable sequence-b prompts

2026-03-25 13:08:05 +00:00
parent e238ec079f
commit 30fad8e954
10 changed files with 568 additions and 10 deletions
@@ -112,3 +112,61 @@ Related:

 - `context/runbook.md`
 - `memory-bank/change-log.md` (CL-032)
+
+---
+
+### D-004: Runtime canonicalization decision needed (`server.js` vs `server/server.js`)
+
+date: 2026-03-25  
+author: Cline  
+scope: runtime startup path, scripts, runbook documentation  
+type: decision  
+rationale: Architecture/debt review identifies persistent ambiguity from dual server entrypoints, increasing operational drift risk.  
+impact: Affects release reliability, troubleshooting clarity, onboarding consistency, and change safety for runtime-affecting work.  
+status: proposed
+
+Decision:
+
+- Adopt one explicit canonical runtime startup path for dev/test/prod and document it in runbook + scripts.
+- Mark the non-canonical server entrypoint as deprecated (or remove when safe) with rollback instructions.
+
+Consequences:
+
+- Reduces deployment and incident-response ambiguity.
+- Requires coordinated validation across environments before deprecating the alternate path.
+
+Related:
+
+- `memory-bank/architect-review.md`
+- `context/architecture.md`
+- `context/runbook.md`
+
+---
+
+### D-005: Introduce CI baseline checks for high-risk parity/coverage gates
+
+date: 2026-03-25  
+author: Cline  
+scope: CI policy for architecture/debt hardening lanes  
+type: decision  
+rationale: High-value focused tests now exist but are not yet fully institutionalized as explicit baseline gates for parity-sensitive change safety.  
+impact: Improves release confidence and reduces regression drift in auth/i18n/high-risk integration paths.  
+status: proposed
+
+Decision:
+
+- Add baseline CI checks for:
+    - `npm run lint`
+    - phase22 aggregate high-risk checks (`tests/phase22/index.test.cjs`)
+    - EN/CY parity validation checks (initial rewrite parity scope)
+
+Consequences:
+
+- Tightens merge discipline for high-risk changes.
+- May require staged rollout to avoid pipeline disruption while stabilizing flaky areas.
+
+Related:
+
+- `context/test-coverage-map.md`
+- `context/current-state-scorecard.md`
+- `memory-bank/open-questions.md` (Q-002)