@shgroup/dsh-serenity-hooks 1.19.3 → 1.19.5

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.19.3",
+  "version": "1.19.5",
   "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

@@ -3559,9 +3559,14 @@ const DEFAULT_COMPACTION_TOOLS = [
 	"grep",
 	"todo_write"
 ];
-/** 默认首轮锚定消息（用户指定：persona 设定 + we/us 人称——首轮模型以 we/us 自称，
-*  对齐 anchored 实测的 "we" 轨迹特征） */
-const DEFAULT_ANCHOR_MESSAGE = "You are a helpful software engineer assistant.The personal pronoun is us/we.";
+/**
+* 协议级锚定消息序列（用户确认固化，2026-08-24 S142）：任何 CCC 在抽象层都是
+* 宁静号/ACC——首轮锚定话语统一，无 CCC 配置面。两轮递进：
+*  ① ACC 身份 + EAP 原则 + we/us 人称 + 先锚定后行动
+*  ② 协作协议 5 条 + acknowledge 要求（只回确认，不做事）
+* 文本 = 原 home-serenity CCC 配置（anchorMessages），随零配置化固化进代码。
+*/
+const DEFAULT_ANCHOR_MESSAGES = ["You are the operator agent of Serenity — a cognitive container governed by the Abstract Cognitive Container (ACC) protocol.\nWe operate under the Explicit Abstraction Principle (EAP): the functional value of a thought equals its external reconstructability — every output we produce must be explicit (E↑), reconstructable (R↓), and stable (S↑).\nThe personal pronoun is us/we.\nWe anchor first, then act: the abstract layer precedes the concrete.\nPlease simply reply \"acknowledge\" — no action needed.", "Before we proceed, align on how we work:\n1. We read before we write — every decision grounds in what already exists in the container.\n2. Every output records its reasoning (R↓): decisions carry reasons and alternatives.\n3. We never jump levels — abstract layer first, then specifics.\n4. Every artifact we create is a durable cognitive anchor for the work that follows.\n5. We keep the container's state coherent (SESSION.md) as we advance.\nPlease simply reply \"acknowledge\" — no action needed."];
 /**
 * 构建一个 epoch 感知晋升跟踪器（纯逻辑，可单测）。
 * requiredSignals：晋升所需信号数（boundary 后累计；默认 1）。
@@ -3572,9 +3577,10 @@ const DEFAULT_ANCHOR_MESSAGE = "You are a helpful software engineer assistant.Th
 * 某些模型/协议（如 opencode-go-responses）的会话可能不产生标准
 * `assistant/message` 晋升信号 → 永不晋升 → bootstrap 阶段工具被裁空
 * （zeroTools 首请求 0 工具，ACC 工具不可见）。兜底：无论晋升信号是否
-* 到达，观察到的模型回复轮数（assistant/message 事件计数，独立于
-* promoteEvents）达到 maxRoundsFallback 即强制 promoted（开放完整工具）。
-* 正常模型锚定轮数（requiredSignals）通常 ≤ 2 < 默认兜底 3，不受影响。
+* 到达，观察到的模型 step 数（`step/start` 事件计数，平台稳定事件，
+* responses/completions 都触发，独立于 promoteEvents）达到 maxRoundsFallback
+* 即强制 promoted（开放完整工具）。正常模型锚定轮数（requiredSignals）
+* 通常 ≤ 2 < 默认兜底 3，不受影响。
 */
 function createEpochPromotion(promoteEvents, requiredSignals = 1, maxRoundsFallback = 3) {
 	/** sessionId -> { boundary, signalCount, rounds }（rounds = 兜底用回复轮计数） */
@@ -3601,7 +3607,7 @@ function createEpochPromotion(promoteEvents, requiredSignals = 1, maxRoundsFallb
 				continue;
 			}
 			if (promoteEvents.has(e.type) && seq > boundary) signalCount++;
-			if (e.type === "assistant/message" && seq > boundary) rounds++;
+			if (e.type === "step/start" && seq > boundary) rounds++;
 		}
 		const entry = {
 			boundary,
@@ -3663,7 +3669,7 @@ function createEpochPromotion(promoteEvents, requiredSignals = 1, maxRoundsFallb
 				return;
 			}
 			if (promoteEvents.has(e.type) && seq > entry.boundary) entry.signalCount++;
-			if (e.type === "assistant/message" && seq > entry.boundary) entry.rounds++;
+			if (e.type === "step/start" && seq > entry.boundary) entry.rounds++;
 			state.set(sid, entry);
 		}
 	};
