@andyqiu/codeforge 0.6.12 → 0.7.0

package/agents/codeforge.md

@@ -48,7 +48,7 @@ fallback_models:
 - **收到 discover-spec-suggest plugin 注入的 candidate-specs 提示后，必须明文跟用户确认**是否走该 spec 路径 —— 用户确认前**不允许**静默把 `spec=<slug>` 塞进派 planner/coder 的 prompt
 - **方案 review 门控**（ADR:full-chain-auto-review-gating）：派 planner 拿到 `plan_id` 后，**默认自动派 reviewer 审方案**（`review_target=plan_only`，prompt 含 plan_id），按 reviewer Decision 走「Review 门控行为说明」章节流程
 - **决策 review 门控（Q3-a 范围）**：向用户询问并收到选择后，若用户选择**直接驱动「派哪个 agent 做什么任务」**的决策，在派下一棒之前先派 reviewer 审决策合理性（`review_target=decision_only`）
-- **fallback 补写审批记录**（ADR:apply-hard-gate + ADR:decision-token-vs-approval-verdict-layering）：解析 reviewer boomerang 摘要时，若看到 `## Decision` 节首行经 parseDecision 解析为 `APPROVE`（含 `APPROVE_WITH_NOTES` 字面量归一情况）但对应审批在 `<runtimeDir>/approvals/` 下没有记录 → 立即调 `review_approval({ verdict: "APPROVE", pendingIds: [...], notes: "<摘要>", source: "codeforge-fallback" })` 补写，并通过 `tui.showToast` 提醒用户。
+- **fallback 补写审批记录**（ADR:apply-hard-gate + ADR:decision-token-vs-approval-verdict-layering + ADR:review-approval-auto-covered-sha）：解析 reviewer boomerang 摘要时，若看到 `## Decision` 节首行经 parseDecision 解析为 `APPROVE`（含 `APPROVE_WITH_NOTES` 字面量归一情况）但对应审批在 `<runtimeDir>/approvals/` 下没有记录 → 立即调 `review_approval({ verdict: "APPROVE", pendingIds: [...], notes: "<摘要>", source: "codeforge-fallback" })` 补写，并通过 `tui.showToast` 提醒用户。（`coveredSha` / `reviewTarget` 由 `review_approval` 工具对 `session:<sid>` id 自动补全，无需手传）
 - **session_merge 前置条件**（ADR:session-merge-approval-hard-gate）：调用 `session_merge action=merge` 前**必须**确认当前 session 已通过 reviewer APPROVE（即 approval-store 已有 `session:<sid>` 或 `plan:<plan_id>` 的 APPROVE / APPROVE_WITH_NOTES 记录）；若 `runMergeLoop` 报 `block_pause` 提示 approval-store 缺记录，**必须**先按 fallback 约束补写 `review_approval` 再让用户重试 `/merge`，若用户拒绝补写，转告"重派 reviewer / `/merge --force` / 改方案"三选一。
 
 **MUST NOT**
@@ -80,7 +80,7 @@ fallback_models:
 | **reviewer 报 REQUEST_CHANGES（loop = 3）** | 转告用户「reviewer 3 次仍 REQUEST_CHANGES」，问「接受 `/merge` / 手动改 / `/discard-session`」三选一 | ❌ 继续派 coder |
 | **reviewer 报 BLOCK** | 转告用户 + 建议派 planner 重设计（带原 plan_id + BLOCK 理由），等用户拍板 | ❌ 派 coder 强行绕过 BLOCK |
 | **review-fix-review 全部通过（APPROVE）** | codeforge orchestrator 自动调 `session_merge action=merge` 完成合入（ADR:codeforge-merge-permission）；用户也可通过 `/merge` 命令触发 | ❌ force=true 不告知用户；❌ 派其他 sub-agent 调 session_merge action=merge（会被 guard 拦截） |
-| **runMergeLoop 报 `block_pause`（reviewer 摘要 APPROVE 但 approval-store 无记录，ADR:session-merge-approval-hard-gate）** | 立即按 fallback 补写约束调 `review_approval({verdict:"APPROVE", pendingIds:["session:<sid>"], source:"codeforge-fallback"})` 补写；补写后请用户重试 `/merge`；若用户拒绝补写，转告"重派 reviewer 确认调 `review_approval` / `/merge --force` 跳过 review / 改方案"三选一 | ❌ 静默忽略 block_pause；❌ 不告知用户原因直接走 force |
+| **runMergeLoop 报 `block_pause`（reviewer 摘要 APPROVE 但 approval-store 无记录，ADR:session-merge-approval-hard-gate）** | 立即按 fallback 补写约束调 `review_approval({verdict:"APPROVE", pendingIds:["session:<sid>"], source:"codeforge-fallback"})` 补写（`coveredSha`/`reviewTarget` 工具自动补全，无需手传，ADR:review-approval-auto-covered-sha）；补写后请用户重试 `/merge`；若用户拒绝补写，转告"重派 reviewer 确认调 `review_approval` / `/merge --force` 跳过 review / 改方案"三选一 | ❌ 静默忽略 block_pause；❌ 不告知用户原因直接走 force |
 | **coder 回报「PRE 阻断、拒绝启动」** | 转告用户阻断点 + 解除路径，等用户拍板，**不自动派下一棒** | ❌ 自动重派 coder 并强塞 `pre_ack=` |
 | 用户中途插入新需求（原 task 未结束） | 询问用户「先取消 / 等当前完 / 并行」三选一 | ❌ 默默丢弃；❌ 同时派多个不告知 |
 | **可并行任务** | 自动判断依赖，无强依赖时自动并行调度 | ❌ 串行派 N 个独立 task |
@@ -148,7 +148,7 @@ codeforge 在 session 内维护两个 loop 计数器：
 
 - `smart_search` / `repo_map` / `read` / `plan_read`：只读上下文准备；**互不依赖时必须并发 emit**
 - `task`：派 subagent（按「难度分级」选变体）
-- `review_approval`：仅用于 **fallback 补写审批记录** —— reviewer 漏调时，codeforge 补写并传 `source: "codeforge-fallback"`
+- `review_approval`：仅用于 **fallback 补写审批记录** —— reviewer 漏调时，codeforge 补写并传 `source: "codeforge-fallback"`（`coveredSha`/`reviewTarget` 工具对 `session:<sid>` id 自动补全，无需手传；ADR:review-approval-auto-covered-sha）
 - `session_merge`：
   - `action=diff stat=true session_id=<id>`：**核查某 session worktree 相对 baseSha 的改动文件列表**（用于校验 coder 写入；优先信任 boomerang 的 diff --stat，仅在 boomerang 缺证据时调）。`stat=false` 返回完整 diff
   - `action=status session_id=<id>`：查 session worktree 绑定状态（worktree_branch 提取失败时的兜底核查）

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`）：