@andyqiu/codeforge 0.6.5 → 0.6.7

package/install.mjs

@@ -492,15 +492,33 @@ function installMdDirs({ targetRoot }) {
     const pruned = pruneStale({ dstPath, prevList, sourceSet })
 
     // 步骤 4：upsert —— 把 sourceSet 文件复制到目标（覆盖同名，不动其他文件）
+    // ADR:install-manifest-actual-copied-consistency —— manifest 记录实际落盘（事实），非源扫描意图
     let count = 0
-    for (const base of sourceFiles) {
-      const f = path.join(srcPath, base)
-      run(`cp ${f} ${dstPath}/`, () => fs.copyFileSync(f, path.join(dstPath, base)))
-      count++
+    const copiedOk = []  // 仅含 post-copy existsSync 复核通过的文件名
+    if (!DRY_RUN) {
+      // 真实 copy：收集 copiedOk，逐文件复核，复核失败 fail-loud
+      for (const base of sourceFiles) {
+        const src = path.join(srcPath, base)
+        const dst = path.join(dstPath, base)
+        fs.copyFileSync(src, dst)
+        if (!fs.existsSync(dst)) {
+          // copy 后文件仍不存在：可能是 FS 异常（NFS/虚拟 FS 等），fail-loud
+          throw new Error(`copy 后文件不存在（existsSync 复核失败）：${dst}`)
+        }
+        copiedOk.push(base)
+        count++
+      }
+    } else {
+      // DRY_RUN：run() 已 vlog，不执行 copy，copiedOk 保持空（dry-run 不落盘）
+      for (const base of sourceFiles) {
+        vlog(`[dry-run] cp ${path.join(srcPath, base)} ${dstPath}/`)
+        count++
+      }
     }
 
-    // 步骤 5：新 manifest = sourceSet（本版实际安装的文件名）
-    nextManifest[dstName] = [...sourceFiles]
+    // 步骤 5：新 manifest = copiedOk（实际落盘文件，非 sourceFiles 意图）
+    // DRY_RUN 下 copiedOk 为空，由 run() 包裹的 writeMdManifest 负责 vlog 不落盘
+    nextManifest[dstName] = DRY_RUN ? [...sourceFiles] : copiedOk
 
     vok(`${srcName}/ → ${dstPath}  (${count} 个 .md upsert, ${pruned} 个过期清理, 第三方文件保留)`)
   }
@@ -551,6 +569,77 @@ function writeMdManifest(targetRoot, data) {
   atomicWriteJson(p, data)
 }
 
+// compareManifestVsDisk：三方比对（manifest / disk / source）
+// ADR:codeforge-doctor-command — doctor 与 install 共享的纯函数
+// 返回：
+//   missing[]   = manifest 登记但 disk 无（来源2：外部腐蚀）
+//   unmanaged[] = source 有（经 shouldCopyMd 过滤）但 disk 无（来源1/2：未安装 / 被删）
+//   stale[]     = disk 有 & source 有 但 manifest 无（manifest 失配，可能未更新）
+// 第三方文件（disk 有但不在 manifest 也不在 source）→ 不纳入任何桶（静默跳过）
+function compareManifestVsDisk({ targetRoot, sourceRoot }) {
+  const manifest = readMdManifest(targetRoot)
+  const missing = []
+  const unmanaged = []
+  const stale = []
+
+  for (const [srcName, dstName] of MD_COPY_DIRS) {
+    const srcPath = path.join(sourceRoot, srcName)
+    const dstPath = path.join(targetRoot, dstName)
+
+    // source 扫描（经 shouldCopyMd 过滤）
+    const sourceFiles = new Set()
+    try {
+      const entries = fs.readdirSync(srcPath)
+      for (const base of entries) {
+        if (!shouldCopyMd(base)) continue
+        try { if (!fs.statSync(path.join(srcPath, base)).isFile()) continue } catch { continue }
+        sourceFiles.add(base)
+      }
+    } catch {
+      // 源目录不存在（发布包未含该目录）→ sourceFiles 为空，正常走后续逻辑
+    }
+
+    // manifest 登记列表
+    const manifestList = manifest[dstName] ?? []
+    const manifestSet = new Set(manifestList)
+
+    // disk 实际文件（目录不存在时视为空）
+    const diskSet = new Set()
+    try {
+      const diskEntries = fs.readdirSync(dstPath)
+      for (const base of diskEntries) {
+        try { if (!fs.statSync(path.join(dstPath, base)).isFile()) continue } catch { continue }
+        diskSet.add(base)
+      }
+    } catch {
+      // 目录不存在 → diskSet 为空
+    }
+
+    // D1：manifest 登记但 disk 无
+    for (const base of manifestList) {
+      if (!diskSet.has(base)) {
+        missing.push({ dir: dstName, file: base })
+      }
+    }
+
+    // D2：source 有但 disk 无（未安装或被删）
+    for (const base of sourceFiles) {
+      if (!diskSet.has(base)) {
+        unmanaged.push({ dir: dstName, file: base })
+      }
+    }
+
+    // D3：disk 有 & source 有 但 manifest 无（manifest 失配）
+    for (const base of diskSet) {
+      if (sourceFiles.has(base) && !manifestSet.has(base)) {
+        stale.push({ dir: dstName, file: base })
+      }
+    }
+  }
+
+  return { missing, unmanaged, stale }
+}
+
 // 差集清理：prevList − sourceSet，仅删目标目录里确实存在的文件。返回清理计数。
 // 第三方文件（如 teamkit-git.md）从不写入 manifest → 不在 prevList → 永不被删。
 function pruneStale({ dstPath, prevList, sourceSet }) {
@@ -826,6 +915,8 @@ export {
   readMdManifest,
   writeMdManifest,
   MD_MANIFEST_REL,
+  compareManifestVsDisk,
+  MD_COPY_DIRS,
 }
 
 // main 守卫：仅作为脚本直接运行时执行

package/package.json

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