@shgroup/dsh-serenity-hooks 1.41.0 → 1.42.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.41.0",
+  "version": "1.42.0",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag；后两个按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2（deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/diag-ops.d.ts

@@ -11,7 +11,9 @@
  *   ①  live 运行态 —— 插件进程内 `diagLive(ctx)`（进程 cwd/CCC + live 会话清单）
  *       ——**独立进程看不到运行时**，这正是本工具存在的理由
  *   ①b 唤醒时钟 —— `containerClocks().wake`（唤醒调度器进程内快照：武装态/计数/上次跳过原因）
- *   ③  唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+ *   ③  唤醒注册表 —— `wake-registry.json` 的**在办条目**（state / at / target / lastResult）+ 补跑窗口
+ *       （🔴 2026-09-19 §0Q 甲案：终态条目**结案即清除** ⇒ 本段只列在办项，不再是"历史全量"；
+ *        历史由 SESSION.md / 工具输出承担——该承诺原本就写在 `wake-registry.ts` 注释里，本次做实）
  *
  * ── 2026-09-15：段数由四降为三（S142「ACC 侧 autopilot 退场」§1 二阶裁定）─────────────
  * ACC 侧 autopilot 整段退场后，报告里两段的**主语消失**，故删除（不是"暂时关掉"）：

package/lib/index.js

@@ -7,7 +7,7 @@ import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPE
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-CEHL5cek.js";
 import { a as unregisterSkiffSession$1, i as skiffSessionSnapshot$1, n as skiffRoleFor$1, r as skiffSessionInfo$1, t as registerSkiffSession$1 } from "./skiff-registry-FTjoWQTQ.js";
 import { r as sessionsRootDir, t as hasSessionLogById } from "./session-cleanup-BtkSmry8.js";
-import { a as WAKE_CATCH_UP_MS, i as registerDisposer, n as sendToTrajectory, o as addWake, r as wakeSchedulerState, s as listWakes, t as registerWakeScheduler } from "./wake-scheduler-BRnPUnER.js";
+import { a as WAKE_CATCH_UP_MS, i as registerDisposer, n as sendToTrajectory, o as addWake, r as wakeSchedulerState, s as listWakes, t as registerWakeScheduler } from "./wake-scheduler-1AsvNQPW.js";
 import { a as FACE_PORTS, c as MECHANISM_PORTS, i as ACP_HTTP_PORT, l as SKIFF_DEBUG_PORT, n as registerSettingsSection, o as GATEWAY_PORT, s as MAIN_WEB_PORT, t as readSimpleSettings, u as WEIXIN_SEND_PORT } from "./settings-section-DMDUoQum.js";
 import { a as markdownToPlainText, c as sendTyping, i as getUpdates, l as sniffImageExt, n as downloadMedia, o as sendFileMessage, r as getConfig, s as sendTextMessage, t as TypingStatus } from "./weixin-api-CtFYm53S.js";
 import z from "@deepseek-ai/schemastery";
