@fenglimg/fabric-shared 2.3.0-rc.12 → 2.3.0-rc.16

package/dist/{chunk-YLIWE46B.js → chunk-WXVFJBL5.js}

@@ -1,9 +1,11 @@
 import {
   resolveGlobalLocale
-} from "./chunk-ASS2KBB7.js";
+} from "./chunk-OX6DWUK4.js";
 
 // src/i18n/locales/en.ts
 var enMessages = {
+  "cli.signpost.retired": "Command `{retired}` was removed. Use `{successor}` instead.",
+  "cli.doctor.args.probe.description": "Emit a machine-readable JSON readiness snapshot (first-hit + store/hooks) without running --fix Prefer --probe in CI for a cheap readiness snapshot; full cite-coverage scans remain on-demand.",
   "cli.main.description": "Fabric CLI \u2014 feeds your project's decisions, pitfalls & conventions to your AI assistant automatically. First time? Run: fabric install",
   "cli.shared.created": "Created",
   "cli.shared.skipped": "Skipped",
@@ -48,10 +50,23 @@ var enMessages = {
   "cli.inspect.explain.census": "census",
   "cli.inspect.explain.census-total": "total {total}",
   "cli.inspect.error": "inspect failed: {message}",
+  // `fabric preview` — local read-only knowledge preview web server (loopback-only).
+  "cli.preview.description": "Start a local read-only knowledge preview (browse in your browser, grouped by scope)",
+  "cli.preview.arg.port": "Port to listen on (default 7777).",
+  "cli.preview.arg.host": "Host to bind (default 127.0.0.1, loopback only).",
+  "cli.preview.arg.open": "Open the browser on start (default on; use --no-open to disable).",
+  "cli.preview.arg.target": "Override the project root (defaults to cwd).",
+  "cli.preview.arg.variant": "Default style variant to open (default: lumen; all styles at /gallery).",
+  "cli.preview.gallery-hint": "All styles gallery: {url}",
+  "cli.preview.started": "Knowledge preview started: {url}",
+  "cli.preview.opening": "Opening browser\u2026",
+  "cli.preview.stop-hint": "Press Ctrl-C to stop.",
+  "cli.preview.stopped": "Preview stopped.",
+  "cli.preview.error": "preview failed: {message}",
   "cli.audit.description": "Knowledge & telemetry audit (cite/conflicts/history/metrics)",
   // `fabric audit cite` — 0%-recall-coverage self-diagnosis hints.
-  "cli.audit.cite.recall-mismatch-hint": "recall coverage is 0 despite {recalls} recall(s) across {sessions} session(s) \u2014 none shared a session with an edit. The recall caller is likely passing a non-client session_id (correlation is session-scoped). See AGENTS.md: pass the real client session_id to fab_recall.",
-  "cli.audit.cite.recall-none-hint": "recall coverage is 0 \u2014 no in-session fab_recall preceded these edits. Recall before editing, and pass the real client session_id (correlation is session-scoped). See AGENTS.md.",
+  "cli.audit.cite.recall-mismatch-hint": "recall coverage is 0 despite {recalls} recall(s) across {sessions} session(s) \u2014 none shared a session with an edit. Likely causes: (1) fab_recall omitted/wrong session_id (must be real client session_id; empty planned events never join edits); (2) recall paths do not path-overlap the edited file (auto-cite only counts overlapping planned.target_paths). Fix: pass session_id, reinstall hooks for active-session sidecar, or fab_recall paths that cover the edit. See AGENTS.md + docs/UPGRADE.md.",
+  "cli.audit.cite.recall-none-hint": "recall coverage is 0 \u2014 no in-session fab_recall preceded these edits (or planned events had empty session_id so they could not join). Recall before editing with the real client session_id; after install, SessionStart stamps .fabric/.cache/active-session.json as server fallback. Path-overlap still required: recall the files you will edit, not only unrelated .fabric paths. See AGENTS.md + docs/UPGRADE.md.",
   // `fabric audit --help` — filtered help (i18n'd subcommand listing).
   "cli.audit.help.tagline": "Knowledge & telemetry audit surfaces (read-only)",
   "cli.audit.help.sub.cite": "Cite-policy adherence report",
@@ -99,7 +114,7 @@ var enMessages = {
   "cli.config.install.args.dry-run.description": "Preview detected write operations without modifying files.",
   "cli.config.errors.unknown-client": 'Unknown client "{client}". Use a comma-separated list such as cc,codex.',
   "cli.config.errors.expected-object": "Expected object in {path}",
-  "cli.config.install.no-configs": "No Fabric MCP client config detected. Create the client directory or set clientPaths in fabric.config.json.",
+  "cli.config.install.no-configs": "No Fabric MCP client config detected. Create the client directory or set clientPaths in .fabric/fabric-config.json.",
   "cli.config.install.no-config-path": "Skipping {client}: no config path detected.",
   "cli.config.install.dry-run": "[dry-run] {client}: would write {path}",
   "cli.config.install.wrote": "{client}: wrote {path}",
@@ -168,7 +183,7 @@ var enMessages = {
   "doctor.section.fixable": "Fixable errors:",
   "doctor.section.manual": "Manual errors:",
   "doctor.section.warnings": "Warnings:",
-  "doctor.section.fix-knowledge-mutations": "Fix-knowledge mutations:",
+  "doctor.section.fix-knowledge-mutations": "Knowledge mutations (via --fix):",
   // flat-design follow-up: the remaining doctor UI-shell strings (TL;DR header,
   // --fix mutation plan, filtered --help) move off hardcoded English into i18n so
   // the whole `fabric doctor` surface honours the machine locale. USAGE/OPTIONS/
@@ -182,7 +197,15 @@ var enMessages = {
   // with doctor.check.*; messages carry store alias / counts via interpolation.
   "doctor.store.no-global-config": "no global Fabric config \u2014 run `fabric install --global <url>`",
   "doctor.store.missing-required": "required store '{id}' is not mounted; run `fabric store mount`",
-  "doctor.store.unbound": "store '{alias}' is mounted but not bound to this project; run `fabric store bind {alias}` to read its knowledge here (then `fabric store switch-write {alias}` to write team knowledge into it)",
+  "doctor.store.unbound": "store '{alias}' is mounted but not bound to this project \u2014 paste: `fabric store bind {alias}` then `fabric store switch-write {alias}`",
+  "doctor.store.empty": "bound store(s) have 0 knowledge entries ({stores}) \u2014 first-hit cannot succeed until you seed or clone knowledge; run `fabric first-hit --seed` (empty local store) or bind a remote team store with content",
+  "doctor.store.no-write-target": "no active write store for this project \u2014 paste: `fabric store bind <alias>` then `fabric store switch-write <alias>` (or `fabric install`)",
+  "doctor.store.no-match": "knowledge exists but no entry matches the probe paths \u2014 try broader paths or add relevance_paths for your modules",
+  "doctor.store.write-target-mismatch": "active write store '{alias}' is not a valid team write target for this project \u2014 run `fabric store switch-write <mounted-team-alias>`",
+  "doctor.store.first-hit-missing-required": "required store(s) not mounted: {ids} \u2014 bind/clone them then re-run `fabric first-hit`",
+  "doctor.store.first-hit-unreachable": "bound store dir missing on disk: {aliases} \u2014 remount or re-clone, then `fabric doctor`",
+  "doctor.store.hooks-missing": "knowledge present but SessionStart/PreToolUse hooks missing \u2014 re-run `fabric install`",
+  "doctor.store.first-hit-ok": "first-hit ready: {count} knowledge entries across {stores}",
   "doctor.store.alias-drift": "by-alias readability link(s) out of sync for {refs}; run `fabric doctor --fix` to repair ~/.fabric/stores/by-alias/",
   "doctor.store.local-only": "store '{alias}' is local-only; add a git remote to back it up",
   "doctor.store.executable": "store '{alias}' contains executable/script files ({files}) \u2014 stores are data-only; Fabric never runs them (S65)",
@@ -191,15 +214,22 @@ var enMessages = {
   "doctor.store.related-broken": "{count} broken `related` link(s) point at ids absent from the corpus: {samples}{overflow} \u2014 fix the related edges via `fab_review` (modify) or edit the entry frontmatter",
   "doctor.store.related-hub": "related graph hubs (top {shown} of {total} referenced): {top}",
   "doctor.store.unreachable": "store '{alias}' is in the read-set but unreachable on disk ({reason}); run `fabric store mount` / re-clone it, then `fabric doctor`",
+  "doctor.store.unreachable-bound": "bound store dir missing on disk: {stores} \u2014 re-clone or remount, then fabric doctor",
   "doctor.store.consumption-heatmap": "top consumed (last {days}d, {consumed}/{total} entries read across {windows} window(s)): {top}",
   "doctor.store.consumption-zero": "{count} entries never consumed in the last {days}d: {sample}{overflow} \u2014 review for retirement via `fab_review` (consumption is one signal, not proof of rot)",
   "doctor.store.overflow-more": ", \u2026(+{count} more)",
-  "doctor.fix-plan.header": "fix-knowledge mutation plan ({count} total)",
+  "doctor.check.knowledge_body_altitude_dump.name": "Knowledge body altitude",
+  "doctor.check.knowledge_body_altitude_dump.ok": "No dump-shaped knowledge bodies detected.",
+  "doctor.check.knowledge_body_altitude_dump.message.singular": "1 dump-shaped knowledge body: {detail}",
+  "doctor.check.knowledge_body_altitude_dump.message.plural": "{count} dump-shaped knowledge bodies (e.g. {detail})",
+  "doctor.check.knowledge_body_altitude_dump.remediation": "Rewrite as reusable decision/pitfall/guideline altitude (## structure), not a session transcript; re-archive via fabric-archive / fab_propose",
+  "doctor.check.knowledge_body_altitude_dump.scan_error": "Body-altitude scan failed ({detail}); doctor cannot confirm corpus is clean.",
+  "doctor.fix-plan.header": "knowledge mutation plan ({count} total)",
   "doctor.fix-plan.preview": "preview:",
   "doctor.fix-plan.more": "... and {count} more",
   "doctor.help.tagline": "Diagnose and fix Fabric workspace issues",
   "doctor.help.flag.target": "Override project root (defaults to cwd)",
-  "doctor.help.flag.fix": "Auto-fix issues (derived-state + knowledge frontmatter/git mv)",
+  "doctor.help.flag.fix": "Auto-fix derived state + auto-safe knowledge lint mutations",
   "doctor.help.flag.json": "Output as JSON for programmatic consumption",
   "doctor.help.flag.verbose": "Show maintainer-audience action hints",
   "doctor.help.example.run": "Run diagnostics",
@@ -288,11 +318,11 @@ var enMessages = {
   "cite-coverage.skip.architectural": "architectural layer",
   "cite-coverage.skip.other": "other",
   "cli.doctor.args.target.description": "Target project path. Defaults to --target, then EXTERNAL_FIXTURE_PATH, then cwd.",
-  "cli.doctor.args.fix.description": "Repair derived Fabric state (meta + indexes).",
+  "cli.doctor.args.fix.description": "Repair derived Fabric state (meta + indexes) and apply auto-safe knowledge lint mutations (store counter floor, stale session-hints cleanup). Decay/frontmatter lints stay report-only \u2014 remediate those via fabric-review.",
   "cli.doctor.args.json.description": "Print the doctor report as JSON.",
   "cli.doctor.args.strict.description": "Treat warnings as failures.",
-  "cli.doctor.args.fix-knowledge.description": "Apply knowledge lint mutations: archive overdue pending drafts, floor drifted per-store id counters, and prune stale session-hint caches. Decay lints (orphan demote / stale archive) are report-only \u2014 remediate those via the fab_review flow. Default doctor run remains report-only.",
-  "cli.doctor.args.yes.description": "Skip the --fix-knowledge safety confirm. Required for non-tty invocations unless FABRIC_NONINTERACTIVE=1 is set in the environment.",
+  "cli.doctor.args.fix-knowledge.description": "Legacy alias wording: knowledge lint mutations now run under `fabric doctor --fix` (store counter floor + stale session-hints cleanup). Decay lints (orphan demote / stale archive) remain report-only \u2014 remediate via fabric-review. Default doctor run remains report-only.",
+  "cli.doctor.args.yes.description": "Skip the knowledge-mutation safety confirm inside `fabric doctor --fix`. Required for non-tty invocations unless FABRIC_NONINTERACTIVE=1 is set in the environment.",
   // rc.35 TASK-12 (P0-11): --verbose unfolds maintainer-audience hints.
   "cli.doctor.args.verbose.description": "Show all action hints including maintainer-audience ones (Fabric contributors editing the source tree). By default these are folded for npm end users.",
   "doctor.maintainer-hint-folded": "(maintainer-only remediation \u2014 re-run with `fabric doctor --verbose` to see)",
@@ -401,7 +431,7 @@ var enMessages = {
   "doctor.check.events_jsonl_health.message.metric_leak": ".fabric/events.jsonl contains {count} rows with metric-counter event_types ({samples}). Those events should be aggregated in metrics.jsonl, not in the audit ledger.",
   "doctor.check.events_jsonl_health.message.metrics_stale": ".fabric/metrics.jsonl hasn't been updated for {minutes} minutes; the server-side 60s flush may be stalled.",
   "doctor.check.events_jsonl_health.message.rotation_overdue": ".fabric/events.jsonl hasn't rotated for {days} days; the 6h rotation tick may not be running.",
-  "doctor.check.events_jsonl_health.remediation": "Run `fabric doctor --fix` \u2014 it triggers a rotation AND flushes metrics.jsonl (rc.2 F16: clears idle-buffered metric counters without a server restart). If the warning persists, restart the MCP server so startMetricsFlush + startRotationTick reschedule. If metric_leak fires, audit recent code changes for direct appendEventLedgerEvent calls bypassing bumpCounter for one of the 4 metric-managed event_types.",
+  "doctor.check.events_jsonl_health.remediation": "Run `fabric doctor --fix` \u2014 it triggers events.jsonl rotation (honors fabric_event_retention_days: 7|30|90 in .fabric/fabric-config.json) AND flushes metrics.jsonl. If the warning persists, restart the MCP server so startMetricsFlush + startRotationTick reschedule. If metric_leak fires, audit recent code changes for direct appendEventLedgerEvent calls bypassing bumpCounter for one of the 4 metric-managed event_types.",
   "doctor.check.event_ledger_partial_write.name": "Event ledger partial write",
   "doctor.check.event_ledger_partial_write.ok.skipped": "No partial-write check needed (ledger missing or not writable).",
   "doctor.check.event_ledger_partial_write.message": "events.jsonl has a partial write at byte offset {byteOffset} ({byteLength} corrupted bytes). Run --fix to truncate and preserve corrupted bytes.",
@@ -425,9 +455,9 @@ var enMessages = {
   "doctor.check.retired_reference.ok": "No retired tool/field names linger in the bootstrap, SKILL.md, or installed hooks.",
   "doctor.check.retired_reference.message": "{count} stale pointer(s) to retired tool/field names in agent-facing text: {sample}",
   "doctor.check.retired_reference.remediation": "Update the flagged text to the replacement token (or remove it), then re-run `fabric install` to resync the dogfood mirrors.",
-  // v2.0.0-rc.33 W3-6 (P1-13): SKILL.md token budget lint. warn > 5K / error > 10K tokens (chars/3 estimate). Anthropic recommends SKILL.md hot path stay ~3K; over 5K hurts progressive disclosure; over 10K is blocking (wasted model context + load latency).
+  // v2.0.0-rc.33 W3-6 (P1-13): SKILL.md token budget lint. warn > 8K / error > 10K tokens (chars/3 estimate). Anthropic recommends SKILL.md hot path stay ~3K, but the two watched skills (fabric-archive/review) are the richest core skills and legitimately run larger; warn sits at 8K (a 2K reaction buffer below the 10K install-abort hard cap) rather than 5K. Over 10K is blocking (wasted model context + load latency).
   "doctor.check.skill_token_budget.name": "Skill token budget",
-  "doctor.check.skill_token_budget.ok": "All .claude/skills/<slug>/SKILL.md files are within token budget (warn 5K / error 10K).",
+  "doctor.check.skill_token_budget.ok": "All .claude/skills/<slug>/SKILL.md files are within token budget (warn 8K / error 10K).",
   "doctor.check.skill_token_budget.message.singular": "{count} SKILL.md exceeds the token budget: {list}. Sink detail into ref/ for progressive disclosure.",
   "doctor.check.skill_token_budget.message.plural": "{count} SKILL.md files exceed the token budget: {list}. Sink detail into ref/ for progressive disclosure.",
   "doctor.check.skill_token_budget.remediation": "Move detailed phase / worked-examples / decision tables out of the SKILL.md hot path into `templates/skills/<slug>/ref/*.md`. Keep SKILL.md focused on trigger-gate + key-phase summaries; see W1 progressive disclosure split. Re-run `fabric install` to sync both client subtrees.",
@@ -511,7 +541,7 @@ var enMessages = {
   "doctor.check.index_drift.ok": "agents.meta.json counters envelope is at or above the highest existing canonical counter for every (layer, type) pair.",
   "doctor.check.index_drift.message.singular": "{count} (layer, type) counter slot have drifted below the observed canonical maximum (next allocate would collide). First: {detail}.",
   "doctor.check.index_drift.message.plural": "{count} (layer, type) counter slots have drifted below the observed canonical maximum (next allocate would collide). First: {detail}.",
-  "doctor.check.index_drift.remediation": "Run `fabric doctor --fix-knowledge` to bump agents.meta.json counters to max_observed + 1.",
+  "doctor.check.index_drift.remediation": "Run `fabric doctor --fix` to bump agents.meta.json counters to max_observed + 1.",
   "doctor.check.underseeded.name": "Knowledge underseeded",
   "doctor.check.underseeded.ok": "Knowledge corpus has {count} canonical entries (>= {threshold}).",
   "doctor.check.underseeded.message.singular": "Knowledge corpus has only {count} canonical entry (< {threshold} threshold). The plan_context retrieval surface is below its useful floor.",
@@ -521,7 +551,7 @@ var enMessages = {
   "doctor.check.session_hints_stale.ok": "No session-hints cache files older than {days} days under .fabric/.cache/.",
   "doctor.check.session_hints_stale.message.singular": "{count} session-hints cache file under .fabric/.cache/ is older than {days} days. First: {detail}.",
   "doctor.check.session_hints_stale.message.plural": "{count} session-hints cache files under .fabric/.cache/ are older than {days} days. First: {detail}.",
-  "doctor.check.session_hints_stale.remediation": "Run `fabric doctor --fix-knowledge` to delete stale session-hints cache files.",
+  "doctor.check.session_hints_stale.remediation": "Run `fabric doctor --fix` to delete stale session-hints cache files.",
   "doctor.check.hook_cache_writable.name": "Hook cache writable",
   "doctor.check.hook_cache_writable.ok": "Hook sidecar cache path {path} accepts write probes.",
   "doctor.check.hook_cache_writable.message": "Hook sidecar cache path {path} is not writable; hook state updates will silently fail. Error: {error}.",
@@ -604,6 +634,7 @@ var enMessages = {
   "doctor.check.relevance_paths_drift.message.plural": "{count} narrow-scope canonical entries have relevance_paths whose globs match no file touched in the last {windowDays}d of git history. First: {detail}.",
   "doctor.check.relevance_paths_drift.remediation": "Review whether the entry is still relevant \u2014 use `fab_review.modify` to refresh the anchors or `fab_review.reject` to archive.",
   // W4-3 (KT-MOD-0001): narrow-scope entry with an empty relevance_paths set.
+  "doctor.check.relevance_paths_drift.remediation_with_sample": "Review whether the entry is still relevant \u2014 sample {sample}; refresh anchors via `fab_review.modify`, or archive via `fab_review.reject`.",
   "doctor.check.narrow_no_paths.name": "Knowledge narrow scope without paths",
   "doctor.check.narrow_no_paths.ok": "Every narrow-scope canonical entry carries at least one relevance_path.",
   "doctor.check.narrow_no_paths.message.singular": "{count} narrow-scope entry has an empty relevance_paths set \u2014 it can never path-match, so it will never surface (permanently dead). First: {detail}.",
@@ -655,6 +686,14 @@ var enMessages = {
   "doctor.check.stray_fabric_dir_detected.ok": "No stray .fabric directories under the project root \u2014 the only authoritative anchor is <projectRoot>/.fabric.",
   "doctor.check.stray_fabric_dir_detected.message": "Found {count} stray .fabric director(ies) ({dirs}) left by subprocesses that mistook a subdirectory for the project root (pre-rc.10 hooks / pre-rc.11 server-side). These scatter events.jsonl / metrics.jsonl / .cache across the source tree.",
   "doctor.check.stray_fabric_dir_detected.remediation": "Run `fabric doctor --fix` to rename each stray dir to `.fabric.stale-<timestamp>` (rescue-before-delete \u2014 never a hard delete). Review the renamed dirs before merging events. Also upgrade global fabric-cli to rc.11+ so the server-side git-anchor resolver is active.",
+  // legacy_fabric_cache_dir_detected — the recall engine's BM25 / vector
+  // caches used to live at `.fabric/cache/{bm25,vectors}`; unify-fabric-cache-dir
+  // moved them into `.fabric/.cache/` next to the hook sidecar cache so one
+  // .gitignore rule covers both. Old data is intact; the fix is a rename.
+  "doctor.check.legacy_fabric_cache_dir_detected.name": "Legacy .fabric/cache/ directories",
+  "doctor.check.legacy_fabric_cache_dir_detected.ok": "Recall caches live under .fabric/.cache/ \u2014 no legacy .fabric/cache/{bm25,vectors} remains.",
+  "doctor.check.legacy_fabric_cache_dir_detected.message": "Found {count} legacy recall-cache dir(s) ({dirs}). These pre-date the unify-fabric-cache-dir move to .fabric/.cache/; the on-disk data (BM25 snapshots / vector embeddings) is intact \u2014 a rename preserves it.",
+  "doctor.check.legacy_fabric_cache_dir_detected.remediation": "Run `fabric doctor --fix` to rename each legacy dir into its `.fabric/.cache/` counterpart (idempotent; skipped if the new path already holds newer data). No re-embed cost is paid; the snapshot files are moved as-is.",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "All .claude/.codex SKILL.md frontmatter values parse as strict YAML.",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} SKILL.md frontmatter value contains an unquoted ': ' that strict YAML parsers reject (Claude Code tolerates it; Codex CLI drops the skill at load). First: {detail}.",
@@ -796,6 +835,7 @@ var enMessages = {
   // so its MCP server loads — that is the default anchor; the --reapply maintenance
   // hint moves to --verbose.
   "cli.install.next-step.restart": "restart any open Claude Code / Codex session to load Fabric (new sessions pick it up automatically).",
+  "cli.install.next-step.nudge-mode": 'Human breadcrumbs default to minimal (one status line/session). Mute with nudge_mode: "silent" in .fabric/fabric-config.json or FABRIC_NUDGE_MODE=silent; raise with normal/verbose.',
   "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)",
@@ -852,7 +892,7 @@ var enMessages = {
   "cli.install.semantic.installing": "Running `npm i -g fastembed` \u2026",
   "cli.install.semantic.installed": "fastembed installed. The embedding model downloads automatically on the first recall (~tens\u2013hundreds of MB; no KB data is uploaded).",
   "cli.install.semantic.install-failed": "Auto-install failed ({reason}). Run the steps manually:",
-  "cli.install.semantic.manual-steps": "  1. Install the optional embedder where the MCP server resolves modules (a global install is global):\n       npm i -g fastembed\n  2. Warm the model cache (the first run downloads the weights, ~tens\u2013hundreds of MB; no KB data is uploaded):\n       export FABRIC_EMBED_CACHE_DIR=~/.cache/fabric-embed   # strict-offline: pre-place the weights here\n  Note: after switching embed_model the existing vector dim/semantics change; the next recall re-embeds with the new model (doc vectors are cached by text and auto-recompute on mismatch).\n  Disable: set embed_enabled=false in fabric.config.json.",
+  "cli.install.semantic.manual-steps": "  1. Install the optional embedder where the MCP server resolves modules (a global install is global):\n       npm i -g fastembed\n  2. Warm the model cache (the first run downloads the weights, ~tens\u2013hundreds of MB; no KB data is uploaded):\n       export FABRIC_EMBED_CACHE_DIR=~/.cache/fabric-embed   # strict-offline: pre-place the weights here\n  Note: after switching embed_model the existing vector dim/semantics change; the next recall re-embeds with the new model (doc vectors are cached by text and auto-recompute on mismatch).\n  Disable: set embed_enabled=false in .fabric/fabric-config.json.",
   // C5: store onboarding interactive copy routed through t().
   "cli.install.store.local-store": "local store",
   "cli.install.store.bind-mounted.prompt": "Bind an already-mounted knowledge store to this project?",
@@ -1019,6 +1059,23 @@ var enMessages = {
   // per [[fabric-serve-quarantine-not-delete]]. Restore from git history when
   // the web UI surface is re-enabled.
   // v2.0.0-rc.29 TASK-008 (BUG-L2): onboard-coverage i18n keys.
+  "cli.first-hit.description": "Prove install\u2192first-hit readiness (bind + non-empty knowledge surface)",
+  "cli.first-hit.args.json.description": "Machine-readable JSON report",
+  "cli.first-hit.args.target.description": "Project root (default: cwd)",
+  "cli.first-hit.args.seed.description": "If empty store, write minimal starter knowledge entries",
+  "cli.first-hit.args.paths.description": "Comma-separated probe paths for surface check",
+  "cli.first-hit.msg.ok": "first-hit ready: {total} knowledge entr{plural} across {stores} store(s); hooks present.",
+  "cli.first-hit.msg.unbound": "unbound: no store is bound to this project's read-set \u2014 knowledge cannot surface.",
+  "cli.first-hit.msg.no_write_target": "no_write_target: project has required stores but no active_write_store.",
+  "cli.first-hit.msg.empty_store": "empty_store: store(s) bound but 0 canonical knowledge files \u2014 empty store is not a happy path.",
+  "cli.first-hit.msg.missing_required": "missing_required: one or more required_stores are not mounted \u2014 multi-store bind incomplete.",
+  "cli.first-hit.msg.write_target_mismatch": "write_target_mismatch: active_write_store is not a mounted writable store on the read-set.",
+  "cli.first-hit.msg.store_unreachable": "store_unreachable: a bound store is registered but its directory is missing on disk.",
+  "cli.first-hit.msg.project_unsealed": "project_unsealed: write store is bound but project_id/active_project is missing \u2014 team knowledge will land flat (semantic_scope: team), not project-partitioned.",
+  "cli.first-hit.msg.no_match": "no_match: knowledge exists but the probe surface is empty (path/scope filter).",
+  "cli.first-hit.msg.hooks_missing": "hooks_missing: knowledge is present but SessionStart/PreToolUse hooks are not installed.",
+  "cli.first-hit.msg.no_project": "no_project: this directory is not a Fabric project (missing .fabric/fabric-config.json).",
+  "cli.first-hit.msg.no_global": "no_global: fabric global config missing \u2014 run fabric install --global first.",
   "cli.onboard-coverage.description": "Report S5 onboard-slot coverage for the workspace. Used by the fabric-archive Skill's first-run phase to detect unclaimed project-tone slots.",
   "cli.onboard-coverage.args.json.description": "Emit machine-readable JSON to stdout instead of the human table.",
   "cli.onboard-coverage.args.target.description": "Override the project root (defaults to cwd).",
@@ -1269,6 +1326,10 @@ var enMessages = {
   "cli.info.recall.vector.not-ready": "not ready \u2014 recall falls back to keyword mode (BM25 / additive)",
   "cli.info.recall.warm.ok": "embedder warm: model '{model}' loaded (vector dim {dim}), cached at {dir}",
   "cli.info.recall.warm.fail": "embedder unavailable \u2014 the optional 'fastembed' package is not resolvable or the model failed to load.\n  Recall falls back to keyword mode (BM25 / additive). Install fastembed where the server resolves modules, then retry.",
+  "cli.store.mount.description": "Mount a knowledge store into the global registry",
+  "cli.store.create.description": "Create a brand-new local knowledge store and mount it",
+  "cli.store.remove.description": "Detach a store from the registry (does NOT delete it)",
+  "cli.store.explain.description": "Explain how a store alias resolves",
   "cli.store.list.description": "List mounted knowledge stores",
   // Footer note appended to `fabric store --help` — explains where the advanced
   // (meta.hidden) operations went so the list-only listing isn't a dead end.
@@ -1342,6 +1403,8 @@ var enMessages = {
 
 // src/i18n/locales/zh-CN.ts
 var zhCNMessages = {
+  "cli.signpost.retired": "\u547D\u4EE4 `{retired}` \u5DF2\u79FB\u9664\u3002\u8BF7\u6539\u7528 `{successor}`\u3002",
+  "cli.doctor.args.probe.description": "\u8F93\u51FA\u673A\u5668\u53EF\u8BFB JSON \u5C31\u7EEA\u5FEB\u7167(first-hit + store/hooks),\u4E0D\u8DD1 --fix CI \u4F18\u5148\u7528 --probe \u505A\u8F7B\u91CF\u5C31\u7EEA\u5FEB\u7167\uFF1B\u5B8C\u6574 cite-coverage \u626B\u63CF\u6309\u9700\u8FD0\u884C\u3002",
   "cli.main.description": "Fabric CLI \u2014 \u81EA\u52A8\u628A\u672C\u9879\u76EE\u7684\u51B3\u7B56 / \u8E29\u5751 / \u89C4\u8303\u5582\u7ED9\u4F60\u7684 AI \u52A9\u624B\uFF0C\u8BA9\u5B83\u4E0D\u5FC5\u6BCF\u6B21\u4F1A\u8BDD\u91CD\u65B0\u5B66\u3002\u9996\u6B21\u4F7F\u7528?\u8FD0\u884C: fabric install",
   "cli.shared.created": "\u5DF2\u521B\u5EFA",
   "cli.shared.skipped": "\u5DF2\u8DF3\u8FC7",
@@ -1384,10 +1447,23 @@ var zhCNMessages = {
   "cli.inspect.explain.census": "\u5168\u96C6\u666E\u67E5",
   "cli.inspect.explain.census-total": "\u603B\u8BA1 {total}",
   "cli.inspect.error": "inspect \u5931\u8D25:{message}",
+  // `fabric preview` — 本地只读知识预览 web 服务(loopback-only)。
+  "cli.preview.description": "\u542F\u52A8\u672C\u5730\u53EA\u8BFB\u77E5\u8BC6\u9884\u89C8\u9875(\u6D4F\u89C8\u5668\u91CC\u6309\u53D7\u4F17\u5206\u7EC4\u6D4F\u89C8)",
+  "cli.preview.arg.port": "\u76D1\u542C\u7AEF\u53E3(\u9ED8\u8BA4 7777)\u3002",
+  "cli.preview.arg.host": "\u76D1\u542C\u5730\u5740(\u9ED8\u8BA4 127.0.0.1,\u4EC5\u672C\u673A\u53EF\u8BBF\u95EE)\u3002",
+  "cli.preview.arg.open": "\u542F\u52A8\u540E\u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668(\u9ED8\u8BA4\u5F00;\u4F20 --no-open \u5173\u95ED)\u3002",
+  "cli.preview.arg.target": "\u8986\u76D6\u9879\u76EE\u6839\u76EE\u5F55(\u9ED8\u8BA4\u53D6 cwd)\u3002",
+  "cli.preview.arg.variant": "\u9ED8\u8BA4\u6253\u5F00\u7684\u6837\u5F0F\u53D8\u4F53(\u9ED8\u8BA4 lumen;\u5168\u90E8\u98CE\u683C\u89C1 /gallery)\u3002",
+  "cli.preview.gallery-hint": "\u6240\u6709\u6837\u5F0F\u753B\u5ECA:{url}",
+  "cli.preview.started": "\u77E5\u8BC6\u9884\u89C8\u5DF2\u542F\u52A8:{url}",
+  "cli.preview.opening": "\u6B63\u5728\u6253\u5F00\u6D4F\u89C8\u5668\u2026",
+  "cli.preview.stop-hint": "\u6309 Ctrl-C \u505C\u6B62\u3002",
+  "cli.preview.stopped": "\u9884\u89C8\u5DF2\u505C\u6B62\u3002",
+  "cli.preview.error": "preview \u5931\u8D25:{message}",
   "cli.audit.description": "\u77E5\u8BC6\u4E0E\u9065\u6D4B\u5BA1\u8BA1 (cite/conflicts/history/metrics)",
   // `fabric audit cite` — recall 覆盖率为 0 的自诊断提示。
-  "cli.audit.cite.recall-mismatch-hint": "recall \u8986\u76D6\u7387\u4E3A 0,\u4F46\u672C\u7A97\u53E3\u6709 {recalls} \u6B21 recall(\u5206\u5E03\u5728 {sessions} \u4E2A\u4F1A\u8BDD)\u2014\u2014 \u6CA1\u6709\u4E00\u4E2A\u4E0E\u7F16\u8F91\u5171\u4EAB\u4F1A\u8BDD\u3002\u591A\u534A\u662F fab_recall \u8C03\u7528\u65B9\u4F20\u4E86\u975E\u5BA2\u6237\u7AEF session_id(\u5173\u8054\u6309\u4F1A\u8BDD\u9694\u79BB)\u3002\u89C1 AGENTS.md:fab_recall \u5FC5\u987B\u4F20\u5165\u771F\u5B9E\u5BA2\u6237\u7AEF session_id\u3002",
-  "cli.audit.cite.recall-none-hint": "recall \u8986\u76D6\u7387\u4E3A 0 \u2014\u2014 \u8FD9\u4E9B\u7F16\u8F91\u524D\u6CA1\u6709\u540C\u4F1A\u8BDD\u7684 fab_recall\u3002\u6539\u524D\u5148 recall,\u4E14\u4F20\u5165\u771F\u5B9E\u5BA2\u6237\u7AEF session_id(\u5173\u8054\u6309\u4F1A\u8BDD\u9694\u79BB)\u3002\u89C1 AGENTS.md\u3002",
+  "cli.audit.cite.recall-mismatch-hint": "recall \u8986\u76D6\u7387\u4E3A 0,\u4F46\u672C\u7A97\u53E3\u6709 {recalls} \u6B21 recall(\u5206\u5E03\u5728 {sessions} \u4E2A\u4F1A\u8BDD)\u2014\u2014 \u6CA1\u6709\u4E00\u4E2A\u4E0E\u7F16\u8F91\u5171\u4EAB\u4F1A\u8BDD\u3002\u5E38\u89C1\u539F\u56E0:(1) fab_recall \u6F0F\u4F20/\u4F20\u9519 session_id(\u5FC5\u987B\u662F\u771F\u5B9E\u5BA2\u6237\u7AEF session_id;planned \u65E0 session \u6C38\u4E0D\u4E0E edit \u5173\u8054);(2) recall \u7684 paths \u4E0E\u7F16\u8F91\u6587\u4EF6\u65E0 path-overlap(\u81EA\u52A8 cite \u53EA\u8BA1\u91CD\u53E0\u7684 planned.target_paths)\u3002\u4FEE:\u4F20 session_id\u3001\u91CD\u88C5 hooks \u542F\u7528 active-session sidecar\u3001\u6216 fab_recall \u8986\u76D6\u5C06\u7F16\u8F91\u7684\u8DEF\u5F84\u3002\u89C1 AGENTS.md \u4E0E docs/UPGRADE.md\u3002",
+  "cli.audit.cite.recall-none-hint": "recall \u8986\u76D6\u7387\u4E3A 0 \u2014\u2014 \u8FD9\u4E9B\u7F16\u8F91\u524D\u6CA1\u6709\u540C\u4F1A\u8BDD\u7684 fab_recall(\u6216 planned \u4E8B\u4EF6 session_id \u4E3A\u7A7A\u5BFC\u81F4\u65E0\u6CD5\u5173\u8054)\u3002\u6539\u524D\u5148 recall \u5E76\u4F20\u5165\u771F\u5B9E\u5BA2\u6237\u7AEF session_id;install \u540E SessionStart \u4F1A\u5199 .fabric/.cache/active-session.json \u4F9B\u670D\u52A1\u7AEF\u56DE\u586B\u3002\u4ECD\u8981\u6C42 path-overlap:recall \u8981\u8986\u76D6\u5C06\u7F16\u8F91\u7684\u6587\u4EF6,\u4E0D\u8981\u53EA recall \u65E0\u5173\u7684 .fabric \u8DEF\u5F84\u3002\u89C1 AGENTS.md \u4E0E docs/UPGRADE.md\u3002",
   // `fabric audit --help` — 过滤式帮助(i18n 子命令清单)。
   "cli.audit.help.tagline": "\u77E5\u8BC6\u4E0E\u9065\u6D4B\u5BA1\u8BA1\u9762(\u53EA\u8BFB)",
   "cli.audit.help.sub.cite": "Cite \u653F\u7B56\u9075\u5FAA\u5EA6\u62A5\u544A",
@@ -1430,7 +1506,7 @@ var zhCNMessages = {
   "cli.config.install.args.dry-run.description": "\u4EC5\u9884\u89C8\u5C06\u8981\u53D1\u751F\u7684\u5199\u5165\u64CD\u4F5C\uFF0C\u4E0D\u4FEE\u6539\u6587\u4EF6\u3002",
   "cli.config.errors.unknown-client": "\u672A\u77E5\u5BA2\u6237\u7AEF\u201C{client}\u201D\u3002\u8BF7\u4F7F\u7528\u9017\u53F7\u5206\u9694\u5217\u8868\uFF0C\u4F8B\u5982 cc,codex\u3002",
   "cli.config.errors.expected-object": "{path} \u4E2D\u5E94\u4E3A\u5BF9\u8C61\u3002",
-  "cli.config.install.no-configs": "\u672A\u68C0\u6D4B\u5230 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002\u8BF7\u521B\u5EFA\u5BA2\u6237\u7AEF\u76EE\u5F55\uFF0C\u6216\u5728 fabric.config.json \u4E2D\u8BBE\u7F6E clientPaths\u3002",
+  "cli.config.install.no-configs": "\u672A\u68C0\u6D4B\u5230 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002\u8BF7\u521B\u5EFA\u5BA2\u6237\u7AEF\u76EE\u5F55\uFF0C\u6216\u5728 .fabric/fabric-config.json \u4E2D\u8BBE\u7F6E clientPaths\u3002",
   "cli.config.install.no-config-path": "\u8DF3\u8FC7 {client}\uFF1A\u672A\u68C0\u6D4B\u5230\u914D\u7F6E\u8DEF\u5F84\u3002",
   "cli.config.install.dry-run": "[dry-run] {client}\uFF1A\u5C06\u5199\u5165 {path}",
   "cli.config.install.wrote": "{client}\uFF1A\u5DF2\u5199\u5165 {path}",
@@ -1499,7 +1575,7 @@ var zhCNMessages = {
   "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",
+  "doctor.section.fix-knowledge-mutations": "\u77E5\u8BC6\u4FA7\u53D8\u66F4\uFF1A",
   // flat-design follow-up: doctor 剩余的 UI-shell 文案(TL;DR 头、--fix 变更计划、
   // 过滤版 --help)从硬编码英文搬进 i18n,让整个 `fabric doctor` 输出跟随机器语言。
   // USAGE/OPTIONS/EXAMPLES 标签保持英文,与其它命令 --help 的 citty renderUsage 对齐。
@@ -1511,7 +1587,15 @@ var zhCNMessages = {
   // 文案通过插值带上 store alias / 计数。
   "doctor.store.no-global-config": "\u65E0\u5168\u5C40 Fabric \u914D\u7F6E \u2014\u2014 \u8FD0\u884C `fabric install --global <url>`",
   "doctor.store.missing-required": "\u5FC5\u9700 store '{id}' \u672A\u6302\u8F7D;\u8FD0\u884C `fabric store mount`",
-  "doctor.store.unbound": "store '{alias}' \u5DF2\u6302\u8F7D\u4F46\u672A\u7ED1\u5B9A\u5230\u672C\u9879\u76EE;\u8FD0\u884C `fabric store bind {alias}` \u5373\u53EF\u5728\u6B64\u8BFB\u53D6\u5B83\u7684\u77E5\u8BC6(\u518D\u7528 `fabric store switch-write {alias}` \u628A\u56E2\u961F\u77E5\u8BC6\u5199\u5165\u5B83)",
+  "doctor.store.unbound": "store '{alias}' \u5DF2\u6302\u8F7D\u4F46\u672A\u7ED1\u5B9A\u5230\u672C\u9879\u76EE \u2014 \u7C98\u8D34\u6267\u884C: `fabric store bind {alias}` \u7136\u540E `fabric store switch-write {alias}`",
+  "doctor.store.empty": "\u5DF2\u7ED1\u5B9A store \u77E5\u8BC6\u6761\u6570\u4E3A 0\uFF08{stores}\uFF09\u2014\u2014\u5728 seed \u6216 clone \u6709\u5185\u5BB9\u524D\u65E0\u6CD5 first-hit\uFF1B\u8FD0\u884C `fabric first-hit --seed`\uFF08\u7A7A\u672C\u5730\u5E93\uFF09\u6216\u7ED1\u5B9A\u5E26\u5185\u5BB9\u7684\u8FDC\u7A0B team store",
+  "doctor.store.no-write-target": "\u672C\u9879\u76EE\u65E0 active write store \u2014 \u7C98\u8D34\u6267\u884C: `fabric store bind <alias>` \u7136\u540E `fabric store switch-write <alias>`\uFF08\u6216 `fabric install`\uFF09",
+  "doctor.store.no-match": "\u77E5\u8BC6\u5B58\u5728\u4F46\u4E0E\u63A2\u6D4B\u8DEF\u5F84\u65E0\u5339\u914D \u2014\u2014 \u653E\u5BBD paths \u6216\u4E3A\u6A21\u5757\u8865 relevance_paths",
+  "doctor.store.write-target-mismatch": "\u6D3B\u52A8\u5199\u5E93 '{alias}' \u4E0D\u662F\u672C\u9879\u76EE\u7684\u6709\u6548 team \u5199\u76EE\u6807 \u2014\u2014 \u8FD0\u884C `fabric store switch-write <\u5DF2\u6302\u8F7D team \u522B\u540D>`",
+  "doctor.store.first-hit-missing-required": "\u5FC5\u9700 store \u672A\u6302\u8F7D: {ids} \u2014\u2014 \u5148 bind/clone \u518D\u8DD1 `fabric first-hit`",
+  "doctor.store.first-hit-unreachable": "\u5DF2\u7ED1\u5B9A store \u76EE\u5F55\u78C1\u76D8\u7F3A\u5931: {aliases} \u2014\u2014 remount/re-clone \u540E\u8DD1 `fabric doctor`",
+  "doctor.store.hooks-missing": "\u77E5\u8BC6\u5DF2\u6709\u4F46 SessionStart/PreToolUse hooks \u7F3A\u5931 \u2014\u2014 \u91CD\u8DD1 `fabric install`",
+  "doctor.store.first-hit-ok": "first-hit \u5C31\u7EEA\uFF1A{count} \u6761\u77E5\u8BC6\uFF0Cstore\uFF1A{stores}",
   "doctor.store.alias-drift": "by-alias \u53EF\u8BFB\u6027\u8F6F\u94FE\u4E0E\u6CE8\u518C\u8868\u4E0D\u540C\u6B65:{refs};\u8FD0\u884C `fabric doctor --fix` \u4FEE\u590D ~/.fabric/stores/by-alias/",
   "doctor.store.local-only": "store '{alias}' \u4EC5\u672C\u5730;\u52A0\u4E00\u4E2A git remote \u4EE5\u5907\u4EFD",
   "doctor.store.executable": "store '{alias}' \u542B\u53EF\u6267\u884C/\u811A\u672C\u6587\u4EF6({files})\u2014\u2014 store \u4EC5\u5B58\u6570\u636E;Fabric \u4ECE\u4E0D\u8FD0\u884C\u5B83\u4EEC (S65)",
@@ -1520,15 +1604,22 @@ var zhCNMessages = {
   "doctor.store.related-broken": "{count} \u6761 `related` \u94FE\u63A5\u6307\u5411\u8BED\u6599\u4E2D\u4E0D\u5B58\u5728\u7684 id:{samples}{overflow} \u2014\u2014 \u901A\u8FC7 `fab_review` (modify) \u4FEE\u590D related \u8FB9,\u6216\u7F16\u8F91\u6761\u76EE frontmatter",
   "doctor.store.related-hub": "related \u56FE\u8C31\u67A2\u7EBD(\u524D {shown} / \u5171 {total} \u4E2A\u88AB\u5F15\u7528):{top}",
   "doctor.store.unreachable": "store '{alias}' \u5728 read-set \u4E2D\u4F46\u78C1\u76D8\u4E0A\u4E0D\u53EF\u8FBE({reason});\u8FD0\u884C `fabric store mount` / \u91CD\u65B0 clone,\u518D\u8DD1 `fabric doctor`",
+  "doctor.store.unreachable-bound": "\u5DF2\u7ED1\u5B9A store \u7684\u78C1\u76D8\u76EE\u5F55\u7F3A\u5931\uFF1A{stores} \u2014 \u8BF7 re-clone \u6216 remount\uFF0C\u518D\u8DD1 fabric doctor",
   "doctor.store.consumption-heatmap": "\u6D88\u8D39\u70ED\u533A(\u8FD1 {days}d,{consumed}/{total} \u6761\u88AB\u8BFB,\u8DE8 {windows} \u4E2A\u7A97\u53E3):{top}",
   "doctor.store.consumption-zero": "{count} \u6761\u5728\u8FD1 {days}d \u5185\u4ECE\u672A\u88AB\u6D88\u8D39:{sample}{overflow} \u2014\u2014 \u901A\u8FC7 `fab_review` \u8003\u8651\u6DD8\u6C70(\u6D88\u8D39\u91CF\u53EA\u662F\u4FE1\u53F7\u4E4B\u4E00,\u975E\u9648\u65E7\u7684\u8BC1\u636E)",
   "doctor.store.overflow-more": ", \u2026(+{count} \u6761)",
-  "doctor.fix-plan.header": "fix-knowledge \u53D8\u66F4\u8BA1\u5212(\u5171 {count} \u9879)",
+  "doctor.check.knowledge_body_altitude_dump.name": "\u77E5\u8BC6\u6B63\u6587 altitude",
+  "doctor.check.knowledge_body_altitude_dump.ok": "\u672A\u53D1\u73B0 dump \u5F62\u6001\u7684\u77E5\u8BC6\u6B63\u6587\u3002",
+  "doctor.check.knowledge_body_altitude_dump.message.singular": "1 \u6761 dump \u5F62\u6001\u77E5\u8BC6\u6B63\u6587: {detail}",
+  "doctor.check.knowledge_body_altitude_dump.message.plural": "{count} \u6761 dump \u5F62\u6001\u77E5\u8BC6\u6B63\u6587(\u4F8B\u5982 {detail})",
+  "doctor.check.knowledge_body_altitude_dump.remediation": "\u6539\u5199\u6210\u53EF\u590D\u7528\u7684 decision/pitfall/guideline altitude(\u5E26 ## \u7ED3\u6784),\u4E0D\u8981\u8D34 session \u6D41\u6C34;\u7ECF fabric-archive / fab_propose \u91CD\u5F52\u6863",
+  "doctor.check.knowledge_body_altitude_dump.scan_error": "\u6B63\u6587 altitude \u626B\u63CF\u5931\u8D25({detail});doctor \u65E0\u6CD5\u786E\u8BA4\u8BED\u6599\u5E72\u51C0\u3002",
+  "doctor.fix-plan.header": "\u77E5\u8BC6\u4FA7\u53D8\u66F4\u8BA1\u5212(\u5171 {count} \u9879)",
   "doctor.fix-plan.preview": "\u9884\u89C8:",
   "doctor.fix-plan.more": "... \u8FD8\u6709 {count} \u9879",
   "doctor.help.tagline": "\u8BCA\u65AD\u5E76\u4FEE\u590D Fabric \u5DE5\u4F5C\u533A\u95EE\u9898",
   "doctor.help.flag.target": "\u8986\u76D6\u9879\u76EE\u6839\u76EE\u5F55(\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55)",
-  "doctor.help.flag.fix": "\u81EA\u52A8\u4FEE\u590D(\u6D3E\u751F\u72B6\u6001 + \u77E5\u8BC6 frontmatter/git mv)",
+  "doctor.help.flag.fix": "\u81EA\u52A8\u4FEE\u590D(\u6D3E\u751F\u72B6\u6001 + \u77E5\u8BC6\u4FA7 cache/counter \u53D8\u66F4)",
   "doctor.help.flag.json": "\u4EE5 JSON \u8F93\u51FA\u4F9B\u7A0B\u5E8F\u6D88\u8D39",
   "doctor.help.flag.verbose": "\u663E\u793A\u9762\u5411\u7EF4\u62A4\u8005\u7684\u64CD\u4F5C\u63D0\u793A",
   "doctor.help.example.run": "\u8FD0\u884C\u8BCA\u65AD",
@@ -1611,11 +1702,11 @@ var zhCNMessages = {
   "cite-coverage.skip.architectural": "\u67B6\u6784\u5C42",
   "cite-coverage.skip.other": "\u5176\u4ED6",
   "cli.doctor.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 --target\u3001EXTERNAL_FIXTURE_PATH\u3001\u5F53\u524D\u76EE\u5F55\u3002",
-  "cli.doctor.args.fix.description": "\u4FEE\u590D Fabric \u6D3E\u751F\u72B6\u6001\uFF08meta + \u7D22\u5F15\uFF09\u3002",
+  "cli.doctor.args.fix.description": "\u81EA\u52A8\u4FEE\u590D\u6D3E\u751F\u72B6\u6001\uFF08meta/\u7D22\u5F15/\u9501\uFF09\u4E0E\u77E5\u8BC6\u4FA7\u53D8\u66F4\uFF08store \u8BA1\u6570\u5668 floor\u3001\u9648\u65E7 session-hints \u7F13\u5B58\u6E05\u7406\uFF09\u3002\u8870\u51CF\u7C7B lint(orphan demote / stale archive)\u4ECD\u53EA\u8BFB\u4E0A\u62A5 \u2014 \u8BF7\u8D70 fab_review\u3002",
   "cli.doctor.args.json.description": "\u4EE5 JSON \u8F93\u51FA doctor \u62A5\u544A\u3002",
   "cli.doctor.args.strict.description": "\u5C06 warning \u4E5F\u89C6\u4E3A\u5931\u8D25\u3002",
-  "cli.doctor.args.fix-knowledge.description": "\u5E94\u7528\u77E5\u8BC6\u5E93 lint \u53D8\u66F4:\u5F52\u6863\u903E\u671F pending draft\u3001\u4FEE\u6B63\u6F02\u79FB\u7684 per-store id \u8BA1\u6570\u5668\u3001\u6E05\u7406\u9648\u65E7 session-hint \u7F13\u5B58\u3002\u8870\u51CF\u7C7B lint(orphan demote / stale archive)\u53EA\u8BFB\u4E0A\u62A5 \u2014 \u8BF7\u901A\u8FC7 fab_review \u6D41\u7A0B\u5904\u7406\u3002\u9ED8\u8BA4 doctor \u8FD0\u884C\u4ECD\u7136\u53EA\u8BFB\u3002",
-  "cli.doctor.args.yes.description": "\u8DF3\u8FC7 --fix-knowledge \u7684\u5B89\u5168\u786E\u8BA4\uFF1B\u975E tty \u8C03\u7528\u5FC5\u987B\u663E\u5F0F\u8BBE\u7F6E\u8BE5\u6807\u8BB0\uFF0C\u6216\u5728\u73AF\u5883\u53D8\u91CF\u4E2D\u8BBE\u7F6E FABRIC_NONINTERACTIVE=1\u3002",
+  "cli.doctor.args.fix-knowledge.description": "\uFF08\u5185\u90E8/legacy \u540D\u79F0\uFF09\u77E5\u8BC6\u4FA7 mutation \u81C2\uFF0C\u73B0\u5DF2\u7531 `fabric doctor --fix` \u4E00\u5E76\u8C03\u7528\u3002\u52FF\u518D\u5355\u72EC\u4F9D\u8D56 --fix-knowledge\u3002",
+  "cli.doctor.args.yes.description": "\u8DF3\u8FC7 --fix \u77E5\u8BC6\u4FA7\u5B89\u5168\u786E\u8BA4\uFF1B\u975E tty \u8C03\u7528\u5FC5\u987B\u663E\u5F0F\u8BBE\u7F6E\u8BE5\u6807\u8BB0\uFF0C\u6216\u5728\u73AF\u5883\u53D8\u91CF\u4E2D\u8BBE\u7F6E FABRIC_NONINTERACTIVE=1\u3002",
   // rc.35 TASK-12 (P0-11): --verbose 展开 maintainer 受众的 remediation。
   "cli.doctor.args.verbose.description": "\u5C55\u5F00\u5168\u90E8 action hint,\u5305\u62EC maintainer \u53D7\u4F17\u7684(Fabric \u8D21\u732E\u8005\u4FEE\u6E90\u7801\u7528)\u3002\u9ED8\u8BA4 npm \u7EC8\u7AEF\u7528\u6237\u89C6\u56FE\u4F1A\u628A\u8FD9\u4E9B\u6298\u53E0\u3002",
   "doctor.maintainer-hint-folded": "(maintainer-only remediation \u2014 \u52A0 `fabric doctor --verbose` \u67E5\u770B)",
@@ -1722,7 +1813,7 @@ var zhCNMessages = {
   "doctor.check.events_jsonl_health.message.metric_leak": ".fabric/events.jsonl \u542B {count} \u884C metric-counter \u7C7B event_type ({samples})\u3002\u8FD9\u4E9B event \u5E94\u7531 metrics.jsonl \u8BA1\u6570, \u4E0D\u518D\u8FDB\u5165 audit ledger\u3002",
   "doctor.check.events_jsonl_health.message.metrics_stale": ".fabric/metrics.jsonl \u5DF2 {minutes} \u5206\u949F\u672A\u66F4\u65B0\uFF1Bserver-side 60s flush \u53EF\u80FD stalled\u3002",
   "doctor.check.events_jsonl_health.message.rotation_overdue": ".fabric/events.jsonl \u5DF2 {days} \u5929\u672A rotate\uFF1B6h rotation tick \u53EF\u80FD\u672A\u8FD0\u884C\u3002",
-  "doctor.check.events_jsonl_health.remediation": "\u8FD0\u884C `fabric doctor --fix` \u2014\u2014 \u5B83\u4F1A\u89E6\u53D1 rotation \u5E76 flush metrics.jsonl(rc.2 F16: \u65E0\u9700\u91CD\u542F server \u5373\u53EF\u6E05\u51FA idle \u671F\u672A\u5237\u7684 metric counter)\u3002\u82E5\u544A\u8B66\u4ECD\u6301\u7EED, \u518D\u91CD\u542F MCP server \u8BA9 startMetricsFlush + startRotationTick \u91CD\u65B0\u8C03\u5EA6\u3002\u82E5 metric_leak \u547D\u4E2D, \u68C0\u67E5\u6700\u8FD1\u4EE3\u7801\u6539\u52A8\u662F\u5426\u7ED5\u8FC7 bumpCounter API \u76F4\u63A5 appendEventLedgerEvent \u5199\u4E86 4 \u4E2A metric-managed event_type \u4E4B\u4E00\u3002",
+  "doctor.check.events_jsonl_health.remediation": "\u8FD0\u884C `fabric doctor --fix` \u2014\u2014 \u4F1A\u6309 .fabric/fabric-config.json \u7684 fabric_event_retention_days(7|30|90) \u8F6E\u8F6C events.jsonl\uFF0C\u5E76 flush metrics.jsonl\u3002\u82E5\u544A\u8B66\u4ECD\u6301\u7EED\uFF0C\u518D\u91CD\u542F MCP server \u8BA9 startMetricsFlush + startRotationTick \u91CD\u65B0\u8C03\u5EA6\u3002\u82E5 metric_leak \u547D\u4E2D\uFF0C\u68C0\u67E5\u6700\u8FD1\u4EE3\u7801\u662F\u5426\u7ED5\u8FC7 bumpCounter \u76F4\u63A5\u5199\u4E86 metric-managed event_type\u3002",
   "doctor.check.event_ledger_partial_write.name": "\u4E8B\u4EF6\u8D26\u672C\u534A\u622A\u5199\u5165",
   "doctor.check.event_ledger_partial_write.ok.skipped": "\u65E0\u9700\u6267\u884C partial-write \u68C0\u67E5\uFF08ledger \u7F3A\u5931\u6216\u4E0D\u53EF\u5199\uFF09\u3002",
   "doctor.check.event_ledger_partial_write.message": "events.jsonl \u5728 byte offset {byteOffset} \u5904\u5B58\u5728 partial write\uFF08{byteLength} \u4E2A corrupted bytes\uFF09\u3002\u8FD0\u884C --fix \u622A\u65AD\u5E76\u4FDD\u7559 corrupted bytes\u3002",
@@ -1746,9 +1837,9 @@ var zhCNMessages = {
   "doctor.check.retired_reference.ok": "bootstrap\u3001SKILL.md\u3001\u5DF2\u5B89\u88C5 hooks \u4E2D\u65E0\u6B8B\u7559\u7684\u9000\u5F79\u5DE5\u5177/\u5B57\u6BB5\u540D\u3002",
   "doctor.check.retired_reference.message": "agent \u53EF\u89C1\u6587\u672C\u4E2D\u6709 {count} \u5904\u6307\u5411\u9000\u5F79\u5DE5\u5177/\u5B57\u6BB5\u540D\u7684 stale pointer: {sample}",
   "doctor.check.retired_reference.remediation": "\u628A\u547D\u4E2D\u6587\u672C\u6539\u4E3A\u66FF\u4EE3 token (\u6216\u5220\u9664), \u518D\u8DD1 `fabric install` \u91CD\u540C\u6B65 dogfood \u955C\u50CF\u3002",
-  // v2.0.0-rc.33 W3-6 (P1-13): SKILL.md token budget lint。warn > 5K / error > 10K token (chars/3 估算)。基于 Anthropic 推荐 SKILL.md 热路径 ~3K, 超过 5K 已影响 progressive disclosure;超过 10K 是阻断级 (model context 浪费 + 加载延迟)。
+  // v2.0.0-rc.33 W3-6 (P1-13): SKILL.md token budget lint。warn > 8K / error > 10K token (chars/3 估算)。Anthropic 推荐 SKILL.md 热路径 ~3K, 但被监控的两个 skill (fabric-archive/review) 是最丰富的核心 skill, 合理偏大;warn 定在 8K (距 10K 装机硬闸留 2K 反应缓冲) 而非 5K。超过 10K 是阻断级 (model context 浪费 + 加载延迟)。
   "doctor.check.skill_token_budget.name": "Skill token \u9884\u7B97",
-  "doctor.check.skill_token_budget.ok": "\u6240\u6709 .claude/skills/<slug>/SKILL.md \u5728 token budget \u5185 (warn 5K / error 10K)\u3002",
+  "doctor.check.skill_token_budget.ok": "\u6240\u6709 .claude/skills/<slug>/SKILL.md \u5728 token budget \u5185 (warn 8K / error 10K)\u3002",
   "doctor.check.skill_token_budget.message.singular": "{count} \u4E2A SKILL.md \u8D85\u51FA token budget: {list}\u3002\u5EFA\u8BAE\u628A\u8BE6\u7EC6\u5185\u5BB9\u4E0B\u6C89\u5230 ref/ progressive disclosure\u3002",
   "doctor.check.skill_token_budget.message.plural": "{count} \u4E2A SKILL.md \u8D85\u51FA token budget: {list}\u3002\u5EFA\u8BAE\u628A\u8BE6\u7EC6\u5185\u5BB9\u4E0B\u6C89\u5230 ref/ progressive disclosure\u3002",
   "doctor.check.skill_token_budget.remediation": "\u5C06\u8D85\u6807 SKILL.md \u4E2D\u7684\u8BE6\u7EC6 phase / worked-examples / decision \u8868\u79FB\u5230 `templates/skills/<slug>/ref/*.md`,SKILL.md \u70ED\u8DEF\u5F84\u53EA\u7559 trigger gate + \u5173\u952E phase \u6982\u8981;\u53C2\u8003 W1 progressive disclosure \u62C6\u5206\u6A21\u5F0F\u3002\u91CD\u65B0\u8DD1 `fabric install` \u540C\u6B65\u4E24\u7AEF\u3002",
@@ -1832,7 +1923,7 @@ var zhCNMessages = {
   "doctor.check.index_drift.ok": "agents.meta.json counters envelope \u5BF9\u6BCF\u4E2A (layer, type) pair \u90FD\u5927\u4E8E\u6216\u7B49\u4E8E\u73B0\u6709 canonical counter \u6700\u5927\u503C\u3002",
   "doctor.check.index_drift.message.singular": "{count} \u4E2A (layer, type) counter slot \u5DF2\u4F4E\u4E8E\u89C2\u6D4B\u5230\u7684 canonical maximum\uFF08next allocate would collide\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.index_drift.message.plural": "{count} \u4E2A (layer, type) counter slots \u5DF2\u4F4E\u4E8E\u89C2\u6D4B\u5230\u7684 canonical maximum\uFF08next allocate would collide\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.index_drift.remediation": "\u8FD0\u884C `fabric doctor --fix-knowledge`\u5C06 agents.meta.json counters \u63D0\u5347\u5230 max_observed + 1\u3002",
+  "doctor.check.index_drift.remediation": "\u8FD0\u884C `fabric doctor --fix` \u5C06 agents.meta.json counters \u63D0\u5347\u5230 max_observed + 1\u3002",
   "doctor.check.underseeded.name": "\u77E5\u8BC6\u79CD\u5B50\u4E0D\u8DB3",
   "doctor.check.underseeded.ok": "\u77E5\u8BC6\u5E93\u5DF2\u6709 {count} \u4E2A canonical entries\uFF08>= {threshold}\uFF09\u3002",
   "doctor.check.underseeded.message.singular": "\u77E5\u8BC6\u5E93\u4EC5\u6709 {count} \u4E2A canonical entry\uFF08< {threshold} threshold\uFF09\u3002plan_context \u68C0\u7D22\u9762\u4F4E\u4E8E\u53EF\u7528\u4E0B\u9650\u3002",
@@ -1842,7 +1933,7 @@ var zhCNMessages = {
   "doctor.check.session_hints_stale.ok": ".fabric/.cache/ \u4E0B\u6CA1\u6709\u8D85\u8FC7 {days} \u5929\u7684 session-hints cache files\u3002",
   "doctor.check.session_hints_stale.message.singular": ".fabric/.cache/ \u4E0B\u6709 {count} \u4E2A session-hints cache file \u8D85\u8FC7 {days} \u5929\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.session_hints_stale.message.plural": ".fabric/.cache/ \u4E0B\u6709 {count} \u4E2A session-hints cache files \u8D85\u8FC7 {days} \u5929\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.session_hints_stale.remediation": "\u8FD0\u884C `fabric doctor --fix-knowledge` \u5220\u9664\u8FC7\u671F\u7684 session-hints cache files\u3002",
+  "doctor.check.session_hints_stale.remediation": "\u8FD0\u884C `fabric doctor --fix` \u5220\u9664\u8FC7\u671F\u7684 session-hints cache files\u3002",
   "doctor.check.hook_cache_writable.name": "Hook \u7F13\u5B58\u53EF\u5199",
   "doctor.check.hook_cache_writable.ok": "Hook sidecar cache \u8DEF\u5F84 {path} \u53EF\u5199\u5165\u63A2\u9488\u6587\u4EF6\u3002",
   "doctor.check.hook_cache_writable.message": "Hook sidecar cache \u8DEF\u5F84 {path} \u4E0D\u53EF\u5199\uFF1Bhook state updates \u4F1A\u9759\u9ED8\u5931\u8D25\u3002\u9519\u8BEF\uFF1A{error}\u3002",
@@ -1924,6 +2015,7 @@ var zhCNMessages = {
   "doctor.check.relevance_paths_drift.message.singular": "{count} \u4E2A narrow-scope canonical entry \u7684 relevance_paths globs \u6CA1\u6709\u5339\u914D\u5230\u6700\u8FD1 {windowDays}d git history \u4E2D\u89E6\u78B0\u8FC7\u7684\u6587\u4EF6\u3002\u9996\u4E2A:{detail}\u3002",
   "doctor.check.relevance_paths_drift.message.plural": "{count} \u4E2A narrow-scope canonical entries \u7684 relevance_paths globs \u6CA1\u6709\u5339\u914D\u5230\u6700\u8FD1 {windowDays}d git history \u4E2D\u89E6\u78B0\u8FC7\u7684\u6587\u4EF6\u3002\u9996\u4E2A:{detail}\u3002",
   "doctor.check.relevance_paths_drift.remediation": "\u5BA1\u9605\u8BE5 entry \u662F\u5426\u4ECD\u7136\u76F8\u5173 \u2014 \u4F7F\u7528 `fab_review.modify` \u5237\u65B0 anchors,\u6216\u4F7F\u7528 `fab_review.reject` \u5F52\u6863\u3002",
+  "doctor.check.relevance_paths_drift.remediation_with_sample": "\u5BA1\u9605\u8BE5 entry \u662F\u5426\u4ECD\u7136\u76F8\u5173 \u2014 \u6837\u672C {sample};\u4F7F\u7528 `fab_review.modify` \u5237\u65B0 anchors,\u6216\u4F7F\u7528 `fab_review.reject` \u5F52\u6863\u3002",
   // W4-3 (KT-MOD-0001): narrow scope 但 relevance_paths 为空。
   "doctor.check.narrow_no_paths.name": "\u77E5\u8BC6 narrow scope \u7F3A\u8DEF\u5F84",
   "doctor.check.narrow_no_paths.ok": "\u6BCF\u6761 narrow scope canonical entry \u90FD\u81F3\u5C11\u5E26\u4E00\u4E2A relevance_path\u3002",
@@ -1975,6 +2067,14 @@ var zhCNMessages = {
   "doctor.check.stray_fabric_dir_detected.ok": "\u9879\u76EE\u4E0B\u672A\u53D1\u73B0\u6E38\u79BB .fabric \u76EE\u5F55,\u552F\u4E00\u6743\u5A01\u6839 .fabric \u5C31\u662F <projectRoot>/.fabric\u3002",
   "doctor.check.stray_fabric_dir_detected.message": "\u53D1\u73B0 {count} \u4E2A\u6E38\u79BB .fabric \u76EE\u5F55({dirs}),\u5B83\u4EEC\u662F\u5B50\u8FDB\u7A0B\u5728\u5B50\u76EE\u5F55\u88AB\u8BEF\u8BA4\u4F5C project root \u7684\u5386\u53F2\u9057\u7559(rc.10 \u4E4B\u524D\u7684 hook / rc.11 \u4E4B\u524D\u7684 server \u4FA7),\u4F1A\u5BFC\u81F4 events.jsonl / metrics.jsonl / .cache \u6563\u843D\u3002",
   "doctor.check.stray_fabric_dir_detected.remediation": "\u8DD1 `fabric doctor --fix` \u4F1A\u628A\u6BCF\u4E2A\u6E38\u79BB dir \u6539\u540D\u4E3A `.fabric.stale-<timestamp>`(rescue-before-delete,\u4E0D\u786C\u5220)\u3002\u6539\u540D\u540E\u53EF\u4EBA\u5DE5\u6838\u5BF9\u662F\u5426\u9700\u8981\u5408\u5E76 events \u518D\u5220\u3002\u540C\u65F6\u5347\u7EA7\u672C\u673A fabric-cli \u81F3 rc.11+ \u8BA9 server \u4FA7 git-anchor \u751F\u6548\u3002",
+  // legacy_fabric_cache_dir_detected — 老版 recall engine 把 BM25/vector 缓存
+  // 放 `.fabric/cache/{bm25,vectors}`;unify-fabric-cache-dir 后统一到
+  // `.fabric/.cache/` 与 hook sidecar 同处,一条 .gitignore 覆盖两者。老数据
+  // 完好,--fix 仅 rename 迁移。
+  "doctor.check.legacy_fabric_cache_dir_detected.name": "\u8001\u7248 .fabric/cache/ \u76EE\u5F55",
+  "doctor.check.legacy_fabric_cache_dir_detected.ok": "Recall \u7F13\u5B58\u5DF2\u5728 .fabric/.cache/ \u4E0B,\u65E0\u6B8B\u7559 .fabric/cache/{bm25,vectors}\u3002",
+  "doctor.check.legacy_fabric_cache_dir_detected.message": "\u53D1\u73B0 {count} \u4E2A\u8001\u7248 recall \u7F13\u5B58\u76EE\u5F55({dirs})\u3002\u8FD9\u4E9B\u662F unify-fabric-cache-dir \u4E4B\u524D\u7684\u4F4D\u7F6E;\u78C1\u76D8\u4E0A\u7684 BM25 \u5FEB\u7167 / \u5411\u91CF embedding \u6570\u636E\u5B8C\u597D,rename \u5373\u53EF\u4FDD\u7559\u3002",
+  "doctor.check.legacy_fabric_cache_dir_detected.remediation": "\u8DD1 `fabric doctor --fix` \u628A\u6BCF\u4E2A\u8001\u76EE\u5F55 rename \u5230 `.fabric/.cache/` \u5BF9\u5E94\u4F4D\u7F6E(\u5E42\u7B49;\u82E5\u65B0\u8DEF\u5F84\u5DF2\u6709\u66F4\u65B0\u6570\u636E\u5219\u8DF3\u8FC7)\u3002\u4E0D\u6D89\u53CA\u91CD\u65B0 embed,\u5FEB\u7167\u6587\u4EF6\u539F\u6837\u8FC1\u79FB\u3002",
   "doctor.check.skill_md_yaml_invalid.name": "Skill markdown YAML",
   "doctor.check.skill_md_yaml_invalid.ok": "\u6240\u6709 .claude/.codex SKILL.md frontmatter values \u90FD\u80FD\u6309 strict YAML \u89E3\u6790\u3002",
   "doctor.check.skill_md_yaml_invalid.message.singular": "{count} \u4E2A SKILL.md frontmatter value \u5305\u542B\u672A\u52A0\u5F15\u53F7\u7684 ': '\uFF0Cstrict YAML parsers \u4F1A\u62D2\u7EDD\uFF08Claude Code tolerates it\uFF1BCodex CLI drops the skill at load\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
@@ -2109,6 +2209,7 @@ var zhCNMessages = {
   // flat-design (G6): 装完最该做的事是重启客户端让 MCP 生效 —— 这才是默认锚点动作;
   // --reapply 维护提示退到 --verbose。
   "cli.install.next-step.restart": "\u91CD\u542F\u5DF2\u5F00\u7684 Claude Code / Codex \u4F1A\u8BDD\u4EE5\u52A0\u8F7D Fabric(\u65B0\u4F1A\u8BDD\u81EA\u52A8\u751F\u6548)\u3002",
+  "cli.install.next-step.nudge-mode": '\u4EBA\u53EF\u89C1\u63D0\u793A\u9ED8\u8BA4 minimal\uFF08\u6BCF\u4F1A\u8BDD\u4E00\u6761\u72B6\u6001\uFF09\u3002\u53EF\u5728 .fabric/fabric-config.json \u8BBE nudge_mode: "silent" \u9759\u97F3\uFF0C\u6216 FABRIC_NUDGE_MODE=silent\uFF1B\u8981\u66F4\u5435\u7528 normal/verbose\u3002',
   "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)",
@@ -2164,7 +2265,7 @@ var zhCNMessages = {
   "cli.install.semantic.installing": "\u6B63\u5728\u8FD0\u884C `npm i -g fastembed` \u2026",
   "cli.install.semantic.installed": "fastembed \u5B89\u88C5\u5B8C\u6210\u3002\u5D4C\u5165\u6A21\u578B\u4F1A\u5728\u9996\u6B21\u53EC\u56DE (recall) \u65F6\u81EA\u52A8\u4E0B\u8F7D\uFF08\u7EA6\u6570\u5341\u2013\u6570\u767E MB\uFF1B\u4E0D\u4E0A\u4F20\u4EFB\u4F55 KB \u6570\u636E\uFF09\u3002",
   "cli.install.semantic.install-failed": "\u81EA\u52A8\u5B89\u88C5\u5931\u8D25\uFF08{reason}\uFF09\u3002\u8BF7\u624B\u52A8\u6267\u884C\u4E0B\u9762\u7684\u6B65\u9AA4\uFF1A",
-  "cli.install.semantic.manual-steps": "  1. \u5B89\u88C5\u53EF\u9009 embedder (\u5411\u91CF\u7F16\u7801\u5668\uFF0C\u88C5\u5230 MCP server \u89E3\u6790\u6A21\u5757\u7684\u4F4D\u7F6E \u2014 \u5168\u5C40\u5B89\u88C5\u5373\u5168\u5C40):\n       npm i -g fastembed\n  2. \u9884\u70ED\u6A21\u578B\u7F13\u5B58 (\u9996\u8DD1\u4F1A\u8054\u7F51\u4E0B\u8F7D\u6A21\u578B\u6743\u91CD ~\u6570\u5341-\u6570\u767E MB, \u4E0D\u4E0A\u4F20\u4EFB\u4F55 KB \u6570\u636E):\n       export FABRIC_EMBED_CACHE_DIR=~/.cache/fabric-embed   # \u4E25\u683C\u79BB\u7EBF\u8005\u9884\u5148\u653E\u597D\u6743\u91CD\n  \u6CE8: \u5207\u6362 embed_model \u540E\u5DF2\u6709\u5411\u91CF\u7EF4\u5EA6/\u8BED\u4E49\u53D8\u5316, \u4E0B\u6B21 recall \u4F1A\u6309\u65B0\u6A21\u578B\u91CD\u65B0\u5D4C\u5165 (doc \u5411\u91CF\u6309\u6587\u672C\u7F13\u5B58, \u81EA\u52A8\u5931\u914D\u91CD\u7B97)\u3002\n  \u5173\u95ED: \u7F16\u8F91 fabric.config.json \u8BBE embed_enabled=false\u3002",
+  "cli.install.semantic.manual-steps": "  1. \u5B89\u88C5\u53EF\u9009 embedder (\u5411\u91CF\u7F16\u7801\u5668\uFF0C\u88C5\u5230 MCP server \u89E3\u6790\u6A21\u5757\u7684\u4F4D\u7F6E \u2014 \u5168\u5C40\u5B89\u88C5\u5373\u5168\u5C40):\n       npm i -g fastembed\n  2. \u9884\u70ED\u6A21\u578B\u7F13\u5B58 (\u9996\u8DD1\u4F1A\u8054\u7F51\u4E0B\u8F7D\u6A21\u578B\u6743\u91CD ~\u6570\u5341-\u6570\u767E MB, \u4E0D\u4E0A\u4F20\u4EFB\u4F55 KB \u6570\u636E):\n       export FABRIC_EMBED_CACHE_DIR=~/.cache/fabric-embed   # \u4E25\u683C\u79BB\u7EBF\u8005\u9884\u5148\u653E\u597D\u6743\u91CD\n  \u6CE8: \u5207\u6362 embed_model \u540E\u5DF2\u6709\u5411\u91CF\u7EF4\u5EA6/\u8BED\u4E49\u53D8\u5316, \u4E0B\u6B21 recall \u4F1A\u6309\u65B0\u6A21\u578B\u91CD\u65B0\u5D4C\u5165 (doc \u5411\u91CF\u6309\u6587\u672C\u7F13\u5B58, \u81EA\u52A8\u5931\u914D\u91CD\u7B97)\u3002\n  \u5173\u95ED: \u7F16\u8F91 .fabric/fabric-config.json \u8BBE embed_enabled=false\u3002",
   // C5: store onboarding 交互文案统一走 t()。
   "cli.install.store.local-store": "\u672C\u5730 store",
   "cli.install.store.bind-mounted.prompt": "\u628A\u4E00\u4E2A\u5DF2\u6302\u8F7D\u7684\u77E5\u8BC6 store \u7ED1\u5B9A\u5230\u672C\u9879\u76EE\uFF1F",
@@ -2330,6 +2431,23 @@ var zhCNMessages = {
   // per [[fabric-serve-quarantine-not-delete]]. Restore from git history when
   // the web UI surface is re-enabled.
   // v2.0.0-rc.29 TASK-008 (BUG-L2): onboard-coverage 国际化键。
+  "cli.first-hit.description": "\u9A8C\u6536 install\u2192first-hit \u5C31\u7EEA\uFF08bind + \u975E\u7A7A\u77E5\u8BC6\u9762\uFF09",
+  "cli.first-hit.args.json.description": "\u673A\u5668\u53EF\u8BFB JSON \u62A5\u544A",
+  "cli.first-hit.args.target.description": "\u9879\u76EE\u6839\uFF08\u9ED8\u8BA4 cwd\uFF09",
+  "cli.first-hit.args.seed.description": "\u82E5 store \u4E3A\u7A7A\u5219\u5199\u5165\u6700\u5C0F starter \u77E5\u8BC6\u6761\u76EE",
+  "cli.first-hit.args.paths.description": "\u9017\u53F7\u5206\u9694\u7684\u63A2\u6D4B\u8DEF\u5F84",
+  "cli.first-hit.msg.ok": "first-hit \u5C31\u7EEA\uFF1A{stores} \u4E2A store \u5171 {total} \u6761\u77E5\u8BC6\uFF1Bhooks \u5DF2\u5B89\u88C5\u3002",
+  "cli.first-hit.msg.unbound": "unbound\uFF1A\u672C\u9879\u76EE read-set \u672A\u7ED1\u5B9A\u4EFB\u4F55 store\uFF0C\u77E5\u8BC6\u65E0\u6CD5\u6D6E\u73B0\u3002",
+  "cli.first-hit.msg.no_write_target": "no_write_target\uFF1A\u5DF2\u6709 required stores \u4F46\u672A\u8BBE\u7F6E active_write_store\u3002",
+  "cli.first-hit.msg.empty_store": "empty_store\uFF1Astore \u5DF2\u7ED1\u5B9A\u4F46\u89C4\u8303\u77E5\u8BC6\u6587\u4EF6\u4E3A 0 \u2014 \u7A7A store \u4E0D\u662F\u6210\u529F\u8DEF\u5F84\u3002",
+  "cli.first-hit.msg.missing_required": "missing_required\uFF1Arequired_stores \u4E2D\u6709\u672A\u6302\u8F7D\u7684 store\u3002",
+  "cli.first-hit.msg.write_target_mismatch": "write_target_mismatch\uFF1Aactive_write_store \u4E0D\u5728\u5DF2\u6302\u8F7D\u53EF\u5199 read-set \u4E0A\u3002",
+  "cli.first-hit.msg.store_unreachable": "store_unreachable\uFF1A\u5DF2\u7ED1\u5B9A store \u5728\u6CE8\u518C\u8868\u4E2D\u4F46\u78C1\u76D8\u76EE\u5F55\u7F3A\u5931\u3002",
+  "cli.first-hit.msg.project_unsealed": "project_unsealed\uFF1A\u5DF2\u7ED1\u5B9A\u5199\u5E93\u4F46\u7F3A\u5C11 project_id/active_project \u2014 \u56E2\u961F\u77E5\u8BC6\u4F1A\u843D\u6210 flat\uFF08semantic_scope: team\uFF09\u800C\u975E\u9879\u76EE\u5206\u533A\u3002",
+  "cli.first-hit.msg.no_match": "no_match\uFF1A\u77E5\u8BC6\u5B58\u5728\u4F46\u63A2\u6D4B\u9762\u4E3A\u7A7A\uFF08\u8DEF\u5F84/scope \u8FC7\u6EE4\uFF09\u3002",
+  "cli.first-hit.msg.hooks_missing": "hooks_missing\uFF1A\u77E5\u8BC6\u5DF2\u5728\u4F46 SessionStart/PreToolUse hooks \u672A\u5B89\u88C5\u3002",
+  "cli.first-hit.msg.no_project": "no_project\uFF1A\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Fabric \u9879\u76EE\uFF08\u7F3A\u5C11 .fabric/fabric-config.json\uFF09\u3002",
+  "cli.first-hit.msg.no_global": "no_global\uFF1A\u7F3A\u5C11\u5168\u5C40 fabric \u914D\u7F6E \u2014 \u8BF7\u5148\u8FD0\u884C fabric install --global\u3002",
   "cli.onboard-coverage.description": "\u6C47\u603B\u5F53\u524D\u5DE5\u4F5C\u533A\u7684 S5 onboard-slot \u8986\u76D6\u5EA6\u3002fabric-archive Skill \u9996\u8DD1\u9636\u6BB5\u7528\u5B83\u5224\u65AD\u54EA\u4E9B\u9879\u76EE\u8BED\u8C03\u69FD\u4F4D\u5C1A\u672A\u88AB\u8BA4\u9886\u3002",
   "cli.onboard-coverage.args.json.description": "\u8F93\u51FA\u673A\u5668\u53EF\u8BFB\u7684 JSON \u5230 stdout\uFF08\u66FF\u4EE3\u4EBA\u7C7B\u53EF\u8BFB\u7684\u8868\u683C\uFF09\u3002",
   "cli.onboard-coverage.args.target.description": "\u8986\u76D6\u9879\u76EE\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF09\u3002",
@@ -2579,6 +2697,10 @@ var zhCNMessages = {
   "cli.info.recall.vector.not-ready": "\u672A\u5C31\u7EEA \u2014\u2014 \u53EC\u56DE\u56DE\u9000\u5230\u5173\u952E\u8BCD\u6A21\u5F0F(BM25 / additive)",
   "cli.info.recall.warm.ok": "embedder \u5DF2\u9884\u70ED:\u6A21\u578B '{model}' \u5DF2\u52A0\u8F7D(\u5411\u91CF\u7EF4\u5EA6 {dim}),\u7F13\u5B58\u4E8E {dir}",
   "cli.info.recall.warm.fail": "embedder \u4E0D\u53EF\u7528 \u2014\u2014 \u53EF\u9009\u7684 'fastembed' \u5305\u65E0\u6CD5\u89E3\u6790,\u6216\u6A21\u578B\u52A0\u8F7D\u5931\u8D25\u3002\n  \u53EC\u56DE\u56DE\u9000\u5230\u5173\u952E\u8BCD\u6A21\u5F0F(BM25 / additive)\u3002\u8BF7\u5728 server \u80FD\u89E3\u6790\u6A21\u5757\u7684\u4F4D\u7F6E\u5B89\u88C5 fastembed \u540E\u91CD\u8BD5\u3002",
+  "cli.store.mount.description": "\u5C06\u77E5\u8BC6 store \u6302\u8F7D\u5230\u5168\u5C40\u6CE8\u518C\u8868",
+  "cli.store.create.description": "\u521B\u5EFA\u5E76\u6302\u8F7D\u672C\u5730\u77E5\u8BC6 store",
+  "cli.store.remove.description": "\u4ECE\u6CE8\u518C\u8868\u5378\u4E0B store\uFF08\u4E0D\u5220\u9664\u78C1\u76D8\uFF09",
+  "cli.store.explain.description": "\u89E3\u91CA store \u522B\u540D\u5982\u4F55\u89E3\u6790",
   "cli.store.list.description": "\u5217\u51FA\u6302\u8F7D\u7684 store",
   // 追加在 `fabric store --help` 末尾的说明 —— 交代进阶(meta.hidden)操作去哪了,
   // 否则只剩 list 一行会让用户以为 store 没别的能力。

package/dist/i18n/index.js

@@ -5,12 +5,13 @@ import {
   enMessages,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-YLIWE46B.js";
+} from "../chunk-WXVFJBL5.js";
 import {
   detectNodeLocale,
   normalizeLocale,
   resolveGlobalLocale
-} from "../chunk-ASS2KBB7.js";
+} from "../chunk-OX6DWUK4.js";
+import "../chunk-C7WZPYZE.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-B2e0wKJi.d.ts → index-KvxqMZV1.d.ts}

@@ -480,6 +480,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance", "narrow", "cite-evict"]>, "many">>;
     cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    altitude_propose_gate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     hint_narrow_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_narrow_dedup_window_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_broad_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -524,6 +525,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     broad_index_backstop: number;
     cite_policy_enabled: boolean;
     self_archive_policy_enabled: boolean;
+    altitude_propose_gate: boolean;
     hint_narrow_top_k: number;
     hint_narrow_dedup_window_turns: number;
     hint_broad_cooldown_hours: number;
@@ -632,6 +634,7 @@ declare const fabricConfigSchema: z.ZodObject<{
     hint_dismiss_signals?: ("narrow" | "archive" | "review" | "import" | "maintenance" | "cite-evict")[] | undefined;
     cite_policy_enabled?: boolean | undefined;
     self_archive_policy_enabled?: boolean | undefined;
+    altitude_propose_gate?: boolean | undefined;
     hint_narrow_top_k?: number | undefined;
     hint_narrow_dedup_window_turns?: number | undefined;
     hint_broad_cooldown_hours?: number | undefined;
@@ -733,6 +736,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance", "narrow", "cite-evict"]>, "many">>;
     cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    altitude_propose_gate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     hint_narrow_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_narrow_dedup_window_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_broad_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -788,6 +792,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     broad_index_backstop: number;
     cite_policy_enabled: boolean;
     self_archive_policy_enabled: boolean;
+    altitude_propose_gate: boolean;
     hint_narrow_top_k: number;
     hint_narrow_dedup_window_turns: number;
     hint_broad_cooldown_hours: number;
@@ -896,6 +901,7 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     hint_dismiss_signals?: ("narrow" | "archive" | "review" | "import" | "maintenance" | "cite-evict")[] | undefined;
     cite_policy_enabled?: boolean | undefined;
     self_archive_policy_enabled?: boolean | undefined;
+    altitude_propose_gate?: boolean | undefined;
     hint_narrow_top_k?: number | undefined;
     hint_narrow_dedup_window_turns?: number | undefined;
     hint_broad_cooldown_hours?: number | undefined;