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

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

@@ -14,7 +14,7 @@ import {
   readEventLedger,
   runDoctorReport,
   sha256
-} from "./chunk-7N3FW5LX.js";
+} from "./chunk-HAXROPQM.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';
 
@@ -97,12 +97,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;
@@ -112,12 +126,55 @@ 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;
+    missing: Array<"intent_clues" | "tech_stack" | "impact" | "must_read_if">;
+    modified: boolean;
+    added_fields: Array<"intent_clues" | "tech_stack" | "impact" | "must_read_if">;
+    error?: string;
+};
+type EnrichDescriptionsReport = {
+    mode: EnrichDescriptionsMode;
+    dryRun: boolean;
+    scanned: number;
+    modified: number;
+    skipped: number;
+    candidates: EnrichDescriptionsCandidate[];
+};
+declare function enrichDescriptions(projectRoot: string, opts?: {
+    auto?: boolean;
+    dryRun?: boolean;
+}): Promise<EnrichDescriptionsReport>;
 
 type KnowledgeMetaBuildSource = "doctor_fix" | "sync_meta";
 type KnowledgeMetaBuildResult = {
@@ -128,6 +185,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>;
@@ -176,8 +258,11 @@ declare class KnowledgeIdAllocator {
 /**
  * Append-evidence-on-collision service for fab_extract_knowledge.
  *
- * Idempotency_key = sha256({source_session, type, slug}). When the same
- * triple hits an existing pending file (verified by frontmatter
+ * Idempotency_key = sha256({source_session: source_sessions[0], type, slug}).
+ * The `source_session` key inside the hash payload is FROZEN for backward
+ * compatibility with on-disk pending entries written before rc.23 — changing
+ * it would invalidate every existing `x-fabric-idempotency-key`. When the
+ * same triple hits an existing pending file (verified by frontmatter
  * `x-fabric-idempotency-key`), the body is preserved and a fresh
  * `## Evidence (call N)` section is appended — LLM-regenerated summaries
  * stay observable without overwriting prior context.
@@ -333,8 +418,14 @@ interface KnowledgeSyncReport {
  */
 declare function ensureKnowledgeFresh(projectRoot: string, opts?: KnowledgeSyncOptions): Promise<KnowledgeSyncReport>;
 interface ReconcileKnowledgeOptions {
-    /** Identifies who triggered the reconcile; controls which summary ledger event is written. */
-    trigger?: "startup" | "doctor" | "manual";
+    /**
+     * Identifies who triggered the reconcile; controls which summary ledger event is written.
+     *
+     * v2.0.0-rc.23 TASK-005 (a-B): `auto-heal-description` added so plan_context
+     * can drive a full reconcile when it detects nodes with `description === undefined`
+     * (legacy meta drift the revision-hash gate cannot detect).
+     */
+    trigger?: "startup" | "doctor" | "manual" | "auto-heal-description";
 }
 /**
  * Full scan + rewrites agents.meta.json with ground-truth disk state + emits
@@ -405,4 +496,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 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 };
+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 };