add-coder 0.2.1 → 0.2.3

package/templates/core/hooks/doc-format-guard.sh

@@ -4,20 +4,31 @@ set -euo pipefail
 
 input=$(cat)
 
+# 动态探测 MAGIC_DIR（兼容多 adapter）
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+PARENT_DIR="$(dirname "$HOOK_DIR")"
+MAGIC_DIR="$(basename "$PARENT_DIR")"
+
 # DEBUG: dump stdin for investigation
-mkdir -p .qoder/debug-dump
-echo "=== $(date) ===" >> .qoder/debug-dump/stdin.log
-echo "file_path: $(echo "$input" | jq -r '.tool_input.file_path // "EMPTY"')" >> .qoder/debug-dump/stdin.log
-echo "has_file_content: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("file_content"))')" >> .qoder/debug-dump/stdin.log
-echo "has_replacements: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("replacements"))')" >> .qoder/debug-dump/stdin.log
-echo "top_keys: $(echo "$input" | jq -r 'keys | join(", ")')" >> .qoder/debug-dump/stdin.log
-echo "tool_input_keys: $(echo "$input" | jq -r '.tool_input | keys | join(", ") // "NO_TOOL_INPUT"')" >> .qoder/debug-dump/stdin.log
-echo "=== DONE ===" >> .qoder/debug-dump/stdin.log
+mkdir -p "$MAGIC_DIR/debug-dump"
+echo "=== $(date) ===" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "file_path: $(echo "$input" | jq -r '.tool_input.file_path // "EMPTY"')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "has_file_content: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("file_content"))')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "has_replacements: $(echo "$input" | jq 'has("tool_input") and (.tool_input | has("replacements"))')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+if echo "$input" | jq -e 'has("tool_input") and (.tool_input | has("file_content"))' > /dev/null 2>&1; then
+  echo "[file_content[500]]: $(echo "$input" | jq -r '.tool_input.file_content' | head -c 500)" >> "$MAGIC_DIR/debug-dump/stdin.log"
+fi
+if echo "$input" | jq -e 'has("tool_input") and (.tool_input | has("replacements"))' > /dev/null 2>&1; then
+  echo "[replacement_new_text[500]]: $(echo "$input" | jq -r '.tool_input.replacements[0].new_text' | head -c 500)" >> "$MAGIC_DIR/debug-dump/stdin.log"
+fi
+echo "top_keys: $(echo "$input" | jq -r 'keys | join(", ")')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "tool_input_keys: $(echo "$input" | jq -r '.tool_input | keys | join(", ") // "NO_TOOL_INPUT"')" >> "$MAGIC_DIR/debug-dump/stdin.log"
+echo "=== DONE ===" >> "$MAGIC_DIR/debug-dump/stdin.log"
 file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
 # L17: 非文件工具事件（空 stdin）→ 不拦截（由 matcher 层过滤）
 [ -z "$file_path" ] && exit 0
 
-if ! echo "$file_path" | grep -qE '\.qoder/(plans|specs)/'; then
+if ! echo "$file_path" | grep -qE '$MAGIC_DIR/(plans|specs)/'; then
   exit 0
 fi
 
@@ -34,8 +45,8 @@ if [ -z "$CONTENT" ]; then
   exit 2
 fi
 
-PROJECT_DIR="${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}"
-TEMPLATES_DIR="$PROJECT_DIR/.qoder/templates"
+PROJECT_DIR="$PWD"
+TEMPLATES_DIR="$PROJECT_DIR/$MAGIC_DIR/templates"
 
 # 通过 filename 匹配模板名
 TEMPLATE_NAME=""
@@ -49,10 +60,12 @@ done
 
 # 退一步：根据文件内容特征猜测模板类型
 if [ -z "$TEMPLATE_NAME" ]; then
-  if echo "$CONTENT" | grep -q "## 四、Handoff"; then
-    TEMPLATE_NAME="simple-standard-plan-template.md"
-  elif echo "$CONTENT" | grep -q "## PLAN 元信息"; then
+  if echo "$CONTENT" | grep -q "## PLAN 元信息"; then
     TEMPLATE_NAME="standard-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## 一、Plan 概述"; then
