feat(agent-workspace): add diagnostics trend index and export surfaces

Author: Jacobinwwey

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

@@ -237,6 +237,27 @@ Deliverables:
   - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
   - `npm run test:agent-workspace:contracts`
 
+### M7.6 (Now): Operator Diagnostics Trend/Index/Export Deepening (Lane Ops Bridge)
+
+Deliverables:
+
+- add bounded runtime diagnostics trend/index/export surfaces to improve operator triage and handoff continuity.
+- add stable runbook-link payloads in diagnostics export without coupling to foundation/reader lanes.
+
+#### M7.6 Progress Note (2026-04-16)
+
+- [Done] expanded `src/frontend/agent_workspace_runtime.js` with diagnostics deepening surfaces:
+  - `getDiagnosticsTrendSnapshot()` for replay-rate and per-operation outcome trends,
+  - `getDiagnosticsIndexSnapshot()` for turn-id and operation-id indexes,
+  - `exportDiagnosticsReport({ format })` for combined snapshot/trend/index export.
+- [Done] added stable runbook-link payloads in diagnostics report export for EN/ZH dashboard + plan/reference handoff.
+- [Done] expanded evidence coverage:
+  - `src/agent_workspace.runtime.behavior.test.ts` now asserts trend/index/export semantics,
+  - `src/agent_workspace.runtime.integration.test.ts` asserts trend/index/export diagnostics surface wiring.
+- [Done] verification evidence:
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+  - `npm run test:agent-workspace:contracts`
+
 ## Success Criteria
 
 - CI failure mode that previously blocked the three agent-workspace suites is eliminated on mainline.
@@ -246,4 +267,4 @@ Deliverables:
 
 ## Next Step
 
-Proceed to `/prompts:ce-plan` using this document as the source for `M7.2` and `M7.3` decomposition.
+Proceed to `/prompts:ce-plan` using this document as the source for `M7.7` decomposition (operator route/index persistence and CI evidence gate hardening), while preserving M7 lane boundary constraints.

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

@@ -314,6 +314,23 @@ Execution anchor:
   - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
   - `npm run test:agent-workspace:contracts`
 
+## Latest Mainline Increment (2026-04-16 M7.6 Operator Diagnostics Trend/Index/Export Lane)
+
+- Extended runtime diagnostics operators in `src/frontend/agent_workspace_runtime.js` with bounded read-only diagnostics APIs:
+  - `getDiagnosticsTrendSnapshot()` for replay-rate and per-operation outcome trends,
+  - `getDiagnosticsIndexSnapshot()` for turn-id and operation-id indexes,
+  - `exportDiagnosticsReport({ format })` for combined snapshot/trend/index export.
+- Added stable runbook-link payloads to exported diagnostics reports for operator handoff:
+  - EN/ZH development dashboards,
+  - agent conversation + focus mode plan,
+  - M7 direction requirements baseline.
+- Expanded runtime evidence:
+  - `src/agent_workspace.runtime.behavior.test.ts` now validates trend/index/export diagnostics semantics,
+  - `src/agent_workspace.runtime.integration.test.ts` now asserts diagnostics trend/index/export API wiring in runtime source.
+- Verification evidence:
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+  - `npm run test:agent-workspace:contracts`
+
 ## Mainline vs Working-Branch Snapshot (2026-04-14)
 
 | Capability Slice | Working Branch (`feat/learning-multi-tutor-adapter`) | Mainline (`origin/main`) | Integration Status |
@@ -322,7 +339,7 @@ Execution anchor:
 | Focus + learning-path side-by-side pane model | Implemented in branch UI/runtime | Dock coexistence baseline integrated (`styles.css`, `path_styles.css`, `path_app.js`) | Partially integrated |
 | Agent workspace contract parity suite | Implemented (`src/agent_workspace.contract.parity.test.ts`, `src/agent_workspace.frontend.test.ts`, `src/agent_workspace.locale.contract.test.ts`, `src/agent_workspace.tauri.contract.test.ts`) | Baseline parity suite integrated (`src/agent_workspace.contract.parity.test.ts`, `src/agent_workspace.frontend.test.ts`, `src/agent_workspace.runtime.integration.test.ts`) | Partially integrated |
 | Result-presentation allowlist/override fail-fast governance | Implemented in branch execution registry and parity tests | Integrated in M1 (`src/frontend/agent_workspace.js` + parity tests) | Baseline integrated |
