@curdx/flow 7.1.3 → 7.1.5

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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.5 — 2026-05-06
+
+### Fixed
+
+- **Prevent local source checkouts from silently running a stale CLI bundle.** A repo-local execution path could still write the old `~/.claude/CLAUDE.md` block even after `7.1.4` was published correctly, because `.gitignore` excludes `dist/` and `npx @curdx/flow` run from the source checkout may execute the checkout's local `bin` (`dist/index.mjs`) instead of the freshly published npm tarball. If `src/` had newer changes but `dist/` had not been rebuilt, the user would unknowingly run old installer logic and keep re-injecting the pre-7.1.4 managed block. Added `src/runner/buildFreshness.ts` and wired it into `src/index.ts` startup so source checkouts now fail fast with a clear error when `src/**/*.ts` is newer than `dist/index.mjs`, instructing the user to run `npm run build` or execute the published package explicitly. New tests in `tests/runner/buildFreshness.test.ts` cover both stale and fresh build states.
+
+## 7.1.4 — 2026-05-06
+
+### Changed
+
+- **`~/.claude/CLAUDE.md` managed block is now language-aware.** `src/runner/claudeMd.ts` no longer emits a single Chinese-only block regardless of installer language. The managed `<!-- BEGIN @curdx/flow v1 -->` block now renders in English when the installer runs with `--lang en` (or `CURDX_FLOW_LANG=en`) and in Chinese when it runs with `zh`. This keeps the generated guidance aligned with the installer's selected language instead of mixing an English install flow with Chinese managed instructions.
+- **Chinese installs inject an explicit language policy into the managed block.** When the current installer language is `zh`, flow now prepends a `Language Policy` section that instructs Claude to keep tool/model interaction in English while replying to the user in Simplified Chinese. English installs do not inject this section. This behavior is covered by new tests in `tests/runner/claudeMd.test.ts`.
+- **Managed-block guidance now uses clearer Claude Code terminology.** The block now distinguishes slash commands from MCP capabilities and plugin skills instead of mixing them together. `claude-mem` calls are rendered as `/claude-mem:...`, Context7 / sequential-thinking / Chrome DevTools are described as MCP capabilities, and the overly-strong `frontend-design` "auto fire" wording was softened to "prioritize, then invoke explicitly if needed". The global decision tree also stopped leaking `TaskCreate` as a user-facing universal rule, matching current Claude Code best-practice guidance more closely.
+
+### Added
+
+- **README alignment for managed `CLAUDE.md` behavior.** `README.md` and `README.zh-CN.md` now document that language selection affects not only the installer UI, but also the rendering of the managed `CLAUDE.md` block, including the extra Chinese-mode language policy injection.
+
 ## 7.1.3 — 2026-05-05
 
 ### Added

package/README.md

@@ -133,6 +133,8 @@ 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.
 
