Skip to content

Commit 7159b1c

Browse files
committed
docs(progress): refine m7.23 direction
1 parent 455fca2 commit 7159b1c

3 files changed

Lines changed: 55 additions & 0 deletions

File tree

docs/brainstorms/2026-04-16-mainline-ci-stabilization-and-m7-direction-requirements.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -707,6 +707,55 @@ Deliverables:
707707
- `npm run test:agent-workspace:contracts`
708708
- `npm run verify:agent-workspace:runtime`
709709

710+
### Post-M7.22 Architecture Judgment
711+
712+
- L4 interaction lane remains stable enough for bounded operator-governance increments:
713+
- current code reality still centers on `src/frontend/agent_workspace_runtime.js` + `src/server.ts` typed/runtime contract closure,
714+
- no evidence yet justifies reopening broader pane/runtime architecture work inside this increment.
715+
- L5 governance lane now has a coherent progression instead of isolated helpers:
716+
- triage thresholds,
717+
- remediation approval gates,
718+
- escalation lifecycle,
719+
- notification delivery/anomaly/SLO governance,
720+
- notification-threshold override/audit governance.
721+
- The main remaining gap is not another new route family.
722+
The next high-leverage gap is operator safety around rollback preview and drift visibility before applying or resetting thresholds.
723+
724+
### M7.23 (Next): Notification-Threshold Rollback Preview and Drift-Diff Governance (Lane Ops Bridge)
725+
726+
Deliverables:
727+
728+
- add bounded preview surface for comparing active notification thresholds against defaults before reset/apply.
729+
- expose structured drift diff so operators can see field-level deltas without reading raw audit history.
730+
- keep scope limited to notification-threshold governance; do not couple this increment to broader remediation-policy or pane-runtime work.
731+
732+
Proposed boundaries:
733+
734+
- In scope:
735+
- read-only diff/preview route(s),
736+
- default-vs-active threshold comparison payload,
737+
- latest-audit-linked rollback preview semantics,
738+
- executable tests and EN/ZH progress-doc updates.
739+
- Out of scope:
740+
- UI wiring,
741+
- cross-lane foundation retrieval work,
742+
- markdown-reader changes,
743+
- automatic rollback execution beyond explicit operator actions.
744+
745+
Preferred implementation posture:
746+
747+
- reuse the current file-backed governance style from `src/server.ts`,
748+
- avoid introducing a new generic config framework,
749+
- keep all new payloads deterministic and bounded by existing audit/retention constants.
750+
751+
Suggested verification slice:
752+
753+
- `npm test -- src/server.migration.test.ts --runInBand --testNamePattern "notification threshold rollback preview"`
754+
- `npm run test:agent-workspace:contracts`
755+
- `npm run verify:agent-workspace:runtime`
756+
- `npm run docs:diataxis:check`
757+
- `npm run docs:site:build`
758+
710759
## Success Criteria
711760

712761
- CI failure mode that previously blocked the three agent-workspace suites is eliminated on mainline.

docs/diataxis/en/explanation/development-progress-dashboard.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -624,6 +624,9 @@ Execution anchor:
624624
- `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"escalation notification threshold overrides and audit-trail governance stay deterministic\"`
625625
- `npm run test:agent-workspace:contracts`
626626
- `npm run verify:agent-workspace:runtime`
627+
- Next direction judgment:
628+
- current bottleneck is rollback visibility, not another broad governance subsystem,
629+
- M7.23 should stay bounded to notification-threshold rollback preview and drift-diff governance on top of existing file-backed policy/audit artifacts.
627630

628631
## Mainline vs Working-Branch Snapshot (2026-04-14)
629632

docs/diataxis/zh/explanation/development-progress-dashboard.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -626,6 +626,9 @@
626626
- `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"escalation notification threshold overrides and audit-trail governance stay deterministic\"`
627627
- `npm run test:agent-workspace:contracts`
628628
- `npm run verify:agent-workspace:runtime`
629+
- 后续方向判断:
630+
- 当前瓶颈是回滚可见性,不是继续扩一个更大的治理子系统,
631+
- M7.23 应继续收敛在 notification-threshold rollback preview 与 drift-diff 治理,复用现有 file-backed policy/audit 产物。
629632

630633
## 主线 vs 工作分支快照(2026-04-14)
631634

0 commit comments

Comments
 (0)