@shgroup/dsh-serenity-hooks 1.19.6 → 1.19.8

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.19.6",
+  "version": "1.19.8",
   "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,24 @@ 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.",
+		"",
+		"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",
@@ -4131,49 +4144,63 @@ function metaphorBlock() {
 		"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.",
+		"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. The Sea has no mistakes — only waters you have not yet charted.",
+		"",
+		"THE SHIP — the container itself",
+		"",
+		"1. The Hull → Bounded Space. 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. Deck Order → Entropy (H_op). Clutter on deck raises the cost of",
+		"   finding things. H_op ≤ H_critical = the ship stays afloat.",
+		"   Verdict: disorganized output = stones on deck.",
 		"",
-		"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.",
+		"3. Engineering Drawings → EAP. Every part dimensioned (E↑), the",
+		"   drawings rebuild the whole machine (R↓), the drawings are reusable",
+		"   (S↑). Verdict: an undimensioned part = unassemblable.",
 		"",
-		"2. The Logbook — SESSION.md is the only ship log. Unrecorded = unvoyaged.",
-		"   Verdict: finishing multi-step work without a progress record = a missing page.",
+		"THE VOYAGE — the cognitive lifecycle",
 		"",
-		"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. 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.",
 		"",
-		"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. 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.",
 		"",
-		"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. 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.",
 		"",
-		"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.",
+		"THE CREW — multi-agent collaboration",
 		"",
-		"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.",
+		"7. 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. 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.",
+		"8. 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 =",
+		"   cannot be rebuilt.",
 		""
 	].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 "";
@@ -4181,13 +4208,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");
 }
@@ -4270,17 +4305,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.6",
+  "version": "1.19.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": {