@n-dx/core 0.1.0

package/packages/sourcevision/dist/schema/validate.d.ts

@@ -0,0 +1,1243 @@
+import { z } from "zod";
+import type * as V1 from "./v1.js";
+export declare const ManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodString;
+    toolVersion: z.ZodString;
+    analyzedAt: z.ZodString;
+    gitSha: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    targetPath: z.ZodString;
+    modules: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<["pending", "running", "complete", "error"]>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        chunks: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "running" | "complete" | "error";
+        error?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        chunks?: number | undefined;
+    }, {
+        status: "pending" | "running" | "complete" | "error";
+        error?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        chunks?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: string;
+    toolVersion: string;
+    analyzedAt: string;
+    targetPath: string;
+    modules: Record<string, {
+        status: "pending" | "running" | "complete" | "error";
+        error?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        chunks?: number | undefined;
+    }>;
+    gitSha?: string | undefined;
+    gitBranch?: string | undefined;
+}, {
+    schemaVersion: string;
+    toolVersion: string;
+    analyzedAt: string;
+    targetPath: string;
+    modules: Record<string, {
+        status: "pending" | "running" | "complete" | "error";
+        error?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        chunks?: number | undefined;
+    }>;
+    gitSha?: string | undefined;
+    gitBranch?: string | undefined;
+}>;
+export declare const InventorySchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        language: z.ZodString;
+        lineCount: z.ZodNumber;
+        hash: z.ZodString;
+        role: z.ZodEnum<["source", "test", "config", "docs", "generated", "asset", "build", "other"]>;
+        category: z.ZodString;
+        lastModified: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        size: number;
+        language: string;
+        lineCount: number;
+        hash: string;
+        role: "test" | "source" | "config" | "docs" | "generated" | "asset" | "build" | "other";
+        category: string;
+        lastModified?: number | undefined;
+    }, {
+        path: string;
+        size: number;
+        language: string;
+        lineCount: number;
+        hash: string;
+        role: "test" | "source" | "config" | "docs" | "generated" | "asset" | "build" | "other";
+        category: string;
+        lastModified?: number | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalFiles: z.ZodNumber;
+        totalLines: z.ZodNumber;
+        byLanguage: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        byRole: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        byCategory: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalFiles: number;
+        totalLines: number;
+        byLanguage: Record<string, number>;
+        byRole: Record<string, number>;
+        byCategory: Record<string, number>;
+    }, {
+        totalFiles: number;
+        totalLines: number;
+        byLanguage: Record<string, number>;
+        byRole: Record<string, number>;
+        byCategory: Record<string, number>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    files: {
+        path: string;
+        size: number;
+        language: string;
+        lineCount: number;
+        hash: string;
+        role: "test" | "source" | "config" | "docs" | "generated" | "asset" | "build" | "other";
+        category: string;
+        lastModified?: number | undefined;
+    }[];
+    summary: {
+        totalFiles: number;
+        totalLines: number;
+        byLanguage: Record<string, number>;
+        byRole: Record<string, number>;
+        byCategory: Record<string, number>;
+    };
+}, {
+    files: {
+        path: string;
+        size: number;
+        language: string;
+        lineCount: number;
+        hash: string;
+        role: "test" | "source" | "config" | "docs" | "generated" | "asset" | "build" | "other";
+        category: string;
+        lastModified?: number | undefined;
+    }[];
+    summary: {
+        totalFiles: number;
+        totalLines: number;
+        byLanguage: Record<string, number>;
+        byRole: Record<string, number>;
+        byCategory: Record<string, number>;
+    };
+}>;
+export declare const ImportsSchema: z.ZodObject<{
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        type: z.ZodEnum<["static", "dynamic", "require", "reexport", "type"]>;
+        symbols: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "type" | "static" | "dynamic" | "require" | "reexport";
+        from: string;
+        to: string;
+        symbols: string[];
+    }, {
+        type: "type" | "static" | "dynamic" | "require" | "reexport";
+        from: string;
+        to: string;
+        symbols: string[];
+    }>, "many">;
+    external: z.ZodArray<z.ZodObject<{
+        package: z.ZodString;
+        importedBy: z.ZodArray<z.ZodString, "many">;
+        symbols: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        symbols: string[];
+        package: string;
+        importedBy: string[];
+    }, {
+        symbols: string[];
+        package: string;
+        importedBy: string[];
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalEdges: z.ZodNumber;
+        totalExternal: z.ZodNumber;
+        circularCount: z.ZodNumber;
+        circulars: z.ZodArray<z.ZodObject<{
+            cycle: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            cycle: string[];
+        }, {
+            cycle: string[];
+        }>, "many">;
+        mostImported: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            count: number;
+        }, {
+            path: string;
+            count: number;
+        }>, "many">;
+        avgImportsPerFile: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalEdges: number;
+        totalExternal: number;
+        circularCount: number;
+        circulars: {
+            cycle: string[];
+        }[];
+        mostImported: {
+            path: string;
+            count: number;
+        }[];
+        avgImportsPerFile: number;
+    }, {
+        totalEdges: number;
+        totalExternal: number;
+        circularCount: number;
+        circulars: {
+            cycle: string[];
+        }[];
+        mostImported: {
+            path: string;
+            count: number;
+        }[];
+        avgImportsPerFile: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    summary: {
+        totalEdges: number;
+        totalExternal: number;
+        circularCount: number;
+        circulars: {
+            cycle: string[];
+        }[];
+        mostImported: {
+            path: string;
+            count: number;
+        }[];
+        avgImportsPerFile: number;
+    };
+    edges: {
+        type: "type" | "static" | "dynamic" | "require" | "reexport";
+        from: string;
+        to: string;
+        symbols: string[];
+    }[];
+    external: {
+        symbols: string[];
+        package: string;
+        importedBy: string[];
+    }[];
+}, {
+    summary: {
+        totalEdges: number;
+        totalExternal: number;
+        circularCount: number;
+        circulars: {
+            cycle: string[];
+        }[];
+        mostImported: {
+            path: string;
+            count: number;
+        }[];
+        avgImportsPerFile: number;
+    };
+    edges: {
+        type: "type" | "static" | "dynamic" | "require" | "reexport";
+        from: string;
+        to: string;
+        symbols: string[];
+    }[];
+    external: {
+        symbols: string[];
+        package: string;
+        importedBy: string[];
+    }[];
+}>;
+export declare const ClassificationsSchema: z.ZodObject<{
+    archetypes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        signals: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["path", "import", "export", "filename", "directory"]>;
+            pattern: z.ZodString;
+            weight: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }, {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }>, "many">;
+        analysisHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        description: string;
+        signals: {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }[];
+        analysisHints?: Record<string, string> | undefined;
+    }, {
+        id: string;
+        name: string;
+        description: string;
+        signals: {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }[];
+        analysisHints?: Record<string, string> | undefined;
+    }>, "many">;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        archetype: z.ZodNullable<z.ZodString>;
+        secondaryArchetypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        confidence: z.ZodNumber;
+        source: z.ZodEnum<["algorithmic", "llm", "user-override"]>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            archetypeId: z.ZodString;
+            signalKind: z.ZodEnum<["path", "import", "export", "filename", "directory"]>;
+            detail: z.ZodString;
+            weight: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }, {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        source: "algorithmic" | "llm" | "user-override";
+        archetype: string | null;
+        confidence: number;
+        secondaryArchetypes?: string[] | undefined;
+        evidence?: {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }[] | undefined;
+    }, {
+        path: string;
+        source: "algorithmic" | "llm" | "user-override";
+        archetype: string | null;
+        confidence: number;
+        secondaryArchetypes?: string[] | undefined;
+        evidence?: {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }[] | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalClassified: z.ZodNumber;
+        totalUnclassified: z.ZodNumber;
+        byArchetype: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        bySource: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalClassified: number;
+        totalUnclassified: number;
+        byArchetype: Record<string, number>;
+        bySource: Record<string, number>;
+    }, {
+        totalClassified: number;
+        totalUnclassified: number;
+        byArchetype: Record<string, number>;
+        bySource: Record<string, number>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    files: {
+        path: string;
+        source: "algorithmic" | "llm" | "user-override";
+        archetype: string | null;
+        confidence: number;
+        secondaryArchetypes?: string[] | undefined;
+        evidence?: {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }[] | undefined;
+    }[];
+    summary: {
+        totalClassified: number;
+        totalUnclassified: number;
+        byArchetype: Record<string, number>;
+        bySource: Record<string, number>;
+    };
+    archetypes: {
+        id: string;
+        name: string;
+        description: string;
+        signals: {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }[];
+        analysisHints?: Record<string, string> | undefined;
+    }[];
+}, {
+    files: {
+        path: string;
+        source: "algorithmic" | "llm" | "user-override";
+        archetype: string | null;
+        confidence: number;
+        secondaryArchetypes?: string[] | undefined;
+        evidence?: {
+            weight: number;
+            archetypeId: string;
+            signalKind: "path" | "import" | "export" | "filename" | "directory";
+            detail: string;
+        }[] | undefined;
+    }[];
+    summary: {
+        totalClassified: number;
+        totalUnclassified: number;
+        byArchetype: Record<string, number>;
+        bySource: Record<string, number>;
+    };
+    archetypes: {
+        id: string;
+        name: string;
+        description: string;
+        signals: {
+            kind: "path" | "import" | "export" | "filename" | "directory";
+            pattern: string;
+            weight: number;
+        }[];
+        analysisHints?: Record<string, string> | undefined;
+    }[];
+}>;
+export declare const FindingSchema: z.ZodObject<{
+    type: z.ZodEnum<["observation", "pattern", "relationship", "anti-pattern", "suggestion", "move-file"]>;
+    pass: z.ZodNumber;
+    scope: z.ZodString;
+    text: z.ZodString;
+    severity: z.ZodOptional<z.ZodEnum<["info", "warning", "critical"]>>;
+    related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    moveReason: z.ZodOptional<z.ZodEnum<["zone-pin-override", "import-neighbor-majority", "directory-consolidation"]>>;
+    predictedImpact: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+    pass: number;
+    scope: string;
+    text: string;
+    from?: string | undefined;
+    to?: string | undefined;
+    severity?: "info" | "warning" | "critical" | undefined;
+    related?: string[] | undefined;
+    moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+    predictedImpact?: number | undefined;
+}, {
+    type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+    pass: number;
+    scope: string;
+    text: string;
+    from?: string | undefined;
+    to?: string | undefined;
+    severity?: "info" | "warning" | "critical" | undefined;
+    related?: string[] | undefined;
+    moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+    predictedImpact?: number | undefined;
+}>;
+export declare const ZonesSchema: z.ZodObject<{
+    zones: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        files: z.ZodArray<z.ZodString, "many">;
+        entryPoints: z.ZodArray<z.ZodString, "many">;
+        cohesion: z.ZodNumber;
+        coupling: z.ZodNumber;
+        insights: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        files: string[];
+        id: string;
+        name: string;
+        description: string;
+        entryPoints: string[];
+        cohesion: number;
+        coupling: number;
+        insights?: string[] | undefined;
+    }, {
+        files: string[];
+        id: string;
+        name: string;
+        description: string;
+        entryPoints: string[];
+        cohesion: number;
+        coupling: number;
+        insights?: string[] | undefined;
+    }>, "many">;
+    crossings: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        fromZone: z.ZodString;
+        toZone: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        fromZone: string;
+        toZone: string;
+    }, {
+        from: string;
+        to: string;
+        fromZone: string;
+        toZone: string;
+    }>, "many">;
+    unzoned: z.ZodArray<z.ZodString, "many">;
+    insights: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["observation", "pattern", "relationship", "anti-pattern", "suggestion", "move-file"]>;
+        pass: z.ZodNumber;
+        scope: z.ZodString;
+        text: z.ZodString;
+        severity: z.ZodOptional<z.ZodEnum<["info", "warning", "critical"]>>;
+        related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        moveReason: z.ZodOptional<z.ZodEnum<["zone-pin-override", "import-neighbor-majority", "directory-consolidation"]>>;
+        predictedImpact: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+        pass: number;
+        scope: string;
+        text: string;
+        from?: string | undefined;
+        to?: string | undefined;
+        severity?: "info" | "warning" | "critical" | undefined;
+        related?: string[] | undefined;
+        moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+        predictedImpact?: number | undefined;
+    }, {
+        type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+        pass: number;
+        scope: string;
+        text: string;
+        from?: string | undefined;
+        to?: string | undefined;
+        severity?: "info" | "warning" | "critical" | undefined;
+        related?: string[] | undefined;
+        moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+        predictedImpact?: number | undefined;
+    }>, "many">>;
+    enrichmentPass: z.ZodOptional<z.ZodNumber>;
+    metaEvaluationCount: z.ZodOptional<z.ZodNumber>;
+    structureHash: z.ZodOptional<z.ZodString>;
+    zoneContentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    lastReset: z.ZodOptional<z.ZodObject<{
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        from: number;
+        to: number;
+    }, {
+        from: number;
+        to: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    zones: {
+        files: string[];
+        id: string;
+        name: string;
+        description: string;
+        entryPoints: string[];
+        cohesion: number;
+        coupling: number;
+        insights?: string[] | undefined;
+    }[];
+    crossings: {
+        from: string;
+        to: string;
+        fromZone: string;
+        toZone: string;
+    }[];
+    unzoned: string[];
+    insights?: string[] | undefined;
+    findings?: {
+        type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+        pass: number;
+        scope: string;
+        text: string;
+        from?: string | undefined;
+        to?: string | undefined;
+        severity?: "info" | "warning" | "critical" | undefined;
+        related?: string[] | undefined;
+        moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+        predictedImpact?: number | undefined;
+    }[] | undefined;
+    enrichmentPass?: number | undefined;
+    metaEvaluationCount?: number | undefined;
+    structureHash?: string | undefined;
+    zoneContentHashes?: Record<string, string> | undefined;
+    lastReset?: {
+        from: number;
+        to: number;
+    } | undefined;
+}, {
+    zones: {
+        files: string[];
+        id: string;
+        name: string;
+        description: string;
+        entryPoints: string[];
+        cohesion: number;
+        coupling: number;
+        insights?: string[] | undefined;
+    }[];
+    crossings: {
+        from: string;
+        to: string;
+        fromZone: string;
+        toZone: string;
+    }[];
+    unzoned: string[];
+    insights?: string[] | undefined;
+    findings?: {
+        type: "pattern" | "observation" | "relationship" | "anti-pattern" | "suggestion" | "move-file";
+        pass: number;
+        scope: string;
+        text: string;
+        from?: string | undefined;
+        to?: string | undefined;
+        severity?: "info" | "warning" | "critical" | undefined;
+        related?: string[] | undefined;
+        moveReason?: "zone-pin-override" | "import-neighbor-majority" | "directory-consolidation" | undefined;
+        predictedImpact?: number | undefined;
+    }[] | undefined;
+    enrichmentPass?: number | undefined;
+    metaEvaluationCount?: number | undefined;
+    structureHash?: string | undefined;
+    zoneContentHashes?: Record<string, string> | undefined;
+    lastReset?: {
+        from: number;
+        to: number;
+    } | undefined;
+}>;
+export declare const ComponentsSchema: z.ZodObject<{
+    components: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<["function", "arrow", "class", "forwardRef"]>;
+        line: z.ZodNumber;
+        isDefaultExport: z.ZodBoolean;
+        conventionExports: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        kind: "function" | "arrow" | "class" | "forwardRef";
+        file: string;
+        line: number;
+        isDefaultExport: boolean;
+        conventionExports: string[];
+    }, {
+        name: string;
+        kind: "function" | "arrow" | "class" | "forwardRef";
+        file: string;
+        line: number;
+        isDefaultExport: boolean;
+        conventionExports: string[];
+    }>, "many">;
+    usageEdges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        componentName: z.ZodString;
+        usageCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        componentName: string;
+        usageCount: number;
+    }, {
+        from: string;
+        to: string;
+        componentName: string;
+        usageCount: number;
+    }>, "many">;
+    routeModules: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        routePattern: z.ZodNullable<z.ZodString>;
+        exports: z.ZodArray<z.ZodEnum<["loader", "action", "default", "meta", "links", "headers", "ErrorBoundary", "shouldRevalidate", "handle", "HydrateFallback"]>, "many">;
+        parentLayout: z.ZodNullable<z.ZodString>;
+        isLayout: z.ZodBoolean;
+        isIndex: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        routePattern: string | null;
+        exports: ("loader" | "action" | "default" | "meta" | "links" | "headers" | "ErrorBoundary" | "shouldRevalidate" | "handle" | "HydrateFallback")[];
+        parentLayout: string | null;
+        isLayout: boolean;
+        isIndex: boolean;
+    }, {
+        file: string;
+        routePattern: string | null;
+        exports: ("loader" | "action" | "default" | "meta" | "links" | "headers" | "ErrorBoundary" | "shouldRevalidate" | "handle" | "HydrateFallback")[];
+        parentLayout: string | null;
+        isLayout: boolean;
+        isIndex: boolean;
+    }>, "many">;
+    routeTree: z.ZodArray<z.ZodType<V1.RouteTreeNode, z.ZodTypeDef, V1.RouteTreeNode>, "many">;
+    serverRoutes: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        prefix: z.ZodString;
+        handler: z.ZodOptional<z.ZodString>;
+        routes: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"]>;
+            path: z.ZodString;
+            handler: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }, {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        prefix: string;
+        routes: {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }[];
+        handler?: string | undefined;
+    }, {
+        file: string;
+        prefix: string;
+        routes: {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }[];
+        handler?: string | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalComponents: z.ZodNumber;
+        totalRouteModules: z.ZodNumber;
+        totalUsageEdges: z.ZodNumber;
+        totalServerRoutes: z.ZodNumber;
+        routeConventions: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        mostUsedComponents: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            file: z.ZodString;
+            usageCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            file: string;
+            usageCount: number;
+        }, {
+            name: string;
+            file: string;
+            usageCount: number;
+        }>, "many">;
+        layoutDepth: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalComponents: number;
+        totalRouteModules: number;
+        totalUsageEdges: number;
+        totalServerRoutes: number;
+        routeConventions: Record<string, number>;
+        mostUsedComponents: {
+            name: string;
+            file: string;
+            usageCount: number;
+        }[];
+        layoutDepth: number;
+    }, {
+        totalComponents: number;
+        totalRouteModules: number;
+        totalUsageEdges: number;
+        totalServerRoutes: number;
+        routeConventions: Record<string, number>;
+        mostUsedComponents: {
+            name: string;
+            file: string;
+            usageCount: number;
+        }[];
+        layoutDepth: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    summary: {
+        totalComponents: number;
+        totalRouteModules: number;
+        totalUsageEdges: number;
+        totalServerRoutes: number;
+        routeConventions: Record<string, number>;
+        mostUsedComponents: {
+            name: string;
+            file: string;
+            usageCount: number;
+        }[];
+        layoutDepth: number;
+    };
+    components: {
+        name: string;
+        kind: "function" | "arrow" | "class" | "forwardRef";
+        file: string;
+        line: number;
+        isDefaultExport: boolean;
+        conventionExports: string[];
+    }[];
+    usageEdges: {
+        from: string;
+        to: string;
+        componentName: string;
+        usageCount: number;
+    }[];
+    routeModules: {
+        file: string;
+        routePattern: string | null;
+        exports: ("loader" | "action" | "default" | "meta" | "links" | "headers" | "ErrorBoundary" | "shouldRevalidate" | "handle" | "HydrateFallback")[];
+        parentLayout: string | null;
+        isLayout: boolean;
+        isIndex: boolean;
+    }[];
+    routeTree: V1.RouteTreeNode[];
+    serverRoutes: {
+        file: string;
+        prefix: string;
+        routes: {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }[];
+        handler?: string | undefined;
+    }[];
+}, {
+    summary: {
+        totalComponents: number;
+        totalRouteModules: number;
+        totalUsageEdges: number;
+        totalServerRoutes: number;
+        routeConventions: Record<string, number>;
+        mostUsedComponents: {
+            name: string;
+            file: string;
+            usageCount: number;
+        }[];
+        layoutDepth: number;
+    };
+    components: {
+        name: string;
+        kind: "function" | "arrow" | "class" | "forwardRef";
+        file: string;
+        line: number;
+        isDefaultExport: boolean;
+        conventionExports: string[];
+    }[];
+    usageEdges: {
+        from: string;
+        to: string;
+        componentName: string;
+        usageCount: number;
+    }[];
+    routeModules: {
+        file: string;
+        routePattern: string | null;
+        exports: ("loader" | "action" | "default" | "meta" | "links" | "headers" | "ErrorBoundary" | "shouldRevalidate" | "handle" | "HydrateFallback")[];
+        parentLayout: string | null;
+        isLayout: boolean;
+        isIndex: boolean;
+    }[];
+    routeTree: V1.RouteTreeNode[];
+    serverRoutes: {
+        file: string;
+        prefix: string;
+        routes: {
+            path: string;
+            file: string;
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            handler?: string | undefined;
+        }[];
+        handler?: string | undefined;
+    }[];
+}>;
+export declare const CallGraphSchema: z.ZodObject<{
+    functions: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        name: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        qualifiedName: z.ZodString;
+        isExported: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+        qualifiedName: string;
+        isExported: boolean;
+    }, {
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+        qualifiedName: string;
+        isExported: boolean;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        callerFile: z.ZodString;
+        caller: z.ZodString;
+        calleeFile: z.ZodNullable<z.ZodString>;
+        callee: z.ZodString;
+        type: z.ZodEnum<["direct", "method", "property-chain", "computed"]>;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "method" | "direct" | "property-chain" | "computed";
+        line: number;
+        column: number;
+        callerFile: string;
+        caller: string;
+        calleeFile: string | null;
+        callee: string;
+    }, {
+        type: "method" | "direct" | "property-chain" | "computed";
+        line: number;
+        column: number;
+        callerFile: string;
+        caller: string;
+        calleeFile: string | null;
+        callee: string;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalFunctions: z.ZodNumber;
+        totalCalls: z.ZodNumber;
+        filesWithCalls: z.ZodNumber;
+        mostCalled: z.ZodArray<z.ZodObject<{
+            qualifiedName: z.ZodString;
+            file: z.ZodString;
+            callerCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }, {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }>, "many">;
+        mostCalling: z.ZodArray<z.ZodObject<{
+            qualifiedName: z.ZodString;
+            file: z.ZodString;
+            calleeCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }, {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }>, "many">;
+        cycleCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalFunctions: number;
+        totalCalls: number;
+        filesWithCalls: number;
+        mostCalled: {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }[];
+        mostCalling: {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }[];
+        cycleCount: number;
+    }, {
+        totalFunctions: number;
+        totalCalls: number;
+        filesWithCalls: number;
+        mostCalled: {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }[];
+        mostCalling: {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }[];
+        cycleCount: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    summary: {
+        totalFunctions: number;
+        totalCalls: number;
+        filesWithCalls: number;
+        mostCalled: {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }[];
+        mostCalling: {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }[];
+        cycleCount: number;
+    };
+    edges: {
+        type: "method" | "direct" | "property-chain" | "computed";
+        line: number;
+        column: number;
+        callerFile: string;
+        caller: string;
+        calleeFile: string | null;
+        callee: string;
+    }[];
+    functions: {
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+        qualifiedName: string;
+        isExported: boolean;
+    }[];
+}, {
+    summary: {
+        totalFunctions: number;
+        totalCalls: number;
+        filesWithCalls: number;
+        mostCalled: {
+            file: string;
+            qualifiedName: string;
+            callerCount: number;
+        }[];
+        mostCalling: {
+            file: string;
+            qualifiedName: string;
+            calleeCount: number;
+        }[];
+        cycleCount: number;
+    };
+    edges: {
+        type: "method" | "direct" | "property-chain" | "computed";
+        line: number;
+        column: number;
+        callerFile: string;
+        caller: string;
+        calleeFile: string | null;
+        callee: string;
+    }[];
+    functions: {
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+        qualifiedName: string;
+        isExported: boolean;
+    }[];
+}>;
+export declare const BranchWorkRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodString;
+    branch: z.ZodString;
+    baseBranch: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        level: z.ZodString;
+        completedAt: z.ZodString;
+        parentChain: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            level: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            level: string;
+        }, {
+            id: string;
+            title: string;
+            level: string;
+        }>, "many">;
+        priority: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+        acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        changeSignificance: z.ZodOptional<z.ZodEnum<["patch", "minor", "major"]>>;
+        breakingChange: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        completedAt: string;
+        id: string;
+        title: string;
+        level: string;
+        parentChain: {
+            id: string;
+            title: string;
+            level: string;
+        }[];
+        description?: string | undefined;
+        priority?: string | undefined;
+        tags?: string[] | undefined;
+        acceptanceCriteria?: string[] | undefined;
+        changeSignificance?: "patch" | "minor" | "major" | undefined;
+        breakingChange?: boolean | undefined;
+    }, {
+        completedAt: string;
+        id: string;
+        title: string;
+        level: string;
+        parentChain: {
+            id: string;
+            title: string;
+            level: string;
+        }[];
+        description?: string | undefined;
+        priority?: string | undefined;
+        tags?: string[] | undefined;
+        acceptanceCriteria?: string[] | undefined;
+        changeSignificance?: "patch" | "minor" | "major" | undefined;
+        breakingChange?: boolean | undefined;
+    }>, "many">;
+    epicSummaries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        completedCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        completedCount: number;
+    }, {
+        id: string;
+        title: string;
+        completedCount: number;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodObject<{
+        totalCompletedCount: z.ZodOptional<z.ZodNumber>;
+        gitSha: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        totalCompletedCount: z.ZodOptional<z.ZodNumber>;
+        gitSha: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        totalCompletedCount: z.ZodOptional<z.ZodNumber>;
+        gitSha: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: string;
+    branch: string;
+    baseBranch: string;
+    createdAt: string;
+    updatedAt: string;
+    items: {
+        completedAt: string;
+        id: string;
+        title: string;
+        level: string;
+        parentChain: {
+            id: string;
+            title: string;
+            level: string;
+        }[];
+        description?: string | undefined;
+        priority?: string | undefined;
+        tags?: string[] | undefined;
+        acceptanceCriteria?: string[] | undefined;
+        changeSignificance?: "patch" | "minor" | "major" | undefined;
+        breakingChange?: boolean | undefined;
+    }[];
+    epicSummaries: {
+        id: string;
+        title: string;
+        completedCount: number;
+    }[];
+    metadata?: z.objectOutputType<{
+        totalCompletedCount: z.ZodOptional<z.ZodNumber>;
+        gitSha: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+}, {
+    schemaVersion: string;
+    branch: string;
+    baseBranch: string;
+    createdAt: string;
+    updatedAt: string;
+    items: {
+        completedAt: string;
+        id: string;
+        title: string;
+        level: string;
+        parentChain: {
+            id: string;
+            title: string;
+            level: string;
+        }[];
+        description?: string | undefined;
+        priority?: string | undefined;
+        tags?: string[] | undefined;
+        acceptanceCriteria?: string[] | undefined;
+        changeSignificance?: "patch" | "minor" | "major" | undefined;
+        breakingChange?: boolean | undefined;
+    }[];
+    epicSummaries: {
+        id: string;
+        title: string;
+        completedCount: number;
+    }[];
+    metadata?: z.objectInputType<{
+        totalCompletedCount: z.ZodOptional<z.ZodNumber>;
+        gitSha: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+}>;
+export type ValidationResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    errors: z.ZodError;
+};
+export declare function validateManifest(data: unknown): ValidationResult<V1.Manifest>;
+export declare function validateInventory(data: unknown): ValidationResult<V1.Inventory>;
+export declare function validateImports(data: unknown): ValidationResult<V1.Imports>;
+export declare function validateClassifications(data: unknown): ValidationResult<V1.Classifications>;
+export declare function validateZones(data: unknown): ValidationResult<V1.Zones>;
+export declare function validateComponents(data: unknown): ValidationResult<V1.Components>;
+export declare function validateCallGraph(data: unknown): ValidationResult<V1.CallGraph>;
+export declare function validateBranchWorkRecord(data: unknown): ValidationResult<V1.BranchWorkRecord>;
+/** Validate any module output by name */
+export declare function validateModule(name: string, data: unknown): ValidationResult<unknown>;
+/**
+ * Format Zod validation errors into clear, actionable messages.
+ *
+ * Each error includes the field path and what was expected, making it
+ * easy to pinpoint and fix the issue.
+ */
+export declare function formatValidationErrors(errors: z.ZodError): string[];