@andyqiu/codeforge 0.6.13 → 0.7.0

package/bin/codeforge.mjs

@@ -1,18 +1,17 @@
 #!/usr/bin/env node
 /**
  * codeforge — opencode 零侵入扩展包的安装入口
+ * ADR:cli-deadcode-cleanup
  *
  * 一行命令安装：
  *   npm install -g @andyqiu/codeforge
  *
  * 子命令：
- *   install    [--dry-run] [--enable-legacy-tools]
+ *   install    [--dry-run]
  *               把 CodeForge 单 bundle 注入到 opencode（写 opencode.json plugin entry）
  *   uninstall               卸载（不动 opencode 自身）
  *   list                              探测 opencode 是否在机器上
  *   version                           打印版本
- *   rollback   [--target=<path>] [--dry-run]
- *                                     恢复到上一次 backup（auto_install 失败时手动救场）
  *   runtime where [<path>]            打印当前项目对应的全局运行时目录
  *   adr-init   [--force] [--dry-run] [--write-prepare] [--no-pre-push]
  *                                     把 ADR 体系（hooks + scripts + 模板）下发到当前 git 项目
@@ -25,8 +24,7 @@
  */
 
 import { spawnSync } from "node:child_process"
-import { copyFileSync, existsSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs"
-import { homedir } from "node:os"
+import { existsSync, readFileSync } from "node:fs"
 import * as path from "node:path"
 import * as url from "node:url"
 
@@ -94,15 +92,12 @@ function parseArgs(argv) {
 
 // ────────────────────────────────────────────────────────────────────
 // opencode installer：薄壳，统一调 install.mjs（Node ESM 跨平台）
-// ADR:unify-install-to-node-mjs
-// 自举兼容：优先找 install.mjs（v0.6+），fallback 到 install.sh（v0.5 过渡期）
-// 用于 upgrade 命令：旧版 CLI 调新包时，新包里只有 install.mjs
+// ADR:unify-install-to-node-mjs / ADR:cli-deadcode-cleanup
+// install.sh/.ps1 已合并进 install.mjs，installer 永远走 node。
 // ────────────────────────────────────────────────────────────────────
 function resolveInstallerScript() {
   const mjsScript = path.join(REPO_ROOT, "install.mjs")
-  if (existsSync(mjsScript)) return { script: mjsScript, useNode: true }
-  const shScript = path.join(REPO_ROOT, "install.sh")
-  if (existsSync(shScript)) return { script: shScript, useNode: false }
+  if (existsSync(mjsScript)) return { script: mjsScript }
   return null
 }
 
@@ -112,24 +107,14 @@ function installOpencode({ scope, dryRun, extraArgs, quiet = false, verbose = fa
     err(`installer 脚本不存在：${path.join(REPO_ROOT, "install.mjs")}`)
     return 2
   }
-  const { script, useNode } = resolved
-  let cmd, args
-  if (useNode) {
-    cmd = process.execPath
-    args = [script]
-    if (scope === "global") args.push("--global")
-    if (dryRun) args.push("--dry-run")
-    if (verbose) args.push("--verbose")
-    if (extraArgs) args.push(...extraArgs)
-  } else {
-    // fallback：旧版包里只有 install.sh（v0.5 过渡期）
-    cmd = "bash"
-    args = [script]
-    if (scope === "global") args.push("--global")
-    if (dryRun) args.push("--dry-run")
-    if (extraArgs) args.push(...extraArgs)
-  }
-  if (!quiet) log(`opencode: ${useNode ? "node" : "bash"} ${args.join(" ")}`)
+  const { script } = resolved
+  const cmd = process.execPath
+  const args = [script]
+  if (scope === "global") args.push("--global")
+  if (dryRun) args.push("--dry-run")
+  if (verbose) args.push("--verbose")
+  if (extraArgs) args.push(...extraArgs)
+  if (!quiet) log(`opencode: node ${args.join(" ")}`)
   const r = spawnSync(cmd, args, { stdio: quiet ? "pipe" : "inherit", cwd: REPO_ROOT })
   if (quiet && r.status !== 0) {
     if (r.stderr) process.stderr.write(r.stderr)
@@ -144,15 +129,11 @@ function uninstallOpencode({ scope }) {
     err(`installer 脚本不存在：${path.join(REPO_ROOT, "install.mjs")}`)
     return 2
   }
-  const { script, useNode } = resolved
-  if (!useNode && process.platform === "win32") {
-    err("Windows 下旧版 install.sh 不支持，请重新安装：npm install -g @andyqiu/codeforge")
-    return 2
-  }
-  const cmd = useNode ? process.execPath : "bash"
+  const { script } = resolved
+  const cmd = process.execPath
   const args = [script, "--uninstall"]
   if (scope === "global") args.push("--global")
-  log(`opencode uninstall: ${useNode ? "node" : "bash"} ${args.join(" ")}`)
+  log(`opencode uninstall: node ${args.join(" ")}`)
   const r = spawnSync(cmd, args, { stdio: "inherit", cwd: REPO_ROOT })
   return r.status ?? 1
 }
@@ -175,7 +156,6 @@ function cmdInstall(args) {
   const autoSkipBuild = fromNpm
   const verbose = !!args.flags.verbose
   const extraArgs = []
-  if (args.flags["enable-legacy-tools"]) extraArgs.push("--enable-legacy-tools")
   if (args.flags["skip-build"] || autoSkipBuild) extraArgs.push("--skip-build")
 
   // npm 场景：dist/index.js 必须已经被 prepack 打好；找不到就直接报错并提示
@@ -222,80 +202,6 @@ function cmdList() {
   return 0
 }
 
-// ────────────────────────────────────────────────────────────────────
-// 子命令：rollback（ADR-0047）—— 把最近的 .bak.<ver> 文件恢复回 index.js
-// ────────────────────────────────────────────────────────────────────
-function defaultBundlePath() {
-  const candidates = [path.join(homedir(), ".config", "opencode", "codeforge", "index.js")]
-  if (process.platform === "win32") {
-    if (process.env.APPDATA) candidates.push(path.join(process.env.APPDATA, "opencode", "codeforge", "index.js"))
-    if (process.env.LOCALAPPDATA) candidates.push(path.join(process.env.LOCALAPPDATA, "opencode", "codeforge", "index.js"))
-  }
-  for (const c of candidates) {
-    if (existsSync(c)) return c
-  }
-  return candidates[0]
-}
-
-function cmdRollback(args) {
-  const target = typeof args.flags.target === "string" ? args.flags.target : defaultBundlePath()
-  const dryRun = !!args.flags["dry-run"] || !!args.flags.dryRun
-
-  log(`CodeForge rollback —— 恢复到上一次 backup`)
-  log(`  target  : ${target}`)
-  log(`  dry-run : ${dryRun}`)
-  hr()
-
-  const dir = path.dirname(target)
-  const base = path.basename(target)
-  if (!existsSync(dir)) {
-    err(`目标目录不存在：${dir}`)
-    err(`提示：先跑 codeforge install 安装一次，自动更新失败时再 rollback。`)
-    return 1
-  }
-
-  let entries
-  try {
-    entries = readdirSync(dir)
-  } catch (e) {
-    err(`读取目录失败：${e.message}`)
-    return 1
-  }
-  const prefix = `${base}.bak.`
-  const backups = entries
-    .filter((f) => f.startsWith(prefix))
-    .map((f) => {
-      const full = path.join(dir, f)
-      let mtimeMs = 0
-      try { mtimeMs = statSync(full).mtimeMs } catch {}
-      return { full, name: f, mtimeMs, ver: f.substring(prefix.length) }
-    })
-    .sort((a, b) => b.mtimeMs - a.mtimeMs)
-
-  if (backups.length === 0) {
-    err(`找不到任何 backup（pattern: ${prefix}*）`)
-    err(`提示：自动更新尚未执行过 / backup 已被清理。可跑 npm install -g @andyqiu/codeforge 重装。`)
-    return 1
-  }
-
-  const latest = backups[0]
-  log(`找到 ${backups.length} 个 backup，最新：${latest.name}`)
-  if (dryRun) {
-    ok(`[dry-run] 会执行：cp ${latest.full} → ${target}`)
-    return 0
-  }
-
-  try {
-    copyFileSync(latest.full, target)
-  } catch (e) {
-    err(`恢复失败：${e.message}`)
-    return 1
-  }
-  ok(`已恢复 ${latest.name} → ${base}（版本：${latest.ver}）`)
-  ok(`下次启动 opencode 即可生效`)
-  return 0
-}
-
 // ────────────────────────────────────────────────────────────────────
 // 子命令：upgrade —— 升级到 npm latest 并重新 install --global
 // ────────────────────────────────────────────────────────────────────
@@ -366,17 +272,6 @@ async function cmdUpgrade(args) {
     return 1
   }
 
-  // npm install 成功后刷新 opencode plugin 缓存，确保重启后加载新版本
-  try {
-    const cacheDir = path.join(homedir(), ".cache", "opencode", "packages", "@andyqiu", "teamkit@latest")
-    if (existsSync(cacheDir)) {
-      rmSync(cacheDir, { recursive: true, force: true })
-      log("已清除 opencode plugin 缓存，重启 opencode 后生效")
-    }
-  } catch {
-    warn("清除 opencode 缓存失败（非致命，可手动重启 opencode）")
-  }
-
   const code = installOpencode({ scope: "global", dryRun: false, extraArgs: ["--skip-build"], quiet: true })
   if (code !== 0) {
     err(`install --global 失败 (exit=${code})`)
@@ -512,7 +407,6 @@ function cmdHelp() {
   codeforge uninstall
   codeforge list
   codeforge version
-  codeforge rollback   [--target=<path>] [--dry-run]   # 恢复最近 backup（auto_install 失败救场）
   codeforge upgrade|update    [--dry-run]   # 升级到 npm latest 并重新 install --global
   codeforge doctor     [--project]   # 诊断 CodeForge 安装健康状态（manifest/disk/source 三方比对）
   codeforge runtime where [<path>]   # 打印当前项目的全局运行时目录
@@ -525,8 +419,6 @@ function cmdHelp() {
 参数：
   --dry-run              只打印操作，不真改
   --skip-build           跳过 npm run build（已有 dist/index.js 时增量装）
-  --enable-legacy-tools  启用旧版 file-based tools（默认禁用，避免 zod 跨实例 bug）
-  --target               rollback 子命令：指定 index.js 路径（默认自动探测）
 
 参数（adr-init 专用）：
   --force                覆盖已存在文件（覆盖前自动 .bak.<ts> 备份）
@@ -573,8 +465,6 @@ async function main() {
     case "-v":
       console.log(getVersion())
       return 0
-    case "rollback":
-      return cmdRollback(args)
     case "upgrade":
     case "update":
       return cmdUpgrade(args)

package/codeforge.config.yaml

@@ -31,7 +31,6 @@ install:
   # 哪些目录拷贝（用户可自定义）
   copy:
     - workflows
-    - context-templates
   # 安装目标
   targets:
     project: ".opencode"

package/codeforge.json

@@ -152,7 +152,7 @@
   },
 
   "update": {
-    "_doc": "自动更新检查（ADR-0047）。opencode 启动时由 plugins/update-checker.ts 后台拉 npm registry latest，auto_install=true 时自动替换 ~/.config/opencode/codeforge/index.js（下次启动生效），失败/离线静默回退到 GitHub Releases。手动回滚：codeforge rollback。",
+    "_doc": "自动更新检查（ADR-0047）。opencode 启动时由 plugins/update-checker.ts 后台拉 npm registry latest，auto_install=true 时自动替换 ~/.config/opencode/codeforge/index.js（下次启动生效），失败/离线静默回退到 GitHub Releases。手动降级：npm install -g @andyqiu/codeforge@<旧版本>。",
     "auto_check_enabled": true,
     "interval_hours": 6,
     "package": "@andyqiu/codeforge",

package/commands/parallel.md

@@ -40,7 +40,7 @@ codeforge 元数据（opencode 不读，由 plugins / workflow-engine 解析）
 或单行 `;` 分隔：
 
 ```
-/parallel 改 README; 同步 PRD; 跑 phase4-check
+/parallel 改 README; 同步 PRD; 跑测试
 ```
 
 走 workflow（`parallel-explore.yaml`）：

package/dist/index.js

@@ -20166,35 +20166,21 @@ var toolPolicyServer = async (ctx) => {
 var handler19 = toolPolicyServer;
 
 // plugins/update-checker.ts
-import { existsSync as existsSync6, rmSync } from "node:fs";
-import { homedir as homedir9 } from "node:os";
-import { join as join25 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir8 } from "node:os";
+import { dirname as dirname15, join as join25 } from "node:path";
 import { spawnSync as spawnSync2 } from "node:child_process";
 
 // lib/update-checker-impl.ts
-import { createHash as createHash4 } from "node:crypto";
-import {
-  copyFileSync,
-  existsSync as existsSync5,
-  mkdirSync as mkdirSync3,
-  mkdtempSync,
-  readFileSync as readFileSync5,
-  readdirSync as readdirSync3,
-  renameSync,
-  statSync as statSync4,
-  unlinkSync,
-  writeFileSync as writeFileSync2
-} from "node:fs";
-import { homedir as homedir8, tmpdir } from "node:os";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { dirname as dirname14, join as join24 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import * as https from "node:https";
-import * as zlib from "node:zlib";
 
 // lib/version-injected.ts
 function getInjectedVersion() {
   try {
-    const v = "0.6.13";
+    const v = "0.7.0";
     if (typeof v === "string" && /^\d+\.\d+\.\d+/.test(v)) {
       return v;
     }
@@ -20205,48 +20191,6 @@ function getInjectedVersion() {
 }
 
 // lib/update-checker-impl.ts
-async function checkUpdateOnce(opts) {
-  const local = opts.localVersion ?? readLocalVersion();
-  const cacheFile = opts.cacheFile ?? defaultCacheFile();
-  const now = (opts.now ?? Date.now)();
-  if (!opts.forceFresh) {
-    const cached = readCache(cacheFile);
-    if (cached && cached.repo === opts.repo && now - cached.checkedAt < opts.intervalMs) {
-      return {
-        hasUpdate: cmpVersion(local, cached.remote) < 0,
-        local,
-        remote: cached.remote,
-        fromCache: true,
-        cacheAgeMs: now - cached.checkedAt
-      };
-    }
-  }
-  const fetcher = opts.fetcher ?? fetchLatestTagFromGitHub;
-  let remote = null;
-  let fetchErr;
-  try {
-    remote = await fetcher(opts.repo);
-  } catch (e) {
-    fetchErr = e instanceof Error ? e.message : String(e);
-  }
-  if (remote === null) {
-    writeCache(cacheFile, { checkedAt: now, remote: local, repo: opts.repo });
-    return {
-      hasUpdate: false,
-      local,
-      remote: "(no release)",
-      fromCache: false,
-      error: fetchErr ?? "no_release"
-    };
-  }
-  writeCache(cacheFile, { checkedAt: now, remote, repo: opts.repo });
-  return {
-    hasUpdate: cmpVersion(local, remote) < 0,
-    local,
-    remote,
-    fromCache: false
-  };
-}
 function cmpVersion(a, b) {
   const pa = parseSemver(a);
   const pb = parseSemver(b);
@@ -20290,97 +20234,6 @@ function readLocalVersion() {
     return "0.0.0";
   }
 }
-function defaultCacheDir() {
-  return process.env["CODEFORGE_CACHE_DIR"] ?? join24(homedir8(), ".cache", "codeforge");
-}
-function defaultCacheFile() {
-  return join24(defaultCacheDir(), "update-check.json");
-}
-function readCache(file) {
-  try {
-    if (!existsSync5(file))
-      return null;
-    const raw = readFileSync5(file, "utf8");
-    const obj = JSON.parse(raw);
-    if (obj && typeof obj === "object" && typeof obj.checkedAt === "number" && typeof obj.remote === "string" && typeof obj.repo === "string") {
-      return obj;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function writeCache(file, entry) {
-  try {
-    mkdirSync3(dirname14(file), { recursive: true });
-    writeFileSync2(file, JSON.stringify(entry, null, 2), "utf8");
-  } catch {}
-}
-var GITHUB_API_HOST = "api.github.com";
-var MAX_REDIRECTS = 5;
-function fetchLatestTagFromGitHub(repo) {
-  return getJsonWithRedirect(`https://${GITHUB_API_HOST}/repos/${repo}/releases/latest`, MAX_REDIRECTS).then((body) => {
-    if (body === null)
-      return null;
-    try {
-      const json = JSON.parse(body);
-      return typeof json.tag_name === "string" && json.tag_name.length > 0 ? json.tag_name : null;
-    } catch (e) {
-      throw e instanceof Error ? e : new Error(String(e));
-    }
-  });
-}
-function getJsonWithRedirect(url2, hopsLeft) {
-  return new Promise((resolve17, reject) => {
-    const u = new URL(url2);
-    const headers = {
-      "User-Agent": "codeforge-update-checker",
-      Accept: "application/vnd.github+json"
-    };
-    if (process.env["GITHUB_TOKEN"]) {
-      headers["Authorization"] = `Bearer ${process.env["GITHUB_TOKEN"]}`;
-    }
-    const req = https.request({
-      host: u.hostname,
-      path: u.pathname + (u.search ?? ""),
-      method: "GET",
-      headers,
-      timeout: 5000
-    }, (res) => {
-      const status = res.statusCode ?? 0;
-      if (status >= 300 && status < 400 && res.headers.location) {
-        res.resume();
-        if (hopsLeft <= 0) {
-          reject(new Error("too_many_redirects"));
-          return;
-        }
-        const next = new URL(res.headers.location, url2).toString();
-        getJsonWithRedirect(next, hopsLeft - 1).then(resolve17, reject);
-        return;
-      }
-      if (status === 404) {
-        res.resume();
-        resolve17(null);
-        return;
-      }
-      if (status >= 400) {
-        res.resume();
-        reject(new Error(`http_${status}`));
-        return;
-      }
-      let body = "";
-      res.setEncoding("utf8");
-      res.on("data", (chunk) => body += chunk);
-      res.on("end", () => resolve17(body));
-    });
-    req.on("timeout", () => {
-      req.destroy();
-      reject(new Error("timeout"));
-    });
-    req.on("error", reject);
-    req.end();
-  });
-}
 async function fetchLatestFromNpm(opts) {
   const registry = (opts.registry ?? "https://registry.npmjs.org").replace(/\/+$/, "");
   const channel = opts.channel ?? "latest";
@@ -20449,256 +20302,75 @@ function defaultHttpFetcher(url2, timeoutMs) {
     req.end();
   });
 }
-async function downloadAndExtractBundle(opts) {
-  const tmpRoot = opts.tmpDir ?? mkdtempSync(join24(tmpdir(), "codeforge-update-"));
-  mkdirSync3(tmpRoot, { recursive: true });
-  const fetcher = opts.tarballFetcher ?? defaultBinaryFetcher;
-  const tarballBuf = await fetcher(opts.tarballUrl);
-  verifyIntegrity(tarballBuf, opts.expectedIntegrity);
-  const tarBuf = zlib.gunzipSync(tarballBuf);
-  extractTarToDir(tarBuf, tmpRoot);
-  const bundlePath = join24(tmpRoot, "package", "dist", "index.js");
-  if (!existsSync5(bundlePath)) {
-    throw new Error(`bundle_not_found: ${bundlePath}`);
-  }
-  return { bundlePath, extractDir: tmpRoot };
-}
-function verifyIntegrity(buf, expected) {
-  const m = /^([a-z0-9]+)-(.+)$/i.exec(expected.trim());
-  if (!m) {
-    throw new Error(`integrity_format_invalid: ${expected}`);
-  }
-  const algo = m[1].toLowerCase();
-  const expectedB64 = m[2];
-  if (algo !== "sha512" && algo !== "sha256" && algo !== "sha384") {
-    throw new Error(`integrity_algo_unsupported: ${algo}`);
-  }
-  const actualB64 = createHash4(algo).update(buf).digest("base64");
-  if (actualB64 !== expectedB64) {
-    throw new Error(`integrity_mismatch: expected ${algo}=${expectedB64.slice(0, 16)}... got ${actualB64.slice(0, 16)}...`);
-  }
-}
-function extractTarToDir(tarBuf, destRoot) {
-  let offset = 0;
-  while (offset + 512 <= tarBuf.length) {
-    const header = tarBuf.subarray(offset, offset + 512);
-    if (header.every((b) => b === 0))
-      break;
-    const nameRaw = header.subarray(0, 100).toString("utf8").replace(/\0.*$/, "");
-    if (!nameRaw) {
-      offset += 512;
-      continue;
-    }
-    const sizeOctal = header.subarray(124, 124 + 12).toString("ascii").replace(/\0.*$/, "").trim();
-    const size = sizeOctal ? parseInt(sizeOctal, 8) : 0;
-    const typeFlag = header.subarray(156, 157).toString("ascii");
-    const prefixRaw = header.subarray(345, 345 + 155).toString("utf8").replace(/\0.*$/, "");
-    const fullName = prefixRaw ? `${prefixRaw}/${nameRaw}` : nameRaw;
-    offset += 512;
-    if (typeFlag === "0" || typeFlag === "" || typeFlag === "\x00") {
-      const fileBuf = tarBuf.subarray(offset, offset + size);
-      const dest = join24(destRoot, fullName);
-      mkdirSync3(dirname14(dest), { recursive: true });
-      writeFileSync2(dest, fileBuf);
-    } else if (typeFlag === "5") {
-      mkdirSync3(join24(destRoot, fullName), { recursive: true });
-    }
-    offset += Math.ceil(size / 512) * 512;
-  }
-}
-function defaultBinaryFetcher(url2) {
-  return downloadBinary(url2, 3);
-}
-function downloadBinary(url2, hopsLeft) {
-  return new Promise((resolve17, reject) => {
-    const u = new URL(url2);
-    const req = https.request({
-      host: u.hostname,
-      port: u.port || undefined,
-      path: u.pathname + (u.search ?? ""),
-      method: "GET",
-      headers: { "User-Agent": "codeforge-update-checker" },
-      timeout: 30000
-    }, (res) => {
-      const status = res.statusCode ?? 0;
-      if (status >= 300 && status < 400 && res.headers.location) {
-        res.resume();
-        if (hopsLeft <= 0) {
-          reject(new Error("too_many_redirects"));
-          return;
-        }
-        const next = new URL(res.headers.location, url2).toString();
-        downloadBinary(next, hopsLeft - 1).then(resolve17, reject);
-        return;
-      }
-      if (status >= 400) {
-        res.resume();
-        reject(new Error(`http_${status}`));
-        return;
-      }
-      const chunks = [];
-      res.on("data", (chunk) => chunks.push(chunk));
-      res.on("end", () => resolve17(Buffer.concat(chunks)));
-    });
-    req.on("timeout", () => {
-      req.destroy();
-      reject(new Error("timeout"));
-    });
-    req.on("error", reject);
-    req.end();
-  });
+
+// plugins/update-checker.ts
+var PLUGIN_NAME20 = "update-checker";
+var PLUGIN_VERSION = "3.0.0";
+var _updateCheckStarted = false;
+function getCacheFile() {
+  return join25(process.env["CODEFORGE_CACHE_DIR"] ?? join25(homedir8(), ".cache", "codeforge"), "update-check.json");
 }
-function atomicReplaceBundle(opts) {
-  const { source, target, oldVersion } = opts;
-  const keep = opts.keepBackups ?? 3;
-  if (!existsSync5(source)) {
-    throw new Error(`atomic_source_missing: ${source}`);
-  }
-  mkdirSync3(dirname14(target), { recursive: true });
-  const newPath = `${target}.new`;
-  const backupPath = `${target}.bak.${oldVersion}`;
-  let strategy = "rename";
+function readLastInstalledVersion() {
   try {
-    copyFileSync(source, newPath);
-    if (existsSync5(target)) {
-      try {
-        renameSync(target, backupPath);
-      } catch (e) {
-        const code = e.code;
-        if (code === "EBUSY" || code === "EPERM" || code === "EACCES") {
-          copyFileSync(target, backupPath);
-          copyFileSync(newPath, target);
-          try {
-            unlinkSync(newPath);
-          } catch {}
-          strategy = "copy_fallback";
-          cleanupOldBackups(target, keep);
-          return { backupPath, strategy };
-        }
-        throw e;
-      }
-    }
-    try {
-      renameSync(newPath, target);
-    } catch (e) {
-      const code = e.code;
-      if (code === "EBUSY" || code === "EPERM" || code === "EACCES") {
-        copyFileSync(newPath, target);
-        try {
-          unlinkSync(newPath);
-        } catch {}
-        strategy = "copy_fallback";
-      } else {
-        throw e;
-      }
-    }
-    cleanupOldBackups(target, keep);
-    return { backupPath, strategy };
-  } catch (e) {
-    try {
-      if (existsSync5(newPath))
-        unlinkSync(newPath);
-    } catch {}
-    throw e;
+    const f = getCacheFile();
+    if (!existsSync5(f))
+      return null;
+    const o = JSON.parse(readFileSync6(f, "utf8"));
+    return typeof o.installedVersion === "string" ? o.installedVersion : null;
+  } catch {
+    return null;
   }
 }
-function cleanupOldBackups(target, keep) {
-  if (keep <= 0)
-    return;
+function writeLastInstalledVersion(v) {
   try {
-    const dir = dirname14(target);
-    const base = target.substring(dir.length + 1);
-    const prefix = `${base}.bak.`;
-    const all = readdirSync3(dir).filter((f) => f.startsWith(prefix)).map((f) => {
-      const full = join24(dir, f);
-      let mtimeMs = 0;
-      try {
-        mtimeMs = statSync4(full).mtimeMs;
-      } catch {}
-      return { full, mtimeMs };
-    }).sort((a, b) => b.mtimeMs - a.mtimeMs);
-    const toRemove = all.slice(keep);
-    for (const item of toRemove) {
-      try {
-        unlinkSync(item.full);
-      } catch {}
-    }
+    const f = getCacheFile();
+    mkdirSync3(dirname15(f), { recursive: true });
+    writeFileSync2(f, JSON.stringify({ installedVersion: v }, null, 2), "utf8");
   } catch {}
 }
-function loadCompatibility(opts) {
+function resolveNodeBin() {
+  const w = process.platform === "win32";
   try {
-    let file = opts?.file;
-    if (!file) {
-      const root = opts?.cwd ?? inferPluginRoot();
-      if (!root)
-        return null;
-      file = join24(root, "compatibility.json");
-    }
-    if (!existsSync5(file))
-      return null;
-    const raw = readFileSync5(file, "utf8");
-    const obj = JSON.parse(raw);
-    if (!obj || typeof obj !== "object")
-      return null;
-    const oc = obj["opencode"];
-    if (!oc || typeof oc !== "object")
-      return null;
-    const o = oc;
-    const min_version = typeof o["min_version"] === "string" ? o["min_version"] : "";
-    const max_version = typeof o["max_version"] === "string" ? o["max_version"] : null;
-    const tested_versions = Array.isArray(o["tested_versions"]) ? o["tested_versions"].filter((v) => typeof v === "string") : [];
-    if (!min_version)
-      return null;
-    return { min_version, max_version, tested_versions };
-  } catch {
-    return null;
+    const r = spawnSync2(w ? "where" : "which", ["node"], { encoding: "utf8", stdio: "pipe" });
+    if (r.status === 0 && r.stdout.trim())
+      return r.stdout.trim().split(/\r?\n/)[0].trim();
+  } catch {}
+  for (const c of w ? ["C:\\Program Files\\nodejs\\node.exe"] : ["/usr/local/bin/node", "/usr/bin/node", "/opt/homebrew/bin/node", "/opt/homebrew/opt/node/bin/node"]) {
+    try {
+      if (spawnSync2(c, ["--version"], { stdio: "pipe", timeout: 2000 }).status === 0)
+        return c;
+    } catch {}
   }
+  return process.execPath;
 }
-function inferPluginRoot() {
+function resolveNpmBin() {
+  const w = process.platform === "win32";
   try {
-    const here = fileURLToPath2(import.meta.url);
-    return dirname14(dirname14(here));
-  } catch {
-    return null;
+    const r = spawnSync2(w ? "where" : "which", ["npm"], { encoding: "utf8", stdio: "pipe" });
+    if (r.status === 0 && r.stdout.trim())
+      return r.stdout.trim().split(/\r?\n/)[0].trim();
+  } catch {}
+  for (const c of w ? ["C:\\Program Files\\nodejs\\npm.cmd"] : ["/usr/local/bin/npm", "/usr/bin/npm", "/opt/homebrew/bin/npm"]) {
+    try {
+      if (spawnSync2(c, ["--version"], { stdio: "pipe", timeout: 2000 }).status === 0)
+        return c;
+    } catch {}
   }
+  return "npm";
 }
-function compareOpencodeVersion(opts) {
-  const cur = (opts.currentOpencodeVer ?? "").trim();
-  const compat = opts.compat;
-  if (!compat) {
-    return { status: "unknown", message: "compatibility.json 不可用，跳过版本校验" };
-  }
-  if (!cur || cur === "unknown") {
-    return { status: "unknown", message: "无法检测 opencode 版本（OPENCODE_VERSION 未设）" };
-  }
-  if (compat.tested_versions.includes(cur)) {
-    return {
-      status: "supported",
-      message: `opencode ${cur} 在 CodeForge 已测试版本列表内`
-    };
-  }
-  if (cmpVersion(cur, compat.min_version) < 0) {
-    return {
-      status: "below_min",
-      message: `opencode ${cur} 低于 CodeForge 要求的最低版本 ${compat.min_version}`
-    };
-  }
-  if (compat.max_version && cmpVersion(cur, compat.max_version) > 0) {
-    return {
-      status: "above_max",
-      message: `opencode ${cur} 高于 CodeForge 已知兼容上限 ${compat.max_version}`
-    };
-  }
-  const testedDisplay = compat.tested_versions.length > 0 ? compat.tested_versions.join(", ") : "(空)";
-  return {
-    status: "untested",
-    message: `opencode ${cur} 未在 CodeForge 已测试版本列表中（已测：${testedDisplay}）`
-  };
+function getNpmGlobalRoot(npmBin) {
+  try {
+    const r = spawnSync2(npmBin, ["root", "-g"], {
+      encoding: "utf8",
+      stdio: "pipe",
+      timeout: 1e4,
+      shell: process.platform === "win32"
+    });
+    if (r.status === 0 && r.stdout.trim())
+      return r.stdout.trim();
+  } catch {}
+  return null;
 }
-
-// plugins/update-checker.ts
-var PLUGIN_NAME20 = "update-checker";
-var PLUGIN_VERSION = "2.0.0";
 logLifecycle(PLUGIN_NAME20, "import", { version: PLUGIN_VERSION });
 var updateCheckerServer = async (ctx) => {
   const yieldResult = shouldYieldToLocalPlugin({ directory: ctx.directory });
@@ -20722,45 +20394,20 @@ var updateCheckerServer = async (ctx) => {
   logLifecycle(PLUGIN_NAME20, "activate", {
     version: PLUGIN_VERSION,
     auto_check_enabled: u.auto_check_enabled,
-    interval_hours: u.interval_hours,
     package: u.package,
     registry: u.registry,
     channel: u.channel,
-    auto_install: u.auto_install,
-    backup_keep: u.backup_keep,
-    repo_fallback: u.repo,
-    config_source: "codeforge.json"
-  });
-  await safeAsync(PLUGIN_NAME20, "opencode_version_check", async () => {
-    const compat = loadCompatibility();
-    const opencodeVer = detectOpencodeVersion();
-    const verdict = compareOpencodeVersion({
-      currentOpencodeVer: opencodeVer,
-      compat
-    });
-    safeWriteLog(PLUGIN_NAME20, {
-      level: "info",
-      msg: "opencode_version_check",
-      opencodeVer,
-      status: verdict.status,
-      verdict_message: verdict.message
-    });
-    if (verdict.status === "untested" || verdict.status === "above_max") {
-      await postToast(ctx, `[CodeForge] ⚠ ${verdict.message}
-   遇到问题请在 issue 中附带本提示`);
-    } else if (verdict.status === "below_min") {
-      const minVer = compat?.min_version ?? "(unknown)";
-      await postToast(ctx, `[CodeForge] ⚠ ${verdict.message}
-   请升级 opencode 到 ${minVer}+`);
-    }
+    auto_install: u.auto_install
   });
   if (!u.auto_check_enabled) {
-    safeWriteLog(PLUGIN_NAME20, {
-      level: "info",
-      msg: "auto-check disabled (codeforge.json update.auto_check_enabled=false)"
-    });
+    safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "auto_check_disabled" });
+    return {};
+  }
+  if (_updateCheckStarted) {
+    safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "check_skipped_already_running" });
     return {};
   }
+  _updateCheckStarted = true;
   setImmediate(() => {
     safeAsync(PLUGIN_NAME20, "checkAndMaybeUpdate", async () => {
       const local = readLocalVersion();
@@ -20773,224 +20420,72 @@ var updateCheckerServer = async (ctx) => {
           timeoutMs: 5000
         });
       } catch (e) {
-        safeWriteLog(PLUGIN_NAME20, {
-          level: "warn",
-          msg: "npm_fetch_failed",
-          error: e.message
-        });
-        await fallbackToGitHubReleases(ctx, u);
+        safeWriteLog(PLUGIN_NAME20, { level: "warn", msg: "npm_fetch_failed", error: e.message });
         return;
       }
-      if (!npmResult) {
-        safeWriteLog(PLUGIN_NAME20, {
-          level: "info",
-          msg: "npm_no_release",
-          package: u.package,
-          channel: u.channel
-        });
+      if (!npmResult)
         return;
-      }
-      const hasUpdate = cmpVersion(local, npmResult.version) < 0;
-      safeWriteLog(PLUGIN_NAME20, {
-        level: "info",
-        msg: "npm_check_result",
-        local,
-        remote: npmResult.version,
-        hasUpdate,
-        tarballUrl: npmResult.tarballUrl
-      });
+      const remote = npmResult.version;
+      const hasUpdate = cmpVersion(local, remote) < 0;
+      safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "npm_check_result", local, remote, hasUpdate });
       if (!hasUpdate)
         return;
+      const lastInstalled = readLastInstalledVersion();
+      if (lastInstalled === remote) {
+        safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "install_skipped_already_installed", version: remote });
+        return;
+      }
       if (!u.auto_install) {
-        await postToast(ctx, `[CodeForge] 有新版本 ${local} → ${npmResult.version}
-   更新命令：npx ${u.package} install --global`);
+        await postToast(ctx, `[codeforge] 有新版本 ${local} → ${remote}
+   运行：codeforge upgrade`);
         return;
       }
-      await safeAsync(PLUGIN_NAME20, "auto_install_full", async () => {
-        const target = getOpencodeBundlePath();
-        if (!target) {
-          safeWriteLog(PLUGIN_NAME20, {
-            level: "warn",
-            msg: "auto_install_skip",
-            reason: "无法定位 opencode bundle 路径"
-          });
-          await postToast(ctx, `[CodeForge] 有新版本 ${local} → ${npmResult.version}
-   自动安装失败：找不到 bundle，请手动 npx ${u.package} install`);
+      await safeAsync(PLUGIN_NAME20, "auto_install", async () => {
+        const nodeBin = resolveNodeBin();
+        const npmBin = resolveNpmBin();
+        safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "auto_install_start", local, remote, nodeBin, npmBin });
+        const r1 = spawnSync2(npmBin, ["install", "-g", `${u.package}@${remote}`], {
+          stdio: "pipe",
+          encoding: "utf8",
+          timeout: 120000,
+          shell: process.platform === "win32"
+        });
+        if (r1.status !== 0) {
+          safeWriteLog(PLUGIN_NAME20, { level: "warn", msg: "npm_install_failed", status: r1.status, stderr: (r1.stderr ?? "").slice(0, 300) });
+          await postToast(ctx, `[codeforge] 自动升级失败（${local} → ${remote}），请手动运行：codeforge upgrade`);
+          return;
+        }
+        safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "npm_install_success", remote });
+        const npmRoot = getNpmGlobalRoot(npmBin);
+        const codeForgeBin = npmRoot ? join25(npmRoot, "@andyqiu", "codeforge", "bin", "codeforge.mjs") : null;
+        if (!codeForgeBin || !existsSync5(codeForgeBin)) {
+          safeWriteLog(PLUGIN_NAME20, { level: "warn", msg: "codeforge_bin_not_found", path: codeForgeBin ?? "null" });
+          await postToast(ctx, `[codeforge] ⚠ npm 包已升级 ${local} → ${remote}，但资产部署未完成。下次启动将重试，或手动运行：codeforge upgrade`);
           return;
         }
-        const { bundlePath, extractDir } = await downloadAndExtractBundle({
-          tarballUrl: npmResult.tarballUrl,
-          expectedIntegrity: npmResult.integrity
+        const r2 = spawnSync2(nodeBin, [codeForgeBin, "install", "--global", "--skip-build"], {
+          stdio: "pipe",
+          encoding: "utf8",
+          timeout: 60000,
+          shell: false
         });
-        try {
-          const installMjs = join25(extractDir, "package", "install.mjs");
-          if (existsSync6(installMjs)) {
-            const nodeBin = resolveNodeBin();
-            const r = spawnSync2(nodeBin, [installMjs, "--global", "--skip-build"], {
-              cwd: join25(extractDir, "package"),
-              stdio: "pipe",
-              encoding: "utf8"
-            });
-            if (r.status === 0) {
-              safeWriteLog(PLUGIN_NAME20, {
-                level: "info",
-                msg: "auto_install_full_success",
-                local,
-                remote: npmResult.version,
-                strategy: "install.mjs"
-              });
-              await postToast(ctx, `[CodeForge] ✅ 已全量更新 ${local} → ${npmResult.version}（bundle + agents/skills/commands/workflows，重启 opencode 生效）
-   回滚：npx ${u.package} rollback`);
-              return;
-            }
-            safeWriteLog(PLUGIN_NAME20, {
-              level: "warn",
-              msg: "install_mjs_failed",
-              nodeBin,
-              status: r.status,
-              stderr: r.stderr?.slice(0, 500),
-              stdout: r.stdout?.slice(0, 500)
-            });
-          } else {
-            safeWriteLog(PLUGIN_NAME20, {
-              level: "info",
-              msg: "install_mjs_absent_fallback_bundle_only",
-              installMjs
-            });
-          }
-          const { backupPath, strategy } = atomicReplaceBundle({
-            source: bundlePath,
-            target,
-            oldVersion: local,
-            keepBackups: u.backup_keep
-          });
-          safeWriteLog(PLUGIN_NAME20, {
-            level: "info",
-            msg: "auto_install_bundle_only_success",
-            local,
-            remote: npmResult.version,
-            target,
-            backupPath,
-            strategy
-          });
-          await postToast(ctx, `[CodeForge] ✅ 已更新 bundle ${local} → ${npmResult.version}（仅 bundle，agents/skills 未变；重启生效）
-   回滚：npx ${u.package} rollback`);
-        } finally {
-          try {
-            rmSync(extractDir, { recursive: true, force: true });
-          } catch {}
+        if (r2.status !== 0) {
+          safeWriteLog(PLUGIN_NAME20, { level: "warn", msg: "codeforge_install_failed", status: r2.status, stderr: (r2.stderr ?? "").slice(0, 300) });
+          await postToast(ctx, `[codeforge] ⚠ npm 包已升级 ${local} → ${remote}，但资产部署失败。下次启动将重试，或手动运行：codeforge upgrade`);
+          return;
         }
+        writeLastInstalledVersion(remote);
+        safeWriteLog(PLUGIN_NAME20, { level: "info", msg: "auto_install_full_success", local, remote, nodeBin, npmBin });
+        await postToast(ctx, `[codeforge] ✅ 已升级 ${local} → ${remote}（重启 opencode 生效）
+   回滚：npm install -g ${u.package}@${local}`);
       });
     });
   });
   return {};
 };
-function resolveNodeBin() {
-  const IS_WIN = process.platform === "win32";
-  try {
-    const r = spawnSync2(IS_WIN ? "where" : "which", ["node"], {
-      encoding: "utf8",
-      stdio: "pipe"
-    });
-    if (r.status === 0 && r.stdout.trim()) {
-      const first = r.stdout.trim().split(/\r?\n/)[0].trim();
-      if (first)
-        return first;
-    }
-  } catch {}
-  const candidates = IS_WIN ? [
-    "C:\\Program Files\\nodejs\\node.exe",
-    "C:\\Program Files (x86)\\nodejs\\node.exe"
-  ] : [
-    "/usr/local/bin/node",
-    "/usr/bin/node",
-    "/opt/homebrew/bin/node",
-    "/opt/homebrew/opt/node/bin/node"
-  ];
-  for (const c of candidates) {
-    try {
-      const t = spawnSync2(c, ["--version"], {
-        encoding: "utf8",
-        stdio: "pipe",
-        timeout: 2000
-      });
-      if (t.status === 0)
-        return c;
-    } catch {}
-  }
-  return process.execPath;
-}
-function detectOpencodeVersion() {
-  const env = process.env["OPENCODE_VERSION"];
-  if (env && env.trim().length > 0)
-    return env.trim();
-  return "unknown";
-}
-function getOpencodeBundlePath() {
-  const candidates = [];
-  candidates.push(join25(homedir9(), ".config", "opencode", "codeforge", "index.js"));
-  if (process.platform === "win32") {
-    const appData = process.env["APPDATA"];
-    if (appData)
-      candidates.push(join25(appData, "opencode", "codeforge", "index.js"));
-    const localAppData = process.env["LOCALAPPDATA"];
-    if (localAppData)
-      candidates.push(join25(localAppData, "opencode", "codeforge", "index.js"));
-  }
-  for (const c of candidates) {
-    if (existsSync6(c))
-      return c;
-  }
-  return candidates[0] ?? null;
-}
-async function fallbackToGitHubReleases(ctx, u) {
-  await safeAsync(PLUGIN_NAME20, "github_fallback", async () => {
-    const result = await checkUpdateOnce({
-      repo: u.repo,
-      intervalMs: u.interval_hours * 3600 * 1000
-    });
-    await reportLegacyResult(ctx, result, u.repo);
-  });
-}
-async function reportLegacyResult(ctx, result, repo) {
-  if (result.error && !result.fromCache) {
-    safeWriteLog(PLUGIN_NAME20, {
-      level: "warn",
-      msg: `update check failed: ${result.error}`,
-      ...result
-    });
-    return;
-  }
-  if (!result.hasUpdate) {
-    safeWriteLog(PLUGIN_NAME20, {
-      level: "info",
-      msg: `up-to-date (local=${result.local}, remote=${result.remote}${result.fromCache ? ", from_cache" : ""})`,
-      ...result
-    });
-    return;
-  }
-  const updateCmd = `bunx --bun github:${repo} install`;
-  const toast = `[CodeForge] 有新版本：${result.local} → ${result.remote}
-  更新命令：${updateCmd}`;
-  safeWriteLog(PLUGIN_NAME20, {
-    level: "info",
-    msg: "new_version_available_github_fallback",
-    local: result.local,
-    remote: result.remote,
-    update_command: updateCmd,
-    fromCache: result.fromCache
-  });
-  await postToast(ctx, toast);
-}
 async function postToast(ctx, message) {
   await safeAsync(PLUGIN_NAME20, "client.app.log", async () => {
-    await ctx.client.app.log({
-      body: {
-        service: PLUGIN_NAME20,
-        level: "info",
-        message
-      }
-    });
+    await ctx.client.app.log({ body: { service: PLUGIN_NAME20, level: "info", message } });
   });
 }
 var handler20 = updateCheckerServer;

package/install.mjs

@@ -103,7 +103,6 @@ function parseArgs(argv) {
     action: "install",
     dryRun: false,
     skipBuild: false,
-    enableLegacyTools: false,
     verbose: false,
     help: false,
     global: false,
@@ -116,22 +115,11 @@ function parseArgs(argv) {
       case "--uninstall": out.action = "uninstall"; break
       case "--dry-run": out.dryRun = true; break
       case "--skip-build": out.skipBuild = true; break
-      case "--enable-legacy-tools": out.enableLegacyTools = true; break
       case "--verbose": out.verbose = true; break
       case "-h":
       case "--help": out.help = true; break
       default:
-        // 容忍 PS 风格 flag（来自旧 bin 调用），静默忽略未知，避免炸
-        if (a.startsWith("-")) {
-          // 兼容 -Global/-DryRun/-Uninstall/-SkipBuild/-EnableLegacyTools
-          const low = a.toLowerCase()
-          if (low === "-global") out.mode = "global"
-          else if (low === "-uninstall") out.action = "uninstall"
-          else if (low === "-dryrun") out.dryRun = true
-          else if (low === "-skipbuild") out.skipBuild = true
-          else if (low === "-enablelegacytools") out.enableLegacyTools = true
-          else if (low === "-verbose") out.verbose = true
-        }
+        // 未知参数静默忽略
         break
     }
   }
@@ -172,7 +160,7 @@ function resolvePaths({ mode }) {
 // v0.1 之前装的目录（卸载时一并清掉）
 const LEGACY_DIRS = ["agent", "command", "tool", "tools", "plugin", "plugins", "lib"]
 // v0.1+ 才有的目录
-const MANAGED_DIRS = ["codeforge", "agents", "commands", "workflows", "context-templates", "review-profiles", "agent-templates"]
+const MANAGED_DIRS = ["codeforge", "agents", "commands", "workflows", "review-profiles", "agent-templates"]
 // 细粒度卸载：只删 CodeForge 自己的 skill
 const OWNED_SKILLS = ["ambiguity-gate", "devils-advocate", "ears-zh", "example-mapping", "success-criteria", "weighted-dimensions"]
 
@@ -188,7 +176,6 @@ const MD_MANIFEST_REL = "codeforge/installed-md-manifest.json"
 // 整目录拷贝
 const COPY_DIRS = [
   ["workflows", "workflows"],
-  ["context-templates", "context-templates"],
   ["review-profiles", "review-profiles"],
   ["agent-templates", "agent-templates"],
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andyqiu/codeforge",
-  "version": "0.6.13",
+  "version": "0.7.0",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,
@@ -48,16 +48,7 @@
     "bench:json": "node --experimental-strip-types --no-warnings ./scripts/bench-repo-map.mjs --json",
     "lint": "tsc --noEmit",
     "check:bun": "node ./scripts/check-bun.mjs",
-    "install:local": "node ./install.mjs",
-    "install:global": "node ./install.mjs --global",
-    "uninstall:local": "node ./install.mjs --uninstall",
-    "phase0:check": "node ./scripts/phase0-check.mjs",
     "phase1:check": "node ./scripts/check-dist-built.mjs && node ./scripts/check-layer-deps.mjs && node ./scripts/phase1-check.mjs",
-    "phase15:check": "node ./scripts/phase15-check.mjs",
-    "v13:check": "node ./scripts/v13-check.mjs",
-    "phase2:check": "node ./scripts/phase2-check.mjs",
-    "phase3:check": "node ./scripts/phase3-check.mjs",
-    "phase4:check": "node ./scripts/phase4-check.mjs",
     "adr-check": "node ./scripts/adr-check.mjs",
     "adr-check:strict": "cross-env ADR_STRICT=1 node ./scripts/adr-check.mjs",
     "adr-index-sync": "node ./scripts/adr-index-sync.mjs",
@@ -65,7 +56,6 @@
     "adr-graph": "node ./scripts/adr-graph-gen.mjs",
     "adr-graph-check": "node ./scripts/adr-graph-gen.mjs --check",
     "adr-init": "node ./bin/codeforge.mjs adr-init",
-    "phases:all": "npm run phase0:check && npm run phase1:check && npm run phase15:check && npm run phase2:check && npm run phase3:check && npm run phase4:check",
     "sync:models": "node ./scripts/sync-agent-models.mjs",
     "sync:models:check": "node ./scripts/sync-agent-models.mjs --check",
     "sync": "node ./scripts/sync-agent-models.mjs && node ./scripts/dev-sync.mjs --sync-only",
@@ -115,7 +105,6 @@
     "bin/",
     "commands/",
     "workflows/",
-    "context-templates/",
     "skills/",
     "review-profiles/",
     "scripts/check-bun.mjs",

package/workflows/feature-dev.yaml

@@ -24,9 +24,6 @@ description: |
 
 trigger: /ship
 
-# 可选：会话开始注入的上下文模板（context-templates/<name>）
-# context_template: feature-dev
-
 steps:
   - name: 规划
     agent: planner