@shgroup/dsh-serenity-hooks 1.34.0 → 1.34.2

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

@@ -25,11 +25,6 @@
  */
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Context } from 'cordis';
-/** 读取 persona 彩蛋配置（plugin 全局；未配置 → mode='' 彩蛋关闭） */
-export declare function readPersonaSettings(): {
-    mode: string;
-    overrideText: string;
-};
 /** 1) 身份块：ACC 身份 + CCC 名 + 平台工具说明（需求③ S142：工具清单移出为独立 toolsBlock 放装配末尾——身份先行、工具参考殿后） */
 export declare function identityBlock(root: string): string;
 /**
@@ -130,3 +125,4 @@ export declare function codeModeAdaptationLine(ctx: Context, scope?: unknown): s
  */
 export declare function registerEntrySkillSectionGlobal(ctx: Context): void;
 export declare function registerEntrySkillSection(agent: Agent, root: string): boolean;
+export declare function registerTrajectorySkillSection(agent: Agent, root: string): boolean;

package/lib/session-cleanup.d.ts

@@ -19,7 +19,7 @@
 /** DSH 会话 root：env DSH_HOME → ~/.dsh（config-ops globalConfigPath 同款推导） */
 export declare function sessionsRootDir(): string;
 /** 一个候选会话（删除前预览信息） */
-export interface CandidateSession {
+interface CandidateSession {
     /** 会话 id（目录名） */
     id: string;
     /** 项目目录（父目录名，如 --home-yh-home-home-serenity--） */
@@ -55,7 +55,7 @@ export declare function sessionLogArtifacts(sessionDirPath: string): Array<{
  */
 export declare function findSessionLog(sessionDirPath: string): string | null;
 /** 删除执行结果 */
-export interface CleanupResult {
+interface CleanupResult {
     deleted: string[];
     /** 尝试删除但失败的会话目录（权限/竞态） */
     errors: Array<{
@@ -75,3 +75,4 @@ export declare function performCleanup(root: string, cutoffMs: number, liveIds?:
 };
 /** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
 export declare function cutoffDaysAgo(days: number, nowMs?: number): number;
+export {};

package/lib/{settings-section-BuPGQv_H.js → settings-section-DTYZjwUs.js}

@@ -1,14 +1,70 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as hostSettings } from "./access-fiehjxV6.js";
 import z from "@deepseek-ai/schemastery";
+//#region src/ports.ts
+/**
+* 集中端口表。
+* A=宿主主面（插件不监听）/ B=网关（可配，默认关）/ C=微信发送（默认开，仅 loopback）
+* / D=Skiff 调试（默认关）/ E=ACP+问答（默认关）。
+*/
+const FACE_PORTS = {
+	main: {
+		port: 3080,
+		host: null,
+		defaultEnabled: true,
+		meaning: "宿主 DSH 主 WebUI + 插件 /serenity/* 路由面（**插件不起此 listener**，端口自宿主读）"
+	},
+	gateway: {
+		port: 3081,
+		host: "0.0.0.0",
+		defaultEnabled: false,
+		meaning: "双端口网关（外部登录 + 全量反代宿主主面；host/port 走 plugin 全局配置）"
+	},
+	weixinSend: {
+		port: 3082,
+		host: "127.0.0.1",
+		defaultEnabled: true,
+		meaning: "微信主动发送面（容器外进程 → POST /send；与 3080 显式解耦，不经网关）"
+	},
+	skiffDebug: {
+		port: 3099,
+		host: "127.0.0.1",
+		defaultEnabled: false,
+		meaning: "Skiff 调试问答面（人工调试子角色；无认证，仅靠 loopback）"
+	},
+	acpHttp: {
+		port: 3100,
+		host: "127.0.0.1",
+		defaultEnabled: false,
+		meaning: "ACP JSON-RPC + 对外问答面（外部程序 + key 认证的问答页共用一 listener）"
+	}
+};
+/** 宿主主 WebUI 端口（面 A：插件**不监听**，只读取；`readWebPort` 的回退值） */
+const MAIN_WEB_PORT = FACE_PORTS.main.port;
+/** 网关端口默认值（面 B） */
+const GATEWAY_PORT = FACE_PORTS.gateway.port;
+/** 微信主动发送端口默认值（面 C） */
+const WEIXIN_SEND_PORT = FACE_PORTS.weixinSend.port;
+/** Skiff 调试页端口默认值（面 D） */
+const SKIFF_DEBUG_PORT = FACE_PORTS.skiffDebug.port;
+/** ACP / 对外问答端口默认值（面 E） */
+const ACP_HTTP_PORT = FACE_PORTS.acpHttp.port;
+/**
+* **机制端口**词表（output-guard 用：agent 在**用户可见输出**里提及内部端口即打回）。
+*
+* 由 {@link FACE_PORTS} 机械派生 ⇒ 与面清单**永不漂移**。
+* ⚠️ 修复记录（C4 块 B，2026-09-15）：旧常量硬写 `['3080','3081','3099','3100']`
+* ——**漏 3082**（微信发送面，默认开）⇒ 守卫拦不住"3082"这类提及。现由表派生，五面齐全。
+*/
+const MECHANISM_PORTS = Object.keys(FACE_PORTS).map((id) => String(FACE_PORTS[id].port));
+//#endregion
 //#region src/settings-section.ts
 var settings_section_exports = /* @__PURE__ */ __exportAll({
 	SERENITY_SETTINGS_NS: () => SERENITY_SETTINGS_NS,
 	defaultSimpleSettings: () => defaultSimpleSettings,
 	entryDefaults: () => entryDefaults,
 	readSimpleSettings: () => readSimpleSettings,
-	registerSettingsSection: () => registerSettingsSection,
-	simpleSettingsSchema: () => simpleSettingsSchema
+	registerSettingsSection: () => registerSettingsSection
 });
 /** 简单配置命名空间（dsh 设置面板的 section id / settings.yaml section） */
 const SERENITY_SETTINGS_NS = "serenity-hooks";
@@ -18,9 +74,9 @@ const simpleSettingsSchema = z.object({
 	rebuildEnabled: z.boolean().default(true),
 	rebuildThresholdK: z.number().min(50).max(4e3).default(400),
 	skiffEnabled: z.boolean().default(false),
-	skiffDebugPort: z.number().min(1024).max(65535).default(3099),
+	skiffDebugPort: z.number().min(1024).max(65535).default(SKIFF_DEBUG_PORT),
 	acpEnabled: z.boolean().default(false),
-	acpHttpPort: z.number().min(1024).max(65535).default(3100),
+	acpHttpPort: z.number().min(1024).max(65535).default(ACP_HTTP_PORT),
 	publicAskEnabled: z.boolean().default(false),
 	autopilotWakeEnabled: z.boolean().required(false),
 	autopilotEnabled: z.boolean().required(false),
@@ -33,9 +89,9 @@ function entryDefaults(config) {
 		rebuildEnabled: config.rebuild?.enabled ?? true,
 		rebuildThresholdK: config.rebuild?.thresholdK ?? 400,
 		skiffEnabled: config.skiff?.enabled ?? false,
-		skiffDebugPort: config.skiff?.debugPort ?? 3099,
+		skiffDebugPort: config.skiff?.debugPort ?? SKIFF_DEBUG_PORT,
 		acpEnabled: config.acp?.enabled ?? false,
-		acpHttpPort: config.acp?.httpPort ?? 3100,
+		acpHttpPort: config.acp?.httpPort ?? ACP_HTTP_PORT,
 		publicAskEnabled: config.publicAsk?.enabled ?? false,
 		wakeSchedulerEnabled: true
 	};
@@ -51,9 +107,9 @@ function defaultSimpleSettings() {
 		rebuildEnabled: true,
 		rebuildThresholdK: 400,
 		skiffEnabled: false,
-		skiffDebugPort: 3099,
+		skiffDebugPort: SKIFF_DEBUG_PORT,
 		acpEnabled: false,
-		acpHttpPort: 3100,
+		acpHttpPort: ACP_HTTP_PORT,
 		publicAskEnabled: false,
 		wakeSchedulerEnabled: true
 	};
@@ -97,4 +153,4 @@ function registerSettingsSection(ctx, config) {
 	hooks.onChange();
 }
 //#endregion
-export { registerSettingsSection as n, settings_section_exports as r, readSimpleSettings as t };
+export { FACE_PORTS as a, MECHANISM_PORTS as c, ACP_HTTP_PORT as i, SKIFF_DEBUG_PORT as l, registerSettingsSection as n, GATEWAY_PORT as o, settings_section_exports as r, MAIN_WEB_PORT as s, readSimpleSettings as t, WEIXIN_SEND_PORT as u };

package/lib/settings-section.d.ts

@@ -16,9 +16,8 @@
  * 则显示降级提示（引导去宁静号面板），在则渲染 schema 表单。零配置自动适配。
  */
 import type { Context } from 'cordis';
-import z from '@deepseek-ai/schemastery';
 /** 插件 Config 的简单配置片段（index.ts Config 组合；settings entry base） */
-export interface SimpleConfigFragment {
+interface SimpleConfigFragment {
     gateway?: {
         enabled?: boolean;
     };
@@ -47,7 +46,7 @@ export declare const SERENITY_SETTINGS_NS = "serenity-hooks";
  * 简单配置 schema（schemastery）：三功能总开关 + F2 阈值 + F4 Skiff 启停。
  * 与 DSH settings 的 schema 语义一致（z.object 布尔/数字）。
  */
-export interface SerenitySimpleSettings {
+interface SerenitySimpleSettings {
     /** F1 双端口网关总开关 */
     gatewayEnabled: boolean;
     /** F2 超限重建总开关 */
@@ -76,36 +75,8 @@ export interface SerenitySimpleSettings {
      *  ——用户 2026-09-15 裁决：「auto-trajectory 的开关只关闭 auto-trajectory 唤醒」。 */
     wakeSchedulerEnabled: boolean;
 }
-/** schemastery schema（与 DSH 各插件 Config 同款） */
-export declare const simpleSettingsSchema: z<Schemastery.ObjectS<{
-    gatewayEnabled: z<boolean, boolean>;
-    rebuildEnabled: z<boolean, boolean>;
-    rebuildThresholdK: z<number, number>;
-    skiffEnabled: z<boolean, boolean>;
-    skiffDebugPort: z<number, number>;
-    acpEnabled: z<boolean, boolean>;
-    acpHttpPort: z<number, number>;
-    publicAskEnabled: z<boolean, boolean>;
-    autopilotWakeEnabled: z<boolean, boolean>;
-    autopilotEnabled: z<boolean, boolean>;
-    wakeSchedulerEnabled: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-    gatewayEnabled: z<boolean, boolean>;
-    rebuildEnabled: z<boolean, boolean>;
-    rebuildThresholdK: z<number, number>;
-    skiffEnabled: z<boolean, boolean>;
-    skiffDebugPort: z<number, number>;
-    acpEnabled: z<boolean, boolean>;
-    acpHttpPort: z<number, number>;
-    publicAskEnabled: z<boolean, boolean>;
-    autopilotWakeEnabled: z<boolean, boolean>;
-    autopilotEnabled: z<boolean, boolean>;
-    wakeSchedulerEnabled: z<boolean, boolean>;
-}>>;
 /** 从插件 Config 提取 entry 默认（settings base 层） */
 export declare function entryDefaults(config: SimpleConfigFragment): SerenitySimpleSettings;
-/** 测试辅助：重置"缺 settings provider"告警去重（生产零调用） */
-export declare function __resetSettingsWarningsForTest(): void;
 /** 进程级默认（无 settings 服务时的兜底） */
 export declare function defaultSimpleSettings(): SerenitySimpleSettings;
 /**
@@ -127,3 +98,4 @@ export declare function __setSimpleSourceForTest(source: (() => SerenitySimpleSe
  * （owner = consumer 插件 ctx；ns 直接字符串）。
  */
 export declare function registerSettingsSection(ctx: Context, config: SimpleConfigFragment): void;
+export {};

package/lib/skiff-core.d.ts

@@ -81,13 +81,7 @@ export declare function ensureWorkspacePromptSection(agent: Agent, scope: string
  * @returns 绑定后的 SESSION.md 绝对路径（供提示词注入）；不适用/失败 → null
  */
 export declare function ensureSkiffSession(root: string, agent: Agent, roleName: string, role: SkiffRoleConfig, persistent?: boolean): string | null;
-/** 当前 scope 是否已激活（幂等判定：getActiveSessionInfo 命中同 dirName）——测试用 */
-export declare function skiffSessionActiveFor(sessionId: string): {
-    sessionId: string;
-    dirName: string;
-    mdPath: string;
-} | null;
-export interface SkiffAgentRef {
+interface SkiffAgentRef {
     handle: AgentHandle;
     agent: Agent;
     sessionId: string;
@@ -114,7 +108,7 @@ export interface SkiffTrajectoryEntry {
     /** assistant 的工具调用名（有则填） */
     tool?: string;
 }
-export interface SkiffAskResult {
+interface SkiffAskResult {
     answer: string;
     sessionId: string;
     trajectory: SkiffTrajectoryEntry[];
@@ -135,7 +129,7 @@ export declare function askSkiff(ctx: Context, agent: Agent, question: string, e
  * 注册表缺失（进程重启遗留等）→ 保守旁路（false，完全独立）。
  */
 export declare function skiffTrajectoryEnabled(root: string, sessionId: string | undefined, key: 'session' | 'keeper' | 'rebuild'): boolean;
-export interface SkiffMsmGate {
+interface SkiffMsmGate {
     /** 拒绝原因（有则拒绝执行） */
     reject?: string;
     /** list 显示白名单（msms）；仅 action==='list' 时有值 */
@@ -147,3 +141,4 @@ export interface SkiffMsmGate {
  * list 白名单过滤、check/guide/ccc-config 只读放行。
  */
 export declare function skiffMsmGate(root: string, sessionId: string | undefined, action: string, name?: string): SkiffMsmGate;
+export {};

package/lib/skiff-debug.d.ts

@@ -18,30 +18,19 @@
  * 实验性质：未开启时零资源占用（无监听、无 agent 创建）。
  */
 import type { Context } from 'cordis';
-import { type SkiffTrajectoryEntry } from './skiff-core.js';
+import { type CccEntry } from './ccc-roots.js';
+import { type FaceSpec } from './face-host.js';
 export declare function skiffDebugActive(): boolean;
 export declare function skiffDebugPort(): number | null;
-/** 候选 CCC 条目（调试页 CCC 切换器数据） */
-export interface SkiffCccEntry {
-    /** CCC 根（绝对路径） */
-    root: string;
-    /** 目录名（展示用） */
-    name: string;
-    /** 该 CCC 的 skiff 角色名列表（实时读取） */
-    roles: string[];
-}
 /**
- * 发现候选 CCC 列表（多 CCC 手工切换，v1.25.6）：
- * ① **dsh 工作区注册表**（workspaceRegistry.list，持久化——所有工作目录即使无 live 会话；
- *    S142 用户 2026-08-29：应直接拉 dsh 工作区，且只列具体 CCC）
- * ② **sessionPersistence 兜底**（持久化会话 headers——必装配服务，覆盖所有历史会话工作目录；
- *    用户实测 workspaceRegistry 拉取仍空时兜底）
- * ③ live 会话兜底
- * ④ 默认绑定 root 兜底（不在列表时放首位）
+ * 候选 CCC 条目（调试页 CCC 切换器数据）。
+ *
+ * C2：定义已迁至 `ccc-roots.ts`（L2 枚举的唯一真相源）——此处只在**类型层**转出
+ * （零运行时重导出，避免把 `ccc-roots` 拉进本模块的运行时静态链）。
  */
-export declare function discoverCccs(ctx: Context, defaultRoot: string): Promise<SkiffCccEntry[]>;
+export type { CccEntry };
 /** 问答页 HTML：CCC 切换器 + 角色下拉 + 输入 + 答案区 + 轨迹区（JS 渲染）+ WebUI 链接 */
-export declare function skiffDebugPage(cccs: SkiffCccEntry[], defaultRoot: string, webPort: number): string;
+export declare function skiffDebugPage(cccs: CccEntry[], defaultRoot: string, webPort: number): string;
 /**
  * JSC (Safari/iOS) JSON.parse 快速路径正则兼容化（v1.26.9，S142 调研定稿）。
  *
@@ -76,6 +65,11 @@ export declare function renderSkiffMarkdown(raw: string, hideThink?: boolean): s
  * 未闭合 think 优雅截断。适用于纯文本输出面（微信等不支持 think 折叠的通道）。
  */
 export declare function stripThink(raw: string): string;
+/**
+ * 本面的规格（C4 块 A/④：**只提供** name/port/host/enabled/handler）。
+ * 路由/鉴权/HTML 全部仍归本模块的 {@link handle}（面宿主不介入面语义）。
+ */
+export declare function skiffDebugSpec(ctx: Context, root: string, port: number, webPort: number): FaceSpec;
 /**
  * 启动调试问答服务（单实例；重复启动幂等返回既有实例）。
  *
@@ -83,11 +77,11 @@ export declare function stripThink(raw: string): string;
  * 解析：live 会话中**含 skiff.roles 的 CCC 优先**）；v1.25.4 起页面可**手工切换**到
  * 其它候选 CCC（live 会话发现的全部 CCC）；角色配置**每次请求实时读取**（不缓存快照）。
  *
+ * C4 块 A：listener 的创建/监听/错误/端口占用/关闭归 `face-host`（本函数只提供规格 + 记日志）。
+ *
  * @param root 默认绑定的 CCC 根（首次加载选中；角色配置读取 + skiff agent cwd）
  * @param port 调试端口（仅 127.0.0.1）
  * @param webPort 主 WebUI 端口（WebUI 链接）
  */
 export declare function startSkiffDebugServer(ctx: Context, root: string, port: number, webPort: number): Promise<void>;
 export declare function stopSkiffDebugServer(): void;
-/** 导出类型引用（测试断言轨迹结构） */
-export type { SkiffTrajectoryEntry };

package/lib/skiff-registry-FTjoWQTQ.js

@@ -0,0 +1,25 @@
+//#region src/skiff-registry.ts
+const skiffSessions = /* @__PURE__ */ new Map();
+/** 查 sessionId 的 Skiff 角色名（无 → null）——向后兼容（guards/seams 依赖） */
+function skiffRoleFor(sessionId) {
+	return skiffSessions.get(sessionId)?.role ?? null;
+}
+/** 查 sessionId 的完整绑定（role + ccc；无 → null）——v1.25.10 会话追问校验 */
+function skiffSessionInfo(sessionId) {
+	return skiffSessions.get(sessionId) ?? null;
+}
+function registerSkiffSession(sessionId, role, ccc) {
+	skiffSessions.set(sessionId, {
+		role,
+		ccc
+	});
+}
+function unregisterSkiffSession(sessionId) {
+	skiffSessions.delete(sessionId);
+}
+/** 测试/调试：注册表快照（sessionId → {role, ccc}） */
+function skiffSessionSnapshot() {
+	return new Map(skiffSessions);
+}
+//#endregion
+export { unregisterSkiffSession as a, skiffSessionSnapshot as i, skiffRoleFor as n, skiffSessionInfo as r, registerSkiffSession as t };

package/lib/skiff-registry.d.ts

@@ -11,7 +11,7 @@
  * 生命周期：进程内存态；连接/页面关闭时 unregister；进程重启自然清空（skiff 会话不复存在）。
  */
 /** 注册表值：会话绑定的角色 + CCC 根（追问延续校验用） */
-export interface SkiffSessionBinding {
+interface SkiffSessionBinding {
     role: string;
     ccc: string;
 }
@@ -23,3 +23,4 @@ export declare function registerSkiffSession(sessionId: string, role: string, cc
 export declare function unregisterSkiffSession(sessionId: string): void;
 /** 测试/调试：注册表快照（sessionId → {role, ccc}） */
 export declare function skiffSessionSnapshot(): ReadonlyMap<string, SkiffSessionBinding>;
+export {};

package/lib/{skiff-role-DAfPb6YQ.js → skiff-role-CEHL5cek.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as resolveInside, m as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-eu_IPF94.js";
+import { h as resolveInside, m as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-NlLr_sxy.js";
 import { existsSync, statSync } from "node:fs";
 //#region src/skiff-role.ts
 /**

package/lib/skiff-role.d.ts

@@ -20,7 +20,7 @@ export declare function isSkiffSessionId(sessionId: string | undefined): boolean
  */
 export declare function readSkiffRoles(root: string, paths?: string[]): Map<string, SkiffRoleConfig>;
 /** 某角色的轨迹纪律子集（缺省全 false = 完全独立） */
-export interface SkiffTrajectorySubset {
+interface SkiffTrajectorySubset {
     session: boolean;
     keeper: boolean;
     rebuild: boolean;
@@ -49,7 +49,7 @@ export declare function systemPromptSource(role: SkiffRoleConfig | undefined): '
  * - 缺省 = 隐式推断：调用方给出**稳定 sessionId** → persistent；否则 temporary
  *   （存量配置零迁移；微信桥传固定会话 id → persistent，ACP/调试页随机 id → temporary）
  */
-export type SkiffKind = 'temporary' | 'persistent';
+type SkiffKind = 'temporary' | 'persistent';
 export declare function resolveSkiffKind(role: SkiffRoleConfig | undefined, hasStableId: boolean): SkiffKind;
 /**
  * 角色提示词**读取器**（v1.30.15，方案 A：长期型热更新）。

package/lib/skills/opencode-scan.d.ts

@@ -4,12 +4,12 @@
  * 兼容 opencode 的 skill 标准：`.opencode/skills/<name>/SKILL.md`
  * （frontmatter: name/description/whenToUse；结构含 references/、scripts/）。
  */
-export interface OpencodeSkillMeta {
+interface OpencodeSkillMeta {
     name: string;
     description: string;
     whenToUse?: string;
 }
-export interface OpencodeSkill {
+interface OpencodeSkill {
     name: string;
     dir: string;
     meta: OpencodeSkillMeta;
@@ -25,3 +25,4 @@ export declare function parseFrontmatter(raw: string): {
 export declare function listOpencodeSkillDirs(root: string): string[];
 /** 加载一个 opencode skill（frontmatter 解析 + 正文）；读失败（EPERM/占用等）返回 null，单目录容错 */
 export declare function loadOpencodeSkill(skillDir: string): OpencodeSkill | null;
+export {};

package/lib/skills-discovery.d.ts

@@ -12,14 +12,27 @@
  *
  * 任何 CCC 都能自动注入其顶层入口 skill 全文（不硬编码名字）。
  */
-export type EntrySkillSource = 'serenity-marker' | 'pointer' | 'opencode' | 'dsh';
-export interface EntrySkill {
+type EntrySkillSource = 'serenity-marker' | 'pointer' | 'opencode' | 'dsh';
+interface EntrySkill {
     name: string;
     content: string;
     source: EntrySkillSource;
 }
+/**
+ * 防穿越：skill 名必须是简单目录名（拒绝分隔符与 `..`/`.` 路径段）。
+ * v1.34.1：导出——轨迹 skill 声明（CCC 数据）的名字也要**先过这一关**才能用于拼路径
+ * （规格 `docs/trajectory-skill-injection.md` §3「名字安全（必做）」）。
+ */
+export declare function isSafeSkillName(name: string): boolean;
+/**
+ * 按名在两个 skills 根下定位 SKILL.md（`.dsh/skills` 优先，其次 `.opencode/skills`）。
+ * v1.34.1：导出——轨迹 skill 注入复用本函数（不新造发现逻辑）；不安全名在此**先行拒绝**
+ * （返回 null，且不发生任何以该名拼出的 fs 访问）。
+ */
+export declare function findSkillMd(root: string, name: string): string | null;
 /** 发现全部入口技能（原文全量，不截断） */
 export declare function findEntrySkills(root: string): EntrySkill[];
 /** 兼容旧接口：第一个入口（或 null） */
 export declare function findEntrySkill(root: string): EntrySkill | null;
 export declare function truncateContent(content: string, maxChars: number): string;
+export {};

package/lib/status.d.ts

@@ -10,7 +10,7 @@
  * 依次尝试 npm_config_prefix / APPDATA\npm / ~/.npm-global。
  */
 export declare function readDshVersion(): string | null;
-export interface SerenityStatus {
+interface SerenityStatus {
     root: string | null;
     accVersion: string;
     dshVersion: string | null;
@@ -36,3 +36,4 @@ export declare function getStatus(cwd: string, configPaths?: string[]): Serenity
 export declare function setSafeMode(root: string, on: boolean): {
     on: boolean;
 };
+export {};

package/lib/tools/cce.d.ts

@@ -1,9 +1,8 @@
 /**
- * cce.ts — CCE 认知连续性工程工具（渐进式披露，ACC 标准工具化）
+ * cce.ts — CCE 内容源（认知连续性工程；v1.30 三工具合并为 praxis 后只保留内容常量）
  *
  * 内容：认知连续性工程（Cognitive Continuity Engineering）——在有限资源与
  * 不可逆不确定性约束下，维持认知实体身份、可达性与演化能力的工程学科。
  * 来源：home-serenity `.opencode/skills/cce/SKILL.md` + CCE 理论。
  */
 export declare const CCE_CONTENT = "# CCE \u2014 Cognitive Continuity Engineering\n\n> **Cognitive Continuity Engineering is the engineering discipline of maintaining a cognitive entity's identity, accessibility, and capacity to evolve under the constraints of bounded resources and irreversible uncertainty.**\n> CCE does not optimize cognition. It preserves the conditions under which cognition can continue. \u2014 Persistence Engineering, not performance engineering\n\n## Core Propositions\n- **Continuity belongs to the container, not to any individual participant** \u2014 agents come and go, but the CCC's cognitive trajectory persists\n- **Organization must at minimum keep pace with accumulation** \u2014 otherwise operational cognitive entropy (H_op) grows unboundedly and accessibility is lost\n- **Reconstruction over preservation** \u2014 an artifact's value is determined by its ability to let future agents rebuild the original reasoning\n\n## Cognitive Container\nA bounded cognitive space in which cognition can accumulate, reorganize, and evolve. 5 defining properties:\n| Property | Function |\n|----------|----------|\n| Identity | Distinguishes this cognitive system from others |\n| Boundaries | Define what is inside/outside the cognitive space |\n| Persistent Memory | Retains accumulated cognition across time |\n| Operational Constraints | Define which operations are allowed inside the container |\n| Evolutionary History | Records the trajectory of cognitive change, making reconstruction possible |\n\n## Operational Cognitive Entropy (H_op)\nDoes not measure total entropy (not operational); it measures only the **excess cognitive cost** for agents to complete tasks inside the container:\n> H_op(C, t) = cost(task | C, t) \u2212 cost(task | ideal)\nContinuity condition: **H_op(C, t) \u2264 H_critical** \u2014 agents can still complete tasks at reasonable cost\n\n## Continuity Maintenance Condition\n> **\u0394H_org \u2265 \u0394H_in** \u2014 organization must at minimum keep pace with accumulation\n\n## Six-Phase Lifecycle\nExperience \u2192 Accumulation \u2192 Organization \u2192 Abstraction \u2192 Reconstruction \u2192 Evolution \u2192\uFF08loop\uFF09\n| Phase | Engineering Concern |\n|-------|---------------------|\n| Experience | Does input carry enough structure |\n| Accumulation | Is information stored losslessly |\n| Organization | Entropy management \u2014 \u0394H_org offsets \u0394H_in |\n| Abstraction | Is abstraction explicitly encoded |\n| Reconstruction | Can reasoning structure be recovered from artifacts |\n| Evolution | Does evolution stay coherent or introduce drift |\n\n## Relationship with EAP\nEAP answers \"how a piece of knowledge should be structured\" (explicitness E\u2191 / reconstructability R\u2193 / stability S\u2191);\nCCE answers \"how structured knowledge should keep evolving across time without losing coherence\". They complement each other: EAP is static quality, CCE is dynamic persistence.\n\n## Relationship with Serenity\nSerenity's session system, session tracking, and entropy management mechanisms (SQC quality loop) are all engineering implementations of CCE;\nthe behavioral constraints embedded in CCC system prompts come from CCE.";
-export declare const cceTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/container-admin.d.ts

@@ -11,7 +11,11 @@
  *   类比 The Manifest（清单维护——工具注册表）+ Crew（角色管理）+ 机务（配置/手册）。
  *
  * 参数极简（LLM 直觉）：domain（管理域）+ action（该域子命令）+ 少量业务参数。
+ *
+ * v1.34.1（⑥ C6a）：由 `export const containerAdminTool` 改为**工厂**
+ * `createContainerAdminTool(ctx)`——autopilot 域搬进进程内后，`status` 必须读只有进程内
+ * 能看到的事实（全局闸 / live 会话 / agent 可解析性，见 `../autopilot-ops.js`）。
+ * 这是本轮唯一为"取 ctx"而做的形态改动（其余域不依赖 ctx，行为不变）。
  */
-/** 管理域（container_admin 一级参数） */
-export type AdminDomain = 'role' | 'msm' | 'config' | 'autopilot';
-export declare const containerAdminTool: import("@deepseek-ai/dsh-tools").ToolDefinition;
+import type { Context } from 'cordis';
+export declare function createContainerAdminTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/eap.d.ts

@@ -1,7 +1,6 @@
 /**
- * eap.ts — EAP 认知质量框架工具（渐进式披露，ACC 标准工具化）
+ * eap.ts — EAP 内容源（认知质量框架；v1.30 三工具合并为 praxis 后只保留内容常量）
  *
- * 内嵌框架内容（自包含，不依赖已安装技能）；可选 section 参数聚焦某原则。
+ * 内嵌框架内容（自包含，不依赖已安装技能）。
  */
 export declare const EAP_CONTENT = "# EAP Cognitive Quality Framework (Explicit Abstraction Principle)\n\n> \"The functional value of a thought is proportional to its external reconstructability.\"\n\n## Three Variables\n| Variable | Meaning | How to improve |\n|----------|---------|----------------|\n| E\u2191 Explicitness | Degree to which variables/entities/relations are clearly defined | Define variables, state relationship direction & cardinality, draw boundaries |\n| R\u2193 Reconstructability | Cost of rebuilding the original reasoning later | Record decision rationale, context, constraints, alternatives |\n| S\u2191 Stability | Degree to which the same input repeatedly produces consistent output | Fix structures, protocolize, avoid relying on implicit context |\n\n## Pre-Output Self-Check Checklist\n- [ ] Variables/entities clearly defined (E\u2191)\n- [ ] Relationships state direction/cardinality (E\u2191)\n- [ ] Boundaries drawn \u2014 what is in scope / what is not (E\u2191)\n- [ ] No ambiguous words: \"handle\" \"optimize\" \"problem\" \u2192 be specific (E\u2191)\n- [ ] Key decisions record rationale and alternatives (R\u2193)\n- [ ] No level-skipping \u2014 align the upper layer before descending (R\u2193)\n- [ ] Structures can be regenerated repeatably (S\u2191)\n\n## Relationship with ACC\nACC (plugin/template) encodes structure as code (E\u2191); generating a CCC from ACC is deterministic (R\u2193); consistent across multiple CCCs (S\u2191).\nCCC (home-serenity etc.) encodes cognitive content as skills/SESSIONs/design docs. Use this checklist to self-check outputs.\n\n## Reference\nhttps://github.com/tellmewhattodo/theory-eap";
-export declare const eapTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/handyman.d.ts

@@ -20,34 +20,5 @@
  */
 import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
 import type { Context } from 'cordis';
-/** 非正常停止时重启 agent 的次数上限（防死循环保险阀）：对话轮次有上限，重启有上限 */
-export declare const HANDYMAN_MAX_RESTARTS = 100;
-/** 对话轮次上限（对齐 osp loop-runner 的 round>=100 强制 done 保险阀） */
-export declare const HANDYMAN_MAX_ROUNDS = 100;
-export interface HandymanJob {
-    task: string;
-    label: string;
-    model?: string;
-}
-export interface HandymanJobResult {
-    label: string;
-    done: boolean;
-    rounds: number;
-    finishReason: 'done' | 'max_rounds' | 'restart_exceeded';
-    restarts: number;
-    model: string;
-    lastResponse: string;
-    progressFile: string;
-}
-/** foreground 模式结果（一次调用一次结果；无循环、无进度文件） */
-export interface HandymanForegroundResult {
-    mode: 'foreground';
-    done: boolean;
-    model: string;
-    stopReason: string;
-    output: string;
-    childId?: string;
-    diagnostic?: string;
-}
 /** 创建 handyman 工具（闭包捕获插件 ctx → 可访问 ctx.agents） */
 export declare function createHandymanTool(ctx: Context): ToolDefinition;

package/lib/tools/msm.d.ts

@@ -15,8 +15,4 @@
  * 管理面（register/deregister/check/guide/catalog/ccc-config）已移入 container_admin。
  * 底层 runMsmAsync/prepareExec 全复用；未命中候选为新增 findSuggestions。
  */
-/** 精简目录（无参调用返回；替代全量 list 的巨输出）——按 skill 分组统计 + 顶部指引 */
-export declare function buildMsmIndex(root: string): string;
-/** 模糊候选：name/description 子串匹配（未精确命中时返回 top-K，供 LLM 下轮选对） */
-export declare function suggestMsm(root: string, query: string, limit?: number): string;
 export declare const msmTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/neat.d.ts

@@ -1,5 +1,4 @@
 /**
- * neat.ts — Neat 设计协作协议工具（渐进式披露，ACC 标准工具化）
+ * neat.ts — Neat 内容源（设计协作协议；v1.30 三工具合并为 praxis 后只保留内容常量）
  */
 export declare const NEAT_CONTENT = "# Neat Design Collaboration Protocol\n\n> Complex design is not thought up at once \u2014 it is walked out in small aligned steps.\n\n## Four Iron Rules\n| Rule | Meaning | Anti-example |\n|------|---------|--------------|\n| Small-step alignment | Advance one decision at a time; confirm before the next step | Presenting 10 options at once |\n| Explicit decisions | Every choice records rationale and alternatives | \"I feel this is good\" (no rationale) |\n| Document-driven | Conclusions land in named files (<subject>-<scope>-<type>.md) | Conclusions exist only in conversation |\n| No level-skipping | Advance strictly through the layers | Writing implementation before requirements are aligned |\n\n## Five-Layer Progression (no skipping)\nRequirements \u2192 Scope \u2192 Solution \u2192 Interface \u2192 Implementation\n| Layer | Artifact | Question |\n|-------|----------|----------|\n| Requirements | Requirements description | \"What problem are we solving?\" |\n| Scope | Scope list (in/out) | \"What is in, explicitly what is out?\" |\n| Solution | Solution comparison + selection | \"How? Which one? Why?\" |\n| Interface | Interface/protocol definition | \"How do the boundaries interact?\" |\n| Implementation | Code/docs | \"Land it layer by layer\" |\n\n## Collaboration Rhythm\n1. Raise one decision point of the current layer (with context + suggestion + rationale)\n2. Wait for confirmation or correction (small step)\n3. After confirmation, record the decision (into session SESSION.md or a design doc)\n4. Move to the next decision point";
-export declare const neatTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/praxis.d.ts

@@ -8,7 +8,6 @@
  *
  * section 参数渐进披露：不传 = 返回精简目录；传 = 返回对应框架全文/章节。
  */
-export type PraxisSection = 'eap' | 'neat' | 'cce';
 /** 框架清单（无参调用时返回的精简目录） */
 export declare const PRAXIS_INDEX = "praxis \u2014 \u53EF\u5B9E\u8DF5\u7406\u8BBA\u6CE8\u5165\uFF08\u8BA4\u77E5\u6846\u67B6\uFF0C\u6309\u9700\u52A0\u8F7D\uFF09\n\u9009\u62E9\u6846\u67B6\uFF1Apraxis eap\uFF08\u8BA4\u77E5\u8D28\u91CF\u2014\u2014E\u2191/R\u2193/S\u2191 \u4E09\u53D8\u91CF + \u8F93\u51FA\u524D\u81EA\u68C0\uFF09\n          praxis neat\uFF08Neat \u534F\u4F5C\u534F\u8BAE\u2014\u2014\u5C0F\u6B65\u5BF9\u9F50/\u663E\u5F0F\u51B3\u7B56/\u6587\u6863\u9A71\u52A8\uFF09\n          praxis cce\uFF08\u8BA4\u77E5\u8FDE\u7EED\u6027\u5DE5\u7A0B\u2014\u2014\u5BB9\u5668 5 \u884C\u4E3A\u7EA6\u675F + H_op \u64CD\u4F5C\u71B5\uFF09\n\u65E0\u53C2\u8FD4\u56DE\u672C\u76EE\u5F55\uFF1B\u8BE6\u60C5\u4EE5\u5BF9\u5E94\u6846\u67B6\u539F\u6587\u4E3A\u51C6\uFF08\u5355\u4E00\u771F\u76F8\u6E90\uFF09\u3002\n";
 export declare const praxisTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/skiff-admin.d.ts

@@ -1,8 +1,8 @@
 /**
  * skiff-admin.ts — Skiff 角色逻辑层（v1.30：skiff_admin 工具已并入 container_admin role 域）
  *
- * 教 CCC 如何定义 Skiff 角色（仿 session 工具 hook-develop-guide 的 SEP 教学模式，
- * 用户拍板 2026-08-28：guide 定义教程 / validate 配置校验 / list 角色摘要）。
+ * 教 CCC 如何定义 Skiff 角色（用户拍板 2026-08-28 的三动作分工：
+ * guide 定义教程 / validate 配置校验 / list 角色摘要）。
  *
  * 归属：ACC 机制（教会 + 校验），角色内容仍归 CCC 配置（.opencode/serenity.json skiff.roles）。
  * 公开入口 = container_admin（domain: role → guide/validate/apply/list）；本文件保留纯逻辑。

package/lib/tools/trajectory.d.ts

@@ -12,18 +12,19 @@
  *     ⇒ 只把**不依赖模板**的两项并入 `use`：空壳 / 长期无活动（**提示，不阻断**）
  *   · `close`/`archive` → 删：`completed` 本就由 SESSION.md 的 `[x]` 推导（不靠 close 写）；
  *     归档能力由 `container_fs mv → _archived/` 承担
- *   · `hook-develop-guide` → 并入 `container_admin msm guide`（SEP 内容进开发手册）
+ *   · `hook-develop-guide` → **淘汰**（v1.34.1：SEP 整体废除——「能落 harness 已有原语，
+ *     就不要自造协议 + 脚本管道」；轨迹挂哪些 skill 改由 SESSION.md frontmatter 声明 +
+ *     `systemPrompt.section` 注入，见 `docs/trajectory-skill-injection.md`）
  *   · autopilot 面（all/init/random/diag/doc/check/status/guide）→ `container_admin` 的 autopilot 域
  *   · `wake-add`/`wake-list`/`wake-rm` → **`wake-later`**（一次登记；**不可回收、无面板**——用户明示接受）
  *
- * 保留 osp 对齐语义的部分：create 的 `--desc`/`--issue` 二选一、use 激活即重命名 dsh 会话标题（F3）、
- * CCC `session-tool` MSM 钩子后处理（create-transform）。活跃会话跟踪：内存 Map（按 dsh 会话 id 隔离）
- * + 从 events 恢复（S134）。
+ * 保留 osp 对齐语义的部分：create 的 `--desc`/`--issue` 二选一、use 激活即重命名 dsh 会话标题（F3）。
+ * 活跃会话跟踪：内存 Map（按 dsh 会话 id 隔离）+ 从 events 恢复（S134）。
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import type { Context } from 'cordis';
 import { type ActiveSessionInfo, type CreateSessionResult } from '../trajectory-ops.js';
-export interface RenameOnUseDeps {
+interface RenameOnUseDeps {
     /** sessionTitle 服务可用性 */
     sessionTitleAvailable: boolean;
 }
@@ -92,18 +93,9 @@ export declare function renameDshSessionForActive(ctx: Context, exec: {
         session?: unknown;
     };
 }, info: ActiveSessionInfo, summary?: string): void;
-/**
- * SEP（Session Extension Protocol）开发者指南（原 `hook-develop-guide` 动作的内容）。
- *
- * v1.33（用户裁决"选 A"）：该动作**不再作为 trajectory 的动作**，内容**并进
- * `container_admin msm guide`**（理由：SEP 的本质就是"注册一个 session-tool MSM"，
- * 天然属于 MSM 开发手册）。⇒ 这里保留为**唯一文本源**，由 container-admin 引用，
- * 避免两份会漂移的说明（单真相源）。
- * @param hasSessionTool 本 CCC 是否已注册 session-tool MSM（决定了尾部的提示行）
- */
-export declare function buildSepGuide(hasSessionTool: boolean): string;
 /**
  * 创建 trajectory 工具（原 logbook；v1.33 S142 §32 更名 + 动作收敛）。
  * 闭包捕获插件 ctx → use 后可调 ctx.sessionTitle.rename。
  */
 export declare function createTrajectoryTool(ctx: Context): ReturnType<typeof defineTool>;
+export {};

package/lib/totp.d.ts

@@ -11,10 +11,6 @@
  */
 /** 时步（秒）——RFC 6238 默认 30 */
 export declare const TOTP_STEP_SECONDS = 30;
-/** 验证窗口：当前时步 ± 1（容忍时钟漂移/生成延迟） */
-export declare const TOTP_WINDOW = 1;
-/** 输出位数（标准 6 位） */
-export declare const TOTP_DIGITS = 6;
 /** 字节 → base32（无填充）。secret 显示/otpauth URI 用。 */
 export declare function base32Encode(bytes: Uint8Array): string;
 /** base32（无填充，大小写不敏感）→ 字节；非法字符抛错。 */