@curdx/flow 3.0.0 → 3.2.0

package/cli/install-self-update.js

@@ -1,62 +0,0 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-
-import { log, run, runSync, VERSION } from "./utils.js";
-import { compareVersions, isVersionNewer } from "./lib/semver.js";
-
-export { compareVersions, isVersionNewer };
-
-/**
- * Check for CLI updates and auto-update if available.
- * @returns {Promise<{updated: boolean, version?: string}>}
- */
-export async function checkAndUpdateSelf() {
-  try {
-    const globalPath = runSync("npm", ["root", "-g"]).stdout.trim();
-    const installedPath = join(globalPath, "@curdx/flow");
-
-    if (!existsSync(installedPath)) {
-      return { updated: false };
-    }
-
-    log.info("Checking for CLI updates...");
-    const res = runSync("npm", ["view", "@curdx/flow", "version"]);
-
-    if (res.code !== 0) {
-      return { updated: false };
-    }
-
-    const latestVersion = res.stdout.trim();
-    const currentVersion = VERSION;
-
-    if (latestVersion === currentVersion) {
-      log.ok(`CLI is up to date (v${currentVersion})`);
-      return { updated: false };
-    }
-
-    if (isVersionNewer(latestVersion, currentVersion)) {
-      log.info(`New version available: v${currentVersion} → v${latestVersion}`);
-      log.info("Updating CLI...");
-
-      const updateRes = await run("npm", ["install", "-g", "@curdx/flow@latest"], {
-        silent: false,
-      });
-
-      if (updateRes.code === 0) {
-        log.ok(`CLI updated to v${latestVersion}`);
-        return {
-          updated: true,
-          version: latestVersion,
-          entryPath: join(installedPath, "bin", "curdx-flow.js"),
-        };
-      }
-
-      log.warn("CLI update failed, continuing with current version");
-      return { updated: false };
-    }
-
-    return { updated: false };
-  } catch {
-    return { updated: false };
-  }
-}

package/cli/install-workflow.js

