@shgroup/dsh-serenity-hooks 1.43.0 → 1.44.0

package/lib/{skiff-registry-FTjoWQTQ.js → skiff-registry-BjIX_KD1.js}

@@ -1,3 +1,21 @@
+import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+//#region src/constants.ts
+/** 常量（纯模块，零 DSH 依赖） */
+/**
+* ACC 版本：自动从 package.json 读取（单一真相源，消除与 CHANGELOG 的漂移）。
+* 发布时只需改 package.json 的 version。
+*/
+const ACC_VERSION = (() => {
+	try {
+		const here = dirname(fileURLToPath(import.meta.url));
+		return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf-8")).version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+})();
+//#endregion
 //#region src/skiff-registry.ts
 const skiffSessions = /* @__PURE__ */ new Map();
 /** 查 sessionId 的 Skiff 角色名（无 → null）——向后兼容（guards/seams 依赖） */
@@ -22,4 +40,4 @@ function skiffSessionSnapshot() {
 	return new Map(skiffSessions);
 }
 //#endregion
-export { unregisterSkiffSession as a, skiffSessionSnapshot as i, skiffRoleFor as n, skiffSessionInfo as r, registerSkiffSession as t };
+export { unregisterSkiffSession as a, skiffSessionSnapshot as i, skiffRoleFor as n, ACC_VERSION as o, skiffSessionInfo as r, registerSkiffSession as t };

package/lib/{skiff-role-CEHL5cek.js → skiff-role-KqQA6pkr.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as resolveInside, m as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-NlLr_sxy.js";
+import { g as resolveInside, h as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DG4Oc7I1.js";
 import { existsSync, statSync } from "node:fs";
 //#region src/skiff-role.ts
 /**

package/lib/{trajectory-bound-kxvMuCui.js → trajectory-bound-BzdzsDPI.js}

@@ -1,4 +1,4 @@
-import { r as cccRootForCwd } from "./ccc-roots-Bd_SjEs7.js";
+import { r as cccRootForCwd } from "./ccc-roots-FxWXuZPw.js";
 import { basename, dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 //#region src/time.ts

package/lib/trajectory-skills.d.ts

@@ -55,17 +55,34 @@ export declare function parseDeclaredSkills(sessionMd: string): string[];
  */
 export declare function hasTrajectorySkillsDeclaration(root: string, mdPath: string): boolean;
 /**
- * 装配注入正文（规格 §3）：按声明顺序拼接各 skill 的 `SKILL.md` 全文，每段带来源抬头
+ * 合并两条声明来源（v1.44.0）：**CCC 级在前，轨迹级追加**，同名去重取首次位置。
+ *
+ * 两条来源（owner 令 2026-09-20）：
+ *   · **CCC 级** = `.opencode/serenity.json` 的 `trajectory.skills`（本 CCC 所有轨迹共有的底座）；
+ *   · **轨迹级** = 该轨迹 `SESSION.md` frontmatter 的 `skills:`（这条轨迹额外的）。
+ *
+ * 为什么是**并集**而不是二选一（R↓）：C1 设计当初否决"纯 CCC 全局"的理由是"会**丢掉
+ * per-trajectory**"；并集把两侧都保住——容器给底座，单条轨迹仍可加自己的额外项。
+ * 为什么 CCC 级**在前**：底座先立、增量随后，与"入口身份块 order=-50 → 本 section order=-45"
+ * 的既有先后观感一致。
+ */
+export declare function mergeSkillNames(cccSkills: readonly string[], trajSkills: readonly string[]): string[];
+/**
+ * 装配注入正文（规格 §3）：按**合并后的**顺序拼接各 skill 的 `SKILL.md` 全文，每段带来源抬头
  * `=== skill: <name> ===`；拿不到全文的一律以 `[缺失]` 响亮提示占位（**不静默**）。
  *
- * 安全（规格 §3 🔒）：名字来自 CCC 数据（frontmatter）⇒ **先过 `isSafeSkillName`**；
+ * 安全（规格 §3 🔒）：名字来自 CCC 数据（frontmatter / CCC 配置）⇒ **先过 `isSafeSkillName`**；
  * 不安全 ⇒ 按缺失处理，且不调用 `findSkillMd` ⇒ **不发生任何以该名拼出的 fs 访问**。
  *
- * 长度守卫：复用已导出的 `truncateContent`，超限截断并在末尾写明 `truncated`。
+ * 长度守卫：复用已导出的 `truncateContent`，**在合并之后**统一截断（两条来源共享同一上限，
+ * 不是各给 32 KB——否则上限会随来源数翻倍）。
  *
  * @param root CCC 根
  * @param mdPath 轨迹的 SESSION.md 路径（**来自绑定的 `mdPath`**，不用 label 拼）
  * @param maxChars 总长上限（字符）
- * @returns 注入正文；无声明 → `''`（空串 = 宿主不产出该 section 块）；SESSION.md 缺失 → 响亮提示
+ * @param cccSkills CCC 级声明（`readTrajectorySkills`；缺省空 = 只有轨迹级，行为与 v1.43 一致）
+ * @returns 注入正文；两条来源皆无声明 → `''`（空串 = 宿主不产出该 section 块）；
+ *          SESSION.md 缺失/读失败 → 响亮提示（若同时有 CCC 级声明，则提示在前、正文随后——
+ *          **提示不因"别处有内容"而被吞掉**）
  */
-export declare function buildTrajectorySkillsSection(root: string, mdPath: string, maxChars?: number): string;
+export declare function buildTrajectorySkillsSection(root: string, mdPath: string, maxChars?: number, cccSkills?: readonly string[]): string;

package/lib/{wake-scheduler-DC4-imVO.js → wake-scheduler-C2GwdriD.js}

@@ -1,7 +1,7 @@
 import { r as hostService, t as hostAgents } from "./access-fiehjxV6.js";
-import { h as resolveInside } from "./ccc-NlLr_sxy.js";
-import { o as listCccs } from "./ccc-roots-Bd_SjEs7.js";
-import { D as localHuman, O as localIdStamp, T as isoLocal, b as sessionsRoot, n as listBoundSessionIds, p as findSession } from "./trajectory-bound-kxvMuCui.js";
+import { g as resolveInside } from "./ccc-DG4Oc7I1.js";
+import { o as listCccs } from "./ccc-roots-FxWXuZPw.js";
+import { D as localHuman, O as localIdStamp, T as isoLocal, b as sessionsRoot, n as listBoundSessionIds, p as findSession } from "./trajectory-bound-BzdzsDPI.js";
 import { t as readSimpleSettings } from "./settings-section-DMDUoQum.js";
 import { basename, dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
@@ -44,7 +44,7 @@ function emptyRegistry() {
 	};
 }
 /** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整表） */
-function asEntry(value) {
+function asEntry$1(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;
@@ -78,7 +78,7 @@ function loadWakeRegistry(root) {
 		const raw = Array.isArray(parsed.entries) ? parsed.entries : [];
 		const entries = [];
 		for (const item of raw) {
-			const e = asEntry(item);
+			const e = asEntry$1(item);
 			if (e) entries.push(e);
 		}
 		return {
@@ -959,6 +959,210 @@ function registerCroTurnTracking(ctx) {
 	});
 }
 //#endregion
+//#region src/cro-log.ts
+/**
+* cro-log.ts — CRO 唤起日志（**ACC 侧**，每轨迹一份固定名文件，2026-09-20 S142 §7.16）
+*
+* ## 所有者令（本模块的存在理由）
+*
+* 「S151 和 S185 的验证都说明，trajectory 倾向于自己做个结构化记录来记录自身 CRO 的执行情况，
+* 这是个结构化流水账；**我们 ACC 有必要进行 CRO 唤醒的日志记录**，当 CRO 存在时，每次**成功唤醒**
+* 写相关信息，但是保留数量要少，**只保留仅两日**的记录即可，**这个时间是程序化的**」
+* ＋「**这个日志写结构化文件到 trajectory 目录，文件名固定即可**」
+* ＋「**失败成功都记录**」。
+*
+* ## 它解决什么麻烦（白话）
+*
+* 在此之前「ACC 到底叫过谁、叫了几次、哪次**没叫成**」**ACC 自己一个字都不留** ——
+* 要查只能去读**被叫的那个程序**写的记录；程序没写 / 写坏 / 被换掉 ⇒ **这段历史就是空白**。
+* ⇒ 本模块让 ACC **自己那一侧**留一份只记两天的流水，使「唤起历史」**不再依赖被观测者是否老实**。
+*
+* ## 🔴 为什么**不是**第二真相源（本容器铁律，勿删此论证）
+*
+* 轨迹目录里因此**并排两个文件、主语各一**：
+*
+* | 文件 | 谁写 | 主语 | 回答 |
+* |---|---|---|---|
+* | `<轨迹目录>/cro-state.json`（CCC 侧程序自建，名字自定） | **CCC 的 CRO 程序** | 程序 | 「**我判了什么**」（含"没叫"的判定、心跳阈值、环境谓词） |
+* | `<轨迹目录>/cro-wake-log.json`（**本模块**） | **ACC** | ACC | 「**我把什么送出去了、送成没有**」 |
+*
+* **内容不重叠**：本模块**不复制**判定细节（不存 `lastDecision` / 阈值 / 谓词）；
+* 而程序**不可能**知道投递结果（CRO 投递是 fire-and-forget）。
+* ⇒ 两者**互补**：完整审计 = 两者合看（本模块 = 投递面｜程序状态 = 判定面）。
+*
+* ## 🔴 轮转（所有者明示「程序化的」）
+*
+* **写入时按窗裁剪**：每次落盘只保留 `at >= now - CRO_LOG_RETENTION_MS` 的条目，
+* 随后**原子写**（`tmp + rename`，与 `wake-registry.ts` 同款形态）。
+* ⇒ 清理与写入**是同一笔操作** ⇒ **结构上不存在"忘了清"的可能**（比"另设一个每 tick 的清理步"更硬：
+* 那多一个"可能忘了跑"的面）。窗宽是**常量**，**无配置键、无人工清理动作**。
+*
+* ## 🔴 铁律（与 `cro.ts` 同族）
+*
+* **本模块的每个导出函数都不抛错**：写盘 / 裁剪 / 解析失败一律返回结构化失败，
+* 由调用方只记一行 tick 日志 ⇒ **CRO 流水的问题绝不影响投递与既有链路**（设计 §5）。
+*
+* ## 保留量级（实测，非估计）
+*
+* 实测最高 = S185 的 40min 心跳（≈36 条/天）；两天窗 ⇒ **≤ ~80 条、< 20 KB**。
+* 最坏（某程序每 5min 都叫）⇒ 288 条/天 ⇒ 两天 **≤ ~600 条、< 100 KB** —— 轮转**自带上限**。
+*/
+/** 固定文件名（所有者令：「文件名固定即可」）——与程序自建的 `cro-state.json` 并排、主语分明 */
+const CRO_LOG_FILENAME = "cro-wake-log.json";
+/** 保留窗 = 2 日（所有者令「只保留仅两日」）；**常量** ⇒ 「这个时间是程序化的」 */
+const CRO_LOG_RETENTION_MS = 1728e5;
+const CRO_LOG_VERSION = 1;
+/** 日志绝对路径 */
+function croWakeLogPath(root, dirName) {
+	return join(sessionsRoot(root), dirName, CRO_LOG_FILENAME);
+}
+function emptyLog() {
+	return {
+		version: CRO_LOG_VERSION,
+		entries: []
+	};
+}
+/** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整档） */
+function asEntry(value) {
+	const e = value;
+	if (!e || typeof e !== "object") return null;
+	if (typeof e.at !== "string" || e.at === "") return null;
+	if (typeof e.ok !== "boolean") return null;
+	if (typeof e.detail !== "string") return null;
+	const digest = e.promptDigest ?? {};
+	return {
+		at: e.at,
+		ok: e.ok,
+		detail: e.detail,
+		tick: typeof e.tick === "number" ? e.tick : 0,
+		reason: typeof e.reason === "string" ? e.reason : null,
+		promptDigest: {
+			length: typeof digest.length === "number" ? digest.length : 0,
+			head: typeof digest.head === "string" ? digest.head : ""
+		}
+	};
+}
+/** 提示词摘要（长度 + 前 N 字；超长不截断标记——长度字段本身就是信号） */
+function summarizeCroPrompt(prompt) {
+	const text = typeof prompt === "string" ? prompt : "";
+	return {
+		length: [...text].length,
+		head: [...text].slice(0, 80).join("")
+	};
+}
+/**
+* 读取日志（**永不抛**；读坏 ⇒ 当作空档 + 返回 error 文本）。
+* @param root CCC 根
+* @param dirName 轨迹目录名
+*/
+function loadCroWakeLog(root, dirName) {
+	const path = croWakeLogPath(root, dirName);
+	if (!existsSync(path)) return {
+		log: emptyLog(),
+		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 {
+			log: {
+				version: CRO_LOG_VERSION,
+				entries
+			},
+			error: null
+		};
+	} catch (err) {
+		return {
+			log: emptyLog(),
+			error: `CRO 流水解析失败（${String(err?.message ?? err)}）`
+		};
+	}
+}
+/**
+* 按窗裁剪（**纯函数** ⇒ 可穷举测试）。
+*
+* 判据：`Date.parse(at) >= nowMs - windowMs` 保留；反之丢弃。
+* 🔴 **`at` 不可解析者一律丢弃**（本模块只写 `isoLocal()` 产物 ⇒ 不可解析 = 被手改或损坏），
+* **并在返回值里报数**（`dropped`）——**不静默吞掉**（本容器反复栽的"安静失败"纪律）。
+*/
+function pruneCroLogEntries(entries, nowMs, windowMs = CRO_LOG_RETENTION_MS) {
+	const floor = nowMs - windowMs;
+	const kept = [];
+	let pruned = 0;
+	let dropped = 0;
+	for (const e of entries) {
+		const t = Date.parse(e.at);
+		if (Number.isNaN(t)) {
+			dropped += 1;
+			continue;
+		}
+		if (t >= floor) kept.push(e);
+		else pruned += 1;
+	}
+	return {
+		kept,
+		pruned,
+		dropped
+	};
+}
+/**
+* 追加一条唤起记录并按窗裁剪（**本模块主入口；永不抛**）。
+*
+* 顺序 = 读 → 追加 → 裁剪 → **原子写**。任一步失败 ⇒ `{ok:false, error}`，
+* **不抛**（调用方只记一行 tick 日志；**绝不影响投递**）。
+*
+* 无 CRO 的轨迹**不会**因本函数产生文件：只有真的发生过一次唤起尝试才会建/写该档
+* （所有者令「**当 CRO 存在时**」）。
+*
+* @param root CCC 根
+* @param dirName 轨迹目录名
+* @param input 本次唤起尝试（成败都记）
+* @param nowMs 当前毫秒（可注入 ⇒ 便于测裁剪边界）
+* @returns 写入结果与裁剪计数
+*/
+function appendCroWakeLog(root, dirName, input, nowMs = Date.now()) {
+	const path = croWakeLogPath(root, dirName);
+	try {
+		const loaded = loadCroWakeLog(root, dirName);
+		const entry = {
+			at: isoLocal(nowMs),
+			ok: input.ok,
+			detail: input.detail,
+			tick: input.tick,
+			reason: input.reason,
+			promptDigest: summarizeCroPrompt(input.prompt)
+		};
+		const { kept, pruned, dropped } = pruneCroLogEntries([...loaded.log.entries, entry], nowMs);
+		mkdirSync(dirname(path), { recursive: true });
+		const tmp = `${path}.tmp`;
+		writeFileSync(tmp, `${JSON.stringify({
+			version: CRO_LOG_VERSION,
+			entries: kept
+		}, null, 2)}\n`, "utf-8");
+		renameSync(tmp, path);
+		return {
+			ok: true,
+			error: null,
+			kept: kept.length,
+			pruned,
+			dropped
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: `CRO 流水写入失败（${String(err?.message ?? err)}）`,
+			kept: 0,
+			pruned: 0,
+			dropped: 0
+		};
+	}
+}
+//#endregion
 //#region src/clock-runtime.ts
 /**
 * clock-runtime.ts — **时钟运行时工厂**（S142 §38 复审候选 C6b，路径 **P2**）
@@ -1594,6 +1798,16 @@ async function runCroPhase(ctx, root, registry, log) {
 			wakes += 1;
 			const res = await deliverCroWake(ctx, root, dirName, outcome.prompt, outcome.decision.reason);
 			log.push(`· ${root}: ${renderCroOutcome(dirName, outcome)} → ${res.ok ? "已投递" : `投递未成功：${res.detail}`}`);
+			if (!res.notReady) {
+				const rec = appendCroWakeLog(root, dirName, {
+					ok: res.ok,
+					detail: res.detail,
+					tick: s.ticks,
+					reason: outcome.decision.reason ?? null,
+					prompt: outcome.prompt
+				}, nowMs);
+				if (!rec.ok) log.push(`· ${root}: ${dirName}: CRO 流水写入失败（已忽略，不影响投递）: ${rec.error}`);
+			}
 		} else if (outcome.status === "skipped") {
 			skips += 1;
 			log.push(`· ${root}: ${renderCroOutcome(dirName, outcome)}`);

package/lib/{weixin-route-B2ajFypI.js → weixin-route-CWMRa36W.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-NlLr_sxy.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DG4Oc7I1.js";
 import { join, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.43.0",
+  "version": "1.44.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": {