@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.0

package/lib/client.js

@@ -4788,13 +4788,15 @@ Instruction-following style:
 			const acpOn = value?.acpEnabled ?? false;
 			const acpPort = value?.acpHttpPort ?? 3100;
 			const publicAskOn = value?.publicAskEnabled ?? false;
-			const autopilotOn = value?.autopilotEnabled ?? false;
+			const autopilotOn = value?.autopilotWakeEnabled ?? value?.autopilotEnabled ?? false;
+			const wakeSchedOn = value?.wakeSchedulerEnabled ?? true;
 			const [openGateway, setOpenGateway] = (0, react.useState)(false);
 			const [openRebuild, setOpenRebuild] = (0, react.useState)(false);
 			const [openSkiff, setOpenSkiff] = (0, react.useState)(false);
 			const [openAcp, setOpenAcp] = (0, react.useState)(false);
 			const [openPublicAsk, setOpenPublicAsk] = (0, react.useState)(false);
 			const [openAutopilot, setOpenAutopilot] = (0, react.useState)(false);
+			const [openWakeSched, setOpenWakeSched] = (0, react.useState)(false);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "ss-section",
 				children: [
@@ -4832,7 +4834,7 @@ Instruction-following style:
 						title: "上下文",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 							title: "超限重建",
-							desc: "上下文接近上限时提示调用 logbook rebuild 清空重建",
+							desc: "上下文接近上限时提示调用 container_trajectory rebuild 清空重建",
 							expandable: true,
 							open: openRebuild,
 							onToggle: setOpenRebuild,
@@ -4845,7 +4847,7 @@ Instruction-following style:
 								className: "ss-detailStack",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 									className: "ss-detailIntro",
-									children: "上下文超限自动重建（logbook rebuild，v1.30 起并入 logbook）：\n· 机制：agent 上下文占用达到阈值时，由 LLM 主动调用重建\n· 语义：完全丢弃当前 dsh 会话 + 自动新建 + 注入「继续原 SESSION 的工作」\n· 效果：SESSION.md 原位不动，认知轨迹延续，上下文归零\n· 关闭后：上下文超限时不再提示，可能导致会话卡顿或丢失"
+									children: "上下文超限自动重建（container_trajectory rebuild，v1.33 起 logbook 并入 trajectory）：\n· 机制：agent 上下文占用达到阈值时，由 LLM 主动调用重建\n· 语义：完全丢弃当前 dsh 会话 + 自动新建 + 注入「继续原 SESSION 的工作」\n· 效果：SESSION.md 原位不动，认知轨迹延续，上下文归零\n· 关闭后：上下文超限时不再提示，可能导致会话卡顿或丢失"
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 									title: "重建阈值",
 									desc: "上下文占用达到该 K 数值时提示（单位 K token，默认 400）",
@@ -4941,22 +4943,40 @@ Instruction-following style:
 								})
 							}) }),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
-								title: "Autopilot Trajectory",
-								desc: "自动巡航轨迹（全局开关，默认关——只在指定电脑开启）",
+								title: "周期自唤醒（autopilot）",
+								desc: "定时唤起 autopilot 轨迹（全局开关，默认关——只在指定电脑开启）",
 								expandable: true,
 								open: openAutopilot,
 								onToggle: setOpenAutopilot,
 								control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
 									checked: autopilotOn,
-									onChange: (on) => toggle("autopilotEnabled", on)
+									onChange: (on) => toggle("autopilotWakeEnabled", on)
 								}),
 								detail: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "ss-detailStack",
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 										className: "ss-detailIntro",
-										children: "Autopilot Trajectory 全局总开关（v1.27.9）：\n· 作用：控制本机（本 dsh 实例）是否运行自动巡航轨迹\n· 默认关：未开启即使 CCC 配置 enabled=true 也不启动定时器\n· 定位：多台电脑装 dsp 时，只在指定电脑开启（其余默认关）\n· 双重门控：全局开关 AND CCC 级 enabled 都满足才运行\n· CCC 级配置（interval/session/偏见脚本/焦点）不受影响"
+										children: "周期自唤醒全局闸（v1.34 更名收窄，原 Autopilot Trajectory 全局总开关）：\n· 作用：控制本机（本 dsh 实例）是否运行**周期**自动巡航唤起\n· 语义边界：**只管周期自唤醒** —— 关掉它不影响一次性唤醒（wake-later，见下一行）\n· 默认关：未开启即使 CCC 配置 enabled=true 也不启动定时器\n· 定位：多台电脑装 dsp 时，只在指定电脑开启（其余默认关）\n· 双重门控：本开关 AND CCC 级 enabled 都满足才运行\n· CCC 级配置（interval/session/偏见脚本/焦点）不受影响"
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AutopilotTrajectoryStatusBlock, { autopilotOn })]
 								})
+							}) }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
+								title: "唤醒调度器（wake-later）",
+								desc: "投递已登记的“未来时刻 + 一条 message”（全局开关，默认开）",
+								expandable: true,
+								open: openWakeSched,
+								onToggle: setOpenWakeSched,
+								control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
+									checked: wakeSchedOn,
+									onChange: (on) => toggle("wakeSchedulerEnabled", on)
+								}),
+								detail: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "ss-detailStack",
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+										className: "ss-detailIntro",
+										children: "唤醒调度器全局闸（v1.34 新增独立开关）：\n· 作用：把 CCC 唤醒注册表（AGENT_SESSIONS/wake-registry.json）里到点的条目投递给目标轨迹\n· 条目来源：`container_trajectory wake-later`（对自己或别的 trajectory 预约未来时刻 + 一条 message）\n· 默认开：条目全部由人类/agent 显式登记，无环境自主性 ⇒ 不需要“默认关”的实验保护\n· 与上一行**互不连带**：关掉周期自唤醒不会关掉本调度器（用户 2026-09-15 裁决）\n· 精度：5min tick；补跑窗口 2h（超窗判 missed 留痕）；fire-and-forget 无回执"
+									})
+								})
 							}) })
 						]
 					}),