-| Conversation turn stream/replay/operator diagnostics expansion | Implemented in branch routes/tests | Mainline has earlier baseline only | Partially integrated |
+| Conversation turn stream/replay/operator diagnostics expansion | Implemented in branch routes/tests | Mainline has snapshot + trend/index/export diagnostics baseline in runtime (`src/frontend/agent_workspace_runtime.js`) | Partially integrated |
 | Graphdb/ANN foundation hardening lane | Branch-oriented lane claims exist in prior docs | Mainline currently exposes file-backed store baseline (`src/learning/store.ts`) | Not integrated on mainline |
 | Markdown reader governance refactor lane | Planned and partially implemented in branch | Mainline baseline only | Partially integrated |
 

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

@@ -316,6 +316,23 @@
   - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
   - `npm run test:agent-workspace:contracts`
 
+## 主线最新增量（2026-04-16 M7.6 运维诊断趋势/索引/导出链路）
+
+- 已在 `src/frontend/agent_workspace_runtime.js` 扩展只读运维诊断 API：
+  - `getDiagnosticsTrendSnapshot()`：输出 replay 比率与按 operation 聚合的结果趋势，
+  - `getDiagnosticsIndexSnapshot()`：输出 turn-id 与 operation-id 索引视图，
+  - `exportDiagnosticsReport({ format })`：导出 snapshot/trend/index 组合报告。
+- 已在导出报告中加入稳定 runbook 链接，便于运维交接：
+  - 中英文 development dashboard，
+  - agent conversation + focus mode 交互方案页，
+  - M7 方向需求基线页。
+- 已补运行时证据：
+  - `src/agent_workspace.runtime.behavior.test.ts` 新增趋势/索引/导出语义断言，
+  - `src/agent_workspace.runtime.integration.test.ts` 新增 trend/index/export API 接线断言。
+- 验证证据：
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+  - `npm run test:agent-workspace:contracts`
+
 ## 主线 vs 工作分支快照（2026-04-14）
 
 | 能力切片 | 工作分支（`feat/learning-multi-tutor-adapter`） | 主线（`origin/main`） | 集成状态 |
@@ -324,7 +341,7 @@
 | Focus + learning-path 并排 pane 模型 | 分支已实现 | 已落入 dock 并排基线（`styles.css`、`path_styles.css`、`path_app.js`） | 部分集成 |
 | Agent workspace 合同门禁测试 | 已实现（`src/agent_workspace.contract.parity.test.ts`、`src/agent_workspace.frontend.test.ts`、`src/agent_workspace.locale.contract.test.ts`、`src/agent_workspace.tauri.contract.test.ts`） | 已落入基线门禁（`src/agent_workspace.contract.parity.test.ts`、`src/agent_workspace.frontend.test.ts`、`src/agent_workspace.runtime.integration.test.ts`） | 部分集成 |
 | 结果呈现 allowlist/override fail-fast 治理 | 分支已实现 | M1 已集成（`src/frontend/agent_workspace.js` + parity tests） | 基线已集成 |
-| conversation turn 流式/重放/诊断扩展 | 分支已扩展 | 主线仅较早基线 | 部分集成 |
+| conversation turn 流式/重放/诊断扩展 | 分支已扩展 | 主线已落入 snapshot + trend/index/export 诊断基线（`src/frontend/agent_workspace_runtime.js`） | 部分集成 |
 | graphdb/ANN 底座收敛 | 先前文档存在分支导向结论 | 主线当前为 file-backed store 基线（`src/learning/store.ts`） | 主线未集成 |
 | Markdown 阅读器治理升级 | 分支已有规划与部分实现 | 主线为旧基线 | 部分集成 |
 

