@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.1

package/lib/tools/cce.d.ts

@@ -1,9 +1,8 @@
 /**
- * cce.ts — CCE 认知连续性工程工具（渐进式披露，ACC 标准工具化）
+ * cce.ts — CCE 内容源（认知连续性工程；v1.30 三工具合并为 praxis 后只保留内容常量）
  *
  * 内容：认知连续性工程（Cognitive Continuity Engineering）——在有限资源与
  * 不可逆不确定性约束下，维持认知实体身份、可达性与演化能力的工程学科。
  * 来源：home-serenity `.opencode/skills/cce/SKILL.md` + CCE 理论。
  */
 export declare const CCE_CONTENT = "# CCE \u2014 Cognitive Continuity Engineering\n\n> **Cognitive Continuity Engineering is the engineering discipline of maintaining a cognitive entity's identity, accessibility, and capacity to evolve under the constraints of bounded resources and irreversible uncertainty.**\n> CCE does not optimize cognition. It preserves the conditions under which cognition can continue. \u2014 Persistence Engineering, not performance engineering\n\n## Core Propositions\n- **Continuity belongs to the container, not to any individual participant** \u2014 agents come and go, but the CCC's cognitive trajectory persists\n- **Organization must at minimum keep pace with accumulation** \u2014 otherwise operational cognitive entropy (H_op) grows unboundedly and accessibility is lost\n- **Reconstruction over preservation** \u2014 an artifact's value is determined by its ability to let future agents rebuild the original reasoning\n\n## Cognitive Container\nA bounded cognitive space in which cognition can accumulate, reorganize, and evolve. 5 defining properties:\n| Property | Function |\n|----------|----------|\n| Identity | Distinguishes this cognitive system from others |\n| Boundaries | Define what is inside/outside the cognitive space |\n| Persistent Memory | Retains accumulated cognition across time |\n| Operational Constraints | Define which operations are allowed inside the container |\n| Evolutionary History | Records the trajectory of cognitive change, making reconstruction possible |\n\n## Operational Cognitive Entropy (H_op)\nDoes not measure total entropy (not operational); it measures only the **excess cognitive cost** for agents to complete tasks inside the container:\n> H_op(C, t) = cost(task | C, t) \u2212 cost(task | ideal)\nContinuity condition: **H_op(C, t) \u2264 H_critical** \u2014 agents can still complete tasks at reasonable cost\n\n## Continuity Maintenance Condition\n> **\u0394H_org \u2265 \u0394H_in** \u2014 organization must at minimum keep pace with accumulation\n\n## Six-Phase Lifecycle\nExperience \u2192 Accumulation \u2192 Organization \u2192 Abstraction \u2192 Reconstruction \u2192 Evolution \u2192\uFF08loop\uFF09\n| Phase | Engineering Concern |\n|-------|---------------------|\n| Experience | Does input carry enough structure |\n| Accumulation | Is information stored losslessly |\n| Organization | Entropy management \u2014 \u0394H_org offsets \u0394H_in |\n| Abstraction | Is abstraction explicitly encoded |\n| Reconstruction | Can reasoning structure be recovered from artifacts |\n| Evolution | Does evolution stay coherent or introduce drift |\n\n## Relationship with EAP\nEAP answers \"how a piece of knowledge should be structured\" (explicitness E\u2191 / reconstructability R\u2193 / stability S\u2191);\nCCE answers \"how structured knowledge should keep evolving across time without losing coherence\". They complement each other: EAP is static quality, CCE is dynamic persistence.\n\n## Relationship with Serenity\nSerenity's session system, session tracking, and entropy management mechanisms (SQC quality loop) are all engineering implementations of CCE;\nthe behavioral constraints embedded in CCC system prompts come from CCE.";
-export declare const cceTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

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

@@ -11,7 +11,11 @@
  *   类比 The Manifest（清单维护——工具注册表）+ Crew（角色管理）+ 机务（配置/手册）。
  *
  * 参数极简（LLM 直觉）：domain（管理域）+ action（该域子命令）+ 少量业务参数。
