@shgroup/dsh-serenity-hooks 1.70.0 → 1.72.0

package/lib/{weixin-route-D_DvgPqy.js → route-f7JlinIt.js}

@@ -1,11 +1,11 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-C33QWoWZ.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-Dkoa2oW3.js";
 import { join, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
-//#region src/localstore-ops.ts
+//#region src/tools/localstore/service.ts
 /**
-* localstore-ops.ts — localstore 纯逻辑层（零 DSH 依赖，可独立单测）
+* tools/localstore/service.ts — localstore 纯逻辑层（零 DSH 依赖，可独立单测）
 *
 * S134 重设计（v1.16.7）：存储从 ~/.serenity/ 迁到 **CCC 根根目录 localstore.json**
 * （JSON 格式——方便 MSM 直接 read + JSON.parse 读取，零解析依赖）。
@@ -281,9 +281,9 @@ function runLocalStore(root, args) {
 	}
 }
 //#endregion
-//#region src/weixin-route.ts
+//#region src/im/route.ts
 /**
-* weixin-route.ts — 微信桥 CCC 配置层纯逻辑（F4c-3，v1.27.0 实验性）
+* im/route.ts — 微信桥 CCC 配置层纯逻辑（F4c-3，v1.27.0 实验性）
 *
 * 职责（零 DSH 依赖，可独立单测）：
 * - 读取 CCC 的 weixin 配置（.opencode/serenity.json weixin 段——结构/路由/开关）
@@ -295,13 +295,14 @@ function runLocalStore(root, args) {
 * 配置归属（S142 用户拍板）：**CCC 级**——serenity.json 结构 + localstore 凭据分离；
 * 不绑定具体 role（用户自选路由目标）。
 */
-var weixin_route_exports = /* @__PURE__ */ __exportAll({
+var route_exports = /* @__PURE__ */ __exportAll({
 	clearWeixinCredential: () => clearWeixinCredential,
 	extractWeixinMedia: () => extractWeixinMedia,
 	extractWeixinText: () => extractWeixinText,
 	hasVoiceItem: () => hasVoiceItem,
 	matchWeixinRoute: () => matchWeixinRoute,
 	nextWeixinAccountId: () => nextWeixinAccountId,
+	readImSettings: () => readImSettings,
 	readWeixinCredential: () => readWeixinCredential,
 	readWeixinSettings: () => readWeixinSettings,
 	removeWeixinAccount: () => removeWeixinAccount,
@@ -310,7 +311,7 @@ var weixin_route_exports = /* @__PURE__ */ __exportAll({
 	setWeixinEnabled: () => setWeixinEnabled,
 	upsertWeixinAccount: () => upsertWeixinAccount,
 	weixinInboundDir: () => weixinInboundDir,
-	weixinSessionIdFor: () => weixinSessionIdFor,
+	weixinSessionIdForTrajectory: () => weixinSessionIdForTrajectory,
 	writeWeixinCredential: () => writeWeixinCredential
 });
 /** localstore 凭据键前缀（**credential scope**——token 是凭据，走 UPPER_SNAKE 键；
@@ -320,51 +321,135 @@ const LS_PREFIX = "WEIXIN_";
 function accountKeyPart(accountId) {
 	return accountId.toUpperCase().replace(/[^A-Z0-9]+/g, "_");
 }
-/** 微信桥 skiff 会话 id 前缀（seams 旁路判定；对外面纯净——守卫识别外部面） */
+/**
+* 微信桥 skiff 会话 id 前缀（守卫识别"外部面"用）。
+*
+* ⚠️ **2026-10-19 起它只是命名习惯，不再是判据** —— skiff 的身份是**轨迹**，
+* 判据 = 「绑定的轨迹有 `skiff.json`」（`role/skiff/profile.ts` 的 `isSkiffSession`）。
+* 保留前缀只为：① 日志/会话列表里一眼认出这是外部面；② 存量会话目录名不变。
+*/
 const WEIXIN_SESSION_PREFIX = "skiff-weixin-";
-/** 微信用户 → 固定会话 id（同用户长期同一会话，记忆延续；多用户天然隔离）。
-*  **v1.27.2 错位一位（用户拍板）**：`.slice(0, 16)` → `.slice(1, 17)`——旧规则生成的
-*  固定 id 已与磁盘损坏的持久化 log 绑定（dsh 不可硬删，create 同 id 必撞）→
-*  新规则下同用户生成**全新 id**，避开损坏 log；固定可重建语义不变（同用户恒同 id）。 */
-function weixinSessionIdFor(fromUserId) {
-	const digest = createHash("sha256").update(fromUserId).digest("hex").slice(1, 17);
-	return `${WEIXIN_SESSION_PREFIX}${digest}`;
+/**
+* **轨迹编码 → 固定的 dsh 会话 id**（2026-10-19 重做：身份挂在轨迹上，不挂在用户上）。
+*
+* ## 为什么改（owner 重做令的实际含义）
+*
+* 旧派生 = `skiff-weixin-<sha256(微信用户 id)>`：**同一条轨迹换一个用户就是另一条会话**，
+* 而**同一个用户换一条轨迹也还是原来那条会话**（后者的症状：改路由之后，新轨迹的约束
+* 对不上旧会话的历史工具清单）。⇒ 那不是"轨迹是一等公民"，那是"用户是一等公民"。
+*
+* 新派生 = **由轨迹编码决定**：同一条轨迹 ⇒ 恒同一条 dsh 会话（无论谁在跟它说话）；
+* 换轨迹 ⇒ 新会话。这正是"skiff 是认知轨迹的一种"。
+*
+* ## 连带删掉的东西
+*
+* 旧实现有 `.weixin-session-gen.json` 换代计数器（`baseId-g<n>`），存在的唯一理由是
+* "身份绑在用户上、载体（SESSION.md）可能先被归档" ⇒ 只能靠换代续命。
+* 现在**身份就是轨迹**：轨迹没了就该报"目标不存在"（响亮），**不该静默续命**
+* ⇒ 计数器整件删除。
+*
+* ⚠️ 会话 id 里保留 `skiff-weixin-` 前缀只为可读性；**它不含用户身份**，
+* 因此也不会泄漏"谁在跟它说话"（旧形态的哈希虽是伪名，但它是**可复算的稳定标识**，
+* 见 `privacy-scan` 的 `weixin-session-pseudonym` 规则 —— 新形态连这个问题都没有了）。
+*/
+function weixinSessionIdForTrajectory(code) {
+	return `${WEIXIN_SESSION_PREFIX}${code}`;
 }
 /**
-* 读取 CCC 微信桥配置（未配置/未启用 → 归一默认）。
-* @returns 归一化 WeixinSettings（accounts/routes 数组清洗；空段 → 空数组）
+* 路由行的**目标编码**（过渡别名解析，单一处）。
+*
+* 🔴 2026-10-19：目标从「角色名」改为**认知轨迹编码**。存量 CCC 的配置里写的是
+* `{user, role}` —— **不强制同批迁移**（配置是 CCC 的数据，改它不该要求同步发版）。
+* ⇒ 读侧接受三种写法，按确定性顺序：`trajectory`（新）→ `role`（旧值，语义已等同编码）
+* → 空（该行作废，由调用方按"未命中"处理）。
 */
-function readWeixinSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+function routeTarget(row) {
+	for (const v of [row.trajectory, row.role]) if (typeof v === "string" && v.trim() !== "") return v.trim();
+	return "";
+}
+/**
+* **统一 IM 配置的单一读取入口**（2026-10-19 owner 定向：微信与飞书只是账号实现不同，
+* 整合到统一配置）。
+*
+* 读取顺序（**确定性，只有这一处**）：
+*   ① `im` 段 —— 但**判据是 `accounts` 是数组**，不是"段存在"（见下 🔴）
+*   ② 旧 `weixin` 段 —— 存量 CCC 零迁移
+*   ③ 都没有 ⇒ 归一默认（`enabled:false`、空数组）
+*
+* 🔴 **为什么判据是「`accounts` 是数组」**：本 CCC 的配置里**曾经**有过一个 `im` 段
+* （退役的 ACP 形态：`{channel:"acp", acp:{enabled, accounts:[…]}}`）。若只判"段存在"，
+* 那份残留会被当成新配置读 ⇒ 得到一个没有 `accounts` 数组 ／ 或 `accounts` 形状完全不同的对象
+* ⇒ 表现为**"配置没生效"且不报错**。⇒ 用可判别的形状把它排除掉（退役残留继续被静默忽略，
+* 与 v1.59.0 的裁决一致）。
+*
+* ⚠️ 本函数**只做归一**，不判断"这个通道实现有没有"——那是装配处的事
+* （`syncMachinePollers` 里有"未实现的 channel 出声但不静默跳过"）。
+*/
+function readImSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	const empty = () => ({
+		enabled: false,
+		accounts: [],
+		routes: []
+	});
 	try {
-		const w = loadSerenityConfig(root, paths).weixin;
-		if (!w || typeof w !== "object") return {
-			enabled: false,
-			accounts: [],
-			routes: []
-		};
-		return {
-			enabled: w.enabled === true,
-			botType: typeof w.botType === "string" && w.botType !== "" ? w.botType : void 0,
-			hook: typeof w.hook === "string" && w.hook.trim() !== "" ? w.hook.trim() : void 0,
-			autoReplyWithLastMessage: w.autoReplyWithLastMessage !== false,
-			fallbackOnNoSend: w.fallbackOnNoSend === true,
-			accounts: Array.isArray(w.accounts) ? w.accounts.filter((a) => typeof a === "object" && a !== null && typeof a.accountId === "string" && a.accountId !== "").map((a) => ({
-				accountId: a.accountId,
-				name: typeof a.name === "string" ? a.name : void 0,
-				enabled: a.enabled !== false
-			})) : [],
-			routes: Array.isArray(w.routes) ? w.routes.filter((r) => typeof r === "object" && r !== null && typeof r.user === "string" && r.user !== "" && typeof r.role === "string" && r.role !== "") : [],
-			aliases: readAliases(w)
-		};
+		const cfg = loadSerenityConfig(root, paths);
+		const unified = cfg.im;
+		if (isUnifiedImSection(unified)) return normalizeImSection(unified, empty());
+		const legacy = cfg.weixin;
+		if (!legacy || typeof legacy !== "object") return empty();
+		return normalizeImSection(legacy, empty());
 	} catch {
-		return {
-			enabled: false,
-			accounts: [],
-			routes: []
-		};
+		return empty();
 	}
 }
 /**
+* 判别一个 `im` 段是不是**新的统一形态**。
+*
+* 判据 = `accounts` 是数组 **且** 每行（若有）不带退役 ACP 的 `accountId` 之外的 ACP 形状；
+* 退役 ACP 形态的特征是顶层有 `channel:"acp"` 或 `acp` 对象。
+* ⇒ 两者**任一命中**即判为"退役残留"，不认。
+*/
+function isUnifiedImSection(v) {
+	if (!v || typeof v !== "object" || Array.isArray(v)) return false;
+	const obj = v;
+	if (obj.acp !== void 0 && (typeof obj.acp === "object" || typeof obj.acp === "string")) return false;
+	if (obj.channel === "acp") return false;
+	return Array.isArray(obj.accounts);
+}
+/** 段 → 归一形态（统一段与旧段**共用同一套归一语义**，避免两条读法各漂） */
+function normalizeImSection(w, d) {
+	const src = w;
+	const accountsIn = Array.isArray(src.accounts) ? src.accounts : [];
+	return {
+		enabled: src.enabled === true,
+		botType: typeof src.botType === "string" && src.botType !== "" ? src.botType : void 0,
+		hook: typeof src.hook === "string" && src.hook.trim() !== "" ? src.hook.trim() : void 0,
+		autoReplyWithLastMessage: src.autoReplyWithLastMessage !== false,
+		fallbackOnNoSend: src.fallbackOnNoSend === true,
+		accounts: accountsIn.filter((a) => typeof a === "object" && a !== null && typeof a.accountId === "string" && a.accountId !== "").map((a) => ({
+			accountId: a.accountId,
+			channel: typeof a.channel === "string" && a.channel.trim() !== "" ? a.channel.trim() : "weixin",
+			name: typeof a.name === "string" ? a.name : void 0,
+			enabled: a.enabled !== false
+		})),
+		routes: Array.isArray(src.routes) ? src.routes.filter((r) => typeof r === "object" && r !== null && typeof r.user === "string" && r.user !== "" && typeof routeTarget(r) === "string").map((r) => ({
+			user: r.user,
+			trajectory: routeTarget(r)
+		})) : [],
+		aliases: readAliases(src)
+	};
+}
+/**
+* 读取 CCC 微信桥配置（未配置/未启用 → 归一默认）。
+*
+* ⚠️ 2026-10-19 起它是 {@link readImSettings} 的**薄别名**（签名与返回形状不变）：
+* 旧调用点无需改动，但**配置来源已经统一**——`im` 段优先、`weixin` 段回退。
+* 保留名字是为了让既有调用点与测试**逐字不动**（P1 是纯重构，读数必须不变）。
+*/
+function readWeixinSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	return readImSettings(root, paths);
+}
+/**
 * 别名表清洗（v1.56.10）：键归一为小写、值必须是非空字符串；非法项静默丢弃。
 * 空/缺省 → `{}`（此时别名解析不可用，只能用裸 iLink 用户 id）。
 */
@@ -409,12 +494,12 @@ function clearWeixinCredential(root, accountId) {
 }
 /**
 * 路由匹配：exact user 优先，通配 `*` 兜底。
-* @returns 命中的 role 名；未命中 → null（无路由 → 消息不回复/忽略）
+* @returns 命中的**轨迹编码**；未命中 → null（无路由 → 消息不回复/忽略）
 */
 function matchWeixinRoute(routes, fromUserId) {
 	if (!Array.isArray(routes) || routes.length === 0) return null;
-	for (const r of routes) if (r.user === fromUserId) return r.role;
-	for (const r of routes) if (r.user === "*") return r.role;
+	for (const r of routes) if (r.user === fromUserId) return r.trajectory;
+	for (const r of routes) if (r.user === "*") return r.trajectory;
 	return null;
 }
 /**
@@ -555,4 +640,4 @@ function setWeixinEnabled(root, enabled) {
 	return next;
 }
 //#endregion
-export { readWeixinCredential as a, weixinInboundDir as c, LOCALSTORE_SCOPES as d, checkLocalstoreGitCompliance as f, runLocalStore as g, readStore as h, matchWeixinRoute as i, weixinSessionIdFor as l, readGitTrack as m, extractWeixinText as n, readWeixinSettings as o, localstorePath as p, hasVoiceItem as r, sanitizeFileName as s, extractWeixinMedia as t, weixin_route_exports as u };
+export { readWeixinCredential as a, sanitizeFileName as c, LOCALSTORE_SCOPES as d, checkLocalstoreGitCompliance as f, runLocalStore as g, readStore as h, matchWeixinRoute as i, weixinInboundDir as l, readGitTrack as m, extractWeixinText as n, readWeixinSettings as o, localstorePath as p, hasVoiceItem as r, route_exports as s, extractWeixinMedia as t, weixinSessionIdForTrajectory as u };

package/lib/seams/context.d.ts

@@ -29,13 +29,13 @@ export declare function accMessage(root: string, configPaths: string[], entrySki
  * - cheap-worker 杂工：sessionId 固定 `cheap-worker-` 前缀（tools/cheap-worker.ts 生成）
  * 三者都不恢复（避免把主会话激活注入子上下文，违背 v1.16.2 scope 隔离）。
  */
-export declare function shouldAutoRestore(agent: Agent): boolean;
+export declare function shouldAutoRestore(agent: Agent, root?: string | null): boolean;
 /**
  * 恢复触发判定（S134 泄漏修复 v1.16.13）：根会话 **且已有对话历史**（续跑/恢复的会话）
- * 才自动恢复上次激活的宁静号会话——全新会话（新任务，如 apaas-26116）无历史 → 不恢复，
+ * 才自动恢复上次激活的宁静号会话——全新会话（新任务）无历史 → 不恢复，
  * 避免把过去的 SESSION 上下文注入新任务（跨任务污染）。
  */
-export declare function shouldRestoreActive(agent: Agent): boolean;
+export declare function shouldRestoreActive(agent: Agent, root?: string | null): boolean;
 interface ContextRegistration {
     configPaths?: string[];
     /** session-start 播种 */

package/lib/seams/guards.d.ts

@@ -8,7 +8,8 @@
  */
 import type { Context } from 'cordis';
 import type { Agent } from '@deepseek-ai/dsh-agent';
-import { type BlacklistRule } from '../ccc.js';
+import { type BlacklistRule } from '../kernel/ccc.js';
+import { type SkiffProfile } from '../role/skiff/profile.js';
 export interface GuardInput {
     root: string;
     toolName: string;
@@ -18,8 +19,14 @@ export interface GuardInput {
     pathArg?: string;
     /** container_fs 等复合工具的子命令 action（只读子命令不查黑名单） */
     action?: string;
-    /** 当前 agent 的 dsh 会话 id（Skiff 角色白名单判定；非 skiff 会话不判定） */
-    skiffSessionId?: string;
+    /**
+     * 该会话的 skiff 约束面（`null`/`undefined` = 不是 skiff 会话 ⇒ 不判定）。
+     *
+     * 🔴 2026-10-19 起传**已解析好的约束面**，不传 sessionId：解判据（"这条轨迹有没有
+     * `skiff.json`"）留在唯一入口 `profile.ts`，守卫只消费结果 ⇒ 纯函数里不再做 IO，
+     * 也不可能出现"守卫的判据与 schema 收窄的判据不一致"。
+     */
+    skiffProfile?: SkiffProfile | null;
 }
 interface GuardDecisionResult {
     deny?: string;
@@ -101,26 +108,25 @@ export declare function getSkiffRoleVisibilityDiagnostics(): {
     denyByKey: Record<string, string[]>;
 };
 /**
- * 同步 **Skiff 会话的工具面**：把角色白名单之外的工具**从 schema 移除**（不是"看得到但被拒"）。
+ * 同步 **skiff 会话的工具面**：把白名单之外的工具**从 schema 移除**（不是"看得到但被拒"）。
  *
  * ## 为什么必须有这条（owner 2026-10-19：「工具清单也要热加载」）
  *
- * 在它之前，skiff 角色白名单**只由运行时守卫拦截**（`decideGuard` 的 skiff 分支）：
- * 工具全部出现在模型 schema 里，调用时才被 `tool not allowed in this skiff role` 打回。
- * ⇒ 两个真实后果：
+ * 在它之前，skiff 白名单**只由运行时守卫拦截**（`decideGuard` 的 skiff 分支）：
+ * 工具全部出现在模型 schema 里，调用时才被打回。⇒ 两个真实后果：
  *  ① **模型看得见它不该有的工具** —— 它会去试，试了才撞墙（一轮白烧，且错误文案泛化，
  *     看不出"是不在清单里"还是"临时性拒绝"）；
- *  ② **配置变动在 schema 上永远不生效** —— 改 `skiff.roles.<r>.tools` 只影响"调用是否放行"，
- *     不影响"模型看得见什么"。这正是 owner 报的"工具清单不热加载"。
+ *  ② **配置变动在 schema 上永远不生效** —— 改 `skiff.json` 的 `tools` 只影响"调用是否放行"。
  *
  * ## 判据与降级
  *
- * - deny 集合 = **`REGISTERED_TOOLS` − 角色白名单**（只对**我们自己注册的**工具算，
+ * - deny 集合 = **`REGISTERED_TOOLS` − 白名单**（只对**我们自己注册的**工具算，
  *   不去动宿主的工具 —— 宿主的工具由各自的条件同步管）。
  * - ⚠️ **未注册的名字会让整次 restrict 失败**（宿主契约逐字 "unknown names … fail"），
  *   而 `diagram` 是按开关注册的 ⇒ 与 `hideAllFor` 同款**两档尝试**（先全覆盖，失败退常驻段）。
- * - 读不到角色（配置删了/角色被移除）⇒ **不动**（fail-open）：此时守卫仍会拦，
- *   最坏是"又变成看得见但调不动"，而不是把工具全删光。
+ * - 读不到约束面（不是 skiff / 配置删了）⇒ **撤销既有隐藏**（回到"无约束"）：
+ *   ⛔ 不能只是 `return` —— 那会把上一步的隐藏**永久留在**一个已不再是 skiff 的会话上
+ *   （这正是 owner 说的"删掉 `skiff.json` 就该立刻恢复"）。
  * - 幂等：算出来的 deny 签名不变就跳过（不每步重建 schema）。
  *
  * @param agent 目标会话

package/lib/seams/keeper.d.ts

@@ -48,7 +48,7 @@ export declare function reminderText(code: string): string;
  *   使用者若要查看当前占用/阈值：看面板（`rebuildThresholdK` 滑块 + 状态显示）——那是给人看的。
  *
  * v1.31.1 交接协议（S142 用户需求"要求 LLM 将当前手头事项写在 SESSION.md 尾部，并要求
- * rebuild 后去读并处理"）：**写侧** = 这里；**读侧** = rebuild 锚点（rebuild.ts）。
+ * rebuild 后去读并处理"）：**写侧** = 这里；**读侧** = rebuild 锚点（trajectory/rebuild.ts）。
  * 两侧共用 cognitive-trajectory-assistant 的常量（单一真相源）。
  *
  * 🔴 **v1.49.0（owner 2026-09-26 裁决："砍掉 in-flight，这正是目的"）**：写侧**不再**指向

package/lib/seams/system-prompt.d.ts

@@ -109,7 +109,9 @@ export declare function sessionBlock(root: string, scope?: string): string;
  * Principles 剥离 MSM 原则段（指令遵循约束）——用户文本承接两处风格；本体论/关系段/
  * 操作边界（安全硬约束）永远保留。未配置 → 与 v1.23.0 逐字节一致（零影响）。
  */
-export declare function serenitySystemPrompt(root: string, scope?: string): string;
+export declare function serenitySystemPrompt(root: string, scope?: string, 
+/** 活跃轨迹目录名（给了才有第 ⑧ 段；未绑定轨迹 ⇒ undefined，不注入） */
+dirName?: string): string;
 /**
  * Code Mode 适配行：当前 scope 以 Code Mode 呈现工具时（run_code 可见），
  * ACC 块按 native 语义指引"直接调用工具"会与"只有 run_code 可直接调用"的执行