@@ -5261,7 +5281,7 @@ Instruction-following style:
 						className: "ss-rowCard",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefList, { items: [{
 							term: "唤醒注册表",
-							value: wakes.length === 0 ? "无条目（agent 用 trajectory wake-add 登记：未来时刻 + 一条 message）" : `${wakes.filter((w) => w.state === "pending").length} 条在办 / 共 ${wakes.length} 条`
+							value: wakes.length === 0 ? "无条目（agent 用 container_trajectory wake-later 登记：未来时刻 + 一条 message）" : `${wakes.filter((w) => w.state === "pending").length} 条在办 / 共 ${wakes.length} 条`
 						}, ...wakes.slice(0, 5).map((w) => ({
 							term: w.state === "pending" ? "· 待唤醒" : `· ${w.state}`,
 							value: `${new Date(w.at).toLocaleString()} → ${w.target}${w.lastResult ? `（${w.lastResult}）` : ""}`

package/lib/diag-ops.d.ts

@@ -0,0 +1,61 @@
+/**
+ * diag-ops.ts — `acc-diag` 报告装配（v1.33，S142 §32.11）
+ *
+ * 为什么单独成模块（R↓）：工具面（`tools/acc-diag.ts`）只做"取 CCC 根 + 渲染"，
+ * 装配逻辑放这里 ⇒ 纯函数可单测、不依赖 DSH 工具注册。
+ *
+ * 为什么**无动作参数**：诊断是低频动作（§32.9 收敛取向），一次调用即出全报告，
+ * 不需要子命令面；动作越多，模型选择成本越高。
+ *
+ * 四段内容（数据来源各自单一真相源，本模块只聚合不复制语义）：
+ *   ① live 运行态 —— 插件进程内 `diagLive(ctx)`（live 会话清单 + 各 autopilot CCC 的
+ *      目标命中 / agent 定位诊断）——**脚本侧看不到运行时**，这正是本工具存在的理由
+ *   ② 面板解析 —— `diagLive.panelResolved`（无参面板请求会落到哪个 CCC）
+ *   ③ 唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+ *   ④ 唤起条件链 —— 包内脚本 `diag`（`runAutopilotScript(root,'diag')`）：逐条件值 + 阻断点 + 修复建议
+ */
+import { type DiagLiveReport, autopilotClockState } from './autopilot-trajectory.js';
+import { wakeSchedulerState } from './wake-scheduler.js';
+import type { Context } from 'cordis';
+/** 进程内时钟状态（唤醒调度器 / autopilot 时钟；判据各自单一真相源） */
+type ClockState = ReturnType<typeof wakeSchedulerState> | ReturnType<typeof autopilotClockState>;
+export interface AccDiagReport {
+    /** 调用方会话所属 CCC 根（脚本诊断的目标） */
+    ccc: string;
+    live: DiagLiveReport;
+    /**
+     * 进程内两个时钟的武装状态（2026-09-14 F 段缺陷**新暴露面**）。
+     * 为什么必须有（R↓）：此前"条目为何滞留在 pending"无法从报告回答——④ 段只算**配置**条件，
+     * 而真正的原因可能在"时钟根本没在跑"这一层。有了它，同类故障一眼可判。
+     */
+    clocks: {
+        wake: ClockState;
+        autopilot: ClockState;
+    };
+    wakes: {
+        /** 注册表文件路径问题（读不到时非空——不得静默） */
+        error: string | null;
+        entries: Array<{
+            id: string;
+            target: string;
+            at: string;
+            state: string;
+            createdBy: string;
+            attempts: number;
+            lastResult: string | null;
+        }>;
+        pending: number;
+    };
+    /** 唤起条件链（脚本输出原文；失败时给出错误文本，不吞） */
+    autopilotChain: string;
+}
+/**
+ * 装配报告（一次调用即全报告）。
+ * @param ctx 插件上下文（进程内读 sessions/agents）
+ * @param root 调用方 CCC 根（脚本诊断目标）
+ * @returns 结构化报告（渲染由 {@link renderAccDiag} 负责）
+ */
+export declare function runAccDiag(ctx: Context, root: string): AccDiagReport;
+/** 人读渲染（四段；空段也要显式说明"无"，避免"沉默 = 一切正常"的误读） */
+export declare function renderAccDiag(r: AccDiagReport): string;
+export {};

package/lib/index.d.ts

@@ -4,7 +4,7 @@
  * 形态（DSH 官方 native hook 约定）：name / inject / Config / apply，无 default export。
  *
  * 能力：
- *   1. 真实 DSH 工具注册：container_fs（文件系统 15 子命令，含 reveal）、logbook（会话全周期含 rebuild）
+ *   1. 真实 DSH 工具注册：container_fs（文件系统 15 子命令，含 reveal）、container_trajectory（轨迹生命周期 + 一次性安排，含 rebuild）
  *   2. 拦截缝机械约束：tools/pre-execute + ctx.tools.guard（安全模式/黑名单/路径守卫）
  *
  * 加载：~/.dsh/config.yaml 加 insert 行（免改 DSH 源码），插件包装入 DSH node_modules。