@fenglimg/fabric-server 2.0.0-rc.15 → 2.0.0-rc.22

package/dist/{http-FCXAUGSO.js → http-FF5NZCJK.js}

@@ -14,7 +14,7 @@ import {
   readEventLedger,
   runDoctorReport,
   sha256
-} from "./chunk-3ZBYYPXQ.js";
+} from "./chunk-7N3FW5LX.js";
 
 // src/http.ts
 import { randomUUID as randomUUID2 } from "crypto";

package/dist/index.d.ts

@@ -97,6 +97,27 @@ type DoctorApplyLintReport = {
 declare function runDoctorReport(target: string): Promise<DoctorReport>;
 declare function runDoctorFix(target: string): Promise<DoctorFixReport>;
 declare function runDoctorApplyLint(target: string): Promise<DoctorApplyLintReport>;
+type CiteCoverageReport = {
+    status: "ok" | "skipped";
+    marker_ts: number;
+    marker_emitted_now: boolean;
+    since_ts: number;
+    client_filter: "cc" | "codex" | "cursor" | "all";
+    metrics: {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    };
+    per_client?: Record<string, Partial<CiteCoverageReport["metrics"]>>;
+    dismissed_reason_histogram?: Record<string, number>;
+    generated_at: string;
+};
+declare function runDoctorCiteCoverage(projectRoot: string, options: {
+    since: number;
+    client: "cc" | "codex" | "cursor" | "all";
+}): Promise<CiteCoverageReport>;
 
 type KnowledgeMetaBuildSource = "doctor_fix" | "sync_meta";
 type KnowledgeMetaBuildResult = {
@@ -235,6 +256,8 @@ type PlanContextResult = {
             path?: string;
         }>;
     };
+    auto_healed?: boolean;
+    previous_revision_hash?: string;
 };
 type SelectionTokenState = {
     token: string;
@@ -382,4 +405,4 @@ declare function startHttpServer(options: {
     authToken?: string;
 }): Promise<Server>;
 
-export { AGENTS_MD_RESOURCE_URI, type AcquireOptions, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type InFlightTracker, KnowledgeIdAllocator, type KnowledgeMetaBuildResult, type KnowledgeMetaBuildSource, type KnowledgeSyncLedgerEvent, type KnowledgeSyncOptions, type KnowledgeSyncReport, LEDGER_PATH, LEGACY_LEDGER_PATH, type LedgerEvent, type LockState, type PlanContextInput, type PlanContextResult, type ReconcileKnowledgeOptions, type RequirementProfile, type SelectionTokenState, ServeLockHeldError, type ShutdownHandlerDeps, type StructuredWarning, type WriteKnowledgeMetaOptions, acquireLock, appendEventLedgerEvent, buildKnowledgeMeta, checkLockOrThrow, computeKnowledgeBasedAgentsMeta, computeKnowledgeTestIndex, createFabricServer, createInFlightTracker, createShutdownHandler, deriveKnowledgeMetaLayer, deriveKnowledgeMetaTopologyType, ensureKnowledgeFresh, extractKnowledge, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameKnowledgeTestIndex, planContext, readLockState, readSelectionToken, reconcileKnowledge, releaseLock, reviewKnowledge, runDoctorApplyLint, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeKnowledgeMeta };
+export { AGENTS_MD_RESOURCE_URI, type AcquireOptions, type CiteCoverageReport, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type InFlightTracker, KnowledgeIdAllocator, type KnowledgeMetaBuildResult, type KnowledgeMetaBuildSource, type KnowledgeSyncLedgerEvent, type KnowledgeSyncOptions, type KnowledgeSyncReport, LEDGER_PATH, LEGACY_LEDGER_PATH, type LedgerEvent, type LockState, type PlanContextInput, type PlanContextResult, type ReconcileKnowledgeOptions, type RequirementProfile, type SelectionTokenState, ServeLockHeldError, type ShutdownHandlerDeps, type StructuredWarning, type WriteKnowledgeMetaOptions, acquireLock, appendEventLedgerEvent, buildKnowledgeMeta, checkLockOrThrow, computeKnowledgeBasedAgentsMeta, computeKnowledgeTestIndex, createFabricServer, createInFlightTracker, createShutdownHandler, deriveKnowledgeMetaLayer, deriveKnowledgeMetaTopologyType, ensureKnowledgeFresh, extractKnowledge, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameKnowledgeTestIndex, planContext, readLockState, readSelectionToken, reconcileKnowledge, releaseLock, reviewKnowledge, runDoctorApplyLint, runDoctorCiteCoverage, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeKnowledgeMeta };

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  AgentsMetaFileMissingError,
   EVENT_LEDGER_PATH,
   LEDGER_PATH,
   LEGACY_LEDGER_PATH,
@@ -16,17 +17,19 @@ import {
   getLedgerPath,
   getLegacyLedgerPath,
   isSameKnowledgeTestIndex,
+  loadActiveMeta,
+  loadActiveMetaOrStale,
   normalizeKnowledgePath,
-  readAgentsMeta,
   reconcileKnowledge,
   resolveProjectRoot,
   runDoctorApplyLint,
+  runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorReport,
   sha256,
   stableStringify,
   writeKnowledgeMeta
-} from "./chunk-3ZBYYPXQ.js";
+} from "./chunk-7N3FW5LX.js";
 
 // src/index.ts
 import { existsSync as existsSync4 } from "fs";
