@c4a/context 0.6.19 → 0.7.0

package/indexerMaterialQuestionExclusion.d.ts

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { type IndexerMaterialGapLedger } from "./indexerMaterialGapLedger.js";
+export declare const indexerMaterialQuestionExclusionReportSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-question-exclusion-report/v1">;
+    project_ref: z.ZodString;
+    ledger_revision: z.ZodString;
+    question_target_inventory_digest: z.ZodString;
+    question_key: z.ZodString;
+    question_ref: z.ZodString;
+    question_contract_digest: z.ZodString;
+    question_subject_target_ref: z.ZodString;
+    question_target_item_digest: z.ZodString;
+    question_revision_digest: z.ZodString;
+    reason_code: z.ZodEffects<z.ZodString, string, string>;
+    severity: z.ZodEnum<["blocking", "recommended"]>;
+    reader_impact: z.ZodEffects<z.ZodString, string, string>;
+    report_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-question-exclusion-report/v1";
+    severity: "recommended" | "blocking";
+    project_ref: string;
+    report_digest: string;
+    question_target_inventory_digest: string;
+    reason_code: string;
+    question_ref: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    ledger_revision: string;
+    reader_impact: string;
+}, {
+    protocol: "context.indexer.material-question-exclusion-report/v1";
+    severity: "recommended" | "blocking";
+    project_ref: string;
+    report_digest: string;
+    question_target_inventory_digest: string;
+    reason_code: string;
+    question_ref: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    ledger_revision: string;
+    reader_impact: string;
+}>;
+export declare const indexerMaterialQuestionExclusionConfirmationSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-question-exclusion-confirmation/v1">;
+    project_ref: z.ZodString;
+    question_key: z.ZodString;
+    question_contract_digest: z.ZodString;
+    question_subject_target_ref: z.ZodString;
+    question_target_item_digest: z.ZodString;
+    reason_code: z.ZodEffects<z.ZodString, string, string>;
+    report_digest: z.ZodString;
+    authority: z.ZodLiteral<"human">;
+    non_delegable: z.ZodLiteral<true>;
+    confirmed_by: z.ZodString;
+    confirmed_at: z.ZodString;
+    decision_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-question-exclusion-confirmation/v1";
+    authority: "human";
+    project_ref: string;
+    report_digest: string;
+    reason_code: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    question_key: string;
+    decision_digest: string;
+    confirmed_by: string;
+    confirmed_at: string;
+    non_delegable: true;
+}, {
+    protocol: "context.indexer.material-question-exclusion-confirmation/v1";
+    authority: "human";
+    project_ref: string;
+    report_digest: string;
+    reason_code: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    question_key: string;
+    decision_digest: string;
+    confirmed_by: string;
+    confirmed_at: string;
+    non_delegable: true;
+}>;
+export type IndexerMaterialQuestionExclusionReport = z.infer<typeof indexerMaterialQuestionExclusionReportSchema>;
+export type IndexerMaterialQuestionExclusionConfirmation = z.infer<typeof indexerMaterialQuestionExclusionConfirmationSchema>;
+export declare function indexerMaterialQuestionExclusionReportDigest(value: Omit<IndexerMaterialQuestionExclusionReport, "report_digest">): string;
+export declare function indexerMaterialQuestionExclusionDecisionDigest(value: Omit<IndexerMaterialQuestionExclusionConfirmation, "decision_digest">): string;
+export declare function proposeIndexerMaterialQuestionExclusion(input: {
+    ledger: unknown;
+    expected_revision: string;
+    project_ref: string;
+    question_key: string;
+    resolved_question: unknown;
+    reason_code: string;
+    domain_state: "required" | "optional" | "out-of-scope";
+    reader_impact: string;
+}): IndexerMaterialQuestionExclusionReport;
+export declare function validateIndexerMaterialQuestionExclusionReport(input: {
+    ledger: unknown;
+    report: unknown;
+    resolved_question: unknown;
+    domain_state: "required" | "optional" | "out-of-scope";
+}): IndexerMaterialQuestionExclusionReport;
+export declare function confirmIndexerMaterialQuestionExclusion(input: {
+    report: unknown;
+    authority: "human" | "managed";
+    confirmed_by: string;
+    confirmed_at: string;
+}): IndexerMaterialQuestionExclusionConfirmation;
+export declare function validateIndexerMaterialQuestionExclusionConfirmation(input: {
+    report: unknown;
+    confirmation: unknown;
+}): IndexerMaterialQuestionExclusionConfirmation;
+export declare function applyIndexerMaterialQuestionExclusion(input: {
+    ledger: unknown;
+    expected_revision: string;
+    report: unknown;
+    confirmation: unknown;
+    resolved_question: unknown;
+    domain_state: "required" | "optional" | "out-of-scope";
+}): IndexerMaterialGapLedger;