+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.
+
 ### Common workflows
 
 ```bash
@@ -337,7 +339,7 @@ Run `npx @curdx/flow status` to see what is installed on your machine.
 | --- | --- |
 | `--all` | Apply to every available item (with `install` or `update`). |
 | `--yes` | Skip all confirmations (non-interactive). |
-| `--lang en` / `--lang zh` | Override the language for the current invocation. |
+| `--lang en` / `--lang zh` | Override the language for the current invocation, including the language used when rendering the managed `CLAUDE.md` block. |
 | `--no-claude-md` | Do not write the managed block to `~/.claude/CLAUDE.md`. |
 | `--json` | Output machine-readable JSON (with `status`). |
 | `--quick` | (Plugin) Run all phases of a spec sequentially without pausing for approval. Use with caution. |
@@ -350,7 +352,7 @@ Run `npx @curdx/flow status` to see what is installed on your machine.
 | Variable | Effect |
 | --- | --- |
 | `CURDX_FLOW_NO_CLAUDE_MD=1` | Equivalent to `--no-claude-md`. |
-| `CURDX_FLOW_LANG=en` / `=zh` | Default language for the installer. |
+| `CURDX_FLOW_LANG=en` / `=zh` | Default language for the installer and for managed `CLAUDE.md` block rendering. |
 | `CONTEXT7_API_KEY` | Optional API key for the context7 MCP server. |
 
 ### Per-project overrides
@@ -394,7 +396,7 @@ Inside any project that uses flow:
 
 The four canonical artifacts (`research.md` … `tasks.md`) are committed with your code. State and progress files are gitignored.
 
-The `<!-- BEGIN @curdx/flow v1 -->` block in `~/.claude/CLAUDE.md` tells Claude what is installed and how to invoke it. flow only ever rewrites this block — content outside the markers is preserved verbatim. Pass `--no-claude-md` (or set `CURDX_FLOW_NO_CLAUDE_MD=1`) to opt out of the managed block.
+The `<!-- BEGIN @curdx/flow v1 -->` block in `~/.claude/CLAUDE.md` tells Claude what is installed and how to invoke it. flow only ever rewrites this block — content outside the markers is preserved verbatim. The block is language-aware: `--lang en` renders the guidance in English, `--lang zh` renders it in Chinese, and the `zh` variant also injects a language policy requiring English for tool/model interaction and Simplified Chinese for user-facing replies. Pass `--no-claude-md` (or set `CURDX_FLOW_NO_CLAUDE_MD=1`) to opt out of the managed block.
 
 ---
 

package/README.zh-CN.md

@@ -133,6 +133,8 @@ npx @curdx/flow
 
 首次运行会让你选择语言（中文 / English），随后选择安装项。内置的 `curdx-flow` 插件（即工作流本身）始终安装；其余工具均可按需选择。
 
+这个语言选择同时决定 flow 写入 `~/.claude/CLAUDE.md` 的受管理块内容。受管理块会按所选语言渲染；若选择 `zh`，还会额外注入语言策略，要求 Claude 在工具 / 模型交互时使用英文、面向用户输出时使用简体中文。
+
 ### 常用操作
 
 ```bash
@@ -337,7 +339,7 @@ flow 内置九个专项子 agent，各自承担明确的单一职责。它们由
 | --- | --- |
 | `--all` | 应用于全部可用项（与 `install` 或 `update` 配合）。 |
 | `--yes` | 跳过所有确认提示（非交互模式）。 |
-| `--lang en` / `--lang zh` | 单次调用覆盖语言设置。 |
+| `--lang en` / `--lang zh` | 单次调用覆盖语言设置，同时影响受管理 `CLAUDE.md` 区块的渲染语言。 |
 | `--no-claude-md` | 不向 `~/.claude/CLAUDE.md` 写入受管理块。 |
 | `--json` | 机器可读 JSON 输出（与 `status` 配合）。 |
 | `--quick` | （插件）连续运行 spec 的全部阶段，不在阶段间暂停等待确认。请谨慎使用。 |
@@ -350,7 +352,7 @@ flow 内置九个专项子 agent，各自承担明确的单一职责。它们由
 | 变量 | 作用 |
 | --- | --- |
 | `CURDX_FLOW_NO_CLAUDE_MD=1` | 等价于 `--no-claude-md`。 |
-| `CURDX_FLOW_LANG=en` / `=zh` | 安装器默认语言。 |
+| `CURDX_FLOW_LANG=en` / `=zh` | 安装器默认语言，同时作为受管理 `CLAUDE.md` 区块的默认渲染语言。 |
 | `CONTEXT7_API_KEY` | context7 MCP 服务器的可选 API 密钥。 |
 
 ### 项目级覆盖
@@ -394,7 +396,7 @@ flow 内置九个专项子 agent，各自承担明确的单一职责。它们由
 
 四份标准产出物（`research.md` … `tasks.md`）随代码一同提交至仓库。状态与进度文件已加入 gitignore。
 
