@shgroup/dsh-serenity-hooks 1.47.3 → 1.48.0

package/lib/live-sessions.d.ts

@@ -15,8 +15,18 @@
  * 留下的 = **进程 cwd/CCC + live 会话清单**（`acc-diag` ① 段仍需要）。
  *
  * 判据纪律：本模块**不得**反向依赖 autopilot 判据层（那会让退场半途而废）。
+ *
+ * ── 🔴 2026-09-25 I2 收敛（约束文档 §2.7 违反清单，L1 违反之一）────────────────
+ * **本模块的 `ctx` 参数类型从 `Context` 改为 `unknown`** —— 消除本文件唯一的 `W2` 接触
+ * （直接 import 宿主 `cordis` 的类型）。
+ *
+ * **为什么这是"真解耦"而不是"把类型藏起来"（判据）：** `ctx` 在本模块**从不被解引用** ——
+ * 它只被**原样透传**给 `hostSessions(ctx)`，而后者（`host/access.ts`，**L0**）的参数
+ * 本就声明为 `ctx: unknown` ⇒ `Context` 这个 import **在语义上是多余的**，
+ * 它没有参与任何类型检查，只贡献了一处 L1→宿主 的接触点。
+ * 🔵 **证据**：grep 本文件 `ctx` 全部 5 处命中 —— 3 处在参数/调用位、2 处在注释，
+ * **零处**属性访问（`ctx.xxx`）。
  */
-import type { Context } from 'cordis';
 /** live 会话条目（诊断用；标题从 events 读） */
 export interface LiveSessionEntry {
     id: string;
@@ -36,10 +46,10 @@ export declare function readSessionTitle(session: unknown): string | null;
  * CCC 枚举（"本机有哪些 CCC"）**不在这里**，归 `ccc-roots.listCccs`（并集语义）；
  * 本函数保留的是它**独有**的那部分：会话维度 + cwd 归属 + 标题 + id。
  *
- * @param ctx 插件上下文
+ * @param ctx 插件上下文（**只透传**给 L0 取数口，本模块不解引用 ⇒ 类型为 `unknown`）
  * @returns 逐条 live 会话
  */
-export declare function listLiveSessions(ctx: Context): LiveSessionEntry[];
+export declare function listLiveSessions(ctx: unknown): LiveSessionEntry[];
 /**
  * 进程内诊断（`acc-diag` ① 段数据源）——输出当前实例的进程归属 + live 会话清单。
  *
@@ -51,4 +61,4 @@ export interface DiagLiveReport {
     processCcc: string | null;
     liveSessions: LiveSessionEntry[];
 }
-export declare function diagLive(ctx: Context): DiagLiveReport;
+export declare function diagLive(ctx: unknown): DiagLiveReport;

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

@@ -1,4 +1,4 @@
-import { r as cccRootForCwd } from "./ccc-roots-NpTWo0-c.js";
+import { r as cccRootForCwd } from "./ccc-roots-Duk89a-h.js";
 import { basename, dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 //#region src/time.ts
@@ -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/opencode-provider.d.ts

@@ -16,6 +16,19 @@
  * - **L2 建路由**：环境里有 `OPENCODE_API_KEY` 且没有任何 opencode 路由 → 建 `opencode-go` 并带全头。
  *   “有 key”就是用户意图的最强证据 → 不需要的人（没 key）零影响（不会平白多出一组模型）。
  *
+ * ## L3 补模型（v1.48.0；S142 owner 具名令「做成自动吧」）
+ *
+ * pi-ai 目录**收录不全**（如 `deepseek-v4.1-flash` 已在官方端点表、目录里却没有）⇒
+ * 面板不显示；手加也不带推理（目录外模型 `base` 为 undefined ⇒ `reasoning` 恒 false，
+ * 见 {@link OPENCODE_EXTRA_MODELS} 的注释）⇒ **"能用但没 thinking"**。
+ * 本层把 {@link OPENCODE_EXTRA_MODELS} 里的模型补进该路由的 `models` 列表。
+ *
+ * 🔴 **三条拒绝条件**（每条都对应一个会把配置弄坏的真实形态，宁可不动）：
+ *   ① 路由**没有显式 `models` 列表** —— 补 `models` 会顶掉整个 pi-ai 目录（宿主是"整体替换"语义）
+ *   ② 列表里含**已知异协议**模型 —— 设路由级 `api` 会覆盖它们的 `base.api`
+ *   ③ 路由已显式设了**别的 `api`** —— 同上，且那是用户的显式选择
+ * 判据与来源见 `planExtraModels` / `OPENCODE_GO_NON_COMPLETIONS`。
+ *
  * ## 注入通道（唯一可用且是官方的）
  *
  * `ctx.settings.update('llm-pi-ai', patch)` —— `dsh-settings` 的官方写入面：
@@ -68,6 +81,37 @@ export declare const OPENCODE_API_KEY_ENV = "OPENCODE_API_KEY";
  * 头名大小写不敏感是 HTTP 语义，但**名字不同就是两个头**，故都要。
  */
 export declare function opencodeRouteHeaders(): Record<string, string>;
+/**
+ * 一个「pi-ai 目录尚未收录、但我们已知怎么配」的 opencode-go 模型。
+ *
+ * 🔴 **为什么必须有 `reasoningEfforts`**：`dsh-llm-pi-ai` 的 `resolveModelReasoning` 是
+ * `if (efforts === void 0) return { reasoning: base?.reasoning ?? false }` ——
+ * **目录里没有的模型 `base` 为 undefined ⇒ 一律判成非推理模型**（"能用但没 thinking"的唯一成因）。
+ * 已收录的兄弟模型（如 `deepseek-v4-flash`）从目录的 `base` 拿到 `reasoning`/`thinkingLevelMap`，
+ * 故本表**只需收录目录没有的那些**。
+ */
+export interface OpencodeExtraModel {
+    readonly name: string;
+    /** 该模型说的 wire 协议；见 {@link OPENCODE_GO_NON_COMPLETIONS} 的安全闸 */
+    readonly api: string;
+    readonly contextWindow: number;
+    readonly maxTokens: number;
+    readonly input: readonly string[];
+    /** pi-ai 推理档 → wire 取值（除 `off` 外都必须非空；空值会被宿主 `invalid` 拒绝） */
+    readonly reasoningEfforts: Readonly<Record<string, string>>;
+    /** 该模型族的 compat（推理 wire 格式在这里；值取自目录里同族兄弟模型） */
+    readonly compat: Readonly<Record<string, unknown>>;
+}
+/**
+ * 目录补丁表（**唯一真相源 = pi-ai 的 `dist/providers/data/opencode-go.json`**）。
+ *
+ * 录取判据：① 官方文档 <https://opencode.ai/docs/zh-cn/go/> 的端点表列了它；
+ * ② pi-ai 目录里**没有**它 ⇒ 面板不显示、手加也没 thinking。
+ *
+ * `deepseek-v4.1-flash` 的各字段**逐字取自目录里 `deepseek-v4-flash`**（同族兄弟，
+ * 同 `chat/completions` 端点 + 同 `thinkingFormat: deepseek`）——不自行发明规格。
+ */
+export declare const OPENCODE_EXTRA_MODELS: Readonly<Record<string, OpencodeExtraModel>>;
 interface OpencodeAutoConfigInput {
     /** `llm-pi-ai` 命名空间**解析后**的值（0.1.7 读面 `settings.describe()` 里按 `ns` 挑出的 `value`；undefined = 命名空间未注册） */
     resolved: unknown;
@@ -86,6 +130,15 @@ type OpencodeAutoConfigAction = {
     kind: 'skip-route';
     route: string;
     reason: 'headers-complete';
+} | {
+    kind: 'add-models';
+    route: string;
+    ids: readonly string[];
+    api: string | null;
+} | {
+    kind: 'skip-models';
+    route: string;
+    reason: 'catalog-served' | 'mixed-protocol' | 'api-conflict';
 } | {
     kind: 'idle';
     reason: 'namespace-unregistered' | 'no-route';

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

@@ -23,7 +23,6 @@
  * CRO 阶段另有**独立**总闸 `croEnabled`（只停 CRO，**不影响**本注册表投递）｜
  * 补跑窗口 2h（超窗置 missed 留痕）｜同 tick 串行｜唤起后维持 live（人类可介入）。
  */
-import type { Context } from 'cordis';
 import { type ClockRuntime } from './clock-runtime.js';
 import { type WakeEntry } from './wake-registry.js';
 /** 投递结果（写回条目的 lastResult；人读） */
@@ -54,7 +53,7 @@ interface WakeDeliveryResult {
  * C6b（P2）：字段由 {@link ClockRuntime} 提供（**工厂那份**，字段名与语义一个字未改）；
  * 此处只把 `lastTickLog` 收为**必需**（本钟独有，autopilot 没有它——现状稿 §2.4）。
  */
-export type WakeSchedulerRuntime = ClockRuntime & {
+type WakeSchedulerRuntime = ClockRuntime & {
     lastTickLog: string[];
 };
 /** 目标定位：目录名 + SESSION.md 绝对路径 */
@@ -86,7 +85,7 @@ export declare function buildWakeText(entry: WakeEntry, target: WakeTarget): str
  * @param entry 唤醒条目
  * @returns 投递结果（写回 lastResult）
  */
-export declare function deliverWake(ctx: Context, root: string, entry: WakeEntry): Promise<WakeDeliveryResult>;
+export declare function deliverWake(ctx: unknown, root: string, entry: WakeEntry): Promise<WakeDeliveryResult>;
 /**
  * 即时消息正文（**刻意不复用** {@link buildWakeText}）：唤醒文本以「**到点**（登记于…）」开头，
  * 对即时投递那是**错的事实**。本函数显式区分"这是即时消息、不是到点唤醒"。
@@ -138,7 +137,7 @@ export declare function buildSendText(target: WakeTarget, message: string, sende
  * @param sender 发起者轨迹标识
  * @returns 投递结果（**同步**返回给调用方）
  */
-export declare function sendToTrajectory(ctx: Context, root: string, target: string, message: string, sender: string): Promise<WakeDeliveryResult>;
+export declare function sendToTrajectory(ctx: unknown, root: string, target: string, message: string, sender: string): Promise<WakeDeliveryResult>;
 /**
  * CRO 唤起消息正文（**刻意不复用** {@link buildWakeText} / {@link buildSendText}）。
  *
@@ -163,5 +162,5 @@ export declare function buildCroWakeText(dirName: string, mdPath: string, prompt
  * 会话出现/settings 变化时热启动（与 autopilot 同款触发面，互不干扰）。
  * @param ctx 插件上下文
  */
-export declare function registerWakeScheduler(ctx: Context): void;
+export declare function registerWakeScheduler(ctx: unknown): void;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.47.3",
+  "version": "1.48.0",
   "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 };