add-coder 0.3.27 → 0.3.29

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

@@ -0,0 +1,15 @@
+// session-start.ts — SessionStart 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core SessionStartGuard，命名子类 TraeSessionStartGuard:
+//   ① 状态恢复 + ② 模板索引 + ③ 代办 + ④ HITL 待审批 = 基类默认
+//   （2026-08-14 实态核验: trae bash 原文四段与 core 逐字一致，收敛为子类无 override）
+// 协议差异仅剩: PROJECT_DIR = $PWD（trae 无注入链）
+
+import { SessionStartGuard } from "../../../core/governance/session-start-guard.js"
+
+class TraeSessionStartGuard extends SessionStartGuard {
+  // 当前无 override（四段与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+process.env.PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+process.exit(new TraeSessionStartGuard(process.env.PROJECT_DIR).run())

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

@@ -0,0 +1,20 @@
+// stop-check.ts — Stop 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core StopRouter，命名子类 TraeStopRouter:
+//   ① Q0-Q4 四象限分流 = 基类（2026-08-14 实态核验: trae bash 原文与 core 逐字相同——
+//   bash diff 为空，收敛为子类无 override）
+// 协议差异: 无（纯文本形态同 core）；MAGIC_DIR 物理推导注入（对齐 bash export）
+
+import { tryResolveMagicDir } from "../../../core/governance/common.js"
+import { StopRouter } from "../../../core/governance/stop-router.js"
+
+class TraeStopRouter 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 TraeStopRouter().run())

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

@@ -0,0 +1,22 @@
+// subagent-guard.ts — SubagentStart 入口（Trae 版，Task 3.1 继承体系）
+// 继承 core SubagentGuardRouter（状态注入模板方法——能力对齐）:
+//   能力对齐注: 原 trae 为弱版（事件提示空话），已对齐强版（状态注入）
+//   ① 输出形态: 纯文本状态块（core/qoder 是 hookSpecificOutput JSON）
+
+import { SubagentGuardRouter } from "../../../core/governance/subagent-guard-router.js"
+
+class TraeSubagentGuardRouter extends SubagentGuardRouter {
+  /** ① 纯文本状态块（trae 协议，与 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 TraeSubagentGuardRouter().run())

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

@@ -0,0 +1,15 @@
+// subagent-stop.ts — SubagentStop 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core SubagentStopRouter，命名子类 TraeSubagentStopRouter:
+//   ① 边界校验 + deliverables 越界检查 + 审计聚合 = 基类（与 trae bash 原文逐字同构，
+//   2026-08-14 实态核验——手写版逻辑与 core 基类完全一致，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR = $PWD（trae 无注入链）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { SubagentStopRouter } from "../../../core/governance/subagent-stop-router.js"
+
+class TraeSubagentStopRouter extends SubagentStopRouter {
+  // 当前无 override（边界校验 + 审计聚合与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new TraeSubagentStopRouter().run(input))

package/templates/adapters/trae/hooks.json

@@ -1 +1 @@
-{"hooks":{"SessionStart":[{"command":"bash .trae/hooks/session-start.sh"}],"UserPromptSubmit":[{"command":"bash .trae/hooks/prompt-submit.sh"}],"PreToolUse":[{"command":"bash .trae/hooks/pre-tool-use.sh"}],"PostToolUse":[{"command":"bash .trae/hooks/post-tool-use.sh"}],"Stop":[{"command":"bash .trae/hooks/stop-check.sh"}],"Notification":[{"matcher":"result","command":"bash .trae/hooks/notification.sh"}]}}
+{"hooks":{"SessionStart":[{"command":"node .trae/hooks/session-start.mjs"}],"UserPromptSubmit":[{"command":"node .trae/hooks/prompt-submit.mjs"}],"PreToolUse":[{"command":"node .trae/hooks/pre-tool-use.mjs"}],"PostToolUse":[{"command":"node .trae/hooks/post-tool-use.mjs"}],"Stop":[{"command":"node .trae/hooks/stop-check.mjs"}],"Notification":[{"matcher":"result","command":"node .trae/hooks/notification.mjs"}]}}

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

@@ -0,0 +1,27 @@
+// doc-format-guard.ts — schema.json 驱动的 ADD 文档格式守卫（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core DocFormatGuard，命名子类 VscodeDocFormatGuard:
+//   探测链 = core 基线（PLAN 元信息 → 一、Plan 概述 → 四、Handoff → simple-plan，
+//   2026-08-14 实态核验与 core 同语义）；
+//   差异点仅一个: 无算法规则段（反作弊/HITL 表/handoff 冲突不校验，bash 原文无此段）
+
+import { readFileSync } from "node:fs"
+import { DocFormatGuard } from "../../../core/governance/doc-format-guard.js"
+
+class VscodeDocFormatGuard extends DocFormatGuard {
+  /** 无算法规则段（vscode bash 原文无反作弊/HITL 表/handoff 冲突校验） */
+  protected override runAlgoChecks(_templateName: string, _filePath: string, _content: string): void {
+    // vscode 协议: 不执行算法化规则校验
+  }
+}
+
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".vscode"
+
+const guard = new VscodeDocFormatGuard(PROJECT_DIR, MAGIC_DIR)
+let raw = ""
+try {
+  raw = readFileSync(0, "utf-8")
+} catch {
+  raw = ""
+}
+process.exitCode = guard.run(raw)

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

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

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

@@ -0,0 +1,15 @@
+// permission-gate.ts — PermissionRequest 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core PermissionGateRouter，命名子类 VscodePermissionGateRouter:
+//   ① tool_name 缺失回退 ""（bash `// empty` 语义）——基类默认，无 override
+//   ② emit = 基类默认（仅高风险工具 Bash/Write/Edit stdout 二次确认，bash 原文逐字）
+// 协议差异: 无（与 core 同构）；命名子类承载端身份 + 未来演进位
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PermissionGateRouter } from "../../../core/governance/permission-gate-router.js"
+
+class VscodePermissionGateRouter extends PermissionGateRouter {
+  // 当前无 override（`// empty` 回退 + 高风险工具提示与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new VscodePermissionGateRouter().run(input))

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

@@ -0,0 +1,32 @@
+// post-tool-failure.ts — PostToolUseFailure 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core PostToolFailureRouter，命名子类 VscodePostToolFailureRouter:
+//   ① error 缺失回退 "未知错误"（bash grep || echo 语义）
+//   ② emit override: 429 限流降级（bash 原文逐字——429/rate.limit/too many requests
+//      → 串行模式建议；否则通用失败提示）——vscode 特有能力，全 stderr
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PostToolFailureRouter } from "../../../core/governance/post-tool-failure-router.js"
+
+class VscodePostToolFailureRouter extends PostToolFailureRouter {
+  /** ① 空输入走 fallback（bash grep || echo 语义：空输入 → "未知错误"） */
+  protected override emptyUsesFallback(): boolean {
+    return true
+  }
+
+  /** ② error 缺失回退 "未知错误"（bash grep || echo 语义） */
+  protected override fallbackError(): string {
+    return "未知错误"
+  }
+
+  /** ② 429 限流降级（bash 原文逐字） */
+  protected override emit(_toolName: string, error: string): void {
+    if (/429|rate\.limit|too many requests/.test(error)) {
+      process.stderr.write("[ADD PostToolFailure] ⚠️ 检测到 429 限流。建议切换为串行模式，降低并行调用数。\n")
+    } else {
+      process.stderr.write(`[ADD PostToolFailure] 工具调用失败: ${error}。请检查并修复。\n`)
+    }
+  }
+}
+
+const input = readHookInput()
+process.exit(new VscodePostToolFailureRouter().run(input))

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

@@ -0,0 +1,25 @@
+// post-tool-use.ts — PostToolUse 入口（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core PostToolRouter，命名子类 VscodePostToolRouter:
+//   六端实态核验（2026-08-14）: post-tool-use 段落能力统一 core 全段
+//   （§1 DPS 自动化 + §2a-e 文档守卫 + §3 Bash 增强）——当前无 override，
+//   命名子类承载端身份 + 未来演进位（如 vscode 协议支持 feedback JSON 时在此扩展）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".vscode"（构造参数注入）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+
+class VscodePostToolRouter extends PostToolRouter {
+  /** 协议差异封装: MAGIC_DIR 兜底 = ".vscode"（env 注入优先，bash 原文逐字） */
+  constructor(projectDir: string) {
+    super(projectDir, process.env.MAGIC_DIR || ".vscode")
+  }
+
+  // 当前无 override（段落能力与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const input = readHookInput()
+const toolName = jsonGet(input, "tool_name")
+if (toolName === "") process.exit(0)
+
+process.exit(new VscodePostToolRouter(PROJECT_DIR).run(input, toolName))

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

@@ -0,0 +1,15 @@
+// pre-compact.ts — 上下文压缩前 ADD 状态保存（VS Code Copilot 版，Task 5.1 继承体系）
+// 继承 core PreCompactGuard，命名子类 VscodePreCompactGuard:
+//   ① 状态保存到恢复标记 + ② tpl 标记清理 = 基类（与 vscode bash 原文逐字同构，
+//   2026-08-14 实态核验——手写版逻辑与 core 基类完全一致，收敛为子类）
+// 协议差异仅剩: PROJECT_DIR = $PWD（vscode 无注入链）
+
+import { PreCompactGuard } from "../../../core/governance/pre-compact-guard.js"
+
+class VscodePreCompactGuard extends PreCompactGuard {
+  // 当前无 override（状态保存/恢复清单/tpl 清理与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+process.env.PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+process.exit(new VscodePreCompactGuard().run())

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

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

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

@@ -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

@@ -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

@@ -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

@@ -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 | ❌ | ✅ |