feat(agent-workspace): roll up persistent managed next steps

Author: Jacobinwwey

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

@@ -476,10 +476,11 @@ It is conversation-product hardening on top of the shipped shell.
 `M8.38` now personalizes those expanded-history follow-up recommendations around missing managed-memory note/correction state, so the next step, rationale, and confidence copy all point directly at the still-missing managed key instead of stopping at generic continuity ranking.
 `M8.39` now personalizes adjacent managed-memory drift/stability explanations, so expanded history items also explain when a newer managed-state read resolved a previously missing key or confirmed that the same missing key still persists across the continuity window.
 `M8.40` now adds compact managed-memory continuity rollups on the Recent Activity card and diagnostics snapshot, so operators can read recovered-vs-persistent managed gaps without re-scanning each managed-memory history item.
+`M8.41` now adds persistent-gap next-step rollups on that same card and diagnostics snapshot, so operators can also see which deterministic managed-memory action still closes the remaining gap without opening each expanded history item.
 
 Priority order:
 
-1. deepen personalization or compact operator rollups on top of the shipped primary/secondary/drift/stability explanation surface, stability signals, managed-memory gap targeting, managed-memory continuity transitions, and managed-memory continuity rollups,
+1. deepen personalization or compact operator rollups on top of the shipped primary/secondary/drift/stability explanation surface, stability signals, managed-memory gap targeting, managed-memory continuity transitions, managed-memory continuity rollups, and persistent-gap next-step rollups,
 2. expand broader operator rollups only when they clearly compound the same current-atom continuity loop,
 3. keep markdown-reader improvements secondary unless they clearly compound the same study loop.
 

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

@@ -6,7 +6,7 @@ It explicitly separates branch-level implementation status from mainline integra
 ## Scope
 
 - Focus area: local-first knowledge mastery platform (ingest, retrieval, learning path, tutor, memory, governance).
-- Time window: `v1.7.0` through the 2026-04-21 foundation-integration checkpoint, the 2026-04-21 UTC CI review cycle, and the post-`M8.40` reconciliation pass.
+- Time window: `v1.7.0` through the 2026-04-21 foundation-integration checkpoint, the 2026-04-21 UTC CI review cycle, and the post-`M8.41` reconciliation pass.
 - Evidence rule: every progress claim must map to:
   - contract layer (`src/learning/api.ts`, `src/learning/types.ts`),
   - route/runtime layer (`src/server.ts`),
@@ -18,12 +18,12 @@ Current top priority is not feature-count expansion.
 Current top priority is **conversation-product hardening on top of the already-green backend baseline**:
 
 - keep backend sufficiency as a standing decision gate rather than an active execution lane,
-- keep closing the correction/product/operator gap exposed after `M8.20-M8.40`,
-- treat `M8.23` as the operator-visibility baseline for conversation-memory/correction actions, `M8.24` as the active-atom action-surface baseline, `M8.25` as the active-atom pane-state continuity baseline, `M8.26` as the active-atom study-loop summary baseline, `M8.27` as the active-atom recent-result continuity baseline, `M8.28` as the active-atom result-preview baseline, `M8.29` as the active-atom history-drill-down baseline, `M8.30` as the active-atom history follow-up baseline, `M8.31` as the active-atom history freshness-ranking baseline, `M8.32` as the active-atom history rationale/alternative baseline, `M8.33` as the active-atom history confidence-signal baseline, `M8.34` as the primary-vs-secondary tradeoff explanation baseline, `M8.35` as the adjacent-history drift explanation baseline, `M8.36` as the adjacent-history stability explanation baseline, `M8.37` as the adjacent-history stability-signal baseline, `M8.38` as the managed-memory gap follow-up baseline, `M8.39` as the managed-memory continuity-transition baseline, and `M8.40` as the managed-memory continuity-rollup baseline,
+- keep closing the correction/product/operator gap exposed after `M8.20-M8.41`,
+- treat `M8.23` as the operator-visibility baseline for conversation-memory/correction actions, `M8.24` as the active-atom action-surface baseline, `M8.25` as the active-atom pane-state continuity baseline, `M8.26` as the active-atom study-loop summary baseline, `M8.27` as the active-atom recent-result continuity baseline, `M8.28` as the active-atom result-preview baseline, `M8.29` as the active-atom history-drill-down baseline, `M8.30` as the active-atom history follow-up baseline, `M8.31` as the active-atom history freshness-ranking baseline, `M8.32` as the active-atom history rationale/alternative baseline, `M8.33` as the active-atom history confidence-signal baseline, `M8.34` as the primary-vs-secondary tradeoff explanation baseline, `M8.35` as the adjacent-history drift explanation baseline, `M8.36` as the adjacent-history stability explanation baseline, `M8.37` as the adjacent-history stability-signal baseline, `M8.38` as the managed-memory gap follow-up baseline, `M8.39` as the managed-memory continuity-transition baseline, `M8.40` as the managed-memory continuity-rollup baseline, and `M8.41` as the managed-memory continuity next-step-rollup baseline,
 - keep the remaining near-term budget on deeper personalization and operator rollup quality now that the continuity-explanation gap is closed on the active history surface,
 - keep remote `main` CI interpretation evidence-based: the latest fully completed `main` workflow set is green, and new pushes should be treated as pending until their workflow set finishes.
 
