@andyqiu/codeforge 0.6.3 → 0.6.5

package/codeforge.json

@@ -154,7 +154,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。",
     "auto_check_enabled": true,
-    "interval_hours": 24,
+    "interval_hours": 6,
     "package": "@andyqiu/codeforge",
     "registry": "https://registry.npmjs.org",
     "channel": "latest",

package/dist/index.js

@@ -19732,9 +19732,10 @@ var toolPolicyServer = async (ctx) => {
 var handler19 = toolPolicyServer;
 
 // plugins/update-checker.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync6, rmSync } from "node:fs";
 import { homedir as homedir8 } from "node:os";
 import { join as join23 } from "node:path";
+import { spawnSync as spawnSync2 } from "node:child_process";
 
 // lib/update-checker-impl.ts
 import { createHash as createHash4 } from "node:crypto";
@@ -19759,7 +19760,7 @@ import * as zlib from "node:zlib";
 // lib/version-injected.ts
 function getInjectedVersion() {
   try {
-    const v = "0.6.3";
+    const v = "0.6.5";
     if (typeof v === "string" && /^\d+\.\d+\.\d+/.test(v)) {
       return v;
     }
@@ -20371,7 +20372,7 @@ var updateCheckerServer = async (ctx) => {
    更新命令：npx ${u.package} install --global`);
         return;
       }
-      await safeAsync(PLUGIN_NAME20, "auto_install_bundle", async () => {
+      await safeAsync(PLUGIN_NAME20, "auto_install_full", async () => {
         const target = getOpencodeBundlePath();
         if (!target) {
           safeWriteLog(PLUGIN_NAME20, {
@@ -20383,27 +20384,66 @@ var updateCheckerServer = async (ctx) => {
    自动安装失败：找不到 bundle，请手动 npx ${u.package} install`);
           return;
         }
-        const { bundlePath } = await downloadAndExtractBundle({
+        const { bundlePath, extractDir } = await downloadAndExtractBundle({
           tarballUrl: npmResult.tarballUrl,
           expectedIntegrity: npmResult.integrity
         });
-        const { backupPath, strategy } = atomicReplaceBundle({
-          source: bundlePath,
-          target,
-          oldVersion: local,
-          keepBackups: u.backup_keep
-        });
-        safeWriteLog(PLUGIN_NAME20, {
-          level: "info",
-          msg: "auto_install_success",
-          local,
-          remote: npmResult.version,
-          target,
-          backupPath,
-          strategy
-        });
-        await postToast(ctx, `[CodeForge] ✅ 已更新 ${local} → ${npmResult.version}（重启 opencode 生效）
+        try {
+          const installMjs = join23(extractDir, "package", "install.mjs");
+          if (existsSync6(installMjs)) {
+            const r = spawnSync2(process.execPath, [installMjs, "--global", "--skip-build"], {
+              cwd: join23(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",
+              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 {}
+        }
       });
     });
   });

package/install.mjs

@@ -176,8 +176,15 @@ const MANAGED_DIRS = ["codeforge", "agents", "commands", "workflows", "context-t
 // 细粒度卸载：只删 CodeForge 自己的 skill
 const OWNED_SKILLS = ["ambiguity-gate", "devils-advocate", "ears-zh", "example-mapping", "success-criteria", "weighted-dimensions"]
 
-// 文件级 copy（.md，排除 README/_*/.bak/隐藏）
+// 文件级 copy（.md，排除 README/_*/.bak/隐藏）— per-file upsert + manifest 差集清理，不 rmrf 整目录
+// ADR:install-whitelist-md-files
 const MD_COPY_DIRS = [["agents", "agents"], ["commands", "commands"]]
+
+// codeforge 自维护的 .md 安装清单：记录"上一版 codeforge 在各目标目录装了哪些 .md"。
+// 用途：install 时算差集（manifest − 本次源）精准清理本版已删除的旧 codeforge 文件，
+//       第三方 .md（如 teamkit-git.md）从不写入 manifest → 永不被清理（零副作用）。
+// 位置在 codeforge/ 子目录下，uninstall 的 rmrf(codeforge/) 会自然清掉，无需额外卸载逻辑。
+const MD_MANIFEST_REL = "codeforge/installed-md-manifest.json"
 // 整目录拷贝
 const COPY_DIRS = [
   ["workflows", "workflows"],
@@ -450,31 +457,57 @@ function installBundle({ targetRoot, bundleSrc }) {
   vok(`VERSION → ${versionFile} (${version})`)
 }
 
+// ADR:install-whitelist-md-files —— manifest 自维护：不再 rmrf 整目录，
+// 读 manifest 算差集精准清理旧 codeforge .md，第三方 .md 零副作用。
 function installMdDirs({ targetRoot }) {
+  // 步骤 1：读上一版 manifest（不存在 → 各目录空列表 = 首次安装）
+  const prevManifest = readMdManifest(targetRoot)
+  const nextManifest = {}
+
   for (const [srcName, dstName] of MD_COPY_DIRS) {
     const srcPath = path.join(SOURCE_ROOT, srcName)
     const dstPath = path.join(targetRoot, dstName)
     if (!fs.existsSync(srcPath) || !fs.statSync(srcPath).isDirectory()) {
       vlog(`源目录不存在，跳过: ${srcPath}`)
+      // 源目录缺失：本版该目录装 0 个文件，manifest 记空（差集会清掉上一版全部该目录文件）
+      nextManifest[dstName] = []
+      const prevList = prevManifest[dstName] ?? []
+      pruneStale({ dstPath, prevList, sourceSet: new Set() })
       continue
     }
-    if (fs.existsSync(dstPath) || isSymlink(dstPath)) rmrf(dstPath)
-    ensureDir(dstPath)
-    let count = 0
-    const entries = DRY_RUN ? safeReaddir(srcPath) : fs.readdirSync(srcPath)
-    for (const base of entries) {
+    ensureDir(dstPath) // 不再 rmrf；幂等建目录
+
+    // 步骤 2：扫源目录 → sourceSet（本版要装的文件名集合）
+    const sourceFiles = []
+    const srcEntries = fs.readdirSync(srcPath)
+    for (const base of srcEntries) {
       if (!shouldCopyMd(base)) continue
+      try { if (!fs.statSync(path.join(srcPath, base)).isFile()) continue } catch { continue }
+      sourceFiles.push(base)
+    }
+    const sourceSet = new Set(sourceFiles)
+
+    // 步骤 3：差集清理 prevManifest[dir] − sourceSet（仅删确实存在的）
+    const prevList = prevManifest[dstName] ?? []
+    const pruned = pruneStale({ dstPath, prevList, sourceSet })
+
+    // 步骤 4：upsert —— 把 sourceSet 文件复制到目标（覆盖同名，不动其他文件）
+    let count = 0
+    for (const base of sourceFiles) {
       const f = path.join(srcPath, base)
-      try {
-        if (!fs.statSync(f).isFile()) continue
-      } catch {
-        continue
-      }
       run(`cp ${f} ${dstPath}/`, () => fs.copyFileSync(f, path.join(dstPath, base)))
       count++
     }
-    vok(`${srcName}/ → ${dstPath}  (${count} 个 .md)`)
+
+    // 步骤 5：新 manifest = sourceSet（本版实际安装的文件名）
+    nextManifest[dstName] = [...sourceFiles]
+
+    vok(`${srcName}/ → ${dstPath}  (${count} 个 .md upsert, ${pruned} 个过期清理, 第三方文件保留)`)
   }
+
+  // 步骤 5（落盘）：写新 manifest
+  ensureDir(path.join(targetRoot, "codeforge")) // 幂等，保证父目录存在
+  run(`write md manifest → ${MD_MANIFEST_REL}`, () => writeMdManifest(targetRoot, nextManifest))
 }
 
 function safeReaddir(p) {
@@ -485,6 +518,54 @@ function safeReaddir(p) {
   }
 }
 
+// 读 manifest：不存在 / 解析失败 → 返回各目录空列表（首次安装走此分支）。
+// 返回结构：{ [dstName]: string[] }，含 MD_COPY_DIRS 的所有 dstName 键。
+// 损坏 JSON 保守降级为"首次安装"（差集空 → 不误删）。
+function readMdManifest(targetRoot) {
+  const empty = {}
+  for (const [, dstName] of MD_COPY_DIRS) empty[dstName] = []
+  const p = path.join(targetRoot, MD_MANIFEST_REL)
+  let raw
+  try {
+    raw = fs.readFileSync(p, "utf8")
+  } catch {
+    return empty // 文件不存在 → 首次安装
+  }
+  try {
+    const parsed = JSON.parse(raw)
+    const out = {}
+    for (const [, dstName] of MD_COPY_DIRS) {
+      const v = parsed?.[dstName]
+      out[dstName] = Array.isArray(v) ? v.filter((x) => typeof x === "string") : []
+    }
+    return out
+  } catch {
+    return empty // 损坏的 manifest → 视为首次安装（保守：差集为空，不误删）
+  }
+}
+
+// 写 manifest：atomicWriteJson（同目录 tmp + rename）。data 形如 { agents: [...], commands: [...] }。
+// 调用方需保证 codeforge/ 目录已存在（installBundle 先于 installMdDirs 跑，已建 codeforge/）。
+function writeMdManifest(targetRoot, data) {
+  const p = path.join(targetRoot, MD_MANIFEST_REL)
+  atomicWriteJson(p, data)
+}
+
+// 差集清理：prevList − sourceSet，仅删目标目录里确实存在的文件。返回清理计数。
+// 第三方文件（如 teamkit-git.md）从不写入 manifest → 不在 prevList → 永不被删。
+function pruneStale({ dstPath, prevList, sourceSet }) {
+  let pruned = 0
+  const actual = new Set(safeReaddir(dstPath))
+  for (const base of prevList) {
+    if (sourceSet.has(base)) continue // 本版仍发布 → 保留
+    if (!actual.has(base)) continue   // 目标里已不存在 → 无需删
+    const stale = path.join(dstPath, base)
+    run(`rm ${stale}（过期 codeforge .md）`, () => fs.rmSync(stale, { force: true }))
+    pruned++
+  }
+  return pruned
+}
+
 function installCopyDirs({ targetRoot }) {
   for (const [srcName, dstName] of COPY_DIRS) {
     const srcPath = path.join(SOURCE_ROOT, srcName)
@@ -742,6 +823,9 @@ export {
   LEGACY_DIRS,
   MANAGED_DIRS,
   OWNED_SKILLS,
+  readMdManifest,
+  writeMdManifest,
+  MD_MANIFEST_REL,
 }
 
 // main 守卫：仅作为脚本直接运行时执行

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andyqiu/codeforge",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,