feat(agent-workspace): add escalation digest cadence and reminder suppression

Author: Jacobinwwey

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

@@ -528,6 +528,35 @@ Deliverables:
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+### M7.17 (Now): Escalation Notification Digest Cadence and Reminder Suppression Policy (Lane Ops Bridge)
+
+Deliverables:
+
+- add escalation notification-policy route exposing reminder/digest governance parameters.
+- add escalation digest route with cadence throttling and explicit `force` override.
+- add reminder suppression policy to prevent duplicate notifications under cooldown/overdue-step constraints.
+
+#### M7.17 Progress Note (2026-04-16)
+
+- [Done] expanded `src/server.ts` with escalation notification governance routes:
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy`,
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest?window=...&strategy=...&limit=...&force=...`.
+- [Done] added deterministic digest cadence persistence:
+  - `agent_workspace_diagnostics/triage_remediation_escalation_digest.v1.json` now stores `lastDigestSentAt` and bounded digest history.
+- [Done] added deterministic reminder suppression policy stack:
+  - `getAgentWorkspaceDiagnosticsRemediationEscalationNotificationPolicy(...)`,
+  - `applyAgentWorkspaceDiagnosticsRemediationEscalationReminderSuppressionPolicy(...)`,
+  - `recordAgentWorkspaceDiagnosticsRemediationEscalationDigestDispatch(...)`,
+  - `buildAgentWorkspaceDiagnosticsRemediationEscalationGovernanceContext(...)`.
+- [Done] expanded evidence coverage:
+  - `src/server.migration.test.ts` now validates notification-policy payload, reminder suppression on consecutive calls, digest cadence throttle (`first=false`, `second=true`), and `force=1` bypass.
+  - `src/knowledge.api.contract.test.ts` now fail-fast checks notification-policy/digest route contracts.
+  - `src/agent_workspace.verification.contract.test.ts` + `scripts/verify-agent-workspace-runtime.js` now fail fast on notification-policy/digest route and helper drift.
+- [Done] verification evidence:
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern "escalation SLA breach detection and overdue acknowledgement reminders stay deterministic|escalation notification-policy, digest cadence, and reminder suppression stay deterministic"`
+  - `npm run test:agent-workspace:contracts`
+  - `npm run verify:agent-workspace:runtime`
+
 ## Success Criteria
 
 - CI failure mode that previously blocked the three agent-workspace suites is eliminated on mainline.
@@ -537,4 +566,4 @@ Deliverables:
 
 ## Next Step
 
-Proceed to `/prompts:ce-plan` using this document as the source for `M7.17` decomposition (escalation notification digest cadence and reminder suppression policy), while preserving M7 lane boundary constraints.
+Proceed to `/prompts:ce-plan` using this document as the source for `M7.18` decomposition (escalation notification delivery hardening and suppression-observability expansion), while preserving M7 lane boundary constraints.

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

@@ -525,6 +525,25 @@ Execution anchor:
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+## Latest Mainline Increment (2026-04-16 M7.17 Escalation Notification Digest Cadence and Reminder Suppression Lane)
+
+- Expanded `src/server.ts` with escalation notification-governance routes:
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy`,
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest?window=...&strategy=...&limit=...&force=...`.
+- Added deterministic digest cadence persistence:
+  - `runtime_data/agent_workspace_diagnostics/triage_remediation_escalation_digest.v1.json` now stores `lastDigestSentAt` and bounded digest history.
+- Added deterministic reminder-suppression policy:
+  - cooldown suppression for recently notified escalations,
+  - overdue-step suppression when overdue growth is below configured minimum.
+- Expanded executable evidence:
+  - `src/server.migration.test.ts` now validates notification-policy payload shape, reminder suppression on consecutive calls, digest throttle cadence (`first=false`, `second=true`), and `force=1` bypass.
+- Hardened runtime verification gate:
+  - `src/knowledge.api.contract.test.ts`, `src/agent_workspace.verification.contract.test.ts`, and `scripts/verify-agent-workspace-runtime.js` now fail fast on notification-policy/digest routes and helper drift.
+- Verification evidence:
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"escalation SLA breach detection and overdue acknowledgement reminders stay deterministic|escalation notification-policy, digest cadence, and reminder suppression stay deterministic\"`
+  - `npm run test:agent-workspace:contracts`
+  - `npm run verify:agent-workspace:runtime`
+
 ## Mainline vs Working-Branch Snapshot (2026-04-14)
 
 | Capability Slice | Working Branch (`feat/learning-multi-tutor-adapter`) | Mainline (`origin/main`) | Integration Status |
