@fenglimg/fabric-server 2.0.0-rc.23 → 2.0.0-rc.26

package/dist/{http-ZBV6YUHD.js → http-FMSBWYMO.js}

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Server } from 'node:http';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { AgentsMeta, KnowledgeTestIndex, AgentsLayer, AgentsTopologyType, Layer, KnowledgeType, StableId, AgentsMetaCounters, EventLedgerEventInput, EventLedgerEvent, RuleDescriptionIndexItem } from '@fenglimg/fabric-shared';
+import { AgentsMeta, KnowledgeTestIndex, AgentsLayer, AgentsTopologyType, KnowledgeType, Layer, StableId, AgentsMetaCounters, EventLedgerEventInput, EventLedgerEvent, RuleDescriptionIndexItem } from '@fenglimg/fabric-shared';
 import { FabExtractKnowledgeInput, FabExtractKnowledgeOutput, FabReviewInput, FabReviewOutput } from '@fenglimg/fabric-shared/schemas/api-contracts';
 import { IOFabricError } from '@fenglimg/fabric-shared/errors';
 
@@ -38,6 +38,7 @@ type DoctorIssue = {
     name: string;
     message: string;
     path?: string;
+    actionHint?: string;
 };
 type DoctorSummary = {
     target: string;
@@ -97,12 +98,26 @@ type DoctorApplyLintReport = {
 declare function runDoctorReport(target: string): Promise<DoctorReport>;
 declare function runDoctorFix(target: string): Promise<DoctorFixReport>;
 declare function runDoctorApplyLint(target: string): Promise<DoctorApplyLintReport>;
+type CiteContractMetrics = {
+    decisions_cited: number;
+    pitfalls_cited: number;
+    contract_with: number;
+    contract_missing: number;
+    hard_violated: number;
+    cite_id_unresolved: number;
+    skip_count: Record<string, number>;
+};
+type CiteLayerTypeBreakdown = {
+    team: Record<string, number>;
+    personal: Record<string, number>;
+};
 type CiteCoverageReport = {
     status: "ok" | "skipped";
     marker_ts: number;
     marker_emitted_now: boolean;
     since_ts: number;
     client_filter: "cc" | "codex" | "cursor" | "all";
+    layer_filter?: "team" | "personal" | "all";
     metrics: {
         edits_touched: number;
         qualifying_cites: number;
@@ -113,12 +128,34 @@ type CiteCoverageReport = {
     per_client?: Record<string, Partial<CiteCoverageReport["metrics"]>>;
     dismissed_reason_histogram?: Record<string, number>;
     none_reason_histogram?: Record<string, number>;
+    contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker";
+    contract_metrics?: CiteContractMetrics;
+    per_layer_type?: CiteLayerTypeBreakdown;
+    contract_marker_ts?: number;
     generated_at: string;
 };
 declare function runDoctorCiteCoverage(projectRoot: string, options: {
     since: number;
     client: "cc" | "codex" | "cursor" | "all";
+    layer?: "team" | "personal" | "all";
 }): Promise<CiteCoverageReport>;
+type ArchiveHistoryEntry = {
+    session_id_short: string;
+    last_attempted_at: string;
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    candidates_proposed: number;
+    covered_through_ts: number;
+    age_since_covered_hours: number;
+};
+type ArchiveHistoryReport = {
+    entries: ArchiveHistoryEntry[];
+    total: number;
+    since_ms: number;
+    generated_at: string;
+};
+declare function runDoctorArchiveHistory(projectRoot: string, options: {
+    since: number;
+}): Promise<ArchiveHistoryReport>;
 type EnrichDescriptionsMode = "auto" | "interactive";
 type EnrichDescriptionsCandidate = {
     path: string;
@@ -149,6 +186,31 @@ type KnowledgeMetaBuildResult = {
 type WriteKnowledgeMetaOptions = {
     source: KnowledgeMetaBuildSource;
 };
+/**
+ * v2.0-rc.24 TASK-07: Load a Map<stable_id, knowledge_type> from the
+ * project's `.fabric/agents.meta.json`. Consumed by the doctor cite-coverage
+ * routing (TASK-08) to dispatch cites to the correct policy bucket
+ * (decision/pitfall = strict contract / model = reference-only /
+ * guideline+process = deferred to rc.25 LLM-judge). Cited ids absent from
+ * this map fall into the `cite_id_unresolved` bucket.
+ *
+ * **Singular knowledge_type contract (rc.24 lock):** the returned map values
+ * are the SINGULAR `KnowledgeType` enum (`"model" | "decision" | "guideline"
+ * | "pitfall" | "process"`) — matching both the on-disk `agents.meta.json`
+ * storage AND the canonical `KnowledgeTypeSchema` exported from
+ * `@fenglimg/fabric-shared`. No normalization happens at this boundary; the
+ * loader is a thin extract over engine-maintained meta. Downstream callers
+ * (TASK-08 doctor) must match against the singular enum.
+ *
+ * Both team (KT-*) and personal (KP-*) entries are included — they live in
+ * the same `meta.nodes` map.
+ *
+ * Graceful on failure: a missing meta file, malformed JSON, or schema
+ * validation failure all yield an empty Map (no throw). The doctor will then
+ * surface every cite as `cite_id_unresolved`, which is the safe degraded
+ * mode.
+ */
+declare function loadKbIdTypeMap(projectRootInput: string): Promise<Map<string, KnowledgeType>>;
 declare function buildKnowledgeMeta(projectRootInput: string): Promise<KnowledgeMetaBuildResult>;
 declare function writeKnowledgeMeta(projectRootInput: string, options: WriteKnowledgeMetaOptions): Promise<KnowledgeMetaBuildResult>;
 declare function computeKnowledgeBasedAgentsMeta(projectRootInput: string, existingMeta?: AgentsMeta): Promise<AgentsMeta>;
@@ -435,4 +497,4 @@ declare function startHttpServer(options: {
     authToken?: string;
 }): Promise<Server>;
 
-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 EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, 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, enrichDescriptions, ensureKnowledgeFresh, extractKnowledge, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameKnowledgeTestIndex, planContext, readLockState, readSelectionToken, reconcileKnowledge, releaseLock, reviewKnowledge, runDoctorApplyLint, runDoctorCiteCoverage, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeKnowledgeMeta };
+export { AGENTS_MD_RESOURCE_URI, type AcquireOptions, type ArchiveHistoryEntry, type ArchiveHistoryReport, type CiteCoverageReport, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, 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, enrichDescriptions, ensureKnowledgeFresh, extractKnowledge, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameKnowledgeTestIndex, loadKbIdTypeMap, planContext, readLockState, readSelectionToken, reconcileKnowledge, releaseLock, reviewKnowledge, runDoctorApplyLint, runDoctorArchiveHistory, runDoctorCiteCoverage, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeKnowledgeMeta };

package/dist/index.js

@@ -23,19 +23,21 @@ import {
   isSameKnowledgeTestIndex,
   loadActiveMeta,
   loadActiveMetaOrStale,
+  loadKbIdTypeMap,
   normalizeKnowledgePath,
   readLockState,
   reconcileKnowledge,
   releaseLock,
   resolveProjectRoot,
   runDoctorApplyLint,
+  runDoctorArchiveHistory,
   runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorReport,
   sha256,
   stableStringify,
   writeKnowledgeMeta
-} from "./chunk-IRB77C6E.js";
+} from "./chunk-RHWIDD6A.js";
 
 // src/index.ts
 import { existsSync as existsSync4 } from "fs";
@@ -1892,7 +1894,7 @@ function formatPreexistingRootMessage(projectRoot) {
 function createFabricServer(tracker) {
   const server = new McpServer({
     name: "fabric-knowledge-server",
-    version: "2.0.0-rc.23"
+    version: "2.0.0-rc.26"
   });
   registerPlanContext(server, tracker);
   registerKnowledgeSections(server, tracker);
@@ -2000,7 +2002,7 @@ function createShutdownHandler(deps) {
   };
 }
 async function startHttpServer(options) {
-  const { createFabricHttpApp } = await import("./http-ZBV6YUHD.js");
+  const { createFabricHttpApp } = await import("./http-FMSBWYMO.js");
   const { port, projectRoot, host = "127.0.0.1", authToken } = options;
   const app = createFabricHttpApp({ projectRoot, host, authToken });
   return await new Promise((resolveServer, rejectServer) => {
@@ -2052,6 +2054,7 @@ export {
   getLedgerPath,
   getLegacyLedgerPath,
   isSameKnowledgeTestIndex,
+  loadKbIdTypeMap,
   planContext,
   readLockState,
   readSelectionToken,
@@ -2059,6 +2062,7 @@ export {
   releaseLock,
   reviewKnowledge,
   runDoctorApplyLint,
+  runDoctorArchiveHistory,
   runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-server",
-  "version": "2.0.0-rc.23",
+  "version": "2.0.0-rc.26",
   "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.23"
+    "@fenglimg/fabric-shared": "2.0.0-rc.26"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",