@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.0

package/lib/wake-registry-D0Vj0WXb.js

@@ -0,0 +1,270 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/wake-registry.ts
+/**
+* wake-registry.ts — trajectory 唤醒注册表（D58，S142 2026-09-13）
+*
+* 需求（用户原话）：一个 CCC 内允许多个 trajectory 任意形态并行；某个 trajectory 可以
+* **预定未来唤醒自己或别人**，本质上是一次「未来时刻 + 一条 message」的投递；autopilot
+* 是「周期自唤醒」的特例（独立循环，D59）。协作边界：互相可见、**无阻塞无等待**。
+*
+* 本模块只负责**注册表本身**（纯数据层，无宿主依赖，可单测）：
+*  - 落点：CCC 内 `AGENT_SESSIONS/wake-registry.json`（随 CCC git，人可读可审计）
+*  - 状态机：`pending` →（投递成功）`delivered`｜（超补跑窗口）`missed`｜（`wake rm` 物理移除）
+*  - 投递即终结：一次性，不重投（无回执语义——发起方不 await，见设计文档 §2）
+*
+* 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
+*/
+var wake_registry_exports = /* @__PURE__ */ __exportAll({
+	WAKE_CATCH_UP_MS: () => WAKE_CATCH_UP_MS,
+	WAKE_REGISTRY_REL_PATH: () => WAKE_REGISTRY_REL_PATH,
+	WAKE_REGISTRY_VERSION: () => 1,
+	addWake: () => addWake,
+	listWakes: () => listWakes,
+	loadWakeRegistry: () => loadWakeRegistry,
+	newWakeId: () => newWakeId,
+	parseWakeAt: () => parseWakeAt,
+	saveWakeRegistry: () => saveWakeRegistry,
+	splitDueWakes: () => splitDueWakes,
+	updateWake: () => updateWake,
+	wakeRegistryPath: () => wakeRegistryPath
+});
+/** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
+const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
+/**
+* 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
+* 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
+*/
+const WAKE_CATCH_UP_MS = 72e5;
+/** 注册表绝对路径 */
+function wakeRegistryPath(root) {
+	return join(root, WAKE_REGISTRY_REL_PATH);
+}
+/** 空注册表 */
+function emptyRegistry() {
+	return {
+		version: 1,
+		entries: []
+	};
+}
+/** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整表） */
+function asEntry(value) {
+	const e = value;
+	if (!e || typeof e.id !== "string" || typeof e.target !== "string") return null;
+	if (typeof e.at !== "string" || typeof e.message !== "string") return null;
+	const state = e.state === "delivered" || e.state === "missed" || e.state === "cancelled" ? e.state : "pending";
+	return {
+		id: e.id,
+		target: e.target,
+		at: e.at,
+		message: e.message,
+		state,
+		createdBy: typeof e.createdBy === "string" ? e.createdBy : "",
+		createdAt: typeof e.createdAt === "string" ? e.createdAt : "",
+		attempts: typeof e.attempts === "number" && Number.isFinite(e.attempts) ? e.attempts : 0,
+		lastResult: typeof e.lastResult === "string" ? e.lastResult : null,
+		deliveredAt: typeof e.deliveredAt === "string" ? e.deliveredAt : null
+	};
+}
+/**
+* 读注册表。文件缺失 → 空表；损坏 → 空表 + error（不抛错，调用方决定是否告警）。
+* @param root CCC 根
+* @returns 注册表与读取错误（无错为 null）
+*/
+function loadWakeRegistry(root) {
+	const path = wakeRegistryPath(root);
+	if (!existsSync(path)) return {
+		registry: emptyRegistry(),
+		error: null
+	};
+	try {
+		const parsed = JSON.parse(readFileSync(path, "utf-8"));
+		const raw = Array.isArray(parsed.entries) ? parsed.entries : [];
+		const entries = [];
+		for (const item of raw) {
+			const e = asEntry(item);
+			if (e) entries.push(e);
+		}
+		return {
+			registry: {
+				version: 1,
+				entries
+			},
+			error: null
+		};
+	} catch (err) {
+		return {
+			registry: emptyRegistry(),
+			error: `唤醒注册表解析失败（${String(err?.message ?? err)}）`
+		};
+	}
+}
+/** 原子写（tmp + rename；与 .bindings.json 同款形态） */
+function saveWakeRegistry(root, registry) {
+	const path = wakeRegistryPath(root);
+	try {
+		mkdirSync(dirname(path), { recursive: true });
+		const tmp = `${path}.tmp`;
+		writeFileSync(tmp, `${JSON.stringify({
+			version: 1,
+			entries: registry.entries
+		}, null, 2)}\n`, "utf-8");
+		renameSync(tmp, path);
+		return {
+			ok: true,
+			error: null
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: `唤醒注册表写入失败（${String(err?.message ?? err)}）`
+		};
+	}
+}
+/** 条目 id：`w-<UTC 到分钟>-<4 hex>`（可读 + 低碰撞；不复用由"物理移除"保证） */
+function newWakeId(nowMs, rand = Math.random) {
+	const iso = new Date(nowMs).toISOString();
+	return `w-${`${iso.slice(0, 10).replace(/-/g, "")}-${iso.slice(11, 16).replace(":", "")}`}-${Math.floor(rand() * 65536).toString(16).padStart(4, "0")}`;
+}
+/**
+* 解析唤醒时刻。接受两种写法（设计文档 §7）：
+*  - 绝对：RFC3339（含时区偏移，如 `2026-09-14T09:00:00+08:00`）
+*  - 相对：`+30m` / `+2h`（便于 agent 直接登记"半小时后"）
+* @param input 用户/agent 传入的时刻串
+* @param nowMs 当前时刻（相对写法基准）
+* @returns `{ ok, ms }` 或 `{ ok: false, error }`
+*/
+function parseWakeAt(input, nowMs) {
+	const raw = input.trim();
+	if (raw === "") return {
+		ok: false,
+		error: "时刻为空"
+	};
+	const rel = /^\+(\d+(?:\.\d+)?)([mhd])$/.exec(raw);
+	if (rel) {
+		const n = Number(rel[1]);
+		const unit = rel[2];
+		return {
+			ok: true,
+			ms: nowMs + n * (unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5)
+		};
+	}
+	const ms = Date.parse(raw);
+	if (!Number.isFinite(ms)) return {
+		ok: false,
+		error: `时刻无法解析（须 RFC3339 或 +30m/+2h）: ${raw}`
+	};
+	return {
+		ok: true,
+		ms
+	};
+}
+/**
+* 登记一条唤醒。
+* @param root CCC 根
+* @param input 目标 trajectory / 时刻串 / message / 发起者 / 当前时刻
+* @returns 成功返回条目，失败返回稳定错误文案（不抛错）
+*/
+function addWake(root, input) {
+	const target = input.target.trim();
+	if (target === "") return {
+		ok: false,
+		error: "target 为空（须 S### 或 AGENT_SESSIONS 目录名）"
+	};
+	const message = input.message.trim();
+	if (message === "") return {
+		ok: false,
+		error: "message 为空（唤醒必须携带一条信息）"
+	};
+	const parsed = parseWakeAt(input.at, input.nowMs);
+	if (!parsed.ok) return {
+		ok: false,
+		error: parsed.error
+	};
+	if (parsed.ms <= input.nowMs) return {
+		ok: false,
+		error: "时刻必须在未来（唤醒只允许可预期的未来）"
+	};
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error
+	};
+	const entry = {
+		id: newWakeId(input.nowMs),
+		target,
+		at: new Date(parsed.ms).toISOString(),
+		message,
+		state: "pending",
+		createdBy: input.createdBy,
+		createdAt: new Date(input.nowMs).toISOString(),
+		attempts: 0,
+		lastResult: null,
+		deliveredAt: null
+	};
+	registry.entries.push(entry);
+	const saved = saveWakeRegistry(root, registry);
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error ?? "写入失败"
+	};
+	return {
+		ok: true,
+		entry
+	};
+}
+/**
+* 到期切分（纯函数，可单测）：
+*  - `due`：`state === 'pending'` 且 `now >= at`（在补跑窗口内）→ 应投递
+*  - `expired`：`state === 'pending'` 且 `now - at > catchUpMs` → 应置 missed（不投递）
+* @param registry 注册表
+* @param nowMs 当前时刻
+* @param catchUpMs 补跑窗口
+*/
+function splitDueWakes(registry, nowMs, catchUpMs = WAKE_CATCH_UP_MS) {
+	const due = [];
+	const expired = [];
+	for (const e of registry.entries) {
+		if (e.state !== "pending") continue;
+		const at = Date.parse(e.at);
+		if (!Number.isFinite(at) || nowMs < at) continue;
+		if (nowMs - at > catchUpMs) expired.push(e);
+		else due.push(e);
+	}
+	return {
+		due,
+		expired
+	};
+}
+/**
+* 更新一条（状态推进；调用方给最终状态与结果文案）。
+* @param root CCC 根
+* @param id 条目 id
+* @param patch 要写入的字段
+* @returns 写入结果
+*/
+function updateWake(root, id, patch) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error
+	};
+	const entry = registry.entries.find((e) => e.id === id);
+	if (!entry) return {
+		ok: false,
+		error: `wake_not_found: ${id}`
+	};
+	Object.assign(entry, patch);
+	return saveWakeRegistry(root, registry);
+}
+/** 列条目（默认全量；`pendingOnly` 只列在办项——面板/工具用） */
+function listWakes(root, opts = {}) {
+	const { registry, error } = loadWakeRegistry(root);
+	return {
+		entries: [...opts.pendingOnly ? registry.entries.filter((e) => e.state === "pending") : registry.entries].sort((a, b) => Date.parse(a.at) - Date.parse(b.at)),
+		error
+	};
+}
+//#endregion
+export { splitDueWakes as a, loadWakeRegistry as i, addWake as n, updateWake as o, listWakes as r, wake_registry_exports as s, WAKE_CATCH_UP_MS as t };