+ *
+ * v1.34.1（⑥ C6a）：由 `export const containerAdminTool` 改为**工厂**
+ * `createContainerAdminTool(ctx)`——autopilot 域搬进进程内后，`status` 必须读只有进程内
+ * 能看到的事实（全局闸 / live 会话 / agent 可解析性，见 `../autopilot-ops.js`）。
+ * 这是本轮唯一为"取 ctx"而做的形态改动（其余域不依赖 ctx，行为不变）。
  */
-/** 管理域（container_admin 一级参数） */
-export type AdminDomain = 'role' | 'msm' | 'config';
-export declare const containerAdminTool: import("@deepseek-ai/dsh-tools").ToolDefinition;
+import type { Context } from 'cordis';
+export declare function createContainerAdminTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/eap.d.ts

@@ -1,7 +1,6 @@
 /**
- * eap.ts — EAP 认知质量框架工具（渐进式披露，ACC 标准工具化）
+ * eap.ts — EAP 内容源（认知质量框架；v1.30 三工具合并为 praxis 后只保留内容常量）
  *
- * 内嵌框架内容（自包含，不依赖已安装技能）；可选 section 参数聚焦某原则。
+ * 内嵌框架内容（自包含，不依赖已安装技能）。
  */
 export declare const EAP_CONTENT = "# EAP Cognitive Quality Framework (Explicit Abstraction Principle)\n\n> \"The functional value of a thought is proportional to its external reconstructability.\"\n\n## Three Variables\n| Variable | Meaning | How to improve |\n|----------|---------|----------------|\n| E\u2191 Explicitness | Degree to which variables/entities/relations are clearly defined | Define variables, state relationship direction & cardinality, draw boundaries |\n| R\u2193 Reconstructability | Cost of rebuilding the original reasoning later | Record decision rationale, context, constraints, alternatives |\n| S\u2191 Stability | Degree to which the same input repeatedly produces consistent output | Fix structures, protocolize, avoid relying on implicit context |\n\n## Pre-Output Self-Check Checklist\n- [ ] Variables/entities clearly defined (E\u2191)\n- [ ] Relationships state direction/cardinality (E\u2191)\n- [ ] Boundaries drawn \u2014 what is in scope / what is not (E\u2191)\n- [ ] No ambiguous words: \"handle\" \"optimize\" \"problem\" \u2192 be specific (E\u2191)\n- [ ] Key decisions record rationale and alternatives (R\u2193)\n- [ ] No level-skipping \u2014 align the upper layer before descending (R\u2193)\n- [ ] Structures can be regenerated repeatably (S\u2191)\n\n## Relationship with ACC\nACC (plugin/template) encodes structure as code (E\u2191); generating a CCC from ACC is deterministic (R\u2193); consistent across multiple CCCs (S\u2191).\nCCC (home-serenity etc.) encodes cognitive content as skills/SESSIONs/design docs. Use this checklist to self-check outputs.\n\n## Reference\nhttps://github.com/tellmewhattodo/theory-eap";
-export declare const eapTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/handyman.d.ts

@@ -20,34 +20,5 @@
  */
 import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
 import type { Context } from 'cordis';
-/** 非正常停止时重启 agent 的次数上限（防死循环保险阀）：对话轮次有上限，重启有上限 */
-export declare const HANDYMAN_MAX_RESTARTS = 100;
-/** 对话轮次上限（对齐 osp loop-runner 的 round>=100 强制 done 保险阀） */
-export declare const HANDYMAN_MAX_ROUNDS = 100;
-export interface HandymanJob {
-    task: string;
-    label: string;
-    model?: string;
-}
-export interface HandymanJobResult {
-    label: string;
-    done: boolean;
-    rounds: number;
-    finishReason: 'done' | 'max_rounds' | 'restart_exceeded';
-    restarts: number;
-    model: string;
-    lastResponse: string;
-    progressFile: string;
-}
-/** foreground 模式结果（一次调用一次结果；无循环、无进度文件） */
-export interface HandymanForegroundResult {
-    mode: 'foreground';
-    done: boolean;
-    model: string;
-    stopReason: string;
-    output: string;
-    childId?: string;
-    diagnostic?: string;
-}
 /** 创建 handyman 工具（闭包捕获插件 ctx → 可访问 ctx.agents） */
 export declare function createHandymanTool(ctx: Context): ToolDefinition;

