@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/graph/graph-query-v2.schema.d.ts

@@ -0,0 +1,449 @@
+/**
+ * MS-01 — Typed graph query contracts (Intent / Architecture / Code Reality overlay).
+ * Queries run on canonical knowledge_nodes / knowledge_edges (+ optional kg_* columns).
+ */
+import { z } from "zod";
+export declare const GraphQueryProjectContextSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export type GraphQueryProjectContext = z.infer<typeof GraphQueryProjectContextSchema>;
+export declare const GraphRequirementCoverageQuerySchema: z.ZodObject<{
+    projectId: z.ZodString;
+} & {
+    requirementNodeId: z.ZodString;
+    /** Max BFS hops from the requirement across implement / verify / deploy edges */
+    maxHops: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    requirementNodeId: string;
+    maxHops?: number | undefined;
+}, {
+    projectId: string;
+    requirementNodeId: string;
+    maxHops?: number | undefined;
+}>;
+export type GraphRequirementCoverageQuery = z.infer<typeof GraphRequirementCoverageQuerySchema>;
+export declare const GraphCoverageParticipantSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    knowledgeType: z.ZodString;
+    kgLayer: z.ZodOptional<z.ZodNullable<z.ZodEnum<["intent", "architecture", "code_reality"]>>>;
+    kgOntologyType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kgStableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    knowledgeType: string;
+    label?: string | null | undefined;
+    kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+    kgOntologyType?: string | null | undefined;
+    kgStableKey?: string | null | undefined;
+}, {
+    nodeId: string;
+    knowledgeType: string;
+    label?: string | null | undefined;
+    kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+    kgOntologyType?: string | null | undefined;
+    kgStableKey?: string | null | undefined;
+}>;
+export declare const GraphRequirementCoverageEdgeSchema: z.ZodObject<{
+    edgeId: z.ZodString;
+    sourceId: z.ZodString;
+    targetId: z.ZodString;
+    legacyRelation: z.ZodString;
+    kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+}, "strip", z.ZodTypeAny, {
+    sourceId: string;
+    targetId: string;
+    edgeId: string;
+    legacyRelation: string;
+    kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+}, {
+    sourceId: string;
+    targetId: string;
+    edgeId: string;
+    legacyRelation: string;
+    kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+}>;
+export declare const GraphRequirementCoverageResponseSchema: z.ZodObject<{
+    requirementNodeId: z.ZodString;
+    coveragePaths: z.ZodArray<z.ZodObject<{
+        hops: z.ZodNumber;
+        nodes: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            knowledgeType: z.ZodString;
+            kgLayer: z.ZodOptional<z.ZodNullable<z.ZodEnum<["intent", "architecture", "code_reality"]>>>;
+            kgOntologyType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kgStableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }, {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }>, "many">;
+        edges: z.ZodArray<z.ZodObject<{
+            edgeId: z.ZodString;
+            sourceId: z.ZodString;
+            targetId: z.ZodString;
+            legacyRelation: z.ZodString;
+            kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+        }, "strip", z.ZodTypeAny, {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }, {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        nodes: {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }[];
+        edges: {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }[];
+        hops: number;
+    }, {
+        nodes: {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }[];
+        edges: {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }[];
+        hops: number;
+    }>, "many">;
+    implementingNeighbors: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        knowledgeType: z.ZodString;
+        kgLayer: z.ZodOptional<z.ZodNullable<z.ZodEnum<["intent", "architecture", "code_reality"]>>>;
+        kgOntologyType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kgStableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        nodeId: string;
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+        kgOntologyType?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }, {
+        nodeId: string;
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+        kgOntologyType?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    requirementNodeId: string;
+    coveragePaths: {
+        nodes: {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }[];
+        edges: {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }[];
+        hops: number;
+    }[];
+    implementingNeighbors: {
+        nodeId: string;
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+        kgOntologyType?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }[];
+}, {
+    requirementNodeId: string;
+    coveragePaths: {
+        nodes: {
+            nodeId: string;
+            knowledgeType: string;
+            label?: string | null | undefined;
+            kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+            kgOntologyType?: string | null | undefined;
+            kgStableKey?: string | null | undefined;
+        }[];
+        edges: {
+            sourceId: string;
+            targetId: string;
+            edgeId: string;
+            legacyRelation: string;
+            kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+        }[];
+        hops: number;
+    }[];
+    implementingNeighbors: {
+        nodeId: string;
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgLayer?: "intent" | "architecture" | "code_reality" | null | undefined;
+        kgOntologyType?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }[];
+}>;
+export type GraphRequirementCoverageResponse = z.infer<typeof GraphRequirementCoverageResponseSchema>;
+export declare const GraphRouteTruthQuerySchema: z.ZodObject<{
+    projectId: z.ZodString;
+} & {
+    /** Normalised HTTP method (GET, POST, …) */
+    method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"]>;
+    /** Route template e.g. /api/graph/query/route-truth */
+    routePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    routePath: string;
+    method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+}, {
+    projectId: string;
+    routePath: string;
+    method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
+}>;
+export type GraphRouteTruthQuery = z.infer<typeof GraphRouteTruthQuerySchema>;
+export declare const GraphRouteTruthParticipantSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    role: z.ZodEnum<["handler_file", "contract_route", "deployment", "unknown"]>;
+    knowledgeType: z.ZodString;
+    kgStableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    role: "unknown" | "deployment" | "handler_file" | "contract_route";
+    knowledgeType: string;
+    label?: string | null | undefined;
+    kgStableKey?: string | null | undefined;
+}, {
+    nodeId: string;
+    role: "unknown" | "deployment" | "handler_file" | "contract_route";
+    knowledgeType: string;
+    label?: string | null | undefined;
+    kgStableKey?: string | null | undefined;
+}>;
+export declare const GraphRouteTruthResponseSchema: z.ZodObject<{
+    stableRouteKey: z.ZodString;
+    matchedNodes: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        role: z.ZodEnum<["handler_file", "contract_route", "deployment", "unknown"]>;
+        knowledgeType: z.ZodString;
+        kgStableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        nodeId: string;
+        role: "unknown" | "deployment" | "handler_file" | "contract_route";
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }, {
+        nodeId: string;
+        role: "unknown" | "deployment" | "handler_file" | "contract_route";
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }>, "many">;
+    linkedEdges: z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodString;
+        legacyRelation: z.ZodString;
+        kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+        sourceId: z.ZodString;
+        targetId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sourceId: string;
+        targetId: string;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }, {
+        sourceId: string;
+        targetId: string;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    stableRouteKey: string;
+    matchedNodes: {
+        nodeId: string;
+        role: "unknown" | "deployment" | "handler_file" | "contract_route";
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }[];
+    linkedEdges: {
+        sourceId: string;
+        targetId: string;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+}, {
+    stableRouteKey: string;
+    matchedNodes: {
+        nodeId: string;
+        role: "unknown" | "deployment" | "handler_file" | "contract_route";
+        knowledgeType: string;
+        label?: string | null | undefined;
+        kgStableKey?: string | null | undefined;
+    }[];
+    linkedEdges: {
+        sourceId: string;
+        targetId: string;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+}>;
+export type GraphRouteTruthResponse = z.infer<typeof GraphRouteTruthResponseSchema>;
+export declare const GraphDriftForFileQuerySchema: z.ZodObject<{
+    projectId: z.ZodString;
+} & {
+    /** Repo-relative POSIX path e.g. packages/frontend/src/app/page.tsx */
+    filePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    filePath: string;
+}, {
+    projectId: string;
+    filePath: string;
+}>;
+export type GraphDriftForFileQuery = z.infer<typeof GraphDriftForFileQuerySchema>;
+export declare const GraphDriftFindingSchema: z.ZodObject<{
+    edgeId: z.ZodString;
+    kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+    legacyRelation: z.ZodString;
+    summary: z.ZodString;
+    evidence: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    evidence: Record<string, unknown>;
+    edgeId: string;
+    legacyRelation: string;
+    kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+}, {
+    summary: string;
+    evidence: Record<string, unknown>;
+    edgeId: string;
+    legacyRelation: string;
+    kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+}>;
+export declare const GraphDriftForFileResponseSchema: z.ZodObject<{
+    fileStableKey: z.ZodString;
+    fileNodeIds: z.ZodArray<z.ZodString, "many">;
+    driftEdges: z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodString;
+        kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+        legacyRelation: z.ZodString;
+        summary: z.ZodString;
+        evidence: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }, {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }>, "many">;
+    supersedesEvidence: z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodString;
+        kgEdgeType: z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>;
+        legacyRelation: z.ZodString;
+        summary: z.ZodString;
+        evidence: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }, {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    fileStableKey: string;
+    fileNodeIds: string[];
+    driftEdges: {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+    supersedesEvidence: {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+}, {
+    fileStableKey: string;
+    fileNodeIds: string[];
+    driftEdges: {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+    supersedesEvidence: {
+        summary: string;
+        evidence: Record<string, unknown>;
+        edgeId: string;
+        legacyRelation: string;
+        kgEdgeType: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null;
+    }[];
+}>;
+export type GraphDriftForFileResponse = z.infer<typeof GraphDriftForFileResponseSchema>;

package/dist/schemas/graph/graph-query-v2.schema.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * MS-01 — Typed graph query contracts (Intent / Architecture / Code Reality overlay).
+ * Queries run on canonical knowledge_nodes / knowledge_edges (+ optional kg_* columns).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphDriftForFileResponseSchema = exports.GraphDriftFindingSchema = exports.GraphDriftForFileQuerySchema = exports.GraphRouteTruthResponseSchema = exports.GraphRouteTruthParticipantSchema = exports.GraphRouteTruthQuerySchema = exports.GraphRequirementCoverageResponseSchema = exports.GraphRequirementCoverageEdgeSchema = exports.GraphCoverageParticipantSchema = exports.GraphRequirementCoverageQuerySchema = exports.GraphQueryProjectContextSchema = void 0;
+const zod_1 = require("zod");
+const edge_v2_schema_1 = require("./edge-v2.schema");
+const node_v2_schema_1 = require("./node-v2.schema");
+exports.GraphQueryProjectContextSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+});
+exports.GraphRequirementCoverageQuerySchema = exports.GraphQueryProjectContextSchema.extend({
+    requirementNodeId: zod_1.z.string().uuid(),
+    /** Max BFS hops from the requirement across implement / verify / deploy edges */
+    maxHops: zod_1.z.number().int().min(1).max(12).optional(),
+});
+exports.GraphCoverageParticipantSchema = zod_1.z.object({
+    nodeId: zod_1.z.string().uuid(),
+    knowledgeType: zod_1.z.string(),
+    kgLayer: node_v2_schema_1.KgLayerSchema.nullable().optional(),
+    kgOntologyType: zod_1.z.string().nullable().optional(),
+    kgStableKey: zod_1.z.string().nullable().optional(),
+    label: zod_1.z.string().nullable().optional(),
+});
+exports.GraphRequirementCoverageEdgeSchema = zod_1.z.object({
+    edgeId: zod_1.z.string().uuid(),
+    sourceId: zod_1.z.string().uuid(),
+    targetId: zod_1.z.string().uuid(),
+    legacyRelation: zod_1.z.string(),
+    kgEdgeType: edge_v2_schema_1.KgEdgeTypeSchema.nullable(),
+});
+exports.GraphRequirementCoverageResponseSchema = zod_1.z.object({
+    requirementNodeId: zod_1.z.string().uuid(),
+    coveragePaths: zod_1.z.array(zod_1.z.object({
+        hops: zod_1.z.number().int().min(0),
+        nodes: zod_1.z.array(exports.GraphCoverageParticipantSchema),
+        edges: zod_1.z.array(exports.GraphRequirementCoverageEdgeSchema),
+    })),
+    implementingNeighbors: zod_1.z.array(exports.GraphCoverageParticipantSchema),
+});
+exports.GraphRouteTruthQuerySchema = exports.GraphQueryProjectContextSchema.extend({
+    /** Normalised HTTP method (GET, POST, …) */
+    method: zod_1.z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"]),
+    /** Route template e.g. /api/graph/query/route-truth */
+    routePath: zod_1.z.string().min(1).max(2048),
+});
+exports.GraphRouteTruthParticipantSchema = zod_1.z.object({
+    nodeId: zod_1.z.string().uuid(),
+    role: zod_1.z.enum(["handler_file", "contract_route", "deployment", "unknown"]),
+    knowledgeType: zod_1.z.string(),
+    kgStableKey: zod_1.z.string().nullable().optional(),
+    label: zod_1.z.string().nullable().optional(),
+});
+exports.GraphRouteTruthResponseSchema = zod_1.z.object({
+    stableRouteKey: zod_1.z.string(),
+    matchedNodes: zod_1.z.array(exports.GraphRouteTruthParticipantSchema),
+    linkedEdges: zod_1.z.array(zod_1.z.object({
+        edgeId: zod_1.z.string().uuid(),
+        legacyRelation: zod_1.z.string(),
+        kgEdgeType: edge_v2_schema_1.KgEdgeTypeSchema.nullable(),
+        sourceId: zod_1.z.string().uuid(),
+        targetId: zod_1.z.string().uuid(),
+    })),
+});
+exports.GraphDriftForFileQuerySchema = exports.GraphQueryProjectContextSchema.extend({
+    /** Repo-relative POSIX path e.g. packages/frontend/src/app/page.tsx */
+    filePath: zod_1.z.string().min(1).max(4096),
+});
+exports.GraphDriftFindingSchema = zod_1.z.object({
+    edgeId: zod_1.z.string().uuid(),
+    kgEdgeType: edge_v2_schema_1.KgEdgeTypeSchema.nullable(),
+    legacyRelation: zod_1.z.string(),
+    summary: zod_1.z.string(),
+    evidence: zod_1.z.record(zod_1.z.unknown()),
+});
+exports.GraphDriftForFileResponseSchema = zod_1.z.object({
+    fileStableKey: zod_1.z.string(),
+    fileNodeIds: zod_1.z.array(zod_1.z.string().uuid()),
+    driftEdges: zod_1.z.array(exports.GraphDriftFindingSchema),
+    supersedesEvidence: zod_1.z.array(exports.GraphDriftFindingSchema),
+});

package/dist/schemas/graph/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NeuraLoom — Knowledge Graph v2 schema barrel.
+ *
+ * Refs: GH umbrella #689.
+ * Canvas: canvases/mega-sprint-01-knowledge-graph-foundation.canvas.tsx
+ *
+ * KG-v2 lives alongside the existing traceability/* schemas; this barrel
+ * intentionally exports only the v2 additions to keep the public surface
+ * minimal until consumers opt-in.
+ */
+export * from "./node-v2.schema";
+export * from "./edge-v2.schema";
+export * from "./graph-query-v2.schema";
+export * from "./sql-security-findings.schema";