Skip to content

Commit 826f498

Browse files
committed
feat(operator): surface managed conversation diagnostics
1 parent fa5ced5 commit 826f498

10 files changed

Lines changed: 679 additions & 19 deletions

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -454,13 +454,13 @@ This delivery path already replaced "generic conversation enhancement" and most
454454
The immediate remaining priority is no longer basic focus/path shell delivery.
455455
It is conversation-product hardening on top of the shipped shell.
456456
`M8.22` already closed the minimum correction-flow gap by turning missing managed-memory state into explicit next-step guidance.
457+
`M8.23` now exposes operator-facing diagnostics counts for managed conversation actions and missing correction state.
457458

458459
Priority order:
459460

460-
1. operator-facing visibility for conversation-memory and correction actions,
461-
2. stronger focus-mode / learning-path action surfaces tied to the active conversation atom,
462-
3. only then deeper personalization work,
463-
4. markdown-reader improvements only when they clearly compound the same study loop.
461+
1. stronger focus-mode / learning-path action surfaces tied to the active conversation atom,
462+
2. only then deeper personalization work,
463+
3. markdown-reader improvements only when they clearly compound the same study loop.
464464

465465
## Related Pages
466466

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

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ Current top priority is not feature-count expansion.
1818
Current top priority is **conversation-product hardening on top of the already-green backend baseline**:
1919

2020
- keep backend sufficiency as a standing decision gate rather than an active execution lane,
21-
- keep closing the correction/product/operator gap exposed after `M8.20-M8.22`,
22-
- treat `M8.22` as the minimum correction-flow closure baseline and move the remaining near-term budget into operator-facing visibility and stronger focus/path action surfaces,
23-
- keep remote `main` CI interpretation evidence-based: the latest fully completed `main` workflow set (`3a1926a`) is green, and the newer `e73b5c6` push remains non-red with `Migration Gates` still running at refresh time.
21+
- keep closing the correction/product/operator gap exposed after `M8.20-M8.23`,
22+
- treat `M8.23` as the operator-visibility baseline for conversation-memory and correction actions and move the remaining near-term budget into stronger focus/path action surfaces,
23+
- 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.
2424

2525
## Current Mainline Snapshot (2026-04-21 M8.18)
2626

@@ -120,6 +120,22 @@ Execution anchor:
120120
- Expanded regression coverage for:
121121
- runtime managed-memory state messaging with explicit next-step guidance.
122122

123+
## Latest Mainline Increment (2026-04-21 M8.23 Operator Visibility for Managed Conversation Actions)
124+
125+
- Upgraded persisted agent-workspace diagnostics from generic memory-policy counts to operator-usable conversation-memory visibility:
126+
- runtime diagnostics now retain managed conversation action identity for `inspect_managed_memory_state`, `write_memory_note`, `record_memory_correction`, and `evict_memory_note`,
127+
- targeted managed-state results now retain matched vs missing `note` / `correction` key classes inside the diagnostics report.
128+
- Kept the slice bounded to the existing diagnostics surface:
129+
- no new operator route or backend persistence model was introduced,
130+
- `latest` / `index` summaries now expose compact managed-conversation counts by reusing the current diagnostics report pipeline.
131+
- Operator-facing reports can now answer the previously missing questions:
132+
- whether correction actions are actually being executed,
133+
- whether targeted managed-state reads are still surfacing missing correction state,
134+
- whether note/correction actions are visible separately instead of being collapsed under generic `apply_memory_policy`.
135+
- Expanded regression coverage for:
136+
- runtime managed-conversation diagnostics summary/index export,
137+
- server-side diagnostics metadata summary extraction for managed conversation actions.
138+
123139
## Latest Mainline Increment (2026-04-14 M1 Baseline)
124140

125141
- Added first `AgentConversationAPI` contract surface:

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -245,8 +245,8 @@ Recommended next product order:
245245
1. conversation-product hardening:
246246
- extend explicit conversation memory APIs beyond the current snapshot/read/managed-key inspection and note/correction/eviction surface,
247247
- the minimum correction / feedback closure is now integrated through explicit next-step guidance on missing managed state,
248-
- next add operator-facing visibility for conversation-memory and correction actions,
249-
- then harden stronger agent action surfaces around focus mode and learning path.
248+
- operator-facing visibility for conversation-memory and correction actions is now integrated through persisted diagnostics summary/index counts,
249+
- next harden stronger agent action surfaces around focus mode and learning path.
250250
2. markdown-reader improvement:
251251
- only when it clearly compounds knowledge review or focus-mode study loops.
252252

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -442,13 +442,13 @@
442442
当前第一优先级已经不再是基础 focus/path 壳层交付,
443443
而是建立在该壳层之上的 conversation-product 加固。
444444
`M8.22` 已经通过“把缺失托管记忆状态转成显式下一步提示”补上最小 correction-flow 缺口。
445+
`M8.23` 现在又补上了托管对话动作与缺失 correction state 的 operator-facing diagnostics 计数。
445446

