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

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

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

package/dist/index.d.ts

@@ -112,12 +112,33 @@ type CiteCoverageReport = {
     };
     per_client?: Record<string, Partial<CiteCoverageReport["metrics"]>>;
     dismissed_reason_histogram?: Record<string, number>;
+    none_reason_histogram?: Record<string, number>;
     generated_at: string;
 };
 declare function runDoctorCiteCoverage(projectRoot: string, options: {
     since: number;
     client: "cc" | "codex" | "cursor" | "all";
 }): Promise<CiteCoverageReport>;
+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 = {
@@ -176,8 +197,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 +357,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 +435,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 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 };