@fenglimg/fabric-server 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -1,17 +1,29 @@
 import { Server } from 'node:http';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { AuditMode, LedgerEntry, HumanLockEntry } from '@fenglimg/fabric-shared';
+import { AgentsMeta, RuleTestIndex, AgentsLayer, AgentsTopologyType } from '@fenglimg/fabric-shared';
 
 declare const LEDGER_PATH = ".fabric/.intent-ledger.jsonl";
 declare const LEGACY_LEDGER_PATH = ".intent-ledger.jsonl";
+declare const EVENT_LEDGER_PATH = ".fabric/events.jsonl";
 declare function getLedgerPath(projectRoot: string): string;
 declare function getLegacyLedgerPath(projectRoot: string): string;
+declare function getEventLedgerPath(projectRoot: string): string;
 
 type DoctorStatus = "ok" | "warn" | "error";
+type DoctorIssueKind = "fixable_error" | "manual_error" | "warning";
 type DoctorCheck = {
     name: string;
     status: DoctorStatus;
     message: string;
+    kind?: DoctorIssueKind;
+    code?: string;
+    fixable?: boolean;
+};
+type DoctorIssue = {
+    code: string;
+    name: string;
+    message: string;
+    path?: string;
 };
 type DoctorSummary = {
     target: string;
@@ -24,81 +36,51 @@ type DoctorSummary = {
         path: string;
         reason: string;
     }>;
-    driftCount: number;
-    protectedPathCount: number;
-    protectedPathsIntact: boolean;
-    lastLedgerEntryTs: number | null;
-    lastLedgerEntryAgeMs: number | null;
     metaRevision: string | null;
-    ledgerPath: string;
-    legacyLedgerPath: string;
-    legacyLedgerDetected: boolean;
-    audit: {
-        enabled: boolean;
-        mode: AuditMode;
-        checkedPathCount: number;
-        violationCount: number;
-        windowMs: number;
-    } | null;
+    computedMetaRevision: string | null;
+    ruleCount: number;
+    eventLedgerPath: string;
+    fixableErrorCount: number;
+    manualErrorCount: number;
+    warningCount: number;
+    targetFiles: Record<string, boolean>;
 };
 type DoctorReport = {
     status: DoctorStatus;
     checks: DoctorCheck[];
+    fixable_errors: DoctorIssue[];
+    manual_errors: DoctorIssue[];
+    warnings: DoctorIssue[];
     summary: DoctorSummary;
-    audit: DoctorAuditReport | null;
 };
 type DoctorFixReport = {
     changed: boolean;
-    migratedLedger: boolean;
+    fixed: DoctorIssue[];
+    remaining_manual_errors: DoctorIssue[];
+    warnings: DoctorIssue[];
     message: string;
     report: DoctorReport;
 };
-type DoctorAuditViolation = {
-    editTs: number;
-    entryId: string;
-    intent: string;
-    lastRuleAccessTs: number | null;
-    path: string;
-};
-type DoctorAuditReport = {
-    mode: AuditMode;
-    skipped: boolean;
-    windowMs: number;
-    checkedPathCount: number;
-    violationCount: number;
-    violations: DoctorAuditViolation[];
-};
 declare function runDoctorReport(target: string): Promise<DoctorReport>;
 declare function runDoctorFix(target: string): Promise<DoctorFixReport>;
-declare function runDoctorAuditReport(target: string, options?: {
-    force?: boolean;
-    mode?: AuditMode;
-    windowMs?: number;
-}): Promise<DoctorAuditReport>;
 
-type StoredLedgerEntry = LedgerEntry & {
-    id: string;
-};
-
-type HumanLockStatus = HumanLockEntry & {
-    drift: boolean;
-    current_hash: string;
-};
-declare function readHumanLock(projectRoot: string): Promise<HumanLockStatus[]>;
-declare function readHumanLockEntry(projectRoot: string, file: string): Promise<HumanLockStatus | null>;
-
-type ApproveHumanLockInput = {
-    file: string;
-    start_line: number;
-    end_line: number;
-    new_hash: string;
+type RuleMetaBuildSource = "doctor_fix" | "sync_meta";
+type RuleMetaBuildResult = {
+    meta: AgentsMeta;
+    ruleTestIndex: RuleTestIndex;
+    changed: boolean;
 };
-type ApproveHumanLockResult = {
-    updated: boolean;
-    entry: HumanLockStatus;
-    ledger_entry?: StoredLedgerEntry;
+type WriteRuleMetaOptions = {
+    source: RuleMetaBuildSource;
 };
-declare function approveHumanLock(projectRoot: string, input: ApproveHumanLockInput): Promise<ApproveHumanLockResult>;
+declare function buildRuleMeta(projectRootInput: string): Promise<RuleMetaBuildResult>;
+declare function writeRuleMeta(projectRootInput: string, options: WriteRuleMetaOptions): Promise<RuleMetaBuildResult>;
+declare function computeRulesBasedAgentsMeta(projectRootInput: string, existingMeta?: AgentsMeta): Promise<AgentsMeta>;
+declare function computeRuleTestIndex(projectRootInput: string, computedMeta: AgentsMeta, previousIndex?: RuleTestIndex): Promise<RuleTestIndex>;
+declare function deriveRuleMetaLayer(relativePath: string): AgentsLayer;
+declare function deriveRuleMetaTopologyType(relativePath: string): AgentsTopologyType;
+declare function isSameRuleTestIndex(left: RuleTestIndex, right: RuleTestIndex): boolean;
+declare function stableStringify(value: unknown): string;
 
 /**
  * Shared constants used across the server package.
@@ -117,4 +99,4 @@ declare function startHttpServer(options: {
     dev?: boolean;
 }): Promise<Server>;
 
-export { AGENTS_MD_RESOURCE_URI, type ApproveHumanLockInput, type ApproveHumanLockResult, type DoctorAuditReport, type DoctorFixReport, type DoctorReport, type HumanLockStatus, LEDGER_PATH, LEGACY_LEDGER_PATH, approveHumanLock, createFabricServer, getLedgerPath, getLegacyLedgerPath, readHumanLock, readHumanLockEntry, runDoctorAuditReport, runDoctorFix, runDoctorReport, startHttpServer, startStdioServer };
+export { AGENTS_MD_RESOURCE_URI, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, LEDGER_PATH, LEGACY_LEDGER_PATH, type RuleMetaBuildResult, type RuleMetaBuildSource, type WriteRuleMetaOptions, buildRuleMeta, computeRuleTestIndex, computeRulesBasedAgentsMeta, createFabricServer, deriveRuleMetaLayer, deriveRuleMetaTopologyType, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameRuleTestIndex, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeRuleMeta };