@curdx/flow 3.0.0 → 3.2.0

package/cli/uninstall-actions.js

@@ -1,360 +0,0 @@
-import { existsSync, lstatSync, unlinkSync, rmSync, readlinkSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-
-import { REQUIRED_PLUGINS, RECOMMENDED_PLUGINS, BUNDLED_MCPS } from "./registry.js";
-import { readConfig, writeConfig } from "./lib/config.js";
-import {
-  removeMcp,
-  removePluginMarketplace,
-  uninstallPlugin,
-} from "./lib/claude-ops.js";
-import {
-  confirm,
-  color,
-  listPlugins,
-  log,
-  resultLastLine,
-  resultOutput,
-} from "./utils.js";
-import { reconcileLegacyContext7InstallState } from "./install-context7-config.js";
-import {
-  UNINSTALL_STEP_COUNT,
-  getInstalledTargets,
-  getManagedMarketplaceIds,
-  selectRecommendedPluginsToRemove,
-  shouldKeepBundledMcps,
-  shouldKeepRequiredPlugins,
-} from "./uninstall-workflow.js";
-
-const HOME = homedir();
-
-const RECOMMENDED = RECOMMENDED_PLUGINS.map(toUninstallTarget);
-const REQUIRED = REQUIRED_PLUGINS.map(toUninstallTarget);
-
-// Symlinks created by install.js (only cleaned with --purge)
-const MANAGED_SYMLINKS = [
-  join(HOME, ".local", "bin", "bun"),
-  join(HOME, ".local", "bin", "uv"),
-];
-
-export async function uninstallCurdxFlowPlugin(
-  {
-    listPluginsImpl = listPlugins,
-    uninstallPluginImpl = uninstallPlugin,
-    logImpl = log,
-    resultOutputImpl = resultOutput,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.step(1, UNINSTALL_STEP_COUNT, "Uninstalling curdx-flow plugin...");
-  const curdx = listPluginsImpl().find((plugin) => plugin.name === "curdx-flow");
-  if (!curdx) {
-    logImpl.info("curdx-flow not installed, skipping");
-    return;
-  }
-
-  const result = await uninstallPluginImpl({
-    scope: "user",
-    uninstallSpec: "curdx-flow@curdx-flow-marketplace",
-  });
-  if (result.code === 0) {
-    logImpl.ok("curdx-flow uninstalled");
-    return;
-  }
-
-  logImpl.err(`Uninstall failed: ${resultOutputImpl(result)}`);
-}
-
-export async function maybeUninstallRecommendedPlugins(
-  { yes, keepRecommended },
-  {
-    getInstalledTargetsImpl = getInstalledTargets,
-    selectRecommendedPluginsToRemoveImpl = selectRecommendedPluginsToRemove,
-    uninstallNamedPluginImpl = uninstallNamedPlugin,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.step(2, UNINSTALL_STEP_COUNT, "Recommended plugins");
-  if (keepRecommended) {
-    logImpl.info("Keeping recommended plugins (--keep-recommended)");
-    return;
-  }
-
-  const present = getInstalledTargetsImpl(RECOMMENDED);
-  if (present.length === 0) {
-    logImpl.info("No installed recommended plugins");
-    return;
-  }
-
-  const selected = await selectRecommendedPluginsToRemoveImpl({ yes, present });
-  for (const name of selected) {
-    const entry = present.find((plugin) => plugin.name === name);
-    if (!entry) continue;
-    await uninstallNamedPluginImpl(entry);
-  }
-}
-
-export async function uninstallNamedPlugin(
-  entry,
-  {
-    uninstallPluginImpl = uninstallPlugin,
-    resultLastLineImpl = resultLastLine,
-  } = {}
-) {
-  log.blank();
-  console.log(`  ${color.cyan("▸")} Uninstalling ${color.bold(entry.name)}...`);
-  const result = await uninstallPluginImpl(entry);
-  if (result.code === 0) {
-    console.log(`  ${color.green("✓")} ${entry.name} uninstalled`);
-    return;
-  }
-
-  console.log(
-    `  ${color.red("✗")} ${entry.name} uninstall failed: ${resultLastLineImpl(result)}`
-  );
-}
-
-export async function maybeRemoveBundledMcps(
-  { yes, keepRecommended },
-  {
-    shouldKeepBundledMcpsImpl = shouldKeepBundledMcps,
-    confirmImpl = confirm,
-    removeMcpImpl = removeMcp,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.info("Required user-level MCP servers (sequential-thinking)");
-  if (shouldKeepBundledMcpsImpl({ yes, keepRecommended })) {
-    logImpl.info(
-      color.dim("--yes or --keep-recommended: keeping user-level MCPs (remove manually with `claude mcp remove <name>`)")
-    );
-    return;
-  }
-
-  const removeMcps = await confirmImpl(
-    `Remove user-level MCPs registered by install (${BUNDLED_MCPS.map((mcp) => mcp.name).join(", ")})? ${color.dim("(keeps them if other tools depend on them)")}`,
-    false
-  );
-  if (!removeMcps) {
-    logImpl.info("Keeping user-level MCPs");
-    return;
-  }
-
-  for (const mcp of BUNDLED_MCPS) {
-    const result = await removeMcpImpl({ name: mcp.name });
-    if (result.code === 0) {
-      logImpl.ok(`  ${mcp.name.padEnd(22)} removed`);
-    } else {
-      logImpl.info(`  ${mcp.name.padEnd(22)} ${color.dim("not present or already removed")}`);
-    }
-  }
-}
-
-export async function maybeUninstallRequiredPlugins(
-  { yes },
-  {
-    shouldKeepRequiredPluginsImpl = shouldKeepRequiredPlugins,
-    confirmImpl = confirm,
-    uninstallPluginImpl = uninstallPlugin,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.info("Required companion plugins");
-  if (shouldKeepRequiredPluginsImpl({ yes })) {
-    logImpl.info(
-      color.dim("--yes mode: keeping required companion plugins (use --purge to remove them)")
-    );
-    return;
-  }
-
-  const removeRequired = await confirmImpl(
-    `Remove required companion plugins (${REQUIRED.map((plugin) => plugin.name).join(", ")})? ${color.dim("(keeps shared tools available if other workflows depend on them)")}`,
-    false
-  );
-  if (!removeRequired) {
-    logImpl.info("Keeping required companion plugins");
-    return;
-  }
-
-  for (const plugin of REQUIRED) {
-    const result = await uninstallPluginImpl(plugin);
-    if (result.code === 0) {
-      logImpl.ok(`  ${plugin.name.padEnd(22)} uninstalled`);
-    } else {
-      logImpl.info(`  ${plugin.name.padEnd(22)} ${color.dim("not present or already removed")}`);
-    }
-  }
-}
-
-export async function maybePurgeRuntimeArtifacts(
-  { purge },
-  {
-    purgeManagedMarketplacesImpl = purgeManagedMarketplaces,
-    removeManagedSymlinksImpl = removeManagedSymlinks,
-    readConfigImpl = readConfig,
-    writeConfigImpl = writeConfig,
-    removeMcpImpl = removeMcp,
-    readUserMcpConfigImpl,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.step(3, UNINSTALL_STEP_COUNT, "Runtime symlinks and marketplaces");
-  if (!purge) {
-    logImpl.info(
-      color.dim("Keeping ~/.local/bin/bun, ~/.local/bin/uv (use --purge to remove)")
-    );
-    logImpl.info(
-      color.dim("Reason: these bun/uv binaries may be used by other tools — confirm before deleting")
-    );
-    return;
-  }
-
-  await purgeManagedMarketplacesImpl();
-  removeManagedSymlinksImpl();
-  await purgeLegacyContext7InstallState({
-    readConfigImpl,
-    writeConfigImpl,
-    removeMcpImpl,
-    readUserMcpConfigImpl,
-    logImpl,
-  });
-}
-
-export async function maybeRemoveProjectState(
-  { yes },
-  {
-    cwd = process.cwd(),
-    confirmImpl = confirm,
-    existsSyncImpl = existsSync,
-    rmSyncImpl = rmSync,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.blank();
-  logImpl.step(4, UNINSTALL_STEP_COUNT, "Project state directory");
-  const flowDir = join(cwd, ".flow");
-  if (!existsSyncImpl(flowDir)) {
-    logImpl.info(".flow/ does not exist, skipping");
-    return;
-  }
-
-  if (yes) {
-    logImpl.info(
-      color.dim("--yes mode: keeping .flow/ (contains specs & decisions — confirm by hand before deleting)")
-    );
-    return;
-  }
-
-  const ok = await confirmImpl(
-    `${color.red("DANGER:")} delete the ${color.bold(".flow/")} directory of the current project? ${color.dim("(includes all specs / decisions, not recoverable)")}`,
-    false
-  );
-  if (!ok) {
-    logImpl.info("Keeping .flow/");
-    return;
-  }
-
-  try {
-    rmSyncImpl(flowDir, { recursive: true, force: true });
-    logImpl.ok(`Removed ${flowDir}`);
-  } catch (err) {
-    logImpl.err(`Removal failed: ${err.message}`);
-  }
-}
-
-async function purgeManagedMarketplaces(
-  {
-    getManagedMarketplaceIdsImpl = getManagedMarketplaceIds,
-    removePluginMarketplaceImpl = removePluginMarketplace,
-    logImpl = log,
-  } = {}
-) {
-  const marketplaceIds = getManagedMarketplaceIdsImpl(RECOMMENDED.concat(REQUIRED));
-
-  for (const marketplaceId of marketplaceIds) {
-    const result = await removePluginMarketplaceImpl(marketplaceId);
-    if (result.code === 0) {
-      logImpl.ok(`Removed marketplace ${marketplaceId}`);
-    } else if (!result.stderr.includes("not found")) {
-      logImpl.warn(`Failed to remove marketplace ${marketplaceId}: ${resultLastLine(result)}`);
-    }
-  }
-}
-
-function removeManagedSymlinks(
-  {
-    existsSyncImpl = existsSync,
-    isBrokenSymlinkImpl = isBrokenSymlink,
-    lstatSyncImpl = lstatSync,
-    readlinkSyncImpl = readlinkSync,
-    unlinkSyncImpl = unlinkSync,
-    logImpl = log,
-  } = {}
-) {
-  for (const link of MANAGED_SYMLINKS) {
-    if (!existsSyncImpl(link) && !isBrokenSymlinkImpl(link)) {
-      continue;
-    }
-    try {
-      const stat = lstatSyncImpl(link);
-      if (!stat.isSymbolicLink()) {
-        logImpl.warn(
-          `${link} is not a symlink (likely a real file placed by the user), skipping`
-        );
-        continue;
-      }
-      const target = readlinkSyncImpl(link);
-      unlinkSyncImpl(link);
-      logImpl.ok(`Removed symlink ${link} ${color.dim(`(was → ${target})`)}`);
-    } catch (err) {
-      logImpl.warn(`Failed to remove ${link}: ${err.message}`);
-    }
-  }
-}
-
-async function purgeLegacyContext7InstallState(
-  {
-    readConfigImpl = readConfig,
-    writeConfigImpl = writeConfig,
-    removeMcpImpl = removeMcp,
-    readUserMcpConfigImpl,
-    logImpl = log,
-  } = {}
-) {
-  const config = readConfigImpl();
-  const language = config?.language === "zh" ? "zh" : "en";
-  await reconcileLegacyContext7InstallState(
-    { name: "context7-plugin" },
-    language,
-    config,
-    {
-      writeConfigImpl,
-      removeMcpImpl,
-      readUserMcpConfigImpl,
-      logImpl,
-    }
-  );
-}
-
-function toUninstallTarget(entry) {
-  return {
-    name: entry.name,
-    uninstallSpec: entry.uninstallSpec,
-    uninstallArgs: entry.uninstallArgs || [],
-    marketplaceId: entry.marketplaceId,
-    scope: entry.scope,
-  };
-}
-
-function isBrokenSymlink(pathname) {
-  try {
-    return lstatSync(pathname).isSymbolicLink();
-  } catch {
-    return false;
-  }
-}

package/cli/uninstall-workflow.js

@@ -1,146 +0,0 @@
-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")}`)
-  );
-}

package/cli/uninstall.js

@@ -1,42 +0,0 @@
-/**
- * uninstall command — remove curdx-flow plugin (and optionally recommended plugins / artifacts).
- */
-
-import { log } from "./utils.js";
-import {
-  createUninstallContext,
-  ensureClaudeCliAvailableForUninstall,
-  printUninstallSummary,
-  removeProtocolsStep,
-  confirmUninstallStep,
-} from "./uninstall-workflow.js";
-import {
-  maybePurgeRuntimeArtifacts,
-  maybeRemoveBundledMcps,
-  maybeRemoveProjectState,
-  maybeUninstallRecommendedPlugins,
-  maybeUninstallRequiredPlugins,
-  uninstallCurdxFlowPlugin,
-} from "./uninstall-actions.js";
-
-export async function uninstall(args = []) {
-  const context = createUninstallContext(args);
-
-  log.title("🗑️  CurdX-Flow Uninstaller");
-
-  ensureClaudeCliAvailableForUninstall();
-
-  if (!(await confirmUninstallStep(context))) {
-    return;
-  }
-
-  await uninstallCurdxFlowPlugin();
-  await maybeUninstallRecommendedPlugins(context);
-  await maybeRemoveBundledMcps(context);
-  await maybeUninstallRequiredPlugins(context);
-  await maybePurgeRuntimeArtifacts(context);
-  removeProtocolsStep();
-  await maybeRemoveProjectState(context);
-
-  printUninstallSummary(context);
-}

package/cli/upgrade-workflow.js

@@ -1,80 +0,0 @@
-import { claudeVersion, color, listPlugins, log, resultLastLine } from "./utils.js";
-
-export const UPGRADE_STEP_COUNT = 3;
-
-export function ensureClaudeCliAvailableForUpgrade(
-  { claudeVersionImpl = claudeVersion, logImpl = log, exitImpl = process.exit } = {}
-) {
-  const version = claudeVersionImpl();
-  if (!version) {
-    logImpl.err("claude CLI not found");
-    exitImpl(1);
-    return null;
-  }
-
-  return version;
-}
-
-export function getInstalledPluginNames({ listPluginsImpl = listPlugins } = {}) {
-  return new Set(listPluginsImpl().map((plugin) => plugin.name));
-}
-
-export function getPluginNameFromSpec(spec) {
-  return String(spec).split("@")[0];
-}
-
-export function classifyPluginUpdateResult(result) {
-  if (result.code !== 0) {
-    return {
-      status: "failed",
-      message: resultLastLine(result),
-    };
-  }
-
-  if (!result.stdout.includes("updated from")) {
-    return {
-      status: "unchanged",
-      message: "already up to date",
-    };
-  }
-
-  const match = result.stdout.match(/updated from (\S+) to (\S+)/);
-  if (!match) {
-    return {
-      status: "updated",
-      message: "updated",
-    };
-  }
-
-  return {
-    status: "updated",
-    from: match[1],
-    to: match[2],
-    message: color.dim(`${match[1]} → ${match[2]}`),
-  };
-}
-
-export async function refreshMarketplaces(
-  marketplaceIds,
-  { updatePluginMarketplaceImpl, logImpl = log } = {}
-) {
-  logImpl.step(1, UPGRADE_STEP_COUNT, "Refreshing marketplaces...");
-
-  for (const marketplaceId of marketplaceIds) {
-    const result = await updatePluginMarketplaceImpl(marketplaceId);
-    if (result.code === 0) {
-      logImpl.ok(`   ${marketplaceId}`);
-      continue;
-    }
-
-    if (!result.stderr.includes("not found")) {
-      logImpl.warn(`   ${marketplaceId}: ${resultLastLine(result)}`);
-    }
-  }
-}
-
-export function printUpgradeSummary({ logImpl = log } = {}) {
-  logImpl.blank();
-  logImpl.ok("Upgrade complete");
-  console.log(color.dim("   Some changes require a Claude Code restart to take effect"));
-}

package/cli/upgrade.js

@@ -1,91 +0,0 @@
-/**
- * upgrade command — update curdx-flow + recommended plugins to latest.
- */
-
-import { log, readConfig } from "./utils.js";
-import { reconcileLegacyContext7InstallState } from "./install-context7-config.js";
-import {
-  PLUGINS_TO_UPDATE,
-  MARKETPLACES_TO_REFRESH,
-} from "./registry.js";
-import {
-  updatePlugin,
-  updatePluginMarketplace,
-} from "./lib/claude-ops.js";
-import {
-  classifyPluginUpdateResult,
-  ensureClaudeCliAvailableForUpgrade,
-  getInstalledPluginNames,
-  getPluginNameFromSpec,
-  printUpgradeSummary,
-  refreshMarketplaces,
-  UPGRADE_STEP_COUNT,
-} from "./upgrade-workflow.js";
-
-export async function upgrade(
-  args = [],
-  {
-    updatePluginImpl = updatePlugin,
-    updatePluginMarketplaceImpl = updatePluginMarketplace,
-    ensureClaudeCliAvailableForUpgradeImpl = ensureClaudeCliAvailableForUpgrade,
-    getInstalledPluginNamesImpl = getInstalledPluginNames,
-    readConfigImpl = readConfig,
-    reconcileLegacyContext7InstallStateImpl = reconcileLegacyContext7InstallState,
-    logImpl = log,
-  } = {}
-) {
-  logImpl.title("⬆️  CurdX-Flow upgrade");
-
-  ensureClaudeCliAvailableForUpgradeImpl({ logImpl });
-
-  // Refresh marketplaces first (derived from cli/registry.js)
-  await refreshMarketplaces(MARKETPLACES_TO_REFRESH, {
-    updatePluginMarketplaceImpl,
-    logImpl,
-  });
-
-  // Update each plugin
-  logImpl.blank();
-  logImpl.step(2, UPGRADE_STEP_COUNT, "Updating installed plugins...");
-  const installedNames = getInstalledPluginNamesImpl();
-
-  for (const spec of PLUGINS_TO_UPDATE) {
-    const pluginName = getPluginNameFromSpec(spec);
-    if (!installedNames.has(pluginName)) {
-      logImpl.info(`   ${pluginName.padEnd(22)} not installed, skipping`);
-      continue;
-    }
-
-    const result = await updatePluginImpl(spec);
-    const status = classifyPluginUpdateResult(result);
-
-    if (status.status === "updated") {
-      logImpl.ok(`   ${pluginName.padEnd(22)} ${status.message}`);
-      continue;
-    }
-
-    if (status.status === "unchanged") {
-      logImpl.info(`   ${pluginName.padEnd(22)} ${status.message}`);
-      continue;
-    }
-
-    logImpl.warn(`   ${pluginName.padEnd(22)} ${status.message}`);
-  }
-
-  logImpl.blank();
-  logImpl.step(3, UPGRADE_STEP_COUNT, "Reconciling legacy Context7 state...");
-  if (installedNames.has("context7-plugin")) {
-    const config = readConfigImpl();
-    const language = config?.language === "zh" ? "zh" : "en";
-    await reconcileLegacyContext7InstallStateImpl(
-      { name: "context7-plugin" },
-      language,
-      config,
-      { logImpl }
-    );
-  } else {
-    logImpl.info("   context7-plugin          not installed, skipping");
-  }
-
-  printUpgradeSummary({ logImpl });
-}