@c4a/context 0.7.8 → 0.7.10-alpha.1

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/{readingStructure.d.ts → knowledgeMap.d.ts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 /** Reader organization is independent of collections, source ownership and outputs. */
-export declare const readingStructureEntrySchema: z.ZodObject<{
+export declare const knowledgeMapEntrySchema: z.ZodObject<{
     key: z.ZodString;
     parent: z.ZodNullable<z.ZodString>;
     title: z.ZodString;
@@ -28,13 +28,13 @@ export declare const readingStructureEntrySchema: 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 readingStructureUpdateSchema: z.ZodObject<{
+export declare const knowledgeMapUpdateSchema: z.ZodObject<{
     expected_revision: z.ZodNullable<z.ZodString>;
     upsert: z.ZodDefault<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
@@ -64,11 +64,11 @@ export declare const readingStructureUpdateSchema: 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,16 +90,16 @@ export declare const readingStructureUpdateSchema: 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;
 }>;
-export declare const readingStructureSchema: z.ZodObject<{
-    protocol: z.ZodLiteral<"context.reading-structure/v1">;
+export declare const knowledgeMapSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.knowledge-map/v1">;
     revision: z.ZodString;
     entries: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
@@ -129,11 +129,11 @@ export declare const readingStructureSchema: 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: {
@@ -146,43 +146,43 @@ export declare const readingStructureSchema: z.ZodObject<{
             section_key?: string | undefined;
         } | undefined;
     }[];
-    protocol: "context.reading-structure/v1";
+    protocol: "context.knowledge-map/v1";
     revision: string;
 }, {
     entries: {
         title: string;
         key: string;
         parent: string | null;
+        order?: number | undefined;
         target?: {
             artifact_ref: string;
             section_key?: string | undefined;
         } | undefined;
-        order?: number | undefined;
     }[];
-    protocol: "context.reading-structure/v1";
+    protocol: "context.knowledge-map/v1";
     revision: string;
 }>;
-export type ReadingStructure = z.infer<typeof readingStructureSchema>;
-export type ReadingStructureUpdate = z.infer<typeof readingStructureUpdateSchema>;
-export declare function validateReadingStructure(value: unknown): ReadingStructure;
-export declare function updateReadingStructure(current: ReadingStructure | undefined, value: unknown): ReadingStructure;
-export interface ProjectedReadingEntry {
+export type KnowledgeMap = z.infer<typeof knowledgeMapSchema>;
+export type KnowledgeMapUpdate = z.infer<typeof knowledgeMapUpdateSchema>;
+export declare function validateKnowledgeMap(value: unknown): KnowledgeMap;
+export declare function updateKnowledgeMap(current: KnowledgeMap | undefined, value: unknown): KnowledgeMap;
+export interface ProjectedKnowledgeMapEntry {
     key: string;
     title: string;
     href?: string;
-    children: ProjectedReadingEntry[];
+    children: ProjectedKnowledgeMapEntry[];
 }
 /** Target availability belongs to each channel. Omit pending/excluded entries and
  * empty groups without mutating shared organization or another channel's map. */
-export declare function projectReadingStructure(structure: ReadingStructure, targets: ReadonlyMap<string, string>): {
-    entries: ProjectedReadingEntry[];
+export declare function projectKnowledgeMap(structure: KnowledgeMap, targets: ReadonlyMap<string, string>): {
+    entries: ProjectedKnowledgeMapEntry[];
     warnings: {
         entry: string;
-        code: "reading-target-unavailable";
+        code: "knowledge-map-target-unavailable";
         target: string;
     }[];
 };
-export declare function readingTargetKey(target: {
+export declare function knowledgeMapTargetKey(target: {
     artifact_ref: string;
     section_key?: string | undefined;
 }): string;

package/package.json

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