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

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%
@@ -365,6 +391,10 @@ Caijuehub is add-coder's first implementation of **TOML declaration → auto-gen
 | 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
@@ -625,3 +655,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-coder",
-  "version": "0.3.6-feature-hitl-enhance-v1.2",
+  "version": "0.3.6",
   "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,6 +41,7 @@
   "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",
@@ -53,7 +54,8 @@
     "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": {
@@ -73,6 +75,9 @@
     },
     "@prisma/adapter-libsql": {
       "optional": true
+    },
+    "@xenova/transformers": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -89,7 +94,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.6",
   "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

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

@@ -1,4 +1,95 @@
 #!/bin/bash
+# post-tool-use.sh — Qoder CN PostToolUse：格式化 + 文档守卫 + 审计提醒 + DPS 自动化
+# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强 + 哨兵自动化
+set -euo pipefail
+
+input=$(cat)
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
+export PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
+source "$HOOK_DIR/lib/common.sh" 2>/dev/null || true
+MAGIC_DIR="$CURRENT_MAGIC"
+
+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 → 自动建哨兵 ═══════════════
+if echo "$input" | grep -q '"check_dps"'; then
+  dps_score=$(echo "$input" | 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}/${MAGIC_DIR}/hitl/.tongyi-${plan_keyword}"
+      if [ ! -f "$sentinel" ]; then
+        touch "$sentinel" 2>/dev/null || true
+        echo "[ADD PostToolUse] ✅ DPS=${dps_score} ≥80, HITL 自动通过 → ${sentinel}" >&2
+      fi
+    else
+      echo "[ADD PostToolUse] ⚠️ DPS=${dps_score} <80, 需 Review 后手动建哨兵 .tongyi-${plan_keyword}" >&2
+    fi
+  fi
+fi
+
+# ═══════════════ §2: Edit/Write matcher ═══════════════
+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=""
+    if echo "$file_path" | grep -qE 'add-route'; then
+      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] 📊 请执行 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_unchecked=$(sed -n '/## Step 8/,/^## /p' "$file_path" 2>/dev/null | grep -c '^\- \[ \]' 2>/dev/null || echo "0")
+      step8_checked=$(sed -n '/## Step 8/,/^## /p' "$file_path" 2>/dev/null | grep -c '^\- \[x\]' 2>/dev/null || echo "0")
+      if [ "$step8_unchecked" = "0" ] && [ "$step8_checked" -gt 0 ]; then
+        echo "[ADD PostToolUse] ⚠️ Step 8 全部收敛完成！请写 devlog日志(走mcp) → 更新 handoff" >&2
+      fi
+    fi
+  fi
+
+  # §2d: schema.json 自动 regen 提醒
+  if echo "$file_path" | grep -qE 'templates/.*\.md$'; then
+    schema_file="${file_path%.md}.schema.json"
+    if [ -f "$schema_file" ]; then
+      echo "[ADD PostToolUse] 🔄 模板已修改，请检查 ${schema_file} 是否需更新" >&2
+    fi
+  fi
+
+  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 — Qoder CN PostToolUse：格式化 + 文档守卫 + 审计提醒
 # 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强
 set -euo pipefail

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

@@ -83,6 +83,25 @@ if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "
     exit 2
   fi
 
+  # §B: 模板类型前置注入 — 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
+    # Qoder 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 全量覆盖可能触发 Qoder 40500。建议用 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