@shgroup/dsh-serenity-hooks 1.74.0 → 1.75.0

package/lib/index.js

@@ -1,10 +1,10 @@
 import { i as __toESM, n as __exportAll } from "./rolldown-runtime-B4iAMlE-.js";
-import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-B2t_aM8L.js";
+import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-BVxn97dY.js";
 import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, g as readUtf8, h as readSafeModeHiddenTools, i as findGitRoot, l as pathInside, m as readExclusiveTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readCognitiveTrajectorySkills, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-CyYJL4F2.js";
-import { A as sessionsRoot, C as namingTitleFor, D as readTrajectoryUid, E as readActiveSessionMd, F as isoLocal, I as localFileStamp, L as localHuman, M as showSession, N as summarize, O as resolveSessionByTitle, P as useSession, R as localIdStamp, S as listSessions, T as parseTrajectoryCode, _ as extractSessionMdPathFromText, a as readTrajectoryConstraintAt, c as registerTrajectorySession$1, d as COGNITIVE_TRAJECTORY_ACTIONS, f as DEFAULT_SESSION_SCOPE, g as createSession, h as clearActiveSessionInfo, j as setActiveSessionInfo, k as sessionEvents$1, l as trajectoryDirNameForSession, m as archiveSession, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, p as UID_FILENAME, r as listTrajectoryConstraints, s as trajectoryConstraintForSession, t as TRAJECTORY_CONSTRAINT_FILENAME, u as unregisterTrajectorySession$1, v as findSession, w as parseSessionContextFromEvents, x as listActiveTrajectories, y as getActiveSessionInfo } from "./profile-BVt84mbi.js";
+import { A as sessionsRoot, B as localHuman, C as namingTitleFor, D as readTrajectoryUid, E as readActiveSessionMd, F as TRAJECTORY_FILENAME, I as TRAJECTORY_LEGACY_FILENAMES, L as readTrajectoryFile, M as showSession, N as summarize, O as resolveSessionByTitle, P as useSession, R as isoLocal, S as listSessions, T as parseTrajectoryCode, V as localIdStamp, _ as extractSessionMdPathFromText, a as readTrajectoryConstraintAt, c as registerTrajectorySession$1, d as COGNITIVE_TRAJECTORY_ACTIONS, f as DEFAULT_SESSION_SCOPE, g as createSession, h as clearActiveSessionInfo, j as setActiveSessionInfo, k as sessionEvents$1, l as trajectoryDirNameForSession, m as archiveSession, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, p as UID_FILENAME, r as listTrajectoryConstraints, s as trajectoryConstraintForSession, t as TRAJECTORY_CONSTRAINT_FILENAME, u as unregisterTrajectorySession$1, v as findSession, w as parseSessionContextFromEvents, x as listActiveTrajectories, y as getActiveSessionInfo, z as localFileStamp } from "./profile-Cz4oBXlI.js";
 import { _ as runLocalStore, a as readFeishuCredential, d as weixinSessionIdForTrajectory, f as LOCALSTORE_SCOPES, g as readStore, h as readGitTrack, i as matchWeixinRoute, l as sanitizeFileName$1, m as localstorePath, n as extractWeixinText, o as readWeixinCredential, p as checkLocalstoreGitCompliance, r as hasVoiceItem, s as readWeixinSettings, t as extractWeixinMedia, u as weixinInboundDir } from "./route-COOFLTpU.js";
-import { a as buildTrajectoryBasePrompt, c as createProfilePromptReader, d as resolveConstraintSystemPrompt, f as ACC_VERSION, i as TRAJECTORY_CONSTRAINT_HINT, l as profileMsmWhitelist, n as readSimpleSettings, o as constraintCognitiveTrajectory, p as findPackageRoot, r as registerSettingsSection, s as constraintSystemPromptSource, u as profileToolWhitelist } from "./settings-D8hlqxua.js";
-import { a as pruneMissingBindings, c as setBindingStore, i as listBoundSessionIds, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND } from "./message-source-DCpoRHP3.js";
+import { a as buildTrajectoryBasePrompt, c as createProfilePromptReader, d as resolveConstraintSystemPrompt, f as ACC_VERSION, i as TRAJECTORY_CONSTRAINT_HINT, l as profileMsmWhitelist, n as readSimpleSettings, o as constraintCognitiveTrajectory, p as findPackageRoot, r as registerSettingsSection, s as constraintSystemPromptSource, u as profileToolWhitelist } from "./settings-CII0Y597.js";
+import { a as pruneMissingBindings, c as setBindingStore, i as listBoundSessionIds, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND } from "./message-source-JhN-qyfn.js";
 import { REGISTERED_TOOLS } from "./invariant.js";
 import { c as sendTextMessage, i as getUpdates, l as sendTyping, n as downloadMedia, o as markdownToPlainText, r as getConfig, s as sendFileMessage, t as TypingStatus, u as sniffImageExt } from "./ilink-BMk2w2KY.js";
 import { a as registerImAccountImpl, i as normalizeAccountChannel, n as getImAccountImpl, r as imAccountChannels } from "./accounts-BHQbakUh.js";
@@ -994,6 +994,68 @@ function weixinSendEndpoint() {
 	return endpoint;
 }
 //#endregion
