@fenglimg/fabric-shared 2.0.0-rc.30 → 2.0.0-rc.33

package/dist/{chunk-225L7D4T.js → chunk-Z7UPW75I.js}

@@ -181,7 +181,9 @@ var enMessages = {
   // four description-grade frontmatter fields on canonical knowledge entries.
   "cli.doctor.args.enrich-descriptions.description": "Back-fill missing intent_clues / tech_stack / impact / must_read_if on canonical knowledge entries (read-only by default; pair with --auto to write stubs).",
   "cli.doctor.args.auto.description": "With --enrich-descriptions: write deterministic stub values for missing fields. Without --auto, the run is read-only.",
-  "cli.doctor.args.dry-run.description": "With --enrich-descriptions --auto: preview the would-be changes without writing to disk.",
+  "cli.doctor.args.dry-run.description": "With --enrich-descriptions --auto or --fix: preview the planned changes without writing to disk. The fix-dry-run output mirrors --fix's fixable_errors list but executes no mutations.",
+  // v2.0.0-rc.33 W4-B1 (T6 P2): --fix --dry-run banner — printed before the standard report so users see no mutations were applied.
+  "cli.doctor.fix-dry-run-banner": "[dry-run] No mutations were applied. The fixable_errors list below shows what `fab doctor --fix` would address; rerun without --dry-run to actually fix.",
   "cli.doctor.errors.enrich-descriptions-mutex": "--enrich-descriptions cannot be combined with --fix, --fix-knowledge, or --cite-coverage. Run them separately.",
   "doctor.enrich.allComplete": "All canonical knowledge entries already declare intent_clues / tech_stack / impact / must_read_if.",
   // rc.26 TASK-02a: doctor foundation-batch check messages.
@@ -203,13 +205,14 @@ var enMessages = {
   "doctor.check.managed_block_drift.ok.no_managed_block": "No three-end managed blocks detected \u2014 propagation pending or legacy-marker state.",
   "doctor.check.bootstrap_anchor.name": "Bootstrap anchor",
   "doctor.check.bootstrap_anchor.message.missing": "Neither AGENTS.md nor CLAUDE.md exists at the repo root. Fabric requires a bootstrap anchor file at the project root.",
-  "doctor.check.bootstrap_anchor.remediation.missing": "Run `fabric install` to generate the AGENTS.md / CLAUDE.md bootstrap anchor at the repo root.",
+  "doctor.check.bootstrap_anchor.remediation.missing": "Run `fab install` to generate the AGENTS.md / CLAUDE.md bootstrap anchor at the repo root.",
   "doctor.check.bootstrap_anchor.ok": "Bootstrap anchor present at repo root: {present}.",
   "doctor.check.baseline_filename_format.name": "Baseline filename format",
   "doctor.check.baseline_filename_format.ok": "All baseline knowledge files use the canonical `${id}--${slug}.md` filename format.",
   "doctor.check.baseline_filename_format.message.singular": "{count} baseline knowledge file uses the deprecated bare-slug filename format and must be migrated to `${id}--${slug}.md`. First: {detail}.",
   "doctor.check.baseline_filename_format.message.plural": "{count} baseline knowledge files use the deprecated bare-slug filename format and must be migrated to `${id}--${slug}.md`. First: {detail}.",
-  "doctor.check.baseline_filename_format.remediation": "Delete the legacy bare-slug baseline file(s) manually \u2014 the baseline pipeline was removed in rc.23 and is no longer an auto-fix path.",
+  // v2.0.0-rc.33 W3-2 (T6 #5): reference the file names from the message so users can copy-paste rm targets rather than grep for them.
+  "doctor.check.baseline_filename_format.remediation": "Manually rm the bare-slug baseline file(s) listed in the message (e.g. `rm <file from message>`). The baseline pipeline was removed in rc.23 and is no longer an auto-fix path.",
   "doctor.check.knowledge_dir_missing.name": "Knowledge layout",
   "doctor.check.knowledge_dir_missing.message.singular": "{count} required knowledge subdir is missing: {list}.",
   "doctor.check.knowledge_dir_missing.message.plural": "{count} required knowledge subdirs are missing: {list}.",
@@ -226,7 +229,7 @@ var enMessages = {
   "doctor.check.agents_meta.message.missing": ".fabric/agents.meta.json is missing.",
   "doctor.check.agents_meta.remediation.missing": "Run `fab doctor --fix` to rebuild agents.meta.json from .fabric/knowledge/.",
   "doctor.check.agents_meta.message.invalid-default": ".fabric/agents.meta.json is invalid.",
-  "doctor.check.agents_meta.remediation.invalid": "Delete .fabric/agents.meta.json and run `fab doctor --fix` to regenerate it.",
+  "doctor.check.agents_meta.remediation.invalid": "Run `fab doctor --fix` to let reconcile rebuild agents.meta.json from the .fabric/knowledge/ disk ground-truth (rc.31+ auto-migrates legacy singular knowledge_type values to canonical plural; do NOT manually delete agents.meta.json \u2014 you would lose counters envelope and promote-ledger associations).",
   "doctor.check.agents_meta.message.stale": ".fabric/agents.meta.json revision {revision} does not match .fabric/knowledge derived revision {computedRevision}.",
   "doctor.check.agents_meta.remediation.stale": "Benign \u2014 engine auto-heals on next plan-context/get-sections call. Run `fab doctor --fix` for explicit reconciliation.",
   "doctor.check.agents_meta.ok": ".fabric/agents.meta.json revision {revision} is aligned with .fabric/knowledge.",
@@ -235,7 +238,8 @@ var enMessages = {
   "doctor.check.rule_content_refs.remediation.unavailable": "Fix agents.meta.json first: run `fab doctor --fix`.",
   "doctor.check.rule_content_refs.message.outside.singular": "{count} content_ref entry is outside .fabric/knowledge.",
   "doctor.check.rule_content_refs.message.outside.plural": "{count} content_ref entries are outside .fabric/knowledge.",
-  "doctor.check.rule_content_refs.remediation.outside": "Edit agents.meta.json to ensure all content_ref values point inside .fabric/knowledge/{type}/ (team) or ~/.fabric/knowledge/{type}/ (personal).",
+  // v2.0.0-rc.33 W3-2 (T6 #12): project rules forbid hand-editing agents.meta.json (see .fabric/AGENTS.md). Direct users through doctor --fix reconcile path instead.
+  "doctor.check.rule_content_refs.remediation.outside": "Run `fab doctor --fix` to let reconcile auto-prune external content_refs (rc.31+ compatible). Do NOT hand-edit agents.meta.json \u2014 the engine reconciles automatically.",
   "doctor.check.rule_content_refs.message.missing.singular": "{count} content_ref target is missing. Run `fab doctor --fix` to reconcile.",
   "doctor.check.rule_content_refs.message.missing.plural": "{count} content_ref targets are missing. Run `fab doctor --fix` to reconcile.",
   "doctor.check.rule_content_refs.remediation.missing": "Run `fab doctor --fix` to reconcile agents.meta.json with the files present in .fabric/knowledge/.",
@@ -255,7 +259,8 @@ var enMessages = {
   "doctor.check.event_ledger.message.not_writable-default": ".fabric/events.jsonl is not writable.",
   "doctor.check.event_ledger.remediation.not_writable": "Check file permissions on .fabric/events.jsonl and ensure no other process holds a write lock.",
   "doctor.check.event_ledger.message.invalid-default": ".fabric/events.jsonl is invalid.",
-  "doctor.check.event_ledger.remediation.invalid": "Delete .fabric/events.jsonl and run `fab doctor --fix` to recreate it.",
+  // v2.0.0-rc.33 W3-1 (P0-6): archive-history mode — direct users to mv the broken ledger into events.archive/ before recreating, preserving history rather than rm'ing it. Mirrors rotateEventLedgerIfNeeded's events-rotated-YYYY-MM-DD.jsonl naming convention (events-corrupted-YYYY-MM-DD.jsonl distinguishes this archive cause from sliding-window rotation).
+  "doctor.check.event_ledger.remediation.invalid": "Archive history first (`mkdir -p .fabric/events.archive && mv .fabric/events.jsonl .fabric/events.archive/events-corrupted-$(date +%Y-%m-%d).jsonl`), then run `fab doctor --fix` to create a new empty ledger. Historical events are preserved under events.archive/.",
   "doctor.check.event_ledger.ok": ".fabric/events.jsonl exists, is writable, and is parseable.",
   "doctor.check.mcp_config_in_wrong_file.name": "Claude MCP config location",
   "doctor.check.mcp_config_in_wrong_file.message": ".claude/settings.json contains mcpServers.fabric \u2014 this file is for hooks/permissions only. Run --fix to remove it, then re-run fab install to write .mcp.json.",
@@ -272,12 +277,36 @@ var enMessages = {
   "doctor.check.event_ledger_schema_compat.ok.clean": "events.jsonl rows all parse against the current schema.",
   "doctor.check.event_ledger_schema_compat.message.schema_version": "events.jsonl has {count} row(s) with unsupported `schema_version` (samples: {samples}).",
   "doctor.check.event_ledger_schema_compat.message.event_type": "events.jsonl has {count} row(s) with unknown `event_type` (samples: {samples}).",
-  "doctor.check.event_ledger_schema_compat.remediation": "Either upgrade the fab CLI to a server-compatible version, or archive `.fabric/events.jsonl` and run `fab doctor --fix` to recreate a fresh ledger.",
+  // v2.0.0-rc.33 W3-1 (P0-6): archive-history mode — same as event_ledger.invalid above. Explicit "archive" wording (rather than "back up") makes it clear the old ledger is preserved under events.archive/, not discarded.
+  "doctor.check.event_ledger_schema_compat.remediation": "Preferred: upgrade the fab CLI to a server-compatible version. Otherwise archive history first (`mkdir -p .fabric/events.archive && mv .fabric/events.jsonl .fabric/events.archive/events-schema-mismatch-$(date +%Y-%m-%d).jsonl`), then run `fab doctor --fix` to create a new empty ledger. Historical events stay under events.archive/ for later manual migration.",
   // v2.0.0-rc.28 TASK-04 (audit §3.1): SKILL ref/ mirror parity check.
   "doctor.check.skill_ref_mirror.name": "Skill ref mirror parity",
   "doctor.check.skill_ref_mirror.ok": "All `.claude/skills/<slug>/ref/` and `.codex/skills/<slug>/ref/` files are byte-identical.",
   "doctor.check.skill_ref_mirror.message": "{count} skill ref file(s) differ between `.claude/skills/` and `.codex/skills/` (paths: {list}). One client was hand-edited or partially installed.",
   "doctor.check.skill_ref_mirror.remediation": "Run `fab install` to rewrite both client subtrees from the canonical templates and restore parity.",
+  // 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).
+  "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.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 `fab install` to sync both client subtrees.",
+  // v2.0.0-rc.33 W3-7 (P1-14): SKILL.md description structural lint. Proxy for trigger-recall (a live-LLM recall test requires a model — W1 ran gemini for that). This lint catches regression: missing description / >60 tokens / no Chinese trigger / no English trigger.
+  "doctor.check.skill_description.name": "Skill description quality",
+  "doctor.check.skill_description.ok": "All SKILL.md description fields are well-structured (non-empty, <60 tokens, bilingual triggers).",
+  "doctor.check.skill_description.message.singular": "{count} SKILL.md description structural issue: {list}. The description field is the host's primary auto-invoke matching signal.",
+  "doctor.check.skill_description.message.plural": "{count} SKILL.md description structural issues: {list}. The description field is the host's primary auto-invoke matching signal.",
+  "doctor.check.skill_description.remediation": "Edit the `description:` field in `packages/cli/templates/skills/<slug>/SKILL.md` frontmatter: (1) non-empty; (2) <60 tokens (chars/3 estimate, ~180 chars); (3) at least one Chinese trigger phrase; (4) at least one English trigger phrase. See W1 description rewrite style. Re-run `fab install` to sync both client subtrees. For recall verification, run the W1 gemini delegate (see .workflow/.scratchpad/rc33-plan/W1-VERIFY-RESULT.md).",
+  // v2.0.0-rc.33 W3-3 (P1-3): cite-policy Goodhart pattern detection. Scans 7d of assistant_turn_observed events for 4 anti-patterns (G1 ritual / G2 dismissal abuse / G3 chained-from misuse / G5 placeholder cite). Warning severity — heuristics can false-positive; advisory only.
+  "doctor.check.cite_goodhart.name": "Cite-policy Goodhart",
+  "doctor.check.cite_goodhart.ok": "No cite-policy Goodhart patterns detected over the last 7 days.",
+  "doctor.check.cite_goodhart.message.singular": "Detected {count} cite-policy Goodhart pattern: {list}.",
+  "doctor.check.cite_goodhart.message.plural": "Detected {count} cite-policy Goodhart patterns: {list}.",
+  "doctor.check.cite_goodhart.remediation": "Review the fired patterns: G1 ritual \u2192 the same id repeated as [recalled] suggests the KB should land into a contract instead; G2 dismissal abuse \u2192 > 60% of recalled cites used skip: bypasses contract enforcement, audit skip-reason validity; G3 chained-from misuse \u2192 chained-from tag with no commitment (operators=[] + skip_reason=null), add operators or use a different tag; G5 placeholder cite \u2192 too many bare 'KB: none' / [unspecified], prefer specific sentinels like [no-relevant] / [not-applicable]. For raw data, run `fab doctor --cite-coverage --since=7d`.",
+  // v2.0.0-rc.33 W4-A4 (T5 P2): draft-backlog lint. rc.32 baseline showed 92% of entries stuck at draft, signaling a broken promote loop. Warns when > 50% draft (workspace must have >= 10 entries to compute the ratio — small corpora are noisy).
+  "doctor.check.draft_backlog.name": "Knowledge draft backlog",
+  "doctor.check.draft_backlog.ok": "draft-maturity entry ratio is healthy (< 50%, or workspace too small to compute).",
+  "doctor.check.draft_backlog.message": "{draftCount}/{totalCount} ({pct}%) canonical knowledge entries are stuck at draft maturity \u2014 promote loop is broken (rc.32 baseline was 92%).",
+  "doctor.check.draft_backlog.remediation": "Run `/fabric-review` to triage drafts: approve to promote to verified/proven, reject to drop, modify to fix. A long-standing draft backlog usually means archive produces drafts faster than review can promote them.",
   "doctor.check.meta_manually_diverged.name": "Meta manual divergence",
   "doctor.check.meta_manually_diverged.ok.unreadable": "agents.meta.json not readable; skipping divergence check.",
   "doctor.check.meta_manually_diverged.message.extra.singular": "agents.meta.json has {count} entry with no backing file on disk. Run --fix to reconcile.",
@@ -295,7 +324,8 @@ var enMessages = {
   "doctor.check.stable_id_collision.name": "Stable ID collision",
   "doctor.check.stable_id_collision.message.singular": 'stable_id "{stableId}" is declared in {fileCount} files: {files}. Edit one of the knowledge files to use a unique stable_id.',
   "doctor.check.stable_id_collision.message.plural": '{count} stable_id collisions detected. First: "{stableId}" in {files}. Edit one of the knowledge files to use a unique stable_id.',
-  "doctor.check.stable_id_collision.remediation": "Edit one of the colliding knowledge files to declare a different `id: K[PT]-XXX-NNNN` frontmatter value.",
+  // v2.0.0-rc.33 W3-2 (T6 #27): route through fabric-review modify so the canonical id allocator picks a fresh id (avoids hand-counter math).
+  "doctor.check.stable_id_collision.remediation": "Run `/fabric-review modify <one of the colliding ids from the message>` to let the canonical id allocator reassign it (updates frontmatter + counters + historical cross-refs atomically). Do NOT hand-edit id frontmatter \u2014 it will desync counters.",
   "doctor.check.stable_id_collision.ok": "No declared stable_id collisions found in .fabric/knowledge/.",
   "doctor.check.counter_desync.name": "Knowledge counter desync",
   "doctor.check.counter_desync.message.singular": "{count} knowledge counter desynced from observed stable_ids. {counterPath} = {current} but observed {observedId}. Run `fab doctor --fix` to bump counters.",
@@ -315,12 +345,12 @@ var enMessages = {
   "doctor.check.orphan_demote.ok": "No canonical knowledge entries exceed their maturity-keyed inactivity threshold.",
   "doctor.check.orphan_demote.message.singular": "{count} canonical knowledge entry exceeds their maturity-keyed inactivity threshold (stable={stableDays}d / endorsed={endorsedDays}d / draft={draftDays}d). First: {detail}.",
   "doctor.check.orphan_demote.message.plural": "{count} canonical knowledge entries exceed their maturity-keyed inactivity threshold (stable={stableDays}d / endorsed={endorsedDays}d / draft={draftDays}d). First: {detail}.",
-  "doctor.check.orphan_demote.remediation": "Run `fab doctor --apply-lint` (rc.4 TASK-003) to demote orphan entries one maturity tier.",
+  "doctor.check.orphan_demote.remediation": "Run `fab doctor --fix-knowledge` to demote orphan entries one maturity tier.",
   "doctor.check.stale_archive.name": "Knowledge stale archive",
   "doctor.check.stale_archive.ok": "No draft knowledge entries exceed the additional stale-archive quiet window.",
   "doctor.check.stale_archive.message.singular": "{count} draft knowledge entry is stale beyond the demote+{additionalDays}d additional quiet window. First: {detail}.",
   "doctor.check.stale_archive.message.plural": "{count} draft knowledge entries are stale beyond the demote+{additionalDays}d additional quiet window. First: {detail}.",
-  "doctor.check.stale_archive.remediation": "Run `fab doctor --apply-lint` (rc.4 TASK-003) to move stale entries into `.fabric/.archive/<type>/`.",
+  "doctor.check.stale_archive.remediation": "Run `fab doctor --fix-knowledge` to move stale entries into `.fabric/.archive/<type>/`.",
   "doctor.check.pending_overdue.name": "Knowledge pending overdue",
   "doctor.check.pending_overdue.ok": "No pending knowledge entries exceed the 14-day review threshold.",
   "doctor.check.pending_overdue.message.singular": "{count} pending knowledge entry has been awaiting review for more than {thresholdDays} days. First: {detail}.",
@@ -330,17 +360,19 @@ var enMessages = {
   "doctor.check.stable_id_duplicate.ok": "No canonical knowledge files share a stable_id across team / personal trees.",
   "doctor.check.stable_id_duplicate.message.singular": "{count} stable_id duplicated across canonical knowledge files (path-decoupled identity invariant). First: {detail}.",
   "doctor.check.stable_id_duplicate.message.plural": "{count} stable_ids duplicated across canonical knowledge files (path-decoupled identity invariant). First: {detail}.",
-  "doctor.check.stable_id_duplicate.remediation": "Manually rename one of the colliding files to a fresh `<prefix>-<type>-<counter>--<slug>.md` allocated via the canonical id allocator; do not edit by hand.",
+  // v2.0.0-rc.33 W3-2 (T6 #34): same as stable_id_collision — route through fabric-review modify so allocator handles the new id.
+  "doctor.check.stable_id_duplicate.remediation": "Run `/fabric-review modify <one of the duplicate ids from the message>` to let the canonical id allocator assign a fresh `<prefix>-<type>-<counter>--<slug>.md` (renames the file + updates frontmatter + corrects counters in one shot).",
   "doctor.check.layer_mismatch.name": "Knowledge layer mismatch",
   "doctor.check.layer_mismatch.ok": "All canonical knowledge files are physically located under the layer their stable_id prefix declares.",
   "doctor.check.layer_mismatch.message.singular": "{count} canonical knowledge file are physically misaligned with their stable_id layer prefix (KT-* must live under team/, KP-* under personal/). First: {detail}.",
   "doctor.check.layer_mismatch.message.plural": "{count} canonical knowledge files are physically misaligned with their stable_id layer prefix (KT-* must live under team/, KP-* under personal/). First: {detail}.",
-  "doctor.check.layer_mismatch.remediation": "Move the file to the correct layer root, or use the fabric-review modify flow to flip its layer (which renames the stable_id prefix accordingly).",
+  // v2.0.0-rc.33 W3-2 (T6 #35): make the skill entry point explicit so users know how to invoke fabric-review.
+  "doctor.check.layer_mismatch.remediation": "Move the file to the correct layer root (KT-* \u2192 .fabric/knowledge/team/, KP-* \u2192 ~/.fabric/knowledge/personal/), or run `/fabric-review modify <id from the message>` to flip its layer (which renames the stable_id prefix accordingly).",
   "doctor.check.index_drift.name": "Knowledge index drift",
   "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 `fab doctor --apply-lint` (rc.4 TASK-003) to bump agents.meta.json counters to max_observed + 1.",
+  "doctor.check.index_drift.remediation": "Run `fab doctor --fix-knowledge` 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.",
@@ -374,7 +406,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 `fab doctor --apply-lint` to delete stale session-hints cache files.",
+  "doctor.check.session_hints_stale.remediation": "Run `fab doctor --fix-knowledge` to delete stale session-hints cache files.",
   "doctor.check.stale_serve_lock.name": "Serve lock",
   "doctor.check.stale_serve_lock.ok.no_lock": "No .fabric/.serve.lock present.",
   "doctor.check.stale_serve_lock.ok.live_pid": ".fabric/.serve.lock held by live PID {pid}.",
@@ -388,7 +420,20 @@ var enMessages = {
   "doctor.check.relevance_fields_missing.ok": "All pending entries declare both relevance_scope and relevance_paths.",
   "doctor.check.relevance_fields_missing.message.singular": "{count} pending entry is missing relevance_scope and/or relevance_paths in frontmatter. First: {detail}.",
   "doctor.check.relevance_fields_missing.message.plural": "{count} pending entries are missing relevance_scope and/or relevance_paths in frontmatter. First: {detail}.",
-  "doctor.check.relevance_fields_missing.remediation": "Run `fab doctor --apply-lint` to back-fill the schema defaults (relevance_scope: broad, relevance_paths: []).",
+  "doctor.check.relevance_fields_missing.remediation": "Run `fab doctor --fix-knowledge` to back-fill the schema defaults (relevance_scope: broad, relevance_paths: []).",
+  // rc.31 BUG-M3/NEW-4: hooks_wired observability.
+  "doctor.check.hooks_wired.name": "Claude Code hooks wired",
+  "doctor.check.hooks_wired.ok.skipped": "Project does not use Claude Code (no .claude/ directory); hooks_wired check skipped.",
+  "doctor.check.hooks_wired.ok.wired": ".claude/settings.json has the three fabric hooks wired: Stop:fabric-hint / SessionStart:knowledge-hint-broad / PreToolUse:knowledge-hint-narrow.",
+  "doctor.check.hooks_wired.message.missing_settings": ".claude/ exists but .claude/settings.json is absent or unparseable; fab install may have never run successfully, or the file was wiped externally.",
+  "doctor.check.hooks_wired.message.incomplete": ".claude/settings.json is missing fabric hook injections: {missing}. fab install dry-run report does not match actual state (rc.30 audit BUG-M3 / NEW-4).",
+  "doctor.check.hooks_wired.remediation": "Run `fab install` to re-inject hooks (idempotent; only fills missing slots). If hooks config was accidentally wiped, back up .claude/settings.json before running.",
+  // rc.31 BUG-G2/G5: promote-ledger invariant check.
+  "doctor.check.promote_ledger_invariant.name": "Promote ledger invariant",
+  "doctor.check.promote_ledger_invariant.ok": "knowledge_proposed={proposed} >= knowledge_promote_started={started} >= knowledge_promoted={promoted}; ledger invariant holds.",
+  "doctor.check.promote_ledger_invariant.message.proposed-lt-started": "knowledge_proposed={proposed} is less than knowledge_promote_started={started} (ledger invariant violated; some pending entries were approved without going through fab_extract_knowledge, so no propose event was emitted for them).",
+  "doctor.check.promote_ledger_invariant.message.started-lt-promoted": "knowledge_promote_started={started} is less than knowledge_promoted={promoted} (ledger invariant violated; unpaired promoted events exist, possibly from doctor filesystem-edit fallback or external writers).",
+  "doctor.check.promote_ledger_invariant.remediation": "Starting in rc.31, review.approve synthesizes a knowledge_proposed event to keep the invariant; re-run fab doctor after the next approve to settle. Historical imbalance is observability-only and does not affect KB function.",
   "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}.",
@@ -577,7 +622,7 @@ var enMessages = {
   "cli.scan.args.target.description": "Target absolute path. Defaults to --target, then EXTERNAL_FIXTURE_PATH, then cwd.",
   "cli.scan.args.debug.description": "Print detection evidence in formatted output.",
   "cli.scan.args.json.description": "Print the diagnostic report as JSON.",
-  "cli.scan.error.missing-forensic": "forensic.json not found at {path}; run `fabric install` first to produce the deterministic project snapshot.",
+  "cli.scan.error.missing-forensic": "forensic.json not found at {path}; run `fab install` first to produce the deterministic project snapshot.",
   "cli.scan.summary.created": "Wrote {count} knowledge entries to .fabric/knowledge/.",
   "cli.scan.summary.skipped": "No changes detected; {count} entries already up-to-date.",
   "cli.scan.report.title": "Fabric scan report",
@@ -1002,7 +1047,9 @@ var zhCNMessages = {
   // rc.23 TASK-007 (a-C2): --enrich-descriptions 回填四个 description 字段。
   "cli.doctor.args.enrich-descriptions.description": "\u56DE\u586B\u6B63\u5F0F\u77E5\u8BC6\u6761\u76EE\u7F3A\u5931\u7684 intent_clues / tech_stack / impact / must_read_if \u5B57\u6BB5\uFF08\u9ED8\u8BA4\u53EA\u8BFB;\u642D\u914D --auto \u5199\u5165 stub\uFF09\u3002",
   "cli.doctor.args.auto.description": "\u4E0E --enrich-descriptions \u642D\u914D\uFF1A\u4E3A\u7F3A\u5931\u5B57\u6BB5\u5199\u5165\u786E\u5B9A\u6027 stub \u503C\u3002\u4E0D\u52A0 --auto \u4EC5\u505A\u53EA\u8BFB\u626B\u63CF\u3002",
-  "cli.doctor.args.dry-run.description": "\u4E0E --enrich-descriptions --auto \u642D\u914D\uFF1A\u4EC5\u9884\u89C8\u6539\u52A8\u8BA1\u5212,\u4E0D\u5199\u5165\u78C1\u76D8\u3002",
+  "cli.doctor.args.dry-run.description": "\u4E0E --enrich-descriptions --auto \u6216 --fix \u642D\u914D:\u4EC5\u9884\u89C8\u6539\u52A8\u8BA1\u5212,\u4E0D\u5199\u5165\u78C1\u76D8\u3002fix-dry-run \u8F93\u51FA\u4E0E --fix \u76F8\u540C\u7684 fixable_errors \u5217\u8868,\u4F46\u4E0D\u6267\u884C\u4EFB\u4F55 mutation\u3002",
+  // v2.0.0-rc.33 W4-B1 (T6 P2): --fix --dry-run banner — 出现在 report 之前, 让用户明确没有发生 mutation。
+  "cli.doctor.fix-dry-run-banner": "[dry-run] \u672A\u5E94\u7528\u4EFB\u4F55 mutation\u3002\u4E0B\u65B9 fixable_errors \u5217\u8868\u5C31\u662F `fab doctor --fix` \u4F1A\u5904\u7406\u7684\u9879;\u53BB\u6389 --dry-run \u518D\u8DD1\u53EF\u5B9E\u9645\u4FEE\u590D\u3002",
   "cli.doctor.errors.enrich-descriptions-mutex": "--enrich-descriptions \u4E0D\u80FD\u4E0E --fix / --fix-knowledge / --cite-coverage \u540C\u65F6\u4F7F\u7528,\u8BF7\u5206\u522B\u8FD0\u884C\u3002",
   "doctor.enrich.allComplete": "\u6240\u6709\u6B63\u5F0F\u77E5\u8BC6\u6761\u76EE\u5747\u5DF2\u5305\u542B intent_clues / tech_stack / impact / must_read_if\u3002",
   // rc.26 TASK-02a: doctor foundation-batch check messages.
@@ -1024,13 +1071,14 @@ var zhCNMessages = {
   "doctor.check.managed_block_drift.ok.no_managed_block": "\u672A\u68C0\u6D4B\u5230 three-end managed blocks\uFF1B\u53EF\u80FD\u5C1A\u672A\u4F20\u64AD\uFF0C\u6216\u4ECD\u5904\u4E8E legacy-marker \u72B6\u6001\u3002",
   "doctor.check.bootstrap_anchor.name": "Bootstrap anchor",
   "doctor.check.bootstrap_anchor.message.missing": "repo root \u4E0B AGENTS.md \u4E0E CLAUDE.md \u90FD\u4E0D\u5B58\u5728\u3002Fabric \u9700\u8981\u5728\u9879\u76EE\u6839\u76EE\u5F55\u5B58\u5728 bootstrap anchor \u6587\u4EF6\u3002",
-  "doctor.check.bootstrap_anchor.remediation.missing": "\u8FD0\u884C `fabric install` \u5728 repo root \u751F\u6210 AGENTS.md / CLAUDE.md bootstrap anchor\u3002",
+  "doctor.check.bootstrap_anchor.remediation.missing": "\u8FD0\u884C `fab install` \u5728 repo root \u751F\u6210 AGENTS.md / CLAUDE.md bootstrap anchor\u3002",
   "doctor.check.bootstrap_anchor.ok": "repo root \u4E0B\u5DF2\u5B58\u5728 Bootstrap anchor\uFF1A{present}\u3002",
   "doctor.check.baseline_filename_format.name": "Baseline \u6587\u4EF6\u540D\u683C\u5F0F",
   "doctor.check.baseline_filename_format.ok": "\u6240\u6709 baseline knowledge \u6587\u4EF6\u90FD\u4F7F\u7528 canonical `${id}--${slug}.md` \u6587\u4EF6\u540D\u683C\u5F0F\u3002",
   "doctor.check.baseline_filename_format.message.singular": "{count} \u4E2A baseline knowledge \u6587\u4EF6\u4ECD\u4F7F\u7528\u5DF2\u5E9F\u5F03\u7684 bare-slug \u6587\u4EF6\u540D\u683C\u5F0F\uFF0C\u5FC5\u987B\u8FC1\u79FB\u4E3A `${id}--${slug}.md`\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.baseline_filename_format.message.plural": "{count} \u4E2A baseline knowledge \u6587\u4EF6\u4ECD\u4F7F\u7528\u5DF2\u5E9F\u5F03\u7684 bare-slug \u6587\u4EF6\u540D\u683C\u5F0F\uFF0C\u5FC5\u987B\u8FC1\u79FB\u4E3A `${id}--${slug}.md`\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.baseline_filename_format.remediation": "\u624B\u52A8\u5220\u9664\u65E7 bare-slug baseline file(s)\uFF1Bbaseline pipeline \u5DF2\u5728 rc.23 \u79FB\u9664\uFF0C\u4E0D\u518D\u63D0\u4F9B auto-fix \u8DEF\u5F84\u3002",
+  // v2.0.0-rc.33 W3-2 (T6 #5): 文案显式引用 message 内已列出的 detail (file 名), 让用户直接 rm 而非自己去 grep 找。baseline pipeline 已 rc.23 移除, 没有 auto-fix。
+  "doctor.check.baseline_filename_format.remediation": "\u624B\u52A8\u5220\u9664\u4E0A\u9762 message \u4E2D\u5217\u51FA\u7684 bare-slug baseline file(s) (\u4F8B\u5982 `rm <message \u5217\u51FA\u7684 file>`);baseline pipeline \u5DF2\u5728 rc.23 \u79FB\u9664, \u4E0D\u518D\u63D0\u4F9B auto-fix \u8DEF\u5F84\u3002",
   "doctor.check.knowledge_dir_missing.name": "Knowledge layout",
   "doctor.check.knowledge_dir_missing.message.singular": "{count} \u4E2A\u5FC5\u9700 knowledge subdir \u7F3A\u5931\uFF1A{list}\u3002",
   "doctor.check.knowledge_dir_missing.message.plural": "{count} \u4E2A\u5FC5\u9700 knowledge subdir \u7F3A\u5931\uFF1A{list}\u3002",
@@ -1047,7 +1095,7 @@ var zhCNMessages = {
   "doctor.check.agents_meta.message.missing": ".fabric/agents.meta.json \u7F3A\u5931\u3002",
   "doctor.check.agents_meta.remediation.missing": "\u8FD0\u884C `fab doctor --fix` \u4ECE .fabric/knowledge/ \u91CD\u5EFA agents.meta.json\u3002",
   "doctor.check.agents_meta.message.invalid-default": ".fabric/agents.meta.json \u65E0\u6548\u3002",
-  "doctor.check.agents_meta.remediation.invalid": "\u5220\u9664 .fabric/agents.meta.json \u5E76\u8FD0\u884C `fab doctor --fix` \u91CD\u65B0\u751F\u6210\u3002",
+  "doctor.check.agents_meta.remediation.invalid": "\u8FD0\u884C `fab doctor --fix` \u8BA9 reconcile \u4ECE .fabric/knowledge/ \u78C1\u76D8 ground-truth \u91CD\u5EFA agents.meta.json\uFF08rc.31 \u8D77\u517C\u5BB9\u5386\u53F2 schema \u7684 singular knowledge_type \u81EA\u52A8\u8FC1\u79FB\u5230 plural\uFF1B\u4E0D\u8981\u624B\u52A8\u5220\u9664 agents.meta.json\uFF0C\u4F1A\u4E22 counters envelope \u4E0E promote ledger \u5173\u8054\uFF09\u3002",
   "doctor.check.agents_meta.message.stale": ".fabric/agents.meta.json revision {revision} \u4E0E .fabric/knowledge \u6D3E\u751F revision {computedRevision} \u4E0D\u4E00\u81F4\u3002",
   "doctor.check.agents_meta.remediation.stale": "\u53EF\u5FFD\u7565\uFF1Bengine \u4F1A\u5728\u4E0B\u4E00\u6B21 plan-context/get-sections \u8C03\u7528\u65F6\u81EA\u52A8\u4FEE\u590D\u3002\u9700\u8981\u663E\u5F0F reconcile \u65F6\u8FD0\u884C `fab doctor --fix`\u3002",
   "doctor.check.agents_meta.ok": ".fabric/agents.meta.json revision {revision} \u5DF2\u4E0E .fabric/knowledge \u5BF9\u9F50\u3002",
@@ -1056,7 +1104,8 @@ var zhCNMessages = {
   "doctor.check.rule_content_refs.remediation.unavailable": "\u5148\u4FEE\u590D agents.meta.json\uFF1A\u8FD0\u884C `fab doctor --fix`\u3002",
   "doctor.check.rule_content_refs.message.outside.singular": "{count} \u4E2A content_ref entry \u4F4D\u4E8E .fabric/knowledge \u5916\u90E8\u3002",
   "doctor.check.rule_content_refs.message.outside.plural": "{count} \u4E2A content_ref entries \u4F4D\u4E8E .fabric/knowledge \u5916\u90E8\u3002",
-  "doctor.check.rule_content_refs.remediation.outside": "\u7F16\u8F91 agents.meta.json\uFF0C\u786E\u4FDD\u6240\u6709 content_ref \u503C\u90FD\u6307\u5411 .fabric/knowledge/{type}/\uFF08team\uFF09\u6216 ~/.fabric/knowledge/{type}/\uFF08personal\uFF09\u5185\u90E8\u3002",
+  // v2.0.0-rc.33 W3-2 (T6 #12): 项目规则禁止手动编辑 agents.meta.json (见 .fabric/AGENTS.md); 改引导用户跑 doctor --fix 走 reconcile 路径 (rc.31+ 兼容自动剔除外部 refs)。
+  "doctor.check.rule_content_refs.remediation.outside": "\u8FD0\u884C `fab doctor --fix` \u8BA9 reconcile \u81EA\u52A8\u5254\u9664\u5916\u90E8 content_ref (rc.31+ \u517C\u5BB9)\u3002\u4E25\u7981\u624B\u52A8\u7F16\u8F91 agents.meta.json \u2014 engine \u4F1A\u81EA\u52A8 reconcile\u3002",
   "doctor.check.rule_content_refs.message.missing.singular": "{count} \u4E2A content_ref target \u7F3A\u5931\u3002\u8FD0\u884C `fab doctor --fix` \u6267\u884C reconcile\u3002",
   "doctor.check.rule_content_refs.message.missing.plural": "{count} \u4E2A content_ref targets \u7F3A\u5931\u3002\u8FD0\u884C `fab doctor --fix` \u6267\u884C reconcile\u3002",
   "doctor.check.rule_content_refs.remediation.missing": "\u8FD0\u884C `fab doctor --fix` \u8BA9 agents.meta.json \u4E0E .fabric/knowledge/ \u4E2D\u7684\u73B0\u6709\u6587\u4EF6 reconcile\u3002",
@@ -1076,7 +1125,8 @@ var zhCNMessages = {
   "doctor.check.event_ledger.message.not_writable-default": ".fabric/events.jsonl \u4E0D\u53EF\u5199\u3002",
   "doctor.check.event_ledger.remediation.not_writable": "\u68C0\u67E5 .fabric/events.jsonl \u7684\u6587\u4EF6\u6743\u9650\uFF0C\u5E76\u786E\u8BA4\u6CA1\u6709\u5176\u4ED6\u8FDB\u7A0B\u6301\u6709\u5199\u9501\u3002",
   "doctor.check.event_ledger.message.invalid-default": ".fabric/events.jsonl \u65E0\u6548\u3002",
-  "doctor.check.event_ledger.remediation.invalid": "\u5220\u9664 .fabric/events.jsonl \u5E76\u8FD0\u884C `fab doctor --fix` \u91CD\u65B0\u521B\u5EFA\u3002",
+  // v2.0.0-rc.33 W3-1 (P0-6): archive-history 模式 — 引导用户先 mv 备份到 events.archive/ 保留历史, 再跑 --fix 重建空 ledger。与 rotateEventLedgerIfNeeded 的命名约定一致 (events-rotated-YYYY-MM-DD.jsonl 是滑窗 rotation; events-corrupted-YYYY-MM-DD.jsonl 是 invalid-fix 归档)。
+  "doctor.check.event_ledger.remediation.invalid": "\u5148\u5F52\u6863\u5386\u53F2 (`mkdir -p .fabric/events.archive && mv .fabric/events.jsonl .fabric/events.archive/events-corrupted-$(date +%Y-%m-%d).jsonl`), \u518D\u8FD0\u884C `fab doctor --fix` \u521B\u5EFA\u65B0\u7A7A ledger\u3002\u5386\u53F2\u4E8B\u4EF6\u4FDD\u7559\u5728 events.archive/ \u4E0D\u4E22\u3002",
   "doctor.check.event_ledger.ok": ".fabric/events.jsonl \u5DF2\u5B58\u5728\uFF0C\u53EF\u5199\uFF0C\u4E14\u53EF\u89E3\u6790\u3002",
   "doctor.check.mcp_config_in_wrong_file.name": "Claude MCP config \u4F4D\u7F6E",
   "doctor.check.mcp_config_in_wrong_file.message": ".claude/settings.json \u5305\u542B mcpServers.fabric\uFF1B\u6B64\u6587\u4EF6\u4EC5\u7528\u4E8E hooks/permissions\u3002\u8FD0\u884C --fix \u79FB\u9664\u5B83\uFF0C\u7136\u540E\u91CD\u65B0\u8FD0\u884C fab install \u5199\u5165 .mcp.json\u3002",
@@ -1093,12 +1143,36 @@ var zhCNMessages = {
   "doctor.check.event_ledger_schema_compat.ok.clean": "events.jsonl \u6240\u6709\u884C\u90FD\u80FD\u89E3\u6790\u4E3A\u5F53\u524D schema\u3002",
   "doctor.check.event_ledger_schema_compat.message.schema_version": "events.jsonl \u542B {count} \u884C `schema_version` \u4E0D\u88AB\u5F53\u524D CLI \u8BC6\u522B\uFF08\u6837\u672C: {samples}\uFF09\u3002",
   "doctor.check.event_ledger_schema_compat.message.event_type": "events.jsonl \u542B {count} \u884C `event_type` \u4E0D\u5728\u5F53\u524D schema \u4E2D\uFF08\u6837\u672C: {samples}\uFF09\u3002",
-  "doctor.check.event_ledger_schema_compat.remediation": "\u5347\u7EA7 fab CLI \u5230\u4E0E server \u517C\u5BB9\u7684\u7248\u672C\uFF0C\u6216\u5907\u4EFD `.fabric/events.jsonl` \u540E\u8DD1 `fab doctor --fix` \u91CD\u5EFA\u7A7A ledger\u3002",
+  // v2.0.0-rc.33 W3-1 (P0-6): archive-history 模式 — 同 event_ledger.invalid, 文案显式说"归档备份"而非"备份后重建",避免用户误以为旧 ledger 被丢弃。
+  "doctor.check.event_ledger_schema_compat.remediation": "\u5347\u7EA7 fab CLI \u5230\u4E0E server \u517C\u5BB9\u7684\u7248\u672C (\u9996\u9009);\u6216\u5148\u5F52\u6863\u5386\u53F2 (`mkdir -p .fabric/events.archive && mv .fabric/events.jsonl .fabric/events.archive/events-schema-mismatch-$(date +%Y-%m-%d).jsonl`),\u518D\u8DD1 `fab doctor --fix` \u521B\u5EFA\u65B0\u7A7A ledger\u3002\u5386\u53F2\u4E8B\u4EF6\u4FDD\u7559\u5728 events.archive/ \u4E0D\u4E22,\u53EF\u540E\u7EED\u624B\u52A8\u8FC1\u79FB\u3002",
   // v2.0.0-rc.28 TASK-04 (audit §3.1): SKILL ref/ 镜像一致性检查。
   "doctor.check.skill_ref_mirror.name": "Skill ref \u955C\u50CF\u4E00\u81F4\u6027",
   "doctor.check.skill_ref_mirror.ok": "`.claude/skills/<slug>/ref/` \u4E0E `.codex/skills/<slug>/ref/` \u5B57\u8282\u4E00\u81F4\u3002",
   "doctor.check.skill_ref_mirror.message": "\u6709 {count} \u4E2A ref \u6587\u4EF6\u5728 `.claude/skills/` \u4E0E `.codex/skills/` \u4E4B\u95F4\u4E0D\u4E00\u81F4\uFF08\u8DEF\u5F84: {list}\uFF09\u3002\u53EF\u80FD\u67D0\u7AEF\u88AB\u624B\u52A8\u7F16\u8F91\u6216 install \u5199\u5165\u5931\u8D25\u3002",
   "doctor.check.skill_ref_mirror.remediation": "\u8DD1 `fab install` \u4ECE canonical templates \u91CD\u5199\u4E24\u7AEF ref \u5B50\u6811\u4EE5\u6062\u590D\u4E00\u81F4\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 浪费 + 加载延迟)。
+  "doctor.check.skill_token_budget.name": "Skill token budget",
+  "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.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 `fab install` \u540C\u6B65\u4E24\u7AEF\u3002",
+  // v2.0.0-rc.33 W3-7 (P1-14): SKILL.md description 结构 lint。代理 trigger-recall (真 LLM 测要 live model, W1 已用 gemini 跑过);本 lint 抓回归: description 缺失 / 超 60 token / 缺中文 trigger / 缺英文 trigger。
+  "doctor.check.skill_description.name": "Skill description quality",
+  "doctor.check.skill_description.ok": "\u6240\u6709 SKILL.md description \u5B57\u6BB5\u7ED3\u6784\u826F\u597D (\u975E\u7A7A / <60 token / \u4E2D\u82F1\u53CC\u8BED trigger)\u3002",
+  "doctor.check.skill_description.message.singular": "{count} \u4E2A SKILL.md description \u7ED3\u6784\u95EE\u9898: {list}\u3002description \u662F host \u7AEF auto-invoke \u7684\u4E3B\u8981\u5339\u914D\u4FE1\u53F7\u3002",
+  "doctor.check.skill_description.message.plural": "{count} \u4E2A SKILL.md description \u7ED3\u6784\u95EE\u9898: {list}\u3002description \u662F host \u7AEF auto-invoke \u7684\u4E3B\u8981\u5339\u914D\u4FE1\u53F7\u3002",
+  "doctor.check.skill_description.remediation": "\u7F16\u8F91 `packages/cli/templates/skills/<slug>/SKILL.md` frontmatter `description:` \u5B57\u6BB5: (1) \u975E\u7A7A; (2) <60 token (chars/3 \u4F30\u7B97, \u7EA6 180 \u5B57\u7B26); (3) \u81F3\u5C11 1 \u4E2A\u4E2D\u6587 trigger \u77ED\u8BED; (4) \u81F3\u5C11 1 \u4E2A\u82F1\u6587 trigger \u77ED\u8BED\u3002\u53C2\u8003 W1 description rewrite \u98CE\u683C\u3002\u91CD\u65B0\u8DD1 `fab install` \u540C\u6B65\u4E24\u7AEF\u3002\u5982\u9700\u9A8C\u8BC1 recall, \u8DD1 W1 \u7684 gemini delegate (\u89C1 .workflow/.scratchpad/rc33-plan/W1-VERIFY-RESULT.md)\u3002",
+  // v2.0.0-rc.33 W3-3 (P1-3): cite-policy Goodhart 模式检测。扫 7d 内 assistant_turn_observed 事件, 4 个 anti-pattern (G1 仪式化 / G2 抄底引用 / G3 chained-from 滥用 / G5 placeholder cite)。warning 级 (启发式有 false-positive, 不阻断)。
+  "doctor.check.cite_goodhart.name": "Cite-policy Goodhart",
+  "doctor.check.cite_goodhart.ok": "\u8FC7\u53BB 7d \u672A\u68C0\u6D4B\u5230 cite-policy Goodhart \u53CD\u6A21\u5F0F\u3002",
+  "doctor.check.cite_goodhart.message.singular": "\u68C0\u6D4B\u5230 {count} \u4E2A cite-policy Goodhart \u6A21\u5F0F: {list}\u3002",
+  "doctor.check.cite_goodhart.message.plural": "\u68C0\u6D4B\u5230 {count} \u4E2A cite-policy Goodhart \u6A21\u5F0F: {list}\u3002",
+  "doctor.check.cite_goodhart.remediation": "\u5BA1\u9605\u89E6\u53D1\u7684 pattern: G1 \u4EEA\u5F0F\u5316 \u2192 \u540C\u4E00 [recalled] cite \u91CD\u590D\u7528,\u8BE5\u628A KB \u771F\u6B63\u843D\u5230 contract; G2 \u6284\u5E95\u5F15\u7528 \u2192 > 60% recalled \u7528 skip: \u662F\u7ED5\u8FC7 contract, review skip reason \u771F\u5B9E\u6027; G3 chained-from \u6EE5\u7528 \u2192 chained-from \u6807\u4E86\u4F46\u6CA1 commitment, \u8981\u8865 operators \u6216\u6539\u7528\u5176\u4ED6 tag; G5 placeholder cite \u2192 'KB: none' / [unspecified] \u592A\u591A, \u8BE5\u7528\u5177\u4F53 sentinel \u5982 [no-relevant] / [not-applicable]\u3002\u8BE6\u7EC6\u6570\u636E\u8DD1 `fab doctor --cite-coverage --since=7d`\u3002",
+  // v2.0.0-rc.33 W4-A4 (T5 P2): draft-backlog lint。rc.32 baseline 92% entry 卡在 draft, 揭示 promote 断流。> 50% draft 触发 warning (workspace 必须 >= 10 entries 才计算比率, 避免小语料噪音)。
+  "doctor.check.draft_backlog.name": "Knowledge draft backlog",
+  "doctor.check.draft_backlog.ok": "canonical knowledge entries \u4E2D draft \u5360\u6BD4\u6B63\u5E38 (< 50%, \u6216 workspace \u592A\u5C0F\u4E0D\u8BC4)\u3002",
+  "doctor.check.draft_backlog.message": "{draftCount}/{totalCount} ({pct}%) canonical knowledge entries \u5361\u5728 draft maturity \u2014 promote \u65AD\u6D41 (rc.32 baseline 92%)\u3002",
+  "doctor.check.draft_backlog.remediation": "\u8C03 `/fabric-review` \u6279\u91CF\u5BA1 draft entries: approve \u5347 verified/proven, reject \u4E22, modify \u4FEE\u3002draft \u957F\u671F\u5806\u79EF\u901A\u5E38\u610F\u5473\u7740 archive skill \u4EA7 draft \u592A\u5FEB\u6216 review skill \u6CA1\u8DDF\u4E0A\u3002",
   "doctor.check.meta_manually_diverged.name": "Meta manual divergence",
   "doctor.check.meta_manually_diverged.ok.unreadable": "agents.meta.json \u4E0D\u53EF\u8BFB\uFF0C\u8DF3\u8FC7 divergence \u68C0\u67E5\u3002",
   "doctor.check.meta_manually_diverged.message.extra.singular": "agents.meta.json \u4E2D\u6709 {count} \u4E2A entry \u5728\u78C1\u76D8\u4E0A\u6CA1\u6709\u5BF9\u5E94\u6587\u4EF6\u3002\u8FD0\u884C --fix \u6267\u884C reconcile\u3002",
@@ -1116,7 +1190,8 @@ var zhCNMessages = {
   "doctor.check.stable_id_collision.name": "Stable ID collision",
   "doctor.check.stable_id_collision.message.singular": 'stable_id "{stableId}" \u88AB\u58F0\u660E\u5728 {fileCount} \u4E2A\u6587\u4EF6\u4E2D\uFF1A{files}\u3002\u8BF7\u7F16\u8F91\u5176\u4E2D\u4E00\u4E2A knowledge file\uFF0C\u6539\u7528\u552F\u4E00 stable_id\u3002',
   "doctor.check.stable_id_collision.message.plural": '\u68C0\u6D4B\u5230 {count} \u4E2A stable_id collisions\u3002\u9996\u4E2A\uFF1A"{stableId}" \u4F4D\u4E8E {files}\u3002\u8BF7\u7F16\u8F91\u5176\u4E2D\u4E00\u4E2A knowledge file\uFF0C\u6539\u7528\u552F\u4E00 stable_id\u3002',
-  "doctor.check.stable_id_collision.remediation": "\u7F16\u8F91\u5176\u4E2D\u4E00\u4E2A colliding knowledge file\uFF0C\u6539\u7528\u4E0D\u540C\u7684 `id: K[PT]-XXX-NNNN` frontmatter \u503C\u3002",
+  // v2.0.0-rc.33 W3-2 (T6 #27): 走 fabric-review modify 流程让 canonical id allocator 重新分配, 而非让用户自己选 id (易撞 counter, 难手算)。
+  "doctor.check.stable_id_collision.remediation": "\u8C03 `/fabric-review modify <message \u4E2D\u5217\u51FA\u7684 colliding id \u4E4B\u4E00>`, \u8BA9 canonical id allocator \u81EA\u52A8\u91CD\u5206\u914D id (\u4F1A\u540C\u6B65\u66F4\u65B0 frontmatter + counters + \u5386\u53F2 cross-ref)\u3002\u4E25\u7981\u624B\u5DE5\u7F16\u8F91 id frontmatter \u2014 \u4F1A\u649E counter\u3002",
   "doctor.check.stable_id_collision.ok": ".fabric/knowledge/ \u4E2D\u672A\u53D1\u73B0\u5DF2\u58F0\u660E\u7684 stable_id collisions\u3002",
   "doctor.check.counter_desync.name": "Knowledge counter desync",
   "doctor.check.counter_desync.message.singular": "{count} \u4E2A knowledge counter \u4E0E\u89C2\u6D4B\u5230\u7684 stable_ids \u4E0D\u540C\u6B65\u3002{counterPath} = {current}\uFF0C\u4F46\u68C0\u6D4B\u5230 {observedId}\u3002\u8FD0\u884C `fab doctor --fix` bump counters\u3002",
@@ -1136,12 +1211,12 @@ var zhCNMessages = {
   "doctor.check.orphan_demote.ok": "\u6CA1\u6709 canonical knowledge entries \u8D85\u8FC7\u6309 maturity \u8BBE\u5B9A\u7684 inactivity threshold\u3002",
   "doctor.check.orphan_demote.message.singular": "{count} \u4E2A canonical knowledge entry \u8D85\u8FC7\u6309 maturity \u8BBE\u5B9A\u7684 inactivity threshold\uFF08stable={stableDays}d / endorsed={endorsedDays}d / draft={draftDays}d\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.orphan_demote.message.plural": "{count} \u4E2A canonical knowledge entries \u8D85\u8FC7\u6309 maturity \u8BBE\u5B9A\u7684 inactivity threshold\uFF08stable={stableDays}d / endorsed={endorsedDays}d / draft={draftDays}d\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.orphan_demote.remediation": "\u8FD0\u884C `fab doctor --apply-lint`\uFF08rc.4 TASK-003\uFF09\u5C06 orphan entries \u964D\u7EA7\u4E00\u4E2A maturity tier\u3002",
+  "doctor.check.orphan_demote.remediation": "\u8FD0\u884C `fab doctor --fix-knowledge`\u5C06 orphan entries \u964D\u7EA7\u4E00\u4E2A maturity tier\u3002",
   "doctor.check.stale_archive.name": "Knowledge stale archive",
   "doctor.check.stale_archive.ok": "\u6CA1\u6709 draft knowledge entries \u8D85\u8FC7\u989D\u5916\u7684 stale-archive quiet window\u3002",
   "doctor.check.stale_archive.message.singular": "{count} \u4E2A draft knowledge entry \u5DF2\u8D85\u8FC7 demote+{additionalDays}d \u989D\u5916 quiet window\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.stale_archive.message.plural": "{count} \u4E2A draft knowledge entries \u5DF2\u8D85\u8FC7 demote+{additionalDays}d \u989D\u5916 quiet window\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.stale_archive.remediation": "\u8FD0\u884C `fab doctor --apply-lint`\uFF08rc.4 TASK-003\uFF09\u5C06 stale entries \u79FB\u52A8\u5230 `.fabric/.archive/<type>/`\u3002",
+  "doctor.check.stale_archive.remediation": "\u8FD0\u884C `fab doctor --fix-knowledge`\u5C06 stale entries \u79FB\u52A8\u5230 `.fabric/.archive/<type>/`\u3002",
   "doctor.check.pending_overdue.name": "Knowledge pending overdue",
   "doctor.check.pending_overdue.ok": "\u6CA1\u6709 pending knowledge entries \u8D85\u8FC7 14-day review threshold\u3002",
   "doctor.check.pending_overdue.message.singular": "{count} \u4E2A pending knowledge entry \u5DF2\u7B49\u5F85 review \u8D85\u8FC7 {thresholdDays} \u5929\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
@@ -1151,17 +1226,19 @@ var zhCNMessages = {
   "doctor.check.stable_id_duplicate.ok": "team / personal trees \u4E2D\u6CA1\u6709 canonical knowledge files \u5171\u4EAB stable_id\u3002",
   "doctor.check.stable_id_duplicate.message.singular": "{count} \u4E2A stable_id \u5728 canonical knowledge files \u4E2D\u91CD\u590D\uFF08path-decoupled identity invariant\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.stable_id_duplicate.message.plural": "{count} \u4E2A stable_ids \u5728 canonical knowledge files \u4E2D\u91CD\u590D\uFF08path-decoupled identity invariant\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.stable_id_duplicate.remediation": "\u624B\u52A8\u5C06\u5176\u4E2D\u4E00\u4E2A colliding file \u91CD\u547D\u540D\u4E3A\u901A\u8FC7 canonical id allocator \u5206\u914D\u7684\u65B0 `<prefix>-<type>-<counter>--<slug>.md`\uFF1B\u4E0D\u8981\u624B\u5DE5\u7F16\u8F91\u3002",
+  // v2.0.0-rc.33 W3-2 (T6 #34): 同 stable_id_collision — 走 fabric-review modify 让 allocator 分配新 id, 不让用户手算。
+  "doctor.check.stable_id_duplicate.remediation": "\u8C03 `/fabric-review modify <message \u4E2D\u5217\u51FA\u7684 duplicate id \u4E4B\u4E00>`, \u7531 canonical id allocator \u5206\u914D\u65B0\u7684 `<prefix>-<type>-<counter>--<slug>.md` (\u4F1A\u540C\u6B65\u91CD\u547D\u540D\u6587\u4EF6 + \u66F4\u65B0 frontmatter + \u4FEE\u6B63 counters)\u3002",
   "doctor.check.layer_mismatch.name": "Knowledge layer mismatch",
   "doctor.check.layer_mismatch.ok": "\u6240\u6709 canonical knowledge files \u90FD\u4F4D\u4E8E stable_id prefix \u58F0\u660E\u7684 layer \u4E0B\u3002",
   "doctor.check.layer_mismatch.message.singular": "{count} \u4E2A canonical knowledge file \u4E0E\u5176 stable_id layer prefix \u7684\u7269\u7406\u4F4D\u7F6E\u4E0D\u4E00\u81F4\uFF08KT-* must live under team/, KP-* under personal/\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.layer_mismatch.message.plural": "{count} \u4E2A canonical knowledge files \u4E0E\u5176 stable_id layer prefix \u7684\u7269\u7406\u4F4D\u7F6E\u4E0D\u4E00\u81F4\uFF08KT-* must live under team/, KP-* under personal/\uFF09\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.layer_mismatch.remediation": "\u5C06\u6587\u4EF6\u79FB\u52A8\u5230\u6B63\u786E\u7684 layer root\uFF0C\u6216\u901A\u8FC7 fabric-review modify \u6D41\u7A0B\u5207\u6362\u5176 layer\uFF08\u4F1A\u76F8\u5E94\u91CD\u547D\u540D stable_id prefix\uFF09\u3002",
+  // v2.0.0-rc.33 W3-2 (T6 #35): 加 skill 入口 (`/fabric-review modify <id>`) 让用户知道怎么 invoke。
+  "doctor.check.layer_mismatch.remediation": "\u5C06\u6587\u4EF6\u79FB\u52A8\u5230\u6B63\u786E\u7684 layer root (KT-* \u2192 .fabric/knowledge/team/, KP-* \u2192 ~/.fabric/knowledge/personal/), \u6216\u8C03 `/fabric-review modify <message \u4E2D\u5217\u51FA\u7684 id>` \u5207\u6362\u5176 layer (\u4F1A\u76F8\u5E94\u91CD\u547D\u540D stable_id prefix)\u3002",
   "doctor.check.index_drift.name": "Knowledge index drift",
   "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 `fab doctor --apply-lint`\uFF08rc.4 TASK-003\uFF09\u5C06 agents.meta.json counters \u63D0\u5347\u5230 max_observed + 1\u3002",
+  "doctor.check.index_drift.remediation": "\u8FD0\u884C `fab doctor --fix-knowledge`\u5C06 agents.meta.json counters \u63D0\u5347\u5230 max_observed + 1\u3002",
   "doctor.check.underseeded.name": "Knowledge underseeded",
   "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",
@@ -1195,7 +1272,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 `fab doctor --apply-lint` \u5220\u9664\u8FC7\u671F\u7684 session-hints cache files\u3002",
+  "doctor.check.session_hints_stale.remediation": "\u8FD0\u884C `fab doctor --fix-knowledge` \u5220\u9664\u8FC7\u671F\u7684 session-hints cache files\u3002",
   "doctor.check.stale_serve_lock.name": "Serve lock",
   "doctor.check.stale_serve_lock.ok.no_lock": "\u672A\u53D1\u73B0 .fabric/.serve.lock\u3002",
   "doctor.check.stale_serve_lock.ok.live_pid": ".fabric/.serve.lock \u7531 live PID {pid} \u6301\u6709\u3002",
@@ -1209,7 +1286,20 @@ var zhCNMessages = {
   "doctor.check.relevance_fields_missing.ok": "\u6240\u6709 pending entries \u90FD\u58F0\u660E\u4E86 relevance_scope \u548C relevance_paths\u3002",
   "doctor.check.relevance_fields_missing.message.singular": "{count} \u4E2A pending entry \u7684 frontmatter \u7F3A\u5C11 relevance_scope \u548C/\u6216 relevance_paths\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
   "doctor.check.relevance_fields_missing.message.plural": "{count} \u4E2A pending entries \u7684 frontmatter \u7F3A\u5C11 relevance_scope \u548C/\u6216 relevance_paths\u3002\u9996\u4E2A\uFF1A{detail}\u3002",
-  "doctor.check.relevance_fields_missing.remediation": "\u8FD0\u884C `fab doctor --apply-lint` \u56DE\u586B schema defaults\uFF08relevance_scope: broad\uFF0Crelevance_paths: []\uFF09\u3002",
+  "doctor.check.relevance_fields_missing.remediation": "\u8FD0\u884C `fab doctor --fix-knowledge` \u56DE\u586B schema defaults\uFF08relevance_scope: broad\uFF0Crelevance_paths: []\uFF09\u3002",
+  // rc.31 BUG-M3/NEW-4: hooks_wired observability.
+  "doctor.check.hooks_wired.name": "Claude Code hooks wired",
+  "doctor.check.hooks_wired.ok.skipped": "\u9879\u76EE\u672A\u542F\u7528 Claude Code\uFF08\u65E0 .claude/ \u76EE\u5F55\uFF09\uFF1B\u8DF3\u8FC7 hooks_wired \u68C0\u67E5\u3002",
+  "doctor.check.hooks_wired.ok.wired": ".claude/settings.json \u5DF2\u6CE8\u5165 Stop:fabric-hint / SessionStart:knowledge-hint-broad / PreToolUse:knowledge-hint-narrow \u4E09\u4E2A fabric hook\u3002",
+  "doctor.check.hooks_wired.message.missing_settings": ".claude/ \u76EE\u5F55\u5B58\u5728\u4F46 .claude/settings.json \u7F3A\u5931\u6216\u65E0\u6CD5\u89E3\u6790\uFF1Bfab install \u53EF\u80FD\u4ECE\u672A\u8DD1\u6210\u529F\uFF0C\u6216\u6587\u4EF6\u88AB\u5916\u90E8\u6E05\u7A7A\u3002",
+  "doctor.check.hooks_wired.message.incomplete": ".claude/settings.json \u7F3A\u5C11 fabric hook \u6CE8\u5165\uFF1A{missing}\u3002fab install \u7684 dry-run \u62A5\u544A\u4E0E\u5B9E\u9645\u72B6\u6001\u4E0D\u4E00\u81F4\uFF08rc.30 audit BUG-M3 / NEW-4\uFF09\u3002",
+  "doctor.check.hooks_wired.remediation": "\u8FD0\u884C `fab install` \u91CD\u65B0\u6CE8\u5165 hooks\uFF08\u5E42\u7B49\uFF1B\u53EA\u8865\u7F3A\u5931\u9879\uFF09\u3002\u82E5\u610F\u5916\u8986\u76D6\u4E86 hooks \u914D\u7F6E\uFF0C\u5148\u5907\u4EFD .claude/settings.json \u518D\u8DD1\u3002",
+  // rc.31 BUG-G2/G5: promote-ledger invariant check.
+  "doctor.check.promote_ledger_invariant.name": "Promote ledger invariant",
+  "doctor.check.promote_ledger_invariant.ok": "knowledge_proposed={proposed} \u2265 knowledge_promote_started={started} \u2265 knowledge_promoted={promoted}\uFF0Cledger \u4E0D\u53D8\u91CF\u6301\u6709\u3002",
+  "doctor.check.promote_ledger_invariant.message.proposed-lt-started": "knowledge_proposed={proposed} \u5C0F\u4E8E knowledge_promote_started={started}\uFF08ledger \u4E0D\u53D8\u91CF\u88AB\u7834\u574F\uFF1B\u90E8\u5206 pending \u5728 approve \u65F6\u672A\u7ECF\u8FC7 fab_extract_knowledge \u2192 \u7F3A\u5C11 propose \u4E8B\u4EF6\uFF09\u3002",
+  "doctor.check.promote_ledger_invariant.message.started-lt-promoted": "knowledge_promote_started={started} \u5C0F\u4E8E knowledge_promoted={promoted}\uFF08ledger \u4E0D\u53D8\u91CF\u88AB\u7834\u574F\uFF1B\u5B58\u5728\u672A\u914D\u5BF9\u7684 promoted \u4E8B\u4EF6\uFF0C\u53EF\u80FD\u6765\u81EA doctor filesystem-edit fallback \u6216\u5916\u90E8\u5199\u5165\uFF09\u3002",
+  "doctor.check.promote_ledger_invariant.remediation": "rc.31 \u8D77 review.approve \u4F1A\u8865\u53D1 knowledge_proposed \u4E8B\u4EF6\u4EE5\u7EF4\u62A4\u4E0D\u53D8\u91CF\uFF1B\u65B0 approve \u540E\u518D\u8DD1\u4E00\u6B21 fab doctor \u5373\u53EF\u6062\u590D\u3002\u5386\u53F2\u5931\u8861\u4EC5\u662F\u53EF\u89C2\u6D4B\u6027\u6307\u793A\uFF0C\u4E0D\u5F71\u54CD KB \u529F\u80FD\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",
@@ -1396,7 +1486,7 @@ var zhCNMessages = {
   "cli.scan.args.target.description": "\u76EE\u6807\u7EDD\u5BF9\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 --target\u3001EXTERNAL_FIXTURE_PATH\u3001\u5F53\u524D\u76EE\u5F55\u3002",
   "cli.scan.args.debug.description": "\u4EE5\u683C\u5F0F\u5316\u8F93\u51FA\u6253\u5370\u68C0\u6D4B\u8BC1\u636E\u3002",
   "cli.scan.args.json.description": "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u8BCA\u65AD\u62A5\u544A\u3002",
-  "cli.scan.error.missing-forensic": "\u672A\u627E\u5230 forensic.json\uFF08\u8DEF\u5F84 {path}\uFF09\uFF1B\u8BF7\u5148\u8FD0\u884C `fabric install` \u751F\u6210\u9879\u76EE\u5FEB\u7167\u3002",
+  "cli.scan.error.missing-forensic": "\u672A\u627E\u5230 forensic.json\uFF08\u8DEF\u5F84 {path}\uFF09\uFF1B\u8BF7\u5148\u8FD0\u884C `fab install` \u751F\u6210\u9879\u76EE\u5FEB\u7167\u3002",
   "cli.scan.summary.created": "\u5DF2\u5199\u5165 {count} \u6761\u77E5\u8BC6\u6761\u76EE\u81F3 .fabric/knowledge/\u3002",
   "cli.scan.summary.skipped": "\u65E0\u5DEE\u5F02\uFF1B{count} \u6761\u5DF2\u5B58\u5728\u7684\u6761\u76EE\u4FDD\u6301\u4E0D\u53D8\u3002",
   "cli.scan.report.title": "Fabric \u626B\u63CF\u62A5\u544A",

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-225L7D4T.js";
+} from "../chunk-Z7UPW75I.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-DkXJGQCD.d.ts → index-Crx0-0-9.d.ts}

@@ -178,6 +178,16 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
     onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    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>>;
+    hint_narrow_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    orphan_demote_stable_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_endorsed_days: z.ZodOptional<z.ZodNumber>;
+    orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     selection_token_ttl_ms: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
@@ -201,6 +211,13 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_topic_result_cap: number;
     review_stale_pending_days: number;
     onboard_slots_opted_out: string[];
+    hint_broad_top_k: number;
+    hint_narrow_top_k: number;
+    hint_narrow_dedup_window_turns: number;
+    hint_broad_cooldown_hours: number;
+    hint_narrow_cooldown_hours: number;
+    hint_summary_max_len: number;
+    hint_reminder_to_context: boolean;
     clientPaths?: {
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
@@ -214,6 +231,9 @@ declare const fabricConfigSchema: z.ZodObject<{
         hardBytes?: number | undefined;
     } | undefined;
     fabric_event_retention_days?: 7 | 30 | 90 | undefined;
+    orphan_demote_stable_days?: number | undefined;
+    orphan_demote_endorsed_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
     selection_token_ttl_ms?: number | undefined;
 }, {
     clientPaths?: {
@@ -250,6 +270,16 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_stale_pending_days?: number | undefined;
     fabric_event_retention_days?: 7 | 30 | 90 | undefined;
     onboard_slots_opted_out?: string[] | undefined;
+    hint_broad_top_k?: number | undefined;
+    hint_narrow_top_k?: number | undefined;
+    hint_narrow_dedup_window_turns?: number | undefined;
+    hint_broad_cooldown_hours?: number | undefined;
+    hint_narrow_cooldown_hours?: number | undefined;
+    orphan_demote_stable_days?: number | undefined;
+    orphan_demote_endorsed_days?: number | undefined;
+    orphan_demote_draft_days?: number | undefined;
+    hint_summary_max_len?: number | undefined;
+    hint_reminder_to_context?: boolean | undefined;
     selection_token_ttl_ms?: number | undefined;
 }>;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-DkXJGQCD.js';
-export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-DkXJGQCD.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-Crx0-0-9.js';
+export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-Crx0-0-9.js';
 export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
 import { z } from 'zod';
 import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';
@@ -26,7 +26,7 @@ declare const ruleDescriptionSchema: z.ZodObject<{
     must_read_if: z.ZodString;
     entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     id: z.ZodOptional<z.ZodString>;
-    knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+    knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
     maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
     knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
     layer_reason: z.ZodOptional<z.ZodString>;
@@ -60,7 +60,7 @@ declare const ruleDescriptionSchema: z.ZodObject<{
     relevance_paths?: string[] | undefined;
     entities?: string[] | undefined;
     id?: string | undefined;
-    knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+    knowledge_type?: unknown;
     maturity?: "draft" | "verified" | "proven" | undefined;
     knowledge_layer?: "personal" | "team" | undefined;
     layer_reason?: string | undefined;
@@ -80,7 +80,7 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
         must_read_if: z.ZodString;
         entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         id: z.ZodOptional<z.ZodString>;
-        knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+        knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
         maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
         knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
         layer_reason: z.ZodOptional<z.ZodString>;
@@ -114,7 +114,7 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -154,7 +154,7 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -191,7 +191,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         must_read_if: z.ZodString;
         entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         id: z.ZodOptional<z.ZodString>;
-        knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+        knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
         maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
         knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
         layer_reason: z.ZodOptional<z.ZodString>;
@@ -225,7 +225,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -258,7 +258,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         must_read_if: z.ZodString;
         entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         id: z.ZodOptional<z.ZodString>;
-        knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+        knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
         maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
         knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
         layer_reason: z.ZodOptional<z.ZodString>;
@@ -292,7 +292,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -325,7 +325,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         must_read_if: z.ZodString;
         entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         id: z.ZodOptional<z.ZodString>;
-        knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+        knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
         maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
         knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
         layer_reason: z.ZodOptional<z.ZodString>;
@@ -359,7 +359,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -392,7 +392,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         must_read_if: z.ZodString;
         entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         id: z.ZodOptional<z.ZodString>;
-        knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+        knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
         maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
         knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
         layer_reason: z.ZodOptional<z.ZodString>;
@@ -426,7 +426,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
         relevance_paths?: string[] | undefined;
         entities?: string[] | undefined;
         id?: string | undefined;
-        knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+        knowledge_type?: unknown;
         maturity?: "draft" | "verified" | "proven" | undefined;
         knowledge_layer?: "personal" | "team" | undefined;
         layer_reason?: string | undefined;
@@ -533,7 +533,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             must_read_if: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
-            knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+            knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
             knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
             layer_reason: z.ZodOptional<z.ZodString>;
@@ -567,7 +567,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             relevance_paths?: string[] | undefined;
             entities?: string[] | undefined;
             id?: string | undefined;
-            knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+            knowledge_type?: unknown;
             maturity?: "draft" | "verified" | "proven" | undefined;
             knowledge_layer?: "personal" | "team" | undefined;
             layer_reason?: string | undefined;
@@ -600,7 +600,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             must_read_if: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
-            knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+            knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
             knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
             layer_reason: z.ZodOptional<z.ZodString>;
@@ -634,7 +634,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             relevance_paths?: string[] | undefined;
             entities?: string[] | undefined;
             id?: string | undefined;
-            knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+            knowledge_type?: unknown;
             maturity?: "draft" | "verified" | "proven" | undefined;
             knowledge_layer?: "personal" | "team" | undefined;
             layer_reason?: string | undefined;
@@ -667,7 +667,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             must_read_if: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
-            knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+            knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
             knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
             layer_reason: z.ZodOptional<z.ZodString>;
@@ -701,7 +701,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             relevance_paths?: string[] | undefined;
             entities?: string[] | undefined;
             id?: string | undefined;
-            knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+            knowledge_type?: unknown;
             maturity?: "draft" | "verified" | "proven" | undefined;
             knowledge_layer?: "personal" | "team" | undefined;
             layer_reason?: string | undefined;
@@ -734,7 +734,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             must_read_if: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
-            knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+            knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
             knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
             layer_reason: z.ZodOptional<z.ZodString>;
@@ -768,7 +768,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             relevance_paths?: string[] | undefined;
             entities?: string[] | undefined;
             id?: string | undefined;
-            knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+            knowledge_type?: unknown;
             maturity?: "draft" | "verified" | "proven" | undefined;
             knowledge_layer?: "personal" | "team" | undefined;
             layer_reason?: string | undefined;
@@ -874,7 +874,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             must_read_if: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             id: z.ZodOptional<z.ZodString>;
-            knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+            knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
             maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
             knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
             layer_reason: z.ZodOptional<z.ZodString>;
@@ -908,7 +908,7 @@ declare const agentsMetaSchema: z.ZodObject<{
             relevance_paths?: string[] | undefined;
             entities?: string[] | undefined;
             id?: string | undefined;
-            knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+            knowledge_type?: unknown;
             maturity?: "draft" | "verified" | "proven" | undefined;
             knowledge_layer?: "personal" | "team" | undefined;
             layer_reason?: string | undefined;
@@ -2320,7 +2320,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2354,7 +2354,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -2387,7 +2387,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2421,7 +2421,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -2454,7 +2454,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2488,7 +2488,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -2521,7 +2521,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2555,7 +2555,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -2661,7 +2661,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2695,7 +2695,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -2769,7 +2769,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -2803,7 +2803,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -3598,7 +3598,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -3632,7 +3632,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -3665,7 +3665,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -3699,7 +3699,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -3732,7 +3732,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -3766,7 +3766,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -3799,7 +3799,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -3833,7 +3833,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -3939,7 +3939,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -3973,7 +3973,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;
@@ -4047,7 +4047,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 must_read_if: z.ZodString;
                 entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 id: z.ZodOptional<z.ZodString>;
-                knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
+                knowledge_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>, "models" | "decisions" | "guidelines" | "pitfalls" | "processes", unknown>>;
                 maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
                 knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
                 layer_reason: z.ZodOptional<z.ZodString>;
@@ -4081,7 +4081,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 relevance_paths?: string[] | undefined;
                 entities?: string[] | undefined;
                 id?: string | undefined;
-                knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
+                knowledge_type?: unknown;
                 maturity?: "draft" | "verified" | "proven" | undefined;
                 knowledge_layer?: "personal" | "team" | undefined;
                 layer_reason?: string | undefined;

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-225L7D4T.js";
+} from "./chunk-Z7UPW75I.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -64,6 +64,13 @@ import "./chunk-LXNCAKJZ.js";
 // src/schemas/agents-meta.ts
 import { z } from "zod";
 var FABRIC_AGENTS_PREFIX = ".fabric/agents/";
+var KNOWLEDGE_TYPE_SINGULAR_TO_PLURAL = {
+  model: "models",
+  decision: "decisions",
+  guideline: "guidelines",
+  pitfall: "pitfalls",
+  process: "processes"
+};
 var AGENTS_META_LAYERS = ["L0", "L1", "L2"];
 var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting", "domain", "local", "global"];
 var AGENTS_META_IDENTITY_SOURCES = ["declared", "derived"];
@@ -79,7 +86,15 @@ var ruleDescriptionSchema = z.object({
   entities: z.array(z.string()).optional(),
   // v2.0 knowledge entry fields (TASK-002 schemas). All optional for backward compat.
   id: z.string().optional(),
-  knowledge_type: z.enum(["models", "decisions", "guidelines", "pitfalls", "processes"]).optional(),
+  // rc.31 NEW-1: forward-compat for legacy on-disk agents.meta.json carrying
+  // singular knowledge_type values (model/decision/guideline/pitfall/process).
+  // Normalize to canonical plural form before enum validation so doctor and
+  // plan-context-hint can load pre-rc.28 meta files without aborting. Disk
+  // gets rewritten to plural on next reconcile (via knowledge-meta-builder).
+  knowledge_type: z.preprocess(
+    (value) => typeof value === "string" && value in KNOWLEDGE_TYPE_SINGULAR_TO_PLURAL ? KNOWLEDGE_TYPE_SINGULAR_TO_PLURAL[value] : value,
+    z.enum(["models", "decisions", "guidelines", "pitfalls", "processes"])
+  ).optional(),
   maturity: z.enum(["draft", "verified", "proven"]).optional(),
   knowledge_layer: z.enum(["personal", "team"]).optional(),
   layer_reason: z.string().optional(),
@@ -485,6 +500,76 @@ var fabricConfigSchema = z5.object({
   // Default `[]` keeps the field optional on existing configs — fresh
   // installs land with no opt-outs.
   onboard_slots_opted_out: z5.array(z5.string()).optional().default([]),
+  // v2.0.0-rc.33 W2-1 (P0-9): TopK upper bound for the broad SessionStart hint
+  // banner emitted by knowledge-hint-broad.cjs. After plan-context-hint returns
+  // its full broad-scoped index, the hook slices the entries to this many
+  // before grouping/truncation rendering — keeps the banner from scrolling off
+  // screen on well-seeded repos (Werewolf-class projects routinely surface 40+
+  // broad entries which buried the actually-relevant top hits). Default 8 is
+  // calibrated against the rc.32 eval baseline (cite-coverage 3.1%): the
+  // banner needs to fit in ~1 screenful so the agent actually reads it.
+  // Range 1..50; values above 20 effectively disable the cap because the
+  // TRUNCATION_THRESHOLD=12 grouped-render kicks in. Mirrors the rc.7 T7 +
+  // archive_max_* pattern of externalizing previously-hardcoded thresholds.
+  hint_broad_top_k: z5.number().int().min(1).max(50).optional().default(8),
+  // v2.0.0-rc.33 W2-1 (P0-9): TopK upper bound for the narrow PreToolUse hint
+  // emitted by knowledge-hint-narrow.cjs. After filtering to entries whose
+  // `relevance_scope === "narrow"` (rc.27 TASK-005 audit §2.5 fix), the hook
+  // slices to this many before the E3 emit-gate / renderSummary pipeline.
+  // Default 5 keeps each per-Edit hint terse — five lines max so the agent's
+  // working memory is not displaced by an unwieldy banner. Range 1..20.
+  hint_narrow_top_k: z5.number().int().min(1).max(20).optional().default(5),
+  // v2.0.0-rc.33 W2-1 (P0-9): per-file dedup window (in PreToolUse turns) for
+  // the narrow hint. Same (file_path, stable_id) tuple stays silent for this
+  // many turns even when the E3 cross-session cache would otherwise re-emit.
+  // Closes the rc.32 eval finding that a single hot file (e.g. werewolf
+  // GameRoom.tsx edited 30 times in a row) re-fired the same narrow hint
+  // each time, training the agent to ignore it. Default 5; range 1..50.
+  // Storage: .fabric/.cache/narrow-dedup-window.json — distinct from session-
+  // hints cache so a window-only suppression does not poison cross-session
+  // dedupe semantics.
+  hint_narrow_dedup_window_turns: z5.number().int().min(1).max(50).optional().default(5),
+  // v2.0.0-rc.33 W2-5 (P1-8): cooldown between broad SessionStart hint emits,
+  // in hours. Distinct from the archive_hint_cooldown_hours that gates the
+  // fabric-hint Stop hook — knowledge-hint-broad re-fires on every
+  // SessionStart by default (compact / clear / new-window), which on long
+  // sessions becomes redundant noise. Setting to 1 means "emit the broad
+  // menu at most once per hour"; 0 means "no cooldown, current behavior."
+  // Range 0..168 (one week). Stored alongside fabric-hint's cooldown cache
+  // under a distinct knowledge-hint-broad key.
+  hint_broad_cooldown_hours: z5.number().int().min(0).max(168).optional().default(0),
+  // v2.0.0-rc.33 W2-5 (P1-8): cooldown for the narrow PreToolUse hint.
+  // Same shape as hint_broad_cooldown_hours but applies to per-Edit hint
+  // re-emission across the cooldown window — independent of E3 session-
+  // hints dedupe. Default 0 preserves rc.32 behavior; set to e.g. 1 to
+  // throttle hint frequency during rapid-fire editing sprints. Range
+  // 0..168 (one week).
+  hint_narrow_cooldown_hours: z5.number().int().min(0).max(168).optional().default(0),
+  // v2.0.0-rc.33 W4-B3 (T5 P2): per-maturity inactivity thresholds (days)
+  // driving orphan_demote. Hardcoded at stable=90/endorsed=30/draft=14 in
+  // rc.32; chatty workspaces want them tighter, slow ones want them looser.
+  // Each field optional; absent → defaults inside doctor.ts apply. Ranges
+  // chosen so a typo can't accidentally disable the lint (min 1).
+  orphan_demote_stable_days: z5.number().int().min(1).max(3650).optional(),
+  orphan_demote_endorsed_days: z5.number().int().min(1).max(3650).optional(),
+  orphan_demote_draft_days: z5.number().int().min(1).max(3650).optional(),
+  // v2.0.0-rc.33 W4-A3 (T4 P2): per-entry summary truncation length used by
+  // knowledge-hint-{broad,narrow}.cjs. Hard-coded at 80 chars in rc.32 — too
+  // short for entries with parameterized summaries (e.g. "Use bcrypt with
+  // cost=12 for password hashing"), too long for terse pitfalls. Range 40..240;
+  // default 80 preserves rc.32 behavior. Both hooks read the same key so the
+  // banner styling stays consistent across SessionStart + PreToolUse.
+  hint_summary_max_len: z5.number().int().min(40).max(240).optional().default(80),
+  // v2.0.0-rc.33 W2-6 (P0-7 + P0-8): when true, knowledge-hint hooks emit
+  // their banners as `hookSpecificOutput.additionalContext` JSON on stdout
+  // (per Claude Code PreToolUse hook contract — see
+  // https://docs.claude.com/en/docs/claude-code/hooks#preToolUse), so the
+  // agent receives them in-context instead of as stderr breadcrumbs the
+  // user may not surface to the model. Default true reflects the rc.33 cite-
+  // coverage focus (rc.32 baseline 3.1% → primary cause: reminders never
+  // entered model context). Set false to revert to legacy stderr-only mode
+  // for hosts that don't honor the JSON contract.
+  hint_reminder_to_context: z5.boolean().optional().default(true),
   // v2.0.0-rc.29 TASK-008 (BUG-F3): selection-token TTL override. The
   // `fab_plan_context` MCP tool hands clients a `selection_token` whose default
   // 5-minute lifetime (`SELECTION_TOKEN_TTL_MS` at

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-DkXJGQCD.js';
+export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-Crx0-0-9.js';
 import 'zod';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.30",
+  "version": "2.0.0-rc.33",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",