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

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-XSUIX6AD.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.36",
     description: t("cli.main.description")
   },
   subCommands: allCommands

package/dist/{install-XCRX34CX.js → install-XSUIX6AD.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.36" : "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.36",
   "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.36",
+    "@fenglimg/fabric-shared": "2.0.0-rc.36"
   },
   "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,