@@ -122,6 +125,13 @@ function resolvePersonalRoot() {
   return process.env.FABRIC_HOME ?? homedir();
 }
 async function extractKnowledge(projectRoot, input) {
+  try {
+    await loadActiveMeta(projectRoot, { caller: "extractKnowledge" });
+  } catch (error) {
+    if (!(error instanceof AgentsMetaFileMissingError)) {
+      throw error;
+    }
+  }
   const sanitizedSlug = sanitizeSlug(input.slug);
   const sourceSessions = Array.isArray(input.source_sessions) && input.source_sessions.length > 0 ? input.source_sessions : input.source_session !== void 0 && input.source_session.length > 0 ? [input.source_session] : [];
   const primarySession = sourceSessions[0] ?? "";
@@ -454,8 +464,9 @@ import { deriveAgentsMetaLayer } from "@fenglimg/fabric-shared";
 var SELECTION_TOKEN_TTL_MS = 5 * 60 * 1e3;
 var selectionTokenCache = /* @__PURE__ */ new Map();
 async function planContext(projectRoot, input) {
-  const meta = await readAgentsMeta(projectRoot);
-  const stale = input.client_hash !== void 0 && input.client_hash !== meta.revision;
+  const metaResult = await loadActiveMetaOrStale(projectRoot, { caller: "planContext" });
+  const meta = metaResult.meta;
+  const stale = metaResult.degraded === true || input.client_hash !== void 0 && input.client_hash !== meta.revision;
   const uniquePaths = dedupePaths(input.paths);
   const allDescriptions = buildDescriptionIndex(meta);
   const relevanceTargetPaths = input.target_paths ?? uniquePaths;
@@ -479,7 +490,14 @@ async function planContext(projectRoot, input) {
     shared: {
       description_index: sharedDescriptionIndex,
       preflight_diagnostics: buildPreflightDiagnostics(meta)
-    }
+    },
+    // v2.0.0-rc.22 Scope D T-D2: surface auto-heal pair only when a heal
+    // actually fired. Keeping these fields absent on the steady-state path
+    // means existing consumers see the same wire shape they always have.
+    ...metaResult.auto_healed ? {
+      auto_healed: true,
+      previous_revision_hash: metaResult.previous_revision_hash
+    } : {}
   };
   try {
     await appendEventLedgerEvent(projectRoot, {
@@ -1567,7 +1585,7 @@ async function getKnowledgeSections(projectRoot, input) {
     throw new Error("selection_token is missing or expired");
   }
   validateAiSelections(token.ai_selectable_stable_ids, input.ai_selected_stable_ids, input.ai_selection_reasons);
-  const meta = await readAgentsMeta(projectRoot);
+  const { meta } = await loadActiveMeta(projectRoot, { caller: "getKnowledgeSections" });
   const selectedStableIds = [...token.required_stable_ids, ...input.ai_selected_stable_ids];
   const selectedRules = sortRuleNodes(selectedStableIds.map((stableId) => findRuleNode(meta, stableId)));
   const diagnostics = [];
@@ -1892,7 +1910,7 @@ function formatPreexistingRootMessage(projectRoot) {
 function createFabricServer(tracker) {
   const server = new McpServer({
     name: "fabric-knowledge-server",
-    version: "2.0.0-rc.15"
+    version: "2.0.0-rc.22"
   });
   registerPlanContext(server, tracker);
   registerKnowledgeSections(server, tracker);
@@ -1992,7 +2010,7 @@ function createShutdownHandler(deps) {
   };
 }
 async function startHttpServer(options) {
-  const { createFabricHttpApp } = await import("./http-FCXAUGSO.js");
+  const { createFabricHttpApp } = await import("./http-FF5NZCJK.js");
   const { port, projectRoot, host = "127.0.0.1", authToken } = options;
   const app = createFabricHttpApp({ projectRoot, host, authToken });
   return await new Promise((resolveServer, rejectServer) => {
@@ -2050,6 +2068,7 @@ export {
   releaseLock,
   reviewKnowledge,
   runDoctorApplyLint,
+  runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorReport,
   stableStringify,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-server",
-  "version": "2.0.0-rc.15",
+  "version": "2.0.0-rc.22",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,7 +13,7 @@
     "express": "^5.2.1",
     "minimatch": "^10.0.1",
     "zod": "^3.25.0",
-    "@fenglimg/fabric-shared": "2.0.0-rc.15"
+    "@fenglimg/fabric-shared": "2.0.0-rc.22"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",