@c4a/context 0.6.19 → 0.7.0

package/indexerEvidenceAdapterResult.d.ts

@@ -0,0 +1,504 @@
+import { z } from "zod";
+export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.evidence-adapter-result/v1">;
+    adapter: z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        package: z.ZodString;
+        export: z.ZodString;
+        version: z.ZodString;
+        digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    }, {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    }>;
+    authorized_scope: z.ZodObject<{
+        source_ref: z.ZodString;
+        module_refs: z.ZodArray<z.ZodString, "many">;
+        scope_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }, {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    }>;
+    input_digest: z.ZodString;
+    precedence: z.ZodNumber;
+    files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        file_ref: z.ZodString;
+        source_ref: z.ZodString;
+        module_ref: z.ZodNullable<z.ZodString>;
+        normalized_path: z.ZodEffects<z.ZodString, string, string>;
+        role: z.ZodEnum<["primary-owner", "enricher"]>;
+        coverage_tier: z.ZodEnum<["ast-catalog", "lightweight-evidence"]>;
+        disposition: z.ZodEnum<["analyzed", "unsupported", "excluded"]>;
+        facts: z.ZodArray<z.ZodObject<{
+            fact_ref: z.ZodString;
+            kind: z.ZodEffects<z.ZodString, string, string>;
+            locator: z.ZodObject<{
+                source_ref: z.ZodString;
+                module_ref: z.ZodNullable<z.ZodString>;
+                normalized_path: z.ZodEffects<z.ZodString, string, string>;
+                qualified_item_path: z.ZodString;
+                signature_digest: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            }, {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            }>;
+            payload_digest: z.ZodString;
+            denominator: z.ZodEnum<["none", "eligible-file", "loc", "symbol", "protocol-item"]>;
+        }, "strict", z.ZodTypeAny, {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }, {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }, {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }>, {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }, {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }>, "many">;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodEffects<z.ZodString, string, string>;
+        fact_ref: z.ZodOptional<z.ZodString>;
+        severity: z.ZodEnum<["info", "warning", "error"]>;
+        detail_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }, {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }>, "many">;
+    toolchain: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        step: z.ZodEffects<z.ZodString, string, string>;
+        package: z.ZodString;
+        export: z.ZodString;
+        version: z.ZodString;
+        digest: z.ZodString;
+        capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        input_digest: z.ZodString;
+        output_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }, {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }>, {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }, {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }>, "many">;
+    output_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    adapter: {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    };
+    protocol: "context.indexer.evidence-adapter-result/v1";
+    files: {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }[];
+    input_digest: string;
+    output_digest: string;
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    precedence: number;
+    diagnostics: {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }[];
+    toolchain: {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }[];
+}, {
+    adapter: {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    };
+    protocol: "context.indexer.evidence-adapter-result/v1";
+    files: {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }[];
+    input_digest: string;
+    output_digest: string;
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    precedence: number;
+    diagnostics: {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }[];
+    toolchain: {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }[];
+}>, {
+    adapter: {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    };
+    protocol: "context.indexer.evidence-adapter-result/v1";
+    files: {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }[];
+    input_digest: string;
+    output_digest: string;
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    precedence: number;
+    diagnostics: {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }[];
+    toolchain: {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }[];
+}, {
+    adapter: {
+        id: string;
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+    };
+    protocol: "context.indexer.evidence-adapter-result/v1";
+    files: {
+        source_ref: string;
+        role: "enricher" | "primary-owner";
+        facts: {
+            kind: string;
+            locator: {
+                source_ref: string;
+                module_ref: string | null;
+                normalized_path: string;
+                qualified_item_path: string;
+                signature_digest: string;
+            };
+            payload_digest: string;
+            fact_ref: string;
+            denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+        }[];
+        module_ref: string | null;
+        normalized_path: string;
+        file_ref: string;
+        coverage_tier: "ast-catalog" | "lightweight-evidence";
+        disposition: "analyzed" | "unsupported" | "excluded";
+    }[];
+    input_digest: string;
+    output_digest: string;
+    authorized_scope: {
+        source_ref: string;
+        module_refs: string[];
+        scope_digest: string;
+    };
+    precedence: number;
+    diagnostics: {
+        code: string;
+        severity: "error" | "info" | "warning";
+        detail_digest: string;
+        fact_ref?: string | undefined;
+    }[];
+    toolchain: {
+        export: string;
+        digest: string;
+        package: string;
+        version: string;
+        step: string;
+        capabilities: string[];
+        input_digest: string;
+        output_digest: string;
+    }[];
+}>;
+export type IndexerEvidenceAdapterResult = z.infer<typeof indexerEvidenceAdapterResultSchema>;
+export type IndexerEvidenceAdapterFile = IndexerEvidenceAdapterResult["files"][number];
+export type IndexerEvidenceAdapterFact = IndexerEvidenceAdapterFile["facts"][number];
+export declare function indexerEvidenceAdapterFileRef(input: {
+    source_ref: string;
+    module_ref: string | null;
+    normalized_path: string;
+}): string;
+export declare function indexerEvidenceAdapterFactRef(input: {
+    source_ref: string;
+    module_ref: string | null;
+    normalized_path: string;
+    qualified_item_path: string;
+    kind: string;
+    signature_digest: string;
+}): string;
+export declare function indexerEvidenceAdapterOutputDigest(value: Omit<IndexerEvidenceAdapterResult, "output_digest">): string;
+export declare function validateIndexerEvidenceAdapterResult(value: unknown): IndexerEvidenceAdapterResult;
+export interface IndexerEvidenceAdapterMerge {
+    protocol: "context.indexer.evidence-adapter-merge/v1";
+    result_digests: string[];
+    primary_owners: Array<{
+        file_ref: string;
+        adapter_id: string;
+        coverage_tier: string;
+    }>;
+    facts: Array<IndexerEvidenceAdapterFact & {
+        adapter_id: string;
+        precedence: number;
+    }>;
+    conflicts: Array<{
+        fact_ref: string;
+        winner_adapter_id: string;
+        shadowed_adapter_ids: string[];
+    }>;
+    merge_digest: string;
+}
+export declare function mergeIndexerEvidenceAdapterResults(input: {
+    results: readonly unknown[];
+    eligible_file_refs: readonly string[];
+}): IndexerEvidenceAdapterMerge;