package/lib/wake-scheduler.d.ts

@@ -17,7 +17,8 @@
  *     → `sessionController` 缺席（headless profile）⇒ 仅投递 live 目标，**不静默**
  *  4. 投递：`agent.followup(...)`（"Queue an ordinary follow-up turn and wake the driver"）
  *
- * 守卫（I-4 默认）：全局 `trajectoryEnabled`（旧键 `autopilotEnabled` 回退）｜
+ * 守卫（I-4 默认 + v1.34 S-1 解耦）：全局 `wakeSchedulerEnabled`（**缺省开**；**不再**回退旧键
+ * `autopilotEnabled`——关周期自唤醒不得连带关一次性唤醒）｜
  * 补跑窗口 2h（超窗置 missed 留痕）｜同 tick 串行｜唤起后维持 live（人类可介入）。
  */
 import type { Context } from 'cordis';
@@ -28,6 +29,33 @@ export interface WakeDeliveryResult {
     ok: boolean;
     detail: string;
 }
+/**
+ * 调度器**进程态**（诊断用，模块级 = 进程级，正是诊断对象）。
+ *
+ * 为什么需要它（R↓，2026-09-14 F 段缺陷）：调度器此前**没有任何可观测面**——
+ * "条目为何一直是 pending" 只能靠反推。有了这四个字段，`acc-diag` 一次调用即可回答
+ * "时钟是否武装 / 上次 tick 何时 / 为何跳过"。
+ */
+interface WakeSchedulerRuntime {
+    /** 定时器是否在跑（startTimer 成功 → true；disposer 拆卸 → false） */
+    armed: boolean;
+    /** 武装时刻（ms；null = 从未） */
+    armedAt: number | null;
+    /** 上次真正执行 tick 的时刻（ms；null = 从未——被跳过的 tick 不刷新它） */
+    lastTickAt: number | null;
+    /** 真正执行过多少次 tick */
+    ticks: number;
+    /** 上次 tick 的逐行摘要（投递 / missed 留痕） */
+    lastTickLog: string[];
+    /** 上次被跳过 / 异常的原因（null = 上次正常执行） */
+    lastSkipReason: string | null;
+}
+/** 调度器进程态快照（只读；`enabled` = 全局闸**当前**值，便于区分"未武装"与"闸关"） */
+export declare function wakeSchedulerState(): WakeSchedulerRuntime & {
+    enabled: boolean;
+};
+/** 测试用：复位进程态（避免用例间串味） */
+export declare function __resetWakeSchedulerStateForTest(): void;
 /** 目标定位：目录名 + SESSION.md 绝对路径 */
 interface WakeTarget {
     dirName: string;
@@ -40,7 +68,18 @@ interface WakeTarget {
  * @returns 命中返回目录信息，未命中 null
  */
 export declare function resolveWakeTarget(root: string, target: string): WakeTarget | null;
-/** 全局闸：`trajectoryEnabled` 优先，旧键 `autopilotEnabled` 回退（设置服务不可用 → 关） */
+/**
+ * 全局闸：**只看 `wakeSchedulerEnabled`**（缺省**开**；显式 `false` 才关）。
+ *
+ * ⚠️ 2026-09-15 用户裁决（S-1 **解耦**）：「auto-trajectory 的开关**只关闭 auto-trajectory 唤醒**」。
+ * ⇒ 本函数**不得**再把 `autopilotEnabled`（周期自唤醒闸）作为回退键 —— 旧实现是
+ * `trajectoryEnabled === true || autopilotEnabled === true`，后果实测：所有者关掉 auto-trajectory 后，
+ * **一次性唤醒 `wake-later` 被连带关掉**，注册表条目静默滞留（当日 6.6h 零 tick）。
+ * 缺省由 false 改 true 的理由：唤醒注册表已是一等机制（D58），条目**全部由人类/agent 显式登记**
+ * 未来时刻（无环境自主性），不需要"默认关"的实验保护；代价 = 一个 unref 的 5min 空检查。
+ *
+ * 设置服务不可用 → 关（保守；异常由日志与 `dashboard health` 响亮暴露，不静默）。
+ */
 export declare function wakeSchedulerEnabled(): boolean;
 /**
  * 取目标 agent：live 优先 → 冷会话走 sessionController.resolveAgent → 标题回退。

package/lib/{weixin-route-wWk4AIwV.js → weixin-route-D1ND823E.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-eu_IPF94.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { createHash } from "node:crypto";

package/package.json

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

package/lib/tools/autopilot-trajectory.d.ts

@@ -1,25 +0,0 @@
-/**
- * autopilot-trajectory.ts — Autopilot Trajectory 一站式管理工具（v1.26.12 实验
- * autotrajectory-exp → v1.27.4 正式化改名）
- *
- * 定位：dsp **只提供工具与知识**，不向 CCC 自动安装任何东西（机制是 CCC 的自选动作）——
- * agent 调本工具（doc/全报告）即懂机制，init/random/check 辅助，
- * 实际执行（写配置/写偏见脚本/标记会话）由 CCC 自己决定、自己用现有工具完成。
- *
- * 实现：薄封装——exec 包内静态脚本（npm files 含 experiments/），脚本是单一真相源。
- * 环境注入 SERENITY_ROOT（当前 CCC 根）供脚本定位；bun 优先（可直跑 TS）。
- * diag-live：**进程内诊断**（v1.26.14 用户"排查访问不到"）——闭包捕获 ctx，
- * 直接读 live 会话/标题/agent（脚本 diag 看不到运行时），输出实例级诊断报告。
- */
-import { defineTool } from '@deepseek-ai/dsh-tools';
-import type { Context } from 'cordis';
-/**
- * 定位包内脚本（npm files 分发 experiments/autopilot-trajectory/）。
- * 布局差异：tsdown bundle 后 import.meta.url 指向 lib/index.js（lib → 包根 1 层）；
- * vitest 源码直跑时指向 src/tools/x.ts（src/tools → 包根 2 层）——逐级上溯查找，
- * 两种布局都稳（找到 experiments/autopilot-trajectory/scripts/autopilot-trajectory.ts 即止）。
- */
-export declare function findExpScript(startDir: string): string | null;
-export declare const AUTOPILOT_ACTIONS: readonly ["all", "init", "random", "diag", "doc", "check", "status", "guide", "diag-live", "wake-add", "wake-list", "wake-rm"];
-/** 创建 trajectory 工具（原 autopilot-trajectory；D58 更名 + 唤醒注册表三动作） */
-export declare function createAutopilotTool(ctx: Context): ReturnType<typeof defineTool>;