add-coder 0.3.27 → 0.3.29

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

@@ -1,223 +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） ──
-#
-# lifecycle 的唯一真相源是 scoped DB。短生命周期 Hook 不常驻 LISTEN；每次触发
-# 都通过当前 adapter 生成态的机器桥（plan-status-bridge）调用 shared resolver。
-# Handoff/add-route 不再参与 active 裁决，禁止跨 adapter 或文件系统 fallback
-# （含 .add 回退与 mtime/勾选数推断）。
-#
-# magicDir 解析（Review P1 #5）: 入口必须注入自身 magicDir；未注入时从生成态
-# 脚本物理位置（<magicDir>/hooks/...）反推；推导失败 → STATUS_UNAVAILABLE，
-# 禁止任何 adapter 名称默认值。
-#
-# Qoder stdout 规范: 本文件内所有 echo 均被调用方命令替换捕获（$(...)，不直接
-# 暴露给 IDE）；hook 入口脚本不得将非 JSON 输出到 stdout。
-#
-# 前置条件: 调用方需设置 PROJECT_DIR 环境变量（项目根目录）
-# 返回: "plan_keyword::step_n/total::round_n/total::handoff_path::add_route_path"
-#       或 "__STATUS_UNAVAILABLE__::reason::database::none::none"（调用方必须 fail-closed）
-
-query_plan_status() {
-  local bridge=""
-  if [ -n "${MAGIC_DIR:-}" ]; then
-    bridge="${PROJECT_DIR:-$PWD}/${MAGIC_DIR}/scripts/plan-status-bridge.ts"
-  elif [ -n "${HOOK_DIR:-}" ]; then
-    # 物理位置反推: <magicDir>/hooks/lib/common.sh → <magicDir>
-    bridge="${PROJECT_DIR:-$PWD}/$(basename "$(dirname "$(dirname "$HOOK_DIR")")")/scripts/plan-status-bridge.ts"
-  else
-    echo '{"availability":"STATUS_UNAVAILABLE","source":"database","reason":"magicDir 未注入且无法从物理位置推导"}'
-    return 3
-  fi
-  if [ ! -f "$bridge" ]; then
-    echo '{"availability":"STATUS_UNAVAILABLE","source":"database","reason":"plan-status bridge missing"}'
-    return 3
-  fi
-  node --import tsx "$bridge"
-}
-
-# 兼容既有 Hook 字段协议：
-# "planName::done/total::approvalStatus::none::none"；后两个路径不参与 active 判定。
-# DB 不可用/不可判定时返回特殊首字段，调用方必须 fail closed，不能当作“无 Plan”。
-detect_active_add() {
-  local snapshot="" rc=0
-  snapshot="$(query_plan_status 2>/dev/null)" || rc=$?
-  if [ "$rc" -ne 0 ]; then
-    local reason
-    reason=$(printf '%s' "$snapshot" | jq -r '.reason // "database status unavailable"' 2>/dev/null || echo "database status unavailable")
-    echo "__STATUS_UNAVAILABLE__::${reason}::database::none::none"
-    return 0
-  fi
-  if ! printf '%s' "$snapshot" | jq -e '.availability == "READY" and .isActive == true' >/dev/null 2>&1; then
-    return 1
-  fi
-  local plan done total approval
-  plan=$(printf '%s' "$snapshot" | jq -r '.planName')
-  done=$(printf '%s' "$snapshot" | jq -r '.progress.doneTasks // 0')
-  total=$(printf '%s' "$snapshot" | jq -r '.progress.totalTasks // 0')
-  approval=$(printf '%s' "$snapshot" | jq -r '.approvalStatus // "none"')
-  echo "${plan}::${done}/${total}::${approval}::none::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 确认改动范围
-  ② 仅对已确认属于本轮的文件生成反向 apply_patch
-  ③ 无法安全确认改动所有权时停止，并请求用户决定
-
-无论选 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/qoder/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 确认改动范围
-  ② 仅对已确认属于本轮的文件生成反向 apply_patch
-  ③ 无法安全确认改动所有权时停止，并请求用户决定
-
-无论选 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/qoder/hooks/lib/notify.sh

@@ -1,36 +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}" extra="${7:-}"
-  local dir="${MAGIC_DIR}/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
-
-  # extra 为可选 JSON 片段（Task 1.5 数据契约：anchor_hit/struct_score/override 等），非空时以逗号拼接
-  printf '{"ts":"%s","hook":"%s","decision":"%s","cmd":"%s","reason":"%s","planKeyword":"%s","planStatus":"%s"%s}\n' \
-    "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-    "$hook" \
-    "$decision" \
-    "$cmd" \
-    "$reason" \
-    "$plan" \
-    "$status" \
-    "${extra:+,$extra}" >> "$file"
-}

