@shgroup/dsh-serenity-hooks 1.79.4 → 1.79.5

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.79.4",
+  "version": "1.79.5",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「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.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/index.js

@@ -3,8 +3,8 @@ import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebSe
 import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, h as readSafeModeHiddenTools, i as findGitRoot, l as pathInside, m as readExclusiveTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-CyYJL4F2.js";
 import { A as sessionEvents, B as isoLocal, C as listSessions, E as parseTrajectoryCode, F as trajectoryDescOf, H as localHuman, I as useSession, L as TRAJECTORY_FILENAME, M as setActiveSessionInfo, N as showSession, O as readTrajectoryUid, P as summarize, R as TRAJECTORY_LEGACY_FILENAMES, S as listActiveTrajectories, T as parseSessionContextFromEvents, U as localIdStamp, V as localFileStamp, _ as createSession, a as readTrajectoryConstraintAt, b as getActiveSessionInfo, c as trajectoryConstraintForSession, f as COGNITIVE_TRAJECTORY_ACTIONS, g as clearActiveSessionInfo, h as archiveSession, j as sessionsRoot, k as resolveSessionByTitle, m as UID_FILENAME, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, r as listTrajectoryConstraints, s as replacesDefaultIdentity, t as TRAJECTORY_CONSTRAINT_FILENAME, v as extractSessionMdPathFromText, w as namingTitleFor, y as findSession, z as readTrajectoryFile } from "./profile-5TQ_C1xi.js";
 import { n as checkLocalstoreGitCompliance, o as readStore, s as runLocalStore, t as LOCALSTORE_SCOPES } from "./service-DDmHSglV.js";
-import { _ as ACC_VERSION, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as resolveConstraintSystemPrompt, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as findPackageRoot } from "./message-source-DK2CnXlh.js";
-import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-BYC1uWi0.js";
+import { _ as ACC_VERSION, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as resolveConstraintSystemPrompt, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as findPackageRoot } from "./message-source-DiP3Uve3.js";
+import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-tdlJDS9i.js";
 import { n as hasSessionLogById, r as sessionsRootDir } from "./cleanup-C-92qnDs.js";
 import { n as readSimpleSettings, r as registerSettingsSection } from "./settings-B-vn8j4g.js";
 import { REGISTERED_TOOLS } from "./invariant.js";
@@ -7114,102 +7114,6 @@ function createCheapWorkerTool(ctx) {
 	});
 }
 //#endregion
