@fenglimg/fabric-shared 2.3.0-rc.2 → 2.3.0-rc.3

package/dist/{chunk-ANUDBQBK.js → chunk-ASS2KBB7.js}

@@ -192,8 +192,20 @@ var globalConfigSchema = z.object({
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
+function isTestRuntime() {
+  return process.env.VITEST !== void 0 || process.env.VITEST_WORKER_ID !== void 0;
+}
 function resolveGlobalRoot() {
-  return join(process.env.FABRIC_HOME ?? homedir(), ".fabric");
+  const fabricHome = process.env.FABRIC_HOME;
+  if (fabricHome !== void 0 && fabricHome !== "") {
+    return join(fabricHome, ".fabric");
+  }
+  if (isTestRuntime()) {
+    throw new Error(
+      "resolveGlobalRoot(): FABRIC_HOME must be set under the test runner \u2014 refusing to fall back to the real home dir (~/.fabric). Repoint process.env.FABRIC_HOME to an isolated temp dir in beforeEach (see plan-context.test.ts for the pattern)."
+    );
+  }
+  return join(homedir(), ".fabric");
 }
 function globalConfigPath(globalRoot = resolveGlobalRoot()) {
   return join(globalRoot, "fabric-global.json");

package/dist/{chunk-OAYQHN6J.js → chunk-KFFBQRL5.js}

@@ -1,6 +1,6 @@
 import {
   resolveGlobalLocale
-} from "./chunk-ANUDBQBK.js";
+} from "./chunk-ASS2KBB7.js";
 
 // src/templates/bootstrap-canonical.ts
 var BOOTSTRAP_MARKER_BEGIN = "<!-- fabric:bootstrap:begin -->";

package/dist/{chunk-ZYBWITH7.js → chunk-UPYKUYHN.js}

@@ -1,6 +1,6 @@
 import {
   resolveGlobalLocale
-} from "./chunk-ANUDBQBK.js";
+} from "./chunk-ASS2KBB7.js";
 
 // src/i18n/locales/en.ts
 var enMessages = {
@@ -18,6 +18,12 @@ var enMessages = {
   "cli.shared.none": "none",
   "cli.shared.loading": "loading",
   "cli.shared.refresh": "Refresh",
+  // flat-design-system Wave4 (TASK-004): gutter-free ✓/x receipt printed after a
+  // clack control (select/multiselect/confirm/text) resolves. The clack control
+  // stays native (C-006); the receipt is a separate flat line.
+  "cli.prompt.receipt.selected": "Selected",
+  "cli.prompt.receipt.set": "Set",
+  "cli.prompt.receipt.cancelled": "Cancelled",
   "cli.shared.target-invalid": "Target must be an existing directory: {target}",
   "cli.shared.target-invalid.action-hint": "Choose an existing project directory, or create it before running the command again.",
   "cli.shared.template-not-found": "Template not found: {path}",
@@ -54,6 +60,9 @@ var enMessages = {
   // Keys consumed by packages/cli/src/commands/config.ts (menu loop +
   // per-field prompts) and by getPanelFields() (label_i18n_key references).
   "cli.config.intro": "Fabric Configuration",
+  // flat-design-system Wave5 (TASK-005): B-横线 title above the flat key/value
+  // panel printed before the clack edit menu.
+  "cli.config.panel.title": "Current configuration",
   "cli.config.outro": "Configuration saved.",
   "cli.config.outro-no-changes": "No changes made.",
   "cli.config.cancel": "Cancelled.",
@@ -96,12 +105,19 @@ var enMessages = {
   "cli.config.fields.nudge_mode.label": "Nudge level",
   "cli.config.fields.nudge_mode.description": "Preset for human-visible nudges (silent / minimal / normal / verbose). Governs only the human channel \u2014 never the knowledge injected to the AI.",
   "cli.config.fields.embed_enabled.label": "Vector semantic search",
-  "cli.config.fields.embed_enabled.description": "Enable vector semantic recall (true / false). Note: turning this on also needs `fabric install --enable-embed` for the host-side setup (fastembed + model cache); flipping it here alone does not enable it.",
+  "cli.config.fields.embed_enabled.description": "Enable vector semantic recall (true / false). Note: true is just intent \u2014 it only takes effect when the running server can resolve the fastembed package AND the model is downloaded (auto-fetched to ~/.fabric/cache/embed on first recall). Check actual state with `fabric info recall`.",
+  "cli.config.fields.fusion.label": "Recall fusion strategy",
+  "cli.config.fields.fusion.description": "How the signals combine into one score: additive = weighted sum (BM25-led, small vector weight) / rrf = Reciprocal Rank Fusion (BM25 and vector on equal footing, so semantics actually count) / auto = adaptive (default: rrf when the vector channel is scoring, else additive \u2014 avoids degenerate single-channel rrf being worse).",
   "cli.doctor.description": "Run Fabric target-state diagnostics (meta sync, knowledge index, bootstrap, events ledger, human-lock drift).\n\nExamples:\n  fabric doctor                   read-only diagnostics report\n  fabric doctor --fix             repair derived state (meta + indexes)\n  fabric doctor --fix-knowledge   apply lint mutations (counter / archive / cache)\n  fabric doctor --json            machine-readable output",
   "doctor.section.fixable": "Fixable errors:",
   "doctor.section.manual": "Manual errors:",
   "doctor.section.warnings": "Warnings:",
   "doctor.section.fix-knowledge-mutations": "Fix-knowledge mutations:",
+  // flat-design-system Wave5 (TASK-005): C-圆点 group headers for the reskinned
+  // doctor surface (`● Store Health` / `● Checks`), replacing the old hardcoded
+  // sectionBar literals so the wording is localized in both locales.
+  "doctor.group.store-health": "Store Health",
+  "doctor.group.checks": "Checks",
   // v2.0.0-rc.29 REVIEW (codex LOW-2): F2's payload-limit defaults reach the JSON
   // envelope but never surfaced in the human renderer, so operators tuning
   // `mcpPayloadLimits` had no fast `fabric doctor` confirmation that their config
@@ -617,12 +633,29 @@ var enMessages = {
   "cli.install.pipeline.title": "Fabric Install",
   "cli.install.pipeline.complete": "Fabric Install Complete",
   "cli.install.pipeline.running": "Running {count} stages...",
+  // TASK-002 (G1): summary-card completion + count words. Formerly hardcoded
+  // English in ConsoleOutputRenderer (Done! / succeeded / skipped / failed /
+  // "All steps completed successfully"); routed through t() + dual-locale tables
+  // so locale-parity.test.ts guards both en + zh-CN carry every key.
+  "cli.summary.done": "Done!",
+  "cli.summary.all-ok": "All steps completed successfully",
+  "cli.summary.n-failed": "{count} step(s) failed",
+  "cli.summary.n-of-total": "{done}/{total} steps completed",
+  "cli.summary.count.succeeded": "succeeded",
+  "cli.summary.count.skipped": "skipped",
+  "cli.summary.count.failed": "failed",
   // TASK-004: a first-ever install gets an onboarding-tone intro; a re-install
   // keeps the terse "Running N stages" line. {count} = total stages.
   "cli.install.pipeline.intro.firstRun": "Welcome to Fabric \u2014 this is your first install. I'll walk you through a one-time setup ({count} stages); later runs skip anything already in place.",
   // TASK-004: the single collapsed health-check card title for a fully-idempotent
   // re-install. {count} = total stages. Detail is behind --verbose.
   "cli.install.healthcheck.title": "\u2713 Fabric is up to date \xB7 {count} stages ready \xB7 no changes",
+  // TASK-003 (G2 root a): the per-stage summary-detail status word now branches on
+  // r.changed (not installed.length) — a no-change re-ensure says "up to date"
+  // instead of misreporting "N installed". installed-count is used only when the
+  // stage actually changed something.
+  "cli.install.stage.uptodate": "up to date",
+  "cli.install.stage.installed-count": "{count} installed",
   "cli.install.pipeline.label.preflight": "Preflight check",
   "cli.install.pipeline.label.env": "Environment setup",
   "cli.install.pipeline.label.store": "Store configuration",
@@ -632,6 +665,10 @@ var enMessages = {
   "cli.install.pipeline.label.guidance": "Next steps",
   "cli.install.pipeline.desc.store": "Bind the current project's read/write store; refresh the resolved-bindings snapshot.",
   "cli.install.next-step": "{label} {message}",
+  // TASK-002 (G6): a single golden-action anchor that closes the summary card.
+  // The verbose capability table is gated behind --verbose; this one line is the
+  // honest "what to do next" footer. {action} = the concrete next command.
+  "cli.install.next-step.anchor": "Next \u2192 {action}",
   "cli.install.reason-message": "{label} {message}",
   "cli.install.language.prompt": "Choose the Fabric language (used for both UI and knowledge; change later via `fabric config`):",
   "cli.install.language.option.zh-CN": "\u7B80\u4F53\u4E2D\u6587 (zh-CN)",
@@ -659,6 +696,10 @@ var enMessages = {
   "cli.install.wizard.stage.bootstrap": "Install bootstrap templates? [{defaultValue}]",
   "cli.install.wizard.stage.mcp": "Configure MCP clients? [{defaultValue}]",
   "cli.install.wizard.stage.hooks": "Install git hooks? [{defaultValue}]",
+  // flat-design-system Wave4 (TASK-004): short stage labels for the post-group ✓ receipt.
+  "cli.install.wizard.stage.bootstrap.short": "bootstrap templates",
+  "cli.install.wizard.stage.mcp.short": "MCP clients",
+  "cli.install.wizard.stage.hooks.short": "git hooks",
   "cli.install.wizard.mcp-install": "MCP server install scope (global/local) [{defaultValue}]",
   "cli.install.wizard.execute.confirm": "Execute this install plan now? [Y/n]",
   "cli.install.wizard.outro": "Install plan accepted. Running Fabric install...",
@@ -793,7 +834,14 @@ var enMessages = {
   // C3: mirror install's phase banner ("Fabric install 将按 N 个阶段执行").
   "cli.uninstall.plan.phase-banner": "Fabric uninstall runs in {total} phases",
   "cli.uninstall.plan.target": "Target: {target}",
-  "cli.uninstall.plan.actions": "Plan: bootstrap={bootstrap} mcp={mcp} scaffold={scaffold} unbind-store={store}",
+  // flat-design-system Wave5 (TASK-004 G3): the plan preview speaks human action
+  // sentences, one per ENABLED stage, instead of the `key=yes/no` jargon line.
+  "cli.uninstall.plan.will-remove": "Will remove:",
+  "cli.uninstall.plan.will-keep": "Will keep:",
+  "cli.uninstall.plan.action.bootstrap": "client skills & hook scripts",
+  "cli.uninstall.plan.action.mcp": "MCP server registration",
+  "cli.uninstall.plan.action.scaffold": "project scaffold files",
+  "cli.uninstall.plan.action.store": "team store binding (this project)",
   "cli.uninstall.plan.detected": "Detected clients: {clients}",
   "cli.uninstall.plan.preserves": "Preserves:",
   "cli.uninstall.plan.preserves.stores": "global knowledge stores, never deleted by project uninstall",
@@ -814,6 +862,10 @@ var enMessages = {
   "cli.uninstall.stages.uptodate": "nothing to remove ({count} already absent)",
   "cli.uninstall.stages.summary": "removed={removed} skipped={skipped} errors={errors}",
   "cli.uninstall.stages.removed-count": "{count} removed",
+  // flat-design-system Wave5 (TASK-006 G3): human result words for the summary
+  // card detail rows, symmetric with install's `{count} installed` / `up to date`.
+  "cli.uninstall.stage.cleaned-count": "{count} cleaned",
+  "cli.uninstall.stage.already-clean": "already clean",
   "cli.uninstall.summary.title": "Uninstall summary",
   "cli.uninstall.summary.body": "removed={removed} skipped={skipped} errors={errors}",
   "cli.uninstall.healthcheck.title": "\u2713 Fabric already absent \xB7 nothing to remove",
@@ -1100,6 +1152,11 @@ var zhCNMessages = {
   "cli.shared.none": "\u65E0",
   "cli.shared.loading": "\u52A0\u8F7D\u4E2D",
   "cli.shared.refresh": "\u5237\u65B0",
+  // flat-design-system Wave4 (TASK-004): clack 控件（select/multiselect/confirm/text）
+  // 落定后打印的平铺无沟槽 ✓/x 回执行。控件保持原生（C-006），回执是独立的一行。
+  "cli.prompt.receipt.selected": "\u5DF2\u9009",
+  "cli.prompt.receipt.set": "\u5DF2\u8BBE\u7F6E",
+  "cli.prompt.receipt.cancelled": "\u5DF2\u53D6\u6D88",
   "cli.shared.target-invalid": "\u76EE\u6807\u5FC5\u987B\u662F\u5DF2\u5B58\u5728\u7684\u76EE\u5F55\uFF1A{target}",
   "cli.shared.target-invalid.action-hint": "\u8BF7\u9009\u62E9\u4E00\u4E2A\u5DF2\u5B58\u5728\u7684\u9879\u76EE\u76EE\u5F55\uFF0C\u6216\u5148\u521B\u5EFA\u8BE5\u76EE\u5F55\u540E\u518D\u91CD\u65B0\u8FD0\u884C\u547D\u4EE4\u3002",
   "cli.shared.template-not-found": "\u672A\u627E\u5230\u6A21\u677F\uFF1A{path}",
@@ -1131,6 +1188,9 @@ var zhCNMessages = {
   // 由 packages/cli/src/commands/config.ts（菜单循环 + 字段编辑）以及
   // getPanelFields() 的 label_i18n_key 引用消费。
   "cli.config.intro": "Fabric \u914D\u7F6E",
+  // flat-design-system Wave5 (TASK-005): clack 编辑菜单前那块平铺键值面板的
+  // B-横线标题。
+  "cli.config.panel.title": "\u5F53\u524D\u914D\u7F6E",
   "cli.config.outro": "\u914D\u7F6E\u5DF2\u4FDD\u5B58\u3002",
   "cli.config.outro-no-changes": "\u672A\u505A\u4EFB\u4F55\u4FEE\u6539\u3002",
   "cli.config.cancel": "\u5DF2\u53D6\u6D88\u3002",
@@ -1173,12 +1233,18 @@ var zhCNMessages = {
   "cli.config.fields.nudge_mode.label": "\u63D0\u793A\u6863\u4F4D",
   "cli.config.fields.nudge_mode.description": "\u4EBA\u7C7B\u53EF\u89C1 nudge \u7684\u603B\u6863\u4F4D\uFF08silent \u9759\u9ED8 / minimal \u7CBE\u7B80 / normal \u6B63\u5E38 / verbose \u8BE6\u5C3D\uFF09\uFF1B\u4EC5\u63A7\u4EBA\u7C7B\u63D0\u793A\u901A\u9053\uFF0C\u4E0D\u5F71\u54CD\u6CE8\u5165\u7ED9 AI \u7684\u77E5\u8BC6\u3002",
   "cli.config.fields.embed_enabled.label": "\u5411\u91CF\u8BED\u4E49\u68C0\u7D22",
-  "cli.config.fields.embed_enabled.description": "\u662F\u5426\u542F\u7528\u5411\u91CF\u8BED\u4E49\u68C0\u7D22\uFF08true / false\uFF09\u3002\u6CE8\u610F\uFF1A\u5F00\u542F\u8FD8\u9700 `fabric install --enable-embed` \u5B8C\u6210\u4E3B\u673A\u4FA7\u5B89\u88C5\uFF08fastembed + \u6A21\u578B\u7F13\u5B58\uFF09\uFF0C\u4EC5\u5728\u6B64\u7F6E true \u4E0D\u4F1A\u81EA\u52A8\u751F\u6548\u3002",
+  "cli.config.fields.embed_enabled.description": "\u662F\u5426\u542F\u7528\u5411\u91CF\u8BED\u4E49\u68C0\u7D22\uFF08true / false\uFF09\u3002\u6CE8\u610F\uFF1Atrue \u53EA\u662F\u610F\u56FE\u5F00\u5173\u2014\u2014\u771F\u6B63\u751F\u6548\u8FD8\u9700\u8FD0\u884C\u4E2D\u7684 server \u80FD\u89E3\u6790\u5230 fastembed \u5305\u3001\u4E14\u6A21\u578B\u5DF2\u4E0B\u8F7D\uFF08\u9996\u6B21\u53EC\u56DE\u65F6\u81EA\u52A8\u4E0B\u5230 ~/.fabric/cache/embed\uFF09\u3002\u7528 `fabric info recall` \u67E5\u5B9E\u9645\u72B6\u6001\u3002",
+  "cli.config.fields.fusion.label": "\u53EC\u56DE\u878D\u5408\u7B56\u7565",
+  "cli.config.fields.fusion.description": "\u591A\u4FE1\u53F7\u5408\u6210\u603B\u5206\u7684\u7B97\u6CD5\uFF1Aadditive \u52A0\u6743\u6C42\u548C\uFF08BM25 \u4E3B\u5BFC\uFF0C\u5411\u91CF\u6743\u91CD\u5C0F\uFF09/ rrf \u5012\u6570\u6392\u540D\u878D\u5408\uFF08BM25 \u4E0E\u5411\u91CF\u5E73\u8D77\u5E73\u5750\uFF0C\u8BED\u4E49\u624D\u771F\u6B63\u751F\u6548\uFF09/ auto \u81EA\u9002\u5E94\uFF08\u9ED8\u8BA4\uFF1A\u5411\u91CF\u5728\u51FA\u5206\u65F6\u7528 rrf\uFF0C\u5426\u5219\u56DE\u843D additive\u2014\u2014\u907F\u514D\u65E0\u5411\u91CF\u65F6 rrf \u9000\u5316\u53CD\u800C\u66F4\u5DEE\uFF09\u3002",
   "cli.doctor.description": "\u8FD0\u884C Fabric \u76EE\u6807\u6001\u8BCA\u65AD\uFF08meta \u540C\u6B65\u3001\u77E5\u8BC6\u7D22\u5F15\u3001bootstrap\u3001events ledger\u3001human-lock \u6F02\u79FB\uFF09\u3002\n\n\u793A\u4F8B\uFF1A\n  fabric doctor                   \u53EA\u8BFB\u8BCA\u65AD\u62A5\u544A\n  fabric doctor --fix             \u4FEE\u590D\u6D3E\u751F\u72B6\u6001\uFF08meta + \u7D22\u5F15\uFF09\n  fabric doctor --fix-knowledge   \u5E94\u7528\u77E5\u8BC6\u5E93 lint \u53D8\u66F4\uFF08\u8BA1\u6570\u5668 / \u5F52\u6863 / \u7F13\u5B58\uFF09\n  fabric doctor --json            \u673A\u5668\u53EF\u8BFB\u8F93\u51FA",
   "doctor.section.fixable": "\u53EF\u4FEE\u590D\u9519\u8BEF\uFF1A",
   "doctor.section.manual": "\u9700\u624B\u52A8\u4FEE\u590D\uFF1A",
   "doctor.section.warnings": "\u8B66\u544A\uFF1A",
   "doctor.section.fix-knowledge-mutations": "Fix-knowledge \u53D8\u66F4\uFF1A",
+  // flat-design-system Wave5 (TASK-005): 重排后的 doctor C-圆点分组标题
+  // (`● 存储健康` / `● 检查项`),取代原硬编码 sectionBar 字面量。
+  "doctor.group.store-health": "\u5B58\u50A8\u5065\u5EB7",
+  "doctor.group.checks": "\u68C0\u67E5\u9879",
   // v2.0.0-rc.29 REVIEW (codex LOW-2): F2 的 payload 阈值之前只出现在 JSON envelope，
   // 人类输出看不到，导致改了 mcpPayloadLimits 之后没法用 `fabric doctor` 快速确认是否生效。
   "doctor.section.payload-limits": "MCP payload \u9608\u503C\uFF1A",
@@ -1684,12 +1750,27 @@ var zhCNMessages = {
   "cli.install.pipeline.title": "Fabric \u5B89\u88C5",
   "cli.install.pipeline.complete": "Fabric \u5B89\u88C5\u5B8C\u6210",
   "cli.install.pipeline.running": "\u5C06\u6309 {count} \u4E2A\u9636\u6BB5\u6267\u884C",
+  // TASK-002 (G1):总结卡收尾 + 计数词。原先在 ConsoleOutputRenderer 中硬编码英文
+  // (Done! / succeeded / skipped / failed / "All steps completed successfully"),
+  // 全部收进 t() + 双语表,locale-parity.test.ts 守护 en + zh-CN 每个 key 齐备。
+  "cli.summary.done": "\u5B8C\u6210!",
+  "cli.summary.all-ok": "\u5168\u90E8\u6B65\u9AA4\u5DF2\u5B8C\u6210",
+  "cli.summary.n-failed": "{count} \u4E2A\u6B65\u9AA4\u5931\u8D25",
+  "cli.summary.n-of-total": "{done}/{total} \u6B65\u5DF2\u5B8C\u6210",
+  "cli.summary.count.succeeded": "\u6210\u529F",
+  "cli.summary.count.skipped": "\u8DF3\u8FC7",
+  "cli.summary.count.failed": "\u5931\u8D25",
   // TASK-004: 首装走 onboarding 定调(欢迎语 + 一次性设置说明);重装保持简洁的
   // "将按 N 阶段执行"。{count} = 阶段总数。
   "cli.install.pipeline.intro.firstRun": "\u6B22\u8FCE\u4F7F\u7528 Fabric \u2014\u2014 \u8FD9\u662F\u9996\u6B21\u5B89\u88C5,\u6211\u4F1A\u5F15\u5BFC\u4F60\u5B8C\u6210\u4E00\u6B21\u6027\u8BBE\u7F6E(\u5171 {count} \u4E2A\u9636\u6BB5);\u4E4B\u540E\u518D\u8DD1\u4F1A\u81EA\u52A8\u8DF3\u8FC7\u5DF2\u5C31\u7EEA\u9879\u3002",
   // TASK-004: 重装且全程幂等(无任何 install)时折叠成的单张体检卡片标题。
   // {count} = 阶段总数。明细走 --verbose。
   "cli.install.healthcheck.title": "\u2713 Fabric \u5DF2\u662F\u6700\u65B0 \xB7 {count} \u9636\u6BB5\u5C31\u7EEA \xB7 \u65E0\u6539\u52A8",
+  // TASK-003 (G2 root a):每阶段总结明细的状态词改按 r.changed 判定(不再用
+  // installed.length)—— 无改动的重装走"已最新",不再误报"N 项已安装"。
+  // installed-count 仅在该阶段确有改动时使用。
+  "cli.install.stage.uptodate": "\u5DF2\u6700\u65B0",
+  "cli.install.stage.installed-count": "{count} \u9879\u5DF2\u5B89\u88C5",
   "cli.install.pipeline.label.preflight": "\u5168\u5C40\u4E0E\u9879\u76EE\u9884\u68C0",
   "cli.install.pipeline.label.env": "\u9879\u76EE\u73AF\u5883\u521D\u59CB\u5316",
   "cli.install.pipeline.label.store": "\u77E5\u8BC6\u5E93\u62D3\u6251",
@@ -1699,6 +1780,9 @@ var zhCNMessages = {
   "cli.install.pipeline.label.guidance": "\u540E\u7EED\u6307\u5F15",
   "cli.install.pipeline.desc.store": "\u7ED1\u5B9A\u5F53\u524D\u9879\u76EE\u7684 read/write store\uFF0C\u5237\u65B0 resolved-bindings snapshot\u3002",
   "cli.install.next-step": "{label} {message}",
+  // TASK-002 (G6): 收口总结卡的单一黄金动作锚点。能力明细表收进 --verbose,
+  // 这一行才是诚实的「下一步做什么」。{action} = 具体下一条命令。
+  "cli.install.next-step.anchor": "\u4E0B\u4E00\u6B65 \u2192 {action}",
   "cli.install.reason-message": "{label} {message}",
   "cli.install.language.prompt": "\u9009\u62E9 Fabric \u8BED\u8A00\uFF08\u754C\u9762\u4E0E\u77E5\u8BC6\u7EDF\u4E00\u4F7F\u7528\uFF0C\u4E4B\u540E\u53EF\u7528 fabric config \u4FEE\u6539\uFF09\uFF1A",
   "cli.install.language.option.zh-CN": "\u7B80\u4F53\u4E2D\u6587 (zh-CN)",
@@ -1726,6 +1810,10 @@ var zhCNMessages = {
   "cli.install.wizard.stage.bootstrap": "\u662F\u5426\u5B89\u88C5 bootstrap \u6A21\u677F\uFF1F[{defaultValue}]",
   "cli.install.wizard.stage.mcp": "\u662F\u5426\u914D\u7F6E MCP \u5BA2\u6237\u7AEF\uFF1F[{defaultValue}]",
   "cli.install.wizard.stage.hooks": "\u662F\u5426\u5B89\u88C5 git hooks\uFF1F[{defaultValue}]",
+  // flat-design-system Wave4 (TASK-004): post-group ✓ 回执用的短阶段标签。
+  "cli.install.wizard.stage.bootstrap.short": "bootstrap \u6A21\u677F",
+  "cli.install.wizard.stage.mcp.short": "MCP \u5BA2\u6237\u7AEF",
+  "cli.install.wizard.stage.hooks.short": "git hooks",
   "cli.install.wizard.mcp-install": "MCP \u670D\u52A1\u7AEF\u5B89\u88C5\u8303\u56F4\uFF08global/local\uFF09[{defaultValue}]",
   "cli.install.wizard.execute.confirm": "\u73B0\u5728\u6267\u884C\u8BE5\u5B89\u88C5\u8BA1\u5212\uFF1F[Y/n]",
   "cli.install.wizard.outro": "\u5B89\u88C5\u8BA1\u5212\u5DF2\u786E\u8BA4\uFF0C\u5F00\u59CB\u6267\u884C Fabric install...",
@@ -1858,7 +1946,14 @@ var zhCNMessages = {
   // C3: 镜像 install 的阶段提示 (install 用 "Fabric install 将按 N 个阶段执行")。
   "cli.uninstall.plan.phase-banner": "Fabric uninstall \u5C06\u6309 {total} \u4E2A\u9636\u6BB5\u6267\u884C",
   "cli.uninstall.plan.target": "\u76EE\u6807\uFF1A{target}",
-  "cli.uninstall.plan.actions": "\u8BA1\u5212\uFF1Abootstrap={bootstrap} mcp={mcp} scaffold={scaffold} unbind-store={store}",
+  // flat-design-system Wave5 (TASK-004 G3): 计划预览用人话动作句，按启用的阶段逐条列，
+  // 不再输出 `key=是/否` 黑话行。
+  "cli.uninstall.plan.will-remove": "\u5C06\u79FB\u9664\uFF1A",
+  "cli.uninstall.plan.will-keep": "\u5C06\u4FDD\u7559\uFF1A",
+  "cli.uninstall.plan.action.bootstrap": "\u5BA2\u6237\u7AEF\u6280\u80FD\u4E0E hook \u811A\u672C",
+  "cli.uninstall.plan.action.mcp": "MCP \u670D\u52A1\u6CE8\u518C",
+  "cli.uninstall.plan.action.scaffold": "\u9879\u76EE\u811A\u624B\u67B6\u6587\u4EF6",
+  "cli.uninstall.plan.action.store": "\u56E2\u961F store \u7ED1\u5B9A\uFF08\u672C\u9879\u76EE\uFF09",
   "cli.uninstall.plan.detected": "\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\uFF1A{clients}",
   "cli.uninstall.plan.preserves": "\u4FDD\u7559\u9879\uFF1A",
   "cli.uninstall.plan.preserves.stores": "\u5168\u5C40\u77E5\u8BC6 stores\uFF0C\u9879\u76EE\u5378\u8F7D\u6C38\u4E0D\u5220\u9664",
@@ -1879,6 +1974,10 @@ var zhCNMessages = {
   "cli.uninstall.stages.uptodate": "\u65E0\u53EF\u79FB\u9664\uFF08{count} \u9879\u5DF2\u4E0D\u5B58\u5728\uFF09",
   "cli.uninstall.stages.summary": "removed={removed} skipped={skipped} errors={errors}",
   "cli.uninstall.stages.removed-count": "\u5DF2\u79FB\u9664 {count} \u9879",
+  // flat-design-system Wave5 (TASK-006 G3): 总结卡明细行的人话结果词，与 install 的
+  // `已安装 {count} 项` / `已最新` 对称。
+  "cli.uninstall.stage.cleaned-count": "\u5DF2\u6E05\u7406 {count} \u9879",
+  "cli.uninstall.stage.already-clean": "\u5DF2\u662F\u5E72\u51C0",
   "cli.uninstall.summary.title": "\u5378\u8F7D\u6458\u8981",
   "cli.uninstall.summary.body": "removed={removed} skipped={skipped} errors={errors}",
   "cli.uninstall.healthcheck.title": "\u2713 Fabric \u5DF2\u4E0D\u5B58\u5728 \xB7 \u65E0\u53EF\u79FB\u9664",

package/dist/i18n/index.js

@@ -5,12 +5,12 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-ZYBWITH7.js";
+} from "../chunk-UPYKUYHN.js";
 import {
   detectNodeLocale,
   normalizeLocale,
   resolveGlobalLocale
-} from "../chunk-ANUDBQBK.js";
+} from "../chunk-ASS2KBB7.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-BO7itJ8e.d.ts → index-C0cijMSw.d.ts}

@@ -496,7 +496,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
-    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf"]>>>;
+    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf", "auto"]>>>;
 }, "strip", z.ZodTypeAny, {
     default_layer_filter: "personal" | "team" | "both";
     nudge_mode: "silent" | "minimal" | "normal" | "verbose";
@@ -525,7 +525,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     embed_enabled: boolean;
     embed_weight: number;
     embed_model: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2";
-    fusion: "additive" | "rrf";
+    fusion: "additive" | "rrf" | "auto";
     clientPaths?: {
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
@@ -632,7 +632,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     embed_enabled?: boolean | undefined;
     embed_weight?: number | undefined;
     embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
-    fusion?: "additive" | "rrf" | undefined;
+    fusion?: "additive" | "rrf" | "auto" | undefined;
 }>;
 declare const fabricConfigLoadSchema: z.ZodObject<{
     clientPaths: z.ZodOptional<z.ZodObject<{
@@ -725,7 +725,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
-    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf"]>>>;
+    fusion: z.ZodDefault<z.ZodOptional<z.ZodEnum<["additive", "rrf", "auto"]>>>;
 } & {
     required_stores: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -765,7 +765,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     embed_enabled: boolean;
     embed_weight: number;
     embed_model: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2";
-    fusion: "additive" | "rrf";
+    fusion: "additive" | "rrf" | "auto";
     clientPaths?: {
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
@@ -872,7 +872,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     embed_enabled?: boolean | undefined;
     embed_weight?: number | undefined;
     embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
-    fusion?: "additive" | "rrf" | undefined;
+    fusion?: "additive" | "rrf" | "auto" | undefined;
 }>;
 
 interface ClientPaths {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, S as StoreIdentity, c as StoreProject, G as GlobalConfig, F as FabricConfig, M as MountedStore, R as RequiredStoreEntry, d as AgentsMeta, L as LedgerEntry } from './index-BO7itJ8e.js';
-export { e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, j as FabricLanguage, k as GLOBAL_BINDINGS_DIR, l as GLOBAL_STATE_DIR, m as HumanLedgerEntry, n as McpPayloadLimits, P as PERSONAL_STORE_SENTINEL, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem, s as STORES_ROOT_DIR, t as STORE_ALIAS_PATTERN, u as STORE_KNOWLEDGE_TYPE_DIRS, v as STORE_LAYOUT, w as STORE_MOUNT_GROUPS, x as STORE_MOUNT_NAME_PATTERN, y as STORE_PROJECT_ID_PATTERN, z as STORE_UUID_PATTERN, B as StoreLayout, E as StoreMountGroup, I as StoreProjectsFile, J as auditModeSchema, K as clientPathsSchema, N as defaultLayerFilterSchema, O as deriveMountLabel, Q as fabricConfigLoadSchema, T as fabricLanguageSchema, U as globalConfigSchema, V as isNonPersonalRequiredStore, W as mcpPayloadLimitsSchema, X as migrateRequiredStores, Y as mountedStoreSchema, Z as nudgeModeSchema, _ as observeConfigSchema, $ as planContextTopKSchema, a0 as requiredStoreEntrySchema, a1 as selectionTokenTtlMsSchema, a2 as storeAliasSchema, a3 as storeIdentitySchema, a4 as storeKnowledgeTypeDir, a5 as storeMountGroup, a6 as storeMountNameSchema, a7 as storeMountSubPath, a8 as storeProjectSchema, a9 as storeProjectsFileSchema, aa as storeRelativePath, ab as storeRelativePathForMount, ac as storeUuidSchema, ad as writeRouteSchema } from './index-BO7itJ8e.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, S as StoreIdentity, c as StoreProject, G as GlobalConfig, F as FabricConfig, M as MountedStore, R as RequiredStoreEntry, d as AgentsMeta, L as LedgerEntry } from './index-C0cijMSw.js';
+export { e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, j as FabricLanguage, k as GLOBAL_BINDINGS_DIR, l as GLOBAL_STATE_DIR, m as HumanLedgerEntry, n as McpPayloadLimits, P as PERSONAL_STORE_SENTINEL, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem, s as STORES_ROOT_DIR, t as STORE_ALIAS_PATTERN, u as STORE_KNOWLEDGE_TYPE_DIRS, v as STORE_LAYOUT, w as STORE_MOUNT_GROUPS, x as STORE_MOUNT_NAME_PATTERN, y as STORE_PROJECT_ID_PATTERN, z as STORE_UUID_PATTERN, B as StoreLayout, E as StoreMountGroup, I as StoreProjectsFile, J as auditModeSchema, K as clientPathsSchema, N as defaultLayerFilterSchema, O as deriveMountLabel, Q as fabricConfigLoadSchema, T as fabricLanguageSchema, U as globalConfigSchema, V as isNonPersonalRequiredStore, W as mcpPayloadLimitsSchema, X as migrateRequiredStores, Y as mountedStoreSchema, Z as nudgeModeSchema, _ as observeConfigSchema, $ as planContextTopKSchema, a0 as requiredStoreEntrySchema, a1 as selectionTokenTtlMsSchema, a2 as storeAliasSchema, a3 as storeIdentitySchema, a4 as storeKnowledgeTypeDir, a5 as storeMountGroup, a6 as storeMountNameSchema, a7 as storeMountSubPath, a8 as storeProjectSchema, a9 as storeProjectsFileSchema, aa as storeRelativePath, ab as storeRelativePathForMount, ac as storeUuidSchema, ad as writeRouteSchema } from './index-C0cijMSw.js';
 import { T as Translator } from './types-qg4xXVuT.js';
 export { L as Locale, M as Messages, a as TranslationKey } from './types-qg4xXVuT.js';
 export { PROTECTED_TOKENS, ProtectedToken, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, resolveGlobalLocale, zhCNMessages } from './i18n/index.js';

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   BOOTSTRAP_REGEX,
   matchBootstrapCanonicalLocale,
   resolveBootstrapCanonical
-} from "./chunk-OAYQHN6J.js";
+} from "./chunk-KFFBQRL5.js";
 import "./chunk-LXNCAKJZ.js";
 import {
   PROTECTED_TOKENS,
@@ -16,7 +16,7 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-ZYBWITH7.js";
+} from "./chunk-UPYKUYHN.js";
 import {
   GLOBAL_BINDINGS_DIR,
   GLOBAL_STATE_DIR,
@@ -51,7 +51,7 @@ import {
   storeRelativePath,
   storeRelativePathForMount,
   storeUuidSchema
-} from "./chunk-ANUDBQBK.js";
+} from "./chunk-ASS2KBB7.js";
 import {
   atomicWriteJson,
   withFileLock
@@ -766,15 +766,18 @@ var fabricConfigSchema = z5.object({
     "fast-bge-base-en",
     "fast-all-MiniLM-L6-v2"
   ]).optional().default("fast-bge-small-zh-v1.5"),
-  // P1 recall-engine-refactor (TASK-003): content-channel fusion strategy.
-  // 'additive' (DEFAULT) = the historical weighted-sum path (BM25_WEIGHT·bm25 +
-  // vectorWeight·vector + structural). 'rrf' = Reciprocal Rank Fusion over the
-  // two CONTENT channels (bm25_rank, vector_rank) plus the unchanged structural
-  // boost. RRF is gated behind this flag and ships OFF — flipping the default to
-  // 'rrf' is a separate human decision gated on a one-off shadow run against the
-  // developer's real bound team store. no-query ranking is byte-identical under
-  // both values (the content channels contribute nothing without query terms).
-  fusion: z5.enum(["additive", "rrf"]).optional().default("additive")
+  // P1 recall-engine-refactor (TASK-003 + follow-up): content-channel fusion
+  // strategy. 'additive' = the weighted-sum path (BM25_WEIGHT·bm25 + vectorWeight·
+  // vector + structural); the vector term is structurally minor (cosine·30 vs an
+  // unbounded BM25), so additive is effectively BM25-led. 'rrf' = Reciprocal Rank
+  // Fusion over the two CONTENT channels (bm25_rank, vector_rank, equal footing)
+  // + a re-scaled structural tiebreaker — lets semantic recall actually matter.
+  // 'auto' (DEFAULT) = adaptive: use 'rrf' WHEN the vector channel is actually
+  // producing scores (embeddings installed + model warm), else fall back to
+  // 'additive'. This is the safe default — real-store shadow showed single-channel
+  // rrf (no vectors) is strictly worse than additive, so auto never lets that
+  // happen. no-query ranking is byte-identical under every value.
+  fusion: z5.enum(["additive", "rrf", "auto"]).optional().default("auto")
 });
 var fabricConfigLoadSchema = fabricConfigSchema.merge(
   z5.object({
@@ -949,7 +952,11 @@ var PANEL_FIELDS = [
   // when absent) — this introspection default mirrors the runtime read in
   // config-loader.ts so the panel never shows a default that contradicts behavior.
   makeEnumField("nudge_mode", "D_behavior", nudgeModeSchema.options, "normal"),
-  makeBooleanField("embed_enabled", true)
+  makeBooleanField("embed_enabled", true),
+  // P1 recall-engine-refactor (follow-up): the content-channel fusion strategy,
+  // panel-editable so it sits next to embed_enabled (the two go together — rrf
+  // only pays off when embeddings are on). 'auto' is the safe adaptive default.
+  makeEnumField("fusion", "D_behavior", ["additive", "rrf", "auto"], "auto")
 ];
 
 // src/schemas/store-stable-id.ts

package/dist/templates/bootstrap-canonical.js

@@ -7,8 +7,8 @@ import {
   BOOTSTRAP_REGEX,
   matchBootstrapCanonicalLocale,
   resolveBootstrapCanonical
-} from "../chunk-OAYQHN6J.js";
-import "../chunk-ANUDBQBK.js";
+} from "../chunk-KFFBQRL5.js";
+import "../chunk-ASS2KBB7.js";
 export {
   BOOTSTRAP_CANONICAL_BY_LOCALE,
   BOOTSTRAP_CANONICAL_EN,

package/dist/theme.d.ts

@@ -23,6 +23,7 @@ declare const SYMBOL_ASCII: {
 };
 declare function symbol(kind: keyof typeof SYMBOL_ASCII, colorOn?: boolean): string;
 declare function sectionBar(title: string, colorOn?: boolean): string;
+declare function headerRule(title: string, colorOn?: boolean): string;
 declare const SCOPE_BADGE_TOKEN: {
     readonly team: "drift";
     readonly project: "ai";
@@ -30,4 +31,4 @@ declare const SCOPE_BADGE_TOKEN: {
 };
 declare function scopeBadge(scope: keyof typeof SCOPE_BADGE_TOKEN, colorOn?: boolean): string;
 
-export { ANSI, PALETTE, SYMBOL_ASCII, type ThemeToken, isColorEnabled, paint, scopeBadge, sectionBar, symbol };
+export { ANSI, PALETTE, SYMBOL_ASCII, type ThemeToken, headerRule, isColorEnabled, paint, scopeBadge, sectionBar, symbol };

package/dist/theme.js

@@ -40,6 +40,12 @@ function symbol(kind, colorOn = isColorEnabled()) {
 function sectionBar(title, colorOn = isColorEnabled()) {
   return colorOn ? `${ANSI.bold}${PALETTE.accent}\u258C ${title}${ANSI.reset}` : `# ${title}`;
 }
+function headerRule(title, colorOn = isColorEnabled()) {
+  const head = colorOn ? `${ANSI.bold}${PALETTE.accent}${title}${ANSI.reset}` : title;
+  const rule = paint("muted", (colorOn ? "\u2500" : "-").repeat(40), colorOn);
+  return `${head}
+${rule}`;
+}
 var SCOPE_BADGE_TOKEN = { team: "drift", project: "ai", personal: "human" };
 function scopeBadge(scope, colorOn = isColorEnabled()) {
   const text = `[${scope}]`;
@@ -49,6 +55,7 @@ export {
   ANSI,
   PALETTE,
   SYMBOL_ASCII,
+  headerRule,
   isColorEnabled,
   paint,
   scopeBadge,

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-BO7itJ8e.js';
+export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-C0cijMSw.js';
 import 'zod';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.3.0-rc.2",
+  "version": "2.3.0-rc.3",
   "description": "Fabric shared types — Zod schemas, i18n, atomic-write helpers, MCP payload guard, error classes. Consumed by @fenglimg/fabric-server + @fenglimg/fabric-cli.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",