@shgroup/dsh-serenity-hooks 1.17.5 → 1.18.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.17.5",
+  "version": "1.18.0",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫/会话落盘）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/index.js

@@ -3504,6 +3504,257 @@ const localstoreTool = defineTool({
 	}
 });
 //#endregion
+//#region src/seams/bootstrap.ts
+/** 默认首请求工具集：dsp 平台 Minimal 等价核心（anchored 是 bash+str_replace_editor） */
+const DEFAULT_BOOTSTRAP_TOOLS = [
+	"read",
+	"write",
+	"edit",
+	"glob",
+	"grep"
+];
+/** 默认剥离的自动注入源（anchored 默认：可用技能目录提醒 + 工作区指令摘要） */
+const DEFAULT_SUPPRESSED_SOURCES = ["skill-catalog", "agent-instructions"];
+/** 默认 compaction 恢复工作集（anchored 默认 read/write/edit/glob/grep/todo_write/ask_user_question） */
+const DEFAULT_COMPACTION_TOOLS = [
+	"read",
+	"write",
+	"edit",
+	"glob",
+	"grep",
+	"todo_write"
+];
+/** 默认首轮锚定问题（用户指定：介绍宁静号，200 字以内） */
+const DEFAULT_ANCHOR_MESSAGE = "请介绍当前宁静号，它是什么，为了什么，200字以内回答";
+/** 构建一个 epoch 感知晋升跟踪器（纯逻辑，可单测） */
+function createEpochPromotion(promoteEvents) {
+	/** sessionId -> { boundary, promoted } */
+	const state = /* @__PURE__ */ new Map();
+	const sessionIdOf = (session) => {
+		if (session && typeof session === "object") {
+			const id = session.id;
+			if (typeof id === "string") return id;
+		}
+	};
+	const scan = (session) => {
+		let boundary = -1;
+		let promoted = false;
+		const events = session?.events;
+		if (Array.isArray(events)) for (const event of events) {
+			const e = event;
+			const seq = typeof e.seq === "number" ? e.seq : 0;
+			if (e.type === "compaction/end") {
+				boundary = seq;
+				promoted = false;
+				continue;
+			}
+			if (promoteEvents.has(e.type) && seq > boundary) promoted = true;
+		}
+		const entry = {
+			boundary,
+			promoted
+		};
+		const sid = sessionIdOf(session);
+		if (sid) state.set(sid, entry);
+		return entry;
+	};
+	return {
+		status(agent) {
+			if (agent === void 0) return {
+				boundary: -1,
+				promoted: true
+			};
+			const session = agent.session;
+			if (session === void 0) return {
+				boundary: -1,
+				promoted: true
+			};
+			if ((session.header?.delegationDepth ?? 0) > 0) return {
+				boundary: -1,
+				promoted: true
+			};
+			const sid = sessionIdOf(session);
+			if (sid === void 0) return {
+				boundary: -1,
+				promoted: true
+			};
+			return state.get(sid) ?? scan(session);
+		},
+		observe(session, event) {
+			const sid = sessionIdOf(session);
+			if (sid === void 0) return;
+			const entry = state.get(sid);
+			if (entry === void 0) return;
+			const e = event;
+			const seq = typeof e.seq === "number" ? e.seq : 0;
+			if (e.type === "compaction/end") {
+				state.set(sid, {
+					boundary: seq,
+					promoted: false
+				});
+				return;
+			}
+			if (promoteEvents.has(e.type) && seq > entry.boundary && !entry.promoted) state.set(sid, {
+				...entry,
+				promoted: true
+			});
+		}
+	};
+}
+const PROMOTE_EVENTS = {
+	"tool-call": /* @__PURE__ */ new Set(["tool/call"]),
+	"assistant-message": /* @__PURE__ */ new Set(["assistant/message"]),
+	either: /* @__PURE__ */ new Set(["tool/call", "assistant/message"])
+};
+function stringList(value, field, fallback) {
+	if (value === void 0) return [...fallback];
+	if (!Array.isArray(value) || value.length === 0 || value.some((item) => typeof item !== "string" || item.length === 0)) throw new TypeError(`bootstrap: ${field} must be a non-empty array of non-empty strings`);
+	return [...new Set(value)];
+}
+function sourceList(value, field, fallback) {
+	if (value === void 0) return new Set(fallback);
+	if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item.length === 0)) throw new TypeError(`bootstrap: ${field} must be an array of non-empty strings`);
+	return new Set(value);
+}
+function resolveBootstrapSettings(opts) {
+	const promoteOn = opts.promoteOn ?? "either";
+	if (promoteOn !== "either" && promoteOn !== "tool-call" && promoteOn !== "assistant-message") throw new TypeError(`bootstrap: promoteOn must be one of "tool-call", "assistant-message", "either"; got ${JSON.stringify(promoteOn)}`);
+	return {
+		bootstrapTools: stringList(opts.bootstrapTools, "bootstrapTools", DEFAULT_BOOTSTRAP_TOOLS),
+		promoteEvents: PROMOTE_EVENTS[promoteOn],
+		suppressedSources: sourceList(opts.suppressedContextSources, "suppressedContextSources", DEFAULT_SUPPRESSED_SOURCES),
+		compactionTools: stringList(opts.compactionTools, "compactionTools", DEFAULT_COMPACTION_TOOLS),
+		anchorMessage: typeof opts.anchorMessage === "string" && opts.anchorMessage.length > 0 ? opts.anchorMessage : DEFAULT_ANCHOR_MESSAGE
+	};
+}
+/**
+* 注册 Anchored bootstrap 机制（按 agent cwd 动态解析 CCC 配置——多 CCC 架构，与 guards 同模式）：
+*  1. session/event 观察晋升信号（tool/call + assistant/message + compaction/end）
+*  2. system-prompt/assemble：bootstrap 阶段目录窄化到 bootstrapTools（+compaction 后 compactionTools）
+*  3. agent/pre-step：bootstrap 阶段剥离 suppressedSources 注入消息（降级保留全部）
+*
+* CCC 的 serenity.json 配置 `bootstrap.enabled: true` 才生效（否则零影响）；
+* 摘除 = 删除 index.ts 中本注册行（独立模块）。
+*/
+/** 从 agent 解析 CCC 根（宽松；无 agent/无 CCC 返回 null） */
+function agentRoot(agent) {
+	const cwd = agent?.session?.header?.cwd;
+	if (typeof cwd !== "string") return null;
+	return findSerenityRoot(cwd);
+}
+/** 按 agent cwd 解析 bootstrap 配置；未开启返回 null */
+function readBootstrapConfig(agent) {
+	const root = agentRoot(agent);
+	if (!root) return null;
+	const b = loadSerenityConfig(root).bootstrap;
+	if (!b?.enabled) return null;
+	return resolveBootstrapSettings({
+		bootstrapTools: b.bootstrapTools,
+		promoteOn: b.promoteOn,
+		suppressedContextSources: b.suppressedContextSources,
+		compactionTools: b.compactionTools,
+		anchorMessage: b.anchorMessage
+	});
+}
+function registerBootstrap(ctx) {
+	const settingsByRoot = /* @__PURE__ */ new Map();
+	const tracker = createEpochPromotion(/* @__PURE__ */ new Set(["tool/call", "assistant/message"]));
+	ctx.on("session/event", (session, event) => {
+		try {
+			tracker.observe(session, event);
+		} catch {}
+	});
+	ctx.on("agent/inbox/inserted", ({ agent, message }) => {
+		try {
+			const root = agentRoot(agent);
+			if (!root) return;
+			const settings = settingsByRoot.get(root) ?? readBootstrapConfig(agent);
+			if (!settings) return;
+			const session = agent.session;
+			if ((session?.header?.delegationDepth ?? 0) > 0) return;
+			if (session?.events?.some((event) => event.type === "user/message")) return;
+			if (message?.source?.kind === "plugin") return;
+			const inbox = agent.inbox;
+			if (!inbox?.prepend) return;
+			inbox.prepend("next-turn", {
+				id: `bootstrap-anchor-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+				role: "user",
+				content: [{
+					type: "text",
+					text: settings.anchorMessage
+				}],
+				source: {
+					kind: "plugin",
+					plugin: "dsh-serenity-hooks",
+					form: "notice",
+					summary: "bootstrap anchor turn"
+				}
+			});
+			warnOnce(`anchor turn injected: "${settings.anchorMessage.slice(0, 40)}…"`);
+		} catch {}
+	});
+	let warned = false;
+	const warnOnce = (message) => {
+		if (warned) return;
+		warned = true;
+		try {
+			console.warn(`[serenity-hooks] bootstrap: ${message}`);
+		} catch {}
+	};
+	ctx.on("system-prompt/assemble", async (_assembly, context, next) => {
+		const assembled = await next();
+		try {
+			const agent = context.agent;
+			const root = agentRoot(agent);
+			if (!root) return assembled;
+			const settings = settingsByRoot.get(root) ?? readBootstrapConfig(agent);
+			if (!settings) return assembled;
+			settingsByRoot.set(root, settings);
+			const status = tracker.status(agent);
+			if (status.promoted) return assembled;
+			const keep = new Set(settings.bootstrapTools);
+			if (status.boundary >= 0) for (const toolName of settings.compactionTools) keep.add(toolName);
+			const tools = assembled.tools;
+			if (!Array.isArray(tools)) return assembled;
+			const available = new Set(tools.map((tool) => tool.name).filter((n) => typeof n === "string"));
+			const missing = [...keep].filter((name) => !available.has(name));
+			if (missing.length > 0) {
+				warnOnce(`expected bootstrap tools missing=${JSON.stringify(missing)} — bootstrap disabled, full catalog exposed`);
+				return assembled;
+			}
+			return {
+				...assembled,
+				tools: tools.filter((tool) => typeof tool.name === "string" && keep.has(tool.name))
+			};
+		} catch (error) {
+			warnOnce(`assemble filter failed, exposing the full catalog: ${String(error?.message ?? error)}`);
+			return assembled;
+		}
+	});
+	ctx.on("agent/pre-step", async ({ agent }, next) => {
+		const decision = await next();
+		if (decision.kind === "reject") return decision;
+		try {
+			const settings = readBootstrapConfig(agent);
+			if (!settings) return decision;
+			if (tracker.status(agent).promoted || settings.suppressedSources.size === 0) return decision;
+			const messages = decision.messages;
+			if (!Array.isArray(messages)) return decision;
+			const kept = messages.filter((message) => {
+				const kind = message?.source?.kind;
+				return typeof kind !== "string" || !settings.suppressedSources.has(kind);
+			});
+			return kept.length === messages.length ? decision : {
+				...decision,
+				messages: kept
+			};
+		} catch (error) {
+			warnOnce(`pre-step context filter failed, keeping injected context: ${String(error?.message ?? error)}`);
+			return decision;
+		}
+	}, { prepend: true });
+}
+//#endregion
 //#region src/seams/loop.ts
 /** 解析当前 dsh 会话 scope 的活跃会话 SESSION.md 绝对路径；无标记/越界返回 null */
 function resolveActiveSession(root, scope = DEFAULT_SESSION_SCOPE) {
@@ -4435,7 +4686,8 @@ const Config = z.object({
 	api: z.boolean().default(true),
 	entrySkillMaxChars: z.number().default(3e4),
 	env: z.boolean().default(true),
-	opencodeSkills: z.boolean().default(true)
+	opencodeSkills: z.boolean().default(true),
+	bootstrap: z.boolean().default(false)
 });
 function apply(ctx, config) {
 	if (config.tools) {
@@ -4468,6 +4720,7 @@ function apply(ctx, config) {
 	if (config.api) registerStatusApi(ctx, { configPaths: config.serenityConfigPaths });
 	if (config.env) registerEnv(ctx);
 	if (config.opencodeSkills) registerOpencodeSkills(ctx);
+	if (config.bootstrap) registerBootstrap(ctx);
 }
 //#endregion
 export { Config, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.17.5",
+  "version": "1.18.0",
   "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": {