+    TEMPLATE_NAME="simple-plan-template.md"
+  elif echo "$CONTENT" | grep -q "## 四、Handoff"; then
+    TEMPLATE_NAME="simple-plan-template.md"
   elif echo "$CONTENT" | grep -q "## Review 元信息"; then
     if echo "$CONTENT" | grep -q "运行时验证"; then
       TEMPLATE_NAME="review-runtime-template.md"
@@ -104,7 +117,7 @@ if [ -z "$TEMPLATE_NAME" ]; then
   fi
 fi
 
-SCHEMA_FILE="$TEMPLATES_DIR/$(echo "${TEMPLATE_NAME%.md}" | sed 's/-template$//').schema.json"
+SCHEMA_FILE="$TEMPLATES_DIR/${TEMPLATE_NAME%.md}.schema.json"
 # L84: schema 文件不存在 → 无校验规则，阻断（不允许无规则放行）
 if [ ! -f "$SCHEMA_FILE" ]; then
   echo "⛔ 阻断：模板 ${TEMPLATE_NAME} 缺少对应的 .schema.json 校验规则" >&2
@@ -119,7 +132,7 @@ ISSUES=""
 
 # ── 章节校验 ──
 # 使用项目目录下的临时文件，避免 /tmp 在沙箱中不可写导致静默跳过
-TMPFILE="$PROJECT_DIR/.qoder/.doc-guard-issues.tmp"
+TMPFILE="$PROJECT_DIR/$MAGIC_DIR/.doc-guard-issues.tmp"
 : > "$TMPFILE"
 trap "rm -f $TMPFILE" EXIT
 # SearchReplace 只传 patch → 跳过章节/子章节校验（无法从 patch 推断完整文档结构）
@@ -154,6 +167,62 @@ done >> "$TMPFILE"
 
 ISSUES=$(cat "$TMPFILE" 2>/dev/null)
 
+# ── 算法化规则校验（ADD 范式约束下沉为代码）──
+ALGO_ISSUES=""
+
+# 规则1: 精简版 Plan 反作弊
+if echo "$TEMPLATE_NAME" | grep -q 'simple-plan'; then
+  # 1a. 文件数 ≤ 3
+  file_count=$(echo "$CONTENT" | grep -cP '^\|\s*`[^`]+`' 2>/dev/null || echo "0")
+  if [ "$file_count" -gt 3 ] 2>/dev/null; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 涉及 ${file_count} 个文件（超过 3 个限制），应改用 standard-plan-template.md\n"
+  fi
+  # 1b. HITL 表不能写 "等 N 个文件"
+  if echo "$CONTENT" | grep -qP '等\s*\d*\s*个文件|等\s*若干'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表文件清单使用模糊描述（'等 N 个文件'），必须列出实际完整路径\n"
+  fi
+  # 1c. HITL 方案/设计决策不能写 "等若干决策"
+  if echo "$CONTENT" | grep -qP '等\s*若干\s*(决策|方案|设计)'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: HITL 表方案/设计决策使用模糊描述（'等若干决策'），必须逐条列出\n"
+  fi
+  # 1d. 不能包含架构设计章节（精简版无架构设计）
+  if echo "$CONTENT" | grep -q '## 三、架构设计'; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版反作弊: 包含 '## 三、架构设计' 章节，精简版不应有架构设计——应改用 standard-plan-template.md\n"
+  fi
+fi
+
+# 规则2: HITL 表非空校验（所有 Plan + Review 模板）
+if echo "$TEMPLATE_NAME" | grep -qE 'plan|review'; then
+  if echo "$CONTENT" | grep -q '## HITL'; then
+    # HITL 表至少要有 1 行非占位符内容（不包含 { } 占位符）
+    hitl_rows=$(echo "$CONTENT" | sed -n '/## HITL/,/^## /p' | grep -cP '^\|\s*[^|{]*\s*\|' 2>/dev/null || echo "0")
+    # rows 包含表头行和分隔行，实际数据行 = rows - 2
+    hitl_data=$((hitl_rows - 2))
+    if [ "$hitl_data" -lt 1 ] 2>/dev/null; then
+      ALGO_ISSUES="${ALGO_ISSUES}  ⚠️  HITL 表为空——必须填写至少 1 行实际内容后再提交审核\n"
+    fi
+  fi
+fi
+
+# 规则3: 精简版 Plan 禁止同时存在独立 handoff 文件
+if echo "$TEMPLATE_NAME" | grep -q 'simple-plan'; then
+  plan_base=$(basename "$file_path" | sed 's/-plan-v.*//')
+  plan_dir=$(dirname "$file_path")
+  handoff_pattern="${plan_dir}/${plan_base}-handoff"
+  if find "$plan_dir" -name "${plan_base}-handoff*.md" 2>/dev/null | grep -q .; then
+    ALGO_ISSUES="${ALGO_ISSUES}  ❌ 精简版 Handoff 冲突: 检测到独立 handoff 文件（${plan_base}-handoff*.md）。精简版 Plan 的 Handoff 已融合在 §四，不应生成独立文件。请删除独立 handoff 文件或改用 standard-plan-template.md\n"
+  fi
+fi
+
+if [ -n "$ALGO_ISSUES" ]; then
+  echo "⛔ 算法化规则校验不通过:" >&2
+  echo -e "$ALGO_ISSUES" >&2
+  # 合并到 ISSUES 中一起阻断
+  echo -e "$ALGO_ISSUES" >> "$TMPFILE"
+fi
+
+ISSUES=$(cat "$TMPFILE" 2>/dev/null)
+
 # ── 阻断或放行 ──
 if [ -n "$ISSUES" ]; then
   echo "⛔ $TEMPLATE_NAME 校验不通过:
