@shgroup/dsh-serenity-hooks 1.30.4 → 1.30.8

package/lib/kit-ops.d.ts

@@ -46,5 +46,5 @@ export interface RegistryHealthReport {
     issues: string[];
 }
 export declare function checkRegistryHealth(root: string): RegistryHealthReport;
-export declare function runKit(root: string | null, args: KitArgs): Promise<JsonValue>;
+export declare function runKit(root: string | null, args: KitArgs, hostCtx?: unknown): Promise<JsonValue>;
 export { loadSerenityConfig };

package/lib/localstore-ops.d.ts

@@ -54,6 +54,8 @@ export declare function checkLocalstoreGitCompliance(root: string): {
     ok: boolean;
     reason?: string;
 };
+/** 测试辅助：重置"坏 localstore"告警去重（生产零调用） */
+export declare function __resetBrokenStoreWarningsForTest(): void;
 /** 读取命名空间全部条目：credential → 扁平；config → 分节（剔除 credentials 保留节） */
 export declare function readStore(root: string, scope: LocalStoreScope): Record<string, string> | Record<string, Record<string, string>>;
 /** 校验凭据 key 合法（大写蛇形）；不合法抛错 */

package/lib/seams/lifecycle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * lifecycle.ts — 宿主生命周期订阅 + 资源拆卸（S142 review F-08）
+ *
+ * 两个此前缺失的收尾面：
+ *
+ * ① **会话/agent 销毁 → 清理 per-会话内存态**。dsp 有约 10 处 per-会话 Map
+ *    （活跃 SESSION 作用域、skiff 注册表、keeper 计分、guard 白名单缓存、bootstrap
+ *    晋升状态、输出守卫状态…）。此前无人订阅 `agent/disposed` / `session/disposed`
+ *    （宿主 0.1.2-rc.1 真实存在：`core/agent/src/runtime-types.ts:175`、
+ *    `core/session/src/index.ts:62`），长跑进程里这些 Map 只增不减——且 `waitIdle`
+ *    在 agent 先被销毁时永不结算。
+ *
+ * ② **插件卸载/HMR/profile 重载 → 停掉自起的监听器与轮询器**。skiff 调试页、ACP
+ *    HTTP 端点、微信桥轮询都是 dsp 自己起的资源；此前没有 `ctx.effect` 拆卸，
+ *    卸载后端口仍被占用（EADDRINUSE）、轮询器重复启动。
+ *
+ * 设计约束：清理与拆卸**一律吞掉异常**——生命周期回调里抛错会影响宿主的销毁流程
+ * （宿主对 `session/disposed` 监听器异常是"contained"语义，但没必要制造噪音）。
+ */
+import type { Context } from 'cordis';
+/** 从 Agent / Session / 事件负载中取会话 id（形状宽容：未知结构返回 null） */
+export declare function sessionIdOf(value: unknown): string | null;
+/** 单会话内存态清理（幂等；无对应状态即 no-op） */
+export declare function cleanupSessionState(sessionId: string): void;
+/**
+ * 装配生命周期订阅与资源拆卸。
+ * @param ctx 宿主插件上下文
+ */
+export declare function registerLifecycle(ctx: Context): void;

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