package/indexerMaterialQuestionWorkset.d.ts

@@ -0,0 +1,508 @@
+import { z } from "zod";
+import { INDEXER_EVIDENCE_KINDS } from "./indexerProtocolCommon.js";
+import { type IndexerQuestionTargetInventory, type IndexerResolvedMaterialQuestion } from "./indexerQuestionAuthority.js";
+declare const materialQuestionSchema: z.ZodObject<{
+    owner_cell_ref: z.ZodString;
+    question_ref: z.ZodString;
+    question_contract_digest: z.ZodString;
+    question_subject_target_ref: z.ZodString;
+    question_target_item_digest: z.ZodString;
+    answer_landing_ref: z.ZodOptional<z.ZodString>;
+    evidence_contract: z.ZodEffects<z.ZodObject<{
+        accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
+        minimum_items: z.ZodNumber;
+        minimum_distinct_sources: z.ZodNumber;
+        provenance_constraints: z.ZodOptional<z.ZodObject<{
+            protocol: z.ZodLiteral<"context.indexer.selector/v1">;
+            expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
+        }, "strict", z.ZodTypeAny, {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        }, {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    }, {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    }>, {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    }, {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    }>;
+    source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    evidence_contract: {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    };
+    question_ref: string;
+    owner_cell_ref: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    source_refs?: string[] | undefined;
+    answer_landing_ref?: string | undefined;
+}, {
+    evidence_contract: {
+        accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_items: number;
+        minimum_distinct_sources: number;
+        provenance_constraints?: {
+            protocol: "context.indexer.selector/v1";
+            expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+        } | undefined;
+    };
+    question_ref: string;
+    owner_cell_ref: string;
+    question_contract_digest: string;
+    question_subject_target_ref: string;
+    question_target_item_digest: string;
+    source_refs?: string[] | undefined;
+    answer_landing_ref?: string | undefined;
+}>;
+declare const worksetItemSchema: z.ZodObject<{
+    question_key: z.ZodString;
+    question_contract_digest: z.ZodString;
+    question_revision_digest: z.ZodString;
+    question: z.ZodObject<{
+        owner_cell_ref: z.ZodString;
+        question_ref: z.ZodString;
+        question_contract_digest: z.ZodString;
+        question_subject_target_ref: z.ZodString;
+        question_target_item_digest: z.ZodString;
+        answer_landing_ref: z.ZodOptional<z.ZodString>;
+        evidence_contract: z.ZodEffects<z.ZodObject<{
+            accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
+            minimum_items: z.ZodNumber;
+            minimum_distinct_sources: z.ZodNumber;
+            provenance_constraints: z.ZodOptional<z.ZodObject<{
+                protocol: z.ZodLiteral<"context.indexer.selector/v1">;
+                expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
+            }, "strict", z.ZodTypeAny, {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            }, {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        }, {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        }>, {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        }, {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        }>;
+        source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        evidence_contract: {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        };
+        question_ref: string;
+        owner_cell_ref: string;
+        question_contract_digest: string;
+        question_subject_target_ref: string;
+        question_target_item_digest: string;
+        source_refs?: string[] | undefined;
+        answer_landing_ref?: string | undefined;
+    }, {
+        evidence_contract: {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        };
+        question_ref: string;
+        owner_cell_ref: string;
+        question_contract_digest: string;
+        question_subject_target_ref: string;
+        question_target_item_digest: string;
+        source_refs?: string[] | undefined;
+        answer_landing_ref?: string | undefined;
+    }>;
+    eligible_answer_indexer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    authorized_source_refs: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    question: {
+        evidence_contract: {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        };
+        question_ref: string;
+        owner_cell_ref: string;
+        question_contract_digest: string;
+        question_subject_target_ref: string;
+        question_target_item_digest: string;
+        source_refs?: string[] | undefined;
+        answer_landing_ref?: string | undefined;
+    };
+    eligible_answer_indexer_ids: string[];
+    authorized_source_refs: string[];
+}, {
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    question: {
+        evidence_contract: {
+            accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+            minimum_items: number;
+            minimum_distinct_sources: number;
+            provenance_constraints?: {
+                protocol: "context.indexer.selector/v1";
+                expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+            } | undefined;
+        };
+        question_ref: string;
+        owner_cell_ref: string;
+        question_contract_digest: string;
+        question_subject_target_ref: string;
+        question_target_item_digest: string;
+        source_refs?: string[] | undefined;
+        answer_landing_ref?: string | undefined;
+    };
+    eligible_answer_indexer_ids: string[];
+    authorized_source_refs: string[];
+}>;
+export declare const indexerMaterialQuestionWorksetSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-question-workset/v1">;
+    workset_digest: z.ZodString;
+    question_set_digest: z.ZodString;
+    question_target_inventory_digest: z.ZodString;
+    question_target_set_digest: z.ZodString;
+    predecessor_ledger_revision: z.ZodString;
+    registry_digest: z.ZodString;
+    requirement_set_digest: z.ZodString;
+    source_input_digests: z.ZodArray<z.ZodString, "many">;
+    items: z.ZodArray<z.ZodObject<{
+        question_key: z.ZodString;
+        question_contract_digest: z.ZodString;
+        question_revision_digest: z.ZodString;
+        question: z.ZodObject<{
+            owner_cell_ref: z.ZodString;
+            question_ref: z.ZodString;
+            question_contract_digest: z.ZodString;
+            question_subject_target_ref: z.ZodString;
+            question_target_item_digest: z.ZodString;
+            answer_landing_ref: z.ZodOptional<z.ZodString>;
+            evidence_contract: z.ZodEffects<z.ZodObject<{
+                accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
+                minimum_items: z.ZodNumber;
+                minimum_distinct_sources: z.ZodNumber;
+                provenance_constraints: z.ZodOptional<z.ZodObject<{
+                    protocol: z.ZodLiteral<"context.indexer.selector/v1">;
+                    expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
+                }, "strict", z.ZodTypeAny, {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                }, {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                }>>;
+            }, "strict", z.ZodTypeAny, {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            }, {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            }>, {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            }, {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            }>;
+            source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        }, {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        }>;
+        eligible_answer_indexer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        authorized_source_refs: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        question_contract_digest: string;
+        question_key: string;
+        question_revision_digest: string;
+        question: {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        };
+        eligible_answer_indexer_ids: string[];
+        authorized_source_refs: string[];
+    }, {
+        question_contract_digest: string;
+        question_key: string;
+        question_revision_digest: string;
+        question: {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        };
+        eligible_answer_indexer_ids: string[];
+        authorized_source_refs: string[];
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-question-workset/v1";
+    workset_digest: string;
+    requirement_set_digest: string;
+    question_target_inventory_digest: string;
+    items: {
+        question_contract_digest: string;
+        question_key: string;
+        question_revision_digest: string;
+        question: {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        };
+        eligible_answer_indexer_ids: string[];
+        authorized_source_refs: string[];
+    }[];
+    question_set_digest: string;
+    question_target_set_digest: string;
+    predecessor_ledger_revision: string;
+    registry_digest: string;
+    source_input_digests: string[];
+}, {
+    protocol: "context.indexer.material-question-workset/v1";
+    workset_digest: string;
+    requirement_set_digest: string;
+    question_target_inventory_digest: string;
+    items: {
+        question_contract_digest: string;
+        question_key: string;
+        question_revision_digest: string;
+        question: {
+            evidence_contract: {
+                accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+                minimum_items: number;
+                minimum_distinct_sources: number;
+                provenance_constraints?: {
+                    protocol: "context.indexer.selector/v1";
+                    expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
+                } | undefined;
+            };
+            question_ref: string;
+            owner_cell_ref: string;
+            question_contract_digest: string;
+            question_subject_target_ref: string;
+            question_target_item_digest: string;
+            source_refs?: string[] | undefined;
+            answer_landing_ref?: string | undefined;
+        };
+        eligible_answer_indexer_ids: string[];
+        authorized_source_refs: string[];
+    }[];
+    question_set_digest: string;
+    question_target_set_digest: string;
+    predecessor_ledger_revision: string;
+    registry_digest: string;
+    source_input_digests: string[];
+}>;
+export type IndexerMaterialQuestion = z.infer<typeof materialQuestionSchema>;
+export type IndexerMaterialQuestionWorksetItem = z.infer<typeof worksetItemSchema>;
+export type IndexerMaterialQuestionWorkset = z.infer<typeof indexerMaterialQuestionWorksetSchema>;
+export declare function indexerMaterialQuestionWorksetDigest(value: Omit<IndexerMaterialQuestionWorkset, "workset_digest">): string;
+interface OwnerCellAuthority {
+    owner_cell_ref: string;
+    owner_cell_digest: string;
+    requirement_ref: string;
+    coverage_domain: string;
+    domain_state: "required" | "optional" | "out-of-scope";
+}
+interface AnswerIndexerCandidate {
+    indexer_id: string;
+    operations: readonly string[];
+    requirement_binding_role: "primary" | "enricher";
+    provider_operation_supported: boolean;
+    supported_evidence_kinds: readonly typeof INDEXER_EVIDENCE_KINDS[number][];
+}
+interface QuestionRoute {
+    requirement_ref: string;
+    question_ref: string;
+    target_ref: string;
+    answer_landing_ref?: string;
+    answer_landing_dependency_digest?: string;
+    authorized_source_refs: readonly string[];
+    candidates: readonly AnswerIndexerCandidate[];
+}
+export declare function buildIndexerMaterialQuestionWorkset(input: {
+    question_target_inventory: IndexerQuestionTargetInventory;
+    resolved_questions: readonly {
+        requirement_ref: string;
+        question: IndexerResolvedMaterialQuestion;
+    }[];
+    owner_cells: readonly OwnerCellAuthority[];
+    target_facts: Readonly<Record<string, Record<string, unknown>>>;
+    allowed_selector_fact_paths: ReadonlySet<string>;
+    routes: readonly QuestionRoute[];
+    predecessor_ledger_revision: string;
+    registry_digest: string;
+    requirement_set_digest: string;
+    source_input_digests: readonly string[];
+}): IndexerMaterialQuestionWorkset;
+export declare function validateIndexerMaterialQuestionWorkset(value: unknown): IndexerMaterialQuestionWorkset;
+export {};

package/indexerNavigationArtifactGraph.d.ts

@@ -0,0 +1,5 @@
+import { type IndexerNavigationArtifactPlan } from "./indexerNavigationArtifactPlan.js";
+export declare function validateIndexerNavigationArtifactGraph(input: {
+    plans: readonly unknown[];
+    logical_artifact_refs: readonly string[];
+}): IndexerNavigationArtifactPlan[];