@shgroup/dsh-serenity-hooks 1.47.3 → 1.47.4

package/lib/{message-source-aR-FJ38L.js → message-source-yuCgrbU6.js}

@@ -227,10 +227,17 @@ function showSession(root, key) {
 	const content = readFileSync(mdPath, "utf-8");
 	return `# ${session.dirName}\n\n${content}`;
 }
-/** 生成 SESSION.md 模板（对齐 osp：goal 写入目标段，时间戳 YYYY-MM-DD HH:mm） */
+/**
+* 生成 SESSION.md 模板（固定格式，owner 2026-09-25 裁决；时间戳 YYYY-MM-DD HH:mm）。
+*
+* 🔴 **状态行是被解析的机器契约**：`completed` 的判据 = SESSION.md 里出现 `[x]`（见 `parseSessionMd`）
+* ⇒ 状态行必须带标记 token：未完成 `- 状态: [ ] <label>`／已完成 `- 状态: [x] <label>`。
+* ⚠️ 改模板时**两件事必须同时成立**：① 状态行保留 `[ ]`（且全模板不得出现任何 `[x]`——否则新会话
+* 一出生就被判 completed）② 七个固定段的名字与顺序不得动（契约钉在 `tests/trajectory-ops.test.ts`）。
+*/
 function sessionMdTemplate(title, id, goal, now) {
 	const ts = localDateTimeMinutes(now);
-	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`;
+	return `# SESSION: ${title}\n- ID: ${id}\n- 状态: [ ] 进行中\n\n## 身份与边界\n${goal ?? "（待补充）"}\n\n## 权威锚点\n- （指针：仓库 / 工具 / 单一真相源位置）\n\n## 工作纪律\n- （只放本轨迹特有的；通用项外推到 skill）\n\n## 决策\n| # | 决策 | 理由 / 否决项 |\n|---|------|------|\n| 1 | | |\n\n## 日志\n- ${ts} — 创建（里程碑 ＋ 证据指针；执行细节归 commit message）\n\n## 当前状态\n- 在办：\n- 断点：\n\n## 待 owner 裁决\n- \n`;
 }
 /** create 子命令（对齐 osp createSession：--desc/--issue 二选一 + dry-run + 长度限制） */
 /** 目录名脱敏（Windows 审计问题 10）：非法字符 → '-', 去尾点/空格, 保留名（CON/NUL 等）加前缀 */