package/templates/adapters/qoder/hooks/lib/preload-templates.sh

@@ -1,212 +0,0 @@
-#!/bin/bash
-###
- # @Author       : xiaomingming wujixmm@gmail.com
- # @Date         : 2026-07-17 13:19:01
- # @LastEditors  : xiaomingming wujixmm@gmail.com
- # @LastEditTime : 2026-07-17 13:21:29
- # @FilePath     : /add-coder/templates/core/hooks/lib/preload-templates.sh
- # @Description  : ADD 模板预读脚本
-### 
-# preload-templates.sh — ADD 模板预读脚本
-# 路径: templates/core/hooks/lib/preload-templates.sh
-#
-# 用法:
-#   preload-templates.sh --index              # 输出模板清单（文件名 + 用途）
-#   preload-templates.sh --full               # 输出全部模板全文
-#   preload-templates.sh --full --top 5       # 输出前 5 个最常用模板全文
-#   preload-templates.sh --full --mark        # 全文输出 + 落 tpl-injected 标记
-#
-# 被 SessionStart（--index）和 UserPromptSubmit（--full）调用。
-# tpl-injected 标记文件用于去重——同会话二次命中时不重复注入。
-
-set -euo pipefail
-
-# 模板目录（分发期物化到各 adapter 本地：<magicDir>/templates；禁止回指源仓）
-# 协议层契约（模板预载）: 读 ${magicDir}/templates 本地物化副本；目录/标准模板缺失 fail-fast
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-TEMPLATES_DIR="${SCRIPT_DIR}/../../templates"
-
-# tpl-injected 标记文件路径（项目级，/tmp 下按项目 hash 区分）
-PROJECT_HASH=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
-TPL_FLAG="/tmp/add_tpl_${PROJECT_HASH}"
-
-# 模板清单（文件名:用途描述，按常用度排序）
-# 顺序即 --top N 的优先级
-declare -A TEMPLATES=(
-  ["simple-plan-template.md"]="需求方案（简单版）：六节结构，元信息+背景+方案+架构+实施+验收"
-  ["spec-template.md"]="功能规格：Why/What Changes/Impact/WHEN-THEN Requirements"
-  ["tasks-template.md"]="任务拆分：Phase→Task→SubTask层级"
-  ["checklist-template.md"]="验收清单：[T]编译期+[R]运行时+ADD规则合规"
-  ["review-template.md"]="方案审查（ADD-9）：问题复现+方案对比+决策结论+影响评估"
-  ["standard-plan-template.md"]="需求方案（标准版）：PLAN元信息+背景+方案+架构+实施Task+验收+关联文档"
-  ["add-route-template-heavyweight.md"]="ADD执行路线图（重型）：每Step验证并更新状态+spec_sync交叉校验"
-  ["add-route-template.md"]="ADD执行路线图（轻量）：标准Step产出检查"
-  ["handoff-single-round-template.md"]="单轮交接：9章节（含恢复上下文审计查询）"
-  ["handoff-multi-round-template.md"]="多轮交接：全局拓扑+每轮13子章节+收敛规则+启动模板"
-  ["review-implementation-template.md"]="实现审查（ADD-10）：格式契约+框架版本+数据模型+E2E curl"
-  ["review-runtime-template.md"]="运行时纠偏（ADD-11）：发现列表+根因分析+流程改进项"
-  ["prd-standard-template.md"]="产品需求文档（新建）：背景目标+用户场景+功能需求+验收标准"
-  ["prd-incremental-template.md"]="产品需求文档（增量）：变更摘要+diff式记录"
-  ["fix-verification-template.md"]="修复验证模板"
-  ["report-template.md"]="代码审查报告模板"
-  ["runtime-report-template.md"]="运行时报告模板"
-  ["TERMINOLOGY.md"]="模板术语速查"
-)
-
-# 按优先级排序的模板文件名列表
-PRIORITY_ORDER=(
-  "simple-plan-template.md"
-  "spec-template.md"
-  "tasks-template.md"
-  "checklist-template.md"
-  "review-template.md"
-  "standard-plan-template.md"
-  "add-route-template-heavyweight.md"
-  "add-route-template.md"
-  "handoff-single-round-template.md"
-  "handoff-multi-round-template.md"
-  "review-implementation-template.md"
-  "review-runtime-template.md"
-  "prd-standard-template.md"
-  "prd-incremental-template.md"
-  "fix-verification-template.md"
-  "report-template.md"
-  "runtime-report-template.md"
-  "TERMINOLOGY.md"
-)
-
-# 读取模板文件内容（strip frontmatter）
-read_template_content() {
-  local file="$1"
-  if [ -f "$file" ]; then
-    # 跳过 YAML frontmatter（--- 开头和 --- 结束之间的内容）
-    awk '
-      BEGIN { in_fm=0; started=0 }
-      NR==1 && /^---$/ { in_fm=1; next }
-      in_fm && /^---$/ { in_fm=0; next }
-      !in_fm { print }
-    ' "$file"
-  fi
-}
-
-# ── 模板目录存在性校验（fail-fast）──
-
-validate_templates_dir() {
-  if [ ! -d "$TEMPLATES_DIR" ]; then
-    echo "[ADD preload] 模板目录不存在: $TEMPLATES_DIR（生成态物化缺失，请执行 add-coder sync 后重试）" >&2
-    exit 1
-  fi
-
-  local available=0
-  local tmpl
-  for tmpl in "${PRIORITY_ORDER[@]}"; do
-    if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
-      available=$((available + 1))
-    fi
-  done
-  if [ "$available" -eq 0 ]; then
-    echo "[ADD preload] 模板目录中未找到 ADD 标准模板: $TEMPLATES_DIR（缺失清单: ${PRIORITY_ORDER[*]}）" >&2
-    exit 1
-  fi
-}
-
-# ── --index 模式：输出模板清单 ──
-
-output_index() {
-  echo "## ADD 可用模板清单"
-  echo ""
-  echo "| # | 模板文件 | 用途 |"
-  echo "|---|---------|------|"
-  local i=1
-  for tmpl in "${PRIORITY_ORDER[@]}"; do
-    if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
-      echo "| $i | $tmpl | ${TEMPLATES[$tmpl]:-模板文件} |"
-      ((i++))
-    fi
-  done
-}
-
-# ── --full 模式：输出模板全文 ──
-
-output_full() {
-  local top="${1:-0}"  # 0 = 全部
-
-  echo "## ADD 模板全文内容"
-  echo ""
-
-  local count=0
-  for tmpl in "${PRIORITY_ORDER[@]}"; do
-    if [ ! -f "$TEMPLATES_DIR/$tmpl" ]; then
-      continue
-    fi
-
-    count=$((count + 1))
-    if [ "$top" -gt 0 ] && [ "$count" -gt "$top" ]; then
-      break
-    fi
-
-    echo "---"
-    echo "### $tmpl"
-    echo ""
-    read_template_content "$TEMPLATES_DIR/$tmpl"
-    echo ""
-  done
-}
-
-# ── 标记文件管理 ──
-
-mark_injected() {
-  touch "$TPL_FLAG" 2>/dev/null || true
-}
-
-is_injected() {
-  [ -f "$TPL_FLAG" ]
-}
-
-clear_injected() {
-  rm -f "$TPL_FLAG" 2>/dev/null || true
-}
-
-# ── 主入口 ──
-
-main() {
-  local mode="index"
-  local top=0
-  local do_mark=false
-
-  while [ $# -gt 0 ]; do
-    case "$1" in
-      --index) mode="index"; shift ;;
-      --full)  mode="full"; shift ;;
-      --top)
-        top="${2:-0}"
-        shift 2
-        ;;
-      --mark) do_mark=true; shift ;;
-      *) shift ;;
-    esac
-  done
-
-  # 入口校验：目录缺失/标准模板缺失 → fail-fast（不再静默空输出）
-  validate_templates_dir
-
-  case "$mode" in
-    index)
-      output_index
-      ;;
-    full)
-      # 去重检查：如果已注入且没有主动要求重新注入，跳过
-      if is_injected && ! $do_mark; then
-        echo "[ADD preload] 模板已在本会话注入，跳过重复注入（tpl-injected 标记存在）" >&2
-        exit 0
-      fi
-
-      output_full "$top"
-
-      # 落标记文件
-      mark_injected
-      ;;
-  esac
-}
-
-main "$@"

