@curdx/flow 6.0.1 → 6.0.3

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 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/).
 
+## 6.0.3 — 2026-04-29
+
+### Changed
+
+- **`~/.claude/CLAUDE.md` injected block now uses combination-pattern playbook instead of flat rules list.** `src/runner/claudeMd.ts::renderBlock` emits three new sections — `Tool Combination Patterns`, `Skip Rules`, `Decision Tree` — all conditional on installed package ids so users only see guidance for tools they actually have. Previous `ALWAYS_ON_RULES` + `buildConditionalRules` (4 short bullets) replaced by `buildCombinationPatterns` / `buildSkipRules` / `buildDecisionTree` (≈40 lines). BEGIN/END markers + idempotent upsert behavior unchanged, so existing user-authored content above/below the block is preserved.
+
+## 6.0.2 — 2026-04-29
+
+### Added
+
+- **`CLAUDE.md` release runbook.** Documents the 5-field version-sync gate (`package.json` + `package-lock.json` root / `packages[""]` + `plugin.json` + `marketplace.json`), the tag-triggered npm publish workflow, and the historical drift incidents (v5.0.0 marketplace, v6.0.0 lockfile) so future sessions have a single-source SOP for cutting releases.
+- **`scripts/bump-version.mjs` + `npm run bump-version`.** Atomically writes the target version into all 5 fields, then shells out to `check-versions` to confirm. `npm version` handles `package.json` + lockfile; the two plugin manifests are patched via targeted regex so inline arrays (e.g. `plugin.json`'s `keywords`) stay byte-identical. Supports `<X.Y.Z|patch|minor|major>` and `--dry-run`.
+
+### Notes
+
+- Both additions are repo-internal — neither file ships in the npm tarball (`files: ["dist", "CHANGELOG.md"]` is unchanged), so the published artifact is byte-identical to 6.0.1 modulo version metadata. This release exists to dogfood the new `bump-version` flow end-to-end.
+
 ## 4.0.1 — 2026-04-27
 
 ### Fixed

package/dist/index.mjs

@@ -816,42 +816,103 @@ function renderItemLine(item) {
   if (item.whenToUse) line += ` \u2014 ${item.whenToUse}`;
   return line;
 }
-var ALWAYS_ON_RULES = [
-  "Do not call every tool by default; pick by the trigger condition above.",
-  "For first-attempt failures or simple edits, skip extra tools."
-];
-function buildConditionalRules(installedIds) {
+function buildCombinationPatterns(ids) {
+  const has = (k) => ids.has(k);
+  const out = ["\u6309\u573A\u666F\u4E32\u8054\uFF0C\u4E0D\u8981\u4E00\u4E2A\u4E2A\u5B64\u7ACB\u8C03\u7528\uFF1A", ""];
+  if (has("claude-mem") || has("context7") || has("curdx-flow")) {
+    out.push("- **\u63A5\u5230\u65B0\u9700\u6C42 / \u65B0 feature \u8D77\u624B\u5F0F**");
+    let step = 1;
+    if (has("claude-mem")) out.push(`  ${step++}. \`claude-mem:mem-search\` \u67E5\u5386\u53F2\u2014\u2014"\u4EE5\u524D\u6709\u6CA1\u6709\u7C7B\u4F3C\u7684\u6D3B/\u5751"`);
+    if (has("context7")) out.push(`  ${step++}. \u6D89\u53CA\u5916\u90E8\u5E93 \u2192 \`context7\` \u62C9\u6700\u65B0\u6587\u6863`);
+    const planners = [];
+    if (has("claude-mem")) planners.push("`claude-mem:make-plan` \u51FA phased plan");
+    if (has("curdx-flow")) planners.push("`/curdx-flow:new` \u8D77 spec");
+    if (planners.length > 0) out.push(`  ${step++}. \u590D\u6742\u591A\u6B65 \u2192 ${planners.join("\uFF0C\u6216 ")}`);
+    out.push(`  ${step++}. \u7B80\u5355\u4E00\u6B21\u6027\u6539\u52A8 \u2192 \u76F4\u63A5\u52A8\u624B\uFF0C\u8DF3\u8FC7\u4E0A\u9762\u51E0\u6B65`);
+    out.push("");
+  }
+  const stuckLines = [];
+  let s = 1;
+  if (has("claude-mem")) stuckLines.push(`  ${s++}. \u5148\u770B \`claude-mem:mem-search\`\u2014\u2014\u4EE5\u524D\u662F\u5426\u89E3\u8FC7\u540C\u6837\u7684 bug`);
+  if (has("chrome-devtools-mcp")) stuckLines.push(`  ${s++}. \u6D4F\u89C8\u5668\u4FA7 bug \u2192 \`chrome-devtools-mcp\`\uFF08network / console / perf trace\uFF09`);
+  if (has("context7")) stuckLines.push(`  ${s++}. \u5E93 / API \u884C\u4E3A\u4E0D\u7B26\u9884\u671F \u2192 \`context7\` \u67E5\u5B98\u65B9 doc\uFF0C\u4E0D\u8981\u51ED\u8BB0\u5FC6`);
+  const stillStuck = [];
+  if (has("sequential-thinking")) stillStuck.push("`sequential-thinking` \u62C6\u5047\u8BBE");
+  if (has("pua")) stillStuck.push("`/pua:pua-loop` \u81EA\u52A8\u8FED\u4EE3");
+  if (stillStuck.length > 0) stuckLines.push(`  ${s++}. \u8FD8\u5361 \u2192 ${stillStuck.join("\uFF0C\u6216 ")}`);
+  if (stuckLines.length > 0) {
+    out.push("- **\u9047\u5230 bug / \u5361\u4F4F 2 \u6B21\u4EE5\u4E0A**", ...stuckLines, "");
+  }
+  if (has("frontend-design") || has("chrome-devtools-mcp")) {
+    out.push("- **\u505A UI / \u524D\u7AEF\u9875\u9762**");
+    if (has("frontend-design")) out.push("  - `frontend-design` \u81EA\u52A8 fire\uFF0C\u65E0\u9700\u624B\u52A8\u8C03");
+    if (has("chrome-devtools-mcp")) out.push("  - \u6E32\u67D3\u5F02\u5E38\u6216\u4EA4\u4E92 bug \u2192 `chrome-devtools-mcp` \u9A8C\u8BC1\uFF0C\u4E0D\u9760\u8089\u773C");
+    out.push("");
+  }
+  if (has("pua") || has("curdx-flow")) {
+    out.push("- **\u5927\u578B / \u8DE8\u6A21\u5757 / \u591A agent \u534F\u4F5C**");
+    if (has("pua")) out.push("  - `/pua:p9` \u62C6 task prompt + \u7BA1 P8 \u56E2\u961F");
+    if (has("curdx-flow")) out.push("  - `/curdx-flow:triage` \u628A\u5927 feature \u62C6\u6210\u591A\u4E2A spec");
+    if (has("pua")) out.push("  - \u6218\u7565\u7EA7 \u2192 `/pua:p10`");
+  }
+  while (out.length > 0 && out[out.length - 1] === "") out.pop();
+  return out;
+}
+function buildSkipRules(ids) {
+  const has = (k) => ids.has(k);
+  const out = [];
+  out.push("- \u4E00\u884C\u6539\u52A8 / typo / \u91CD\u547D\u540D\u53D8\u91CF \u2014\u2014 \u4E0D\u8981 plan\uFF0C\u4E0D\u8981 mem-search\uFF0C\u76F4\u63A5 Edit");
+  const skips = [];
+  if (has("pua")) skips.push("`/pua:pua`");
+  if (has("sequential-thinking")) skips.push("`sequential-thinking`");
+  if (skips.length > 0) {
+    out.push(`- \u5DF2\u77E5\u786E\u5B9A\u7684 fix \u2014\u2014 \u4E0D\u8981 ${skips.join("\u3001")}`);
+  }
+  out.push('- \u7528\u6237\u95EE"\u8FD9\u662F\u4EC0\u4E48\u610F\u601D"\u7C7B\u7684\u89E3\u91CA\u9898 \u2014\u2014 \u4E0D\u8C03\u4EFB\u4F55\u5DE5\u5177\uFF0C\u76F4\u63A5\u7B54');
+  if (has("curdx-flow")) {
+    out.push("- \u5355\u6587\u4EF6\u5C40\u90E8\u91CD\u6784 \u2014\u2014 \u4E0D\u8D77 spec\uFF0C\u4E0D\u8FDB curdx-flow");
+  }
+  return out;
+}
+function buildDecisionTree(ids) {
+  const has = (k) => ids.has(k);
   const out = [];
+  out.push("1. \u80FD 1\u20132 \u6B65\u641E\u5B9A\uFF1F\u2192 \u76F4\u63A5\u505A");
+  out.push("2. \u591A\u6B65\u9AA4\u4F46\u8DEF\u5F84\u6E05\u6670\uFF1F\u2192 TaskCreate \u62C6\u4EFB\u52A1\uFF0C\u4E0D\u8FDB spec");
   const planners = [];
-  if (installedIds.has("sequential-thinking")) planners.push("sequential-thinking");
-  if (installedIds.has("claude-mem")) planners.push("claude-mem `make-plan`");
+  if (has("curdx-flow")) planners.push("`/curdx-flow:new`");
+  if (has("claude-mem")) planners.push("`claude-mem:make-plan`");
   if (planners.length > 0) {
-    out.push(`For complex / risky changes, plan first (${planners.join(" or ")}).`);
+    out.push(`3. \u9700\u6C42\u6A21\u7CCA / \u8DE8\u6A21\u5757 / \u8981\u5206\u9636\u6BB5\u4EA4\u4ED8\uFF1F\u2192 ${planners.join(" \u6216 ")}`);
   }
-  if (installedIds.has("context7")) {
-    out.push("For library / SDK lookups, prefer context7 over web search.");
-  }
-  if (installedIds.has("chrome-devtools-mcp")) {
-    out.push("For browser-rendered behavior, verify in chrome-devtools-mcp instead of guessing.");
+  if (has("claude-mem")) {
+    out.push("4. \u540C\u6837\u7684\u6D3B\u4EE5\u524D\u53EF\u80FD\u5E72\u8FC7\uFF1F\u2192 \u5148 `claude-mem:mem-search`");
   }
   return out;
 }
 function renderBlock(items) {
   const installedIds = new Set(items.map((i) => i.id));
-  const rules = [...ALWAYS_ON_RULES, ...buildConditionalRules(installedIds)];
-  return [
+  const lines = [
     BEGIN_MARKER,
     "## Tool Usage",
     "",
     "Available tools/plugins:",
-    ...items.map(renderItemLine),
-    "",
-    "Rules:",
-    ...rules.map((r) => `- ${r}`),
-    "",
-    "Run `npx @curdx/flow` to install / update / uninstall.",
-    END_MARKER
-  ].join("\n");
+    ...items.map(renderItemLine)
+  ];
+  const combo = buildCombinationPatterns(installedIds);
+  if (combo.length > 0) {
+    lines.push("", "## Tool Combination Patterns\uFF08\u7EC4\u5408\u5DE5\u4F5C\u6D41\uFF09", "", ...combo);
+  }
+  const skip = buildSkipRules(installedIds);
+  if (skip.length > 0) {
+    lines.push("", "## Skip Rules\uFF08\u9632\u8FC7\u5EA6\u5DE5\u5177\u5316\uFF09", "", ...skip);
+  }
+  const tree = buildDecisionTree(installedIds);
+  if (tree.length > 0) {
+    lines.push("", "## Decision Tree\uFF08\u9047\u5230\u6A21\u7CCA\u8BF7\u6C42\u65F6\uFF09", "", ...tree);
+  }
+  lines.push("", "Run `npx @curdx/flow` to install / update / uninstall.", END_MARKER);
+  return lines.join("\n");
 }
 function withEol(s, eol) {
   return eol === "\n" ? s : s.split("\n").join(eol);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curdx/flow",
-  "version": "6.0.1",
+  "version": "6.0.3",
   "description": "Interactive installer for Claude Code plugins and MCP servers",
   "type": "module",
   "bin": "./dist/index.mjs",
@@ -17,6 +17,7 @@
     "start": "node ./dist/index.mjs",
     "typecheck": "tsc --noEmit",
     "check-versions": "node scripts/check-versions.mjs",
+    "bump-version": "node scripts/bump-version.mjs",
     "prepublishOnly": "node scripts/check-versions.mjs && npm run typecheck && npm run build"
   },
   "keywords": [