add-coder 0.3.26 → 0.3.28

package/templates/adapters/vscode/hooks/prompt-submit.ts

@@ -0,0 +1,74 @@
+// prompt-submit.ts — UserPromptSubmit 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core PromptRouter（L1/L2/L3 模板方法）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① extractPrompt: grep 正则提取（无 jq）
+//   ② acceptedText: 验收 4 行（无 ★ 同步检查行——vscode bash 原文）
+//   ③ onAccepted: 无 review-checklist 子进程
+//   ④ onDevKwMatched: stderr "[ADD PromptSubmit] 检测到开发关键词"
+//   ⑤ layer2ToStderr: false（Layer2 提示输出 stdout）
+//   ⑥ layer3Text: 「[ADD 当前状态]」多行块
+//   ⑦ afterLayer3: 模板全文注入（--full --top 5）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PreloadTemplates } from "../../../core/governance/preload-templates.js"
+import { PromptRouter } from "../../../core/governance/prompt-router.js"
+
+const MAGIC_DIR = process.env.MAGIC_DIR || ".vscode"
+
+class VscodePromptRouter extends PromptRouter {
+  /** ① prompt 提取（对齐 bash grep/sed，无 jq） */
+  protected override extractPrompt(input: string): string {
+    return input.match(/"prompt"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+  }
+
+  /** ② 验收幂等文本（vscode 4 行，无 ★ 同步检查） */
+  protected override acceptedText(): string {
+    return `[ADD 验收] ⚠️ 已验收。进入 Review 模式:
+  ① 重新检查 checklist [T]/[R] 项
+  ② 审查 audit 记录完整性
+  ③ 如有差异 → Review 回流至 handoff（增量更新）
+  ④ 无差异 → 记录 'Review 已确认，无新发现'
+`
+  }
+
+  /** ③ 验收后置（vscode 无 review-checklist 子进程） */
+  protected override onAccepted(_handoff: string, _addRoute: string): void {
+    // vscode 协议: 无子进程调用
+  }
+
+  /** ④ 开发关键词命中提示（stderr） */
+  protected override onDevKwMatched(): void {
+    process.stderr.write("[ADD PromptSubmit] 检测到开发关键词\n")
+  }
+
+  /** ⑤ Layer 2 输出通道（vscode: stdout） */
+  protected override layer2ToStderr(): boolean {
+    return false
+  }
+
+  /** ⑥ Layer 3 状态文本（多行块） */
+  protected override layer3Text(plan: string, rounds: string, step: string, handoff: string): string {
+    return `[ADD 当前状态]
+  Plan: ${plan}
+  轮次: ${rounds}
+  当前 Step: ${step}
+  handoff: ${handoff}
+`
+  }
+
+  /** ⑦ Layer 3 附加注入: 模板全文（--full --top 5 + tpl-injected 去重） */
+  protected override afterLayer3(): void {
+    try {
+      const preload = new PreloadTemplates()
+      preload.validate()
+      if (!preload.isInjected()) {
+        process.stdout.write(preload.full(5))
+        preload.markInjected()
+      }
+    } catch {
+      /* 对齐 bash [ -f "$TPL_SCRIPT" ] 缺失时跳过 */
+    }
+  }
+}
+
+const input = readHookInput()
+process.exit(new VscodePromptRouter(MAGIC_DIR).run(input))

package/templates/adapters/vscode/hooks/review-checklist.ts

@@ -0,0 +1,5 @@
+// review-checklist.ts — Review 检查清单校验（VS Code Copilot 版）
+// bash 版缺陷修复: SHARED_LIB 路径断裂，TS 版 import core common.js（内联）。
+
+process.stdout.write("[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。\n")
+process.exit(0)

package/templates/adapters/vscode/hooks/session-end.ts

@@ -0,0 +1,16 @@
+// session-end.ts — SessionEnd 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core SessionEndGuard，命名子类 VscodeSessionEndGuard:
+//   完整治理（标记清理 + 审计结算 + Stop 兜底）——能力对齐注（2026-08-14 发现）:
+//   bash 版薄包装 source lib/session-end.sh 后 main 因 BASH_SOURCE 守卫不执行
+//   （卡位 #2 完全失效）；TS 版实现完整治理，与 core/qoder/trae 对齐。
+//   当前无 override，命名子类承载端身份 + 未来演进位
+// 协议差异仅剩: PROJECT_DIR = $PWD（vscode 无注入链）
+
+import { SessionEndGuard } from "../../../core/governance/session-end.js"
+
+class VscodeSessionEndGuard extends SessionEndGuard {
+  // 当前无 override（清理/结算/兜底与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+process.exit(new VscodeSessionEndGuard(PROJECT_DIR).run())

package/templates/adapters/vscode/hooks/session-start.ts

@@ -0,0 +1,24 @@
+// session-start.ts — SessionStart 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core SessionStartGuard，命名子类 VscodeSessionStartGuard:
+//   ① emitState（纯文本状态块）+ ② emitIndex（模板索引）= 基类默认（与 vscode bash 原文逐字一致）
+//   ③ emitTodoReminder / ④ emitHitlPending = override 为空（vscode bash 原文仅两段，
+//   无代办/HITL 段——与 claude 同构差异，2026-08-14 实态核验）
+// 协议差异仅剩: PROJECT_DIR = $PWD（vscode 无注入链）
+
+import { SessionStartGuard } from "../../../core/governance/session-start-guard.js"
+
+class VscodeSessionStartGuard extends SessionStartGuard {
+  /** ③ vscode 版无代办刷新段 */
+  protected override emitTodoReminder(_state: string | null): void {
+    // vscode 协议: 无代办刷新段（bash 原文仅两段）
+  }
+
+  /** ④ vscode 版无 HITL 待审批段 */
+  protected override emitHitlPending(): void {
+    // vscode 协议: 无 HITL 检测段（bash 原文仅两段）
+  }
+}
+
+process.env.PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+process.exit(new VscodeSessionStartGuard(process.env.PROJECT_DIR).run())

package/templates/adapters/vscode/hooks/stop-check.ts

@@ -0,0 +1,21 @@
+// stop-check.ts — Stop 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core StopRouter，命名子类 VscodeStopRouter:
+//   bash 原文与 core 逐字相同（2026-08-14 实态核验: vscode bash L40/L56 与 core bash L32/L48
+//   均为 build_stop_context 无 echo，Q2/Q4 换行语义对齐 core TS +"\n"）——当前无 override，
+//   命名子类承载端身份 + 未来演进位
+// 协议差异: 无（纯文本形态同 core）；MAGIC_DIR 物理推导注入（对齐 bash export）
+
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { StopRouter } from "../../../core/governance/stop-router.js"
+
+class VscodeStopRouter extends StopRouter {
+  // 当前无 override（Q0-Q4 分流与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+// 对齐 bash: MAGIC_DIR 从物理位置推导并 export（入口注入优先）
+const inferredMagicDir = tryResolveMagicDir()
+if (inferredMagicDir && !process.env.MAGIC_DIR) {
+  process.env.MAGIC_DIR = inferredMagicDir
+}
+
+process.exit(new VscodeStopRouter().run())

package/templates/adapters/vscode/hooks/subagent-guard.ts

@@ -0,0 +1,21 @@
+// subagent-guard.ts — SubagentStart 入口（VS Code Copilot 版，Task 3.1 继承体系）
+// 继承 core SubagentGuardRouter（状态注入模板方法——能力对齐）；仅 override 协议差异:
+//   ① 输出形态: 纯文本状态块（core/qoder 是 hookSpecificOutput JSON）
+
+import { SubagentGuardRouter } from "../../../core/governance/subagent-guard-router.js"
+
+class VscodeSubagentGuardRouter extends SubagentGuardRouter {
+  /** ① 纯文本状态块（vscode 协议，与 claude 同构） */
+  protected override emit(state: string): void {
+    const [plan, step, rounds, handoff] = state.split("::")
+    process.stdout.write(`[ADD SubagentStart] 子代理上下文注入:
+  Plan: ${plan}
+  Step: ${step}
+  轮次: ${rounds}
+  handoff: ${handoff}
+  遵循 ADD 规范，完成后请检查 checklist 对应项
+`)
+  }
+}
+
+process.exit(new VscodeSubagentGuardRouter().run())

package/templates/adapters/vscode/hooks/subagent-stop.ts

@@ -0,0 +1,15 @@
+// subagent-stop.ts — SubagentStop 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core SubagentStopRouter，命名子类 VscodeSubagentStopRouter:
+//   边界校验 + 审计聚合与 core 逐字同构（2026-08-14 实态核验: vscode 完整实现版
+//   与 core 相同，收敛为子类）——当前无 override，命名子类承载端身份 + 未来演进位
+// 协议差异: 无
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { SubagentStopRouter } from "../../../core/governance/subagent-stop-router.js"
+
+class VscodeSubagentStopRouter extends SubagentStopRouter {
+  // 当前无 override（边界校验 + 审计聚合与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new VscodeSubagentStopRouter().run(input))

package/templates/core/docs/ADD-governance-claude-code.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Claude Code 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Claude Code 的 Hook 机制在 agent 生命周期中确定性运行。面向 add-coder 用户和贡献者，说明每个 hook 事件的治理职能和注入通道。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../.qoder/reports/issue-6-tool-call-throttling-report.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../reports/issue-6-tool-call-throttling-report.md)
 > **Hook 参考**: https://code.claude.com/docs/zh-CN/hooks
 
 ---
@@ -17,7 +17,7 @@ Claude Code 支持 17 种事件，按频率分三档：
 | 每次工具调用 | PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、PermissionDenied |
 | 其他 | PreCompact、SubagentStart、SubagentStop、Notification、ConfigChange、WorktreeCreate/Remove |
 
-配置位置：`.claude/hooks/*.sh` + `.claude/settings.json`
+配置位置：`.claude/hooks/*.mjs`（TS 源码 esbuild 烘焙零依赖产物）+ `.claude/settings.json`（command 直调 node）——2026-08-14 hook node 化实态，bash 待退役
 
 ---
 
@@ -65,13 +65,13 @@ Claude Code 的注入通道为 **stdout → additionalContext**——hook 脚本
 │                                                      │
 │  SessionStart                                        │
 │  ├─ detect_active_add() 扫描 plans/ 恢复 ADD 状态    │
-│  ├─ preload-templates.sh --index                     │
+│  ├─ preload-templates.mjs --index                     │
 │  └─ stdout → additionalContext 注入                  │
 │        │                                             │
 │        ▼                                             │
 │  UserPromptSubmit                                    │
 │  ├─ match_trigger() 检测 ADD 触发词                  │
-│  ├─ 首次命中 → preload-templates.sh --full            │
+│  ├─ 首次命中 → preload-templates.mjs --full            │
 │  ├─ touch tpl-injected 标记                          │
 │  └─ 同会话二次命中 → 短路                             │
 │        │                                             │

package/templates/core/docs/ADD-governance-codex.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Codex 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Codex 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://www.runoob.com/codex/codex-hooks.html | Codex 设置 → 导入其他 agent 配置
 
 ---
@@ -44,15 +44,15 @@ Notification ─────────────────→ ⑫ 开发
 
 Codex 的注入通道为 **stdout**（与 Claude Code 兼容）。Codex 支持导入 Claude Code Hook 配置，可通过双通道架构获得完整治理：
 
-- **Codex 原生**（6 事件，`.codex/hooks.json` → `.codex/hooks/xxx.sh`）
-- **Claude Code 导入**（14 事件，`.claude/settings.json` → `.claude/hooks/xxx.sh`）——Codex 设置中开启「导入其他 agent 配置」即可。同一套脚本，两通道共享，脚本内置幂等保护。
+- **Codex 原生**（5 事件，`.codex/hooks.json` → `.codex/hooks/*.mjs` node 直调——2026-08-14 node 化实态，bash 待退役）
+- **Claude Code 导入**（11 事件，`.claude/settings.json` → `.claude/hooks/*.mjs`）——Codex 设置中开启「导入其他 agent 配置」即可。同一套产物，两通道共享，脚本内置幂等保护。
 
 ```
 npx add-coder init --adapter=codex
         │
-        ├──→ .codex/hooks.json （6 事件 → .codex/hooks/xxx.sh）
+        ├──→ .codex/hooks.json （5 事件 → .codex/hooks/*.mjs）
         ├──→ .codex/settings.json
-        └──→ .claude/ ★ （含完整 14 事件 hooks + settings.json + mcp.json）
+        └──→ .claude/ ★ （含完整 11 事件 hooks + settings.json + mcp.json）
 ```
 
 | 注入场景 | 触发事件 | 注入内容 | 通道 |
@@ -66,7 +66,7 @@ npx add-coder init --adapter=codex
 
 | 维度 | Codex | Claude Code |
 |---|---|---|
-| 事件数 | 0 (原生) / 14 (导入 Claude) | 17 |
+| 事件数 | 5 (原生) / 11 (导入 Claude) | 17 |
 | 配置格式 | `.codex/hooks.json` | `.claude/settings.json` |
 | Claude Hook 导入 | ✅ 原生支持（导入其他 agent 配置） | — |
 | 全局 Hook | `~/.codex/hooks.json` | `~/.claude/settings.json` |

package/templates/core/docs/ADD-governance-qoder-cn.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Qoder CN 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Qoder CN 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://help.aliyun.com/zh/lingma/qoder-cn-update-log
 
 ---
@@ -17,7 +17,7 @@ Qoder CN v1.7.0（2026-07-15）升级至 30+ 事件。以下为 ADD 治理覆盖
 | 每次工具调用 | PreToolUse、PostToolUse、PostToolUseFailure |
 | 其他 | SubagentStart（v1.7.0 新增）、SubagentStop（v1.7.0 新增）、Notification（v1.7.0 新增） |
 
-配置位置：`.qoder/hooks/*.sh` + `.qoder/settings.json`
+配置位置：`.qoder/hooks/*.mjs`（TS 源码 esbuild 烘焙零依赖产物）+ `.qoder/settings.json`（command 直调 node）——2026-08-14 hook node 化实态，bash 待退役
 
 **关键差异**：Qoder CN 不支持 PreCompact / PermissionRequest / PermissionDenied / StopFailure / ConfigChange / Worktree——这些 Claude Code 独有事件在 Qoder 端无对应 hookpoint，相关脚本不编译到 Qoder adapter。
 
@@ -54,7 +54,7 @@ Qoder CN 的注入通道为 **stderr → 下一轮 system prompt 注入**。这
 | 开发触发 | UserPromptSubmit（首次命中） | 13 个模板全文 | stderr → 下一轮 system prompt |
 | 去重 | UserPromptSubmit（同会话后续命中） | 短路跳过 | — |
 
-**重要约束**：Qoder 端 `prompt-submit.sh` 已有 73 行完善的触发词路由系统（Layer 1 精准 P0 触发词 → Layer 2 开发关键词检测 → Layer 3 活跃 ADD 状态注入 + 验收幂等保护）。模板全文注入逻辑以**增量方式**插入 Layer 2 之后，禁止覆盖现有分流逻辑。
+**重要约束**：Qoder 端 `prompt-submit.mjs`（TS 版，core `prompt-router.ts` 继承）已有完善的触发词路由系统（Layer 1 精准 P0 触发词 → Layer 2 开发关键词检测 → Layer 3 活跃 ADD 状态注入 + 验收幂等保护）。模板全文注入逻辑以**增量方式**插入 Layer 2 之后，禁止覆盖现有分流逻辑。
 
 ---
 
@@ -89,11 +89,11 @@ UserPromptSubmit hook additional context: ADD workflow active. ...
 | hook 注册了但不执行 | `command` 缺少 `bash` 前缀 | settings.json 所有 command 加 `bash` 前缀 |
 | hook 执行但 stdout 未被注入 | 纯文本不被 IDE 解析为 additionalContext | 改用 JSON 格式：`{"hookSpecificOutput":{"hookEventName":"...","additionalContext":"..."}}` |
 | 脚本 exit 0 但没有输出 | `VOCABULARY_FILE` 用了 `$PWD`，hook 运行时 cwd 不是项目根 | 改为 `${PROJECT_DIR:-$PWD}` |
-| `detect_active_add` 返回空 | `PROJECT_DIR` 在 `source lib/vocabulary.sh` 之后才设置 | `export PROJECT_DIR` 移到所有 `source` 语句之前 |
+| `detect_active_add` 返回空 | node 版 PROJECT_DIR 未注入 | `tryResolveMagicDir` 注入链前置（env 优先 → 物理推导） |
 | additionalContext 有时注入有时不注入 | 注入代码在 Layer 1 之后——P0 触发词匹配后 `exit 0` 跳过了注入 | 将 additionalContext 注入移到 Layer 1 之前 |
 
 ### 关键设计决策
 
-1. **`PROJECT_DIR` 必须最先设置**：所有 `source lib/*.sh` 之前，因为被 source 的脚本可能依赖 `${PROJECT_DIR}` 定位文件
+1. **`PROJECT_DIR` 注入链最先执行**：env 优先（QODER/QODERCN_PROJECT_DIR）→ `tryResolveMagicDir` 物理推导——入口薄壳首行，因为治理库可能依赖 `${PROJECT_DIR}` 定位文件
 2. **additionalContext 放在入口最前**：在任何 `exit` 分支之前，确保所有代码路径都能注入上下文
 3. **Stop/PreToolUse 不用 JSON**：中断/阻断类输出走 stderr 纯文本，不走 stdout JSON

package/templates/core/docs/ADD-governance-trae.md

@@ -1,7 +1,7 @@
 # ADD 范式在 Trae 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 Trae 的 Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md)
 > **Hook 参考**: https://docs.trae.cn/ide_automate-actions-with-hooks | https://docs.trae.cn/ide_hook-configuration-reference
 
 ---
@@ -42,7 +42,7 @@ Notification ─────────────────→ ⑫ 开发
 
 ## 注入通道
 
-Trae 的注入通道为 **stdout**（与 Claude Code 兼容）。Trae 支持导入 Claude Code Hook 配置，因此 `prompt-submit.sh` 和 `session-start.sh` 的 stdout 输出方式与 Claude Code 端一致。
+Trae 的注入通道为 **stdout**（与 Claude Code 兼容）。Trae 支持导入 Claude Code Hook 配置，因此 `prompt-submit.mjs` 和 `session-start.mjs` 的 stdout 输出方式与 Claude Code 端一致（2026-08-14 node 化实态，bash 待退役）。
 
 | 注入场景 | 触发事件 | 注入内容 | 通道 |
 |---|---|---|---|
@@ -55,7 +55,7 @@ Trae 的注入通道为 **stdout**（与 Claude Code 兼容）。Trae 支持导
 
 | 维度 | Trae | Claude Code |
 |---|---|---|
-| 事件数 | 0 (原生) / 14 (导入 Claude) | 17 |
+| 事件数 | 6 (原生) / 11 (导入 Claude) | 17 |
 | 配置格式 | `hooks.json` | `.claude/settings.json` |
 | Claude Hook 导入 | ✅ 原生支持 | — |
 | SessionEnd | ❌ | ✅ |

package/templates/core/docs/ADD-governance-vscode-copilot.md

@@ -1,7 +1,7 @@
 # ADD 范式在 VS Code Copilot 上的确定性运行
 
 > **定位**：描述 ADD 范式如何通过 VS Code Copilot 的 Agent Hook 机制在 agent 生命周期中确定性运行。
-> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../.qoder/plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../.qoder/reports/issue-6-tool-call-throttling-report.md)
+> **关联文档**：[add-coder-hook-full-alignment-plan-v1](../plans/2026-07/17/add-coder-hook-full-alignment-plan-v1.md) | [issue-6-report](../reports/issue-6-tool-call-throttling-report.md)
 > **Hook 参考**: https://docs.github.com/zh/copilot/concepts/agents/hooks | https://vscode.js.cn/docs/agent-customization/hooks
 > **VS Code 版本要求**: 1.127+（Agent Hook 预览），1.129+（Agent Host 架构，支持 `.claude/settings.json`）
 
@@ -19,9 +19,9 @@ VS Code Copilot 支持 10 种 Agent Hook 事件（官方 8 + Cloud Agent 2）：
 | 子 agent | **SubagentStart**、**SubagentStop** |
 | 其他 | **PreCompact**、errorOccurred（Cloud Agent 专属） |
 
-配置位置：`.github/hooks/*.json`（JSON 格式，`command` 字段指向 shell 脚本）
+配置位置：`.vscode/hooks/*.mjs`（TS 源码 esbuild 烘焙零依赖产物，node 直调——2026-08-14 node 化实态，bash 待退役）
 
-**关键差异 vs Claude Code**：不支持 PostToolUseFailure / StopFailure / Notification / PermissionRequest。但 **VS Code 1.129+ Agent Host 同时读取 `.claude/settings.json`**，`npx add-coder init --adapter=vscode` 会同步产出 `.claude/` 目录，`.github/hooks/*.json` 的 `command` 统一指向 `.claude/hooks/xxx.sh`——双通道共享同一套完整脚本。
+**关键差异 vs Claude Code**：不支持 PostToolUseFailure / StopFailure / Notification / PermissionRequest。但 **VS Code 1.129+ Agent Host 同时读取 `.claude/settings.json`**，`npx add-coder init --adapter=vscode` 会同步产出 `.claude/` 目录，双通道共享同一套 `.mjs` 产物（node 直调）。
 
 ---
 
@@ -48,36 +48,35 @@ errorOccurred ────────────────→ ⑮ 错误分
 
 ## 注入通道
 
-VS Code Copilot 的注入通道为 **`.github/hooks/*.json` 的 `command` stdout**。
+VS Code Copilot 的注入通道为 **hook 配置的 `command` stdout**（node 直调 `.mjs` 产物）。
 
 VS Code 1.129+ 的 Agent Host 架构让同一项目支持多 Agent 并行运行——Copilot、Claude Code 各走各的通道：
 
-| 通道 | 配置位置 | 脚本路径 | 说明 |
+| 通道 | 配置位置 | 产物路径 | 说明 |
 |---|---|---|---|
-| **VS Code 原生** | `.github/hooks/*.json` | `.claude/hooks/xxx.sh` | 10 个 JSON 文件，command 指向完整 Claude 脚本 |
-| **Agent Host (Claude)** | `.claude/settings.json` | `.claude/hooks/xxx.sh` | 同一套脚本，Claude Code agent 直接读取 |
+| **VS Code 原生** | `.vscode/hooks/` | `.vscode/hooks/*.mjs` | 14 入口 node 产物，command 直调 |
+| **Agent Host (Claude)** | `.claude/settings.json` | `.claude/hooks/*.mjs` | 同一套产物，Claude Code agent 直接读取 |
 
 ```
 npx add-coder init --adapter=vscode
         │
-        ├──→ .github/hooks/*.json （10 个，→ .claude/hooks/xxx.sh）
+        ├──→ .vscode/hooks/*.mjs （14 入口，node 直调）
         ├──→ .vscode/settings.json （MCP 配置）
-        ├──→ .vscode/hooks/lib/ （共享库）
         └──→ .claude/ ★ （Agent Host 双通道，含完整 hooks + settings.json + mcp.json）
 ```
 
 | 注入场景 | 触发事件 | 注入内容 | 配置 |
 |---|---|---|---|
-| 会话启动 | SessionStart | 模板索引 | `session-start.json` → `.claude/hooks/lib/preload-templates.sh --index` |
-| 开发触发 | UserPromptSubmit | 13 个模板全文 | `user-prompt-submit.json` → `.claude/hooks/lib/preload-templates.sh --full --top 5 --mark` |
+| 会话启动 | SessionStart | 模板索引 | `.vscode/hooks/session-start.mjs --index` |
+| 开发触发 | UserPromptSubmit | 13 个模板全文 | `.vscode/hooks/preload-templates.mjs --full --top 5 --mark` |
 
 ---
 
 ## 路径约定
 
-VS Code Copilot hooks 必须位于 **项目根目录** 的 `.github/hooks/` 下。`npx add-coder init --adapter vscode` 会将 JSON 文件分发到此路径，而非 `.vscode/` 子目录。
+VS Code Copilot hooks 产物位于 **项目根目录** 的 `.vscode/hooks/`（14 入口 node 产物）。`npx add-coder init --adapter vscode` 会将 TS 源码烘焙分发到此路径；Agent Host（1.129+）同时读取 `.claude/` 双通道。
 
-**Issue #6 背景**：本端的 429 并发问题是最初触发源。轮次 1 优先交付 `session-start.json` + `user-prompt-submit.json` 两个文件，仅这两个 JSON 即可消灭模板读取风暴（429 不再触发）。
+**Issue #6 背景**：本端的 429 并发问题是最初触发源。轮次 1 优先交付 `session-start` + `user-prompt-submit` 两个入口，仅这两个即可消灭模板读取风暴（429 不再触发）。
 
 ---
 
@@ -85,9 +84,9 @@ VS Code Copilot hooks 必须位于 **项目根目录** 的 `.github/hooks/` 下
 
 | 维度 | VS Code Copilot | Claude Code |
 |---|---|---|
-| 配置格式 | `.github/hooks/*.json` | `.claude/settings.json` |
-| 注入通道 | JSON command stdout | stdout → additionalContext |
-| 脚本路径 | `.claude/hooks/xxx.sh`（与 Claude 共享） | `.claude/hooks/xxx.sh` |
+| 配置格式 | `.vscode/hooks/*.mjs`（command 直调） | `.claude/settings.json` |
+| 注入通道 | command stdout | stdout → additionalContext |
+| 产物路径 | `.vscode/hooks/*.mjs`（与 Claude 共享治理层） | `.claude/hooks/*.mjs` |
 | 独有事件 | errorOccurred | PermissionRequest/Denied / StopFailure / Notification / PostToolUseFailure |
 | 子 agent 启动 | ✅ SubagentStart | ✅ SubagentStart |
 | Agent Host 双通道 | ✅ `.claude/` 同步产出 | — |
@@ -96,7 +95,7 @@ VS Code Copilot hooks 必须位于 **项目根目录** 的 `.github/hooks/` 下
 
 ## 自定义 Hook 源切换
 
-VS Code Copilot 的 `.github/hooks/*.json` 默认指向 `.vscode/hooks/xxx.sh`（VS Code 原生完整脚本）。项目同时产出 `.claude/` 目录（含 Claude Code 完整 hook 体系 + settings.json），两套体系可切换。
+VS Code Copilot 的 `.vscode/hooks/*.mjs` 为 VS Code 原生 node 产物（14 入口）。项目同时产出 `.claude/` 目录（含 Claude Code 完整 hook 体系 + settings.json），两套体系可切换。
 
 ### 两套体系对比
 
@@ -107,21 +106,21 @@ VS Code Copilot 的 `.github/hooks/*.json` 默认指向 `.vscode/hooks/xxx.sh`
 | 环境变量 | `$PWD`（VS Code cwd=项目根） | `$CLAUDE_PROJECT_DIR` |
 | 退出码阻断 | ✅ exit 2（与 Claude 相同） | ✅ exit 2 |
 | 上下文注入 | stdout 纯文本（VS Code 格式） | stdout → additionalContext（Claude 格式） |
-| 共享 lib | ✅ `hooks/lib/common.sh` | ✅ `hooks/lib/common.sh` |
+| 共享治理层 | ✅ core governance 内联（0 复制） | ✅ core governance 内联（0 复制） |
 | 治理能力 | 完整四路守卫 + 验收阻断 + 审计 | 完整四路守卫 + 验收阻断 + 审计（与 VS Code 版同等） |
 
-> **两套实现代码质量同等，能力完整，差异仅在于环境变量和输出格式。**
+> **两套实现质量同等，能力完整，差异仅在于环境变量和输出格式。**
 
 ### 切换方式
 
-编辑 `.github/hooks/` 下的任意 JSON 文件，将 `bash` 字段中的路径从 `.vscode/hooks/` 改为 `.claude/hooks/` 即可：
+编辑 hook 配置（settings.json / Agent Host 通道），将 `command` 中的路径从 `.vscode/hooks/` 改为 `.claude/hooks/` 即可：
 
 ```json
 // 默认（VS Code 原生，推荐）
-"bash": "bash .vscode/hooks/pre-tool-use.sh"
+"command": "node .vscode/hooks/pre-tool-use.mjs"
 
-// 切换为 Claude Code 体系（如果同时使用 Claude Code 并希望统一脚本）
-"bash": "bash .claude/hooks/pre-tool-use.sh"
+// 切换为 Claude Code 体系（如果同时使用 Claude Code 并希望统一产物）
+"command": "node .claude/hooks/pre-tool-use.mjs"
 ```
 
 **切换场景建议**：

package/templates/core/governance/audit-bridge.ts

@@ -0,0 +1,47 @@
+// audit-bridge.ts — AuditBridge（审计桥接，Task 8.1 事件面扩展，ADD-7 自动化）
+// 设计（Spec §4 嵌入式三层，回流 R1）:
+//   ① 主路径（现状不动）: 拦截事件 writeHookEvent(jsonl) → MCP 常驻 fs.watch 消费 → devOperation 落库
+//   ② 事件面扩展（本类）: post-tool-use 文件写入 → 写 hook 事件（decision="write"）→ 同一 jsonl 主路径
+//      → MCP 常驻侧自动消费落库（幂等 dedupKey: hook::ts::planKeyword + decision + cmd）
+//   ③ 自然演化: Claude mcp_tool 直调 record_dev_operation 由 handlerTypes 维度声明驱动（TOML 一行切换）
+//
+// 与 writeHookEvent 的关系: 复用其 jsonl 写入 + 轮转逻辑（event.file 真源），
+// 但路径必须用本类 magicDir 构造参数（writeHookEvent 默认 env.MAGIC_DIR || ".qoder"
+// 兜底——core/adapter 入口多数未回写 env.MAGIC_DIR，依赖 env 会错写 .qoder/reports）。
+
+import { writeHookEvent } from "./notify.js"
+
+/**
+ * 审计桥接：post-tool-use 文件写入事件面扩展。
+ * emit() 幂等——同文件同秒重复写入由 MCP 消费端 dedupKey 去重，落库唯一。
+ */
+export class AuditBridge {
+  private readonly projectDir: string
+  private readonly magicDir: string
+
+  constructor(projectDir: string, magicDir: string) {
+    this.projectDir = projectDir
+    this.magicDir = magicDir
+  }
+
+  /**
+   * 文件写入审计事件（decision="write"）。
+   * @param filePath 被写入文件路径（绝对/相对均可，MCP 消费端以 cmd 为 targetId）
+   */
+  emit(filePath: string): void {
+    if (!filePath || filePath === "") return
+    const planKeyword = this.extractPlanKeyword(filePath)
+    writeHookEvent("post-tool-use", "write", filePath, "文件写入审计（ADD-7 自动化）", planKeyword, "none", "", this.magicDir)
+  }
+
+  /**
+   * 从写入路径提取 planKeyword（plans/specs/reviews 目录下命名规范文件）:
+   *   xxx-plan-v1.md / xxx-add-route-v1.md / xxx-review-v1.md → xxx-{suffix}-vN
+   * 其余路径 → "unknown"（与拦截事件缺省语义一致）。
+   */
+  private extractPlanKeyword(filePath: string): string {
+    void this.projectDir
+    const m = filePath.match(/([^/]+-(?:plan|add-route|review)-v\d+)\.md$/)
+    return m ? m[1] : "unknown"
+  }
+}