-## Current Mainline Snapshot (2026-04-21 Baseline Split: Foundation M8.18 / Conversation M8.40)
+## Current Mainline Snapshot (2026-04-21 Baseline Split: Foundation M8.18 / Conversation M8.41)
 
 - Foundation baseline on `main` is currently:
   - status `integrated`
@@ -37,12 +37,12 @@ Current top priority is **conversation-product hardening on top of the already-g
 - Historical increment sections below remain chronological archive entries.
 - When a historical section says `in_progress` / `no-go`, read it as past checkpoint truth rather than current repo state.
 
-## Reconciliation Notes (2026-04-21 Post-M8.40)
+## Reconciliation Notes (2026-04-21 Post-M8.41)
 
 - The active mainline question is no longer whether backend sufficiency work should continue.
   That lane is closed-by-default while its gate stays green.
-- The active mainline question is also no longer whether tradeoff, drift, stability explanation, stability signaling, managed-memory continuity targeting, and compact continuity rollups should be added.
-  `M8.34`, `M8.35`, `M8.36`, `M8.37`, `M8.38`, `M8.39`, and `M8.40` now ship that continuity-explanation layer on the expanded history decision surface.
+- The active mainline question is also no longer whether tradeoff, drift, stability explanation, stability signaling, managed-memory continuity targeting, compact continuity rollups, and compact persistent-gap next-step rollups should be added.
+  `M8.34`, `M8.35`, `M8.36`, `M8.37`, `M8.38`, `M8.39`, `M8.40`, and `M8.41` now ship that continuity-explanation layer on the expanded history decision surface.
 - The next gap is no longer local explanation opacity.
   The remaining product question is how much deeper personalization and operator rollup value should sit on top of this now-readable current-atom history surface.
 - Remote `main` CI is currently green on the latest push.
@@ -235,6 +235,22 @@ Execution anchor:
   - diagnostics snapshot coverage for stored preview payloads,
   - EN/ZH re-render coverage for localized preview text.
 
+## Latest Mainline Increment (2026-04-21 M8.41 Active-Atom Managed-Memory Continuity Next-Step Rollups)
+
+- Extended the compact managed-memory continuity story with deterministic next-step rollups:
+  - the Recent Activity card now maps persistent managed-memory gaps to the exact follow-up action labels that still remain,
+  - diagnostics snapshots/exports now preserve resolved-vs-persistent follow-up action ids next to the continuity counts,
+  - operators no longer have to open each expanded history item to see which deterministic managed-memory action still closes the remaining gap.
+- Kept the slice frontend-bounded:
+  - no backend route, API contract, persistence model, or capability schema changed,
+  - the new rollup only derives follow-up actions from the same bounded managed-memory continuity counts already recorded on the frontend.
+- Closed the next post-`M8.40` compact operator-rollup gap:
+  - compact continuity counts now stay actionable instead of only descriptive,
+  - exported diagnostics now keep the same persistent-gap next-step guidance that the active-atom card exposes locally.
+- Expanded regression coverage for:
+  - Recent Activity card persistent-gap next-step summary lines,
+  - diagnostics snapshot/export follow-up action ids for resolved vs persistent managed-memory continuity.
+
 ## Latest Mainline Increment (2026-04-21 M8.40 Active-Atom Managed-Memory Continuity Rollups)
 
 - Extended the current-atom history surface and diagnostics snapshot with compact managed-memory continuity rollups:

