@shgroup/dsh-serenity-hooks 1.31.13 → 1.34.0

package/lib/{session-bound-BpTayaIS.js → trajectory-bound-C8DUxi6_.js}

@@ -1,30 +1,27 @@
-import { a as findSerenityRoot } from "./ccc-DAsSHsub.js";
+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";
-//#region src/session-ops.ts
+//#region src/trajectory-ops.ts
 /**
-* session-ops.ts — session 工具纯操作层（零 DSH 依赖，可独立单测）
+* trajectory-ops.ts — 轨迹工具纯操作层（零 DSH 依赖，可独立单测）
 *
-* 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec：
-*   - create：--desc / --issue 二选一（互斥、缺省报错）；issue 模式目录 YYYY-MM-DD--<issue>
-*     （无 S###，sessionId=issue）；desc 模式 YYYY-MM-DD--S###--<desc>；goal 写入目标段；dry-run 预览
-*   - close：需 name + confirm=true；标记 [x] 已完成+已关闭 + 进度记录"关闭"
-*   - archive：name 缺省 → 批量归档（completed + ≥7 天 → 移动 _archived/）；单会话需 completed + grace
-*   - list/show/health/qa/summary：文本输出格式与 osp 一致
-* 保留 dsp S134 活跃会话机制（内存 Map + events 恢复，不落盘）——osp 同为内存 active-state。
+* 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec。
+*
+* v1.33 收敛（S142 §32）：本文件只服务 `container_trajectory` 的 6 个动作
+* （list / show / create / use / rebuild / wake-later）。旧 `logbook` 面里
+* **close / archive / health / qa 四个动作已删**（用户裁决「功能上废弃，实际上没用」），
+* 其函数（closeSession / archiveSessions / healthCheck / qaCheck）**同批删除**——
+* 保留下来的只有：create（--desc / --issue 二选一、dry-run 预览）、
+* list（含 summarize 仪表盘）、show、use（激活 + 绑定）、以及供 list 用的 summarize。
+* 「完成」不再由 close 写入，而是从 SESSION.md 的 `[x]` 推导；归档走 `container_fs mv`。
 */
