From e6bec37b1a567b4940c8a63c6b4ee4ffbf9eddbe Mon Sep 17 00:00:00 2001
From: Chen Gu <guchen@MBKPro.lan>
Date: Tue, 10 Mar 2026 09:42:47 +0800
Subject: [PATCH] chore(heartbeat): add autonomous TODO inspection and
 escalation logic

---
 HEARTBEAT.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/HEARTBEAT.md b/HEARTBEAT.md
index 61431c5..0c1efb9 100644
--- a/HEARTBEAT.md
+++ b/HEARTBEAT.md
@@ -24,6 +24,24 @@
 - 需要主动触达时：直接给用户发送自然消息，不要输出 HEARTBEAT_OK。
 - 若本轮不需要触达：回复 HEARTBEAT_OK。
 
+### TODO 自动巡检逻辑（Val 自主执行）
+
+1. 每次 heartbeat 先读取：`TODO.md` 与 `memory/heartbeat-state.json`。
+2. 对 `status != done` 的任务执行检查：
+   - 若当前时间 >= `next_check_at`：标记“到期检查”
+   - 若 `escalate_if_overdue=true` 且超时未更新：立即升级提醒
+3. 巡检后更新：
+   - 任务的 `last_checked_at`
+   - 按 `check_interval` 推进 `next_check_at`
+   - `memory/heartbeat-state.json` 的 `todoWatch.lastScanAt/nextScanAt`
+4. 升级文案统一三段：
+   - 任务：`id + title`
+   - 状态：`当前进度 / 阻塞点 / 风险等级`
+   - 建议：`1 条立即动作 + 1 条兜底动作`
+5. 夜间静默（23:00-08:00）默认不主动升级，除非：
+   - P0 任务明确超时
+   - 或用户明确要求实时播报
+
 ---
 
 ## 每日 ArXiv 简报任务（新增）