+//#region src/tools/config-docs.ts
+/**
+* 渲染**目录**（第一层）。
+*
+* 🔴 只调 `summary`，**绝不调 `render`** —— 目录若触发正文，就退化成"整份长文"。
+* 这条不是性能优化，是**判据**：它保证 `docs` 的输出大小与章数成正比，与正文长度无关。
+*/
+function renderDocsIndex(chapters) {
+	const lines = [
+		"═══ CCC 配置说明 · 目录 ═══",
+		"",
+		"说明类内容已超过单次返回的合适篇幅 ⇒ 先读目录，再按章取详情。",
+		"",
+		"用法：container_admin config docs <章节>",
+		""
+	];
+	for (const ch of chapters) lines.push(`  ${ch.id.padEnd(14)}${ch.summary}`);
+	lines.push("");
+	lines.push("旧入口（msm catalog / msm ccc-config / config guide）**降为指针**，只指路、不再返回正文。");
+	return lines.join("\n");
+}
+/**
+* 解析一个章节参数（第二层）。
+*
+* 不存在 ⇒ 返回 `null`，由调用方给出**带候选清单**的拒绝 ——
+* "不知道这个章节" 与 "这一章是空的" 必须可区分（否则用户以为功能没有）。
+*/
+function findDocsChapter(chapters, id) {
+	const want = id.trim().toLowerCase();
+	if (want === "") return null;
+	return chapters.find((c) => c.id.toLowerCase() === want) ?? null;
+}
+/**
+* **指针文案**（v1.75.0，owner 裁 Q3「指针」）——被降级的旧入口共用这一份。
+*
+* ## 为什么要有"指针"这个形态（而不是直接删掉旧入口）
+*
+* 旧入口的名字（`msm catalog` / `msm ccc-config` / `config guide`）**已经写在 CCC 侧的
+* 文档与提示词里**，硬删会让它们全部变成"未知动作"，而且**没有任何机械信号**告诉我们
+* 哪份文档已经说谎了（本仓 D151 同族）。
+*
+* ⇒ 保留名字、只换返回内容：调用方能**自己顺着指针找到正文**，而正文仍然只有一份。
+*
+* 🔴 **必须只有一处实现**：`container-admin.ts`（config 域）与 `msm/service.ts`（msm 域）
+* 都要用它。两处各写一份文案 ⇒ 措辞漂移（本仓反复踩过的形态）。
+*
+* @param chapter 正文所在的章 id
+* @param what 这个入口原来叫什么（进标题，让调用方一眼确认自己找对了）
+*/
+function docsPointer(chapter, what) {
+	return [
+		`═══ ${what} — 正文已统一 ═══`,
+		"",
+		`正文在：container_admin config docs ${chapter}`,
+		"",
+		"为什么改（v1.75.0，owner 裁「指针」）：这个内容此前有**两个**正文入口，",
+		"而它们返回同一份常量 ⇒ 两个真相源。现在「一个内容一个正文入口」，本入口只指路。",
+		"",
+		"索引（不知道还有哪些章）：container_admin config docs"
+	].join("\n");
+}
+//#endregion
 //#region src/tools/msm/service.ts
 /**
 * tools/msm/service.ts — msm 纯操作层（acc_msm → msm 执行 + container_admin 管理面，v1.30；零 DSH 依赖）
@@ -1069,6 +1131,10 @@ const NPX_BIN = process.platform === "win32" ? "npx.cmd" : "npx";
 * 目录在前、详情各归各——**单一真相源**：本目录只索引"去哪个工具/子命令看详情"，不复制详情
 * （避免 container_admin/weixin-doctor 等 guide 全文重复 → 多真相源 → 失同步）。
 * 后续新增功能只需在此加一行（低熵可演进）。
+*
+* 🔴 **2026-10-19 v1.75.0 起导出**：它是 `container_admin config docs catalog` 那一章的正文。
+* `msm catalog` 动作**降为指针**（只指路，不再返回本常量）—— 否则同一份正文会有两个入口，
+* 而"两个入口返回同一份内容"正是本目录自己反对的形态。
 */
 const ACC_CATALOG = `═══ ACC Usage Catalog ═══
 Directory of ACC capabilities — each area lists where to go for details (guides live with their feature; this catalog only points).
@@ -1552,7 +1618,7 @@ function runMsm(root, args) {
 			return `${header}\n` + lines.join("\n");
 		}
 		case "guide": return { guide: MSM_GUIDE };
-		case "catalog": return { catalog: ACC_CATALOG };
+		case "catalog": return { catalog: docsPointer("catalog", "ACC 能力目录") };
 		case "exec": {
 			const { entry, businessArgs, fmtJson, hasHelp, protocol } = prepareExec(root, args);
 			const p = protocolResult(protocol);
@@ -1676,7 +1742,7 @@ function runMsm(root, args) {
 			}
 			throw new Error(`MSM not registered: "${name}"`);
 		}
-		case "ccc-config": return CCC_CONFIG_REFERENCE;
+		case "ccc-config": return docsPointer("config", "CCC 配置参考");
 		case "check": return checkRegistryQuality(root);
 		default: throw new Error(`Unknown action: ${args.action}`);
 	}
@@ -4079,7 +4145,7 @@ const TRAJECTORY_PRESET = "standard";
 * @param sessionId 指定会话 id（可选；微信桥等外部面用固定 id 实现"轨迹 ↔ 会话"长期映射）
 */
 async function createTrajectoryAgent(ctx, root, profile, defaultModel, sessionId) {
-	if (!ctx.agents) throw new Error("轨迹约束: ctx.agents unavailable");
+	if (!ctx.agents) throw new Error("trajectory constraint: ctx.agents unavailable");
 	const model = profile.model?.trim() || defaultModel || "";
 	const id = sessionId ?? `轨迹约束-${profile.code}-${randomUUID()}`;
 	const setup = async (agentCtx) => {
@@ -4306,7 +4372,7 @@ function trajectoryConstraintMsmGate(root, sessionId, action, name) {
 	if (sessionId === void 0) return {};
 	const profile = trajectoryConstraintFor(root, sessionId);
 	if (profile === null) return {};
-	if (action === "register" || action === "deregister") return { reject: "register/deregister is not allowed in 轨迹约束 sessions" };
+	if (action === "register" || action === "deregister") return { reject: "register/deregister is not allowed in trajectory-constraint sessions" };
 	if (action === "exec") {
 		if (!name || !profile.msms.includes(name)) return { reject: "MSM not allowed" };
 		return {};
@@ -10331,6 +10397,16 @@ function croScriptPath(root, dirName) {
 * —— 程序还没跑，没有快照可读。⇒ 只能读文件。（这也是"机制属 ACC"的体现：
 * ACC 在调用用户程序前先判定自己该不该调用。）
 *
+* ## 🆕 2026-10-19 owner 裁 Q2：**声明文件里的 `cro.host` 优先，独立文件回落**
+*
+* 收拢后机器名住在 `<轨迹目录>/trajectory.json` 的 `cro.host` 字段里。
+* 判据（**两代并读，不硬切**）：**声明面里有合法 `cro.host` ⇒ 用它；否则回落 `cro-host-binding` 文件**。
+*
+* 🔴 **为什么这里绝不能硬切**（比别处更硬的一条，逐字保留原裁定）：
+* 硬切之后，**第二台机器**读到的是「没绑」而不是「绑给了别人」——
+* 两者都导致"不跑"，**表面结果相同，但判据退化**（失去可诊断性）。
+* ⇒ 只要还有一台机器可能装着旧版本，两条路都必须能读。
+*
 * @param root CCC 根
 * @param dirName 轨迹目录名
 * @param selfHost 本机机器名（**注入** ⇒ 可测；生产调用方传 `hostname()`）
@@ -10350,6 +10426,8 @@ function resolveCroHostBinding(root, dirName, selfHost) {
 			detail: `绑定文件路径非法（已忽略）：${String(err?.message ?? err)}`
 		};
 	}
+	const fromJson = readCroHostFromDeclaration(root, dirName);
+	if (fromJson !== null) return verdictFor(fromJson, self);
 	let raw;
 	try {
 		if (!existsSync(fileAbs)) return {
@@ -10357,7 +10435,7 @@ function resolveCroHostBinding(root, dirName, selfHost) {
 			bound: null,
 			self,
 			code: "not-bound",
-			detail: `未绑定机器（缺 ${CRO_HOST_FILENAME}）⇒ 按"必须指定"不运行`
+			detail: `未绑定机器（缺 ${CRO_HOST_FILENAME}，且 ${TRAJECTORY_FILENAME} 里也没有 cro.host）⇒ 按"必须指定"不运行`
 		};
 		const st = statSync(fileAbs);
 		if (st.size > CRO_HOST_FILE_MAX) return {
@@ -10385,6 +10463,37 @@ function resolveCroHostBinding(root, dirName, selfHost) {
 		code: "not-bound",
 		detail: `绑定文件为空（只有注释/空行）⇒ 按"必须指定"不运行`
 	};
+	return verdictFor(bound, self);
+}
+/**
+* 从**声明文件**（`trajectory.json` 族）里取 `cro.host`（取不到 ⇒ `null`）。
+*
+* 🔴 **永不抛**：本函数跑在 tick 内（旁路容忍铁律）；坏 JSON / 结构不符一律按"没给"处理，
+* 于是**自然回落到独立文件那条路** —— 这正是两代并读想要的降级方向。
+*
+* @param root CCC 根
+* @param dirName 轨迹目录名
+* @returns 机器名；没给 ⇒ `null`
+*/
+function readCroHostFromDeclaration(root, dirName) {
+	try {
+		const cro = readTrajectoryFile(join(sessionsRoot(root), dirName))?.data?.["cro"];
+		if (!cro || typeof cro !== "object" || Array.isArray(cro)) return null;
+		const host = cro["host"];
+		if (typeof host !== "string") return null;
+		const trimmed = host.trim();
+		return trimmed === "" ? null : trimmed;
+	} catch {
+		return null;
+	}
+}
+/**
+* 已解析出的机器名 → 判定结果（三种态的唯一收敛点）。
+*
+* 🔴 **抽出来的理由**：两条读取路（声明文件 / 独立文件）必须给出**同一种**判定语义；
+* 各写一份迟早会漂（"声明面绑给别人"与"文件面绑给别人"在日志里长得不一样就糟了）。
+*/
+function verdictFor(bound, self) {
 	if (bound === self) return {
 		allowed: true,
 		bound,
@@ -10921,12 +11030,36 @@ function registerCroTurnTracking(ctx) {
 * | 文件 | 谁写 | 主语 | 回答 |
 * |---|---|---|---|
 * | `<轨迹目录>/cro-state.json`（CCC 侧程序自建，名字自定） | **CCC 的 CRO 程序** | 程序 | 「**我判了什么**」（含"没叫"的判定、心跳阈值、环境谓词） |
-* | `<轨迹目录>/cro-wake-log.json`（**本模块**） | **ACC** | ACC | 「**我把什么送出去了、送成没有**」 |
+* | `<轨迹目录>/cro-wake-log.log`（**本模块**） | **ACC** | ACC | 「**我把什么送出去了、送成没有**」 |
 *
 * **内容不重叠**：本模块**不复制**判定细节（不存 `lastDecision` / 阈值 / 谓词）；
 * 而程序**不可能**知道投递结果（CRO 投递是 fire-and-forget）。
 * ⇒ 两者**互补**：完整审计 = 两者合看（本模块 = 投递面｜程序状态 = 判定面）。
 *
+* ## 🔴 形态 = 纯文本行，不是 JSON（owner 2026-10-19 裁 Q1）
+*
+* owner 原话：「**日志不要写 json，不合适，日志直接写纯文本 `.log` 就行**」。
+* ⇒ 一行一条，**tab 分隔**（终端里按制表位对齐，`grep` / `cut` / `awk` 直接可用）：
+*
+* ```text
+* # ACC CRO 唤起流水（纯文本 · tab 分隔 · 时间 / 结果 / tick / 方式 / 理由 / 提示词摘要）
+* 2026-10-19T22:15:03+08:00	ok	tick=82	已投递（live）	reason=心跳：距上次 44m	prompt=17:请先整理你的 SESSION.md
+* ```
+*
+* 🔴 **`#` 开头是注释 / 表头行，解析时跳过** —— 纯文本档案缺了表头，下一个人（或半年后的我）
+* 打开只看到一堆制表符，那是把 R 推给读者。
+* 🔴 **坏行跳过而非报错**（与 JSON 版的 `asEntry()` 同口径）：手改 / 半行 / 截断都不得让整档失效。
+*
+* ## 🔴 两代并读（**不硬切**，本容器反复栽过的形态）
+*
+* 旧名 `cro-wake-log.json` **仍然读**（存量轨迹里可能正有那份）；
+* **只写新 `.log`**。读侧判据 = **「新档在就只读新档，否则回落旧档」**。
+*
+* 🔴 **首次写入 = 迁移，不是覆盖**：那一刻 `loadCroWakeLog` 读到的仍是旧档条目，
+* 它们与新条目一起过裁剪、一起落进新档 ⇒ **窗内的旧记录不会凭空消失**；
+* 而旧档此后不再被读（新档已在）⇒ **不会重复计入**，也不需要删除动作。
+* ⚠️ 这条**只能靠读源码知道**（写出来的档看不出它继承过谁）⇒ 故在此明写。
+*
 * ## 🔴 轮转（所有者明示「程序化的」）
 *
 * **写入时按窗裁剪**：每次落盘只保留 `at >= now - CRO_LOG_RETENTION_MS` 的条目，
@@ -10945,21 +11078,107 @@ function registerCroTurnTracking(ctx) {
 * 最坏（某程序每 5min 都叫）⇒ 288 条/天 ⇒ 两天 **≤ ~600 条、< 100 KB** —— 轮转**自带上限**。
 */
 /** 固定文件名（所有者令：「文件名固定即可」）——与程序自建的 `cro-state.json` 并排、主语分明 */
-const CRO_LOG_FILENAME = "cro-wake-log.json";
+const CRO_LOG_FILENAME = "cro-wake-log.log";
+/**
+* 🔴 **读取族 = 新名在前、旧名在后**（认族，不认"当前叫什么"）。
+*
+* 本容器已两次栽在"上游改名、下游写死旧名"：`skiff.json` → `trajectory-constraint.json` 那次，
+* 症状是「写不进去」，而真因是「文件名对不上」，两者在读数上完全不像。
+* ⇒ 上游再改名只往族里加一项。
+*/
+const CRO_LOG_LEGACY_FILENAMES = ["cro-wake-log.json"];
 /** 保留窗 = 2 日（所有者令「只保留仅两日」）；**常量** ⇒ 「这个时间是程序化的」 */
 const CRO_LOG_RETENTION_MS = 1728e5;
-const CRO_LOG_VERSION = 1;
-/** 日志绝对路径 */
+/** 纯文本档案的表头行（解析时跳过；人打开时先看到它） */
+const CRO_LOG_HEADER = "# ACC CRO 唤起流水（纯文本 · tab 分隔 · 时间 / 结果 / tick / 方式 / 理由 / 提示词摘要）";
+/** 日志绝对路径（**写入目标** = 新名） */
 function croWakeLogPath(root, dirName) {
 	return join(sessionsRoot(root), dirName, CRO_LOG_FILENAME);
 }
+/** 旧档绝对路径（**只读**，用于两代并读） */
+function croWakeLogLegacyPath(root, dirName, filename) {
+	return join(sessionsRoot(root), dirName, filename);
+}
 function emptyLog() {
 	return {
-		version: CRO_LOG_VERSION,
+		version: 1,
 		entries: []
 	};
 }
-/** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整档） */
+/**
+* 抹掉会破坏**行结构**的字符（tab / CR / LF）。
+*
+* 🔴 只抹这三个：它们是**分隔符**，混进来会让一行变成两行或错位；
+* 其余字符（`|`、`]`、中文标点）**原样保留** —— 那些是内容，抹了就是把 E 降了。
+*/
+function oneline(text) {
+	return text.replace(/[\t\r\n]+/g, " ");
+}
+/** 一条记录 → 纯文本行（tab 分隔、字段带前缀便于人读） */
+function formatCroLogLine(entry) {
+	const reason = entry.reason === null ? "" : oneline(entry.reason);
+	const head = oneline(entry.promptDigest.head);
+	return [
+		oneline(entry.at),
+		entry.ok ? "ok" : "fail",
+		`tick=${entry.tick}`,
+		oneline(entry.detail),
+		`reason=${reason}`,
+		`prompt=${entry.promptDigest.length}:${head}`
+	].join("	");
+}
+/**
+* 纯文本行 → 记录（**坏行返回 null 而不是抛**）。
+*
+* 判据：字段数不足 / 时间不可解析 / `ok` 标记不认识 ⇒ `null`（跳过该行，其余照读）。
+* 🔴 `at` 必须**可被 `Date.parse` 解析**才收 —— 那是裁剪的前提，
+* 收一条解析不了的时间等于让它在此档里永久驻留（轮转对它失效）。
+*/
+function parseCroLogLine(line) {
+	if (line === "" || line.startsWith("#")) return null;
+	const parts = line.split("	");
+	if (parts.length < 6) return null;
+	const at = parts[0];
+	if (Number.isNaN(Date.parse(at))) return null;
+	const mark = parts[1];
+	if (mark !== "ok" && mark !== "fail") return null;
+	const tickM = /^tick=(\d+)$/.exec(parts[2]);
+	if (!tickM) return null;
+	const reasonRaw = parts[4].startsWith("reason=") ? parts[4].slice(7) : "";
+	const promptM = /^prompt=(\d+):([\s\S]*)$/.exec(parts[5]);
+	return {
+		at,
+		ok: mark === "ok",
+		detail: parts[3],
+		tick: Number(tickM[1]),
+		reason: reasonRaw === "" ? null : reasonRaw,
+		promptDigest: {
+			length: promptM ? Number(promptM[1]) : 0,
+			head: promptM ? promptM[2] : ""
+		}
+	};
+}
+/** 全文 → 记录（跳过表头与坏行；**永不抛**） */
+function parseCroLogText(text) {
+	const entries = [];
+	for (const line of text.split("\n")) {
+		const e = parseCroLogLine(line);
+		if (e) entries.push(e);
+	}
+	return entries;
+}
+/** JSON 旧档 → 记录（字段缺失/类型不符 ⇒ 丢弃该条，不阻断整档） */
+function parseCroLogJson(text) {
+	const parsed = JSON.parse(text);
+	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 entries;
+}
+/** 旧档条目形状校验（容忍手改） */
 function asEntry(value) {
 	const e = value;
 	if (!e || typeof e !== "object") return null;
@@ -10989,27 +11208,20 @@ function summarizeCroPrompt(prompt) {
 }
 /**
 * 读取日志（**永不抛**；读坏 ⇒ 当作空档 + 返回 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);
-		}
+	if (existsSync(path)) try {
 		return {
 			log: {
-				version: CRO_LOG_VERSION,
-				entries
+				version: 1,
+				entries: parseCroLogText(readFileSync(path, "utf-8"))
 			},
 			error: null
 		};
@@ -11019,6 +11231,28 @@ function loadCroWakeLog(root, dirName) {
 			error: `CRO 流水解析失败（${String(err?.message ?? err)}）`
 		};
 	}
+	for (const legacy of CRO_LOG_LEGACY_FILENAMES) {
+		const legacyPath = croWakeLogLegacyPath(root, dirName, legacy);
+		if (!existsSync(legacyPath)) continue;
+		try {
+			return {
+				log: {
+					version: 1,
+					entries: parseCroLogJson(readFileSync(legacyPath, "utf-8"))
+				},
+				error: null
+			};
+		} catch (err) {
+			return {
+				log: emptyLog(),
+				error: `CRO 流水解析失败（${String(err?.message ?? err)}）`
+			};
+		}
+	}
+	return {
+		log: emptyLog(),
+		error: null
+	};
 }
 /**
 * 按窗裁剪（**纯函数** ⇒ 可穷举测试）。
@@ -11047,6 +11281,10 @@ function pruneCroLogEntries(entries, nowMs, windowMs = CRO_LOG_RETENTION_MS) {
 		dropped
 	};
 }
+/** 记录集 → 落盘全文（表头 ＋ 逐行 ＋ 末尾换行） */
+function renderCroLogText(entries) {
+	return `${[CRO_LOG_HEADER, ...entries.map(formatCroLogLine)].join("\n")}\n`;
+}
 /**
 * 追加一条唤起记录并按窗裁剪（**本模块主入口；永不抛**）。
 *
@@ -11077,10 +11315,7 @@ function appendCroWakeLog(root, dirName, input, nowMs = Date.now()) {
 		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");
+		writeFileSync(tmp, renderCroLogText(kept), "utf-8");
 		renameSync(tmp, path);
 		return {
 			ok: true,
@@ -12823,7 +13058,7 @@ const localstoreTool = defineTool({
 });
 //#endregion
 //#region src/tools/trajectory-constraint-admin.ts
-/** 轨迹约束 定义教程：概念 ／ `trajectory-constraint.json` schema ／ 双白名单 ／ 轨迹纪律 ／ 微信路由 */
+/** 轨迹约束 定义教程：概念 ／ `trajectory.json` schema ／ 双白名单 ／ 轨迹纪律 ／ 微信路由 */
 const TRAJECTORY_CONSTRAINT_GUIDE = `═══ 轨迹约束 Guide (2026-10-19 redesigned) ═══
 
 **A 轨迹约束 IS a cognitive trajectory — the one whose directory contains \`${TRAJECTORY_CONSTRAINT_FILENAME}\`.**
@@ -12832,8 +13067,12 @@ becomes a 轨迹约束; delete it and it goes back to being an ordinary trajecto
 
   AGENT_SESSIONS/<YYYY-MM-DD--<code>--<desc>>/
     ├─ SESSION.md      ← its persistent body (this IS the workspace — nothing is auto-created)
-    ├─ ${TRAJECTORY_CONSTRAINT_FILENAME}          ← its constraints (this file is what makes it a 轨迹约束)
-    └─ TRAJECTORY-UID  ← legacy, read-only (superseded by the code)
+    ├─ PROMPT.md       ← its charter (trajectory-level prompt; all trajectories may have one)
+    ├─ ${TRAJECTORY_CONSTRAINT_FILENAME}          ← its declaration (this file is what makes it a 轨迹约束)
+    └─ continuous-re-occurrence.ts  ← optional CRO program (spawned, never imported)
+
+  The older names ${TRAJECTORY_LEGACY_FILENAMES.map((n) => `\`${n}\``).join(" / ")} are still READ
+  (the family is checked in that order) — writing goes to \`${TRAJECTORY_FILENAME}\` only.
 
 ── ${TRAJECTORY_CONSTRAINT_FILENAME} schema ──
   {
@@ -12841,8 +13080,10 @@ becomes a 轨迹约束; delete it and it goes back to being an ordinary trajecto
     "tools": ["read","grep","msm",...], // non-MSM toolbar whitelist — anything not listed is REMOVED from the schema
     "msms":  ["msm-a","msm-b"],         // MSM whitelist — msm exec may only run these; register/deregister always refused
     "cognitiveTrajectory": { "session": true, "keeper": true, "rebuild": true },  // defaults TRUE (see below)
-    "systemPromptFile": ".opencode/skiff/<role>.md",  // recommended: relative to CCC root, hot-reloads on save
-    "systemPrompt": "..."                             // inline fallback; systemPromptFile wins when both are set
+    "systemPromptFile": ".opencode/skiff/<role>.md",  // relative to CCC root, hot-reloads on save
+    "systemPrompt": "...",                            // inline fallback; systemPromptFile wins when both are set
+    "uid": "my-handle",                 // optional legacy alias (read-only; the code is the identity now)
+    "cro": { "host": "<machine name>" } // optional: which machine may run this trajectory's CRO program
   }
 
 ── Two whitelists, both default-deny ──
@@ -12945,39 +13186,6 @@ function applyTrajectoryConstraint(root) {
 	};
 }
 //#endregion
-//#region src/tools/config-docs.ts
-/**
-* 渲染**目录**（第一层）。
-*
-* 🔴 只调 `summary`，**绝不调 `render`** —— 目录若触发正文，就退化成"整份长文"。
-* 这条不是性能优化，是**判据**：它保证 `docs` 的输出大小与章数成正比，与正文长度无关。
-*/
-function renderDocsIndex(chapters) {
-	const lines = [
-		"═══ CCC 配置说明 · 目录 ═══",
-		"",
-		"说明类内容已超过单次返回的合适篇幅 ⇒ 先读目录，再按章取详情。",
-		"",
-		"用法：container_admin config docs <章节>",
-		""
-	];
-	for (const ch of chapters) lines.push(`  ${ch.id.padEnd(14)}${ch.summary}`);
-	lines.push("");
-	lines.push("相关：container_admin msm catalog（工具/能力目录——与本章录互指，不互相复制）");
-	return lines.join("\n");
-}
-/**
-* 解析一个章节参数（第二层）。
-*
-* 不存在 ⇒ 返回 `null`，由调用方给出**带候选清单**的拒绝 ——
-* "不知道这个章节" 与 "这一章是空的" 必须可区分（否则用户以为功能没有）。
-*/
-function findDocsChapter(chapters, id) {
-	const want = id.trim().toLowerCase();
-	if (want === "") return null;
-	return chapters.find((c) => c.id.toLowerCase() === want) ?? null;
-}
-//#endregion
 //#region src/tools/container-admin.ts
 /**
 * container-admin.ts — container_admin（v1.30：机务舱——容器管理面统一入口）
@@ -13008,6 +13216,57 @@ function findDocsChapter(chapters, id) {
 function agentSessionId(exec) {
 	return exec.agent?.session?.id ?? "";
 }
+/**
+* `config view` 的**现值摘要**（v1.75.0 起：不再回整份说明正文）。
+*
+* 语义边界（这正是它和 `docs config` 的分工）：
+* - 本函数回答「**你这个 CCC 现在填了什么**」⇒ 只报有值的键，且值超长截断。
+* - 它回答不了「**这个键该怎么填**」⇒ 那是 `docs config` 那一章。
+*
+* 🔴 为什么必须截断：现值里可能有很长的字段（`topPrompt` 实测数百字符）。
+* 不截断会让 "看现值" 退化成 "又返回一坨正文" —— 那就回到了统一前的问题。
+*
+* ⚠️ 返回类型是 `JsonValue`（工具 output schema 的契约）⇒ 必须**转成纯 JSON 可表达形态**，
+* 不能直接把 `Record<string, unknown>` 塞回去（`unknown` 里可能有函数/undefined，
+* 那会让序列化层行为不确定）。
+*/
+function viewConfigSummary(root) {
+	let cfg;
+	try {
+		cfg = loadSerenityConfig(root);
+	} catch (err) {
+		return { error: `配置读取失败：${String(err?.message ?? err)}` };
+	}
+	const MAX_STR = 120;
+	const MAX_ARRAY = 12;
+	const MAX_KEYS = 12;
+	/** 递归转成纯 JSON 可表达值（超长按上限截断，并标注原始规模） */
+	const toJson = (v) => {
+		if (v === null || v === void 0) return null;
+		if (typeof v === "string") return v.length > MAX_STR ? `${v.slice(0, MAX_STR)}…（共 ${v.length} 字符）` : v;
+		if (typeof v === "number") return Number.isFinite(v) ? v : String(v);
+		if (typeof v === "boolean") return v;
+		if (Array.isArray(v)) {
+			const head = v.slice(0, MAX_ARRAY).map(toJson);
+			return v.length > MAX_ARRAY ? [...head, `…（共 ${v.length} 项）`] : head;
+		}
+		if (typeof v === "object") {
+			const obj = v;
+			const keys = Object.keys(obj);
+			const out = {};
+			for (const k of keys.slice(0, MAX_KEYS)) out[k] = toJson(obj[k]);
+			if (keys.length > MAX_KEYS) out["…"] = `另有 ${keys.length - MAX_KEYS} 个键`;
+			return out;
+		}
+		return String(v);
+	};
+	return {
+		cccRoot: root,
+		sections: Object.keys(cfg),
+		values: toJson(cfg),
+		note: "这是**现值摘要**（只报有值的键、超长已截断）。每段怎么填、填错会怎样 ⇒ container_admin config docs config"
+	};
+}
 function renderText$1(value) {
 	return [{
 		type: "text",
@@ -13036,21 +13295,49 @@ const DOMAIN_NAMES = Object.keys({
 	]
 });
 /**
-* 说明目录的章节（P3 两层菜单的**唯一注册处**）。
-*
-* 🔴 加一章 = 在这里加一项（`render` 惰性求值）。**正文不复制**：
-* 每章的真相源就在它自己的函数里（`CCC_CONFIG_REFERENCE` / `TRAJECTORY_CONSTRAINT_GUIDE`）——
-* 本表只做**切分与路由**，避免"同一段说明有第二份会漂的副本"。
-*/
-const DOCS_CHAPTERS = [{
-	id: "config",
-	summary: "CCC 配置全表——9 段各是什么、怎么填、填错会怎样（.opencode/serenity.json）",
-	render: () => CCC_CONFIG_REFERENCE
-}, {
-	id: "trajectory-constraint",
-	summary: "轨迹约束：一条轨迹怎么被约束（trajectory-constraint.json 的 schema ＋ 双白名单）",
-	render: () => TRAJECTORY_CONSTRAINT_GUIDE
-}];
+* 说明目录的章节（**说明类内容的唯一注册处**）。
+*
+* 🔴 两条纪律：
+* ① **加一章 = 在这里加一项**（`render` 惰性求值）——说明类内容增长时**不新增工具/子命令**。
+* ② **正文不复制**：每章的真相源就在它自己的函数里（`CCC_CONFIG_REFERENCE` /
+*    `TRAJECTORY_CONSTRAINT_GUIDE` / `ACC_CATALOG`）——本表只做**切分与路由**。
+*
+* ## 🔴 2026-10-19 v1.75.0：说明面统一（owner 裁 Q3 = 指针）
+*
+* 统一前有 **5 个并列入口**，其中两组返回**同一份正文**：
+* `docs config` ≡ `msm ccc-config`｜`docs trajectory-constraint` ≡ `config guide`｜
+* `msm catalog`（域挂错了：它描述整个 ACC，却挂在 MSM 注册表下）。
+*
+* ⇒ 统一后的分工（**一个内容一个正文入口**）：
+* - **`config docs <chapter>`** = 唯一正文入口
+* - `msm ccc-config` / `config guide` = **指针**（指向对应 chapter，不再返回正文）
+* - `msm catalog` = **指针**（指向 `catalog` 章）
+*
+* 判据依据：`praxis` 已经做对了这件事 —— `praxis eap` 返回正文、`praxis` 无参返回目录，
+* **没有第二个入口读同一份 EAP**。本表把同一形态搬到 config 域。
+*/
+const DOCS_CHAPTERS = [
+	{
+		id: "catalog",
+		summary: "ACC 能力总目录——7 个能力分区，每区一句话 ＋ 去哪个子命令看详情",
+		render: () => ACC_CATALOG
+	},
+	{
+		id: "config",
+		summary: "CCC 配置全表——9 段各是什么、怎么填、填错会怎样（.opencode/serenity.json）",
+		render: () => CCC_CONFIG_REFERENCE
+	},
+	{
+		id: "trajectory-constraint",
+		summary: "轨迹约束：一条轨迹怎么被约束（trajectory.json 的 schema ＋ 双白名单）",
+		render: () => TRAJECTORY_CONSTRAINT_GUIDE
+	}
+];
+/**
+* 指针与章目的关系（v1.75.0）：
+* 被降级的旧入口（`msm catalog` / `msm ccc-config` / `config guide`）统一走
+* `config-docs.ts` 的 `docsPointer()` —— **只有一处实现**，避免两域各写一份文案而漂移。
+*/
 function createContainerAdminTool(ctx) {
 	return defineTool({
 		name: "container_admin",
@@ -13131,8 +13418,11 @@ function createContainerAdminTool(ctx) {
 					};
 				}
 				case "view":
-				case "": return { config: runMsm(root, { action: "ccc-config" }) };
-				case "guide": return { guide: TRAJECTORY_CONSTRAINT_GUIDE };
+				case "": return {
+					config: viewConfigSummary(root),
+					docs: "完整配置说明（每段怎么填、填错会怎样）→ container_admin config docs config"
+				};
+				case "guide": return { guide: docsPointer("trajectory-constraint", "轨迹约束教程") };
 				case "validate": return validateTrajectoryConstraint(root);
 				case "apply": return applyTrajectoryConstraint(root);
 				case "list": return listTrajectoryConstraintSummary(root);
@@ -14824,10 +15114,10 @@ function registerKeeper(ctx, opts = {}) {
 		const root = cccRootForCwd(cwd);
 		if (!root) return next();
 		const sessionId = exec.agent?.session?.id;
-		const 轨迹约束Keeper = trajectoryConstraintParticipates(root, sessionId, "keeper");
-		const 轨迹约束Rebuild = trajectoryConstraintParticipates(root, sessionId, "rebuild");
+		const participatesKeeper = trajectoryConstraintParticipates(root, sessionId, "keeper");
+		const participatesRebuild = trajectoryConstraintParticipates(root, sessionId, "rebuild");
 		const tracker = trackerFor(exec);
-		const shouldRemind = 轨迹约束Keeper ? tracker.step(exec.name) : false;
+		const shouldRemind = participatesKeeper ? tracker.step(exec.name) : false;
 		const downstream = await next();
 		try {
 			recordToolUsage(root, exec.name, exec.arguments);
@@ -14840,7 +15130,7 @@ function registerKeeper(ctx, opts = {}) {
 				text: reminderText(code)
 			});
 		}
-		if (轨迹约束Rebuild) {
+		if (participatesRebuild) {
 			const session = exec.agent?.session;
 			if (session) {
 				const pressure = readContextPressure(ctx, session);
@@ -15793,7 +16083,7 @@ function registerStatusApi(ctx, opts = {}) {
 						});
 					}
 					const { saveWeixinRoutes } = await import("./route-COOFLTpU.js").then((n) => n.c);
-					const { findDirNameByCode } = await import("./profile-BVt84mbi.js").then((n) => n.i);
+					const { findDirNameByCode } = await import("./profile-Cz4oBXlI.js").then((n) => n.i);
 					for (const r of routes) if (findDirNameByCode(root, r.trajectory) === null) {
 						sendJson$2(res, 400, { error: `unknown trajectory: ${r.trajectory} (no such trajectory code in ${root})` });
 						return;
@@ -20776,7 +21066,7 @@ const MEDIA_MAX_BYTES = 20971520;
 */
 async function resolveCccRootByAlias(ctx, alias) {
 	try {
-		const { listCccs } = await import("./ccc-roots-B2t_aM8L.js").then((n) => n.a);
+		const { listCccs } = await import("./ccc-roots-BVxn97dY.js").then((n) => n.a);
 		const entries = await listCccs(ctx);
 		const byName = entries.find((e) => e.name === alias);
 		if (byName) return byName.root;
@@ -20844,7 +21134,7 @@ async function resolveInboundTarget(ctx, input) {
 		});
 		return null;
 	}
-	const { findDirNameByCode } = await import("./profile-BVt84mbi.js").then((n) => n.i);
+	const { findDirNameByCode } = await import("./profile-Cz4oBXlI.js").then((n) => n.i);
 	if (findDirNameByCode(root, target.role) === null) {
 		const detail = `目标 CCC "${target.ccc}" 内没有编码为 "${target.role}" 的认知轨迹`;
 		console.error(`[serenity-hooks] ✗ human-channel: ${detail}（account=${input.account} user=${input.user}）—— 该消息**未投递**，请改订阅表里的目标编码`);
@@ -21656,7 +21946,7 @@ function syncHumanChannel(ctx) {
 	(async () => {
 		try {
 			stopMachineLoops();
-			const { listCccs } = await import("./ccc-roots-B2t_aM8L.js").then((n) => n.a);
+			const { listCccs } = await import("./ccc-roots-BVxn97dY.js").then((n) => n.a);
 			for (const entry of await listCccs(ctx)) syncCccBridge(ctx, entry.root);
 		} catch {}
 	})();
@@ -21920,7 +22210,7 @@ function matchCcc(input, candidates) {
 }
 /** 组装候选列表（`ccc-roots.listCccs` 投影 + `.serenity` 名；动态 import 保持本模块静态依赖轻量） */
 async function collectCandidates(ctx) {
-	const { listCccs } = await import("./ccc-roots-B2t_aM8L.js").then((n) => n.a);
+	const { listCccs } = await import("./ccc-roots-BVxn97dY.js").then((n) => n.a);
 	const entries = await listCccs(ctx, { defaultRoot: process.cwd() });
 	const seen = /* @__PURE__ */ new Set();
 	const out = [];