@fenglimg/fabric-server 2.0.0-rc.27 → 2.0.0-rc.29

package/dist/{chunk-NZSGNQKE.js → chunk-CTQ4UMO4.js}

@@ -84,7 +84,7 @@ import { readFile } from "fs/promises";
 import { join } from "path";
 import { agentsMetaSchema } from "@fenglimg/fabric-shared";
 import { IOFabricError } from "@fenglimg/fabric-shared/errors";
-import { agentsMetaNodeSchema, agentsMetaSchema as agentsMetaSchema2 } from "@fenglimg/fabric-shared";
+import { agentsMetaSchema as agentsMetaSchema2 } from "@fenglimg/fabric-shared";
 var AgentsMetaFileMissingError = class extends IOFabricError {
   constructor(metaPath, opts) {
     super(`Fabric agents metadata file is missing: ${metaPath}`, {
@@ -1078,9 +1078,17 @@ function extractKnowledgeFieldsFromFrontmatter(frontmatter) {
 `);
     }
   }
+  const SINGULAR_TO_PLURAL = {
+    model: "models",
+    decision: "decisions",
+    guideline: "guidelines",
+    pitfall: "pitfalls",
+    process: "processes"
+  };
   let knowledge_type;
   if (rawType !== void 0) {
-    const parsed = KnowledgeTypeSchema.safeParse(rawType);
+    const normalized = SINGULAR_TO_PLURAL[rawType] ?? rawType;
+    const parsed = KnowledgeTypeSchema.safeParse(normalized);
     if (parsed.success) {
       knowledge_type = parsed.data;
     } else {
@@ -1429,6 +1437,12 @@ async function ensureKnowledgeFresh(projectRoot, opts) {
     contextCache.invalidate("file_watch", projectRoot);
   }
   freshSyncCooldown.delete(projectRoot);
+  if (opts?.autoHealOnDrift === true && events.length > 0) {
+    try {
+      await reconcileKnowledge(projectRoot, { trigger: "auto-heal-after-drift" });
+    } catch {
+    }
+  }
   const status = warnings.length > 0 ? "errors" : "reconciled";
   return {
     status,
@@ -1620,11 +1634,11 @@ function checkLockOrThrow(projectRoot, opts) {
 
 // src/services/doctor.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync4, readdirSync, readFileSync as readFileSync2, statSync as statSync4 } from "fs";
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync3, statSync as statSync4 } from "fs";
 import { access, mkdir as mkdir4, readFile as readFile5, rename, unlink, writeFile as writeFile2 } from "fs/promises";
 import { constants } from "fs";
 import { homedir as homedir3 } from "os";
-import { isAbsolute as isAbsolute2, join as join6, posix, relative as nodeRelative, resolve as resolve3, sep as sep3 } from "path";
+import { isAbsolute as isAbsolute2, join as join7, posix, relative as nodeRelative, resolve as resolve3, sep as sep3 } from "path";
 import { minimatch } from "minimatch";
 import {
   agentsMetaSchema as agentsMetaSchema4,
@@ -1643,6 +1657,41 @@ import {
   resolveFabricLocale as resolveFabricLocale2
 } from "@fenglimg/fabric-shared";
 import { detectFramework } from "@fenglimg/fabric-shared/node";
+import {
+  PAYLOAD_LIMIT_DEFAULT_HARD_BYTES,
+  PAYLOAD_LIMIT_DEFAULT_WARN_BYTES
+} from "@fenglimg/fabric-shared/node/mcp-payload-guard";
+
+// src/config-loader.ts
+import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
+import { join as join6 } from "path";
+import { selectionTokenTtlMsSchema } from "@fenglimg/fabric-shared";
+function readFabricConfig(projectRoot) {
+  const configPath = join6(projectRoot, "fabric.config.json");
+  if (!existsSync4(configPath)) {
+    return {};
+  }
+  const parsed = JSON.parse(readFileSync2(configPath, "utf8"));
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`Expected object in ${configPath}`);
+  }
+  return parsed;
+}
+function readPayloadLimits(projectRoot) {
+  return readFabricConfig(projectRoot).mcpPayloadLimits;
+}
+function readSelectionTokenTtlMs(projectRoot) {
+  try {
+    const raw = readFabricConfig(projectRoot).selection_token_ttl_ms;
+    if (raw === void 0) return void 0;
+    const parsed = selectionTokenTtlMsSchema.safeParse(raw);
+    return parsed.success ? parsed.data : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/services/doctor.ts
 import { atomicWriteJson as atomicWriteJson2, atomicWriteText as atomicWriteText4 } from "@fenglimg/fabric-shared/node/atomic-write";
 var ORPHAN_DEMOTE_THRESHOLD_DAYS = {
   stable: 90,
@@ -1753,6 +1802,7 @@ async function runDoctorReport(target) {
     inspectL2ManagedBlockDrift(projectRoot)
   ]);
   const mcpConfigInWrongFile = inspectMcpConfigInWrongFile(projectRoot);
+  const skillRefMirror = inspectSkillRefMirror(projectRoot);
   const metaManuallyDiverged = await inspectMetaManuallyDiverged(projectRoot);
   const knowledgeDirUnindexed = inspectKnowledgeDirUnindexed(projectRoot, meta);
   const knowledgeDirMissing = inspectKnowledgeDirMissing(projectRoot);
@@ -1815,6 +1865,11 @@ async function runDoctorReport(target) {
     // events.jsonl rows that fail Zod validation because of unknown
     // schema_version or event_type tokens. Previously silently dropped.
     createEventLedgerSchemaCompatCheck(t, eventLedger),
+    // v2.0.0-rc.28 TASK-04 (audit §3.1 follow-up): SKILL ref/ mirror parity.
+    // Detects hand-edits or partial install that breaks the byte-identical
+    // contract between .claude/skills/<slug>/ref/ and .codex/skills/<slug>/
+    // ref/. warning severity — fab install restores parity.
+    createSkillRefMirrorCheck(t, skillRefMirror),
     createMcpConfigInWrongFileCheck(t, mcpConfigInWrongFile),
     createMetaManuallyDivergedCheck(t, metaManuallyDiverged),
     createKnowledgeDirUnindexedCheck(t, knowledgeDirUnindexed),
@@ -1908,11 +1963,27 @@ async function runDoctorReport(target) {
       warningCount: warnings.length,
       infoCount: infos.length,
       targetFiles: Object.fromEntries(
-        TARGET_FILE_PATHS.map((path2) => [path2, existsSync4(join6(projectRoot, path2))])
-      )
+        TARGET_FILE_PATHS.map((path2) => [path2, existsSync5(join7(projectRoot, path2))])
+      ),
+      // v2.0.0-rc.29 TASK-008 (BUG-F2): resolve and surface payload thresholds.
+      // Best-effort: a corrupt fabric.config.json should not fail doctor; on
+      // any read/parse error fall back to library defaults with source="default".
+      payload_limits: resolvePayloadLimits(projectRoot)
     }
   };
 }
+function resolvePayloadLimits(projectRoot) {
+  let override;
+  try {
+    override = readPayloadLimits(projectRoot);
+  } catch {
+    override = void 0;
+  }
+  const warn = override?.warnBytes ?? PAYLOAD_LIMIT_DEFAULT_WARN_BYTES;
+  const hard = override?.hardBytes ?? PAYLOAD_LIMIT_DEFAULT_HARD_BYTES;
+  const source = override?.warnBytes !== void 0 || override?.hardBytes !== void 0 ? "config" : "default";
+  return { warn_bytes: warn, hard_bytes: hard, source };
+}
 async function runDoctorFix(target) {
   const projectRoot = normalizeTarget(target);
   const before = await runDoctorReport(projectRoot);
@@ -1935,7 +2006,7 @@ async function runDoctorFix(target) {
     }
   }
   if (before.fixable_errors.some((issue) => issue.code === "bootstrap_snapshot_drift")) {
-    const snapshotPath = join6(projectRoot, ".fabric", "AGENTS.md");
+    const snapshotPath = join7(projectRoot, ".fabric", "AGENTS.md");
     await ensureParentDirectory(snapshotPath);
     await atomicWriteText4(snapshotPath, BOOTSTRAP_CANONICAL);
     fixed.push(findIssue(before.fixable_errors, "bootstrap_snapshot_drift"));
@@ -2009,7 +2080,7 @@ async function runDoctorFix(target) {
   if (before.infos.some((issue) => issue.code === "stale_serve_lock")) {
     const lockInspection = inspectStaleServeLock(projectRoot, Date.now());
     if (lockInspection.present && !lockInspection.pidAlive) {
-      const lockFilePath = join6(projectRoot, ".fabric", ".serve.lock");
+      const lockFilePath = join7(projectRoot, ".fabric", ".serve.lock");
       try {
         await unlink(lockFilePath);
       } catch (err) {
@@ -2166,7 +2237,7 @@ async function applyOrphanDemote(projectRoot, candidate, now) {
     };
   }
   const detail = `${candidate.maturity} -> ${next}`;
-  const absPath = join6(projectRoot, candidate.path);
+  const absPath = join7(projectRoot, candidate.path);
   try {
     const source = await readFile5(absPath, "utf8");
     const rewritten = rewriteFrontmatterMaturity(source, next);
@@ -2233,11 +2304,11 @@ async function applyOrphanDemote(projectRoot, candidate, now) {
   }
 }
 async function applyStaleArchive(projectRoot, candidate, now) {
-  const sourceAbs = join6(projectRoot, candidate.path);
-  const destAbs = join6(projectRoot, candidate.archive_path);
+  const sourceAbs = join7(projectRoot, candidate.path);
+  const destAbs = join7(projectRoot, candidate.archive_path);
   const detail = `${candidate.path} -> ${candidate.archive_path}`;
   try {
-    await mkdir4(join6(destAbs, ".."), { recursive: true });
+    await mkdir4(join7(destAbs, ".."), { recursive: true });
     try {
       await rename(sourceAbs, destAbs);
     } catch (renameError) {
@@ -2296,7 +2367,7 @@ async function applyStaleArchive(projectRoot, candidate, now) {
 async function applyPendingAutoArchive(projectRoot, candidate, now) {
   const detail = `${candidate.pending_path} -> ${candidate.archived_to}`;
   try {
-    await mkdir4(join6(candidate.archived_to_abs, ".."), { recursive: true });
+    await mkdir4(join7(candidate.archived_to_abs, ".."), { recursive: true });
     let moved = false;
     if (candidate.layer === "team") {
       try {
@@ -2373,7 +2444,7 @@ function relativePosix(projectRoot, absolutePath) {
 }
 async function applySessionHintsStaleCleanup(projectRoot, candidate) {
   const detail = `deleted (${candidate.age_days}d old)`;
-  const absPath = join6(projectRoot, candidate.path);
+  const absPath = join7(projectRoot, candidate.path);
   try {
     const { unlink: unlink2 } = await import("fs/promises");
     await unlink2(absPath);
@@ -2394,7 +2465,7 @@ async function applySessionHintsStaleCleanup(projectRoot, candidate) {
   }
 }
 async function applyIndexDriftFix(projectRoot, inspection) {
-  const metaPath = join6(projectRoot, ".fabric", "agents.meta.json");
+  const metaPath = join7(projectRoot, ".fabric", "agents.meta.json");
   const detailParts = [];
   try {
     const meta = agentsMetaSchema4.parse(JSON.parse(await readFile5(metaPath, "utf8")));
@@ -2430,7 +2501,7 @@ function truncateErrorMessage(error) {
   return raw.length > 240 ? `${raw.slice(0, 237)}...` : raw;
 }
 async function inspectForensic(projectRoot) {
-  const path2 = join6(projectRoot, ".fabric", "forensic.json");
+  const path2 = join7(projectRoot, ".fabric", "forensic.json");
   try {
     const parsed = forensicReportSchema.parse(JSON.parse(await readFile5(path2, "utf8")));
     return { present: true, valid: true, report: parsed };
@@ -2442,12 +2513,12 @@ async function inspectForensic(projectRoot) {
   }
 }
 function inspectMcpConfigInWrongFile(projectRoot) {
-  const settingsPath = join6(projectRoot, ".claude", "settings.json");
-  if (!existsSync4(settingsPath)) {
+  const settingsPath = join7(projectRoot, ".claude", "settings.json");
+  if (!existsSync5(settingsPath)) {
     return { hasWrongEntry: false, settingsPath };
   }
   try {
-    const parsed = JSON.parse(readFileSync2(settingsPath, "utf8"));
+    const parsed = JSON.parse(readFileSync3(settingsPath, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       return { hasWrongEntry: false, settingsPath };
     }
@@ -2463,7 +2534,7 @@ function inspectMcpConfigInWrongFile(projectRoot) {
   }
 }
 async function inspectMeta(projectRoot) {
-  const metaPath = join6(projectRoot, ".fabric", "agents.meta.json");
+  const metaPath = join7(projectRoot, ".fabric", "agents.meta.json");
   const built = await tryBuildRuleMeta(projectRoot);
   try {
     const raw = await readFile5(metaPath, "utf8");
@@ -2536,7 +2607,7 @@ function inspectContentRefs(projectRoot, meta) {
     if (isPersonalKnowledge) {
       continue;
     }
-    if (!existsSync4(join6(projectRoot, contentRef))) {
+    if (!existsSync5(join7(projectRoot, contentRef))) {
       missing.push(contentRef);
     }
   }
@@ -2544,7 +2615,7 @@ function inspectContentRefs(projectRoot, meta) {
 }
 async function inspectEventLedger(projectRoot) {
   const path2 = getEventLedgerPath(projectRoot);
-  const exists = existsSync4(path2);
+  const exists = existsSync5(path2);
   if (!exists) {
     return {
       exists: false,
@@ -2616,8 +2687,55 @@ async function inspectEventLedger(projectRoot) {
     };
   }
 }
+function inspectSkillRefMirror(projectRoot) {
+  const skillSlugs = ["fabric-archive", "fabric-review", "fabric-import"];
+  const driftedPaths = [];
+  for (const slug of skillSlugs) {
+    const claudeRef = join7(projectRoot, ".claude", "skills", slug, "ref");
+    const codexRef = join7(projectRoot, ".codex", "skills", slug, "ref");
+    let claudeFiles = null;
+    let codexFiles = null;
+    try {
+      claudeFiles = readdirSync(claudeRef).filter((n) => n.endsWith(".md"));
+    } catch {
+    }
+    try {
+      codexFiles = readdirSync(codexRef).filter((n) => n.endsWith(".md"));
+    } catch {
+    }
+    if (claudeFiles === null || codexFiles === null) continue;
+    const claudeSet = new Set(claudeFiles);
+    const codexSet = new Set(codexFiles);
+    const union = /* @__PURE__ */ new Set([...claudeFiles, ...codexFiles]);
+    for (const fname of union) {
+      const inClaude = claudeSet.has(fname);
+      const inCodex = codexSet.has(fname);
+      if (!inClaude || !inCodex) {
+        driftedPaths.push(`skills/${slug}/ref/${fname}`);
+        continue;
+      }
+      let claudeBody;
+      let codexBody;
+      try {
+        claudeBody = readFileSync3(join7(claudeRef, fname), "utf8");
+      } catch {
+        continue;
+      }
+      try {
+        codexBody = readFileSync3(join7(codexRef, fname), "utf8");
+      } catch {
+        continue;
+      }
+      if (claudeBody !== codexBody) {
+        driftedPaths.push(`skills/${slug}/ref/${fname}`);
+      }
+    }
+  }
+  if (driftedPaths.length === 0) return { status: "ok" };
+  return { status: "drift", driftedPaths };
+}
 async function inspectKnowledgeTestIndex(projectRoot) {
-  const path2 = join6(projectRoot, ".fabric", ".cache", "knowledge-test.index.json");
+  const path2 = join7(projectRoot, ".fabric", ".cache", "knowledge-test.index.json");
   const built = await tryBuildRuleMeta(projectRoot);
   try {
     const index = knowledgeTestIndexSchema2.parse(JSON.parse(await readFile5(path2, "utf8")));
@@ -2641,8 +2759,8 @@ async function inspectKnowledgeTestIndex(projectRoot) {
 }
 function inspectBootstrapAnchor(projectRoot) {
   return {
-    hasAgentsMd: existsSync4(join6(projectRoot, "AGENTS.md")),
-    hasClaudeMd: existsSync4(join6(projectRoot, "CLAUDE.md"))
+    hasAgentsMd: existsSync5(join7(projectRoot, "AGENTS.md")),
+    hasClaudeMd: existsSync5(join7(projectRoot, "CLAUDE.md"))
   };
 }
 var BOOTSTRAP_MARKER_MIGRATION_TARGETS = [
@@ -2654,8 +2772,8 @@ var BOOTSTRAP_MARKER_MIGRATION_TARGETS = [
 async function inspectBootstrapMarkerMigration(target) {
   const filesNeedingMigration = [];
   for (const rel of BOOTSTRAP_MARKER_MIGRATION_TARGETS) {
-    const abs = join6(target, rel);
-    if (!existsSync4(abs)) {
+    const abs = join7(target, rel);
+    if (!existsSync5(abs)) {
       continue;
     }
     let content;
@@ -2692,8 +2810,8 @@ function createBootstrapMarkerMigrationCheck(t, inspection) {
   );
 }
 async function inspectL1BootstrapSnapshotDrift(target) {
-  const abs = join6(target, ".fabric", "AGENTS.md");
-  if (!existsSync4(abs)) {
+  const abs = join7(target, ".fabric", "AGENTS.md");
+  if (!existsSync5(abs)) {
     return { status: "missing", canonical: BOOTSTRAP_CANONICAL, onDisk: null };
   }
   let onDisk;
@@ -2724,8 +2842,8 @@ function createL1BootstrapSnapshotDriftCheck(t, inspection) {
   );
 }
 async function inspectL2ManagedBlockDrift(target) {
-  const snapshotPath = join6(target, ".fabric", "AGENTS.md");
-  if (!existsSync4(snapshotPath)) {
+  const snapshotPath = join7(target, ".fabric", "AGENTS.md");
+  if (!existsSync5(snapshotPath)) {
     return { status: "ok", drifted: [] };
   }
   let snapshot;
@@ -2734,9 +2852,9 @@ async function inspectL2ManagedBlockDrift(target) {
   } catch {
     return { status: "ok", drifted: [] };
   }
-  const projectRulesPath = join6(target, ".fabric", "project-rules.md");
+  const projectRulesPath = join7(target, ".fabric", "project-rules.md");
   let expectedBody = snapshot;
-  if (existsSync4(projectRulesPath)) {
+  if (existsSync5(projectRulesPath)) {
     try {
       const projectRules = await readFile5(projectRulesPath, "utf8");
       expectedBody = `${snapshot}
@@ -2748,11 +2866,11 @@ ${projectRules}`;
   const drifted = [];
   let anyManagedBlockFound = false;
   const blockTargets = [
-    join6(target, "AGENTS.md"),
-    join6(target, ".cursor", "rules", "fabric-bootstrap.mdc")
+    join7(target, "AGENTS.md"),
+    join7(target, ".cursor", "rules", "fabric-bootstrap.mdc")
   ];
   for (const abs of blockTargets) {
-    if (!existsSync4(abs)) {
+    if (!existsSync5(abs)) {
       continue;
     }
     let content;
@@ -2783,8 +2901,8 @@ ${projectRules}`;
       drifted.push({ path: abs, expected: expectedBody, actual: body });
     }
   }
-  const claudeMdPath = join6(target, "CLAUDE.md");
-  if (existsSync4(claudeMdPath)) {
+  const claudeMdPath = join7(target, "CLAUDE.md");
+  if (existsSync5(claudeMdPath)) {
     let claudeContent;
     try {
       claudeContent = await readFile5(claudeMdPath, "utf8");
@@ -2854,11 +2972,11 @@ function createBootstrapAnchorCheck(t, inspection) {
   );
 }
 function inspectKnowledgeDirMissing(projectRoot) {
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
   const missingSubdirs = [];
   for (const sub of KNOWLEDGE_SUBDIRS3) {
-    const path2 = join6(knowledgeRoot, sub);
-    if (!existsSync4(path2)) {
+    const path2 = join7(knowledgeRoot, sub);
+    if (!existsSync5(path2)) {
       missingSubdirs.push(`.fabric/knowledge/${sub}`);
     }
   }
@@ -2866,13 +2984,13 @@ function inspectKnowledgeDirMissing(projectRoot) {
 }
 function inspectBaselineFilenameFormat(projectRoot) {
   const offenders = [];
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
-  if (!existsSync4(knowledgeRoot)) {
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
+  if (!existsSync5(knowledgeRoot)) {
     return { offenders };
   }
   for (const sub of KNOWLEDGE_CANONICAL_TYPE_DIRS) {
-    const dir = join6(knowledgeRoot, sub);
-    if (!existsSync4(dir)) {
+    const dir = join7(knowledgeRoot, sub);
+    if (!existsSync5(dir)) {
       continue;
     }
     let entries;
@@ -2889,10 +3007,10 @@ function inspectBaselineFilenameFormat(projectRoot) {
       if (BASELINE_ID_PREFIXED_FILENAME_PATTERN.test(entryName)) {
         continue;
       }
-      const abs = join6(dir, entryName);
+      const abs = join7(dir, entryName);
       let source;
       try {
-        source = readFileSync2(abs, "utf8");
+        source = readFileSync3(abs, "utf8");
       } catch {
         continue;
       }
@@ -3192,6 +3310,25 @@ function createEventLedgerSchemaCompatCheck(t, ledger) {
     t("doctor.check.event_ledger_schema_compat.remediation")
   );
 }
+function createSkillRefMirrorCheck(t, inspection) {
+  if (inspection.status === "ok") {
+    return okCheck(
+      t("doctor.check.skill_ref_mirror.name"),
+      t("doctor.check.skill_ref_mirror.ok")
+    );
+  }
+  return issueCheck(
+    t("doctor.check.skill_ref_mirror.name"),
+    "warn",
+    "warning",
+    "skill_ref_mirror_drift",
+    t("doctor.check.skill_ref_mirror.message", {
+      count: String(inspection.driftedPaths.length),
+      list: inspection.driftedPaths.join(", ")
+    }),
+    t("doctor.check.skill_ref_mirror.remediation")
+  );
+}
 function createEventLedgerPartialWriteCheck(t, ledger) {
   if (!ledger.exists || !ledger.writable) {
     return okCheck(
@@ -3247,8 +3384,8 @@ function findIssue(issues, code) {
   };
 }
 async function inspectMetaManuallyDiverged(projectRoot) {
-  const metaPath = join6(projectRoot, ".fabric", "agents.meta.json");
-  if (!existsSync4(metaPath)) {
+  const metaPath = join7(projectRoot, ".fabric", "agents.meta.json");
+  if (!existsSync5(metaPath)) {
     return { extraMetaEntries: [], hashMismatchEntries: [], readable: false };
   }
   let meta;
@@ -3267,13 +3404,13 @@ async function inspectMetaManuallyDiverged(projectRoot) {
   const hashMismatchEntries = [];
   for (const node of Object.values(meta.nodes)) {
     const contentRef = node.content_ref ?? node.file;
-    const absPath = join6(projectRoot, contentRef);
-    if (!existsSync4(absPath)) {
+    const absPath = join7(projectRoot, contentRef);
+    if (!existsSync5(absPath)) {
       extraMetaEntries.push(contentRef);
       continue;
     }
     try {
-      const content = readFileSync2(absPath, "utf8");
+      const content = readFileSync3(absPath, "utf8");
       const diskHash = sha256(content);
       if (node.hash !== "" && node.hash !== diskHash) {
         hashMismatchEntries.push(contentRef);
@@ -3286,7 +3423,7 @@ async function inspectMetaManuallyDiverged(projectRoot) {
 }
 function inspectKnowledgeDirUnindexed(projectRoot, meta) {
   const physicalMdFiles = /* @__PURE__ */ new Set();
-  collectMdFilesUnder(physicalMdFiles, projectRoot, join6(projectRoot, ".fabric", "knowledge"), ".fabric/knowledge");
+  collectMdFilesUnder(physicalMdFiles, projectRoot, join7(projectRoot, ".fabric", "knowledge"), ".fabric/knowledge");
   if (physicalMdFiles.size === 0) {
     return { unindexedFiles: [] };
   }
@@ -3301,7 +3438,7 @@ function inspectKnowledgeDirUnindexed(projectRoot, meta) {
   return { unindexedFiles };
 }
 function collectMdFilesUnder(out, projectRoot, rootDir, relPrefix) {
-  if (!existsSync4(rootDir)) {
+  if (!existsSync5(rootDir)) {
     return;
   }
   const stack = [rootDir];
@@ -3311,7 +3448,7 @@ function collectMdFilesUnder(out, projectRoot, rootDir, relPrefix) {
       continue;
     }
     for (const entry of readdirSync(dir, { withFileTypes: true })) {
-      const abs = join6(dir, entry.name);
+      const abs = join7(dir, entry.name);
       if (entry.isDirectory()) {
         if (entry.name !== "pending" && entry.name !== "archive") {
           stack.push(abs);
@@ -3344,8 +3481,8 @@ function createKnowledgeDirUnindexedCheck(t, inspection) {
 }
 async function inspectStableIdCollisions(projectRoot) {
   const found = [];
-  const knowledgeDir = join6(projectRoot, ".fabric", "knowledge");
-  if (existsSync4(knowledgeDir)) {
+  const knowledgeDir = join7(projectRoot, ".fabric", "knowledge");
+  if (existsSync5(knowledgeDir)) {
     const stack = [knowledgeDir];
     while (stack.length > 0) {
       const dir = stack.pop();
@@ -3353,7 +3490,7 @@ async function inspectStableIdCollisions(projectRoot) {
         continue;
       }
       for (const entry of readdirSync(dir, { withFileTypes: true })) {
-        const abs = join6(dir, entry.name);
+        const abs = join7(dir, entry.name);
         if (entry.isDirectory()) {
           stack.push(abs);
         } else if (entry.isFile() && entry.name.endsWith(".md")) {
@@ -3418,11 +3555,11 @@ function inspectCounterDesync(meta) {
     }
     const layer = parsed.layer === "personal" ? "KP" : "KT";
     const typeCode = [
-      ["model", "MOD"],
-      ["decision", "DEC"],
-      ["guideline", "GLD"],
-      ["pitfall", "PIT"],
-      ["process", "PRO"]
+      ["models", "MOD"],
+      ["decisions", "DEC"],
+      ["guidelines", "GLD"],
+      ["pitfalls", "PIT"],
+      ["processes", "PRO"]
     ].find(([t]) => t === parsed.type)?.[1];
     if (typeCode === void 0) {
       continue;
@@ -3532,18 +3669,18 @@ function createMetaManuallyDivergedCheck(t, inspection) {
 }
 function inspectPreexistingRootFiles(projectRoot) {
   const candidates = ["CLAUDE.md", "AGENTS.md"];
-  const detected = candidates.filter((name) => existsSync4(join6(projectRoot, name)));
+  const detected = candidates.filter((name) => existsSync5(join7(projectRoot, name)));
   return { detected };
 }
 async function inspectFilesystemEditFallback(projectRoot) {
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
-  if (!existsSync4(knowledgeRoot)) {
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
+  if (!existsSync5(knowledgeRoot)) {
     return { synthesized: 0, synthesizedStableIds: [] };
   }
   const canonicalIds = /* @__PURE__ */ new Set();
   for (const typeDir of KNOWLEDGE_CANONICAL_TYPE_DIRS) {
-    const dir = join6(knowledgeRoot, typeDir);
-    if (!existsSync4(dir)) {
+    const dir = join7(knowledgeRoot, typeDir);
+    if (!existsSync5(dir)) {
       continue;
     }
     let entries;
@@ -3583,17 +3720,40 @@ async function inspectFilesystemEditFallback(projectRoot) {
   }
   orphanIds.sort();
   for (const stable_id of orphanIds) {
-    await appendEventLedgerEvent(projectRoot, {
-      event_type: "knowledge_promoted",
-      stable_id,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      reason: SYNTHESIZED_PROMOTED_REASON,
-      correlation_id: "doctor-synthesized",
-      session_id: "doctor-synthesized"
-    });
+    await emitSynthesizedPromotionTriplet(projectRoot, stable_id);
   }
   return { synthesized: orphanIds.length, synthesizedStableIds: orphanIds };
 }
+async function emitSynthesizedPromotionTriplet(projectRoot, stable_id) {
+  const baseTs = Date.now();
+  await appendEventLedgerEvent(projectRoot, {
+    event_type: "knowledge_proposed",
+    stable_id,
+    timestamp: new Date(baseTs).toISOString(),
+    reason: SYNTHESIZED_PROMOTED_REASON,
+    correlation_id: "doctor-synthesized",
+    session_id: "doctor-synthesized",
+    ts: baseTs
+  });
+  await appendEventLedgerEvent(projectRoot, {
+    event_type: "knowledge_promote_started",
+    stable_id,
+    timestamp: new Date(baseTs + 1).toISOString(),
+    reason: SYNTHESIZED_PROMOTED_REASON,
+    correlation_id: "doctor-synthesized",
+    session_id: "doctor-synthesized",
+    ts: baseTs + 1
+  });
+  await appendEventLedgerEvent(projectRoot, {
+    event_type: "knowledge_promoted",
+    stable_id,
+    timestamp: new Date(baseTs + 2).toISOString(),
+    reason: SYNTHESIZED_PROMOTED_REASON,
+    correlation_id: "doctor-synthesized",
+    session_id: "doctor-synthesized",
+    ts: baseTs + 2
+  });
+}
 function createFilesystemEditFallbackCheck(t, inspection) {
   if (inspection.synthesized === 0) {
     return okCheck(
@@ -3752,13 +3912,13 @@ function extractKnowledgeFrontmatterCreatedAt(source) {
   return Number.isFinite(parsed) ? parsed : null;
 }
 function* iterateCanonicalEntries(projectRoot, lastActiveIndex) {
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
-  if (!existsSync4(knowledgeRoot)) {
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
+  if (!existsSync5(knowledgeRoot)) {
     return;
   }
   for (const typeDir of KNOWLEDGE_CANONICAL_TYPE_DIRS) {
-    const dir = join6(knowledgeRoot, typeDir);
-    if (!existsSync4(dir)) {
+    const dir = join7(knowledgeRoot, typeDir);
+    if (!existsSync5(dir)) {
       continue;
     }
     let entries;
@@ -3776,10 +3936,10 @@ function* iterateCanonicalEntries(projectRoot, lastActiveIndex) {
         continue;
       }
       const stableId = match[1];
-      const absPath = join6(dir, entry.name);
+      const absPath = join7(dir, entry.name);
       let source;
       try {
-        source = readFileSync2(absPath, "utf8");
+        source = readFileSync3(absPath, "utf8");
       } catch {
         continue;
       }
@@ -3852,13 +4012,13 @@ async function inspectStaleArchive(projectRoot, now) {
   return { candidates };
 }
 function* iteratePendingFiles(projectRoot, now) {
-  const teamRoot = join6(projectRoot, ".fabric", "knowledge", "pending");
-  const personalRoot = join6(resolvePersonalRootForPending(), ".fabric", "knowledge", "pending");
+  const teamRoot = join7(projectRoot, ".fabric", "knowledge", "pending");
+  const personalRoot = join7(resolvePersonalRootForPending(), ".fabric", "knowledge", "pending");
   for (const [layer, root, displayPrefix] of [
     ["team", teamRoot, ".fabric/knowledge/pending"],
     ["personal", personalRoot, "~/.fabric/knowledge/pending"]
   ]) {
-    if (!existsSync4(root)) {
+    if (!existsSync5(root)) {
       continue;
     }
     let typeDirs = [];
@@ -3868,7 +4028,7 @@ function* iteratePendingFiles(projectRoot, now) {
       continue;
     }
     for (const typeDir of typeDirs) {
-      const dir = join6(root, typeDir);
+      const dir = join7(root, typeDir);
       let entries;
       try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -3879,10 +4039,10 @@ function* iteratePendingFiles(projectRoot, now) {
         if (!entry.isFile() || !entry.name.endsWith(".md")) {
           continue;
         }
-        const absPath = join6(dir, entry.name);
+        const absPath = join7(dir, entry.name);
         let source = "";
         try {
-          source = readFileSync2(absPath, "utf8");
+          source = readFileSync3(absPath, "utf8");
         } catch {
           continue;
         }
@@ -3954,7 +4114,7 @@ function inspectPendingAutoArchive(projectRoot, now) {
         pending_path: visit.pending_path,
         pending_path_abs: visit.pending_path_abs,
         archived_to: archivedToRel,
-        archived_to_abs: join6(projectRoot, archivedToRel),
+        archived_to_abs: join7(projectRoot, archivedToRel),
         age_days: visit.age_days
       });
     } else {
@@ -3963,7 +4123,7 @@ function inspectPendingAutoArchive(projectRoot, now) {
         visit.type,
         visit.filename
       );
-      const archivedToAbs = join6(
+      const archivedToAbs = join7(
         resolvePersonalRootForPending(),
         ".fabric",
         ".archive",
@@ -3987,12 +4147,12 @@ function inspectPendingAutoArchive(projectRoot, now) {
 }
 function inspectUnderseeded(projectRoot) {
   const threshold = readUnderseedThresholdFromConfig(projectRoot);
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
   let nodeCount = 0;
-  if (existsSync4(knowledgeRoot)) {
+  if (existsSync5(knowledgeRoot)) {
     for (const typeDir of KNOWLEDGE_CANONICAL_TYPE_DIRS) {
-      const dir = join6(knowledgeRoot, typeDir);
-      if (!existsSync4(dir)) continue;
+      const dir = join7(knowledgeRoot, typeDir);
+      if (!existsSync5(dir)) continue;
       let entries;
       try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -4013,8 +4173,8 @@ function inspectUnderseeded(projectRoot) {
   };
 }
 function inspectSessionHintsStale(projectRoot, now) {
-  const cacheDir = join6(projectRoot, ".fabric", ".cache");
-  if (!existsSync4(cacheDir)) {
+  const cacheDir = join7(projectRoot, ".fabric", ".cache");
+  if (!existsSync5(cacheDir)) {
     return { candidates: [] };
   }
   let entries;
@@ -4028,7 +4188,7 @@ function inspectSessionHintsStale(projectRoot, now) {
     if (!entry.isFile()) continue;
     if (!entry.name.startsWith(SESSION_HINTS_FILE_PREFIX)) continue;
     if (!entry.name.endsWith(SESSION_HINTS_FILE_SUFFIX)) continue;
-    const absPath = join6(cacheDir, entry.name);
+    const absPath = join7(cacheDir, entry.name);
     let mtimeMs = 0;
     try {
       mtimeMs = statSync4(absPath).mtimeMs;
@@ -4072,11 +4232,11 @@ function inspectNarrowTooFew(projectRoot, now) {
   const structuralFlagged = total >= NARROW_MIN_TOTAL && narrowRatio < NARROW_RATIO_THRESHOLD;
   const windowStartMs = now - SILENCE_WINDOW_DAYS * MS_PER_DAY;
   const editFires = readCounterTimestamps(
-    join6(projectRoot, EDIT_COUNTER_FILE_REL),
+    join7(projectRoot, EDIT_COUNTER_FILE_REL),
     windowStartMs
   );
   const silenceFires = readCounterTimestamps(
-    join6(projectRoot, HINT_SILENCE_COUNTER_FILE_REL),
+    join7(projectRoot, HINT_SILENCE_COUNTER_FILE_REL),
     windowStartMs
   );
   const telemetrySkipped = editFires === 0;
@@ -4095,10 +4255,10 @@ function inspectNarrowTooFew(projectRoot, now) {
   };
 }
 function readCounterTimestamps(absPath, windowStartMs) {
-  if (!existsSync4(absPath)) return 0;
+  if (!existsSync5(absPath)) return 0;
   let raw;
   try {
-    raw = readFileSync2(absPath, "utf8");
+    raw = readFileSync3(absPath, "utf8");
   } catch {
     return 0;
   }
@@ -4114,10 +4274,10 @@ function readCounterTimestamps(absPath, windowStartMs) {
   return count;
 }
 function readUnderseedThresholdFromConfig(projectRoot) {
-  const configPath = join6(projectRoot, ".fabric", "fabric-config.json");
-  if (!existsSync4(configPath)) return DEFAULT_UNDERSEED_NODE_THRESHOLD;
+  const configPath = join7(projectRoot, ".fabric", "fabric-config.json");
+  if (!existsSync5(configPath)) return DEFAULT_UNDERSEED_NODE_THRESHOLD;
   try {
-    const raw = readFileSync2(configPath, "utf8");
+    const raw = readFileSync3(configPath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       const v = parsed.underseed_node_threshold;
@@ -4311,11 +4471,11 @@ function extractKnowledgeFrontmatterRelevancePaths(source) {
 }
 function* iterateRelevanceFrontmatter(projectRoot) {
   for (const visit of iterateCanonicalFilenames(projectRoot)) {
-    const layerRoot = visit.layer === "team" ? join6(projectRoot, ".fabric", "knowledge") : resolvePersonalKnowledgeRoot();
-    const absPath = join6(layerRoot, visit.type, visit.filename);
+    const layerRoot = visit.layer === "team" ? join7(projectRoot, ".fabric", "knowledge") : resolvePersonalKnowledgeRoot();
+    const absPath = join7(layerRoot, visit.type, visit.filename);
     let source;
     try {
-      source = readFileSync2(absPath, "utf8");
+      source = readFileSync3(absPath, "utf8");
     } catch {
       continue;
     }
@@ -4377,7 +4537,7 @@ function inspectRelevancePathsDangling(projectRoot) {
   return { entries };
 }
 function collectWorkspacePathsForGlobMatch(projectRoot) {
-  if (!existsSync4(projectRoot)) {
+  if (!existsSync5(projectRoot)) {
     return [];
   }
   let rootStat;
@@ -4401,7 +4561,7 @@ function collectWorkspacePathsForGlobMatch(projectRoot) {
       continue;
     }
     for (const entry of entries) {
-      const abs = join6(current, entry.name);
+      const abs = join7(current, entry.name);
       const rel = normalizePath(abs.slice(projectRoot.length + 1));
       if (rel.length === 0) continue;
       if (entry.isDirectory()) {
@@ -4558,8 +4718,8 @@ function inspectRelevanceFieldsMissing(projectRoot) {
   const candidates = [];
   let scannedCount = 0;
   const FM_PATTERN = /^(?:\uFEFF)?---\r?\n([\s\S]*?)\r?\n---/u;
-  const teamRoot = join6(projectRoot, ".fabric", "knowledge", "pending");
-  const personalRoot = join6(
+  const teamRoot = join7(projectRoot, ".fabric", "knowledge", "pending");
+  const personalRoot = join7(
     resolvePersonalRootForPending(),
     ".fabric",
     "knowledge",
@@ -4569,7 +4729,7 @@ function inspectRelevanceFieldsMissing(projectRoot) {
     [teamRoot, ".fabric/knowledge/pending"],
     [personalRoot, "~/.fabric/knowledge/pending"]
   ]) {
-    if (!existsSync4(root)) {
+    if (!existsSync5(root)) {
       continue;
     }
     let typeDirs = [];
@@ -4579,7 +4739,7 @@ function inspectRelevanceFieldsMissing(projectRoot) {
       continue;
     }
     for (const typeDir of typeDirs) {
-      const dir = join6(root, typeDir);
+      const dir = join7(root, typeDir);
       let entries;
       try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -4590,10 +4750,10 @@ function inspectRelevanceFieldsMissing(projectRoot) {
         if (!entry.isFile() || !entry.name.endsWith(".md")) {
           continue;
         }
-        const absPath = join6(dir, entry.name);
+        const absPath = join7(dir, entry.name);
         let source;
         try {
-          source = readFileSync2(absPath, "utf8");
+          source = readFileSync3(absPath, "utf8");
         } catch {
           continue;
         }
@@ -4725,8 +4885,8 @@ var SKILL_QUOTED_VALUE_LEADS = /* @__PURE__ */ new Set(['"', "'", "[", "{", ">",
 function inspectSkillMdYamlInvalid(projectRoot) {
   const candidates = [];
   for (const rootRel of SKILL_MD_FRONTMATTER_ROOTS) {
-    const rootAbs = join6(projectRoot, rootRel);
-    if (!existsSync4(rootAbs)) continue;
+    const rootAbs = join7(projectRoot, rootRel);
+    if (!existsSync5(rootAbs)) continue;
     let dirEntries;
     try {
       dirEntries = readdirSync(rootAbs, { withFileTypes: true });
@@ -4735,11 +4895,11 @@ function inspectSkillMdYamlInvalid(projectRoot) {
     }
     for (const dirEntry of dirEntries) {
       if (!dirEntry.isDirectory()) continue;
-      const skillFile = join6(rootAbs, dirEntry.name, "SKILL.md");
-      if (!existsSync4(skillFile)) continue;
+      const skillFile = join7(rootAbs, dirEntry.name, "SKILL.md");
+      if (!existsSync5(skillFile)) continue;
       let raw;
       try {
-        raw = readFileSync2(skillFile, "utf8");
+        raw = readFileSync3(skillFile, "utf8");
       } catch {
         continue;
       }
@@ -4821,11 +4981,11 @@ function inspectOnboardCoverage(projectRoot) {
   for (const slot of ONBOARD_SLOT_NAMES) {
     filled[slot] = [];
   }
-  const knowledgeRoot = join6(projectRoot, ".fabric", "knowledge");
-  if (existsSync4(knowledgeRoot)) {
+  const knowledgeRoot = join7(projectRoot, ".fabric", "knowledge");
+  if (existsSync5(knowledgeRoot)) {
     for (const typeDir of KNOWLEDGE_CANONICAL_TYPE_DIRS_FOR_ONBOARD) {
-      const dir = join6(knowledgeRoot, typeDir);
-      if (!existsSync4(dir)) continue;
+      const dir = join7(knowledgeRoot, typeDir);
+      if (!existsSync5(dir)) continue;
       let entries;
       try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -4835,10 +4995,10 @@ function inspectOnboardCoverage(projectRoot) {
       for (const entry of entries) {
         if (!entry.isFile()) continue;
         if (!entry.name.endsWith(".md")) continue;
-        const filePath = join6(dir, entry.name);
+        const filePath = join7(dir, entry.name);
         let content;
         try {
-          content = readFileSync2(filePath, "utf8");
+          content = readFileSync3(filePath, "utf8");
         } catch {
           continue;
         }
@@ -4862,11 +5022,11 @@ function inspectOnboardCoverage(projectRoot) {
   return { filled, missing, opted_out: optedOut };
 }
 function readOnboardOptedOut(projectRoot) {
-  const path2 = join6(projectRoot, ".fabric", "fabric-config.json");
-  if (!existsSync4(path2)) return [];
+  const path2 = join7(projectRoot, ".fabric", "fabric-config.json");
+  if (!existsSync5(path2)) return [];
   let raw;
   try {
-    raw = readFileSync2(path2, "utf8");
+    raw = readFileSync3(path2, "utf8");
   } catch {
     return [];
   }
@@ -4982,7 +5142,7 @@ function createNarrowTooFewCheck(t, inspection) {
 }
 function resolvePersonalKnowledgeRoot() {
   const home = process.env.FABRIC_HOME ?? homedir3();
-  return join6(home, ".fabric", "knowledge");
+  return join7(home, ".fabric", "knowledge");
 }
 function parseStableIdFromCanonicalFilename(filename) {
   const match = CANONICAL_KNOWLEDGE_FILENAME_PATTERN.exec(filename);
@@ -5002,18 +5162,18 @@ function parseStableIdFromCanonicalFilename(filename) {
   };
 }
 function* iterateCanonicalFilenames(projectRoot) {
-  const teamRoot = join6(projectRoot, ".fabric", "knowledge");
+  const teamRoot = join7(projectRoot, ".fabric", "knowledge");
   const personalRoot = resolvePersonalKnowledgeRoot();
   for (const [layer, root, displayPrefix] of [
     ["team", teamRoot, ".fabric/knowledge"],
     ["personal", personalRoot, "~/.fabric/knowledge"]
   ]) {
-    if (!existsSync4(root)) {
+    if (!existsSync5(root)) {
       continue;
     }
     for (const typeDir of KNOWLEDGE_CANONICAL_TYPE_DIRS) {
-      const dir = join6(root, typeDir);
-      if (!existsSync4(dir)) {
+      const dir = join7(root, typeDir);
+      if (!existsSync5(dir)) {
         continue;
       }
       let entries;
@@ -5184,8 +5344,8 @@ async function migrateBootstrapMarkers(projectRoot) {
   const paths = [];
   const countPerPath = {};
   for (const rel of BOOTSTRAP_MARKER_MIGRATION_TARGETS) {
-    const abs = join6(projectRoot, rel);
-    if (!existsSync4(abs)) {
+    const abs = join7(projectRoot, rel);
+    if (!existsSync5(abs)) {
       continue;
     }
     let original;
@@ -5211,8 +5371,8 @@ async function migrateBootstrapMarkers(projectRoot) {
   return { paths, countPerPath };
 }
 async function rewriteThreeEndManagedBlocks(projectRoot) {
-  const snapshotPath = join6(projectRoot, ".fabric", "AGENTS.md");
-  if (!existsSync4(snapshotPath)) {
+  const snapshotPath = join7(projectRoot, ".fabric", "AGENTS.md");
+  if (!existsSync5(snapshotPath)) {
     return;
   }
   let snapshot;
@@ -5221,8 +5381,8 @@ async function rewriteThreeEndManagedBlocks(projectRoot) {
   } catch {
     return;
   }
-  const projectRulesPath = join6(projectRoot, ".fabric", "project-rules.md");
-  const hasProjectRules = existsSync4(projectRulesPath);
+  const projectRulesPath = join7(projectRoot, ".fabric", "project-rules.md");
+  const hasProjectRules = existsSync5(projectRulesPath);
   let expectedBody = snapshot;
   if (hasProjectRules) {
     try {
@@ -5237,11 +5397,11 @@ ${projectRules}`;
 ${expectedBody}
 ${BOOTSTRAP_MARKER_END}`;
   const blockTargets = [
-    join6(projectRoot, "AGENTS.md"),
-    join6(projectRoot, ".cursor", "rules", "fabric-bootstrap.mdc")
+    join7(projectRoot, "AGENTS.md"),
+    join7(projectRoot, ".cursor", "rules", "fabric-bootstrap.mdc")
   ];
   for (const abs of blockTargets) {
-    if (!existsSync4(abs)) {
+    if (!existsSync5(abs)) {
       continue;
     }
     let existing;
@@ -5271,8 +5431,8 @@ ${managedBlock}
     }
     await atomicWriteText4(abs, next);
   }
-  const claudeMdPath = join6(projectRoot, "CLAUDE.md");
-  if (existsSync4(claudeMdPath)) {
+  const claudeMdPath = join7(projectRoot, "CLAUDE.md");
+  if (existsSync5(claudeMdPath)) {
     let claudeContent;
     try {
       claudeContent = await readFile5(claudeMdPath, "utf8");
@@ -5300,13 +5460,13 @@ ${managedBlock}
   }
 }
 async function fixMcpConfigInWrongFile(projectRoot) {
-  const settingsPath = join6(projectRoot, ".claude", "settings.json");
-  if (!existsSync4(settingsPath)) {
+  const settingsPath = join7(projectRoot, ".claude", "settings.json");
+  if (!existsSync5(settingsPath)) {
     return;
   }
   let settings;
   try {
-    const parsed = JSON.parse(readFileSync2(settingsPath, "utf8"));
+    const parsed = JSON.parse(readFileSync3(settingsPath, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       return;
     }
@@ -5334,12 +5494,12 @@ async function fixMcpConfigInWrongFile(projectRoot) {
 }
 async function ensureKnowledgeSubdirs(projectRoot) {
   for (const sub of KNOWLEDGE_SUBDIRS3) {
-    await mkdir4(join6(projectRoot, ".fabric", "knowledge", sub), { recursive: true });
+    await mkdir4(join7(projectRoot, ".fabric", "knowledge", sub), { recursive: true });
   }
 }
 async function fixCounterDesync(projectRoot) {
-  const metaPath = join6(projectRoot, ".fabric", "agents.meta.json");
-  if (!existsSync4(metaPath)) {
+  const metaPath = join7(projectRoot, ".fabric", "agents.meta.json");
+  if (!existsSync5(metaPath)) {
     return;
   }
   let meta;
@@ -5757,8 +5917,8 @@ async function runDoctorCiteCoverage(projectRoot, options) {
           continue;
         }
         bumpLayerType(citeId, kbType);
-        if (kbType === "decision" || kbType === "pitfall") {
-          if (kbType === "decision") decisionsCited += 1;
+        if (kbType === "decisions" || kbType === "pitfalls") {
+          if (kbType === "decisions") decisionsCited += 1;
           else pitfallsCited += 1;
           const commitment = commitments[i];
           const operators = commitment?.operators ?? [];
@@ -5922,7 +6082,7 @@ function normalizePath(path2) {
   return posix.normalize(path2.split("\\").join("/"));
 }
 function collectEntryPoints(root) {
-  if (!existsSync4(root) || !statSync4(root).isDirectory()) {
+  if (!existsSync5(root) || !statSync4(root).isDirectory()) {
     return [];
   }
   const entries = [];
@@ -5933,7 +6093,7 @@ function collectEntryPoints(root) {
       continue;
     }
     for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const absolutePath = join6(current, entry.name);
+      const absolutePath = join7(current, entry.name);
       const relativePath = normalizePath(absolutePath.slice(root.length + 1));
       if (relativePath.length === 0) {
         continue;
@@ -5999,14 +6159,14 @@ var ENRICH_DESC_FIELD_PATTERNS = {
 async function enrichDescriptions(projectRoot, opts = {}) {
   const auto = opts.auto === true;
   const dryRun = opts.dryRun === true;
-  const mode = auto ? "auto" : "interactive";
+  const mode = auto ? dryRun ? "preview" : "auto" : "readonly";
   const candidates = [];
   let scanned = 0;
   let modified = 0;
   let skipped = 0;
   for (const visit of iterateCanonicalFilenames(projectRoot)) {
-    const layerRoot = visit.layer === "team" ? join6(projectRoot, ".fabric", "knowledge") : resolvePersonalKnowledgeRoot();
-    const absPath = join6(layerRoot, visit.type, visit.filename);
+    const layerRoot = visit.layer === "team" ? join7(projectRoot, ".fabric", "knowledge") : resolvePersonalKnowledgeRoot();
+    const absPath = join7(layerRoot, visit.type, visit.filename);
     scanned += 1;
     let source;
     try {
@@ -6209,7 +6369,7 @@ async function emitAutoHealEventBestEffort(projectRoot, payload) {
 
 // src/services/get-knowledge.ts
 import { readFile as readFile6 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 import { minimatch as minimatch2 } from "minimatch";
 var PRIORITY_ORDER = {
   high: 0,
@@ -6253,7 +6413,7 @@ async function loadGetKnowledgeContext(projectRoot) {
     return cached;
   }
   const meta = await readAgentsMeta(projectRoot);
-  const l0Content = await readFile6(join7(projectRoot, ".fabric", "bootstrap", "README.md"), "utf8");
+  const l0Content = await readFile6(join8(projectRoot, ".fabric", "bootstrap", "README.md"), "utf8");
   const context = {
     meta,
     l0Content,
@@ -6392,7 +6552,7 @@ async function readRuleContent(projectRoot, file, fileContentCache) {
   if (cached !== void 0) {
     return await cached;
   }
-  const pending = readFile6(join7(projectRoot, file), "utf8");
+  const pending = readFile6(join8(projectRoot, file), "utf8");
   fileContentCache.set(file, pending);
   return await pending;
 }
@@ -6427,6 +6587,8 @@ export {
   invalidateKnowledgeSyncCooldown,
   ensureKnowledgeFresh,
   reconcileKnowledge,
+  readPayloadLimits,
+  readSelectionTokenTtlMs,
   loadActiveMeta,
   loadActiveMetaOrStale,
   getKnowledge,