@shgroup/dsh-serenity-hooks 1.19.7 → 1.19.9

package/dsh.plugin.json

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

@@ -4089,11 +4089,31 @@ function cceBlock() {
 		""
 	].join("\n");
 }
-/** 3) Constraints 块：逐字对齐 osp（Root + 文件边界 + shell + subagent + session-first） */
-function constraintsBlock(root) {
+/**
+* Principles 块（v1.19.8 合并，S142）：认知容器本体论（why）+ 操作边界（operational
+* boundaries）。原独立 Principles 与 Constraints 合并——同属容器约束体系，先原则
+* 后边界（从抽象到具体，重建视角 R↓）。**注意：Constraints 不再作为独立对齐块存在
+* （spec 修订：同步 osp compacting.ts——Constraints 内容并入本块，工具名仍为平台真实名）。**
+*/
+function principlesBlock(root) {
 	return [
 		"",
-		"=== Serenity Constraints ===",
+		"=== Serenity Principles ===",
+		"Why a cognitive container: all work is cognition — every artifact, decision,",
+		"and line of code is a product of thought; and from cognition, any work can",
+		"be built. In this frame, the world contains no errors — only insufficient",
+		"cognition. A setback is a gap to be filled (read, ask, research), not a",
+		"fault to be hidden. Never disguise or excuse what you do not know;",
+		"not-knowing is a state to be repaired, and reporting it is the first repair.",
+		"",
+		"MSM principles — machinery before improvisation:",
+		"- Determinism first: use a registered Mech before hand-rolling; reserve",
+		"  Semi-Mech for genuine judgment points.",
+		"- Single source of truth: an MSM is the only decoder of its own usage",
+		"  (--help/--schema); documents must not duplicate it.",
+		"- Registered to act: no tool exists unless it is on the manifest.",
+		"",
+		"Operational boundaries:",
 		`Root: ${root}`,
 		"  • File access — read/edit/write/grep/glob are confined to Root; paths outside Root are rejected (RR5)",
 		"  • Shell — use acc_msm by default. Note: bash may be disabled",
@@ -4134,7 +4154,7 @@ function metaphorBlock() {
 		"violation. The universe is structured in three layers — the Ship (the",
 		"container itself), the Voyage (the cognitive lifecycle), the Crew",
 		"(multi-agent collaboration); every metaphor maps to one protocol",
-		"constraint.",
+		"constraint. The Sea has no mistakes — only waters you have not yet charted.",
 		"",
 		"THE SHIP — the container itself",
 		"",
@@ -4151,30 +4171,42 @@ function metaphorBlock() {
 		"   drawings rebuild the whole machine (R↓), the drawings are reusable",
 		"   (S↑). Verdict: an undimensioned part = unassemblable.",
 		"",
+		"4. The Machinery → MSM (Mech & Semi-Mech). The ship's equipment is",
+		"   machinery: registered, deterministic, self-describing. Turn the",
+		"   crank of a Mech and the action is exact; the wheel with a helmsman",
+		"   (Semi-Mech) steers where judgment is needed. Verdict: hand-rolling",
+		"   what a machine already does = wasting the crew.",
+		"",
+		"5. The Manifest → Single Source of Truth. Every tool exists only if it",
+		"   is on the manifest (mech-registry); there is exactly one manifest.",
+		"   An MSM self-describes (--help/--schema) — the manifest is the only",
+		"   key. Verdict: duplicating a tool's usage in documents = two",
+		"   contradictory charts.",
+		"",
 		"THE VOYAGE — the cognitive lifecycle",
 		"",
-		"4. Harbor Inspection → First Anchor. The first anchor = departure",
+		"6. Harbor Inspection → First Anchor. 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.",
 		"",
-		"5. The Logbook → Session Tracking. SESSION.md is the only ship log.",
+		"7. The Logbook → Session Tracking. SESSION.md is the only ship log.",
 		"   Unrecorded = unvoyaged. Verdict: finishing multi-step work without",
 		"   a progress record = a missing page.",
 		"",
-		"6. The Ship of Theseus → Continuity. Planks may be replaced; the ship",
+		"8. The Ship of Theseus → Continuity. 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.",
 		"",
 		"THE CREW — multi-agent collaboration",
 		"",
-		"7. Crew Rotation → Multi-Agent Cognition. Other crew members will come",
+		"9. Crew Rotation → Multi-Agent Cognition. 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.",
 		"",
-		"8. Blueprint over Statue → Reconstruction > Preservation. Keep the",
+		"10. Blueprint over Statue → Reconstruction > Preservation. 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 =",
@@ -4183,9 +4215,11 @@ function metaphorBlock() {
 	].join("\n");
 }
 /**
-* 运行时状态块 1) safe-mode（S134 v1.16.12）：ON 时告知 agent（行为约束；机制仍由 guards 强制）。
-* 文案与实现逐项对应（guards.ts）：bash 禁用（restrict deny + decideGuard）、
-* 黑名单路径拦截、CCC 治理文件保护；write/edit 等其余工具保留（受路径逃逸/黑名单约束）。
+* 运行时状态块 1) safe-mode（S134 v1.16.12）：ON 时告知 agent。
+* v1.19.8 结构重排（S142 用户设计思路）：语义（为什么——无人值守自由）→
+* 机制（什么被禁用）→ 约束（不可做什么）。文案与实现逐项对应（guards.ts）：
+* bash 禁用（restrict deny + decideGuard）、黑名单路径拦截、CCC 治理文件保护；
+* write/edit 等其余工具保留（受路径逃逸/黑名单约束）。
 */
 function safeModeBlock(root) {
 	if (!isSafeModeOn(root)) return "";
@@ -4193,13 +4227,21 @@ function safeModeBlock(root) {
 	return [
 		"",
 		"=== Serenity Safe Mode ===",
-		"Safe mode is ON (enabled by the user): bash is disabled (hidden and blocked);",
-		"blacklist rules apply to file paths; CCC governance files (.serenity,",
-		".serenity-safe-on) are protected from agent writes. Other read/write tools",
-		"remain available, subject to path-escape and blacklist guards.",
+		"Safe mode is ON (enabled by the user). It makes the vessel unattended-capable —",
+		"the hull holds its course without a watch on deck: you may work with fuller",
+		"freedom, pushing work forward autonomously without pausing for approval at",
+		"every step. The guards are not chains; they are the ballast that lets you",
+		"sail unaccompanied.",
+		"",
+		"Operational details:",
+		"- bash is disabled (hidden and blocked)",
+		"- blacklist rules apply to file paths",
+		"- CCC governance files (.serenity, .serenity-safe-on) are protected from agent writes",
+		"- other read/write tools remain available, subject to path-escape and blacklist guards",
+		blacklist.length > 0 ? `\nActive blacklist rules: ${blacklist.map((b) => b.message ?? b.pattern).join(", ")}` : "",
+		"",
 		"Behavior constraints: do not attempt to bypass restrictions; do not write to",
 		"blacklisted paths or governance files.",
-		blacklist.length > 0 ? `\nActive blacklist rules: ${blacklist.map((b) => b.message ?? b.pattern).join(", ")}` : "",
 		""
 	].join("\n");
 }
@@ -4282,17 +4324,22 @@ function sessionBlock(root, scope = DEFAULT_SESSION_SCOPE) {
 		""
 	].join("\n");
 }
-/** 完整系统提示词注入文本：ACC + CCE + Constraints + EAP + SKILL 全文 + Session（osp 顺序 + EAP 扩展） */
+/**
+* 完整系统提示词注入文本（v1.19.8 结构精简，S142 重建视角 R↓）：
+* 身份（ACC）→ 世界模型（Metaphor）→ 信念/边界（Principles）→ 时间约束（CCE）
+* → 质量（EAP）→ 状态（SafeMode/Localstore）→ CCC 上下文（SKILL）→ 会话（Session）。
+* 认知展开顺序：我是谁 → 我所在的世界 → 为什么 → 如何一致 → 产物标准 → 当前状态 → 上下文。
+*/
 function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
 	const parts = [
 		accBlock(root),
+		metaphorBlock(),
+		principlesBlock(root),
 		cceBlock(),
-		constraintsBlock(root)
+		eapBlock()
 	];
 	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.7",
+  "version": "1.19.9",
   "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": {