package/lib/tools/msm.d.ts

@@ -15,8 +15,4 @@
  * 管理面（register/deregister/check/guide/catalog/ccc-config）已移入 container_admin。
  * 底层 runMsmAsync/prepareExec 全复用；未命中候选为新增 findSuggestions。
  */
-/** 精简目录（无参调用返回；替代全量 list 的巨输出）——按 skill 分组统计 + 顶部指引 */
-export declare function buildMsmIndex(root: string): string;
-/** 模糊候选：name/description 子串匹配（未精确命中时返回 top-K，供 LLM 下轮选对） */
-export declare function suggestMsm(root: string, query: string, limit?: number): string;
 export declare const msmTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/neat.d.ts

@@ -1,5 +1,4 @@
 /**
- * neat.ts — Neat 设计协作协议工具（渐进式披露，ACC 标准工具化）
+ * neat.ts — Neat 内容源（设计协作协议；v1.30 三工具合并为 praxis 后只保留内容常量）
  */
 export declare const NEAT_CONTENT = "# Neat Design Collaboration Protocol\n\n> Complex design is not thought up at once \u2014 it is walked out in small aligned steps.\n\n## Four Iron Rules\n| Rule | Meaning | Anti-example |\n|------|---------|--------------|\n| Small-step alignment | Advance one decision at a time; confirm before the next step | Presenting 10 options at once |\n| Explicit decisions | Every choice records rationale and alternatives | \"I feel this is good\" (no rationale) |\n| Document-driven | Conclusions land in named files (<subject>-<scope>-<type>.md) | Conclusions exist only in conversation |\n| No level-skipping | Advance strictly through the layers | Writing implementation before requirements are aligned |\n\n## Five-Layer Progression (no skipping)\nRequirements \u2192 Scope \u2192 Solution \u2192 Interface \u2192 Implementation\n| Layer | Artifact | Question |\n|-------|----------|----------|\n| Requirements | Requirements description | \"What problem are we solving?\" |\n| Scope | Scope list (in/out) | \"What is in, explicitly what is out?\" |\n| Solution | Solution comparison + selection | \"How? Which one? Why?\" |\n| Interface | Interface/protocol definition | \"How do the boundaries interact?\" |\n| Implementation | Code/docs | \"Land it layer by layer\" |\n\n## Collaboration Rhythm\n1. Raise one decision point of the current layer (with context + suggestion + rationale)\n2. Wait for confirmation or correction (small step)\n3. After confirmation, record the decision (into session SESSION.md or a design doc)\n4. Move to the next decision point";
-export declare const neatTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/praxis.d.ts

@@ -8,7 +8,6 @@
  *
  * section 参数渐进披露：不传 = 返回精简目录；传 = 返回对应框架全文/章节。
  */
