add-coder 0.3.26 → 0.3.28

package/templates/adapters/codex/hooks/doc-format-guard.sh

@@ -1,261 +0,0 @@
-#!/bin/bash
-# doc-format-guard.sh — schema.json 驱动的 ADD 文档格式守卫
-set -euo pipefail
-
-input=$(cat)
-
-# 动态探测 MAGIC_DIR（兼容多 adapter）
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-PARENT_DIR="$(dirname "$HOOK_DIR")"
-MAGIC_DIR=".codex"
-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
-
-# DEBUG: dump stdin for investigation
-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 "$MAGIC_DIR/(plans|specs)/"; then
-  exit 0
-fi
-
-CONTENT=$(echo "$input" | jq -r '
-  if .tool_input.file_content then .tool_input.file_content
-  elif .tool_input.content then .tool_input.content
-  elif .tool_input.new_string then .tool_input.new_string
-  elif .tool_input.new_string then .tool_input.new_string
-  elif .tool_input.replacements then .tool_input.replacements[0].new_text
-  else "" end')
-# L24: PostToolUse 不可阻断（仅反馈），PreToolUse exit 2 + ask 可拦截
-# L24: 文件在 .qoder/(plans|specs)/ 下但 Write 工具未传 content → 无法校验，阻断
-if [ -z "$CONTENT" ]; then
-  echo "⛔ 拒绝：Write 工具未传 file_content，无法校验手写文档格式" >&2
-  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"Write 工具未传 file_content，无法校验手写文档。请用 SearchReplace 改写已有文件，或用 Write 工具重试。"}}'
-  write_hook_event "doc-format-guard" "deny" "Write" "Write 工具未传 file_content" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-  exit 2
-fi
-
-PROJECT_DIR="$PWD"
-TEMPLATES_DIR="$PROJECT_DIR/$MAGIC_DIR/templates"
-
-# 通过 filename 匹配模板名
-TEMPLATE_NAME=""
-for tmpl in "$TEMPLATES_DIR"/*.md; do
-  base=$(basename "$tmpl")
-  if echo "$file_path" | grep -q "$base"; then
-    TEMPLATE_NAME="$base"
-    break
-  fi
-done
-
-# 退一步：根据文件内容特征猜测模板类型
-if [ -z "$TEMPLATE_NAME" ]; 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"
-    elif echo "$CONTENT" | grep -q "跨仓库格式契约"; then
-      TEMPLATE_NAME="review-implementation-template.md"
-    else
-      TEMPLATE_NAME="review-template.md"
-    fi
-  elif echo "$CONTENT" | grep -q "## Why"; then
-    TEMPLATE_NAME="spec-template.md"
-  elif echo "$CONTENT" | grep -q "## Preconditions"; then
-    TEMPLATE_NAME="tasks-template.md"
-  elif echo "$CONTENT" | grep -q "审计链（证据→devlog→checklist）"; then
-    TEMPLATE_NAME="checklist-template.md"
-  else
-    case "$file_path" in
-      *handoff*)
-        # ★ 按内容特征区分单/多轮 handoff，不依赖文件名
-        if echo "$CONTENT" | grep -qF "## 全局元信息"; then
-          TEMPLATE_NAME="handoff-multi-round-template.md"
-        elif echo "$CONTENT" | grep -qF "## 1. 交接前状态"; then
-          TEMPLATE_NAME="handoff-single-round-template.md"
-        else
-          echo "⛔ handoff 文件内容无法识别模板类型（缺 '## 全局元信息' 或 '## 1. 交接前状态'），拒绝写入" >&2
-          echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"handoff 内容不符合 single/multi 模板规范"}}'
-          write_hook_event "doc-format-guard" "deny" "$file_path" "handoff 模板类型无法识别" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-          exit 2
-        fi
-        ;;
-      *plan*)            TEMPLATE_NAME="standard-plan-template.md" ;;
-      *add-route*heavy*) TEMPLATE_NAME="add-route-template-heavyweight.md" ;;
-      *add-route*)       TEMPLATE_NAME="add-route-template.md" ;;
-      *tasks*)           TEMPLATE_NAME="tasks-template.md" ;;
-      *spec*)            TEMPLATE_NAME="spec-template.md" ;;
-      *checklist*)       TEMPLATE_NAME="checklist-template.md" ;;
-      *report*runtime*)  TEMPLATE_NAME="runtime-report-template.md" ;;
-      *report*)          TEMPLATE_NAME="report-template.md" ;;
-      *fix-verif*)       TEMPLATE_NAME="fix-verification-template.md" ;;
-      *hitl*)           TEMPLATE_NAME="hitl-template.md" ;;
-      *) 
-        # 增量修订识别：包含 ~~删除线~~ / → 新增标记 / [修订日期] 任意一个 → 视为增量更新，放行
-        if echo "$CONTENT" | grep -qE '~~.+~~|→|\[[0-9]{4}-[0-9]{2}-[0-9]{2}\s+修订'; then
-          echo "[doc-format-guard] 检测到增量修订格式，跳过完整章节校验" >&2
-          exit 0
-        fi
-        echo "⛔ 拒绝：无法识别文档类型 (file_path: $file_path)，缺少模板匹配规则" >&2
-        echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"无法识别 ADD 文档类型，请联系管理员更新 doc-format-guard.sh"}}'
-        write_hook_event "doc-format-guard" "deny" "$file_path" "无法识别文档类型" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-        exit 2
-        ;;
-    esac
-  fi
-fi
-
-SCHEMA_FILE="$TEMPLATES_DIR/${TEMPLATE_NAME%.md}.schema.json"
-# L84: schema 文件不存在 → 无校验规则，阻断（不允许无规则放行）
-if [ ! -f "$SCHEMA_FILE" ]; then
-  echo "⛔ 阻断：模板 ${TEMPLATE_NAME} 缺少对应的 .schema.json 校验规则" >&2
-  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"缺少 .schema.json 校验规则文件，禁止无规则放行"}}'
-  write_hook_event "doc-format-guard" "deny" "$file_path" "缺少 .schema.json 校验规则" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-  exit 2
-fi
-
-# SearchReplace 只传 patch（replacements[].new_text），不传全文件 → 跳过章节校验
-IS_SEARCH_REPLACE=$(echo "$input" | jq -r '(.tool_input.replacements | length > 0) or (.tool_input.new_string != null) // false')
-
-ISSUES=""
-
-# ── 章节校验 ──
-# 使用项目目录下的临时文件，避免 /tmp 在沙箱中不可写导致静默跳过
-TMPFILE="$PROJECT_DIR/$MAGIC_DIR/.doc-guard-issues.tmp"
-: > "$TMPFILE"
-trap "rm -f $TMPFILE" EXIT
-# SearchReplace 只传 patch → 跳过章节/子章节校验（无法从 patch 推断完整文档结构）
-if [ "$IS_SEARCH_REPLACE" != "true" ]; then
-  jq -r '.sections[] | select(.required == true) | .heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r heading; do
-    if ! echo "$CONTENT" | grep -qF "$heading"; then
-      echo "  缺章节: $heading"
-    fi
-  done > "$TMPFILE"
-
-  # 子章节
-  jq -r '.sections[].subsections[]?.heading' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r sub; do
-    if ! echo "$CONTENT" | grep -qF "$sub"; then
-      echo "  缺子章节: $sub"
-    fi
-  done >> "$TMPFILE"
-fi
-
-# ── 占位符校验 ──
-jq -r '.placeholders[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r ph; do
-  if echo "$CONTENT" | grep -qF "$ph"; then
-    echo "  未替换占位符: $ph"
-  fi
-done >> "$TMPFILE"
-
-# ── 禁止词校验 ──
-jq -r '.forbidden_terms[]?' "$SCHEMA_FILE" 2>/dev/null | while IFS= read -r term; do
-  if echo "$CONTENT" | grep -qw "$term"; then
-    echo "  禁止词: $term"
-  fi
-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 校验不通过:
-$ISSUES" >&2
-  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"ask\",\"permissionDecisionReason\":\"文档格式校验不通过，请对照模板修正\"}}"
-  write_hook_event "doc-format-guard" "deny" "$file_path" "文档格式校验不通过" "$PLAN_KEYWORD" "$PLAN_STATUS" 2>/dev/null || true
-  exit 2
-fi
-
-# ── 自动更新 index.md ──
-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
-fi
-
-exit 0

package/templates/adapters/codex/hooks/lib/common.sh

@@ -1,261 +0,0 @@
-#!/bin/bash
-###
- # @Author       : xiaomingming wujixmm@gmail.com
- # @Date         : 2026-07-17 13:14:46
- # @LastEditors  : xiaomingming wujixmm@gmail.com
- # @LastEditTime : 2026-07-17 13:21:36
- # @FilePath     : /add-coder/templates/core/hooks/lib/common.sh
- # @Description  : ADD Hook 共享库 — 四端通用函数
-### 
-# ADD Hook 共享库 — 四端通用函数
-# 被 Claude/Qoder/VS Code/Trae adapter 的 hook 脚本 source 引用
-# 路径: templates/core/hooks/lib/common.sh
-
-# 退出码常量,目前适配的ide都一样
-export EXIT_PASS=0   # 放行
-export EXIT_BLOCK=2  # 阻断
-
-# ── 输入解析 ──
-
-# 从 stdin 解析 JSON 输入（hook 事件通过 stdin 传入 JSON）
-parse_input() {
-  if [ -t 0 ]; then
-    echo "{}"
-  else
-    cat
-  fi
-}
-
-# 从 JSON 中提取字段值（简单实现，不依赖 jq）
-# 用法: json_get "$json" "field_name"
-json_get() {
-  echo "$1" | grep -o "\"$2\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/'
-}
-
-# ── ADD 活跃 Plan 检测（裁决定逻辑，SKILL §0.7.1） ──
-#
-# 活跃判定标准：
-#   1. magicDir 优先级: 由 Hook 脚本自身的路径推断（.claude/hooks/xxx.sh → .claude）→ .add → stderr 提示全局搜索
-#   2. 索引优先: 先读 plans/index.md 匹配 → 无匹配才 glob *-handoff*.md
-#   3. 活跃定义: add-route 中存在 [ ] 未勾选项 = 活跃；全部 [x] = 已收敛
-#   4. 多 Plan 冲突: 取 add-route 最近 mtime
-#   5. 无 add-route: Plan 初始态，视为活跃
-#
-# 前置条件: 调用方需设置 PROJECT_DIR 环境变量（项目根目录）
-# 返回: "plan_keyword::step_n/total::round_n/total::handoff_path::add_route_path" 或 ""
-
-detect_active_add() {
-  local plans_dir=""
-
-  # 1. magicDir 回退: 当前 IDE（CURRENT_MAGIC）→ 目录检测 → .add → 提示全局搜索
-  local magic_dirs=()
-  if [ -n "${CURRENT_MAGIC:-}" ]; then
-    magic_dirs+=("$CURRENT_MAGIC")
-  else
-    # 兜底: 检测 PROJECT_DIR 下哪个 magicDir 存在
-    for m in ".claude" ".qoder" ".vscode" ".trae"; do
-      [ -d "${PROJECT_DIR:-$PWD}/$m" ] && { magic_dirs+=("$m"); break; }
-    done
-  fi
-  magic_dirs+=(".add")
-
-  for magic in "${magic_dirs[@]}"; do
-    if [ -d "${PROJECT_DIR:-$PWD}/$magic/plans" ]; then
-      plans_dir="${PROJECT_DIR:-$PWD}/$magic/plans"
-      break
-    fi
-  done
-
-  if [ -z "$plans_dir" ]; then
-    echo "[ADD detect] 未在当前 IDE magicDir 和 .add 中找到 plans 目录。是否需要全局搜索所有 magicDir？" >&2
-    return 1
-  fi
-
-  local handoff=""
-  local add_route=""
-
-  # 2. 索引优先: 先读 index.md
-  if [ -f "$plans_dir/index.md" ]; then
-    # 从 index.md 表格提取最近一个 handoff 相对路径
-    # 表格格式: | YYYY-MM/DD/path-to-handoff.md | ...
-    handoff=$(grep -oE '[0-9]{4}-[0-9]{2}/[0-9]{2}/[^|]*handoff[^|]*\.md' "$plans_dir/index.md" 2>/dev/null | head -1 | xargs)
-    if [ -n "$handoff" ] && [ -f "$plans_dir/$handoff" ]; then
-      handoff="$plans_dir/$handoff"
-    else
-      handoff=""
-    fi
-  fi
-
-  # 3. 退路: glob handoff 文件（mtime 7 天内）
-  if [ -z "$handoff" ]; then
-    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)
-  fi
-  [ -z "$handoff" ] && return 1
-
-  # 提取 plan keyword
-  local plan_kw=$(basename "$handoff" | sed 's/-handoff.*//')
-
-  # 查找 add-route
-  local handoff_dir=$(dirname "$handoff")
-  add_route=$(find "$handoff_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
-  [ -z "$add_route" ] && add_route=$(find "$plans_dir" -name "*add-route*.md" -type f 2>/dev/null | head -1)
-
-  # 4. 活跃判定: 读 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}"
-    # 全部 [x] → 已收敛（但 handoff 还存在 → 可能是遗留，仍返回但标记）
-  else
-    # 无 add-route → Plan 初始态，视为活跃
-    step_info="init"
-  fi
-
-  # 5. 轮次统计（从 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 追踪 ──
-
-# dev action 标记文件（项目级，PreToolUse 写入，Stop 读取）
-DEV_FLAG="/tmp/add_dev_$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")"
-
-mark_dev_action() {
-  touch "$DEV_FLAG" 2>/dev/null || true
-}
-
-has_dev_action() {
-  [ -f "$DEV_FLAG" ]
-}
-
-clear_dev_action() {
-  rm -f "$DEV_FLAG" 2>/dev/null || true
-}
-
-# ── 验收完整度检查 ──
-
-# 检查 handoff + add-route 的验收完整度
-# 用法: check_add_completeness "$handoff_path" "$add_route_path"
-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"
-}
-
-# ── 验收幂等保护 ──
-
-# 检查是否已验收（幂等保护）
-# 用法: is_already_accepted "$add_route_path" "$handoff_path"
-# 返回 0 = 已验收，1 = 未验收
-is_already_accepted() {
-  local add_route="$1" handoff="$2"
-  # add-route Step 8 是否已 [x]
-  if [ -f "$add_route" ]; then
-    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
-}
-
-# ── Stop 四象限分流 few-shot 上下文（卡位 #7） ──
-# 用法: build_stop_context "$quadrant" "$info"
-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
-          生成 add-route → check_dps ≥ {{dpsPass}}
-  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_unclosed")
-      cat <<EOF
-[ADD Stop] ⚠️ 代码已完成但验收未闭环:
-${info}
-
-请依次执行（不要等下次会话）:
-  ① Write devlog → handoff 同目录 devlog-{plan}-v{n}.md
-     格式: # Devlog: {plan}\n 日期 / Plan / 轮次 / 本轮改了什么 / 验收结果 / 遗留项 / 架构回看
-  ② Edit handoff → 更新 §验证标准 全部 [x] + 补充审计 ID
-  ③ Read docs/ → 回看架构文档确认一致性
-  ④ Edit add-route → 勾选对应 Step [x]
-
-以上全部完成后 Agent 才能停止。
-EOF
-      ;;
-  esac
-}
-
-# ── PreToolUse 写入前置守卫上下文（卡位 #4） ──
-build_pretool_context() {
-  local plan="$1" round="$2"
-  cat <<EOF
-[ADD PreToolUse] 当前 Plan: ${plan}，轮次: ${round}。
-本次写入应属于 ADD Step 3 代码实现阶段。
-完成后执行 record_dev_operation 记录审计。
-EOF
-}