-const SESSION_ACTIONS = [
+const TRAJECTORY_ACTIONS = [
 	"list",
 	"show",
 	"create",
 	"use",
-	"close",
-	"health",
-	"qa",
-	"archive",
-	"summary",
-	"hook-develop-guide",
-	"rebuild"
+	"rebuild",
+	"wake-later"
 ];
 /**
 * 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类
@@ -45,11 +42,7 @@ function sessionEvents(session) {
 	return s.events ?? [];
 }
 const SESSION_MD = "SESSION.md";
-const ARCHIVE_DIR_NAME = "_archived";
 const HEALTH_STALE_DAYS = 7;
-const HEALTH_STALLED_PCT = 30;
-const HEALTH_STALLED_DAYS = 3;
-const HEALTH_GHOST_DAYS = 2;
 const DAY = 864e5;
 function sessionsRoot(root) {
 	return join(root, "AGENT_SESSIONS");
@@ -60,18 +53,12 @@ function parseSessionMd(filePath) {
 		const content = readFileSync(filePath, "utf-8");
 		return {
 			hasSessionMd: true,
-			completed: /\[\s*x\s*\]/i.test(content),
-			completedCount: (content.match(/\[\s*x\s*\]/gi) ?? []).length,
-			pendingCount: (content.match(/\[\s*[ \t]\s*\]/g) ?? []).length,
-			unresolvedCount: (content.match(/(未解决|open|question|TODO)/gi) ?? []).length
+			completed: /\[\s*x\s*\]/i.test(content)
 		};
 	} catch {
 		return {
 			hasSessionMd: false,
-			completed: false,
-			completedCount: 0,
-			pendingCount: 0,
-			unresolvedCount: 0
+			completed: false
 		};
 	}
 }
@@ -83,10 +70,7 @@ function readSessionEntry(dirPath) {
 		const mdPath = join(dirPath, SESSION_MD);
 		const status = existsSync(mdPath) ? parseSessionMd(mdPath) : {
 			hasSessionMd: false,
-			completed: false,
-			completedCount: 0,
-			pendingCount: 0,
-			unresolvedCount: 0
+			completed: false
 		};
 		return {
 			dirName,
@@ -241,6 +225,9 @@ let lastActive = null;
 function getActiveSessionInfo(scope) {
 	return activeStore.get(scope) ?? null;
 }
+function getLastActiveSessionInfo() {
+	return lastActive;
+}
 function setActiveSessionInfo(scope, info) {
 	activeStore.set(scope, info);
 	lastActive = info;
@@ -295,26 +282,6 @@ function useSession(root, key, scope = DEFAULT_SESSION_SCOPE) {
 	};
 }
 /**
-* close 子命令（对齐 osp closeSession）：需 name + confirm=true；
-* 标记 SESSION.md 为 [x] 已完成 + [x] 已关闭 + 进度记录"关闭"；清除该会话的活跃状态。
-*/
-function closeSession(root, key, confirm, scope = DEFAULT_SESSION_SCOPE) {
-	if (!confirm) return "⚠ Close requires explicit confirmation.\n  Re-run with --confirm to confirm closing this session.";
-	const session = findSession(sessionsRoot(root), key);
-	if (!session) throw new Error(`Session not found: "${key}". Use "list" to see available sessions.`);
-	if (session.status.completed) return `Session "${session.dirName}" is already completed.`;
-	const mdPath = join(session.path, SESSION_MD);
-	if (!existsSync(mdPath)) throw new Error(`Session "${session.dirName}" has no SESSION.md — nothing to close.`);
-	let content = readFileSync(mdPath, "utf-8");
-	content = content.replace(/\r\n/g, "\n");
-	content = content.replace(/## 状态\n\n?- \[ \] 进行中/, "## 状态\n- [x] 已完成\n- [x] 已关闭");
-	const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 16).replace("T", " ");
-	if (!content.includes("-- 关闭")) content = content.replace(/(## 进度记录\n)/, `$1- ${now} — 关闭\n`);
-	writeFileSync(mdPath, content, "utf-8");
-	clearActiveSessionInfo(scope);
-	return `Session "${session.dirName}" closed and marked as completed.`;
-}
-/**
 * 从会话历史（events）解析会话身份（进程重启恢复；只扫**当前会话**自己的历史——无跨会话串台）。
 *
 * v1.24.11 稳固化（S142 用户需求：重建后新会话必须准确知道从哪个 SESSION 恢复）：
@@ -412,76 +379,7 @@ function resolveSessionByTitle(title, sessionsDir) {
 	if (fuzzy.length === 1) return join(fuzzy[0].path, SESSION_MD);
 	return null;
 }
-/** health 子命令（对齐 osp healthCheck：stale/stalled/ghost/drift 四类检查，文本输出） */
-function healthCheck(root) {
-	const sessions = readAllSessions(sessionsRoot(root));
-	if (sessions.length === 0) return "No sessions found — nothing to check.";
-	const now = Date.now();
-	const issues = [];
-	for (const s of sessions) {
-		const ageDays = (now - s.mtime.getTime()) / DAY;
-		const st = s.status;
-		if (ageDays > HEALTH_STALE_DAYS && !st.completed) issues.push({
-			dirName: s.dirName,
-			issue: `No activity for ${Math.floor(ageDays)}d`,
-			severity: "stale"
-		});
-		const totalTasks = st.completedCount + st.pendingCount;
-		if (totalTasks > 0) {
-			const pct = Math.round(st.completedCount / totalTasks * 100);
-			if (pct < HEALTH_STALLED_PCT && ageDays > HEALTH_STALLED_DAYS && !st.completed) issues.push({
-				dirName: s.dirName,
-				issue: `Only ${pct}% done after ${Math.floor(ageDays)}d`,
-				severity: "stalled"
-			});
-		}
-		if (!st.hasSessionMd && ageDays > HEALTH_GHOST_DAYS) issues.push({
-			dirName: s.dirName,
-			issue: "No SESSION.md (ghost directory)",
-			severity: "ghost"
-		});
-		if (st.unresolvedCount > 3 && !st.completed) issues.push({
-			dirName: s.dirName,
-			issue: `${st.unresolvedCount} unresolved items`,
-			severity: "drift"
-		});
-	}
-	if (issues.length === 0) return "All sessions healthy — no issues found.";
-	const lines = issues.map((i) => `[${i.severity.toUpperCase()}] ${i.dirName}: ${i.issue}`);
-	return `${issues.length} issue(s) found:\n` + lines.join("\n");
-}
-/** archive 子命令（对齐 osp archiveSessions：移动 _archived/；name 缺省批量） */
-function archiveSessions(root, opts) {
-	const { name, dryRun } = opts;
-	const sessionsDir = sessionsRoot(root);
-	const now = Date.now();
-	const archiveDir = join(sessionsDir, ARCHIVE_DIR_NAME);
-	if (name) {
-		const session = findSession(sessionsDir, name);
-		if (!session) throw new Error(`Session not found: "${name}"`);
-		if (!session.status.completed) return `Session "${session.dirName}" is not completed — skipping.`;
-		const ageDays = (now - session.mtime.getTime()) / DAY;
-		if (ageDays < 7) return `Session "${session.dirName}" completed ${Math.floor(ageDays)}d ago — needs ${7 - Math.floor(ageDays)} more days before archiving.`;
-		if (dryRun) return `[dry-run] Would archive: ${session.dirName} → ${ARCHIVE_DIR_NAME}/`;
-		if (!existsSync(archiveDir)) mkdirSync(archiveDir, { recursive: true });
-		renameSync(session.path, join(archiveDir, session.dirName));
-		return `Archived: ${session.dirName} → _archived/`;
-	}
-	const toArchive = readAllSessions(sessionsDir).filter((s) => {
-		if (!s.status.completed) return false;
-		return (now - s.mtime.getTime()) / DAY >= 7;
-	});
-	if (toArchive.length === 0) return "No sessions eligible for archiving.";
-	if (dryRun) return `[dry-run] Would archive ${toArchive.length} session(s):\n` + toArchive.map((s) => `  ${s.dirName}`).join("\n");
-	if (!existsSync(archiveDir)) mkdirSync(archiveDir, { recursive: true });
-	let count = 0;
-	for (const s of toArchive) {
-		renameSync(s.path, join(archiveDir, s.dirName));
-		count++;
-	}
-	return `Archived ${count} session(s) → _archived/`;
-}
-/** summary 子命令（对齐 osp sessionSummary 文本仪表盘） */
+/** summary 仪表盘（供 `list` 动作拼接；v1.33 起独立 `summary` 动作已撤，并入 list） */
 function summarize(root) {
 	const sessions = readAllSessions(sessionsRoot(root));
 	if (sessions.length === 0) return "AGENT_SESSIONS/ is empty.";
@@ -506,157 +404,7 @@ function summarize(root) {
 			return `  ${s.status.completed ? "✓" : "○"} ${s.dirName} (${age}d ago)`;
 		})
 	];
-	if (stale > 0) lines.push("", "⚠ Warning: Stale sessions found — run \"session health\" for details.");
-	return lines.join("\n");
-}
-/** 事实核对：SESSION.md 声明 vs 实际情况（结构/一致性/新鲜度/决策质量/产出物） */
-function qaCheck(root, key) {
-	const session = findSession(sessionsRoot(root), key);
-	if (!session) throw new Error(`Session not found: "${key}". Use "list" to see available sessions.`);
-	const mdPath = join(session.path, SESSION_MD);
-	if (!existsSync(mdPath)) return `[ERROR] Session "${session.dirName}" has no SESSION.md — nothing to verify.`;
-	const content = readFileSync(mdPath, "utf-8");
-	const issues = [];
-	for (const section of [
-		{
-			heading: "目标",
-			label: "目标 (goal)"
-		},
-		{
-			heading: "状态",
-			label: "状态 (status)"
-		},
-		{
-			heading: "关键决策",
-			label: "关键决策 (key decisions)"
-		},
-		{
-			heading: "进度记录",
-			label: "进度记录 (progress)"
-		},
-		{
-			heading: "产出物",
-			label: "产出物 (outputs)"
-		},
-		{
-			heading: "未解决的问题",
-			label: "未解决的问题 (unresolved)"
-		}
-	]) {
-		const headingRegex = new RegExp(`^##\\s*${section.heading}[\\s\\S]*?(?=^##|(?![\\s\\S]))`, "m");
-		const match = content.match(headingRegex);
-		if (!match) {
-			issues.push({
-				severity: "warning",
-				category: "structure",
-				message: `Missing section: ${section.label}`
-			});
-			continue;
-		}
-		const headingLineRegex = new RegExp(`^##\\s*${section.heading}\\s*$`, "m");
-		const body = match[0].replace(headingLineRegex, "").trim();
-		if (!body || /^[-*]\s*$/.test(body)) issues.push({
-			severity: "warning",
-			category: "structure",
-			message: `Section "${section.label}" is empty (only placeholder)`
-		});
-	}
-	const completedTasks = (content.match(/\[\s*x\s*\]/gi) ?? []).length;
-	const pendingTasks = (content.match(/\[\s*[ \t]\s*\]/gi) ?? []).length;
-	const statusSection = content.match(/^##\s*状态[\s\S]*?(?=^##|(?![^]))/im);
-	const statusBody = statusSection ? statusSection[0].replace(/^##\s*状态.*$/m, "").trim() : "";
-	const hasCompletionMark = statusBody ? /#+\s*(?:完成|done|completed|closed)\b/i.test(statusBody) || /(?:全部完成|已全部完成|所有.*任务.*完成|任务.*全部完成|已完成.*所有)/i.test(statusBody) : false;
-	const unresolvedSection = content.match(/^##\s*未解决的问题[\s\S]*?(?=^##|(?![^]))/im);
-	const unresolvedBody = unresolvedSection ? unresolvedSection[0].replace(/^##\s*未解决的问题.*$/m, "").trim() : "";
-	const unresolvedCount = unresolvedBody ? (unresolvedBody.match(/(?:未解决|open|question|TODO)/gi) ?? []).length : 0;
-	if (hasCompletionMark && pendingTasks > 0) issues.push({
-		severity: "error",
-		category: "consistency",
-		message: `Session marked as completed but has ${pendingTasks} pending task(s)`
-	});
-	if (hasCompletionMark && unresolvedCount > 0) issues.push({
-		severity: "warning",
-		category: "consistency",
-		message: `Session marked as completed but has ${unresolvedCount} unresolved item(s)`
-	});
-	if (completedTasks > 0 && pendingTasks === 0 && !hasCompletionMark) issues.push({
-		severity: "info",
-		category: "consistency",
-		message: `All ${completedTasks} task(s) completed but session not marked complete`
-	});
-	const progressSection = content.match(/##\s*进度记录[\s\S]*?(?=^##|\z)/m);
-	if (progressSection) {
-		const dateMatches = progressSection[0].match(/\b(\d{4}-\d{2}-\d{2})\b/g);
-		if (dateMatches && dateMatches.length > 0) {
-			const lastDateStr = dateMatches[dateMatches.length - 1];
-			const lastDate = new Date(lastDateStr);
-			const daysSince = Math.floor((Date.now() - lastDate.getTime()) / DAY);
-			if (daysSince > HEALTH_STALE_DAYS && pendingTasks > 0) issues.push({
-				severity: "warning",
-				category: "stale",
-				message: `No progress entry for ${daysSince} days (last: ${lastDateStr}), session still has ${pendingTasks} pending task(s)`
-			});
-		}
-	}
-	const decisionSection = content.match(/##\s*关键决策[\s\S]*?(?=^##|\z)/m);
-	if (decisionSection) {
-		const decisionLines = decisionSection[0].split("\n").filter((l) => /^\|\s*\d+\s*\|/.test(l));
-		if (decisionLines.length > 0) {
-			const emptyDecisions = decisionLines.filter((l) => {
-				const cells = l.split("|").map((c) => c.trim());
-				return cells.length >= 4 && (!cells[2] || !cells[3] || cells[2] === "-" || cells[3] === "-");
-			});
-			if (emptyDecisions.length > 0) issues.push({
-				severity: "info",
-				category: "quality",
-				message: `${emptyDecisions.length} decision(s) have empty reason — consider filling gaps`
-			});
-		} else if (!hasCompletionMark) issues.push({
-			severity: "info",
-			category: "quality",
-			message: "No decisions recorded yet — add key decisions as the session progresses"
-		});
-	}
-	const outputSection = content.match(/##\s*产出物[\s\S]*?(?=^##|\z)/m);
-	if (outputSection) {
-		const outputLines = outputSection[0].split("\n").filter((l) => /^\s*[-*]\s/.test(l));
-		const fileRefs = [];
-		for (const line of outputLines) {
-			const refs = line.match(/`[^`]+`/g) ?? [];
-			fileRefs.push(...refs.map((r) => r.replace(/`/g, "")));
-			const inlineRefs = line.match(/\b[\w./-]+\.[a-zA-Z]{1,5}\b/g) ?? [];
-			fileRefs.push(...inlineRefs.filter((r) => r.includes("/") || r.includes(".")));
-		}
-		if (fileRefs.length > 0) {
-			const missing = fileRefs.filter((ref) => !existsSync(join(root, ref)));
-			if (missing.length > 0 && completedTasks > 0) issues.push({
-				severity: "warning",
-				category: "outputs",
-				message: `${missing.length} referenced file(s) not found: ${missing.slice(0, 3).join(", ")}${missing.length > 3 ? `... (+${missing.length - 3} more)` : ""}`
-			});
-		}
-	}
-	const errorCount = issues.filter((i) => i.severity === "error").length;
-	const warningCount = issues.filter((i) => i.severity === "warning").length;
-	const infoCount = issues.filter((i) => i.severity === "info").length;
-	const verified = errorCount === 0 && warningCount === 0;
-	const lines = [
-		`QA Report: ${session.dirName}`,
-		`────────────────${"─".repeat(session.dirName.length)}`,
-		`Summary: ${issues.length} issue(s) found (${errorCount} error, ${warningCount} warning, ${infoCount} info)`,
-		`Status: ${verified ? "✓ Verified" : "⚠ Issues found"}`
-	];
-	if (issues.length > 0) {
-		lines.push("");
-		for (const issue of issues) {
-			const tag = issue.severity === "error" ? "ERR" : issue.severity === "warning" ? "WRN" : "INF";
-			lines.push(`  [${tag}:${issue.category}] ${issue.message}`);
-		}
-	}
-	lines.push("", "Recommendations:");
-	if (errorCount > 0) lines.push("  • Fix errors before closing the session (status vs content mismatch)");
-	if (warningCount > 0) lines.push("  • Review warnings — they may indicate incomplete or outdated information");
-	if (verified) lines.push("  • Session looks clean — no issues detected");
+	if (stale > 0) lines.push("", "⚠ Warning: stale trajectories present (no activity > 7d) — see the list above for detail.");
 	return lines.join("\n");
 }
 /** 绑定文件相对 CCC 根的路径 */
@@ -734,6 +482,59 @@ function readLastBound(session) {
 	}
 	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 覆盖该会话记录）。
 *
@@ -763,4 +564,4 @@ function appendBound(session, action, rec) {
 	}
 }
 //#endregion
-export { useSession as C, summarize as S, resolveSessionByTitle as _, archiveSessions as a, setActiveSessionInfo as b, createSession as c, getActiveSessionInfo as d, healthCheck as f, readActiveSessionMd as g, qaCheck as h, SESSION_ACTIONS as i, extractSessionMdPathFromText as l, parseSessionContextFromEvents as m, readLastBound as n, clearActiveSessionInfo as o, listSessions as p, DEFAULT_SESSION_SCOPE as r, closeSession as s, appendBound as t, findSession as u, sessionEvents as v, showSession as x, sessionsRoot as y };
+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 };

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 会话日志**。
@@ -45,6 +45,36 @@ export declare function bindingsPathFor(session: unknown): string | null;
 export declare function readLastBound(session: unknown): SessionBoundRecord | null;
 /** 判定会话是否已有绑定（供 reconcile 判定：无绑定才标题升级）。 */
 export declare function hasAnyBound(session: unknown): boolean;
+/**
+ * **调用方自身**所属 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###` 或完整目录名）；三级全落空 → 空串（渲染为 `?`）
+ */
+export declare function resolveSessionTrajectoryLabel(session: unknown, scope: string): string;
+/**
+ * 反向查：绑定到某 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 列表（最新绑定在前）；无绑定 → `[]`
+ */
+export declare function listBoundSessionIds(root: string, dirName: string): string[];
 /**
  * 写入绑定（latest-wins 覆盖该会话记录）。
  *

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

@@ -1,17 +1,29 @@
 /**
- * session-ops.ts — session 工具纯操作层（零 DSH 依赖，可独立单测）
+ * trajectory-ops.ts — 轨迹工具纯操作层（零 DSH 依赖，可独立单测）
  *
- * 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec：
- *   - create：--desc / --issue 二选一（互斥、缺省报错）；issue 模式目录 YYYY-MM-DD--<issue>
- *     （无 S###，sessionId=issue）；desc 模式 YYYY-MM-DD--S###--<desc>；goal 写入目标段；dry-run 预览
- *   - close：需 name + confirm=true；标记 [x] 已完成+已关闭 + 进度记录"关闭"
- *   - archive：name 缺省 → 批量归档（completed + ≥7 天 → 移动 _archived/）；单会话需 completed + grace
- *   - list/show/health/qa/summary：文本输出格式与 osp 一致
- * 保留 dsp S134 活跃会话机制（内存 Map + events 恢复，不落盘）——osp 同为内存 active-state。
+ * 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec。
+ *
+ * v1.33 收敛（S142 §32）：本文件只服务 `container_trajectory` 的 6 个动作
+ * （list / show / create / use / rebuild / wake-later）。旧 `logbook` 面里
+ * **close / archive / health / qa 四个动作已删**（用户裁决「功能上废弃，实际上没用」），
+ * 其函数（closeSession / archiveSessions / healthCheck / qaCheck）**同批删除**——
+ * 保留下来的只有：create（--desc / --issue 二选一、dry-run 预览）、
+ * list（含 summarize 仪表盘）、show、use（激活 + 绑定）、以及供 list 用的 summarize。
+ * 「完成」不再由 close 写入，而是从 SESSION.md 的 `[x]` 推导；归档走 `container_fs mv`。
  */
 import type { JsonValue } from './json.js';
-export type SessionAction = 'list' | 'show' | 'create' | 'use' | 'close' | 'health' | 'qa' | 'archive' | 'summary' | 'hook-develop-guide' | 'rebuild';
-export declare const SESSION_ACTIONS: readonly SessionAction[];
+/**
+ * `container_trajectory` 工具的动作集合（v1.33，S142 §32 用户裁决后的收敛结果）。
+ *
+ * 为什么只有 6 个（R↓）：旧面是 `logbook`（11）+ `trajectory`（12）两个工具，用户裁决
+ * 「都合并成 trajectory，废除 logbook 这个词」并逐条删并 ——
+ * summary 并进 list｜health/qa 淘汰（判据＝旧模板，EAP 已取代；仅"空壳/长期无活动"并入 use）｜
+ * close/archive 删（completed 由 SESSION.md 的 `[x]` 推导；归档走 container_fs mv）｜
+ * 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';
+export declare const TRAJECTORY_ACTIONS: readonly TrajectoryAction[];
 /**
  * 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类
  * 移除 `.events` 属性 → `snapshotEvents()` 方法（dsh-session/src/session.ts：
@@ -26,10 +38,8 @@ export declare function sessionEvents<T = unknown>(session: unknown): readonly T
 export declare function sessionsRoot(root: string): string;
 interface SessionStatus {
     hasSessionMd: boolean;
+    /** 「完成」的判据 = SESSION.md 里出现 `[x]`（v1.33 起不再由 close 动作写入） */
     completed: boolean;
-    completedCount: number;
-    pendingCount: number;
-    unresolvedCount: number;
 }
 export interface SessionEntry {
     dirName: string;
@@ -98,11 +108,6 @@ export declare function useSession(root: string, key: string, scope?: string): {
     mdPath: string;
     context: string;
 };
-/**
- * close 子命令（对齐 osp closeSession）：需 name + confirm=true；
- * 标记 SESSION.md 为 [x] 已完成 + [x] 已关闭 + 进度记录"关闭"；清除该会话的活跃状态。
- */
-export declare function closeSession(root: string, key: string, confirm: boolean, scope?: string): string;
 /**
  * 从会话历史（events）解析会话身份（进程重启恢复；只扫**当前会话**自己的历史——无跨会话串台）。
  *
@@ -136,16 +141,7 @@ export declare function resolveSessionByTitle(title: string, sessionsDir: string
  * 只作最后手段（内存/events/锚点全缺时），保证重建锚点至少指向一个真实存在的轨迹。
  */
 export declare function findLatestActiveSessionMd(root: string): string | null;
-/** health 子命令（对齐 osp healthCheck：stale/stalled/ghost/drift 四类检查，文本输出） */
-export declare function healthCheck(root: string): string;
-/** archive 子命令（对齐 osp archiveSessions：移动 _archived/；name 缺省批量） */
-export declare function archiveSessions(root: string, opts: {
-    name?: string;
-    dryRun: boolean;
-}): string;
-/** summary 子命令（对齐 osp sessionSummary 文本仪表盘） */
+/** summary 仪表盘（供 `list` 动作拼接；v1.33 起独立 `summary` 动作已撤，并入 list） */
 export declare function summarize(root: string): string;
-/** 事实核对：SESSION.md 声明 vs 实际情况（结构/一致性/新鲜度/决策质量/产出物） */
-export declare function qaCheck(root: string, key: string): string;
 export type SessionInfo = SessionEntry;
 export type { JsonValue };