-export type PraxisSection = 'eap' | 'neat' | 'cce';
 /** 框架清单（无参调用时返回的精简目录） */
 export declare const PRAXIS_INDEX = "praxis \u2014 \u53EF\u5B9E\u8DF5\u7406\u8BBA\u6CE8\u5165\uFF08\u8BA4\u77E5\u6846\u67B6\uFF0C\u6309\u9700\u52A0\u8F7D\uFF09\n\u9009\u62E9\u6846\u67B6\uFF1Apraxis eap\uFF08\u8BA4\u77E5\u8D28\u91CF\u2014\u2014E\u2191/R\u2193/S\u2191 \u4E09\u53D8\u91CF + \u8F93\u51FA\u524D\u81EA\u68C0\uFF09\n          praxis neat\uFF08Neat \u534F\u4F5C\u534F\u8BAE\u2014\u2014\u5C0F\u6B65\u5BF9\u9F50/\u663E\u5F0F\u51B3\u7B56/\u6587\u6863\u9A71\u52A8\uFF09\n          praxis cce\uFF08\u8BA4\u77E5\u8FDE\u7EED\u6027\u5DE5\u7A0B\u2014\u2014\u5BB9\u5668 5 \u884C\u4E3A\u7EA6\u675F + H_op \u64CD\u4F5C\u71B5\uFF09\n\u65E0\u53C2\u8FD4\u56DE\u672C\u76EE\u5F55\uFF1B\u8BE6\u60C5\u4EE5\u5BF9\u5E94\u6846\u67B6\u539F\u6587\u4E3A\u51C6\uFF08\u5355\u4E00\u771F\u76F8\u6E90\uFF09\u3002\n";
 export declare const praxisTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

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

@@ -1,8 +1,8 @@
 /**
  * skiff-admin.ts — Skiff 角色逻辑层（v1.30：skiff_admin 工具已并入 container_admin role 域）
  *
- * 教 CCC 如何定义 Skiff 角色（仿 session 工具 hook-develop-guide 的 SEP 教学模式，
- * 用户拍板 2026-08-28：guide 定义教程 / validate 配置校验 / list 角色摘要）。
+ * 教 CCC 如何定义 Skiff 角色（用户拍板 2026-08-28 的三动作分工：
+ * guide 定义教程 / validate 配置校验 / list 角色摘要）。
  *
  * 归属：ACC 机制（教会 + 校验），角色内容仍归 CCC 配置（.opencode/serenity.json skiff.roles）。
  * 公开入口 = container_admin（domain: role → guide/validate/apply/list）；本文件保留纯逻辑。

package/lib/tools/{session.d.ts → trajectory.d.ts}

@@ -1,23 +1,30 @@
 /**
- * session.ts — session 真实 DSH 工具定义（defineTool）
+ * trajectory.ts — `container_trajectory` 真实 DSH 工具定义（defineTool）
  *
- * AGENT_SESSIONS/ 全周期管理：list/show/create/use/close/health/qa/archive/summary。
- * 行为对齐 osp（opencode-serenity-plugin/src/session/session-tool.ts）——osp 是 ACC 工具 spec：
- *   - create：--desc <desc> [--goal <goal>] 或 --issue <id>（二选一）
- *   - close：需 --confirm 防误关
- *   - archive：name 可缺省（批量归档）
- *   - hook-develop-guide 子命令 + CCC session-tool MSM 扩展提示（extHint）
- * CCC 扩展采用 osp 的"钩子后处理"模型（create-transform），而非整命令委派。
- * 活跃会话跟踪：写内存 Map（.dsh/active-sessions/<scope> 语义）+ events 恢复（S134）。
+ * v1.33（S142 §32 用户裁决）：由 `logbook` **更名并收敛为 `trajectory`**（v1.34：工具名再硬切为
+ * `container_trajectory`，无别名）——trajectory 是一等概念
+ * （SESSION.md 是它的持久身体），本工具管它的**载体生命周期 + 一次性时间安排**。
+ * 动作收敛为 **6 个**：list / show / create / use / rebuild / wake-later。
  *
- * v1.21 F3（用户逻辑修正）：SESSION 是对话过程中创建的——**use 激活宁静号会话时，
- * 同步把当前 dsh 会话重命名为该 SESSION 目录名**（sessionTitle.rename，user source
- * pin 住标题）。非创建时预命名。
+ * 与旧面（logbook 11 动作 + trajectory 12 动作）的对应（用户逐条裁决，R↓）：
+ *   · `summary` → 并入 `list`（全库统计随清单一起给）
+ *   · `health`/`qa` → **淘汰**：其判据是"旧六节模板合规"，而 ACC 层的编写标准已升级为 EAP
+ *     ⇒ 只把**不依赖模板**的两项并入 `use`：空壳 / 长期无活动（**提示，不阻断**）
+ *   · `close`/`archive` → 删：`completed` 本就由 SESSION.md 的 `[x]` 推导（不靠 close 写）；
+ *     归档能力由 `container_fs mv → _archived/` 承担
+ *   · `hook-develop-guide` → **淘汰**（v1.34.1：SEP 整体废除——「能落 harness 已有原语，
+ *     就不要自造协议 + 脚本管道」；轨迹挂哪些 skill 改由 SESSION.md frontmatter 声明 +
+ *     `systemPrompt.section` 注入，见 `docs/trajectory-skill-injection.md`）
+ *   · autopilot 面（all/init/random/diag/doc/check/status/guide）→ `container_admin` 的 autopilot 域
+ *   · `wake-add`/`wake-list`/`wake-rm` → **`wake-later`**（一次登记；**不可回收、无面板**——用户明示接受）
+ *
+ * 保留 osp 对齐语义的部分：create 的 `--desc`/`--issue` 二选一、use 激活即重命名 dsh 会话标题（F3）。
+ * 活跃会话跟踪：内存 Map（按 dsh 会话 id 隔离）+ 从 events 恢复（S134）。
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import type { Context } from 'cordis';
-import { type ActiveSessionInfo, type CreateSessionResult } from '../session-ops.js';
-export interface RenameOnUseDeps {
+import { type ActiveSessionInfo, type CreateSessionResult } from '../trajectory-ops.js';
+interface RenameOnUseDeps {
     /** sessionTitle 服务可用性 */
     sessionTitleAvailable: boolean;
 }
