@shgroup/dsh-serenity-hooks 1.34.0 → 1.34.2

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/trajectory-bound.d.ts

@@ -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 {};

package/lib/{trajectory-bound-C8DUxi6_.js → trajectory-ops-mrXK0H0I.js}

@@ -1,6 +1,5 @@
-import { a as findSerenityRoot } from "./ccc-eu_IPF94.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 //#region src/trajectory-ops.ts
 /**
 * trajectory-ops.ts — 轨迹工具纯操作层（零 DSH 依赖，可独立单测）
@@ -407,161 +406,5 @@ function summarize(root) {
 	if (stale > 0) lines.push("", "⚠ Warning: stale trajectories present (no activity > 7d) — see the list above for detail.");
 	return lines.join("\n");
 }
-/** 绑定文件相对 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 = findSerenityRoot(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 !== "serenity/bound") 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 { sessionsRoot as _, DEFAULT_SESSION_SCOPE as a, summarize as b, createSession as c, getActiveSessionInfo as d, listSessions as f, sessionEvents as g, resolveSessionByTitle as h, resolveSessionTrajectoryLabel as i, extractSessionMdPathFromText as l, readActiveSessionMd as m, listBoundSessionIds as n, TRAJECTORY_ACTIONS as o, parseSessionContextFromEvents as p, readLastBound as r, clearActiveSessionInfo as s, appendBound as t, findSession as u, setActiveSessionInfo as v, useSession as x, showSession as y };
+export { summarize as _, extractSessionMdPathFromText as a, getLastActiveSessionInfo as c, readActiveSessionMd as d, resolveSessionByTitle as f, showSession as g, setActiveSessionInfo as h, createSession as i, listSessions as l, sessionsRoot as m, TRAJECTORY_ACTIONS as n, findSession as o, sessionEvents as p, clearActiveSessionInfo as r, getActiveSessionInfo as s, DEFAULT_SESSION_SCOPE as t, parseSessionContextFromEvents as u, useSession as v };

package/lib/trajectory-ops.d.ts

@@ -11,7 +11,6 @@
  * list（含 summarize 仪表盘）、show、use（激活 + 绑定）、以及供 list 用的 summarize。
  * 「完成」不再由 close 写入，而是从 SESSION.md 的 `[x]` 推导；归档走 `container_fs mv`。
  */
-import type { JsonValue } from './json.js';
 /**
  * `container_trajectory` 工具的动作集合（v1.33，S142 §32 用户裁决后的收敛结果）。
  *
@@ -22,7 +21,7 @@ import type { JsonValue } from './json.js';
  * hook-develop-guide 并进 container_admin msm guide｜autopilot 面归 container_admin 的 autopilot 域｜
  * wake-add/list/rm 收敛为 wake-later。
  */
-export type TrajectoryAction = 'list' | 'show' | 'create' | 'use' | 'rebuild' | 'wake-later';
+type TrajectoryAction = 'list' | 'show' | 'create' | 'use' | 'rebuild' | 'wake-later';
 export declare const TRAJECTORY_ACTIONS: readonly TrajectoryAction[];
 /**
  * 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类
@@ -41,7 +40,7 @@ interface SessionStatus {
     /** 「完成」的判据 = SESSION.md 里出现 `[x]`（v1.33 起不再由 close 动作写入） */
     completed: boolean;
 }
