@curdx/flow 3.3.2 → 3.5.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 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.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
+
+- **`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

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

@@ -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,6 +520,36 @@ 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",
+  required: true,
+  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 +647,7 @@ var PKGS = [
   claude_mem_default,
   chrome_devtools_mcp_default,
   frontend_design_default,
+  ralph_specum_default,
   sequential_thinking_default,
   context7_default
 ];
@@ -830,11 +863,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);
@@ -845,7 +884,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];
@@ -961,6 +1002,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"));
@@ -976,7 +1024,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.3.2",
+  "version": "3.5.0",
   "description": "Interactive installer for Claude Code plugins and MCP servers",
   "type": "module",
   "bin": "./dist/index.mjs",