@@ -87,7 +94,8 @@ export declare function renameDshSessionForActive(ctx: Context, exec: {
     };
 }, info: ActiveSessionInfo, summary?: string): void;
 /**
- * 创建 session 工具（闭包捕获插件 ctx → use 后可调 ctx.sessionTitle.rename）。
- * v1.21 F3：use 激活宁静号会话 → 当前 dsh 会话重命名为该 SESSION 目录名。
+ * 创建 trajectory 工具（原 logbook；v1.33 S142 §32 更名 + 动作收敛）。
+ * 闭包捕获插件 ctx → use 后可调 ctx.sessionTitle.rename。
  */
-export declare function createSessionTool(ctx: Context): ReturnType<typeof defineTool>;
+export declare function createTrajectoryTool(ctx: Context): ReturnType<typeof defineTool>;
+export {};

package/lib/totp.d.ts

@@ -11,10 +11,6 @@
  */
 /** 时步（秒）——RFC 6238 默认 30 */
 export declare const TOTP_STEP_SECONDS = 30;
-/** 验证窗口：当前时步 ± 1（容忍时钟漂移/生成延迟） */
-export declare const TOTP_WINDOW = 1;
-/** 输出位数（标准 6 位） */
-export declare const TOTP_DIGITS = 6;
 /** 字节 → base32（无填充）。secret 显示/otpauth URI 用。 */
 export declare function base32Encode(bytes: Uint8Array): string;
 /** base32（无填充，大小写不敏感）→ 字节；非法字符抛错。 */

package/lib/trajectory-assistant.d.ts

@@ -52,7 +52,7 @@ export declare const ACK_SKIP_PREFIX = "TRAJECTORY-ASSISTANT-skipped";
  */
 export declare const IN_FLIGHT_HEADING = "## In-flight (rebuild handover)";
 /** 风格档位：plain（默认，精确文本）/ metaphor（借星舰词——产品隐喻非游戏词） */
-export type TrajectoryStyle = 'plain' | 'metaphor';
+type TrajectoryStyle = 'plain' | 'metaphor';
 /**
  * 按风格生成前缀 token。plain = eventToken()（原样）；metaphor 仅当有
  * 星舰化变体时替换用词（当前等价保留——星舰词库隐喻域的既有措辞即
@@ -65,3 +65,4 @@ export declare function styledToken(event: keyof typeof EVENT_LABEL, style?: Tra
  * 尚无可靠自动检测（D2 用户拍板记录为未解问题），实现留待仪式落地。
  */
 export declare function onSettlement(_cb: (sessionId: string) => void): void;
