@c4a/context 0.7.9 → 0.7.10-alpha.2

package/indexerTemplateRendering.d.ts

@@ -19,7 +19,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         type: z.ZodEnum<["string", "string-list", "string-map", "number", "boolean", "json"]>;
         content_layer: z.ZodEnum<["deterministic-fact", "semantic-prose"]>;
         required: z.ZodBoolean;
-        evidence_required: z.ZodBoolean;
         maximum_length: z.ZodOptional<z.ZodNumber>;
         maximum_items: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
@@ -27,7 +26,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }, {
@@ -35,7 +33,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }>, {
@@ -43,7 +40,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }, {
@@ -51,7 +47,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }>, "many">;
@@ -75,8 +70,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         reader_goal: z.ZodEffects<z.ZodString, string, string>;
         variable_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
         deterministic_block_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
-        accepted_evidence_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
-        minimum_evidence_items: z.ZodNumber;
         on_missing: z.ZodEnum<["request-input", "omit"]>;
         deletion_condition: z.ZodString;
     }, "strict", z.ZodTypeAny, {
@@ -86,8 +79,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         presence: "required" | "optional";
         variable_ids: string[];
         deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
         on_missing: "omit" | "request-input";
         deletion_condition: string;
     }, {
@@ -97,8 +88,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         presence: "required" | "optional";
         variable_ids: string[];
         deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
         on_missing: "omit" | "request-input";
         deletion_condition: string;
     }>, {
@@ -108,8 +97,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         presence: "required" | "optional";
         variable_ids: string[];
         deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
         on_missing: "omit" | "request-input";
         deletion_condition: string;
     }, {
@@ -119,8 +106,6 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         presence: "required" | "optional";
         variable_ids: string[];
         deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
         on_missing: "omit" | "request-input";
         deletion_condition: string;
     }>, "many">;
@@ -142,6 +127,16 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     forbidden_outputs: z.ZodArray<z.ZodString, "many">;
     maximum_rendered_bytes: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
+    sections: {
+        section_key: string;
+        reader_goal: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        on_missing: "omit" | "request-input";
+        deletion_condition: string;
+    }[];
     protocol: "context.indexer.template/v1";
     profile: string;
     reader_goal: string;
@@ -151,22 +146,9 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }[];
-    sections: {
-        section_key: string;
-        reader_goal: string;
-        question_ref: string;
-        presence: "required" | "optional";
-        variable_ids: string[];
-        deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
-        on_missing: "omit" | "request-input";
-        deletion_condition: string;
-    }[];
     applicability: {
         artifact_policy_variants: string[];
         condition_refs: string[];
@@ -186,6 +168,16 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     forbidden_outputs: string[];
     maximum_rendered_bytes: number;
 }, {
+    sections: {
+        section_key: string;
+        reader_goal: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        on_missing: "omit" | "request-input";
+        deletion_condition: string;
+    }[];
     protocol: "context.indexer.template/v1";
     profile: string;
     reader_goal: string;
@@ -195,22 +187,9 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }[];
-    sections: {
-        section_key: string;
-        reader_goal: string;
-        question_ref: string;
-        presence: "required" | "optional";
-        variable_ids: string[];
-        deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
-        on_missing: "omit" | "request-input";
-        deletion_condition: string;
-    }[];
     applicability: {
         artifact_policy_variants: string[];
         condition_refs: string[];
@@ -230,6 +209,16 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     forbidden_outputs: string[];
     maximum_rendered_bytes: number;
 }>, {
+    sections: {
+        section_key: string;
+        reader_goal: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        on_missing: "omit" | "request-input";
+        deletion_condition: string;
+    }[];
     protocol: "context.indexer.template/v1";
     profile: string;
     reader_goal: string;
@@ -239,22 +228,9 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }[];
-    sections: {
-        section_key: string;
-        reader_goal: string;
-        question_ref: string;
-        presence: "required" | "optional";
-        variable_ids: string[];
-        deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
-        on_missing: "omit" | "request-input";
-        deletion_condition: string;
-    }[];
     applicability: {
         artifact_policy_variants: string[];
         condition_refs: string[];
@@ -274,6 +250,16 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
     forbidden_outputs: string[];
     maximum_rendered_bytes: number;
 }, {
+    sections: {
+        section_key: string;
+        reader_goal: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        on_missing: "omit" | "request-input";
+        deletion_condition: string;
+    }[];
     protocol: "context.indexer.template/v1";
     profile: string;
     reader_goal: string;
@@ -283,22 +269,9 @@ export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
         id: string;
         required: boolean;
         content_layer: "semantic-prose" | "deterministic-fact";
-        evidence_required: boolean;
         maximum_length?: number | undefined;
         maximum_items?: number | undefined;
     }[];
