feat: expose primary runbook action contract

Author: Jacobinwwey

docs/brainstorms/2026-04-21-mainline-reconciliation-after-m8-51-primary-runbook-action-requirements.md

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

docs/brainstorms/2026-04-21-mainline-reconciliation-after-m8-52-primary-runbook-consumer-requirements.md

@@ -0,0 +1,86 @@
+---
+date: 2026-04-21
+topic: mainline-reconciliation-after-m8-52-primary-runbook-consumer
+---
+
+# Mainline Reconciliation After M8.52 Primary Runbook Consumer Requirements
+
+## Problem Frame
+
+`M8.52` now ships on `main`.
+The bounded primary runbook-action surfacing step is closed:
+
+- `/triage`, `/triage/history`, and `/triage/runbook` now expose an explicit `primaryRunbookAction`,
+- `triage.primaryRunbookAction` now mirrors that same bounded recommendation inside the nested triage payload,
+- pane/report consumers no longer need to treat `runbookActions[0]` as an undocumented contract,
+- no new persistence, route family, or broader dashboard shell was introduced.
+
+That changes the next seam again.
+The active question is no longer whether the server contract should make the primary recommendation explicit.
+The active question is whether any bounded pane/report consumer should adopt that shipped primary contract before broader operator-shell work resumes.
+
+## Verified Mainline Reality (2026-04-21)
+
+- `/triage`, `/triage/history`, and `/triage/runbook` now keep `primaryRunbookAction` aligned with the same derived `runbookActions` set.
+- The explicit primary contract already reuses only shipped fast-path data:
+  - `runbookActions`,
+  - `triagePriority`,
+  - `replayRiskLevel`,
+  - `replayRiskSignals`,
+  - `managedConversationContinuitySummary`.
+- Backend sufficiency remains green and dormant-by-default.
+
+## Critical Findings
+
+1. `M8.52` closed the contract-explicitness seam.
+   Consumers no longer need to infer the intended primary recommendation from array position.
+
+2. The next bounded gap is consumer adoption.
+   The current server payload is now explicit enough for pane/report reuse without another ranking pass.
+
+3. Broader dashboard work is still not the sharpest next move.
+   The highest-leverage next step is to let one bounded consumer read the shipped primary contract instead of widening the shell first.
+
+4. New persistence would still be wasteful here.
+   The required recommendation already exists on the fast path.
+
+## Requirements
+
+**Truth Refresh**
+- R1. This document becomes the new current source-of-truth item for post-`M8.52` direction.
+- R2. Current-facing docs must describe `M8.52` as shipped explicit primary runbook-action surfacing.
+
+**Next-Lane Narrowing**
+- R3. Current-facing docs must define `M8.53` as bounded primary runbook consumer adoption.
+- R4. `M8.53` must stay inside already-shipped fast-path payloads:
+  - `primaryRunbookAction`,
+  - `runbookActions`,
+  - `runbookLinks`,
+  - `triagePriority`,
+  - `replayRiskLevel`.
+- R5. `M8.53` must prefer reuse of the shipped `primaryRunbookAction` contract over recomputing or re-sorting recommendations in the consumer.
+- R6. `M8.53` must not require new persistence, full-report joins, or a broader dashboard shell.
+
+**Scope Control**
+- R7. Do not reopen backend-escalation or CI-repair narration unless fresh evidence appears.
+- R8. Do not move markdown-reader work ahead of `M8.53` unless it compounds the same operator/study loop more directly.
+- R9. Do not jump to broader operator dashboards before bounded primary-consumer adoption lands or is explicitly rejected.
+
+## Success Criteria
+
+- this document is listed first under `docs/brainstorms/index.md`,
+- EN/ZH current-facing docs describe `M8.52` as shipped,
+- EN/ZH current-facing docs describe `M8.53` as bounded primary-consumer adoption work,
+- docs verification passes,
+- `main` stays clean after verification.
+
+## Scope Boundaries
+
+- This document does not reopen backend sufficiency work.
+- This document does not add a new diagnostics persistence model.
+- This document does not claim that broader dashboard work now ships.
+- This document does not require a new operator route family.
+
+## Next Steps
+
+-> `/ce:plan` for `post-M8.52 primary runbook consumer adoption`, keeping `M8.53` bounded to one consumer reusing the shipped `primaryRunbookAction` contract.

docs/brainstorms/index.md

@@ -4,6 +4,7 @@ This page tracks active and archived brainstorming outputs used before implement
 
 ## Current
 
+- [2026-04-21 Mainline Reconciliation After M8.52 Primary Runbook Consumer Requirements](2026-04-21-mainline-reconciliation-after-m8-52-primary-runbook-consumer-requirements.md)
 - [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)
 - [2026-04-21 Mainline Reconciliation After M8.50 Priority Consumer Requirements](2026-04-21-mainline-reconciliation-after-m8-50-priority-consumer-requirements.md)
 - [2026-04-21 Mainline Reconciliation After M8.49 Triage Prioritization Requirements](2026-04-21-mainline-reconciliation-after-m8-49-triage-prioritization-requirements.md)

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

@@ -484,16 +484,17 @@ It is conversation-product hardening on top of the shipped shell.
 `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.
 `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.
 `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.
-`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.
+`M8.49` and `M8.50` now make severity and ordering continuity-aware, `M8.51` now reuses that explainable priority inside runbook actions, and `M8.52` now exposes `primaryRunbookAction` explicitly, so the next bounded seam is consumer adoption rather than another contract-only ranking pass.
 
 Priority order:
 
-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,
-2. expand broader operator rollups only after that explicit primary-action step is in place,
-3. keep markdown-reader improvements secondary unless they clearly compound the same study/operator loop more than `M8.52`.
+1. make `M8.53` about bounded primary runbook consumer adoption next, so one pane/report surface reuses the shipped `primaryRunbookAction` contract instead of re-deriving recommendations locally,
+2. expand broader operator rollups only after that consumer-adoption step is in place,
+3. keep markdown-reader improvements secondary unless they clearly compound the same study/operator loop more than `M8.53`.
 
 ## Related Pages
 
+- [Mainline Reconciliation After M8.52 Primary Runbook Consumer Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-52-primary-runbook-consumer-requirements.md)
 - [Mainline Reconciliation After M8.51 Primary Runbook Action Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-51-primary-runbook-action-requirements.md)
 - [Mainline Reconciliation After M8.50 Priority Consumer Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-50-priority-consumer-requirements.md)
 - [Mainline Reconciliation After M8.49 Triage Prioritization Requirements](../../../brainstorms/2026-04-21-mainline-reconciliation-after-m8-49-triage-prioritization-requirements.md)