@curdx/flow 3.4.0 → 4.0.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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.0 — 2026-04-27
+
+### Breaking
+
+- **Plugin renamed `ralph-specum` → `curdx-flow`.** The bundled spec-driven workflow plugin now lives under the `curdx-flow` brand, slash namespace `/curdx-flow:*`, full slug `curdx-flow@curdx`. The marketplace identifier was simultaneously shortened from `curdx-flow` to `curdx` (the GitHub repo source `curdx/curdx-flow` is unchanged). All in-plugin slash references, env vars (`RALPH_SPECUM_*` → `CURDX_FLOW_*`), and labels were updated accordingly.
+- **Auto-migration:** the installer now detects legacy `ralph-specum@curdx-flow` and `ralph-specum@smart-ralph` installs and uninstalls them automatically before installing the new slug, so users on v3.4 / v3.5 transparently transition. Your `specs/` directory and any in-progress spec state files are not touched — the rename is purely a plugin-identity change.
+- **Manual fallback:** if you'd rather run the migration yourself, execute `claude plugin uninstall ralph-specum@curdx-flow` (or `@smart-ralph`) before re-running `npx @curdx/flow install`. The old marketplace `curdx-flow` may remain registered alongside the new `curdx` marketplace; this is harmless and you can `claude plugin marketplace remove curdx-flow` if you want to clean up.
+
+### Notes
+
+- The plugin's authorship and license lineage (smart-ralph by tzachbon → ralph-specum fork → curdx-flow) is recorded in `plugins/curdx-flow/NOTICE.md`. MIT License preserved.
+- `.claude-plugin/marketplace.json` now declares one plugin: `curdx-flow` v4.9.1 sourced from `./plugins/curdx-flow`.
+
+## 3.5.0 — 2026-04-27
+
+### Changed
+
+- **`ralph-specum` is now a required bundled plugin** — it no longer appears as an optional checkbox in the install multiselect. Instead, it's listed in a dedicated "always installed" header above the prompt, alongside its current state (not installed / up-to-date / update available). When the flow runs, ralph-specum is auto-installed or auto-updated whenever it needs action; up-to-date installs are silently skipped. The other six items (pua, claude-mem, chrome-devtools-mcp, frontend-design, sequential-thinking, context7) remain optional. `--ids X` now also auto-includes required plugins that need action; users can still explicitly run `--ids ralph-specum` to force a reinstall confirmation. Uninstall flow is unchanged — users may still uninstall ralph-specum, and the next install will re-add it.
+- **Internal:** `Pkg` type gains a `required?: boolean` field so future bundled plugins can opt into the same "always installed" semantics without touching install-flow code.
+
 ## 3.4.0 — 2026-04-27
 
 ### Added

package/README.md

