@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/workflow/code-reality-artifacts.schema.d.ts

@@ -0,0 +1,914 @@
+/**
+ * Code-reality graph summary artifact — counts + top items per inventory.
+ * SUMMARIZES the typed knowledge_nodes/knowledge_edges graph (does not replace it).
+ * Refs: #1251 / parent #1250 (finishes #689).
+ */
+import { z } from 'zod';
+/**
+ * Code-reality ontology vocabulary for the deterministic indexer.
+ * Reuses KG-v2 code_reality / architecture node-type names where they exist
+ * (node-v2.schema.ts) and adds the path-level kinds the indexer needs.
+ * Persisted to knowledge_nodes.kg_ontology_type (TEXT; validated here).
+ */
+export declare const CodeRealityOntologyTypeSchema: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+export type CodeRealityOntologyType = z.infer<typeof CodeRealityOntologyTypeSchema>;
+export declare const CodeRealitySummaryItemSchema: z.ZodObject<{
+    stableKey: z.ZodString;
+    label: z.ZodString;
+    ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+    stableKey: string;
+    path?: string | undefined;
+}, {
+    label: string;
+    ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+    stableKey: string;
+    path?: string | undefined;
+}>;
+export type CodeRealitySummaryItem = z.infer<typeof CodeRealitySummaryItemSchema>;
+declare const InventorySummarySchema: z.ZodObject<{
+    totalCount: z.ZodNumber;
+    topItems: z.ZodArray<z.ZodObject<{
+        stableKey: z.ZodString;
+        label: z.ZodString;
+        ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+        stableKey: string;
+        path?: string | undefined;
+    }, {
+        label: string;
+        ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+        stableKey: string;
+        path?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    totalCount: number;
+    topItems: {
+        label: string;
+        ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+        stableKey: string;
+        path?: string | undefined;
+    }[];
+}, {
+    totalCount: number;
+    topItems: {
+        label: string;
+        ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+        stableKey: string;
+        path?: string | undefined;
+    }[];
+}>;
+export type CodeRealityInventorySummary = z.infer<typeof InventorySummarySchema>;
+/**
+ * Honest coverage for the semantic portion of a code-reality scan.
+ * The Git tree and eligible indexer content are exhaustive — no file-count cap.
+ * `contentMax` is legacy-only (old snapshots that sliced the tree).
+ * Absence of semanticCoverage means a legacy snapshot and must be re-scanned.
+ */
+export declare const CodeRealitySemanticCoverageSchema: z.ZodObject<{
+    structuralObservedFiles: z.ZodNumber;
+    structuralComplete: z.ZodBoolean;
+    eligibleFiles: z.ZodNumber;
+    selectedFiles: z.ZodNumber;
+    fetchedFiles: z.ZodNumber;
+    fetchFailedFiles: z.ZodNumber;
+    structurallyOnlyFiles: z.ZodNumber;
+    ast: z.ZodObject<{
+        candidateFiles: z.ZodNumber;
+        attemptedFiles: z.ZodNumber;
+        parsedFiles: z.ZodNumber;
+        failedFiles: z.ZodNumber;
+        symbolCapHitFiles: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        candidateFiles: number;
+        attemptedFiles: number;
+        parsedFiles: number;
+        failedFiles: number;
+        symbolCapHitFiles: number;
+    }, {
+        candidateFiles: number;
+        attemptedFiles: number;
+        parsedFiles: number;
+        failedFiles: number;
+        symbolCapHitFiles: number;
+    }>;
+    bounds: z.ZodObject<{
+        contentCapped: z.ZodBoolean;
+        contentMax: z.ZodOptional<z.ZodNumber>;
+        symbolsPerFile: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        contentCapped: boolean;
+        symbolsPerFile: number;
+        contentMax?: number | undefined;
+    }, {
+        contentCapped: boolean;
+        symbolsPerFile: number;
+        contentMax?: number | undefined;
+    }>;
+    /** Omitted on legacy snapshots. Incremental selected < eligible is not a cap. */
+    scanScope: z.ZodOptional<z.ZodEnum<["full", "incremental"]>>;
+    semanticComplete: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    fetchedFiles: number;
+    eligibleFiles: number;
+    structuralObservedFiles: number;
+    structuralComplete: boolean;
+    selectedFiles: number;
+    fetchFailedFiles: number;
+    structurallyOnlyFiles: number;
+    ast: {
+        candidateFiles: number;
+        attemptedFiles: number;
+        parsedFiles: number;
+        failedFiles: number;
+        symbolCapHitFiles: number;
+    };
+    bounds: {
+        contentCapped: boolean;
+        symbolsPerFile: number;
+        contentMax?: number | undefined;
+    };
+    semanticComplete: boolean;
+    scanScope?: "full" | "incremental" | undefined;
+}, {
+    fetchedFiles: number;
+    eligibleFiles: number;
+    structuralObservedFiles: number;
+    structuralComplete: boolean;
+    selectedFiles: number;
+    fetchFailedFiles: number;
+    structurallyOnlyFiles: number;
+    ast: {
+        candidateFiles: number;
+        attemptedFiles: number;
+        parsedFiles: number;
+        failedFiles: number;
+        symbolCapHitFiles: number;
+    };
+    bounds: {
+        contentCapped: boolean;
+        symbolsPerFile: number;
+        contentMax?: number | undefined;
+    };
+    semanticComplete: boolean;
+    scanScope?: "full" | "incremental" | undefined;
+}>;
+export type CodeRealitySemanticCoverage = z.infer<typeof CodeRealitySemanticCoverageSchema>;
+/**
+ * Single bundled snapshot artifact (no split-brain): the typed graph lives in
+ * knowledge_nodes/knowledge_edges; this payload is the counts/top-items overlay.
+ */
+export declare const CodeRealityGraphSnapshotPayloadSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    generatedAt: z.ZodString;
+    repoName: z.ZodString;
+    commitSha: z.ZodString;
+    commitShaTraceabilityWarning: z.ZodNullable<z.ZodString>;
+    graphLayer: z.ZodLiteral<"code_reality">;
+    nodeCountByType: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    edgeCountByRelation: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    totalNodes: z.ZodNumber;
+    totalEdges: z.ZodNumber;
+    astExtracted: z.ZodBoolean;
+    /** Undefined only for legacy snapshots; consumers must request a re-scan. */
+    semanticCoverage: z.ZodOptional<z.ZodObject<{
+        structuralObservedFiles: z.ZodNumber;
+        structuralComplete: z.ZodBoolean;
+        eligibleFiles: z.ZodNumber;
+        selectedFiles: z.ZodNumber;
+        fetchedFiles: z.ZodNumber;
+        fetchFailedFiles: z.ZodNumber;
+        structurallyOnlyFiles: z.ZodNumber;
+        ast: z.ZodObject<{
+            candidateFiles: z.ZodNumber;
+            attemptedFiles: z.ZodNumber;
+            parsedFiles: z.ZodNumber;
+            failedFiles: z.ZodNumber;
+            symbolCapHitFiles: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        }, {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        }>;
+        bounds: z.ZodObject<{
+            contentCapped: z.ZodBoolean;
+            contentMax: z.ZodOptional<z.ZodNumber>;
+            symbolsPerFile: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        }, {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        }>;
+        /** Omitted on legacy snapshots. Incremental selected < eligible is not a cap. */
+        scanScope: z.ZodOptional<z.ZodEnum<["full", "incremental"]>>;
+        semanticComplete: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        fetchedFiles: number;
+        eligibleFiles: number;
+        structuralObservedFiles: number;
+        structuralComplete: boolean;
+        selectedFiles: number;
+        fetchFailedFiles: number;
+        structurallyOnlyFiles: number;
+        ast: {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        };
+        bounds: {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        };
+        semanticComplete: boolean;
+        scanScope?: "full" | "incremental" | undefined;
+    }, {
+        fetchedFiles: number;
+        eligibleFiles: number;
+        structuralObservedFiles: number;
+        structuralComplete: boolean;
+        selectedFiles: number;
+        fetchFailedFiles: number;
+        structurallyOnlyFiles: number;
+        ast: {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        };
+        bounds: {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        };
+        semanticComplete: boolean;
+        scanScope?: "full" | "incremental" | undefined;
+    }>>;
+    routeInventory: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            stableKey: z.ZodString;
+            label: z.ZodString;
+            ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }>;
+    apiInventory: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            stableKey: z.ZodString;
+            label: z.ZodString;
+            ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }>;
+    schemaInventory: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            stableKey: z.ZodString;
+            label: z.ZodString;
+            ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }>;
+    uiInventory: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            stableKey: z.ZodString;
+            label: z.ZodString;
+            ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }>;
+    workflowInventory: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            stableKey: z.ZodString;
+            label: z.ZodString;
+            ontologyType: z.ZodEnum<["Directory", "File", "FrontendRoute", "APIRoute", "RouteHandler", "ApiHandler", "ServerAction", "Contract", "ZodSchema", "SQLMigration", "SupabaseTable", "RLSActualPolicy", "ReactComponent", "Component", "Hook", "Test", "CIWorkflow", "DeploymentConfig", "ExportedSymbol", "ExportedFunction", "RepoPolicyDomain", "GuardianRule", "CursorSkill", "AgentInstruction"]>;
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }, {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    }>;
+    findingRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    duplicateClusterRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    orphanRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    splitBrainRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    performanceHotspotRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    securityFindingRegister: z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>;
+    /**
+     * File/symbol nodes reachable only from test files (#1846 N3) — imported or
+     * called exclusively by `test_code`-scoped files. Not orphaned (something
+     * does reference them) but not wired into runtime code either; kept out of
+     * `orphanRegister` so a test-only fixture is never reported as dead code.
+     * Optional: absent on snapshots built before this register existed.
+     */
+    testOnlyImportRegister: z.ZodOptional<z.ZodObject<{
+        totalCount: z.ZodNumber;
+        topItems: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+        }, {
+            label: string;
+            key: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }, {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    }>>;
+    /** Offline repo-intel rollup merged at scan time (#1394). */
+    repoIntelRollup: z.ZodOptional<z.ZodObject<{
+        driftFindings: z.ZodNumber;
+        orphanFindings: z.ZodNumber;
+        criticalDrift: z.ZodNumber;
+        contentHash: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        driftFindings: number;
+        orphanFindings: number;
+        criticalDrift: number;
+        contentHash?: string | undefined;
+    }, {
+        driftFindings: number;
+        orphanFindings: number;
+        criticalDrift: number;
+        contentHash?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "1.0.0";
+    generatedAt: string;
+    totalNodes: number;
+    commitSha: string;
+    repoName: string;
+    totalEdges: number;
+    commitShaTraceabilityWarning: string | null;
+    graphLayer: "code_reality";
+    nodeCountByType: Record<string, number>;
+    edgeCountByRelation: Record<string, number>;
+    astExtracted: boolean;
+    routeInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    apiInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    schemaInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    uiInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    workflowInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    findingRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    duplicateClusterRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    orphanRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    splitBrainRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    performanceHotspotRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    securityFindingRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    semanticCoverage?: {
+        fetchedFiles: number;
+        eligibleFiles: number;
+        structuralObservedFiles: number;
+        structuralComplete: boolean;
+        selectedFiles: number;
+        fetchFailedFiles: number;
+        structurallyOnlyFiles: number;
+        ast: {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        };
+        bounds: {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        };
+        semanticComplete: boolean;
+        scanScope?: "full" | "incremental" | undefined;
+    } | undefined;
+    testOnlyImportRegister?: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    } | undefined;
+    repoIntelRollup?: {
+        driftFindings: number;
+        orphanFindings: number;
+        criticalDrift: number;
+        contentHash?: string | undefined;
+    } | undefined;
+}, {
+    schemaVersion: "1.0.0";
+    generatedAt: string;
+    totalNodes: number;
+    commitSha: string;
+    repoName: string;
+    totalEdges: number;
+    commitShaTraceabilityWarning: string | null;
+    graphLayer: "code_reality";
+    nodeCountByType: Record<string, number>;
+    edgeCountByRelation: Record<string, number>;
+    astExtracted: boolean;
+    routeInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    apiInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    schemaInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    uiInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    workflowInventory: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            ontologyType: "APIRoute" | "FrontendRoute" | "Component" | "File" | "RouteHandler" | "ServerAction" | "ReactComponent" | "ZodSchema" | "SQLMigration" | "SupabaseTable" | "RLSActualPolicy" | "Directory" | "ApiHandler" | "Contract" | "Hook" | "Test" | "CIWorkflow" | "DeploymentConfig" | "ExportedSymbol" | "ExportedFunction" | "RepoPolicyDomain" | "GuardianRule" | "CursorSkill" | "AgentInstruction";
+            stableKey: string;
+            path?: string | undefined;
+        }[];
+    };
+    findingRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    duplicateClusterRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    orphanRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    splitBrainRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    performanceHotspotRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    securityFindingRegister: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    };
+    semanticCoverage?: {
+        fetchedFiles: number;
+        eligibleFiles: number;
+        structuralObservedFiles: number;
+        structuralComplete: boolean;
+        selectedFiles: number;
+        fetchFailedFiles: number;
+        structurallyOnlyFiles: number;
+        ast: {
+            candidateFiles: number;
+            attemptedFiles: number;
+            parsedFiles: number;
+            failedFiles: number;
+            symbolCapHitFiles: number;
+        };
+        bounds: {
+            contentCapped: boolean;
+            symbolsPerFile: number;
+            contentMax?: number | undefined;
+        };
+        semanticComplete: boolean;
+        scanScope?: "full" | "incremental" | undefined;
+    } | undefined;
+    testOnlyImportRegister?: {
+        totalCount: number;
+        topItems: {
+            label: string;
+            key: string;
+        }[];
+    } | undefined;
+    repoIntelRollup?: {
+        driftFindings: number;
+        orphanFindings: number;
+        criticalDrift: number;
+        contentHash?: string | undefined;
+    } | undefined;
+}>;
+export type CodeRealityGraphSnapshotPayload = z.infer<typeof CodeRealityGraphSnapshotPayloadSchema>;
+export {};