@curdx/flow 2.3.11 → 3.1.0

package/cli/doctor-workflow.js

@@ -1,483 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { removeMcp } from "./lib/claude-ops.js";
-import { readProjectClaudeSettings } from "./lib/doctor-claude-settings.js";
-import { CONFIG_FILE, readConfig, writeConfig } from "./lib/config.js";
-import { inspectRuntimeEnvironment } from "./lib/doctor-runtime-environment.js";
-import {
-  claudeVersion,
-  color,
-  ensureClaudeMemRuntimes,
-  inspectClaudeMemRuntimes,
-  listMcps,
-  listPluginMarketplaces,
-  listPlugins,
-  log,
-  readUserMcpConfig,
-  runSync,
-} from "./utils.js";
-
-export { readProjectClaudeSettings };
-export { inspectRuntimeEnvironment };
-
-const PACKAGE_ROOT = fileURLToPath(new URL("../", import.meta.url));
-export const DOCTOR_JSON_CONTRACT_VERSION = 2;
-export const DOCTOR_SETTINGS_INSPECTION = Object.freeze({
-  pluginOptionScopesInspected: ["managed-file", "user", "project", "local"],
-  pluginOptionScopesNotInspected: ["managed-server", "managed-mdm", "cli"],
-});
-
-export function createDoctorContext(args = []) {
-  return {
-    fix: args.includes("--fix"),
-    json: args.includes("--json"),
-    verbose: args.includes("--verbose") || args.includes("-v"),
-  };
-}
-
-function isUrlLike(value) {
-  return /^[a-z][a-z0-9+.-]*:\/\//i.test(value);
-}
-
-function isWindowsAbsolutePath(value) {
-  return /^[A-Za-z]:[\\/]/.test(value);
-}
-
-function looksLikeRelativePathToken(value) {
-  if (typeof value !== "string") return false;
-  const token = value.trim();
-  if (!token) return false;
-
-  if (token.startsWith("./") || token.startsWith("../")) return true;
-  if (!/[\\/]/.test(token)) return false;
-
-  if (
-    token.startsWith("/") ||
-    token.startsWith("~/") ||
-    token.startsWith("${") ||
-    token.startsWith("@") ||
-    token.startsWith("--") ||
-    isUrlLike(token) ||
-    isWindowsAbsolutePath(token)
-  ) {
-    return false;
-  }
-
-  return (
-    /\.(?:[cm]?js|mjs|ts|tsx|jsx|py|rb|sh|bash|zsh|fish|ps1|cmd|bat|exe)$/i.test(token) ||
-    /(^|[\\/])(?:scripts?|bin|dist|src|tools|vendor|node_modules|venv|\.venv)([\\/]|$)/i.test(token)
-  );
-}
-export async function readProjectMcpConfig(cwd = process.cwd()) {
-  const rootPath = path.join(cwd, ".mcp.json");
-  const misplacedPath = path.join(cwd, ".claude", ".mcp.json");
-
-  const state = {
-    exists: false,
-    misplacedExists: false,
-    invalid: false,
-    parseError: null,
-    shapeError: null,
-    serverCount: 0,
-    relativePathWarnings: [],
-  };
-
-  try {
-    const misplacedStat = await fs.stat(misplacedPath);
-    state.misplacedExists = misplacedStat.isFile();
-  } catch {
-    state.misplacedExists = false;
-  }
-
-  try {
-    const stat = await fs.stat(rootPath);
-    if (!stat.isFile()) return state;
-    state.exists = true;
-  } catch {
-    return state;
-  }
-
-  let parsed;
-  try {
-    parsed = JSON.parse(await fs.readFile(rootPath, "utf-8"));
-  } catch (error) {
-    state.invalid = true;
-    state.parseError = error.message;
-    return state;
-  }
-
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    state.shapeError = "root value must be a JSON object";
-    return state;
-  }
-
-  if (!parsed.mcpServers || typeof parsed.mcpServers !== "object" || Array.isArray(parsed.mcpServers)) {
-    state.shapeError = 'missing top-level "mcpServers" object';
-    return state;
-  }
-
-  state.serverCount = Object.keys(parsed.mcpServers).length;
-
-  for (const [serverName, config] of Object.entries(parsed.mcpServers)) {
-    if (!config || typeof config !== "object" || Array.isArray(config)) continue;
-
-    if (looksLikeRelativePathToken(config.command)) {
-      state.relativePathWarnings.push({
-        serverName,
-        field: "command",
-        value: config.command,
-      });
-    }
-
-    const args = Array.isArray(config.args) ? config.args : [];
-    args.forEach((arg, index) => {
-      if (!looksLikeRelativePathToken(arg)) return;
-      state.relativePathWarnings.push({
-        serverName,
-        field: `args[${index}]`,
-        value: arg,
-      });
-    });
-  }
-
-  return state;
-}
-
-export async function readProjectTeamConfig(cwd = process.cwd()) {
-  const teamConfigPath = path.join(cwd, ".claude", "teams", "teams.json");
-  const state = {
-    exists: false,
-  };
-
-  try {
-    const stat = await fs.stat(teamConfigPath);
-    state.exists = stat.isFile();
-  } catch {
-    state.exists = false;
-  }
-
-  return state;
-}
-
-export async function readBundledPluginRuntimeDefaults(packageRoot = PACKAGE_ROOT) {
-  const pluginSettingsPath = path.join(packageRoot, "settings.json");
-  const pluginManifestPath = path.join(packageRoot, ".claude-plugin", "plugin.json");
-  const monitorsPath = path.join(packageRoot, "monitors", "monitors.json");
-  const packageJsonPath = path.join(packageRoot, "package.json");
-
-  const state = {
-    exists: false,
-    packageVersion: null,
-    pluginVersion: null,
-    sourceRepo: {
-      isGitRepo: false,
-      branch: null,
-      shortSha: null,
-      exactTag: null,
-      dirty: false,
-    },
-    defaultAgent: null,
-    subagentStatusLineCommand: null,
-    monitorCount: 0,
-    monitors: [],
-    userConfig: [],
-  };
-
-  let pluginSettings = null;
-  let pluginManifest = null;
-  let monitors = null;
-
-  try {
-    pluginSettings = JSON.parse(await fs.readFile(pluginSettingsPath, "utf-8"));
-  } catch {
-    pluginSettings = null;
-  }
-
-  try {
-    pluginManifest = JSON.parse(await fs.readFile(pluginManifestPath, "utf-8"));
-  } catch {
-    pluginManifest = null;
-  }
-
-  try {
-    const pkg = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
-    state.packageVersion = typeof pkg?.version === "string" ? pkg.version : null;
-  } catch {
-    state.packageVersion = null;
-  }
-
-  const gitRepoCheck = runSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: packageRoot });
-  if (gitRepoCheck.code === 0 && gitRepoCheck.stdout.trim() === "true") {
-    state.sourceRepo.isGitRepo = true;
-
-    const branch = runSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: packageRoot });
-    if (branch.code === 0) {
-      state.sourceRepo.branch = branch.stdout.trim() || null;
-    }
-
-    const shortSha = runSync("git", ["rev-parse", "--short", "HEAD"], { cwd: packageRoot });
-    if (shortSha.code === 0) {
-      state.sourceRepo.shortSha = shortSha.stdout.trim() || null;
-    }
-
-    const exactTag = runSync("git", ["describe", "--tags", "--exact-match", "HEAD"], { cwd: packageRoot });
-    if (exactTag.code === 0) {
-      state.sourceRepo.exactTag = exactTag.stdout.trim() || null;
-    }
-
-    const status = runSync("git", ["status", "--short"], { cwd: packageRoot });
-    if (status.code === 0) {
-      state.sourceRepo.dirty = status.stdout.trim().length > 0;
-    }
-  }
-
-  try {
-    monitors = JSON.parse(await fs.readFile(monitorsPath, "utf-8"));
-  } catch {
-    monitors = null;
-  }
-
-  if (!pluginSettings && !pluginManifest && !monitors) {
-    return state;
-  }
-
-  state.exists = true;
-  state.pluginVersion = typeof pluginManifest?.version === "string" ? pluginManifest.version : null;
-  state.defaultAgent = typeof pluginSettings?.agent === "string" ? pluginSettings.agent : null;
-  state.subagentStatusLineCommand =
-    typeof pluginSettings?.subagentStatusLine?.command === "string"
-      ? pluginSettings.subagentStatusLine.command
-      : null;
-
-  if (Array.isArray(monitors)) {
-    state.monitorCount = monitors.length;
-    state.monitors = monitors
-      .filter((entry) => entry && typeof entry === "object")
-      .map((entry) => ({
-        name: typeof entry.name === "string" ? entry.name : null,
-        when: typeof entry.when === "string" ? entry.when : "always",
-      }))
-      .filter((entry) => entry.name);
-  }
-
-  if (pluginManifest?.userConfig && typeof pluginManifest.userConfig === "object") {
-    state.userConfig = Object.entries(pluginManifest.userConfig)
-      .filter(([, value]) => value && typeof value === "object" && !Array.isArray(value))
-      .map(([key, value]) => ({
-        key,
-        type: value.type ?? null,
-        default: Object.prototype.hasOwnProperty.call(value, "default") ? value.default : undefined,
-        sensitive: value.sensitive === true,
-      }));
-  }
-
-  return state;
-}
-
-export async function readProjectState(cwd = process.cwd()) {
-  const flowDir = path.join(cwd, ".flow");
-  try {
-    const stat = await fs.stat(flowDir);
-    if (!stat.isDirectory()) {
-      return { exists: false, activeSpec: null };
-    }
-
-    try {
-      const activeSpec = await fs.readFile(path.join(flowDir, ".active-spec"), "utf-8");
-      return { exists: true, activeSpec: activeSpec.trim() };
-    } catch {
-      return { exists: true, activeSpec: null };
-    }
-  } catch {
-    return { exists: false, activeSpec: null };
-  }
-}
-
-export async function collectDoctorData(
-  {
-    cwd = process.cwd(),
-  } = {},
-  {
-    claudeVersionImpl = claudeVersion,
-    listPluginsImpl = listPlugins,
-    listPluginMarketplacesImpl = listPluginMarketplaces,
-    listMcpsImpl = listMcps,
-    readUserMcpConfigImpl = readUserMcpConfig,
-    inspectClaudeMemRuntimesImpl = inspectClaudeMemRuntimes,
-    inspectRuntimeEnvironmentImpl = inspectRuntimeEnvironment,
-    readProjectStateImpl = readProjectState,
-    readProjectMcpConfigImpl = readProjectMcpConfig,
-    readProjectTeamConfigImpl = readProjectTeamConfig,
-    readProjectClaudeSettingsImpl = readProjectClaudeSettings,
-    readBundledPluginRuntimeDefaultsImpl = readBundledPluginRuntimeDefaults,
-    readConfigImpl = readConfig,
-  } = {}
-) {
-  const claudeVersionValue = claudeVersionImpl();
-  const plugins = claudeVersionValue ? listPluginsImpl() : [];
-  const marketplaces = claudeVersionValue ? listPluginMarketplacesImpl() : [];
-  const mcps = claudeVersionValue ? listMcpsImpl() : [];
-  const userMcpConfig = claudeVersionValue ? readUserMcpConfigImpl() : new Map();
-  const runtimeStatus = plugins.some(
-    (plugin) => plugin.name === "claude-mem" && plugin.status === "enabled"
-  )
-    ? inspectClaudeMemRuntimesImpl()
-    : null;
-
-  return {
-    claudeVersionValue,
-    nodeVersion: process.version,
-    plugins,
-    marketplaces,
-    mcps,
-    userMcpConfig,
-    runtimeStatus,
-    runtimeEnvironment: inspectRuntimeEnvironmentImpl(),
-    cwd,
-    projectState: await readProjectStateImpl(cwd),
-    projectMcpConfig: await readProjectMcpConfigImpl(cwd),
-    projectTeamConfig: await readProjectTeamConfigImpl(cwd),
-    projectClaudeSettings: await readProjectClaudeSettingsImpl(cwd),
-    bundledPluginRuntimeDefaults: await readBundledPluginRuntimeDefaultsImpl(),
-    legacyInstallState: {
-      configPath: CONFIG_FILE,
-      hasLegacyContext7ApiKey: Object.prototype.hasOwnProperty.call(readConfigImpl(), "context7ApiKey"),
-    },
-  };
-}
-
-export async function applyDoctorFixes(
-  doctorData,
-  {
-    ensureClaudeMemRuntimesImpl = ensureClaudeMemRuntimes,
-    removeMcpImpl = removeMcp,
-    readConfigImpl = readConfig,
-    writeConfigImpl = writeConfig,
-  } = {}
-) {
-  const fixes = [];
-  const context7PluginOwnsMcp = doctorData.mcps.some(
-    (entry) => entry.name === "context7" && entry.plugin === "context7-plugin"
-  );
-  const hasLegacyUserContext7Mcp =
-    doctorData.userMcpConfig instanceof Map && doctorData.userMcpConfig.has("context7");
-
-  if (context7PluginOwnsMcp && hasLegacyUserContext7Mcp) {
-    const result = await removeMcpImpl({ name: "context7" });
-    if (result.code === 0) {
-      doctorData.userMcpConfig.delete("context7");
-      doctorData.mcps = doctorData.mcps.filter(
-        (entry) => !(entry.name === "context7" && entry.plugin == null)
-      );
-      fixes.push({
-        kind: "legacy-context7-user-mcp-removed",
-      });
-    }
-  }
-
-  if (doctorData.legacyInstallState?.hasLegacyContext7ApiKey) {
-    const config = readConfigImpl();
-    if (Object.prototype.hasOwnProperty.call(config, "context7ApiKey")) {
-      delete config.context7ApiKey;
-      writeConfigImpl(config);
-      doctorData.legacyInstallState = {
-        ...doctorData.legacyInstallState,
-        hasLegacyContext7ApiKey: false,
-      };
-      fixes.push({
-        kind: "legacy-context7-api-key-removed",
-        configPath: CONFIG_FILE,
-      });
-    }
-  }
-
-  const claudeMemEnabled = doctorData.plugins.some(
-    (plugin) => plugin.name === "claude-mem" && plugin.status === "enabled"
-  );
-
-  if (!claudeMemEnabled) {
-    return fixes;
-  }
-
-  const runtimeStatus = ensureClaudeMemRuntimesImpl();
-  doctorData.runtimeStatus = runtimeStatus;
-  fixes.push({
-    kind: "claude-mem-runtimes",
-    runtimeStatus,
-  });
-  return fixes;
-}
-
-export function renderReportLines(lines, { logImpl = log } = {}) {
-  for (const line of lines) {
-    if (line.level === "ok") {
-      logImpl.ok(line.text);
-    } else if (line.level === "warn") {
-      logImpl.warn(line.text);
-    } else if (line.level === "err") {
-      logImpl.err(line.text);
-    } else {
-      logImpl.info(line.text);
-    }
-
-    for (const detail of line.details || []) {
-      console.log(color.dim(`     → ${detail}`));
-    }
-  }
-}
-
-export function buildDoctorJsonPayload({
-  context = {},
-  doctorData,
-  fixes = [],
-  report,
-} = {}) {
-  return {
-    contractVersion: DOCTOR_JSON_CONTRACT_VERSION,
-    generatedAt: new Date().toISOString(),
-    context: {
-      fix: context.fix === true,
-      json: context.json === true,
-      verbose: context.verbose === true,
-    },
-    summary: {
-      errors: report?.errors || 0,
-      warnings: report?.warnings || 0,
-      healthy: (report?.errors || 0) === 0,
-    },
-    metadata: {
-      appliedFixes: fixes,
-      settingsInspection: DOCTOR_SETTINGS_INSPECTION,
-    },
-    doctorData,
-    report,
-  };
-}
-
-export function printDoctorSummary(
-  report,
-  { logImpl = log, exitImpl = process.exit } = {}
-) {
-  console.log();
-  if (report.errors > 0) {
-    console.log(color.red(`Summary: ${report.errors} error(s), ${report.warnings} warning(s)`));
-    console.log(color.dim("Fix errors and re-run curdx-flow doctor"));
-    exitImpl(1);
-    return;
-  }
-
-  if (report.warnings > 0) {
-    console.log(color.yellow(`Summary: ${report.warnings} warning(s). Usable, but worth addressing.`));
-    return;
-  }
-
-  console.log(color.green("Summary: all healthy ✓"));
-}
-
-export function printVerboseDoctorDetails({ runSyncImpl = runSync } = {}) {
-  console.log(`\n${color.bold("Details:")}`);
-  console.log(color.dim("  Plugins raw:"));
-  console.log(runSyncImpl("claude", ["plugin", "list"]).stdout);
-}

