@shgroup/dsh-serenity-hooks 1.73.0 → 1.74.0

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

@@ -1,53 +1,53 @@
 /**
- * trajectory/policy/profile.ts — **skiff 的唯一判据**：目录下有 `skiff.json` 的认知轨迹（零 DSH 依赖，可独立单测）
+ * trajectory/policy/profile.ts — **轨迹约束的唯一判据**：目录下有 `trajectory-constraint.json` 的认知轨迹（零 DSH 依赖，可独立单测）
  *
  * ## 🔴 owner 2026-10-19 重做令（逐字，本文件存在的全部理由）
  *
- * > 「skiff 复杂的约束和提示词体系都干掉，改为这样的实现：
- * > **skiff 本身是认知轨迹的一个特殊情况，即目录下拥有 `skiff.json` 的认知轨迹自动是一个 skiff**
- * > （json 里配置上个版本就有的各种约束），**会话跑在认知轨迹上且发现 `skiff.json`，则运行时实现各类约束**」
+ * > 「轨迹约束 复杂的约束和提示词体系都干掉，改为这样的实现：
+ * > **轨迹约束本身是认知轨迹的一个特殊情况，即目录下拥有 `trajectory-constraint.json` 的认知轨迹自动是一个 轨迹约束**
+ * > （json 里配置上个版本就有的各种约束），**会话跑在认知轨迹上且发现 `trajectory-constraint.json`，则运行时实现各类约束**」
  *
  * ## 旧模型 → 新模型（**一条判据取代四条**）
  *
  * | 项 | 旧 | 新 |
  * |---|---|---|
- * | skiff 是什么 | `serenity.json` 的 `skiff.roles.<name>` 一条配置 | **轨迹目录里有 `skiff.json`** |
- * | 怎么认出 skiff 会话 | dsh sessionId 前缀 `skiff-` | **它绑定的轨迹有 `skiff.json`** |
- * | 工作台从哪来 | `ensureSkiffSession` 另建一个 SESSION | **就是该轨迹自己的 SESSION.md** |
+ * | 轨迹约束是什么 | `serenity.json` 的 `轨迹约束.roles.<name>` 一条配置 | **轨迹目录里有 `trajectory-constraint.json`** |
+ * | 怎么认出 轨迹约束会话 | dsh sessionId 前缀 `轨迹约束-` | **它绑定的轨迹有 `trajectory-constraint.json`** |
+ * | 工作台从哪来 | `ensureTrajectorySession` 另建一个 SESSION | **就是该轨迹自己的 SESSION.md** |
  * | 身份 | 角色名 | **轨迹编码**（`trajectory/core.ts` 的 `parseTrajectoryCode`） |
  *
  * ⇒ 收益（owner：「理解难度大幅下降」的实际内容）：四个各自会漂的机制收敛为**一条文件存在性判据**。
- * 删掉 `skiff.json` ⇒ 该轨迹**当场**退化为普通轨迹（工具面、提示词、keeper 全部恢复默认）。
+ * 删掉 `trajectory-constraint.json` ⇒ 该轨迹**当场**退化为普通轨迹（工具面、提示词、keeper 全部恢复默认）。
  *
  * ## 归属（D23）
  * **机制在 ACC**（文件叫什么、怎么读、怎么判、缺省值、如何施加约束）；
- * **内容在 CCC**（`skiff.json` 里填什么：模型、白名单、提示词路径）。
- * ⇒ ACC 代码里**不出现任何具体角色名**，也不读 `serenity.json` 的 skiff 段（该段已退役）。
+ * **内容在 CCC**（`trajectory-constraint.json` 里填什么：模型、白名单、提示词路径）。
+ * ⇒ ACC 代码里**不出现任何具体角色名**，也不读 `serenity.json` 的 轨迹约束段（该段已退役）。
  *
- * ## S12（2026-10-19，轨迹中心重构）：此前位于 `role/skiff/` 下（该目录已随本重构消失）
+ * ## S12（2026-10-19，轨迹中心重构）：此前位于 `role/轨迹约束/` 下（该目录已随本重构消失）
  *
  * 落点 = `trajectory/policy/`。判据（判读表 §3.1）：本文件判的是**某条轨迹的约束面**，
  * 主语是轨迹 ⇒ 它一直就是轨迹切面，只是旧目录把它挂在"角色"这个**平行概念**下。
- * ⚠️ **文件名 `profile` 与 `skiff.json` / `SkiffProfile` 等符号名一律不动**：
+ * ⚠️ **文件名 `profile` 与 `trajectory-constraint.json` / `TrajectoryConstraint` 等符号名一律不动**：
  * 那是有具体指称的东西（一个固定文件名 ＋ 它的解析结果），不是组织单位。
  */
-/** `skiff.json` 的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
-export declare const SKIFF_PROFILE_FILENAME = "skiff.json";
+/** `trajectory-constraint.json` 的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
+export declare const TRAJECTORY_CONSTRAINT_FILENAME = "trajectory-constraint.json";
 /**
- * 一个 skiff 轨迹的**完整约束面**（= 旧 `skiff.roles.<name>` 那套，整体搬进轨迹目录）。
+ * 一个 轨迹约束轨迹的**完整约束面**（= 旧 `轨迹约束.roles.<name>` 那套，整体搬进轨迹目录）。
  *
  * ⚠️ 与旧配置的**一处有意语义翻转**（R↓，别当成"顺手改默认值"）：
- * `cognitiveTrajectory.*` 在旧模型里**缺省全 false**（"skiff 完全独立"），理由是
- * **它的工作台是外挂的**（`ensureSkiffSession` 另建一个 SESSION，不由轨迹承载）。
+ * `cognitiveTrajectory.*` 在旧模型里**缺省全 false**（"轨迹约束 完全独立"），理由是
+ * **它的工作台是外挂的**（`ensureTrajectorySession` 另建一个 SESSION，不由轨迹承载）。
  * 新模型里**工作台就是它自己的 SESSION.md** ⇒ 全 false 会让它拿不到自己的身体
  * ⇒ **缺省翻成 true**。这不是偏好问题，是两个模型的结构差。
  */
