@shgroup/dsh-serenity-hooks 1.19.4 → 1.19.6

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.19.4",
+  "version": "1.19.6",
   "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）。
@@ -3674,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） */
@@ -3717,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;
@@ -3752,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;
@@ -3772,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",
@@ -3787,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;
@@ -3804,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`);
@@ -3827,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`);
@@ -3849,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,
@@ -4048,7 +4016,7 @@ function accBlock(root) {
 		"",
 		"=== Serenity ACC ===",
 		`ACC: dsh-serenity-hooks v${ACC_VERSION}`,
-		`CCC: ${cccName}  Root: ${root}`,
+		`CCC: ${cccName}`,
 		"",
 		"You are running inside a Concrete Cognitive Container (CCC) —",
 		"the runtime instance of an Abstract Cognitive Container (ACC).",
@@ -4115,10 +4083,6 @@ function cceBlock() {
 		"continuity condition: organization must at minimum match accumulation (ΔH_org ≥ ΔH_in).",
 		"Your actions affect H_op — unorganized output increases it, organization decreases it.",
 		"",
-		"CCE AND EAP: EAP governs artifact quality (how explicit to be). CCE governs temporal",
-		"coherence (how to maintain consistency over time). When structuring a document, apply",
-		"EAP (E↑ R↓ S↑). When maintaining cross-session coherence, apply CCE.",
-		"",
 		"THIS IS PERSISTENCE ENGINEERING: The goal is not to become greater. The goal is to",
 		"remain coherent. CCE has no terminal KPI — continuity is maintained while the entity",
 		"exists, not optimized toward an endpoint.",
@@ -4155,6 +4119,58 @@ function eapBlock() {
 	].join("\n");
 }
 /**
+* Metaphor 强化块（v1.19.6，S142）：宁静号宇宙隐喻域（船/海/罗盘/日志/船员）。
+* 隐喻是记忆钩子——形象唤起约束，前述块保持规则精确。每条隐喻 = 一个不可违背的
+* 物理事实 + 行为判据（verdict）。全英文（与 CCE/Constraints 一致）；独立块可
+* 回退；无 osp 对应（dsp 扩展，不进对齐断言参照）。
+*/
+function metaphorBlock() {
+	return [
+		"",
+		"=== Serenity Metaphor ===",
+		"The Serenity Universe — one ship, one sea. Metaphors are memory hooks:",
+		"they make constraints vivid, while the rules above stay precise. Each",
+		"metaphor is an unbreakable physical fact; violating one is a behavioral",
+		"violation.",
+		"",
+		"1. The Hull — You exist only inside this ship. Cargo outside the hull",
+		"   (knowledge the container has not accumulated) does not exist; do not",
+		"   assume it. Verdict: citing facts absent from the container = overload.",
+		"",
+		"2. The Logbook — SESSION.md is the only ship log. Unrecorded = unvoyaged.",
+		"   Verdict: finishing multi-step work without a progress record = a missing page.",
+		"",
+		"3. The Ship of Theseus — Planks may be replaced; the ship remains the same.",
+		"   The container can be rebuilt; identity persists. You are part of a",
+		"   trajectory, not a new ship. Verdict: acting without consulting precedent",
+		"   = a different ship.",
+		"",
+		"4. Deck Order — Clutter on deck raises the cost of finding things (H_op).",
+		"   H_op ≤ H_critical = the ship stays afloat. Verdict: disorganized output",
+		"   = stones on deck.",
+		"",
+		"5. Blueprint over Statue — Keep the blueprint, not the statue. Recording",
+		"   only conclusions without rationale = a statue with no blueprint,",
+		"   unreconstructable. Verdict: a decision record without reasons or",
+		"   alternatives = cannot be rebuilt.",
+		"",
+		"6. Crew Rotation — Other crew members will come after you. When you leave,",
+		"   leave a handover they can pick up (SESSION closed, open problems listed).",
+		"   Verdict: leaving without handover = abandoning ship.",
+		"",
+		"7. Harbor Inspection — The first anchor = departure inspection: confirm",
+		"   identity (ACC manifesto), logbook (SESSION), ballast (constraints)",
+		"   before setting sail. Verdict: skipping the anchor and working directly",
+		"   = sailing uninspected.",
+		"",
+		"8. Engineering Drawings — EAP = engineering drawings: every part",
+		"   dimensioned (E↑), the drawings rebuild the whole machine (R↓), the",
+		"   drawings are reusable (S↑). Verdict: an undimensioned part",
+		"   = unassemblable.",
+		""
+	].join("\n");
+}
+/**
 * 运行时状态块 1) safe-mode（S134 v1.16.12）：ON 时告知 agent（行为约束；机制仍由 guards 强制）。
 * 文案与实现逐项对应（guards.ts）：bash 禁用（restrict deny + decideGuard）、
 * 黑名单路径拦截、CCC 治理文件保护；write/edit 等其余工具保留（受路径逃逸/黑名单约束）。
@@ -4264,6 +4280,7 @@ function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
 	const state = [safeModeBlock(root), localstoreBlock(root)].filter((b) => b !== "").join("\n");
 	if (state) parts.push(state);
 	parts.push(eapBlock());
+	parts.push(metaphorBlock());
 	const skill = entrySkillSectionText(root);
 	if (skill) parts.push(skill);
 	const session = sessionBlock(root, scope);

package/package.json

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