@@ -3673,41 +3679,27 @@ const PROMOTE_EVENTS = {
 	"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)}`);
-	let anchorMessages;
-	if (Array.isArray(opts.anchorMessages)) {
-		if (opts.anchorMessages.length === 0 || opts.anchorMessages.some((m) => typeof m !== "string" || m.length === 0)) throw new TypeError(`bootstrap: anchorMessages must be a non-empty array of non-empty strings`);
-		anchorMessages = opts.anchorMessages;
-	} else anchorMessages = [typeof opts.anchorMessage === "string" && opts.anchorMessage.length > 0 ? opts.anchorMessage : DEFAULT_ANCHOR_MESSAGE];
+/** 协议固有 bootstrap 设置：zeroTools=true（首请求 0 工具纯文字锚定轮）、
+*  晋升信号仅 assistant/message（对齐 zero-anchored-standard）、
+*  requiredSignals = 锚定轮数（2 条消息 → 2 条回复后晋升）。无参——零配置面。 */
+function resolveBootstrapSettings() {
 	return {
-		bootstrapTools: stringList(opts.bootstrapTools, "bootstrapTools", DEFAULT_BOOTSTRAP_TOOLS),
-		promoteEvents: opts.zeroTools ? PROMOTE_EVENTS["assistant-message"] : PROMOTE_EVENTS[promoteOn],
-		requiredSignals: opts.zeroTools ? anchorMessages.length : 1,
-		suppressedSources: sourceList(opts.suppressedContextSources, "suppressedContextSources", DEFAULT_SUPPRESSED_SOURCES),
-		compactionTools: stringList(opts.compactionTools, "compactionTools", DEFAULT_COMPACTION_TOOLS),
-		anchorMessages,
-		zeroTools: opts.zeroTools === true
+		bootstrapTools: [...DEFAULT_BOOTSTRAP_TOOLS],
+		promoteEvents: PROMOTE_EVENTS["assistant-message"],
+		requiredSignals: DEFAULT_ANCHOR_MESSAGES.length,
+		suppressedSources: new Set(DEFAULT_SUPPRESSED_SOURCES),
+		compactionTools: [...DEFAULT_COMPACTION_TOOLS],
+		anchorMessages: [...DEFAULT_ANCHOR_MESSAGES],
+		zeroTools: true
 	};
 }
 /**
-* 注册 Anchored bootstrap 机制（按 agent cwd 动态解析 CCC 配置——多 CCC 架构，与 guards 同模式）：
-*  1. session/event 观察晋升信号（tool/call + assistant/message + compaction/end）
+* 注册 Anchored bootstrap 机制（协议固有，零配置面——S142；按 agent cwd 定位 CCC root，
+* 晋升状态按 root 隔离，但设置全局一致）：
+*  1. session/event 观察晋升信号（assistant/message + step/start 兜底 + 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） */
@@ -3716,31 +3708,16 @@ function agentRoot(agent) {
 	if (typeof cwd !== "string") return null;
 	return findSerenityRoot(cwd);
 }
-/** 按 agent cwd 解析 bootstrap 配置（总是生效——无 enabled 开关，用户明确"直接开启不能关"；
-*  CCC 的 serenity.json bootstrap 段仅用于调参数，缺省用默认设置） */
-function readBootstrapConfig(agent) {
-	const root = agentRoot(agent);
-	if (!root) return resolveBootstrapSettings({});
-	const b = loadSerenityConfig(root).bootstrap;
-	return resolveBootstrapSettings({
-		bootstrapTools: b?.bootstrapTools,
-		promoteOn: b?.promoteOn,
-		suppressedContextSources: b?.suppressedContextSources,
-		compactionTools: b?.compactionTools,
-		anchorMessage: b?.anchorMessage,
-		anchorMessages: b?.anchorMessages,
-		zeroTools: b?.zeroTools
-	});
-}
+/** 协议固有设置（零配置面）：所有 CCC 使用同一固化设置 */
+const SETTINGS = resolveBootstrapSettings();
 function registerBootstrap(ctx) {
-	const settingsByRoot = /* @__PURE__ */ new Map();
 	const trackers = /* @__PURE__ */ new Map();
 	/** 已锚定会话（进程内防重：子 agent 每会话只锚定一次） */
 	const anchoredSessions = /* @__PURE__ */ new Set();
-	const trackerFor = (root, settings) => {
+	const trackerFor = (root) => {
 		let t = trackers.get(root);
 		if (!t) {
-			t = createEpochPromotion(settings.promoteEvents, settings.requiredSignals);
+			t = createEpochPromotion(SETTINGS.promoteEvents, SETTINGS.requiredSignals);
 			trackers.set(root, t);
 		}
 		return t;
@@ -3751,16 +3728,12 @@ function registerBootstrap(ctx) {
 			if (typeof cwd !== "string") return;
 			const root = findSerenityRoot(cwd);
 			if (!root) return;
-			const settings = settingsByRoot.get(root) ?? readBootstrapConfig({ session });
-			settingsByRoot.set(root, settings);
-			trackerFor(root, settings).observe(session, event);
+			trackerFor(root).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 (!agentRoot(agent)) return;
 			const session = agent.session;
 			const depth = session?.header?.delegationDepth ?? 0;
 			const sid = typeof session?.id === "string" ? session.id : void 0;
@@ -3771,12 +3744,12 @@ function registerBootstrap(ctx) {
 			if (message?.source?.kind === "plugin") return;
 			const inbox = agent.inbox;
 			if (!inbox?.prepend) return;
-			for (let i = settings.anchorMessages.length - 1; i >= 0; i--) inbox.prepend("next-turn", {
+			for (let i = SETTINGS.anchorMessages.length - 1; i >= 0; i--) inbox.prepend("next-turn", {
 				id: `bootstrap-anchor-${Date.now()}-${Math.random().toString(36).slice(2, 8)}-${i}`,
 				role: "user",
 				content: [{
 					type: "text",
-					text: settings.anchorMessages[i]
+					text: SETTINGS.anchorMessages[i]
 				}],
 				source: {
 					kind: "plugin",
@@ -3786,7 +3759,7 @@ function registerBootstrap(ctx) {
 				}
 			});
 			if (sid !== void 0) anchoredSessions.add(sid);
-			warnOnce(`anchor turns injected: ${settings.anchorMessages.length} 条（${settings.anchorMessages[0].slice(0, 40)}…）`);
+			warnOnce(`anchor turns injected: ${SETTINGS.anchorMessages.length} 条（${SETTINGS.anchorMessages[0].slice(0, 40)}…）`);
 		} catch {}
 	});
 	let warned = false;
@@ -3803,19 +3776,17 @@ function registerBootstrap(ctx) {
 			const agent = context.agent;
 			const root = agentRoot(agent);
 			if (!root) return assembled;
-			const settings = settingsByRoot.get(root) ?? readBootstrapConfig(agent);
-			settingsByRoot.set(root, settings);
-			const status = trackerFor(root, settings).status(agent);
+			const status = trackerFor(root).status(agent);
 			if (status.promoted) return assembled;
 			const tools = assembled.tools;
 			if (!Array.isArray(tools)) return assembled;
 			const available = new Set(tools.map((tool) => tool.name).filter((n) => typeof n === "string"));
-			if (settings.zeroTools) {
+			if (SETTINGS.zeroTools) {
 				if (status.boundary < 0) return {
 					...assembled,
 					tools: []
 				};
-				const keep = new Set(settings.compactionTools);
+				const keep = new Set(SETTINGS.compactionTools);
 				const missing = [...keep].filter((name) => !available.has(name));
 				if (missing.length > 0) {
 					warnOnce(`expected compaction tools missing=${JSON.stringify(missing)} — bootstrap disabled, full catalog exposed`);
@@ -3826,8 +3797,8 @@ function registerBootstrap(ctx) {
 					tools: tools.filter((tool) => typeof tool.name === "string" && keep.has(tool.name))
 				};
 			}
-			const keep = new Set(settings.bootstrapTools);
-			if (status.boundary >= 0) for (const toolName of settings.compactionTools) keep.add(toolName);
+			const keep = new Set(SETTINGS.bootstrapTools);
+			if (status.boundary >= 0) for (const toolName of SETTINGS.compactionTools) keep.add(toolName);
 			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`);
@@ -3848,14 +3819,12 @@ function registerBootstrap(ctx) {
 		try {
 			const root = agentRoot(agent);
 			if (!root) return decision;
-			const settings = settingsByRoot.get(root) ?? readBootstrapConfig(agent);
-			settingsByRoot.set(root, settings);
-			if (trackerFor(root, settings).status(agent).promoted || settings.suppressedSources.size === 0) return decision;
+			if (trackerFor(root).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 typeof kind !== "string" || !SETTINGS.suppressedSources.has(kind);
 			});
 			return kept.length === messages.length ? decision : {
 				...decision,

package/package.json

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