@shgroup/dsh-serenity-hooks 1.74.0 → 1.76.0

package/lib/kernel/ccc.d.ts

@@ -93,8 +93,9 @@ interface SerenityConfig {
      * （约束面住在轨迹目录里）。⇒ 本段**不再被读取**：存量配置里残留的 `轨迹约束.roles` ⇒
      * **静默忽略**（schemastery 非 strict，不报错；也不会被误当成"没有 轨迹约束"）。
      *
-     * 迁移路径 = 把 `轨迹约束.roles.<name>` 的内容原样搬进对应轨迹目录的 `trajectory-constraint.json`
-     * （判据与步骤见 `trajectory/policy/profile.ts` 头注释与 `docs/trajectory-constraint-redesign.md` §5）。
+     * 迁移路径 = 把 `轨迹约束.roles.<name>` 的内容原样搬进对应轨迹目录的声明文件
+     * （判据与步骤见 `trajectory/policy/profile.ts` 头注释）。
+     * 🔴 2026-10-19：声明文件已收拢为 **`trajectory.json`**（旧名仍在**读取族**里，写只写新名）。
      */
     /**
      * 认知轨迹族配置（D58，S142 2026-09-13；2026-10-18 更名 `cognitiveTrajectory`）。

package/lib/{message-source-DCpoRHP3.js → message-source-C_Zd2vJh.js}

@@ -1,5 +1,5 @@
-import { r as cccRootForCwd } from "./ccc-roots-B2t_aM8L.js";
-import { T as parseTrajectoryCode, b as getLastActiveSessionInfo, k as sessionEvents, y as getActiveSessionInfo } from "./profile-BVt84mbi.js";
+import { r as cccRootForCwd } from "./ccc-roots-rwgzt_0F.js";
+import { T as parseTrajectoryCode, b as getLastActiveSessionInfo, k as sessionEvents, y as getActiveSessionInfo } from "./profile-DplLGGqo.js";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 //#region src/trajectory/bound.ts
@@ -50,6 +50,7 @@ function fromDomainRecord(rec) {
 		action: rec.action ?? "activate",
 		at: typeof rec.at === "number" ? rec.at : 0,
 		...rec.note ? { note: rec.note } : {},
+		...rec.createdAsUser === true ? { createdAsUser: true } : {},
 		...rec.supersededAt !== void 0 ? { supersededAt: rec.supersededAt } : {}
 	};
 }
@@ -62,6 +63,7 @@ function toDomainRecord(rec) {
 		action: rec.action,
 		at: rec.at,
 		...rec.note ? { note: rec.note } : {},
+		...rec.createdAsUser === true ? { createdAsUser: true } : {},
 		...rec.supersededAt !== void 0 ? { supersededAt: rec.supersededAt } : {}
 	};
 }
@@ -394,7 +396,8 @@ function appendBound(session, action, rec) {
 		...rec.sessionId ? { sessionId: rec.sessionId } : {},
 		action,
 		at: Date.now(),
-		...rec.note ? { note: rec.note } : {}
+		...rec.note ? { note: rec.note } : {},
+		...rec.createdAsUser === true ? { createdAsUser: true } : {}
 	};
 	if (domainStore?.available) domainStore.put(id, toDomainRecord(record)).catch(() => {});
 	if (!path) return domainStore?.available === true;

package/lib/{profile-BVt84mbi.js → profile-DplLGGqo.js}

@@ -88,6 +88,114 @@ function localIdStamp(value = Date.now()) {
 	return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}`;
 }
 //#endregion
+//#region src/trajectory/policy/files.ts
+/**
+* trajectory/policy/files.ts — **轨迹级文件的文件名族**（owner 2026-10-19 裁 Q2：短名 `trajectory.json`）
+*
+* ## 这一层解决什么（白话）
+*
+* 一条轨迹目录里，ACC 自己产的文件原先有**四个名字各异的文件**：
+* `trajectory-constraint.json`（约束面）／`TRAJECTORY-UID`（只读遗留的旧标识）／
+* `cro-host-binding`（一行机器名）／`cro-wake-log.json`（CRO 流水）。
+* 后两个里，**「声明」性质的那两个现在并进一个 JSON**（流水不并 —— 见 `cro/log.ts` 的理由）。
+*
+* ⇒ 收拢后的形态：
+*
+* ```text
+* <轨迹目录>/
+*   SESSION.md                 ← 轨迹的身体（不动）
+*   PROMPT.md                  ← 章程（不动）
+*   continuous-re-occurrence.ts← CRO 程序（不动）
+*   trajectory.json            ← 🆕 声明面：约束 ＋ 旧标识(code) ＋ cro.host
+*   cro-wake-log.log           ← CRO 流水（高频追加，**刻意不并入**）
+* ```
+*
+* ## 🔴 为什么不硬切（本容器已两次栽在"上游改名、下游写死旧名"）
+*
+* 读取侧认**族**：`trajectory.json`（新）→ `trajectory-constraint.json`（v1.74 名）→
+* `skiff.json`（v1.71 名）。**任一存在即成立**。上游再改名只往族里加一项，不再单点写死。
+*
+* 🔴 **`cro-host-binding` 必须两代并读，这一条是有行为后果的**
+* （理由逐字保留在 `cro/core.ts` 的 `resolveCroHostBinding` 头注）：
+* 绑定声明要**跟着轨迹走到第二台机器**，在那里被判成「绑给了别人」而**正确地不跑**。
+* 若硬切改名，第二台机器读到的是**「没绑」** —— **表面结果相同，但判据退化**
+* （失去"明确绑给别人"的可诊断性）⇒ 只能两代并读。
+*
+* ## 归属（D23）
+* 本模块只管**机制**（文件叫什么、按什么顺序找、怎么读）；**内容归 CCC**
+* （JSON 里填什么：模型 / 白名单 / 提示词路径 / 机器名）。
+*
+* ## 边界与铁律
+* 本模块**零本地依赖**（只用 `node:fs` / `node:path`）⇒ 谁 import 它都不会成环。
+* 每个读取函数**永不抛**：文件不存在 / 坏 JSON ⇒ `null`，由调用方各自决定降级方式。
+*/
+/**
+* 收拢后的**新**文件名（owner 裁 Q2「短名」）。
+*
+* 🔴 **为什么要改名**：它装的不止"约束"了（还有 `code` 与 `cro.host`）
+* ⇒ 留着旧名会让**名字本身就是错名**（D151 同族：界面/文档里的名字会随内容演进而撒谎）。
+*/
+const TRAJECTORY_FILENAME = "trajectory.json";
+/**
+* **判据族**：任一存在 ⇒ 这条轨迹有声明面（= 旧模型说的"它是一个轨迹约束"）。
+*
+* ⚠️ **顺序即优先级**（第一个找到的胜过后面的）：新名优先，两个旧名按代际倒序。
+* ⚠️ **准入面宽于约束面是有意的**：约束文件缺失的轨迹仍需要能被当作轨迹处理。
+*/
+const TRAJECTORY_FILENAME_FAMILY = [
+	TRAJECTORY_FILENAME,
+	"trajectory-constraint.json",
+	"skiff.json"
+];
+/** 旧名的单独导出（调用方要单独判断"这是不是旧档"时用；顺序同上、不含新名） */
+const TRAJECTORY_LEGACY_FILENAMES = TRAJECTORY_FILENAME_FAMILY.slice(1);
+/**
+* 在一条轨迹目录里找**声明文件**（族内第一个存在的）。
+*
+* @param trajectoryDir 轨迹目录绝对路径
+* @returns 命中的文件绝对路径；族内一个都不存在 ⇒ `null`（= 普通轨迹，**常态不是错误**）
+*/
+function findTrajectoryFile(trajectoryDir) {
+	for (const name of TRAJECTORY_FILENAME_FAMILY) {
+		const p = join(trajectoryDir, name);
+		try {
+			if (existsSync(p)) return p;
+		} catch {}
+	}
+	return null;
+}
+/**
+* 读一条轨迹目录里的声明文件，解析成对象（**永不抛**）。
+*
+* @returns `{ file, data }`：`file` 是命中的文件名（族内哪个），`data` 是解析后的对象；
+*          **族内无文件 ⇒ `null`**；**坏 JSON / 顶层非对象 ⇒ `{ file, data: null, error }`**
+*          —— 这三种情形调用方的降级方式各不相同（普通轨迹 / 告警后按普通轨迹），故分开给。
+*/
+function readTrajectoryFile(trajectoryDir) {
+	const file = findTrajectoryFile(trajectoryDir);
+	if (file === null) return null;
+	let raw;
+	try {
+		raw = JSON.parse(readFileSync(file, "utf-8"));
+	} catch (err) {
+		return {
+			file,
+			data: null,
+			error: `JSON 解析失败（${String(err?.message ?? err)}）`
+		};
+	}
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {
+		file,
+		data: null,
+		error: "顶层不是对象"
+	};
+	return {
+		file,
+		data: raw,
+		error: null
+	};
+}
+//#endregion
 //#region src/trajectory/core.ts
 /**
 * trajectory/core.ts — 轨迹工具纯操作层（零 DSH 依赖，可独立单测）
@@ -244,6 +352,19 @@ function parseTrajectoryCode(dirName) {
 	return code === "" ? null : code;
 }
 /**
+* 从目录名取**可读描述**（编码之后那一段；没有就返回空串）。
+*
+* 用途：给"模拟用户开场白"当标签（D171）。判据 = 与 {@link parseTrajectoryCode} **互逆、同源**：
+* 剥日期前缀 → 第一段是编码 → 其后（去掉前导 `--`）全是描述。
+* ⚠️ 描述里**可以**含 `--`（只有编码不许）⇒ 这里必须取"第一段之后整串"，不能 split 再取第二段。
+*/
+function trajectoryDescOf(dirName) {
+	if (!DIR_DATE_PREFIX_RE.test(dirName)) return "";
+	const rest = dirName.replace(DIR_DATE_PREFIX_RE, "");
+	const sep = rest.indexOf("--");
+	return sep === -1 ? "" : rest.slice(sep + 2).trim();
+}
+/**
 * 展示用会话 ID（`list` 面板 / 绑定记录的 `sessionId` 字段）。
 *
 * 🔴 2026-10-19 起**编码即 ID**，不再只认 `S###` —— 旧实现只匹配 `--S(\d{3,})--`，
@@ -309,8 +430,25 @@ function isValidUid(uid) {
 * 🔴 **形态非法的文件按"没设定"处理，而不是报错**：解析侧出现在**每一次** `findSession` 里
 * （show/use/archive/send-now/send-later 全走它），在那里抛错会让一个坏文件**炸掉整条轨迹的所有操作**
 * —— 惩罚远大于问题本身。而写入侧已退役 ⇒ 坏文件只可能来自外部手改，更不该连坐。
+*
+* ## 🆕 2026-10-19 owner 裁 Q2：**声明文件里的 `uid` 优先，独立文件回落**
+*
+* 收拢后这个旧标识住在 `<轨迹目录>/trajectory.json` 的 `uid` 字段里（它属"声明"，
+* 与约束面/机器绑定同源）。判据（**两代并读，不硬切**）：
+* **声明面里有合法 `uid` ⇒ 用它；否则回落 `TRAJECTORY-UID` 文件**。
+*
+* ⚠️ **为什么字段名是 `uid` 而不是方案书里写的 `code`**：`code` 在本仓已有一个**更窄的含义**
+* —— 目录名里那个固定位置的轨迹编码（`parseTrajectoryCode`）。同一个词在一个 JSON 里表示两件事，
+* 正是本轨反复抓的那类"名字会撒谎"。⇒ 旧标识就叫 `uid`（它本来就是 UID，见 `UID_FILENAME`）。
 */
 function readTrajectoryUid(sessionPath) {
+	try {
+		const fromJson = readTrajectoryFile(sessionPath)?.data?.["uid"];
+		if (typeof fromJson === "string") {
+			const trimmed = fromJson.trim();
+			if (isValidUid(trimmed)) return trimmed;
+		}
+	} catch {}
 	try {
 		const raw = readFileSync(join(sessionPath, UID_FILENAME), "utf-8").trim();
 		return isValidUid(raw) ? raw : null;
@@ -751,21 +889,22 @@ function archiveSession(root, key, dryRun = false) {
 }
 //#endregion
 //#region src/trajectory/policy/window.ts
-const 轨迹约束Sessions = /* @__PURE__ */ new Map();
+/** sessionId → 绑定的轨迹（**进程内**；跨重启的权威来源是 `trajectory/bound.ts` 的持久绑定） */
+const trajectorySessions = /* @__PURE__ */ new Map();
 /** 登记/更新一个会话 → 轨迹的映射 */
 function registerTrajectorySession(sessionId, trajectoryDirName, ccc) {
-	轨迹约束Sessions.set(sessionId, {
+	trajectorySessions.set(sessionId, {
 		trajectoryDirName,
 		ccc
 	});
 }
 /** 解绑（会话销毁 / 轨迹失效 ⇒ 换身份） */
 function unregisterTrajectorySession(sessionId) {
-	轨迹约束Sessions.delete(sessionId);
+	trajectorySessions.delete(sessionId);
 }
 /** 查会话承载的轨迹目录名（无 → null）；`guards`/`system-prompt` 的同步热路径用 */
 function trajectoryDirNameForSession(sessionId) {
-	const b = 轨迹约束Sessions.get(sessionId);
+	const b = trajectorySessions.get(sessionId);
 	return b === void 0 || b.trajectoryDirName === "" ? null : b.trajectoryDirName;
 }
 //#endregion
@@ -812,8 +951,13 @@ var profile_exports = /* @__PURE__ */ __exportAll({
 	readTrajectoryConstraintByCode: () => readTrajectoryConstraintByCode,
 	trajectoryConstraintForSession: () => trajectoryConstraintForSession
 });
-/** `trajectory-constraint.json` 的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
-const TRAJECTORY_CONSTRAINT_FILENAME = "trajectory-constraint.json";
+/**
+* 🆕 **声明文件的文件名**（2026-10-19 owner 裁 Q2：短名 `trajectory.json`）。
+*
+* ⚠️ **判据不是"这个名字在不在"**，而是**族内任一存在**（`TRAJECTORY_FILENAME_FAMILY`）。
+* 这个名字只是**写入目标**与**提示文案里该印的那个**。
+*/
+const TRAJECTORY_CONSTRAINT_FILENAME = TRAJECTORY_FILENAME;
 /**
 * 已告警过的坏 `trajectory-constraint.json`（进程级去重：同一坏文件不刷屏，但**绝不静默**）。
 *
@@ -846,26 +990,27 @@ function readTrajectoryConstraintAt(trajectoryDir, root) {
 	const dirName = trajectoryDir.split("/").filter(Boolean).pop() ?? "";
 	const code = parseTrajectoryCode(dirName);
 	if (code === null) return null;
-	const file = join(trajectoryDir, TRAJECTORY_CONSTRAINT_FILENAME);
-	if (!existsSync(file)) return null;
+	const found = findTrajectoryFile(trajectoryDir);
+	if (found === null) return null;
 	let raw;
 	try {
-		raw = JSON.parse(readUtf8(file));
+		raw = JSON.parse(readUtf8(found));
 	} catch (err) {
-		if (!warnedBrokenProfiles.has(file)) {
-			warnedBrokenProfiles.add(file);
-			console.warn(`[serenity-hooks] ✗ ${TRAJECTORY_CONSTRAINT_FILENAME} 解析失败 ⇒ 该轨迹**按普通轨迹处理**（工具白名单与提示词约束全部不施加）。请修 JSON: ${file} — ${String(err?.message ?? err)}`);
+		if (!warnedBrokenProfiles.has(found)) {
+			warnedBrokenProfiles.add(found);
+			console.warn(`[serenity-hooks] ✗ ${TRAJECTORY_FILENAME} 解析失败 ⇒ 该轨迹**按普通轨迹处理**（工具白名单与提示词约束全部不施加）。请修 JSON: ${found} — ${String(err?.message ?? err)}`);
 		}
 		return null;
 	}
 	if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-		if (!warnedBrokenProfiles.has(file)) {
-			warnedBrokenProfiles.add(file);
-			console.warn(`[serenity-hooks] ✗ ${TRAJECTORY_CONSTRAINT_FILENAME} 顶层不是对象 ⇒ 按普通轨迹处理: ${file}`);
+		if (!warnedBrokenProfiles.has(found)) {
+			warnedBrokenProfiles.add(found);
+			console.warn(`[serenity-hooks] ✗ ${TRAJECTORY_FILENAME} 顶层不是对象 ⇒ 按普通轨迹处理: ${found}`);
 		}
 		return null;
 	}
 	const obj = raw;
+	const file = found;
 	const strList = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "").map((x) => x.trim()) : [];
 	/** 布尔缺省 **true**（R↓ 见接口：工作台就是这条轨迹自己的身体） */
 	const boolOrTrue = (v) => typeof v === "boolean" ? v : true;
@@ -963,4 +1108,4 @@ function isTrajectoryConstrained(root, sessionId) {
 	return trajectoryConstraintForSession(root, sessionId) !== null;
 }
 //#endregion
-export { sessionsRoot as A, namingTitleFor as C, readTrajectoryUid as D, readActiveSessionMd as E, isoLocal as F, localFileStamp as I, localHuman as L, showSession as M, summarize as N, resolveSessionByTitle as O, useSession as P, localIdStamp as R, listSessions as S, parseTrajectoryCode as T, extractSessionMdPathFromText as _, readTrajectoryConstraintAt as a, getLastActiveSessionInfo as b, registerTrajectorySession as c, COGNITIVE_TRAJECTORY_ACTIONS as d, DEFAULT_SESSION_SCOPE as f, createSession as g, clearActiveSessionInfo as h, profile_exports as i, setActiveSessionInfo as j, sessionEvents as k, trajectoryDirNameForSession as l, archiveSession as m, isTrajectoryConstrained as n, readTrajectoryConstraintByCode as o, UID_FILENAME as p, listTrajectoryConstraints as r, trajectoryConstraintForSession as s, TRAJECTORY_CONSTRAINT_FILENAME as t, unregisterTrajectorySession as u, findSession as v, parseSessionContextFromEvents as w, listActiveTrajectories as x, getActiveSessionInfo as y };
+export { sessionsRoot as A, localFileStamp as B, namingTitleFor as C, readTrajectoryUid as D, readActiveSessionMd as E, useSession as F, localIdStamp as H, TRAJECTORY_FILENAME as I, TRAJECTORY_LEGACY_FILENAMES as L, showSession as M, summarize as N, resolveSessionByTitle as O, trajectoryDescOf as P, readTrajectoryFile as R, listSessions as S, parseTrajectoryCode as T, localHuman as V, extractSessionMdPathFromText as _, readTrajectoryConstraintAt as a, getLastActiveSessionInfo as b, registerTrajectorySession as c, COGNITIVE_TRAJECTORY_ACTIONS as d, DEFAULT_SESSION_SCOPE as f, createSession as g, clearActiveSessionInfo as h, profile_exports as i, setActiveSessionInfo as j, sessionEvents as k, trajectoryDirNameForSession as l, archiveSession as m, isTrajectoryConstrained as n, readTrajectoryConstraintByCode as o, UID_FILENAME as p, listTrajectoryConstraints as r, trajectoryConstraintForSession as s, TRAJECTORY_CONSTRAINT_FILENAME as t, unregisterTrajectorySession as u, findSession as v, parseSessionContextFromEvents as w, listActiveTrajectories as x, getActiveSessionInfo as y, isoLocal as z };

package/lib/{settings-D8hlqxua.js → settings-f9WZXcgi.js}

@@ -1,4 +1,4 @@
-import { f as hostSettings } from "./ccc-roots-B2t_aM8L.js";
+import { f as hostSettings } from "./ccc-roots-rwgzt_0F.js";
 import { _ as resolveInside, g as readUtf8 } from "./ccc-CyYJL4F2.js";
 import { dirname, join } from "node:path";
 import { existsSync, readFileSync, statSync } from "node:fs";

package/lib/tools/config-docs.d.ts

@@ -51,3 +51,21 @@ export declare function renderDocsIndex(chapters: readonly DocsChapter[]): strin
  * "不知道这个章节" 与 "这一章是空的" 必须可区分（否则用户以为功能没有）。
  */
 export declare function findDocsChapter(chapters: readonly DocsChapter[], id: string): DocsChapter | 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 这个入口原来叫什么（进标题，让调用方一眼确认自己找对了）
+ */
+export declare function docsPointer(chapter: string, what: string): string;

package/lib/tools/container-admin.d.ts

@@ -25,4 +25,9 @@
  *   container = CCC（具体认知容器）；admin = 管理操作。
  */
 import type { Context } from 'cordis';
+/**
+ * 指针与章目的关系（v1.75.0）：
+ * 被降级的旧入口（`msm catalog` / `msm ccc-config` / `config guide`）统一走
+ * `config-docs.ts` 的 `docsPointer()` —— **只有一处实现**，避免两域各写一份文案而漂移。
+ */
 export declare function createContainerAdminTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/msm/service.d.ts

@@ -7,6 +7,17 @@
 import type { JsonValue } from '../../kernel/json.js';
 type MsmAction = 'list' | 'exec' | 'register' | 'deregister' | 'check' | 'guide' | 'ccc-config' | 'catalog';
 export declare const MSM_ACTIONS: readonly MsmAction[];
+/**
+ * ACC 能力目录（需求④ S142 用户拍板："acc 配置各自做 guide 越来越多，整合成目录式使用指南"）。
+ * 目录在前、详情各归各——**单一真相源**：本目录只索引"去哪个工具/子命令看详情"，不复制详情
+ * （避免 container_admin/weixin-doctor 等 guide 全文重复 → 多真相源 → 失同步）。
+ * 后续新增功能只需在此加一行（低熵可演进）。
+ *
+ * 🔴 **2026-10-19 v1.75.0 起导出**：它是 `container_admin config docs catalog` 那一章的正文。
+ * `msm catalog` 动作**降为指针**（只指路，不再返回本常量）—— 否则同一份正文会有两个入口，
+ * 而"两个入口返回同一份内容"正是本目录自己反对的形态。
+ */
+export declare const ACC_CATALOG = "\u2550\u2550\u2550 ACC Usage Catalog \u2550\u2550\u2550\nDirectory of ACC capabilities \u2014 each area lists where to go for details (guides live with their feature; this catalog only points).\n\n  \u2460 \u8F68\u8FF9\u672C\u4F53          \u2192 cognitive_trajectory\uFF08list/show/create/use + rebuild \u8D85\u9650\u91CD\u5EFA + send-now \u5373\u65F6\u6295\u9012 + send-later \u672A\u6765\u4E00\u6B21\u6027\u5524\u9192\n                          + cro-guide CRO \u7F16\u5199\u6307\u5357\uFF09\n                         \u539F logbook \u5DF2\u5E76\u5165\uFF08v1.33 \u7528\u6237\u88C1\u51B3\uFF1A\u5E9F\u9664 logbook \u8BCD\uFF09\uFF1Bclose/archive \u5220\uFF08\u5F52\u6863\u8D70 container_fs mv\uFF09\uFF0C\n                         health/qa/summary \u5206\u522B\u5E76\u5165 use / list\uFF0Chook-develop-guide \u5E76\u8FDB container_admin msm guide\n  \u2461 \u8BA4\u77E5\u8D28\u91CF\u6846\u67B6      \u2192 praxis\uFF08eap/neat/cce/ontology \u56DB\u5408\u4E00\u2014\u2014\u53EF\u5B9E\u8DF5\u7406\u8BBA\u6CE8\u5165\uFF0Csection \u6E10\u8FDB\u62AB\u9732\uFF0C\u65E0\u53C2\u5373\u76EE\u5F55\uFF09\n                          ontology\uFF08v1.52 D121\uFF1A\u672C\u4F53\u5DE5\u7A0B**\u5F15\u64CE**\u2014\u2014init/check/explain/verify/review/compliance\uFF1B\n                          \u4E0E praxis ontology \u7684\u5206\u5DE5 = \u90A3\u4E2A\u662F**\u65B9\u6CD5\u6587\u672C**\u3001\u8FD9\u4E2A\u662F**\u80FD\u8DD1\u7684\u90A3\u4E2A**\uFF09\n  \u2462 \u5DE5\u5177\u4E0E\u6267\u884C        \u2192 container_fs\uFF08\u5BB9\u5668\u6587\u4EF6\u7CFB\u7EDF 15 \u5B50\u547D\u4EE4\uFF09/ container_git\uFF08git\uFF09/ dashboard\uFF08health \u542B\u6CE8\u518C\u8868\u68C0\u67E5/time/wait\uFF09\n                         acc_msm \u5DF2\u5E76\u5165 msm\uFF08\u6267\u884C+\u53D1\u73B0\uFF09\u4E0E container_admin\uFF08\u7BA1\u7406\uFF09\u2014\u2014msm(\"<name>\", [\"<args>\"])\uFF1Binspect=true \u67E5\u7528\u6CD5\n                         cheap-worker\uFF08\u6742\u5DE5 agent \u7F16\u6392\u2014\u2014guide \u5B50\u547D\u4EE4\uFF1Acheap-worker guide\uFF09\n                         \u4E13\u5C5E\u5DE5\u5177\uFF08**\u9ED8\u8BA4\u5BF9\u6240\u6709 CCC \u9690\u85CF**\uFF0C\u53EA\u6709\u5728\u81EA\u5DF1 exclusiveTools \u91CC\u70B9\u540D\u7684 CCC \u53EF\u89C1\uFF09\u2192 acc-diag\uFF08\u8FD0\u884C\u6001\u8BCA\u65AD\uFF09\n  \u2463 \u8F68\u8FF9\u7EA6\u675F\u4E0E\u5BF9\u5916\u9762  \u2192 container_admin config\uFF08\u8F68\u8FF9\u7EA6\u675F\u56DB\u52A8\u4F5C guide/validate/apply/list\u2014\u2014**\u539F role \u57DF\u5DF2\u5E76\u5165 config**\uFF0C\u65E7\u540D\u4F5C\u8FC7\u6E21\u522B\u540D\u4ECD\u53EF\u7528\uFF1B\u8BF4\u660E\u7C7B\u914D\u7F6E\u8D70**\u4E24\u5C42\u83DC\u5355** config docs \u76EE\u5F55 \uFF0F config docs <\u7AE0\u8282> \u8BE6\u60C5\uFF09\n                         \u5916\u90E8\u7A0B\u5E8F\u5316\u63A5\u5165\u7528\u5B98\u65B9 dsh --profile acp\n                         \uFF0B \u73B0\u6210 ACP \u5BA2\u6237\u7AEF\uFF1B\u672C\u63D2\u4EF6\u4E0D\u63D0\u4F9B ACP \u9762\n  \u2464 \u81EA\u4E3B\u4E0E\u63A5\u5165        \u2192 cognitive_trajectory send-now\uFF08\u8DE8\u8F68\u8FF9\u7684**\u5373\u65F6**\u9012\u9001\uFF0C**\u4E0D\u6392\u961F**\uFF1Alive \u76EE\u6807\u5728\u8DD1\u5C31\u5F53\u573A\u6CE8\u5165\u5F53\u524D\u8F6E\u3001\u7A7A\u95F2\u5219\u7ACB\u5373\u8D77\u8F6E\uFF1B\u975E live \u51B7\u8F7D\u5165\u2014\u2014\u7B49\u6548\u4E8E\u76F4\u63A5 wake\uFF1B**\u6709\u540C\u6B65\u56DE\u6267**\uFF09\n                         cognitive_trajectory send-later\uFF08\u8DE8\u8F68\u8FF9\u7684\"\u672A\u6765\u65F6\u523B + \u4E00\u6761 message\"\uFF1Bfire-and-forget\uFF0C\u65E0\u56DE\u6267\u65E0\u56DE\u6536\uFF09\n                         weixin \u5FAE\u4FE1\u6865\uFF08\u914D\u7F6E/\u626B\u7801/\u8DEF\u7531/\u6D88\u606F hook\u2014\u2014CCC \u4FA7 weixin-doctor MSM\uFF1Amsm(\"weixin-doctor\", [\"guide\"])\uFF09\n  \u2465 CCC \u914D\u7F6E\u603B\u89C8      \u2192 container_admin config docs config\uFF08\u6309\u7AE0\u8BE6\u60C5\u2014\u20149 \u6BB5\u5168\u8868\uFF09\n                          \u6216 container_admin msm ccc-config\uFF08\u540C\u4E00\u4EFD\u6B63\u6587\u7684\u65E7\u5165\u53E3\uFF0C\u4FDD\u7559\uFF09\n  \u2466 \u6CE8\u518C\u8868\u4E0E\u5B89\u5168      \u2192 mech-registry.json \u7531 container_admin msm register/deregister \u7BA1\u7406\uFF08\u5199\u4FDD\u62A4\u2014\u2014\u4E0D\u53EF\u76F4\u63A5\u7F16\u8F91\uFF09\n                         dashboard health \u8F93\u51FA registry \u5B8C\u6574\u6027\u68C0\u67E5\uFF1B\u635F\u574F\u6062\u590D\u6307\u5F15\u89C1 health registry.issues\n                         CCC \u7EA7\u5F00\u5173\uFF1AexclusiveTools\uFF08\u58F0\u660E\u4E13\u5C5E\u5DE5\u5177\uFF09/ safeMode.blacklist\uFF08\u5199\u8DEF\u5F84\u9ED1\u540D\u5355\uFF09\n                         / safeMode.hiddenTools\uFF08**\u5B89\u5168\u6A21\u5F0F\u5F00\u542F\u671F\u95F4**\u989D\u5916\u9690\u85CF\u7684\u5DE5\u5177\uFF0Cv1.51.4\uFF09\n                         CCC \u7EA7 skill \u4F9B\u7ED9\uFF1AcognitiveTrajectory.skills\uFF08v1.44.0\u2014\u2014**\u672C CCC \u6BCF\u6761\u8F68\u8FF9\u90FD\u5E26**\uFF0C\u542B \u8F68\u8FF9\u7EA6\u675F\u4F1A\u8BDD\uFF1B\u4E0E\u8F68\u8FF9\u81EA\u5DF1\u7684 frontmatter \u58F0\u660E\u53D6\u5E76\u96C6\uFF09\n\n\u6BCF\u533A\uFF1A\u4E00\u53E5\u8BDD\u5B9A\u4F4D + \u8BE6\u7EC6\u5165\u53E3\uFF08\u5DE5\u5177\u540D / guide \u5B50\u547D\u4EE4\uFF09\u3002\u8BE6\u60C5\u6C38\u8FDC\u4EE5\u5BF9\u5E94\u5DE5\u5177\u7684 guide/ccc-config \u4E3A\u5355\u4E00\u771F\u76F8\u6E90\u3002\n";
 export declare const MSM_GUIDE = "MSM Development Manual (Mech & Semi-Mech framework)\n\n## What it is\nMSM = the executable-unit layer. Mech is pure TS with zero LLM reasoning; Semi-Mech is a TS framework + LLM decision points.\nMSM is ACC's deterministic executable-unit layer \u2014 all shell/exec operations go through MSM and cannot be bypassed.\n\n## Registering a new MSM (container_admin msm register)\n1. Write the script under <skill>/scripts/ (runnable via tsx; must include a main() CLI guard with an import.meta.url check)\n2. container_admin msm register --domain msm --action register <name> --skill <s> --path <script path relative to root> --category <mech|semi-mech> --description <desc>\n3. Auto-writes mech-registry.json (preserving the original format) + git commit (commits only the registry file)\n4. Validation: path must be inside root, script must exist, name must be globally unique\n\n## flag schema (v1)\nflags is a new-style object array for parameter validation and path-escape guarding:\n  [{\"name\":\"output\",\"type\":\"string\",\"description\":\"output path\"},\n   {\"name\":\"target\",\"type\":\"path\",\"description\":\"operation target (type:path enables in-root validation + symlink defense)\"},\n   {\"name\":\"force\",\"type\":\"boolean\",\"description\":\"force mode\",\"default\":false}]\n- {name, type} format \u2014 new style, type:\"path\" enables the path-escape guard\n- {flag, description} format \u2014 old style, CLI flag description string\n- On registration, flags are passed via container_admin msm register --flags '<json>'\n\n## Script conventions\n- Top-of-file documentation: purpose / usage / exit codes\n- Exit codes: 0 success / 1 user / 2 system / 3 operator (per ACC protocol classification)\n- main() CLI guard (DC-M2): the script must start with\n    if (import.meta.url === `file://${process.argv[1]}`) { main() }\n  or an equivalent isMain / require.main === check \u2014 so vitest imports never trigger top-level code\n- A paired .test.ts or .spec.ts (DC-M1, vitest)\n- Business subprocess environment: SERENITY_ROOT / SERENITY_CCC / SERENITY_VERSION injected\n\n## Interaction & confirmation conventions (no blocking confirmation)\n- MSMs run in **user-less subprocesses** (spawn/execFile, 600s timeout) \u2014 **never** use\n  readline / prompt / process.stdin etc. to block waiting for user input (it would hang until killed by the timeout)\n- When a second confirmation is needed: **directly return the confirmation request** (list the operation to perform and its impact + how to retry with the confirmation flag),\n  returning a non-zero exit code (or an explicit hint)\n- After the agent confirms, **re-invoke the MSM with the confirmation flag** (e.g. --confirm / --yes / --force) to retry\n- Standard mode (two-phase):\n  1. First call: destructive/confirmation-requiring operation detected and no confirmation flag present \u2192 output the confirmation request (list operation/impact/rollback),\n     exit non-zero (e.g. 1 user), **perform no changes**\n  2. After the agent evaluates, re-invoke: with the confirmation flag \u2192 execute and output the result\n- Applies to: delete/overwrite/push/batch operations and other irreversible or wide-impact operations\n- Anti-example (forbidden): readline waiting for user input, process.stdin.on('data') blocking waits\n  (MSMs have no stdin interaction channel \u2014 they hang until the 600s timeout)\n\n## Quality checks (container_admin msm check, DC-M1~M4)\nDC-M1 has .test.ts/.spec.ts; DC-M2 has a main() guard (function main( / isMain / require.main === / import.meta.url);\nDC-M3 bidirectional: scripts unregistered + registry references missing scripts; DC-M4 path-type flags marked type:\"path\"\n\n## Self-description (protocol flags, first argument only)\nmsm(\"<name>\", [\"--list\"])           \u2014 list all MSMs\nmsm(\"<name>\", [\"--schema\", \"<n>\"])  \u2014 view a specific MSM's parameter schema\nmsm(\"<name>\", [\"--format=json\"])    \u2014 JSON output mode (remaining args passed through losslessly)\n";
 /**
  * CCC 配置参考（对齐 osp ccc-config action）。

package/lib/tools/trajectory-constraint-admin.d.ts

@@ -13,8 +13,8 @@
  * 归属（D23）不变：ACC 提供机制（教程 + 校验 + 列表），**约束内容归 CCC**（写进 `trajectory-constraint.json`）。
  */
 import type { JsonValue } from '../kernel/json.js';
-/** 轨迹约束 定义教程：概念 ／ `trajectory-constraint.json` schema ／ 双白名单 ／ 轨迹纪律 ／ 微信路由 */
-export declare const TRAJECTORY_CONSTRAINT_GUIDE = "\u2550\u2550\u2550 \u8F68\u8FF9\u7EA6\u675F Guide (2026-10-19 redesigned) \u2550\u2550\u2550\n\n**A \u8F68\u8FF9\u7EA6\u675F IS a cognitive trajectory \u2014 the one whose directory contains `trajectory-constraint.json`.**\nThat is the whole rule. No role table, no name registry: put the file there and the trajectory\nbecomes a \u8F68\u8FF9\u7EA6\u675F; delete it and it goes back to being an ordinary trajectory (takes effect at once).\n\n  AGENT_SESSIONS/<YYYY-MM-DD--<code>--<desc>>/\n    \u251C\u2500 SESSION.md      \u2190 its persistent body (this IS the workspace \u2014 nothing is auto-created)\n    \u251C\u2500 trajectory-constraint.json          \u2190 its constraints (this file is what makes it a \u8F68\u8FF9\u7EA6\u675F)\n    \u2514\u2500 TRAJECTORY-UID  \u2190 legacy, read-only (superseded by the code)\n\n\u2500\u2500 trajectory-constraint.json schema \u2500\u2500\n  {\n    \"model\": \"provider/model\",          // optional; falls back to cheap-worker.defaultModel\n    \"tools\": [\"read\",\"grep\",\"msm\",...], // non-MSM toolbar whitelist \u2014 anything not listed is REMOVED from the schema\n    \"msms\":  [\"msm-a\",\"msm-b\"],         // MSM whitelist \u2014 msm exec may only run these; register/deregister always refused\n    \"cognitiveTrajectory\": { \"session\": true, \"keeper\": true, \"rebuild\": true },  // defaults TRUE (see below)\n    \"systemPromptFile\": \".opencode/skiff/<role>.md\",  // recommended: relative to CCC root, hot-reloads on save\n    \"systemPrompt\": \"...\"                             // inline fallback; systemPromptFile wins when both are set\n  }\n\n\u2500\u2500 Two whitelists, both default-deny \u2500\u2500\n  - `tools: []` + non-empty `msms` = pure-MSM \u8F68\u8FF9\u7EA6\u675F (the usual knowledge-QA shape)\n  - non-empty `msms` \u21D2 the `msm` tool is added automatically (the only entry point for MSMs)\n  - anything outside both lists is invisible in the schema, not merely rejected at call time\n\n\u2500\u2500 cognitiveTrajectory: why the defaults are TRUE \u2500\u2500\n  The workspace of a \u8F68\u8FF9\u7EA6\u675F is its own SESSION.md. Setting these to false would cut it off from\n  its own body, so `session`/`keeper`/`rebuild` all default to true. Set false explicitly only\n  when you deliberately want that participation off.\n\n\u2500\u2500 WeChat routing: user \u2192 trajectory code \u2500\u2500\n  `weixin.routes`: `[{ \"user\": \"<wx id or *>\", \"trajectory\": \"<code>\" }]`\n  A route pointing at a code with no such trajectory is a hard error (the message is NOT delivered).\n  A trajectory WITHOUT `trajectory-constraint.json` is still a legal target \u2014 it is just an ordinary trajectory.\n\n\u2500\u2500 Operating it \u2500\u2500\n  Everything is read live: saving `trajectory-constraint.json` takes effect on the next turn, no restart.\n    (The prompt FILE hot-reloads by mtime; the JSON itself is re-read every turn.)\n  After editing, run container_admin config apply for an explicit validation + confirmation pass.\n  Skill loading is always available to \u8F68\u8FF9\u7EA6\u675F sessions (skills are not whitelisted \u2014 they are read-only knowledge).";
+/** 轨迹约束 定义教程：概念 ／ `trajectory.json` schema ／ 双白名单 ／ 轨迹纪律 ／ 微信路由 */
+export declare const TRAJECTORY_CONSTRAINT_GUIDE: string;
 /** 校验当前 CCC 的 轨迹约束面：msms 均已注册 ／ model ∈ cheap-worker.models ／ 提示词非空 */
 export declare function validateTrajectoryConstraint(root: string): JsonValue;
 /** 列出当前 CCC 的轨迹约束（编码 ／ 模型 ／ msms ／ tools ／ 纪律摘要 ／ 提示词来源） */

package/lib/trajectory/bound.d.ts

@@ -32,6 +32,8 @@ interface SessionBoundRecord {
     action: SessionBoundAction;
     at: number;
     note?: string;
+    /** 🆕 ACC 以"用户开场白"形态建的载体（判决 D171）。**布尔事实**，不从 `note` 文案推。 */
+    createdAsUser?: boolean;
     /**
      * **(b) 已被取代标记**（S142 §0y，所有者 2026-09-18 裁「b 做」）。
      *
@@ -166,5 +168,6 @@ export declare function appendBound(session: unknown, action: SessionBoundAction
     mdPath: string;
     sessionId?: string;
     note?: string;
+    createdAsUser?: boolean;
 }): boolean;
 export {};

package/lib/trajectory/core.d.ts

@@ -109,6 +109,14 @@ export declare function isValidTrajectoryCode(code: string): boolean;
  * @returns 编码；目录名不带日期前缀（非本工具建的 / 损坏）→ `null`
  */
 export declare function parseTrajectoryCode(dirName: string): string | null;
+/**
+ * 从目录名取**可读描述**（编码之后那一段；没有就返回空串）。
+ *
+ * 用途：给"模拟用户开场白"当标签（D171）。判据 = 与 {@link parseTrajectoryCode} **互逆、同源**：
+ * 剥日期前缀 → 第一段是编码 → 其后（去掉前导 `--`）全是描述。
+ * ⚠️ 描述里**可以**含 `--`（只有编码不许）⇒ 这里必须取"第一段之后整串"，不能 split 再取第二段。
+ */
+export declare function trajectoryDescOf(dirName: string): string;
 /**
  * UID 的声明文件名（**固定名、住在轨迹目录内**）。
  *
@@ -162,6 +170,16 @@ export declare function isValidUid(uid: string): boolean;
  * 🔴 **形态非法的文件按"没设定"处理，而不是报错**：解析侧出现在**每一次** `findSession` 里
  * （show/use/archive/send-now/send-later 全走它），在那里抛错会让一个坏文件**炸掉整条轨迹的所有操作**
  * —— 惩罚远大于问题本身。而写入侧已退役 ⇒ 坏文件只可能来自外部手改，更不该连坐。
+ *
+ * ## 🆕 2026-10-19 owner 裁 Q2：**声明文件里的 `uid` 优先，独立文件回落**
+ *
+ * 收拢后这个旧标识住在 `<轨迹目录>/trajectory.json` 的 `uid` 字段里（它属"声明"，
+ * 与约束面/机器绑定同源）。判据（**两代并读，不硬切**）：
+ * **声明面里有合法 `uid` ⇒ 用它；否则回落 `TRAJECTORY-UID` 文件**。
+ *
+ * ⚠️ **为什么字段名是 `uid` 而不是方案书里写的 `code`**：`code` 在本仓已有一个**更窄的含义**
+ * —— 目录名里那个固定位置的轨迹编码（`parseTrajectoryCode`）。同一个词在一个 JSON 里表示两件事，
+ * 正是本轨反复抓的那类"名字会撒谎"。⇒ 旧标识就叫 `uid`（它本来就是 UID，见 `UID_FILENAME`）。
  */
 export declare function readTrajectoryUid(sessionPath: string): string | null;
 /**

package/lib/trajectory/policy/files.d.ts

@@ -0,0 +1,75 @@
+/**
+ * trajectory/policy/files.ts — **轨迹级文件的文件名族**（owner 2026-10-19 裁 Q2：短名 `trajectory.json`）
+ *
+ * ## 这一层解决什么（白话）
+ *
+ * 一条轨迹目录里，ACC 自己产的文件原先有**四个名字各异的文件**：
+ * `trajectory-constraint.json`（约束面）／`TRAJECTORY-UID`（只读遗留的旧标识）／
+ * `cro-host-binding`（一行机器名）／`cro-wake-log.json`（CRO 流水）。
+ * 后两个里，**「声明」性质的那两个现在并进一个 JSON**（流水不并 —— 见 `cro/log.ts` 的理由）。
+ *
+ * ⇒ 收拢后的形态：
+ *
+ * ```text
+ * <轨迹目录>/
+ *   SESSION.md                 ← 轨迹的身体（不动）
+ *   PROMPT.md                  ← 章程（不动）
+ *   continuous-re-occurrence.ts← CRO 程序（不动）
+ *   trajectory.json            ← 🆕 声明面：约束 ＋ 旧标识(code) ＋ cro.host
+ *   cro-wake-log.log           ← CRO 流水（高频追加，**刻意不并入**）
+ * ```
+ *
+ * ## 🔴 为什么不硬切（本容器已两次栽在"上游改名、下游写死旧名"）
+ *
+ * 读取侧认**族**：`trajectory.json`（新）→ `trajectory-constraint.json`（v1.74 名）→
+ * `skiff.json`（v1.71 名）。**任一存在即成立**。上游再改名只往族里加一项，不再单点写死。
+ *
+ * 🔴 **`cro-host-binding` 必须两代并读，这一条是有行为后果的**
+ * （理由逐字保留在 `cro/core.ts` 的 `resolveCroHostBinding` 头注）：
+ * 绑定声明要**跟着轨迹走到第二台机器**，在那里被判成「绑给了别人」而**正确地不跑**。
+ * 若硬切改名，第二台机器读到的是**「没绑」** —— **表面结果相同，但判据退化**
+ * （失去"明确绑给别人"的可诊断性）⇒ 只能两代并读。
+ *
+ * ## 归属（D23）
+ * 本模块只管**机制**（文件叫什么、按什么顺序找、怎么读）；**内容归 CCC**
+ * （JSON 里填什么：模型 / 白名单 / 提示词路径 / 机器名）。
+ *
+ * ## 边界与铁律
+ * 本模块**零本地依赖**（只用 `node:fs` / `node:path`）⇒ 谁 import 它都不会成环。
+ * 每个读取函数**永不抛**：文件不存在 / 坏 JSON ⇒ `null`，由调用方各自决定降级方式。
+ */
+/**
+ * 收拢后的**新**文件名（owner 裁 Q2「短名」）。
+ *
+ * 🔴 **为什么要改名**：它装的不止"约束"了（还有 `code` 与 `cro.host`）
+ * ⇒ 留着旧名会让**名字本身就是错名**（D151 同族：界面/文档里的名字会随内容演进而撒谎）。
+ */
+export declare const TRAJECTORY_FILENAME = "trajectory.json";
+/**
+ * **判据族**：任一存在 ⇒ 这条轨迹有声明面（= 旧模型说的"它是一个轨迹约束"）。
+ *
+ * ⚠️ **顺序即优先级**（第一个找到的胜过后面的）：新名优先，两个旧名按代际倒序。
+ * ⚠️ **准入面宽于约束面是有意的**：约束文件缺失的轨迹仍需要能被当作轨迹处理。
+ */
+export declare const TRAJECTORY_FILENAME_FAMILY: readonly ["trajectory.json", "trajectory-constraint.json", "skiff.json"];
+/** 旧名的单独导出（调用方要单独判断"这是不是旧档"时用；顺序同上、不含新名） */
+export declare const TRAJECTORY_LEGACY_FILENAMES: ("trajectory.json" | "trajectory-constraint.json" | "skiff.json")[];
+/**
+ * 在一条轨迹目录里找**声明文件**（族内第一个存在的）。
+ *
+ * @param trajectoryDir 轨迹目录绝对路径
+ * @returns 命中的文件绝对路径；族内一个都不存在 ⇒ `null`（= 普通轨迹，**常态不是错误**）
+ */
+export declare function findTrajectoryFile(trajectoryDir: string): string | null;
+/**
+ * 读一条轨迹目录里的声明文件，解析成对象（**永不抛**）。
+ *
+ * @returns `{ file, data }`：`file` 是命中的文件名（族内哪个），`data` 是解析后的对象；
+ *          **族内无文件 ⇒ `null`**；**坏 JSON / 顶层非对象 ⇒ `{ file, data: null, error }`**
+ *          —— 这三种情形调用方的降级方式各不相同（普通轨迹 / 告警后按普通轨迹），故分开给。
+ */
+export declare function readTrajectoryFile(trajectoryDir: string): {
+    file: string;
+    data: Record<string, unknown> | null;
+    error: string | null;
+} | null;

package/lib/trajectory/policy/profile.d.ts

@@ -31,8 +31,13 @@
  * ⚠️ **文件名 `profile` 与 `trajectory-constraint.json` / `TrajectoryConstraint` 等符号名一律不动**：
  * 那是有具体指称的东西（一个固定文件名 ＋ 它的解析结果），不是组织单位。
  */
-/** `trajectory-constraint.json` 的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
-export declare const TRAJECTORY_CONSTRAINT_FILENAME = "trajectory-constraint.json";
+/**
+ * 🆕 **声明文件的文件名**（2026-10-19 owner 裁 Q2：短名 `trajectory.json`）。
+ *
+ * ⚠️ **判据不是"这个名字在不在"**，而是**族内任一存在**（`TRAJECTORY_FILENAME_FAMILY`）。
+ * 这个名字只是**写入目标**与**提示文案里该印的那个**。
+ */
+export declare const TRAJECTORY_CONSTRAINT_FILENAME = "trajectory.json";
 /**
  * 一个 轨迹约束轨迹的**完整约束面**（= 旧 `轨迹约束.roles.<name>` 那套，整体搬进轨迹目录）。
  *

package/lib/trajectory/policy/window.d.ts

@@ -26,8 +26,8 @@
  * （此时持久绑定已落盘 ⇒ 由它接管，**不会因为内存空而失去约束**）。
  */
 /** 注册表值：该 dsh 会话承载哪条轨迹（`trajectoryDirName` 为空串 = 已登记但还没定轨迹） */
-interface 轨迹约束SessionBinding {
-    /** 轨迹目录名（`YYYY-MM-DD--<code>[--<desc>]`）——**轨迹约束 身份的唯一载体** */
+interface TrajectorySessionBinding {
+    /** 轨迹目录名（`YYYY-MM-DD--<code>[--<desc>]`）——**轨迹身份的唯一载体** */
     trajectoryDirName: string;
     /** CCC 根（多 CCC 时防止串味：同 sessionId 复用必须同 (轨迹, CCC)） */
     ccc: string;
@@ -39,9 +39,9 @@ export declare function unregisterTrajectorySession(sessionId: string): void;
 /** 查会话承载的轨迹目录名（无 → null）；`guards`/`system-prompt` 的同步热路径用 */
 export declare function trajectoryDirNameForSession(sessionId: string): string | null;
 /** 查会话的完整绑定（轨迹 + CCC；无 → null）——追问延续时校验 (轨迹, CCC) 未串味 */
-export declare function trajectorySessionInfo(sessionId: string): 轨迹约束SessionBinding | null;
+export declare function trajectorySessionInfo(sessionId: string): TrajectorySessionBinding | null;
 /** 测试/诊断：注册表快照 */
-export declare function trajectorySessionSnapshot(): ReadonlyMap<string, 轨迹约束SessionBinding>;
+export declare function trajectorySessionSnapshot(): ReadonlyMap<string, TrajectorySessionBinding>;
 /** 测试：清空（进程级状态，用例间必须复位） */
 export declare function resetTrajectorySessions(): void;
 export {};

package/lib/trajectory/session.d.ts

@@ -83,7 +83,7 @@ export declare function workspaceCognitiveTrajectoryLine(mdPath: string): string
  * @returns true = 段已在位；false = 该 agent 挂不上（调用方降级为 question 前缀注入）
  */
 export declare function ensureWorkspacePromptSection(agent: Agent, scope: string, root: string): boolean;
-interface 轨迹约束AgentRef {
+interface TrajectoryAgentRef {
     handle: AgentHandle;
     agent: Agent;
     sessionId: string;
@@ -100,8 +100,8 @@ interface 轨迹约束AgentRef {
  * @param profile 该 轨迹约束的约束面（来自 `trajectory-constraint.json`）
  * @param sessionId 指定会话 id（可选；微信桥等外部面用固定 id 实现"轨迹 ↔ 会话"长期映射）
  */
-export declare function createTrajectoryAgent(ctx: Context, root: string, profile: TrajectoryConstraint, defaultModel?: string, sessionId?: string): Promise<轨迹约束AgentRef>;
-interface 轨迹约束AskResult {
+export declare function createTrajectoryAgent(ctx: Context, root: string, profile: TrajectoryConstraint, defaultModel?: string, sessionId?: string): Promise<TrajectoryAgentRef>;
+interface TrajectoryAskResult {
     answer: string;
     sessionId: string;
 }
@@ -132,7 +132,7 @@ export declare function waitForTurnAssistant(ctx: unknown, agent: Agent, beforeA
  */
 export declare function askTrajectory(ctx: Context, agent: Agent, question: string, options?: {
     timeoutMs?: number;
-}): Promise<轨迹约束AskResult>;
+}): Promise<TrajectoryAskResult>;
 /**
  * 轨迹约束会话的轨迹纪律参与判定：**不是 轨迹约束恒 true**（正常参与）；
  * 轨迹约束 按 `trajectory-constraint.json` 的 `cognitiveTrajectory` 子集决定。
@@ -142,7 +142,7 @@ export declare function askTrajectory(ctx: Context, agent: Agent, question: stri
  * 纪律参与项的失败不该让会话失去 keeper/rebuild（那是能力倒退，比多跑一次更糟）。
  */
 export declare function trajectoryConstraintParticipates(root: string, sessionId: string | undefined, key: 'session' | 'keeper' | 'rebuild'): boolean;
-interface 轨迹约束MsmGate {
+interface TrajectoryConstraintMsmGate {
     /** 拒绝原因（有则拒绝执行） */
     reject?: string;
     /** list 显示白名单（msms）；仅 action==='list' 时有值 */
@@ -153,12 +153,12 @@ interface 轨迹约束MsmGate {
  * exec 非白名单 MSM 拒绝（**不列名单**）、register/deregister 必拒、
  * list 白名单过滤、check/guide/ccc-config 只读放行。
  */
-export declare function trajectoryConstraintMsmGate(root: string, sessionId: string | undefined, action: string, name?: string): 轨迹约束MsmGate;
-/** 该 轨迹约束会话的工具白名单（guards 的 schema 收窄用） */
-export declare function 轨迹约束ToolWhitelist(root: string, sessionId: string | undefined): Set<string> | null;
+export declare function trajectoryConstraintMsmGate(root: string, sessionId: string | undefined, action: string, name?: string): TrajectoryConstraintMsmGate;
+/** 该轨迹约束会话的工具白名单（guards 的 schema 收窄用） */
+export declare function trajectoryConstraintToolWhitelist(root: string, sessionId: string | undefined): Set<string> | null;
 /** 按编码解析 轨迹约束（路由/调试页/审计用） */
 export declare function trajectoryConstraintByCode(root: string, code: string): TrajectoryConstraint | null;
 /** 编码 → 轨迹目录名（路由用；只做精确匹配） */
-export declare function 轨迹约束DirNameByCode(root: string, code: string): string | null;
+export declare function trajectoryConstraintDirNameByCode(root: string, code: string): string | null;
 /** 一次性解析提示词全文（admin/validate 用；热路径不要用） */
-export declare function 轨迹约束SystemPrompt(root: string, profile: TrajectoryConstraint | null | undefined): string;
+export declare function trajectoryConstraintSystemPrompt(root: string, profile: TrajectoryConstraint | null | undefined): string;