@andyqiu/codeforge 0.5.29 → 0.6.1

package/install.sh

@@ -1,726 +0,0 @@
-#!/usr/bin/env bash
-# ============================================================================
-# CodeForge install.sh — 零侵入安装到 opencode (v0.1+ 单 bundle 架构)
-#
-# CodeForge 改为 OMO 风格的单 plugin bundle 架构：
-#   1. 17 个能力被 bun build 编译成 dist/index.js 一个 ESM bundle
-#   2. 在 opencode.json 里只占 1 行 plugin entry
-#   3. 永久避免 opencode 1.14+ 早期版本的 zod 跨实例 bug（issue #12336/#21155）
-#
-# 行为：
-#   1. 检测 opencode CLI / KH MCP
-#   2. 构建 dist/index.js（除非 --skip-build）
-#   3. 把 dist/index.js 复制到 ~/.config/opencode/codeforge/index.js
-#   4. 在 ~/.config/opencode/opencode.json 的 "plugin" 数组追加 file:// URL
-#   5. 把 agents/commands 用 file-by-file copy 注入（带白名单）
-#   6. 把 workflows/context-templates/review-profiles 整目录拷贝
-#   7. 智能合并 AGENTS.md：
-#      - 项目模式 + 已有 AGENTS.md → 替换 <!-- knowledge-hub:start -->...<!-- knowledge-hub:end --> 块（带 .bak 备份）
-#      - 项目模式 + 无 AGENTS.md  → 生成含 marker 块的短版骨架
-#      - 全局模式               → 跳过（context-templates 已经放进 ~/.config/opencode/context-templates/ 给所有项目复用）
-#   8. --global 时生成 ~/.config/codeforge/kh.json 模板（不含 token，硬约束 #2）
-#   9. 输出验证清单
-#
-# 用法：
-#   ./install.sh                # 项目级（默认）
-#   ./install.sh --global       # 全局
-#   ./install.sh --uninstall    # 卸载
-#   ./install.sh --dry-run      # 仅打印操作，不执行
-#   ./install.sh --skip-build   # 跳过 npm run build
-# ============================================================================
-
-set -euo pipefail
-
-# ────────────── 颜色 ──────────────
-if [[ -t 1 ]]; then
-  C_RESET='\033[0m'; C_BOLD='\033[1m'
-  C_RED='\033[31m'; C_GREEN='\033[32m'; C_YELLOW='\033[33m'; C_BLUE='\033[34m'; C_CYAN='\033[36m'
-else
-  C_RESET=''; C_BOLD=''; C_RED=''; C_GREEN=''; C_YELLOW=''; C_BLUE=''; C_CYAN=''
-fi
-
-log()    { printf '%b\n' "${C_CYAN}[codeforge]${C_RESET} $*"; }
-ok()     { printf '%b\n' "${C_GREEN}✓${C_RESET} $*"; }
-warn()   { printf '%b\n' "${C_YELLOW}⚠${C_RESET}  $*"; }
-err()    { printf '%b\n' "${C_RED}✗${C_RESET} $*" >&2; }
-hr()     { printf '%b\n' "${C_BOLD}────────────────────────────────────────────────${C_RESET}"; }
-
-# ────────────── ADR-0050: WSL 路径错位拒绝（先于参数解析，用原始 $* 检测 --uninstall） ──────────────
-# 防止在 WSL 中 $HOME 落在 /mnt/c|d|e/Users/ 导致 codeforge 配置写到
-# Windows 文件系统（NTFS 性能差、权限模型不同、git/symlink 行为异常）。
-#
-# 触发条件：
-#   - 系统真存在 wslpath 命令（WSL 环境标志），或
-#   - 测试旁路 CODEFORGE_FORCE_WSL_CHECK=1（CI/单测中强制走分支）
-#
-# 用户逃生口：
-#   - CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 → 强制继续（不推荐）
-#   - --uninstall 参数 → guard 整段跳过（用户可能就是要从错位位置清理掉，
-#     ADR-0050 / reviewer Phase 3 #3：卸载场景必须能跑通）
-#
-# 这里用 `$*` 原始参数串做模式匹配，**不依赖**下方 while 循环解析出的 ACTION
-# 变量，因为本段必须在参数解析之前执行（错位路径下连参数解析的 set -u 都可能
-# 因为环境异常而炸，guard 必须最早跑）。
-if [[ " $* " != *" --uninstall "* ]]; then
-  if command -v wslpath >/dev/null 2>&1 || [[ "${CODEFORGE_FORCE_WSL_CHECK:-}" == "1" ]]; then
-    case "$HOME" in
-      /mnt/c/*|/mnt/d/*|/mnt/e/*)
-        err "在 WSL 中检测到 \$HOME=$HOME 落在 Windows 挂载路径下"
-        err "这会导致 codeforge 配置写到 Windows 文件系统，引发权限 / 性能 / 路径转换问题"
-        err "请改用 WSL 原生 home（通常是 /home/<user>/），或在 /etc/wsl.conf 中显式设置 default=<linux-user>"
-        err "如确实需要继续，设置环境变量 CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 跳过检查（不推荐）"
-        err "如果你是想卸载之前装错位置的 codeforge，加 --uninstall 参数会跳过本检查"
-        if [[ "${CODEFORGE_ALLOW_WSL_WINDOWS_HOME:-}" != "1" ]]; then
-          exit 1
-        fi
-        warn "已通过 CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 跳过 WSL 路径检查（请确保你清楚后果）"
-        ;;
-    esac
-  fi
-fi
-
-# ────────────── 参数 ──────────────
-MODE="project"
-ACTION="install"
-DRY_RUN=0
-SKIP_BUILD=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --global)     MODE="global" ;;
-    --project)    MODE="project" ;;
-    --uninstall)  ACTION="uninstall" ;;
-    --dry-run)    DRY_RUN=1 ;;
-    --skip-build) SKIP_BUILD=1 ;;
-    -h|--help)
-      sed -n '3,30p' "$0"
-      exit 0
-      ;;
-    *) err "未知参数：$1"; exit 2 ;;
-  esac
-  shift
-done
-
-
-# ────────────── 路径解析 ──────────────
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-SOURCE_ROOT="$SCRIPT_DIR"
-
-if [[ "$MODE" == "global" ]]; then
-  TARGET_ROOT="${XDG_CONFIG_HOME:-$HOME/.config}/opencode"
-else
-  TARGET_ROOT="$(pwd)/.opencode"
-fi
-
-# CodeForge 自身的全局配置目录（与 opencode 配置目录同级）
-CODEFORGE_CFG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/codeforge"
-
-# v0.1 之前装的目录（卸载时一并清掉）
-LEGACY_DIRS=(agent command tool tools plugin plugins lib)
-# v0.1+ 才有的目录（review-profiles 由 ADR:reviewer-multi-profile 引入）
-# agent-templates 由 ADR:agent-templates-move-to-root 移到根目录（supersedes agent-templates-distribution）
-MANAGED_DIRS=(codeforge agents commands workflows context-templates review-profiles agent-templates)
-
-BUNDLE_SRC_REL="dist/index.js"
-BUNDLE_DST_REL="codeforge/index.js"
-
-# 文件级 copy 白名单（.md，排除 README/_*/.bak/.*）
-MD_COPY_DIRS=("agents:agents" "commands:commands")
-# 整目录拷贝（review-profiles 由 ADR:reviewer-multi-profile 引入，避开 maxdepth 1 限制）
-# ADR:agent-templates-move-to-root — agent-templates 随 install 分发到全局目录
-COPY_DIRS=("workflows:workflows" "context-templates:context-templates" "review-profiles:review-profiles" "agent-templates:agent-templates")
-
-# KH 行为规范模板（B3 智能合并的输入）
-KH_TEMPLATE_REL="context-templates/kh-instructions.md"
-
-# ────────────── 工具函数 ──────────────
-run() {
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} %s\n" "$*"
-  else
-    eval "$@"
-  fi
-}
-
-ensure_dir() {
-  if [[ ! -d "$1" ]]; then
-    run "mkdir -p '$1'"
-  fi
-}
-
-# 计算 plugin 入口的 file:// URL
-plugin_uri() {
-  local abs="$TARGET_ROOT/$BUNDLE_DST_REL"
-  echo "file://$abs"
-}
-
-opencode_cfg_path() {
-  echo "$TARGET_ROOT/opencode.json"
-}
-
-# 配置默认 agent → codeforge（ADR-0056 D5 / D2 实施细节）
-#
-# 在 ~/.config/opencode/opencode.json 顶层幂等合并 "default_agent": "codeforge"。
-# 行为规则：
-#   - 字段不存在 → 写入 codeforge
-#   - 字段已是 codeforge → unchanged
-#   - 字段为其他值（用户自配） → 跳过不动 + 打 warn（绝不覆盖用户配置）
-# 仅在 MODE=user/global 调用（项目级配置由用户自己管，不动）。
-# 失败不阻塞 install 主流程（warn + return 0）。
-# 用 node 处理 JSON（避免 sed/awk 处理 JSON 转义边界）。
-configure_default_agent() {
-  local opencode_json="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/opencode.json"
-  local target_agent="codeforge"
-
-  if [[ ! -f "$opencode_json" ]]; then
-    warn "opencode.json 不存在，跳过 default_agent 配置（首次安装 opencode 后请手动重跑 codeforge install）"
-    return 0
-  fi
-
-  if ! command -v node >/dev/null 2>&1; then
-    warn "未找到 node，跳过 default_agent 配置（请安装 Node.js >= 20 后重跑 install）"
-    return 0
-  fi
-
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} configure default_agent=%s in %s\n" "$target_agent" "$opencode_json"
-    return 0
-  fi
-
-  local result
-  result=$(CFG="$opencode_json" TARGET="$target_agent" node -e '
-    const fs = require("node:fs");
-    const path = process.env.CFG;
-    const target = process.env.TARGET;
-    let cfg;
-    try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
-    catch (e) { console.log("ERROR: " + e.message); process.exit(0); }
-    const current = cfg.default_agent;
-    if (current === undefined) {
-      cfg.default_agent = target;
-      fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
-      console.log("SET default_agent=" + target);
-    } else if (current === target) {
-      console.log("UNCHANGED (already " + target + ")");
-    } else {
-      console.log("SKIPPED: user has default_agent=\"" + current + "\", not touching");
-    }
-  ' 2>&1) || {
-    warn "default_agent 配置失败（不阻塞 install 主流程）"
-    return 0
-  }
-  ok "default_agent: $result"
-}
-
-# 卸载时还原 default_agent（仅当当前值是 codeforge 时移除字段）。
-# 用户改成其他值的不动。
-restore_default_agent() {
-  local opencode_json="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/opencode.json"
-  if [[ ! -f "$opencode_json" ]]; then
-    return 0
-  fi
-  if ! command -v node >/dev/null 2>&1; then
-    warn "未找到 node，跳过 default_agent 卸载还原"
-    return 0
-  fi
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} restore default_agent in %s (remove if codeforge)\n" "$opencode_json"
-    return 0
-  fi
-
-  local result
-  result=$(CFG="$opencode_json" node -e '
-    const fs = require("node:fs");
-    const path = process.env.CFG;
-    let cfg;
-    try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
-    catch { process.exit(0); }
-    if (cfg.default_agent === "codeforge") {
-      delete cfg.default_agent;
-      fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
-      console.log("REMOVED default_agent (was codeforge)");
-    } else if (cfg.default_agent !== undefined) {
-      console.log("SKIPPED: default_agent=\"" + cfg.default_agent + "\" not set by codeforge");
-    } else {
-      console.log("NOOP (no default_agent)");
-    }
-  ' 2>&1) || return 0
-  ok "default_agent: $result"
-}
-
-# 写 ~/.config/codeforge/kh.json 模板（仅 --global 调用）
-#
-# 硬约束 #2：API key 绝不能落盘，模板里**不写** token / apiKey 字段。
-# 用户必须通过环境变量 KNOWLEDGE_API_KEY 提供。
-# 已存在则跳过，避免覆盖用户自定义。
-write_kh_template() {
-  ensure_dir "$CODEFORGE_CFG_DIR"
-  local kh_file="$CODEFORGE_CFG_DIR/kh.json"
-  if [[ -f "$kh_file" ]]; then
-    ok "已存在 ${kh_file}，跳过覆盖"
-    return 0
-  fi
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} write %s (no token)\n" "$kh_file"
-    return 0
-  fi
-  cat > "$kh_file" <<'EOF'
-{
-  "url": "http://10.5.60.26:8900/mcp",
-  "timeoutMs": 5000,
-  "maxRetries": 1
-}
-EOF
-  ok "已生成 ${kh_file}（API key 请通过环境变量 KNOWLEDGE_API_KEY 提供，禁止写入文件）"
-}
-
-# 智能合并项目根 AGENTS.md：
-#   - 已有 AGENTS.md  → 替换 <!-- knowledge-hub:start -->...<!-- knowledge-hub:end --> 块（带 .bak 备份）
-#   - 不存在 AGENTS.md → 生成含 marker 块的短版骨架
-#
-# 实现委托给 scripts/merge-agents-md.mjs CLI（C.4 单一入口），
-# 算法源自 lib/agents-merge.ts，sh/ps1 共用同一份 Node 实现，
-# 避免 install 脚本各自维护算法副本造成漂移。
-merge_project_agents_md() {
-  local agents_target="$1"
-  local template_path="$2"
-  local cli_path="$SOURCE_ROOT/scripts/merge-agents-md.mjs"
-  if [[ ! -f "$template_path" ]]; then
-    warn "模板不存在，跳过 AGENTS.md 合并: $template_path"
-    return 0
-  fi
-  if [[ ! -f "$cli_path" ]]; then
-    warn "merge CLI 不存在，跳过 AGENTS.md 智能合并: $cli_path"
-    return 0
-  fi
-  if ! command -v node >/dev/null 2>&1; then
-    warn "未找到 node，跳过 AGENTS.md 智能合并（请安装 Node.js >= 20）"
-    return 0
-  fi
-  local cli_args=(--target "$agents_target" --template "$template_path")
-  if [[ $DRY_RUN -eq 1 ]]; then
-    cli_args+=(--dry-run)
-  fi
-  node "$cli_path" "${cli_args[@]}" || {
-    warn "AGENTS.md 合并失败（不阻塞 install 主流程）"
-    return 0
-  }
-}
-
-# 用 node 重写 opencode.json 的 plugin 数组（追加自己 + 去掉所有 codeforge legacy entry）
-write_plugin_entry() {
-  local cfg; cfg="$(opencode_cfg_path)"
-  local uri; uri="$(plugin_uri)"
-
-  if ! command -v node >/dev/null 2>&1; then
-    err "需要 node 才能改写 opencode.json，请安装 Node.js >= 20"
-    return 1
-  fi
-
-  ensure_dir "$TARGET_ROOT"
-
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} write %s plugin entry: %s\n" "$cfg" "$uri"
-    return 0
-  fi
-
-  CFG="$cfg" URI="$uri" node -e '
-    const fs = require("node:fs");
-    const path = process.env.CFG;
-    const uri = process.env.URI;
-    let cfg = {};
-    if (fs.existsSync(path)) {
-      try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
-      catch { fs.copyFileSync(path, path + ".bak." + Date.now()); cfg = {}; }
-    }
-    if (!cfg.$schema) cfg.$schema = "https://opencode.ai/config.json";
-    if (!Array.isArray(cfg.plugin)) cfg.plugin = [];
-    const cleaned = [];
-    for (const e of cfg.plugin) {
-      const s = String(e);
-      if (/\/codeforge\/index\.js$/.test(s)) continue;
-      if (/\/plugins\/[^/]+\.ts$/.test(s) && /opencode/.test(s)) continue;
-      if (/\/\.opencode\/plugins\//.test(s)) continue;
-      cleaned.push(e);
-    }
-    cleaned.push(uri);
-    cfg.plugin = cleaned;
-    fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
-  '
-  ok "opencode.json 已写入 plugin entry: $uri"
-}
-
-remove_plugin_entry() {
-  local cfg; cfg="$(opencode_cfg_path)"
-  if [[ ! -f "$cfg" ]]; then return 0; fi
-  if ! command -v node >/dev/null 2>&1; then
-    warn "未找到 node，跳过 opencode.json plugin entry 清理"
-    return 0
-  fi
-
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} rewrite %s without codeforge plugin entry\n" "$cfg"
-    return 0
-  fi
-
-  CFG="$cfg" node -e '
-    const fs = require("node:fs");
-    const path = process.env.CFG;
-    let cfg;
-    try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
-    catch { return; }
-    if (!Array.isArray(cfg.plugin)) return;
-    cfg.plugin = cfg.plugin.filter(e => {
-      const s = String(e);
-      if (/\/codeforge\/index\.js$/.test(s)) return false;
-      if (/\/plugins\/[^/]+\.ts$/.test(s)) return false;
-      if (/\/\.opencode\/plugins\//.test(s)) return false;
-      return true;
-    });
-    fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
-  '
-  ok "opencode.json 已移除 codeforge plugin entry"
-}
-
-# 卸载
-uninstall() {
-  log "卸载 CodeForge from: $TARGET_ROOT"
-  remove_plugin_entry
-  # 还原 default_agent（仅 user/global mode；project mode 不动用户级配置）
-  if [[ "$MODE" != "project" ]]; then
-    restore_default_agent
-  fi
-  for name in "${LEGACY_DIRS[@]}" "${MANAGED_DIRS[@]}"; do
-    local p="$TARGET_ROOT/$name"
-    if [[ -e "$p" || -L "$p" ]]; then
-      run "rm -rf '$p'"
-      ok "已删除 $p"
-    fi
-  done
-  hr
-  # 细粒度删除 skills：只删 CodeForge 自己的 skill，不删用户自装的（如 frontend-design）
-  OWNED_SKILLS=(ambiguity-gate devils-advocate ears-zh example-mapping success-criteria weighted-dimensions)
-  for skill_name in "${OWNED_SKILLS[@]}"; do
-    local p="$TARGET_ROOT/skills/$skill_name"
-    if [[ -e "$p" || -L "$p" ]]; then
-      run "rm -rf '$p'"
-      ok "已删除 skill: $p"
-    fi
-  done
-  ok "卸载完成（opencode 自身和你的 AGENTS.md / ~/.config/codeforge/kh.json 不会被动）"
-}
-
-# 检测
-detect_opencode() {
-  if command -v opencode >/dev/null 2>&1; then
-    local v; v="$(opencode --version 2>/dev/null || echo "unknown")"
-    ok "检测到 opencode: $v"
-  else
-    warn "未检测到 opencode CLI"
-    warn "  安装方式：https://github.com/sst/opencode#installation"
-  fi
-}
-
-detect_kh_mcp() {
-  local cfg="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/opencode.json"
-  if [[ -f "$cfg" ]] && grep -q "knowledge-hub\|code-forge-knowledge-hub" "$cfg" 2>/dev/null; then
-    ok "检测到 Knowledge Hub MCP 已注册"
-  else
-    warn "未在 $cfg 中找到 Knowledge Hub MCP"
-    warn "  配置示例见 docs/PRD.md §6.2"
-  fi
-}
-
-# ────────────── 主流程 ──────────────
-hr
-log "${C_BOLD}CodeForge installer${C_RESET}  (mode=$MODE, action=$ACTION, dry-run=$DRY_RUN)"
-hr
-log "Source : $SOURCE_ROOT"
-log "Target : $TARGET_ROOT"
-hr
-
-if [[ "$ACTION" == "uninstall" ]]; then
-  uninstall
-  exit 0
-fi
-
-# Step 1/8: 环境检测
-log "Step 1/8: 环境检测"
-detect_opencode
-detect_kh_mcp
-
-# Step 2/8: build dist bundle
-log "Step 2/8: 构建 dist/index.js 单 bundle"
-BUNDLE_SRC="$SOURCE_ROOT/$BUNDLE_SRC_REL"
-if [[ $SKIP_BUILD -eq 1 ]]; then
-  warn "已跳过 build（--skip-build），使用现有 dist/index.js"
-else
-  if [[ $DRY_RUN -eq 1 ]]; then
-    printf "  ${C_BLUE}[dry-run]${C_RESET} npm run build\n"
-  else
-    (cd "$SOURCE_ROOT" && npm run build) || { err "npm run build 失败"; exit 1; }
-  fi
-fi
-if [[ ! -f "$BUNDLE_SRC" && $DRY_RUN -eq 0 ]]; then
-  if [[ $SKIP_BUILD -eq 1 ]]; then
-    err "找不到 ${BUNDLE_SRC}（npm 包可能损坏）"
-    err "  请尝试重装：npx @andyqiu/codeforge install [--global]"
-  else
-    err "找不到 ${BUNDLE_SRC}，请先成功执行 npm run build"
-  fi
-  exit 1
-fi
-if [[ -f "$BUNDLE_SRC" ]]; then
-  size=$(wc -c < "$BUNDLE_SRC" | tr -d ' ')
-  ok "bundle 已就绪: $BUNDLE_SRC (${size} bytes)"
-fi
-
-# Step 3/8: 准备目录 + 清理 legacy
-log "Step 3/8: 准备目标目录 + 清理 legacy 注入物"
-ensure_dir "$TARGET_ROOT"
-for legacy in "${LEGACY_DIRS[@]}"; do
-  p="$TARGET_ROOT/$legacy"
-  if [[ -e "$p" || -L "$p" ]]; then
-    run "rm -rf '$p'"
-    warn "已清理 legacy 目录: $p"
-  fi
-done
-
-# Step 4/8: 装 bundle
-log "Step 4/8: 装入 dist/index.js bundle"
-BUNDLE_DST="$TARGET_ROOT/$BUNDLE_DST_REL"
-ensure_dir "$(dirname "$BUNDLE_DST")"
-run "cp -f '$BUNDLE_SRC' '$BUNDLE_DST'"
-ok "bundle → $BUNDLE_DST"
-write_plugin_entry
-
-# 写 VERSION marker 文件（用户 cat 一行查版本，不依赖 grep bundle）
-CF_VERSION="$(node -e "console.log(require('$SOURCE_ROOT/package.json').version)" 2>/dev/null || echo "unknown")"
-VERSION_FILE="$TARGET_ROOT/codeforge/VERSION"
-if [[ $DRY_RUN -eq 0 ]]; then
-  printf "%s\n" "$CF_VERSION" > "$VERSION_FILE"
-fi
-ok "VERSION → ${VERSION_FILE} (${CF_VERSION})"
-
-# Step 5/8: 装 agents / commands / workflows / context-templates / review-profiles
-log "Step 5/8: 装 agents / commands / workflows / context-templates / review-profiles"
-for entry in "${MD_COPY_DIRS[@]}"; do
-  src_name="${entry%%:*}"; dst_name="${entry##*:}"
-  src_path="$SOURCE_ROOT/$src_name"
-  dst_path="$TARGET_ROOT/$dst_name"
-  if [[ ! -d "$src_path" ]]; then
-    warn "源目录不存在，跳过: $src_path"; continue
-  fi
-  if [[ -e "$dst_path" || -L "$dst_path" ]]; then
-    run "rm -rf '$dst_path'"
-  fi
-  ensure_dir "$dst_path"
-  count=0
-  while IFS= read -r f; do
-    base="$(basename "$f")"
-    if [[ "$base" == "README.md" || "$base" == _* || "$base" == *.bak || "$base" == .* ]]; then continue; fi
-    run "cp -f '$f' '$dst_path/'"
-    count=$((count+1))
-  done < <(find "$src_path" -maxdepth 1 -type f -name '*.md')
-  ok "$src_name/ → $dst_path  ($count 个 .md)"
-done
-for entry in "${COPY_DIRS[@]}"; do
-  src_name="${entry%%:*}"; dst_name="${entry##*:}"
-  src_path="$SOURCE_ROOT/$src_name"
-  dst_path="$TARGET_ROOT/$dst_name"
-  if [[ ! -d "$src_path" ]]; then
-    warn "源目录不存在，跳过: $src_path"; continue
-  fi
-  ensure_dir "$dst_path"
-  run "cp -R '$src_path/.' '$dst_path/'"
-  ok "$src_name/ → $dst_path (整目录拷贝)"
-done
-
-
-# Step 5b/8: 装 skills/（opencode skill 目录：~/.config/opencode/skills/ 或 .opencode/skills/）
-# skills/ 在项目顶级，git 追踪，npm 包含。安装时整目录 rsync 到 target。
-# 细粒度 uninstall：只删 CodeForge 自己的 skill 子目录，不碰用户自装的其他 skill。
-log "Step 5b/8: 装 skills/"
-SKILLS_SRC="$SOURCE_ROOT/skills"
-SKILLS_DST="$TARGET_ROOT/skills"
-if [[ -d "$SKILLS_SRC" ]]; then
-  ensure_dir "$SKILLS_DST"
-  skill_count=0
-  while IFS= read -r skill_dir; do
-    skill_name="$(basename "$skill_dir")"
-    dst_skill="$SKILLS_DST/$skill_name"
-    if [[ -e "$dst_skill" || -L "$dst_skill" ]]; then
-      run "rm -rf '$dst_skill'"
-    fi
-    run "cp -R '$skill_dir' '$dst_skill'"
-    skill_count=$((skill_count + 1))
-  done < <(find "$SKILLS_SRC" -mindepth 1 -maxdepth 1 -type d)
-  ok "skills/ → $SKILLS_DST  ($skill_count 个 skill)"
-else
-  warn "skills/ 目录不存在，跳过（发布包未含 skills）"
-fi
-
-# Step 5c/8: 装 assets/（adr-init 模板资产：scripts/ + githooks/ + docs/）
-# assets/ 在项目顶级，git 追踪，npm 包含。安装时整目录拷贝到 TARGET_ROOT/assets/。
-# resolveAssetsRoot（tools/adr-init.ts）从 dist/index.js 所在目录向上找 package.json+assets/adr-init，
-# 命中 ~/.config/opencode（层 1），因此 assets 必须装到 TARGET_ROOT/assets/adr-init/。
-log "Step 5c/8: 装 assets/"
-ASSETS_SRC="$SOURCE_ROOT/assets"
-ASSETS_DST="$TARGET_ROOT/assets"
-if [[ -d "$ASSETS_SRC" ]]; then
-  ensure_dir "$ASSETS_DST"
-  run "cp -R '$ASSETS_SRC/.' '$ASSETS_DST/'"
-  ok "assets/ → $ASSETS_DST"
-else
-  warn "assets/ 目录不存在，跳过（发布包未含 assets）"
-fi
-
-# Step 6/8: AGENTS.md 智能合并（仅项目模式）
-log "Step 6/8: AGENTS.md 智能合并"
-if [[ "$MODE" == "project" ]]; then
-  agents_target="$(pwd)/AGENTS.md"
-  template_path="$SOURCE_ROOT/$KH_TEMPLATE_REL"
-  merge_project_agents_md "$agents_target" "$template_path"
-else
-  ok "全局模式：跳过项目 AGENTS.md 合并（context-templates 已装到 $TARGET_ROOT/context-templates）"
-fi
-
-# Step 7/8: KH 全局配置模板（仅 --global）
-log "Step 7/8: KH 全局配置模板"
-if [[ "$MODE" == "global" ]]; then
-  write_kh_template
-else
-  ok "项目级安装，跳过 KH 全局模板（要装请加 --global）"
-fi
-
-# Step 8/8: 配置默认 agent → codeforge（ADR-0056 D5）
-# 仅 user/global mode 配置用户级 ~/.config/opencode/opencode.json
-# project mode 不动用户级配置（项目应由用户自决是否覆盖）
-# Windows 用户暂需手动配置（install.ps1 尚未实现该步骤，留待 ADR-0059）
-log "Step 8/8: 配置默认 agent → codeforge"
-if [[ "$MODE" == "global" ]]; then
-  configure_default_agent
-else
-  ok "项目级安装，跳过用户级 default_agent 配置（要装请加 --global）"
-fi
-
-# 如果是 CodeForge 开发仓库本身，重新生成 dev shim（install 会清掉 .opencode/plugins/）
-# ADR-0055：本仓库内 opencode 加载本项目 dist/ 而非全局 stable，依赖 dev shim 让位
-if [ -f ".codeforge/.dev-marker" ] && [ -f "scripts/dev-sync.mjs" ]; then
-  node scripts/dev-sync.mjs --no-build 2>/dev/null || true
-  echo "  ↳ dev shim regenerated (.opencode/plugins/codeforge-dev.js)"
-fi
-
-
-# Step 9/9: 安装后自检（ADR:worktree-guard-fail-loud Fix D）
-# 在「验证清单」前主动跑 4 项关键依赖检查；warn 不阻塞 install，但用户能立刻看到红绿
-verify_install() {
-  local has_warn=0
-  log "Step 9/9: 安装后自检"
-
-  # 1. git 版本（worktree 隔离硬依赖；需要 >= 2.5）
-  if command -v git >/dev/null 2>&1; then
-    local gv major minor
-    gv="$(git --version 2>/dev/null | awk '{print $3}')"
-    major="$(printf '%s' "$gv" | cut -d. -f1)"
-    minor="$(printf '%s' "$gv" | cut -d. -f2)"
-    # 数值校验失败时按 0 处理，避免 "[: : integer expression expected"
-    case "$major" in *[!0-9]*|"") major=0 ;; esac
-    case "$minor" in *[!0-9]*|"") minor=0 ;; esac
-    if [ "$major" -gt 2 ] || { [ "$major" -eq 2 ] && [ "$minor" -ge 5 ]; }; then
-      ok "git $gv  (>= 2.5 ✓ worktree 支持)"
-    else
-      warn "git $gv 版本太旧（worktree 需要 >= 2.5）；worktree 隔离将失效（写操作会被 DENY）"
-      has_warn=1
-    fi
-  else
-    warn "git 未安装；worktree 隔离将失效（写操作会被 DENY）"
-    has_warn=1
-  fi
-
-  # 1b. git 仓库探测（reviewer 追加：Fix D 补 git rev-parse --git-dir 检查）
-  # 全局模式下当前目录通常**不是** CodeForge 自己的项目，因此只 info 提示；
-  # 项目模式下若当前目录不是 git 仓库，必然影响 worktree 隔离 → warn。
-  if command -v git >/dev/null 2>&1; then
-    if git rev-parse --git-dir >/dev/null 2>&1; then
-      ok "当前目录是 git 仓库（git rev-parse --git-dir ✓）"
-    else
-      if [ "$MODE" = "project" ]; then
-        warn "当前目录不是 git 仓库（git rev-parse --git-dir 失败）；worktree 隔离将失效"
-        warn "  解决：\`git init && git add -A && git commit -m 'initial'\`"
-        has_warn=1
-      else
-        log "  ↳ 当前目录非 git 仓库（全局安装无碍；进入实际项目使用时该项目需是 git 仓库）"
-      fi
-    fi
-  fi
-
-  # 2. opencode 版本
-  if command -v opencode >/dev/null 2>&1; then
-    local ov
-    ov="$(opencode --version 2>/dev/null || echo unknown)"
-    ok "opencode $ov"
-  else
-    warn "opencode 未在 PATH 中；CodeForge 无入口可用（请先安装 opencode）"
-    has_warn=1
-  fi
-
-  # 3. plugin 注册检查
-  local cfg
-  cfg="$(opencode_cfg_path)"
-  if [ -f "$cfg" ] && grep -q '"codeforge"' "$cfg" 2>/dev/null; then
-    ok "plugin 已注册：$cfg"
-  else
-    if [ "$MODE" = "project" ]; then
-      log "  ↳ 项目级配置 $cfg 未包含 codeforge entry（如需用 codeforge agent，请编辑该文件）"
-    else
-      warn "plugin 未在 $cfg 中注册"
-      has_warn=1
-    fi
-  fi
-
-  # 4. dev-marker 误用检测（仅 global 模式有意义）
-  if [ "$MODE" = "global" ]; then
-    if [ -f "$HOME/.codeforge/.dev-marker" ] || [ -f "$HOME/.dev-marker" ]; then
-      warn "检测到 \$HOME 附近有 .codeforge/.dev-marker —— 可能导致所有项目让位到本地 plugin"
-      warn "  建议删除：rm \$HOME/.codeforge/.dev-marker"
-      has_warn=1
-    fi
-  fi
-
-  if [ "$has_warn" -eq 0 ]; then
-    ok "${C_BOLD}自检通过${C_RESET}"
-  else
-    warn "${C_BOLD}自检发现 $has_warn 项问题，详见上方${C_RESET}"
-  fi
-}
-verify_install
-
-
-# 验证清单
-hr
-ok "${C_BOLD}CodeForge v${CF_VERSION} 安装完成${C_RESET}"
-hr
-cat <<EOF
-${C_BOLD}验证清单：${C_RESET}
-  1. 列出注入的扩展点：
-     $ ls -la "$TARGET_ROOT"
-  2. 看 opencode.json 里 plugin entry：
-     $ cat "$(opencode_cfg_path)"
-  3. 让 opencode 校验配置：
-     $ opencode debug config
-     -> 期望看到 1 个 codeforge plugin entry（不是 17 个）
-  4. 跑一次最小 dogfood，看 plugin import + activation 日志：
-     $ opencode run "hello"
-     $ tail -n 50 \$HOME/.cache/codeforge/plugins.log
-  5. KH 配置（仅 --global 安装时生成）：
-     $ cat "$CODEFORGE_CFG_DIR/kh.json"
-     $ export KNOWLEDGE_API_KEY=<your-token>   # ← API key 必须走环境变量
-  6. AGENTS.md 智能合并（仅项目级）：
-     - 已有 AGENTS.md → KH 块被替换成模板内容，原文件备份成 *.bak.<timestamp>
-     - 模板源：${SOURCE_ROOT}/${KH_TEMPLATE_REL}（修改后请重新 install）
-
-${C_BOLD}卸载：${C_RESET}
-  $ ./install.sh --uninstall ${MODE/project/}
-EOF
-hr