@@ -1,209 +0,0 @@
-import { spawn } from "node:child_process";
-
-import { installRecommendedPlugins } from "./install-companions.js";
-import { printNextSteps } from "./install-next-steps.js";
-import { parseInstallOptions } from "./install-options.js";
-import {
-  getMarketplaceLabel,
-  getMarketplaceSource,
-  shouldUseOfflineInstall,
-} from "./install-paths.js";
-import { injectGlobalProtocols, GLOBAL_CLAUDE_MD } from "./protocols.js";
-import { checkAndUpdateSelf } from "./install-self-update.js";
-import {
-  claudeVersion,
-  color,
-  intro,
-  listPlugins,
-  log,
-  select,
-} from "./utils.js";
-
-export const INSTALL_STEP_COUNT = 5;
-
-export function createInstallContext(args = []) {
-  const options = parseInstallOptions(args);
-  const useOffline = shouldUseOfflineInstall({ forceOnline: options.forceOnline });
-
-  return {
-    ...options,
-    args,
-    useOffline,
-    marketplaceSource: getMarketplaceSource(useOffline),
-    marketplaceLabel: getMarketplaceLabel(useOffline),
-  };
-}
-
-export async function maybeRestartWithUpdatedCli(
-  context,
-  {
-    checkAndUpdateSelfImpl = checkAndUpdateSelf,
-    spawnImpl = spawn,
-    logImpl = log,
-    exitImpl = process.exit,
-  } = {}
-) {
-  if (context.skipSelfUpdate) {
-    return false;
-  }
-
-  const updateResult = await checkAndUpdateSelfImpl();
-  if (!updateResult.updated) {
-    return false;
-  }
-
-  logImpl.info("Restarting with updated version...");
-  const child = spawnImpl(
-    process.execPath,
-    [updateResult.entryPath, "install", ...context.args, "--skip-self-update"],
-    {
-      stdio: "inherit",
-      shell: false,
-    }
-  );
-
-  await new Promise((resolve) => {
-    child.on("close", (code) => {
-      exitImpl(code || 0);
-      resolve();
-    });
-  });
-
-  return true;
-}
-
-export async function renderInstallIntro(
-  { yes },
-  { introImpl = intro, logImpl = log, isTTY = process.stdout.isTTY } = {}
-) {
-  if (isTTY && !yes) {
-    await introImpl("🚀 CurdX-Flow Installer");
-    return;
-  }
-
-  logImpl.title("🚀 CurdX-Flow Installer");
-}
-
-export function ensureClaudeCliAvailable(
-  { logImpl = log, claudeVersionImpl = claudeVersion, exitImpl = process.exit } = {}
-) {
-  logImpl.blank();
-  logImpl.step(1, INSTALL_STEP_COUNT, "Checking claude CLI...");
-
-  const version = claudeVersionImpl();
-  if (!version) {
-    logImpl.err(
-      "claude CLI not found. Install Claude Code from https://code.claude.com first."
-    );
-    exitImpl(1);
-    return null;
-  }
-
-  logImpl.ok(`claude CLI found (${version})`);
-  return version;
-}
-
-export function snapshotCurdxFlowInstall({ listPluginsImpl = listPlugins } = {}) {
-  return listPluginsImpl().find((plugin) => plugin.name === "curdx-flow");
-}
-
-export async function resolveExistingInstallationAction(
-  { prevCurdxFlow, yes, language },
-  { selectImpl = select, logImpl = log, exitImpl = process.exit } = {}
-) {
-  if (!prevCurdxFlow || yes) {
-    return { action: null, continueInstall: true };
-  }
-
-  logImpl.blank();
-  const action = await selectImpl({
-    message: language === "zh"
-      ? "检测到已安装的版本。如何继续？"
-      : "Existing installation detected. How would you like to proceed?",
-    options: [
-      {
-        value: "upgrade",
-        label: language === "zh" ? "升级到最新版本" : "Upgrade to latest version",
-        hint: language === "zh"
-          ? `当前: v${prevCurdxFlow.version}`
-          : `Current: v${prevCurdxFlow.version}`,
-      },
-      {
-        value: "reinstall",
-        label: language === "zh" ? "重新安装（保留配置）" : "Reinstall (preserve config)",
-      },
-      {
-        value: "reconfigure",
-        label: language === "zh" ? "重新配置插件" : "Reconfigure plugins",
-      },
-      {
-        value: "cancel",
-        label: language === "zh" ? "取消" : "Cancel",
-      },
-    ],
-    initialValue: "upgrade",
-  });
-
-  if (action === "cancel") {
-    logImpl.info(language === "zh" ? "安装已取消" : "Installation cancelled");
-    exitImpl(0);
-    return { action, continueInstall: false };
-  }
-
-  if (action === "reconfigure") {
-    logImpl.info(
-      language === "zh"
-        ? "重新配置模式：将重新提示插件选择和 API key 配置"
-        : "Reconfigure mode: will re-prompt for plugin selection and API key configuration"
-    );
-  }
-
-  return { action, continueInstall: true };
-}
-
-export async function runRecommendedPluginsStep(
-  { noDeps, all, yes, language },
-  {
-    logImpl = log,
-    installRecommendedPluginsImpl = installRecommendedPlugins,
-    printNextStepsImpl = printNextSteps,
-  } = {}
-) {
-  if (noDeps) {
-    logImpl.blank();
-    logImpl.step(4, INSTALL_STEP_COUNT, "Recommended plugins");
-    logImpl.info("Skipping recommended plugins (--no-deps)");
-    printNextStepsImpl();
-    return false;
-  }
-
-  const installedRecommended = await installRecommendedPluginsImpl({ all, yes, language });
-  if (!installedRecommended) {
-    printNextStepsImpl();
-    return false;
-  }
-
-  return true;
-}
-
-export function injectGlobalProtocolsStep(
-  { logImpl = log, injectGlobalProtocolsImpl = injectGlobalProtocols } = {}
-) {
-  logImpl.blank();
-  logImpl.step(5, INSTALL_STEP_COUNT, "Injecting global protocols into ~/.claude/CLAUDE.md...");
-
-  try {
-    const result = injectGlobalProtocolsImpl();
-    if (result.action === "created") {
-      logImpl.ok(`Global protocols injected ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else if (result.action === "appended") {
-      logImpl.ok(`Global protocols appended ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else if (result.action === "upgraded") {
-      logImpl.ok(`Global protocols upgraded ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else {
-      logImpl.info(`Global protocols up to date ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    }
-  } catch (err) {
-    logImpl.warn(`Protocol injection failed: ${err.message} ${color.dim("(non-blocking)")}`);
-  }
-}

package/cli/install.js

@@ -1,101 +0,0 @@
-/**
- * install command — install curdx-flow plugin + optional recommended plugins.
- */
-
-import {
-  addRequiredPluginMarketplaces,
-  installRequiredPlugins,
-  registerBundledMcps,
-} from "./install-companions.js";
-import {
-  addCurdxMarketplace,
-  installCurdxFlowPlugin,
-} from "./install-curdx-plugin.js";
-import { resolveInstallLanguage } from "./install-language.js";
-import { printNextSteps } from "./install-next-steps.js";
-import { readShippedVersion } from "./install-paths.js";
-import {
-  createInstallContext,
-  ensureClaudeCliAvailable,
-  injectGlobalProtocolsStep,
-  maybeRestartWithUpdatedCli,
-  renderInstallIntro,
-  resolveExistingInstallationAction,
-  runRecommendedPluginsStep,
-  snapshotCurdxFlowInstall,
-} from "./install-workflow.js";
-
-export async function install(args = []) {
-  const context = createInstallContext(args);
-
-  if (await maybeRestartWithUpdatedCli(context)) {
-    return;
-  }
-
-  await renderInstallIntro(context);
-
-  // ---------- Step 0: Language selection ----------
-  const { language, config } = await resolveInstallLanguage({ yes: context.yes });
-
-  // ---------- Step 1: Check claude CLI ----------
-  ensureClaudeCliAvailable();
-
-  // Snapshot curdx-flow's pre-install version BEFORE Step 2 touches the
-  // marketplace. Step 2 does `claude plugin marketplace remove` + `add` to
-  // rebind to the current source, and the remove side-effect also drops
-  // any plugins installed from that marketplace. If we only call
-  // listPlugins() in Step 3, curdx-flow is already gone from the list and
-  // we can't tell a fresh install apart from an upgrade — the Step 3
-  // output then incorrectly says "installed" for both cases.
-  const prevCurdxFlow = snapshotCurdxFlowInstall();
-
-  // ---------- Step 1.5: Existing installation action menu ----------
-  const existingInstall = await resolveExistingInstallationAction({
-    prevCurdxFlow,
-    yes: context.yes,
-    language,
-  });
-  if (!existingInstall.continueInstall) {
-    return;
-  }
-
-  await addCurdxMarketplace(context);
-
-  // Claude Code resolves plugin dependencies during install. Register
-  // required companion marketplaces before installing curdx-flow so its
-  // cross-marketplace dependency on Context7 can be satisfied immediately.
-  await addRequiredPluginMarketplaces({ logWarnings: false });
-
-  // ---------- Step 3: Install curdx-flow plugin ----------
-  // Read the version the marketplace is shipping so we can decide whether an
-  // already-installed plugin needs an update (same name but stale version
-  // previously silently skipped the upgrade — caused the beta.1 → beta.7 drift).
-  const shippedVersion = readShippedVersion();
-  await installCurdxFlowPlugin({ prevCurdxFlow, shippedVersion });
-
-  // ---------- Step 3.5: Install required plugins + register user-level MCPs ----------
-  await installRequiredPlugins({
-    yes: context.yes,
-    language,
-    config,
-    skipMarketplaceAdd: true,
-  });
-
-  // Beta.12: direct MCPs migrated from plugin.json bundling. See cli/registry.js
-  // for the rationale. Context7 now uses Upstash's official plugin instead.
-  await registerBundledMcps();
-
-  // ---------- Step 4: Recommended plugins ----------
-  const installedRecommended = await runRecommendedPluginsStep({
-    noDeps: context.noDeps,
-    all: context.all,
-    yes: context.yes,
-    language,
-  });
-  if (!installedRecommended) {
-    return;
-  }
-
-  injectGlobalProtocolsStep();
-  printNextSteps();
-}

package/cli/lib/claude-commands.js

@@ -1,41 +0,0 @@
-export function pluginMarketplaceAddArgs({ scope, marketplaceSource }) {
-  return ["plugin", "marketplace", "add", "--scope", scope, marketplaceSource];
-}
-
-export function pluginMarketplaceUpdateArgs(marketplaceId) {
-  return ["plugin", "marketplace", "update", marketplaceId];
-}
-
-export function pluginMarketplaceRemoveArgs(marketplaceId) {
-  return ["plugin", "marketplace", "remove", marketplaceId];
-}
-
-export function pluginInstallArgs({ scope, installSpec }) {
-  return ["plugin", "install", "--scope", scope, installSpec];
-}
-
-export function pluginUpdateArgs({ scope = "user", spec }) {
-  return ["plugin", "update", "--scope", scope, spec];
-}
-
-export function pluginUninstallArgs({ scope, uninstallSpec, uninstallArgs = [] }) {
-  return ["plugin", "uninstall", "--scope", scope, ...uninstallArgs, uninstallSpec];
-}
-
-export function mcpAddArgs({ scope = "user", name, command, args = [], env = [] }) {
-  return [
-    "mcp",
-    "add",
-    "--scope",
-    scope,
-    name,
-    ...env.flatMap((value) => ["--env", value]),
-    "--",
-    command,
-    ...args,
-  ];
-}
-
-export function mcpRemoveArgs({ scope = "user", name }) {
-  return ["mcp", "remove", "--scope", scope, name];
-}

package/cli/lib/claude-ops.js

@@ -1,47 +0,0 @@
-import { run } from "./process.js";
-import {
-  mcpAddArgs,
-  mcpRemoveArgs,
-  pluginInstallArgs,
-  pluginMarketplaceAddArgs,
-  pluginMarketplaceRemoveArgs,
-  pluginMarketplaceUpdateArgs,
-  pluginUninstallArgs,
-  pluginUpdateArgs,
-} from "./claude-commands.js";
-
-async function runClaude(args, { runner = run, silent = true } = {}) {
-  return runner("claude", args, { silent });
-}
-
-export async function addPluginMarketplace(entry, options) {
-  return runClaude(pluginMarketplaceAddArgs(entry), options);
-}
-
-export async function updatePluginMarketplace(marketplaceId, options) {
-  return runClaude(pluginMarketplaceUpdateArgs(marketplaceId), options);
-}
-
-export async function removePluginMarketplace(marketplaceId, options) {
-  return runClaude(pluginMarketplaceRemoveArgs(marketplaceId), options);
-}
-
-export async function installPlugin(entry, options) {
-  return runClaude(pluginInstallArgs(entry), options);
-}
-
-export async function updatePlugin(spec, options) {
-  return runClaude(pluginUpdateArgs({ spec }), options);
-}
-
-export async function uninstallPlugin(entry, options) {
-  return runClaude(pluginUninstallArgs(entry), options);
-}
-
-export async function addMcp(entry, options) {
-  return runClaude(mcpAddArgs(entry), options);
-}
-
-export async function removeMcp(entry, options) {
-  return runClaude(mcpRemoveArgs(entry), options);
-}

package/cli/lib/claude.js

@@ -1,183 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-import { has, runSync } from "./process.js";
-
-const HOME = homedir();
-
-export function claudeVersion() {
-  if (!has("claude")) return null;
-  const res = runSync("claude", ["--version"]);
-  if (res.code !== 0) return null;
-  const m = res.stdout.match(/(\d+\.\d+\.\d+)/);
-  return m ? m[1] : res.stdout.trim().split("\n")[0];
-}
-
-function normalizePluginError(error) {
-  if (typeof error === "string") {
-    return error;
-  }
-  if (error && typeof error === "object") {
-    return error.message || error.code || JSON.stringify(error);
-  }
-  return String(error);
-}
-
-export function parsePluginListJson(output) {
-  const trimmed = String(output || "").trim();
-  if (!trimmed.startsWith("[")) {
-    return null;
-  }
-
-  const arr = JSON.parse(trimmed);
-  return arr.map((p) => {
-    const id = String(p.id || p.name || "");
-    const errors = Array.isArray(p.errors)
-      ? p.errors.map(normalizePluginError).filter(Boolean)
-      : [];
-    const enabled = p.enabled !== false;
-
-    return {
-      id,
-      name: id.split("@")[0],
-      marketplaceId: id.split("@")[1] || undefined,
-      version: p.version,
-      status: errors.length > 0 ? "failed" : enabled ? "enabled" : "disabled",
-      scope: p.scope,
-      errors,
-      raw: JSON.stringify(p),
-    };
-  });
-}
-
-export function listPlugins() {
-  const j = runSync("claude", ["plugin", "list", "--json"]);
-  if (j.code === 0) {
-    try {
-      const plugins = parsePluginListJson(j.stdout);
-      if (plugins) {
-        return plugins;
-      }
-    } catch {
-      // JSON parse failed; fall through to legacy text parser.
-    }
-  }
-
-  const res = runSync("claude", ["plugin", "list"]);
-  if (res.code !== 0) return [];
-  const plugins = [];
-  const blocks = res.stdout.split(/\n\s*❯\s*/).slice(1);
-  for (const block of blocks) {
-    const lines = block.split("\n");
-    const id = lines[0].trim();
-    const name = id.split("@")[0];
-    const version = (block.match(/Version:\s*(\S+)/) || [])[1];
-    const status = block.includes("✔")
-      ? "enabled"
-      : block.includes("✘")
-        ? "failed"
-        : "unknown";
-    plugins.push({
-      id,
-      name,
-      marketplaceId: id.split("@")[1],
-      version,
-      status,
-      raw: block,
-    });
-  }
-  return plugins;
-}
-
-export function listPluginMarketplaces() {
-  const j = runSync("claude", ["plugin", "marketplace", "list", "--json"]);
-  if (j.code === 0 && j.stdout.trim().startsWith("[")) {
-    try {
-      return JSON.parse(j.stdout);
-    } catch {
-      return [];
-    }
-  }
-  return [];
-}
-
-export function findPluginByRegistryEntry(plugins, registryEntry) {
-  return plugins.find(
-    (plugin) => plugin.id === registryEntry.id || plugin.name === registryEntry.name
-  );
-}
-
-export function hasMarketplace(marketplaces, registryEntry) {
-  if (!registryEntry.marketplaceSource) return true;
-  return marketplaces.some((marketplace) => marketplace.name === registryEntry.marketplaceId);
-}
-
-export function readUserMcpConfig() {
-  try {
-    const path = join(HOME, ".claude.json");
-    if (!existsSync(path)) return new Map();
-    const cfg = JSON.parse(readFileSync(path, "utf-8"));
-    const servers = cfg?.mcpServers || {};
-    return new Map(Object.entries(servers));
-  } catch {
-    return new Map();
-  }
-}
-
-export function findDuplicateMcps(mcps, userConfig) {
-  const duplicates = [];
-  for (const m of mcps) {
-    if (m.plugin && userConfig.has(m.name)) {
-      duplicates.push({
-        name: m.name,
-        userConfig: userConfig.get(m.name),
-        pluginEntry: m,
-      });
-    }
-  }
-  return duplicates;
-}
-
-export function listMcps() {
-  const res = runSync("claude", ["mcp", "list"]);
-  if (res.code !== 0) return [];
-  return parseMcpList(res.stdout);
-}
-
-export function parseMcpList(output) {
-  const mcps = [];
-  for (const raw of output.split("\n")) {
-    const line = raw.trimEnd();
-    if (!line) continue;
-    if (line.startsWith("Checking") || line.startsWith("checking")) continue;
-
-    const statusSplit = line.lastIndexOf(" - ");
-    if (statusSplit === -1) continue;
-    const statusRaw = line.slice(statusSplit + 3).trim();
-    const beforeStatus = line.slice(0, statusSplit);
-    const nameSplit = beforeStatus.indexOf(": ");
-    if (nameSplit === -1) continue;
-    const fullName = beforeStatus.slice(0, nameSplit).trim();
-    const command = beforeStatus.slice(nameSplit + 2).trim();
-
-    let plugin = null;
-    let name = fullName;
-    if (fullName.startsWith("plugin:")) {
-      const parts = fullName.split(":");
-      if (parts.length >= 3) {
-        plugin = parts[1];
-        name = parts.slice(2).join(":");
-      }
-    }
-
-    const status = /Connected|✓/.test(statusRaw)
-      ? "connected"
-      : /Failed|✗/.test(statusRaw)
-        ? "failed"
-        : "unknown";
-
-    mcps.push({ name, plugin, fullName, status, command });
-  }
-  return mcps;
-}

package/cli/lib/config.js

@@ -1,24 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-const CONFIG_DIR = join(homedir(), ".claude");
-export const CONFIG_FILE = join(CONFIG_DIR, "curdx-flow-config.json");
-
-export function readConfig() {
-  if (!existsSync(CONFIG_FILE)) {
-    return {};
-  }
-  try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-
-export function writeConfig(config) {
-  if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-  }
-  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
-}