-//#region src/trajectory/alive.ts
-/**
-* trajectory/alive.ts — **"这个 dsh 会话还活着吗"的唯一判据**（owner 2026-10-20 裁决）
-*
-* ## owner 的原话（本模块的全部设计依据）
-*
-* > 「死应该包含归档判断；只有 ① 或者 ②且不在归档集 才算活」
-* > 「use 只要被调用了，可以无条件覆盖绑定到当前会话（这说明当前会话肯定活着啊）」
-*
-* ## 为什么必须收成一个判据（在此之前有三个互不一致的判据）
-*
-* | # | 判据 | 旧实现位置 | 单独使用时的漏洞 |
-* |---|---|---|---|
-* | ① | 进程内 loaded agent | `hostAgents(ctx).get(id)` | 冷会话全判死 |
-* | ② | 磁盘上有会话日志 | `hasSessionLogById()` | **归档后日志逐字节不动** ⇒ 归档会话判活 |
-* | ③ | 宿主归档集 | `workspaceRegistry.archivedSessionIds` | 旧 dsp **零引用**（整个仓库 0 处） |
-*
-* 宿主的归档语义是**只往集合里加一个 id、不动日志**（`dsh-workspace` 的
-* `archiveSession` 注释：「Archiving never touches workspace accounting」）。
-* ⇒ 只问 ② 的实现在归档上**必然判错**，而那个错误没有任何机械信号。
-*
-* ## 判据（owner 给定，逐字实现）
-*
-* ```text
-* 活 ⟺ ①                       （进程内 loaded ⇒ 一定在）
-*    ∨ (② ∧ 不在归档集)          （日志在、且没人把它归档掉）
-* ```
-*
-* 🔴 **一处对原话的收紧（必须说出来，不许默默改）**：owner 的 ① 未附加"不在归档集"，
-* 而本模块把**归档判定排在最前** —— 即 `归档 ∧ live ⇒ 判死`。理由：归档是**人对这条会话
-* 的处置声明**（宿主会把它从所有分组面隐藏），若仍被当成载体，唤醒调度器会去驱动一条
-* **使用者以为已经收起来**的会话。⚠️ 与字面规则的差异仅此一格；`use` 不受影响
-* （见下方 §use 逃生门），因此真需要复活一条已归档会话时**仍然有受支持的路**。
-*
-* ## 🔴 `use` 的逃生门（owner 第二条，写在调用点）
-*
-* **`use` 不查存活**：它被调用这件事本身证明**当前会话活着**（本模块的被测对象是
-* "别人写的那个 id"，而 `use` 手里拿的是**自己**）。⇒ `use` 走无条件覆盖
-* （`claimBinding` 的 `takeover`），因此**判据再严也不会把一条轨迹锁死**。
-* 这条逃生门是判据可以取严的前提，两者必须一起存在。
-*
-* ## 依赖纪律
-*
-* 纯判据 `isSessionAlive` 零依赖、可单测；宿主面只在 `hostAliveProbe` 里，
-* 且**不抛错**（服务缺失 ⇒ 该维度作废，而不是让 ACC 工具整块失败）。
-*/
-/** 宿主侧的归档集读取（不可用 ⇒ 空集 = 该维度作废，**不是**把所有会话判死） */
-function archivedIdsOf(ctx) {
-	try {
-		const ids = hostService(ctx, "workspaceRegistry")?.archivedSessionIds;
-		return new Set(Array.isArray(ids) ? ids : []);
-	} catch {
-		return /* @__PURE__ */ new Set();
-	}
-}
-/**
-* **宿主面的判活探针**（`(sessionId) => boolean`）——所有需要"这条会话还活着吗"的
-* 生产代码都应当用这一个，不要自己拼 `agents.get` ＋ `hasSessionLogById`。
-*
-* 语义 = {@link isSessionAlive}，其中：
-*  · `liveIds` 因为宿主只给 `get(id)` 而**按 id 逐次问**（不是集合）；
-*  · `archivedIds` 在**首次调用时**取一次快照并在闭包内复用（每 tick 一个探针，
-*    归档集在一个 tick 内不变）—— 避免为每条轨迹重复读存储域。
-*
-* ⚠️ **快照的代价**：同一探针内若有人中途归档了某会话，本探针直到下次新建才看见。
-*    调度器是每 tick 新建一个探针（见 `wake/scheduler.ts`），故实际窗口 ≤1 tick。
-*
-* @param ctx 插件上下文（取 `agents` 与 `workspaceRegistry`）
-* @returns 探针；**永不抛**
-*/
-function hostAliveProbe(ctx) {
-	let archived;
-	const archivedOnce = () => archived ??= archivedIdsOf(ctx);
-	return (sessionId) => {
-		if (typeof sessionId !== "string" || sessionId === "") return false;
-		if (archivedOnce().has(sessionId)) return false;
-		try {
-			if (hostAgents(ctx)?.get?.(sessionId)) return true;
-		} catch {}
-		try {
-			return hasSessionLogById(sessionsRootDir(), sessionId);
-		} catch {
-			return true;
-		}
-	};
-}
-/**
-* 判据只有**两个**出口，别再开第三个：
-*  · {@link isSessionAlive} —— 纯判据（给定事实），单测的靶子；
-*  · {@link hostAliveProbe} —— 生产入口（自己去宿主与磁盘取事实）。
-*
-* ⚠️ 曾有一个 `aliveFactsFor`（把探针摊平成 `SessionAliveFacts`），**全仓零调用点**，
-* 已删除 —— 留一个"看起来有用、实际无人调用"的导出，会让下一个人以为存在第二条判活路径
-* （本仓同族教训：`cheapWorkerPresetInheritance` 全仓零调用点 ⇒ 接线断了却看不出来）。
-*/
-//#endregion
 //#region src/wake/registry.ts
 /**
 * wake/registry.ts — 认知轨迹唤醒注册表（D58，S142 2026-09-13）
@@ -7670,6 +7574,102 @@ function deliverCarrierOpening(agent, text) {
 	}
 }
 //#endregion
+//#region src/trajectory/alive.ts
+/**
+* trajectory/alive.ts — **"这个 dsh 会话还活着吗"的唯一判据**（owner 2026-10-20 裁决）
+*
+* ## owner 的原话（本模块的全部设计依据）
+*
+* > 「死应该包含归档判断；只有 ① 或者 ②且不在归档集 才算活」
+* > 「use 只要被调用了，可以无条件覆盖绑定到当前会话（这说明当前会话肯定活着啊）」
+*
+* ## 为什么必须收成一个判据（在此之前有三个互不一致的判据）
+*
+* | # | 判据 | 旧实现位置 | 单独使用时的漏洞 |
+* |---|---|---|---|
+* | ① | 进程内 loaded agent | `hostAgents(ctx).get(id)` | 冷会话全判死 |
+* | ② | 磁盘上有会话日志 | `hasSessionLogById()` | **归档后日志逐字节不动** ⇒ 归档会话判活 |
+* | ③ | 宿主归档集 | `workspaceRegistry.archivedSessionIds` | 旧 dsp **零引用**（整个仓库 0 处） |
+*
+* 宿主的归档语义是**只往集合里加一个 id、不动日志**（`dsh-workspace` 的
+* `archiveSession` 注释：「Archiving never touches workspace accounting」）。
+* ⇒ 只问 ② 的实现在归档上**必然判错**，而那个错误没有任何机械信号。
+*
+* ## 判据（owner 给定，逐字实现）
+*
+* ```text
+* 活 ⟺ ①                       （进程内 loaded ⇒ 一定在）
+*    ∨ (② ∧ 不在归档集)          （日志在、且没人把它归档掉）
+* ```
+*
+* 🔴 **一处对原话的收紧（必须说出来，不许默默改）**：owner 的 ① 未附加"不在归档集"，
+* 而本模块把**归档判定排在最前** —— 即 `归档 ∧ live ⇒ 判死`。理由：归档是**人对这条会话
+* 的处置声明**（宿主会把它从所有分组面隐藏），若仍被当成载体，唤醒调度器会去驱动一条
+* **使用者以为已经收起来**的会话。⚠️ 与字面规则的差异仅此一格；`use` 不受影响
+* （见下方 §use 逃生门），因此真需要复活一条已归档会话时**仍然有受支持的路**。
+*
+* ## 🔴 `use` 的逃生门（owner 第二条，写在调用点）
+*
+* **`use` 不查存活**：它被调用这件事本身证明**当前会话活着**（本模块的被测对象是
+* "别人写的那个 id"，而 `use` 手里拿的是**自己**）。⇒ `use` 走无条件覆盖
+* （`claimBinding` 的 `takeover`），因此**判据再严也不会把一条轨迹锁死**。
+* 这条逃生门是判据可以取严的前提，两者必须一起存在。
+*
+* ## 依赖纪律
+*
+* 纯判据 `isSessionAlive` 零依赖、可单测；宿主面只在 `hostAliveProbe` 里，
+* 且**不抛错**（服务缺失 ⇒ 该维度作废，而不是让 ACC 工具整块失败）。
+*/
+/** 宿主侧的归档集读取（不可用 ⇒ 空集 = 该维度作废，**不是**把所有会话判死） */
+function archivedIdsOf(ctx) {
+	try {
+		const ids = hostService(ctx, "workspaceRegistry")?.archivedSessionIds;
+		return new Set(Array.isArray(ids) ? ids : []);
+	} catch {
+		return /* @__PURE__ */ new Set();
+	}
+}
+/**
+* **宿主面的判活探针**（`(sessionId) => boolean`）——所有需要"这条会话还活着吗"的
+* 生产代码都应当用这一个，不要自己拼 `agents.get` ＋ `hasSessionLogById`。
+*
+* 语义 = {@link isSessionAlive}，其中：
+*  · `liveIds` 因为宿主只给 `get(id)` 而**按 id 逐次问**（不是集合）；
+*  · `archivedIds` 在**首次调用时**取一次快照并在闭包内复用（每 tick 一个探针，
+*    归档集在一个 tick 内不变）—— 避免为每条轨迹重复读存储域。
+*
+* ⚠️ **快照的代价**：同一探针内若有人中途归档了某会话，本探针直到下次新建才看见。
+*    调度器是每 tick 新建一个探针（见 `wake/scheduler.ts`），故实际窗口 ≤1 tick。
+*
+* @param ctx 插件上下文（取 `agents` 与 `workspaceRegistry`）
+* @returns 探针；**永不抛**
+*/
+function hostAliveProbe(ctx) {
+	let archived;
+	const archivedOnce = () => archived ??= archivedIdsOf(ctx);
+	return (sessionId) => {
+		if (typeof sessionId !== "string" || sessionId === "") return false;
+		if (archivedOnce().has(sessionId)) return false;
+		try {
+			if (hostAgents(ctx)?.get?.(sessionId)) return true;
+		} catch {}
+		try {
+			return hasSessionLogById(sessionsRootDir(), sessionId);
+		} catch {
+			return true;
+		}
+	};
+}
+/**
+* 判据只有**两个**出口，别再开第三个：
+*  · {@link isSessionAlive} —— 纯判据（给定事实），单测的靶子；
+*  · {@link hostAliveProbe} —— 生产入口（自己去宿主与磁盘取事实）。
+*
+* ⚠️ 曾有一个 `aliveFactsFor`（把探针摊平成 `SessionAliveFacts`），**全仓零调用点**，
+* 已删除 —— 留一个"看起来有用、实际无人调用"的导出，会让下一个人以为存在第二条判活路径
+* （本仓同族教训：`cheapWorkerPresetInheritance` 全仓零调用点 ⇒ 接线断了却看不出来）。
+*/
+//#endregion
 //#region src/cro/core.ts
 /**
 * cro/core.ts — CRO（Continuous Re-Occurrence · 持续再发生）机制层（S142 §7.8，2026-09-19）
@@ -9462,7 +9462,8 @@ async function createAndBindTarget(ctx, root, dirName) {
 	});
 	const openingNote = deliverCarrierOpening(agent, buildCarrierOpening(parseTrajectoryCode(dirName) ?? dirName, trajectoryDescOf(dirName))) ? ", opening-as-user" : ", ⚠️ 开场白未投递";
 	const wsNote = workspaceId !== void 0 ? "" : await attachToWorkspace(ctx, root, sessionId);
-	const how = `auto-create(${sessionId}${bound ? ", bound" : ", ⚠️ 绑定写入失败"}${workspaceId !== void 0 ? ", via-workspaceId(=用户同一形态)" : ", via-cwd+attach"}${openingNote}${wsNote})`;
+	const viaNote = workspaceId !== void 0 ? ", via-workspaceId(=用户同一形态)" : ", via-cwd+attach";
+	const how = `auto-create(${sessionId}${bound.ok ? ", bound" : `, ⚠️ 绑定写入失败（${bound.code}）`}${viaNote}${openingNote}${wsNote})`;
 	return {
 		agent,
 		how
@@ -10475,7 +10476,7 @@ function createCognitiveTrajectoryTool(ctx) {
 						dirName: info.dirName,
 						mdPath: info.mdPath,
 						sessionId: info.sessionId,
-						alive: hostAliveProbe(ctx)
+						takeover: true
 					});
 					const advisory = advisoryHint(targetEntry.dirName, join(targetEntry.path, "SESSION.md"));
 					const out = {
@@ -10484,10 +10485,16 @@ function createCognitiveTrajectoryTool(ctx) {
 						context: active.context
 					};
 					if (advisory) out.advisory = advisory;
-					if (bound === true) out.binding = "written";
-					else if (bound === false) {
+					if (bound !== null && bound.ok) {
+						out.binding = "written";
+						if (bound.replaced !== void 0) {
+							out.bindingReplaced = bound.replaced;
+							out.bindingHint = `已顶掉原载体 ${bound.replaced}（owner 裁决：use 无条件覆盖到当前会话）。若那条会话还活着，它此刻**不再**承载「${info?.dirName ?? targetEntry.dirName}」——这是单槽位的必然结果，不是错误；需要它继续承载就再对它 \`use\` 一次。`;
+						}
+					} else if (bound !== null) {
 						out.binding = "not-written";
-						out.bindingHint = `绑定未写入：本会话取不到可用的 header（id / cwd 缺一不可）⇒ 按契约「绑定声明是唯一真相」，「${info?.dirName ?? targetEntry.dirName}」此刻仍是**未绑定**。 会话标题变了**不能**当作绑定成功的证据（改名走的是另一条通路）。 详见宿主日志里的 \`✗ 绑定未写入（SESSION_HEADER_UNRESOLVED）\`。`;
+						out.bindingCode = bound.code;
+						out.bindingHint = `绑定未写入（${bound.code}）：${bound.detail} ⇒ 按契约「绑定声明是唯一真相」，「${info?.dirName ?? targetEntry.dirName}」此刻仍是**未绑定**。 会话标题变了**不能**当作绑定成功的证据（改名走的是另一条通路）。`;
 					}
 					return out;
 				}

package/lib/{message-source-DK2CnXlh.js → message-source-DiP3Uve3.js}

@@ -521,7 +521,12 @@ function findTrajectoryHolding(sessionsRoot, sessionId) {
 * @param decl 要写入的声明
 * @param opts.takeover 允许顶掉本条轨迹现有的另一个载体
 * @param opts.alive 探针：**旧载体**是否还活着（缺省 ⇒ 一律当活 = 旧语义）
-* @returns `{ ok: true }` 或 `{ ok: false, code, detail }`（**不抛**，由调用方决定如何呈现）
+* @returns `{ ok: true, replaced?, released? }` 或 `{ ok: false, code, detail }`（**不抛**，由调用方决定如何呈现）
+*
+* 🔴 **2026-10-20 追加 `replaced`（由一条 skiff 轨迹的实测逼出）**：`released` 只覆盖
+* 「这个会话此前安家在**另一条**轨迹」那一格（跨轨迹清理）；而**同一轨迹换载体**时被顶掉的那个
+* 会话 id 此前**没有任何出口** ⇒ 调用方无法在回执里说出"你顶掉了谁"。
+* 静默换代正是"一条轨迹感觉有两个载体"的成因 ⇒ 顶掉谁必须能被读出来。
 */
 function claimBinding(sessionsRoot, dirName, decl, opts = {}) {
 	const holder = findTrajectoryHolding(sessionsRoot, decl.sessionId);
@@ -547,9 +552,11 @@ function claimBinding(sessionsRoot, dirName, decl, opts = {}) {
 		code: "WRITE_FAILED",
 		detail: `写 ${BIND_FILENAME} 失败：${join(sessionsRoot, dirName)}`
 	};
-	return released === void 0 ? { ok: true } : {
+	const replaced = cur !== null && cur.sessionId !== decl.sessionId ? cur.sessionId : void 0;
+	return {
 		ok: true,
-		released
+		...replaced === void 0 ? {} : { replaced },
+		...released === void 0 ? {} : { released }
 	};
 }
 //#endregion
@@ -718,14 +725,26 @@ function listBoundSessionIds(root, dirName, alive) {
 * 旧签名 `appendBound(session, action, rec)` 保持不变：`session` 提供 `header.id` / `header.cwd`，
 * `rec.dirName` 指明写哪条轨迹的交代。
 *
-* @returns 写入成功 ⇒ true（**每条轨迹只有一个文件，没有"追加"语义，只有"覆盖"**）
+* @returns 写入成功 ⇒ `{ ok: true, replaced?, released? }`（**每条轨迹只有一个文件，没有"追加"语义，只有"覆盖"**）；
+*          失败 ⇒ `{ ok: false, code, detail }`，**`code` 指名是哪一条守卫拒的**
+*
+* 🔴 **为什么从 `boolean` 改成分级结果（2026-10-20，一条 skiff 轨迹实测逼出）**：
+* 本函数有**两条完全不同的失败路径** —— ① header 守卫（id / root 取不到）② `claimBinding` 拒绝
+* （`SESSION_TAKEN` / `TRAJECTORY_OCCUPIED` / `WRITE_FAILED`）。日志侧早已分开（D186），
+* **但回执侧只有一句 header 文案** ⇒ 调用方被指向错误的方向（那位实测者第一轮就照文案去找 header，
+* 真因是槽位被占）。⇒ 结果必须**带码**，让回执能说出是哪一半。
 */
 function appendBound(session, action, rec) {
 	const id = sessionHeader(session)?.id;
 	const root = rootOf(session);
 	if (typeof id !== "string" || id === "" || root === null) {
-		console.warn(`[serenity-hooks] ✗ 绑定未写入（SESSION_HEADER_UNRESOLVED）：会话对象取不到可用的 header（id=${typeof id === "string" && id !== "" ? id : "(空/非字符串)"}，root=${root ?? "null（header.cwd 缺失或上溯不到 .serenity）"}） ⇒ 轨迹「${rec.dirName}」的 current.dsh_session_bind **未被改写**。 排查：该会话的 header.cwd 是否指向某个含 .serenity 的目录； 无 cwd 的会话（如某些程序性创建的载体）**不会**写绑定。`);
-		return false;
+		const detail = `会话对象取不到可用的 header（id=${typeof id === "string" && id !== "" ? id : "(空/非字符串)"}，root=${root ?? "null（header.cwd 缺失或上溯不到 .serenity）"}） ⇒ 轨迹「${rec.dirName}」的 current.dsh_session_bind **未被改写**。 排查：该会话的 header.cwd 是否指向某个含 .serenity 的目录； 无 cwd 的会话（如某些程序性创建的载体）**不会**写绑定。`;
+		console.warn(`[serenity-hooks] ✗ 绑定未写入（SESSION_HEADER_UNRESOLVED）：${detail}`);
+		return {
+			ok: false,
+			code: "SESSION_HEADER_UNRESOLVED",
+			detail
+		};
 	}
 	const result = claimBinding(sessionsRoot(root), rec.dirName, {
 		sessionId: id,
@@ -739,9 +758,17 @@ function appendBound(session, action, rec) {
 	});
 	if (!result.ok) {
 		console.warn(`[serenity-hooks] ✗ 绑定未写入（${result.code}）：${result.detail}`);
-		return false;
+		return {
+			ok: false,
+			code: result.code,
+			detail: result.detail
+		};
 	}
-	return true;
+	return {
+		ok: true,
+		...result.replaced === void 0 ? {} : { replaced: result.replaced },
+		...result.released === void 0 ? {} : { released: result.released }
+	};
 }
 /**
 * 这条轨迹**是否曾经有过载体**（判"要不要允许自建"）。

package/lib/{session-BYC1uWi0.js → session-tdlJDS9i.js}

@@ -2,7 +2,7 @@ import { n as agentCwdFor, r as cccRootForCwd, s as hostAgents } from "./ccc-roo
 import { g as readUtf8, o as isSafeModeOn, p as readCognitiveTrajectorySkills, u as readBlacklist } from "./ccc-CyYJL4F2.js";
 import { B as isoLocal, D as readActiveSessionMd, a as readTrajectoryConstraintAt, c as trajectoryConstraintForSession, d as unregisterTrajectorySession$1, j as sessionsRoot, l as registerTrajectorySession$1, p as DEFAULT_SESSION_SCOPE, u as trajectoryDirNameForSession } from "./profile-5TQ_C1xi.js";
 import { a as readGitTrack, i as localstorePath } from "./service-DDmHSglV.js";
-import { _ as ACC_VERSION, d as constraintCognitiveTrajectory, m as profileMsmWhitelist, n as PLUGIN_SOURCE, o as readLastBound, p as createProfilePromptReader, u as buildTrajectoryBasePrompt } from "./message-source-DK2CnXlh.js";
+import { _ as ACC_VERSION, d as constraintCognitiveTrajectory, m as profileMsmWhitelist, n as PLUGIN_SOURCE, o as readLastBound, p as createProfilePromptReader, u as buildTrajectoryBasePrompt } from "./message-source-DiP3Uve3.js";
 import { basename, dirname, join, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";

package/lib/trajectory/bind-file.d.ts

@@ -241,13 +241,19 @@ export declare function findTrajectoryHolding(sessionsRoot: string, sessionId: s
  * @param decl 要写入的声明
  * @param opts.takeover 允许顶掉本条轨迹现有的另一个载体
  * @param opts.alive 探针：**旧载体**是否还活着（缺省 ⇒ 一律当活 = 旧语义）
- * @returns `{ ok: true }` 或 `{ ok: false, code, detail }`（**不抛**，由调用方决定如何呈现）
+ * @returns `{ ok: true, replaced?, released? }` 或 `{ ok: false, code, detail }`（**不抛**，由调用方决定如何呈现）
+ *
+ * 🔴 **2026-10-20 追加 `replaced`（由一条 skiff 轨迹的实测逼出）**：`released` 只覆盖
+ * 「这个会话此前安家在**另一条**轨迹」那一格（跨轨迹清理）；而**同一轨迹换载体**时被顶掉的那个
+ * 会话 id 此前**没有任何出口** ⇒ 调用方无法在回执里说出"你顶掉了谁"。
+ * 静默换代正是"一条轨迹感觉有两个载体"的成因 ⇒ 顶掉谁必须能被读出来。
  */
 export declare function claimBinding(sessionsRoot: string, dirName: string, decl: BindDeclaration, opts?: {
     takeover?: boolean;
     alive?: (sessionId: string) => boolean;
 }): {
     ok: true;
+    replaced?: string;
     released?: string;
 } | {
     ok: false;

package/lib/trajectory/bound.d.ts

@@ -120,13 +120,37 @@ export declare function supersedeOtherBindings(_root: string, _dirName: string,
  * 保留本函数只为不打断既有调用点，恒返回空数组。
  */
 export declare function pruneMissingBindings(_root: string, _isMissing: (sessionId: string) => boolean): string[];
+/**
+ * 绑定写入的结果（分级，**不是 boolean**）。
+ *
+ * 分级的意义 = **调用方能说出是哪一半失败**（见 `appendBound` 头注）。
+ */
+export type BindWriteCode = 'SESSION_HEADER_UNRESOLVED' | 'SESSION_TAKEN' | 'TRAJECTORY_OCCUPIED' | 'WRITE_FAILED';
+export type BindWriteResult = {
+    ok: true;
+    /** 同一轨迹上被顶掉的旧载体 id（`use` 无条件覆盖时要写进回执 —— 静默换代是不允许的） */
+    replaced?: string;
+    /** 被清掉的**另一条**轨迹的残留声明（`claimBinding` 的安全网） */
+    released?: string;
+} | {
+    ok: false;
+    code: BindWriteCode;
+    detail: string;
+};
 /**
  * 把一条轨迹的当前载体写成 `sessionId`（**唯一写入口**，内部走 `claimBinding` 的两条不变量）。
  *
  * 旧签名 `appendBound(session, action, rec)` 保持不变：`session` 提供 `header.id` / `header.cwd`，
  * `rec.dirName` 指明写哪条轨迹的交代。
  *
- * @returns 写入成功 ⇒ true（**每条轨迹只有一个文件，没有"追加"语义，只有"覆盖"**）
+ * @returns 写入成功 ⇒ `{ ok: true, replaced?, released? }`（**每条轨迹只有一个文件，没有"追加"语义，只有"覆盖"**）；
+ *          失败 ⇒ `{ ok: false, code, detail }`，**`code` 指名是哪一条守卫拒的**
+ *
+ * 🔴 **为什么从 `boolean` 改成分级结果（2026-10-20，一条 skiff 轨迹实测逼出）**：
+ * 本函数有**两条完全不同的失败路径** —— ① header 守卫（id / root 取不到）② `claimBinding` 拒绝
+ * （`SESSION_TAKEN` / `TRAJECTORY_OCCUPIED` / `WRITE_FAILED`）。日志侧早已分开（D186），
+ * **但回执侧只有一句 header 文案** ⇒ 调用方被指向错误的方向（那位实测者第一轮就照文案去找 header，
+ * 真因是槽位被占）。⇒ 结果必须**带码**，让回执能说出是哪一半。
  */
 export declare function appendBound(session: unknown, action: SessionBoundAction, rec: {
     dirName: string;
@@ -144,7 +168,7 @@ export declare function appendBound(session: unknown, action: SessionBoundAction
      * 生产调用点应当传 {@link hostAliveProbe}（`trajectory/alive.ts`）。
      */
     alive?: (sessionId: string) => boolean;
-}): boolean;
+}): BindWriteResult;
 /**
  * 这条轨迹**是否曾经有过载体**（判"要不要允许自建"）。
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.79.4",
+  "version": "1.79.5",
   "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.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {