add-coder 0.3.6-feature-hitl-enhance-v1.2 → 0.3.7

package/README.md

@@ -8,6 +8,28 @@ Make 0.75 into one.
    <a href="https://www.npmcharts.com/compare/add-coder?interval=30" style="color:#c41a16;font-weight:700">📈 趋势</a>
  </p>
 
+```bash
+# 第一次过死亡谷耗时 19天
+~ $ curl -s https://api.npmjs.org/downloads/point/last-month/add-coder                          {"downloads":5161,"start":"2026-06-29","end":"2026-07-28","package":"add-coder"}~ $             ~ $ npm info add-coder@0.1.0                                                                    add-coder@0.1.0 | MIT | deps: 3 | versions: 35  Initialize ADD paradigm workflow templates for Claude Code, Qoder, and VS Code.                                                                 keywords: add, add-paradigm, claude, qoder, vscode, mcp, workflow, codein2027, 集中裁决层, caijuehub
+                                                bin: add-coder
+                                                dist
+.tarball: https://registry.npmjs.org/add-coder/-/add-coder-0.1.0.tgz
+.shasum: 3266ddb5304d303705694edec7c2f41efc24881d                                               .integrity: sha512-MxFICLEoAgTVxnHaiIOli5eVyCXvB+xnSzpfmu0mrigEeM9NxzBOm2Auzjn1GKUTXSWelT0FecwwlYmsCf+TWQ==
+.unpackedSize: 704.9 kB
+
+dependencies:
+zod: ^3.24.0, commander: ^13.1.0, smol-toml: ^1.7.0
+
+maintainers:
+- wujixmm <wujixmm@gmail.com>
+
+dist-tags:
+latest: 0.3.5
+preview: 0.3.6-feature-hitl-enhance-v1.2
+
+published 2 weeks ago by wujixmm <wujixmm@gmail.com>
+
+```
 > 🀄中文 | 🔤[English](#-english-readme)
 
 **AI 代码治理的落地方案** — [codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。 [NPM](https://www.npmjs.com/package/add-coder) · [GitHub](https://github.com/xiaomingming92/add-coder)
@@ -49,6 +71,10 @@ Caijuehub 是 add-coder 历史上第一个实现 **TOML 规则声明 → 自动
 | HITL 审批 | `hitl-interaction-rules.toml` | `hitl.ts` | 每 IDE 独立声明交互模式 |
 | DPS 评分 | `dps-scoring-rules.toml` | `gateway.ts` | 文档质量闸门：语义/熵/CPM/结构 四维权重+阈值，AI 调参不碰代码 |
 
+> 📊 [sync-magic benchmark](./docs/sync-magic-benchmark-report.md)：caijuehub 改造实测——4 组对比，TS vs bash，熵值 vs 速度的场景价值分析。
+>
+> 🧠 [什么是酷的软件](./docs/what-makes-software-cool.md)：从 benchmark 出发抽象工程美学框架——标准符合度 × 熵值 × runtime 容忍区间。含 IT 运营 vs 个人认知双视角分析、达索案例。
+
 **改规则不改代码**——产品经理读 TOML 即可理解软件行为，市场人员改 TOML 即可调整策略参数。AI Agent 大规模索引、检索、修改规则时，操作的是同一张决策表。认知负担从 O(N×M) 降为 O(1)。
 
 ### ③ Prompt Cache 原生友好 — 月费 ¥218，节省 98%
@@ -313,6 +339,7 @@ Tasks (实验性)     双向              ✅ 已实现      长任务持久化
 | Demo 仓库演示 | 提供完整示例仓库，展示 Policy-Update-Loop 与 Report 体系的端到端闭环实践 |--|
 | MCP 能力重构 | ✅ v0.2.9 MCP 工具链架构升级，提升审计与门禁工具的可扩展性和独立部署能力 | 2026-07/23/add-coder-mcp-restructure-plan-v1.md |
 | Hook 通知升级 | ✅ v0.2.9 Hook 拦截事件 jsonl → fs.watch → record_dev_operation 落库 + Notification + 治理信号 | 2026-07/24/add-coder-hook-notify-upgrade-plan-v1.md |
+| ide插件 | 解耦ADD范式代码和被治理项目的代码 |在做了,大家拭目以待吧,让编程更有趣,我的目标其实不在于IDE,我的工作顺手的事情 |
 | 对话记忆增强 | 长期项目知识记忆和plan级别的稀疏记忆 |--|
 
 
@@ -355,16 +382,20 @@ Traditional AI development: Chat → Generate code → Dig through chat history
 | Auditing relies on developer discipline | The **MCP audit toolchain** automatically records every operation; system gateways enforce checks |
 | No traceability | Audit events are naturally linked: Plan → Spec → Task → Step → Tool Call, forming a complete evidence chain |
 
-### ② Caijuehub Rule Engine: From Sync to Three Domains
+### ② Caijuehub — The Centralized Adjudication Layer: From Sync to Three Domains
 
-Caijuehub is add-coder's first implementation of **TOML declaration → auto-generated strategy → business code consumption**. From the initial sync --patch experiment to today's three-domain coverage spanning HITL and DPS, the evolution proves the extensibility of centralized decision layers. Details: [docs/caijuehub.md](./docs/caijuehub.md).
+Caijuehub is add-coder's first implementation of **TOML declaration → auto-generated strategy → business code consumption**. From the initial sync --patch experiment to today's three-domain coverage spanning HITL and DPS, the evolution proves the extensibility of the centralized adjudication layer. Details: [docs/caijuehub.md](./docs/caijuehub.md).
 
 | Domain | Rules File | Consumer | Description |
 |--------|---------|--------|------|
-| sync --patch | `sync-rules.toml` | `sync.ts` | **First centralized decision hot-update in npm history** (eating my own dog food: add-coder manages its own template sync via caijuehub) |
+| sync --patch | `sync-rules.toml` | `sync.ts` | **First centralized adjudication hot-update in npm history** (eating my own dog food: add-coder manages its own template sync via caijuehub) |
 | HITL Approval | `hitl-interaction-rules.toml` | `hitl.ts` | Per-IDE interaction mode declaration |
 | DPS Scoring | `dps-scoring-rules.toml` | `gateway.ts` | Doc quality gateway: semantic/entropy/CPM/structure 4D weights+thresholds, AI self-tuning without touching code |
 
+> 📊 [sync-magic benchmark](./docs/sync-magic-benchmark-report.md): Caijuehub refactoring measured — 4-group comparison, TS vs bash, scenario-value analysis of entropy vs speed.
+>
+> 🧠 [What Makes Software Cool](./docs/what-makes-software-cool.md): An engineering aesthetics framework derived from the benchmark — standards compliance × entropy × runtime tolerance. IT ops vs personal cognition perspectives, Dassault case study.
+
 **Edit rules, not code** — product managers read TOML to understand software behavior, marketers modify TOML to adjust strategy parameters. When AI agents index, search, and modify rules at scale, they operate on the same decision table. Cognitive load drops from O(N×M) to O(1).
 
 ### ③ Prompt Cache Native — ¥218/mo, 98% Savings
@@ -586,7 +617,8 @@ npx add-coder init
               ┌────────────┘
               ▼
        ┌─────────────────────────────────────┐
-       │       Caijuehub Rule Engine          │
+       │  Caijuehub — Centralized            │
+       │  Adjudication Layer                  │
        │  TOML-Driven Policy System           │
        │  Detect / Adapt / Prisma / Write —   │
        │  Fully Configurable                  │
@@ -625,3 +657,7 @@ npx add-coder init
 | Memory Enhancement | Long-term project knowledge memory and plan-level sparse memory | 📋 |
 
 ---
+
+My hometown 
+
+<img width="720"  alt="hometown outside" src="https://github.com/user-attachments/assets/7aad93de-9cea-4194-b09d-cbd892d61cc2" />

package/dist/index.js

@@ -305,7 +305,21 @@ var SYNC_PRISMA_CONFIG = {
   ON_FIELD_CONFLICT: "interactive",
   ON_MISSING_FIELD: "interactive",
   ON_EXTRA_FIELD: "ignore",
-  PROMPT: "add-coder \u6807\u51C6 add.prisma \u4E0E\u6D88\u8D39\u65B9 schema \u5B58\u5728\u5DEE\u5F02\u3002"
+  PROMPT: "add-coder \u6807\u51C6 add.prisma \u4E0E\u6D88\u8D39\u65B9 schema \u5B58\u5728\u5DEE\u5F02\u3002",
+  POST_SYNC: {
+    HEADER: "\u4E0B\u4E00\u6B65\u6309\u4F60\u7684\u573A\u666F\u9009\u62E9\u8FC1\u79FB\u547D\u4EE4:",
+    FINAL: "npx prisma generate",
+    MANAGED_ACTIONS: [
+      { label: "\u5F00\u53D1\u73AF\u5883\uFF08\u751F\u6210\u65B0\u8FC1\u79FB+\u540C\u6B65\u672C\u5730\u5E93\uFF09", cmd: "npx prisma migrate dev" },
+      { label: "\u751F\u4EA7/CI\uFF08\u53EA\u5E94\u7528\u5DF2\u6709\u8FC1\u79FB\uFF09", cmd: "npx prisma migrate deploy" },
+      { label: "\u4E0D\u786E\u5B9A\uFF1F\u5148\u67E5\u72B6\u6001", cmd: "npx prisma migrate status" }
+    ],
+    P3005: { hint: "\u82E5\u62A5 P3005\uFF08\u5E93\u6709\u8868\u4F46\u65E0\u8FC1\u79FB\u8BB0\u5F55\uFF09= \u9700\u5148\u57FA\u7EBF\u5316:", cmd: "npx prisma migrate resolve --applied <\u8FC1\u79FB\u540D>\uFF0C\u518D\u6267\u884C deploy" },
+    UNMANAGED_ACTIONS: [
+      { label: "\u9996\u6B21\u63A5\u5165\u8FC1\u79FB\u7BA1\u7406\uFF08\u7A7A\u5E93\uFF09", cmd: "npx prisma migrate dev --name init" },
+      { label: "\u5E93\u5DF2\u6709\u8868\uFF08db push \u5EFA\u8FC7\uFF09", hint: "\u5148\u624B\u52A8\u57FA\u7EBF\u5316\uFF0C\u518D deploy:", steps: ["npx prisma migrate diff --from-empty --to-schema-datamodel <schema\u6587\u4EF6> --script", "\u5C06\u8F93\u51FA\u5199\u5165 prisma/migrations/<\u65F6\u95F4\u6233>_init/migration.sql", "npx prisma migrate resolve --applied <\u65F6\u95F4\u6233>_init"] }
+    ]
+  }
 };
 
 // src/cli/writer.ts
@@ -1294,6 +1308,28 @@ async function syncCommand(options = {}) {
   console.log(`\u540C\u6B65\u5B8C\u6210: \u65B0\u5EFA ${result.created}, \u8DF3\u8FC7 ${result.skipped}`);
   await checkPrismaDiff(projectRoot, options);
 }
+function printMigrateGuidance(targetPath, changed) {
+  const g = SYNC_PRISMA_CONFIG.POST_SYNC;
+  const isManaged = existsSync8(resolve6(dirname4(targetPath), "migrations"));
+  const actions = isManaged ? g.MANAGED_ACTIONS : g.UNMANAGED_ACTIONS;
+  console.log(`  \u25B6 \u5DF2\u5199\u5165 ${changed} \u5904\u53D8\u66F4\uFF0C${g.HEADER}`);
+  for (const a of actions) {
+    if ("cmd" in a && "label" in a) {
+      const prefix = isManaged ? "\u251C\u2500" : "\u251C\u2500";
+      console.log(`     ${prefix} ${a.label}: ${a.cmd}`);
+    } else if ("steps" in a) {
+      const item = a;
+      console.log(`     \u2514\u2500 ${item.label}:`);
+      if (item.hint) console.log(`        \u26A0\uFE0F  ${item.hint}`);
+      for (const s of item.steps) console.log(`          ${s}`);
+    }
+  }
+  if (isManaged) {
+    console.log(`     \u26A0\uFE0F  ${g.P3005.hint}`);
+    console.log(`          ${g.P3005.cmd}`);
+  }
+  console.log(`     \u26A0\uFE0F  \u6240\u6709\u573A\u666F\u6536\u5C3E: ${g.FINAL}`);
+}
 async function checkPrismaDiff(projectRoot, options) {
   if (!options.patch) return;
   const basePath = resolve6(projectRoot, SYNC_PRISMA_CONFIG.BASE_SCHEMA);
@@ -1311,6 +1347,7 @@ async function checkPrismaDiff(projectRoot, options) {
     return;
   }
   const targetExists = existsSync8(targetPath);
+  let modifiedCount = 0;
   console.log(`
 \u26A0\uFE0F  Prisma schema \u5DEE\u5F02\u68C0\u6D4B:`);
   console.log(`  \u57FA\u51C6: ${result.baseSchema} (add-coder \u6807\u51C6)`);
@@ -1342,6 +1379,7 @@ async function checkPrismaDiff(projectRoot, options) {
       },
       execute() {
         const n = injectMissingModels(result.targetPath, selected);
+        modifiedCount += n;
         console.log(`  \u2705 \u5DF2\u5C06 ${n} \u4E2A\u6A21\u578B/\u679A\u4E3E\u6CE8\u5165 ${result.targetPath}`);
         return Promise.resolve(n);
       }
@@ -1370,6 +1408,7 @@ async function checkPrismaDiff(projectRoot, options) {
           },
           execute() {
             const n = overwriteFieldLines(targetPath, basePath, d.name, d.conflicts);
+            modifiedCount += n;
             console.log(`    \u2705 \u5DF2\u8986\u76D6 ${n} \u4E2A\u51B2\u7A81\u5B57\u6BB5`);
             return Promise.resolve(n);
           }
@@ -1390,6 +1429,7 @@ async function checkPrismaDiff(projectRoot, options) {
           },
           execute() {
             const n = injectFieldLines(targetPath, basePath, d.name, d.missingFields);
+            modifiedCount += n;
             console.log(`    \u2705 \u5DF2\u8865\u5145 ${n} \u4E2A\u5B57\u6BB5`);
             return Promise.resolve(n);
           }
@@ -1417,7 +1457,11 @@ async function checkPrismaDiff(projectRoot, options) {
   if (targetExists) {
     console.log(`
   ${SYNC_PRISMA_CONFIG.PROMPT}`);
-    console.log(`  \u25B6 \u8BF7\u8FD0\u884C: npx prisma migrate dev && npx prisma generate`);
+    if (modifiedCount > 0) {
+      printMigrateGuidance(targetPath, modifiedCount);
+    } else {
+      console.log(`  \u25B6 \u76EE\u6807 schema \u5DF2\u662F\u6700\u65B0\uFF08\u672A\u9009\u62E9\u4EFB\u4F55\u53D8\u66F4\uFF09\uFF0C\u65E0\u9700\u8FC1\u79FB\u64CD\u4F5C`);
+    }
   } else {
     console.log(`
   \u76EE\u6807 schema \u6587\u4EF6\u4E0D\u5B58\u5728: ${result.targetPath}`);
@@ -1425,7 +1469,9 @@ async function checkPrismaDiff(projectRoot, options) {
     writeFileSync4(targetPath, "// add.prisma \u2014 ADD \u6CBB\u7406\u6A21\u578B\n\n", "utf-8");
     const n = injectMissingModels(targetPath, result.missing);
     console.log(`  \u2705 \u5DF2\u521B\u5EFA\u5E76\u6CE8\u5165 ${n} \u4E2A\u6A21\u578B/\u679A\u4E3E`);
-    console.log(`  \u25B6 \u8BF7\u8FD0\u884C: npx prisma migrate dev && npx prisma generate`);
+    if (n > 0) {
+      printMigrateGuidance(targetPath, n);
+    }
   }
 }
 async function handleDiffAction(action, ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.3.6-feature-hitl-enhance-v1.2",
+  "version": "0.3.7",
   "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": {
@@ -41,19 +41,20 @@
   "license": "AGPL-3.0-only",
   "dependencies": {
     "@modelcontextprotocol/server": "2.0.0",
+    "@xenova/transformers": "^2.17.2",
     "commander": "^13.1.0",
     "smol-toml": "^1.7.0",
     "vector-cosine-similarity": "^1.8.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@prisma/adapter-libsql": "^7.0.0",
     "@prisma/adapter-pg": "^7.0.0",
     "@prisma/client": "^7.0.0",
     "dotenv": "*",
     "prisma": "^7.0.0",
     "tsx": ">=4",
-    "vector-cosine-similarity": "^1.8.0"
+    "vector-cosine-similarity": "^1.8.0",
+    "@xenova/transformers": "^2.17.2"
   },
   "peerDependenciesMeta": {
     "@prisma/client": {
@@ -69,10 +70,10 @@
       "optional": false
     },
     "@prisma/adapter-pg": {
-      "optional": true
+      "optional": false
     },
-    "@prisma/adapter-libsql": {
-      "optional": true
+    "@xenova/transformers": {
+      "optional": false
     }
   },
   "devDependencies": {
@@ -89,7 +90,9 @@
     "predev": "npm run db:ensure",
     "dev": "tsup --watch",
     "db:ensure": "bash scripts/db-ensure.sh",
-    "sync": "bash scripts/sync-magic-dirs.sh",
+    "sync": "tsx scripts/sync-magic.ts",
+    "sync:bash": "bash scripts/benchmark/sync-magic.sh",
+    "benchmark": "tsx scripts/benchmark/benchmark-sync.ts",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "generate": "tsx src/caijuehub/transcribe.ts",

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

@@ -1,5 +1,5 @@
 {
-  "_version": "0.3.6-feature-hitl-enhance-v1.2",
+  "_version": "0.3.7",
   "adapters/claude/hooks/doc-format-guard.sh": "ec59ad3f",
   "adapters/claude/hooks/lib/common.sh": "db321ef6",
   "adapters/claude/hooks/lib/context-inject.sh": "4132f203",
@@ -15,7 +15,7 @@
   "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": "8f151533",
+  "adapters/claude/hooks/pre-tool-use.sh": "ecbdc628",
   "adapters/claude/hooks/prompt-submit.sh": "680b41f4",
   "adapters/claude/hooks/review-checklist.sh": "b383a983",
   "adapters/claude/hooks/session-end.sh": "777ae808",
@@ -38,9 +38,9 @@
   "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": "f54dd009",
+  "adapters/codex/hooks/post-tool-use.sh": "27123aee",
   "adapters/codex/hooks/pre-compact.sh": "6164c007",
-  "adapters/codex/hooks/pre-tool-use.sh": "e3bf721d",
+  "adapters/codex/hooks/pre-tool-use.sh": "ffa7936b",
   "adapters/codex/hooks/prompt-submit.sh": "bea6f381",
   "adapters/codex/hooks/review-checklist.sh": "b383a983",
   "adapters/codex/hooks/session-end.sh": "3cc8c346",
@@ -62,9 +62,9 @@
   "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": "47dd691c",
+  "adapters/qoder/hooks/post-tool-use.sh": "051cb6ed",
   "adapters/qoder/hooks/pre-compact.sh": "092fa6cf",
-  "adapters/qoder/hooks/pre-tool-use.sh": "32eaa754",
+  "adapters/qoder/hooks/pre-tool-use.sh": "5ba6d9ae",
   "adapters/qoder/hooks/prompt-submit.sh": "f36e6ae8",
   "adapters/qoder/hooks/review-checklist.sh": "666831c8",
   "adapters/qoder/hooks/session-end.sh": "c50339df",
@@ -87,9 +87,9 @@
   "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": "f54dd009",
+  "adapters/trae/hooks/post-tool-use.sh": "27123aee",
   "adapters/trae/hooks/pre-compact.sh": "6164c007",
-  "adapters/trae/hooks/pre-tool-use.sh": "190ce5cc",
+  "adapters/trae/hooks/pre-tool-use.sh": "8e57d1fa",
   "adapters/trae/hooks/prompt-submit.sh": "bea6f381",
   "adapters/trae/hooks/review-checklist.sh": "b383a983",
   "adapters/trae/hooks/session-end.sh": "3cc8c346",
@@ -124,7 +124,7 @@
   "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": "dbb5f75a",
+  "adapters/vscode/hooks/pre-tool-use.sh": "6232624b",
   "adapters/vscode/hooks/prompt-submit.sh": "4529a394",
   "adapters/vscode/hooks/review-checklist.sh": "b383a983",
   "adapters/vscode/hooks/session-end.sh": "7b407b9f",
@@ -135,8 +135,7 @@
   "adapters/vscode/launch.json": "f2b79855",
   "adapters/vscode/settings.json": "7cabd00e",
   "adapters/vscode/tasks.json": "654d7fbd",
-  "core/agents/add-flow-guardian.md": "697d422f",
-  "core/agents/add-orchestrator.md": "0d555e99",
+  "core/agents/add-flow-guardian.md": "a23f50cf",
   "core/docs/ADD-governance-claude-code.md": "0f582a7e",
   "core/docs/ADD-governance-codex.md": "289e8b71",
   "core/docs/ADD-governance-qoder-cn.md": "332a7253",
@@ -154,9 +153,9 @@
   "core/hooks/notification.sh": "f7aed25d",
   "core/hooks/permission-gate.sh": "bcca7732",
   "core/hooks/post-tool-failure.sh": "669b1b65",
-  "core/hooks/post-tool-use.sh": "f54dd009",
+  "core/hooks/post-tool-use.sh": "27123aee",
   "core/hooks/pre-compact.sh": "6164c007",
-  "core/hooks/pre-tool-use.sh": "8642d052",
+  "core/hooks/pre-tool-use.sh": "fa73df98",
   "core/hooks/prompt-submit.sh": "bea6f381",
   "core/hooks/review-checklist.sh": "b383a983",
   "core/hooks/session-end.sh": "3cc8c346",
@@ -167,7 +166,7 @@
   "core/plans/2026-07/08/add-coder-npm-package-add-route-v1.md": "b05fce99",
   "core/plans/2026-07/08/add-coder-npm-package-handoff-v1.md": "1bd40a4a",
   "core/plans/2026-07/08/add-coder-npm-package-plan-v1.md": "a678d98e",
-  "core/prisma/add.prisma": "eb397d48",
+  "core/prisma/add.prisma": "3733af9f",
   "core/reports/REPORT-WORKFLOW.md": "03d39b21",
   "core/reports/boundary-runtime-report.md": "6fd8053f",
   "core/reports/code-review-combined-report.md": "195d52aa",
@@ -176,7 +175,7 @@
   "core/reports/index.md": "6348c374",
   "core/reports/runtime-report/gateway.md": "a5751665",
   "core/reviews/.gitkeep": "e3b0c442",
-  "core/rules/project_rules.md": "76272603",
+  "core/rules/project_rules.md": "b2680762",
   "core/rules/theory-practice-map.toml": "b1db99fd",
   "core/scripts/db-ensure.sh": "faeb6b92",
   "core/scripts/gen-plan-index.sh": "bfc6ad3e",
@@ -193,7 +192,7 @@
   "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/dps-scoring.strategy.ts": "ed889421",
+  "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": "97257db9",
   "core/scripts/mcp-server/shared/hitl-interaction.strategy.ts": "7c5c26f5",
@@ -204,29 +203,36 @@
   "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": "47ea912f",
+  "core/scripts/mcp-server/tools/audit.ts": "3c23458b",
   "core/scripts/mcp-server/tools/context.ts": "463df4f4",
   "core/scripts/mcp-server/tools/docs.ts": "a3937aec",
-  "core/scripts/mcp-server/tools/gateway.ts": "5d178f61",
+  "core/scripts/mcp-server/tools/gateway/check_add_route_completeness.ts": "c205989d",
+  "core/scripts/mcp-server/tools/gateway/check_add_route_status.ts": "3662b6dc",
+  "core/scripts/mcp-server/tools/gateway/check_dps.ts": "12f3b375",
+  "core/scripts/mcp-server/tools/gateway/check_rahs.ts": "dc7e2a20",
+  "core/scripts/mcp-server/tools/gateway/check_spec_sync.ts": "a683697f",
+  "core/scripts/mcp-server/tools/gateway/helpers.ts": "5ed11a3b",
+  "core/scripts/mcp-server/tools/gateway/index.ts": "5a9fd5ed",
+  "core/scripts/mcp-server/tools/gateway.backup": "65eae393",
   "core/scripts/mcp-server/tools/hitl.ts": "80093743",
   "core/scripts/mcp-server/tools/hook-event-report.ts": "3926005b",
-  "core/scripts/mcp-server/tools/index.ts": "4735daf0",
-  "core/scripts/mcp-server/tools/plan.ts": "bf146dca",
+  "core/scripts/mcp-server/tools/index.ts": "b15c6753",
+  "core/scripts/mcp-server/tools/plan.ts": "9ef4da1e",
   "core/scripts/mcp-server/tools/quality.ts": "26ddf75d",
   "core/scripts/mcp-server/tools/review.ts": "c2d464ed",
   "core/scripts/mcp-server/types.ts": "6c5e60bc",
   "core/scripts/mcp-server.ts": "99cc6833",
   "core/skills/add-paradigm/SKILL.md": "b74ef053",
-  "core/skills/session-init/SKILL.md": "0fbdc5cd",
+  "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",
   "core/specs/add-coder-npm-package/tasks.md": "c34301e5",
   "core/templates/01-架构/《ADD开发工作路径与文档协同规范》.md": "4a566775",
   "core/templates/TERMINOLOGY.md": "e9f4f781",
-  "core/templates/add-route-template-heavyweight.md": "8b1eb7c2",
-  "core/templates/add-route-template.md": "670f9ebe",
-  "core/templates/add-route-template.schema.json": "c29a8f65",
-  "core/templates/checklist-template.md": "f904e049",
+  "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/checklist-template.md": "d6b73a5c",
   "core/templates/checklist-template.schema.json": "fb3a73e8",
   "core/templates/fix-verification-template.md": "9c9ed175",
   "core/templates/fix-verification-template.schema.json": "a18bc6a5",
@@ -252,14 +258,14 @@
   "core/templates/review-template.schema.json": "abc2ece6",
   "core/templates/runtime-report-template.md": "7b35208a",
   "core/templates/runtime-report-template.schema.json": "6c1143e6",
-  "core/templates/simple-plan-template.md": "0bb1ebbe",
+  "core/templates/simple-plan-template.md": "db5c247f",
   "core/templates/simple-plan-template.schema.json": "99d53cc1",
-  "core/templates/spec-template.md": "3fe8f818",
-  "core/templates/spec-template.schema.json": "b13b3de8",
-  "core/templates/standard-plan-template.md": "44d30a4e",
+  "core/templates/spec-template.md": "619b01cc",
+  "core/templates/spec-template.schema.json": "051b6e5d",
+  "core/templates/standard-plan-template.md": "2129931c",
   "core/templates/standard-plan-template.schema.json": "2b767928",
-  "core/templates/tasks-template.md": "3a0f318d",
-  "core/templates/tasks-template.schema.json": "c046de41",
+  "core/templates/tasks-template.md": "2b9d0d52",
+  "core/templates/tasks-template.schema.json": "fff6eb47",
   "core/tools/README.md": "26a63460",
   "core/vocabulary/add-governance-vocabulary.md": "0bd9f725",
   "shared/hooks-lib/common.sh": "441eee52"

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

@@ -82,6 +82,25 @@ if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "
     exit $EXIT_BLOCK
   fi
 
+  # 模板类型前置注入 — plans/ 写入前提示应选模板
+  if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then
+    fname=$(basename "$file_path")
+    if echo "$fname" | grep -qE 'plan-v[0-9]'; then
+      echo "💡 [ADD PreToolUse] 写入 Plan → 模板: standard-plan-template.md（标准）或 simple-plan-template.md（≤3文件）" >&2
+    elif echo "$fname" | grep -qE 'add-route'; then
+      echo "💡 [ADD PreToolUse] 写入 ADD Route → 模板: add-route-template.md" >&2
+    elif echo "$fname" | grep -qE 'handoff'; then
+      echo "💡 [ADD PreToolUse] 写入 Handoff → 模板: handoff-single-round-template.md（单轮）或 handoff-multi-round-template.md（多轮）" >&2
+    fi
+    # Write 大文件适配 — 已存在大文件建议用 SearchReplace 分块
+    if echo "$tool_name" | grep -qE 'Write' && [ -f "$file_path" ]; then
+      fsize=$(wc -c < "$file_path" 2>/dev/null || echo "0")
+      if [ "$fsize" -gt 2000 ] 2>/dev/null; then
+        echo "⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发工具 payload 限制。建议用 SearchReplace 分块追加。" >&2
+      fi
+    fi
+  fi
+
   # §C: HITL tongyi 检查 — plans/ + PLAN_REVIEW reviews/ 写入前必须有 .hitl-tongyi-{planName} 哨兵
   # implementation/runtime review 不需要 HITL，走 §B 活跃 Plan 检查
   if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then

package/templates/adapters/codex/hooks/post-tool-use.sh

@@ -1,4 +1,107 @@
 #!/bin/bash
+# post-tool-use.sh — PostToolUse：格式化 + 文档守卫 + 审计提醒 + DPS 自动化
+# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强 + 哨兵自动化
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+COMMON_LIB="$HOOK_DIR/lib/common.sh"
+[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
+
+input=$(parse_input)
+tool_name=$(json_get "$input" "tool_name")
+[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+
+# ═══════════════ §1: HITL DPS 自动化 — check_dps ≥ 80 → 自动建哨兵 ═══════════════
+# 检测 MCP check_dps 调用结果，DPS ≥ 80 自动 touch .tongyi-{plan} 哨兵
+if echo "$input" | grep -q '"check_dps"'; then
+  tool_output=$(echo "$input" | grep -o '"output"[[:space:]]*:[[:space:]]*"[^"]*"\|"content"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null || echo "")
+  dps_score=$(echo "$tool_output" | grep -oP 'DPS\s*=\s*\K\d+' 2>/dev/null || echo "")
+  plan_keyword=$(echo "$input" | grep -oP '"planKeyword"\s*:\s*"\K[^"]+' 2>/dev/null || echo "")
+
+  if [ -n "$dps_score" ] && [ -n "$plan_keyword" ]; then
+    if [ "$dps_score" -ge 80 ] 2>/dev/null; then
+      sentinel="${PROJECT_DIR:-$PWD}/${MAGIC_DIR:-.qoder}/hitl/.tongyi-${plan_keyword}"
+      if [ ! -f "$sentinel" ]; then
+        touch "$sentinel" 2>/dev/null && echo "[ADD PostToolUse] ✅ DPS=${dps_score} ≥80, HITL 自动通过 → ${sentinel}" >&2 || true
+        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 已自动建哨兵 ${sentinel}" >&2
+      else
+        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 哨兵已存在 → ${sentinel}" >&2
+      fi
+    else
+      echo "[ADD PostToolUse] ⚠️ DPS=${dps_score} <80, 需 Review 后手动建哨兵 .tongyi-${plan_keyword}" >&2
+      echo "[ADD PostToolUse] 修复文档后重新 check_dps，通过即自动放行。" >&2
+    fi
+  fi
+fi
+
+# ═══════════════ §2: Edit/Write matcher: 格式化 + 文档守卫 + 自动 plan_track ═══════════════
+if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
+  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
+  [ -z "$file_path" ] && exit 0
+
+  # §2a: ADD 文档结构守卫
+  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
+    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全。" >&2
+  fi
+
+  # §2b: plan_track 自动触发 — specs/ 或 add-route 写入后自动落库
+  if echo "$file_path" | grep -qE '/(specs|plans)/.*add-route'; then
+    plan_name=$(basename "$file_path" | sed 's/-add-route.*//' | sed 's/-plan-v[0-9]*$//')
+    # 从路径提取完整 planName（含 -plan-vN 后缀）
+    if echo "$file_path" | grep -qE 'add-route'; then
+      # add-route 写入：从文件名反推 planName
+      plan_prefix=$(basename "$file_path" | sed 's/-add-route-v[0-9]*\.md$//')
+      plan_dir=$(dirname "$file_path")
+      if [ -d "$plan_dir" ]; then
+        plan_file=$(ls "$plan_dir"/*-plan-v*.md 2>/dev/null | head -1 || echo "")
+        if [ -n "$plan_file" ]; then
+          plan_name=$(basename "$plan_file" .md)
+        fi
+      fi
+    fi
+    if [ -n "$plan_name" ]; then
+      echo "[ADD PostToolUse] 📊 自动同步 PlanRecord: plan_track({ planName: \"${plan_name}\" }) — 请执行" >&2
+    fi
+  fi
+
+  # §2c: devlog 自动提醒 — add-route Step 8 全 [x] 时提醒
+  if echo "$file_path" | grep -qE 'add-route.*\.md$'; then
+    if [ -f "$file_path" ]; then
+      step8_content=$(sed -n '/## Step 8/,/^## /p' "$file_path" 2>/dev/null || echo "")
+      unchecked=$(echo "$step8_content" | grep -c '^\- \[ \]' 2>/dev/null || echo "0")
+      checked=$(echo "$step8_content" | grep -c '^\- \[x\]' 2>/dev/null || echo "0")
+      if [ "$unchecked" = "0" ] && [ "$checked" -gt 0 ]; then
+        echo "[ADD PostToolUse] ⚠️ Step 8 全部收敛完成！请写 devlog日志(走mcp) → 更新 handoff" >&2
+      fi
+    fi
+  fi
+
+  # §2d: schema.json 自动 regen — 模板 .md 修改后更新对应 schema
+  if echo "$file_path" | grep -qE 'templates/.*\.md$'; then
+    schema_file="${file_path%.md}.schema.json"
+    if [ -f "$schema_file" ]; then
+      # 扫描模板实际 ## 标题，更新 schema sections
+      headings=$(grep -oP '^## \K.+' "$file_path" 2>/dev/null | head -20 || echo "")
+      if [ -n "$headings" ]; then
+        echo "[ADD PostToolUse] 🔄 模板已修改，请检查 ${schema_file} 是否需更新（§ sections）" >&2
+        echo "[ADD PostToolUse] 模板标题: $(echo "$headings" | tr '\n' ' ')" >&2
+      fi
+    fi
+  fi
+
+  # §2e: 审计提醒
+  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
+  exit 0
+fi
+
+# ═══════════════ §3: Bash matcher: 结果增强 ═══════════════
+if [ "$tool_name" = "Bash" ]; then
+  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
+  exit 0
+fi
+
+exit 0
+#!/bin/bash
 # post-tool-use.sh — Claude Code PostToolUse：格式化 + 文档守卫 + 审计提醒
 # 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强
 set -euo pipefail

package/templates/adapters/codex/hooks/pre-tool-use.sh

@@ -154,6 +154,25 @@ if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "
     exit 2
   fi
 
+  # §C: 模板类型前置注入 — plans/ 写入前提示应选模板
+  if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then
+    fname=$(basename "$file_path")
+    if echo "$fname" | grep -qE 'plan-v[0-9]'; then
+      echo "💡 [ADD PreToolUse] 写入 Plan → 模板: standard-plan-template.md（标准）或 simple-plan-template.md（≤3文件）" >&2
+    elif echo "$fname" | grep -qE 'add-route'; then
+      echo "💡 [ADD PreToolUse] 写入 ADD Route → 模板: add-route-template.md" >&2
+    elif echo "$fname" | grep -qE 'handoff'; then
+      echo "💡 [ADD PreToolUse] 写入 Handoff → 模板: handoff-single-round-template.md（单轮）或 handoff-multi-round-template.md（多轮）" >&2
+    fi
+    # Write 大文件适配 — 已存在大文件建议用 SearchReplace 分块
+    if echo "$tool_name" | grep -qE 'Write' && [ -f "$file_path" ]; then
+      fsize=$(wc -c < "$file_path" 2>/dev/null || echo "0")
+      if [ "$fsize" -gt 2000 ] 2>/dev/null; then
+        echo "⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发工具 payload 限制。建议用 SearchReplace 分块追加。" >&2
+      fi
+    fi
+  fi
+
   # §C: HITL tongyi 检查 — plans/ + PLAN_REVIEW reviews/ 写入前必须有 .hitl-tongyi-{planName} 哨兵
   # implementation/runtime review 不需要 HITL，走 §B 活跃 Plan 检查
   if echo "$file_path" | grep -qE '\.(qoder|claude|add|vscode|trae)/(plans)/'; then