@@ -306,6 +313,39 @@ function createSession(opts) {
 const DEFAULT_SESSION_SCOPE = "default";
 /** [SESSION CONTEXT] 恢复标记（use 时注入 events 历史；进程重启后从 events 解析） */
 const SESSION_CONTEXT_MARKER = "[SESSION CONTEXT] Activated:";
+/**
+* 概括清洗（标题用；需求② S142 用户拍板：编号日期后加 ≤20 字内容概括）。
+* 规则（服务端统一，不信任 LLM 输入）：
+*   - 去控制字符/换行/回车/制表（防标题注入/多行污染）
+*   - trim（去首尾空白）
+*   - 截断 ≤20 字符（按 Unicode 码点——中英混排统一；emoji 等代理对按码点保留）
+*   - 去 `/`（防标题被误读为路径分隔）
+* @returns 清洗后的概括（空输入 → 空串；调用方决定是否允许空）
+*/
+function sanitizeSessionSummary(summary) {
+	return [...summary.replace(/[\u0000-\u001f\u007f]/g, "").replace(/\//g, "").trim()].slice(0, 20).join("");
+}
+/**
+* 从激活会话派生命名标题（v1.22.9 格式修正 + 需求② 概括）：
+* F3 原始需求是 **`S###-日期`**（如 `S143-2026-08-26`）——从 `sessionId` 派生，
+* 而非完整目录名（`2026-08-24--S142--...` 超长 + 中文，不符合用户拍板格式）。
+* 需求②（S142 用户拍板）：编号日期后加 ≤20 字内容概括 → `S###-YYYY-MM-DD-<概括>`
+* ——概括来自显式 summary 参数（服务端截断/清洗，可靠不靠猜）；编号日期仍固定派生。
+* 无 S### 编号（issue 会话等）→ 回退目录名。
+* @param active 激活会话信息（sessionId + dirName）
+* @param summary 内容概括（≤20 字，服务端清洗截断；空 → 不带概括的 `S###-日期`）
+* @returns `S143-2026-08-26-概括` / `S143-2026-08-26` / 原目录名
+*/
+function namingTitleFor(active, summary) {
+	const sid = active.sessionId;
+	if (typeof sid === "string" && /^S\d+$/.test(sid)) {
+		const date = active.dirName.match(/^(\d{4}-\d{2}-\d{2})--/)?.[1] ?? "";
+		const cleaned = summary ? sanitizeSessionSummary(summary) : "";
+		const base = date ? `${sid}-${date}` : sid;
+		return cleaned ? `${base}-${cleaned}` : base;
+	}
+	return active.dirName;
+}
 /** 内存活跃会话：scope（dsh 会话 id）→ 会话信息（不落盘；并行多会话各自 key 隔离） */
 const activeStore = /* @__PURE__ */ new Map();
 /** 全局最近活跃（对齐 osp lastActive；供无 scope 上下文使用） */
@@ -358,7 +398,8 @@ function useSession(root, key, scope = DEFAULT_SESSION_SCOPE) {
 			``,
 			`→ 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.`,
+			`  When a milestone lands or a decision is made: overwrite "当前状态" and append ONE`,
+			`  milestone line to "日志" (one line + an evidence pointer — details go to the commit message).`,
 			``,
 			`→ BEFORE responding to the user, you MUST call todowrite immediately`,
 			`  with the session todo list. The first item MUST be:`,
@@ -924,4 +965,4 @@ const ACC_MESSAGE_KIND = "plugin:dsh-serenity-hooks";
 /** ACC 注入消息的统一来源值（各缝共用；需要 `form` 时按 `ContextFormed` 另加字段）。 */
 const PLUGIN_SOURCE = { kind: ACC_MESSAGE_KIND };
 //#endregion
-export { showSession as C, localFileStamp as D, isoLocal as E, localHuman as O, setActiveSessionInfo as S, useSession as T, parseSessionContextFromEvents as _, pruneMissingBindings as a, sessionEvents as b, setBindingStore as c, clearActiveSessionInfo as d, createSession as f, listSessions as g, getActiveSessionInfo as h, listBoundSessionIds as i, localIdStamp as k, DEFAULT_SESSION_SCOPE as l, findSession as m, PLUGIN_SOURCE as n, readLastBound as o, extractSessionMdPathFromText as p, appendBound as r, resolveSessionTrajectoryLabel as s, ACC_MESSAGE_KIND as t, TRAJECTORY_ACTIONS as u, readActiveSessionMd as v, summarize as w, sessionsRoot as x, resolveSessionByTitle as y };
+export { localIdStamp as A, setActiveSessionInfo as C, isoLocal as D, useSession as E, localFileStamp as O, sessionsRoot as S, summarize as T, namingTitleFor as _, pruneMissingBindings as a, resolveSessionByTitle as b, setBindingStore as c, clearActiveSessionInfo as d, createSession as f, listSessions as g, getActiveSessionInfo as h, listBoundSessionIds as i, localHuman as k, DEFAULT_SESSION_SCOPE as l, findSession as m, PLUGIN_SOURCE as n, readLastBound as o, extractSessionMdPathFromText as p, appendBound as r, resolveSessionTrajectoryLabel as s, ACC_MESSAGE_KIND as t, TRAJECTORY_ACTIONS as u, parseSessionContextFromEvents as v, showSession as w, sessionEvents as x, readActiveSessionMd as y };

package/lib/msm-ops.d.ts

@@ -24,7 +24,9 @@ export interface MsmEntry {
     usage?: string;
     flags?: MsmFlag[];
 }
-interface MsmArgs {
+/** 🔴 2026-09-25（S142 第 1 批）：本接口**必须导出** —— `runMsm`/`runMsmAsync` 的**公开签名**引用它
+ *  （此前未导出 ⇒ 外部调用方看不到该类型，只能传结构等价字面量 = 契约不完整）。 */
+export interface MsmArgs {
     action: MsmAction;
     name?: string;
     args?: string[];

package/lib/tools/trajectory.d.ts

@@ -44,28 +44,6 @@ interface RenameOnUseDeps {
     /** sessionTitle 服务可用性 */
     sessionTitleAvailable: boolean;
 }
-/**
- * 清洗 + 截断会话概括（需求② S142 用户拍板：编号日期后加 ≤20 字内容概括）。
- * 规则（服务端统一，不信任 LLM 输入）：
- *   - 去控制字符/换行/回车/制表（防标题注入/多行污染）
- *   - trim（去首尾空白）
- *   - 截断 ≤20 字符（按 Unicode 码点——中英混排统一；emoji 等代理对按码点保留）
- *   - 去 `/`（防标题被误读为路径分隔）
- * @returns 清洗后的概括（空输入 → 空串；调用方决定是否允许空）
- */
-export declare function sanitizeSessionSummary(summary: string): string;
-/**
- * 从激活会话派生命名标题（v1.22.9 格式修正 + 需求② 概括）：
- * F3 原始需求是 **`S###-日期`**（如 `S143-2026-08-26`）——从 `sessionId` 派生，
- * 而非完整目录名（`2026-08-24--S142--...` 超长 + 中文，不符合用户拍板格式）。
- * 需求②（S142 用户拍板）：编号日期后加 ≤20 字内容概括 → `S###-YYYY-MM-DD-<概括>`
- * ——概括来自显式 summary 参数（服务端截断/清洗，可靠不靠猜）；编号日期仍固定派生。
- * 无 S### 编号（issue 会话等）→ 回退目录名。
- * @param active 激活会话信息（sessionId + dirName）
- * @param summary 内容概括（≤20 字，服务端清洗截断；空 → 不带概括的 `S###-日期`）
- * @returns `S143-2026-08-26-概括` / `S143-2026-08-26` / 原目录名
- */
-export declare function namingTitleFor(active: ActiveSessionInfo, summary?: string): string;
 /**
  * use 激活宁静号会话后，把当前 dsh 会话重命名为命名标题（`S###-日期[-概括]`）。
  * v1.27.1：**永远开启**（不再有 naming.enabled 门控）——仅 sessionTitle 服务

package/lib/trajectory-assistant.d.ts

@@ -15,8 +15,9 @@
  * L6 结算）仅在本模块注释与内部文档出现，永不浮现在提示词文本。
  *
  * 结算（settlement）挂点：D6 用户拍板——若 CCC 有标准 SESSION 复盘仪式，
- * 结算视图归 trajectory-assistant。当前 close/archive 无复盘摘要 → 机制
- * 延后，仅留 onSettlement 导出 seam（OP-1，无调用者）。
+ * 结算视图归 trajectory-assistant。当前 close/archive 无复盘摘要 ⇒ 机制延后。
+ * 🔴 2026-09-25（S142 分批清死代码·第 1 批）：原先那个 `onSettlement(cb)` **空 seam 已删**
+ * （零调用者、无触发器、空实现）——仪式真落地时按当时的信号重新设计，**不再靠空占位**。
  */
 /** 可见提示词前缀用词（跨领域自然词，D8：无游戏黑话） */
 export declare const EVENT_LABEL: {
@@ -59,10 +60,4 @@ type TrajectoryStyle = 'plain' | 'metaphor';
  * "context limit/deck check" 类，不强制替换；扩展点留给未来实验）。
  */
 export declare function styledToken(event: keyof typeof EVENT_LABEL, style?: TrajectoryStyle): string;
-/**
- * 结算 seam（OP-1/D6）：未来标准 SESSION 复盘仪式接入点。当前无调用者，
- * 仅导出契约：onSettlement(cb) 在"工作完成且被用户认可"时触发——该信号
- * 尚无可靠自动检测（D2 用户拍板记录为未解问题），实现留待仪式落地。
- */
-export declare function onSettlement(_cb: (sessionId: string) => void): void;
 export {};

package/lib/trajectory-bound.d.ts

@@ -51,8 +51,6 @@ export declare const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
  * 幂等：重复调用以后者为准（HMR / 重载场景）。
  */
 export declare function setBindingStore(store: BindingStore | null): void;
-/** 当前域句柄（诊断用；`null` = 未接线/不可用） */
-export declare function getBindingStore(): BindingStore | null;
 /**
  * §0L **一次性迁移**：把某个 CCC 的旧 `.bindings.json` 全量灌入宿主存储域。
  *
@@ -72,21 +70,6 @@ export declare function migrateBindingsToDomain(root: string): {
     skipped: number;
     failed: number;
 };
-/**
- * **按 CCC 惰性补迁移**（§0L 修正，S142 2026-09-19）。
- *
- * 🔴 为什么需要它（实测缺陷，R↓）：
- * 装载期那次迁移用的是 `process.cwd()` —— 而 dsh **服务进程的 cwd 是 `/home/yh`**，
- * **不是 CCC 根**（实测 `acc-diag`：`进程 cwd: /home/yh ｜ 进程 CCC: （无）`）。
- * ⇒ 迁移读的是一个**不存在的文件**，静默迁移 0 条
- * （症状：发布后 `~/.dsh/storages/serenity_bindings.json` **没出现**）。
- *
- * 现在改为：**任何一次能定位到 CCC 根的路径**都顺手补一次迁移（幂等 + 进程内去重）。
- * 这样无论服务从哪个 cwd 启动，只要那条 CCC 有会话活动，它的绑定就会被带上。
- *
- * @param root CCC 根
- */
-export declare function ensureBindingsMigrated(root: string): void;
 /** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
 export declare function bindingsPathFor(session: unknown): string | null;
 /**

package/lib/trajectory-ops.d.ts

@@ -14,7 +14,8 @@
 /**
  * `container_trajectory` 工具的动作集合（v1.33，S142 §32 用户裁决后的收敛结果）。
  *
- * 为什么只有 6 个（R↓）：旧面是 `logbook`（11）+ `trajectory`（12）两个工具，用户裁决
+ * 为什么收敛到这 8 个（R↓；v1.33 收敛时为 **6 个** —— 其后追加 `send-now`（09-16）
+ * 与 `cro-guide`（09-20），🔴 2026-09-25 更正计数，勿再写成"6 个"）：旧面是 `logbook`（11）+ `trajectory`（12）两个工具，用户裁决
  * 「都合并成 trajectory，废除 logbook 这个词」并逐条删并 ——
  * summary 并进 list｜health/qa 淘汰（判据＝旧模板，EAP 已取代；仅"空壳/长期无活动"并入 use）｜
  * close/archive 删（completed 由 SESSION.md 的 `[x]` 推导；归档走 container_fs mv）｜
@@ -52,7 +53,11 @@ 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 动作写入） */
+    /**
+     * 「完成」的判据 = SESSION.md 里**出现 `[x]`**（v1.33 起不再由 close 动作写入）。
+     * 🔴 这是**全文匹配**、两代格式通用：新格式的状态行 `- 状态: [x] …` 与旧格式的
+     * `## 状态` 段内 `- [x] 已完成` 都能被识别 ⇒ **不可改成锚定某一行的正则**（会让旧会话永远"未完成"）。
+     */
     completed: boolean;
 }
 interface SessionEntry {
@@ -101,6 +106,28 @@ export interface ActiveSessionInfo {
     dirName: string;
     mdPath: string;
 }
+/**
+ * 概括清洗（标题用；需求② S142 用户拍板：编号日期后加 ≤20 字内容概括）。
+ * 规则（服务端统一，不信任 LLM 输入）：
+ *   - 去控制字符/换行/回车/制表（防标题注入/多行污染）
+ *   - trim（去首尾空白）
+ *   - 截断 ≤20 字符（按 Unicode 码点——中英混排统一；emoji 等代理对按码点保留）
+ *   - 去 `/`（防标题被误读为路径分隔）
+ * @returns 清洗后的概括（空输入 → 空串；调用方决定是否允许空）
+ */
+export declare function sanitizeSessionSummary(summary: string): string;
+/**
+ * 从激活会话派生命名标题（v1.22.9 格式修正 + 需求② 概括）：
+ * F3 原始需求是 **`S###-日期`**（如 `S143-2026-08-26`）——从 `sessionId` 派生，
+ * 而非完整目录名（`2026-08-24--S142--...` 超长 + 中文，不符合用户拍板格式）。
+ * 需求②（S142 用户拍板）：编号日期后加 ≤20 字内容概括 → `S###-YYYY-MM-DD-<概括>`
+ * ——概括来自显式 summary 参数（服务端截断/清洗，可靠不靠猜）；编号日期仍固定派生。
+ * 无 S### 编号（issue 会话等）→ 回退目录名。
+ * @param active 激活会话信息（sessionId + dirName）
+ * @param summary 内容概括（≤20 字，服务端清洗截断；空 → 不带概括的 `S###-日期`）
+ * @returns `S143-2026-08-26-概括` / `S143-2026-08-26` / 原目录名
+ */
+export declare function namingTitleFor(active: ActiveSessionInfo, summary?: string): string;
 export declare function getActiveSessionInfo(scope: string): ActiveSessionInfo | null;
 export declare function getLastActiveSessionInfo(): ActiveSessionInfo | null;
 export declare function setActiveSessionInfo(scope: string, info: ActiveSessionInfo): void;

package/lib/trajectory-skills.d.ts

@@ -15,8 +15,6 @@
  */
 /** 全文注入总长上限（字符数；规格 §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）。
  *

package/lib/wake-scheduler.d.ts

@@ -54,7 +54,7 @@ interface WakeDeliveryResult {
  * C6b（P2）：字段由 {@link ClockRuntime} 提供（**工厂那份**，字段名与语义一个字未改）；
  * 此处只把 `lastTickLog` 收为**必需**（本钟独有，autopilot 没有它——现状稿 §2.4）。
  */
-export type WakeSchedulerRuntime = ClockRuntime & {
+type WakeSchedulerRuntime = ClockRuntime & {
     lastTickLog: string[];
 };
 /** 目标定位：目录名 + SESSION.md 绝对路径 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.47.3",
+  "version": "1.47.4",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1。",
   "license": "MIT",
   "repository": {

package/lib/session-cleanup-BtkSmry8.js

@@ -1,213 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { join } from "node:path";
-import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
-//#region src/session-cleanup.ts
-/**
-* session-cleanup.ts — DSH 平台旧会话自动清理（v1.29，S142 需求③）
-*
-* 背景（实证）：DSH 会话物理存储 = `$DSH_HOME/sessions/`（缺省 ~/.dsh/sessions；
-* base bundle cordis.patch.yml root: dshHomePath('sessions')）。磁盘布局：
-*   <root>/--<project-slug>--/<encoded-session-id>/session[.vN].jsonl(.zstd)
-* **世代（v1.31.13 补）**：宿主自 DSH 0.1.5 起按世代写文件，且迁移**保留源文件**
-* ⇒ 一个会话目录常见 v0 与 v3 两个文件并存。本模块用 `sessionLogArtifacts()` 统一枚举世代。
-* DSH **无删除会话 API**（PersistenceCoordinator 仅 create/append/load/inspect/borrow，
-* 无 delete/purge；workspace archiveSession 只加归档集不删文件）——物理删除只能直接
-* 删文件。删除后一致性（利好）：sessionPersistence.list() = readdir 扫描磁盘现存 →
-* 物理删后 list 不再返回；WorkspaceRegistry 下次启动重建 header index 自动消失。
-*
-* 方案（S142 用户拍板）：lastActive 基准 + 手动触发 + 不过滤不归档直接物理删；
-* 安全底线 = live 会话保护跳过（删正在运行的会话 = 灾难）。
-*
-* 本模块纯逻辑（零 ctx 依赖）：传入 sessionsRoot + liveIds，可单测。
-*/
-var session_cleanup_exports = /* @__PURE__ */ __exportAll({
-	collectEligibleSessions: () => collectEligibleSessions,
-	cutoffDaysAgo: () => cutoffDaysAgo,
-	findSessionLog: () => findSessionLog,
-	hasSessionLogById: () => hasSessionLogById,
-	performCleanup: () => performCleanup,
-	sessionLogArtifacts: () => sessionLogArtifacts,
-	sessionLogBytesById: () => sessionLogBytesById,
-	sessionsRootDir: () => sessionsRootDir
-});
-/** DSH 会话 root：env DSH_HOME → ~/.dsh（config-ops globalConfigPath 同款推导） */
-function sessionsRootDir() {
-	const dshHome = process.env.DSH_HOME ?? join(process.env.HOME ?? "", ".dsh");
-	return join(dshHome, "sessions");
-}
-/** 一天的毫秒数 */
-const DAY_MS = 864e5;
-/**
-* 扫描 sessions root，列出可清理候选：
-* - 递归 `<root>/<project>/<session-id>/session.jsonl(.zstd)`（任意深度下找 *session* 文件）
-* - 过滤 live（liveIds 集合）——安全底线
-* - 过滤 lastActive >= cutoffMs（最后活动未达阈值 → 保留）
-* root 不存在/为空 → 返回 []（非错误）。
-*/
-function collectEligibleSessions(root, cutoffMs, liveIds = /* @__PURE__ */ new Set()) {
-	if (!existsSync(root)) return [];
-	const out = [];
-	for (const project of readdirSync(root, { withFileTypes: true })) {
-		if (!project.isDirectory()) continue;
-		const projectPath = join(root, project.name);
-		for (const entry of readdirSync(projectPath, { withFileTypes: true })) {
-			if (!entry.isDirectory()) continue;
-			const dirPath = join(projectPath, entry.name);
-			const artifacts = sessionLogArtifacts(dirPath);
-			if (artifacts.length === 0) continue;
-			const log = findSessionLog(dirPath);
-			if (log === null) continue;
-			if (liveIds.has(entry.name)) continue;
-			let mtime = Number.NEGATIVE_INFINITY;
-			for (const artifact of artifacts) try {
-				mtime = Math.max(mtime, statSync(artifact.path).mtimeMs);
-			} catch {}
-			if (!Number.isFinite(mtime)) continue;
-			if (mtime >= cutoffMs) continue;
-			out.push({
-				id: entry.name,
-				project: project.name,
-				logPath: log,
-				lastActiveMs: mtime
-			});
-		}
-	}
-	return out;
-}
-/**
-* 会话日志文件名识别：`session.jsonl` / `session.jsonl.zstd`（= **v0 世代**）/
-* `session.v<N>.jsonl[.zstd]`（= 第 N 世代，DSH 0.1.5 起按世代写文件）。
-* 出处：`@deepseek-ai/dsh-session-persistence-jsonl` 的 `parseSessionFormatLogFilename` 同款形态。
-*/
-const SESSION_LOG_RE = /^session(?:\.v(\d+))?\.jsonl(\.zstd)?$/;
-/**
-* 列出会话目录下的**全部日志世代**，按代递增排序（同代内 `.jsonl` 在前、`.zstd` 在后 = 后者更代表"当前书写格式"）。
-*
-* 为什么需要（R↓，v1.31.13 修复）：宿主自 0.1.5 起改成**按世代写文件**，且迁移**保留源文件**
-* ⇒ 同一会话常见 `session.jsonl.zstd`（v0）与 `session.v3.jsonl.zstd`（v3）**并存**。
-* 旧实现只认前两个名字 → 新格式会话对本模块**完全不可见**（静默 no-op：清理永远不生效、磁盘只涨）。
-*/
-function sessionLogArtifacts(sessionDirPath) {
-	let names;
-	try {
-		names = readdirSync(sessionDirPath);
-	} catch {
-		return [];
-	}
-	const out = [];
-	for (const name of names) {
-		const m = SESSION_LOG_RE.exec(name);
-		if (m === null) continue;
-		out.push({
-			name,
-			generation: m[1] === void 0 ? 0 : Number(m[1]),
-			path: join(sessionDirPath, name)
-		});
-	}
-	return out.sort((a, b) => a.generation - b.generation || (a.name.endsWith(".zstd") ? 1 : 0) - (b.name.endsWith(".zstd") ? 1 : 0));
-}
-/**
-* 在会话目录下找 session 日志文件；无 → null。
-* 多世代并存时返回**最高世代**（= 宿主 `findLog` 选中的当前世代；旧行为对单文件目录完全一致）。
-*/
-function findSessionLog(sessionDirPath) {
-	const artifacts = sessionLogArtifacts(sessionDirPath);
-	const latest = artifacts[artifacts.length - 1];
-	return latest === void 0 ? null : latest.path;
-}
-/**
-* 执行清理（用户拍板：直接物理删，不过滤不归档；dryRun 预览不删）。
-* 删除 = rmSync 整个会话目录（recursive + force）。失败逐个记 errors 不中断。
-*/
-function performCleanup(root, cutoffMs, liveIds = /* @__PURE__ */ new Set(), opts = {}) {
-	const candidates = collectEligibleSessions(root, cutoffMs, liveIds);
-	if (opts.dryRun) return {
-		candidates,
-		result: null
-	};
-	const result = {
-		deleted: [],
-		errors: []
-	};
-	for (const c of candidates) {
-		const dir = dirOf(c.logPath);
-		try {
-			rmSync(dir, {
-				recursive: true,
-				force: true
-			});
-			result.deleted.push(c.id);
-		} catch (e) {
-			result.errors.push({
-				id: c.id,
-				reason: e.message
-			});
-		}
-	}
-	return {
-		candidates,
-		result
-	};
-}
-/** 从日志路径取会话目录（父目录） */
-function dirOf(logPath) {
-	return logPath.slice(0, logPath.lastIndexOf("/")) || logPath;
-}
-/**
-* 某一 dsh 会话（目录名 / 会话 id）的**当前世代日志体积**（字节）。
-*
-* 为什么要它（S142 §0y「旧会话累积 ⇒ dsh 内存崩溃」，所有者令）：
-*   · 宿主恢复/继续一条会话必须**重放全部事件**（`scanLog` → `materializeAppendBatch`）
-*     ⇒ **代价 ∝ 日志体积**；
-*   · 实测（`_tmp/measure-session-load.mjs`，照宿主 `scanZstdFrames` 复刻）：
-*     一条 **72.2 MB**（zstd）的日志 = 35 559 个 frame / 252.6 MB 文本 / 62 680 条事件，
-*     **光是读一遍峰值 RSS +1 175 MB**（探针什么都不保留）；
-*   · 而宿主的解析缓存 `COLD_LOG_MEMO_MAX_ENTRIES = 2` 是**按条数限、不按字节限**的
-*     （`dsh-session-persistence-jsonl/lib/index.js:2175`）⇒ 两条巨日志 = 上限内。
-* 🔴 **在本函数之前，ACC 侧没有任何地方知道"绑定的这条会话日志多大"——这个信号根本不存在。**
-* 这是"靠 agent 自觉 rebuild 不够"的机制层原因（keeper 的 K 量的是**模型上下文**，压缩后回落；
-* 而**日志文件只增不减** ⇒ rebuild 提醒永远不会因为"日志 72 MB"触发）。
-*
-* 只认会话目录（含任意世代日志）；返回**最高世代**的日志（= 宿主 `findLog` 选中的当前世代）。
-* 未命中 / 不可读 → null（非错误，调用方按"未知"处理）。
-* @param root - DSH 会话 root（{@link sessionsRootDir}）
-* @param sessionId - 会话目录名（`.bindings.json` 的键，含 `session-` 前缀）或裸 id
-* @returns 字节数 + 日志绝对路径；未命中 → null
-*/
-function sessionLogBytesById(root, sessionId) {
-	if (sessionId === "" || !existsSync(root)) return null;
-	const dirName = sessionId.startsWith("session-") ? sessionId : `session-${sessionId}`;
-	for (const project of readdirSync(root, { withFileTypes: true })) {
-		if (!project.isDirectory()) continue;
-		const log = findSessionLog(join(root, project.name, dirName));
-		if (log === null) continue;
-		try {
-			return {
-				bytes: statSync(log).size,
-				path: log
-			};
-		} catch {
-			return null;
-		}
-	}
-	return null;
-}
-/**
-* **(c) 绑定一致性兜底**的判据：某会话的日志**是否仍在磁盘上**。
-*
-* 🔴 **fail-closed**：sessions root 本身不存在时**一律返回 true（当作"在"）**——
-* 否则换 `DSH_HOME` / 换机器会让"全部绑定看起来都悬空"，进而误清整张绑定表。
-* 只有"root 在、而这个会话目录确实不在"才算悬空。
-* @param sessionRoot - DSH 会话 root（{@link sessionsRootDir}）
-* @param sessionId - 会话目录名（`.bindings.json` 的键）或裸 id
-*/
-function hasSessionLogById(sessionRoot, sessionId) {
-	if (!existsSync(sessionRoot)) return true;
-	return sessionLogBytesById(sessionRoot, sessionId) !== null;
-}
-/** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
-function cutoffDaysAgo(days, nowMs = Date.now()) {
-	return nowMs - days * DAY_MS;
-}
-//#endregion
-export { session_cleanup_exports as n, sessionsRootDir as r, hasSessionLogById as t };