-export interface SessionEntry {
+interface SessionEntry {
     dirName: string;
     path: string;
     mtime: Date;
@@ -56,7 +55,7 @@ export declare function findSession(sessionsDir: string, key: string): SessionEn
 export declare function listSessions(root: string, activeId?: string): string;
 /** show 子命令（对齐 osp showSession：`# dirName\n\n` + SESSION.md 内容） */
 export declare function showSession(root: string, key: string): string;
-export interface CreateSessionOptions {
+interface CreateSessionOptions {
     root: string;
     /** --desc 模式的描述（与 issue 互斥） */
     desc?: string;
@@ -71,9 +70,6 @@ export interface CreateSessionResult {
     sessionPath: string;
     sessionId: string;
 }
-/** create 子命令（对齐 osp createSession：--desc/--issue 二选一 + dry-run + 长度限制） */
-/** 目录名脱敏（Windows 审计问题 10）：非法字符 → '-', 去尾点/空格, 保留名（CON/NUL 等）加前缀 */
-export declare function sanitizeDirName(s: string): string;
 export declare function createSession(opts: CreateSessionOptions): CreateSessionResult;
 /**
  * 活动会话跟踪（S134 v1.16.14 内存化，对齐 osp active-state）：
@@ -143,5 +139,4 @@ export declare function resolveSessionByTitle(title: string, sessionsDir: string
 export declare function findLatestActiveSessionMd(root: string): string | null;
 /** summary 仪表盘（供 `list` 动作拼接；v1.33 起独立 `summary` 动作已撤，并入 list） */
 export declare function summarize(root: string): string;
-export type SessionInfo = SessionEntry;
-export type { JsonValue };
+export {};

package/lib/trajectory-skills.d.ts

@@ -0,0 +1,71 @@
+/**
+ * trajectory-skills.ts — 轨迹 skill 声明解析 + 注入内容装配（纯逻辑，零 DSH 依赖）
+ *
+ * 接口真相源：`docs/trajectory-skill-injection.md` v1.0（§2 数据契约 / §3 注入契约）。
+ * 一句话：**轨迹自己声明它要挂哪些 skill**（`SESSION.md` 顶部 YAML frontmatter 的 `skills:`），
+ * ACC 在**绑定期间**把这些 skill 的 `SKILL.md` 全文注入系统提示词。
+ *
+ * 分工（R↓：为什么解析与注册分开）：
+ *   · 本模块 = **纯文本层**（解析 / 装配 / 安全判定）——可脱离 DSH 单测；
+ *   · `seams/system-prompt.ts` 的 `registerTrajectorySkillSection` = **宿主接入层**
+ *     （per-agent `ctx.systemPrompt.section`），只做门与注册，不再解析文本。
+ *
+ * 边界（规格 §2.2）：**不解析** `skills` 以外任何键的语义（CCC 可自由使用，ACC 视而不见）；
+ * **不改写** frontmatter（ACC 只读）。
+ */
+/** 全文注入总长上限（字符数；规格 §3「缺省 32 KB」——防上下文爆炸） */
+export declare const TRAJECTORY_SKILLS_MAX_CHARS: number;
+/** 缺失标记（规格 §3/§6-3 的验收锚点：任何"拿不到全文"的情况都必须带它，绝不静默） */
+export declare const SKILL_MISSING_MARK = "[\u7F3A\u5931]";
+/**
+ * 抽取文件顶部 YAML frontmatter 区（规格 §2.1）。
+ *
+ * 规则：**第一行必须是 `---`**；到下一个 `---` 行为止是 frontmatter 区。
+ * 首行不是 `---`，或没有闭合 `---` ⇒ 视为**无 frontmatter**（返回 null）。
+ * 边界判断（R↓）：未闭合块按"无 frontmatter"处理而非吞掉整个文件——半个声明块是格式错误，
+ * 猜它的意图等于把坏数据当好消息（宁可零注入，也不注入来路不明的半截列表）。
+ *
+ * @param content SESSION.md 全文
+ * @returns frontmatter 区各行（不含两条 `---` 定界行）；无 → null
+ */
+export declare function extractFrontmatter(content: string): string[] | null;
+/**
+ * 解析声明（规格 §2.1，**最小实现，不引 YAML 依赖**）。
+ *
+ * 只认 `skills:` 键；未知键一律忽略（向前兼容，不报错）。两种值形态都支持：
+ *   ① 行内数组 `skills: [home-rhetoric, acc-eap]`
+ *   ② 缩进列表（`skills:` 后各起一行 `  - a`）
+ * 名字：去首尾空白、空项丢弃、**保持书写顺序**（注入顺序 = 书写顺序）、同名去重（保留首次位置）。
+ *
+ * 未定义形态（不在规格的两种值形态内，如 `skills: a` 裸标量）⇒ **视为无声明**：
+ * 本函数只认契约里写明的两种形态，猜第三种等于自造契约（规格 §2.1 只列了 ①②）。
+ *
+ * @param sessionMd SESSION.md 全文
+ * @returns 声明的 skill 名（按书写顺序去重）；无 frontmatter / 无 `skills` 键 / 值为空 → `[]`
+ */
+export declare function parseDeclaredSkills(sessionMd: string): string[];
+/**
+ * 注册门（规格 §3「无绑定 / 无声明 ⇒ 完全不注册该 section」）。
+ *
+ * 返回 true 的两种情况：
+ *   · 文件在且**有非空声明** → 注册（有内容可注入）
+ *   · 文件**不在 / 读不到** → 同样注册——此时 section 文本是响亮的 `[缺失]` 提示
+ *     （规格 §6-6 要求"不静默"；不注册就等于静默）
+ * 其余（文件在但无 frontmatter / 无 `skills` 键 / 值为空）⇒ false，不注册、不产生噪声。
+ */
+export declare function hasTrajectorySkillsDeclaration(root: string, mdPath: string): boolean;
+/**
+ * 装配注入正文（规格 §3）：按声明顺序拼接各 skill 的 `SKILL.md` 全文，每段带来源抬头
+ * `=== skill: <name> ===`；拿不到全文的一律以 `[缺失]` 响亮提示占位（**不静默**）。
+ *
+ * 安全（规格 §3 🔒）：名字来自 CCC 数据（frontmatter）⇒ **先过 `isSafeSkillName`**；
+ * 不安全 ⇒ 按缺失处理，且不调用 `findSkillMd` ⇒ **不发生任何以该名拼出的 fs 访问**。
+ *
+ * 长度守卫：复用已导出的 `truncateContent`，超限截断并在末尾写明 `truncated`。
+ *
+ * @param root CCC 根
+ * @param mdPath 轨迹的 SESSION.md 路径（**来自绑定的 `mdPath`**，不用 label 拼）
+ * @param maxChars 总长上限（字符）
+ * @returns 注入正文；无声明 → `''`（空串 = 宿主不产出该 section 块）；SESSION.md 缺失 → 响亮提示
+ */
+export declare function buildTrajectorySkillsSection(root: string, mdPath: string, maxChars?: number): string;

package/lib/{wake-registry-D0Vj0WXb.js → wake-registry-CYxIb484.js}

@@ -1,6 +1,5 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 //#region src/wake-registry.ts
 /**
 * wake-registry.ts — trajectory 唤醒注册表（D58，S142 2026-09-13）
@@ -16,22 +15,10 @@ import { dirname, join } from "node:path";
 *
 * 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
 */
-var wake_registry_exports = /* @__PURE__ */ __exportAll({
-	WAKE_CATCH_UP_MS: () => WAKE_CATCH_UP_MS,
-	WAKE_REGISTRY_REL_PATH: () => WAKE_REGISTRY_REL_PATH,
-	WAKE_REGISTRY_VERSION: () => 1,
-	addWake: () => addWake,
-	listWakes: () => listWakes,
-	loadWakeRegistry: () => loadWakeRegistry,
-	newWakeId: () => newWakeId,
-	parseWakeAt: () => parseWakeAt,
-	saveWakeRegistry: () => saveWakeRegistry,
-	splitDueWakes: () => splitDueWakes,
-	updateWake: () => updateWake,
-	wakeRegistryPath: () => wakeRegistryPath
-});
 /** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
 const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
+/** 注册表格式版本（结构变更时 +1；读取端只接受本版本） */
+const WAKE_REGISTRY_VERSION = 1;
 /**
 * 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
 * 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
@@ -44,7 +31,7 @@ function wakeRegistryPath(root) {
 /** 空注册表 */
 function emptyRegistry() {
 	return {
-		version: 1,
+		version: WAKE_REGISTRY_VERSION,
 		entries: []
 	};
 }
@@ -88,7 +75,7 @@ function loadWakeRegistry(root) {
 		}
 		return {
 			registry: {
-				version: 1,
+				version: WAKE_REGISTRY_VERSION,
 				entries
 			},
 			error: null
@@ -107,7 +94,7 @@ function saveWakeRegistry(root, registry) {
 		mkdirSync(dirname(path), { recursive: true });
 		const tmp = `${path}.tmp`;
 		writeFileSync(tmp, `${JSON.stringify({
-			version: 1,
+			version: WAKE_REGISTRY_VERSION,
 			entries: registry.entries
 		}, null, 2)}\n`, "utf-8");
 		renameSync(tmp, path);
@@ -267,4 +254,4 @@ function listWakes(root, opts = {}) {
 	};
 }
 //#endregion
-export { splitDueWakes as a, loadWakeRegistry as i, addWake as n, updateWake as o, listWakes as r, wake_registry_exports as s, WAKE_CATCH_UP_MS as t };
+export { splitDueWakes as a, loadWakeRegistry as i, addWake as n, updateWake as o, listWakes as r, WAKE_CATCH_UP_MS as t };

package/lib/wake-registry.d.ts

@@ -12,17 +12,13 @@
  *
  * 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
  */
-/** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
-export declare const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
-/** 注册表格式版本（结构变更时 +1；读取端只接受本版本） */
-export declare const WAKE_REGISTRY_VERSION = 1;
 /**
  * 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
  * 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
  */
 export declare const WAKE_CATCH_UP_MS: number;
 /** 条目状态：一次性唤醒只有这四种归宿 */
-export type WakeState = 'pending' | 'delivered' | 'missed' | 'cancelled';
+type WakeState = 'pending' | 'delivered' | 'missed' | 'cancelled';
 /** 一条唤醒条目 */
 export interface WakeEntry {
     /** 稳定 id（不复用；`w-<UTC 到分钟>-<4 hex>`） */
@@ -47,7 +43,7 @@ export interface WakeEntry {
     deliveredAt: string | null;
 }
 /** 注册表文件形态 */
-export interface WakeRegistry {
+interface WakeRegistry {
     version: number;
     entries: WakeEntry[];
 }
@@ -62,11 +58,6 @@ export declare function loadWakeRegistry(root: string): {
     registry: WakeRegistry;
     error: string | null;
 };
-/** 原子写（tmp + rename；与 .bindings.json 同款形态） */
-export declare function saveWakeRegistry(root: string, registry: WakeRegistry): {
-    ok: boolean;
-    error: string | null;
-};
 /** 条目 id：`w-<UTC 到分钟>-<4 hex>`（可读 + 低碰撞；不复用由"物理移除"保证） */
 export declare function newWakeId(nowMs: number, rand?: () => number): string;
 /**
@@ -144,3 +135,4 @@ export declare function listWakes(root: string, opts?: {
     entries: WakeEntry[];
     error: string | null;
 };
+export {};