add-coder 0.3.26 → 0.3.28

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

@@ -0,0 +1,34 @@
+// notification.ts — Notification 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core NotificationRouter，命名子类 QoderNotificationRouter:
+//   ① 兜底 magicDir = ".qoder"（构造参数注入——替代 bash 硬编码 ${PROJECT_DIR}/.qoder/reviews）
+//   ② emitReminder override: 无 Plan 前缀（qoder bash 原文逐字「[ADD Notification] 请检查 Review 文档」，
+//     与 core 的 Plan 前缀文本差异保留——非能力漂移，qoder bash 原文如此）
+//   ③ 输出通道: stdout（qoder bash 原文 echo 无 >&2 重定向——违反 qoder JSON 规范但缺陷照搬，
+//     归 Task 9.4 缺陷修复专项）
+// 协议差异仅剩: PROJECT_DIR 注入链（qoder-env）
+
+import { readHookInput } from "../../../core/governance/common.js"
+import { NotificationRouter } from "../../../core/governance/notification-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+class QoderNotificationRouter extends NotificationRouter {
+  /** 协议差异封装: fallbackMagicDir = ".qoder"（qoder 端兜底，bash 原文硬编码语义） */
+  constructor(projectDir: string) {
+    super(projectDir, ".qoder")
+  }
+
+  /** ① qoder bash 原文硬编码 ${PROJECT_DIR}/.qoder/reviews——无跨端探测循环（协议差异，不做探测） */
+  protected override resolveMagicDir(): string {
+    return process.env.MAGIC_DIR ?? ".qoder"
+  }
+
+  /** ② qoder 提醒文本: 无 Plan 前缀（bash 原文逐字） */
+  protected override emitReminder(_plan: string, reviewsDir: string): void {
+    process.stdout.write(`[ADD Notification] 请检查 Review 文档: ${reviewsDir}\n`)
+  }
+}
+
+const input = readHookInput()
+const PROJECT_DIR = injectProjectDir()
+
+process.exit(new QoderNotificationRouter(PROJECT_DIR).run(input))

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

@@ -0,0 +1,26 @@
+// permission-gate.ts — PermissionRequest 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core PermissionGateRouter，命名子类 QoderPermissionGateRouter:
+//   ① emit override: 全量工具 stderr 日志（qoder bash 原文无条件输出——
+//      qoder 权限弹窗自行处理 Review 卡位；core 是仅高风险工具 stdout 提示）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PermissionGateRouter } from "../../../core/governance/permission-gate-router.js"
+
+class QoderPermissionGateRouter extends PermissionGateRouter {
+  /** ① tool_name 缺失回退 "unknown"（bash jq `// \"unknown\"` 语义） */
+  protected override fallbackToolName(): string {
+    return "unknown"
+  }
+
+  /** ② qoder 协议: 全量工具 stderr 日志（bash 原文逐字） */
+  protected override emit(toolName: string): void {
+    process.stderr.write(`[ADD PermissionRequest] 工具 ${toolName} 请求权限。如有 Review 文档待确认，请先检查。\n`)
+  }
+}
+
+// 对齐 bash: MAGIC_DIR 由物理位置推导注入（替代 HOOK_DIR 局部变量 source 传递）
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+const input = readHookInput()
+process.exit(new QoderPermissionGateRouter().run(input))

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

@@ -0,0 +1,30 @@
+// post-tool-failure.ts — PostToolUseFailure 入口（Qoder CN 版，Task 4.1 继承体系补全）
+// 继承 core PostToolFailureRouter，命名子类 QoderPostToolFailureRouter:
+//   ① emit override: stderr 回退建议（qoder bash 原文逐字——
+//      「检查是否需要回退到上一 ADD Step 重新执行」；core 是 stdout 固定提示）
+
+import { readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PostToolFailureRouter } from "../../../core/governance/post-tool-failure-router.js"
+
+class QoderPostToolFailureRouter extends PostToolFailureRouter {
+  /** ① tool_name/error 缺失回退 "unknown"（bash jq `// \"unknown\"` 语义） */
+  protected override fallbackToolName(): string {
+    return "unknown"
+  }
+
+  protected override fallbackError(): string {
+    return "unknown"
+  }
+
+  /** ② qoder 协议: stderr 回退建议（bash 原文逐字） */
+  protected override emit(toolName: string, error: string): void {
+    process.stderr.write(`[ADD PostToolUseFailure] 工具 ${toolName} 失败: ${error}。检查是否需要回退到上一 ADD Step 重新执行。\n`)
+  }
+}
+
+// 对齐 bash: MAGIC_DIR 由物理位置推导注入
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+
+const input = readHookInput()
+process.exit(new QoderPostToolFailureRouter().run(input))

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

@@ -0,0 +1,32 @@
+// post-tool-use.ts — PostToolUse 入口（Qoder CN 版，Task 4.1 能力演进）
+// 继承 core PostToolRouter；协议能力实证（2026-08-14 Qoder 官方文档）:
+//   Qoder PostToolUse 事件支持 stdout JSON，专属字段 hookSpecificOutput.feedback
+//   （「反馈信息，会展示给用户」）——qoder 输出通道用 feedback JSON（能力演进，
+//   非收敛降级）；段落能力（§1 DPS + §2a-e + §3）对齐 core 全段（此前 qoder §1
+//   缺分支为 bash 时代漂移，已补齐）。
+// 协议差异: 输出通道 collectJson=true（feedback JSON）+ PROJECT_DIR 注入链
+
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { PostToolRouter } from "../../../core/governance/post-tool-router.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+class QoderPostToolRouter extends PostToolRouter {
+  /** 输出通道: feedback JSON（Qoder 文档实证 PostToolUse 专属字段） */
+  protected override collectJson(): boolean {
+    return true
+  }
+}
+
+const input = readHookInput()
+let toolName = jsonGet(input, "tool_name")
+if (toolName === "") {
+  toolName = input.match(/"tool_name"\s*:\s*"([^"]*)"/)?.[1] ?? ""
+}
+
+process.exit(new QoderPostToolRouter(PROJECT_DIR, MAGIC_DIR).run(input, toolName))

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

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

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

@@ -0,0 +1,112 @@
+// pre-tool-use.ts — PreToolUse 入口（Qoder CN 版，Task 4.1 继承体系）
+// 继承 core PreToolUseGuard（模板方法固化治理流程）；仅 override 协议差异（bash 原文逐字对照）:
+//   ① 检测链: 构造传 adapterName="qoder" → 加载 [guard.adapter_detectors] qoder 独立链
+//      （与 claude 同构四段链，2026-08-14 实态核验）
+//   ② onBlock: stderr + stdout JSON deny（permissionDecision: deny）+ 事件 + exit 2（无 logBlock）
+//   ③ onSensitiveDeny: stderr + JSON deny + 事件 + exit 2（core 无事件上报）
+//   ④ onSectionAPass: Bash 放行 markDevAction（同 claude）
+//   ⑤ largeFileText: 「Qoder 40500」错误码提示（qoder IDE 特有）
+//   ⑥ onHitlDeny: JSON deny + additionalContext + exit 2 + event "ask"（core exit 0 + event "deny"）
+//   ⑦ onOtherTool: ③ Read matcher 模板提示（同 claude）
+
+import { jsonGet, readHookInput, tryResolveMagicDir } from "../../../core/governance/common.js"
+import { writeHookEvent } from "../../../core/governance/notify.js"
+import { PreToolUseGuard } from "../../../core/governance/pre-tool-guard.js"
+import { markDevAction } from "../../../core/governance/common.js"
+import { injectProjectDir } from "./lib/qoder-env.js"
+
+injectProjectDir()
+const inferred = tryResolveMagicDir()
+if (inferred && !process.env.MAGIC_DIR) process.env.MAGIC_DIR = inferred
+const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd()
+const MAGIC_DIR = process.env.MAGIC_DIR || ".qoder"
+
+/** JSON deny 输出（Qoder PreToolUse 协议: permissionDecision deny） */
+function denyJsonOut(reason: string): string {
+  return JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: reason,
+    },
+  }) + "\n"
+}
+
+class QoderPreToolUseGuard extends PreToolUseGuard {
+  constructor(projectDir: string, magicDir: string) {
+    super(projectDir, magicDir, "qoder")
+  }
+
+  /** ② §A 阻断: stderr + JSON deny + 事件 + exit 2（无 logBlock） */
+  protected override onBlock(blocked: { reason: string; stderr: string }, command: string): number {
+    process.stderr.write(blocked.stderr.replaceAll("{{cmd}}", command))
+    process.stdout.write(denyJsonOut(blocked.reason))
+    writeHookEvent("pre-tool-use", "deny", command, blocked.reason, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ③ §B 敏感文件: stderr + JSON deny + 事件 + exit 2 */
+  protected override onSensitiveDeny(filePath: string): number {
+    process.stderr.write(`⛔ 敏感文件受保护，禁止写入: ${filePath}\n`)
+    process.stdout.write(denyJsonOut("敏感文件受保护"))
+    writeHookEvent("pre-tool-use", "deny", filePath, "敏感文件受保护", this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ④ §A 放行后处理: bash 原文 mark_dev_action */
+  protected override onSectionAPass(_command: string): void {
+    markDevAction()
+  }
+
+  /** ⑤ 大文件提示: Qoder 40500 错误码（qoder IDE 特有） */
+  protected override largeFileText(fsize: number): string {
+    return `⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发 Qoder 40500。建议用 SearchReplace 分块追加。\n`
+  }
+
+  /** ⑥ HITL 未 tongyi: JSON deny + additionalContext + exit 2 + event "ask" */
+  protected override onHitlDeny(toolName: string, filePath: string, tongyiMarker: string): number {
+    process.stderr.write(`⛔ [ADD PreToolUse §C] HITL 未 tongyi: ${filePath}\n`)
+    process.stderr.write(`   原因: 哨兵文件 ${tongyiMarker} 不存在\n`)
+    process.stderr.write(`   操作: 请先调用 create_hitl 创建审批，再 update_hitl({ status: "TONGYI" })\n`)
+    const msg = `⛔ HITL 未 tongyi: 哨兵 ${tongyiMarker} 不存在。请先 create_hitl → 人工 tongyi → update_hitl 后再写入`
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "deny",
+          permissionDecisionReason: msg,
+          additionalContext: msg,
+        },
+      }) + "\n"
+    )
+    writeHookEvent("pre-tool-use", "ask", `${toolName} ${filePath}`, `HITL 未 tongyi: ${tongyiMarker}`, this.planKeyword, this.planStatus)
+    return 2
+  }
+
+  /** ⑦ ③ 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 QoderPreToolUseGuard(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/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))