package/templates/adapters/qoder/hooks/lib/session-end.sh

@@ -1,76 +0,0 @@
-#!/bin/bash
-###
- # @Author       : xiaomingming wujixmm@gmail.com
- # @Date         : 2026-07-17 13:20:43
- # @LastEditors  : xiaomingming wujixmm@gmail.com
- # @LastEditTime : 2026-07-17 13:34:19
- # @FilePath     : /add-coder/templates/core/hooks/lib/session-end.sh
- # @Description  : SessionEnd 治理卡位
-### 
-# session-end.sh — SessionEnd 治理卡位
-# 路径: templates/core/hooks/lib/session-end.sh
-#
-# 治理职能（卡位 #2）:
-#   ① 清理 tpl-injected 标记文件
-#   ② 会话审计结算（汇总 tool 调用统计）
-#   ③ Stop 未触发兜底: 若 Stop 未执行验收检查，补执行 checklist 快照（best-effort）
-#
-# 用法: 被各 IDE adapter 的 SessionEnd hook 脚本 source 并调用 main
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/common.sh" 2>/dev/null || true
-
-# 清理 tpl-injected 标记
-cleanup_tpl_flag() {
-  local 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 标记
-cleanup_dev_flag() {
-  local project_hash=$(echo "${PROJECT_DIR:-$PWD}" | md5sum 2>/dev/null | cut -c1-8 || echo "default")
-  rm -f "/tmp/add_dev_${project_hash}" 2>/dev/null || true
-}
-
-# Stop 未触发兜底: 如果 dev action 标记还在（说明 Stop 没执行验收检查）
-stop_fallback() {
-  if has_dev_action 2>/dev/null; then
-    echo "[ADD SessionEnd] ⚠️ 检测到 dev action 标记未清除——Stop 可能未触发验收检查" >&2
-
-    # 尝试找到 handoff 做 checklist 快照
-    local state=""
-    if type detect_active_add >/dev/null 2>&1; then
-      state=$(detect_active_add 2>/dev/null || true)
-    fi
-
-    if [ -n "$state" ]; then
-      local handoff=$(echo "$state" | awk -F'::' '{print $4}')
-      local 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
-}
-
-main() {
-  # ① 清理标记文件
-  cleanup_tpl_flag
-  cleanup_dev_flag
-
-  # ② 审计结算（输出到 stderr 供日志记录）
-  echo "[ADD SessionEnd] 会话结束 — $(date -Iseconds)" >&2
-
-  # ③ Stop 未触发兜底
-  stop_fallback
-
-  exit 0
-}
-
-# 被 source 时不自动执行，source 后调用 main
-if [ "${BASH_SOURCE[0]}" = "$0" ]; then
-  main "$@"
-fi

package/templates/adapters/qoder/hooks/lib/state-detect.sh

@@ -1,13 +0,0 @@
-#!/bin/bash
-# state-detect.sh — 兼容入口；状态裁决统一委托 common.sh，禁止维护第二套 magicDir 探测。
-# 协议层契约（Review P1 #5）: 仅当前 magicDir scope；禁止跨端扫描与 .add fallback；
-# 禁止 adapter 名称默认值（入口注入 MAGIC_DIR 或物理位置推导）。
-
-# 宿主注入链（Claude/Qoder 私有协议：项目根由 IDE 注入）
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${QODER_PROJECT_DIR:-${QODERCN_PROJECT_DIR:-$PWD}}}"
-
-if ! type detect_active_add >/dev/null 2>&1; then
-  HOOK_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  # shellcheck source=common.sh
-  source "$HOOK_LIB_DIR/common.sh"
-fi