package/cli/doctor.js

@@ -1,73 +0,0 @@
-/**
- * doctor command — external health check (no need to enter Claude Code).
- */
-
-import {
-  color,
-  log,
-} from "./utils.js";
-import { buildDoctorReport } from "./lib/doctor-report.js";
-import {
-  applyDoctorFixes,
-  buildDoctorJsonPayload,
-  collectDoctorData,
-  createDoctorContext,
-  printDoctorSummary,
-  printVerboseDoctorDetails,
-  renderReportLines,
-} from "./doctor-workflow.js";
-
-export async function doctor(
-  args = [],
-  {
-    applyDoctorFixesImpl = applyDoctorFixes,
-    buildDoctorJsonPayloadImpl = buildDoctorJsonPayload,
-    buildDoctorReportImpl = buildDoctorReport,
-    collectDoctorDataImpl = collectDoctorData,
-    createDoctorContextImpl = createDoctorContext,
-    printDoctorSummaryImpl = printDoctorSummary,
-    printVerboseDoctorDetailsImpl = printVerboseDoctorDetails,
-    renderReportLinesImpl = renderReportLines,
-    logImpl = log,
-    colorImpl = color,
-    consoleImpl = console,
-    processImpl = process,
-  } = {}
-) {
-  const context = createDoctorContextImpl(args);
-  let fixes = [];
-
-  if (!context.json) {
-    logImpl.title("🏥 CurdX-Flow Health Check");
-  }
-
-  const doctorData = await collectDoctorDataImpl();
-  if (context.fix) {
-    if (!context.json) {
-      logImpl.info("Applying safe fixes...");
-    }
-    fixes = await applyDoctorFixesImpl(doctorData);
-    if (fixes.length === 0 && !context.json) {
-      logImpl.info("No automatic fixes available for the current environment");
-    }
-  }
-  const report = buildDoctorReportImpl(doctorData);
-
-  if (context.json) {
-    const payload = buildDoctorJsonPayloadImpl({ context, doctorData, fixes, report });
-    consoleImpl.log(JSON.stringify(payload, null, 2));
-    processImpl.exitCode = report.errors > 0 ? 1 : 0;
-    return;
-  }
-
-  renderReportLinesImpl(report.lines, { logImpl });
-  for (const section of report.sections) {
-    consoleImpl.log(`\n${colorImpl.bold(section.title)}`);
-    renderReportLinesImpl(section.lines, { logImpl });
-  }
-
-  printDoctorSummaryImpl(report, { logImpl });
-  if (context.verbose && doctorData.claudeVersionValue) {
-    printVerboseDoctorDetailsImpl();
-  }
-}