-`~/.claude/CLAUDE.md` 中的 `<!-- BEGIN @curdx/flow v1 -->` 块告知 Claude 当前已安装的内容及调用方式。flow 仅会重写该块，标记之外的内容**原样保留**。如需关闭受管理块，传入 `--no-claude-md`，或设置环境变量 `CURDX_FLOW_NO_CLAUDE_MD=1`。
+`~/.claude/CLAUDE.md` 中的 `<!-- BEGIN @curdx/flow v1 -->` 块告知 Claude 当前已安装的内容及调用方式。flow 仅会重写该块，标记之外的内容**原样保留**。该区块会根据语言设置渲染：`--lang en` 输出英文提示，`--lang zh` 输出中文提示；其中 `zh` 版本还会额外注入语言策略，要求工具 / 模型交互使用英文、面向用户回复使用简体中文。如需关闭受管理块，传入 `--no-claude-md`，或设置环境变量 `CURDX_FLOW_NO_CLAUDE_MD=1`。
 
 ---
 

package/dist/index.mjs

@@ -195,6 +195,9 @@ var currentLang = "zh";
 function setLang(lang) {
   currentLang = lang;
 }
+function getLang() {
+  return currentLang;
+}
 function t(key, vars) {
   const raw = tables[currentLang][key] ?? tables.en[key] ?? key;
   if (!vars) return raw;
@@ -848,44 +851,111 @@ var BLOCK_RE = /<!-- BEGIN @curdx\/flow v\d+[^>]*-->[\s\S]*?<!-- END @curdx\/flo
 function claudeMdPath() {
   return path4.join(os2.homedir(), ".claude", "CLAUDE.md");
 }
+function isZh() {
+  return getLang() === "zh";
+}
 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", ""];
+  const out = [
+    isZh() ? "\u6309\u573A\u666F\u4E32\u8054\uFF0C\u4F18\u5148\u6309\u80FD\u529B\u8FB9\u754C\u8C03\u7528\uFF1Aslash command\u3001MCP\u3001\u63D2\u4EF6 skill \u4E0D\u8981\u6DF7\u5199\u3002" : "Combine tools by capability. Keep slash commands, MCP tools, and plugin skills distinct.",
+    ""
+  ];
   if (has("claude-mem") || has("context7") || has("curdx-flow")) {
-    out.push("- **\u63A5\u5230\u65B0\u9700\u6C42 / \u65B0 feature \u8D77\u624B\u5F0F**");
+    out.push(isZh() ? "- **\u63A5\u5230\u65B0\u9700\u6C42 / \u65B0 feature**" : "- **Starting a new feature**");
     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`);
+    if (has("claude-mem")) {
+      out.push(
+        isZh() ? `  ${step++}. \u5148\u7528 \`/claude-mem:mem-search\` \u67E5\u5386\u53F2\uFF0C\u786E\u8BA4\u4E4B\u524D\u6709\u6CA1\u6709\u7C7B\u4F3C\u5B9E\u73B0\u3001\u8E29\u5751\u6216\u51B3\u7B56\u3002` : `  ${step++}. Start with \`/claude-mem:mem-search\` to check whether this work, decision, or pitfall already exists in memory.`
+      );
+    }
+    if (has("context7")) {
+      out.push(
+        isZh() ? `  ${step++}. \u6D89\u53CA\u5916\u90E8\u5E93\u3001SDK\u3001\u6846\u67B6\u6216 API \u65F6\uFF0C\u4F7F\u7528 Context7 MCP \u62C9\u5B98\u65B9\u6700\u65B0\u6587\u6863\u3002` : `  ${step++}. If external libraries, SDKs, frameworks, or APIs are involved, use the Context7 MCP to pull current official docs.`
+      );
+    }
     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`);
+    if (has("claude-mem")) {
+      planners.push(
+        isZh() ? "`/claude-mem:make-plan` \u4EA7\u51FA\u5206\u9636\u6BB5\u8BA1\u5212" : "`/claude-mem:make-plan` for a phased plan"
+      );
+    }
+    if (has("curdx-flow")) {
+      planners.push(
+        isZh() ? "`/curdx-flow:new` \u6216\u76F8\u5173 spec flow \u8D77\u5B8C\u6574\u89C4\u683C" : "`/curdx-flow:new` or the spec flow for a full specification"
+      );
+    }
+    if (planners.length > 0) {
+      out.push(
+        isZh() ? `  ${step++}. \u591A\u6B65\u9AA4\u3001\u9AD8\u4E0D\u786E\u5B9A\u6027\u3001\u8DE8\u6A21\u5757\u65F6\uFF0C\u518D\u8FDB\u5165 ${planners.join("\uFF0C\u6216 ")}\u3002` : `  ${step++}. Only move into ${planners.join(" or ")} when the work is multi-step, cross-cutting, or uncertain.`
+      );
+    }
+    out.push(
+      isZh() ? `  ${step++}. \u7B80\u5355\u3001\u8303\u56F4\u660E\u786E\u7684\u4E00\u6B21\u6027\u6539\u52A8\uFF0C\u76F4\u63A5\u505A\uFF0C\u4E0D\u8981\u5148\u628A\u6D41\u7A0B\u62C9\u6EE1\u3002` : `  ${step++}. For small, clear one-shot changes, implement directly instead of forcing the full workflow.`
+    );
     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`);
