@curdx/flow 7.1.19 → 7.1.20

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/).
 
+## 7.1.20 — 2026-05-11
+
+### Changed
+
+- **Companion capabilities are now the default required bundle.** `pua`, `claude-mem`, `chrome-devtools-mcp`, `frontend-design`, `sequential-thinking`, and `context7` are marked `required` in the installer alongside `curdx-flow`, so interactive installs show them as always installed and `--ids` installs auto-include missing required companions.
+- **Official plugin dependency metadata added.** `curdx-flow` now declares plugin dependencies for `pua`, `claude-mem`, `chrome-devtools-mcp`, and `frontend-design`, and the root marketplace explicitly allows those cross-marketplace dependencies.
+- **Capability routing marks bundled companions as `core-required`.** Smart-route recommendations still trigger only when relevant, but recommended bundled capabilities are no longer suppressed by narrow availability filters.
+
+### Tests
+
+- Added registry and manifest regression coverage for the required bundle, expanded capability-router expectations, rebuilt hook bundles, and tightened `claudecc` smoke checks for `core-required` recommendations.
+
 ## 7.1.19 — 2026-05-11
 
 ### Added

package/README.md

@@ -123,7 +123,7 @@ The same npm package delivers both products. The installer reads its descriptor
 
 - **Node.js** ≥ 20.12 ([download](https://nodejs.org))
 - **Claude Code CLI** installed and on `PATH` ([install instructions](https://docs.anthropic.com/en/docs/claude-code))
-- *(Optional)* **Bun** ≥ 1.0 — auto-detected; the installer offers to install it if you choose `claude-mem`
+- *(Optional)* **Bun** ≥ 1.0 — auto-detected; the installer offers to install it for the default `claude-mem` companion
 
 ### Install
 
@@ -131,7 +131,7 @@ The same npm package delivers both products. The installer reads its descriptor
 npx @curdx/flow
 ```
 
-On first run, you pick a language (中文 / English), then select what to install. The bundled `curdx-flow` plugin (the spec workflow itself) is always installed. Everything else is opt-in.
+On first run, you pick a language (中文 / English). The full curdx-flow bundle is installed by default: `curdx-flow`, `pua`, `claude-mem`, `chrome-devtools-mcp`, `frontend-design`, `sequential-thinking`, and `context7`. If a companion has a local prerequisite that is missing, the installer reports the skip reason and continues so the core workflow remains usable.
 
 That language choice also controls the managed `~/.claude/CLAUDE.md` block that flow writes. The block is rendered in the selected language, and when you choose `zh` it additionally injects a language policy telling Claude to keep tool/model interaction in English while replying to the user in Simplified Chinese.
 
@@ -428,9 +428,9 @@ Most workflow frameworks address this by adding more agents, more orchestration,
 
 No. flow runs **inside** Claude Code as a plugin. You still use the Claude Code CLI / IDE extension to chat; flow adds the `/curdx-flow:*` commands, subagents, hooks, and the bundled marketplace.
 
-#### Can I use flow without installing the marketplace plugins?
+#### Can I use flow without the companion capabilities?
 
-Yes. The bundled `curdx-flow` plugin is the spec workflow itself; everything else (claude-mem, chrome-devtools-mcp, …) is opt-in. `npx @curdx/flow install` lets you pick.
+The default installer treats the companion capabilities as required because routing depends on them for memory, current docs, frontend design, browser verification, structured reasoning, and retry/parallel recovery. If a local prerequisite is missing, that item may be skipped with a visible reason, but the next `npx @curdx/flow install` run will try to restore it.
 
 #### Do I need to commit the spec files?
 

package/dist/index.mjs

@@ -514,6 +514,7 @@ var pua = {
   name: "pua",
   description: "tanweai/pua \u2014 Chinese Claude Code skills bundle",
   type: "plugin",
+  required: true,
   slashNamespace: "/pua:*",
   whenToUse: "auto-fires on 2+ failures or user frustration; sub-modes p7 / p9 / pro / loop. Skip on first-attempt failures or when a known fix is executing.",
   marketplaces: () => [MARKETPLACE_NAME],
@@ -609,6 +610,7 @@ var claudeMem = {
   name: "claude-mem",
   description: "thedotmack/claude-mem \u2014 persistent cross-session memory for Claude Code",
   type: "plugin",
+  required: true,
   slashNamespace: "/claude-mem:*",
   whenToUse: 'for cross-session memory search ("did we solve this before?"), phased planning (`make-plan`), or phased execution (`do`).',
   marketplaces: () => [MARKETPLACE_NAME2],
@@ -668,6 +670,7 @@ var chromeDevtoolsMcp = {
   name: "chrome-devtools-mcp",
   description: "ChromeDevTools/chrome-devtools-mcp \u2014 drive a real Chrome from Claude Code",
   type: "plugin",
+  required: true,
   whenToUse: "when debugging code that runs in a browser: perf traces, network / console inspection, DOM / CSS issues. Prefer snapshot over screenshot.",
   prereqCheck: async (t2) => {
     const major = Number(process.versions.node.split(".")[0] ?? "0");
@@ -697,6 +700,7 @@ var frontendDesign = {
   name: "frontend-design",
   description: "Anthropic official \u2014 UI/frontend design helpers",
   type: "plugin",
+  required: true,
   whenToUse: "auto-fires when building UI / web components / pages. Best where visual personality matters (landing, marketing, portfolio).",
   isInstalled: () => isPluginInstalled(PLUGIN_ID4),
   install: (ctx) => installPluginById(PLUGIN_ID4, ctx),
@@ -742,6 +746,7 @@ var sequentialThinking = {
   name: "sequential-thinking",
   description: "modelcontextprotocol/server-sequential-thinking \u2014 structured reasoning helper",
   type: "mcp",
+  required: true,
   whenToUse: "for complex multi-step problems where assumptions may shift (architecture comparison, risk-assessed migrations, prod-only debugging). Skip for simple queries.",
   isInstalled: () => isMcpInstalled(MCP_NAME),
   install: async (ctx) => {
@@ -783,6 +788,7 @@ var context7 = {
   name: "context7",
   description: "upstash/context7 \u2014 up-to-date docs from any library (HTTP MCP, optional API key)",
   type: "mcp",
+  required: true,
   whenToUse: "for any library / SDK / framework / API / Claude Code docs lookup. Use instead of web search.",
   isInstalled: () => isMcpInstalled(MCP_NAME2),
   configPrompts: async ({ t: t2 }) => {
@@ -913,7 +919,15 @@ var ORDER = [
   "sequential-thinking",
   "pua"
 ];
-var DOCS_RE = /\b(api|sdk|library|libraries|framework|docs?|documentation|version|upgrade|dependency|dependencies|claude code|plugin|mcp|hook|hooks|skill|skills|agent|agents|react|vue|spring|spring boot|spring cloud|next\.?js|vite|webpack|npm|node)\b|最新|文档|依赖|框架|插件|官方|联网|搜索/i;
+var CORE_REQUIRED = /* @__PURE__ */ new Set([
+  "context7",
+  "claude-mem",
+  "frontend-design",
+  "chrome-devtools-mcp",
+  "sequential-thinking",
+  "pua"
+]);
+var EXTERNAL_DOCS_RE = /\b(api|sdk|library|libraries|framework|version|upgrade|dependency|dependencies|official docs?|latest docs?|claude code|plugin|mcp|hook|hooks|skill|skills|agent|agents|react|vue|spring|spring boot|spring cloud|next\.?js|vite|webpack|npm|node)\b|最新|依赖|框架|插件|官方|联网|搜索|文档.*(最新|官方|API|SDK|框架|插件|依赖)/i;
 var MEMORY_RE = /\b(previous|before|again|remember|memory|history|similar|repeated|regression|already solved|same bug|past decision)\b|之前|上次|记得|历史|做过|又|重复|老问题/i;
 var UI_RE = /\b(ui|ux|frontend|front-end|browser|chrome|dom|css|html|layout|component|page|form|modal|responsive|visual|render|react|vue|vite|next\.?js|screenshot|interaction)\b|前端|页面|浏览器|样式|交互|组件|布局|视觉|截图/i;
 var BROWSER_VERIFY_RE = /\b(browser|chrome|dom|css|network|console|performance|render|screenshot|e2e|playwright|visual regression|interaction)\b|浏览器|控制台|网络|性能|渲染|截图|端到端/i;
@@ -928,11 +942,14 @@ function hasAny(values, candidates) {
   const set = new Set((values ?? []).map((v) => v.toLowerCase()));
   return candidates.some((candidate) => set.has(candidate.toLowerCase()));
 }
-function capabilityAllowed(id, available) {
-  return available === null || available.has(id);
+function capabilityAvailability(id, available) {
+  if (CORE_REQUIRED.has(id)) return "core-required";
+  if (available === null) return "check-if-installed";
+  return available.has(id) ? "known-available" : null;
 }
 function pushRecommendation(out, available, id, phase, reason, instruction) {
-  if (!capabilityAllowed(id, available)) return;
+  const availability = capabilityAvailability(id, available);
+  if (availability === null) return;
   if (out.some((rec) => rec.id === id)) return;
   const cap = CAPABILITIES[id];
   out.push({
@@ -941,6 +958,7 @@ function pushRecommendation(out, available, id, phase, reason, instruction) {
     type: cap.type,
     invocation: cap.invocation,
     phase,
+    availability,
     reason,
     instruction
   });
@@ -960,16 +978,17 @@ function recommendToolCapabilities(input) {
   if (missingRoots > 0) {
     return recs;
   }
-  const localLowRisk = LOW_RISK_LOCAL_RE.test(goal) && route === "direct-change";
+  const externalDocsRelevant = EXTERNAL_DOCS_RE.test(goal);
+  const localLowRisk = LOW_RISK_LOCAL_RE.test(goal) && route === "direct-change" && !externalDocsRelevant;
   if (localLowRisk) {
     return recs;
   }
   const hasFrontend = UI_RE.test(goal) || hasAny(topologyKinds, ["frontend-app"]) || hasAny(topologyFrameworks, ["react", "vue", "next.js", "vite"]);
   const browserRuntime = BROWSER_VERIFY_RE.test(goal) || hasFrontend;
-  const complex = COMPLEX_RE.test(goal) || risk === "high" || risk === "critical" || route === "full-spec" || route === "epic-split";
+  const complex = COMPLEX_RE.test(goal) && route !== "direct-change" || risk === "high" || risk === "critical" || route === "full-spec" || route === "epic-split";
   const stuck = STUCK_RE.test(goal);
   const parallel = PARALLEL_RE.test(goal) || route === "epic-split";
-  if (DOCS_RE.test(goal)) {
+  if (externalDocsRelevant) {
     pushRecommendation(
       recs,
       available,
@@ -1045,25 +1064,25 @@ function renderInstalledCapabilityRules(availableCapabilities) {
 }
 function renderCapabilityDecisionTree(availableCapabilities) {
   const available = new Set(availableCapabilities);
-  const lines = [
-    "1. Can the edit be finished safely from local code in 1-2 steps? -> Do it directly."
+  const rules = [
+    "Can the edit be finished safely from local code in 1-2 steps? -> Do it directly."
   ];
   if (available.has("context7")) {
-    lines.push("2. Does correctness depend on external docs, SDKs, APIs, or Claude Code behavior? -> use the Context7 MCP before editing.");
+    rules.push("Does correctness depend on external docs, SDKs, APIs, or Claude Code behavior? -> use the Context7 MCP before editing.");
   }
   if (available.has("claude-mem")) {
-    lines.push("3. Might similar work, a prior decision, or a repeated failure exist? -> Start with `/claude-mem:mem-search`.");
+    rules.push("Might similar work, a prior decision, or a repeated failure exist? -> Start with `/claude-mem:mem-search`.");
   }
   if (available.has("frontend-design") || available.has("chrome-devtools-mcp")) {
-    lines.push("4. Is visible frontend behavior in scope? -> Use frontend-design for UI decisions and Chrome DevTools MCP for runtime proof when installed.");
+    rules.push("Is visible frontend behavior in scope? -> Use frontend-design for UI decisions and Chrome DevTools MCP for runtime proof when installed.");
   }
   if (available.has("sequential-thinking")) {
-    lines.push("5. Is the work high-risk, architectural, or assumption-heavy? -> Use sequential-thinking after reading the relevant code.");
+    rules.push("Is the work high-risk, architectural, or assumption-heavy? -> Use sequential-thinking after reading the relevant code.");
   }
   if (available.has("pua")) {
-    lines.push("6. Are there multiple failed attempts or truly independent parallel slices? -> Use `/pua:pua-loop` for recovery or `/pua:p9` for bounded parallel planning.");
+    rules.push("Are there multiple failed attempts or truly independent parallel slices? -> Use `/pua:pua-loop` for recovery or `/pua:p9` for bounded parallel planning.");
   }
-  return lines;
+  return rules.map((rule, idx) => `${idx + 1}. ${rule}`);
 }
 function parseList(value) {
   if (!value) return [];
@@ -1133,7 +1152,7 @@ function buildSkipRules(ids) {
 function buildDecisionTree(ids) {
   const out = renderCapabilityDecisionTree([...ids]);
   if (ids.has("curdx-flow")) {
-    out.push("7. Is the request ambiguous, cross-cutting, phase-based, or multi-root? -> Run /curdx-flow:start.");
+    out.push(`${out.length + 1}. Is the request ambiguous, cross-cutting, phase-based, or multi-root? -> Run /curdx-flow:start.`);
   }
   return out;
 }

package/package.json

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