@andyqiu/codeforge 0.8.2 → 0.8.3

package/bin/codeforge-doctor.mjs

@@ -77,10 +77,12 @@ function resolveTarget(args) {
 // 参数解析
 // ────────────────────────────────────────────────────────────────────
 function parseArgs(argv) {
-  const args = { project: false, help: false }
+  const args = { project: false, help: false, runtime: false }
   for (const a of argv) {
     if (a === "--project" || a === "-p") args.project = true
     if (a === "--help" || a === "-h") args.help = true
+    // ADR:zero-command-worktree-convergence Amendment (2026-06-12) Phase 6c —— runtime 健康度段
+    if (a === "--runtime" || a === "-r") args.runtime = true
   }
   return args
 }
@@ -97,12 +99,14 @@ if (args.help) {
 用法：
   codeforge doctor             # 检查 global (~/.config/opencode)
   codeforge doctor --project   # 检查 project (<cwd>/.opencode)
+  codeforge doctor --runtime   # 额外检查当前项目的 worktree 运行时健康度
 
 检查项：
   D1  manifest 登记但 disk 缺失 → ✗（建议跑 codeforge install）
   D2  source 有但 disk 缺失     → ✗（建议跑 codeforge install）
   D3  disk∩source 但 manifest 无 → ⚠（manifest 可能未更新）
   第三方 .md 文件（不在 manifest 也不在 source）→ 静默跳过
+  --runtime  worktree 健康度（追踪文件 / 超期 worktree / 待审 / 留痕 等 8 类信号，带下一步提示）
 
 exit code：有 ✗ → 1，仅 ⚠ → 0，全绿 → 0`)
   process.exit(0)
@@ -184,4 +188,40 @@ if (!hasErrors && stale.length === 0) {
   }
 }
 
+// ────────────────────────────────────────────────────────────────────
+// --runtime：worktree 运行时健康度（ADR:zero-command-worktree-convergence Phase 6c）
+//
+// 经 dist bundle 动态 import collectHealthDigest（dist 不存在 = 未 build → 优雅降级提示，
+// 不阻断既有安装检查结果）。健康度查询只读，绝不 mutate。
+// ────────────────────────────────────────────────────────────────────
+if (args.runtime) {
+  console.log()
+  console.log(`${C.bold}runtime 健康度${C.reset}（当前项目 worktree）`)
+  const distIndex = path.join(REPO_ROOT, "dist", "index.js")
+  if (!existsSync(distIndex)) {
+    console.log(`  ${C.yellow}⚠${C.reset}  dist 未构建（${shortenHome(distIndex)} 不存在），跳过 runtime 检查`)
+    console.log(`  建议：跑 ${C.bold}npm run build${C.reset} 后重试`)
+  } else {
+    try {
+      const { collectHealthDigest } = await import(url.pathToFileURL(distIndex).href)
+      if (typeof collectHealthDigest !== "function") {
+        console.log(`  ${C.yellow}⚠${C.reset}  当前 dist 版本不含 collectHealthDigest（旧版本？），请重新 build`)
+      } else {
+        const digest = await collectHealthDigest(process.cwd())
+        if (!digest || !digest.hasIssues) {
+          console.log(`  ${C.green}✓${C.reset} worktree 运行时健康，无需操作`)
+        } else {
+          for (const sig of digest.signals) {
+            const icon = sig.informational ? `${C.dim}ℹ${C.reset}` : `${C.yellow}⚠${C.reset}`
+            console.log(`  ${icon}  ${sig.nextStep}`)
+          }
+        }
+      }
+    } catch (e) {
+      console.log(`  ${C.yellow}⚠${C.reset}  runtime 健康度采集失败：${e?.message ?? e}`)
+      console.log(`  ${C.dim}（不影响上方安装检查结果）${C.reset}`)
+    }
+  }
+}
+
 process.exit(hasErrors ? 1 : 0)