@@ -163,7 +232,7 @@ $ISSUES" >&2
 fi
 
 # ── 自动更新 index.md ──
-if echo "$file_path" | grep -q '\.qoder/plans/'; then
+if echo "$file_path" | grep -q '$MAGIC_DIR/plans/'; then
   if [ -x "$PROJECT_DIR/scripts/gen-plan-index.sh" ]; then
     "$PROJECT_DIR/scripts/gen-plan-index.sh" 2>/dev/null || true
   fi

package/templates/core/hooks/lib/context-inject.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# context-inject.sh — 上下文注入模板
+# 共享库
+
+# 结构化 SessionStart JSON 注入
+build_session_start_json() {
+  local plan="$1" step="$2" round="$3" handoff="$4"
+  cat <<EOF
+{
+  "continue": true,
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "上次 ADD 流程未完成:\n  Plan: ${plan}\n  轮次: ${round}\n  当前 Step: ${step} (add-route)\n  恢复命令: query_audit_logs({ planKeyword: '${plan}' })\n  handoff: ${handoff}"
+  }
+}
+EOF
+}
+
+# Stop 四象限分流 few-shot 上下文
+build_stop_context() {
+  local quadrant="$1" info="$2"
+  case "$quadrant" in
+    "no_add_no_dev")
+      echo "[ADD Stop] 无活跃 Plan，无代码改动。正常结束。"
+      ;;
+    "no_add_has_dev")
+      cat <<'EOF'
+[ADD Stop] ⚠️ 检测到代码修改但无活跃 ADD Plan。
+
+Plan 不是"文档开销"——它是代码治理的基础设斻。跳过 Plan 的后果:
+  · 没有 add-route → 每次改动无法追溯到具体 Task
+  · 没有 tasks.md → 后续 AI Session 不知道改了哪些文件
+  · 没有 handoff → 交接时上下文全丢，只能靠 git log 猜
+
+你必须立即补救，二选一:
+
+方案 A — 补 ADD 流程（招安）:
+  Step 0: 读 .qoder/templates/plan-template.md → 生成 Plan → .qoder/plans/{today}/{keyword}-plan-v1.md
+          生成 add-route → check_dps ≥ 85
+  Step 1: 扩展 AgentAuditPhase（如需要）
+  Step 2: 确认 agentAudit() 通道
+  Step 3: 将已写代码关联到 tasks.md
+  完成后可正常停止。
+
+方案 B — 补不上则回滚:
+  如果改动太复杂无法追溯生成 Plan，则:
+  ① git diff 确认改动范围
+  ② git checkout -- <改动的文件> 撤回
+  ③ 告知用户 "以下改动已回滚，请先走 ADD 流程再重新实施: <文件列表>"
+
+无论选 A 还是 B，完成后告诉用户下次执行 session-init 恢复上下文。
+EOF
+      ;;
+    "has_add_no_dev")
+      echo "[ADD Stop] ADD 流程进行中 (${info})，本次无代码改动。下次继续时执行 session-init 恢复上下文。"
+      ;;
+    "has_add_dev_step02")
+      echo "[ADD Stop] ADD Step 0-2: 文档先行/审计准备阶段。无需验收闭环。下一步: 进入 Step 3 代码实现。"
+      ;;
+    "has_add_dev_step3")
+      echo "[ADD Stop] ADD Step 3: 代码实现进行中 (${info})。完成后进入 Step 3.5 实现审查。"
+      ;;
+    "has_add_dev_unclosed")
+      cat <<'EOF'
+[ADD Stop] ⚠️ 代码已完成但验收未闭环:
+${info}
+
+请依次执行（不要等下次会话）:
+  ① Write devlog → handoff 同目录 devlog-{plan}-v{n}.md
+     格式: # Devlog: {plan}\n 日期 / Plan / 轮次 / 本轮改了什么 / 验收结果 / 遗留项 / 架构回看
+  ② Edit handoff → 更新 §验证标准 全部 [x] + 补充审计 ID
+     ★ 同步: checklist 有新 cuid → handoff ADD-7 表必须对应新增行
+     ★ Step 0 准入: handoff + add-route + Specs 三元组缺一不可，缺则回退 Step 0.5
+  ③ Read docs/ → 回看架构文档确认一致性
+  ④ Edit add-route → 勾选对应 Step [x]
+
+以上全部完成后 Agent 才能停止。
+
+下次恢复: 读 handoff → 查同目录 devlog-*.md → query_audit_logs
+EOF
+      ;;
+        "has_add_dev_closed")
+      echo "[ADD Stop] ✅ 验收闭环: add-route全部[x], devlog已记录, handoff已更新。验收幂等——重复触发不覆盖已有结论。"
+      ;;
+  esac
+}
+
+# 写操作前置守卫上下文
+build_pretool_context() {
+  local plan="$1" round="$2"
+  cat <<EOF
+[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
+本次写入应属于 ADD Step 3 代码实现阶段。
+完成后执行 record_dev_operation 记录审计。
+EOF
+}

package/templates/core/hooks/lib/state-detect.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+# state-detect.sh — ADD 活跃流程检测 + dev action 追踪
+# 共享库
+
+PROJECT_DIR="$PWD"
+
+# 动态探测 MAGIC_DIR（兼容多 adapter，source 自 hook 脚本时继承调用者的 HOOK_DIR）
+if [ -z "${MAGIC_DIR:-}" ]; then
+  if [ -n "${HOOK_DIR:-}" ]; then
+    MAGIC_DIR="$(basename "$(dirname "$HOOK_DIR")")"
+  else
+    for m in ".claude" ".qoder" ".vscode" ".add"; do
+      [ -d "$PROJECT_DIR/$m" ] && { MAGIC_DIR="$m"; break; }
+    done
+    MAGIC_DIR="${MAGIC_DIR:-.add}"
+  fi
+fi
+
+MAGIC_PATH="$PROJECT_DIR/$MAGIC_DIR"
+PLANS_DIR="$MAGIC_PATH/plans"
+
+# dev action 标记文件（项目级，PreToolUse 写入，Stop 读取）
+DEV_FLAG="/tmp/add_dev_$(echo "$PROJECT_DIR" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
+
+# 检测活跃 ADD 流程
+# 返回: "plan_keyword::step_x/total::round_n/total_r::handoff_path::add_route_path" 或 ""
+detect_active_add() {
+  local handoff=""
+  local today_dir="$PLANS_DIR/$(date +%Y-%m)"
+  [ -d "$today_dir" ] && handoff=$(find "$today_dir" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
+  [ -z "$handoff" ] && handoff=$(find "$PLANS_DIR" -name "*handoff*.md" -mtime -7 -type f 2>/dev/null | head -1)
+  [ -z "$handoff" ] && return 1
+
+  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
+
+  # add-route
+  local add_route=$(find "$PLANS_DIR" -name "*add-route*.md" -type f 2>/dev/null | head -1)
+
+  # Step 统计（从 add-route）
+  local step_info="?"
+  if [ -f "$add_route" ]; then
+    local ck=$(grep -c '\[x\]' "$add_route" 2>/dev/null || true)
+    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || true)
+    ck=${ck:-0}; uc=${uc:-0}
+    local total=$((ck + uc))
+    [ "$total" -gt 0 ] && step_info="${ck}/${total}"
+  fi
+
+  # 轮次统计（从 handoff）
+  local round_info="?"
+  if grep -q '<第[0-9]轮>' "$handoff" 2>/dev/null; then
+    local ck=$(grep -c '\[x\]' "$handoff" 2>/dev/null || true); ck=${ck:-0}
+    local total=$(grep -c '<第[0-9]轮>' "$handoff" 2>/dev/null || true); total=${total:-0}
+    [ "$total" -gt 0 ] && round_info="${ck}/${total}"
+  else
+    round_info="1/1"
+  fi
+
+  echo "${plan_kw}::${step_info}::${round_info}::${handoff}::${add_route:-none}"
+}
+
+# 标记 dev action
+mark_dev_action() {
+  touch "$DEV_FLAG" 2>/dev/null || true
+}
+
+# 检测 dev action
+has_dev_action() {
+  [ -f "$DEV_FLAG" ]
+}
+
+# 清理 dev action 标记（验收闭环后调用）
+clear_dev_action() {
+  rm -f "$DEV_FLAG" 2>/dev/null || true
+}
+
+# 检查验收完整度，返回 issues 文本
+check_add_completeness() {
+  local handoff="$1" add_route="$2"
+  local issues=""
+
+  # devlog（内容已回流至 handoff，检查 handoff 是否含验收结果）
+  if [ -f "$handoff" ] && ! grep -qE '验收|收敛|闭环|本轮改了什么|devlog' "$handoff" 2>/dev/null; then
+    issues="${issues}  [ ] devlog 缺失（handoff 无验收记录）\n"
+  fi
+
+  # handoff 验证标准
+  if [ -f "$handoff" ]; then
+    local uc=$(grep -c '\[ \]' "$handoff" 2>/dev/null || echo "0")
+    [ "$uc" -gt 0 ] && issues="${issues}  [ ] handoff ${uc} 项未勾选\n"
+  fi
+
+  # add-route Step
+  if [ -f "$add_route" ]; then
+    local uc=$(grep -c '\[ \]' "$add_route" 2>/dev/null || echo "0")
+    [ "$uc" -gt 0 ] && issues="${issues}  [ ] add-route ${uc} Step 未闭环\n"
+  fi
+
+  echo -e "$issues"
+}
+
+# 检查是否已验收（幂等保护）
+# 返回 0 = 未验收，1 = 已验收
+is_already_accepted() {
+  local add_route="$1" handoff="$2"
+  # add-route Step 8 是否已 [x]
+  if [ -f "$add_route" ]; then
+    # 检查 Step 8 产出项是否勾选
+    if grep -A 10 'Step 8' "$add_route" 2>/dev/null | grep -q '\[x\].*验证并更新项目状态'; then
+      # handoff 是否有验收记录
+      if [ -f "$handoff" ] && grep -qE '✅.*验收|收敛|全部闭环|全部.*完成' "$handoff" 2>/dev/null; then
+        return 0
+      fi
+    fi
+  fi
+  return 1
+}

package/templates/core/hooks/lib/vocabulary.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# vocabulary.sh — 从 vocabulary markdown 表格加载触发词
+# 单一数据源: .qoder/vocabulary/add-governance-vocabulary.md §类别 A-F 表格
+
+# 动态探测 MAGIC_DIR
+if [ -z "${MAGIC_DIR:-}" ]; then
+  for m in ".claude" ".qoder" ".vscode" ".add"; do
+    [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { MAGIC_DIR="$m"; break; }
+  done
+  MAGIC_DIR="${MAGIC_DIR:-.add}"
+fi
+VOCABULARY_FILE="${PROJECT_DIR:-$PWD}/$MAGIC_DIR/vocabulary/add-governance-vocabulary.md"
+
+# 输出格式: 优先级::触发词正则::响应文本（:: 避免与触发词内的 | 冲突）
+load_triggers() {
+  [ ! -f "$VOCABULARY_FILE" ] && return 1
+  sed -n '/^## 类别 A: 文档类型/,/^## 类别 [G-Z]/p' "$VOCABULARY_FILE" \
+    | grep -E '^\| (P0|P1|P2) ' \
+    | while IFS='|' read -r _ prio raw_trigger action; do
+        prio=$(echo "$prio" | xargs)
+        trigger=$(echo "$raw_trigger" | sed 's/`//g;s/ *\/ */|/g;s/^ *//;s/ *$//')
+        action=$(echo "$action" | xargs)
+        [ -z "$trigger" ] && continue
+        echo "${prio}::${trigger}::${action}"
+      done || true
+}
+
+match_trigger() {
+  local prompt="$1"
+  while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    local prio="${line%%::*}"
+    local rest="${line#*::}"
+    local regex="${rest%%::*}"
+    local action="${rest#*::}"
+    # 跳过开发关键词检测行（由 Layer 2/3 分流处理，特征：超长regex含"修bug"）
+    if echo "$regex" | grep -qE '修\.\?bug|fix\.\?bug' 2>/dev/null; then
+      continue
+    fi
+    if echo "$prompt" | grep -qiE "$regex" 2>/dev/null; then
+      echo "[ADD 触发] ${regex} → ${action}"
+    fi
+  done < <(load_triggers 2>/dev/null)
+}
+
+load_dev_keywords() {
+  load_triggers 2>/dev/null | while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    # 只取包含"开发|改功能"的开发关键词检测行
+    if echo "$line" | grep -q '开发|改功能' 2>/dev/null; then
+      local rest="${line#*::}"
+      local regex="${rest%%::*}"
+      echo "$regex"
+    fi
+  done || true
+}

package/templates/core/hooks/notification.sh

@@ -22,7 +22,14 @@ state=$(detect_active_add 2>/dev/null || true)
 
 IFS='::' read -r plan _ _ _ _ <<< "$state"
 
-reviews_dir="${PROJECT_DIR}/.qoder/reviews"
+# 动态探测
+if [ -z "${MAGIC_DIR:-}" ]; then
+  for m in ".claude" ".qoder" ".vscode" ".add"; do
+    [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { MAGIC_DIR="$m"; break; }
+  done
+  MAGIC_DIR="${MAGIC_DIR:-.add}"
+fi
+reviews_dir="${PROJECT_DIR}/$MAGIC_DIR/reviews"
 if ls "$reviews_dir"/*.md >/dev/null 2>&1; then
   echo "[ADD Notification] Plan: ${plan} — 请检查 Review 文档: ${reviews_dir}"
 fi

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

@@ -8,7 +8,7 @@ export CURRENT_MAGIC=$(basename "$(dirname "$HOOK_DIR")")
 COMMON_LIB="$HOOK_DIR/lib/common.sh"
 [ -f "$COMMON_LIB" ] && source "$COMMON_LIB"
 
-export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
+export PROJECT_DIR="$PWD"
 
 # ── ① 获取 ADD 状态并保存到标记文件 ──
 if type detect_active_add >/dev/null 2>&1; then

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

@@ -1,78 +1,131 @@
 #!/bin/bash
-# pre-tool-use.sh — Claude Code PreToolUse：四路守卫
+# pre-tool-use.sh — PreToolUse §A§B（阻断模式，通用适配版）
+# §A: Bash 裸写保护 — 拦截所有绕过 IDE 追踪的文件写操作
+# §B: 源码 Plan 关联检查 — 无 Plan 的 src/**/*.ts 编辑阻断
 # 治理卡位 #4: 危险命令拦截 / 模板路径兜底 / 写入前置守卫 / 敏感文件保护
 set -euo pipefail
 
+input=$(cat)
+
+# 探测 MAGIC_DIR 和 PROJECT_DIR（兼容多种 adapter）
 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"
-
-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 "")
-
-export PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
-
-# ── ① Bash matcher: 危险命令拦截 + 终端写文件拦截 ──
-if [ "$tool_name" = "Bash" ]; then
-  cmd=$(echo "$input" | grep -o '"command"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  # 危险命令
-  if echo "$cmd" | grep -qiE 'rm[[:space:]]+-rf[[:space:]]+/|DROP[[:space:]]+TABLE|git[[:space:]]+push[[:space:]]+--force|mkfs\.|dd[[:space:]]+if='; then
-    echo "⛔ 危险命令已被阻止: $cmd" >&2
-    exit $EXIT_BLOCK
-  fi
-  # 终端写文件拦截（含 > / >> / << heredoc / mv / touch / python -c > file）
-  if echo "$cmd" | grep -qE '(cat|echo|tee|sed[[:space:]]+-i|awk|printf|cp|mv|dd|touch)[[:space:]]*.*([>]{1,2}|[|][[:space:]]*tee|<<)'; then
-    echo "⛔ 禁止通过终端命令直接写文件: $cmd。请使用 Write/Edit/SearchReplace 工具。" >&2
-    exit $EXIT_BLOCK
+PARENT="$(dirname "$HOOK_DIR")"
+MAGIC_DIR="$(basename "$PARENT")"
+PROJECT_DIR="$PWD"
+
+# ── §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"
+    exit 2
   fi
-  # mv 无重定向但仍操作文件
-  if echo "$cmd" | grep -qE '^[[:space:]]*mv[[:space:]]+/tmp/'; then
-    echo "⛔ 禁止通过 mv /tmp/ 绕过 IDE 工具: $cmd" >&2
-    exit $EXIT_BLOCK
+
+  # 检测 2: sed -i 原地编辑
+  if echo "$command" | grep -qE '\bsed\b.*-i'; 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"
+    exit 2
   fi
-  # python/node 脚本写文件
-  if echo "$cmd" | grep -qE '(python3|python|node)[[:space:]].*[>]{1,2}'; then
-    echo "⛔ 禁止通过脚本语言直接写文件: $cmd。请使用 Write/Edit/SearchReplace 工具。" >&2
-    exit $EXIT_BLOCK
+
+  # 检测 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"
+    exit 2
   fi
-  mark_dev_action
-  exit 0
-fi
 
-# ── ② Write/Edit matcher: 文件写入前置守卫 ──
-if [ "$tool_name" = "Write" ] || [ "$tool_name" = "Edit" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  [ -z "$file_path" ] && exit 0
-
-  # 检查是否写入 plans/specs/reviews 目录但无活跃 ADD Plan
-  if echo "$file_path" | grep -qE '\.(qoder|claude|add)/plans/|\.(qoder|claude|add)/specs/|\.(qoder|claude|add)/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 PreToolUse] ⚠️ 正在写入 Plan/Spec/Review 文档但无活跃 ADD Plan——请先执行 add-paradigm" >&2
-      fi
-    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"
+    exit 2
   fi
 
-  # 敏感文件保护
-  if echo "$file_path" | grep -qE '\.env$|\.env\.production$|\.env\.local$|credentials|secrets'; then
-    echo "⛔ 敏感文件受保护，禁止写入: $file_path" >&2
-    exit $EXIT_BLOCK
+  # 检测 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"
+    exit 2
   fi
 
-  mark_dev_action
+  # 放行: 构建工具(npx/pnpm/npm/yarn)、版本控制(git)、
+  #        只读操作(ls/cat/grep/find/head/tail/wc)、目录操作(mkdir/rmdir) 等
   exit 0
 fi
 
-# ── ③ Read matcher: 模板路径兜底 ──
-if [ "$tool_name" = "Read" ]; then
-  file_path=$(echo "$input" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/' || echo "")
-  if echo "$file_path" | grep -q 'templates/'; then
-    echo "[ADD PreToolUse] 提示: 模板文件已通过 hook 预读到上下文，可跳过重复读取" >&2
-  fi
+# ═══════════════ §B: 源码 Plan 关联检查 ═══════════════
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+[ -z "$file_path" ] && exit 0
+
+if ! echo "$file_path" | grep -qE '(src/|/src/).*\.(ts|tsx)$'; then
+  exit 0
+fi
+
+MOD=$(basename "$file_path" | sed 's/\.[jt]sx\?$//')
+
+MATCHES=$(grep -rl "$MOD" "$PROJECT_DIR/$MAGIC_DIR/plans" "$PROJECT_DIR/$MAGIC_DIR/specs" "$PROJECT_DIR/$MAGIC_DIR/reports" 2>/dev/null | wc -l)
+
+if [ "$MATCHES" -gt 0 ]; then
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"permissionDecisionReason\":\"相关 ADD Plan 已存在\"}}"
   exit 0
 fi
 
-exit 0
+echo "⛔ 阻断: ${file_path} 无相关 ADD Plan。请先创建 Plan（plan-template / simple-plan-template）。" >&2
+echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"无相关 ADD Plan。请用 AskUserQuestion 询问用户选择 plan-template 或 simple-plan-template 创建 Plan。\"}}"
+exit 2