@fenglimg/fabric-cli 2.0.0-rc.34 → 2.0.0-rc.35

package/README.md

@@ -1,6 +1,6 @@
 # @fenglimg/fabric-cli
 
-`fabric` 是 Fabric 的主命令，`fab` 是永久别名，两者等价。
+`fabric` 是 Fabric 的 CLI 主命令。
 
 ## 快速开始
 

package/dist/{chunk-SRX7WZUG.js → chunk-BATF4PEJ.js}

@@ -107,7 +107,7 @@ var dismissSlotCmd = defineCommand({
       const next = [...optedOut, slot];
       const merged = { ...config, onboard_slots_opted_out: next };
       await atomicWriteJson(configPath, merged);
-      console.log(`Dismissed onboard slot "${slot}". Run \`fab config onboard-reset ${slot}\` to re-open.`);
+      console.log(`Dismissed onboard slot "${slot}". Run \`fabric config onboard-reset ${slot}\` to re-open.`);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(`dismiss-slot failed: ${message}`);
@@ -153,7 +153,7 @@ var onboardResetCmd = defineCommand({
       const next = optedOut.filter((s) => s !== slot);
       const merged = { ...config, onboard_slots_opted_out: next };
       await atomicWriteJson(configPath, merged);
-      console.log(`Reset onboard slot "${slot}"; it will appear in \`fab onboard-coverage\` as missing again.`);
+      console.log(`Reset onboard slot "${slot}"; it will appear in \`fabric onboard-coverage\` as missing again.`);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(`onboard-reset failed: ${message}`);

package/dist/{chunk-5N3KXIVI.js → chunk-XVS4F3P6.js}

@@ -76,6 +76,10 @@ var SKILL_DESTINATIONS = {
     ".codex/skills/fabric-import/SKILL.md"
   ]
 };
+var DEPRECATED_SKILL_DIRS = [
+  ".claude/skills/fabric-init",
+  ".codex/skills/fabric-init"
+];
 var HOOK_SCRIPT_DESTINATIONS = {
   fabricHint: [
     ".claude/hooks/fabric-hint.cjs",
@@ -223,6 +227,33 @@ async function installFabricImportSkill(projectRoot, _options = {}) {
   results.push(...await installSkillRefFiles(projectRoot, "fabric-import"));
   return results;
 }
+async function cleanupDeprecatedSkills(projectRoot) {
+  const results = [];
+  for (const rel of DEPRECATED_SKILL_DIRS) {
+    const target = join2(projectRoot, rel);
+    if (!existsSync2(target)) {
+      results.push({ step: "skill-deprecated-cleanup", path: target, status: "skipped", message: "absent" });
+      continue;
+    }
+    try {
+      await rm(target, { recursive: true, force: true });
+      results.push({
+        step: "skill-deprecated-cleanup",
+        path: target,
+        status: "written",
+        message: "removed-deprecated"
+      });
+    } catch (error) {
+      results.push({
+        step: "skill-deprecated-cleanup",
+        path: target,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return results;
+}
 async function installSkillRefFiles(projectRoot, skillSlug) {
   let refTemplateDir;
   try {
@@ -790,6 +821,7 @@ export {
   installFabricArchiveSkill,
   installFabricReviewSkill,
   installFabricImportSkill,
+  cleanupDeprecatedSkills,
   installArchiveHintHook,
   installKnowledgeHintBroadHook,
   installKnowledgeHintNarrowHook,

package/dist/{config-5CH4EJQ2.js → config-XJIPZNUP.js}

@@ -3,7 +3,7 @@ import {
   configCmd,
   config_default,
   installMcpClients
-} from "./chunk-SRX7WZUG.js";
+} from "./chunk-BATF4PEJ.js";
 import "./chunk-MF3OTILQ.js";
 import "./chunk-PWLW3B57.js";
 export {

package/dist/{doctor-E26YO67D.js → doctor-2FCRAWDZ.js}

@@ -72,6 +72,16 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.yes.description"),
       default: false
     },
+    // rc.35 TASK-12 (P0-11): expose maintainer-audience actionHints. By
+    // default the renderer folds remediation strings that target Fabric
+    // contributors (edit `packages/cli/templates/...`, interpret G1-G5
+    // cite-goodhart codes, etc.) since npm end users have no actionable
+    // lever for them. --verbose shows them.
+    verbose: {
+      type: "boolean",
+      description: t("cli.doctor.args.verbose.description"),
+      default: false
+    },
     // rc.20 TASK-05: cite policy adherence report (read-only). Skips standard
     // inspections entirely — different output surface. Mutually exclusive
     // with --fix / --fix-knowledge (enforced in run()).
@@ -284,7 +294,7 @@ var doctorCommand = defineCommand({
       } else if (fix && args["dry-run"] === true) {
         writeStdout(dt("cli.doctor.fix-dry-run-banner"));
       }
-      renderHumanReport(report, dt);
+      renderHumanReport(report, dt, args.verbose === true);
     }
     await emitDoctorRunEventBestEffort(resolution.target, {
       mode: fixKnowledge ? "fix-knowledge" : "lint",
@@ -307,14 +317,15 @@ var doctorCommand = defineCommand({
   }
 });
 var doctor_default = doctorCommand;
-function renderHumanReport(report, dt) {
+function renderHumanReport(report, dt, verbose) {
   writeStdout(`${renderStatus(report.status)} ${paint.ai("fabric doctor")} ${paint.human(report.summary.target)}`);
   for (const check of report.checks) {
     writeStdout(`${renderStatus(check.status)} ${check.name}: ${check.message}`);
   }
-  writeIssueSection(dt("doctor.section.fixable"), report.fixable_errors);
-  writeIssueSection(dt("doctor.section.manual"), report.manual_errors);
-  writeIssueSection(dt("doctor.section.warnings"), report.warnings);
+  const opts = { verbose, dt };
+  writeIssueSection(dt("doctor.section.fixable"), report.fixable_errors, opts);
+  writeIssueSection(dt("doctor.section.manual"), report.manual_errors, opts);
+  writeIssueSection(dt("doctor.section.warnings"), report.warnings, opts);
   renderPayloadLimits(report, dt);
 }
 function renderPayloadLimits(report, dt) {
@@ -344,7 +355,7 @@ function renderFixKnowledgeMutations(fixKnowledgeReport, dt) {
     writeStdout(`${marker} ${mutation.kind}: ${mutation.path} [${mutation.detail}]${errSuffix}`);
   }
 }
-function writeIssueSection(title, issues) {
+function writeIssueSection(title, issues, options) {
   if (issues.length === 0) {
     return;
   }
@@ -353,7 +364,11 @@ function writeIssueSection(title, issues) {
   for (const issue of issues) {
     writeStdout(`- ${issue.code}: ${issue.message}`);
     if (issue.actionHint !== void 0 && issue.actionHint.length > 0) {
-      writeStdout(`  \u2192 ${issue.actionHint}`);
+      if (issue.audience === "maintainer" && !options.verbose) {
+        writeStdout(`  \u2192 ${options.dt("doctor.maintainer-hint-folded")}`);
+      } else {
+        writeStdout(`  \u2192 ${issue.actionHint}`);
+      }
     }
   }
 }
@@ -600,7 +615,7 @@ function appendContractSection(lines, report, dt) {
   }
 }
 function renderEnrichDescriptionsReport(report, dt) {
-  const header = `${symbol.ok} ${paint.ai("fab doctor --enrich-descriptions")} mode=${report.mode}${report.dryRun ? " (dry-run)" : ""} scanned=${report.scanned} modified=${report.modified} skipped=${report.skipped}`;
+  const header = `${symbol.ok} ${paint.ai("fabric doctor --enrich-descriptions")} mode=${report.mode}${report.dryRun ? " (dry-run)" : ""} scanned=${report.scanned} modified=${report.modified} skipped=${report.skipped}`;
   writeStdout(header);
   if (report.candidates.length === 0) {
     writeStdout(dt("doctor.enrich.allComplete"));

package/dist/index.js

@@ -11,22 +11,22 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-XCRX34CX.js").then((module) => module.default),
-  doctor: () => import("./doctor-E26YO67D.js").then((module) => module.default),
+  install: () => import("./install-HOTE5BPA.js").then((module) => module.default),
+  doctor: () => import("./doctor-2FCRAWDZ.js").then((module) => module.default),
   serve: () => import("./serve-43JTEM3U.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-Q7V55BXH.js").then((module) => module.default),
-  config: () => import("./config-5CH4EJQ2.js").then((module) => module.default),
-  "plan-context-hint": () => import("./plan-context-hint-CXTLNVSV.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-BIJ5GLEU.js").then((module) => module.default),
+  config: () => import("./config-XJIPZNUP.js").then((module) => module.default),
+  "plan-context-hint": () => import("./plan-context-hint-UQLRKGBZ.js").then((module) => module.default),
   // v2.0.0-rc.23 TASK-014 (F8c): S5 onboard-slot coverage. Used by the
   // fabric-archive Skill's first-run phase to detect unclaimed slots.
-  "onboard-coverage": () => import("./onboard-coverage-6MN3CYHT.js").then((module) => module.default)
+  "onboard-coverage": () => import("./onboard-coverage-MFCAEBDO.js").then((module) => module.default)
 };
 
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.0-rc.34",
+    version: "2.0.0-rc.35",
     description: t("cli.main.description")
   },
   subCommands: allCommands

package/dist/{install-XCRX34CX.js → install-HOTE5BPA.js}

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   installMcpClients
-} from "./chunk-SRX7WZUG.js";
+} from "./chunk-BATF4PEJ.js";
 import {
+  cleanupDeprecatedSkills,
   installArchiveHintHook,
   installCitePolicyEvictHook,
   installFabricArchiveSkill,
@@ -19,7 +20,7 @@ import {
   writeCodexBootstrapManagedBlock,
   writeCursorBootstrapManagedBlock,
   writeFabricAgentsSnapshot
-} from "./chunk-5N3KXIVI.js";
+} from "./chunk-XVS4F3P6.js";
 import {
   detectClientSupports
 } from "./chunk-MF3OTILQ.js";
@@ -342,7 +343,7 @@ async function buildForensicReport(targetInput) {
   const report = {
     version: "1.0",
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
-    generated_by: `fab-cli@${getCliVersion()}`,
+    generated_by: `fabric-cli@${getCliVersion()}`,
     target,
     project_name: readProjectName(target),
     framework,
@@ -1350,7 +1351,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.0.0-rc.34" : "unknown";
+  return true ? "2.0.0-rc.35" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -1387,6 +1388,11 @@ var installCommand = defineCommand({
       type: "boolean",
       description: t("cli.install.args.yes.description"),
       default: false
+    },
+    "force-skills-only": {
+      type: "boolean",
+      description: t("cli.install.args.force-skills-only.description"),
+      default: false
     }
   },
   async run({ args }) {
@@ -1394,9 +1400,56 @@ var installCommand = defineCommand({
   }
 });
 var install_default = installCommand;
+async function runSkillsOnlyRefresh(targetInput) {
+  const target = normalizeTarget3(targetInput);
+  const metaPath = join4(target, ".fabric", "agents.meta.json");
+  if (!existsSync4(metaPath)) {
+    const message = t("cli.install.force-skills-only.uninitialised.message");
+    const hint = t("cli.install.force-skills-only.uninitialised.hint");
+    process.stderr.write(`${message}
+${hint}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(formatInitStageHeader(t("cli.install.force-skills-only.banner")));
+  const results = [];
+  results.push(...await cleanupDeprecatedSkills(target));
+  results.push(...await installFabricArchiveSkill(target));
+  results.push(...await installFabricReviewSkill(target));
+  results.push(...await installFabricImportSkill(target));
+  let written = 0;
+  let skipped = 0;
+  let errors = 0;
+  for (const r of results) {
+    if (r.status === "written") written += 1;
+    else if (r.status === "skipped") skipped += 1;
+    else if (r.status === "error") errors += 1;
+  }
+  console.log(
+    t("cli.install.force-skills-only.summary", {
+      written: String(written),
+      skipped: String(skipped),
+      errors: String(errors)
+    })
+  );
+  if (errors > 0) {
+    for (const r of results) {
+      if (r.status === "error") {
+        process.stderr.write(`  ${r.step} ${r.path}: ${r.message ?? "error"}
+`);
+      }
+    }
+    process.exitCode = 1;
+  }
+}
 async function runInitCommand(args) {
   const logger = createDebugLogger(args.debug);
   const resolution = resolveDevMode(args.target, process.cwd());
+  if (args["force-skills-only"] === true) {
+    await runSkillsOnlyRefresh(resolution.target);
+    return;
+  }
   const intent = resolveInitCliIntent(args, resolution.target);
   const fabricInitialized = existsSync4(join4(intent.target, ".fabric", "events.jsonl"));
   if (fabricInitialized) {
@@ -1850,6 +1903,7 @@ async function executeInitStagePlan(plan, stageName) {
     switch (stage.name) {
       case "bootstrap": {
         const installResults = [];
+        installResults.push(...await runBestEffort("skill-deprecated-cleanup", () => cleanupDeprecatedSkills(plan.target)));
         installResults.push(...await runBestEffort("skill-install", () => installFabricArchiveSkill(plan.target)));
         installResults.push(...await runBestEffort("skill-review-install", () => installFabricReviewSkill(plan.target)));
         installResults.push(...await runBestEffort("skill-import-install", () => installFabricImportSkill(plan.target)));
@@ -2402,5 +2456,6 @@ export {
   installCommand,
   resolveInitExecutionPlanWithWizard,
   runInitCommand,
+  runSkillsOnlyRefresh,
   shouldUseInitWizard
 };

package/dist/{onboard-coverage-6MN3CYHT.js → onboard-coverage-MFCAEBDO.js}

@@ -160,7 +160,7 @@ function renderHumanReadable(report) {
       detail = entries.join(", ");
     } else if (report.opted_out.includes(slot)) {
       status = "opted-out";
-      detail = "(user-dismissed; run `fab config onboard-reset` to re-open)";
+      detail = "(user-dismissed; run `fabric config onboard-reset` to re-open)";
     } else {
       status = "missing";
       detail = "(run /fabric-archive to onboard)";
@@ -174,12 +174,12 @@ var onboardCoverageCommand = defineCommand({
     name: "onboard-coverage",
     // v2.0.0-rc.29 TASK-008 (BUG-L2): route description strings through t()
     // (mirrors serve.ts pattern). Previously this command was English-only
-    // even when the rest of `fab --help` rendered zh-CN, so Chinese-locale
+    // even when the rest of `fabric --help` rendered zh-CN, so Chinese-locale
     // users saw an isolated English block under --help.
     description: t("cli.onboard-coverage.description"),
-    // Mirrors `plan-context-hint`: hidden from `fab --help` so the top-level
+    // Mirrors `plan-context-hint`: hidden from `fabric --help` so the top-level
     // banner stays focused on install/doctor/serve/config. The command stays
-    // callable directly from Skills via `fab onboard-coverage --json`.
+    // callable directly from Skills via `fabric onboard-coverage --json`.
     hidden: true
   },
   args: {

package/dist/{plan-context-hint-CXTLNVSV.js → plan-context-hint-UQLRKGBZ.js}

@@ -11,9 +11,9 @@ var planContextHintCommand = defineCommand({
   meta: {
     name: "plan-context-hint",
     description: "Emit versioned knowledge hint JSON to stdout. Used by rc.6 hooks and the fabric-import skill.",
-    // rc.15 TASK-004 (C8): hidden from `fab --help` listing. The command stays
+    // rc.15 TASK-004 (C8): hidden from `fabric --help` listing. The command stays
     // callable so hook scripts and the fabric-import skill can still invoke
-    // it via `fab plan-context-hint ...`; it just no longer appears in the
+    // it via `fabric plan-context-hint ...`; it just no longer appears in the
     // top-level usage banner alongside install/doctor/serve/uninstall/config.
     hidden: true
   },

package/dist/{uninstall-Q7V55BXH.js → uninstall-BIJ5GLEU.js}

@@ -7,7 +7,7 @@ import {
   HOOK_SCRIPT_DESTINATIONS,
   SKILL_DESTINATIONS,
   fabricAgentsSnapshotPath
-} from "./chunk-5N3KXIVI.js";
+} from "./chunk-XVS4F3P6.js";
 import {
   detectClientSupports,
   resolveClients

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.0.0-rc.34",
+  "version": "2.0.0-rc.35",
   "type": "module",
   "bin": {
-    "fab": "dist/index.js",
     "fabric": "dist/index.js"
   },
   "main": "./dist/index.js",
@@ -20,8 +19,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.34",
-    "@fenglimg/fabric-shared": "2.0.0-rc.34"
+    "@fenglimg/fabric-server": "2.0.0-rc.35",
+    "@fenglimg/fabric-shared": "2.0.0-rc.35"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/templates/hooks/cite-policy-evict.cjs

@@ -141,7 +141,7 @@ function renderReminder(turnCount, interval) {
     "decisions/pitfalls cite MUST end with contract: → <operator> [<operator>...] where operator ∈ {edit:<glob> !edit:<glob> require:<symbol> forbid:<symbol> skip:<reason>}.",
     "skip reasons: sequencing | conditional | semantic | aesthetic | architectural | other:<text>.",
     "KB: none sentinels: [no-relevant] (queried but nothing matched) | [not-applicable] (pure exploration / read-only / user Q&A).",
-    "Audit: fab doctor --cite-coverage — this rule does not block work, only records.",
+    "Audit: fabric doctor --cite-coverage — this rule does not block work, only records.",
   ].join("\n");
 }
 

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

@@ -61,6 +61,7 @@ const { dirname, join } = require("node:path");
 // (TASK-002). Variant is resolved ONCE per main() invocation via
 // readFabricLanguage(cwd) and threaded into renderBanner — no fs in render path.
 const { renderBanner, readFabricLanguage } = require("./lib/banner-i18n.cjs");
+const { resolveOpaqueSummaries } = require("./lib/summary-fallback.cjs");
 
 // -----------------------------------------------------------------------------
 // rc.12: SessionStart broad-menu is now unconditionally emitted on every
@@ -415,12 +416,11 @@ const MATURITY_DRAFT = "draft";
  * Spawn `fabric plan-context-hint --all` and return parsed JSON. Returns
  * null on any failure (ENOENT, non-zero exit, malformed JSON). Never throws.
  *
- * spawn strategy: try `fabric` first (user-PATH install) then `fab` (the
- * alternate bin name shipped by @fenglimg/fabric-cli). If neither is on PATH,
- * return null — the hook stays silent rather than nagging about install state.
+ * If `fabric` is not on PATH, return null — the hook stays silent rather
+ * than nagging about install state.
  */
 function invokePlanContextHint(cwd) {
-  const candidates = ["fabric", "fab"];
+  const candidates = ["fabric"];
   // rc.31 NEW-6: capture the last meaningful failure so we can surface it on
   // stderr before fail-open. Without this, hook silently swallows backend
   // crashes (e.g. agents_meta_invalid → plan-context-hint exits with stderr
@@ -439,7 +439,7 @@ function invokePlanContextHint(cwd) {
       continue; // spawn throw (extremely rare) — try next candidate
     }
     // ENOENT surfaces as error on the result object. Skip silently for ENOENT
-    // (bin not installed is expected for `fabric` when only `fab` is shipped).
+    // (bin not installed is the only legitimate reason to bail).
     if (res.error) {
       if (res.error.code !== "ENOENT") {
         lastFailure = { bin, reason: String(res.error.message || res.error.code || res.error) };
@@ -738,6 +738,26 @@ function main(env, stdio) {
         ? { ...payload, entries: payload.entries.slice(0, topK) }
         : payload;
 
+    // rc.35 TASK-06 (P0-10.b): summary-fallback substitution. Entries whose
+    // description.summary equals stable_id render as "<id> · <id>" and the
+    // AI skips fetching them; the fallback reads `## Summary` from the
+    // entry's .md file and swaps in the first paragraph. Best-effort —
+    // failure leaves the original opaque summary untouched.
+    let resolvedPayload = slicedPayload;
+    try {
+      if (slicedPayload && Array.isArray(slicedPayload.entries)) {
+        const resolvedEntries = resolveOpaqueSummaries(
+          slicedPayload.entries,
+          cwd,
+          typeof slicedPayload.revision_hash === "string" ? slicedPayload.revision_hash : "",
+        );
+        resolvedPayload = { ...slicedPayload, entries: resolvedEntries };
+      }
+    } catch {
+      // resolveOpaqueSummaries swallows its own errors; this catch is belt
+      // + suspenders for any unexpected exception from the lib layer.
+    }
+
     // rc.8 underseed self-check: decide whether to surface the one-line
     // `/fabric-import` recommendation banner alongside the broad summary.
     const recommendImport = shouldRecommendImport(cwd);
@@ -749,7 +769,7 @@ function main(env, stdio) {
     // for the agent's working memory. rc.33 W2-5 reintroduces an opt-in
     // hours-based cooldown via fabric-config (see gate above).
     const summaryMaxLen = readSummaryMaxLen(cwd);
-    const lines = renderSummary(slicedPayload, summaryMaxLen);
+    const lines = renderSummary(resolvedPayload, summaryMaxLen);
 
     if (recommendImport) {
       // rc.16 TASK-003: resolve fabric_language ONCE per invocation (only when

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

@@ -75,6 +75,12 @@ const {
 } = require("node:fs");
 const { dirname, join } = require("node:path");
 
+// rc.35 TASK-06 (P0-10.b): summary-fallback. Substitutes opaque entries
+// (where description.summary === stable_id) with a snippet read from the
+// entry's .md `## Summary` section. Caches results in
+// `.fabric/.cache/summary-fallback.json` keyed by revision_hash.
+const { resolveOpaqueSummaries } = require("./lib/summary-fallback.cjs");
+
 // -----------------------------------------------------------------------------
 // CONSTANTS
 // -----------------------------------------------------------------------------
@@ -95,6 +101,14 @@ const DEFAULT_SUMMARY_MAX_LEN = 80;
 const EDIT_COUNTER_DIR_REL = join(".fabric", ".cache");
 const EDIT_COUNTER_FILE = "edit-counter";
 
+// rc.35 TASK-07 (P0-2): events.jsonl path. PreToolUse Edit fires append a
+// `edit_intent_checked` event (ledger_source: 'hook') so doctor cite-
+// coverage's editsTouched metric sees actual edit signals. Without this
+// signal the entire cite-policy contract validation is structurally inert
+// (rc.30 audit P0-2: 18582 turns / 240 edits / 0 events).
+const EVENTS_LEDGER_DIR_REL = ".fabric";
+const EVENTS_LEDGER_FILE = "events.jsonl";
+
 // rc.6 TASK-023 (E6): hint-silence-counter sidecar — companion to the
 // edit-counter above. Where edit-counter records every PreToolUse fire
 // (numerator-agnostic), the silence-counter records only those fires that
@@ -317,6 +331,72 @@ function extractPaths(toolInput) {
  *     array. The fire-count signal is preserved; the activity overview
  *     just contributes nothing from those lines.
  */
+/**
+ * rc.35 TASK-07 (P0-2): append one `edit_intent_checked` event per touched
+ * path to `.fabric/events.jsonl`. Carries `ledger_source: 'hook'` so doctor
+ * cite-coverage can distinguish hook-originated edit signals from
+ * AI/human-originated `appendLedgerEntry` calls.
+ *
+ * Best-effort:
+ *   - Skips silently when `.fabric/` does not exist (project not init'd).
+ *   - Skips silently when paths is empty (counter signal is preserved by
+ *     the sibling appendEditCounter call; cite-coverage only cares about
+ *     non-empty path events).
+ *   - ANY error (mkdir, append, JSON throw) is swallowed — the hook must
+ *     remain non-blocking per the rc.6 contract.
+ *
+ * Atomicity:
+ *   - One JSON line per path. Append on small writes (< PIPE_BUF, ~4KB on
+ *     POSIX) is atomic at the OS level, so concurrent PreToolUse fires
+ *     from parallel sessions interleave cleanly without partial writes.
+ */
+function appendEditIntentToLedger(projectRoot, now, paths, toolName) {
+  try {
+    const fabricDir = join(projectRoot, EVENTS_LEDGER_DIR_REL);
+    // No .fabric/ → project not initialised. Bail before any write.
+    if (!existsSync(fabricDir)) return;
+    const { isAbsolute: pathIsAbsolute, relative: pathRelative } = require("node:path");
+    const pathList = Array.isArray(paths)
+      ? paths
+          .filter((p) => typeof p === "string" && p.length > 0)
+          .map((p) => {
+            if (pathIsAbsolute(p)) {
+              const rel = pathRelative(projectRoot, p);
+              return rel.startsWith("..") ? null : rel;
+            }
+            // Already-relative paths: drop ones that escape the project tree.
+            return p.startsWith("..") ? null : p;
+          })
+          .filter((p) => typeof p === "string" && p.length > 0)
+          // Use forward slashes for cross-platform consistency on disk.
+          .map((p) => p.split(/[\\/]/).join("/"))
+      : [];
+    if (pathList.length === 0) return;
+    const tsMs = now instanceof Date ? now.getTime() : Number(now);
+    const ledgerEntryId = `hook:${randomUUID()}`;
+    const intent = typeof toolName === "string" && toolName.length > 0 ? toolName : "edit";
+    const lines = pathList
+      .map((p) => JSON.stringify({
+        kind: "fabric-event",
+        id: `event:${randomUUID()}`,
+        ts: tsMs,
+        schema_version: 1,
+        event_type: "edit_intent_checked",
+        path: p,
+        compliant: true,
+        intent,
+        ledger_entry_id: ledgerEntryId,
+        ledger_source: "hook",
+        matched_rule_context_ts: null,
+        window_ms: 0,
+      }))
+      .join("\n") + "\n";
+    appendFileSync(join(fabricDir, EVENTS_LEDGER_FILE), lines, "utf8");
+  } catch {
+    // Silent — events ledger failure must never block the edit.
+  }
+}
+
 function appendEditCounter(projectRoot, now, paths) {
   try {
     const dir = join(projectRoot, EDIT_COUNTER_DIR_REL);
@@ -1079,6 +1159,11 @@ function main(env, stdio) {
     }
     if (!(env && env.skipCounter === true)) {
       appendEditCounter(cwd, now, paths);
+      // rc.35 TASK-07 (P0-2): mirror the edit-counter sidecar into the
+      // events.jsonl ledger so doctor cite-coverage's editsTouched metric
+      // sees actual edit signals. Best-effort — failure is swallowed inside
+      // appendEditIntentToLedger and does not block the hook.
+      appendEditIntentToLedger(cwd, now, paths, toolName);
     }
 
     // E2 path is conditional on a recognized tool + extractable paths.
@@ -1237,7 +1322,21 @@ function main(env, stdio) {
     }
 
     const summaryMaxLen = readSummaryMaxLen(cwd);
-    const lines = renderSummary({ ...cliPayload, entries: dedupDecision.filtered }, summaryMaxLen);
+    // rc.35 TASK-06 (P0-10.b): substitute opaque summaries before render.
+    // Same lib used by the broad hook — opaque entries seen from both call
+    // sites share a single .fabric/.cache/summary-fallback.json file.
+    // Best-effort — any failure leaves the original opaque summary intact.
+    let resolvedEntries = dedupDecision.filtered;
+    try {
+      resolvedEntries = resolveOpaqueSummaries(
+        dedupDecision.filtered,
+        cwd,
+        currentRevisionHash,
+      );
+    } catch {
+      // resolveOpaqueSummaries swallows its own errors; defensive catch.
+    }
+    const lines = renderSummary({ ...cliPayload, entries: resolvedEntries }, summaryMaxLen);
     if (lines.length === 0) return;
 
     // Stderr: human-facing breadcrumb + legacy contract.
@@ -1294,6 +1393,10 @@ module.exports = {
   renderSummary,
   truncateSummary,
   formatEntryLine,
+  // rc.35 TASK-07 (P0-2): cite-infrastructure wire-up. Exported so the
+  // integration test can drive the writer directly without standing up the
+  // entire PreToolUse main() flow.
+  appendEditIntentToLedger,
   // rc.6 TASK-021 (E3) — session-hints cache exports for tests / future
   // consumers (TASK-023 silence-counter telemetry will reuse the same
   // session-id resolution + cache shape).
@@ -1323,6 +1426,8 @@ module.exports = {
     EDIT_COUNTER_FILE,
     HINT_SILENCE_COUNTER_DIR_REL,
     HINT_SILENCE_COUNTER_FILE,
+    EVENTS_LEDGER_DIR_REL,
+    EVENTS_LEDGER_FILE,
     EDIT_TOOL_NAMES,
     SESSION_HINTS_DIR_REL,
     SESSION_HINTS_FILE_PREFIX,

package/templates/hooks/lib/summary-fallback.cjs

@@ -0,0 +1,210 @@
+/**
+ * rc.35 TASK-06 (P0-10.b) — summary-fallback library.
+ *
+ * Resolves opaque hint entries (where `entry.summary === entry.id` so the
+ * AI sees no information beyond the id) by reading the entry's markdown
+ * file at `.fabric/knowledge/<type>/<id>--<slug>.md`, extracting the first
+ * paragraph under `## Summary`, and substituting that text into the entry
+ * before the hook renders it.
+ *
+ * Caching: results are stored in `.fabric/.cache/summary-fallback.json`
+ * keyed by the current `revision_hash` returned by plan-context-hint. The
+ * cache is wiped wholesale when the revision changes (cheap invariant —
+ * any meta rev bump implies entry text MAY have moved). Per-process call
+ * also benefits from in-memory dedup since the same opaque id may appear
+ * across narrow + broad paths.
+ *
+ * Design contract:
+ *   - Never throw. ANY failure (cache read, fs scan, file read) degrades
+ *     to a no-op — the original opaque summary is left untouched. Hooks
+ *     must remain best-effort.
+ *   - Idempotent over identical inputs. Two calls in succession with the
+ *     same revision_hash + entries set produce zero disk reads on the
+ *     second call.
+ *
+ * Public API (module.exports):
+ *   resolveOpaqueSummaries(entries, projectRoot, revisionHash) — returns
+ *     a NEW array of entries with `summary` substituted for opaque cases.
+ *     Original `entry.id` is preserved verbatim.
+ *
+ *   _extractFirstSummaryParagraph(md) — pure helper, exposed for testing.
+ *
+ *   _readCache / _writeCache — exposed for testing.
+ */
+
+const { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } = require("node:fs");
+const { join } = require("node:path");
+
+const CACHE_DIR_REL = ".fabric/.cache";
+const CACHE_FILE_REL = ".fabric/.cache/summary-fallback.json";
+const KNOWLEDGE_DIR_REL = ".fabric/knowledge";
+const SUMMARY_MAX_LEN = 80;
+const KNOWLEDGE_TYPE_DIRS = ["decisions", "pitfalls", "guidelines", "models", "processes"];
+
+function _isOpaque(entry) {
+  if (!entry || typeof entry.id !== "string" || typeof entry.summary !== "string") {
+    return false;
+  }
+  return entry.summary.trim() === entry.id.trim();
+}
+
+/**
+ * Pure helper: extract the first paragraph under a `## Summary` heading.
+ *
+ *   - `## Summary` is case-insensitive but level-sensitive (only H2).
+ *   - First paragraph = lines until blank line or next heading.
+ *   - Collapses whitespace + trims; returns `""` if no summary section or
+ *     the section is empty.
+ */
+function _extractFirstSummaryParagraph(md) {
+  if (typeof md !== "string" || md.length === 0) return "";
+  const lines = md.split(/\r?\n/);
+  let i = 0;
+  while (i < lines.length) {
+    if (/^##\s+summary\s*$/i.test(lines[i].trim())) {
+      i += 1;
+      break;
+    }
+    i += 1;
+  }
+  if (i >= lines.length) return "";
+  // Skip blank lines after the heading
+  while (i < lines.length && lines[i].trim().length === 0) i += 1;
+  // Collect until the next blank line or next heading
+  const buf = [];
+  while (i < lines.length) {
+    const line = lines[i];
+    if (line.trim().length === 0) break;
+    if (/^#{1,6}\s/.test(line.trim())) break;
+    buf.push(line.trim());
+    i += 1;
+  }
+  const flat = buf.join(" ").replace(/\s+/g, " ").trim();
+  if (flat.length === 0) return "";
+  if (flat.length <= SUMMARY_MAX_LEN) return flat;
+  return `${flat.slice(0, SUMMARY_MAX_LEN - 1)}…`;
+}
+
+function _readCache(projectRoot) {
+  const cachePath = join(projectRoot, CACHE_FILE_REL);
+  if (!existsSync(cachePath)) return null;
+  try {
+    const raw = readFileSync(cachePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && typeof parsed.revision === "string" && parsed.summaries && typeof parsed.summaries === "object") {
+      return parsed;
+    }
+  } catch {
+    // ignore — caller treats null as no-cache
+  }
+  return null;
+}
+
+function _writeCache(projectRoot, payload) {
+  try {
+    const cacheDir = join(projectRoot, CACHE_DIR_REL);
+    if (!existsSync(cacheDir)) mkdirSync(cacheDir, { recursive: true });
+    const cachePath = join(projectRoot, CACHE_FILE_REL);
+    writeFileSync(cachePath, JSON.stringify(payload), "utf8");
+  } catch {
+    // Best-effort — failing to persist cache is not an error
+  }
+}
+
+/**
+ * Scan `.fabric/knowledge/<type>/` for the canonical `<id>--<slug>.md`
+ * matching `stableId`. Tries the most likely type-dir first based on the
+ * entry's `type` hint, then falls back to scanning all canonical type
+ * directories. Returns the absolute path or null.
+ *
+ * The id→file mapping is unique by construction (stable_id is allocated
+ * once per file), so the first match wins.
+ */
+function _findEntryFile(projectRoot, stableId, typeHint) {
+  const baseDir = join(projectRoot, KNOWLEDGE_DIR_REL);
+  if (!existsSync(baseDir)) return null;
+  const tryOrder = [];
+  if (typeof typeHint === "string" && typeHint.length > 0) {
+    // Accept both singular and plural hints — find the plural form.
+    const lower = typeHint.toLowerCase();
+    const plural = KNOWLEDGE_TYPE_DIRS.find((d) => d === lower || d.startsWith(lower));
+    if (plural) tryOrder.push(plural);
+  }
+  for (const t of KNOWLEDGE_TYPE_DIRS) {
+    if (!tryOrder.includes(t)) tryOrder.push(t);
+  }
+  const prefix = `${stableId}--`;
+  for (const t of tryOrder) {
+    const typeDir = join(baseDir, t);
+    if (!existsSync(typeDir)) continue;
+    let files;
+    try {
+      files = readdirSync(typeDir);
+    } catch {
+      continue;
+    }
+    for (const f of files) {
+      if (f.startsWith(prefix) && f.endsWith(".md")) {
+        return join(typeDir, f);
+      }
+    }
+  }
+  return null;
+}
+
+function _resolveOne(projectRoot, entry) {
+  const filePath = _findEntryFile(projectRoot, entry.id, entry.type);
+  if (filePath === null) return "";
+  let md;
+  try {
+    md = readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+  return _extractFirstSummaryParagraph(md);
+}
+
+/**
+ * Main API. Returns a new array of entries with `summary` swapped for
+ * the extracted fallback wherever the original summary was opaque AND
+ * the fallback extraction yielded a non-empty string. Non-opaque entries
+ * pass through unchanged.
+ */
+function resolveOpaqueSummaries(entries, projectRoot, revisionHash) {
+  if (!Array.isArray(entries) || entries.length === 0) return entries;
+  const cache = _readCache(projectRoot);
+  const cachedSummaries = cache && cache.revision === revisionHash && cache.summaries ? cache.summaries : {};
+  const nextCacheSummaries = { ...cachedSummaries };
+  let cacheChanged = cache === null || cache.revision !== revisionHash;
+  const result = entries.map((entry) => {
+    if (!_isOpaque(entry)) return entry;
+    const id = entry.id;
+    let fallback;
+    if (Object.prototype.hasOwnProperty.call(cachedSummaries, id)) {
+      fallback = cachedSummaries[id];
+    } else {
+      fallback = _resolveOne(projectRoot, entry);
+      nextCacheSummaries[id] = fallback;
+      cacheChanged = true;
+    }
+    if (typeof fallback === "string" && fallback.length > 0) {
+      return { ...entry, summary: fallback };
+    }
+    return entry;
+  });
+  if (cacheChanged) {
+    _writeCache(projectRoot, { revision: revisionHash, summaries: nextCacheSummaries });
+  }
+  return result;
+}
+
+module.exports = {
+  resolveOpaqueSummaries,
+  _extractFirstSummaryParagraph,
+  _readCache,
+  _writeCache,
+  _findEntryFile,
+  _isOpaque,
+  SUMMARY_MAX_LEN,
+  KNOWLEDGE_TYPE_DIRS,
+};

package/templates/skills/fabric-archive/SKILL.md

@@ -53,7 +53,7 @@ Graceful degradation: missing digest cache → single-session fallback. Missing
 
 ### Phase 1.5 — First-run Onboard (ref-only)
 
-**SKIP this phase entirely unless** entry_point ∈ {E2_explicit_user_invoke, E4_user_range_rollback} AND `fab onboard-coverage --json` reports `missing.length > 0`. For E1/E3/E5, silently fall through to Phase 0.
+**SKIP this phase entirely unless** entry_point ∈ {E2_explicit_user_invoke, E4_user_range_rollback} AND `fabric onboard-coverage --json` reports `missing.length > 0`. For E1/E3/E5, silently fall through to Phase 0.
 
 `Read ref/phase-1-5-onboard.md` for the Step 1-4 coverage check → user prompt → tour-and-propose procedure.
 

package/templates/skills/fabric-archive/ref/dry-run-scope.md

@@ -7,7 +7,7 @@
 | `fab_extract_knowledge` MCP call (Phase 4) | One call per confirmed candidate, writes to `.fabric/knowledge/pending/<slug>.md` | SKIPPED. Phase 4 renders "would write N pending entries" preview table instead. |
 | `session_archive_attempted` event (Phase 4.5) | Appended to `.fabric/events.jsonl` for every session in scope | SKIPPED entirely. No ledger entry. |
 | `fab_review reject` (Phase 3 user-dismissed branch) | Invoked when user types `撤销` / `reject` after self-archive proposal | SKIPPED. The dismissal is rendered to console but no MCP write occurs. |
-| `fab onboard-coverage` slot writes (Phase 1.5 fill-all / dismiss-all) | Each `Bash("fab config dismiss-slot <slot>")` invocation runs | SKIPPED. Slot decisions are shown as "would dismiss/propose" preview. |
+| `fabric onboard-coverage` slot writes (Phase 1.5 fill-all / dismiss-all) | Each `Bash("fabric config dismiss-slot <slot>")` invocation runs | SKIPPED. Slot decisions are shown as "would dismiss/propose" preview. |
 | `.fabric/.cache/session-digests/<session_id>.md` reads | Read freely (read-side, safe) | Read freely — same as normal. |
 | Stop-hook / archive-hint stdin/stdout | Read-only inspection of `.fabric/events.jsonl` | Same — no change. |
 

package/templates/skills/fabric-archive/ref/e5-cron-recap.md

@@ -8,7 +8,7 @@
 
 `今日复盘` = E5 entry point. Default scope = today. Falls back to historical scan if today yields no candidates (silent-skip per Phase 4.5).
 
-E5 是 5 入口模型中唯一由 OS 调度器或 Claude Code `/loop` 周期触发的入口形态。fab 端**零代码**——不提供 `fab schedule` 子命令,亦不内嵌 daemon。用户基于自己的执行环境二选一接入: `/loop`(Claude Code 原生,推荐) 或 OS cron(跨平台 fallback)。
+E5 是 5 入口模型中唯一由 OS 调度器或 Claude Code `/loop` 周期触发的入口形态。fabric 端**零代码**——不提供 `fabric schedule` 子命令,亦不内嵌 daemon。用户基于自己的执行环境二选一接入: `/loop`(Claude Code 原生,推荐) 或 OS cron(跨平台 fallback)。
 
 ### /loop sample (primary path for Claude Code)
 

package/templates/skills/fabric-archive/ref/i18n-policy.md

@@ -34,7 +34,7 @@ Rendering rule:
 
 - `fabric_language === "zh-CN"` → emit the zh-CN variant; pure monolingual, no language mixing inside a single user-facing block.
 - `fabric_language === "en"` → emit the en variant; pure monolingual, no language mixing inside a single user-facing block.
-- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fab install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
+- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fabric install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
 - `fabric_language === "match-existing"` or any other value → emit the en variant; pure monolingual.
 
 Protected tokens (`fab_extract_knowledge`, `relevance_scope`,

package/templates/skills/fabric-archive/ref/phase-1-5-onboard.md

@@ -1,6 +1,6 @@
 # Phase 1.5 — First-run Onboard Phase (ref)
 
-> **Loaded on demand.** SKILL.md hot path only runs this when entry_point ∈ {E2_explicit_user_invoke, E4_user_range_rollback} AND `fab onboard-coverage --json` reports `missing.length > 0`. For E1/E3/E5 entries OR fully-covered workspaces, this entire phase is skipped — no reason to load.
+> **Loaded on demand.** SKILL.md hot path only runs this when entry_point ∈ {E2_explicit_user_invoke, E4_user_range_rollback} AND `fabric onboard-coverage --json` reports `missing.length > 0`. For E1/E3/E5 entries OR fully-covered workspaces, this entire phase is skipped — no reason to load.
 
 ## Phase 1.5 — First-run Onboard Phase
 
@@ -55,7 +55,7 @@ tone.
 A first-time user whose ONLY invocations ever come via hook (never an
 explicit `/fabric-archive`) will not see the onboard prompt; the 5
 onboard slots remain empty. Mitigation: documentation tells users to
-run an explicit `fab archive` at least once to populate the onboard
+run an explicit `fabric archive` at least once to populate the onboard
 baseline.
 
 ##### Worked example
@@ -82,7 +82,7 @@ $ /fabric-archive
 
 ---
 
-After F8a removed the auto-`fab scan` baseline pipeline, a freshly installed
+After F8a removed the auto-`fabric scan` baseline pipeline, a freshly installed
 Fabric workspace ships with an EMPTY `.fabric/knowledge/` tree. Five fixed
 **S5 onboard slots** capture the "project tone" baseline that the AI needs
 for high-quality plan_context retrieval from day one:
@@ -98,10 +98,10 @@ gathering, so coverage state is fresh for the session.
 
 #### Step 1 — Check coverage
 
-Invoke `fab onboard-coverage --json` and parse the JSON payload:
+Invoke `fabric onboard-coverage --json` and parse the JSON payload:
 
 ```bash
-fab onboard-coverage --json
+fabric onboard-coverage --json
 ```
 
 Expected shape:
@@ -147,8 +147,8 @@ proposed entry counts toward coverage once approved via fab_review.
 | User choice    | Action |
 |----------------|--------|
 | `fill-all`     | For EACH slot in `missing`, run Step 4 (Tour-and-propose). All proposals share session_id; one batch review at the end (Phase 3). |
-| `fill-each`    | Loop slot-by-slot through `missing`. Per slot: ask user `confirm | dismiss | skip` (per-slot AskUserQuestion); `confirm` → run Step 4; `dismiss` → `fab config dismiss-slot <slot>`; `skip` → leave for next archive run. |
-| `dismiss-all`  | For EACH slot in `missing`, invoke `Bash("fab config dismiss-slot <slot>")`. Print a one-line confirmation each. Skip to Phase 0. |
+| `fill-each`    | Loop slot-by-slot through `missing`. Per slot: ask user `confirm | dismiss | skip` (per-slot AskUserQuestion); `confirm` → run Step 4; `dismiss` → `fabric config dismiss-slot <slot>`; `skip` → leave for next archive run. |
+| `dismiss-all`  | For EACH slot in `missing`, invoke `Bash("fabric config dismiss-slot <slot>")`. Print a one-line confirmation each. Skip to Phase 0. |
 | `skip`         | No-op. Slots remain in `missing` for the next archive run. Skip to Phase 0. |
 
 #### Step 4 — Tour-and-propose (per-slot)
@@ -174,7 +174,7 @@ After Read-ing the slot-specific sources, classify the observation:
 
 Call `fab_extract_knowledge` with the inferred fields PLUS `onboard_slot:
 <slot>`. The pending file's frontmatter will carry the slot label, and the
-next `fab onboard-coverage` run will see the slot as filled (once approved
+next `fabric onboard-coverage` run will see the slot as filled (once approved
 via fab_review).
 
 Example:
@@ -201,9 +201,9 @@ mcp__fabric__fab_extract_knowledge({
 
 - MUST run BEFORE Phase 2 evidence gathering — onboard is a separate flow,
   not interleaved with session-archive candidates.
-- MUST call `fab onboard-coverage --json` before deciding; never assume
+- MUST call `fabric onboard-coverage --json` before deciding; never assume
   coverage state.
-- NEVER fill a slot that is in `opted_out` — `fab onboard-coverage` already
+- NEVER fill a slot that is in `opted_out` — `fabric onboard-coverage` already
   excludes those from `missing`, but the Skill MUST NOT re-propose them
   even if the user asks "fill all of them" — the dismiss is intentional.
 - NEVER prompt the user when `missing.length === 0` — silent skip.

package/templates/skills/fabric-import/ref/i18n-policy.md

@@ -29,7 +29,7 @@ Rendering rule:
 
 - `fabric_language === "zh-CN"` → emit the zh-CN variant; pure monolingual, no language mixing inside a single user-facing block.
 - `fabric_language === "en"` → emit the en variant; pure monolingual, no language mixing inside a single user-facing block.
-- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fab install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
+- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fabric install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
 - `fabric_language === "match-existing"` or any other value → emit the en variant; pure monolingual.
 
 Protected tokens (`fab_extract_knowledge`, `fab_review`, `relevance_scope`,

package/templates/skills/fabric-review/ref/i18n-policy.md

@@ -33,7 +33,7 @@ Rendering rule:
 
 - `fabric_language === "zh-CN"` → emit the zh-CN variant; pure monolingual, no language mixing inside a single user-facing block.
 - `fabric_language === "en"` → emit the en variant; pure monolingual, no language mixing inside a single user-facing block.
-- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fab install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
+- `fabric_language === "zh-CN-hybrid"` → emit Chinese narrative prose with English technical terms preserved. Protected tokens (always EN): MCP tool names (e.g. `fab_get_knowledge_sections`), CLI command names (e.g. `fabric install`), file paths, technical concepts (`Skill`, `SessionStart`, `hook`, `MCP`, `revision_hash`, `pending`, `proven`, `verified`, `draft`).
 - `fabric_language === "match-existing"` or any other value → emit the en variant; pure monolingual.
 
 Protected tokens (`fab_review`, `relevance_scope`, `relevance_paths`,