add-coder 0.3.27 → 0.3.29

package/templates/.add-coder-src-hash.json

@@ -1,104 +1,76 @@
 {
-  "_version": "0.3.27",
-  "adapters/claude/hooks/doc-format-guard.sh": "cde3e3cf",
-  "adapters/claude/hooks/lib/common.sh": "6b6e875f",
-  "adapters/claude/hooks/lib/context-inject.sh": "177d3651",
-  "adapters/claude/hooks/lib/notify.sh": "914739e3",
-  "adapters/claude/hooks/lib/preload-templates.sh": "d6f5a818",
-  "adapters/claude/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/claude/hooks/lib/state-detect.sh": "4ccd5304",
-  "adapters/claude/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/claude/hooks/lib/vocabulary.sh": "3fa4f4a7",
-  "adapters/claude/hooks/notification.sh": "60bf9b01",
-  "adapters/claude/hooks/permission-denied.sh": "0a0605df",
-  "adapters/claude/hooks/permission-gate.sh": "bcca7732",
-  "adapters/claude/hooks/post-tool-failure.sh": "669b1b65",
-  "adapters/claude/hooks/post-tool-use.sh": "f54dd009",
-  "adapters/claude/hooks/pre-compact.sh": "4248f84f",
-  "adapters/claude/hooks/pre-tool-use.sh": "080f8979",
-  "adapters/claude/hooks/prompt-submit.sh": "7b9d52a7",
-  "adapters/claude/hooks/review-checklist.sh": "b383a983",
-  "adapters/claude/hooks/session-end.sh": "777ae808",
-  "adapters/claude/hooks/session-start.sh": "fd1d5e4f",
-  "adapters/claude/hooks/stop-check.sh": "2733e4f6",
-  "adapters/claude/hooks/stop-failure.sh": "e3d6c335",
-  "adapters/claude/hooks/subagent-guard.sh": "5922efba",
-  "adapters/claude/hooks/subagent-stop.sh": "0f89e28c",
+  "_version": "0.3.29",
+  "adapters/claude/hooks/doc-format-guard.ts": "2abf8013",
+  "adapters/claude/hooks/lib/claude-env.ts": "170b40ca",
+  "adapters/claude/hooks/notification.ts": "f14ca7b6",
+  "adapters/claude/hooks/permission-denied.ts": "8d773db9",
+  "adapters/claude/hooks/permission-gate.ts": "858f2dc6",
+  "adapters/claude/hooks/post-tool-failure.ts": "8c53fdd4",
+  "adapters/claude/hooks/post-tool-use.ts": "54c1840a",
+  "adapters/claude/hooks/pre-compact.ts": "fdb49e54",
+  "adapters/claude/hooks/pre-tool-use.ts": "c47cc5d5",
+  "adapters/claude/hooks/prompt-submit.ts": "c3847e2a",
+  "adapters/claude/hooks/review-checklist.ts": "94695330",
+  "adapters/claude/hooks/session-end.ts": "3c963eae",
+  "adapters/claude/hooks/session-start.ts": "3f762d49",
+  "adapters/claude/hooks/stop-check.ts": "967fd318",
+  "adapters/claude/hooks/stop-failure.ts": "b132759b",
+  "adapters/claude/hooks/subagent-guard.ts": "f33fc276",
+  "adapters/claude/hooks/subagent-stop.ts": "b016ebdf",
   "adapters/claude/mcp.json": "4ddc5120",
-  "adapters/claude/settings.json": "067ccc45",
+  "adapters/claude/settings.json": "9cf9603a",
   "adapters/codex/config.toml.example": "62c03d71",
-  "adapters/codex/hooks/doc-format-guard.sh": "b4bfdc53",
-  "adapters/codex/hooks/lib/common.sh": "1452227a",
-  "adapters/codex/hooks/lib/context-inject.sh": "c650d3ad",
-  "adapters/codex/hooks/lib/notify.sh": "6138e686",
-  "adapters/codex/hooks/lib/preload-templates.sh": "921448e8",
-  "adapters/codex/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/codex/hooks/lib/state-detect.sh": "9e33aa27",
-  "adapters/codex/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/codex/hooks/lib/vocabulary.sh": "16b6bf8b",
-  "adapters/codex/hooks/notification.sh": "ab9c9d99",
-  "adapters/codex/hooks/permission-gate.sh": "bcca7732",
-  "adapters/codex/hooks/post-tool-failure.sh": "669b1b65",
-  "adapters/codex/hooks/post-tool-use.sh": "d2d5824d",
-  "adapters/codex/hooks/pre-compact.sh": "6164c007",
-  "adapters/codex/hooks/pre-tool-use.sh": "14384656",
-  "adapters/codex/hooks/prompt-submit.sh": "bc6616c0",
-  "adapters/codex/hooks/review-checklist.sh": "b383a983",
-  "adapters/codex/hooks/session-end.sh": "3cc8c346",
-  "adapters/codex/hooks/session-start.sh": "caf87b67",
-  "adapters/codex/hooks/stop-check.sh": "b00352dd",
-  "adapters/codex/hooks/subagent-guard.sh": "47d04662",
-  "adapters/codex/hooks/subagent-stop.sh": "0a34648b",
-  "adapters/codex/hooks.json": "dcfa21dc",
+  "adapters/codex/hooks/doc-format-guard.ts": "566b835f",
+  "adapters/codex/hooks/notification.ts": "a4fd2749",
+  "adapters/codex/hooks/permission-gate.ts": "15af671c",
+  "adapters/codex/hooks/post-tool-failure.ts": "bddd1f4e",
+  "adapters/codex/hooks/post-tool-use.ts": "a7a2fc6c",
+  "adapters/codex/hooks/pre-compact.ts": "c0671f9b",
+  "adapters/codex/hooks/pre-tool-use.ts": "3750e60b",
+  "adapters/codex/hooks/prompt-submit.ts": "625cdc5e",
+  "adapters/codex/hooks/review-checklist.ts": "9a664173",
+  "adapters/codex/hooks/session-end.ts": "7fcb6f86",
+  "adapters/codex/hooks/session-start.ts": "4eacd44f",
+  "adapters/codex/hooks/stop-check.ts": "ee1801dd",
+  "adapters/codex/hooks/subagent-guard.ts": "e5ccf88b",
+  "adapters/codex/hooks/subagent-stop.ts": "a27e6a9e",
+  "adapters/codex/hooks.json": "3c78fb72",
   "adapters/codex/settings.json": "44136fa3",
-  "adapters/qoder/hooks/doc-format-guard.sh": "64ce5ba8",
-  "adapters/qoder/hooks/lib/common.sh": "afbc44c8",
-  "adapters/qoder/hooks/lib/context-inject.sh": "177d3651",
-  "adapters/qoder/hooks/lib/notify.sh": "914739e3",
-  "adapters/qoder/hooks/lib/preload-templates.sh": "d6f5a818",
-  "adapters/qoder/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/qoder/hooks/lib/state-detect.sh": "4ccd5304",
-  "adapters/qoder/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/qoder/hooks/lib/vocabulary.sh": "3fa4f4a7",
-  "adapters/qoder/hooks/notification.sh": "7d4efea6",
-  "adapters/qoder/hooks/permission-gate.sh": "3bf27b1a",
-  "adapters/qoder/hooks/post-tool-failure.sh": "8bc7a0e4",
-  "adapters/qoder/hooks/post-tool-use.sh": "051cb6ed",
-  "adapters/qoder/hooks/pre-compact.sh": "092fa6cf",
-  "adapters/qoder/hooks/pre-tool-use.sh": "565cff92",
-  "adapters/qoder/hooks/prompt-submit.sh": "c96d0823",
-  "adapters/qoder/hooks/review-checklist.sh": "666831c8",
-  "adapters/qoder/hooks/session-end.sh": "c50339df",
-  "adapters/qoder/hooks/session-start.sh": "29a3e29a",
-  "adapters/qoder/hooks/stop-check.sh": "69fa9e50",
-  "adapters/qoder/hooks/subagent-guard.sh": "ce60eaac",
-  "adapters/qoder/hooks/subagent-stop.sh": "5a2c78c6",
+  "adapters/qoder/hooks/doc-format-guard.ts": "12e360db",
+  "adapters/qoder/hooks/lib/context-inject.ts": "aaee941a",
+  "adapters/qoder/hooks/lib/qoder-env.ts": "ec8c3243",
+  "adapters/qoder/hooks/lib/review-checklist.ts": "23a06b37",
+  "adapters/qoder/hooks/notification.ts": "01a25a5b",
+  "adapters/qoder/hooks/permission-gate.ts": "8478e48e",
+  "adapters/qoder/hooks/post-tool-failure.ts": "b9439d5c",
+  "adapters/qoder/hooks/post-tool-use.ts": "c7e9ce26",
+  "adapters/qoder/hooks/pre-compact.ts": "70a8e8f8",
+  "adapters/qoder/hooks/pre-tool-use.ts": "2f0cab18",
+  "adapters/qoder/hooks/prompt-submit.ts": "9050e0cb",
+  "adapters/qoder/hooks/review-checklist.ts": "cf4ac191",
+  "adapters/qoder/hooks/session-end.ts": "e9bf7cd4",
+  "adapters/qoder/hooks/session-start.ts": "eeb089e0",
+  "adapters/qoder/hooks/stop-check.ts": "53447287",
+  "adapters/qoder/hooks/subagent-guard.ts": "0c10171b",
+  "adapters/qoder/hooks/subagent-stop.ts": "b41e08af",
   "adapters/qoder/mcp.json": "b2075957",
-  "adapters/qoder/settings.json": "4bae3c9a",
+  "adapters/qoder/settings.json": "31799ee7",
   "adapters/qoder/sync-policy.json": "9cb6ff90",
-  "adapters/trae/hooks/doc-format-guard.sh": "81f2adc9",
-  "adapters/trae/hooks/lib/common.sh": "6b6e875f",
-  "adapters/trae/hooks/lib/context-inject.sh": "177d3651",
-  "adapters/trae/hooks/lib/notify.sh": "45811b53",
-  "adapters/trae/hooks/lib/preload-templates.sh": "d6f5a818",
-  "adapters/trae/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/trae/hooks/lib/state-detect.sh": "172b332c",
-  "adapters/trae/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/trae/hooks/lib/vocabulary.sh": "3fa4f4a7",
-  "adapters/trae/hooks/notification.sh": "f7aed25d",
-  "adapters/trae/hooks/permission-gate.sh": "bcca7732",
-  "adapters/trae/hooks/post-tool-failure.sh": "669b1b65",
-  "adapters/trae/hooks/post-tool-use.sh": "27123aee",
-  "adapters/trae/hooks/pre-compact.sh": "6164c007",
-  "adapters/trae/hooks/pre-tool-use.sh": "9265b8ac",
-  "adapters/trae/hooks/prompt-submit.sh": "a41371ea",
-  "adapters/trae/hooks/review-checklist.sh": "b383a983",
-  "adapters/trae/hooks/session-end.sh": "3cc8c346",
-  "adapters/trae/hooks/session-start.sh": "aa8faa0f",
-  "adapters/trae/hooks/stop-check.sh": "6190438c",
-  "adapters/trae/hooks/subagent-guard.sh": "47d04662",
-  "adapters/trae/hooks/subagent-stop.sh": "0a34648b",
-  "adapters/trae/hooks.json": "e5045c2c",
+  "adapters/trae/hooks/doc-format-guard.ts": "14968f12",
+  "adapters/trae/hooks/notification.ts": "f0b4b606",
+  "adapters/trae/hooks/permission-gate.ts": "c53aedc7",
+  "adapters/trae/hooks/post-tool-failure.ts": "4cd97dac",
+  "adapters/trae/hooks/post-tool-use.ts": "7b1e2f4f",
+  "adapters/trae/hooks/pre-compact.ts": "5de3b0fe",
+  "adapters/trae/hooks/pre-tool-use.ts": "a7486c97",
+  "adapters/trae/hooks/prompt-submit.ts": "95ebd771",
+  "adapters/trae/hooks/review-checklist.ts": "343bd699",
+  "adapters/trae/hooks/session-end.ts": "64ce383f",
+  "adapters/trae/hooks/session-start.ts": "d6b4fdc7",
+  "adapters/trae/hooks/stop-check.ts": "b33ad5e4",
+  "adapters/trae/hooks/subagent-guard.ts": "eab8cbd9",
+  "adapters/trae/hooks/subagent-stop.ts": "5a9d53bb",
+  "adapters/trae/hooks.json": "e9d9eae7",
   "adapters/trae/settings.json": "ca3d163b",
   "adapters/vscode/.github/hooks/error-occurred.json": "9caa13dc",
   "adapters/vscode/.github/hooks/post-tool-use.json": "bff9d4d8",
@@ -111,59 +83,66 @@
   "adapters/vscode/.github/hooks/subagent-stop.json": "47dbdd8d",
   "adapters/vscode/.github/hooks/user-prompt-submit.json": "3a608d62",
   "adapters/vscode/extensions.json": "0f4024c1",
-  "adapters/vscode/hooks/doc-format-guard.sh": "80d26470",
-  "adapters/vscode/hooks/lib/common.sh": "6b6e875f",
-  "adapters/vscode/hooks/lib/context-inject.sh": "177d3651",
-  "adapters/vscode/hooks/lib/notify.sh": "914739e3",
-  "adapters/vscode/hooks/lib/preload-templates.sh": "d6f5a818",
-  "adapters/vscode/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/vscode/hooks/lib/state-detect.sh": "10b7e404",
-  "adapters/vscode/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/vscode/hooks/lib/vocabulary.sh": "3fa4f4a7",
-  "adapters/vscode/hooks/notification.sh": "f90b62b5",
-  "adapters/vscode/hooks/permission-gate.sh": "bcca7732",
-  "adapters/vscode/hooks/post-tool-failure.sh": "355cfab1",
-  "adapters/vscode/hooks/post-tool-use.sh": "5f188718",
-  "adapters/vscode/hooks/pre-compact.sh": "a0908f0e",
-  "adapters/vscode/hooks/pre-tool-use.sh": "4bf878e7",
-  "adapters/vscode/hooks/prompt-submit.sh": "38d19373",
-  "adapters/vscode/hooks/review-checklist.sh": "b383a983",
-  "adapters/vscode/hooks/session-end.sh": "7b407b9f",
-  "adapters/vscode/hooks/session-start.sh": "ad724a3e",
-  "adapters/vscode/hooks/stop-check.sh": "382328b6",
-  "adapters/vscode/hooks/subagent-guard.sh": "5d0ea685",
-  "adapters/vscode/hooks/subagent-stop.sh": "dd19f712",
+  "adapters/vscode/hooks/doc-format-guard.ts": "38e71c50",
+  "adapters/vscode/hooks/notification.ts": "5eed547d",
+  "adapters/vscode/hooks/permission-gate.ts": "ad096bc1",
+  "adapters/vscode/hooks/post-tool-failure.ts": "f7bc81b3",
+  "adapters/vscode/hooks/post-tool-use.ts": "42146851",
+  "adapters/vscode/hooks/pre-compact.ts": "15e4a043",
+  "adapters/vscode/hooks/pre-tool-use.ts": "8e8e588d",
+  "adapters/vscode/hooks/prompt-submit.ts": "767b13d2",
+  "adapters/vscode/hooks/review-checklist.ts": "f5fb4557",
+  "adapters/vscode/hooks/session-end.ts": "acdd9f42",
+  "adapters/vscode/hooks/session-start.ts": "54b262b0",
+  "adapters/vscode/hooks/stop-check.ts": "7a69b075",
+  "adapters/vscode/hooks/subagent-guard.ts": "773dc2c8",
+  "adapters/vscode/hooks/subagent-stop.ts": "a614b97d",
   "adapters/vscode/launch.json": "f2b79855",
   "adapters/vscode/settings.json": "7cabd00e",
   "adapters/vscode/tasks.json": "654d7fbd",
   "core/agents/add-flow-guardian.md": "c3e650d2",
-  "core/docs/ADD-governance-claude-code.md": "56c9a3de",
-  "core/docs/ADD-governance-codex.md": "3ac11e63",
-  "core/docs/ADD-governance-qoder-cn.md": "1624a93a",
-  "core/docs/ADD-governance-trae.md": "cbad6b2d",
-  "core/docs/ADD-governance-vscode-copilot.md": "2c26c14c",
-  "core/hooks/doc-format-guard.sh": "922732c0",
-  "core/hooks/lib/common.sh": "6b6e875f",
-  "core/hooks/lib/context-inject.sh": "177d3651",
-  "core/hooks/lib/notify.sh": "45811b53",
-  "core/hooks/lib/preload-templates.sh": "d6f5a818",
-  "core/hooks/lib/session-end.sh": "29813cbc",
-  "core/hooks/lib/state-detect.sh": "172b332c",
-  "core/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "core/hooks/lib/vocabulary.sh": "3fa4f4a7",
-  "core/hooks/notification.sh": "f7aed25d",
-  "core/hooks/permission-gate.sh": "bcca7732",
-  "core/hooks/post-tool-failure.sh": "669b1b65",
-  "core/hooks/post-tool-use.sh": "27123aee",
-  "core/hooks/pre-compact.sh": "6164c007",
-  "core/hooks/pre-tool-use.sh": "e0c5376a",
-  "core/hooks/prompt-submit.sh": "a41371ea",
-  "core/hooks/review-checklist.sh": "b383a983",
-  "core/hooks/session-end.sh": "3cc8c346",
-  "core/hooks/session-start.sh": "aa8faa0f",
-  "core/hooks/stop-check.sh": "6190438c",
-  "core/hooks/subagent-guard.sh": "47d04662",
-  "core/hooks/subagent-stop.sh": "0a34648b",
+  "core/docs/ADD-governance-claude-code.md": "b11fabb9",
+  "core/docs/ADD-governance-codex.md": "7ce9443d",
+  "core/docs/ADD-governance-qoder-cn.md": "54d79441",
+  "core/docs/ADD-governance-trae.md": "ec2976ae",
+  "core/docs/ADD-governance-vscode-copilot.md": "ab7885a4",
+  "core/governance/audit-bridge.ts": "1a0d5ccd",
+  "core/governance/common.ts": "37570397",
+  "core/governance/context-inject.ts": "8ded8188",
+  "core/governance/doc-format-guard.ts": "70978fc9",
+  "core/governance/notification-router.ts": "526ee71c",
+  "core/governance/notify.ts": "b7e8543f",
+  "core/governance/permission-gate-router.ts": "e4fa8376",
+  "core/governance/post-tool-failure-router.ts": "7542b2a0",
+  "core/governance/post-tool-router.ts": "556f9200",
+  "core/governance/pre-compact-guard.ts": "e1c2b2e7",
+  "core/governance/pre-tool-guard.ts": "c64b7382",
+  "core/governance/preload-templates.ts": "cfd6d3ca",
+  "core/governance/prompt-router.ts": "15ca2987",
+  "core/governance/review-checklist-guard.ts": "b24568b1",
+  "core/governance/rules.ts": "ffd7b843",
+  "core/governance/session-end.ts": "108fc3f6",
+  "core/governance/session-start-guard.ts": "96666e11",
+  "core/governance/state-detect.ts": "55afc935",
+  "core/governance/stop-router.ts": "b59fb651",
+  "core/governance/subagent-guard-router.ts": "398fb80e",
+  "core/governance/subagent-stop-router.ts": "f331f59f",
+  "core/governance/subagent-stop.ts": "56101604",
+  "core/governance/vocabulary.ts": "477d762b",
+  "core/hooks/doc-format-guard.ts": "8d9b16a9",
+  "core/hooks/notification.ts": "00732f1c",
+  "core/hooks/permission-gate.ts": "32400e27",
+  "core/hooks/post-tool-failure.ts": "23c76f04",
+  "core/hooks/post-tool-use.ts": "9f3abfa1",
+  "core/hooks/pre-compact.ts": "ec87ebf1",
+  "core/hooks/pre-tool-use.ts": "8e1ee6ea",
+  "core/hooks/prompt-submit.ts": "eb0aabdd",
+  "core/hooks/review-checklist.ts": "c7b3bb50",
+  "core/hooks/session-end.ts": "b390ddb0",
+  "core/hooks/session-start.ts": "2a3f796c",
+  "core/hooks/stop-check.ts": "0c3fc40a",
+  "core/hooks/subagent-guard.ts": "37019300",
+  "core/hooks/subagent-stop.ts": "9eebd61f",
   "core/prisma/add.prisma": "a543cd84",
   "core/reports/REPORT-WORKFLOW.md": "03d39b21",
   "core/reports/boundary-runtime-report.md": "6fd8053f",
@@ -232,7 +211,7 @@
   "core/scripts/mcp-server/tools/gateway/check_add_route_status.ts": "4caf552c",
   "core/scripts/mcp-server/tools/gateway/check_doc_similarity.ts": "2cba51c5",
   "core/scripts/mcp-server/tools/gateway/check_dps.ts": "92020f8e",
-  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "71f74ba6",
+  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "7091a262",
   "core/scripts/mcp-server/tools/gateway/check_spec_sync.ts": "560a88ad",
   "core/scripts/mcp-server/tools/gateway/helpers.ts": "f8794a92",
   "core/scripts/mcp-server/tools/gateway/index.ts": "cffe9783",
@@ -240,7 +219,7 @@
   "core/scripts/mcp-server/tools/hitl.ts": "04b6b807",
   "core/scripts/mcp-server/tools/hook-event-report.ts": "1d825b3f",
   "core/scripts/mcp-server/tools/index.ts": "443128c8",
-  "core/scripts/mcp-server/tools/plan.ts": "b38bbccc",
+  "core/scripts/mcp-server/tools/plan.ts": "d20b300c",
   "core/scripts/mcp-server/tools/quality.ts": "c4634453",
   "core/scripts/mcp-server/tools/registrar.ts": "efd81b3a",
   "core/scripts/mcp-server/tools/review.ts": "65c35e31",
@@ -297,6 +276,5 @@
   "core/templates/tasks-template.md": "2b9d0d52",
   "core/templates/tasks-template.schema.json": "2e691c8a",
   "core/tools/README.md": "26a63460",
-  "core/vocabulary/add-governance-vocabulary.md": "ee9e2bd2",
-  "shared/hooks-lib/common.sh": "441eee52"
+  "core/vocabulary/add-governance-vocabulary.md": "ee9e2bd2"
 }

package/templates/adapters/claude/hooks/doc-format-guard.ts

@@ -0,0 +1,32 @@
+// doc-format-guard.ts — schema.json 驱动的 ADD 文档格式守卫（Claude 版，Task 3.1 子类最小化）
+// 继承 core DocFormatGuard；差异点仅两个（bash 原文 L87-104 逐字对照）:
+//   ① 内容探测链: 加载 [doc.adapter_content_rules] claude 独立链（构造参数 adapterName）
+//      ——「## 四、Handoff」分支前置 + simple-standard-plan-template.md 映射
+//   ② 无算法规则段（反作弊/HITL 表/handoff 冲突不校验）——override runAlgoChecks
+
+import { readFileSync } from "node:fs"
+import { DocFormatGuard } from "../../../core/governance/doc-format-guard.js"
+
+class ClaudeDocFormatGuard extends DocFormatGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "claude")
+  }
+
+  /** 差异点 ②: claude 版无算法规则段 */
+  protected override runAlgoChecks(_templateName: string, _filePath: string, _content: string): void {
+    // claude 版不执行算法化规则校验（bash 原文无此段）
+  }
+}
+
+// ── 主入口 ──
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+const guard = new ClaudeDocFormatGuard(PROJECT_DIR, MAGIC_DIR)
+let raw = ""
+try {
+  raw = readFileSync(0, "utf-8")
+} catch {
+  raw = ""
+}
+process.exitCode = guard.run(raw)

package/templates/adapters/claude/hooks/lib/claude-env.ts

@@ -0,0 +1,7 @@
+// lib/claude-env.ts — Claude 私有环境解析（CLAUDE_PROJECT_DIR 优先）
+// 契约: claude 端所有 hook 的 PROJECT_DIR 来源 = ${CLAUDE_PROJECT_DIR:-$PWD}
+
+/** Claude 项目目录解析（对齐 bash ${CLAUDE_PROJECT_DIR:-$PWD}） */
+export function resolveClaudeProjectDir(): string {
+  return process.env.CLAUDE_PROJECT_DIR || process.cwd()
+}

package/templates/adapters/claude/hooks/notification.ts

@@ -0,0 +1,24 @@
+// notification.ts — Notification 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core NotificationRouter，命名子类 ClaudeNotificationRouter:
+//   ① 探测循环（.claude/.qoder/.vscode/.add）与 reviews 提醒 = 基类（bash 原文逐字对齐）
+//   ② 兜底 magicDir = ".claude"（构造参数注入，claude 协议差异）
+//   ③ 提醒文本 = 基类默认（含 Plan 前缀，与 claude bash 原文一致）
+// 协议差异仅剩: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { NotificationRouter } from "../../../core/governance/notification-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+class ClaudeNotificationRouter extends NotificationRouter {
+  /** 协议差异封装: fallbackMagicDir = ".claude"（claude 端兜底，bash 原文逐字） */
+  constructor(projectDir: string) {
+    super(projectDir, ".claude")
+  }
+
+  // 当前无 override（提醒文本与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+const input = readHookInput()
+process.exit(new ClaudeNotificationRouter(process.env.PROJECT_DIR).run(input))