+  if (has("claude-mem")) {
+    stuckLines.push(
+      isZh() ? `  ${s++}. \u5148\u7528 \`/claude-mem:mem-search\` \u67E5\u8BB0\u5FC6\uFF0C\u786E\u8BA4\u662F\u4E0D\u662F\u4EE5\u524D\u89E3\u8FC7\u540C\u7C7B bug\u3002` : `  ${s++}. Check \`/claude-mem:mem-search\` first to see whether the same bug was solved before.`
+    );
+  }
+  if (has("chrome-devtools-mcp")) {
+    stuckLines.push(
+      isZh() ? `  ${s++}. \u6D4F\u89C8\u5668\u4FA7\u95EE\u9898\u4F7F\u7528 Chrome DevTools MCP\uFF1A\u770B network\u3001console\u3001performance\u3001DOM snapshot\u3002` : `  ${s++}. For browser-side issues, use the Chrome DevTools MCP for network, console, performance, and DOM snapshots.`
+    );
+  }
+  if (has("context7")) {
+    stuckLines.push(
+      isZh() ? `  ${s++}. \u5982\u679C\u6000\u7591\u662F\u5E93 / API \u884C\u4E3A\u53D8\u5316\uFF0C\u4F7F\u7528 Context7 MCP \u67E5\u5B98\u65B9\u6587\u6863\uFF0C\u4E0D\u8981\u51ED\u8BB0\u5FC6\u3002` : `  ${s++}. If the issue may come from library or API behavior, use the Context7 MCP instead of relying on memory.`
+    );
+  }
   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 (has("sequential-thinking")) {
+    stillStuck.push(
+      isZh() ? "\u4F7F\u7528 sequential-thinking MCP \u62C6\u5047\u8BBE" : "use the sequential-thinking MCP to break down hypotheses"
+    );
+  }
+  if (has("pua")) {
+    stillStuck.push(
+      isZh() ? "\u518D\u8FDB\u5165 `/pua:pua-loop` \u8FED\u4EE3" : "then enter `/pua:pua-loop` for structured retries"
+    );
+  }
+  if (stillStuck.length > 0) {
+    stuckLines.push(
+      isZh() ? `  ${s++}. \u4E24\u8F6E\u4EE5\u4E0A\u4ECD\u5361\u4F4F\uFF0C\u518D ${stillStuck.join("\uFF0C\u6216 ")}\u3002` : `  ${s++}. If you are still stuck after multiple attempts, ${stillStuck.join(" or ")}.`
+    );
+  }
   if (stuckLines.length > 0) {
-    out.push("- **\u9047\u5230 bug / \u5361\u4F4F 2 \u6B21\u4EE5\u4E0A**", ...stuckLines, "");
+    out.push(isZh() ? "- **\u9047\u5230 bug / \u8FDE\u7EED\u5361\u4F4F**" : "- **Debugging and repeated failures**", ...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(isZh() ? "- **\u505A UI / \u524D\u7AEF\u9875\u9762**" : "- **UI and frontend work**");
+    if (has("frontend-design")) {
+      out.push(
+        isZh() ? "  - \u4F18\u5148\u4F7F\u7528 `frontend-design` \u63D2\u4EF6\u7684 UI skills\uFF1B\u82E5\u672A\u81EA\u52A8\u89E6\u53D1\uFF0C\u518D\u663E\u5F0F\u8C03\u7528\u5BF9\u5E94 skill\u3002" : "  - Prioritize the `frontend-design` plugin skills for UI work; if they do not trigger automatically, invoke the relevant skill explicitly."
+      );
+    }
+    if (has("chrome-devtools-mcp")) {
+      out.push(
+        isZh() ? "  - \u6E32\u67D3\u5F02\u5E38\u3001\u4EA4\u4E92\u95EE\u9898\u6216\u89C6\u89C9\u56DE\u5F52\uFF0C\u4F7F\u7528 Chrome DevTools MCP \u9A8C\u8BC1\uFF0C\u4E0D\u8981\u53EA\u9760\u8089\u773C\u731C\u3002" : "  - For rendering issues, interaction bugs, or visual regressions, verify with the Chrome DevTools MCP instead of relying on visual guesswork alone."
+      );
+    }
     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`");
+    out.push(isZh() ? "- **\u5927\u578B / \u8DE8\u6A21\u5757 / \u591A agent \u534F\u4F5C**" : "- **Large, cross-cutting, or multi-agent work**");
+    if (has("pua")) {
+      out.push(
+        isZh() ? "  - \u9700\u8981\u5E76\u884C\u62C6\u89E3\u4E0E\u56E2\u961F\u534F\u4F5C\u65F6\uFF0C\u7528 `/pua:p9`\uFF1B\u66F4\u9AD8\u5C42\u6218\u7565\u89C4\u5212\u518D\u8003\u8651 `/pua:p10`\u3002" : "  - Use `/pua:p9` for parallel task decomposition and team coordination; reserve `/pua:p10` for higher-level strategy work."
+      );
+    }
+    if (has("curdx-flow")) {
+      out.push(
+        isZh() ? "  - \u4E00\u4E2A\u5927\u529F\u80FD\u9700\u8981\u62C6\u6210\u591A\u4E2A\u76F8\u4E92\u4F9D\u8D56\u7684\u89C4\u683C\u65F6\uFF0C\u4F7F\u7528 `/curdx-flow:triage`\u3002" : "  - Use `/curdx-flow:triage` when one large feature needs to be split into multiple dependent specs."
+      );
+    }
   }
   while (out.length > 0 && out[out.length - 1] === "") out.pop();
   return out;
@@ -893,48 +963,76 @@ function buildCombinationPatterns(ids) {
 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");
+  out.push(
+    isZh() ? "- \u4E00\u884C\u6539\u52A8\u3001typo\u3001\u7EAF\u91CD\u547D\u540D\u53D8\u91CF\uFF1A\u4E0D\u8981\u5148 plan\uFF0C\u4E0D\u8981\u5148\u5F00 spec\uFF0C\u76F4\u63A5\u6539\u3002" : "- For one-line changes, typos, or pure renames, skip planning and spec flow. Just make the 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(
+      isZh() ? `- \u5DF2\u77E5\u786E\u5B9A\u7684 fix\uFF1A\u4E0D\u8981\u5148\u4E0A ${skips.join("\u3001")}\u3002` : `- For a known, deterministic fix, do not reach for ${skips.join(" or ")} first.`
+    );
   }
-  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');
+  out.push(
+    isZh() ? "- \u7EAF\u6982\u5FF5\u89E3\u91CA\u9898\u53EF\u4EE5\u76F4\u63A5\u7B54\uFF1B\u5982\u679C\u662F\u5728\u95EE\u5F53\u524D\u4ED3\u5E93\u91CC\u7684\u4EE3\u7801\u542B\u4E49\uFF0C\u5148\u8BFB\u76F8\u5173\u6587\u4EF6\u518D\u89E3\u91CA\u3002" : "- Answer pure conceptual explanation questions directly. If the question is about code in this repository, read the relevant files first."
+  );
   if (has("curdx-flow")) {
-    out.push("- \u5355\u6587\u4EF6\u5C40\u90E8\u91CD\u6784 \u2014\u2014 \u4E0D\u8D77 spec\uFF0C\u4E0D\u8FDB curdx-flow");
+    out.push(
+      isZh() ? "- \u5355\u6587\u4EF6\u5C40\u90E8\u91CD\u6784\u6216\u5F88\u5C0F\u8303\u56F4\u7684\u6574\u7406\uFF1A\u901A\u5E38\u4E0D\u8981\u8FDB\u5165 curdx-flow spec \u6D41\u3002" : "- For a single-file refactor or a very local cleanup, usually do not enter the curdx-flow spec workflow."
+    );
   }
   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");
+  out.push(isZh() ? "1. \u80FD 1\u20132 \u6B65\u641E\u5B9A\uFF1F\u2192 \u76F4\u63A5\u505A\u3002" : "1. Can it be finished in 1-2 steps? -> Do it directly.");
+  out.push(
+    isZh() ? "2. \u591A\u6B65\u9AA4\u4F46\u8DEF\u5F84\u6E05\u6670\uFF1F\u2192 \u62C6\u6210\u7B80\u77ED\u4EFB\u52A1\u5217\u8868\u9010\u4E2A\u63A8\u8FDB\uFF0C\u4E0D\u8981\u9ED8\u8BA4\u8FDB\u5165\u5B8C\u6574 spec \u6D41\u3002" : "2. Is it multi-step but still clear? -> Break it into a short task list and execute without defaulting to the full spec flow."
+  );
   const planners = [];
   if (has("curdx-flow")) planners.push("`/curdx-flow:new`");
-  if (has("claude-mem")) planners.push("`claude-mem:make-plan`");
+  if (has("claude-mem")) planners.push("`/claude-mem:make-plan`");
   if (planners.length > 0) {
-    out.push(`3. \u9700\u6C42\u6A21\u7CCA / \u8DE8\u6A21\u5757 / \u8981\u5206\u9636\u6BB5\u4EA4\u4ED8\uFF1F\u2192 ${planners.join(" \u6216 ")}`);
+    out.push(
+      isZh() ? `3. \u9700\u6C42\u6A21\u7CCA\u3001\u8DE8\u6A21\u5757\u3001\u9700\u8981\u5206\u9636\u6BB5\u4EA4\u4ED8\uFF1F\u2192 ${planners.join(" \u6216 ")}\u3002` : `3. Is the request ambiguous, cross-cutting, or phase-based? -> ${planners.join(" or ")}.`
+    );
   }
   if (has("claude-mem")) {
-    out.push("4. \u540C\u6837\u7684\u6D3B\u4EE5\u524D\u53EF\u80FD\u5E72\u8FC7\uFF1F\u2192 \u5148 `claude-mem:mem-search`");
+    out.push(
+      isZh() ? "4. \u8FD9\u7C7B\u6D3B\u4EE5\u524D\u53EF\u80FD\u505A\u8FC7\uFF1F\u2192 \u5148 `/claude-mem:mem-search`\u3002" : "4. Might this work have been done before? -> Start with `/claude-mem:mem-search`."
+    );
   }
   return out;
 }
+function buildLanguagePolicy() {
+  if (getLang() !== "zh") return [];
+  return [
+    "- Tool and model interaction must be in English.",
+    "- All user-facing responses must be in Simplified Chinese."
+  ];
+}
 function renderBlock(items) {
   const installedIds = new Set(items.map((i) => i.id));
   const sections = [
-    ["## Tool Combination Patterns\uFF08\u7EC4\u5408\u5DE5\u4F5C\u6D41\uFF09", buildCombinationPatterns(installedIds)],
-    ["## Skip Rules\uFF08\u9632\u8FC7\u5EA6\u5DE5\u5177\u5316\uFF09", buildSkipRules(installedIds)],
-    ["## Decision Tree\uFF08\u9047\u5230\u6A21\u7CCA\u8BF7\u6C42\u65F6\uFF09", buildDecisionTree(installedIds)]
+    ["## Language Policy\uFF08\u8BED\u8A00\u89C4\u5219\uFF09", buildLanguagePolicy()],
+    [
+      isZh() ? "## Tool Combination Patterns\uFF08\u7EC4\u5408\u5DE5\u4F5C\u6D41\uFF09" : "## Tool Combination Patterns",
+      buildCombinationPatterns(installedIds)
+    ],
+    [isZh() ? "## Skip Rules\uFF08\u9632\u8FC7\u5EA6\u5DE5\u5177\u5316\uFF09" : "## Skip Rules", buildSkipRules(installedIds)],
+    [isZh() ? "## Decision Tree\uFF08\u9047\u5230\u6A21\u7CCA\u8BF7\u6C42\u65F6\uFF09" : "## Decision Tree", buildDecisionTree(installedIds)]
   ];
   const lines = [BEGIN_MARKER];
   for (const [heading, body] of sections) {
     if (body.length === 0) continue;
     lines.push(heading, "", ...body, "");
   }
-  lines.push("Run `npx @curdx/flow` to install / update / uninstall.", END_MARKER);
+  lines.push(
+    isZh() ? "\u8FD0\u884C `npx @curdx/flow` \u4EE5 install / update / uninstall\u3002" : "Run `npx @curdx/flow` to install / update / uninstall.",
+    END_MARKER
+  );
   return lines.join("\n");
 }
 function withEol(s, eol) {
@@ -1613,6 +1711,58 @@ var analyzeCmd = defineCommand({
 });
 var analyze_default = analyzeCmd;
 
+// src/runner/buildFreshness.ts
+import { readdirSync, statSync, existsSync as existsSync3 } from "fs";
+import path5 from "path";
+import { fileURLToPath } from "url";
+var SELF_PATH = fileURLToPath(import.meta.url);
+var RUNNER_DIR = path5.dirname(SELF_PATH);
+var PROJECT_ROOT = path5.resolve(RUNNER_DIR, "..", "..");
+var SRC_DIR = path5.join(PROJECT_ROOT, "src");
+var DIST_ENTRY = path5.join(PROJECT_ROOT, "dist", "index.mjs");
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", ".git"]);
+function newestTsMtimeMs(dir) {
+  let newest = 0;
+  const entries = readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIP_DIRS.has(entry.name)) continue;
+    const full = path5.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      newest = Math.max(newest, newestTsMtimeMs(full));
+      continue;
+    }
+    if (!entry.isFile() || !entry.name.endsWith(".ts")) continue;
+    newest = Math.max(newest, statSync(full).mtimeMs);
+  }
+  return newest;
+}
+function assertFreshLocalBuild() {
+  assertFreshBuild({ projectRoot: PROJECT_ROOT, srcDir: SRC_DIR, distEntry: DIST_ENTRY });
+}
+function assertFreshBuild(opts) {
+  const { projectRoot, srcDir, distEntry } = opts;
+  if (!existsSync3(srcDir) || !existsSync3(distEntry)) return;
+  let distMtimeMs = 0;
+  let newestSrcMtimeMs = 0;
+  try {
+    distMtimeMs = statSync(distEntry).mtimeMs;
+    newestSrcMtimeMs = newestTsMtimeMs(srcDir);
+  } catch {
+    return;
+  }
+  if (newestSrcMtimeMs <= distMtimeMs) return;
+  const relDist = path5.relative(projectRoot, distEntry);
+  const relSrc = path5.relative(projectRoot, srcDir);
+  throw new Error(
+    [
+      "Local build is stale: source files are newer than the bundled CLI entry.",
+      `Detected source checkout at ${projectRoot}.`,
+      `Run \`npm run build\` to refresh ${relDist}, or execute the published package explicitly with \`npx --package @curdx/flow@$(node -p "require('./package.json').version") @curdx/flow\`.`,
+      `This guard only applies when running from a local checkout that still contains ${relSrc}/.`
+    ].join(" ")
+  );
+}
+
 // src/index.ts
 function parseLang(v) {
   return v === "zh" || v === "en" ? v : void 0;
@@ -1748,6 +1898,7 @@ async function runInteractive(argv2) {
 }
 var argv = process.argv.slice(2);
 var first = firstNonFlag(argv);
+assertFreshLocalBuild();
 if (first === void 0 || first !== void 0 && !SUBCOMMANDS.has(first) && first !== "--help" && first !== "-h") {
   if (first === void 0) {
     runInteractive(argv).catch((err) => {

package/package.json

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