@@ -14557,7 +14557,9 @@ function containerStatus(opts = {}) {
 *   ①  live 运行态 —— 插件进程内 `diagLive(ctx)`（进程 cwd/CCC + live 会话清单）
 *       ——**独立进程看不到运行时**，这正是本工具存在的理由
 *   ①b 唤醒时钟 —— `containerClocks().wake`（唤醒调度器进程内快照：武装态/计数/上次跳过原因）
-*   ③  唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+*   ③  唤醒注册表 —— `wake-registry.json` 的**在办条目**（state / at / target / lastResult）+ 补跑窗口
+*       （🔴 2026-09-19 §0Q 甲案：终态条目**结案即清除** ⇒ 本段只列在办项，不再是"历史全量"；
+*        历史由 SESSION.md / 工具输出承担——该承诺原本就写在 `wake-registry.ts` 注释里，本次做实）
 *
 * ── 2026-09-15：段数由四降为三（S142「ACC 侧 autopilot 退场」§1 二阶裁定）─────────────
 * ACC 侧 autopilot 整段退场后，报告里两段的**主语消失**，故删除（不是"暂时关掉"）：
@@ -14632,10 +14634,11 @@ function renderAccDiag(r) {
 	lines.push("");
 	lines.push(renderClock("唤醒调度器（wake-registry tick）", r.clocks.wake));
 	lines.push("");
-	lines.push(`── ③ 唤醒注册表（${r.ccc}/AGENT_SESSIONS/wake-registry.json）──`);
+	lines.push(`── ③ 唤醒注册表（在办项；已结案条目即时清除，历史见 SESSION.md）──`);
+	lines.push(`  （${r.ccc}/AGENT_SESSIONS/wake-registry.json）`);
 	if (r.wakes.error) lines.push(`⚠ 注册表读取问题: ${r.wakes.error}`);
 	lines.push(`条目: ${r.wakes.entries.length} 条（在办 ${r.wakes.pending}）｜补跑窗口 ${WAKE_CATCH_UP_MS / 36e5}h`);
-	if (r.wakes.entries.length === 0) lines.push("（无条目）");
+	if (r.wakes.entries.length === 0) lines.push("（无在办条目）");
 	for (const w of r.wakes.entries) {
 		lines.push(`  · ${w.id} [${w.state}] at=${w.at} → ${w.target} by=${w.createdBy} attempts=${w.attempts}`);
 		if (w.lastResult) lines.push(`      lastResult: ${w.lastResult}`);

package/lib/wake-registry.d.ts

@@ -118,8 +118,61 @@ export declare function splitDueWakes(registry: WakeRegistry, nowMs: number, cat
     due: WakeEntry[];
     expired: WakeEntry[];
 };
+/**
+ * 🔴 结案并**移除**一条（owner 2026-09-19 裁定「**直接删**」，S142 §0Q 甲案）。
+ *
+ * ## 为什么删（R↓）
+ *
+ * 本模块原本是「`pending` → 终态」但**终态条目永不移除** ⇒ 文件**只增**（实测 308 KB / 143+ 条）。
+ * owner 明令「应当**唤醒后就清理**的」⇒ 终态即删。
+ *
+ * **审计不丢**：由 **SESSION.md 与工具输出**承担——这正是本文件 `removeWake` 的既有注释承诺
+ * （*"审计由 SESSION.md 与工具输出承担——注册表只保留在办项"*）。
+ * ⚠️ 此前该承诺**并未兑现**（`updateWake` 只改 state 从不删行）⇒ 本次是**把承诺做实**。
+ *
+ * ## 与 `updateWake` 的分工（**别混用**）
+ *
+ * - `updateWake`：**仍在办**的推进（失败重试 `state:'pending'` + `attempts+1`）⇒ **保留行**；
+ * - `finalizeWake`：**不再办**的归宿（投递成功 / 超窗 missed）⇒ 写终态后**同一笔事务里删掉**。
+ *
+ * 🔴 **为什么两个动作要同一次写盘**：若先 `updateWake(delivered)` 再 `removeWake`，
+ * 中间被打断会留下一条"已终结但没删"的条目 ⇒ 又回到只增。
+ * 故本函数**读一次、改一次、删一次、写一次**（单次原子落盘）。
+ *
+ * @param root CCC 根
+ * @param id 条目 id
+ * @param terminal 终态（`delivered` / `missed` / `cancelled`）——写入仅用于**日志文案**，
+ *                 随即整行移除；保留该参数是为了让调用点语义自明（"它归到哪一档了"）。
+ * @param result 人读结果（进日志，不进表）
+ * @returns `removed` = 被移除的条目（供调用方打印"它是什么"）；不存在 → 稳定错误码
+ */
+export declare function finalizeWake(root: string, id: string, terminal: 'delivered' | 'missed' | 'cancelled', result: string): {
+    ok: boolean;
+    error: string | null;
+    removed: WakeEntry | null;
+};
+/**
+ * 一次性清除**存量终态条目**（`delivered` / `missed` / `cancelled`）。
+ *
+ * ## 为什么需要（不是可选）
+ *
+ * 本函数上线前，表里已积压 143+ 条终态记录（308 KB）⇒ **只改行为不改存量 = 文件不再涨但仍很大**。
+ * 故首次运行须清一次。**幂等**（无终态条目时空转，不写盘）。
+ *
+ * 审计不丢：与 `finalizeWake` 同理（终态本就属性"已结案"，其史由 SESSION.md 承担）。
+ * @param root CCC 根
+ * @returns 清掉几条（0 = 本来就没有）
+ */
+export declare function purgeFinalizedWakes(root: string): {
+    ok: boolean;
+    error: string | null;
+    purged: number;
+};
 /**
  * 更新一条（状态推进；调用方给最终状态与结果文案）。
+ *
+ * ⚠️ **只用于"仍在办"的推进**（主要是失败重试）。**终态请用 `finalizeWake`**——
+ * 否则该行会永远留下（这正是本表过去只增的根因，见 `finalizeWake` 注释）。
  * @param root CCC 根
  * @param id 条目 id
  * @param patch 要写入的字段

package/lib/{wake-scheduler-BRnPUnER.js → wake-scheduler-1AsvNQPW.js}

@@ -230,7 +230,109 @@ function splitDueWakes(registry, nowMs, catchUpMs = WAKE_CATCH_UP_MS) {
 	};
 }
 /**
+* 🔴 结案并**移除**一条（owner 2026-09-19 裁定「**直接删**」，S142 §0Q 甲案）。
+*
+* ## 为什么删（R↓）
+*
+* 本模块原本是「`pending` → 终态」但**终态条目永不移除** ⇒ 文件**只增**（实测 308 KB / 143+ 条）。
+* owner 明令「应当**唤醒后就清理**的」⇒ 终态即删。
+*
+* **审计不丢**：由 **SESSION.md 与工具输出**承担——这正是本文件 `removeWake` 的既有注释承诺
+* （*"审计由 SESSION.md 与工具输出承担——注册表只保留在办项"*）。
+* ⚠️ 此前该承诺**并未兑现**（`updateWake` 只改 state 从不删行）⇒ 本次是**把承诺做实**。
+*
+* ## 与 `updateWake` 的分工（**别混用**）
+*
+* - `updateWake`：**仍在办**的推进（失败重试 `state:'pending'` + `attempts+1`）⇒ **保留行**；
+* - `finalizeWake`：**不再办**的归宿（投递成功 / 超窗 missed）⇒ 写终态后**同一笔事务里删掉**。
+*
+* 🔴 **为什么两个动作要同一次写盘**：若先 `updateWake(delivered)` 再 `removeWake`，
+* 中间被打断会留下一条"已终结但没删"的条目 ⇒ 又回到只增。
+* 故本函数**读一次、改一次、删一次、写一次**（单次原子落盘）。
+*
+* @param root CCC 根
+* @param id 条目 id
+* @param terminal 终态（`delivered` / `missed` / `cancelled`）——写入仅用于**日志文案**，
+*                 随即整行移除；保留该参数是为了让调用点语义自明（"它归到哪一档了"）。
+* @param result 人读结果（进日志，不进表）
+* @returns `removed` = 被移除的条目（供调用方打印"它是什么"）；不存在 → 稳定错误码
+*/
+function finalizeWake(root, id, terminal, result) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error,
+		removed: null
+	};
+	const idx = registry.entries.findIndex((e) => e.id === id);
+	if (idx < 0) return {
+		ok: false,
+		error: `wake_not_found: ${id}`,
+		removed: null
+	};
+	const [removed] = registry.entries.splice(idx, 1);
+	const saved = saveWakeRegistry(root, registry);
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error,
+		removed: null
+	};
+	return {
+		ok: true,
+		error: null,
+		removed: {
+			...removed,
+			state: terminal,
+			lastResult: result
+		}
+	};
+}
+/**
+* 一次性清除**存量终态条目**（`delivered` / `missed` / `cancelled`）。
+*
+* ## 为什么需要（不是可选）
+*
+* 本函数上线前，表里已积压 143+ 条终态记录（308 KB）⇒ **只改行为不改存量 = 文件不再涨但仍很大**。
+* 故首次运行须清一次。**幂等**（无终态条目时空转，不写盘）。
+*
+* 审计不丢：与 `finalizeWake` 同理（终态本就属性"已结案"，其史由 SESSION.md 承担）。
+* @param root CCC 根
+* @returns 清掉几条（0 = 本来就没有）
+*/
+function purgeFinalizedWakes(root) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error,
+		purged: 0
+	};
+	const kept = registry.entries.filter((e) => e.state === "pending");
+	const purged = registry.entries.length - kept.length;
+	if (purged === 0) return {
+		ok: true,
+		error: null,
+		purged: 0
+	};
+	const saved = saveWakeRegistry(root, {
+		...registry,
+		entries: kept
+	});
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error,
+		purged: 0
+	};
+	return {
+		ok: true,
+		error: null,
+		purged
+	};
+}
+/**
 * 更新一条（状态推进；调用方给最终状态与结果文案）。
+*
+* ⚠️ **只用于"仍在办"的推进**（主要是失败重试）。**终态请用 `finalizeWake`**——
+* 否则该行会永远留下（这正是本表过去只增的根因，见 `finalizeWake` 注释）。
 * @param root CCC 根
 * @param id 条目 id
 * @param patch 要写入的字段
@@ -801,6 +903,8 @@ async function runWakeTick(ctx) {
 	}
 	clock.noteSkipReason(null);
 	for (const root of roots) {
+		const purged = purgeFinalizedWakes(root);
+		if (purged.ok && purged.purged > 0) log.push(`· ${root}: 清除 ${purged.purged} 条已结案记录（存量首清）`);
 		const { registry, error } = loadWakeRegistry(root);
 		if (error) {
 			log.push(`✗ ${root}: ${error}`);
@@ -808,11 +912,8 @@ async function runWakeTick(ctx) {
 		}
 		const { due, expired } = splitDueWakes(registry, Date.now(), WAKE_CATCH_UP_MS);
 		for (const e of expired) {
-			updateWake(root, e.id, {
-				state: "missed",
-				lastResult: `超过补跑窗口（${WAKE_CATCH_UP_MS / 36e5}h）未投递`
-			});
-			log.push(`· ${root}: ${e.id} → missed（超补跑窗口）`);
+			finalizeWake(root, e.id, "missed", `超过补跑窗口（${WAKE_CATCH_UP_MS / 36e5}h）未投递`);
+			log.push(`· ${root}: ${e.id} → missed（超补跑窗口，已清除）`);
 		}
 		for (const e of due) {
 			const res = await deliverWake(ctx, root, e);
@@ -820,13 +921,17 @@ async function runWakeTick(ctx) {
 				log.push(`· ${root}: ${e.id} → 跳过（宿主服务未就绪，下个 tick 再试；不计失败）`);
 				continue;
 			}
-			updateWake(root, e.id, {
-				state: res.ok ? "delivered" : "pending",
-				attempts: e.attempts + 1,
-				lastResult: res.detail,
-				deliveredAt: res.ok ? isoLocal() : null
-			});
-			log.push(`· ${root}: ${e.id} → ${res.ok ? "delivered" : `重试（${res.detail}）`}`);
+			if (res.ok) {
+				finalizeWake(root, e.id, "delivered", res.detail);
+				log.push(`· ${root}: ${e.id} → delivered（已清除）`);
+			} else {
+				updateWake(root, e.id, {
+					state: "pending",
+					attempts: e.attempts + 1,
+					lastResult: res.detail
+				});
+				log.push(`· ${root}: ${e.id} → 重试（${res.detail}）`);
+			}
 		}
 	}
 	return log;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.41.0",
+  "version": "1.42.0",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2。",
   "license": "MIT",
   "repository": {