Skip to content

Commit 584f664

Browse files
committed
feat: reuse triage priority in runbook actions
1 parent 6d1ef29 commit 584f664

11 files changed

Lines changed: 215 additions & 42 deletions

docs/brainstorms/2026-04-21-mainline-reconciliation-after-m8-50-priority-consumer-requirements.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ topic: mainline-reconciliation-after-m8-50-priority-consumer
55

66
# Mainline Reconciliation After M8.50 Priority Consumer Requirements
77

8+
> Status note (2026-04-21): `M8.51` has now shipped on `main`. This document remains the pre-implementation narrowing pass and is superseded by [Mainline Reconciliation After M8.51 Primary Runbook Action Requirements](./2026-04-21-mainline-reconciliation-after-m8-51-primary-runbook-action-requirements.md).
9+
810
## Problem Frame
911

1012
`M8.50` now ships on `main`.
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
date: 2026-04-21
3+
topic: mainline-reconciliation-after-m8-51-primary-runbook-action
4+
---
5+
6+
# Mainline Reconciliation After M8.51 Primary Runbook Action Requirements
7+
8+
## Problem Frame
9+
10+
`M8.51` now ships on `main`.
11+
The bounded priority-consumer alignment step is closed:
12+
13+
- runbook actions now reuse the already-shipped continuity-aware `triagePriority` surface,
14+
- `review-top-priority-replay-report` now emits whenever a bounded top-priority replay report exists,
15+
- severity stays explainable and bounded (`high -> critical`, `continuityBoosted -> warning`, otherwise `info`),
16+
- persistent managed-memory continuity inspection now records the current top-priority source context.
17+
18+
That changes the next seam again.
19+
The active question is no longer whether any consumer should reuse `triagePriority`.
20+
The active question is whether pane/report consumers should keep inferring the primary operator recommendation from runbook-action array order alone.
21+
22+
## Verified Mainline Reality (2026-04-21)
23+
24+
- `/triage`, `/triage/history`, and `/triage/runbook` now stay aligned on the same bounded `runbookActions` set.
25+
- The first runbook consumer already reuses:
26+
- `triagePriority`,
27+
- `replayRiskLevel`,
28+
- `replayRiskSignals`,
29+
- `replayCandidateRate`,
30+
- `managedConversationContinuitySummary`.
31+
- No new persistence model, route family, or broader dashboard shell was introduced.
32+
- Backend sufficiency remains green and dormant-by-default.
33+
34+
## Critical Findings
35+
36+
1. `M8.51` closed the first consumer-reuse seam.
37+
Runbook guidance no longer has to recompute priority from raw replay-rate ordering.
38+
39+
2. The next gap is now contract explicitness, not more ranking logic.
40+
Consumers can currently read the intended primary recommendation only by trusting array position.
41+
42+
3. Array-order semantics are too implicit for the next consumer.
43+
If another pane/report surface needs the primary action, it should not have to assume `runbookActions[0]` is a stable API contract unless the API says so explicitly.
44+
45+
4. Broader dashboard work is still not the sharpest next move.
46+
The next bounded step is to expose primary-action semantics on top of the current runbook payload, not to widen the shell.
47+
48+
## Requirements
49+
50+
**Truth Refresh**
51+
- R1. This document becomes the new current source-of-truth item for post-`M8.51` direction.
52+
- R2. Current-facing docs must describe `M8.51` as shipped priority-aware runbook action reuse.
53+
54+
**Next-Lane Narrowing**
55+
- R3. Current-facing docs must define `M8.52` as bounded primary runbook-action surfacing.
56+
- R4. `M8.52` must stay inside already-shipped fast-path payloads and their derived runbook output:
57+
- `runbookActions`,
58+
- `triagePriority`,
59+
- `replayRiskLevel`,
60+
- `replayRiskSignals`,
61+
- `managedConversationContinuitySummary`.
62+
- R5. `M8.52` must prefer explicit primary-action semantics over array-position conventions.
63+
- R6. `M8.52` must not require new persistence, full-report joins, or a broader dashboard shell.
64+
65+
**Scope Control**
66+
- R7. Do not reopen backend-escalation or CI-repair narration unless fresh evidence appears.
67+
- R8. Do not move markdown-reader work ahead of `M8.52` unless it compounds the same operator/study loop more directly.
68+
- R9. Do not jump to broader operator dashboards before primary runbook-action semantics land or are explicitly rejected.
69+
70+
## Success Criteria
71+
72+
- this document is listed first under `docs/brainstorms/index.md`,
73+
- EN/ZH current-facing docs describe `M8.51` as shipped,
74+
- EN/ZH current-facing docs describe `M8.52` as bounded primary runbook-action surfacing work,
75+
- docs verification passes,
76+
- `main` stays clean after verification.
77+
78+
## Scope Boundaries
79+
80+
- This document does not reopen backend sufficiency work.
81+
- This document does not add a new diagnostics persistence model.
82+
- This document does not claim that broader dashboard work now ships.
83+
- This document does not require a new operator route family.
84+
85+
## Next Steps
86+
87+
-> `/ce:plan` for `post-M8.51 primary runbook-action surfacing`, keeping `M8.52` bounded to explicit primary recommendation semantics on the existing triage/runbook payloads.

