feat(agent-workspace): add escalation SLA breach reminders

Author: Jacobinwwey

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

@@ -500,6 +500,34 @@ Deliverables:
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+### M7.16 (Now): Escalation SLA Breach Detection and Overdue Acknowledgement Reminders (Lane Ops Bridge)
+
+Deliverables:
+
+- add deterministic escalation SLA breach detection for overdue acknowledgement and overdue resolution windows.
+- add overdue reminder surface for unresolved remediation escalation actions.
+- persist escalation monitor trail to preserve first-detected timestamps for SLA evaluation.
+
+#### M7.16 Progress Note (2026-04-16)
+
+- [Done] expanded `src/server.ts` with escalation SLA/reminder routes:
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla?window=...&strategy=...&limit=...`,
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders?window=...&strategy=...&limit=...`.
+- [Done] added deterministic escalation monitor + SLA helper stack:
+  - `refreshAgentWorkspaceDiagnosticsRemediationEscalationMonitorTrail(...)`,
+  - `buildAgentWorkspaceDiagnosticsRemediationEscalationSlaReport(...)`,
+  - persisted monitor artifact: `agent_workspace_diagnostics/triage_remediation_escalation_monitor.v1.json`.
+- [Done] extended escalation route observability:
+  - `/triage/remediation/escalation` now emits `slaSummary` derived from current SLA report.
+- [Done] expanded evidence coverage:
+  - `src/server.migration.test.ts` now validates stale escalation monitor seeding, ack-overdue SLA breach detection, reminder payload semantics, and monitor trail persistence invariants.
+  - `src/knowledge.api.contract.test.ts` now fail-fast checks escalation SLA/reminder route contracts.
+  - `src/agent_workspace.verification.contract.test.ts` + `scripts/verify-agent-workspace-runtime.js` now fail fast on SLA/reminder helper and route drift.
+- [Done] verification evidence:
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern "triage route summarizes replay risk|triage history and alert-threshold governance|adaptive threshold simulation and remediation guardrails|remediation backtest and approval-gate flow|approval policy hardening and remediation trend-regression alarms|approval-policy drift detection and alarm-to-runbook escalation stay deterministic|escalation acknowledgement lifecycle and runbook-action status audit trail stay deterministic|escalation SLA breach detection and overdue acknowledgement reminders 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.
@@ -509,4 +537,4 @@ Deliverables:
 
 ## Next Step
 
-Proceed to `/prompts:ce-plan` using this document as the source for `M7.16` decomposition (escalation SLA breach detection and overdue acknowledgement reminders), while preserving M7 lane boundary constraints.
+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.

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

@@ -504,6 +504,27 @@ Execution anchor:
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+## Latest Mainline Increment (2026-04-16 M7.16 Escalation SLA Breach Detection and Overdue Reminder Lane)
+
+- Expanded `src/server.ts` with escalation SLA/reminder routes:
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla?window=...&strategy=...&limit=...`,
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders?window=...&strategy=...&limit=...`.
+- Added deterministic escalation monitor + SLA helpers:
+  - persisted monitor trail for first-detected timestamps,
+  - overdue acknowledgement breach detection,
+  - overdue resolution breach detection,
+  - reminder synthesis for overdue escalation actions.
+- Extended escalation observability:
+  - `/triage/remediation/escalation` now emits `slaSummary` for immediate governance visibility.
+- Extended executable evidence:
+  - `src/server.migration.test.ts` now validates stale monitor seeding, SLA breach payload semantics, overdue reminder payloads, and monitor persistence invariants.
+- 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 escalation SLA/reminder routes and helper drift.
+- Verification evidence:
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"triage route summarizes replay risk|triage history and alert-threshold governance|adaptive threshold simulation and remediation guardrails|remediation backtest and approval-gate flow|approval policy hardening and remediation trend-regression alarms|approval-policy drift detection and alarm-to-runbook escalation stay deterministic|escalation acknowledgement lifecycle and runbook-action status audit trail stay deterministic|escalation SLA breach detection and overdue acknowledgement reminders 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 |
@@ -552,7 +573,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 baseline integrated | Add escalation SLA breach detection and overdue acknowledgement reminders |
+| 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 |
 
 ## Verification Baseline
 

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

@@ -506,6 +506,27 @@
   - `npm run test:agent-workspace:contracts`
   - `npm run verify:agent-workspace:runtime`
 