@@ -573,7 +592,7 @@ This dashboard aligns against the following requirement chain:
 | L2 Retrieval | explainable hybrid/vector retrieval + governance | Expanded in branch-oriented plans | Mainline file-backed baseline only (`src/learning/store.ts`) | Re-enter lane after concrete module evidence lands on mainline |
 | L3 Learning | mastery diagnostics + path/session loop | Expanded in branch | Partially integrated | Contract and integration parity |
 | L4 Interaction | agent conversation + focus/path pane runtime | Implemented in branch | M1-M4 baseline integrated on mainline | Expand capability surface via typed contract only |
-| L5 Governance | runbook, diagnostics, replay/autonomy controls | Expanded in branch | Operator diagnostics persistence/triage/history/threshold governance + runbook automation/audit + adaptive simulation/remediation + remediation backtest/approval-gate + approval-policy hardening/regression-alarms + approval-policy drift/escalation + escalation acknowledgement lifecycle/audit + escalation SLA/reminder baseline integrated | Add escalation notification digest cadence and reminder suppression policy |
+| L5 Governance | runbook, diagnostics, replay/autonomy controls | Expanded in branch | Operator diagnostics persistence/triage/history/threshold governance + runbook automation/audit + adaptive simulation/remediation + remediation backtest/approval-gate + approval-policy hardening/regression-alarms + approval-policy drift/escalation + escalation acknowledgement lifecycle/audit + escalation SLA/reminder baseline + notification digest/suppression baseline integrated | M7.18: delivery-channel hardening and suppression observability |
 
 ## Verification Baseline
 

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

@@ -527,6 +527,25 @@
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+## 主线最新增量（2026-04-16 M7.17 升级通知摘要节奏与提醒抑制策略链路）
+
+- 已在 `src/server.ts` 增加升级通知治理路由：
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy`，
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest?window=...&strategy=...&limit=...&force=...`。
+- 已新增确定性摘要节奏持久化工件：
+  - `runtime_data/agent_workspace_diagnostics/triage_remediation_escalation_digest.v1.json` 持久化 `lastDigestSentAt` 与有界摘要历史。
+- 已新增确定性提醒抑制策略：
+  - 最近已通知升级动作按 cooldown 抑制，
+  - 逾期增量未达到最小步长时按 overdue-step 抑制。
+- 已补可执行证据：
+  - `src/server.migration.test.ts` 新增 notification-policy 载荷断言、连续提醒调用抑制断言、摘要节奏限流断言（首次不节流、二次节流）与 `force=1` 旁路断言。
+- 已加固 runtime 门禁：
+  - `src/knowledge.api.contract.test.ts`、`src/agent_workspace.verification.contract.test.ts` 与 `scripts/verify-agent-workspace-runtime.js` 新增 notification-policy/digest 路由与 helper 的 fail-fast 断言。
+- 验证证据：
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"escalation SLA breach detection and overdue acknowledgement reminders stay deterministic|escalation notification-policy, digest cadence, and reminder suppression stay deterministic\"`
+  - `npm run test:agent-workspace:contracts`
+  - `npm run verify:agent-workspace:runtime`
+
 ## 主线 vs 工作分支快照（2026-04-14）
 
 | 能力切片 | 工作分支（`feat/learning-multi-tutor-adapter`） | 主线（`origin/main`） | 集成状态 |
@@ -575,7 +594,7 @@
 | L2 检索层 | 可解释混合/向量检索 + 治理 | 分支规划增强中 | 主线当前为 file-backed 基线（`src/learning/store.ts`） | 待主线出现对应模块证据后再收敛 |
 | L3 学习层 | 掌握诊断 + 路径/会话闭环 | 分支增强中 | 主线部分集成 | 契约与集成一致性 |
 | L4 交互层 | agent 对话 + focus/path pane 运行时 | 分支已实现 | 主线 M1-M4 已落入基线 | 继续通过 typed contract 扩展动作面 |
-| L5 治理层 | runbook/诊断/回放与自动化 | 分支增强中 | 主线已集成运维诊断持久化/分级/趋势历史/阈值治理 + runbook 自动化/阈值审计 + 自适应模拟/自动修复 + 回测/批准门禁 + 批准策略硬化/回归告警 + 批准策略漂移/升级 + 升级确认生命周期/审计 + 升级 SLA/提醒基线 | 增补升级通知摘要节奏与提醒抑制策略 |
+| L5 治理层 | runbook/诊断/回放与自动化 | 分支增强中 | 主线已集成运维诊断持久化/分级/趋势历史/阈值治理 + runbook 自动化/阈值审计 + 自适应模拟/自动修复 + 回测/批准门禁 + 批准策略硬化/回归告警 + 批准策略漂移/升级 + 升级确认生命周期/审计 + 升级 SLA/提醒基线 + 通知摘要/抑制基线 | M7.18：通知交付链路硬化与抑制可观测性扩展 |
 
 ## 验证基线
 

scripts/verify-agent-workspace-runtime.js

@@ -156,6 +156,14 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
     serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders'),
     'Missing diagnostics remediation escalation reminders route in src/server.ts'
   );
+  assert(
+    serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy'),
+    'Missing diagnostics remediation escalation notification policy route in src/server.ts'
+  );
+  assert(
+    serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest'),
+    'Missing diagnostics remediation escalation digest route in src/server.ts'
+  );
   assert(
     serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/acknowledgements'),
     'Missing diagnostics remediation escalation acknowledgement route in src/server.ts'
@@ -256,6 +264,22 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
     serverSource.includes('buildAgentWorkspaceDiagnosticsRemediationEscalationSlaReport'),
     'Missing remediation escalation SLA report builder in src/server.ts'
   );
+  assert(
+    serverSource.includes('getAgentWorkspaceDiagnosticsRemediationEscalationNotificationPolicy'),
+    'Missing remediation escalation notification policy helper in src/server.ts'
+  );
+  assert(
+    serverSource.includes('recordAgentWorkspaceDiagnosticsRemediationEscalationDigestDispatch'),
+    'Missing remediation escalation digest dispatch recorder in src/server.ts'
+  );
+  assert(
+    serverSource.includes('applyAgentWorkspaceDiagnosticsRemediationEscalationReminderSuppressionPolicy'),
+    'Missing remediation escalation reminder suppression policy helper in src/server.ts'
+  );
+  assert(
+    serverSource.includes('buildAgentWorkspaceDiagnosticsRemediationEscalationGovernanceContext'),
+    'Missing remediation escalation governance context builder in src/server.ts'
+  );
   assert(
     serverSource.includes('acknowledgeAgentWorkspaceDiagnosticsRemediationEscalation'),
     'Missing remediation escalation acknowledge helper in src/server.ts'
@@ -315,12 +339,14 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
       'diagnostics remediation policy drift route exists',
       'diagnostics remediation escalation route exists',
       'diagnostics remediation escalation SLA/reminder routes exist',
+      'diagnostics remediation escalation notification policy and digest routes exist',
       'diagnostics remediation escalation acknowledgement routes exist',
       'diagnostics remediation approval routes exist',
       'diagnostics triage remediation route exists',
       'diagnostics retention governance exists',
       'diagnostics alert-threshold governance helpers exist',
       'diagnostics threshold simulation, drift, remediation, escalation, and SLA helpers exist',
+      'diagnostics escalation notification, digest cadence, and reminder suppression helpers exist',
       'diagnostics remediation policy and alarm helpers exist',
       'diagnostics threshold audit helpers exist',
       'diagnostics remediation approval trail helpers exist',

src/agent_workspace.verification.contract.test.ts

@@ -62,6 +62,8 @@ describe('agent workspace verification script contracts', () => {
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/audit');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders');
+    expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy');
+    expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/acknowledge');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approvals');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approve');
@@ -85,6 +87,10 @@ describe('agent workspace verification script contracts', () => {
     expect(runtimeSource).toContain('annotateAgentWorkspaceDiagnosticsRemediationEscalationActionsWithLifecycle');
     expect(runtimeSource).toContain('refreshAgentWorkspaceDiagnosticsRemediationEscalationMonitorTrail');
     expect(runtimeSource).toContain('buildAgentWorkspaceDiagnosticsRemediationEscalationSlaReport');
+    expect(runtimeSource).toContain('getAgentWorkspaceDiagnosticsRemediationEscalationNotificationPolicy');
+    expect(runtimeSource).toContain('recordAgentWorkspaceDiagnosticsRemediationEscalationDigestDispatch');
+    expect(runtimeSource).toContain('applyAgentWorkspaceDiagnosticsRemediationEscalationReminderSuppressionPolicy');
+    expect(runtimeSource).toContain('buildAgentWorkspaceDiagnosticsRemediationEscalationGovernanceContext');
     expect(runtimeSource).toContain('acknowledgeAgentWorkspaceDiagnosticsRemediationEscalation');
     expect(runtimeSource).toContain('requestAgentWorkspaceDiagnosticsRemediationApproval');
     expect(runtimeSource).toContain('executeAgentWorkspaceDiagnosticsAutoRemediation');

src/knowledge.api.contract.test.ts

@@ -26,6 +26,8 @@ describe('Knowledge mastery API contract wiring', () => {
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/audit',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders',
+            '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/notification-policy',
+            '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/digest',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/acknowledge',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approvals',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approve',