@c4a/context 0.7.5 → 0.7.9

package/indexerArticlePlan.d.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import type { IndexerArtifactResult } from "./indexerArtifactResult.js";
+/** Reader titles can change; these keys remain stable across revisions. */
+export declare const indexerArticleKeySchema: z.ZodString;
+export declare const indexerArticlePlanSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    reader_task: z.ZodString;
+    artifact_intent: z.ZodString;
+    template_id: z.ZodOptional<z.ZodString>;
+    required: z.ZodBoolean;
+    sections: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        heading: z.ZodString;
+        required: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        key: string;
+        required: boolean;
+        heading: string;
+    }, {
+        key: string;
+        required: boolean;
+        heading: string;
+    }>, "many">;
+    question_targets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    knowledge_dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        artifact_ref: z.ZodString;
+        section_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        required: boolean;
+        artifact_ref: string;
+        section_refs: string[];
+    }, {
+        artifact_ref: string;
+        required?: boolean | undefined;
+        section_refs?: string[] | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    key: string;
+    required: boolean;
+    sections: {
+        key: string;
+        required: boolean;
+        heading: string;
+    }[];
+    reader_task: string;
+    artifact_intent: string;
+    question_targets: string[];
+    template_id?: string | undefined;
+    knowledge_dependencies?: {
+        required: boolean;
+        artifact_ref: string;
+        section_refs: string[];
+    }[] | undefined;
+}, {
+    title: string;
+    key: string;
+    required: boolean;
+    sections: {
+        key: string;
+        required: boolean;
+        heading: string;
+    }[];
+    reader_task: string;
+    artifact_intent: string;
+    template_id?: string | undefined;
+    question_targets?: string[] | undefined;
+    knowledge_dependencies?: {
+        artifact_ref: string;
+        required?: boolean | undefined;
+        section_refs?: string[] | undefined;
+    }[] | undefined;
+}>;
+export type IndexerArticlePlan = z.infer<typeof indexerArticlePlanSchema>;
+export declare function validateIndexerArticlePlan(articles: readonly IndexerArticlePlan[], targets?: readonly string[]): void;
+export declare function indexerArticleSectionKey(article: string, section: string): string;
+/** Applies to both semantic submissions and programmatic Providers. */
+export declare function validateIndexerPlannedArticles(result: IndexerArtifactResult, articles: readonly IndexerArticlePlan[]): Array<{
+    code: string;
+    message: string;
+}>;

package/indexerArtifact.d.ts

