@fenglimg/fabric-server 2.3.0-rc.12 → 2.3.0-rc.16

package/README.md

@@ -7,7 +7,8 @@ Fabric MCP knowledge server. Runs over stdio transport and serves Claude Code an
 - `fab_recall` — single-step recall: returns candidate descriptions + native read paths (no body delivery over MCP; read a body on demand via a native Read of the returned path)
 - `fab_archive_scan` — scan recent work for archive-worthy knowledge candidates
 - `fab_propose` — persist a pending knowledge entry
-- `fab_review` — list / approve / reject / modify / defer pending entries
+- `fab_pending` — read-only browse/search of pending + canonical knowledge (`list` / `search`)
+- `fab_review` — write-only triage of pending knowledge (`approve` / `reject` / `modify` / `modify-content` / `modify-content-batch` / `modify-layer` / `defer` / `retire`)
 
 ## Install
 

package/dist/index.d.ts

@@ -41,6 +41,114 @@ type BacklogAgeMetric = {
 declare function checkBacklogAge(projectRoot: string, nowMs?: number): Promise<BacklogAgeMetric>;
 declare function renderBacklogAgeLine(metric: BacklogAgeMetric): string;
 
+/**
+ * doctor-types.ts — pure public report/check types for the doctor subsystem.
+ *
+ * Wave W1 extraction from doctor.ts (repo-hygiene-slim). No runtime logic —
+ * only type aliases. doctor.ts re-exports these for backward-compatible
+ * `import type { DoctorCheck } from "./doctor.js"` consumers.
+ */
+
+type DoctorStatus = "ok" | "warn" | "error";
+type DoctorIssueKind = "fixable_error" | "manual_error" | "warning" | "info";
+type DoctorCheck = {
+    name: string;
+    status: DoctorStatus;
+    message: string;
+    kind?: DoctorIssueKind;
+    code?: string;
+    fixable?: boolean;
+    actionHint?: string;
+    audience?: "user" | "maintainer";
+};
+type DoctorIssue = {
+    code: string;
+    name: string;
+    message: string;
+    path?: string;
+    actionHint?: string;
+    audience?: "user" | "maintainer";
+};
+type DoctorPayloadLimits = {
+    warn_bytes: number;
+    hard_bytes: number;
+    source: "default" | "config";
+};
+type DoctorSummary = {
+    target: string;
+    framework: {
+        kind: string;
+        version: string;
+        subkind: string;
+    };
+    entryPoints: Array<{
+        path: string;
+        reason: string;
+    }>;
+    metaRevision: string | null;
+    computedMetaRevision: string | null;
+    ruleCount: number;
+    eventLedgerPath: string;
+    fixableErrorCount: number;
+    manualErrorCount: number;
+    warningCount: number;
+    infoCount: number;
+    targetFiles: Record<string, boolean>;
+    payload_limits: DoctorPayloadLimits;
+    health: DoctorHealth;
+};
+type DoctorReport = {
+    status: DoctorStatus;
+    checks: DoctorCheck[];
+    fixable_errors: DoctorIssue[];
+    manual_errors: DoctorIssue[];
+    warnings: DoctorIssue[];
+    infos: DoctorIssue[];
+    summary: DoctorSummary;
+};
+type DoctorFixReport = {
+    changed: boolean;
+    fixed: DoctorIssue[];
+    remaining_manual_errors: DoctorIssue[];
+    warnings: DoctorIssue[];
+    message: string;
+    report: DoctorReport;
+};
+type DoctorApplyLintMutationKind = "knowledge_session_hints_stale_cleanup" | "store_counter_floor";
+type DoctorApplyLintMutation = {
+    kind: DoctorApplyLintMutationKind;
+    path: string;
+    detail: string;
+    applied: boolean;
+    error?: string;
+};
+type DoctorApplyLintReport = {
+    changed: boolean;
+    mutations: DoctorApplyLintMutation[];
+    warnings: DoctorIssue[];
+    manual_errors: DoctorIssue[];
+    aborted: boolean;
+    abort_reason?: string;
+    message: string;
+    report: DoctorReport;
+};
+type EnrichDescriptionsMode = "auto" | "preview" | "readonly" | "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 extractRuleDescription(source: string): RuleDescription | undefined;
 
 interface AlwaysActiveBody {
@@ -52,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;
 }
 /**
@@ -88,6 +200,7 @@ interface KnowledgeCensus {
  */
 declare function buildKnowledgeCensus(projectRoot: string): Promise<KnowledgeCensus>;
 declare function buildAlwaysActiveBodies(projectRoot: string): Promise<AlwaysActiveBody[]>;
+declare function computeReadSetRevision(projectRoot: string): Promise<string>;
 interface StoreCanonicalEntry {
     stableId: string;
     qualifiedId: string;
@@ -177,6 +290,7 @@ type MetricsRow = {
  * dual-write allowlist below.
  */
 declare const METRIC_COUNTER_NAMES: {
+    readonly knowledge_body_read: "knowledge_body_read";
     readonly knowledge_consumed: "knowledge_consumed";
     readonly edit_intent_checked: "edit_intent_checked";
     readonly knowledge_context_planned: "knowledge_context_planned";
@@ -261,6 +375,7 @@ declare function runDoctorCiteCoverage(projectRoot: string, options: {
     until?: number;
     recallWindowMs?: number;
 }): Promise<CiteCoverageReport>;
+
 type ArchiveHistoryEntry = {
     session_id_short: string;
     last_attempted_at: string;
@@ -296,109 +411,10 @@ declare function runDoctorHistoryAll(projectRoot: string, options: {
     since: number;
 }): Promise<HistoryAllReport>;
 
-type DoctorStatus = "ok" | "warn" | "error";
-type DoctorIssueKind = "fixable_error" | "manual_error" | "warning" | "info";
-type DoctorCheck = {
-    name: string;
-    status: DoctorStatus;
-    message: string;
-    kind?: DoctorIssueKind;
-    code?: string;
-    fixable?: boolean;
-    actionHint?: string;
-    audience?: "user" | "maintainer";
-};
-type DoctorIssue = {
-    code: string;
-    name: string;
-    message: string;
-    path?: string;
-    actionHint?: string;
-    audience?: "user" | "maintainer";
-};
-type DoctorPayloadLimits = {
-    warn_bytes: number;
-    hard_bytes: number;
-    source: "default" | "config";
-};
-type DoctorSummary = {
-    target: string;
-    framework: {
-        kind: string;
-        version: string;
-        subkind: string;
-    };
-    entryPoints: Array<{
-        path: string;
-        reason: string;
-    }>;
-    metaRevision: string | null;
-    computedMetaRevision: string | null;
-    ruleCount: number;
-    eventLedgerPath: string;
-    fixableErrorCount: number;
-    manualErrorCount: number;
-    warningCount: number;
-    infoCount: number;
-    targetFiles: Record<string, boolean>;
-    payload_limits: DoctorPayloadLimits;
-    health: DoctorHealth;
-};
-type DoctorReport = {
-    status: DoctorStatus;
-    checks: DoctorCheck[];
-    fixable_errors: DoctorIssue[];
-    manual_errors: DoctorIssue[];
-    warnings: DoctorIssue[];
-    infos: DoctorIssue[];
-    summary: DoctorSummary;
-};
-type DoctorFixReport = {
-    changed: boolean;
-    fixed: DoctorIssue[];
-    remaining_manual_errors: DoctorIssue[];
-    warnings: DoctorIssue[];
-    message: string;
-    report: DoctorReport;
-};
-type DoctorApplyLintMutationKind = "knowledge_orphan_demote_required" | "knowledge_stale_archive_required" | "knowledge_index_drift" | "knowledge_pending_auto_archive" | "knowledge_session_hints_stale_cleanup" | "knowledge_relevance_fields_missing";
-type DoctorApplyLintMutation = {
-    kind: DoctorApplyLintMutationKind;
-    path: string;
-    detail: string;
-    applied: boolean;
-    error?: string;
-};
-type DoctorApplyLintReport = {
-    changed: boolean;
-    mutations: DoctorApplyLintMutation[];
-    warnings: DoctorIssue[];
-    manual_errors: DoctorIssue[];
-    aborted: boolean;
-    abort_reason?: string;
-    message: string;
-    report: DoctorReport;
-};
 declare function runDoctorReport(target: string): Promise<DoctorReport>;
 declare function runDoctorFix(target: string): Promise<DoctorFixReport>;
 declare function runDoctorApplyLint(target: string): Promise<DoctorApplyLintReport>;
 
-type EnrichDescriptionsMode = "auto" | "preview" | "readonly" | "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;
@@ -654,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).
  *
@@ -900,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;
@@ -966,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 & {
     /**
@@ -1167,4 +1199,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, 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 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 };