@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.1

package/lib/session-bound-NHozeLFc.js

@@ -1,822 +0,0 @@
-import { a as findSerenityRoot } from "./ccc-DAsSHsub.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
-import { basename, dirname, join } from "node:path";
-//#region src/session-ops.ts
-/**
-* session-ops.ts — session 工具纯操作层（零 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。
-*/
-const SESSION_ACTIONS = [
-	"list",
-	"show",
-	"create",
-	"use",
-	"close",
-	"health",
-	"qa",
-	"archive",
-	"summary",
-	"hook-develop-guide",
-	"rebuild"
-];
-/**
-* 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类
-* 移除 `.events` 属性 → `snapshotEvents()` 方法（dsh-session/src/session.ts：
-* `snapshotEvents(fromSeq, toSeqExclusive)`）。插件早期代码多处裸读 `.events`
-* （经 `as unknown as { events? }` 断言绕过 typecheck），运行时静默 undefined——
-* 造成 first-anchor 每轮重插 / SESSION 激活恢复失效 / rebuild 定位错乱。
-* 统一收敛到本 helper：snapshotEvents() 优先（rc.1 真实形态），`.events` 兜底
-* （测试替身/旧运行时）。所有消费方一律经此读取，禁止再裸读 `.events`。
-* 泛型 T：调用方按需声明事件形状（如 `SessionEvent`），unknown 默认。
-*/
-function sessionEvents(session) {
-	const s = session;
-	if (!s) return [];
-	if (typeof s.snapshotEvents === "function") try {
-		return s.snapshotEvents() ?? [];
-	} catch {}
-	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");
-}
-/** 解析 SESSION.md 状态元数据（对齐 osp parseSessionMd） */
-function parseSessionMd(filePath) {
-	try {
-		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
-		};
-	} catch {
-		return {
-			hasSessionMd: false,
-			completed: false,
-			completedCount: 0,
-			pendingCount: 0,
-			unresolvedCount: 0
-		};
-	}
-}
-function readSessionEntry(dirPath) {
-	try {
-		const st = statSync(dirPath);
-		if (!st.isDirectory()) return null;
-		const dirName = basename(dirPath);
-		const mdPath = join(dirPath, SESSION_MD);
-		const status = existsSync(mdPath) ? parseSessionMd(mdPath) : {
-			hasSessionMd: false,
-			completed: false,
-			completedCount: 0,
-			pendingCount: 0,
-			unresolvedCount: 0
-		};
-		return {
-			dirName,
-			path: dirPath,
-			mtime: st.mtime,
-			status
-		};
-	} catch {
-		return null;
-	}
-}
-/** 读取 AGENT_SESSIONS 中所有会话，活跃（未完成）排前（对齐 osp readAllSessions） */
-function readAllSessions(sessionsDir) {
-	try {
-		return readdirSync(sessionsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => readSessionEntry(join(sessionsDir, e.name))).filter((s) => s !== null).sort((a, b) => {
-			if (!a.status.completed && b.status.completed) return -1;
-			if (a.status.completed && !b.status.completed) return 1;
-			return b.mtime.getTime() - a.mtime.getTime();
-		});
-	} catch {
-		return [];
-	}
-}
-/** 提取目录名中的会话 ID（S### 或 issue 名）；无匹配返回 '' */
-function extractSessionId(dirName) {
-	const m = dirName.match(/--S(\d{3,})--/);
-	return m ? `S${m[1]}` : "";
-}
-/**
-* 根据 key 查找会话（对齐 osp findSession）：
-* 精确目录名 → S### ID（允许 S31→031）→ 唯一模糊子串匹配（多个则报错）
-*/
-function findSession(sessionsDir, key) {
-	const all = readAllSessions(sessionsDir);
-	const byName = all.find((s) => s.dirName === key);
-	if (byName) return byName;
-	const searchId = key.replace(/^S/, "").padStart(3, "0");
-	const byId = all.find((s) => {
-		const m = s.dirName.match(/--S(\d{3,})--/);
-		return m && m[1] === searchId;
-	});
-	if (byId) return byId;
-	const lower = key.toLowerCase();
-	const fuzzy = all.filter((s) => s.dirName.toLowerCase().includes(lower));
-	if (fuzzy.length === 1) return fuzzy[0] ?? null;
-	if (fuzzy.length > 1) throw new Error(`Found ${fuzzy.length} sessions matching "${key}": ` + fuzzy.map((s) => s.dirName).join(", ") + ". Use a more specific query.");
-	return null;
-}
-/** list 子命令（对齐 osp listSessions 文本格式 + active 标记） */
-function listSessions(root, activeId) {
-	const sessions = readAllSessions(sessionsRoot(root));
-	if (sessions.length === 0) return "(no sessions in AGENT_SESSIONS/)";
-	const lines = sessions.map((s) => {
-		const age = Math.floor((Date.now() - s.mtime.getTime()) / DAY);
-		const sessionId = extractSessionId(s.dirName);
-		return `${activeId !== void 0 && sessionId !== "" && sessionId === activeId ? "●" : s.status.completed ? "✓" : "○"} ${s.dirName} (${age}d ago)`;
-	});
-	return `AGENT_SESSIONS/ (${sessions.length} sessions)\n` + lines.join("\n");
-}
-/** show 子命令（对齐 osp showSession：`# dirName\n\n` + SESSION.md 内容） */
-function showSession(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 `Session ${session.dirName} (no SESSION.md — directory exists but is empty)`;
-	const content = readFileSync(mdPath, "utf-8");
-	return `# ${session.dirName}\n\n${content}`;
-}
-/** 生成 SESSION.md 模板（对齐 osp：goal 写入目标段，时间戳 YYYY-MM-DD HH:mm） */
-function sessionMdTemplate(title, id, goal, now) {
-	const ts = now.toISOString().slice(0, 16).replace("T", " ");
-	return `# SESSION: ${title}\n- ID: ${id}\n\n## 目标\n${goal ?? "（待补充）"}\n\n## 状态\n- [ ] 进行中\n\n## 关键决策\n| # | 决策 | 理由 |\n|---|------|------|\n| 1 | | |\n\n## 进度记录\n- ${ts} — 创建\n\n## 产出物\n- \n\n## 未解决的问题\n- \n`;
-}
-/** create 子命令（对齐 osp createSession：--desc/--issue 二选一 + dry-run + 长度限制） */
-/** 目录名脱敏（Windows 审计问题 10）：非法字符 → '-', 去尾点/空格, 保留名（CON/NUL 等）加前缀 */
-function sanitizeDirName(s) {
-	const cleaned = s.replace(/[<>:"/\\|?*\u0000-\u001f]/g, "-").replace(/[ .]+$/g, "");
-	if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(cleaned)) return `_${cleaned}`;
-	return cleaned;
-}
-function createSession(opts) {
-	const { root, desc, issue, goal, dryRun } = opts;
-	const sessionsDir = sessionsRoot(root);
-	const now = /* @__PURE__ */ new Date();
-	const datePrefix = now.toISOString().slice(0, 10);
-	if (!desc && !issue) throw new Error("create requires either --desc or --issue");
-	if (desc && issue) throw new Error("--desc and --issue are mutually exclusive");
-	if (issue) {
-		if (issue.length > 100) throw new Error(`issue too long: ${issue.length} chars (max 100)`);
-		const dirName = `${datePrefix}--${sanitizeDirName(issue)}`;
-		const sessionPath = join(sessionsDir, dirName);
-		if (!dryRun && existsSync(sessionPath)) throw new Error(`Session directory already exists: "${dirName}"`);
-		if (dryRun) return {
-			message: `[dry-run] Would create: ${dirName}/`,
-			dirName,
-			sessionPath,
-			sessionId: issue
-		};
-		mkdirSync(sessionPath, { recursive: true });
-		writeFileSync(join(sessionPath, SESSION_MD), sessionMdTemplate(issue, issue, goal, now), "utf-8");
-		return {
-			message: `Created: ${dirName}/`,
-			dirName,
-			sessionPath,
-			sessionId: issue
-		};
-	}
-	if (!desc || desc.length === 0) throw new Error("description cannot be empty");
-	if (desc.length > 200) throw new Error(`description too long: ${desc.length} chars (max 200)`);
-	const sessions = readAllSessions(sessionsDir);
-	let maxId = 0;
-	for (const s of sessions) {
-		const m = s.dirName.match(/--S(\d{3,})--/);
-		if (m) {
-			const num = parseInt(m[1], 10);
-			if (num > maxId) maxId = num;
-		}
-	}
-	const nextId = String(maxId + 1).padStart(3, "0");
-	const dirName = `${datePrefix}--S${nextId}--${sanitizeDirName(desc)}`;
-	const sessionPath = join(sessionsDir, dirName);
-	if (!dryRun && existsSync(sessionPath)) throw new Error(`Session directory already exists: "${dirName}"`);
-	if (dryRun) return {
-		message: `[dry-run] Would create: ${dirName}/\n  goal=${goal ?? "(none)"}`,
-		dirName,
-		sessionPath,
-		sessionId: `S${nextId}`
-	};
-	mkdirSync(sessionPath, { recursive: true });
-	writeFileSync(join(sessionPath, SESSION_MD), sessionMdTemplate(desc, `S${nextId}`, goal, now), "utf-8");
-	return {
-		message: `Created: ${dirName}/ (S${nextId})`,
-		dirName,
-		sessionPath,
-		sessionId: `S${nextId}`
-	};
-}
-/**
-* 活动会话跟踪（S134 v1.16.14 内存化，对齐 osp active-state）：
-* **不落盘**——活跃会话状态在内存 Map（key = scope = dsh 会话 id），避免落盘标记
-* 文件累积与跨会话串台（落盘版 `.dsh/active-sessions/<scope>` 已被此方案取代）。
-* 进程重启恢复：从**当前会话历史（events）**解析 `[SESSION CONTEXT]` 标记（use 时注入），
-* 只扫自己会话——无全局扫描、无跨会话污染。
-*/
-const DEFAULT_SESSION_SCOPE = "default";
-/** [SESSION CONTEXT] 恢复标记（use 时注入 events 历史；进程重启后从 events 解析） */
-const SESSION_CONTEXT_MARKER = "[SESSION CONTEXT] Activated:";
-/** 内存活跃会话：scope（dsh 会话 id）→ 会话信息（不落盘；并行多会话各自 key 隔离） */
-const activeStore = /* @__PURE__ */ new Map();
-/** 全局最近活跃（对齐 osp lastActive；供无 scope 上下文使用） */
-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;
-}
-function clearActiveSessionInfo(scope) {
-	activeStore.delete(scope);
-	if (lastActive && ![...activeStore.values()].some((v) => v === lastActive)) lastActive = null;
-}
-/** 当前 scope 的活跃会话 SESSION.md 绝对路径；无激活返回 null（读内存，不落盘） */
-function readActiveSessionMd(_root, scope = DEFAULT_SESSION_SCOPE) {
-	return getActiveSessionInfo(scope)?.mdPath ?? null;
-}
-/**
-* use 子命令：激活会话（写内存 Map）+ 返回对齐 osp 的输出文本
-* （含 [SESSION CONTEXT] 标记 + todowrite 指令；标记随工具结果进 events 历史，
-*  进程重启后从当前会话 events 解析恢复）。
-*/
-function useSession(root, key, scope = DEFAULT_SESSION_SCOPE) {
-	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)) throw new Error(`Session "${session.dirName}" has no SESSION.md — nothing to load.`);
-	const sessionId = extractSessionId(session.dirName) || basename(session.dirName);
-	const dirName = session.dirName;
-	const shortName = dirName.replace(/^\d{4}-\d{2}-\d{2}--/, "");
-	setActiveSessionInfo(scope, {
-		sessionId,
-		dirName,
-		mdPath
-	});
-	return {
-		dir: dirName,
-		mdPath,
-		context: [
-			`───────────────────────────────────────────────────────────────`,
-			`${SESSION_CONTEXT_MARKER} ${dirName}`,
-			`───────────────────────────────────────────────────────────────`,
-			`Use "session show ${sessionId}" to view session details.`,
-			`SESSION.md path: ${mdPath}`,
-			``,
-			`→ All subsequent work should refer back to this session.`,
-			`  Use "session show ${sessionId}" to check current progress.`,
-			`  After advancing work, update the "进度记录" (progress) section in SESSION.md.`,
-			``,
-			`→ BEFORE responding to the user, you MUST call todowrite immediately`,
-			`  with the session todo list. The first item MUST be:`,
-			`    content: "SESSION: ${sessionId} — ${shortName}"`,
-			`    status: "completed", priority: "low"`,
-			`  Follow with any tasks parsed from SESSION.md.`,
-			`───────────────────────────────────────────────────────────────`
-		].join("\n")
-	};
-}
-/**
-* 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 恢复）：
-* **路径规范行即可，不再要求 [SESSION CONTEXT] 标记**——`session use` 上下文与重建锚点
-* （buildRebuildAnchor 的 `- Persistent trajectory — SESSION.md path: <rel>` 行）同格式，
-* 因此**仅靠重建锚点的会话（从未显式 use）同样可恢复**。从**尾到头**扫描，最后一条
-* 合法路径胜出（时间序最新）；会话目录名/ID 从路径本身派生（单一真相源，不猜）。
-* 路径可为相对（重建锚点存 rel）——绝对化与存在性校验在调用方（知道 root）执行。
-*/
-function parseSessionContextFromEvents(events) {
-	for (let i = events.length - 1; i >= 0; i--) {
-		const strs = [];
-		collectStrings(events[i], strs);
-		for (const s of strs) {
-			const md = extractSessionMdPathFromText(s);
-			if (!md) continue;
-			let dirName;
-			let filePath;
-			if (basename(md) === SESSION_MD) {
-				dirName = basename(dirname(md));
-				filePath = md;
-			} else if (isSessionDirName(basename(md))) {
-				dirName = basename(md);
-				filePath = join(md, SESSION_MD);
-			} else continue;
-			if (!isSessionDirName(dirName)) continue;
-			const idMatch = dirName.match(/--S(\d{3,})--/);
-			return {
-				sessionId: idMatch ? `S${idMatch[1]}` : dirName,
-				dirName,
-				mdPath: filePath
-			};
-		}
-	}
-	return null;
-}
-/** 递归收集对象/数组/字符串中的全部字符串（保留原文，无 JSON 转义） */
-function collectStrings(v, out) {
-	if (typeof v === "string") {
-		out.push(v);
-		return;
-	}
-	if (v && typeof v === "object") for (const val of Object.values(v)) collectStrings(val, out);
-}
-/** 规范行正则：`SESSION.md path: <路径>`（路径可含空格 → [^\r\n]+ 整行匹配） */
-const SESSION_MD_PATH_RE = /SESSION\.md path:\s*([^\r\n]+)/;
-/** 从文本提取 SESSION.md 路径（use 上下文 / 重建锚点规范行通用；无匹配返回 null）。
-*  同行已知尾注（如系统提示词 Session 块的 persistent-body 注释）剥除——规范行只取路径本体。 */
-function extractSessionMdPathFromText(text) {
-	const m = text.match(SESSION_MD_PATH_RE);
-	if (!m) return null;
-	let p = m[1].trim();
-	const suffix = p.search(/ \(the trajectory's persistent body/);
-	if (suffix > 0) p = p.slice(0, suffix).trim();
-	return p;
-}
-/** 会话目录名形态校验（createSession 恒带日期前缀 `YYYY-MM-DD--`） */
-function isSessionDirName(dirName) {
-	return /^\d{4}-\d{2}-\d{2}--/.test(dirName) && dirName.length > 11;
-}
-/**
-* 从 dsh 会话标题解析 SESSION 目录（编码无关 best-match，U3/U4）——
-* 标题不假设 S### 前缀（CCC 可自定义编码：apaas-xxx / P### / 完整目录名等）。
-* 匹配优先级（全部对 AGENT_SESSIONS 现有目录 best-match，不猜）：
-*   ① 标题即完整目录名（含日期前缀 `YYYY-MM-DD--`）→ 精确命中
-*   ② 标题含 `--<code>--` 段（如完整目录名被截断为 `<code>-日期-概括` 前段）→
-*      按 code 段匹配：取标题首 token（`-` 前），与各目录 `--<code>--`/`--<code>` 尾段比对
-*   ③ 唯一模糊子串匹配（多个则返回 null 防误猜）
-* @param title dsh 会话标题（如 `S142-2026-08-24-概括` / `apaas-26116-…` / 完整目录名）
-* @param sessionsDir AGENT_SESSIONS 绝对路径
-* @returns 命中目录的绝对路径（SESSION.md）；无/歧义返回 null
-*/
-function resolveSessionByTitle(title, sessionsDir) {
-	const t = (title ?? "").trim();
-	if (!t) return null;
-	const all = readAllSessions(sessionsDir);
-	if (all.length === 0) return null;
-	if (isSessionDirName(t)) {
-		const exact = all.find((s) => s.dirName === t);
-		if (exact) return join(exact.path, SESSION_MD);
-	}
-	const codeToken = t.split("-")[0]?.trim() ?? "";
-	if (codeToken) {
-		const byCode = all.filter((s) => {
-			const m = s.dirName.match(/--([^--]+)--/);
-			const code = m ? m[1] : null;
-			const tailMatch = s.dirName.match(/--([^--]+)$/);
-			const tailCode = tailMatch && !s.dirName.includes("--", s.dirName.lastIndexOf("--") + 3) ? tailMatch[1] : null;
-			return code === codeToken || tailCode === codeToken || s.dirName === codeToken || s.dirName.includes(`--${codeToken}`);
-		});
-		if (byCode.length === 1) return join(byCode[0].path, SESSION_MD);
-		if (byCode.length > 1) return null;
-	}
-	const fuzzy = all.filter((s) => s.dirName.toLowerCase().includes(t.toLowerCase()));
-	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 文本仪表盘） */
-function summarize(root) {
-	const sessions = readAllSessions(sessionsRoot(root));
-	if (sessions.length === 0) return "AGENT_SESSIONS/ is empty.";
-	const now = Date.now();
-	const completed = sessions.filter((s) => s.status.completed).length;
-	const active = sessions.length - completed;
-	const stale = sessions.filter((s) => !s.status.completed && (now - s.mtime.getTime()) / DAY > HEALTH_STALE_DAYS).length;
-	const ghost = sessions.filter((s) => !s.status.hasSessionMd).length;
-	const recent = sessions.slice(0, 5);
-	const lines = [
-		`AGENT_SESSIONS Summary`,
-		`────────────────────────`,
-		`Total:    ${sessions.length}`,
-		`Active:   ${active}`,
-		`Completed: ${completed}`,
-		`Stale:    ${stale}`,
-		`Ghost:    ${ghost}`,
-		``,
-		`Recent activity (top 5):`,
-		...recent.map((s) => {
-			const age = Math.floor((now - s.mtime.getTime()) / DAY);
-			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");
-	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 { showSession as C, setActiveSessionInfo as S, useSession as T, qaCheck as _, DEFAULT_SESSION_SCOPE as a, sessionEvents as b, clearActiveSessionInfo as c, extractSessionMdPathFromText as d, findSession as f, parseSessionContextFromEvents as g, listSessions as h, resolveSessionTrajectoryLabel as i, closeSession as l, healthCheck as m, listBoundSessionIds as n, SESSION_ACTIONS as o, getActiveSessionInfo as p, readLastBound as r, archiveSessions as s, appendBound as t, createSession as u, readActiveSessionMd as v, summarize as w, sessionsRoot as x, resolveSessionByTitle as y };