add-coder 0.3.27 → 0.3.28

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

@@ -0,0 +1,66 @@
+// prompt-submit.ts — UserPromptSubmit 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core PromptRouter（L1/L2/L3 模板方法）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① preamble: 无条件 "ADD workflow active" JSON 注入（Qoder 主端协议）
+//   ② onAccepted: review-checklist 内存调用（checkReviewQuality，非 core 子进程）
+//   ③ devKwMatched: 逐个正则 some（core 是 join("|") 单正则）
+//   ④ layer3Json: true——Layer3 输出 hookSpecificOutput JSON 包
+//   ⑤ dailyInContext: true——日报并入 additionalContext（core 独立行）
+//   ⑥ dailyWarnText: 「建议创建 Plan」（无"或检查 hooks 误报"）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PromptRouter } from "../../../core/governance/prompt-router.js"
+import { checkReviewQuality } from "../../../core/governance/review-checklist-guard.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const MAGIC_DIR = process.env.MAGIC_DIR ?? ".qoder"
+
+class QoderPromptRouter extends PromptRouter {
+  /** ① 前置注入: 无条件 JSON（Qoder CN IDE stdout JSON 注入模型上下文） */
+  protected override preamble(_input: string): void {
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "UserPromptSubmit",
+          additionalContext: "ADD workflow active. Templates preloaded. Use add-paradigm SKILL.",
+        },
+      }) + "\n"
+    )
+  }
+
+  /** ② 验收后置: checklist 质量检查内存调用（bash 外部调用 → TS 内存调用，stdout 直出行为等价） */
+  protected override onAccepted(handoff: string, addRoute: string): void {
+    process.stdout.write(checkReviewQuality(handoff, addRoute) + "\n")
+  }
+
+  /** ③ 开发关键词匹配: 逐个正则 some */
+  protected override devKwMatched(prompt: string, devKw: string[]): boolean {
+    return devKw.some((kw) => {
+      try {
+        return new RegExp(kw, "i").test(prompt)
+      } catch {
+        return false
+      }
+    })
+  }
+
+  /** ④ Layer3 JSON 输出 */
+  protected override layer3Json(): boolean {
+    return true
+  }
+
+  /** ⑤ 日报并入 additionalContext */
+  protected override dailyInContext(): boolean {
+    return true
+  }
+
+  /** ⑥ 日报告警文本（无"或检查 hooks 误报"） */
+  protected override dailyWarnText(noPlan: number, threshold: number): string {
+    return `[Hook ⚠️] 无 Plan 提示已达 ${noPlan} 次（≥${threshold}），建议创建 Plan`
+  }
+}
+
+const input = readHookInput()
+process.exit(new QoderPromptRouter(MAGIC_DIR).run(input))

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

@@ -0,0 +1,24 @@
+// review-checklist.ts — 验收 Review 模式（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core ReviewChecklistGuard，命名子类 QoderReviewChecklistGuard:
+//   ① specRoot = ".qoder/specs"（构造参数——checkReviewQuality 默认值同，qoder 协议差异）
+//   ② Step 0 准入失败 exit 1 语义 = 基类（qoder bash 原文逐字）
+// 被 prompt-submit 的「验收」幂等检查后调用。
+
+import { ReviewChecklistGuard } from "../../../core/governance/review-checklist-guard.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderReviewChecklistGuard extends ReviewChecklistGuard {
+  /** 协议差异封装: specRoot = ".qoder/specs"（qoder 端 spec 目录） */
+  constructor() {
+    super(".qoder/specs")
+  }
+
+  // 当前无 override（Step 0 准入 exit 1 语义与 core 基线一致）；命名子类承载端身份 + 未来演进位
+}
+
+injectProjectDir()
+
+const handoff = process.argv[2] ?? ""
+const addRoute = process.argv[3] ?? ""
+
+process.exit(new QoderReviewChecklistGuard().run(handoff, addRoute))

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

@@ -0,0 +1,27 @@
+// session-end.ts — SessionEnd 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core SessionEndGuard，命名子类 QoderSessionEndGuard:
+//   ① 清理标记（tpl + dev）= 基类（bash 原文逐字）
+//   ② emitSettle override: stdout JSON additionalContext（qoder 协议——
+//     含 fallbackMsg 检测，bash 缺陷照搬: 清理后 hasDevAction 恒 false，fallbackMsg 恒空）
+//   ③ stopFallback = 基类（清理后 hasDevAction 恒 false → 恒无操作，与 qoder bash 原文等价）
+
+import { hasDevAction, localIsoSeconds } from "../../../core/governance/common.js"
+import { SessionEndGuard } from "../../../core/governance/session-end.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderSessionEndGuard extends SessionEndGuard {
+  /** ② qoder 协议: stdout JSON additionalContext（含 fallbackMsg 检测——bash 缺陷照搬顺序） */
+  protected override emitSettle(): void {
+    // bash 缺陷照搬: 先清理 dev 标记再检查 has_dev_action——清理后检查恒为 false
+    let fallbackMsg = ""
+    if (hasDevAction()) {
+      fallbackMsg = "⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查"
+    }
+    const ctx = `[ADD SessionEnd] 会话结束 — ${localIsoSeconds()}。标记已清理。${fallbackMsg}`
+    process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionEnd", additionalContext: ctx } }) + "\n")
+  }
+}
+
+injectProjectDir()
+
+process.exit(new QoderSessionEndGuard().run())

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

@@ -0,0 +1,83 @@
+// session-start.ts — SessionStart 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core SessionStartGuard；仅 override 协议差异（bash 原文逐字对照）:
+//   ① emitState: JSON 注入（ADD: plan Step.. Round.. + 代办并入）
+//   ② emitIndex: JSON 注入（lines 计数，对齐 bash wc -l）
+//   ③ emitTodoReminder: 空（代办已并入状态段）
+//   ④ emitHitlPending: JSON 注入
+
+import { existsSync, readdirSync, statSync } from "node:fs"
+import { join } from "node:path"
+import { detectActiveAdd, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PreloadTemplates } from "../../../core/governance/preload-templates.js"
+import { SessionStartGuard } from "../../../core/governance/session-start-guard.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+const PROJECT_DIR = injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const MAGIC_DIR = process.env.MAGIC_DIR ?? ""
+
+/** JSON 输出助手（Qoder stdout 规范） */
+function sessionJson(context: string): string {
+  return JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: context } }) + "\n"
+}
+
+class QoderSessionStartGuard extends SessionStartGuard {
+  constructor(projectDir: string) {
+    super(projectDir)
+  }
+
+  /** ① 状态恢复: JSON 注入（ADD: plan Step.. Round.. + 代办并入） */
+  protected override emitState(state: string | null): void {
+    if (state === null) return
+    const [plan, step, rounds] = state.split("::")
+    let addCtx = `ADD: ${plan} Step${step} Round${rounds}`
+    addCtx += "\n[代办] 如有未加载的 IDE 代办清单，请从 tasks.md §IDE JSON 刷新 TodoWrite"
+    process.stdout.write(sessionJson(addCtx))
+  }
+
+  /** ② 模板索引: JSON 注入（对齐 bash bash "$TPL_SCRIPT" --index | wc -l） */
+  protected override emitIndex(): void {
+    try {
+      const preload = new PreloadTemplates()
+      preload.validate()
+      const idx = preload.index()
+      const lines = idx.split("\n").length - 1 // wc -l 语义
+      process.stdout.write(sessionJson(`${lines} ADD templates available. Use preload-templates.sh --index for list.`))
+    } catch {
+      /* 对齐 bash [ -f "$TPL_SCRIPT" ] 缺失时跳过 */
+    }
+  }
+
+  /** ③ 代办已并入状态段 */
+  protected override emitTodoReminder(_state: string | null): void {
+    // qoder 协议: 代办并入 emitState
+  }
+
+  /** ④ HITL 待审批: JSON 注入（对齐 bash find *.hitl.md -mtime -7） */
+  protected override emitHitlPending(): void {
+    const plansDir = join(PROJECT_DIR, MAGIC_DIR, "plans")
+    if (MAGIC_DIR !== "" && existsSync(plansDir)) {
+      const weekAgo = Date.now() - 7 * 24 * 3600 * 1000
+      let hitlCount = 0
+      try {
+        hitlCount = readdirSync(plansDir)
+          .filter((f) => f.endsWith(".hitl.md"))
+          .filter((f) => {
+            try {
+              return statSync(join(plansDir, f)).mtimeMs >= weekAgo
+            } catch {
+              return false
+            }
+          }).length
+      } catch {
+        hitlCount = 0
+      }
+      if (hitlCount > 0) {
+        process.stdout.write(sessionJson(`[HITL 待审批] 检测到 ${hitlCount} 个待审批 HITL 提案，请检查并处理`))
+      }
+    }
+  }
+}
+
+process.exit(new QoderSessionStartGuard(PROJECT_DIR).run())

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

@@ -0,0 +1,69 @@
+// stop-check.ts — Stop 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core StopRouter（Q0-Q4 模板方法）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① stop_hook_active=true → 跳过（Qoder 内部 Stop 触发，入口解析）
+//   ② emitQ0/Q3/Q4Pass: stdout 输出 hookSpecificOutput JSON（Qoder stdout 规范）
+//   ③ emitQ2/emitQ4Unclosed: stderr 无 \n 后缀（qoder 版差异）
+//   ④ ~~unclosedInterpolate: false~~ → 已修复（Task 9.4.1: 回归基类 true 插值语义）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { StopRouter } from "../../../core/governance/stop-router.js"
+import { buildStopContext } from "./lib/context-inject.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+/** JSON 输出助手（Qoder stdout 规范） */
+function stopJson(context: string): string {
+  return JSON.stringify({ hookSpecificOutput: { hookEventName: "Stop", additionalContext: context } }) + "\n"
+}
+
+class QoderStopRouter extends StopRouter {
+  /** ② Q0: stderr + stdout JSON + 2 */
+  protected override emitQ0(reason: string): number {
+    process.stderr.write(`[ADD Stop] ⛔ Plan status 暂不可用（${reason}）。未回退 Handoff/add-route 猜测，请恢复数据库或 MCP resolver 后重试。\n`)
+    process.stdout.write(stopJson(`[ADD Stop] Plan status 暂不可用（${reason}），fail-closed 阻断`))
+    return 2
+  }
+
+  /** ③ Q2: stderr few-shot 无 \n 后缀（qoder 差异） */
+  protected override emitQ2(): number {
+    process.stderr.write(buildStopContext("no_add_has_dev", ""))
+    return 2
+  }
+
+  /** ② Q3: stdout JSON + 0 */
+  protected override emitQ3(plan: string, rounds: string, step: string): number {
+    process.stdout.write(stopJson(`[ADD Stop] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}。本次无代码改动，下次继续时执行 session-init 恢复上下文。`))
+    return 0
+  }
+
+  /** ③④ Q4 未闭环: stderr 无 \n + 字面量缺陷照搬（不插值） */
+  protected override emitQ4Unclosed(info: string): number {
+    process.stderr.write(buildStopContext("has_add_dev_unclosed", info))
+    return 2
+  }
+
+  /** ② Q4 通过: stdout JSON + 0 */
+  protected override emitQ4Pass(): number {
+    process.stdout.write(stopJson("[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。"))
+    return 0
+  }
+}
+// 注: ④ unclosedInterpolate 缺陷照搬（false → {{info}} 传空串不插值）已修复——
+// 2026-08-14 Task 9.4.1 删除 override，回归基类 true（插值语义），golden 反写。
+
+// ── 入口 ──
+// 对齐 bash: stop_hook_active=true → 跳过（Qoder 内部 Stop 触发）
+const input = readHookInput()
+let stopActive = "false"
+try {
+  const parsed = JSON.parse(input) as { stop_hook_active?: unknown }
+  stopActive = typeof parsed.stop_hook_active === "string" ? parsed.stop_hook_active : "false"
+} catch {
+  stopActive = "false"
+}
+if (stopActive === "true") process.exit(0)
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+process.exit(new QoderStopRouter().run())

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

@@ -0,0 +1,16 @@
+// subagent-guard.ts — SubagentStart 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core SubagentGuardRouter，命名子类 QoderSubagentGuardRouter:
+//   输出形态 = 基类默认（hookSpecificOutput JSON，与 core 同构）——当前无 override，
+//   命名子类承载端身份 + 未来演进位（如 SubagentStart 新增字段）。
+// 协议差异: PROJECT_DIR 注入链（qoder-env）
+
+import { SubagentGuardRouter } from "../../../core/governance/subagent-guard-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderSubagentGuardRouter extends SubagentGuardRouter {
+  // 当前无 override（基类 JSON 输出即 qoder 协议）
+}
+
+injectProjectDir()
+
+process.exit(new QoderSubagentGuardRouter().run())

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

@@ -0,0 +1,33 @@
+// subagent-stop.ts — SubagentStop 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core SubagentStopRouter，命名子类 QoderSubagentStopRouter（qoder 协议差异 override）:
+//   ① checkDeliverables: false——qoder 轻量提示无阻断（bash 原文无交付物越界检查）
+//   ② emitNoPlanWarn: stdout JSON（qoder 协议；core 是 stderr 文本）
+//   ③ emitBoundaryPass: stdout JSON（qoder 协议；core 是 stderr 两行审计）
+
+import { detectActiveAdd, readHookInput } from "../../../core/governance/common.js"
+import { SubagentStopRouter } from "../../../core/governance/subagent-stop-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderSubagentStopRouter extends SubagentStopRouter {
+  /** ① qoder 轻量提示无阻断（bash 原文无交付物越界检查） */
+  protected override checkDeliverables(): boolean {
+    return false
+  }
+
+  /** ② 无活跃 Plan: stdout JSON（qoder 协议） */
+  protected override emitNoPlanWarn(agentName: string): void {
+    const ctx = `[ADD SubagentStop] ⚠️ ${agentName} 已完成，但无活跃 ADD Plan 无法校验边界。`
+    process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "SubagentStop", additionalContext: ctx } }) + "\n")
+  }
+
+  /** ③ 边界通过: stdout JSON（qoder 协议——bash 原文逐字文本） */
+  protected override emitBoundaryPass(agentName: string, planKw: string, handoff: string): void {
+    const ctx = `[ADD SubagentStop] ${agentName} 子代理结束。Plan: ${planKw}, handoff: ${handoff}。边界校验通过，审计已聚合。`
+    process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "SubagentStop", additionalContext: ctx } }) + "\n")
+  }
+}
+
+injectProjectDir()
+
+const input = readHookInput()
+process.exit(new QoderSubagentStopRouter().run(input))

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())