add-coder 0.3.26 → 0.3.28

package/templates/adapters/qoder/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/session-start.sh"
+            "command": "node .qoder/hooks/session-start.mjs"
           }
         ]
       }
@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/prompt-submit.sh"
+            "command": "node .qoder/hooks/prompt-submit.mjs"
           }
         ]
       }
@@ -26,11 +26,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/pre-tool-use.sh"
+            "command": "node .qoder/hooks/pre-tool-use.mjs"
           },
           {
             "type": "command",
-            "command": "bash .qoder/hooks/doc-format-guard.sh"
+            "command": "node .qoder/hooks/doc-format-guard.mjs"
           }
         ]
       }
@@ -41,11 +41,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/post-tool-use.sh"
+            "command": "node .qoder/hooks/post-tool-use.mjs"
           },
           {
             "type": "command",
-            "command": "bash .qoder/hooks/doc-format-guard.sh"
+            "command": "node .qoder/hooks/doc-format-guard.mjs"
           }
         ]
       }
@@ -55,7 +55,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/post-tool-failure.sh"
+            "command": "node .qoder/hooks/post-tool-failure.mjs"
           }
         ]
       }
@@ -65,7 +65,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/stop-check.sh"
+            "command": "node .qoder/hooks/stop-check.mjs"
           }
         ]
       }
@@ -75,7 +75,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/subagent-guard.sh"
+            "command": "node .qoder/hooks/subagent-guard.mjs"
           }
         ]
       }
@@ -85,7 +85,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/subagent-guard.sh"
+            "command": "node .qoder/hooks/subagent-guard.mjs"
           }
         ]
       }
@@ -95,7 +95,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/pre-compact.sh"
+            "command": "node .qoder/hooks/pre-compact.mjs"
           }
         ]
       }
@@ -106,7 +106,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/notification.sh"
+            "command": "node .qoder/hooks/notification.mjs"
           }
         ]
       }
@@ -116,7 +116,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .qoder/hooks/permission-gate.sh"
+            "command": "node .qoder/hooks/permission-gate.mjs"
           }
         ]
       }

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

@@ -0,0 +1,30 @@
+// doc-format-guard.ts — schema.json 驱动的 ADD 文档格式守卫（Trae 版，Task 6.1 继承体系）
+// 继承 core DocFormatGuard，命名子类 TraeDocFormatGuard:
+//   ① 探测链与 core 数据驱动同语义（PLAN 元信息 → 一、Plan 概述 → 四、Handoff → simple-plan，
+//      2026-08-14 实态核验 trae 独立类 L133-135 与 core 基线一致）→ 当前无 override
+//      （空子类承载端身份 + 未来演进位）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".trae"（构造参数）
+
+import { readFileSync } from "node:fs"
+import { DocFormatGuard } from "../../../core/governance/doc-format-guard.js"
+
+class TraeDocFormatGuard extends DocFormatGuard {
+  /** 协议差异封装: MAGIC_DIR 兜底 = ".trae"（trae 端） */
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir)
+  }
+
+  // 当前无 override（探测链/算法段同 core）；未来 trae 协议演进在此扩展，不改 core
+}
+
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".trae"
+
+const guard = new TraeDocFormatGuard(PROJECT_DIR, MAGIC_DIR)
+let raw = ""
+try {
+  raw = readFileSync(0, "utf-8")
+} catch {
+  raw = ""
+}
+process.exitCode = guard.run(raw)

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

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

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

@@ -0,0 +1,15 @@
+// permission-gate.ts — PermissionRequest 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core PermissionGateRouter，命名子类 TraePermissionGateRouter:
+//   ① 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 TraePermissionGateRouter extends PermissionGateRouter {
+  // 当前无 override（`// empty` 回退 + 高风险工具提示与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new TraePermissionGateRouter().run(input))

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

@@ -0,0 +1,14 @@
+// post-tool-failure.ts — PostToolUseFailure 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core PostToolFailureRouter，命名子类 TraePostToolFailureRouter:
+//   ① emit = 基类默认（stdout 固定文本——bash 原文逐字，trae 为占位实现）
+// 协议差异: 无（与 core 同构）；命名子类承载端身份 + 未来演进位
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PostToolFailureRouter } from "../../../core/governance/post-tool-failure-router.js"
+
+class TraePostToolFailureRouter extends PostToolFailureRouter {
+  // 当前无 override（stdout 固定提示与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+process.exit(new TraePostToolFailureRouter().run(input))

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

@@ -0,0 +1,24 @@
+// post-tool-use.ts — PostToolUse 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core PostToolRouter，命名子类 TraePostToolRouter:
+//   ① §1 DPS 自动化 + §2a-e 文档守卫 + §3 Bash 增强 = 基类
+//   （2026-08-14 实态核验: trae 手写版与 core PostToolRouter 逐字同构）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".trae"（构造参数封装——原手写版误用 ".qoder" 兜底，已修正）
+
+import { jsonGet, readHookInput } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+
+class TraePostToolRouter extends PostToolRouter {
+  /** 协议差异封装: MAGIC_DIR 兜底 = ".trae"（原手写版复制 qoder 时误用 ".qoder" 兜底，2026-08-14 修正） */
+  constructor(projectDir: string) {
+    super(projectDir, process.env.MAGIC_DIR || ".trae")
+  }
+
+  // 当前无 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 TraePostToolRouter(PROJECT_DIR).run(input, toolName))

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

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

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

@@ -0,0 +1,40 @@
+// pre-tool-use.ts — PreToolUse 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core PreToolUseGuard，命名子类 TraePreToolUseGuard:
+//   ① 检测链: 构造传 adapterName="trae" → 加载 [guard.adapter_detectors] trae 独立链
+//      （与 core 同正则同序，stderr 为 trae 长文本版——2026-08-14 实态核验，TOML 数据化）
+//   ② onBlock/onSectionAPass/onNoPlanAllow/onSensitiveDeny/largeFileText/onHitlDeny
+//      = core 基类默认（逐字对照 trae bash 原文一致：JSON ask + logBlock + 事件 + exit 2；
+//      HITL 失败 exit 0 放行）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".trae"（构造参数）
+
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PreToolUseGuard } from "../../../core/governance/pre-tool-guard.js"
+
+class TraePreToolUseGuard extends PreToolUseGuard {
+  /** ① trae 独立检测链（TOML [guard.adapter_detectors] adapter=trae） */
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "trae")
+  }
+
+  // 其余扩展点与 core 基线一致（trae bash 原文逐字对照）；命名子类承载端身份 + 未来演进位
+}
+
+const input = readHookInput()
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+// 探测 MAGIC_DIR（唯一解析链：注入优先 → 物理位置推导）
+let MAGIC_DIR = process.env.MAGIC_DIR
+if (!MAGIC_DIR) {
+  MAGIC_DIR = tryResolveMagicDir() || ".trae"
+}
+
+const toolName = jsonGet(input, "tool_name")
+const command = jsonGet(input, "command")
+
+const guard = new TraePreToolUseGuard(PROJECT_DIR, MAGIC_DIR)
+
+if (command !== "") {
+  process.exit(guard.runSectionA(input))
+} else {
+  process.exit(guard.runSectionB(input, toolName))
+}

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

@@ -0,0 +1,29 @@
+// prompt-submit.ts — UserPromptSubmit 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core PromptRouter（L1/L2/L3 模板方法）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① extractPrompt = 基类默认（jsonGet 与 bash `jq -r '.prompt // empty'` 同语义）
+//   ② acceptedText = 基类默认（trae bash 原文 6 行含 ★ 同步检查，与 core 逐字一致）
+//   ③ onAccepted: 输出 review-checklist 占位文本（trae bash 调占位脚本；core 是子进程 stdio ignore）
+//   ④ layer2ToStderr: false——Layer2 提示输出 stdout（trae bash heredoc 无重定向）
+// 协议差异仅剩: MAGIC_DIR 兜底 = ".trae"（构造参数）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { PromptRouter } from "../../../core/governance/prompt-router.js"
+
+const MAGIC_DIR = process.env.MAGIC_DIR || ".trae"
+
+class TraePromptRouter extends PromptRouter {
+  /** ③ 验收后置: 输出 review-checklist 占位文本（trae bash 调占位脚本逐字） */
+  protected override onAccepted(_handoff: string, _addRoute: string): void {
+    process.stdout.write("[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。\n")
+  }
+
+  /** ④ Layer 2 输出通道（trae: stdout——bash heredoc 无重定向） */
+  protected override layer2ToStderr(): boolean {
+    return false
+  }
+
+  // 其余（extractPrompt/acceptedText/layer3Text/dailyWarnText/afterLayer3）与 core 基线一致
+}
+
+const input = readHookInput()
+process.exit(new TraePromptRouter(MAGIC_DIR).run(input))

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

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

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

@@ -0,0 +1,16 @@
+// session-end.ts — SessionEnd 入口（Trae 版，Task 6.1 继承体系）
+// 继承 core SessionEndGuard，命名子类 TraeSessionEndGuard:
+//   ① 清理标记（tpl + dev）+ ② 审计结算（stderr）+ ③ Stop 兜底 = 基类
+//   （2026-08-14 实态核验: trae 手写版与 core SessionEndGuard 逐字同构——bash 原文
+//   清理 → 警告 → checklist 快照 → 结算，收敛为子类无 override）
+// 协议差异仅剩: PROJECT_DIR = $PWD（trae 无注入链）
+
+import { SessionEndGuard } from "../../../core/governance/session-end.js"
+
+class TraeSessionEndGuard extends SessionEndGuard {
+  // 当前无 override（清理/结算/兜底与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+process.env.PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+
+process.exit(new TraeSessionEndGuard(process.env.PROJECT_DIR).run())

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))
+}