package/templates/adapters/claude/hooks/permission-denied.ts

@@ -0,0 +1,33 @@
+// permission-denied.ts — Claude Code PermissionDenied 拒绝记录 + 替代方案（Claude 独有事件）
+// 治理卡位 #14: 拒绝原因记录 + 替代方案注入
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? "unknown"
+}
+let reason = jsonGet(input, "reason")
+if (reason === "") {
+  reason = input.match(/"reason"\s*:\s*"([^"]*)"/)?.[1] ?? "权限被拒绝"
+}
+
+// 记录拒绝
+process.stderr.write(`[ADD PermissionDenied] ${toolName} 被拒绝: ${reason}\n`)
+
+// 按工具类型提供替代建议
+switch (toolName) {
+  case "Bash":
+    process.stderr.write("[ADD PermissionDenied] 建议: 使用安全的等价命令，或通过 permission-gate.sh 白名单放行\n")
+    break
+  case "Write":
+  case "Edit":
+    process.stderr.write("[ADD PermissionDenied] 建议: 检查目标路径是否在项目范围内，敏感文件（.env等）不可写入\n")
+    break
+  case "Read":
+    process.stderr.write("[ADD PermissionDenied] 建议: 该文件可能受读保护，尝试读取项目公有文件替代\n")
+    break
+}
+
+process.exit(0)

package/templates/adapters/claude/hooks/permission-gate.ts

@@ -0,0 +1,12 @@
+// permission-gate.ts — PermissionRequest 权限请求门禁（Claude 版，与 core 同构）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+
+// 高风险工具需要二次确认
+if (toolName === "Bash" || toolName === "Write" || toolName === "Edit") {
+  process.stdout.write(`[ADD PermissionGate] 高风险工具: ${toolName}，请确认操作。\n`)
+}
+process.exit(0)

package/templates/adapters/claude/hooks/post-tool-failure.ts

@@ -0,0 +1,4 @@
+// post-tool-failure.ts — PostToolUseFailure 工具失败后处理（Claude 版，与 core 同构）
+
+process.stdout.write("[ADD PostToolFailure] 工具调用失败，请检查错误信息并修复。\n")
+process.exit(0)

package/templates/adapters/claude/hooks/post-tool-use.ts

@@ -0,0 +1,17 @@
+// post-tool-use.ts — PostToolUse 入口薄壳（Claude 版，Task 4.1 能力对齐）
+// 继承 core PostToolRouter 无 override——六端实态核验（2026-08-14）:
+//   post-tool-use 六端均为纯文本 stderr（无协议形态差异），此前 claude 的
+//   「无 §1 DPS / 无 §2b-d / 增量修订文本」为 bash 时代能力漂移——统一收敛 core 全段。
+// 协议差异仅剩: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（claude-env 注入链）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+if (toolName === "") process.exit(0)
+
+process.exit(new PostToolRouter(process.env.PROJECT_DIR, process.env.MAGIC_DIR || ".claude").run(input, toolName))

package/templates/adapters/claude/hooks/pre-compact.ts

@@ -0,0 +1,10 @@
+// pre-compact.ts — 上下文压缩前 ADD 状态保存（Claude 版，Task 3.1 继承体系）
+// 治理逻辑: core PreCompactGuard（状态保存 + tpl 标记清理，与 core 同构）
+// 协议差异: PROJECT_DIR 来源 CLAUDE_PROJECT_DIR（依赖注入）
+
+import { PreCompactGuard } from "../../../core/governance/pre-compact-guard.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+
+process.exit(new PreCompactGuard().run())

package/templates/adapters/claude/hooks/pre-tool-use.ts

@@ -0,0 +1,81 @@
+// pre-tool-use.ts — PreToolUse 入口（Claude 版，Task 3.1 继承体系）
+// 继承 core PreToolUseGuard（模板方法固化治理流程）；仅 override 协议差异:
+//   ① 检测链: 构造传 adapterName="claude" → 加载 [guard.adapter_detectors] 独立链
+//   ② onBlock: 纯 stderr（无 askJson / 无 logBlock）+ exit 2
+//   ③ onNoPlanAllow: 输出同 core 但 exit 2（bash 原文 L73 exit $EXIT_BLOCK）→ Task 9.4.2 修复对齐 exit 0
+//   ④ onSensitiveDeny: 纯 stderr（无 denyJson）+ 事件 + exit 2
+//   ⑤ onOtherTool: ③ Read matcher 模板提示（claude 特有）
+
+import { detectActiveAdd, jsonGet, markDevAction, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { writeHookEvent } from "../../../core/governance/notify.js"
+import { PreToolUseGuard } from "../../../core/governance/pre-tool-guard.js"
+import { resolveClaudeProjectDir } from "./lib/claude-env.js"
+
+process.env.PROJECT_DIR = resolveClaudeProjectDir()
+const PROJECT_DIR = process.env.PROJECT_DIR
+
+const magicDir = tryResolveMagicDir()
+if (magicDir && !process.env.MAGIC_DIR) {
+  process.env.MAGIC_DIR = magicDir
+}
+const MAGIC_DIR = process.env.MAGIC_DIR || ""
+
+class ClaudePreToolUseGuard extends PreToolUseGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "claude")
+  }
+
+  /** ② §A 阻断: 纯 stderr（{{cmd}} 模板替换）+ 事件 + exit 2（无 askJson / logBlock） */
+  protected override onBlock(blocked: { reason: string; stderr: string }, command: string): number {
+    process.stderr.write(blocked.stderr.replaceAll("{{cmd}}", command))
+    writeHookEvent("pre-tool-use", "deny", command, blocked.reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** §A 放行后处理: bash 原文 L56 mark_dev_action（core 无此行为） */
+  protected override onSectionAPass(_command: string): void {
+    markDevAction()
+  }
+
+  /** ③ §B 无 Plan 放行: 输出同 core（提示 + allowJson + 事件）+ exit 0（Task 9.4.2 修复: bash 原文 exit 2 缺陷对齐 core） */
+  protected override onNoPlanAllow(toolName: string, filePath: string): number {
+    process.stderr.write("[ADD 提示] 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——首次创建场景放行，建议先执行 add-paradigm 生成 Plan+add-route\n")
+    process.stdout.write('{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","permissionDecisionReason":"无活跃 ADD Plan 但为 Plan/Spec/Review 写入（首次创建场景），提示而非拦截"}}\n')
+    writeHookEvent("pre-tool-use", "info", filePath, "无活跃 ADD Plan 下写入 Plan/Spec/Review（首次创建放行）", this.planKeyword, this.planStatus)
+    return 0
+  }
+
+  /** ④ §B 敏感文件: 纯 stderr（无 denyJson）+ 事件 + exit 2 */
+  protected override onSensitiveDeny(filePath: string): number {
+    process.stderr.write(`⛔ 敏感文件受保护，禁止写入: ${filePath}\n`)
+    writeHookEvent("pre-tool-use", "deny", filePath, "敏感文件受保护", this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ⑤ ③ Read matcher: 模板路径兜底提示（claude 特有） */
+  protected override onOtherTool(input: string, toolName: string): number {
+    if (toolName === "Read") {
+      const filePath = jsonGet(input, "file_path")
+      if (filePath.includes("templates/")) {
+        process.stderr.write("[ADD PreToolUse] 提示: 模板文件已通过 hook 预读到上下文，可跳过重复读取\n")
+      }
+    }
+    return 0
+  }
+}
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+}
+
+const guard = new ClaudePreToolUseGuard(PROJECT_DIR, MAGIC_DIR)
+
+if (toolName === "Bash") {
+  process.exit(guard.runSectionA(input))
+} else if (toolName === "Write" || toolName === "Edit" || toolName === "SearchReplace") {
+  process.exit(guard.runSectionB(input, toolName))
+} else {
+  process.exit(guard.runSectionC(input, toolName))
+}