@curdx/flow 2.0.17 → 2.0.19

package/cli/lib/doctor-report.js

@@ -0,0 +1,189 @@
+import { BUNDLED_MCPS, REQUIRED_PLUGINS, RECOMMENDED_PLUGINS } from "../registry.js";
+import {
+  findDuplicateMcps,
+  findPluginByRegistryEntry,
+  hasMarketplace,
+} from "./claude.js";
+
+export function buildDoctorReport({
+  claudeVersionValue,
+  nodeVersion,
+  plugins = [],
+  marketplaces = [],
+  mcps = [],
+  userMcpConfig,
+  runtimeStatus,
+  cwd,
+  projectState,
+}) {
+  const lines = [];
+  const sections = [];
+  let errors = 0;
+  let warnings = 0;
+
+  const pushLine = (target, level, text, details = []) => {
+    target.push({ level, text, details });
+    if (level === "err") errors++;
+    if (level === "warn") warnings++;
+  };
+  const pushSectionLine = (section, level, text, details = []) => {
+    pushLine(section.lines, level, text, details);
+  };
+  const createSection = (title) => {
+    const section = { title, lines: [] };
+    sections.push(section);
+    return section;
+  };
+
+  if (claudeVersionValue) {
+    pushLine(lines, "ok", `claude CLI            ${claudeVersionValue}`);
+  } else {
+    pushLine(lines, "err", "claude CLI            not found (install Claude Code)");
+  }
+  pushLine(lines, "ok", `Node                  ${nodeVersion}`);
+
+  const curdx = plugins.find((plugin) => plugin.name === "curdx-flow");
+  if (curdx) {
+    if (curdx.status === "enabled") {
+      pushLine(lines, "ok", `curdx-flow            v${curdx.version} (enabled)`);
+    } else {
+      pushLine(lines, "err", `curdx-flow            v${curdx.version} (${curdx.status})`);
+    }
+  } else {
+    pushLine(lines, "warn", "curdx-flow            not installed → run curdx-flow install");
+  }
+
+  const requiredSection = createSection("Required plugins:");
+  for (const entry of REQUIRED_PLUGINS) {
+    const plugin = findPluginByRegistryEntry(plugins, entry);
+    if (!hasMarketplace(marketplaces, entry)) {
+      pushSectionLine(
+        requiredSection,
+        "warn",
+        `${entry.marketplaceId.padEnd(22)} marketplace missing`,
+        [`run: claude plugin marketplace add --scope ${entry.scope} ${entry.marketplaceSource}`]
+      );
+    }
+    if (plugin && plugin.status === "enabled") {
+      pushSectionLine(requiredSection, "ok", `${entry.name.padEnd(22)} v${plugin.version || "unknown"}`);
+    } else if (plugin && plugin.status === "failed") {
+      pushSectionLine(requiredSection, "err", `${entry.name.padEnd(22)} load failed`);
+    } else {
+      pushSectionLine(
+        requiredSection,
+        "warn",
+        `${entry.name.padEnd(22)} not installed`,
+        [`run: claude plugin install --scope ${entry.scope} ${entry.installSpec}`]
+      );
+    }
+  }
+
+  const mcpSection = createSection("MCP Servers (required by L2 mandatory tools):");
+  for (const expected of BUNDLED_MCPS) {
+    const userLevel = mcps.find((entry) => entry.name === expected.name && entry.plugin === null);
+    const pluginLevel = mcps.find((entry) => entry.name === expected.name && entry.plugin !== null);
+
+    if (userLevel) {
+      pushSectionLine(mcpSection, "ok", `${expected.name.padEnd(22)} user-level (standard)`);
+    } else if (pluginLevel) {
+      pushSectionLine(
+        mcpSection,
+        "warn",
+        `${expected.name.padEnd(22)} registered via plugin:${pluginLevel.plugin} (legacy)`,
+        ["run: npx @curdx/flow install --all"]
+      );
+    } else if (curdx) {
+      pushSectionLine(
+        mcpSection,
+        "warn",
+        `${expected.name.padEnd(22)} missing`,
+        [`run: claude mcp add --scope user ${expected.name} -- ${expected.command} ${expected.args.join(" ")}`]
+      );
+    } else {
+      pushSectionLine(mcpSection, "info", `${expected.name.padEnd(22)} waiting for curdx-flow install`);
+    }
+  }
+
+  const recommendedSection = createSection("Recommended plugins:");
+  let claudeMemEnabled = false;
+  for (const entry of RECOMMENDED_PLUGINS) {
+    const plugin = findPluginByRegistryEntry(plugins, entry);
+    if (!hasMarketplace(marketplaces, entry)) {
+      pushSectionLine(
+        recommendedSection,
+        "warn",
+        `${entry.marketplaceId.padEnd(22)} marketplace missing`,
+        [`run: claude plugin marketplace add --scope ${entry.scope} ${entry.marketplaceSource}`]
+      );
+    }
+    if (plugin && plugin.status === "enabled") {
+      pushSectionLine(recommendedSection, "ok", `${entry.name.padEnd(22)} v${plugin.version}`);
+      if (entry.postInstall === "claude-mem-runtimes") claudeMemEnabled = true;
+    } else if (plugin && plugin.status === "failed") {
+      pushSectionLine(recommendedSection, "err", `${entry.name.padEnd(22)} load failed`);
+    } else {
+      pushSectionLine(
+        recommendedSection,
+        "warn",
+        `${entry.name.padEnd(22)} not installed`,
+        [`run: claude plugin install --scope ${entry.scope} ${entry.installSpec}`]
+      );
+    }
+  }
+
+  const duplicates = findDuplicateMcps(mcps, userMcpConfig);
+  if (duplicates.length > 0) {
+    const duplicateSection = createSection("Legacy plugin-bundled MCPs still present:");
+    for (const duplicate of duplicates) {
+      pushSectionLine(
+        duplicateSection,
+        "warn",
+        `${duplicate.name.padEnd(22)} both user-level AND plugin:${duplicate.pluginEntry.plugin} active`,
+        [
+          "migration: claude plugin update curdx-flow@curdx-flow-marketplace",
+          "then restart Claude Code",
+        ]
+      );
+    }
+  }
+
+  if (claudeMemEnabled && runtimeStatus) {
+    const runtimeSection = createSection("Runtime (claude-mem dependencies):");
+    for (const [name, status] of Object.entries(runtimeStatus)) {
+      if (status.status === "ok") {
+        pushSectionLine(runtimeSection, "ok", `${name.padEnd(22)} visible on PATH`);
+      } else if (status.status === "linked") {
+        pushSectionLine(runtimeSection, "ok", `${name.padEnd(22)} auto-linked ${status.link} → ${status.path}`);
+      } else if (status.status === "missing") {
+        pushSectionLine(
+          runtimeSection,
+          "warn",
+          `${name.padEnd(22)} not installed`,
+          ["claude-mem will auto-install on next Claude Code session"]
+        );
+      } else if (status.status === "path-unwritable") {
+        const dir = status.path.split("/").slice(0, -1).join("/");
+        pushSectionLine(
+          runtimeSection,
+          "err",
+          `${name.padEnd(22)} installed but not on PATH`,
+          [`add export PATH="${dir}:$PATH" to your shell rc`]
+        );
+      }
+    }
+  }
+
+  const localProjectSection = createSection("Local project:");
+  if (projectState?.exists) {
+    pushSectionLine(localProjectSection, "ok", `.flow/                ${cwd}`);
+    if (projectState.activeSpec) {
+      pushSectionLine(localProjectSection, "info", `Active spec           ${projectState.activeSpec}`);
+    } else {
+      pushSectionLine(localProjectSection, "info", "Active spec           (none)");
+    }
+  } else {
+    pushSectionLine(localProjectSection, "info", ".flow/                not a curdx-flow project (run: curdx-flow init)");
+  }
+
+  return { lines, sections, errors, warnings };
+}