docs/brainstorms/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ This page tracks active and archived brainstorming outputs used before implement
44

55
## Current
66

7+
- [2026-04-21 Mainline Reconciliation After M8.51 Primary Runbook Action Requirements](2026-04-21-mainline-reconciliation-after-m8-51-primary-runbook-action-requirements.md)
78
- [2026-04-21 Mainline Reconciliation After M8.50 Priority Consumer Requirements](2026-04-21-mainline-reconciliation-after-m8-50-priority-consumer-requirements.md)
89
- [2026-04-21 Mainline Reconciliation After M8.49 Triage Prioritization Requirements](2026-04-21-mainline-reconciliation-after-m8-49-triage-prioritization-requirements.md)
910
- [2026-04-21 Mainline Reconciliation After M8.48 Triage Policy Requirements](2026-04-21-mainline-reconciliation-after-m8-48-triage-policy-requirements.md)

docs/diataxis/en/explanation/agent-conversation-focus-mode-plan.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -484,15 +484,17 @@ It is conversation-product hardening on top of the shipped shell.
484484
`M8.46` now preserves continuity breadth (`atomIds` / `atomCount`) and latest-transition freshness (`newerAt` / `olderAt`) on that same summary surface, so future pane/report actions can stay on bounded continuity payloads instead of rejoining raw capability events.
485485
`M8.47` now promotes that compact continuity digest into server-readable diagnostics metadata plus triage/history fast paths, so operator consumers no longer need snapshot-only coupling or full-report joins to read continuity breadth, totals, and latest-transition context.
486486
`M8.48` now lets runbook guidance consume that same normalized continuity digest, so persistent managed-memory gaps surface as explicit operator actions before any broader dashboard work.
487+
`M8.49` and `M8.50` now make severity and ordering continuity-aware, and `M8.51` now reuses that explainable priority inside runbook actions, so the next bounded seam is explicit primary-action surfacing rather than another consumer-specific ranking pass.
487488

488489
Priority order:
489490

490-
1. make `M8.51` about bounded priority-consumer alignment next, so any further operator action reuses the shipped explainable `triagePriority` surface instead of recomputing ranking,
491-
2. expand broader operator rollups only after that reuse step is in place,
492-
3. keep markdown-reader improvements secondary unless they clearly compound the same study/operator loop more than `M8.51`.
491+
1. make `M8.52` about bounded primary runbook-action surfacing next, so pane/report consumers can reuse the shipped priority-aware recommendation without scanning or re-sorting the full action list,
492+
2. expand broader operator rollups only after that explicit primary-action step is in place,
493+
3. keep markdown-reader improvements secondary unless they clearly compound the same study/operator loop more than `M8.52`.
493494

494495
## Related Pages
495496

497+
- [Mainline Reconciliation After M8.51 Primary Runbook Action Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-51-primary-runbook-action-requirements.md)
496498
- [Mainline Reconciliation After M8.50 Priority Consumer Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-50-priority-consumer-requirements.md)
497499
- [Mainline Reconciliation After M8.49 Triage Prioritization Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-49-triage-prioritization-requirements.md)
498500
- [Mainline Reconciliation After M8.48 Triage Policy Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-48-triage-policy-requirements.md)

0 commit comments

Comments
 (0)