+export {};

package/lib/trajectory-bound-Cax1p9ut.js

@@ -0,0 +1,190 @@
+import { r as cccRootForCwd } from "./ccc-roots-Bd_SjEs7.js";
+import { c as getLastActiveSessionInfo, p as sessionEvents, s as getActiveSessionInfo } from "./trajectory-ops-mrXK0H0I.js";
+import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+//#region src/trajectory-bound.ts
+/**
+* trajectory-bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
+*
+* 目标（S142 用户拍板，方案 v1.0）：让「dsh 会话（载体）↔ SESSION（宁静号轨迹）」
+* 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 container_trajectory rebuild 后
+* 自行更换 SESSION。
+*
+* 存储形态（v1.30.6 起，S142 review F-01）：绑定**不再写入 dsh 会话日志**。
+* 原因（宿主契约实证）：dsp 的自定义事件 `serenity/bound` 既不在宿主的
+* `KNOWN_SESSION_EVENT_TYPES`（生成静态集，明确说明 out-of-repo 插件事件不在其中），
+* 而 `Session.append` 构造事件时只写 `{type,seq,time,data,surfaceOp?,sourceEventSeqs?}`
+* ——**没有写入 envelope `ignorable` 标记的通道**；宿主的 `assertEventsSupported`
+* （session-persistence/coordinator.ts:1248-1252，调用点含恢复/HMR 路径）会拒绝任何
+* "未知且非 ignorable" 的事件 → 含该事件的会话在冷加载时可能抛
+* `SessionFormatUnsupportedError`。v1.29.1~v1.30.5 的设计文档虽写明要带
+* `ignorable: true`（docs/session-binding-hardening-research.md:53），但类型层声明
+* 不等于持久层标记，实际从未落盘。
+*
+* 现形态：每 CCC 一个 JSON 文件 `AGENT_SESSIONS/.bindings.json`（原子写：tmp + rename），
+* 以 dsh 会话 id 为键，latest-wins 覆盖。**向后兼容**：读取时若文件中无该会话记录，
+* 仍回落到扫描会话日志中的旧 `serenity/bound` 事件（老会话的绑定不丢）。
+*
+* 编码无关（U4）：绑定锚 = **完整 AGENT_SESSIONS 目录名**（磁盘唯一存在），
+* sessionId（S###/apaas-xxx/自定义）仅是派生展示字段——绝不假设 S 前缀。
+*/
+/** 旧形态事件类型（v1.29.1~v1.30.5 写入会话日志；v1.30.6 起只读不写——兼容存量绑定） */
+const SESSION_BOUND_EVENT = "serenity/bound";
+/** 绑定文件相对 CCC 根的路径 */
+const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
+const BINDINGS_VERSION = 1;
+function sessionHeader(session) {
+	const header = session?.header;
+	if (!header || typeof header !== "object") return null;
+	return header;
+}
+/** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
+function bindingsPathFor(session) {
+	const header = sessionHeader(session);
+	if (typeof header?.cwd !== "string") return null;
+	const root = cccRootForCwd(header.cwd);
+	if (!root) return null;
+	return join(root, BINDINGS_REL_PATH);
+}
+function readBindingsFile(path) {
+	if (!existsSync(path)) return {
+		version: BINDINGS_VERSION,
+		sessions: {}
+	};
+	try {
+		const sessions = JSON.parse(readFileSync(path, "utf-8")).sessions;
+		if (!sessions || typeof sessions !== "object") return {
+			version: BINDINGS_VERSION,
+			sessions: {}
+		};
+		return {
+			version: BINDINGS_VERSION,
+			sessions
+		};
+	} catch {
+		return {
+			version: BINDINGS_VERSION,
+			sessions: {}
+		};
+	}
+}
+/** 原子写：同目录 tmp + rename（避免半写文件被后续读取） */
+function writeBindingsFile(path, data) {
+	mkdirSync(dirname(path), { recursive: true });
+	const tmp = `${path}.tmp`;
+	writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
+	renameSync(tmp, path);
+}
+/** 记录形状校验（容忍手改/旧数据） */
+function asBoundRecord(value) {
+	const r = value;
+	if (!r || typeof r.dirName !== "string" || typeof r.mdPath !== "string") return null;
+	return r;
+}
+/** 旧形态：从会话日志扫最后一条 `serenity/bound`（兼容 v1.30.5 及更早写入的绑定） */
+function readLegacyBoundFromEvents(session) {
+	const events = sessionEvents(session);
+	for (let i = events.length - 1; i >= 0; i--) {
+		const ev = events[i];
+		if (!ev || ev.type !== SESSION_BOUND_EVENT) continue;
+		const rec = asBoundRecord(ev.data);
+		if (rec) return rec;
+	}
+	return null;
+}
+/**
+* 读取会话当前绑定（权威，latest-wins）：文件记录优先，无则回落旧事件形态。
+* 无绑定返回 null。
+*/
+function readLastBound(session) {
+	const path = bindingsPathFor(session);
+	const id = sessionHeader(session)?.id;
+	if (path && typeof id === "string") {
+		const rec = asBoundRecord(readBindingsFile(path).sessions[id]);
+		if (rec) return rec;
+	}
+	return readLegacyBoundFromEvents(session);
+}
+/** 目录名 → 轨迹标签（`--S###--` 命中取 `S###`；未命中原样返回——编码无关 U4） */
+function trajectoryLabel(dirName) {
+	const m = dirName.match(/--S(\d{3,})--/);
+	return m ? `S${m[1]}` : dirName;
+}
+/**
+* **调用方自身**所属 trajectory 的标签（审计字段 `createdBy` 的唯一正解）。
+*
+* 三级来源，逐级回退（R↓：为什么不用单一来源）：
+*  1. `readLastBound(session)` —— **持久 bound**，权威（重启存活、不受别的会话激活污染）
+*  2. `getActiveSessionInfo(scope)` —— 本 dsh 会话的**内存**激活（按 scope 隔离）
+*  3. `getLastActiveSessionInfo()` —— **全局**最近激活指针（无绑定的会话兼容回退）
+*
+* ⚠️ 为何单列成本函数（S142 §30.12.1 实测缺陷）：唤醒注册表的 `createdBy` 原先直接取第 3 级
+* 全局指针，而它记录的是"**进程内最近一次被激活的 trajectory**"——多会话并发时必然张冠李戴
+* （实测：S142 登记唤醒被写成 `by=S060`）。`createdBy` 是 D60「以可审计替代入口栅」的**唯一凭证**，
+* 失真即替代控制失效 ⇒ 必须以"调用方自己是谁"为准，全局指针只作最后兜底。
+*
+* @param session 调用方 dsh 会话对象（需 `header.id` + `header.cwd`）
+* @param scope 调用方 dsh 会话 id（取不到传空串）
+* @returns 轨迹标签（`S###` 或完整目录名）；三级全落空 → 空串（渲染为 `?`）
+*/
+function resolveSessionTrajectoryLabel(session, scope) {
+	const bound = session ? readLastBound(session) : null;
+	if (bound?.dirName) return trajectoryLabel(bound.dirName);
+	const scoped = scope !== "" ? getActiveSessionInfo(scope) : null;
+	if (scoped) return scoped.sessionId;
+	return getLastActiveSessionInfo()?.sessionId ?? "";
+}
+/**
+* 反向查：绑定到某 trajectory 目录名的 dsh 会话 id（**按绑定时间倒序，最新在前**）。
+*
+* 用途（wake-scheduler 冷唤醒）：.bindings.json 以 **sessionId 为键**，而唤醒条目的
+* target 是**目录名**——需要值侧扫描做反向索引。冷会话被唤醒时必须先知道"哪个 dsh
+* 会话承载这条轨迹"，这是唯一的权威来源（标题只作回退，见 v1.29.2 R2）。
+*
+* @param root CCC 根
+* @param dirName AGENT_SESSIONS 目录名（完整名，如 `2026-09-01--S151--x--auto`）
+* @returns 会话 id 列表（最新绑定在前）；无绑定 → `[]`
+*/
+function listBoundSessionIds(root, dirName) {
+	const file = readBindingsFile(join(root, BINDINGS_REL_PATH));
+	const hits = [];
+	for (const [id, raw] of Object.entries(file.sessions)) {
+		const rec = asBoundRecord(raw);
+		if (!rec || rec.dirName !== dirName) continue;
+		hits.push({
+			id,
+			at: typeof rec.at === "number" ? rec.at : 0
+		});
+	}
+	return hits.sort((a, b) => b.at - a.at).map((h) => h.id);
+}
+/**
+* 写入绑定（latest-wins 覆盖该会话记录）。
+*
+* 绑定持久化尽力而为：无法定位 CCC 根 / 无会话 id / 写盘失败 → 返回 false，不阻断主流程。
+* @param session 目标 dsh 会话（需 `header.id` + `header.cwd` 可定位 CCC 根）
+* @param action 绑定动作
+* @param rec 绑定记录（dirName + mdPath 必填；sessionId 可选展示码）
+*/
+function appendBound(session, action, rec) {
+	const path = bindingsPathFor(session);
+	const id = sessionHeader(session)?.id;
+	if (!path || typeof id !== "string") return false;
+	try {
+		const file = readBindingsFile(path);
+		file.sessions[id] = {
+			dirName: rec.dirName,
+			mdPath: rec.mdPath,
+			...rec.sessionId ? { sessionId: rec.sessionId } : {},
+			action,
+			at: Date.now(),
+			...rec.note ? { note: rec.note } : {}
+		};
+		writeBindingsFile(path, file);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { resolveSessionTrajectoryLabel as i, listBoundSessionIds as n, readLastBound as r, appendBound as t };

package/lib/{session-bound.d.ts → trajectory-bound.d.ts}

@@ -1,8 +1,8 @@
 /**
- * session-bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
+ * trajectory-bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
  *
  * 目标（S142 用户拍板，方案 v1.0）：让「dsh 会话（载体）↔ SESSION（宁静号轨迹）」
- * 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 logbook rebuild 后
+ * 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 container_trajectory rebuild 后
  * 自行更换 SESSION。
  *
  * 存储形态（v1.30.6 起，S142 review F-01）：绑定**不再写入 dsh 会话日志**。
@@ -23,8 +23,8 @@
  * 编码无关（U4）：绑定锚 = **完整 AGENT_SESSIONS 目录名**（磁盘唯一存在），
  * sessionId（S###/apaas-xxx/自定义）仅是派生展示字段——绝不假设 S 前缀。
  */
-export type SessionBoundAction = 'activate' | 'switch' | 'create' | 'rebuild' | 'reconcile' | 'release';
-export interface SessionBoundRecord {
+type SessionBoundAction = 'activate' | 'switch' | 'create' | 'rebuild' | 'reconcile' | 'release';
+interface SessionBoundRecord {
     dirName: string;
     mdPath: string;
     sessionId?: string;
@@ -32,8 +32,6 @@ export interface SessionBoundRecord {
     at: number;
     note?: string;
 }
-/** 旧形态事件类型（v1.29.1~v1.30.5 写入会话日志；v1.30.6 起只读不写——兼容存量绑定） */
-export declare const SESSION_BOUND_EVENT: "serenity/bound";
 /** 绑定文件相对 CCC 根的路径 */
 export declare const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
 /** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
@@ -89,3 +87,4 @@ export declare function appendBound(session: unknown, action: SessionBoundAction
     sessionId?: string;
     note?: string;
 }): boolean;
+export {};