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

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 {
@@ -88,6 +196,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 +286,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 +371,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 +407,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;
@@ -1167,4 +1179,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 };