src/agent_workspace.runtime.behavior.test.ts

@@ -28,6 +28,24 @@ type AgentRuntimeModule = {
             latestFocusAtomId: string;
             latestKnowledgePoints: number;
         };
+        getDiagnosticsTrendSnapshot: () => {
+            conversationRequests: number;
+            replayCandidateTurns: number;
+            userTurns: number;
+            replayCandidateRate: number;
+            operationStats: Array<Record<string, unknown>>;
+        };
+        getDiagnosticsIndexSnapshot: () => {
+            turnIndex: {
+                byTurnId: Record<string, Record<string, unknown>>;
+                replayCandidateTurnIds: string[];
+            };
+            capabilityIndex: {
+                operationIds: string[];
+                byOperationId: Record<string, Record<string, unknown>>;
+            };
+        };
+        exportDiagnosticsReport: (options?: { format?: string }) => string | Record<string, unknown>;
     };
 };
 
@@ -1633,5 +1651,60 @@ describe('agent workspace runtime behavior', () => {
                 resultPresentation: 'learning_path_card',
             })
         );
+
+        const trend = runtime.getDiagnosticsTrendSnapshot();
+        expect(trend.conversationRequests).toBe(2);
+        expect(trend.userTurns).toBe(2);
+        expect(trend.replayCandidateTurns).toBe(1);
+        expect(trend.replayCandidateRate).toBe(0.5);
+        const operationTrend = trend.operationStats.find(
+            (stats) => stats.operationId === 'build_learning_path'
+        );
+        expect(operationTrend).toEqual(
+            expect.objectContaining({
+                requestCount: 1,
+                resultCount: 1,
+                successCount: 1,
+                failureCount: 0,
+                latestStatus: 'success',
+            })
+        );
+
+        const index = runtime.getDiagnosticsIndexSnapshot();
+        expect(index.turnIndex.replayCandidateTurnIds.length).toBe(1);
+        expect(index.capabilityIndex.operationIds).toContain('build_learning_path');
+        expect(index.capabilityIndex.byOperationId.build_learning_path).toEqual(
+            expect.objectContaining({
+                requestCount: 1,
+                resultCount: 1,
+                successCount: 1,
+                failureCount: 0,
+            })
+        );
+
+        const exportedJson = runtime.exportDiagnosticsReport({ format: 'json' });
+        expect(typeof exportedJson).toBe('string');
+        const exported = JSON.parse(exportedJson as string);
+        expect(exported.snapshot).toEqual(
+            expect.objectContaining({
+                conversationRequests: 2,
+                replayCandidateTurns: 1,
+            })
+        );
+        expect(exported.trend).toEqual(
+            expect.objectContaining({
+                replayCandidateRate: 0.5,
+            })
+        );
+        expect(exported.runbookLinks).toEqual(
+            expect.arrayContaining([
+                expect.objectContaining({
+                    id: 'development-progress-dashboard',
+                }),
+                expect.objectContaining({
+                    id: 'm7-direction-requirements',
+                }),
+            ])
+        );
     });
 });

src/agent_workspace.runtime.integration.test.ts

@@ -38,6 +38,10 @@ describe('agent workspace runtime integration baseline', () => {
         expect(runtimeSource).toContain('pathApp.switchCentral(');
         expect(runtimeSource).toContain('requestBridgeWindowVisibility');
         expect(runtimeSource).toContain('getDiagnosticsSnapshot');
+        expect(runtimeSource).toContain('getDiagnosticsTrendSnapshot');
+        expect(runtimeSource).toContain('getDiagnosticsIndexSnapshot');
+        expect(runtimeSource).toContain('exportDiagnosticsReport');
+        expect(runtimeSource).toContain('DIAGNOSTIC_RUNBOOK_LINKS');
         expect(runtimeSource).toContain('__noteConnectionAgentWorkspaceRuntimeInstance');
     });