@curdx/flow 3.3.1 → 3.4.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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/).
 
+## 3.4.0 — 2026-04-27
+
+### Added
+
+- **`ralph-specum` is now a bundled plugin** — spec-driven development with autonomous task-by-task execution (research → requirements → design → tasks → implement, plus epic triage). Originally authored by [tzachbon](https://github.com/tzachbon/smart-ralph); ralph-specum v4.9.1 has been migrated into this repository as the canonical home and is no longer tracked against upstream. MIT license and authorship are preserved at `plugins/ralph-specum/LICENSE` and `plugins/ralph-specum/NOTICE.md`.
+- **curdx-flow itself is now a Claude Code marketplace** — the repo ships `.claude-plugin/marketplace.json` so Claude CLI can install bundled plugins via `claude plugin marketplace add curdx/curdx-flow` + `claude plugin install ralph-specum@curdx-flow`. The flow installer wires this up automatically; users just run `npx @curdx/flow install` and ralph-specum is pre-checked in the multiselect along with the other not-installed items.
+
+### Notes
+
+- If you previously installed ralph-specum from the upstream `tzachbon/smart-ralph` marketplace, run `claude plugin uninstall ralph-specum@smart-ralph` before installing this version to avoid a name collision. Going forward, only the `ralph-specum@curdx-flow` build is maintained.
+- Plugin files are not shipped in the npm tarball (`package.json` `files` is unchanged: `["dist", "CHANGELOG.md"]`). They live in the GitHub repo and are pulled by Claude CLI when the marketplace is added — so a `git push` of this repo must precede `npm publish` for a new release to be installable.
+
+## 3.3.2 — 2026-04-27
+
+### Fixed
+
+- **CLAUDE.md sync no longer skipped on the "nothing selected" path** — when a user upgraded flow with all tools already installed and ran `install`, the multiselect would show nothing pre-checked; pressing enter without a selection caused the flow to early-return before reaching the sync step, so the managed block was never added to CLAUDE.md. Each of `install` / `update` / `uninstall` now wraps its body in `try / finally` and runs the sync at the end of any non-cancelled exit (including "nothing to do" paths). User-cancelled flows (Ctrl+C, multiselect cancel, uninstall confirm "no") still skip the sync to respect intent.
+
 ## 3.3.1 — 2026-04-27
 
 ### Fixed

package/README.md

@@ -31,9 +31,12 @@ npx @curdx/flow --lang en    # override language
 | `claude-mem` | plugin | `thedotmack/claude-mem` |
 | `chrome-devtools-mcp` | plugin | `ChromeDevTools/chrome-devtools-mcp` |
 | `frontend-design` | plugin | `claude-plugins-official` (built-in) |
+| `ralph-specum` | plugin | bundled in this repo — spec-driven dev with autonomous task execution (originally [tzachbon/smart-ralph](https://github.com/tzachbon/smart-ralph), MIT) |
 | `sequential-thinking` | mcp | `@modelcontextprotocol/server-sequential-thinking` |
 | `context7` | mcp | HTTP — `https://mcp.context7.com/mcp` (optional API key) |
 
+> If you previously installed ralph-specum from `tzachbon/smart-ralph`, run `claude plugin uninstall ralph-specum@smart-ralph` before installing this version. Only the `ralph-specum@curdx-flow` build is maintained going forward.
+
 ## What it writes to your filesystem
 
 After every successful `install` / `update` / `uninstall`, flow keeps a short managed block in your global `~/.claude/CLAUDE.md` so Claude Code knows at session start which tools are installed and when to use them. The block looks like:

package/dist/index.mjs

@@ -518,6 +518,35 @@ var frontendDesign = {
 };
 var frontend_design_default = frontendDesign;
 
+// src/registry/plugins/ralph-specum.ts
+var PLUGIN_ID5 = "ralph-specum@curdx-flow";
+var PLUGIN_NAME3 = "ralph-specum";
+var MARKETPLACE_NAME4 = "curdx-flow";
+var MARKETPLACE_SOURCE4 = "curdx/curdx-flow";
+var ralphSpecum = {
+  id: "ralph-specum",
+  name: "ralph-specum",
+  description: "curdx-flow (originally tzachbon/smart-ralph) \u2014 spec-driven dev with autonomous task execution",
+  type: "plugin",
+  slashNamespace: "/ralph-specum:*",
+  whenToUse: "for spec-driven multi-task work \u2014 research \u2192 requirements \u2192 design \u2192 tasks \u2192 autonomous execution per task. Use when starting a feature that benefits from upfront spec; skip for one-shot fixes or simple edits.",
+  marketplaces: () => [MARKETPLACE_NAME4],
+  isInstalled: () => isPluginInstalled(PLUGIN_ID5),
+  installedVersion: async () => {
+    const p10 = await findPlugin(PLUGIN_ID5);
+    const v = p10?.version;
+    return v && v !== "unknown" ? v : null;
+  },
+  latestVersion: () => getMarketplacePluginVersion(MARKETPLACE_NAME4, PLUGIN_NAME3),
+  install: async (ctx) => {
+    await ensureMarketplace(MARKETPLACE_NAME4, MARKETPLACE_SOURCE4, ctx);
+    await installPluginById(PLUGIN_ID5, ctx);
+  },
+  uninstall: (ctx) => uninstallPluginById(PLUGIN_ID5, ctx),
+  update: (ctx) => updatePluginById(PLUGIN_ID5, ctx)
+};
+var ralph_specum_default = ralphSpecum;
+
 // src/registry/mcps/sequential-thinking.ts
 var MCP_NAME = "sequential-thinking";
 var sequentialThinking = {
@@ -615,6 +644,7 @@ var PKGS = [
   claude_mem_default,
   chrome_devtools_mcp_default,
   frontend_design_default,
+  ralph_specum_default,
   sequential_thinking_default,
   context7_default
 ];
@@ -952,48 +982,55 @@ async function maybeRefreshMarketplaces(opts) {
   );
 }
 async function installFlow(opts = {}) {
-  await maybeRefreshMarketplaces(opts);
-  const explicit = opts.all || opts.ids && opts.ids.length > 0;
-  const candidates = explicit ? selectFromIds(opts) : [...PKGS];
-  if (candidates.length === 0) {
-    p4.log.info(t("install.nothingSelected"));
-    return;
-  }
-  const stateMap = /* @__PURE__ */ new Map();
-  const sp = p4.spinner();
-  sp.start(t("state.checking"));
+  let userCancelled = false;
   try {
-    await Promise.all([listPlugins(), listMcp()]);
-    await Promise.all(
-      candidates.map(async (pkg) => {
-        stateMap.set(pkg.id, await deriveState(pkg));
-      })
-    );
-  } finally {
-    sp.stop(t("state.checked", { count: candidates.length }));
-  }
-  let targets;
-  if (explicit) {
-    targets = candidates;
-  } else {
-    const picked = await selectInteractive(stateMap);
-    if (picked === null) {
-      p4.cancel(t("app.cancelled"));
+    await maybeRefreshMarketplaces(opts);
+    const explicit = opts.all || opts.ids && opts.ids.length > 0;
+    const candidates = explicit ? selectFromIds(opts) : [...PKGS];
+    if (candidates.length === 0) {
+      p4.log.info(t("install.nothingSelected"));
       return;
     }
-    targets = picked;
-  }
-  if (targets.length === 0) {
-    p4.log.info(t("install.nothingSelected"));
-    return;
-  }
-  const results = [];
-  for (const pkg of targets) {
-    const state = stateMap.get(pkg.id) ?? { kind: "not_installed" };
-    results.push(await runOne(pkg, state, opts));
+    const stateMap = /* @__PURE__ */ new Map();
+    const sp = p4.spinner();
+    sp.start(t("state.checking"));
+    try {
+      await Promise.all([listPlugins(), listMcp()]);
+      await Promise.all(
+        candidates.map(async (pkg) => {
+          stateMap.set(pkg.id, await deriveState(pkg));
+        })
+      );
+    } finally {
+      sp.stop(t("state.checked", { count: candidates.length }));
+    }
+    let targets;
+    if (explicit) {
+      targets = candidates;
+    } else {
+      const picked = await selectInteractive(stateMap);
+      if (picked === null) {
+        userCancelled = true;
+        p4.cancel(t("app.cancelled"));
+        return;
+      }
+      targets = picked;
+    }
+    if (targets.length === 0) {
+      p4.log.info(t("install.nothingSelected"));
+      return;
+    }
+    const results = [];
+    for (const pkg of targets) {
+      const state = stateMap.get(pkg.id) ?? { kind: "not_installed" };
+      results.push(await runOne(pkg, state, opts));
+    }
+    summarize(results);
+  } finally {
+    if (!userCancelled) {
+      await syncFromState({ skip: opts.noClaudeMd });
+    }
   }
-  summarize(results);
-  await syncFromState({ skip: opts.noClaudeMd });
 }
 
 // src/flows/uninstall.ts
@@ -1017,80 +1054,88 @@ async function probeInstalled() {
   }
 }
 async function uninstallFlow(opts = {}) {
-  const installed = await probeInstalled();
-  let targets;
-  if (opts.ids && opts.ids.length > 0) {
-    targets = [];
-    for (const id of opts.ids) {
-      const pkg = findPkg(id);
-      if (!pkg) {
-        p5.log.warn(`Unknown id: ${id}`);
-        continue;
+  let userCancelled = false;
+  try {
+    const installed = await probeInstalled();
+    let targets;
+    if (opts.ids && opts.ids.length > 0) {
+      targets = [];
+      for (const id of opts.ids) {
+        const pkg = findPkg(id);
+        if (!pkg) {
+          p5.log.warn(`Unknown id: ${id}`);
+          continue;
+        }
+        if (!installed.some((x2) => x2.id === pkg.id)) {
+          p5.log.warn(`${pkg.name}: ${t("pkg.notInstalled")}`);
+          continue;
+        }
+        targets.push(pkg);
       }
-      if (!installed.some((x2) => x2.id === pkg.id)) {
-        p5.log.warn(`${pkg.name}: ${t("pkg.notInstalled")}`);
-        continue;
+    } else {
+      if (installed.length === 0) {
+        p5.log.info(t("uninstall.noneInstalled"));
+        return;
       }
-      targets.push(pkg);
+      const picked = await p5.multiselect({
+        message: t("uninstall.selectPrompt"),
+        options: installed.map((pkg) => ({
+          value: pkg.id,
+          label: `${pkg.name} ${pc2.dim(`(${pkg.type})`)}`,
+          hint: pkg.description
+        })),
+        required: false
+      });
+      if (p5.isCancel(picked)) {
+        userCancelled = true;
+        p5.cancel(t("app.cancelled"));
+        return;
+      }
+      targets = picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
     }
-  } else {
-    if (installed.length === 0) {
-      p5.log.info(t("uninstall.noneInstalled"));
+    if (targets.length === 0) {
+      p5.log.info(t("install.nothingSelected"));
       return;
     }
-    const picked = await p5.multiselect({
-      message: t("uninstall.selectPrompt"),
-      options: installed.map((pkg) => ({
-        value: pkg.id,
-        label: `${pkg.name} ${pc2.dim(`(${pkg.type})`)}`,
-        hint: pkg.description
-      })),
-      required: false
-    });
-    if (p5.isCancel(picked)) {
-      p5.cancel(t("app.cancelled"));
-      return;
-    }
-    targets = picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
-  }
-  if (targets.length === 0) {
-    p5.log.info(t("install.nothingSelected"));
-    return;
-  }
-  if (!opts.yes) {
-    const ok2 = await p5.confirm({
-      message: t("uninstall.confirm", { count: targets.length }),
-      initialValue: false
-    });
-    if (p5.isCancel(ok2) || ok2 === false) {
-      p5.cancel(t("app.cancelled"));
-      return;
+    if (!opts.yes) {
+      const ok2 = await p5.confirm({
+        message: t("uninstall.confirm", { count: targets.length }),
+        initialValue: false
+      });
+      if (p5.isCancel(ok2) || ok2 === false) {
+        userCancelled = true;
+        p5.cancel(t("app.cancelled"));
+        return;
+      }
     }
-  }
-  const results = [];
-  for (const pkg of targets) {
-    const log5 = p5.taskLog({ title: t("uninstall.starting", { name: pkg.name }) });
-    try {
-      await pkg.uninstall({ log: log5, config: {}, t });
-      log5.success(t("uninstall.success", { name: pkg.name }));
-      results.push({ id: pkg.id, status: "ok" });
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      log5.error(`${t("uninstall.failed", { name: pkg.name })}
+    const results = [];
+    for (const pkg of targets) {
+      const log5 = p5.taskLog({ title: t("uninstall.starting", { name: pkg.name }) });
+      try {
+        await pkg.uninstall({ log: log5, config: {}, t });
+        log5.success(t("uninstall.success", { name: pkg.name }));
+        results.push({ id: pkg.id, status: "ok" });
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log5.error(`${t("uninstall.failed", { name: pkg.name })}
 ${msg}`);
-      results.push({ id: pkg.id, status: "fail", message: msg });
+        results.push({ id: pkg.id, status: "fail", message: msg });
+      }
+    }
+    const ok = results.filter((r) => r.status === "ok").length;
+    const fail = results.filter((r) => r.status === "fail").length;
+    p5.note(
+      [
+        pc2.green(t("install.summaryOk", { count: ok })),
+        pc2.red(t("install.summaryFail", { count: fail }))
+      ].join("\n"),
+      t("install.summaryTitle")
+    );
+  } finally {
+    if (!userCancelled) {
+      await syncFromState({ skip: opts.noClaudeMd });
     }
   }
-  const ok = results.filter((r) => r.status === "ok").length;
-  const fail = results.filter((r) => r.status === "fail").length;
-  p5.note(
-    [
-      pc2.green(t("install.summaryOk", { count: ok })),
-      pc2.red(t("install.summaryFail", { count: fail }))
-    ].join("\n"),
-    t("install.summaryTitle")
-  );
-  await syncFromState({ skip: opts.noClaudeMd });
 }
 
 // src/flows/update.ts
@@ -1114,89 +1159,96 @@ async function probeInstalled2() {
   }
 }
 async function updateFlow(opts = {}) {
-  const installed = await probeInstalled2();
-  if (installed.length === 0) {
-    p6.log.info(t("update.noneInstalled"));
-    return;
-  }
-  let targets;
-  if (opts.all) {
-    targets = installed;
-  } else if (opts.ids && opts.ids.length > 0) {
-    targets = [];
-    for (const id of opts.ids) {
-      const pkg = findPkg(id);
-      if (!pkg) {
-        p6.log.warn(`Unknown id: ${id}`);
-        continue;
+  let userCancelled = false;
+  try {
+    const installed = await probeInstalled2();
+    if (installed.length === 0) {
+      p6.log.info(t("update.noneInstalled"));
+      return;
+    }
+    let targets;
+    if (opts.all) {
+      targets = installed;
+    } else if (opts.ids && opts.ids.length > 0) {
+      targets = [];
+      for (const id of opts.ids) {
+        const pkg = findPkg(id);
+        if (!pkg) {
+          p6.log.warn(`Unknown id: ${id}`);
+          continue;
+        }
+        if (!installed.some((x2) => x2.id === pkg.id)) {
+          p6.log.warn(`${pkg.name}: ${t("pkg.notInstalled")}`);
+          continue;
+        }
+        targets.push(pkg);
       }
-      if (!installed.some((x2) => x2.id === pkg.id)) {
-        p6.log.warn(`${pkg.name}: ${t("pkg.notInstalled")}`);
-        continue;
+    } else {
+      const picked = await p6.multiselect({
+        message: t("update.selectPrompt"),
+        options: installed.map((pkg) => ({
+          value: pkg.id,
+          label: `${pkg.name} ${pc3.dim(`(${pkg.type})`)}`,
+          hint: pkg.description
+        })),
+        required: false
+      });
+      if (p6.isCancel(picked)) {
+        userCancelled = true;
+        p6.cancel(t("app.cancelled"));
+        return;
       }
-      targets.push(pkg);
+      targets = picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
     }
-  } else {
-    const picked = await p6.multiselect({
-      message: t("update.selectPrompt"),
-      options: installed.map((pkg) => ({
-        value: pkg.id,
-        label: `${pkg.name} ${pc3.dim(`(${pkg.type})`)}`,
-        hint: pkg.description
-      })),
-      required: false
-    });
-    if (p6.isCancel(picked)) {
-      p6.cancel(t("app.cancelled"));
+    if (targets.length === 0) {
+      p6.log.info(t("install.nothingSelected"));
       return;
     }
-    targets = picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
-  }
-  if (targets.length === 0) {
-    p6.log.info(t("install.nothingSelected"));
-    return;
-  }
-  const results = [];
-  for (const pkg of targets) {
-    if (pkg.id === "sequential-thinking") {
-      p6.log.info(t("update.mcpAutoNote", { name: pkg.name }));
-      results.push({ id: pkg.id, status: "noop" });
-      continue;
-    }
-    if (pkg.id === "context7") {
-      p6.log.info(t("update.context7Note"));
-      results.push({ id: pkg.id, status: "noop" });
-      continue;
-    }
-    const log5 = p6.taskLog({ title: t("update.starting", { name: pkg.name }) });
-    try {
-      if (pkg.update) {
-        await pkg.update({ log: log5, config: {}, t });
-      } else {
-        await pkg.uninstall({ log: log5, config: {}, t });
-        await pkg.install({ log: log5, config: {}, t });
+    const results = [];
+    for (const pkg of targets) {
+      if (pkg.id === "sequential-thinking") {
+        p6.log.info(t("update.mcpAutoNote", { name: pkg.name }));
+        results.push({ id: pkg.id, status: "noop" });
+        continue;
       }
-      log5.success(t("update.success", { name: pkg.name }));
-      results.push({ id: pkg.id, status: "ok" });
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      log5.error(`${t("update.failed", { name: pkg.name })}
+      if (pkg.id === "context7") {
+        p6.log.info(t("update.context7Note"));
+        results.push({ id: pkg.id, status: "noop" });
+        continue;
+      }
+      const log5 = p6.taskLog({ title: t("update.starting", { name: pkg.name }) });
+      try {
+        if (pkg.update) {
+          await pkg.update({ log: log5, config: {}, t });
+        } else {
+          await pkg.uninstall({ log: log5, config: {}, t });
+          await pkg.install({ log: log5, config: {}, t });
+        }
+        log5.success(t("update.success", { name: pkg.name }));
+        results.push({ id: pkg.id, status: "ok" });
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log5.error(`${t("update.failed", { name: pkg.name })}
 ${msg}`);
-      results.push({ id: pkg.id, status: "fail", message: msg });
+        results.push({ id: pkg.id, status: "fail", message: msg });
+      }
+    }
+    const ok = results.filter((r) => r.status === "ok").length;
+    const fail = results.filter((r) => r.status === "fail").length;
+    const noop = results.filter((r) => r.status === "noop").length;
+    p6.note(
+      [
+        pc3.green(t("install.summaryOk", { count: ok })),
+        pc3.red(t("install.summaryFail", { count: fail })),
+        pc3.dim(`noop: ${noop}`)
+      ].join("\n"),
+      t("install.summaryTitle")
+    );
+  } finally {
+    if (!userCancelled) {
+      await syncFromState({ skip: opts.noClaudeMd });
     }
   }
-  const ok = results.filter((r) => r.status === "ok").length;
-  const fail = results.filter((r) => r.status === "fail").length;
-  const noop = results.filter((r) => r.status === "noop").length;
-  p6.note(
-    [
-      pc3.green(t("install.summaryOk", { count: ok })),
-      pc3.red(t("install.summaryFail", { count: fail })),
-      pc3.dim(`noop: ${noop}`)
-    ].join("\n"),
-    t("install.summaryTitle")
-  );
-  await syncFromState({ skip: opts.noClaudeMd });
 }
 
 // src/flows/status.ts
@@ -1361,7 +1413,7 @@ var SUBCOMMANDS = /* @__PURE__ */ new Set(["install", "uninstall", "update", "st
 var root = defineCommand({
   meta: {
     name: "@curdx/flow",
-    version: "3.3.1",
+    version: "3.3.2",
     description: "Interactive installer for Claude Code plugins and MCP servers"
   },
   args: sharedArgs,

package/package.json

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