-    sections: {
-        section_key: string;
-        reader_goal: string;
-        question_ref: string;
-        presence: "required" | "optional";
-        variable_ids: string[];
-        deterministic_block_ids: string[];
-        accepted_evidence_kinds: ("code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
-        minimum_evidence_items: number;
-        on_missing: "omit" | "request-input";
-        deletion_condition: string;
-    }[];
     applicability: {
         artifact_policy_variants: string[];
         condition_refs: string[];
@@ -338,56 +311,179 @@ export declare const indexerRenderedArtifactSchema: z.ZodObject<{
         content_blocks: z.ZodArray<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;
+            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[];
+            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;
+        }>, "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">;
-        evidence_refs: z.ZodArray<z.ZodString, "many">;
         content_digest: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        evidence_refs: string[];
-        markdown: string;
         content_digest: string;
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
+        markdown: string;
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
         content_blocks: {
-            evidence_refs: string[];
-            layer: "deterministic-block" | "semantic-prose";
-            fact_refs: string[];
-            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;
         }[];
     }, {
-        evidence_refs: string[];
-        markdown: string;
         content_digest: string;
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
+        markdown: string;
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
         content_blocks: {
-            evidence_refs: string[];
-            layer: "deterministic-block" | "semantic-prose";
-            fact_refs: string[];
-            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;
         }[];
     }>, "many">;
     material_question_gaps: z.ZodArray<z.ZodObject<{
@@ -409,29 +505,44 @@ export declare const indexerRenderedArtifactSchema: z.ZodObject<{
     review_ready: z.ZodBoolean;
     rendered_digest: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    protocol: "context.indexer.rendered-artifact/v1";
-    profile: string;
-    artifact_kind: string;
-    template_id: string;
-    artifact_id: string;
-    artifact_policy_variant: string;
     sections: {
-        evidence_refs: string[];
-        markdown: string;
         content_digest: string;
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
+        markdown: string;
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
         content_blocks: {
-            evidence_refs: string[];
-            layer: "deterministic-block" | "semantic-prose";
-            fact_refs: string[];
-            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;
         }[];
     }[];
+    protocol: "context.indexer.rendered-artifact/v1";
+    profile: string;
+    artifact_kind: string;
+    template_id: string;
+    artifact_id: string;
+    artifact_policy_variant: string;
     artifact_result_digest: string;
     template_digest: string;
     template_origin: "provider" | "customization-override";
@@ -444,29 +555,44 @@ export declare const indexerRenderedArtifactSchema: z.ZodObject<{
     review_ready: boolean;
     rendered_digest: string;
 }, {
-    protocol: "context.indexer.rendered-artifact/v1";
-    profile: string;
-    artifact_kind: string;
-    template_id: string;
-    artifact_id: string;
-    artifact_policy_variant: string;
     sections: {
-        evidence_refs: string[];
-        markdown: string;
         content_digest: string;
+        references: {
+            source_ref: string;
+            locator: {
+                path: string;
+                start_line: number;
+                end_line: number;
+            };
+            content_digest: string;
+        }[];
+        markdown: string;
         section_key: string;
         owner_indexer_id: string;
         document_kind: string;
         reader_goal: string;
         artifact_kind: string;
         content_blocks: {
-            evidence_refs: string[];
-            layer: "deterministic-block" | "semantic-prose";
-            fact_refs: string[];
-            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;
         }[];
     }[];
+    protocol: "context.indexer.rendered-artifact/v1";
+    profile: string;
+    artifact_kind: string;
+    template_id: string;
+    artifact_id: string;
+    artifact_policy_variant: string;
     artifact_result_digest: string;
     template_digest: string;
     template_origin: "provider" | "customization-override";

package/knowledgeMap.d.ts

@@ -28,11 +28,11 @@ export declare const knowledgeMapEntrySchema: z.ZodObject<{
     title: string;
     key: string;
     parent: string | null;
+    order?: number | undefined;
     target?: {
         artifact_ref: string;
         section_key?: string | undefined;
     } | undefined;
-    order?: number | undefined;
 }>;
 export declare const knowledgeMapUpdateSchema: z.ZodObject<{
     expected_revision: z.ZodNullable<z.ZodString>;
@@ -64,11 +64,11 @@ export declare const knowledgeMapUpdateSchema: z.ZodObject<{
         title: string;
         key: string;
         parent: string | null;
+        order?: number | undefined;
         target?: {
             artifact_ref: string;
             section_key?: string | undefined;
         } | undefined;
-        order?: number | undefined;
     }>, "many">>;
     remove: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
@@ -90,11 +90,11 @@ export declare const knowledgeMapUpdateSchema: z.ZodObject<{
         title: string;
         key: string;
         parent: string | null;
+        order?: number | undefined;
         target?: {
             artifact_ref: string;
             section_key?: string | undefined;
         } | undefined;
-        order?: number | undefined;
     }[] | undefined;
     remove?: string[] | undefined;
 }>;
@@ -129,11 +129,11 @@ export declare const knowledgeMapSchema: z.ZodObject<{
         title: string;
         key: string;
         parent: string | null;
+        order?: number | undefined;
         target?: {
             artifact_ref: string;
             section_key?: string | undefined;
         } | undefined;
-        order?: number | undefined;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
     entries: {
@@ -153,11 +153,11 @@ export declare const knowledgeMapSchema: z.ZodObject<{
         title: string;
         key: string;
         parent: string | null;
+        order?: number | undefined;
         target?: {
             artifact_ref: string;
             section_key?: string | undefined;
         } | undefined;
-        order?: number | undefined;
     }[];
     protocol: "context.knowledge-map/v1";
     revision: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.7.9",
+  "version": "0.7.10-alpha.2",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",