@curdx/flow 4.0.0 → 5.0.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to `@curdx/flow` are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/) and the project follows [Semantic Versioning](https://semver.org/).
 
+## 4.0.1 — 2026-04-27
+
+### Fixed
+
+- **Migration cleanup is now exhaustive.** v4.0.0's auto-migration for the `ralph-specum` → `curdx-flow` rename only invoked `claude plugin uninstall`, which leaves substantial residue when the marketplace's plugin id has been renamed (the CLI can't resolve the legacy id and bails). The installer now manually purges every leftover artifact for legacy slugs (`ralph-specum@curdx-flow`, `ralph-specum@smart-ralph`):
+  - `~/.claude/settings.json` → removes `enabledPlugins[<legacyId>]`
+  - `~/.claude/plugins/installed_plugins.json` → removes `plugins[<legacyId>]`
+  - `~/.claude/plugins/cache/<marketplace>/<name>/` → recursive remove
+  - `~/.claude/plugins/data/<name>-<marketplace>/` → recursive remove
+  - Marketplace registrations (`known_marketplaces.json`, `extraKnownMarketplaces`) are deliberately left alone — those are user-managed.
+- Implementation lives in `src/runner/legacy-cleanup.ts::purgeLegacyPluginArtifacts`. Idempotent and safe: every step swallows ENOENT silently and reports JSON / IO errors via the install task log without failing the flow.
+
 ## 4.0.0 — 2026-04-27
 
 ### Breaking

package/dist/index.mjs

@@ -520,6 +520,78 @@ var frontendDesign = {
 };
 var frontend_design_default = frontendDesign;
 
+// src/runner/legacy-cleanup.ts
+import { promises as fs2 } from "fs";
+import path2 from "path";
+import os2 from "os";
+async function purgeLegacyPluginArtifacts(legacyId, ctx) {
+  const at = legacyId.indexOf("@");
+  if (at <= 0 || at === legacyId.length - 1) return;
+  const name = legacyId.slice(0, at);
+  const marketplace = legacyId.slice(at + 1);
+  const home = os2.homedir();
+  const settingsPath = path2.join(home, ".claude", "settings.json");
+  const installedPath = path2.join(home, ".claude", "plugins", "installed_plugins.json");
+  const cacheDir = path2.join(home, ".claude", "plugins", "cache", marketplace, name);
+  const dataDir = path2.join(home, ".claude", "plugins", "data", `${name}-${marketplace}`);
+  let removedAny = false;
+  removedAny = await deleteJsonKey(settingsPath, ["enabledPlugins", legacyId], ctx) || removedAny;
+  removedAny = await deleteJsonKey(installedPath, ["plugins", legacyId], ctx) || removedAny;
+  removedAny = await rmDir(cacheDir, ctx) || removedAny;
+  removedAny = await rmDir(dataDir, ctx) || removedAny;
+  if (removedAny) {
+    ctx.log.message(`Purged legacy artifacts for ${legacyId}.`);
+    clearStateCache();
+  }
+}
+async function deleteJsonKey(filePath, keyPath, ctx) {
+  let raw;
+  try {
+    raw = await fs2.readFile(filePath, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") return false;
+    ctx.log.message(`Skip purge of ${filePath}: ${err.message}`);
+    return false;
+  }
+  let json;
+  try {
+    json = JSON.parse(raw);
+  } catch (err) {
+    ctx.log.message(`Skip purge of ${filePath}: invalid JSON (${err.message})`);
+    return false;
+  }
+  let cursor = json;
+  for (let i = 0; i < keyPath.length - 1; i++) {
+    const next = cursor?.[keyPath[i]];
+    if (!next || typeof next !== "object") return false;
+    cursor = next;
+  }
+  const finalKey = keyPath[keyPath.length - 1];
+  if (!cursor || !(finalKey in cursor)) return false;
+  delete cursor[finalKey];
+  try {
+    await fs2.writeFile(filePath, JSON.stringify(json, null, 2) + "\n", "utf8");
+    return true;
+  } catch (err) {
+    ctx.log.message(`Failed to rewrite ${filePath}: ${err.message}`);
+    return false;
+  }
+}
+async function rmDir(dirPath, ctx) {
+  try {
+    await fs2.access(dirPath);
+  } catch {
+    return false;
+  }
+  try {
+    await fs2.rm(dirPath, { recursive: true, force: true });
+    return true;
+  } catch (err) {
+    ctx.log.message(`Failed to remove ${dirPath}: ${err.message}`);
+    return false;
+  }
+}
+
 // src/registry/plugins/curdx-flow.ts
 var PLUGIN_ID5 = "curdx-flow@curdx";
 var PLUGIN_NAME3 = "curdx-flow";
@@ -528,10 +600,12 @@ var MARKETPLACE_SOURCE4 = "curdx/curdx-flow";
 var LEGACY_PLUGIN_IDS = ["ralph-specum@curdx-flow", "ralph-specum@smart-ralph"];
 async function uninstallLegacyIfPresent(ctx) {
   for (const legacyId of LEGACY_PLUGIN_IDS) {
-    if (await isPluginInstalled(legacyId)) {
+    const installed = await isPluginInstalled(legacyId);
+    if (installed) {
       ctx.log.message(`Removing legacy plugin ${legacyId} (renamed to ${PLUGIN_ID5})\u2026`);
       await uninstallPluginById(legacyId, ctx);
     }
+    await purgeLegacyPluginArtifacts(legacyId, ctx);
   }
 }
 var curdxFlow = {
@@ -669,15 +743,15 @@ function findPkg(id) {
 }
 
 // src/runner/claudeMd.ts
-import { promises as fs2 } from "fs";
-import path2 from "path";
-import os2 from "os";
+import { promises as fs3 } from "fs";
+import path3 from "path";
+import os3 from "os";
 import * as p3 from "@clack/prompts";
 var BEGIN_MARKER = "<!-- BEGIN @curdx/flow v1 -->";
 var END_MARKER = "<!-- END @curdx/flow v1 -->";
 var BLOCK_RE = /<!-- BEGIN @curdx\/flow v\d+[^>]*-->[\s\S]*?<!-- END @curdx\/flow v\d+ -->/;
 function claudeMdPath() {
-  return path2.join(os2.homedir(), ".claude", "CLAUDE.md");
+  return path3.join(os3.homedir(), ".claude", "CLAUDE.md");
 }
 function renderItemLine(item) {
   let line = `- ${item.name}`;
@@ -786,7 +860,7 @@ async function syncClaudeMd(opts) {
     let existing = "";
     let existed = true;
     try {
-      existing = await fs2.readFile(file, "utf8");
+      existing = await fs3.readFile(file, "utf8");
     } catch (err) {
       if (err.code === "ENOENT") {
         existed = false;
@@ -808,10 +882,10 @@ async function syncClaudeMd(opts) {
     if (next === existing) {
       return { status: "unchanged", path: file };
     }
-    await fs2.mkdir(path2.dirname(file), { recursive: true });
+    await fs3.mkdir(path3.dirname(file), { recursive: true });
     const tmp = `${file}.tmp.${process.pid}`;
-    await fs2.writeFile(tmp, next, "utf8");
-    await fs2.rename(tmp, file);
+    await fs3.writeFile(tmp, next, "utf8");
+    await fs3.rename(tmp, file);
     if (!existed) return { status: "created", path: file };
     if (hadBlock && items.length === 0) return { status: "removed", path: file };
     return { status: "updated", path: file };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curdx/flow",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "Interactive installer for Claude Code plugins and MCP servers",
   "type": "module",
   "bin": "./dist/index.mjs",