446447
优先顺序:
447448

448-
1. 增加 conversation-memory / correction action 的 operator-facing visibility,
449-
2. 继续加固绑定当前会话 atom 的 focus-mode / learning-path action surface,
450-
3. 之后才进入更深的 personalization 工作,
451-
4. Markdown 阅读器提升只有在能明确复利同一学习闭环时才进入前列。
449+
1. 继续加固绑定当前会话 atom 的 focus-mode / learning-path action surface,
450+
2. 之后才进入更深的 personalization 工作,
451+
3. Markdown 阅读器提升只有在能明确复利同一学习闭环时才进入前列。
452452

453453
## 关联页面
454454

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

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@
1818
当前重心是 **建立在已转绿 backend 基线之上的 conversation-product 加固**
1919

2020
- 让 backend sufficiency 继续作为常驻 decision gate,而不是继续占用主动执行预算,
21-
- 持续收口 `M8.20-M8.22` 之后暴露出的 correction / product / operator 缺口,
22-
-`M8.22` 视作最小 correction-flow closure 基线,把剩余近端预算转向 operator-facing visibility 与更强的 focus/path action surface,
23-
- 远端 `main` CI 解释继续基于代码事实:最近一组已完整结束的 `main` 工作流(`3a1926a`)为绿色,而更新的 `e73b5c6` 推送在刷新时也保持非红,仅 `Migration Gates` 仍在执行
21+
- 持续收口 `M8.20-M8.23` 之后暴露出的 correction / product / operator 缺口,
22+
-`M8.23` 视作 conversation-memory / correction action 的 operator-visibility 基线,把剩余近端预算转向更强的 focus/path action surface,
23+
- 远端 `main` CI 解释继续基于代码事实:最近一组已完整结束的主线工作流为绿色,新推送在整组工作流结束前只应视为 pending
2424

2525
## 当前主线快照(2026-04-21 M8.18)
2626

@@ -120,6 +120,22 @@
120120
- 回归覆盖同步扩展到:
121121
- runtime 托管记忆状态消息对显式下一步提示的断言。
122122

123+
## 主线最新增量(2026-04-21 M8.23 托管对话动作的 Operator Visibility)
124+
125+
- 已把持久化 agent-workspace diagnostics 从泛化 memory-policy 计数升级为 operator 可用的 conversation-memory 可见性:
126+
- runtime diagnostics 现在会保留 `inspect_managed_memory_state``write_memory_note``record_memory_correction``evict_memory_note` 的动作身份,
127+
- 定向托管状态读取结果也会在 diagnostics report 中保留 `note` / `correction` 的 matched / missing 键类。
128+
- 范围继续保持收敛,复用现有 diagnostics surface:
129+
- 没有新增 operator 路由,也没有新增 backend 持久化模型,
130+
- `latest` / `index` 摘要现在只是在既有 diagnostics report pipeline 上补出紧凑的 managed-conversation 计数。
131+
- 这让 operator report 能回答此前缺失的问题:
132+
- correction action 是否真的被执行,
133+
- 定向托管状态读取是否仍在暴露缺失 correction state,
134+
- note / correction action 是否能从泛化的 `apply_memory_policy` 统计里拆分出来。
135+
- 回归覆盖同步扩展到:
136+
- runtime managed-conversation diagnostics summary / index 导出,
137+
- server 侧 diagnostics metadata summary 对 managed conversation action 的提取断言。
138+
123139
## 主线最新增量(2026-04-14 M1 基线)
124140

125141
- 已新增第一版 `AgentConversationAPI` 合同面:

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -244,8 +244,8 @@
244244
1. conversation-product 加固:
245245
- 在当前 snapshot/read/托管 key 检查与 note/correction/eviction 能力之上继续扩展显式 conversation memory API,
246246
- 最小 correction / feedback 收口已经通过“缺失托管状态 -> 显式下一步提示”集成到主线,
247-
- 下一步补 conversation-memory / correction action 的 operator-facing visibility,
248-
- 之后再继续加固围绕 focus mode 与 learning path 的 agent action surface。
247+
- conversation-memory / correction action 的 operator-facing visibility 已经通过持久化 diagnostics summary / index 计数集成到主线
248+
- 下一步继续加固围绕 focus mode 与 learning path 的 agent action surface。
249249
2. markdown reader 提升:
250250
- 只有在它能明确加强知识 review 或 focus-mode 学习闭环时,再提升优先级。
251251

0 commit comments

Comments
 (0)