-export interface SkiffProfile {
+export interface TrajectoryConstraint {
     /** 该约束面所属轨迹的目录名（`YYYY-MM-DD--<code>[--<desc>]`） */
     dirName: string;
     /** 轨迹编码（= 唯一标识；见 `parseTrajectoryCode`） */
     code: string;
-    /** `skiff.json` 的绝对路径 */
+    /** `trajectory-constraint.json` 的绝对路径 */
     path: string;
     /** 模型（`provider/model`）；缺省回退 `cheap-worker.defaultModel` */
     model?: string;
@@ -67,26 +67,26 @@ export interface SkiffProfile {
     systemPromptFile?: string;
 }
 /**
- * 读一个目录下的 `skiff.json`（**纯读，不施加约束**）。
+ * 读一个目录下的 `trajectory-constraint.json`（**纯读，不施加约束**）。
  *
  * @param trajectoryDir 轨迹目录绝对路径
  * @param root CCC 根（仅用于 `systemPromptFile` 的逃逸拒绝）
- * @returns 归一后的约束面；**无该文件 → `null`（= 这不是 skiff，常态，不是错误）**
+ * @returns 归一后的约束面；**无该文件 → `null`（= 这不是 轨迹约束，常态，不是错误）**
  *
  * ⚠️ **形态容错**：数组元素非字符串 → 丢弃该项（不整份作废）；`cognitiveTrajectory`
  * 缺项 → 各自取 **true**（见 R↓）；`model` 空白 → undefined（回退缺省）。
- * 坏 JSON ⇒ 告警 + `null`（**按"不是 skiff"处理**：宁可让它退回普通轨迹，也不要带着
+ * 坏 JSON ⇒ 告警 + `null`（**按"不是 轨迹约束"处理**：宁可让它退回普通轨迹，也不要带着
  * 半份读不懂的权限面运行）。
  */
-export declare function readSkiffProfileAt(trajectoryDir: string, root: string): SkiffProfile | null;
+export declare function readTrajectoryConstraintAt(trajectoryDir: string, root: string): TrajectoryConstraint | null;
 /**
- * 按**轨迹编码**解析 skiff 约束面（`list`/`admin`/调试页/路由解析用）。
+ * 按**轨迹编码**解析 轨迹约束面（`list`/`admin`/调试页/路由解析用）。
  *
- * @returns 约束面；轨迹不存在 ／ 无 `skiff.json` → `null`
+ * @returns 约束面；轨迹不存在 ／ 无 `trajectory-constraint.json` → `null`
  */
-export declare function readSkiffProfileByCode(root: string, code: string): SkiffProfile | null;
-/** 扫全部活跃轨迹，返回全部 skiff。**顺序按目录名**（确定性，便于对读）。 */
-export declare function listSkiffProfiles(root: string): SkiffProfile[];
+export declare function readTrajectoryConstraintByCode(root: string, code: string): TrajectoryConstraint | null;
+/** 扫全部活跃轨迹，返回全部 轨迹约束。**顺序按目录名**（确定性，便于对读）。 */
+export declare function listTrajectoryConstraints(root: string): TrajectoryConstraint[];
 /**
  * 编码 → 轨迹目录名（活跃轨迹内）。找不到 → `null`。
  *
@@ -96,27 +96,27 @@ export declare function listSkiffProfiles(root: string): SkiffProfile[];
  */
 export declare function findDirNameByCode(root: string, code: string): string | null;
 /**
- * **会话级**判据（J2）：这个 dsh 会话是不是 skiff 会话 —— 唯一入口。
+ * **会话级**判据（J2）：这个 dsh 会话是不是 轨迹约束会话 —— 唯一入口。
  *
- * 判据 = **它绑定的轨迹有 `skiff.json`**（不是 sessionId 前缀，也不是配置里有没有角色）。
+ * 判据 = **它绑定的轨迹有 `trajectory-constraint.json`**（不是 sessionId 前缀，也不是配置里有没有角色）。
  *
  * ## 为什么"绑定的轨迹"从两个来源取（R↓，一个失败模式）
  * ① **持久绑定**（`readLastBound`，宿主存储域/`.bindings.json`）—— 权威，跨重启成立；
  * ② **内存注册表**（`trajectory/policy/window`）—— 覆盖绑定的**窗口期**（轨迹刚定、bound 还没落盘）。
- * ⇒ 只取 ① 会在建会话的第一轮判成"不是 skiff"（工具面不收窄，模型看见不该有的工具）；
- *    只取 ② 会在进程重启后全判成"不是"（skiff 失去约束，**权限面静默放开**）。
+ * ⇒ 只取 ① 会在建会话的第一轮判成"不是 轨迹约束"（工具面不收窄，模型看见不该有的工具）；
+ *    只取 ② 会在进程重启后全判成"不是"（轨迹约束 失去约束，**权限面静默放开**）。
  * ⇒ **两来源并取**，都不中才 `null`。
  *
  * @param root CCC 根
  * @param sessionId dsh 会话 id
  * @param boundDirName 调用方已解析的绑定目录名（可选；给了就省一次读绑定）
- * @returns 约束面；不是 skiff 会话 → `null`
+ * @returns 约束面；不是 轨迹约束会话 → `null`
  */
-export declare function skiffProfileForSession(root: string, sessionId: string | undefined, boundDirName?: string | null): SkiffProfile | null;
+export declare function trajectoryConstraintForSession(root: string, sessionId: string | undefined, boundDirName?: string | null): TrajectoryConstraint | null;
 /**
- * 该 dsh 会话**是不是** skiff 会话（布尔形态的 `skiffProfileForSession`）。
+ * 该 dsh 会话**是不是** 轨迹约束会话（布尔形态的 `trajectoryConstraintForSession`）。
  *
  * 存在的理由：调用点很多只要一个"是/不是"（seams 的旁路判定），
  * 让它们各自写 `!== null` 会把判据散开；**判据只能有一个入口**。
  */
-export declare function isSkiffSession(root: string, sessionId: string | undefined): boolean;
+export declare function isTrajectoryConstrained(root: string, sessionId: string | undefined): boolean;

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

@@ -5,35 +5,35 @@
  *
  * | 模块 | 管什么 |
  * |---|---|
- * | `./profile.ts` | **判据 + 读盘**（"这是不是 skiff"、"约束面是什么"） |
+ * | `./profile.ts` | **判据 + 读盘**（"这是不是 轨迹约束"、"约束面是什么"） |
  * | `./rules.ts`（本文件） | **从约束面派生出的纯函数**（白名单集合、提示词读取器、基础提示词文本） |
  * | `../session-create.ts` | 会话创建/复用、提问、守门查询 |
  *
- * ⇒ 本文件**不再读 `serenity.json`**：`skiff.roles` 整段已退役（owner 2026-10-19 重做）。
- * 它只接收一个已解析好的 `SkiffProfile`，因此**不涉及任何 IO**（除提示词文件，那是刻意懒读的）。
+ * ⇒ 本文件**不再读 `serenity.json`**：`轨迹约束.roles` 整段已退役（owner 2026-10-19 重做）。
+ * 它只接收一个已解析好的 `TrajectoryConstraint`，因此**不涉及任何 IO**（除提示词文件，那是刻意懒读的）。
  *
  * ## S12（2026-10-19，轨迹中心重构）
  *
- * 原名 `role/skiff/config.ts`。改名理由（框架 §6.3「角色不是一个概念，是一段历史」）：
+ * 原名 `role/轨迹约束/config.ts`。改名理由（框架 §6.3「角色不是一个概念，是一段历史」）：
  * 它派生的是**某条轨迹的约束面**，与"配置读取"无关（本文件零配置读取，见上一段）
  * ⇒ `config` 这个名字描述的是**它曾经的样子**，`rules` 描述它**现在做的事**。
  */
-import type { SkiffProfile } from './profile.js';
+import type { TrajectoryConstraint } from './profile.js';
 /** 白名单推导 ────────────────────────────────────────────────────────────── */
 /** 提示词来源提示串（`apply` 回执与面板共用；避免两处措辞漂） */
-export declare const SKIFF_PROFILE_HINT = "systemPromptFile hot-reloads by mtime; the rest of skiff.json is re-read every turn";
+export declare const TRAJECTORY_CONSTRAINT_HINT = "systemPromptFile hot-reloads by mtime; the rest of trajectory-constraint.json is re-read every turn";
 /**
- * 该 skiff 会话**可见**的工具面（tools ∪ `msm`）。
+ * 该 轨迹约束会话**可见**的工具面（tools ∪ `msm`）。
  *
- * 🔴 `msm` 为什么自动加入：`msms` 非空意味着这个 skiff **有 MSM 通道**，
+ * 🔴 `msm` 为什么自动加入：`msms` 非空意味着这个 轨迹约束 **有 MSM 通道**，
  * 而 MSM 的唯一合法调用入口是 `msm` 工具（单入口纪律）——不给它 `msm` 就等于
  * 声明了一堆调不动的能力。⚠️ 这是**并集**，不是覆盖：`tools` 里显式写的照旧生效。
  */
-export declare function profileToolWhitelist(profile: SkiffProfile | null | undefined): Set<string>;
-/** 该 skiff 会话可 exec 的 MSM 白名单（`msm` 工具内部再过滤；独立于工具白名单） */
-export declare function profileMsmWhitelist(profile: SkiffProfile | null | undefined): Set<string>;
-/** 轨迹纪律参与项（`profile` 缺省已在 `readSkiffProfileAt` 归一为全 true） */
-export declare function profileCognitiveTrajectory(profile: SkiffProfile | null | undefined): {
+export declare function profileToolWhitelist(profile: TrajectoryConstraint | null | undefined): Set<string>;
+/** 该 轨迹约束会话可 exec 的 MSM 白名单（`msm` 工具内部再过滤；独立于工具白名单） */
+export declare function profileMsmWhitelist(profile: TrajectoryConstraint | null | undefined): Set<string>;
+/** 轨迹纪律参与项（`profile` 缺省已在 `readTrajectoryConstraintAt` 归一为全 true） */
+export declare function constraintCognitiveTrajectory(profile: TrajectoryConstraint | null | undefined): {
     session: boolean;
     keeper: boolean;
     rebuild: boolean;
@@ -46,9 +46,22 @@ export declare function profileCognitiveTrajectory(profile: SkiffProfile | null
  *
  * ⚠️ 热路径**不用**它（那会用每次工具调用去读盘）——热路径用 `createProfilePromptReader`。
  */
-export declare function resolveProfileSystemPrompt(root: string, profile: SkiffProfile | null | undefined): string;
-/** 提示词来源（`list`/`validate` 展示用） */
-export declare function profileSystemPromptSource(profile: SkiffProfile | null | undefined): 'file' | 'inline' | 'none';
+export declare function resolveConstraintSystemPrompt(root: string, profile: TrajectoryConstraint | null | undefined): string;
+/**
+ * 提示词来源（`list`/`validate` 展示用）。
+ *
+ * 🔴 **2026-10-19 修（T4 的漏网面）**：v1.72.0 起提示词有两代来源——**新形态**
+ * 是轨迹目录里的 `PROMPT.md`（`trajectory/prompt.ts`，**优先**），旧形态才是
+ * `systemPromptFile` / `systemPrompt`。本函数原先只认旧形态 ⇒ 两条只写了 `PROMPT.md`
+ * 的轨迹在 `container_admin config list` 里恒显示 `promptSource: 'none'`。
+ *
+ * 那是**读数器过时**，不是配置缺失：`validate` 侧早已按两条来源判（见
+ * `trajectory-constraint-admin.ts` 的 `hasTrajectoryPromptOrLegacy`），而 `list` 侧漏了。
+ * ⇒ 返 **四种**值，把"有章程但来源是新形态"这一格单独说出来。
+ *
+ * @param hasPromptFile 该轨迹目录下**是否真有** `PROMPT.md`（调用方查，本函数不做 IO）
+ */
+export declare function constraintSystemPromptSource(profile: TrajectoryConstraint | null | undefined, hasPromptFile?: boolean): 'trajectory-file' | 'file' | 'inline' | 'none';
 /**
  * 提示词**读取器**（长期热更新；改文件即生效，无需重启）。
  *
@@ -62,9 +75,9 @@ export declare function profileSystemPromptSource(profile: SkiffProfile | null |
  * @param root CCC 根
  * @param profile 约束面
  */
-export declare function createProfilePromptReader(root: string, profile: SkiffProfile | null | undefined): () => string;
+export declare function createProfilePromptReader(root: string, profile: TrajectoryConstraint | null | undefined): () => string;
 /**
- * skiff 基础提示词（dsp 只给这部分；CCC 的 `systemPrompt` 段由调用方拼接）。
+ * 轨迹约束 基础提示词（dsp 只给这部分；CCC 的 `systemPrompt` 段由调用方拼接）。
  *
  * ## 🔴 为什么**不再枚举**清单（owner 2026-10-19 令）
  *
@@ -80,6 +93,6 @@ export declare function createProfilePromptReader(root: string, profile: SkiffPr
  *
  * ⇒ 现在只声明**边界与发现路径**，不抄内容：清单在哪，怎么取，越界会怎样。
  *
- * @param code 轨迹编码（skiff 的身份 —— 不是"角色名"，那个概念已退役）
+ * @param code 轨迹编码（轨迹约束的身份 —— 不是"角色名"，那个概念已退役）
  */
-export declare function buildSkiffBasePrompt(code: string): string;
+export declare function buildTrajectoryBasePrompt(code: string): string;

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

@@ -4,11 +4,11 @@
  * ## 它现在只做一件事：**把「会话」映到「轨迹」**
  *
  * 旧形态存的是 `{role, ccc}`（角色名）。owner 2026-10-19 重做后 **角色名不再存在**——
- * skiff 的身份是**轨迹编码**，约束面住在该轨迹的 `skiff.json` 里（见 `./profile.ts`）。
+ * 轨迹约束的身份是**轨迹编码**，约束面住在该轨迹的 `trajectory-constraint.json` 里（见 `./profile.ts`）。
  * ⇒ 本表退化为一张**会话 → 轨迹目录名**的内存映射，供**同步**热路径（guards / system-prompt）查询；
  * 权威来源仍是持久绑定（`trajectory/bound.ts` 的 `readLastBound`）。
  *
- * ## S12（2026-10-19，轨迹中心重构）：原名 `role/skiff/registry.ts`
+ * ## S12（2026-10-19，轨迹中心重构）：原名 `role/轨迹约束/registry.ts`
  *
  * 改名理由：它**不是**一张"注册表"（注册表的语义是权威名单），它是**权威来源之外的一个窗口**——
  * 覆盖「轨迹已定、绑定还没落盘」那一段（见下方「为什么还需要这张内存表」）。
@@ -16,32 +16,32 @@
  *
  * ## 为什么还需要这张内存表（R↓，一个窗口期）
  *
- * 持久绑定是**异步落盘**的（宿主存储域写入）。会话刚建立、`skiff.json` 已生效、绑定的记录
- * 还没落盘的那一段，`readLastBound` 返回 null ⇒ 若只认持久绑定，**第一轮会被判成"不是 skiff"**
+ * 持久绑定是**异步落盘**的（宿主存储域写入）。会话刚建立、`trajectory-constraint.json` 已生效、绑定的记录
+ * 还没落盘的那一段，`readLastBound` 返回 null ⇒ 若只认持久绑定，**第一轮会被判成"不是 轨迹约束"**
  * ⇒ 工具面不收窄（模型看见并会去试它不该有的工具）。
- * ⇒ 两个来源并取（见 `profile.ts` 的 `skiffProfileForSession`），**都不中才判"不是"**。
+ * ⇒ 两个来源并取（见 `profile.ts` 的 `trajectoryConstraintForSession`），**都不中才判"不是"**。
  *
  * ## 生命周期
  * 进程内存态：连接/会话关闭时解绑（`lifecycle.ts`），进程重启自然清空
  * （此时持久绑定已落盘 ⇒ 由它接管，**不会因为内存空而失去约束**）。
  */
 /** 注册表值：该 dsh 会话承载哪条轨迹（`trajectoryDirName` 为空串 = 已登记但还没定轨迹） */
-interface SkiffSessionBinding {
-    /** 轨迹目录名（`YYYY-MM-DD--<code>[--<desc>]`）——**skiff 身份的唯一载体** */
+interface 轨迹约束SessionBinding {
+    /** 轨迹目录名（`YYYY-MM-DD--<code>[--<desc>]`）——**轨迹约束 身份的唯一载体** */
     trajectoryDirName: string;
     /** CCC 根（多 CCC 时防止串味：同 sessionId 复用必须同 (轨迹, CCC)） */
     ccc: string;
 }
 /** 登记/更新一个会话 → 轨迹的映射 */
-export declare function registerSkiffSession(sessionId: string, trajectoryDirName: string, ccc: string): void;
+export declare function registerTrajectorySession(sessionId: string, trajectoryDirName: string, ccc: string): void;
 /** 解绑（会话销毁 / 轨迹失效 ⇒ 换身份） */
-export declare function unregisterSkiffSession(sessionId: string): void;
+export declare function unregisterTrajectorySession(sessionId: string): void;
 /** 查会话承载的轨迹目录名（无 → null）；`guards`/`system-prompt` 的同步热路径用 */
-export declare function skiffTrajectoryDirNameFor(sessionId: string): string | null;
+export declare function trajectoryDirNameForSession(sessionId: string): string | null;
 /** 查会话的完整绑定（轨迹 + CCC；无 → null）——追问延续时校验 (轨迹, CCC) 未串味 */
-export declare function skiffSessionInfo(sessionId: string): SkiffSessionBinding | null;
+export declare function trajectorySessionInfo(sessionId: string): 轨迹约束SessionBinding | null;
 /** 测试/诊断：注册表快照 */
-export declare function skiffSessionSnapshot(): ReadonlyMap<string, SkiffSessionBinding>;
+export declare function trajectorySessionSnapshot(): ReadonlyMap<string, 轨迹约束SessionBinding>;
 /** 测试：清空（进程级状态，用例间必须复位） */
-export declare function resetSkiffSessions(): void;
+export declare function resetTrajectorySessions(): void;
 export {};

package/lib/trajectory/prompt.d.ts

@@ -8,7 +8,7 @@
  * **轨迹提示词** = 一条认知轨迹的**可编辑章程声明**，由 ACC 按固定顺序装配进系统提示词。
  * 三个关键词各是一条判据：
  * - **可编辑**：住在 CCC（盘上），改它**不发版**（D23 归属判据的直接推论）
- * - **声明**：它声明**身份／章程／方法论**，**不声明能力**（能力面归 `skiff.json` 白名单与工具 schema）
+ * - **声明**：它声明**身份／章程／方法论**，**不声明能力**（能力面归 `trajectory-constraint.json` 白名单与工具 schema）
  * - **固定顺序**：装配顺序由 ACC 定死（见 `seams/system-prompt.ts` 的 ⑧ 位）
  *
  * ## 为什么取代「人格」
@@ -23,24 +23,24 @@
  *
  * - **跟着轨迹走**：`archive` 时整个目录搬走，章程不会掉队（旧形态 `.opencode/skiff/<name>.md`
  *   与轨迹**分居两处** —— 多条轨迹共用一份文件正是那个后果）。
- * - **每条轨迹都能有**：不只是 skiff。普通轨迹同样需要"我是谁、按什么章程"。
- * - 与 `SESSION.md`（身体：延续/日志）、`skiff.json`（约束面：能力）三件并列，
+ * - **每条轨迹都能有**：不只是 轨迹约束。普通轨迹同样需要"我是谁、按什么章程"。
+ * - 与 `SESSION.md`（身体：延续/日志）、`trajectory-constraint.json`（约束面：能力）三件并列，
  *   各管一件事，不合并（合并会让"改能力"与"改身份"互相牵连）。
  *
  * ## 兼容（不静默坏）
  *
- * `PROMPT.md` 不存在时**不报错**（普通轨迹常态）。skiff 的旧字段 `systemPromptFile`
+ * `PROMPT.md` 不存在时**不报错**（普通轨迹常态）。轨迹约束的旧字段 `systemPromptFile`
  * 在兼容期仍被读取——优先级见 {@link resolveTrajectoryPrompt}。
  */
-import type { SkiffProfile } from './policy/profile.js';
+import type { TrajectoryConstraint } from './policy/profile.js';
 /** 轨迹提示词的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
 export declare const TRAJECTORY_PROMPT_FILENAME = "PROMPT.md";
 /** 一次解析的结果（`source` 说明正文**从哪来**，便于诊断与「为什么我改的不生效」） */
 export interface TrajectoryPromptResolution {
     /** 提示词正文（已 trim）；无来源 ⇒ 空串 */
     text: string;
-    /** 来源：轨迹目录的 PROMPT.md ／ skiff 旧字段 ／ 无 */
-    source: 'trajectory-file' | 'skiff-legacy' | 'none';
+    /** 来源：轨迹目录的 PROMPT.md ／ 轨迹约束 旧字段 ／ 无 */
+    source: 'trajectory-file' | '轨迹约束-legacy' | 'none';
     /** 实际读取的绝对路径（`none` ⇒ null） */
     path: string | null;
 }
@@ -49,9 +49,9 @@ export declare function trajectoryPromptPath(root: string, dirName: string): str
 /**
  * 该轨迹**有没有**轨迹提示词（单一判据）。
  *
- * 用途：兼容期的"让位"判定 —— 若已有 `PROMPT.md`，skiff 旧字段 `systemPromptFile`
- * 必须**让位**，否则同一份章程会在两处各注入一遍（第 ⑧ 段 ＋ `serenity-skiff` 段）。
- * 🔴 判据只有这一处：别在 skiff 那边自己拼路径再判（两处会漂）。
+ * 用途：兼容期的"让位"判定 —— 若已有 `PROMPT.md`，轨迹约束 旧字段 `systemPromptFile`
+ * 必须**让位**，否则同一份章程会在两处各注入一遍（第 ⑧ 段 ＋ `serenity-轨迹约束` 段）。
+ * 🔴 判据只有这一处：别在 轨迹约束那边自己拼路径再判（两处会漂）。
  */
 export declare function hasTrajectoryPrompt(root: string, dirName: string): boolean;
 /**
@@ -61,13 +61,13 @@ export declare function hasTrajectoryPrompt(root: string, dirName: string): bool
  *
  * 优先级（**确定性，只有这一条**）：
  *   ① `<轨迹目录>/PROMPT.md` —— 新形态，**所有轨迹**都能有
- *   ② skiff 的 `systemPromptFile` —— **兼容期**旧形态（存量 CCC 不必同批迁移）
+ *   ② 轨迹约束的 `systemPromptFile` —— **兼容期**旧形态（存量 CCC 不必同批迁移）
  *   ③ 无 ⇒ 空串（**不是错误**：没有章程的轨迹是常态）
  *
  * ⚠️ 读失败（权限/坏文件）⇒ 空串而不是抛错：提示词读不到不该阻断会话创建；
  * 但**会告警**（见 reader 版本），不静默。
  */
-export declare function resolveTrajectoryPrompt(root: string, dirName: string, legacyProfile?: SkiffProfile | null): TrajectoryPromptResolution;
+export declare function resolveTrajectoryPrompt(root: string, dirName: string, legacyProfile?: TrajectoryConstraint | null): TrajectoryPromptResolution;
 /**
  * 轨迹提示词的**读取器**（长期热更新；改文件即生效，无需重启）。
  *

package/lib/trajectory/rebuild.d.ts

@@ -75,9 +75,9 @@ interface RebuildResult {
  * → ②b **权威绑定**（`AGENT_SESSIONS/.bindings.json`，本会话持久绑定）→ ③ surface 首条锚点
  * （events 异常时兜底）。
  *
- * v1.30.13（S142 用户"微信桥 + skiff 会话锚定要准确"，诊断 D4）：**移除**原 ④「全局最新未完成
+ * v1.30.13（S142 用户"微信桥 + 轨迹约束会话锚定要准确"，诊断 D4）：**移除**原 ④「全局最新未完成
  * 会话」（`findLatestActiveSessionMd`）。理由（R↓）：④ 是**跨轨迹**猜测——候选①②③全空时，
- * 它会把 rebuild 静默接到 AGENT_SESSIONS 里最新的另一个会话（临时 skiff 会话 persistent=false、
+ * 它会把 rebuild 静默接到 AGENT_SESSIONS 里最新的另一个会话（临时 轨迹约束会话 persistent=false、
  * 重启后首条消息前、新会话首条消息都命中该形态），而"接错轨迹"比重建失败危险得多
  * （错误轨迹被继续写入 + 正确轨迹静默丢失）。现在全部候选失败 → 返回 null → 调用方
  * 报错引导用户显式 `cognitive_trajectory use`（响亮失败优于静默接错）。

package/lib/trajectory/session.d.ts

@@ -1,24 +1,24 @@
 /**
- * trajectory/session.ts — 轨迹的**会话（载体）管理**（**2026-10-19 重做**：skiff = 带 `skiff.json` 的认知轨迹）
+ * trajectory/session.ts — 轨迹的**会话（载体）管理**（**2026-10-19 重做**：轨迹约束 = 带 `trajectory-constraint.json` 的认知轨迹）
  *
  * ## 与旧版的根本差别（R↓，这是那次重做的全部内容）
  *
- * 旧版：skiff 是**一个角色**（`serenity.json` 的 `skiff.roles.<name>`），会话身份由
- * dsh sessionId 前缀 `skiff-` 判定，工作台由 `ensureSkiffSession` **另建一个 SESSION**。
+ * 旧版：轨迹约束是**一个角色**（`serenity.json` 的 `轨迹约束.roles.<name>`），会话身份由
+ * dsh sessionId 前缀 `轨迹约束-` 判定，工作台由 `ensureTrajectorySession` **另建一个 SESSION**。
  *
- * 新版：skiff 是**一条认知轨迹**（目录里有 `skiff.json`）——
+ * 新版：轨迹约束是**一条认知轨迹**（目录里有 `trajectory-constraint.json`）——
  * · **身份 = 轨迹编码**（不是角色名，不是 sessionId 前缀）；
- * · **工作台 = 该轨迹自己的 SESSION.md**（不再另建，`ensureSkiffSession` 已删除）；
- * · **判据 = 绑定的轨迹有没有 `skiff.json`**（唯一入口 `policy/profile.ts` 的 `skiffProfileForSession`）。
+ * · **工作台 = 该轨迹自己的 SESSION.md**（不再另建，`ensureTrajectorySession` 已删除）；
+ * · **判据 = 绑定的轨迹有没有 `trajectory-constraint.json`**（唯一入口 `policy/profile.ts` 的 `trajectoryConstraintForSession`）。
  *
  * ⇒ 删掉的东西（它们只是旧模型的补丁，不是通用机制）：
- * `SKIFF_SESSION_PREFIX` 判定 ／ `ensureSkiffSession` 自动建工作台 ／
+ * `SKIFF_SESSION_PREFIX` 判定 ／ `ensureTrajectorySession` 自动建工作台 ／
  * `kind: temporary|persistent` ／ 换代计数器（`im/route.ts` 的 `.weixin-session-gen.json`）。
  *
  * ## 本文件仍负责
  * agent 创建/复用（resume-or-create）／系统提示词段注册／提问与等本轮回答／守门查询。
  *
- * ## S13（2026-10-19，轨迹中心重构）：此前位于 `role/skiff/` 下（该目录已随本重构消失）
+ * ## S13（2026-10-19，轨迹中心重构）：此前位于 `role/轨迹约束/` 下（该目录已随本重构消失）
  *
  * 文件名从 `core` 改为 `session`：它管的是**轨迹的会话（载体）**——
  * 与同目录 `live.ts`（活载体查询）／`rebuild.ts`（换船板）／`cleanup.ts`（清理）同族。
@@ -29,61 +29,61 @@
  */
 import type { Context } from 'cordis';
 import type { Agent, AgentHandle } from '@deepseek-ai/dsh-agent';
-import { type SkiffProfile } from './policy/profile.js';
-export type { SkiffProfile };
+import { type TrajectoryConstraint } from './policy/profile.js';
+export type { TrajectoryConstraint };
 /** 查 sessionId 承载的轨迹目录名（无 → null） */
-export declare function skiffTrajectoryDirNameFor(sessionId: string): string | null;
+export declare function trajectoryDirNameForSession(sessionId: string): string | null;
 /** 查 sessionId 的会话绑定（轨迹 ＋ ccc；无 → null）——追问校验 */
-export declare function skiffSessionInfo(sessionId: string): {
+export declare function trajectorySessionInfo(sessionId: string): {
     trajectoryDirName: string;
     ccc: string;
 } | null;
 /** 查 sessionId 的活体 agent（进程内会话延续用；未注册/已清理 → undefined） */
-export declare function getSkiffAgent(sessionId: string): Agent | undefined;
-/** 该会话当前绑定的 skiff 约束面（不是 skiff → null）。**守门与提示词的唯一查询入口。** */
-export declare function skiffProfileFor(root: string, sessionId: string | undefined): SkiffProfile | null;
-export declare function registerSkiffSession(sessionId: string, trajectoryDirName: string, ccc: string, agent: Agent): void;
-export declare function unregisterSkiffSession(sessionId: string): void;
+export declare function getTrajectoryAgent(sessionId: string): Agent | undefined;
+/** 该会话当前绑定的 轨迹约束面（不是 轨迹约束 → null）。**守门与提示词的唯一查询入口。** */
+export declare function trajectoryConstraintFor(root: string, sessionId: string | undefined): TrajectoryConstraint | null;
+export declare function registerTrajectorySession(sessionId: string, trajectoryDirName: string, ccc: string, agent: Agent): void;
+export declare function unregisterTrajectorySession(sessionId: string): void;
 /** 测试/调试：注册表快照 */
-export declare function skiffSessionSnapshot(): ReadonlyMap<string, {
+export declare function trajectorySessionSnapshot(): ReadonlyMap<string, {
     trajectoryDirName: string;
     ccc: string;
 }>;
 /**
- * 该 skiff 会话的**工作台路径** = 它自己轨迹的 SESSION.md。
+ * 该 轨迹约束会话的**工作台路径** = 它自己轨迹的 SESSION.md。
  *
- * 🔴 与旧版的差别：旧版会在这里**自动新建**一个 SESSION（`ensureSkiffSession`）；
- * 新版**没有新建这个动作** —— 轨迹就是工作台，`skiff.json` 与 `SESSION.md` 同处一个目录。
+ * 🔴 与旧版的差别：旧版会在这里**自动新建**一个 SESSION（`ensureTrajectorySession`）；
+ * 新版**没有新建这个动作** —— 轨迹就是工作台，`trajectory-constraint.json` 与 `SESSION.md` 同处一个目录。
  * ⇒ 语义变成纯粹的"查询：我自己的身体在哪"。
  *
- * @returns SESSION.md 绝对路径；不是 skiff / 文件不在 → null
+ * @returns SESSION.md 绝对路径；不是 轨迹约束 / 文件不在 → null
  */
-export declare function skiffWorkspaceMdPath(root: string, sessionId: string | undefined): string | null;
+export declare function trajectoryWorkspaceMdPath(root: string, sessionId: string | undefined): string | null;
 /**
  * 系统提示词中的**工作台纪律块**（S142 用户：只给路径 LLM 不会主动用）。
  *
- * SESSION = 工作台 —— skiff 与主舱同一套机制（**零特调**，用户拍板）：
+ * SESSION = 工作台 —— 轨迹约束与主舱同一套机制（**零特调**，用户拍板）：
  * SESSION.md 是持久记忆载体、rebuild 自动从本 SESSION 续接。
  * 注入 agent 系统提示词（用户对话面不可见）。
  *
  * v1.30.13（S142 诊断 D5）：写入纪律**不点名具体工具** —— 旧文案写死 "with write/edit"，
- * 而某个 skiff 的工具白名单里根本没有 write/edit ⇒ 指令指向它没有的工具
+ * 而某个 轨迹约束的工具白名单里根本没有 write/edit ⇒ 指令指向它没有的工具
  * （注入纪律与能力面矛盾，模型只能猜）。现文案改为「用本轨迹被授权的写入通道」。
  */
 export declare function workspaceCognitiveTrajectoryLine(mdPath: string): string;
 /**
  * 把**工作台纪律块**挂到 agent 的系统提示词段（单一注入点）。
  *
- * 用户原话（S142，2026-09-08）："微信桥的注入机制，每个用户消息都会注入，skiff 本身也会注入，
- * 这样就重复，能否微信桥情况下，注入内容直接取 skiff 的，这样不用配两遍"。
+ * 用户原话（S142，2026-09-08）："微信桥的注入机制，每个用户消息都会注入，轨迹约束本身也会注入，
+ * 这样就重复，能否微信桥情况下，注入内容直接取 轨迹约束的，这样不用配两遍"。
  *
- * 现形态：工作台行**只**经本函数挂系统提示词段（name `serenity-skiff-workspace`，
+ * 现形态：工作台行**只**经本函数挂系统提示词段（name `serenity-轨迹约束-workspace`，
  * 动态 `text()` 每轮按 scope 读当前活跃 mdPath）。
  *
  * @returns true = 段已在位；false = 该 agent 挂不上（调用方降级为 question 前缀注入）
  */
 export declare function ensureWorkspacePromptSection(agent: Agent, scope: string, root: string): boolean;
-interface SkiffAgentRef {
+interface 轨迹约束AgentRef {
     handle: AgentHandle;
     agent: Agent;
     sessionId: string;
@@ -91,17 +91,17 @@ interface SkiffAgentRef {
     resumed: boolean;
 }
 /**
- * 创建（或复用）一个 skiff 会话。
+ * 创建（或复用）一个 轨迹约束会话。
  *
  * **固定 sessionId 的 resume-or-create**（v1.27.2）：指定 sessionId 且磁盘已有持久化 log →
  * `ctx.agents.resume`（DSH 持久化语义：sessionId 即身份，历史 + turn 续号延续）；
  * 无 log（首次）→ `ctx.agents.create`。不指定 → 随机 id 恒 create（调试页路径）。
  *
- * @param profile 该 skiff 的约束面（来自 `skiff.json`）
+ * @param profile 该 轨迹约束的约束面（来自 `trajectory-constraint.json`）
  * @param sessionId 指定会话 id（可选；微信桥等外部面用固定 id 实现"轨迹 ↔ 会话"长期映射）
  */
-export declare function createSkiffAgent(ctx: Context, root: string, profile: SkiffProfile, defaultModel?: string, sessionId?: string): Promise<SkiffAgentRef>;
-interface SkiffAskResult {
+export declare function createTrajectoryAgent(ctx: Context, root: string, profile: TrajectoryConstraint, defaultModel?: string, sessionId?: string): Promise<轨迹约束AgentRef>;
+interface 轨迹约束AskResult {
     answer: string;
     sessionId: string;
 }
@@ -130,35 +130,35 @@ export declare function waitForTurnAssistant(ctx: unknown, agent: Agent, beforeA
  *
  * @param options.timeoutMs 本轮等待上限（测试注入；生产用缺省）
  */
-export declare function askSkiff(ctx: Context, agent: Agent, question: string, options?: {
+export declare function askTrajectory(ctx: Context, agent: Agent, question: string, options?: {
     timeoutMs?: number;
-}): Promise<SkiffAskResult>;
+}): Promise<轨迹约束AskResult>;
 /**
- * skiff 会话的轨迹纪律参与判定：**不是 skiff 恒 true**（正常参与）；
- * skiff 按 `skiff.json` 的 `cognitiveTrajectory` 子集决定。
+ * 轨迹约束会话的轨迹纪律参与判定：**不是 轨迹约束恒 true**（正常参与）；
+ * 轨迹约束 按 `trajectory-constraint.json` 的 `cognitiveTrajectory` 子集决定。
  *
- * 注册表缺失（进程刚重启、绑定还没读）⇒ 由 `skiffProfileForSession` 回落持久绑定；
- * 两者都不中 ⇒ 判"不是 skiff" ⇒ 恒 true（正常参与）。**fail-open 是有意的**：
+ * 注册表缺失（进程刚重启、绑定还没读）⇒ 由 `trajectoryConstraintForSession` 回落持久绑定；
+ * 两者都不中 ⇒ 判"不是 轨迹约束" ⇒ 恒 true（正常参与）。**fail-open 是有意的**：
  * 纪律参与项的失败不该让会话失去 keeper/rebuild（那是能力倒退，比多跑一次更糟）。
  */
-export declare function skiffCognitiveTrajectoryEnabled(root: string, sessionId: string | undefined, key: 'session' | 'keeper' | 'rebuild'): boolean;
-interface SkiffMsmGate {
+export declare function trajectoryConstraintParticipates(root: string, sessionId: string | undefined, key: 'session' | 'keeper' | 'rebuild'): boolean;
+interface 轨迹约束MsmGate {
     /** 拒绝原因（有则拒绝执行） */
     reject?: string;
     /** list 显示白名单（msms）；仅 action==='list' 时有值 */
     whitelist?: Set<string>;
 }
 /**
- * `msm` 工具的 skiff 门控：非 skiff 恒放行；skiff 会话——
+ * `msm` 工具的 轨迹约束门控：非 轨迹约束恒放行；轨迹约束会话——
  * exec 非白名单 MSM 拒绝（**不列名单**）、register/deregister 必拒、
  * list 白名单过滤、check/guide/ccc-config 只读放行。
  */
-export declare function skiffMsmGate(root: string, sessionId: string | undefined, action: string, name?: string): SkiffMsmGate;
-/** 该 skiff 会话的工具白名单（guards 的 schema 收窄用） */
-export declare function skiffToolWhitelist(root: string, sessionId: string | undefined): Set<string> | null;
-/** 按编码解析 skiff（路由/调试页/审计用） */
-export declare function skiffProfileByCode(root: string, code: string): SkiffProfile | null;
+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 trajectoryConstraintByCode(root: string, code: string): TrajectoryConstraint | null;
 /** 编码 → 轨迹目录名（路由用；只做精确匹配） */
-export declare function skiffDirNameByCode(root: string, code: string): string | null;
+export declare function 轨迹约束DirNameByCode(root: string, code: string): string | null;
 /** 一次性解析提示词全文（admin/validate 用；热路径不要用） */
-export declare function skiffSystemPrompt(root: string, profile: SkiffProfile | null | undefined): string;
+export declare function 轨迹约束SystemPrompt(root: string, profile: TrajectoryConstraint | null | undefined): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.73.0",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/认知轨迹唤醒注册表。skiff = 目录下有 skiff.json 的认知轨迹（约束面住在轨迹里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
+  "version": "1.74.0",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹约束 = 目录下有 trajectory-constraint.json 的认知轨迹（约束面住在轨迹里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {
     "type": "git",