@c4a/context 0.7.1 → 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +65 -170
  2. package/README.zh-CN.md +52 -129
  3. package/docs/README.md +9 -10
  4. package/docs/README.zh-CN.md +6 -7
  5. package/docs/getting-started.md +73 -428
  6. package/docs/guides/agent-guide.md +94 -518
  7. package/docs/guides/code-indexer-skill-authoring.md +24 -13
  8. package/docs/guides/markdown-indexer-skill-authoring.md +14 -14
  9. package/docs/reference/code-extractors.md +29 -121
  10. package/docs/reference/indexer-provider-protocol.md +43 -110
  11. package/docs/reference/package-templates.md +2 -3
  12. package/docs/reference/project-api.md +52 -986
  13. package/index.d.ts +10 -8
  14. package/index.js +4739 -7103
  15. package/indexerAgentStepProtocol.d.ts +1366 -7649
  16. package/indexerArtifact.d.ts +225 -0
  17. package/indexerArtifactDependencies.d.ts +41 -39
  18. package/indexerArtifactResult.d.ts +219 -252
  19. package/indexerAuthorizedWorksetView.d.ts +368 -0
  20. package/indexerBaseQuestionAmendment.d.ts +484 -280
  21. package/indexerBenchmark.d.ts +16 -16
  22. package/indexerCandidateCompile.d.ts +66 -60
  23. package/indexerCapabilityGroupEvidence.d.ts +6 -6
  24. package/indexerCatalogFallback.d.ts +122 -128
  25. package/indexerCollectionMapping.d.ts +13 -13
  26. package/indexerContentLayers.d.ts +8 -8
  27. package/indexerContractOverlay.d.ts +10 -10
  28. package/indexerControlledInvocation.d.ts +12 -12
  29. package/indexerControlledProgram.d.ts +2467 -2797
  30. package/indexerCoreExports.d.ts +6 -6
  31. package/indexerCustomizationDraft.d.ts +3315 -2091
  32. package/indexerCustomizationLadder.d.ts +2 -2
  33. package/indexerDependencyView.d.ts +108 -108
  34. package/indexerEffectiveArtifact.d.ts +1134 -0
  35. package/indexerEvidenceAdapterAuthorityMerge.d.ts +48 -0
  36. package/indexerEvidenceAdapterResult.d.ts +52 -52
  37. package/indexerExampleDecision.d.ts +128 -128
  38. package/indexerExampleIdentity.d.ts +6 -6
  39. package/indexerGeneratedAuthoringAudit.d.ts +18 -18
  40. package/indexerIncrementalImpact.d.ts +16 -16
  41. package/indexerInspectorWorksetProjection.d.ts +6 -0
  42. package/indexerInventoryDisposition.d.ts +70 -70
  43. package/indexerLayerComposition.d.ts +2139 -373
  44. package/indexerLayoutChange.d.ts +10 -10
  45. package/indexerLayoutProposalSet.d.ts +71 -66
  46. package/indexerLayoutResolver.d.ts +53 -48
  47. package/indexerLayoutTransition.d.ts +0 -50
  48. package/indexerLifecycle.d.ts +0 -13
  49. package/indexerMainLifecycle.d.ts +10 -0
  50. package/indexerMainRunLedger.d.ts +138 -11
  51. package/indexerMainRunProtocol.d.ts +1406 -785
  52. package/indexerMainWorkset.d.ts +460 -206
  53. package/indexerMaterialGapLedger.d.ts +13 -2904
  54. package/indexerOverlayQuestionAmendment.d.ts +491 -287
  55. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  56. package/indexerParserCapabilityCatalog.d.ts +136 -0
  57. package/indexerParserCoordinate.d.ts +16 -16
  58. package/indexerParserDependencyIntent.d.ts +22 -0
  59. package/indexerParserExecutionPlan.d.ts +388 -0
  60. package/indexerParserFactView.d.ts +42 -22
  61. package/indexerPartitionConvergence.d.ts +0 -3
  62. package/indexerPartitionInventory.d.ts +2 -0
  63. package/indexerPartitionPlan.d.ts +101 -99
  64. package/indexerPhysicalArtifactManifest.d.ts +8 -8
  65. package/indexerPostAuthorComposition.d.ts +116 -1156
  66. package/indexerPostAuthorRunLedger.d.ts +1434 -280
  67. package/indexerPrimaryProjection.d.ts +10 -10
  68. package/indexerPrimaryResultView.d.ts +435 -0
  69. package/indexerProfileContract.d.ts +181 -181
  70. package/indexerProgramExecutionAuthorization.d.ts +12 -12
  71. package/indexerProgramRunProtocol.d.ts +2141 -2749
  72. package/indexerProjectProposal.d.ts +496 -292
  73. package/indexerProjectedArtifactFanOutAudit.d.ts +0 -3
  74. package/indexerProtocolCommon.d.ts +4 -1
  75. package/indexerProvider.d.ts +134 -218
  76. package/indexerProviderComposition.d.ts +53 -53
  77. package/indexerProviderResolution.d.ts +12 -12
  78. package/indexerProviderResolutionAction.d.ts +14 -14
  79. package/indexerProviderRouting.d.ts +923 -515
  80. package/indexerProviderSelectionProposal.d.ts +893 -485
  81. package/indexerQuestionAuthority.d.ts +46 -47
  82. package/indexerReaderTargetInventory.d.ts +8 -8
  83. package/indexerRegistry.d.ts +765 -357
  84. package/indexerRequirementConfirmation.d.ts +98 -98
  85. package/indexerRequirementLifecycle.d.ts +224 -224
  86. package/indexerResultReconciliation.d.ts +204 -5919
  87. package/indexerResultReconciliationRun.d.ts +0 -1
  88. package/indexerRunEnvelope.d.ts +20 -20
  89. package/indexerSemanticInput.d.ts +3678 -0
  90. package/indexerStructuredDeclaration.d.ts +57 -53
  91. package/indexerSubjectCatalog.d.ts +14 -14
  92. package/indexerSubjectIdentity.d.ts +2 -2
  93. package/indexerSubjectKeyAuthority.d.ts +31 -30
  94. package/indexerTemplateRendering.d.ts +64 -64
  95. package/indexerToolSnapshot.d.ts +8 -8
  96. package/package.json +1 -1
  97. package/phases.d.ts +3 -183
  98. package/codeIndexPlan.d.ts +0 -158
  99. package/indexerAuditFacts.d.ts +0 -66
  100. package/indexerAuditOverrideReadiness.d.ts +0 -27
  101. package/indexerAuditProtocol.d.ts +0 -238
  102. package/indexerAuditRevision.d.ts +0 -726
  103. package/indexerAuditRevisionActions.d.ts +0 -236
  104. package/indexerMaterialAnswer.d.ts +0 -738
  105. package/indexerMaterialAnswerActualization.d.ts +0 -91
  106. package/indexerMaterialAnswerExecutionPlan.d.ts +0 -2887
  107. package/indexerMaterialAnswerFlow.d.ts +0 -63
  108. package/indexerMaterialAnswerLayout.d.ts +0 -76
  109. package/indexerMaterialAnswerReview.d.ts +0 -217
  110. package/indexerMaterialAnswerReviewRoute.d.ts +0 -6145
  111. package/indexerMaterialAnswerRunLedger.d.ts +0 -918
  112. package/indexerMaterialAnswerRunProtocol.d.ts +0 -1253
  113. package/indexerMaterialQuestionExclusion.d.ts +0 -129
  114. package/indexerMaterialQuestionWorkset.d.ts +0 -508
  115. package/indexerPlannedMaterialAnswer.d.ts +0 -116
  116. package/indexerProfileMetricAudit.d.ts +0 -218
  117. package/indexerWorksetRead.d.ts +0 -287
