@andyqiu/codeforge 0.6.4 → 0.6.5

package/dist/index.js

@@ -19760,7 +19760,7 @@ import * as zlib from "node:zlib";
 // lib/version-injected.ts
 function getInjectedVersion() {
   try {
-    const v = "0.6.4";
+    const v = "0.6.5";
     if (typeof v === "string" && /^\d+\.\d+\.\d+/.test(v)) {
       return v;
     }

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.4",
+  "version": "0.6.5",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,