@fenglimg/fabric-cli 2.0.0-rc.21 → 2.0.0-rc.22

package/dist/{chunk-FNO7CQDG.js → chunk-PSVKSMRO.js}

@@ -9,7 +9,7 @@ import {
 // src/commands/scan.ts
 import { createHash } from "crypto";
 import { existsSync, readdirSync, readFileSync, statSync } from "fs";
-import { mkdir, readFile } from "fs/promises";
+import { mkdir, readFile, unlink } from "fs/promises";
 import { dirname, isAbsolute, join, resolve } from "path";
 import {
   KnowledgeIdAllocator,
@@ -25,6 +25,30 @@ var SCAN_STATE_FILE = ".scan-state.json";
 var FORENSIC_FILE = ".fabric/forensic.json";
 var AGENTS_META_FILE = ".fabric/agents.meta.json";
 var LAYER_REASON = "project artifact (deterministic init scan)";
+var KNOWN_BASELINE_IDS = /* @__PURE__ */ new Set([
+  "KT-MOD-0001",
+  // tech-stack
+  "KT-MOD-0002",
+  // module-structure
+  "KT-MOD-0003",
+  // readme-first-paragraph
+  "KT-PRO-0001",
+  // build-config
+  "KT-PRO-0002",
+  // ci-config (allocated after build-config in the deterministic order)
+  "KT-GLD-0001"
+  // code-style
+]);
+var KNOWN_BASELINE_SLUGS = /* @__PURE__ */ new Set([
+  "tech-stack",
+  "module-structure",
+  "build-config",
+  "code-style",
+  "ci-config",
+  "readme-first-paragraph",
+  "project-brief"
+]);
+var ID_PREFIXED_FILENAME_PATTERN = /^KT-[A-Z]+-\d+--.+\.md$/u;
 async function runInitScan(targetInput, options = {}) {
   const startTs = Date.now();
   const target = normalizeTarget(targetInput);
@@ -32,20 +56,20 @@ async function runInitScan(targetInput, options = {}) {
   if (!existsSync(forensicPath)) {
     throw new Error(t("cli.scan.error.missing-forensic", { path: forensicPath }));
   }
+  await migrateLegacyBaselineFilenames(target);
   const forensic = await readForensic(forensicPath);
   const nowIso = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
-  const tags = deriveTagsFromForensic(forensic);
   const fabricConfig = readFabricConfig(target);
   const fabricLanguage = fabricConfig.fabric_language ?? "match-existing";
   const resolvedLanguage = resolveFabricLanguage(fabricLanguage, target);
   const candidates = [
-    buildTechStackEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildModuleStructureEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildBuildConfigEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildCodeStyleEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildCIConfigEntry(forensic, nowIso, tags),
-    buildReadmeFirstParaEntry(target, forensic, nowIso, tags, resolvedLanguage),
-    buildProjectBriefEntry(target, forensic, nowIso, tags)
+    buildTechStackEntry(forensic, nowIso, resolvedLanguage),
+    buildModuleStructureEntry(forensic, nowIso, resolvedLanguage),
+    buildBuildConfigEntry(forensic, nowIso, resolvedLanguage),
+    buildCodeStyleEntry(forensic, nowIso, resolvedLanguage),
+    buildCIConfigEntry(forensic, nowIso),
+    buildReadmeFirstParaEntry(target, forensic, nowIso, resolvedLanguage),
+    buildProjectBriefEntry(target, forensic, nowIso)
   ];
   const entries = candidates.filter((e) => e !== null);
   const sidecarPath = join(target, KNOWLEDGE_DIR, SCAN_STATE_FILE);
@@ -55,11 +79,12 @@ async function runInitScan(targetInput, options = {}) {
   const skipped = [];
   const placedEntries = [];
   for (const entry of entries) {
-    const targetPath = join(target, KNOWLEDGE_DIR, entry.target_subdir, `${entry.slug}.md`);
-    const existingId = findExistingIdForFile(sidecar, targetPath, target);
+    const subdirAbs = join(target, KNOWLEDGE_DIR, entry.target_subdir);
+    const existingId = findExistingIdBySlug(sidecar, subdirAbs, entry.slug);
     const id = existingId ?? await allocator.allocate(entry.layer, entry.type);
     const built = { ...entry, id };
     placedEntries.push(built);
+    const targetPath = join(subdirAbs, `${id}--${entry.slug}.md`);
     const fullContent = renderMarkdown(built);
     const bodyHash = sha256(stripFrontmatter(fullContent));
     const sidecarKey = id;
@@ -303,7 +328,7 @@ function detectExistingLanguage(target) {
   const ratio = cjkCount / denominator;
   return ratio > ZH_CN_RATIO_THRESHOLD ? "zh-CN-hybrid" : "en";
 }
-function buildTechStackEntry(forensic, nowIso, tags, language = "en") {
+function buildTechStackEntry(forensic, nowIso, language = "en") {
   const framework = forensic.framework;
   const byExt = forensic.topology.by_ext ?? {};
   const topExtensions = Object.entries(byExt).sort(([, a], [, b]) => b - a).slice(0, 5).map(([ext, count]) => `${ext} (${count})`);
@@ -330,12 +355,12 @@ function buildTechStackEntry(forensic, nowIso, tags, language = "en") {
     body,
     target_subdir: "models",
     slug: "tech-stack",
-    tags,
+    tags: [],
     relevance_scope: "narrow",
     relevance_paths: relevancePaths
   };
 }
-function buildModuleStructureEntry(forensic, nowIso, tags, language = "en") {
+function buildModuleStructureEntry(forensic, nowIso, language = "en") {
   const keyDirs = forensic.topology.key_dirs ?? [];
   const entryPoints = forensic.entry_points ?? [];
   const totalFiles = forensic.topology.total_files ?? 0;
@@ -361,12 +386,12 @@ function buildModuleStructureEntry(forensic, nowIso, tags, language = "en") {
     body,
     target_subdir: "models",
     slug: "module-structure",
-    tags,
+    tags: [],
     relevance_scope: "narrow",
     relevance_paths: relevancePaths
   };
 }
-function buildBuildConfigEntry(forensic, nowIso, tags, language = "en") {
+function buildBuildConfigEntry(forensic, nowIso, language = "en") {
   const configFiles = (forensic.candidate_files ?? []).filter((entry) => entry.family === "config").map((entry) => entry.path);
   const framework = forensic.framework.kind;
   const configBlock = configFiles.length > 0 ? configFiles.map((file) => `- ${file}`).join("\n") : "- (no config files detected)";
@@ -389,12 +414,12 @@ function buildBuildConfigEntry(forensic, nowIso, tags, language = "en") {
     body,
     target_subdir: "processes",
     slug: "build-config",
-    tags,
+    tags: [],
     relevance_scope: "narrow",
     relevance_paths: relevancePaths
   };
 }
-function buildCodeStyleEntry(forensic, nowIso, tags, language = "en") {
+function buildCodeStyleEntry(forensic, nowIso, language = "en") {
   const dominantPatterns = (forensic.assertions ?? []).filter((a) => a.type === "pattern" || a.type === "domain").slice(0, 4).map((a) => `- ${a.statement}`);
   const proposedRules = (forensic.assertions ?? []).map((a) => a.proposed_rule).filter((rule) => typeof rule === "string" && rule.length > 0).slice(0, 4);
   const patternsBlock = dominantPatterns.length > 0 ? dominantPatterns.join("\n") : "- (no dominant patterns detected)";
@@ -424,12 +449,12 @@ function buildCodeStyleEntry(forensic, nowIso, tags, language = "en") {
     body,
     target_subdir: "guidelines",
     slug: "code-style",
-    tags,
+    tags: [],
     relevance_scope: "narrow",
     relevance_paths: relevancePaths
   };
 }
-function buildCIConfigEntry(forensic, nowIso, tags) {
+function buildCIConfigEntry(forensic, nowIso) {
   const ciFiles = (forensic.candidate_files ?? []).map((entry) => entry.path).filter((path) => isCIConfigPath(path));
   const ciExtensions = forensic.topology.by_ext ?? {};
   const hasCISignal = ciFiles.length > 0 || Object.keys(ciExtensions).some((ext) => ext === ".yml" || ext === ".yaml") && (forensic.assertions ?? []).some((a) => /ci|workflow|pipeline/i.test(a.statement));
@@ -466,12 +491,12 @@ function buildCIConfigEntry(forensic, nowIso, tags) {
     body,
     target_subdir: "processes",
     slug: "ci-config",
-    tags,
+    tags: [],
     relevance_scope: "narrow",
     relevance_paths: relevancePaths
   };
 }
-function buildReadmeFirstParaEntry(target, forensic, nowIso, tags, language = "en") {
+function buildReadmeFirstParaEntry(target, forensic, nowIso, language = "en") {
   if (forensic.readme.quality === "missing") {
     return null;
   }
@@ -501,7 +526,7 @@ function buildReadmeFirstParaEntry(target, forensic, nowIso, tags, language = "e
     body,
     target_subdir: "models",
     slug: "readme-first-paragraph",
-    tags,
+    tags: [],
     // v2.0-rc.7 T2: broad by design — single repo-root file, the Phase 1.5
     // PreToolUse blacklist already covers README. Anchoring this entry to
     // README.md would surface it on every README edit, which is noise.
@@ -509,7 +534,7 @@ function buildReadmeFirstParaEntry(target, forensic, nowIso, tags, language = "e
     relevance_paths: []
   };
 }
-function buildProjectBriefEntry(target, forensic, nowIso, tags) {
+function buildProjectBriefEntry(target, forensic, nowIso) {
   if (forensic.readme.quality === "missing") {
     return null;
   }
@@ -541,7 +566,7 @@ function buildProjectBriefEntry(target, forensic, nowIso, tags) {
     body,
     target_subdir: "models",
     slug: "project-brief",
-    tags,
+    tags: [],
     // v2.0-rc.7 T2: broad — project brief is a cross-cutting description
     // with no path anchor. Narrowing it to README.md would duplicate the
     // readme-first-paragraph surface; keeping it broad lets the
@@ -603,47 +628,6 @@ function quoteIfNeeded(value) {
 function stripFrontmatter(content) {
   return content.replace(/^---[\s\S]*?\r?\n---\s*\r?\n?/u, "");
 }
-function deriveTagsFromForensic(forensic) {
-  const MAX_TAGS = 5;
-  const seen = /* @__PURE__ */ new Set();
-  const tags = [];
-  function add(raw) {
-    const normalized = raw.toLowerCase().trim().replace(/\s+/gu, "-");
-    if (normalized.length > 0 && !seen.has(normalized)) {
-      seen.add(normalized);
-      tags.push(normalized);
-    }
-  }
-  if (forensic.framework.kind) {
-    add(forensic.framework.kind);
-  }
-  const SKIP_EXTS = /* @__PURE__ */ new Set([".json", ".md", ".lock", ".yaml", ".yml", ".txt", ".env"]);
-  const EXT_MAP = {
-    ".ts": "typescript",
-    ".tsx": "typescript",
-    ".js": "javascript",
-    ".jsx": "javascript",
-    ".mjs": "javascript",
-    ".cjs": "javascript",
-    ".py": "python",
-    ".go": "go",
-    ".rs": "rust",
-    ".java": "java",
-    ".cs": "csharp",
-    ".rb": "ruby",
-    ".php": "php",
-    ".swift": "swift",
-    ".kt": "kotlin"
-  };
-  const byExt = forensic.topology.by_ext ?? {};
-  const sorted = Object.entries(byExt).filter(([ext]) => !SKIP_EXTS.has(ext)).sort(([, a], [, b]) => b - a);
-  for (const [ext] of sorted) {
-    if (tags.length >= MAX_TAGS) break;
-    const mapped = EXT_MAP[ext] ?? ext.replace(/^\./u, "");
-    add(mapped);
-  }
-  return tags.slice(0, MAX_TAGS);
-}
 async function readForensic(forensicPath) {
   const raw = await readFile(forensicPath, "utf8");
   return JSON.parse(raw);
@@ -669,29 +653,143 @@ async function readScanState(sidecarPath) {
     return {};
   }
 }
-function findExistingIdForFile(sidecar, targetPath, target) {
-  if (!existsSync(targetPath)) {
+async function migrateLegacyBaselineFilenames(target) {
+  const knowledgeRoot = join(target, KNOWLEDGE_DIR);
+  if (!existsSync(knowledgeRoot)) {
+    return { migrated: [] };
+  }
+  const migrated = [];
+  const subdirs = ["models", "guidelines", "processes"];
+  for (const sub of subdirs) {
+    const subdirPath = join(knowledgeRoot, sub);
+    if (!existsSync(subdirPath)) continue;
+    let entries;
+    try {
+      entries = readdirSync(subdirPath);
+    } catch {
+      continue;
+    }
+    for (const name of entries) {
+      if (!name.endsWith(".md")) continue;
+      if (ID_PREFIXED_FILENAME_PATTERN.test(name)) {
+        const idMatch = /^(KT-[A-Z]+-\d+)--(.+)\.md$/u.exec(name);
+        if (idMatch === null) continue;
+        const [, fileId, fileSlug] = idMatch;
+        if (!KNOWN_BASELINE_IDS.has(fileId)) continue;
+        if (!KNOWN_BASELINE_SLUGS.has(fileSlug)) continue;
+        const onDiskPath = join(subdirPath, name);
+        let onDiskRaw;
+        try {
+          onDiskRaw = readFileSync(onDiskPath, "utf8");
+        } catch {
+          continue;
+        }
+        const scrubbed = stripStaleTagsLine(onDiskRaw);
+        if (scrubbed !== onDiskRaw) {
+          await atomicWriteText(onDiskPath, scrubbed);
+        }
+        continue;
+      }
+      const bareSlug = name.slice(0, -".md".length);
+      if (!KNOWN_BASELINE_SLUGS.has(bareSlug)) continue;
+      const oldPath = join(subdirPath, name);
+      let raw;
+      try {
+        raw = readFileSync(oldPath, "utf8");
+      } catch {
+        continue;
+      }
+      const id = extractFrontmatterId(raw);
+      if (id === null || !KNOWN_BASELINE_IDS.has(id)) continue;
+      const newName = `${id}--${bareSlug}.md`;
+      const newPath = join(subdirPath, newName);
+      const cleanedRaw = stripStaleTagsLine(raw);
+      if (existsSync(newPath)) {
+        try {
+          await unlink(oldPath);
+        } catch {
+        }
+        continue;
+      }
+      await atomicWriteText(newPath, cleanedRaw);
+      try {
+        await unlink(oldPath);
+      } catch {
+      }
+      migrated.push({ from: oldPath, to: newPath, id });
+    }
+  }
+  return { migrated };
+}
+function stripStaleTagsLine(raw) {
+  const fmMatch = /^(---\r?\n)([\s\S]*?)(\r?\n---\s*(?:\r?\n|$))/u.exec(raw);
+  if (fmMatch === null) return raw;
+  const head = fmMatch[1];
+  const body = fmMatch[2];
+  const tail = fmMatch[3];
+  const rest = raw.slice(fmMatch[0].length);
+  const flowPattern = /^tags:[ \t]*\[[^\n]*\][ \t]*$/mu;
+  if (flowPattern.test(body)) {
+    const replaced = body.replace(flowPattern, "tags: []");
+    return `${head}${replaced}${tail}${rest}`;
+  }
+  const blockPattern = /^tags:[ \t]*\r?\n(?:[ \t]+-[ \t]+.+\r?\n?)+/mu;
+  if (blockPattern.test(body)) {
+    const replaced = body.replace(blockPattern, "tags: []\n");
+    return `${head}${replaced.replace(/\n{2,}$/u, "\n")}${tail}${rest}`;
+  }
+  const barePattern = /^tags:[ \t]*$/mu;
+  if (barePattern.test(body)) {
+    const replaced = body.replace(barePattern, "tags: []");
+    return `${head}${replaced}${tail}${rest}`;
+  }
+  return raw;
+}
+function extractFrontmatterId(raw) {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---/u.exec(raw);
+  if (match === null) return null;
+  const idLine = /^id:\s*(.+)$/mu.exec(match[1]);
+  if (idLine === null) return null;
+  return idLine[1].replace(/^["'](.*)["']$/u, "$1").trim();
+}
+function findExistingIdBySlug(sidecar, subdirAbs, slug) {
+  if (!existsSync(subdirAbs)) {
     return null;
   }
+  let entries;
   try {
-    const raw = readFileSync(targetPath, "utf8");
-    const match = /^---\r?\n([\s\S]*?)\r?\n---/u.exec(raw);
-    if (match === null) {
-      return null;
-    }
-    const idLine = /^id:\s*(.+)$/mu.exec(match[1]);
-    if (idLine === null) {
+    entries = readdirSync(subdirAbs);
+  } catch {
+    return null;
+  }
+  const escapedSlug = slug.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+  const pattern = new RegExp(`^(KT-[A-Z]+-\\d+)--${escapedSlug}\\.md$`, "u");
+  const matches = [];
+  for (const name of entries) {
+    const m = pattern.exec(name);
+    if (m === null) continue;
+    matches.push({ id: m[1], file: name });
+  }
+  if (matches.length !== 1) {
+    return null;
+  }
+  const filenameId = matches[0].id;
+  try {
+    const raw = readFileSync(join(subdirAbs, matches[0].file), "utf8");
+    const frontmatterId = extractFrontmatterId(raw);
+    if (frontmatterId !== filenameId) {
       return null;
     }
-    const candidate = idLine[1].replace(/^["'](.*)["']$/u, "$1").trim();
-    if (/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/.test(candidate) && sidecar[candidate] !== void 0) {
-      return candidate;
-    }
-    return null;
   } catch {
-    void target;
     return null;
   }
+  if (!/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/u.test(filenameId)) {
+    return null;
+  }
+  if (sidecar[filenameId] === void 0) {
+    return null;
+  }
+  return filenameId;
 }
 function isCIConfigPath(path) {
   return path.startsWith(".github/workflows/") || path.startsWith(".gitlab-ci") || path === "azure-pipelines.yml" || path === ".circleci/config.yml" || path === "Jenkinsfile" || path === ".travis.yml";
@@ -759,7 +857,7 @@ async function registerKnowledgeNodesInMeta(target, entries) {
   }
   const nodes = typeof meta.nodes === "object" && meta.nodes !== null ? meta.nodes : {};
   for (const entry of entries) {
-    const contentRef = `${KNOWLEDGE_DIR}/${entry.target_subdir}/${entry.slug}.md`;
+    const contentRef = `${KNOWLEDGE_DIR}/${entry.target_subdir}/${entry.id}--${entry.slug}.md`;
     const absPath = join(target, contentRef);
     let hash = "";
     try {

package/dist/{doctor-L6TIXXIX.js → doctor-HIX2FFEP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runInitScan
-} from "./chunk-FNO7CQDG.js";
+} from "./chunk-PSVKSMRO.js";
 import {
   hasActionHint,
   paint,

package/dist/index.js

@@ -11,19 +11,19 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-DNZXGFHJ.js").then((module) => module.default),
-  doctor: () => import("./doctor-L6TIXXIX.js").then((module) => module.default),
+  install: () => import("./install-WJZQZM7D.js").then((module) => module.default),
+  doctor: () => import("./doctor-HIX2FFEP.js").then((module) => module.default),
   serve: () => import("./serve-6PPQX7AW.js").then((module) => module.default),
   uninstall: () => import("./uninstall-L2HEEOU3.js").then((module) => module.default),
   config: () => import("./config-AYP5F72E.js").then((module) => module.default),
-  "plan-context-hint": () => import("./plan-context-hint-CFDGXHCA.js").then((module) => module.default)
+  "plan-context-hint": () => import("./plan-context-hint-RYVSMULL.js").then((module) => module.default)
 };
 
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.0-rc.21",
+    version: "2.0.0-rc.22",
     description: t("cli.main.description")
   },
   subCommands: allCommands

package/dist/{install-DNZXGFHJ.js → install-WJZQZM7D.js}

@@ -5,7 +5,7 @@ import {
 import {
   detectExistingLanguage,
   runInitScan
-} from "./chunk-FNO7CQDG.js";
+} from "./chunk-PSVKSMRO.js";
 import {
   installArchiveHintHook,
   installFabricArchiveSkill,
@@ -1299,7 +1299,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.0.0-rc.21" : "unknown";
+  return true ? "2.0.0-rc.22" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));

package/dist/{plan-context-hint-CFDGXHCA.js → plan-context-hint-RYVSMULL.js}

@@ -72,13 +72,20 @@ async function runPlanContextHint(opts) {
     maturity: item.maturity ?? item.description.maturity ?? "",
     summary: item.description.summary
   }));
-  return {
+  const output = {
     version: 2,
     revision_hash: result.revision_hash,
     target_paths: targetPaths,
     entries,
     broad_count: sharedIndex.length
   };
+  if (result.auto_healed === true) {
+    output.auto_healed = true;
+    if (typeof result.previous_revision_hash === "string") {
+      output.previous_revision_hash = result.previous_revision_hash;
+    }
+  }
+  return output;
 }
 function parsePathsArg(raw) {
   if (raw === void 0 || raw.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.0.0-rc.21",
+  "version": "2.0.0-rc.22",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -20,8 +20,8 @@
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "2.0.0-rc.21",
-    "@fenglimg/fabric-shared": "2.0.0-rc.21"
+    "@fenglimg/fabric-server": "2.0.0-rc.22",
+    "@fenglimg/fabric-shared": "2.0.0-rc.22"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/templates/hooks/knowledge-hint-broad.cjs

@@ -476,6 +476,46 @@ function renderSummary(payload) {
   if (revHash !== null && revHash.length > 0) {
     lines.push(`  revision_hash: ${revHash}`);
   }
+
+  // rc.22 Scope D T-D4 (TASK-011): meta auto-refresh breadcrumb. Emitted ONLY
+  // when the server's planContext() detected meta drift and rebuilt the meta
+  // in-place (auto_healed === true). One informational line — operators need
+  // a paper trail when revision_hash flips mid-session.
+  //
+  // Variant resolution:
+  //   - Both hashes present → full transition line (`sha PREV → CUR`) with
+  //     8-char hex prefixes stripped of the `sha256:` scheme prefix.
+  //   - auto_healed:true but previous_revision_hash missing → generic line
+  //     (T10 noted the server may emit `auto_healed:true` alone if it lost
+  //     the prior hash for any reason). Stays informational.
+  //
+  // i18n: routed through renderBanner so zh-CN / en / zh-CN-hybrid variants
+  // share one call site. fabric_language is resolved via readFabricLanguage()
+  // ONLY when the line is actually emitted (keeps the no-banner path free of
+  // the extra config read, matching the broadImportBanner site below).
+  if (payload.auto_healed === true) {
+    const variant = readFabricLanguage(process.cwd());
+    const prevRaw =
+      typeof payload.previous_revision_hash === "string"
+        ? payload.previous_revision_hash
+        : null;
+    const curRaw =
+      typeof payload.revision_hash === "string" ? payload.revision_hash : null;
+    if (prevRaw && curRaw) {
+      // Strip optional `sha256:` scheme prefix, then take first 8 hex chars.
+      const stripScheme = (h) =>
+        h.startsWith("sha256:") ? h.slice("sha256:".length) : h;
+      const prev = stripScheme(prevRaw).slice(0, 8);
+      const cur = stripScheme(curRaw).slice(0, 8);
+      lines.push(
+        renderBanner("metaAutoRefreshedBanner", variant, { prev, cur }),
+      );
+    } else {
+      // Defensive: auto_healed:true but no usable previous hash → generic line.
+      lines.push(renderBanner("metaAutoRefreshedBannerGeneric", variant, {}));
+    }
+  }
+
   lines.push("  Use `fab_get_knowledge_sections` to fetch full content.");
   return lines;
 }

package/templates/hooks/lib/banner-i18n.cjs

@@ -223,6 +223,36 @@ const STRINGS = {
     "zh-CN-hybrid": () =>
       "  📋 Fabric: 知识库稀疏，是否调 /fabric-import 从 git 历史与现有文档回灌知识?",
   },
+
+  // ---- Broad hook: meta auto-refresh breadcrumb (rc.22 Scope D T-D4) -------
+  // Surfaced ONLY when planContext() detected meta drift and rebuilt the meta
+  // in-place (server emits `auto_healed: true` in plan-context-hint payload).
+  // Single informational line — operators need a breadcrumb when meta auto-
+  // heals so a "why did revision change?" question has a paper trail.
+  //
+  // Two render shapes:
+  //   - metaAutoRefreshedBanner: full transition with prev → cur 8-char hash
+  //     prefixes. Used when both previous_revision_hash + revision_hash present.
+  //   - metaAutoRefreshedBannerGeneric: defensive fallback when the server
+  //     emitted `auto_healed: true` but did not include previous_revision_hash
+  //     (T10 noted this edge case). No hash transition shown.
+  //
+  // Note: 🔄 emoji prefix is intentional (matches the project's general "no
+  // emoji" rule's exception for explicit user request — see TASK-011 description).
+  // params: { prev, cur } — both already 8-char hex strings, caller-supplied.
+  metaAutoRefreshedBanner: {
+    "zh-CN": (p) => `  🔄 Fabric: 元数据已自动刷新(sha ${p.prev} → ${p.cur})`,
+    en: (p) => `  🔄 Fabric: meta auto-refreshed (sha ${p.prev} → ${p.cur})`,
+    "zh-CN-hybrid": (p) => `  🔄 Fabric: 元数据已自动刷新(sha ${p.prev} → ${p.cur})`,
+  },
+
+  // Generic variant — no hash transition. Used when auto_healed:true but
+  // previous_revision_hash is missing from the payload.
+  metaAutoRefreshedBannerGeneric: {
+    "zh-CN": () => "  🔄 Fabric: 元数据已自动刷新",
+    en: () => "  🔄 Fabric: meta auto-refreshed",
+    "zh-CN-hybrid": () => "  🔄 Fabric: 元数据已自动刷新",
+  },
 };
 
 /**