add-coder 0.3.26 → 0.3.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.3.26",
+  "version": "0.3.28",
   "private": false,
   "description": "[codein2027](https://github.com/xiaomingming92/codein2027) - A complete scaffolding for building the ADD programming paradigm, the implementation layer for AI code governance. Core principle: Audit as Infrastructure. Breaks the black-box programming process and cross-session amnesia, evolving programming paradigms into an auditable, traceable, and convergent new era. npx-ready.\n\n[codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架——AI 代码治理的落地方案。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。npx 即用，人人可体验。",
   "repository": {
@@ -40,10 +40,10 @@
   "email": "wujixmm@gmail.com",
   "license": "AGPL-3.0-only",
   "dependencies": {
-    "@ariga/atlas": "^1.3.0",
     "@huggingface/transformers": "^3.8.1",
     "@modelcontextprotocol/server": "2.0.0",
     "commander": "^13.1.0",
+    "find-up": "^8.0.0",
     "smol-toml": "^1.7.0",
     "vector-cosine-similarity": "^1.8.0",
     "zod": "^4.4.3"
@@ -54,6 +54,7 @@
     "@prisma/client": "^7.0.0",
     "dotenv": "*",
     "prisma": "^7.0.0",
+    "pg": "^8.16.0",
     "tsx": ">=4",
     "vector-cosine-similarity": "^1.8.0"
   },
@@ -73,6 +74,9 @@
     "@prisma/adapter-pg": {
       "optional": false
     },
+    "pg": {
+      "optional": true
+    },
     "@huggingface/transformers": {
       "optional": false
     }
@@ -80,12 +84,18 @@
   "devDependencies": {
     "@eslint/js": "^9.39.4",
     "@types/node": "^22.20.1",
+    "@types/pg": "^8.20.4",
+    "esbuild": "0.27.7",
     "eslint": "^9.39.4",
+    "pg": "^8.22.0",
     "tsup": "^8.4.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.10"
   },
+  "optionalDependencies": {
+    "@ariga/atlas": "^1.3.0"
+  },
   "scripts": {
     "build": "tsup",
     "predev": "npm run db:ensure",
@@ -96,9 +106,10 @@
     "benchmark": "tsx scripts/benchmark/benchmark-sync.ts",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
-    "generate": "tsx src/caijuehub/transcribe.ts",
+    "generate": "tsx src/caijuehub/transcribe/index.ts",
     "podman-add-coder-up": "podman-compose --env-file .env.development -f podman-compose.add.yml up -d",
     "podman-add-coder-down": "podman-compose --env-file .env.development -f podman-compose.add.yml down",
-    "test": "vitest run"
+    "test": "vitest run",
+    "generate:check": "tsx scripts/generate-idempotency-check.ts"
   }
 }

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

@@ -1,103 +1,76 @@
 {
-  "_version": "0.3.26",
-  "adapters/claude/hooks/doc-format-guard.sh": "73f36a12",
-  "adapters/claude/hooks/lib/common.sh": "4f3e64ad",
-  "adapters/claude/hooks/lib/context-inject.sh": "cfc8c65e",
-  "adapters/claude/hooks/lib/notify.sh": "e0033e53",
-  "adapters/claude/hooks/lib/preload-templates.sh": "96dd67fe",
-  "adapters/claude/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/claude/hooks/lib/state-detect.sh": "b87dd85a",
-  "adapters/claude/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/claude/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "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": "2fe9e42c",
-  "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": "41bc519a",
-  "adapters/claude/hooks/stop-failure.sh": "e3d6c335",
-  "adapters/claude/hooks/subagent-guard.sh": "5922efba",
-  "adapters/claude/hooks/subagent-stop.sh": "0f89e28c",
+  "_version": "0.3.28",
+  "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/codex/hooks/doc-format-guard.sh": "aea5f606",
-  "adapters/codex/hooks/lib/common.sh": "4f3e64ad",
-  "adapters/codex/hooks/lib/context-inject.sh": "cfc8c65e",
-  "adapters/codex/hooks/lib/notify.sh": "e0033e53",
-  "adapters/codex/hooks/lib/preload-templates.sh": "96dd67fe",
-  "adapters/codex/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/codex/hooks/lib/state-detect.sh": "135bde23",
-  "adapters/codex/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/codex/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "adapters/codex/hooks/notification.sh": "f7aed25d",
-  "adapters/codex/hooks/permission-gate.sh": "bcca7732",
-  "adapters/codex/hooks/post-tool-failure.sh": "669b1b65",
-  "adapters/codex/hooks/post-tool-use.sh": "27123aee",
-  "adapters/codex/hooks/pre-compact.sh": "6164c007",
-  "adapters/codex/hooks/pre-tool-use.sh": "797664b8",
-  "adapters/codex/hooks/prompt-submit.sh": "a41371ea",
-  "adapters/codex/hooks/review-checklist.sh": "b383a983",
-  "adapters/codex/hooks/session-end.sh": "3cc8c346",
-  "adapters/codex/hooks/session-start.sh": "aa8faa0f",
-  "adapters/codex/hooks/stop-check.sh": "dc4829be",
-  "adapters/codex/hooks/subagent-guard.sh": "47d04662",
-  "adapters/codex/hooks/subagent-stop.sh": "0a34648b",
-  "adapters/codex/hooks.json": "d9c99f6b",
+  "adapters/claude/settings.json": "9cf9603a",
+  "adapters/codex/config.toml.example": "62c03d71",
+  "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": "6f8aa245",
-  "adapters/qoder/hooks/lib/common.sh": "4f3e64ad",
-  "adapters/qoder/hooks/lib/context-inject.sh": "cfc8c65e",
-  "adapters/qoder/hooks/lib/notify.sh": "e0033e53",
-  "adapters/qoder/hooks/lib/preload-templates.sh": "96dd67fe",
-  "adapters/qoder/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/qoder/hooks/lib/state-detect.sh": "b87dd85a",
-  "adapters/qoder/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/qoder/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "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": "336f262e",
-  "adapters/qoder/hooks/review-checklist.sh": "666831c8",
-  "adapters/qoder/hooks/session-end.sh": "c50339df",
-  "adapters/qoder/hooks/session-start.sh": "a4307a78",
-  "adapters/qoder/hooks/stop-check.sh": "974db988",
-  "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": "5f528aff",
-  "adapters/trae/hooks/lib/common.sh": "4f3e64ad",
-  "adapters/trae/hooks/lib/context-inject.sh": "cfc8c65e",
-  "adapters/trae/hooks/lib/notify.sh": "e0033e53",
-  "adapters/trae/hooks/lib/preload-templates.sh": "96dd67fe",
-  "adapters/trae/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/trae/hooks/lib/state-detect.sh": "135bde23",
-  "adapters/trae/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/trae/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "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": "2d7fc7a7",
-  "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": "dc4829be",
-  "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",
@@ -110,60 +83,67 @@
   "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": "97a7370e",
-  "adapters/vscode/hooks/lib/common.sh": "4f3e64ad",
-  "adapters/vscode/hooks/lib/context-inject.sh": "cfc8c65e",
-  "adapters/vscode/hooks/lib/notify.sh": "e0033e53",
-  "adapters/vscode/hooks/lib/preload-templates.sh": "96dd67fe",
-  "adapters/vscode/hooks/lib/session-end.sh": "29813cbc",
-  "adapters/vscode/hooks/lib/state-detect.sh": "b87dd85a",
-  "adapters/vscode/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "adapters/vscode/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "adapters/vscode/hooks/notification.sh": "f7aed25d",
-  "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": "3e56d1a9",
-  "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": "df1ad9dd",
-  "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": "0f582a7e",
-  "core/docs/ADD-governance-codex.md": "289e8b71",
-  "core/docs/ADD-governance-qoder-cn.md": "332a7253",
-  "core/docs/ADD-governance-trae.md": "ffb29a0e",
-  "core/docs/ADD-governance-vscode-copilot.md": "74062e88",
-  "core/hooks/doc-format-guard.sh": "3a1beea8",
-  "core/hooks/lib/common.sh": "4f3e64ad",
-  "core/hooks/lib/context-inject.sh": "cfc8c65e",
-  "core/hooks/lib/notify.sh": "e0033e53",
-  "core/hooks/lib/preload-templates.sh": "96dd67fe",
-  "core/hooks/lib/session-end.sh": "29813cbc",
-  "core/hooks/lib/state-detect.sh": "135bde23",
-  "core/hooks/lib/subagent-stop.sh": "4cc1d446",
-  "core/hooks/lib/vocabulary.sh": "d5a92ac3",
-  "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": "f967ab24",
-  "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": "dc4829be",
-  "core/hooks/subagent-guard.sh": "47d04662",
-  "core/hooks/subagent-stop.sh": "0a34648b",
-  "core/prisma/add.prisma": "037bd7e9",
+  "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",
   "core/reports/code-review-combined-report.md": "195d52aa",
@@ -175,58 +155,78 @@
   "core/rules/profiles/index.toml": "b83332d4",
   "core/rules/profiles/machineserver-profile.md": "8a36cf39",
   "core/rules/profiles/webapp-profile.md": "e493ae7b",
-  "core/rules/project_rules.md": "82b25e08",
+  "core/rules/project_rules.md": "094821ad",
   "core/rules/theory-practice-map.toml": "b1db99fd",
-  "core/scripts/db-ensure.sh": "1ef7a9f3",
-  "core/scripts/gen-plan-index.sh": "bfc6ad3e",
+  "core/scripts/db-ensure.sh": "94a5ff92",
+  "core/scripts/gen-plan-index.sh": "47836bec",
   "core/scripts/mcp-server/elicitation/confirm.ts": "924857b8",
   "core/scripts/mcp-server/elicitation/index.ts": "44c5dc3f",
   "core/scripts/mcp-server/index.ts": "3483ec45",
-  "core/scripts/mcp-server/notifications/hitl.ts": "96eb7c5d",
-  "core/scripts/mcp-server/notifications/hook.ts": "a6cb861f",
+  "core/scripts/mcp-server/notifications/hitl.ts": "7b71338a",
+  "core/scripts/mcp-server/notifications/hook.ts": "31bc0ffb",
   "core/scripts/mcp-server/notifications/index.ts": "b6615afa",
   "core/scripts/mcp-server/resources/add-coder-version.ts": "2384fa40",
   "core/scripts/mcp-server/resources/add-state.ts": "1c1cc3a2",
-  "core/scripts/mcp-server/resources/hook-events-report.ts": "1d4b5996",
-  "core/scripts/mcp-server/resources/index.ts": "50e19629",
+  "core/scripts/mcp-server/resources/hitl-approval-widget.ts": "f663610e",
+  "core/scripts/mcp-server/resources/hook-events-report.ts": "9b62bacd",
+  "core/scripts/mcp-server/resources/index.ts": "d2d723f3",
   "core/scripts/mcp-server/resources/round-task.ts": "104a0d74",
   "core/scripts/mcp-server/sampling/index.ts": "7ee26d92",
-  "core/scripts/mcp-server/sampling/review.ts": "5db7a8df",
-  "core/scripts/mcp-server/shared/db-types.ts": "299915ee",
-  "core/scripts/mcp-server/shared/dps-scoring.strategy.ts": "f1c901dc",
-  "core/scripts/mcp-server/shared/env.ts": "57f4c2f2",
-  "core/scripts/mcp-server/shared/fs.ts": "0e66a214",
-  "core/scripts/mcp-server/shared/hitl-interaction.strategy.ts": "7c5c26f5",
+  "core/scripts/mcp-server/sampling/review.ts": "dd6e22ff",
+  "core/scripts/mcp-server/shared/db-types.ts": "bd97e8b6",
+  "core/scripts/mcp-server/shared/dps-scoring.strategy.ts": "92ecf32b",
+  "core/scripts/mcp-server/shared/env.ts": "f79ab09c",
+  "core/scripts/mcp-server/shared/fs.ts": "be216ce3",
+  "core/scripts/mcp-server/shared/hitl-interaction.strategy.ts": "dcfe946f",
+  "core/scripts/mcp-server/shared/hitl-lifecycle-mutation.ts": "06952c62",
+  "core/scripts/mcp-server/shared/hitl-proposal-mutation.ts": "87a7a372",
+  "core/scripts/mcp-server/shared/hitl-ui.ts": "51d574f2",
   "core/scripts/mcp-server/shared/package.json": "e3d5a4a2",
-  "core/scripts/mcp-server/shared/prisma.ts": "a9618f99",
-  "core/scripts/mcp-server/shared/project-root-strategy.ts": "1a5bdc57",
-  "core/scripts/mcp-server/shared/response.ts": "f7806b67",
+  "core/scripts/mcp-server/shared/plan-lifecycle-events.ts": "ae99b9a0",
+  "core/scripts/mcp-server/shared/plan-lifecycle-mutation.ts": "303d9674",
+  "core/scripts/mcp-server/shared/plan-lifecycle-subscriber.ts": "1b1c2b84",
+  "core/scripts/mcp-server/shared/plan-lifecycle.ts": "6a49ff4d",
+  "core/scripts/mcp-server/shared/plan-round-events.ts": "86b6ba3f",
+  "core/scripts/mcp-server/shared/plan-round-mutation.ts": "c058e930",
+  "core/scripts/mcp-server/shared/plan-round-store.ts": "bc28bd09",
+  "core/scripts/mcp-server/shared/plan-round-subscriber.ts": "43fcf257",
+  "core/scripts/mcp-server/shared/plan-status-store.ts": "5b7bcfd2",
+  "core/scripts/mcp-server/shared/plan-tracking-mutation.ts": "2fd19676",
+  "core/scripts/mcp-server/shared/prisma.ts": "9be3b5bf",
+  "core/scripts/mcp-server/shared/project-root-strategy.ts": "8dde9bf3",
+  "core/scripts/mcp-server/shared/quant-recheck.strategy.ts": "12211d20",
+  "core/scripts/mcp-server/shared/redact.ts": "22e008aa",
+  "core/scripts/mcp-server/shared/response.ts": "0d1539a8",
   "core/scripts/mcp-server/shared/run-command.ts": "42caf972",
+  "core/scripts/mcp-server/shared/runtime-context.ts": "51d0b45f",
+  "core/scripts/mcp-server/shared/schema-topology.ts": "a680b738",
   "core/scripts/mcp-server/tasks/index.ts": "c040eb75",
   "core/scripts/mcp-server/tasks/runner.ts": "d84bd35d",
   "core/scripts/mcp-server/tasks/store.ts": "2fce1a92",
-  "core/scripts/mcp-server/tools/audit.ts": "8564e46f",
-  "core/scripts/mcp-server/tools/context.ts": "99a2ac03",
-  "core/scripts/mcp-server/tools/contract.ts": "93dea040",
+  "core/scripts/mcp-server/tools/audit.ts": "705292b3",
+  "core/scripts/mcp-server/tools/context.ts": "d7d4e546",
+  "core/scripts/mcp-server/tools/contract.ts": "14b6ab8f",
   "core/scripts/mcp-server/tools/docs.ts": "034e473c",
   "core/scripts/mcp-server/tools/gateway/check_add_route_completeness.ts": "b58e76ee",
-  "core/scripts/mcp-server/tools/gateway/check_add_route_status.ts": "23fbbb6b",
-  "core/scripts/mcp-server/tools/gateway/check_dps.ts": "4d599b38",
-  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "4078b0f1",
-  "core/scripts/mcp-server/tools/gateway/check_spec_sync.ts": "486df441",
+  "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": "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": "559acb75",
+  "core/scripts/mcp-server/tools/gateway/index.ts": "cffe9783",
   "core/scripts/mcp-server/tools/gateway.backup": "65eae393",
-  "core/scripts/mcp-server/tools/hitl.ts": "d61277f5",
-  "core/scripts/mcp-server/tools/hook-event-report.ts": "3f21836e",
-  "core/scripts/mcp-server/tools/index.ts": "884172ba",
-  "core/scripts/mcp-server/tools/plan.ts": "8ce5a7ab",
+  "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": "d20b300c",
   "core/scripts/mcp-server/tools/quality.ts": "c4634453",
   "core/scripts/mcp-server/tools/registrar.ts": "efd81b3a",
-  "core/scripts/mcp-server/tools/review.ts": "52d78450",
+  "core/scripts/mcp-server/tools/review.ts": "65c35e31",
   "core/scripts/mcp-server/types.ts": "6c5e60bc",
-  "core/scripts/mcp-server.ts": "99cc6833",
-  "core/skills/add-paradigm/SKILL.md": "5d4fa389",
+  "core/scripts/mcp-server.ts": "0c9b0666",
+  "core/scripts/plan-status-bridge.ts": "70c5d8b7",
+  "core/skills/add-paradigm/SKILL.md": "55df369a",
   "core/skills/session-init/SKILL.md": "bb1205b0",
   "core/specs/add-coder-npm-package/checklist.md": "ed92032c",
   "core/specs/add-coder-npm-package/spec.md": "c7d0f235",
@@ -235,18 +235,20 @@
   "core/templates/TERMINOLOGY.md": "e9f4f781",
   "core/templates/add-route-template-heavyweight.md": "0e107ac0",
   "core/templates/add-route-template.md": "da7022df",
-  "core/templates/add-route-template.schema.json": "867a45c1",
+  "core/templates/add-route-template.schema.json": "cca77a6e",
   "core/templates/checklist-template.md": "d6b73a5c",
   "core/templates/checklist-template.schema.json": "fb3a73e8",
-  "core/templates/collab-contract-template.md": "bccba0fd",
+  "core/templates/collab-contract-template.md": "b8a52503",
   "core/templates/collab-contract-template.schema.json": "ae0f482c",
   "core/templates/fix-verification-template.md": "9c9ed175",
   "core/templates/fix-verification-template.schema.json": "a18bc6a5",
   "core/templates/handoff-multi-round-template.md": "d3a2375d",
+  "core/templates/handoff-multi-round-template.schema.json": "c752a9dc",
   "core/templates/handoff-multi-round.schema.json": "abed4220",
   "core/templates/handoff-single-round-template.md": "dceb7c86",
-  "core/templates/handoff-single-round.schema.json": "0627cda2",
-  "core/templates/hitl-approval-widget.html": "b31f3d0f",
+  "core/templates/handoff-single-round-template.schema.json": "201f8b5c",
+  "core/templates/handoff-single-round.schema.json": "19486507",
+  "core/templates/hitl-approval-widget.html": "7045227d",
   "core/templates/hitl-template.md": "44989804",
   "core/templates/hitl-template.schema.json": "e7ecc53e",
   "core/templates/index.md": "0fb42ea5",
@@ -268,12 +270,11 @@
   "core/templates/simple-plan-template.md": "5b2d8dd6",
   "core/templates/simple-plan-template.schema.json": "02718806",
   "core/templates/spec-template.md": "619b01cc",
-  "core/templates/spec-template.schema.json": "051b6e5d",
+  "core/templates/spec-template.schema.json": "9e5d530b",
   "core/templates/standard-plan-template.md": "7beafc59",
-  "core/templates/standard-plan-template.schema.json": "ca2bbb11",
+  "core/templates/standard-plan-template.schema.json": "95dc6e03",
   "core/templates/tasks-template.md": "2b9d0d52",
-  "core/templates/tasks-template.schema.json": "fff6eb47",
+  "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))