@c4a/context 0.7.8 → 0.7.10-alpha.1

package/indexerCollectionMapping.d.ts

@@ -30,10 +30,10 @@ export declare const indexerSectionCollectionSchema: z.ZodObject<{
 } & {
     resolution_digest: z.ZodString;
 }, "strict", z.ZodTypeAny, {
+    collection: import("./contracts.js").TopLevelNamespace;
     protocol: "context.indexer.section-collection/v1";
     profile: string;
     mapping_digest: string;
-    collection: import("./contracts.js").TopLevelNamespace;
     profile_contract_digest: string;
     source_role: string;
     resolution_digest: string;
@@ -45,10 +45,10 @@ export declare const indexerSectionCollectionSchema: z.ZodObject<{
         artifact_kind: string;
     };
 }, {
+    collection: import("./contracts.js").TopLevelNamespace;
     protocol: "context.indexer.section-collection/v1";
     profile: string;
     mapping_digest: string;
-    collection: import("./contracts.js").TopLevelNamespace;
     profile_contract_digest: string;
     source_role: string;
     resolution_digest: string;

package/indexerContentLayers.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { type ArticleSourceReference } from "./articleStructure.js";
 import type { IndexerJson } from "./indexerRegistry.js";
 export declare const indexerCanonicalJsonSchema: z.ZodType<IndexerJson>;
 export declare const indexerArtifactFactSchema: z.ZodObject<{
@@ -46,72 +47,219 @@ export declare const indexerArtifactFactSchema: z.ZodObject<{
     evidence_refs: string[];
 }>;
 export declare const indexerDeterministicBlockRendererSchema: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
-export declare const indexerArtifactContentBlockSchema: z.ZodDiscriminatedUnion<"layer", [z.ZodObject<{
-    block_id: z.ZodEffects<z.ZodString, string, string>;
-    layer: z.ZodLiteral<"deterministic-block">;
-    renderer: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
-    fact_refs: z.ZodArray<z.ZodString, "many">;
-}, "strict", z.ZodTypeAny, {
-    block_id: string;
-    layer: "deterministic-block";
-    renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-    fact_refs: string[];
-}, {
-    block_id: string;
-    layer: "deterministic-block";
-    renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
-    fact_refs: string[];
-}>, z.ZodObject<{
+export declare const indexerArtifactContentBlockSchema: z.ZodObject<{
     block_id: z.ZodEffects<z.ZodString, string, string>;
     layer: z.ZodLiteral<"semantic-prose">;
     markdown: z.ZodString;
-    evidence_refs: z.ZodArray<z.ZodString, "many">;
+    references: z.ZodArray<z.ZodObject<{
+        source_ref: z.ZodString;
+        locator: z.ZodEffects<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            start_line: z.ZodNumber;
+            end_line: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>;
+        content_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    evidence_refs: string[];
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
     block_id: string;
     layer: "semantic-prose";
     markdown: string;
 }, {
-    evidence_refs: string[];
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
     block_id: string;
     layer: "semantic-prose";
     markdown: string;
-}>]>;
+}>;
 declare const renderedContentBlockPayloadSchema: z.ZodObject<{
     layer: z.ZodEnum<["deterministic-block", "semantic-prose"]>;
     markdown: z.ZodString;
-    fact_refs: z.ZodArray<z.ZodString, "many">;
-    evidence_refs: z.ZodArray<z.ZodString, "many">;
+    references: z.ZodArray<z.ZodObject<{
+        source_ref: z.ZodString;
+        locator: z.ZodEffects<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            start_line: z.ZodNumber;
+            end_line: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>;
+        content_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    evidence_refs: string[];
-    layer: "deterministic-block" | "semantic-prose";
-    fact_refs: string[];
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
+    layer: "semantic-prose" | "deterministic-block";
     markdown: string;
 }, {
-    evidence_refs: string[];
-    layer: "deterministic-block" | "semantic-prose";
-    fact_refs: string[];
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
+    layer: "semantic-prose" | "deterministic-block";
     markdown: string;
 }>;
 export declare const indexerRenderedContentBlockSchema: z.ZodObject<{
     layer: z.ZodEnum<["deterministic-block", "semantic-prose"]>;
     markdown: z.ZodString;
-    fact_refs: z.ZodArray<z.ZodString, "many">;
-    evidence_refs: z.ZodArray<z.ZodString, "many">;
+    references: z.ZodArray<z.ZodObject<{
+        source_ref: z.ZodString;
+        locator: z.ZodEffects<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            start_line: z.ZodNumber;
+            end_line: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }, {
+            path: string;
+            start_line: number;
+            end_line: number;
+        }>;
+        content_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }, {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }>, "many">;
 } & {
     content_digest: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    evidence_refs: string[];
-    layer: "deterministic-block" | "semantic-prose";
-    fact_refs: string[];
-    markdown: string;
     content_digest: string;
-}, {
-    evidence_refs: string[];
-    layer: "deterministic-block" | "semantic-prose";
-    fact_refs: string[];
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
+    layer: "semantic-prose" | "deterministic-block";
     markdown: string;
+}, {
     content_digest: string;
+    references: {
+        source_ref: string;
+        locator: {
+            path: string;
+            start_line: number;
+            end_line: number;
+        };
+        content_digest: string;
+    }[];
+    layer: "semantic-prose" | "deterministic-block";
+    markdown: string;
 }>;
 export type IndexerArtifactFact = z.infer<typeof indexerArtifactFactSchema>;
 export type IndexerArtifactContentBlock = z.infer<typeof indexerArtifactContentBlockSchema>;
@@ -127,13 +275,11 @@ export declare function indexerRenderedContentBlockDigest(value: z.infer<typeof
 export declare function buildIndexerRenderedContentBlock(input: {
     layer: "deterministic-block" | "semantic-prose";
     markdown: string;
-    fact_refs?: readonly string[];
-    evidence_refs?: readonly string[];
+    references: readonly ArticleSourceReference[];
 }): IndexerRenderedContentBlock;
 export declare function validateIndexerRenderedContentBlock(value: unknown): IndexerRenderedContentBlock;
 export declare function materializeIndexerStructuredContent(input: {
     blocks: readonly IndexerArtifactContentBlock[];
-    facts: readonly IndexerArtifactFact[];
     render_cache?: Map<string, IndexerRenderedContentBlock[]> | undefined;
 }): IndexerRenderedContentBlock[];
 export {};

package/indexerContractOverlay.d.ts

@@ -188,27 +188,27 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }, {
             id: string;
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }>, "many">>;
         question_target_domains: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodEffects<z.ZodString, string, string>;
@@ -222,8 +222,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             }>;
-            grouping_operator: z.ZodEffects<z.ZodString, string, string>;
-            subject_key_kind: z.ZodEffects<z.ZodString, string, string>;
             granularity: z.ZodEnum<["module", "identity"]>;
         }, "strict", z.ZodTypeAny, {
             id: string;
@@ -231,8 +229,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }, {
             id: string;
@@ -240,8 +236,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }>, "many">>;
         reader_question_contracts: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -411,14 +405,14 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }[] | undefined;
         question_target_domains?: {
             id: string;
@@ -426,8 +420,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }[] | undefined;
         reader_question_contracts?: {
@@ -489,14 +481,14 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }[] | undefined;
         question_target_domains?: {
             id: string;
@@ -504,8 +496,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }[] | undefined;
         reader_question_contracts?: {
@@ -599,13 +589,13 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
     id: string;
     protocol: "context.indexer.contract-overlay/v1";
     version: string;
-    operator_contract_version: string;
-    operator_contract_digest: string;
     extends: {
         contract_digest: string;
         version: string;
         profile: string;
     };
+    operator_contract_version: string;
+    operator_contract_digest: string;
     additions: {
         metrics?: ({
             id: string;
@@ -644,14 +634,14 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }[] | undefined;
         question_target_domains?: {
             id: string;
@@ -659,8 +649,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }[] | undefined;
         reader_question_contracts?: {
@@ -706,13 +694,13 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
     id: string;
     protocol: "context.indexer.contract-overlay/v1";
     version: string;
-    operator_contract_version: string;
-    operator_contract_digest: string;
     extends: {
         contract_digest: string;
         version: string;
         profile: string;
     };
+    operator_contract_version: string;
+    operator_contract_digest: string;
     additions: {
         metrics?: ({
             id: string;
@@ -751,14 +739,14 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
             thresholds: Record<string, {
                 recommended_max: number;
             }>;
-            eligibility: {
-                protocol: "context.indexer.selector/v1";
-                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
-            };
             artifact_kinds: {
                 required: string[];
                 discretionary: string[];
             };
+            eligibility: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            };
         }[] | undefined;
         question_target_domains?: {
             id: string;
@@ -766,8 +754,6 @@ export declare const indexerContractOverlaySchema: z.ZodObject<{
                 operator: string;
                 parameters?: Record<string, import("./indexerRegistry.js").IndexerJson> | undefined;
             };
-            grouping_operator: string;
-            subject_key_kind: string;
             granularity: "module" | "identity";
         }[] | undefined;
         reader_question_contracts?: {
@@ -844,18 +830,18 @@ export declare const indexerOverlayValidationReceiptSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     protocol: "context.indexer.overlay-validation-receipt/v1";
     receipt_digest: string;
-    operator_contract_digest: string;
     project_ref: string;
     provider_integrity: string;
+    operator_contract_digest: string;
     overlay_digest: string;
     base_contract_digest: string;
     conformance_report_digest: string;
 }, {
     protocol: "context.indexer.overlay-validation-receipt/v1";
     receipt_digest: string;
-    operator_contract_digest: string;
     project_ref: string;
     provider_integrity: string;
+    operator_contract_digest: string;
     overlay_digest: string;
     base_contract_digest: string;
     conformance_report_digest: string;

package/indexerControlledInvocation.d.ts

@@ -140,13 +140,13 @@ export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject
         entry: z.ZodEffects<z.ZodString, string, string>;
         args: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     }, "strict", z.ZodTypeAny, {
-        args: string[];
         runtime: "node";
         entry: string;
-    }, {
         args: string[];
+    }, {
         runtime: "node";
         entry: string;
+        args: string[];
     }>;
     capabilities: z.ZodArray<z.ZodEnum<["source.read", "parser-facts.read", "indexer-result.write"]>, "many">;
     dependencies: z.ZodEffects<z.ZodObject<{
@@ -283,9 +283,9 @@ export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject
     };
     resource: "program" | "activation-detector" | "authoring-inspector";
     execution: {
-        args: string[];
         runtime: "node";
         entry: string;
+        args: string[];
     };
     program: {
         path: string;
@@ -338,9 +338,9 @@ export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject
     };
     resource: "program" | "activation-detector" | "authoring-inspector";
     execution: {
-        args: string[];
         runtime: "node";
         entry: string;
+        args: string[];
     };
     program: {
         path: string;
@@ -393,9 +393,9 @@ export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject
     };
     resource: "program" | "activation-detector" | "authoring-inspector";
     execution: {
-        args: string[];
         runtime: "node";
         entry: string;
+        args: string[];
     };
     program: {
         path: string;
@@ -448,9 +448,9 @@ export declare const indexerControlledInvocationSchema: z.ZodEffects<z.ZodObject
     };
     resource: "program" | "activation-detector" | "authoring-inspector";
     execution: {
-        args: string[];
         runtime: "node";
         entry: string;
+        args: string[];
     };
     program: {
         path: string;