@@ -1,129 +0,0 @@
1
- import { z } from "zod";
2
- import { type IndexerMaterialGapLedger } from "./indexerMaterialGapLedger.js";
3
- export declare const indexerMaterialQuestionExclusionReportSchema: z.ZodObject<{
4
- protocol: z.ZodLiteral<"context.indexer.material-question-exclusion-report/v1">;
5
- project_ref: z.ZodString;
6
- ledger_revision: z.ZodString;
7
- question_target_inventory_digest: z.ZodString;
8
- question_key: z.ZodString;
9
- question_ref: z.ZodString;
10
- question_contract_digest: z.ZodString;
11
- question_subject_target_ref: z.ZodString;
12
- question_target_item_digest: z.ZodString;
13
- question_revision_digest: z.ZodString;
14
- reason_code: z.ZodEffects<z.ZodString, string, string>;
15
- severity: z.ZodEnum<["blocking", "recommended"]>;
16
- reader_impact: z.ZodEffects<z.ZodString, string, string>;
17
- report_digest: z.ZodString;
18
- }, "strict", z.ZodTypeAny, {
19
- protocol: "context.indexer.material-question-exclusion-report/v1";
20
- severity: "recommended" | "blocking";
21
- project_ref: string;
22
- report_digest: string;
23
- question_target_inventory_digest: string;
24
- reason_code: string;
25
- question_ref: string;
26
- question_contract_digest: string;
27
- question_subject_target_ref: string;
28
- question_target_item_digest: string;
29
- question_key: string;
30
- question_revision_digest: string;
31
- ledger_revision: string;
32
- reader_impact: string;
33
- }, {
34
- protocol: "context.indexer.material-question-exclusion-report/v1";
35
- severity: "recommended" | "blocking";
36
- project_ref: string;
37
- report_digest: string;
38
- question_target_inventory_digest: string;
39
- reason_code: string;
40
- question_ref: string;
41
- question_contract_digest: string;
42
- question_subject_target_ref: string;
43
- question_target_item_digest: string;
44
- question_key: string;
45
- question_revision_digest: string;
46
- ledger_revision: string;
47
- reader_impact: string;
48
- }>;
49
- export declare const indexerMaterialQuestionExclusionConfirmationSchema: z.ZodObject<{
50
- protocol: z.ZodLiteral<"context.indexer.material-question-exclusion-confirmation/v1">;
51
- project_ref: z.ZodString;
52
- question_key: z.ZodString;
53
- question_contract_digest: z.ZodString;
54
- question_subject_target_ref: z.ZodString;
55
- question_target_item_digest: z.ZodString;
56
- reason_code: z.ZodEffects<z.ZodString, string, string>;
57
- report_digest: z.ZodString;
58
- authority: z.ZodLiteral<"human">;
59
- non_delegable: z.ZodLiteral<true>;
60
- confirmed_by: z.ZodString;
61
- confirmed_at: z.ZodString;
62
- decision_digest: z.ZodString;
63
- }, "strict", z.ZodTypeAny, {
64
- protocol: "context.indexer.material-question-exclusion-confirmation/v1";
65
- authority: "human";
66
- project_ref: string;
67
- report_digest: string;
68
- reason_code: string;
69
- question_contract_digest: string;
70
- question_subject_target_ref: string;
71
- question_target_item_digest: string;
72
- question_key: string;
73
- decision_digest: string;
74
- confirmed_by: string;
75
- confirmed_at: string;
76
- non_delegable: true;
77
- }, {
78
- protocol: "context.indexer.material-question-exclusion-confirmation/v1";
79
- authority: "human";
80
- project_ref: string;
81
- report_digest: string;
82
- reason_code: string;
83
- question_contract_digest: string;
84
- question_subject_target_ref: string;
85
- question_target_item_digest: string;
86
- question_key: string;
87
- decision_digest: string;
88
- confirmed_by: string;
89
- confirmed_at: string;
90
- non_delegable: true;
91
- }>;
92
- export type IndexerMaterialQuestionExclusionReport = z.infer<typeof indexerMaterialQuestionExclusionReportSchema>;
93
- export type IndexerMaterialQuestionExclusionConfirmation = z.infer<typeof indexerMaterialQuestionExclusionConfirmationSchema>;
94
- export declare function indexerMaterialQuestionExclusionReportDigest(value: Omit<IndexerMaterialQuestionExclusionReport, "report_digest">): string;
95
- export declare function indexerMaterialQuestionExclusionDecisionDigest(value: Omit<IndexerMaterialQuestionExclusionConfirmation, "decision_digest">): string;
96
- export declare function proposeIndexerMaterialQuestionExclusion(input: {
97
- ledger: unknown;
98
- expected_revision: string;
99
- project_ref: string;
100
- question_key: string;
101
- resolved_question: unknown;
102
- reason_code: string;
103
- domain_state: "required" | "optional" | "out-of-scope";
104
- reader_impact: string;
105
- }): IndexerMaterialQuestionExclusionReport;
106
- export declare function validateIndexerMaterialQuestionExclusionReport(input: {
107
- ledger: unknown;
108
- report: unknown;
109
- resolved_question: unknown;
110
- domain_state: "required" | "optional" | "out-of-scope";
111
- }): IndexerMaterialQuestionExclusionReport;
112
- export declare function confirmIndexerMaterialQuestionExclusion(input: {
113
- report: unknown;
114
- authority: "human" | "managed";
115
- confirmed_by: string;
116
- confirmed_at: string;
117
- }): IndexerMaterialQuestionExclusionConfirmation;
118
- export declare function validateIndexerMaterialQuestionExclusionConfirmation(input: {
119
- report: unknown;
120
- confirmation: unknown;
121
- }): IndexerMaterialQuestionExclusionConfirmation;
122
- export declare function applyIndexerMaterialQuestionExclusion(input: {
123
- ledger: unknown;
124
- expected_revision: string;
125
- report: unknown;
126
- confirmation: unknown;
127
- resolved_question: unknown;
128
- domain_state: "required" | "optional" | "out-of-scope";
129
- }): IndexerMaterialGapLedger;
@@ -1,508 +0,0 @@
1
- import { z } from "zod";
2
- import { INDEXER_EVIDENCE_KINDS } from "./indexerProtocolCommon.js";
3
- import { type IndexerQuestionTargetInventory, type IndexerResolvedMaterialQuestion } from "./indexerQuestionAuthority.js";
4
- declare const materialQuestionSchema: z.ZodObject<{
5
- owner_cell_ref: z.ZodString;
6
- question_ref: z.ZodString;
7
- question_contract_digest: z.ZodString;
8
- question_subject_target_ref: z.ZodString;
9
- question_target_item_digest: z.ZodString;
10
- answer_landing_ref: z.ZodOptional<z.ZodString>;
11
- evidence_contract: z.ZodEffects<z.ZodObject<{
12
- accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
13
- minimum_items: z.ZodNumber;
14
- minimum_distinct_sources: z.ZodNumber;
15
- provenance_constraints: z.ZodOptional<z.ZodObject<{
16
- protocol: z.ZodLiteral<"context.indexer.selector/v1">;
17
- expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
18
- }, "strict", z.ZodTypeAny, {
19
- protocol: "context.indexer.selector/v1";
20
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
21
- }, {
22
- protocol: "context.indexer.selector/v1";
23
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
24
- }>>;
25
- }, "strict", z.ZodTypeAny, {
26
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
27
- minimum_items: number;
28
- minimum_distinct_sources: number;
29
- provenance_constraints?: {
30
- protocol: "context.indexer.selector/v1";
31
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
32
- } | undefined;
33
- }, {
34
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
35
- minimum_items: number;
36
- minimum_distinct_sources: number;
37
- provenance_constraints?: {
38
- protocol: "context.indexer.selector/v1";
39
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
40
- } | undefined;
41
- }>, {
42
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
43
- minimum_items: number;
44
- minimum_distinct_sources: number;
45
- provenance_constraints?: {
46
- protocol: "context.indexer.selector/v1";
47
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
48
- } | undefined;
49
- }, {
50
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
51
- minimum_items: number;
52
- minimum_distinct_sources: number;
53
- provenance_constraints?: {
54
- protocol: "context.indexer.selector/v1";
55
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
56
- } | undefined;
57
- }>;
58
- source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
59
- }, "strict", z.ZodTypeAny, {
60
- evidence_contract: {
61
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
62
- minimum_items: number;
63
- minimum_distinct_sources: number;
64
- provenance_constraints?: {
65
- protocol: "context.indexer.selector/v1";
66
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
67
- } | undefined;
68
- };
69
- question_ref: string;
70
- owner_cell_ref: string;
71
- question_contract_digest: string;
72
- question_subject_target_ref: string;
73
- question_target_item_digest: string;
74
- source_refs?: string[] | undefined;
75
- answer_landing_ref?: string | undefined;
76
- }, {
77
- evidence_contract: {
78
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
79
- minimum_items: number;
80
- minimum_distinct_sources: number;
81
- provenance_constraints?: {
82
- protocol: "context.indexer.selector/v1";
83
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
84
- } | undefined;
85
- };
86
- question_ref: string;
87
- owner_cell_ref: string;
88
- question_contract_digest: string;
89
- question_subject_target_ref: string;
90
- question_target_item_digest: string;
91
- source_refs?: string[] | undefined;
92
- answer_landing_ref?: string | undefined;
93
- }>;
94
- declare const worksetItemSchema: z.ZodObject<{
95
- question_key: z.ZodString;
96
- question_contract_digest: z.ZodString;
97
- question_revision_digest: z.ZodString;
98
- question: z.ZodObject<{
99
- owner_cell_ref: z.ZodString;
100
- question_ref: z.ZodString;
101
- question_contract_digest: z.ZodString;
102
- question_subject_target_ref: z.ZodString;
103
- question_target_item_digest: z.ZodString;
104
- answer_landing_ref: z.ZodOptional<z.ZodString>;
105
- evidence_contract: z.ZodEffects<z.ZodObject<{
106
- accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
107
- minimum_items: z.ZodNumber;
108
- minimum_distinct_sources: z.ZodNumber;
109
- provenance_constraints: z.ZodOptional<z.ZodObject<{
110
- protocol: z.ZodLiteral<"context.indexer.selector/v1">;
111
- expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
112
- }, "strict", z.ZodTypeAny, {
113
- protocol: "context.indexer.selector/v1";
114
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
115
- }, {
116
- protocol: "context.indexer.selector/v1";
117
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
118
- }>>;
119
- }, "strict", z.ZodTypeAny, {
120
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
121
- minimum_items: number;
122
- minimum_distinct_sources: number;
123
- provenance_constraints?: {
124
- protocol: "context.indexer.selector/v1";
125
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
126
- } | undefined;
127
- }, {
128
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
129
- minimum_items: number;
130
- minimum_distinct_sources: number;
131
- provenance_constraints?: {
132
- protocol: "context.indexer.selector/v1";
133
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
134
- } | undefined;
135
- }>, {
136
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
137
- minimum_items: number;
138
- minimum_distinct_sources: number;
139
- provenance_constraints?: {
140
- protocol: "context.indexer.selector/v1";
141
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
142
- } | undefined;
143
- }, {
144
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
145
- minimum_items: number;
146
- minimum_distinct_sources: number;
147
- provenance_constraints?: {
148
- protocol: "context.indexer.selector/v1";
149
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
150
- } | undefined;
151
- }>;
152
- source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
153
- }, "strict", z.ZodTypeAny, {
154
- evidence_contract: {
155
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
156
- minimum_items: number;
157
- minimum_distinct_sources: number;
158
- provenance_constraints?: {
159
- protocol: "context.indexer.selector/v1";
160
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
161
- } | undefined;
162
- };
163
- question_ref: string;
164
- owner_cell_ref: string;
165
- question_contract_digest: string;
166
- question_subject_target_ref: string;
167
- question_target_item_digest: string;
168
- source_refs?: string[] | undefined;
169
- answer_landing_ref?: string | undefined;
170
- }, {
171
- evidence_contract: {
172
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
173
- minimum_items: number;
174
- minimum_distinct_sources: number;
175
- provenance_constraints?: {
176
- protocol: "context.indexer.selector/v1";
177
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
178
- } | undefined;
179
- };
180
- question_ref: string;
181
- owner_cell_ref: string;
182
- question_contract_digest: string;
183
- question_subject_target_ref: string;
184
- question_target_item_digest: string;
185
- source_refs?: string[] | undefined;
186
- answer_landing_ref?: string | undefined;
187
- }>;
188
- eligible_answer_indexer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
189
- authorized_source_refs: z.ZodArray<z.ZodString, "many">;
190
- }, "strict", z.ZodTypeAny, {
191
- question_contract_digest: string;
192
- question_key: string;
193
- question_revision_digest: string;
194
- question: {
195
- evidence_contract: {
196
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
197
- minimum_items: number;
198
- minimum_distinct_sources: number;
199
- provenance_constraints?: {
200
- protocol: "context.indexer.selector/v1";
201
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
202
- } | undefined;
203
- };
204
- question_ref: string;
205
- owner_cell_ref: string;
206
- question_contract_digest: string;
207
- question_subject_target_ref: string;
208
- question_target_item_digest: string;
209
- source_refs?: string[] | undefined;
210
- answer_landing_ref?: string | undefined;
211
- };
212
- eligible_answer_indexer_ids: string[];
213
- authorized_source_refs: string[];
214
- }, {
215
- question_contract_digest: string;
216
- question_key: string;
217
- question_revision_digest: string;
218
- question: {
219
- evidence_contract: {
220
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
221
- minimum_items: number;
222
- minimum_distinct_sources: number;
223
- provenance_constraints?: {
224
- protocol: "context.indexer.selector/v1";
225
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
226
- } | undefined;
227
- };
228
- question_ref: string;
229
- owner_cell_ref: string;
230
- question_contract_digest: string;
231
- question_subject_target_ref: string;
232
- question_target_item_digest: string;
233
- source_refs?: string[] | undefined;
234
- answer_landing_ref?: string | undefined;
235
- };
236
- eligible_answer_indexer_ids: string[];
237
- authorized_source_refs: string[];
238
- }>;
239
- export declare const indexerMaterialQuestionWorksetSchema: z.ZodObject<{
240
- protocol: z.ZodLiteral<"context.indexer.material-question-workset/v1">;
241
- workset_digest: z.ZodString;
242
- question_set_digest: z.ZodString;
243
- question_target_inventory_digest: z.ZodString;
244
- question_target_set_digest: z.ZodString;
245
- predecessor_ledger_revision: z.ZodString;
246
- registry_digest: z.ZodString;
247
- requirement_set_digest: z.ZodString;
248
- source_input_digests: z.ZodArray<z.ZodString, "many">;
249
- items: z.ZodArray<z.ZodObject<{
250
- question_key: z.ZodString;
251
- question_contract_digest: z.ZodString;
252
- question_revision_digest: z.ZodString;
253
- question: z.ZodObject<{
254
- owner_cell_ref: z.ZodString;
255
- question_ref: z.ZodString;
256
- question_contract_digest: z.ZodString;
257
- question_subject_target_ref: z.ZodString;
258
- question_target_item_digest: z.ZodString;
259
- answer_landing_ref: z.ZodOptional<z.ZodString>;
260
- evidence_contract: z.ZodEffects<z.ZodObject<{
261
- accepted_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
262
- minimum_items: z.ZodNumber;
263
- minimum_distinct_sources: z.ZodNumber;
264
- provenance_constraints: z.ZodOptional<z.ZodObject<{
265
- protocol: z.ZodLiteral<"context.indexer.selector/v1">;
266
- expression: z.ZodType<import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression, z.ZodTypeDef, import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression>;
267
- }, "strict", z.ZodTypeAny, {
268
- protocol: "context.indexer.selector/v1";
269
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
270
- }, {
271
- protocol: "context.indexer.selector/v1";
272
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
273
- }>>;
274
- }, "strict", z.ZodTypeAny, {
275
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
276
- minimum_items: number;
277
- minimum_distinct_sources: number;
278
- provenance_constraints?: {
279
- protocol: "context.indexer.selector/v1";
280
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
281
- } | undefined;
282
- }, {
283
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
284
- minimum_items: number;
285
- minimum_distinct_sources: number;
286
- provenance_constraints?: {
287
- protocol: "context.indexer.selector/v1";
288
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
289
- } | undefined;
290
- }>, {
291
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
292
- minimum_items: number;
293
- minimum_distinct_sources: number;
294
- provenance_constraints?: {
295
- protocol: "context.indexer.selector/v1";
296
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
297
- } | undefined;
298
- }, {
299
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
300
- minimum_items: number;
301
- minimum_distinct_sources: number;
302
- provenance_constraints?: {
303
- protocol: "context.indexer.selector/v1";
304
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
305
- } | undefined;
306
- }>;
307
- source_refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
308
- }, "strict", z.ZodTypeAny, {
309
- evidence_contract: {
310
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
311
- minimum_items: number;
312
- minimum_distinct_sources: number;
313
- provenance_constraints?: {
314
- protocol: "context.indexer.selector/v1";
315
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
316
- } | undefined;
317
- };
318
- question_ref: string;
319
- owner_cell_ref: string;
320
- question_contract_digest: string;
321
- question_subject_target_ref: string;
322
- question_target_item_digest: string;
323
- source_refs?: string[] | undefined;
324
- answer_landing_ref?: string | undefined;
325
- }, {
326
- evidence_contract: {
327
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
328
- minimum_items: number;
329
- minimum_distinct_sources: number;
330
- provenance_constraints?: {
331
- protocol: "context.indexer.selector/v1";
332
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
333
- } | undefined;
334
- };
335
- question_ref: string;
336
- owner_cell_ref: string;
337
- question_contract_digest: string;
338
- question_subject_target_ref: string;
339
- question_target_item_digest: string;
340
- source_refs?: string[] | undefined;
341
- answer_landing_ref?: string | undefined;
342
- }>;
343
- eligible_answer_indexer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
344
- authorized_source_refs: z.ZodArray<z.ZodString, "many">;
345
- }, "strict", z.ZodTypeAny, {
346
- question_contract_digest: string;
347
- question_key: string;
348
- question_revision_digest: string;
349
- question: {
350
- evidence_contract: {
351
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
352
- minimum_items: number;
353
- minimum_distinct_sources: number;
354
- provenance_constraints?: {
355
- protocol: "context.indexer.selector/v1";
356
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
357
- } | undefined;
358
- };
359
- question_ref: string;
360
- owner_cell_ref: string;
361
- question_contract_digest: string;
362
- question_subject_target_ref: string;
363
- question_target_item_digest: string;
364
- source_refs?: string[] | undefined;
365
- answer_landing_ref?: string | undefined;
366
- };
367
- eligible_answer_indexer_ids: string[];
368
- authorized_source_refs: string[];
369
- }, {
370
- question_contract_digest: string;
371
- question_key: string;
372
- question_revision_digest: string;
373
- question: {
374
- evidence_contract: {
375
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
376
- minimum_items: number;
377
- minimum_distinct_sources: number;
378
- provenance_constraints?: {
379
- protocol: "context.indexer.selector/v1";
380
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
381
- } | undefined;
382
- };
383
- question_ref: string;
384
- owner_cell_ref: string;
385
- question_contract_digest: string;
386
- question_subject_target_ref: string;
387
- question_target_item_digest: string;
388
- source_refs?: string[] | undefined;
389
- answer_landing_ref?: string | undefined;
390
- };
391
- eligible_answer_indexer_ids: string[];
392
- authorized_source_refs: string[];
393
- }>, "many">;
394
- }, "strict", z.ZodTypeAny, {
395
- protocol: "context.indexer.material-question-workset/v1";
396
- workset_digest: string;
397
- requirement_set_digest: string;
398
- question_target_inventory_digest: string;
399
- items: {
400
- question_contract_digest: string;
401
- question_key: string;
402
- question_revision_digest: string;
403
- question: {
404
- evidence_contract: {
405
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
406
- minimum_items: number;
407
- minimum_distinct_sources: number;
408
- provenance_constraints?: {
409
- protocol: "context.indexer.selector/v1";
410
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
411
- } | undefined;
412
- };
413
- question_ref: string;
414
- owner_cell_ref: string;
415
- question_contract_digest: string;
416
- question_subject_target_ref: string;
417
- question_target_item_digest: string;
418
- source_refs?: string[] | undefined;
419
- answer_landing_ref?: string | undefined;
420
- };
421
- eligible_answer_indexer_ids: string[];
422
- authorized_source_refs: string[];
423
- }[];
424
- question_set_digest: string;
425
- question_target_set_digest: string;
426
- predecessor_ledger_revision: string;
427
- registry_digest: string;
428
- source_input_digests: string[];
429
- }, {
430
- protocol: "context.indexer.material-question-workset/v1";
431
- workset_digest: string;
432
- requirement_set_digest: string;
433
- question_target_inventory_digest: string;
434
- items: {
435
- question_contract_digest: string;
436
- question_key: string;
437
- question_revision_digest: string;
438
- question: {
439
- evidence_contract: {
440
- accepted_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
441
- minimum_items: number;
442
- minimum_distinct_sources: number;
443
- provenance_constraints?: {
444
- protocol: "context.indexer.selector/v1";
445
- expression: import("./indexerRestrictedSelector.js").IndexerRestrictedSelectorExpression;
446
- } | undefined;
447
- };
448
- question_ref: string;
449
- owner_cell_ref: string;
450
- question_contract_digest: string;
451
- question_subject_target_ref: string;
452
- question_target_item_digest: string;
453
- source_refs?: string[] | undefined;
454
- answer_landing_ref?: string | undefined;
455
- };
456
- eligible_answer_indexer_ids: string[];
457
- authorized_source_refs: string[];
458
- }[];
459
- question_set_digest: string;
460
- question_target_set_digest: string;
461
- predecessor_ledger_revision: string;
462
- registry_digest: string;
463
- source_input_digests: string[];
464
- }>;
465
- export type IndexerMaterialQuestion = z.infer<typeof materialQuestionSchema>;
466
- export type IndexerMaterialQuestionWorksetItem = z.infer<typeof worksetItemSchema>;
467
- export type IndexerMaterialQuestionWorkset = z.infer<typeof indexerMaterialQuestionWorksetSchema>;
468
- export declare function indexerMaterialQuestionWorksetDigest(value: Omit<IndexerMaterialQuestionWorkset, "workset_digest">): string;
469
- interface OwnerCellAuthority {
470
- owner_cell_ref: string;
471
- owner_cell_digest: string;
472
- requirement_ref: string;
473
- coverage_domain: string;
474
- domain_state: "required" | "optional" | "out-of-scope";
475
- }
476
- interface AnswerIndexerCandidate {
477
- indexer_id: string;
478
- operations: readonly string[];
479
- requirement_binding_role: "primary" | "enricher";
480
- provider_operation_supported: boolean;
481
- supported_evidence_kinds: readonly typeof INDEXER_EVIDENCE_KINDS[number][];
482
- }
483
- interface QuestionRoute {
484
- requirement_ref: string;
485
- question_ref: string;
486
- target_ref: string;
487
- answer_landing_ref?: string;
488
- answer_landing_dependency_digest?: string;
489
- authorized_source_refs: readonly string[];
490
- candidates: readonly AnswerIndexerCandidate[];
491
- }
492
- export declare function buildIndexerMaterialQuestionWorkset(input: {
493
- question_target_inventory: IndexerQuestionTargetInventory;
494
- resolved_questions: readonly {
495
- requirement_ref: string;
496
- question: IndexerResolvedMaterialQuestion;
497
- }[];
498
- owner_cells: readonly OwnerCellAuthority[];
499
- target_facts: Readonly<Record<string, Record<string, unknown>>>;
500
- allowed_selector_fact_paths: ReadonlySet<string>;
501
- routes: readonly QuestionRoute[];
502
- predecessor_ledger_revision: string;
503
- registry_digest: string;
504
- requirement_set_digest: string;
505
- source_input_digests: readonly string[];
506
- }): IndexerMaterialQuestionWorkset;
507
- export declare function validateIndexerMaterialQuestionWorkset(value: unknown): IndexerMaterialQuestionWorkset;
508
- export {};