@curdx/flow 2.0.18 → 2.0.20

package/cli/install-workflow.js

@@ -0,0 +1,209 @@
+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(
+    "curdx-flow",
+    ["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

@@ -3,16 +3,6 @@
  */
 
 import {
-  color,
-  log,
-  claudeVersion,
-  listPlugins,
-  select,
-  intro,
-} from "./utils.js";
-import { injectGlobalProtocols, GLOBAL_CLAUDE_MD } from "./protocols.js";
-import {
-  installRecommendedPlugins,
   installRequiredPlugins,
   registerBundledMcps,
 } from "./install-companions.js";
@@ -22,56 +12,32 @@ import {
 } from "./install-curdx-plugin.js";
 import { resolveInstallLanguage } from "./install-language.js";
 import { printNextSteps } from "./install-next-steps.js";
-import { parseInstallOptions } from "./install-options.js";
+import { readShippedVersion } from "./install-paths.js";
 import {
-  getMarketplaceLabel,
-  getMarketplaceSource,
-  readShippedVersion,
-  shouldUseOfflineInstall,
-} from "./install-paths.js";
-import { checkAndUpdateSelf } from "./install-self-update.js";
+  createInstallContext,
+  ensureClaudeCliAvailable,
+  injectGlobalProtocolsStep,
+  maybeRestartWithUpdatedCli,
+  renderInstallIntro,
+  resolveExistingInstallationAction,
+  runRecommendedPluginsStep,
+  snapshotCurdxFlowInstall,
+} from "./install-workflow.js";
 
 export async function install(args = []) {
-  const { all, noDeps, forceOnline, yes, skipSelfUpdate } = parseInstallOptions(args);
+  const context = createInstallContext(args);
 
-  // ---------- Step 0: Self-update check ----------
-  if (!skipSelfUpdate) {
-    const updateResult = await checkAndUpdateSelf();
-    if (updateResult.updated) {
-      // CLI was updated, re-exec with same args
-      log.info("Restarting with updated version...");
-      const { spawn } = await import("node:child_process");
-      const child = spawn("curdx-flow", ["install", ...args, "--skip-self-update"], {
-        stdio: "inherit",
-        shell: false,
-      });
-      return new Promise((resolve) => {
-        child.on("close", (code) => process.exit(code || 0));
-      });
-    }
+  if (await maybeRestartWithUpdatedCli(context)) {
+    return;
   }
 
-  const useOffline = shouldUseOfflineInstall({ forceOnline });
-
-  // Use @clack intro only in interactive TTY mode
-  if (process.stdout.isTTY && !yes) {
-    await intro("🚀 CurdX-Flow Installer");
-  } else {
-    log.title("🚀 CurdX-Flow Installer");
-  }
+  await renderInstallIntro(context);
 
   // ---------- Step 0: Language selection ----------
-  const { language, config } = await resolveInstallLanguage({ yes });
+  const { language, config } = await resolveInstallLanguage({ yes: context.yes });
 
   // ---------- Step 1: Check claude CLI ----------
-  log.blank();
-  log.step(1, 5, "Checking claude CLI...");
-  const ver = claudeVersion();
-  if (!ver) {
-    log.err("claude CLI not found. Install Claude Code from https://code.claude.com first.");
-    process.exit(1);
-  }
-  log.ok(`claude CLI found (${ver})`);
+  ensureClaudeCliAvailable();
 
   // Snapshot curdx-flow's pre-install version BEFORE Step 2 touches the
   // marketplace. Step 2 does `claude plugin marketplace remove` + `add` to
@@ -80,55 +46,19 @@ export async function install(args = []) {
   // 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 = listPlugins().find((p) => p.name === "curdx-flow");
+  const prevCurdxFlow = snapshotCurdxFlowInstall();
 
   // ---------- Step 1.5: Existing installation action menu ----------
-  if (prevCurdxFlow && !yes) {
-    log.blank();
-    const action = await select({
-      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") {
-      log.info(language === "zh" ? "安装已取消" : "Installation cancelled");
-      process.exit(0);
-    }
-
-    if (action === "reconfigure") {
-      log.info(language === "zh"
-        ? "重新配置模式：将重新提示插件选择和 API key 配置"
-        : "Reconfigure mode: will re-prompt for plugin selection and API key configuration");
-      // Continue with normal flow but force prompts
-    }
+  const existingInstall = await resolveExistingInstallationAction({
+    prevCurdxFlow,
+    yes: context.yes,
+    language,
+  });
+  if (!existingInstall.continueInstall) {
+    return;
   }
 
-  const marketplaceSource = getMarketplaceSource(useOffline);
-  const marketplaceLabel = getMarketplaceLabel(useOffline);
-  await addCurdxMarketplace({ marketplaceSource, marketplaceLabel, useOffline });
+  await addCurdxMarketplace(context);
 
   // ---------- Step 3: Install curdx-flow plugin ----------
   // Read the version the marketplace is shipping so we can decide whether an
@@ -138,43 +68,23 @@ export async function install(args = []) {
   await installCurdxFlowPlugin({ prevCurdxFlow, shippedVersion });
 
   // ---------- Step 3.5: Install required plugins + register user-level MCPs ----------
-  await installRequiredPlugins({ yes, language, config });
+  await installRequiredPlugins({ yes: context.yes, language, config });
 
   // 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 ----------
-  if (noDeps) {
-    log.blank();
-    log.step(4, 5, "Recommended plugins");
-    log.info("Skipping recommended plugins (--no-deps)");
-    printNextSteps();
-    return;
-  }
-  const installedRecommended = await installRecommendedPlugins({ all, yes, language });
+  const installedRecommended = await runRecommendedPluginsStep({
+    noDeps: context.noDeps,
+    all: context.all,
+    yes: context.yes,
+    language,
+  });
   if (!installedRecommended) {
-    printNextSteps();
     return;
   }
 
-  // ---------- Step 5: inject global protocols ----------
-  log.blank();
-  log.step(5, 5, "Injecting global protocols into ~/.claude/CLAUDE.md...");
-  try {
-    const r = injectGlobalProtocols();
-    if (r.action === "created") {
-      log.ok(`Global protocols injected ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else if (r.action === "appended") {
-      log.ok(`Global protocols appended ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else if (r.action === "upgraded") {
-      log.ok(`Global protocols upgraded ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    } else {
-      log.info(`Global protocols up to date ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
-    }
-  } catch (err) {
-    log.warn(`Protocol injection failed: ${err.message} ${color.dim("(non-blocking)")}`);
-  }
-
+  injectGlobalProtocolsStep();
   printNextSteps();
 }

package/cli/uninstall-workflow.js

@@ -0,0 +1,146 @@
+import { GLOBAL_CLAUDE_MD, removeGlobalProtocols } from "./protocols.js";
+import {
+  claudeVersion,
+  color,
+  confirm,
+  listPlugins,
+  log,
+  multiSelect,
+} from "./utils.js";
+
+export const UNINSTALL_STEP_COUNT = 4;
+
+export function createUninstallContext(args = []) {
+  return {
+    yes: args.includes("--yes") || args.includes("-y"),
+    purge: args.includes("--purge"),
+    keepRecommended: args.includes("--keep-recommended"),
+  };
+}
+
+export function ensureClaudeCliAvailableForUninstall(
+  { claudeVersionImpl = claudeVersion, logImpl = log, exitImpl = process.exit } = {}
+) {
+  const version = claudeVersionImpl();
+  if (!version) {
+    logImpl.err("claude CLI not found, cannot uninstall plugin.");
+    exitImpl(1);
+    return null;
+  }
+
+  return version;
+}
+
+export async function confirmUninstallStep(
+  { yes },
+  { confirmImpl = confirm, logImpl = log } = {}
+) {
+  if (yes) {
+    return true;
+  }
+
+  const confirmed = await confirmImpl(
+    `This will uninstall the ${color.bold("curdx-flow")} plugin. Continue?`,
+    false
+  );
+  if (!confirmed) {
+    logImpl.info("Cancelled");
+  }
+  return confirmed;
+}
+
+export function getInstalledTargets(entries, { listPluginsImpl = listPlugins } = {}) {
+  const installedNames = new Set(listPluginsImpl().map((plugin) => plugin.name));
+  return entries.filter((entry) => installedNames.has(entry.name));
+}
+
+export async function selectRecommendedPluginsToRemove(
+  { yes, present },
+  { multiSelectImpl = multiSelect, logImpl = log } = {}
+) {
+  if (present.length === 0) {
+    return [];
+  }
+
+  if (yes) {
+    logImpl.info(
+      color.dim("--yes mode: keeping recommended plugins (use --purge to remove them)")
+    );
+    return [];
+  }
+
+  const choices = present.map((entry) => ({
+    label: color.bold(entry.name),
+    value: entry.name,
+    hint: "",
+  }));
+
+  return multiSelectImpl(
+    "Which recommended plugins to also uninstall? (default: none)",
+    choices,
+    []
+  );
+}
+
+export function shouldKeepBundledMcps({ yes, keepRecommended }) {
+  if (!yes && !keepRecommended) {
+    return false;
+  }
+
+  return true;
+}
+
+export function shouldKeepRequiredPlugins({ yes }) {
+  return yes;
+}
+
+export function getManagedMarketplaceIds(entries) {
+  return [
+    ...new Set(
+      entries
+        .map((entry) => entry.marketplaceId)
+        .filter((id) => id && id !== "claude-plugins-official")
+    ),
+  ];
+}
+
+export function removeProtocolsStep(
+  { logImpl = log, removeGlobalProtocolsImpl = removeGlobalProtocols } = {}
+) {
+  logImpl.blank();
+  console.log(color.dim("Removing global protocols from ~/.claude/CLAUDE.md..."));
+
+  try {
+    const result = removeGlobalProtocolsImpl();
+    if (result.action === "removed") {
+      logImpl.ok(`Global protocols removed ${color.dim(`(${GLOBAL_CLAUDE_MD})`)}`);
+    } else if (result.action === "not-present") {
+      logImpl.info("Global protocols not present, skipping");
+    } else {
+      logImpl.info("~/.claude/CLAUDE.md does not exist, skipping");
+    }
+  } catch (err) {
+    logImpl.warn(`Protocol removal failed: ${err.message}`);
+  }
+}
+
+export function printUninstallSummary({ purge }, { logImpl = log } = {}) {
+  logImpl.blank();
+  console.log(color.bold("✅ Uninstall complete"));
+  if (purge) {
+    return;
+  }
+
+  console.log(
+    color.dim(
+      `\nArtifacts kept:\n` +
+        `  - ~/.local/bin/bun, ~/.local/bin/uv (symlinks; use --purge to remove)\n` +
+        `  - bun/uv binaries themselves (~/.bun/bin/bun, ~/.local/bin/uv real installs)\n` +
+        `  - claude-mem data (~/.claude-mem/)\n` +
+        `  - claude marketplace cache`
+    )
+  );
+  console.log(
+    color.dim(`\nFully purge: ${color.cyan("curdx-flow uninstall --purge")}`)
+  );
+}