@fenglimg/fabric-server 2.3.0-rc.15 → 2.3.0-rc.17

package/dist/index.d.ts

@@ -160,7 +160,11 @@ interface AlwaysActiveBody {
     /** description.summary — the overflow-degrade fallback when the body cannot
      *  fit the injection char budget (the budget is enforced hook-side, D10). */
     summary: string;
-    /** frontmatter-stripped markdown body. */
+    /**
+     * ISS-20260713-014 / KT-DEC-0036: SessionStart wire is index-only.
+     * Body is empty on this path; full text via Read/fab_recall.
+     * Field retained for wire compatibility.
+     */
     body: string;
 }
 /**
@@ -666,6 +670,12 @@ declare function explainWhyNotSurfaced(projectRoot: string, query: string): Prom
  */
 declare function extractKnowledge(projectRoot: string, input: FabExtractKnowledgeInput): Promise<FabExtractKnowledgeOutput>;
 
+/**
+ * fab_review / fab_pending facade (ISS-20260713-013).
+ * Action implementations live in review-write-actions / review-search;
+ * path/sandbox/list helpers in review-shared; frontmatter in review-frontmatter.
+ */
+
 /**
  * v2.0 rc.3 fab_review service (W3-K K2: WRITE-only).
  *
@@ -912,6 +922,26 @@ declare function readEventLedger(projectRoot: string, options?: ReadEventLedgerO
  */
 declare function flushAndSyncEventLedger(projectRoot: string): void;
 