docs/diataxis/en/explanation/local-backend-sufficiency-and-escalation-plan.md

@@ -248,8 +248,8 @@ Recommended next product order:
    - the minimum correction / feedback closure is now integrated through explicit next-step guidance on missing managed state,
    - operator-facing visibility for conversation-memory and correction actions is now integrated through persisted diagnostics summary/index counts,
    - stronger agent action surfaces around focus mode and learning path are now integrated through the active-atom quick-action rail, toolbar routing, continuity notes/path-target diagnostics, capability-taxonomy summary cards, the recent-activity history card, localized result-detail previews on that history surface, expandable history drill-down, deterministic history follow-up affordances, continuity-aware freshness ranking for those affordances, and bounded rationale/secondary-alternative rendering,
-   - `M8.34` primary-vs-secondary tradeoff explanation, `M8.35` adjacent-history drift explanation, `M8.36` adjacent-history stability explanation, `M8.37` adjacent-history stability signals, `M8.38` managed-memory gap follow-up personalization, `M8.39` managed-memory continuity transition explanation, and `M8.40` managed-memory continuity rollups are now integrated on top of the shipped signal-enabled current-atom recent-activity card,
-   - next only deepen personalization or broader operator rollups when they clearly compound that same readable current-atom continuity loop, especially when they keep missing managed-state targeting, transition explanation, and continuity rollups explicit.
+  - `M8.34` primary-vs-secondary tradeoff explanation, `M8.35` adjacent-history drift explanation, `M8.36` adjacent-history stability explanation, `M8.37` adjacent-history stability signals, `M8.38` managed-memory gap follow-up personalization, `M8.39` managed-memory continuity transition explanation, `M8.40` managed-memory continuity rollups, and `M8.41` persistent-gap next-step rollups are now integrated on top of the shipped signal-enabled current-atom recent-activity card,
+  - next only deepen personalization or broader operator rollups when they clearly compound that same readable current-atom continuity loop, especially when they keep missing managed-state targeting, transition explanation, continuity rollups, and persistent-gap next-step guidance explicit.
 2. markdown-reader improvement:
    - only when it clearly compounds knowledge review or focus-mode study loops.
 

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

@@ -464,10 +464,11 @@
 `M8.38` 现在又围绕缺失的 managed-memory note / correction state 个性化这些展开 history follow-up recommendation，让下一步、rationale 与 confidence copy 都直接指向仍然缺失的托管 key，而不是停留在通用 continuity ranking。
 `M8.39` 现在又把相邻 managed-memory drift / stability explanation 个性化，让展开后的 history item 还能直接说明：更新的 managed-state read 是已经恢复了某个缺失 key，还是仍在同一 continuity window 内持续缺少这个 key。
 `M8.40` 现在又把 compact managed-memory continuity rollup 补到 Recent Activity card 与 diagnostics snapshot 上，让操作者无需逐条重扫 managed-memory history item，也能读出 gap 的恢复与持续情况。
+`M8.41` 现在又把 persistent-gap next-step rollup 补到同一张卡与 diagnostics snapshot 上，让操作者无需展开每条 history item，也能直接看到剩余 gap 还对应哪个确定性的 managed-memory 动作。
 
 优先顺序：
 
-1. 在当前已落地的 primary/secondary/drift/stability explanation surface、stability signal、managed-memory gap targeting、managed-memory continuity transition 与 managed-memory continuity rollup 之上继续加深 personalization 或 compact operator rollup，
+1. 在当前已落地的 primary/secondary/drift/stability explanation surface、stability signal、managed-memory gap targeting、managed-memory continuity transition、managed-memory continuity rollup 与 persistent-gap next-step rollup 之上继续加深 personalization 或 compact operator rollup，
 2. 只有当更宽的 operator rollup 能明确复利同一 current-atom continuity loop 时才继续扩展，
 3. Markdown 阅读器提升继续保持次优先级，除非它能明确加强同一学习闭环。