@curdx/flow 3.4.0 → 3.5.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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

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)?',
@@ -528,6 +530,7 @@ var ralphSpecum = {
   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],
@@ -860,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);
@@ -875,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];
@@ -991,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"));
@@ -1006,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.4.0",
+  "version": "3.5.0",
   "description": "Interactive installer for Claude Code plugins and MCP servers",
   "type": "module",
   "bin": "./dist/index.mjs",