+/**
+ * ISS-20260713-011: selection_token mint / LRU cache for plan-context.
+ */
+type SelectionTokenState = {
+    token: string;
+    revision_hash: string;
+    target_paths: string[];
+    required_stable_ids: string[];
+    ai_selectable_stable_ids: string[];
+    created_at: number;
+    expires_at: number;
+};
+declare function readSelectionToken(token: string, now?: number): SelectionTokenState | undefined;
+
+/**
+ * planContext facade (ISS-20260713-011).
+ * Scoring / BM25 cache / selection-token live in dedicated modules;
+ * this file orchestrates the plan-context pipeline and re-exports the public API.
+ */
+
 type PlanContextInput = {
     paths: string[];
     intent?: string;
@@ -978,17 +1008,7 @@ type PlanContextResult = {
     /** Internal service→tool signal; stripped before MCP output. */
     payload_over_budget?: boolean;
 };
-type SelectionTokenState = {
-    token: string;
-    revision_hash: string;
-    target_paths: string[];
-    required_stable_ids: string[];
-    ai_selectable_stable_ids: string[];
-    created_at: number;
-    expires_at: number;
-};
 declare function planContext(projectRoot: string, input: PlanContextInput): Promise<PlanContextResult>;
-declare function readSelectionToken(token: string, now?: number): SelectionTokenState | undefined;
 
 type RecallInput = PlanContextInput & {
     /**
@@ -1153,7 +1173,33 @@ declare const AGENTS_MD_RESOURCE_URI = "fabric://bootstrap-readme";
 declare function formatPreexistingRootMessage(projectRoot: string): string | null;
 
 declare const FABRIC_SERVER_INSTRUCTIONS: string;
+declare function buildServerInstructions(projectRoot: string): string;
 declare function createFabricServer(tracker?: InFlightTracker): McpServer;
+/**
+ * The slice of the MCP `Server` the roots adoption consumes — injectable so
+ * tests can drive it without a live transport.
+ */
+interface McpRootsSource {
+    getClientCapabilities(): {
+        roots?: unknown;
+    } | undefined;
+    listRoots(): Promise<{
+        roots: Array<{
+            uri?: string;
+        }>;
+    }>;
+}
+/**
+ * ISS werewolf-minigame (rootless MCP spawn, KT-PIT-0046): fetch the client's
+ * workspace roots (when the client declares the `roots` capability) and record
+ * them as project-root candidates via `setMcpRootsHint`. Returns the accepted
+ * absolute paths ([] when the capability is absent or the fetch fails —
+ * best-effort, never sinks startup). Called from `oninitialized`; the
+ * env > CLAUDE_PROJECT_DIR > roots > cwd priority lives in
+ * `resolveProjectRoot`, which every tool call re-runs, so adoption heals
+ * subsequent calls without a restart.
+ */
+declare function adoptMcpClientRoots(source: McpRootsSource): Promise<string[]>;
 declare function startStdioServer(): Promise<void>;
 /**
  * Dependencies for the shutdown handler factory. Tests inject `exit` to assert
@@ -1179,4 +1225,4 @@ interface ShutdownHandlerDeps {
  */
 declare function createShutdownHandler(deps: ShutdownHandlerDeps): () => void;
 
-export { AGENTS_MD_RESOURCE_URI, type AlwaysActiveBody, type ArchiveHistoryEntry, type ArchiveHistoryReport, type BacklogAgeMetric, COLD_EVAL_RUBRIC, type CiteCoverageReport, type ColdEvalBatch, type ColdEvalCandidate, type ColdEvalVerdict, type ConflictEntry, type ConflictJudge, type ConflictLintReport, type ConflictPair, type ConflictVerdict, type ConsumptionEntry, type ConsumptionInspection, type ConsumptionLintConfig, DEFAULT_CONFLICT_SIMILARITY_THRESHOLD, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, FABRIC_SERVER_INSTRUCTIONS, type HistoryAllReport, type HistoryDayRow, type InFlightTracker, type KnowledgeCensus, LEDGER_PATH, LEGACY_LEDGER_PATH, METRICS_LEDGER_PATH, METRIC_COUNTER_NAMES, type MetricCounterName, type MetricsRow, OPTIONAL_EMBED_PACKAGE, type PlanContextInput, type PlanContextResult, type PrecheckResult, RETIRED_TOKENS, type RecallInput, type RecallResult, type RelatedBrokenLink, type RelatedGraphInspection, type RelatedGraphNode, type RelatedHubEntry, type RequirementProfile, type RetiredReferenceHit, type RetiredReferenceInspection, type RetiredToken, type SelectionTokenState, type ShutdownHandlerDeps, type StoreCanonicalEntry, type StoreReachability, type SurfaceVerdict, type UnboundProjectViolation, type WhyNotSurfacedResult, aggregateConsumption, appendEventLedgerEvent, buildAlwaysActiveBodies, buildColdEvalBatch, buildKnowledgeCensus, buildRelatedGraph, bumpCounter, checkBacklogAge, clearPrecheckCache, collectStoreCanonicalEntries, computeReadSetRevision, contextCache, createFabricServer, createInFlightTracker, createShutdownHandler, defaultEmbedCacheDir, detectUnboundProject, drainCounters, enrichDescriptions, evaluateStoreDir, explainWhyNotSurfaced, extractKnowledge, findConflictCandidates, flushAndSyncEventLedger, flushMetrics, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, getMetricsLedgerPath, inspectConsumption, inspectRelatedGraph, inspectRetiredReferences, isEmbedderResolvable, lintConflicts, loadConflictEntries, loadEmbedder, pairSimilarity, planContext, precheckStoreReachability, readEmbedConfig, readEventLedger, readFusion, readLedger, readMetrics, readSelectionToken, recall, rehydrateAgentsMetaAt, renderBacklogAgeLine, resolveLedgerPaths, reviewKnowledge, reviewPending, runDoctorApplyLint, runDoctorArchiveHistory, runDoctorCiteCoverage, runDoctorConflictLint, runDoctorFix, runDoctorHistoryAll, runDoctorReport, startMetricsFlush, startRotationTick, startStdioServer, stopMetricsFlush, stopRotationTick };
+export { AGENTS_MD_RESOURCE_URI, type AlwaysActiveBody, type ArchiveHistoryEntry, type ArchiveHistoryReport, type BacklogAgeMetric, COLD_EVAL_RUBRIC, type CiteCoverageReport, type ColdEvalBatch, type ColdEvalCandidate, type ColdEvalVerdict, type ConflictEntry, type ConflictJudge, type ConflictLintReport, type ConflictPair, type ConflictVerdict, type ConsumptionEntry, type ConsumptionInspection, type ConsumptionLintConfig, DEFAULT_CONFLICT_SIMILARITY_THRESHOLD, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, FABRIC_SERVER_INSTRUCTIONS, type HistoryAllReport, type HistoryDayRow, type InFlightTracker, type KnowledgeCensus, LEDGER_PATH, LEGACY_LEDGER_PATH, METRICS_LEDGER_PATH, METRIC_COUNTER_NAMES, type McpRootsSource, type MetricCounterName, type MetricsRow, OPTIONAL_EMBED_PACKAGE, type PlanContextInput, type PlanContextResult, type PrecheckResult, RETIRED_TOKENS, type RecallInput, type RecallResult, type RelatedBrokenLink, type RelatedGraphInspection, type RelatedGraphNode, type RelatedHubEntry, type RequirementProfile, type RetiredReferenceHit, type RetiredReferenceInspection, type RetiredToken, type SelectionTokenState, type ShutdownHandlerDeps, type StoreCanonicalEntry, type StoreReachability, type SurfaceVerdict, type UnboundProjectViolation, type WhyNotSurfacedResult, adoptMcpClientRoots, aggregateConsumption, appendEventLedgerEvent, buildAlwaysActiveBodies, buildColdEvalBatch, buildKnowledgeCensus, buildRelatedGraph, buildServerInstructions, bumpCounter, checkBacklogAge, clearPrecheckCache, collectStoreCanonicalEntries, computeReadSetRevision, contextCache, createFabricServer, createInFlightTracker, createShutdownHandler, defaultEmbedCacheDir, detectUnboundProject, drainCounters, enrichDescriptions, evaluateStoreDir, explainWhyNotSurfaced, extractKnowledge, findConflictCandidates, flushAndSyncEventLedger, flushMetrics, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, getMetricsLedgerPath, inspectConsumption, inspectRelatedGraph, inspectRetiredReferences, isEmbedderResolvable, lintConflicts, loadConflictEntries, loadEmbedder, pairSimilarity, planContext, precheckStoreReachability, readEmbedConfig, readEventLedger, readFusion, readLedger, readMetrics, readSelectionToken, recall, rehydrateAgentsMetaAt, renderBacklogAgeLine, resolveLedgerPaths, reviewKnowledge, reviewPending, runDoctorApplyLint, runDoctorArchiveHistory, runDoctorCiteCoverage, runDoctorConflictLint, runDoctorFix, runDoctorHistoryAll, runDoctorReport, startMetricsFlush, startRotationTick, startStdioServer, stopMetricsFlush, stopRotationTick };