package/cli/help.js

@@ -1,59 +0,0 @@
-import { VERSION, color } from "./utils.js";
-
-export function printHelp() {
-  console.log(`
-${color.bold("curdx-flow")} ${color.dim(`v${VERSION}`)}
-CurdX-Flow installer & helper for Claude Code
-
-${color.bold("USAGE")}
-  npx @curdx/flow <command> [options]
-
-${color.bold("COMMANDS")}
-  ${color.cyan("install")}   Install curdx-flow plugin + optional recommended plugins
-            --all            Install all recommended (skip prompt)
-            --no-deps        Only install curdx-flow, skip recommendations
-            --online         Fetch plugin from GitHub instead of using the
-                             local npm package (slower; default is offline
-                             when the plugin body is bundled)
-
-  ${color.cyan("doctor")}    Check health (claude CLI, plugin, MCPs, recommended)
-            --fix            Apply safe runtime fixes (bun/uv PATH symlinks)
-            --json           Emit machine-readable health report JSON
-            --verbose        Show raw plugin list details
-
-  ${color.cyan("upgrade")}   Update curdx-flow and recommended plugins to latest
-
-  ${color.cyan("uninstall")} Remove curdx-flow plugin (and optionally recommended / artifacts)
-            -y, --yes           Skip confirmation, keep recommended + .flow/
-            --keep-recommended  Don't ask about pua/claude-mem/frontend-design
-            --purge             Also remove ~/.local/bin/bun, ~/.local/bin/uv symlinks
-
-${color.bold("OPTIONS")}
-  -v, --version       Print version
-  -h, --help          Show this CLI usage summary
-
-${color.dim("For the full command / workflow reference (including all slash")}
-${color.dim("commands like /curdx-flow:start, /curdx-flow:spec, …) run:")}
-  ${color.cyan("/curdx-flow:help")}  ${color.dim("(inside Claude Code)")}
-
-${color.bold("EXAMPLES")}
-  ${color.dim("# First-time install with recommended plugins")}
-  npx @curdx/flow install --all
-
-  ${color.dim("# Check what's installed")}
-  npx @curdx/flow doctor
-
-  ${color.dim("# Update everything")}
-  npx @curdx/flow upgrade
-
-${color.bold("INITIALIZING A PROJECT")}
-  Once curdx-flow is installed, initialize your project inside Claude Code:
-
-    ${color.cyan("claude")}
-    ${color.cyan("/curdx-flow:init")}
-    ${color.cyan("/curdx-flow:start my-feature \"<description>\"")}
-
-${color.bold("LEARN MORE")}
-  https://github.com/curdx/curdx-flow
-`);
-}