package/templates/adapters/codex/hooks/lib/context-inject.sh

@@ -1,96 +0,0 @@
-#!/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 ≥ {{dpsPass}}
-  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/adapters/codex/hooks/lib/notify.sh

@@ -1,34 +0,0 @@
-#!/bin/bash
-# notify.sh — Hook 拦截事件写入 jsonl（零外部依赖，bash 原生）
-# 用法: source 后在 exit 2 前调用 write_hook_event
-#
-# 写入格式（7 字段 jsonl）:
-#   {"ts":"ISO8601","hook":"...","decision":"deny","cmd":"...","reason":"...","planKeyword":"...","planStatus":"..."}
-#
-# 磁盘管理:
-#   - 单文件 ≤256KB，超限轮转为 .old（覆盖，不累积多份）
-#   - 总量 ≤512KB（当前 + 一个 .old）
-#   - MCP Server 宕机不丢事件，重启后从文件恢复消费
-
-write_hook_event() {
-  local hook="$1" decision="$2" cmd="$3" reason="$4" plan="${5:-unknown}" status="${6:-none}"
-  local dir="${MAGIC_DIR:-.qoder}/reports"
-  mkdir -p "$dir" 2>/dev/null || true
-  local file="$dir/hook-events.jsonl"
-
-  # 超过 256KB 自动轮转（262144 bytes）
-  if [ -f "$file" ]; then
-    local sz
-    sz=$(stat -c%s "$file" 2>/dev/null || echo 0)
-    [ "$sz" -gt 262144 ] && mv "$file" "${file}.old" 2>/dev/null || true
-  fi
-
-  printf '{"ts":"%s","hook":"%s","decision":"%s","cmd":"%s","reason":"%s","planKeyword":"%s","planStatus":"%s"}\n' \
-    "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-    "$hook" \
-    "$decision" \
-    "$cmd" \
-    "$reason" \
-    "$plan" \
-    "$status" >> "$file"
-}