+## 主线最新增量（2026-04-16 M7.16 升级 SLA 超时检测与逾期提醒链路）
+
+- 已在 `src/server.ts` 增加升级 SLA/提醒路由：
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla?window=...&strategy=...&limit=...`，
+  - `GET /api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/reminders?window=...&strategy=...&limit=...`。
+- 已新增确定性升级监控 + SLA helper 栈：
+  - 升级 monitor 轨迹持久化（首检时间保留），
+  - 逾期确认超时检测，
+  - 逾期解决超时检测，
+  - 逾期提醒动作合成。
+- 已扩展升级可观测性：
+  - `/triage/remediation/escalation` 输出新增 `slaSummary`，用于治理面即时判断超时态势。
+- 已补可执行证据：
+  - `src/server.migration.test.ts` 新增 stale monitor 注入、SLA breach 载荷断言、逾期提醒载荷断言与 monitor 落盘不变量断言。
+- 已加固 runtime 门禁：
+  - `src/knowledge.api.contract.test.ts`、`src/agent_workspace.verification.contract.test.ts` 与 `scripts/verify-agent-workspace-runtime.js` 新增 escalation SLA/reminder 路由与 helper 的 fail-fast 断言。
+- 验证证据：
+  - `npm test -- src/server.migration.test.ts --runInBand --testNamePattern \"triage route summarizes replay risk|triage history and alert-threshold governance|adaptive threshold simulation and remediation guardrails|remediation backtest and approval-gate flow|approval policy hardening and remediation trend-regression alarms|approval-policy drift detection and alarm-to-runbook escalation stay deterministic|escalation acknowledgement lifecycle and runbook-action status audit trail stay deterministic|escalation SLA breach detection and overdue acknowledgement reminders 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`） | 集成状态 |
@@ -554,7 +575,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/提醒基线 | 增补升级通知摘要节奏与提醒抑制策略 |
 
 ## 验证基线
 

scripts/verify-agent-workspace-runtime.js

@@ -148,6 +148,14 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
     serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation'),
     'Missing diagnostics remediation escalation route in src/server.ts'
   );
+  assert(
+    serverSource.includes('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/sla'),
+    'Missing diagnostics remediation escalation SLA route in src/server.ts'
+  );
+  assert(
+    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/acknowledgements'),
     'Missing diagnostics remediation escalation acknowledgement route in src/server.ts'
@@ -240,6 +248,14 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
     serverSource.includes('annotateAgentWorkspaceDiagnosticsRemediationEscalationActionsWithLifecycle'),
     'Missing remediation escalation lifecycle annotator in src/server.ts'
   );
+  assert(
+    serverSource.includes('refreshAgentWorkspaceDiagnosticsRemediationEscalationMonitorTrail'),
+    'Missing remediation escalation monitor refresher in src/server.ts'
+  );
+  assert(
+    serverSource.includes('buildAgentWorkspaceDiagnosticsRemediationEscalationSlaReport'),
+    'Missing remediation escalation SLA report builder in src/server.ts'
+  );
   assert(
     serverSource.includes('acknowledgeAgentWorkspaceDiagnosticsRemediationEscalation'),
     'Missing remediation escalation acknowledge helper in src/server.ts'
@@ -298,12 +314,13 @@ function verifyAgentWorkspaceRuntime(repoRoot = path.resolve(__dirname, '..')) {
       'diagnostics remediation policy route exists',
       'diagnostics remediation policy drift route exists',
       'diagnostics remediation escalation route exists',
+      'diagnostics remediation escalation SLA/reminder 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, and escalation helpers exist',
+      'diagnostics threshold simulation, drift, remediation, escalation, and SLA 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

@@ -60,6 +60,8 @@ describe('agent workspace verification script contracts', () => {
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation');
     expect(runtimeSource).toContain('/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/acknowledgements');
     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/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');
@@ -81,6 +83,8 @@ describe('agent workspace verification script contracts', () => {
     expect(runtimeSource).toContain('readAgentWorkspaceDiagnosticsRemediationEscalationAuditTrail');
     expect(runtimeSource).toContain('appendAgentWorkspaceDiagnosticsRemediationEscalationAuditEntry');
     expect(runtimeSource).toContain('annotateAgentWorkspaceDiagnosticsRemediationEscalationActionsWithLifecycle');
+    expect(runtimeSource).toContain('refreshAgentWorkspaceDiagnosticsRemediationEscalationMonitorTrail');
+    expect(runtimeSource).toContain('buildAgentWorkspaceDiagnosticsRemediationEscalationSlaReport');
     expect(runtimeSource).toContain('acknowledgeAgentWorkspaceDiagnosticsRemediationEscalation');
     expect(runtimeSource).toContain('requestAgentWorkspaceDiagnosticsRemediationApproval');
     expect(runtimeSource).toContain('executeAgentWorkspaceDiagnosticsAutoRemediation');

src/knowledge.api.contract.test.ts

@@ -24,6 +24,8 @@ describe('Knowledge mastery API contract wiring', () => {
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/escalation/acknowledgements',
             '/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/acknowledge',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approvals',
             '/api/knowledge/operator/agent-workspace-diagnostics/triage/remediation/approve',