package/cli/install-bundled-mcps.js

@@ -1,37 +0,0 @@
-/**
- * Register MCP servers that curdx-flow depends on at user level via
- * `claude mcp add`. Source-of-truth list: cli/registry.js BUNDLED_MCPS.
- * Preserves existing user-level entries when mcp.preserveExisting is set.
- */
-
-import { addMcp } from "./lib/claude-ops.js";
-import { BUNDLED_MCPS } from "./registry.js";
-import { color, log, readUserMcpConfig, resultLastLine } from "./utils.js";
-
-export async function registerBundledMcps() {
-  log.blank();
-  log.info("Registering required MCP servers (user-level)...");
-  const existingUserMcps = readUserMcpConfig();
-  for (const mcp of BUNDLED_MCPS) {
-    if (mcp.preserveExisting && existingUserMcps.has(mcp.name)) {
-      const existing = existingUserMcps.get(mcp.name);
-      log.info(
-        `  ${mcp.name.padEnd(22)} ${color.dim(`already registered (${(existing.args || []).join(" ")}) — preserving`)}`
-      );
-      continue;
-    }
-    const r = await addMcp(mcp);
-    if (r.code === 0) {
-      log.ok(`  ${mcp.name.padEnd(22)} ${color.dim("registered")}`);
-    } else if (r.stderr.includes("already exists")) {
-      log.info(`  ${mcp.name.padEnd(22)} ${color.dim("already exists — skipped")}`);
-    } else {
-      log.warn(
-        `  ${mcp.name.padEnd(22)} registration failed: ${resultLastLine(r)}`
-      );
-      log.info(
-        `     Run manually: claude mcp add --scope user ${mcp.name} -- ${mcp.command} ${mcp.args.join(" ")}`
-      );
-    }
-  }
-}

package/cli/install-companions.js

@@ -1,19 +0,0 @@
-/**
- * Re-export barrel preserving the stable import surface. New callers should
- * import directly from the concern-specific modules below instead of going
- * through this barrel. Kept in place so existing imports in cli/install.js
- * and cli/install-workflow.js keep working unchanged.
- *
- * Concern split:
- *   install-required-plugins.js    — required Claude Code companion plugins
- *   install-bundled-mcps.js        — user-level MCP registration
- *   install-recommended-plugins.js — optional recommended plugins
- *   install-context7-config.js     — legacy Context7 state reconciliation (private to required)
- */
-
-export {
-  addRequiredPluginMarketplaces,
-  installRequiredPlugins,
-} from "./install-required-plugins.js";
-export { registerBundledMcps } from "./install-bundled-mcps.js";
-export { installRecommendedPlugins } from "./install-recommended-plugins.js";