@@ -31,11 +31,13 @@ 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) |
+| `curdx-flow` | plugin | bundled in this repo (always installed) — spec-driven dev with autonomous task execution (originally [tzachbon/smart-ralph](https://github.com/tzachbon/smart-ralph), MIT, intermediate fork: ralph-specum) |
 | `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.
+> Migration notes:
+> - If you installed the upstream `ralph-specum@smart-ralph` build, run `claude plugin uninstall ralph-specum@smart-ralph` before upgrading.
+> - If you installed `ralph-specum@curdx-flow` (curdx-flow v3.4.0 / v3.5.0), run `claude plugin uninstall ralph-specum@curdx-flow` and re-run `npx @curdx/flow install`. The plugin is now `curdx-flow@curdx` with slash namespace `/curdx-flow:*`.
 
 ## What it writes to your filesystem
 

package/dist/index.mjs

@@ -30,6 +30,7 @@ var messages = {
   "marketplace.refreshed": "\u5DF2\u5237\u65B0 {count} \u4E2A marketplace",
   "marketplace.refreshSkipped": "marketplace \u7F13\u5B58\u4ECD\u662F\u65B0\u9C9C\u7684\uFF0C\u8DF3\u8FC7\u5237\u65B0",
   "install.updating": '\u66F4\u65B0 "{name}" \u5230 v{version}',
+  "install.requiredHeader": "\u4EE5\u4E0B\u6761\u76EE\u968F @curdx/flow \u9ED8\u8BA4\u5B89\u88C5\uFF08\u4E0D\u53EF\u53D6\u6D88\uFF09",
   "install.selectPrompt": "\u52FE\u9009\u8981\u5B89\u88C5 / \u91CD\u88C5\u7684\u6761\u76EE\uFF08\u9ED8\u8BA4\u52FE\u9009\u672A\u5B89\u88C5\u7684\uFF09",
   "install.nothingSelected": "\u6CA1\u6709\u9009\u62E9\u4EFB\u4F55\u6761\u76EE\uFF0C\u5DF2\u9000\u51FA\u3002",
   "install.confirmReinstall": '"{name}" \u5DF2\u5B89\u88C5\uFF0C\u662F\u5426\u91CD\u65B0\u5B89\u88C5\uFF08\u5148\u5378\u8F7D\u518D\u5B89\u88C5\uFF09\uFF1F',
@@ -101,6 +102,7 @@ var messages2 = {
   "marketplace.refreshed": "Refreshed {count} marketplace(s)",
   "marketplace.refreshSkipped": "Marketplace caches are fresh, skipping refresh",
   "install.updating": 'Updating "{name}" to v{version}',
+  "install.requiredHeader": "Always installed by @curdx/flow (cannot be unchecked)",
   "install.selectPrompt": "Select items to install / reinstall (not-installed are pre-selected)",
   "install.nothingSelected": "Nothing selected. Exiting.",
   "install.confirmReinstall": '"{name}" is already installed. Reinstall (uninstall then install)?',
@@ -518,17 +520,27 @@ 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";
+// src/registry/plugins/curdx-flow.ts
+var PLUGIN_ID5 = "curdx-flow@curdx";
+var PLUGIN_NAME3 = "curdx-flow";
+var MARKETPLACE_NAME4 = "curdx";
 var MARKETPLACE_SOURCE4 = "curdx/curdx-flow";
-var ralphSpecum = {
-  id: "ralph-specum",
-  name: "ralph-specum",
+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)) {
+      ctx.log.message(`Removing legacy plugin ${legacyId} (renamed to ${PLUGIN_ID5})\u2026`);
+      await uninstallPluginById(legacyId, ctx);
+    }
+  }
+}
+var curdxFlow = {
+  id: "curdx-flow",
+  name: "curdx-flow",
   description: "curdx-flow (originally tzachbon/smart-ralph) \u2014 spec-driven dev with autonomous task execution",
   type: "plugin",
-  slashNamespace: "/ralph-specum:*",
+  required: true,
+  slashNamespace: "/curdx-flow:*",
   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),
@@ -539,13 +551,17 @@ var ralphSpecum = {
   },
   latestVersion: () => getMarketplacePluginVersion(MARKETPLACE_NAME4, PLUGIN_NAME3),
   install: async (ctx) => {
+    await uninstallLegacyIfPresent(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)
+  update: async (ctx) => {
+    await uninstallLegacyIfPresent(ctx);
+    await updatePluginById(PLUGIN_ID5, ctx);
+  }
 };
-var ralph_specum_default = ralphSpecum;
+var curdx_flow_default = curdxFlow;
 
 // src/registry/mcps/sequential-thinking.ts
 var MCP_NAME = "sequential-thinking";
@@ -644,7 +660,7 @@ var PKGS = [
   claude_mem_default,
   chrome_devtools_mcp_default,
   frontend_design_default,
-  ralph_specum_default,
+  curdx_flow_default,
   sequential_thinking_default,
   context7_default
 ];
@@ -860,11 +876,17 @@ function stateLabel(pkg, s) {
   }
 }
 async function selectInteractive(states) {
-  const options = PKGS.map((pkg) => {
+  const requiredPkgs = PKGS.filter((pkg) => pkg.required);
+  const optionalPkgs = PKGS.filter((pkg) => !pkg.required);
+  if (requiredPkgs.length > 0) {
+    const lines = requiredPkgs.map((pkg) => `  ${stateLabel(pkg, states.get(pkg.id))}`);
+    p4.note(lines.join("\n"), t("install.requiredHeader"));
+  }
+  const options = optionalPkgs.map((pkg) => {
     const s = states.get(pkg.id);
     return { value: pkg.id, label: stateLabel(pkg, s), hint: pkg.description };
   });
-  const initialValues = PKGS.filter((pkg) => {
+  const initialValues = optionalPkgs.filter((pkg) => {
     const s = states.get(pkg.id);
     return s.kind === "not_installed" || s.kind === "update_available";
   }).map((pkg) => pkg.id);
@@ -875,7 +897,9 @@ async function selectInteractive(states) {
     required: false
   });
   if (p4.isCancel(picked)) return null;
-  return picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
+  const userPicked = picked.map((id) => findPkg(id)).filter((x2) => Boolean(x2));
+  const requiredAuto = requiredPkgs.filter((pkg) => states.get(pkg.id)?.kind !== "up_to_date");
+  return [...requiredAuto, ...userPicked];
 }
 function selectFromIds(opts) {
   if (opts.all) return [...PKGS];
@@ -991,6 +1015,13 @@ async function installFlow(opts = {}) {
       p4.log.info(t("install.nothingSelected"));
       return;
     }
+    if (opts.ids && opts.ids.length > 0) {
+      for (const pkg of PKGS) {
+        if (pkg.required && !candidates.some((c) => c.id === pkg.id)) {
+          candidates.push(pkg);
+        }
+      }
+    }
     const stateMap = /* @__PURE__ */ new Map();
     const sp = p4.spinner();
     sp.start(t("state.checking"));
@@ -1006,7 +1037,16 @@ async function installFlow(opts = {}) {
     }
     let targets;
     if (explicit) {
-      targets = candidates;
+      if (opts.ids && opts.ids.length > 0) {
+        const userListedIds = new Set(opts.ids);
+        targets = candidates.filter((pkg) => {
+          if (!pkg.required) return true;
+          if (userListedIds.has(pkg.id)) return true;
+          return stateMap.get(pkg.id)?.kind !== "up_to_date";
+        });
+      } else {
+        targets = candidates;
+      }
     } else {
       const picked = await selectInteractive(stateMap);
       if (picked === null) {

package/package.json

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