@@ -1,5 +1,10 @@
 /**
- * system-prompt.ts — 顶层入口 skill 全文 + ACC/CCE/Constraints/Session 系统提示词注入
+ * system-prompt.ts — Induction（成员装配机制，specs v1.5.0 命名）装配文本构造
+ *
+ * 机制：把新实例（新会话 / rebuild 重建 / 新 agent）引入为轨迹成员的装配机制——本文件装配的文本
+ * 即 Induction 骨架（8 块五层，specs README §5）：A 主体定义（ACC/Principles/CCE）→ B 质量规范（EAP）
+ * → C 状态调节（状态块）→ D 工作供给（SKILL/Tools）→ E 任务指示（Session），稳定→易变装配序；
+ * Metaphor 为 A 层世界模型记忆钩渲染层（不计入 8 块骨架）。
  *
  * **完全对齐 opencode-serenity-plugin 的 system.transform 注入内容**（compacting.ts）：
  * 结构（v1.19.8 精简，S142 重建视角 R↓）：

package/lib/{session-bound-p9oR9dj9.js → session-bound-D2ANqVn-.js}

@@ -1,3 +1,4 @@
+import { a as findSerenityRoot } from "./ccc-DAsSHsub.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 //#region src/session-ops.ts
@@ -671,55 +672,108 @@ function qaCheck(root, key) {
 	if (verified) lines.push("  • Session looks clean — no issues detected");
 	return lines.join("\n");
 }
-//#endregion
-//#region src/session-bound.ts
-/** 事件 type 常量（声明 + 读取共用） */
-const SESSION_BOUND_EVENT = "serenity/bound";
-/** 事件形状归一（运行时数据经 session.append 深冻结，此处仅类型收窄） */
-function asBoundEvent(e) {
-	const ev = e;
-	if (!ev || ev.type !== "serenity/bound") return null;
-	const d = ev.data;
-	if (!d || typeof d.dirName !== "string" || typeof d.mdPath !== "string") return null;
-	return d;
+/** 绑定文件相对 CCC 根的路径 */
+const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
+const BINDINGS_VERSION = 1;
+function sessionHeader(session) {
+	const header = session?.header;
+	if (!header || typeof header !== "object") return null;
+	return header;
 }
-/**
-* 读取会话日志中**最后一条** `serenity/bound`（权威绑定，latest-wins）。
-* 尾到头扫描（时间序最新在后）；无 bound 事件返回 null。
-* 纯逻辑零 DSH 依赖（经 sessionEvents helper 读 snapshotEvents/events 兜底）。
-*/
-function readLastBound(session) {
+/** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
+function bindingsPathFor(session) {
+	const header = sessionHeader(session);
+	if (typeof header?.cwd !== "string") return null;
+	const root = findSerenityRoot(header.cwd);
+	if (!root) return null;
+	return join(root, BINDINGS_REL_PATH);
+}
+function readBindingsFile(path) {
+	if (!existsSync(path)) return {
+		version: BINDINGS_VERSION,
+		sessions: {}
+	};
+	try {
+		const sessions = JSON.parse(readFileSync(path, "utf-8")).sessions;
+		if (!sessions || typeof sessions !== "object") return {
+			version: BINDINGS_VERSION,
+			sessions: {}
+		};
+		return {
+			version: BINDINGS_VERSION,
+			sessions
+		};
+	} catch {
+		return {
+			version: BINDINGS_VERSION,
+			sessions: {}
+		};
+	}
+}
+/** 原子写：同目录 tmp + rename（避免半写文件被后续读取） */
+function writeBindingsFile(path, data) {
+	mkdirSync(dirname(path), { recursive: true });
+	const tmp = `${path}.tmp`;
+	writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
+	renameSync(tmp, path);
+}
+/** 记录形状校验（容忍手改/旧数据） */
+function asBoundRecord(value) {
+	const r = value;
+	if (!r || typeof r.dirName !== "string" || typeof r.mdPath !== "string") return null;
+	return r;
+}
+/** 旧形态：从会话日志扫最后一条 `serenity/bound`（兼容 v1.30.5 及更早写入的绑定） */
+function readLegacyBoundFromEvents(session) {
 	const events = sessionEvents(session);
 	for (let i = events.length - 1; i >= 0; i--) {
-		const b = asBoundEvent(events[i]);
-		if (b) return b;
+		const ev = events[i];
+		if (!ev || ev.type !== "serenity/bound") continue;
+		const rec = asBoundRecord(ev.data);
+		if (rec) return rec;
 	}
 	return null;
 }
 /**
-* append 一条 `serenity/bound` 绑定事件（log-only，无 surfaceOp——元数据不进模型可见面）。
-* @param session 目标 dsh 会话（真实 Session；append 泛型经内部断言兼容——类型由
-*   `serenity/bound` 声明面保证，append 接受已声明事件）
+* 读取会话当前绑定（权威，latest-wins）：文件记录优先，无则回落旧事件形态。
+* 无绑定返回 null。
+*/
+function readLastBound(session) {
+	const path = bindingsPathFor(session);
+	const id = sessionHeader(session)?.id;
+	if (path && typeof id === "string") {
+		const rec = asBoundRecord(readBindingsFile(path).sessions[id]);
+		if (rec) return rec;
+	}
+	return readLegacyBoundFromEvents(session);
+}
+/**
+* 写入绑定（latest-wins 覆盖该会话记录）。
+*
+* 绑定持久化尽力而为：无法定位 CCC 根 / 无会话 id / 写盘失败 → 返回 false，不阻断主流程。
+* @param session 目标 dsh 会话（需 `header.id` + `header.cwd` 可定位 CCC 根）
 * @param action 绑定动作
 * @param rec 绑定记录（dirName + mdPath 必填；sessionId 可选展示码）
-* @returns 是否成功（append 抛错/会话不可用时 false——绑定失败不阻断主流程）
 */
 function appendBound(session, action, rec) {
-	if (!session || typeof session.append !== "function") return false;
+	const path = bindingsPathFor(session);
+	const id = sessionHeader(session)?.id;
+	if (!path || typeof id !== "string") return false;
 	try {
-		const append = session.append;
-		append(SESSION_BOUND_EVENT, {
+		const file = readBindingsFile(path);
+		file.sessions[id] = {
 			dirName: rec.dirName,
 			mdPath: rec.mdPath,
 			...rec.sessionId ? { sessionId: rec.sessionId } : {},
 			action,
 			at: Date.now(),
 			...rec.note ? { note: rec.note } : {}
-		});
+		};
+		writeBindingsFile(path, file);
 		return true;
 	} catch {
 		return false;
 	}
 }
 //#endregion
-export { useSession as C, summarize as S, resolveSessionByTitle as _, archiveSessions as a, setActiveSessionInfo as b, extractSessionMdPathFromText as c, getActiveSessionInfo as d, healthCheck as f, readActiveSessionMd as g, qaCheck as h, SESSION_ACTIONS as i, findLatestActiveSessionMd as l, parseSessionContextFromEvents as m, readLastBound as n, closeSession as o, listSessions as p, DEFAULT_SESSION_SCOPE as r, createSession as s, appendBound as t, findSession as u, sessionEvents as v, showSession as x, sessionsRoot as y };
+export { summarize as C, showSession as S, readActiveSessionMd as _, archiveSessions as a, sessionsRoot as b, createSession as c, findSession as d, getActiveSessionInfo as f, qaCheck as g, parseSessionContextFromEvents as h, SESSION_ACTIONS as i, extractSessionMdPathFromText as l, listSessions as m, readLastBound as n, clearActiveSessionInfo as o, healthCheck as p, DEFAULT_SESSION_SCOPE as r, closeSession as s, appendBound as t, findLatestActiveSessionMd as u, resolveSessionByTitle as v, useSession as w, setActiveSessionInfo as x, sessionEvents as y };

package/lib/session-bound.d.ts

@@ -1,47 +1,29 @@
 /**
- * session-bound.ts — SESSION 绑定持久化（serenity/bound 会话事件）
+ * session-bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
  *
  * 目标（S142 用户拍板，方案 v1.0）：让「dsh 会话（载体）↔ SESSION（宁静号轨迹）」
  * 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 logbook rebuild 后
  * 自行更换 SESSION。
  *
- * 机制（DSH 原生，零改 harness）：
- *   `SessionEventMap` 是 merge-extensible（先例：dsh-compaction 扩展 compaction/*；
- *   dsp 已在 append compaction/prune）——插件可 declare module 自定义事件，
- *   `Session.append(type, data)` 将其写入会话 append-only 日志，随 session.jsonl
- *   持久化落盘，进程重启后 snapshotEvents() 可完整读取。
+ * 存储形态（v1.30.6 起，S142 review F-01）：绑定**不再写入 dsh 会话日志**。
+ * 原因（宿主契约实证）：dsp 的自定义事件 `serenity/bound` 既不在宿主的
+ * `KNOWN_SESSION_EVENT_TYPES`（生成静态集，明确说明 out-of-repo 插件事件不在其中），
+ * 而 `Session.append` 构造事件时只写 `{type,seq,time,data,surfaceOp?,sourceEventSeqs?}`
+ * ——**没有写入 envelope `ignorable` 标记的通道**；宿主的 `assertEventsSupported`
+ * （session-persistence/coordinator.ts:1248-1252，调用点含恢复/HMR 路径）会拒绝任何
+ * "未知且非 ignorable" 的事件 → 含该事件的会话在冷加载时可能抛
+ * `SessionFormatUnsupportedError`。v1.29.1~v1.30.5 的设计文档虽写明要带
+ * `ignorable: true`（docs/session-binding-hardening-research.md:53），但类型层声明
+ * 不等于持久层标记，实际从未落盘。
  *
- * 权威绑定 = 会话日志中**最后一条** `serenity/bound`（append-only latest-wins）。
- * 本事件是 log-only 元数据（无 surfaceOp——永不上模型可见面，不进系统提示词）。
+ * 现形态：每 CCC 一个 JSON 文件 `AGENT_SESSIONS/.bindings.json`（原子写：tmp + rename），
+ * 以 dsh 会话 id 为键，latest-wins 覆盖。**向后兼容**：读取时若文件中无该会话记录，
+ * 仍回落到扫描会话日志中的旧 `serenity/bound` 事件（老会话的绑定不丢）。
  *
  * 编码无关（U4）：绑定锚 = **完整 AGENT_SESSIONS 目录名**（磁盘唯一存在），
  * sessionId（S###/apaas-xxx/自定义）仅是派生展示字段——绝不假设 S 前缀。
  */
-import type { Session } from '@deepseek-ai/dsh-session';
-import type { SessionEventMap } from '@deepseek-ai/dsh-session/types';
-declare module '@deepseek-ai/dsh-session/types' {
-    interface SessionEventMap {
-        /**
-         * Serenity SESSION binding — authoritative; appended on every binding change.
-         * Code-agnostic (keyed by full dir name), log-only (no surfaceOp).
-         */
-        'serenity/bound': {
-            /** Full AGENT_SESSIONS dir name — the ONLY hard identity. */
-            dirName: string;
-            /** SESSION.md absolute path. */
-            mdPath: string;
-            /** Display code when parseable (S142 / apaas-26116 / custom); informational. */
-            sessionId?: string;
-            /** Why this binding record was written. */
-            action: 'activate' | 'switch' | 'create' | 'rebuild' | 'reconcile' | 'release';
-            /** Epoch ms. */
-            at: number;
-            /** Optional reason (e.g. 'auto from title'). */
-            note?: string;
-        };
-    }
-}
-export type SessionBoundAction = SessionEventMap['serenity/bound']['action'];
+export type SessionBoundAction = 'activate' | 'switch' | 'create' | 'rebuild' | 'reconcile' | 'release';
 export interface SessionBoundRecord {
     dirName: string;
     mdPath: string;
@@ -50,29 +32,28 @@ export interface SessionBoundRecord {
     at: number;
     note?: string;
 }
-/** 事件 type 常量（声明 + 读取共用） */
+/** 旧形态事件类型（v1.29.1~v1.30.5 写入会话日志；v1.30.6 起只读不写——兼容存量绑定） */
 export declare const SESSION_BOUND_EVENT: "serenity/bound";
+/** 绑定文件相对 CCC 根的路径 */
+export declare const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
+/** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
+export declare function bindingsPathFor(session: unknown): string | null;
 /**
- * 读取会话日志中**最后一条** `serenity/bound`（权威绑定，latest-wins）。
- * 尾到头扫描（时间序最新在后）；无 bound 事件返回 null。
- * 纯逻辑零 DSH 依赖（经 sessionEvents helper 读 snapshotEvents/events 兜底）。
+ * 读取会话当前绑定（权威，latest-wins）：文件记录优先，无则回落旧事件形态。
+ * 无绑定返回 null。
  */
 export declare function readLastBound(session: unknown): SessionBoundRecord | null;
-/**
- * 判定会话日志是否已有任何 bound 事件（供 reconcile 判定：无绑定才标题升级）。
- */
+/** 判定会话是否已有绑定（供 reconcile 判定：无绑定才标题升级）。 */
 export declare function hasAnyBound(session: unknown): boolean;
 /**
- * append 一条 `serenity/bound` 绑定事件（log-only，无 surfaceOp——元数据不进模型可见面）。
- * @param session 目标 dsh 会话（真实 Session；append 泛型经内部断言兼容——类型由
- *   `serenity/bound` 声明面保证，append 接受已声明事件）
+ * 写入绑定（latest-wins 覆盖该会话记录）。
+ *
+ * 绑定持久化尽力而为：无法定位 CCC 根 / 无会话 id / 写盘失败 → 返回 false，不阻断主流程。
+ * @param session 目标 dsh 会话（需 `header.id` + `header.cwd` 可定位 CCC 根）
  * @param action 绑定动作
  * @param rec 绑定记录（dirName + mdPath 必填；sessionId 可选展示码）
- * @returns 是否成功（append 抛错/会话不可用时 false——绑定失败不阻断主流程）
  */
-export declare function appendBound(session: Session | {
-    append: (type: string, data: unknown) => unknown;
-} | null | undefined, action: SessionBoundAction, rec: {
+export declare function appendBound(session: unknown, action: SessionBoundAction, rec: {
     dirName: string;
     mdPath: string;
     sessionId?: string;

package/lib/{settings-section-BfVxgCZy.js → settings-section-BPk0e1du.js}

@@ -1,4 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { a as hostSettings } from "./access-CdL6BAYj.js";
 import z from "@deepseek-ai/schemastery";
 //#region src/settings-section.ts
 var settings_section_exports = /* @__PURE__ */ __exportAll({
@@ -39,6 +40,8 @@ function entryDefaults(config) {
 }
 /** 运行时源（installSettingsSection 注入：settings scope 或 entry fallback） */
 let simpleSource = null;
+/** 缺 settings provider 的告警去重（进程级一次；降级路径可能被多次注册调用） */
+let warnedNoSettingsProvider = false;
 /** 进程级默认（无 settings 服务时的兜底） */
 function defaultSimpleSettings() {
 	return {
@@ -79,11 +82,15 @@ function registerSettingsSection(ctx, config) {
 			} catch {}
 		}
 	};
-	const settingsAny = ctx.settings;
+	const settingsAny = hostSettings(ctx);
 	if (settingsAny) {
 		settingsAny.installSection.call(settingsAny, ctx, SERENITY_SETTINGS_NS, simpleSettingsSchema, entryDefaults(config), hooks);
 		return;
 	}
+	if (!warnedNoSettingsProvider) {
+		warnedNoSettingsProvider = true;
+		console.warn("[serenity-hooks] ✗ settings 服务不可用 → 简单配置降级为 entry 默认值（面板开关/阈值改动不生效；检查宿主 settings provider 是否装载）");
+	}
 	hooks.setSource(() => ({}));
 	hooks.onChange();
 }

package/lib/settings-section.d.ts

@@ -92,6 +92,8 @@ export declare const simpleSettingsSchema: z<Schemastery.ObjectS<{
 }>>;
 /** 从插件 Config 提取 entry 默认（settings base 层） */
 export declare function entryDefaults(config: SimpleConfigFragment): SerenitySimpleSettings;
+/** 测试辅助：重置"缺 settings provider"告警去重（生产零调用） */
+export declare function __resetSettingsWarningsForTest(): void;
 /** 进程级默认（无 settings 服务时的兜底） */
 export declare function defaultSimpleSettings(): SerenitySimpleSettings;
 /**

package/lib/{skiff-debug-gYigSgl_.js → skiff-debug-8pF60JBO.js}

@@ -1,7 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { a as findSerenityRoot, f as readHandymanConfig } from "./ccc-CX48YNUL.js";
-import { a as resolveRoleSystemPrompt, i as readSkiffRoles, n as buildSkiffBasePrompt, o as roleMsmWhitelist, r as isSkiffSessionId, u as trajectorySubset } from "./skiff-role-LW4tjF9L.js";
-import { b as setActiveSessionInfo, n as readLastBound, s as createSession, t as appendBound } from "./session-bound-p9oR9dj9.js";
+import { a as findSerenityRoot, f as readHandymanConfig } from "./ccc-DAsSHsub.js";
+import { a as resolveRoleSystemPrompt, i as readSkiffRoles, n as buildSkiffBasePrompt, o as roleMsmWhitelist, r as isSkiffSessionId, u as trajectorySubset } from "./skiff-role-DlrbHPLD.js";
+import { i as hostSessions, r as hostService, t as hostAgents } from "./access-CdL6BAYj.js";
+import { c as createSession, n as readLastBound, t as appendBound, x as setActiveSessionInfo } from "./session-bound-D2ANqVn-.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -210,6 +211,47 @@ function listActiveHandymen(root) {
 	return out;
 }
 //#endregion
+//#region src/agent-idle.ts
+/**
+* 等待 agent 空闲或销毁。
+* @param ctx 宿主插件上下文（事件通道来源）
+* @param agent 目标 agent
+* @returns 空闲、agent 销毁、或会话销毁时结算（永不 reject）
+*/
+function waitAgentIdle(ctx, agent) {
+	return new Promise((resolve) => {
+		let settled = false;
+		const disposers = [];
+		const finish = () => {
+			if (settled) return;
+			settled = true;
+			for (const dispose of disposers) try {
+				dispose();
+			} catch {}
+			resolve();
+		};
+		const subscribe = (name, cb) => {
+			try {
+				const off = ctx.on?.(name, cb);
+				if (typeof off === "function") disposers.push(off);
+			} catch {}
+		};
+		subscribe("agent/status", (payload) => {
+			const p = payload;
+			if (p?.agent === agent && p?.status === "idle") finish();
+		});
+		subscribe("agent/disposed", (payload) => {
+			if (payload?.agent === agent) finish();
+		});
+		const sessionId = agent.session?.id;
+		subscribe("session/disposed", (session) => {
+			const id = session?.id;
+			if (typeof id === "string" && id === sessionId) finish();
+		});
+		if (agent.status === "idle") finish();
+	});
+}
+//#endregion
 //#region src/skiff-core.ts
 const PLUGIN_SOURCE = {
 	kind: "plugin",
@@ -380,7 +422,7 @@ async function createSkiffAgent(ctx, root, roleName, role, defaultModel, session
 /** 取 live agent（DSH 文档：`ctx.agents.get(id)` 返回 bare Agent；会话 live 时 resume/create 均不可用） */
 function getLiveAgent(ctx, id) {
 	try {
-		return ctx.agents?.get?.(id);
+		return hostAgents(ctx)?.get?.(id);
 	} catch {
 		return;
 	}
@@ -462,22 +504,6 @@ async function createOrResumeAgent(ctx, id, root, model, setup, fixedId) {
 		};
 	}
 }
-/** 等待 agent 空闲（agent/status → idle）；无超时（agent 工作多久等多久，handyman 同款） */
-function waitIdle(ctx, agent) {
-	return new Promise((resolve) => {
-		let settled = false;
-		let dispose = () => {};
-		const finish = () => {
-			if (settled) return;
-			settled = true;
-			dispose();
-			resolve();
-		};
-		dispose = ctx.on("agent/status", (payload) => {
-			if (payload.agent === agent && payload.status === "idle") finish();
-		});
-	});
-}
 /**
 * 会话事件读取（v1.28.0 适配 0.1.2-rc.1）：rc.1 Session 移除 `.events` 属性 → `snapshotEvents()` 方法。
 * 兼容双形态（运行时 rc.1 snapshotEvents；测试替身 events）——同一函数两处语义，测试注入零侵入。
@@ -563,7 +589,7 @@ async function askSkiff(ctx, agent, question, eventsStart, options) {
 		}],
 		source: PLUGIN_SOURCE
 	}));
-	await waitIdle(ctx, agent);
+	await waitAgentIdle(ctx, agent);
 	const answer = lastAssistantText(agent);
 	const trajectory = options?.includeTrajectory === false ? [] : eventsToTrajectory(sessionEvents(agent.session).slice(before));
 	return {
@@ -2324,15 +2350,15 @@ async function discoverCccs(ctx, defaultRoot) {
 		if (r && !roots.includes(r)) roots.push(r);
 	};
 	try {
-		const registry = ctx.get?.("workspaceRegistry");
+		const registry = hostService(ctx, "workspaceRegistry");
 		for (const ws of registry?.list?.() ?? []) pushRoot(ws?.path);
 	} catch {}
 	if (roots.length === 0) try {
-		const sp = ctx.get?.("sessionPersistence");
+		const sp = hostService(ctx, "sessionPersistence");
 		for (const h of await sp?.list?.() ?? []) pushRoot(h?.cwd);
 	} catch {}
 	if (roots.length === 0) try {
-		const sessions = ctx.sessions;
+		const sessions = hostSessions(ctx);
 		for (const s of sessions?.list?.() ?? []) pushRoot(s?.header?.cwd);
 	} catch {}
 	if (!roots.includes(defaultRoot)) roots.unshift(defaultRoot);
@@ -2748,4 +2774,4 @@ async function handle(ctx, defaultRoot, webPort, req, res) {
 	}
 }
 //#endregion
-export { readProgress as C, writeProgress as D, writeFailedStatus as E, skiffRoleFor$1 as O, newStopToken as S, splitModel as T, workspaceTrajectoryLine as _, startSkiffDebugServer as a, handymanProgressPaths as b, askSkiff as c, getSkiffAgent as d, skiffMsmGate as f, unregisterSkiffSession as g, skiffTrajectoryEnabled as h, skiff_debug_exports as i, createSkiffAgent as l, skiffSessionSnapshot as m, jscSafeJsonText as n, stopSkiffDebugServer as o, skiffSessionInfo as p, renderSkiffMarkdown as r, stripThink as s, discoverCccs as t, ensureSkiffSession as u, HANDYMAN_GUIDE as v, requireWhitelistedModel as w, listActiveHandymen as x, buildRoundPrompt as y };
+export { newStopToken as C, writeFailedStatus as D, splitModel as E, writeProgress as O, listActiveHandymen as S, requireWhitelistedModel as T, workspaceTrajectoryLine as _, startSkiffDebugServer as a, buildRoundPrompt as b, askSkiff as c, getSkiffAgent as d, skiffMsmGate as f, unregisterSkiffSession as g, skiffTrajectoryEnabled as h, skiff_debug_exports as i, skiffRoleFor$1 as k, createSkiffAgent as l, skiffSessionSnapshot as m, jscSafeJsonText as n, stopSkiffDebugServer as o, skiffSessionInfo as p, renderSkiffMarkdown as r, stripThink as s, discoverCccs as t, ensureSkiffSession as u, waitAgentIdle as v, readProgress as w, handymanProgressPaths as x, HANDYMAN_GUIDE as y };

package/lib/{skiff-role-LW4tjF9L.js → skiff-role-DlrbHPLD.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { m as resolveInside, p as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-CX48YNUL.js";
+import { m as resolveInside, p as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
 import { existsSync } from "node:fs";
 //#region src/skiff-role.ts
 /**
@@ -54,7 +54,9 @@ function readSkiffRoles(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
 				systemPromptFile: typeof role.systemPromptFile === "string" ? role.systemPromptFile : void 0
 			});
 		}
-	} catch {}
+	} catch (err) {
+		console.warn(`[serenity-hooks] ✗ skiff 角色配置读取失败（按无角色继续）: ${String(err?.message ?? err)}`);
+	}
 	return out;
 }
 function trajectorySubset(role) {

package/lib/tools/handyman.d.ts

@@ -12,7 +12,7 @@
  *
  * 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
  * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 →
- * 未完成继续下一轮；followup/waitIdle 抛错（非正常停止）→ dispose 并重新 create agent
+ * 未完成继续下一轮；followup/等待空闲抛错（非正常停止）→ dispose 并重新 create agent
  * （重启计数，≤100），同一轮重试。工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
  *
  * preset 继承 + 工具收窄：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐

package/lib/tools/kit.d.ts

@@ -1,4 +1,9 @@
 /**
  * kit.ts — dashboard 真实 DSH 工具定义（defineTool）（v1.30：acc_kit → dashboard）
  */
-export declare const kitTool: import("@deepseek-ai/dsh-tools").ToolDefinition;
+import type { Context } from 'cordis';
+/**
+ * dashboard 工具（v1.30.7：闭包捕获 ctx → health 可附宿主契约探针 F-05）。
+ * ctx 仅用于**只读探针**（`ctx.get` / 属性读取），无副作用。
+ */
+export declare function createKitTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/{weixin-route-jA0qENOf.js → weixin-route-BJ4g4ZNq.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-CX48YNUL.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { createHash } from "node:crypto";
@@ -77,7 +77,9 @@ function checkLocalstoreGitCompliance(root) {
 		reason: `localstore.json must not be committed (localstore.gitTrack=deny default) but .gitignore does not cover it — add ${LOCALSTORE_FILENAME} to .gitignore (or set localstore.gitTrack=allow to explicitly permit)`
 	};
 }
-/** 读取全文件（顶层分节）；文件不存在/坏 JSON 返回空 */
+/** 已告警的坏 localstore 路径（进程级去重；F-07：凭据文件损坏不得静默） */
+const warnedBrokenStores = /* @__PURE__ */ new Set();
+/** 读取全文件（顶层分节）；文件不存在 → 空；**坏 JSON → 空 + 响亮告警**（每路径一次） */
 function readAll(root) {
 	const p = localstorePath(root);
 	if (!existsSync(p)) return {};
@@ -85,7 +87,11 @@ function readAll(root) {
 		const v = JSON.parse(readFileSync(p, "utf-8").replace(/^\uFEFF/, ""));
 		if (v && typeof v === "object" && !Array.isArray(v)) return v;
 		return {};
-	} catch {
+	} catch (err) {
+		if (!warnedBrokenStores.has(p)) {
+			warnedBrokenStores.add(p);
+			console.warn(`[serenity-hooks] ✗ localstore 解析失败，已按空存储继续（其中凭据/配置对工具表现为"未设置"，请修 JSON）: ${p} — ${String(err?.message ?? err)}`);
+		}
 		return {};
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.30.4",
+  "version": "1.30.8",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {