add-coder 0.3.27 → 0.3.28

package/templates/core/hooks/post-tool-use.sh

@@ -1,138 +0,0 @@
-#!/bin/bash
-# post-tool-use.sh — PostToolUse：格式化 + 文档守卫 + 审计提醒 + DPS 自动化
-# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强 + 哨兵自动化
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-input=$(parse_input)
-tool_name=$(json_get "$input" "tool_name")
-[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-
-# ═══════════════ §1: HITL DPS 自动化 — check_dps ≥ 80 → 自动建哨兵 ═══════════════
-# 检测 MCP check_dps 调用结果，DPS ≥ 80 自动 touch .tongyi-{plan} 哨兵
-if echo "$input" | grep -q '"check_dps"'; then
-  tool_output=$(echo "$input" | grep -o '"output"[[:space:]]*:[[:space:]]*"[^"]*"\|"content"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null || echo "")
-  dps_score=$(echo "$tool_output" | grep -oP 'DPS\s*=\s*\K\d+' 2>/dev/null || echo "")
-  plan_keyword=$(echo "$input" | grep -oP '"planKeyword"\s*:\s*"\K[^"]+' 2>/dev/null || echo "")
-
-  if [ -n "$dps_score" ] && [ -n "$plan_keyword" ]; then
-    if [ "$dps_score" -ge 80 ] 2>/dev/null; then
-      sentinel="${PROJECT_DIR:-$PWD}/${MAGIC_DIR:-.qoder}/hitl/.tongyi-${plan_keyword}"
-      if [ ! -f "$sentinel" ]; then
-        touch "$sentinel" 2>/dev/null && echo "[ADD PostToolUse] ✅ DPS=${dps_score} ≥80, HITL 自动通过 → ${sentinel}" >&2 || true
-        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 已自动建哨兵 ${sentinel}" >&2
-      else
-        echo "[ADD PostToolUse] DPS=${dps_score} ≥80, 哨兵已存在 → ${sentinel}" >&2
-      fi
-    else
-      echo "[ADD PostToolUse] ⚠️ DPS=${dps_score} <80, 需 Review 后手动建哨兵 .tongyi-${plan_keyword}" >&2
-      echo "[ADD PostToolUse] 修复文档后重新 check_dps，通过即自动放行。" >&2
-    fi
-  fi
-fi
-
-# ═══════════════ §2: Edit/Write matcher: 格式化 + 文档守卫 + 自动 plan_track ═══════════════
-if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  [ -z "$file_path" ] && exit 0
-
-  # §2a: ADD 文档结构守卫
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
-    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全。" >&2
-  fi
-
-  # §2b: plan_track 自动触发 — specs/ 或 add-route 写入后自动落库
-  if echo "$file_path" | grep -qE '/(specs|plans)/.*add-route'; then
-    plan_name=$(basename "$file_path" | sed 's/-add-route.*//' | sed 's/-plan-v[0-9]*$//')
-    # 从路径提取完整 planName（含 -plan-vN 后缀）
-    if echo "$file_path" | grep -qE 'add-route'; then
-      # add-route 写入：从文件名反推 planName
-      plan_prefix=$(basename "$file_path" | sed 's/-add-route-v[0-9]*\.md$//')
-      plan_dir=$(dirname "$file_path")
-      if [ -d "$plan_dir" ]; then
-        plan_file=$(ls "$plan_dir"/*-plan-v*.md 2>/dev/null | head -1 || echo "")
-        if [ -n "$plan_file" ]; then
-          plan_name=$(basename "$plan_file" .md)
-        fi
-      fi
-    fi
-    if [ -n "$plan_name" ]; then
-      echo "[ADD PostToolUse] 📊 自动同步 PlanRecord: plan_track({ planName: \"${plan_name}\" }) — 请执行" >&2
-    fi
-  fi
-
-  # §2c: devlog 自动提醒 — add-route Step 8 全 [x] 时提醒
-  if echo "$file_path" | grep -qE 'add-route.*\.md$'; then
-    if [ -f "$file_path" ]; then
-      step8_content=$(sed -n '/## Step 8/,/^## /p' "$file_path" 2>/dev/null || echo "")
-      unchecked=$(echo "$step8_content" | grep -c '^\- \[ \]' 2>/dev/null || echo "0")
-      checked=$(echo "$step8_content" | grep -c '^\- \[x\]' 2>/dev/null || echo "0")
-      if [ "$unchecked" = "0" ] && [ "$checked" -gt 0 ]; then
-        echo "[ADD PostToolUse] ⚠️ Step 8 全部收敛完成！请写 devlog日志(走mcp) → 更新 handoff" >&2
-      fi
-    fi
-  fi
-
-  # §2d: schema.json 自动 regen — 模板 .md 修改后更新对应 schema
-  if echo "$file_path" | grep -qE 'templates/.*\.md$'; then
-    schema_file="${file_path%.md}.schema.json"
-    if [ -f "$schema_file" ]; then
-      # 扫描模板实际 ## 标题，更新 schema sections
-      headings=$(grep -oP '^## \K.+' "$file_path" 2>/dev/null | head -20 || echo "")
-      if [ -n "$headings" ]; then
-        echo "[ADD PostToolUse] 🔄 模板已修改，请检查 ${schema_file} 是否需更新（§ sections）" >&2
-        echo "[ADD PostToolUse] 模板标题: $(echo "$headings" | tr '\n' ' ')" >&2
-      fi
-    fi
-  fi
-
-  # §2e: 审计提醒
-  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
-  exit 0
-fi
-
-# ═══════════════ §3: Bash matcher: 结果增强 ═══════════════
-if [ "$tool_name" = "Bash" ]; then
-  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
-  exit 0
-fi
-
-exit 0
-#!/bin/bash
-# post-tool-use.sh — Claude Code PostToolUse：格式化 + 文档守卫 + 审计提醒
-# 治理卡位 #5: 格式化 + ADD文档守卫 + 审计落库 + 结果增强
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-input=$(parse_input)
-tool_name=$(json_get "$input" "tool_name")
-[ -z "$tool_name" ] && tool_name=$(echo "$input" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-
-# ── Edit/Write matcher: 格式化 + ADD文档守卫 ──
-if [ "$tool_name" = "Edit" ] || [ "$tool_name" = "Write" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  [ -z "$file_path" ] && exit 0
-
-  # ADD 文档结构守卫：写入 plans/specs/reviews 后提示
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/(plans|specs|reviews)/'; then
-    echo "[ADD PostToolUse] ADD 文档已写入: ${file_path}。请确保章节完整、双向链接齐全、增量修订格式正确。" >&2
-  fi
-
-  # 审计提醒（所有文件写入）
-  echo "[ADD PostToolUse] 文件已写入: ${file_path}。请执行 record_dev_operation 落库审计（ADD-7）。" >&2
-  exit 0
-fi
-
-# ── Bash matcher: 结果增强 ──
-if [ "$tool_name" = "Bash" ]; then
-  echo "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。" >&2
-  exit 0
-fi
-
-exit 0

package/templates/core/hooks/pre-compact.sh

@@ -1,37 +0,0 @@
-#!/bin/bash
-# pre-compact.sh — 上下文压缩前 ADD 状态保存（Claude Code 适配）
-# 治理卡位 #9: ADD状态保存 + 恢复清单导出 + tpl标记清理
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-export PROJECT_DIR="$PWD"
-
-# ── ① 获取 ADD 状态并保存到标记文件 ──
-if type detect_active_add >/dev/null 2>&1; then
-  state=$(detect_active_add 2>/dev/null || true)
-  if [ -n "$state" ]; then
-    IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-
-    # 写入恢复标记文件（SessionStart 恢复时读取）
-    RECOVERY_FILE="/tmp/add_recovery_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
-    cat > "$RECOVERY_FILE" <<EOF
-plan=${plan}
-step=${step}
-rounds=${rounds}
-handoff=${handoff}
-add_route=${add_route}
-EOF
-
-    echo "[ADD PreCompact] ADD 状态已保存: Plan=${plan}, Step=${step}" >&2
-  fi
-fi
-
-# ── ② 清理 tpl-injected 标记（compact 后上下文丢失，下次需重注） ──
-TPL_FLAG="/tmp/add_tpl_$(echo "${PROJECT_DIR}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
-rm -f "$TPL_FLAG" 2>/dev/null || true
-
-exit 0

package/templates/core/hooks/pre-tool-use.sh

@@ -1,223 +0,0 @@
-#!/bin/bash
-# pre-tool-use.sh — PreToolUse §A§B（阻断模式，通用适配版）
-# §A: Bash 裸写保护 — 拦截所有绕过 IDE 追踪的文件写操作
-# §B: Write/Edit 写入前置守卫 — Plan/Spec/Review 需要活跃 ADD Plan + 敏感文件保护
-# 治理卡位 #4: 危险命令拦截 / 模板路径兜底 / 写入前置守卫 / 敏感文件保护
-set -euo pipefail
-
-input=$(cat)
-
-# 探测 MAGIC_DIR 和 PROJECT_DIR（兼容多种 adapter）
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-PARENT="$(dirname "$HOOK_DIR")"
-MAGIC_DIR="$(basename "$PARENT")"
-PROJECT_DIR="$PWD"
-
-# ── Hook 通知: 拦截事件写入 jsonl（旁路，失败不阻断 exit 2）──
-source "${HOOK_DIR}/lib/notify.sh" 2>/dev/null || true
-ACTIVE_PLAN=$(detect_active_add 2>/dev/null || true)
-if [ -n "$ACTIVE_PLAN" ]; then
-  PLAN_KEYWORD="${ACTIVE_PLAN%%::*}"
-  PLAN_STATUS="active"
-else
-  PLAN_KEYWORD="no-active-plan"
-  PLAN_STATUS="none"
-fi
-
-# ── §A 辅助函数: 阻断日志 ──
-_log_block() {
-  local rule="$1" cmd="$2"
-  mkdir -p "$PROJECT_DIR/$MAGIC_DIR/debug-dump"
-  cat >> "$PROJECT_DIR/$MAGIC_DIR/debug-dump/stdin.log" <<BLOCKLOG
-=== $(date) [BLOCKED by §A: ${rule}] ===
-command: ${cmd:0:300}
-=== DONE ===
-BLOCKLOG
-}
-
-# ═══════════════ §A: Bash 工具写入保护 ═══════════════
-# 任何通过 Bash 修改文件内容的操作都会绕过 IDE 工具层（Write/SearchReplace），
-# 导致 Plan 关联检查、doc-format-guard、审计追踪全部失效。
-# 因此全局阻断所有可写文件的 Bash 命令，强制走 IDE 工具通道。
-command=$(echo "$input" | jq -r '.tool_input.command // empty')
-if [ -n "$command" ]; then
-
-  # 检测 1: 脚本解释器 — 可写任意文件，无法解析脚本内容做细粒度拦截
-  if echo "$command" | grep -qE '(^|;|\|\||&&|\|)\s*(python3?|node|ruby|perl|php)(\s|$)'; then
-    _reason="禁止通过脚本解释器直接修改文件。请使用 Write 或 SearchReplace 工具操作文件。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过脚本解释器直接修改文件。
-
-  python/node/ruby/perl/php 可在脚本中写入任意文件，绕过:
-    · Plan 关联检查（哪个文件属于哪个 ADD Plan？）
-    · doc-format-guard（章节/占位符/禁止词校验）
-    · 审计追踪（agentAudit 无法感知 Bash 内部的文件变更）
-
-  → 请改用 Write 或 SearchReplace 工具操作文件。
-  → 如需运行构建/测试脚本，使用 npx/pnpm/npm 命令。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "脚本解释器" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过脚本解释器直接修改文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
-
-  # 检测 2: sed -i 原地编辑（精确判定：`-i` 必须是 sed 独立 option；不把路径子串如 session-init 误判）
-  # 协议层契约（Review P0 #3/命令分类）: 与 codex 已实现版本同契约语义
-  if echo "$command" | grep -qE '(^|[;&|][[:space:]]*)sed[[:space:]]+([^;&|]*[[:space:]])?(-[[:alpha:]]*i[^[:space:];&|]*|--in-place(=[^[:space:];&|]*)?)([[:space:];&|]|$)'; then
-    _reason="禁止通过 sed -i 直接编辑文件。请使用 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 sed -i 原地编辑文件。
-
-  sed -i 直接写入文件，绕过 IDE 工具层的所有校验。
-  → 请改用 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "sed -i" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 sed -i 原地编辑" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
-
-  # 检测 3: 输出重定向 (>/>>) 写入文件
-  if echo "$command" | grep -qE '[>]{1,2}\s+\S'; then
-    _reason="禁止通过重定向写入文件。请使用 Write 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过重定向(>/>>)写入文件。
-
-  重定向写入绕过 IDE 工具层，变更无法追踪。
-  → 请改用 Write 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "重定向" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过重定向写入文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
-
-  # 检测 4: tee / dd 写入
-  if echo "$command" | grep -qE '\btee\b|\bdd\b.*of='; then
-    _reason="禁止通过 tee/dd 写入文件。请使用 Write 或 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 tee/dd 写入文件。
-
-  → 请改用 Write 或 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "tee/dd" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 tee/dd 写入文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
-
-  # 检测 5: cp / mv / touch — 可创建或覆盖文件
-  if echo "$command" | grep -qE '(^|;|\|\||&&|\|)\s*(cp|mv|touch)\b'; then
-    _reason="禁止通过 cp/mv/touch 操作文件。请使用 Write 或 SearchReplace 工具。"
-    cat >&2 <<'EOF'
-⛔ [ADD PreToolUse §A] 阻断: 禁止通过 cp/mv/touch 操作文件。
-
-  → 请改用 Write 或 SearchReplace 工具。
-EOF
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"${_reason}\"}}"
-    _log_block "cp/mv/touch" "$command"
-    write_hook_event "pre-tool-use" "deny" "$command" "禁止通过 cp/mv/touch 操作文件" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-    exit 2
-  fi
-
-  # 放行: 构建工具(npx/pnpm/npm/yarn)、版本控制(git)、
-  #        只读操作(ls/cat/grep/find/head/tail/wc)、目录操作(mkdir/rmdir) 等
-  exit 0
-fi
-
-# ═══════════════ §B: Write/Edit 文件写入前置守卫 ═══════════════
-# 非 Bash 工具（Write/Edit）的文件写入需要经过:
-#   1. Plan/Spec/Review 文档写入 → 需要活跃 ADD Plan
-#   2. 敏感文件保护 → 阻断写入
-#   3. Dev Action 标记 → 用于 Stop 检查
-# 注意: 不再对 src/**/*.ts 做 Plan 白名单放行，避免绕过 skill/rules 规定的 HITL。
-tool_name=$(echo "$input" | jq -r '.tool_name // empty')
-if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ] || [ "$tool_name" = "SearchReplace" ]; then
-  file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
-  [ -z "$file_path" ] && exit 0
-
-  # §B: 写入守卫按当前 magicDir 限域（Review P1 #5: 禁止多端路径正则）
-  if echo "$file_path" | grep -qE "${MAGIC_DIR}/(plans|specs|reviews)/"; then
-    if type detect_active_add >/dev/null 2>&1; then
-      state=$(detect_active_add 2>/dev/null || true)
-      if [ -z "$state" ]; then
-        echo "[ADD 提示] 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——首次创建场景放行，建议先执行 add-paradigm 生成 Plan+add-route" >&2
-        echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"permissionDecisionReason\":\"无活跃 ADD Plan 但为 Plan/Spec/Review 写入（首次创建场景），提示而非拦截\"}}"
-        write_hook_event "pre-tool-use" "info" "$tool_name $file_path" "无活跃 ADD Plan 下写入 Plan/Spec/Review（首次创建放行）" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-        exit 0
-      fi
-    fi
-  fi
-
-  if echo "$file_path" | grep -qE '\.env$|\.env\.production$|\.env\.local$|credentials|secrets'; then
-    echo "⛔ 敏感文件受保护，禁止写入: $file_path" >&2
-    echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"敏感文件受保护\"}}"
-    exit 2
-  fi
-
-  # §C: 模板类型前置注入 — 仅当前 magicDir plans/ 写入前提示应选模板
-  if echo "$file_path" | grep -qE "${MAGIC_DIR}/(plans)/"; then
-    fname=$(basename "$file_path")
-    if echo "$fname" | grep -qE 'plan-v[0-9]'; then
-      echo "💡 [ADD PreToolUse] 写入 Plan → 模板: standard-plan-template.md（标准）或 simple-plan-template.md（≤3文件）" >&2
-    elif echo "$fname" | grep -qE 'add-route'; then
-      echo "💡 [ADD PreToolUse] 写入 ADD Route → 模板: add-route-template.md" >&2
-    elif echo "$fname" | grep -qE 'handoff'; then
-      echo "💡 [ADD PreToolUse] 写入 Handoff → 模板: handoff-single-round-template.md（单轮）或 handoff-multi-round-template.md（多轮）" >&2
-    fi
-    # Write 大文件适配 — 已存在大文件建议用 SearchReplace 分块
-    if echo "$tool_name" | grep -qE 'Write' && [ -f "$file_path" ]; then
-      fsize=$(wc -c < "$file_path" 2>/dev/null || echo "0")
-      if [ "$fsize" -gt 2000 ] 2>/dev/null; then
-        echo "⚠️ [ADD PreToolUse] 文件已有 ${fsize} 字节，Write 全量覆盖可能触发工具 payload 限制。建议用 SearchReplace 分块追加。" >&2
-      fi
-    fi
-  fi
-
-  # §C: HITL tongyi 检查 — plans/ + PLAN_REVIEW reviews/ 写入前必须有 .hitl-tongyi-{planName} 哨兵
-  # implementation/runtime review 不需要 HITL，走 §B 活跃 Plan 检查
-  # handoff 是 Step 8 收敛产物（多轮交接手册），不经 HITL 审批，同样豁免
-  # TODO 应该caijuehub管理
-  if echo "$file_path" | grep -qE "${MAGIC_DIR}/(plans)/"; then
-    if echo "$file_path" | grep -qE '\-handoff'; then
-      _do_hitl=false  # handoff 不被 HITL 拦截（Step 8 产物，无独立审批）
-    else
-      _do_hitl=true
-    fi
-  elif echo "$file_path" | grep -qE "${MAGIC_DIR}/(reviews)/"; then
-    if echo "$file_path" | grep -qE '-(implementation|runtime)'; then
-      _do_hitl=false  # implementation/runtime review 不被 HITL 拦截
-    else
-      _do_hitl=true   # PLAN_REVIEW 需要 HITL
-    fi
-  else
-    _do_hitl=false
-  fi
-
-  if [ "$_do_hitl" = true ]; then
-    _relative=$(echo "$file_path" | sed "s|.*/\.\(qoder\|claude\|add\|vscode\|trae\)/\(plans\|reviews\)/||")
-    # 限域: 仅当前 magicDir 下的 plans/reviews 触发 HITL 门禁
-    if ! echo "$file_path" | grep -qE "${MAGIC_DIR}/(plans|reviews)/"; then
-      _do_hitl=false
-    fi
-    _planName=$(basename "$_relative" .md | sed 's/\.hitl$//;s/-plan-v[0-9]*$//;s/-add-route-v[0-9]*$//;s/-review-v[0-9]*$//;s/-review-implementation$//;s/-review-runtime$//')
-    if [ -n "$_planName" ]; then
-      _tongyi_marker="${PROJECT_DIR}/${MAGIC_DIR}/hitl/.tongyi-${_planName}"
-      if [ ! -f "$_tongyi_marker" ]; then
-        echo "⛔ [ADD PreToolUse §C] HITL 未 tongyi: $file_path" >&2
-        echo "   原因: 哨兵文件 $_tongyi_marker 不存在" >&2
-        echo "   操作: 请先调用 create_hitl 创建审批，再 update_hitl({ status: \"TONGYI\" })" >&2
-        _reason="HITL 未 tongyi: 哨兵 ${_tongyi_marker} 不存在。请先 create_hitl → 人工 tongyi → update_hitl 后再写入"
-        echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"${_reason}\",\"additionalContext\":\"${_reason}\"}}"
-        write_hook_event "pre-tool-use" "deny" "$tool_name $file_path" "HITL 未 tongyi: $_tongyi_marker" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-        exit 0
-      fi
-    fi
-  fi
-
-  mark_dev_action 2>/dev/null || true
-  exit 0
-fi
-
-exit 0

package/templates/core/hooks/prompt-submit.sh

@@ -1,87 +0,0 @@
-#!/bin/bash
-# prompt-submit.sh — UserPromptSubmit 触发词智能路由（通用适配版）
-# 治理卡位 #3: Layer 1 精准触发 → Layer 2 阻断 → Layer 3 状态注入
-set -euo pipefail
-
-input=$(cat)
-prompt=$(echo "$input" | jq -r '.prompt // empty')
-[ -z "$prompt" ] && exit 0
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$HOOK_DIR/lib/vocabulary.sh" 2>/dev/null || true
-source "$HOOK_DIR/lib/state-detect.sh" 2>/dev/null || true
-source "$HOOK_DIR/lib/notify.sh" 2>/dev/null || true
-
-# ─── Layer 1: 精准 P0 触发词 ───
-matched=$(match_trigger "$prompt" 2>/dev/null || true)
-if [ -n "$matched" ]; then
-  # 验收幂等保护: 如果已验收，提示不重复
-  if echo "$prompt" | grep -qiE '验收|收敛' 2>/dev/null; then
-    add_state=$(detect_active_add 2>/dev/null || true)
-    if [ -n "$add_state" ]; then
-      _handoff=$(echo "$add_state" | awk -F'::' '{print $4}')
-      _add_route=$(echo "$add_state" | awk -F'::' '{print $5}')
-      if is_already_accepted "$_add_route" "$_handoff" 2>/dev/null; then
-        cat <<EOF
-[ADD 验收] ⚠️ 已验收。进入 Review 模式:
-  ① 重新检查 checklist [T]/[R] 项
-  ② 审查 audit 记录完整性
-  ③ 如有差异 → Review 回流至 handoff（增量更新，不覆盖已有结论）
-  ④ 无差异 → 记录 'Review 已确认，无新发现'
-  ★ 同步检查: 如 checklist 有新 cuid 但 handoff 审计表缺失 → 更新 handoff ADD-7 表 + query_audit_logs 命令
-EOF
-        HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-        "$HOOK_DIR/review-checklist.sh" "$_handoff" "$_add_route" 2>/dev/null || true
-        exit 0
-      fi
-    fi
-  fi
-  echo "$matched"
-  exit 0
-fi
-
-# ─── 开发关键词检测（动态加载） ───
-dev_kw=$(load_dev_keywords 2>/dev/null || true)
-if [ -z "$dev_kw" ]; then
-  exit 0
-fi
-
-if ! echo "$prompt" | grep -qiE "$dev_kw"; then
-  exit 0
-fi
-
-# ─── Layer 2/3: 按活跃 ADD 分流 ───
-state=$(detect_active_add 2>/dev/null || true)
-if [ -z "$state" ]; then
-  # Layer 2: 无活跃 ADD → 提示启动（不阻断）
-  cat >&2 <<'EOF'
-[ADD 提示] 检测到开发任务，但无活跃 ADD Plan。建议先执行 add-paradigm SKILL:
-  Step 0: 文档先行 (Plan → Review → Specs)
-  Step 3: 代码实现 + 审计植入
-  Step 8: 收敛判断
-EOF
-  write_hook_event "prompt-submit" "info" "$prompt" "无活跃 ADD Plan 下检测到开发任务" "no-active-plan" "none" 2>/dev/null || true
-  exit 0
-fi
-
-# Layer 3: 有活跃 ADD → 注入状态
-plan=$(echo "$state" | awk -F'::' '{print $1}')
-step=$(echo "$state" | awk -F'::' '{print $2}')
-rounds=$(echo "$state" | awk -F'::' '{print $3}')
-handoff=$(echo "$state" | awk -F'::' '{print $4}')
-echo "[ADD 状态] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}, handoff: ${handoff}"
-
-# ─── Hook 治理日报（注入 AI 上下文）───
-HOOK_JSONL="${MAGIC_DIR:-.qoder}/reports/hook-events.jsonl"
-if [ -f "$HOOK_JSONL" ]; then
-  TODAY="$(date +%Y-%m-%d)"
-  TOTAL=$(grep -c "\"ts\":\"${TODAY}" "$HOOK_JSONL" 2>/dev/null || echo 0)
-  NO_PLAN=$(grep "\"ts\":\"${TODAY}" "$HOOK_JSONL" 2>/dev/null | grep -c '"planKeyword":"no-active-plan"' || echo 0)
-  if [ "$TOTAL" -gt 0 ] 2>/dev/null; then
-    echo "[Hook 治理] 今日提示: ${TOTAL} 次 | 无 Plan 提示: ${NO_PLAN} 次"
-    if [ "$NO_PLAN" -ge 10 ] 2>/dev/null; then
-      echo "[Hook ⚠️] 无 Plan 提示已达 ${NO_PLAN} 次（≥10），建议创建 Plan 或检查 hooks 误报"
-    fi
-  fi
-fi
-exit 0

package/templates/core/hooks/review-checklist.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-# review-checklist.sh — Review 检查清单校验（Claude Code 适配）
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-SHARED_LIB="$HOOK_DIR/../../shared/hooks-lib/common.sh"
-[ -f "$SHARED_LIB" ] && source "$SHARED_LIB"
-
-echo "[ADD ReviewChecklist] 请在提交前确认 checklist.md 全部项已勾选。"
-exit 0

package/templates/core/hooks/session-end.sh

@@ -1,38 +0,0 @@
-#!/bin/bash
-# SessionEnd — 通用版（核心模板，Trae 等适配器继承）
-# 治理卡位 #2: 标记清理 + 会话审计结算 + Stop未触发兜底
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-export PROJECT_DIR="$PWD"
-
-# ── ① 清理 tpl-injected 标记 ──
-project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
-rm -f "/tmp/add_tpl_${project_hash}" 2>/dev/null || true
-
-# ── ② 清理 dev action 标记 ──
-rm -f "/tmp/add_dev_${project_hash}" 2>/dev/null || true
-
-# ── ③ Stop 未触发兜底: 如果 dev action 标记还在，补执行 checklist 快照 ──
-if has_dev_action 2>/dev/null; then
-  echo "[ADD SessionEnd] ⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查" >&2
-
-  state=$(detect_active_add 2>/dev/null || true)
-  if [ -n "$state" ]; then
-    handoff=$(echo "$state" | awk -F'::' '{print $4}')
-    add_route=$(echo "$state" | awk -F'::' '{print $5}')
-    if [ -f "$handoff" ]; then
-      echo "[ADD SessionEnd] 补执行 checklist 快照（best-effort，不阻断）" >&2
-      if type check_add_completeness >/dev/null 2>&1; then
-        check_add_completeness "$handoff" "$add_route" >&2 2>/dev/null || true
-      fi
-    fi
-  fi
-fi
-
-# ── ④ 审计结算 ──
-echo "[ADD SessionEnd] 会话结束 — $(date -Iseconds)" >&2
-exit 0

package/templates/core/hooks/session-start.sh

@@ -1,53 +0,0 @@
-#!/bin/bash
-# SessionStart — ADD 上下文恢复 + 模板索引注入（Claude Code 适配）
-# 治理卡位 #1: ADD状态恢复 + 模板索引注入
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-
-# 加载四端通用函数（路径统一后: .claude/hooks/lib/common.sh）
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-# 设置项目目录
-export PROJECT_DIR="$PWD"
-
-# ── ① ADD 状态恢复 ──
-state=$(detect_active_add 2>/dev/null || true)
-if [ -n "$state" ]; then
-  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-  cat <<EOF
-[ADD SessionStart] 检测到活跃 ADD Plan:
-  Plan: ${plan}
-  轮次: ${rounds}
-  当前 Step: ${step}
-  handoff: ${handoff}
-  恢复命令: query_audit_logs({ planKeyword: '${plan}' })
-EOF
-fi
-
-# ── ② 模板索引注入 ──
-TPL_SCRIPT="$HOOK_DIR/lib/preload-templates.sh"
-if [ -f "$TPL_SCRIPT" ]; then
-  bash "$TPL_SCRIPT" --index
-fi
-
-# ── ③ §代办刷新：活跃 Plan 时提醒加载 IDE 代办 ──
-# session-init Step 2.6 依赖 IDE resume invoke SKILL，本段作为兜底
-if [ -n "$state" ]; then
-  IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-  cat <<EOF
-[代办] 检测到活跃 Plan: ${plan}。如有未加载的 IDE 代办清单，请从 tasks.md §IDE JSON 刷新 TodoWrite。
-EOF
-fi
-
-# ── ④ §HITL 待审批检测 ──
-if [ -d "$PLANS_DIR" ]; then
-  hitl_count=$(find "$PLANS_DIR" -name "*.hitl.md" -mtime -7 -type f 2>/dev/null | wc -l)
-  if [ "$hitl_count" -gt 0 ] 2>/dev/null; then
-    echo "[HITL 待审批] 检测到 ${hitl_count} 个待审批 HITL 提案，请检查并处理"
-  fi
-fi
-
-exit 0

package/templates/core/hooks/stop-check.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-# stop-check.sh — Claude Code Stop：四象限分流 + 验收检查（few-shot 上下文注入）
-# 治理卡位 #7: 验收检查 + devlog + 阻断
-# DB lifecycle 真相源（协议层）：DB 不可用时 fail-closed，禁止回退 Handoff/add-route 猜测
-set -euo pipefail
-
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
-export MAGIC_DIR=$(basename "$(dirname "$HOOK_DIR")")
-COMMON_LIB="$HOOK_DIR/lib/common.sh"
-[ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
-
-export PROJECT_DIR="$PWD"
-
-state=$(detect_active_add 2>/dev/null || true)
-has_dev=$(has_dev_action 2>/dev/null && echo "true" || echo "false")
-
-# ═══════ Q0: DB 不可用 → fail closed（禁止当“无 Plan”） ═══════
-if [ "${state%%::*}" = "__STATUS_UNAVAILABLE__" ]; then
-  reason=$(echo "$state" | awk -F'::' '{print $2}')
-  echo "[ADD Stop] ⛔ Plan status 暂不可用（${reason}）。未回退 Handoff/add-route 猜测，请恢复数据库或 MCP resolver 后重试。" >&2
-  exit "${EXIT_BLOCK:-2}"
-fi
-
-# ═══════ Q1: 无 ADD + 无 dev → 正常停 ═══════
-if [ -z "$state" ] && [ "$has_dev" != "true" ]; then
-  exit 0
-fi
-
-# ═══════ Q2: 无 ADD + 有 dev → 严重违规，few-shot 注入 ═══════
-if [ -z "$state" ] && [ "$has_dev" = "true" ]; then
-  build_stop_context "no_add_has_dev" >&2
-  exit $EXIT_BLOCK
-fi
-
-IFS='::' read -r plan step rounds handoff add_route <<< "$state"
-
-# ═══════ Q3: 有 ADD + 无 dev → 注入状态 ═══════
-if [ "$has_dev" != "true" ]; then
-  echo "[ADD Stop] Plan: ${plan}, 轮次: ${rounds}, Step: ${step}"
-  echo "本次无代码改动。下次继续时执行 session-init 恢复上下文。"
-  exit 0
-fi
-
-# ═══════ Q4: 有 ADD + 有 dev → 验收检查 ═══════
-issues=$(check_add_completeness "$handoff" "$add_route" 2>/dev/null || true)
-if [ -n "$issues" ]; then
-  build_stop_context "has_add_dev_unclosed" "$issues" >&2
-  exit $EXIT_BLOCK
-fi
-
-clear_dev_action 2>/dev/null || true
-echo "[ADD Stop] ✅ 验收通过——checklist 全部勾选，devlog 已记录。"
-exit 0