@@ -94,6 +94,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
     artifact_policy_variant: string;
 }>, z.ZodObject<{
     representation: z.ZodLiteral<"sections">;
+    template_id: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     sections: z.ZodArray<z.ZodObject<{
         section_key: z.ZodEffects<z.ZodString, string, string>;
         owner_indexer_id: z.ZodEffects<z.ZodString, string, string>;
@@ -104,17 +105,17 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         blocks: z.ZodArray<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", "json-code-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" | "json-code-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" | "json-code-block";
+            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
             fact_refs: string[];
         }>, z.ZodObject<{
             block_id: z.ZodEffects<z.ZodString, string, string>;
@@ -141,7 +142,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         blocks: ({
             block_id: string;
             layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "json-code-block";
+            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
             fact_refs: string[];
         } | {
             evidence_refs: string[];
@@ -158,7 +159,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         blocks: ({
             block_id: string;
             layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "json-code-block";
+            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
             fact_refs: string[];
         } | {
             evidence_refs: string[];
@@ -184,7 +185,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         blocks: ({
             block_id: string;
             layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "json-code-block";
+            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
             fact_refs: string[];
         } | {
             evidence_refs: string[];
@@ -193,6 +194,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
             markdown: string;
         })[];
     }[];
+    template_id?: string | undefined;
 }, {
     artifact_kind: string;
     representation: "sections";
@@ -207,7 +209,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
         blocks: ({
             block_id: string;
             layer: "deterministic-block";
-            renderer: "bullet-list" | "key-value-table" | "json-code-block";
+            renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
             fact_refs: string[];
         } | {
             evidence_refs: string[];
@@ -216,6 +218,7 @@ export declare const indexerArtifactSchema: z.ZodDiscriminatedUnion<"representat
             markdown: string;
         })[];
     }[];
+    template_id?: string | undefined;
 }>]>;
 export type IndexerArtifact = z.infer<typeof indexerArtifactSchema>;
 export type IndexerArtifactSectionProjection = z.infer<typeof indexerArtifactSectionProjectionSchema>;

package/indexerArtifactDependencies.d.ts

@@ -256,7 +256,7 @@ export declare const indexerArtifactDependencySetSchema: z.ZodObject<{
         group_projection_digest: string;
         dependency_ref: string;
     }>, z.ZodObject<{
-        kind: z.ZodEnum<["template-policy-fragment", "contract-metric"]>;
+        kind: z.ZodEnum<["template-policy-fragment", "contract-metric", "approved-knowledge"]>;
         target_ref: z.ZodString;
         content_digest: z.ZodString;
         targets: z.ZodArray<z.ZodDiscriminatedUnion<"level", [z.ZodObject<{
@@ -292,7 +292,7 @@ export declare const indexerArtifactDependencySetSchema: z.ZodObject<{
     } & {
         dependency_ref: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "template-policy-fragment" | "contract-metric";
+        kind: "template-policy-fragment" | "contract-metric" | "approved-knowledge";
         targets: ({
             level: "logical-unit";
         } | {
@@ -308,7 +308,7 @@ export declare const indexerArtifactDependencySetSchema: z.ZodObject<{
         node_ref: string;
         dependency_ref: string;
     }, {
-        kind: "template-policy-fragment" | "contract-metric";
+        kind: "template-policy-fragment" | "contract-metric" | "approved-knowledge";
         targets: ({
             level: "logical-unit";
         } | {
@@ -521,7 +521,7 @@ export declare const indexerArtifactDependencySetSchema: z.ZodObject<{
         group_projection_digest: string;
         dependency_ref: string;
     } | {
-        kind: "template-policy-fragment" | "contract-metric";
+        kind: "template-policy-fragment" | "contract-metric" | "approved-knowledge";
         targets: ({
             level: "logical-unit";
         } | {
@@ -634,7 +634,7 @@ export declare const indexerArtifactDependencySetSchema: z.ZodObject<{
         group_projection_digest: string;
         dependency_ref: string;
     } | {
-        kind: "template-policy-fragment" | "contract-metric";
+        kind: "template-policy-fragment" | "contract-metric" | "approved-knowledge";
         targets: ({
             level: "logical-unit";
         } | {

package/indexerArtifactPolicy.d.ts

@@ -133,16 +133,16 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
     reader_question_refs: z.ZodArray<z.ZodString, "many">;
     evidence_refs: z.ZodArray<z.ZodString, "many">;
 }, "strict", z.ZodTypeAny, {
+    purpose: "required" | "discretionary";
     evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
-    purpose: "required" | "discretionary";
     reader_question_refs: string[];
 }, {
+    purpose: "required" | "discretionary";
     evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
-    purpose: "required" | "discretionary";
     reader_question_refs: string[];
 }>, z.ZodObject<{
     artifact_id: z.ZodEffects<z.ZodString, string, string>;
@@ -165,10 +165,10 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
         end_key: string;
     }>;
 }, "strict", z.ZodTypeAny, {
+    purpose: "semantic-split";
     evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
-    purpose: "semantic-split";
     reader_question_refs: string[];
     split_of: string;
     boundary: {
@@ -177,10 +177,10 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
         end_key: string;
     };
 }, {
+    purpose: "semantic-split";
     evidence_refs: string[];
     artifact_kind: string;
     artifact_id: string;
-    purpose: "semantic-split";
     reader_question_refs: string[];
     split_of: string;
     boundary: {
@@ -200,16 +200,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
         reader_question_refs: z.ZodArray<z.ZodString, "many">;
         evidence_refs: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
+        purpose: "required" | "discretionary";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "required" | "discretionary";
         reader_question_refs: string[];
     }, {
+        purpose: "required" | "discretionary";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "required" | "discretionary";
         reader_question_refs: string[];
     }>, z.ZodObject<{
         artifact_id: z.ZodEffects<z.ZodString, string, string>;
@@ -232,10 +232,10 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
             end_key: string;
         }>;
     }, "strict", z.ZodTypeAny, {
+        purpose: "semantic-split";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "semantic-split";
         reader_question_refs: string[];
         split_of: string;
         boundary: {
@@ -244,10 +244,10 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
             end_key: string;
         };
     }, {
+        purpose: "semantic-split";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "semantic-split";
         reader_question_refs: string[];
         split_of: string;
         boundary: {
@@ -264,16 +264,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
     protocol: "context.indexer.artifact-bundle/v1";
     artifact_policy_variant: string;
     artifacts: ({
+        purpose: "required" | "discretionary";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "required" | "discretionary";
         reader_question_refs: string[];
     } | {
+        purpose: "semantic-split";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "semantic-split";
         reader_question_refs: string[];
         split_of: string;
         boundary: {
@@ -290,16 +290,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
     protocol: "context.indexer.artifact-bundle/v1";
     artifact_policy_variant: string;
     artifacts: ({
+        purpose: "required" | "discretionary";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "required" | "discretionary";
         reader_question_refs: string[];
     } | {
+        purpose: "semantic-split";
         evidence_refs: string[];
         artifact_kind: string;
         artifact_id: string;
-        purpose: "semantic-split";
         reader_question_refs: string[];
         split_of: string;
         boundary: {