@c4a/context 0.7.8 → 0.7.10-alpha.1

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 (84) hide show
  1. package/articleStructure.d.ts +254 -0
  2. package/docs/guides/agent-dialogue.md +6 -5
  3. package/docs/guides/agent-guide.md +11 -5
  4. package/docs/guides/code-indexer-skill-authoring.md +76 -178
  5. package/docs/guides/indexer-provider-and-customization.md +93 -398
  6. package/docs/guides/indexer-skill-creation.md +107 -97
  7. package/docs/guides/knowledge-updates.md +137 -18
  8. package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
  9. package/docs/guides/package-outputs.md +213 -47
  10. package/docs/reference/indexer-provider-protocol.md +71 -102
  11. package/docs/reference/package-templates.md +39 -65
  12. package/docs/reference/project-api.md +53 -0
  13. package/docs/reference/template-variables.md +2 -3
  14. package/index.d.ts +11 -11
  15. package/index.js +5826 -8062
  16. package/indexerAgentStepProtocol.d.ts +0 -910
  17. package/indexerApprovedKnowledge.d.ts +98 -359
  18. package/indexerArticlePlan.d.ts +3 -26
  19. package/indexerArtifact.d.ts +201 -70
  20. package/indexerArtifactPolicy.d.ts +4 -22
  21. package/indexerArtifactResult.d.ts +240 -888
  22. package/indexerAuthoringFixture.d.ts +0 -13
  23. package/indexerBenchmark.d.ts +2 -2
  24. package/indexerCandidateCompile.d.ts +123 -167
  25. package/indexerCatalogFallback.d.ts +32 -374
  26. package/indexerCollectionMapping.d.ts +2 -2
  27. package/indexerContentLayers.d.ts +187 -41
  28. package/indexerContractOverlay.d.ts +30 -44
  29. package/indexerControlledInvocation.d.ts +6 -6
  30. package/indexerControlledProgram.d.ts +959 -3020
  31. package/indexerDependencyView.d.ts +96 -96
  32. package/indexerEffectiveArtifact.d.ts +381 -242
  33. package/indexerExampleDecision.d.ts +134 -134
  34. package/indexerExampleIdentity.d.ts +6 -6
  35. package/indexerExampleIdentityAudit.d.ts +6 -6
  36. package/indexerInventoryDisposition.d.ts +0 -39
  37. package/indexerLayerComposition.d.ts +1378 -852
  38. package/indexerLayoutChange.d.ts +24 -33
  39. package/indexerLayoutProposalSet.d.ts +143 -137
  40. package/indexerLayoutResolver.d.ts +116 -101
  41. package/indexerLayoutTransition.d.ts +6 -6
  42. package/indexerMainLifecycle.d.ts +1 -11
  43. package/indexerMainRunLedger.d.ts +0 -14
  44. package/indexerMainRunProtocol.d.ts +806 -2530
  45. package/indexerMainWorkset.d.ts +0 -1212
  46. package/indexerNavigationArtifactPlan.d.ts +2 -2
  47. package/indexerOverlayQuestionApplyProposal.d.ts +0 -4
  48. package/indexerParserCoordinate.d.ts +2 -2
  49. package/indexerParserExecutionPlan.d.ts +42 -42
  50. package/indexerPartitionPlan.d.ts +24 -354
  51. package/indexerPhysicalArtifactManifest.d.ts +12 -27
  52. package/indexerPostAuthorComposition.d.ts +2 -253
  53. package/indexerPostAuthorRunLedger.d.ts +860 -562
  54. package/indexerPrimaryProjection.d.ts +2 -2
  55. package/indexerPrimaryResultView.d.ts +0 -318
  56. package/indexerProfileContract.d.ts +200 -549
  57. package/indexerProgramExecutionAuthorization.d.ts +4 -4
  58. package/indexerProgramRunProtocol.d.ts +806 -2527
  59. package/indexerProjectProposal.d.ts +8 -8
  60. package/indexerProjectedArtifactFanOutAudit.d.ts +8 -8
  61. package/indexerProjectedArtifactPlan.d.ts +0 -9
  62. package/indexerProtocolHash.d.ts +2 -0
  63. package/indexerProvider.d.ts +76 -318
  64. package/indexerProviderComposition.d.ts +16 -42
  65. package/indexerQuestionAuthority.d.ts +2 -82
  66. package/indexerReaderTargetInventory.d.ts +6 -6
  67. package/indexerRegistry.d.ts +606 -0
  68. package/indexerRequirementLifecycle.d.ts +6 -6
  69. package/indexerResultReconciliation.d.ts +35 -149
  70. package/indexerSemanticInput.d.ts +10926 -5665
  71. package/indexerStructuredDeclaration.d.ts +24 -24
  72. package/indexerTemplateRendering.d.ts +239 -113
  73. package/{readingStructure.d.ts → knowledgeMap.d.ts} +21 -21
  74. package/package.json +1 -1
  75. package/packageSite.d.ts +25 -0
  76. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +13 -16
  77. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +9 -9
  78. package/indexerArtifactDependencies.d.ts +0 -693
  79. package/indexerCompositionFactDependencies.d.ts +0 -16
  80. package/indexerExampleFactDependencies.d.ts +0 -17
  81. package/indexerIncrementalImpact.d.ts +0 -221
  82. package/indexerKnowledgeDependency.d.ts +0 -46
  83. package/indexerSubjectCatalog.d.ts +0 -230
  84. package/indexerSubjectKeyAuthority.d.ts +0 -786
@@ -75,214 +75,13 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
75
75
  source_role: z.ZodEffects<z.ZodString, string, string>;
76
76
  logical_unit: z.ZodObject<{
77
77
  group_key: z.ZodString;
78
- subject_key: z.ZodObject<{
79
- protocol: z.ZodLiteral<"context.subject-key/v1">;
80
- namespace: z.ZodEffects<z.ZodString, string, string>;
81
- kind: z.ZodEffects<z.ZodString, string, string>;
82
- local_key: z.ZodEffects<z.ZodString, string, string>;
83
- }, "strict", z.ZodTypeAny, {
84
- kind: string;
85
- namespace: string;
86
- protocol: "context.subject-key/v1";
87
- local_key: string;
88
- }, {
89
- kind: string;
90
- namespace: string;
91
- protocol: "context.subject-key/v1";
92
- local_key: string;
93
- }>;
94
78
  logical_unit_ref: z.ZodString;
95
- target_resolution_dispositions: z.ZodArray<z.ZodUnion<[z.ZodObject<{
96
- query_ref: z.ZodString;
97
- disposition: z.ZodLiteral<"reuse-existing">;
98
- target_subject_key: z.ZodObject<{
99
- protocol: z.ZodLiteral<"context.subject-key/v1">;
100
- namespace: z.ZodEffects<z.ZodString, string, string>;
101
- kind: z.ZodEffects<z.ZodString, string, string>;
102
- local_key: z.ZodEffects<z.ZodString, string, string>;
103
- }, "strict", z.ZodTypeAny, {
104
- kind: string;
105
- namespace: string;
106
- protocol: "context.subject-key/v1";
107
- local_key: string;
108
- }, {
109
- kind: string;
110
- namespace: string;
111
- protocol: "context.subject-key/v1";
112
- local_key: string;
113
- }>;
114
- target_node_ref: z.ZodString;
115
- }, "strict", z.ZodTypeAny, {
116
- target_node_ref: string;
117
- disposition: "reuse-existing";
118
- query_ref: string;
119
- target_subject_key: {
120
- kind: string;
121
- namespace: string;
122
- protocol: "context.subject-key/v1";
123
- local_key: string;
124
- };
125
- }, {
126
- target_node_ref: string;
127
- disposition: "reuse-existing";
128
- query_ref: string;
129
- target_subject_key: {
130
- kind: string;
131
- namespace: string;
132
- protocol: "context.subject-key/v1";
133
- local_key: string;
134
- };
135
- }>, z.ZodObject<{
136
- query_ref: z.ZodString;
137
- disposition: z.ZodLiteral<"create-independent">;
138
- subject_key: z.ZodObject<{
139
- protocol: z.ZodLiteral<"context.subject-key/v1">;
140
- namespace: z.ZodEffects<z.ZodString, string, string>;
141
- kind: z.ZodEffects<z.ZodString, string, string>;
142
- local_key: z.ZodEffects<z.ZodString, string, string>;
143
- }, "strict", z.ZodTypeAny, {
144
- kind: string;
145
- namespace: string;
146
- protocol: "context.subject-key/v1";
147
- local_key: string;
148
- }, {
149
- kind: string;
150
- namespace: string;
151
- protocol: "context.subject-key/v1";
152
- local_key: string;
153
- }>;
154
- reason_code: z.ZodEffects<z.ZodString, string, string>;
155
- evidence_refs: z.ZodArray<z.ZodString, "many">;
156
- }, "strict", z.ZodTypeAny, {
157
- subject_key: {
158
- kind: string;
159
- namespace: string;
160
- protocol: "context.subject-key/v1";
161
- local_key: string;
162
- };
163
- evidence_refs: string[];
164
- disposition: "create-independent";
165
- query_ref: string;
166
- reason_code: string;
167
- }, {
168
- subject_key: {
169
- kind: string;
170
- namespace: string;
171
- protocol: "context.subject-key/v1";
172
- local_key: string;
173
- };
174
- evidence_refs: string[];
175
- disposition: "create-independent";
176
- query_ref: string;
177
- reason_code: string;
178
- }>, z.ZodObject<{
179
- query_ref: z.ZodString;
180
- disposition: z.ZodLiteral<"request-material">;
181
- missing_facts: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
182
- source_hints: z.ZodArray<z.ZodString, "many">;
183
- }, "strict", z.ZodTypeAny, {
184
- disposition: "request-material";
185
- query_ref: string;
186
- missing_facts: string[];
187
- source_hints: string[];
188
- }, {
189
- disposition: "request-material";
190
- query_ref: string;
191
- missing_facts: string[];
192
- source_hints: string[];
193
- }>, z.ZodObject<{
194
- query_ref: z.ZodString;
195
- disposition: z.ZodLiteral<"unsupported">;
196
- missing_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
197
- }, "strict", z.ZodTypeAny, {
198
- disposition: "unsupported";
199
- query_ref: string;
200
- missing_capabilities: string[];
201
- }, {
202
- disposition: "unsupported";
203
- query_ref: string;
204
- missing_capabilities: string[];
205
- }>]>, "many">;
206
79
  }, "strict", z.ZodTypeAny, {
207
- subject_key: {
208
- kind: string;
209
- namespace: string;
210
- protocol: "context.subject-key/v1";
211
- local_key: string;
212
- };
213
80
  logical_unit_ref: string;
214
81
  group_key: string;
215
- target_resolution_dispositions: ({
216
- target_node_ref: string;
217
- disposition: "reuse-existing";
218
- query_ref: string;
219
- target_subject_key: {
220
- kind: string;
221
- namespace: string;
222
- protocol: "context.subject-key/v1";
223
- local_key: string;
224
- };
225
- } | {
226
- subject_key: {
227
- kind: string;
228
- namespace: string;
229
- protocol: "context.subject-key/v1";
230
- local_key: string;
231
- };
232
- evidence_refs: string[];
233
- disposition: "create-independent";
234
- query_ref: string;
235
- reason_code: string;
236
- } | {
237
- disposition: "request-material";
238
- query_ref: string;
239
- missing_facts: string[];
240
- source_hints: string[];
241
- } | {
242
- disposition: "unsupported";
243
- query_ref: string;
244
- missing_capabilities: string[];
245
- })[];
246
82
  }, {
247
- subject_key: {
248
- kind: string;
249
- namespace: string;
250
- protocol: "context.subject-key/v1";
251
- local_key: string;
252
- };
253
83
  logical_unit_ref: string;
254
84
  group_key: string;
255
- target_resolution_dispositions: ({
256
- target_node_ref: string;
257
- disposition: "reuse-existing";
258
- query_ref: string;
259
- target_subject_key: {
260
- kind: string;
261
- namespace: string;
262
- protocol: "context.subject-key/v1";
263
- local_key: string;
264
- };
265
- } | {
266
- subject_key: {
267
- kind: string;
268
- namespace: string;
269
- protocol: "context.subject-key/v1";
270
- local_key: string;
271
- };
272
- evidence_refs: string[];
273
- disposition: "create-independent";
274
- query_ref: string;
275
- reason_code: string;
276
- } | {
277
- disposition: "request-material";
278
- query_ref: string;
279
- missing_facts: string[];
280
- source_hints: string[];
281
- } | {
282
- disposition: "unsupported";
283
- query_ref: string;
284
- missing_capabilities: string[];
285
- })[];
286
85
  }>;
287
86
  capability_group_evidence: z.ZodObject<{
288
87
  protocol: z.ZodLiteral<"context.indexer.capability-group-evidence/v1">;
@@ -401,20 +200,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
401
200
  section_evidence: z.ZodArray<z.ZodObject<{
402
201
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
403
202
  section_key: z.ZodEffects<z.ZodString, string, string>;
404
- evidence_refs: z.ZodArray<z.ZodString, "many">;
405
203
  }, "strict", z.ZodTypeAny, {
406
- evidence_refs: string[];
407
204
  section_key: string;
408
205
  artifact_id: string;
409
206
  }, {
410
- evidence_refs: string[];
411
207
  section_key: string;
412
208
  artifact_id: string;
413
209
  }>, "many">;
414
210
  }, "strict", z.ZodTypeAny, {
415
211
  member_id: string;
416
212
  section_evidence: {
417
- evidence_refs: string[];
418
213
  section_key: string;
419
214
  artifact_id: string;
420
215
  }[];
@@ -424,7 +219,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
424
219
  }, {
425
220
  member_id: string;
426
221
  section_evidence: {
427
- evidence_refs: string[];
428
222
  section_key: string;
429
223
  artifact_id: string;
430
224
  }[];
@@ -454,15 +248,12 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
454
248
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
455
249
  inventory_disposition: z.ZodLiteral<"owned">;
456
250
  projection_disposition: z.ZodLiteral<"catalog-only">;
457
- fact_refs: z.ZodArray<z.ZodString, "many">;
458
251
  }, "strict", z.ZodTypeAny, {
459
- fact_refs: string[];
460
252
  member_id: string;
461
253
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
462
254
  inventory_disposition: "owned";
463
255
  projection_disposition: "catalog-only";
464
256
  }, {
465
- fact_refs: string[];
466
257
  member_id: string;
467
258
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
468
259
  inventory_disposition: "owned";
@@ -472,15 +263,12 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
472
263
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
473
264
  inventory_disposition: z.ZodLiteral<"owned">;
474
265
  projection_disposition: z.ZodLiteral<"boundary-only">;
475
- evidence_refs: z.ZodArray<z.ZodString, "many">;
476
266
  }, "strict", z.ZodTypeAny, {
477
- evidence_refs: string[];
478
267
  member_id: string;
479
268
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
480
269
  inventory_disposition: "owned";
481
270
  projection_disposition: "boundary-only";
482
271
  }, {
483
- evidence_refs: string[];
484
272
  member_id: string;
485
273
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
486
274
  inventory_disposition: "owned";
@@ -490,15 +278,12 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
490
278
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
491
279
  inventory_disposition: z.ZodLiteral<"excluded-with-reason">;
492
280
  reason_code: z.ZodEffects<z.ZodString, string, string>;
493
- evidence_refs: z.ZodArray<z.ZodString, "many">;
494
281
  }, "strict", z.ZodTypeAny, {
495
- evidence_refs: string[];
496
282
  member_id: string;
497
283
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
498
284
  inventory_disposition: "excluded-with-reason";
499
285
  reason_code: string;
500
286
  }, {
501
- evidence_refs: string[];
502
287
  member_id: string;
503
288
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
504
289
  inventory_disposition: "excluded-with-reason";
@@ -545,7 +330,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
545
330
  dispositions: ({
546
331
  member_id: string;
547
332
  section_evidence: {
548
- evidence_refs: string[];
549
333
  section_key: string;
550
334
  artifact_id: string;
551
335
  }[];
@@ -559,19 +343,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
559
343
  inventory_disposition: "owned";
560
344
  projection_disposition: "capability-group";
561
345
  } | {
562
- fact_refs: string[];
563
346
  member_id: string;
564
347
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
565
348
  inventory_disposition: "owned";
566
349
  projection_disposition: "catalog-only";
567
350
  } | {
568
- evidence_refs: string[];
569
351
  member_id: string;
570
352
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
571
353
  inventory_disposition: "owned";
572
354
  projection_disposition: "boundary-only";
573
355
  } | {
574
- evidence_refs: string[];
575
356
  member_id: string;
576
357
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
577
358
  inventory_disposition: "excluded-with-reason";
@@ -598,7 +379,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
598
379
  dispositions: ({
599
380
  member_id: string;
600
381
  section_evidence: {
601
- evidence_refs: string[];
602
382
  section_key: string;
603
383
  artifact_id: string;
604
384
  }[];
@@ -612,19 +392,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
612
392
  inventory_disposition: "owned";
613
393
  projection_disposition: "capability-group";
614
394
  } | {
615
- fact_refs: string[];
616
395
  member_id: string;
617
396
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
618
397
  inventory_disposition: "owned";
619
398
  projection_disposition: "catalog-only";
620
399
  } | {
621
- evidence_refs: string[];
622
400
  member_id: string;
623
401
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
624
402
  inventory_disposition: "owned";
625
403
  projection_disposition: "boundary-only";
626
404
  } | {
627
- evidence_refs: string[];
628
405
  member_id: string;
629
406
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
630
407
  inventory_disposition: "excluded-with-reason";
@@ -642,344 +419,74 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
642
419
  })[];
643
420
  disposition_digest: string;
644
421
  }>;
645
- structured_declarations: z.ZodOptional<z.ZodObject<{
646
- protocol: z.ZodLiteral<"context.indexer.structured-declaration-set/v1">;
647
- source_identity_inventory_digest: z.ZodString;
648
- declarations: z.ZodArray<z.ZodObject<{
649
- carrier_kind: z.ZodEnum<["indexer-result", "catalog", "manifest", "section-evidence"]>;
650
- carrier_ref: z.ZodString;
651
- declaration_kind: z.ZodEnum<["directory", "entry", "method", "handler", "store", "locator"]>;
652
- source_ref: z.ZodString;
653
- module_ref: z.ZodNullable<z.ZodString>;
654
- target: z.ZodDiscriminatedUnion<"target_type", [z.ZodObject<{
655
- target_type: z.ZodLiteral<"directory">;
656
- normalized_path: z.ZodEffects<z.ZodString, string, string>;
657
- }, "strict", z.ZodTypeAny, {
658
- normalized_path: string;
659
- target_type: "directory";
660
- }, {
661
- normalized_path: string;
662
- target_type: "directory";
663
- }>, z.ZodObject<{
664
- target_type: z.ZodLiteral<"file">;
665
- normalized_path: z.ZodEffects<z.ZodString, string, string>;
666
- content_digest: z.ZodString;
667
- }, "strict", z.ZodTypeAny, {
668
- content_digest: string;
669
- normalized_path: string;
670
- target_type: "file";
671
- }, {
672
- content_digest: string;
673
- normalized_path: string;
674
- target_type: "file";
675
- }>, z.ZodObject<{
676
- target_type: z.ZodLiteral<"item">;
677
- normalized_path: z.ZodEffects<z.ZodString, string, string>;
678
- source_fact_ref: z.ZodString;
679
- qualified_item_path: z.ZodString;
680
- signature_digest: z.ZodString;
681
- }, "strict", z.ZodTypeAny, {
682
- normalized_path: string;
683
- qualified_item_path: string;
684
- signature_digest: string;
685
- target_type: "item";
686
- source_fact_ref: string;
687
- }, {
688
- normalized_path: string;
689
- qualified_item_path: string;
690
- signature_digest: string;
691
- target_type: "item";
692
- source_fact_ref: string;
693
- }>]>;
694
- evidence_refs: z.ZodArray<z.ZodString, "many">;
695
- } & {
696
- declaration_ref: z.ZodString;
697
- }, "strict", z.ZodTypeAny, {
698
- source_ref: string;
699
- evidence_refs: string[];
700
- module_ref: string | null;
701
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
702
- carrier_ref: string;
703
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
704
- target: {
705
- normalized_path: string;
706
- target_type: "directory";
707
- } | {
708
- content_digest: string;
709
- normalized_path: string;
710
- target_type: "file";
711
- } | {
712
- normalized_path: string;
713
- qualified_item_path: string;
714
- signature_digest: string;
715
- target_type: "item";
716
- source_fact_ref: string;
717
- };
718
- declaration_ref: string;
719
- }, {
720
- source_ref: string;
721
- evidence_refs: string[];
722
- module_ref: string | null;
723
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
724
- carrier_ref: string;
725
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
726
- target: {
727
- normalized_path: string;
728
- target_type: "directory";
729
- } | {
730
- content_digest: string;
731
- normalized_path: string;
732
- target_type: "file";
733
- } | {
734
- normalized_path: string;
735
- qualified_item_path: string;
736
- signature_digest: string;
737
- target_type: "item";
738
- source_fact_ref: string;
739
- };
740
- declaration_ref: string;
741
- }>, "many">;
742
- declaration_set_digest: z.ZodString;
743
- }, "strict", z.ZodTypeAny, {
744
- protocol: "context.indexer.structured-declaration-set/v1";
745
- source_identity_inventory_digest: string;
746
- declarations: {
747
- source_ref: string;
748
- evidence_refs: string[];
749
- module_ref: string | null;
750
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
751
- carrier_ref: string;
752
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
753
- target: {
754
- normalized_path: string;
755
- target_type: "directory";
756
- } | {
757
- content_digest: string;
758
- normalized_path: string;
759
- target_type: "file";
760
- } | {
761
- normalized_path: string;
762
- qualified_item_path: string;
763
- signature_digest: string;
764
- target_type: "item";
765
- source_fact_ref: string;
766
- };
767
- declaration_ref: string;
768
- }[];
769
- declaration_set_digest: string;
770
- }, {
771
- protocol: "context.indexer.structured-declaration-set/v1";
772
- source_identity_inventory_digest: string;
773
- declarations: {
774
- source_ref: string;
775
- evidence_refs: string[];
776
- module_ref: string | null;
777
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
778
- carrier_ref: string;
779
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
780
- target: {
781
- normalized_path: string;
782
- target_type: "directory";
783
- } | {
784
- content_digest: string;
785
- normalized_path: string;
786
- target_type: "file";
787
- } | {
788
- normalized_path: string;
789
- qualified_item_path: string;
790
- signature_digest: string;
791
- target_type: "item";
792
- source_fact_ref: string;
793
- };
794
- declaration_ref: string;
795
- }[];
796
- declaration_set_digest: string;
797
- }>>;
798
- structured_claims: z.ZodOptional<z.ZodObject<{
799
- protocol: z.ZodLiteral<"context.indexer.structured-claim-set/v1">;
800
- author_workset_digest: z.ZodString;
801
- logical_unit_ref: z.ZodString;
802
- claims: z.ZodArray<z.ZodObject<{
803
- claim_ref: z.ZodString;
804
- claim_kind: z.ZodEffects<z.ZodString, string, string>;
805
- subject_ref: z.ZodString;
806
- owner: z.ZodObject<{
807
- artifact_id: z.ZodEffects<z.ZodString, string, string>;
808
- section_key: z.ZodEffects<z.ZodString, string, string>;
809
- }, "strict", z.ZodTypeAny, {
810
- section_key: string;
811
- artifact_id: string;
812
- }, {
813
- section_key: string;
814
- artifact_id: string;
815
- }>;
816
- evidence_refs: z.ZodArray<z.ZodString, "many">;
817
- }, "strict", z.ZodTypeAny, {
818
- evidence_refs: string[];
819
- claim_ref: string;
820
- claim_kind: string;
821
- subject_ref: string;
822
- owner: {
823
- section_key: string;
824
- artifact_id: string;
825
- };
826
- }, {
827
- evidence_refs: string[];
828
- claim_ref: string;
829
- claim_kind: string;
830
- subject_ref: string;
831
- owner: {
832
- section_key: string;
833
- artifact_id: string;
834
- };
835
- }>, "many">;
836
- claims_digest: z.ZodString;
837
- }, "strict", z.ZodTypeAny, {
838
- protocol: "context.indexer.structured-claim-set/v1";
839
- logical_unit_ref: string;
840
- author_workset_digest: string;
841
- claims: {
842
- evidence_refs: string[];
843
- claim_ref: string;
844
- claim_kind: string;
845
- subject_ref: string;
846
- owner: {
847
- section_key: string;
848
- artifact_id: string;
849
- };
850
- }[];
851
- claims_digest: string;
852
- }, {
853
- protocol: "context.indexer.structured-claim-set/v1";
854
- logical_unit_ref: string;
855
- author_workset_digest: string;
856
- claims: {
857
- evidence_refs: string[];
858
- claim_ref: string;
859
- claim_kind: string;
860
- subject_ref: string;
861
- owner: {
862
- section_key: string;
863
- artifact_id: string;
864
- };
865
- }[];
866
- claims_digest: string;
867
- }>>;
868
- facts: z.ZodArray<z.ZodObject<{
869
- fact_ref: z.ZodString;
870
- fact_kind: z.ZodEffects<z.ZodString, string, string>;
871
- subject_key: z.ZodObject<{
872
- protocol: z.ZodLiteral<"context.subject-key/v1">;
873
- namespace: z.ZodEffects<z.ZodString, string, string>;
874
- kind: z.ZodEffects<z.ZodString, string, string>;
875
- local_key: z.ZodEffects<z.ZodString, string, string>;
876
- }, "strict", z.ZodTypeAny, {
877
- kind: string;
878
- namespace: string;
879
- protocol: "context.subject-key/v1";
880
- local_key: string;
881
- }, {
882
- kind: string;
883
- namespace: string;
884
- protocol: "context.subject-key/v1";
885
- local_key: string;
886
- }>;
887
- value: z.ZodType<import("./indexerRegistry.js").IndexerJson, z.ZodTypeDef, import("./indexerRegistry.js").IndexerJson>;
888
- evidence_refs: z.ZodArray<z.ZodString, "many">;
889
- }, "strict", z.ZodTypeAny, {
890
- value: import("./indexerRegistry.js").IndexerJson;
891
- fact_ref: string;
892
- fact_kind: string;
893
- subject_key: {
894
- kind: string;
895
- namespace: string;
896
- protocol: "context.subject-key/v1";
897
- local_key: string;
898
- };
899
- evidence_refs: string[];
900
- }, {
901
- value: import("./indexerRegistry.js").IndexerJson;
902
- fact_ref: string;
903
- fact_kind: string;
904
- subject_key: {
905
- kind: string;
906
- namespace: string;
907
- protocol: "context.subject-key/v1";
908
- local_key: string;
909
- };
910
- evidence_refs: string[];
911
- }>, "many">;
912
- evidence_bindings: z.ZodArray<z.ZodObject<{
913
- evidence_ref: z.ZodString;
914
- kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
915
- source_ref: z.ZodString;
916
- module_ref: z.ZodNullable<z.ZodString>;
917
- locator: z.ZodEffects<z.ZodObject<{
918
- path: z.ZodEffects<z.ZodString, string, string>;
919
- start_line: z.ZodNumber;
920
- end_line: z.ZodNumber;
921
- }, "strict", z.ZodTypeAny, {
922
- path: string;
923
- start_line: number;
924
- end_line: number;
925
- }, {
926
- path: string;
927
- start_line: number;
928
- end_line: number;
929
- }>, {
930
- path: string;
931
- start_line: number;
932
- end_line: number;
933
- }, {
934
- path: string;
935
- start_line: number;
936
- end_line: number;
937
- }>;
938
- content_digest: z.ZodString;
939
- coverage_tier: z.ZodEnum<["ast-catalog", "lightweight-evidence"]>;
940
- binding_digest: z.ZodString;
941
- }, "strict", z.ZodTypeAny, {
942
- kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
943
- source_ref: string;
944
- locator: {
945
- path: string;
946
- start_line: number;
947
- end_line: number;
948
- };
949
- content_digest: string;
950
- module_ref: string | null;
951
- coverage_tier: "ast-catalog" | "lightweight-evidence";
952
- evidence_ref: string;
953
- binding_digest: string;
954
- }, {
955
- kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
956
- source_ref: string;
957
- locator: {
958
- path: string;
959
- start_line: number;
960
- end_line: number;
961
- };
962
- content_digest: string;
963
- module_ref: string | null;
964
- coverage_tier: "ast-catalog" | "lightweight-evidence";
965
- evidence_ref: string;
966
- binding_digest: string;
967
- }>, "many">;
968
422
  artifacts: z.ZodArray<z.ZodDiscriminatedUnion<"representation", [z.ZodObject<{
969
423
  representation: z.ZodLiteral<"template">;
970
424
  template_id: z.ZodEffects<z.ZodString, string, string>;
971
425
  variables: z.ZodRecord<z.ZodString, z.ZodObject<{
972
426
  value: z.ZodType<import("./indexerRegistry.js").IndexerJson, z.ZodTypeDef, import("./indexerRegistry.js").IndexerJson>;
973
- fact_refs: z.ZodArray<z.ZodString, "many">;
974
- evidence_refs: z.ZodArray<z.ZodString, "many">;
427
+ references: z.ZodArray<z.ZodObject<{
428
+ source_ref: z.ZodString;
429
+ locator: z.ZodEffects<z.ZodObject<{
430
+ path: z.ZodEffects<z.ZodString, string, string>;
431
+ start_line: z.ZodNumber;
432
+ end_line: z.ZodNumber;
433
+ }, "strict", z.ZodTypeAny, {
434
+ path: string;
435
+ start_line: number;
436
+ end_line: number;
437
+ }, {
438
+ path: string;
439
+ start_line: number;
440
+ end_line: number;
441
+ }>, {
442
+ path: string;
443
+ start_line: number;
444
+ end_line: number;
445
+ }, {
446
+ path: string;
447
+ start_line: number;
448
+ end_line: number;
449
+ }>;
450
+ content_digest: z.ZodString;
451
+ }, "strict", z.ZodTypeAny, {
452
+ source_ref: string;
453
+ locator: {
454
+ path: string;
455
+ start_line: number;
456
+ end_line: number;
457
+ };
458
+ content_digest: string;
459
+ }, {
460
+ source_ref: string;
461
+ locator: {
462
+ path: string;
463
+ start_line: number;
464
+ end_line: number;
465
+ };
466
+ content_digest: string;
467
+ }>, "many">;
975
468
  }, "strict", z.ZodTypeAny, {
976
469
  value: import("./indexerRegistry.js").IndexerJson;
977
- evidence_refs: string[];
978
- fact_refs: string[];
470
+ references: {
471
+ source_ref: string;
472
+ locator: {
473
+ path: string;
474
+ start_line: number;
475
+ end_line: number;
476
+ };
477
+ content_digest: string;
478
+ }[];
979
479
  }, {
980
480
  value: import("./indexerRegistry.js").IndexerJson;
981
- evidence_refs: string[];
982
- fact_refs: string[];
481
+ references: {
482
+ source_ref: string;
483
+ locator: {
484
+ path: string;
485
+ start_line: number;
486
+ end_line: number;
487
+ };
488
+ content_digest: string;
489
+ }[];
983
490
  }>>;
984
491
  section_projections: z.ZodArray<z.ZodObject<{
985
492
  section_key: z.ZodEffects<z.ZodString, string, string>;
@@ -1009,8 +516,15 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1009
516
  template_id: string;
1010
517
  variables: Record<string, {
1011
518
  value: import("./indexerRegistry.js").IndexerJson;
1012
- evidence_refs: string[];
1013
- fact_refs: string[];
519
+ references: {
520
+ source_ref: string;
521
+ locator: {
522
+ path: string;
523
+ start_line: number;
524
+ end_line: number;
525
+ };
526
+ content_digest: string;
527
+ }[];
1014
528
  }>;
1015
529
  section_projections: {
1016
530
  section_key: string;
@@ -1027,8 +541,15 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1027
541
  template_id: string;
1028
542
  variables: Record<string, {
1029
543
  value: import("./indexerRegistry.js").IndexerJson;
1030
- evidence_refs: string[];
1031
- fact_refs: string[];
544
+ references: {
545
+ source_ref: string;
546
+ locator: {
547
+ path: string;
548
+ start_line: number;
549
+ end_line: number;
550
+ };
551
+ content_digest: string;
552
+ }[];
1032
553
  }>;
1033
554
  section_projections: {
1034
555
  section_key: string;
@@ -1049,122 +570,175 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1049
570
  reader_goal: z.ZodEffects<z.ZodString, string, string>;
1050
571
  artifact_kind: z.ZodEffects<z.ZodString, string, string>;
1051
572
  } & {
1052
- blocks: z.ZodArray<z.ZodDiscriminatedUnion<"layer", [z.ZodObject<{
1053
- block_id: z.ZodEffects<z.ZodString, string, string>;
1054
- layer: z.ZodLiteral<"deterministic-block">;
1055
- renderer: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
1056
- fact_refs: z.ZodArray<z.ZodString, "many">;
1057
- }, "strict", z.ZodTypeAny, {
1058
- block_id: string;
1059
- layer: "deterministic-block";
1060
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1061
- fact_refs: string[];
1062
- }, {
1063
- block_id: string;
1064
- layer: "deterministic-block";
1065
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1066
- fact_refs: string[];
1067
- }>, z.ZodObject<{
573
+ blocks: z.ZodArray<z.ZodObject<{
1068
574
  block_id: z.ZodEffects<z.ZodString, string, string>;
1069
575
  layer: z.ZodLiteral<"semantic-prose">;
1070
576
  markdown: z.ZodString;
1071
- evidence_refs: z.ZodArray<z.ZodString, "many">;
577
+ references: z.ZodArray<z.ZodObject<{
578
+ source_ref: z.ZodString;
579
+ locator: z.ZodEffects<z.ZodObject<{
580
+ path: z.ZodEffects<z.ZodString, string, string>;
581
+ start_line: z.ZodNumber;
582
+ end_line: z.ZodNumber;
583
+ }, "strict", z.ZodTypeAny, {
584
+ path: string;
585
+ start_line: number;
586
+ end_line: number;
587
+ }, {
588
+ path: string;
589
+ start_line: number;
590
+ end_line: number;
591
+ }>, {
592
+ path: string;
593
+ start_line: number;
594
+ end_line: number;
595
+ }, {
596
+ path: string;
597
+ start_line: number;
598
+ end_line: number;
599
+ }>;
600
+ content_digest: z.ZodString;
601
+ }, "strict", z.ZodTypeAny, {
602
+ source_ref: string;
603
+ locator: {
604
+ path: string;
605
+ start_line: number;
606
+ end_line: number;
607
+ };
608
+ content_digest: string;
609
+ }, {
610
+ source_ref: string;
611
+ locator: {
612
+ path: string;
613
+ start_line: number;
614
+ end_line: number;
615
+ };
616
+ content_digest: string;
617
+ }>, "many">;
1072
618
  }, "strict", z.ZodTypeAny, {
1073
- evidence_refs: string[];
619
+ references: {
620
+ source_ref: string;
621
+ locator: {
622
+ path: string;
623
+ start_line: number;
624
+ end_line: number;
625
+ };
626
+ content_digest: string;
627
+ }[];
1074
628
  block_id: string;
1075
629
  layer: "semantic-prose";
1076
630
  markdown: string;
1077
631
  }, {
1078
- evidence_refs: string[];
632
+ references: {
633
+ source_ref: string;
634
+ locator: {
635
+ path: string;
636
+ start_line: number;
637
+ end_line: number;
638
+ };
639
+ content_digest: string;
640
+ }[];
1079
641
  block_id: string;
1080
642
  layer: "semantic-prose";
1081
643
  markdown: string;
1082
- }>]>, "many">;
644
+ }>, "many">;
1083
645
  }, "strict", z.ZodTypeAny, {
1084
646
  section_key: string;
1085
647
  owner_indexer_id: string;
1086
648
  document_kind: string;
1087
649
  reader_goal: string;
1088
650
  artifact_kind: string;
1089
- blocks: ({
1090
- block_id: string;
1091
- layer: "deterministic-block";
1092
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1093
- fact_refs: string[];
1094
- } | {
1095
- evidence_refs: string[];
651
+ blocks: {
652
+ references: {
653
+ source_ref: string;
654
+ locator: {
655
+ path: string;
656
+ start_line: number;
657
+ end_line: number;
658
+ };
659
+ content_digest: string;
660
+ }[];
1096
661
  block_id: string;
1097
662
  layer: "semantic-prose";
1098
663
  markdown: string;
1099
- })[];
664
+ }[];
1100
665
  }, {
1101
666
  section_key: string;
1102
667
  owner_indexer_id: string;
1103
668
  document_kind: string;
1104
669
  reader_goal: string;
1105
670
  artifact_kind: string;
1106
- blocks: ({
1107
- block_id: string;
1108
- layer: "deterministic-block";
1109
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1110
- fact_refs: string[];
1111
- } | {
1112
- evidence_refs: string[];
671
+ blocks: {
672
+ references: {
673
+ source_ref: string;
674
+ locator: {
675
+ path: string;
676
+ start_line: number;
677
+ end_line: number;
678
+ };
679
+ content_digest: string;
680
+ }[];
1113
681
  block_id: string;
1114
682
  layer: "semantic-prose";
1115
683
  markdown: string;
1116
- })[];
684
+ }[];
1117
685
  }>, "many">;
1118
686
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
1119
687
  artifact_kind: z.ZodEffects<z.ZodString, string, string>;
1120
688
  artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
1121
689
  }, "strict", z.ZodTypeAny, {
1122
- artifact_kind: string;
1123
- representation: "sections";
1124
- artifact_id: string;
1125
- artifact_policy_variant: string;
1126
690
  sections: {
1127
691
  section_key: string;
1128
692
  owner_indexer_id: string;
1129
693
  document_kind: string;
1130
694
  reader_goal: string;
1131
695
  artifact_kind: string;
1132
- blocks: ({
1133
- block_id: string;
1134
- layer: "deterministic-block";
1135
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1136
- fact_refs: string[];
1137
- } | {
1138
- evidence_refs: string[];
696
+ blocks: {
697
+ references: {
698
+ source_ref: string;
699
+ locator: {
700
+ path: string;
701
+ start_line: number;
702
+ end_line: number;
703
+ };
704
+ content_digest: string;
705
+ }[];
1139
706
  block_id: string;
1140
707
  layer: "semantic-prose";
1141
708
  markdown: string;
1142
- })[];
709
+ }[];
1143
710
  }[];
1144
- template_id?: string | undefined;
1145
- }, {
1146
711
  artifact_kind: string;
1147
712
  representation: "sections";
1148
713
  artifact_id: string;
1149
714
  artifact_policy_variant: string;
715
+ template_id?: string | undefined;
716
+ }, {
1150
717
  sections: {
1151
718
  section_key: string;
1152
719
  owner_indexer_id: string;
1153
720
  document_kind: string;
1154
721
  reader_goal: string;
1155
722
  artifact_kind: string;
1156
- blocks: ({
1157
- block_id: string;
1158
- layer: "deterministic-block";
1159
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1160
- fact_refs: string[];
1161
- } | {
1162
- evidence_refs: string[];
723
+ blocks: {
724
+ references: {
725
+ source_ref: string;
726
+ locator: {
727
+ path: string;
728
+ start_line: number;
729
+ end_line: number;
730
+ };
731
+ content_digest: string;
732
+ }[];
1163
733
  block_id: string;
1164
734
  layer: "semantic-prose";
1165
735
  markdown: string;
1166
- })[];
736
+ }[];
1167
737
  }[];
738
+ artifact_kind: string;
739
+ representation: "sections";
740
+ artifact_id: string;
741
+ artifact_policy_variant: string;
1168
742
  template_id?: string | undefined;
1169
743
  }>]>, "many">;
1170
744
  artifact_bundle: z.ZodNullable<z.ZodObject<{
@@ -1176,16 +750,13 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1176
750
  artifact_kind: z.ZodEffects<z.ZodString, string, string>;
1177
751
  purpose: z.ZodEnum<["required", "discretionary"]>;
1178
752
  reader_question_refs: z.ZodArray<z.ZodString, "many">;
1179
- evidence_refs: z.ZodArray<z.ZodString, "many">;
1180
753
  }, "strict", z.ZodTypeAny, {
1181
754
  purpose: "required" | "discretionary";
1182
- evidence_refs: string[];
1183
755
  artifact_kind: string;
1184
756
  artifact_id: string;
1185
757
  reader_question_refs: string[];
1186
758
  }, {
1187
759
  purpose: "required" | "discretionary";
1188
- evidence_refs: string[];
1189
760
  artifact_kind: string;
1190
761
  artifact_id: string;
1191
762
  reader_question_refs: string[];
@@ -1194,7 +765,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1194
765
  artifact_kind: z.ZodEffects<z.ZodString, string, string>;
1195
766
  purpose: z.ZodLiteral<"semantic-split">;
1196
767
  reader_question_refs: z.ZodArray<z.ZodString, "many">;
1197
- evidence_refs: z.ZodArray<z.ZodString, "many">;
1198
768
  split_of: z.ZodEffects<z.ZodString, string, string>;
1199
769
  boundary: z.ZodObject<{
1200
770
  axis: z.ZodEffects<z.ZodString, string, string>;
@@ -1211,7 +781,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1211
781
  }>;
1212
782
  }, "strict", z.ZodTypeAny, {
1213
783
  purpose: "semantic-split";
1214
- evidence_refs: string[];
1215
784
  artifact_kind: string;
1216
785
  artifact_id: string;
1217
786
  reader_question_refs: string[];
@@ -1223,7 +792,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1223
792
  };
1224
793
  }, {
1225
794
  purpose: "semantic-split";
1226
- evidence_refs: string[];
1227
795
  artifact_kind: string;
1228
796
  artifact_id: string;
1229
797
  reader_question_refs: string[];
@@ -1243,13 +811,11 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1243
811
  artifact_policy_variant: string;
1244
812
  artifacts: ({
1245
813
  purpose: "required" | "discretionary";
1246
- evidence_refs: string[];
1247
814
  artifact_kind: string;
1248
815
  artifact_id: string;
1249
816
  reader_question_refs: string[];
1250
817
  } | {
1251
818
  purpose: "semantic-split";
1252
- evidence_refs: string[];
1253
819
  artifact_kind: string;
1254
820
  artifact_id: string;
1255
821
  reader_question_refs: string[];
@@ -1269,13 +835,11 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1269
835
  artifact_policy_variant: string;
1270
836
  artifacts: ({
1271
837
  purpose: "required" | "discretionary";
1272
- evidence_refs: string[];
1273
838
  artifact_kind: string;
1274
839
  artifact_id: string;
1275
840
  reader_question_refs: string[];
1276
841
  } | {
1277
842
  purpose: "semantic-split";
1278
- evidence_refs: string[];
1279
843
  artifact_kind: string;
1280
844
  artifact_id: string;
1281
845
  reader_question_refs: string[];
@@ -1299,29 +863,26 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1299
863
  source_hints: z.ZodArray<z.ZodString, "many">;
1300
864
  }, "strict", z.ZodTypeAny, {
1301
865
  requirement_ref: string;
1302
- source_hints: string[];
1303
866
  proposal_ref: string;
1304
867
  question_ref: string;
1305
868
  question_target_key: string;
869
+ source_hints: string[];
1306
870
  }, {
1307
871
  requirement_ref: string;
1308
- source_hints: string[];
1309
872
  proposal_ref: string;
1310
873
  question_ref: string;
1311
874
  question_target_key: string;
875
+ source_hints: string[];
1312
876
  }>, "many">;
1313
877
  question_target_dispositions: z.ZodArray<z.ZodUnion<[z.ZodObject<{
1314
878
  question_target_key: z.ZodString;
1315
879
  state: z.ZodLiteral<"answered">;
1316
- evidence_binding_digest: z.ZodString;
1317
880
  }, "strict", z.ZodTypeAny, {
1318
881
  state: "answered";
1319
882
  question_target_key: string;
1320
- evidence_binding_digest: string;
1321
883
  }, {
1322
884
  state: "answered";
1323
885
  question_target_key: string;
1324
- evidence_binding_digest: string;
1325
886
  }>, z.ZodObject<{
1326
887
  question_target_key: z.ZodString;
1327
888
  state: z.ZodLiteral<"material-gap">;
@@ -1354,18 +915,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1354
915
  source_ref: string;
1355
916
  protocol: "context.indexer.artifact-result/v1";
1356
917
  requirement_ref: string;
1357
- facts: {
1358
- value: import("./indexerRegistry.js").IndexerJson;
1359
- fact_ref: string;
1360
- fact_kind: string;
1361
- subject_key: {
1362
- kind: string;
1363
- namespace: string;
1364
- protocol: "context.subject-key/v1";
1365
- local_key: string;
1366
- };
1367
- evidence_refs: string[];
1368
- }[];
1369
918
  module_ref: string | null;
1370
919
  input_digest: string;
1371
920
  output_digest: string;
@@ -1380,8 +929,15 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1380
929
  template_id: string;
1381
930
  variables: Record<string, {
1382
931
  value: import("./indexerRegistry.js").IndexerJson;
1383
- evidence_refs: string[];
1384
- fact_refs: string[];
932
+ references: {
933
+ source_ref: string;
934
+ locator: {
935
+ path: string;
936
+ start_line: number;
937
+ end_line: number;
938
+ };
939
+ content_digest: string;
940
+ }[];
1385
941
  }>;
1386
942
  section_projections: {
1387
943
  section_key: string;
@@ -1393,28 +949,31 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1393
949
  artifact_id: string;
1394
950
  artifact_policy_variant: string;
1395
951
  } | {
1396
- artifact_kind: string;
1397
- representation: "sections";
1398
- artifact_id: string;
1399
- artifact_policy_variant: string;
1400
952
  sections: {
1401
953
  section_key: string;
1402
954
  owner_indexer_id: string;
1403
955
  document_kind: string;
1404
956
  reader_goal: string;
1405
957
  artifact_kind: string;
1406
- blocks: ({
1407
- block_id: string;
1408
- layer: "deterministic-block";
1409
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1410
- fact_refs: string[];
1411
- } | {
1412
- evidence_refs: string[];
958
+ blocks: {
959
+ references: {
960
+ source_ref: string;
961
+ locator: {
962
+ path: string;
963
+ start_line: number;
964
+ end_line: number;
965
+ };
966
+ content_digest: string;
967
+ }[];
1413
968
  block_id: string;
1414
969
  layer: "semantic-prose";
1415
970
  markdown: string;
1416
- })[];
971
+ }[];
1417
972
  }[];
973
+ artifact_kind: string;
974
+ representation: "sections";
975
+ artifact_id: string;
976
+ artifact_policy_variant: string;
1418
977
  template_id?: string | undefined;
1419
978
  })[];
1420
979
  indexer_id: string;
@@ -1428,45 +987,8 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1428
987
  customization_fingerprint: string | null;
1429
988
  source_role: string;
1430
989
  logical_unit: {
1431
- subject_key: {
1432
- kind: string;
1433
- namespace: string;
1434
- protocol: "context.subject-key/v1";
1435
- local_key: string;
1436
- };
1437
990
  logical_unit_ref: string;
1438
991
  group_key: string;
1439
- target_resolution_dispositions: ({
1440
- target_node_ref: string;
1441
- disposition: "reuse-existing";
1442
- query_ref: string;
1443
- target_subject_key: {
1444
- kind: string;
1445
- namespace: string;
1446
- protocol: "context.subject-key/v1";
1447
- local_key: string;
1448
- };
1449
- } | {
1450
- subject_key: {
1451
- kind: string;
1452
- namespace: string;
1453
- protocol: "context.subject-key/v1";
1454
- local_key: string;
1455
- };
1456
- evidence_refs: string[];
1457
- disposition: "create-independent";
1458
- query_ref: string;
1459
- reason_code: string;
1460
- } | {
1461
- disposition: "request-material";
1462
- query_ref: string;
1463
- missing_facts: string[];
1464
- source_hints: string[];
1465
- } | {
1466
- disposition: "unsupported";
1467
- query_ref: string;
1468
- missing_capabilities: string[];
1469
- })[];
1470
992
  };
1471
993
  capability_group_evidence: {
1472
994
  protocol: "context.indexer.capability-group-evidence/v1";
@@ -1500,7 +1022,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1500
1022
  dispositions: ({
1501
1023
  member_id: string;
1502
1024
  section_evidence: {
1503
- evidence_refs: string[];
1504
1025
  section_key: string;
1505
1026
  artifact_id: string;
1506
1027
  }[];
@@ -1514,19 +1035,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1514
1035
  inventory_disposition: "owned";
1515
1036
  projection_disposition: "capability-group";
1516
1037
  } | {
1517
- fact_refs: string[];
1518
1038
  member_id: string;
1519
1039
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1520
1040
  inventory_disposition: "owned";
1521
1041
  projection_disposition: "catalog-only";
1522
1042
  } | {
1523
- evidence_refs: string[];
1524
1043
  member_id: string;
1525
1044
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1526
1045
  inventory_disposition: "owned";
1527
1046
  projection_disposition: "boundary-only";
1528
1047
  } | {
1529
- evidence_refs: string[];
1530
1048
  member_id: string;
1531
1049
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1532
1050
  inventory_disposition: "excluded-with-reason";
@@ -1544,32 +1062,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1544
1062
  })[];
1545
1063
  disposition_digest: string;
1546
1064
  };
1547
- evidence_bindings: {
1548
- kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
1549
- source_ref: string;
1550
- locator: {
1551
- path: string;
1552
- start_line: number;
1553
- end_line: number;
1554
- };
1555
- content_digest: string;
1556
- module_ref: string | null;
1557
- coverage_tier: "ast-catalog" | "lightweight-evidence";
1558
- evidence_ref: string;
1559
- binding_digest: string;
1560
- }[];
1561
1065
  artifact_bundle: {
1562
1066
  protocol: "context.indexer.artifact-bundle/v1";
1563
1067
  artifact_policy_variant: string;
1564
1068
  artifacts: ({
1565
1069
  purpose: "required" | "discretionary";
1566
- evidence_refs: string[];
1567
1070
  artifact_kind: string;
1568
1071
  artifact_id: string;
1569
1072
  reader_question_refs: string[];
1570
1073
  } | {
1571
1074
  purpose: "semantic-split";
1572
- evidence_refs: string[];
1573
1075
  artifact_kind: string;
1574
1076
  artifact_id: string;
1575
1077
  reader_question_refs: string[];
@@ -1587,80 +1089,23 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1587
1089
  } | null;
1588
1090
  material_question_proposals: {
1589
1091
  requirement_ref: string;
1590
- source_hints: string[];
1591
1092
  proposal_ref: string;
1592
1093
  question_ref: string;
1593
1094
  question_target_key: string;
1095
+ source_hints: string[];
1594
1096
  }[];
1595
1097
  question_target_dispositions: ({
1596
1098
  state: "answered";
1597
1099
  question_target_key: string;
1598
- evidence_binding_digest: string;
1599
1100
  } | {
1600
1101
  state: "material-gap";
1601
1102
  material_question_proposal_ref: string;
1602
1103
  question_target_key: string;
1603
1104
  })[];
1604
- structured_declarations?: {
1605
- protocol: "context.indexer.structured-declaration-set/v1";
1606
- source_identity_inventory_digest: string;
1607
- declarations: {
1608
- source_ref: string;
1609
- evidence_refs: string[];
1610
- module_ref: string | null;
1611
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
1612
- carrier_ref: string;
1613
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
1614
- target: {
1615
- normalized_path: string;
1616
- target_type: "directory";
1617
- } | {
1618
- content_digest: string;
1619
- normalized_path: string;
1620
- target_type: "file";
1621
- } | {
1622
- normalized_path: string;
1623
- qualified_item_path: string;
1624
- signature_digest: string;
1625
- target_type: "item";
1626
- source_fact_ref: string;
1627
- };
1628
- declaration_ref: string;
1629
- }[];
1630
- declaration_set_digest: string;
1631
- } | undefined;
1632
- structured_claims?: {
1633
- protocol: "context.indexer.structured-claim-set/v1";
1634
- logical_unit_ref: string;
1635
- author_workset_digest: string;
1636
- claims: {
1637
- evidence_refs: string[];
1638
- claim_ref: string;
1639
- claim_kind: string;
1640
- subject_ref: string;
1641
- owner: {
1642
- section_key: string;
1643
- artifact_id: string;
1644
- };
1645
- }[];
1646
- claims_digest: string;
1647
- } | undefined;
1648
1105
  }, {
1649
1106
  source_ref: string;
1650
1107
  protocol: "context.indexer.artifact-result/v1";
1651
1108
  requirement_ref: string;
1652
- facts: {
1653
- value: import("./indexerRegistry.js").IndexerJson;
1654
- fact_ref: string;
1655
- fact_kind: string;
1656
- subject_key: {
1657
- kind: string;
1658
- namespace: string;
1659
- protocol: "context.subject-key/v1";
1660
- local_key: string;
1661
- };
1662
- evidence_refs: string[];
1663
- }[];
1664
1109
  module_ref: string | null;
1665
1110
  input_digest: string;
1666
1111
  output_digest: string;
@@ -1675,8 +1120,15 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1675
1120
  template_id: string;
1676
1121
  variables: Record<string, {
1677
1122
  value: import("./indexerRegistry.js").IndexerJson;
1678
- evidence_refs: string[];
1679
- fact_refs: string[];
1123
+ references: {
1124
+ source_ref: string;
1125
+ locator: {
1126
+ path: string;
1127
+ start_line: number;
1128
+ end_line: number;
1129
+ };
1130
+ content_digest: string;
1131
+ }[];
1680
1132
  }>;
1681
1133
  section_projections: {
1682
1134
  section_key: string;
@@ -1688,28 +1140,31 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1688
1140
  artifact_id: string;
1689
1141
  artifact_policy_variant: string;
1690
1142
  } | {
1691
- artifact_kind: string;
1692
- representation: "sections";
1693
- artifact_id: string;
1694
- artifact_policy_variant: string;
1695
1143
  sections: {
1696
1144
  section_key: string;
1697
1145
  owner_indexer_id: string;
1698
1146
  document_kind: string;
1699
1147
  reader_goal: string;
1700
1148
  artifact_kind: string;
1701
- blocks: ({
1702
- block_id: string;
1703
- layer: "deterministic-block";
1704
- renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
1705
- fact_refs: string[];
1706
- } | {
1707
- evidence_refs: string[];
1149
+ blocks: {
1150
+ references: {
1151
+ source_ref: string;
1152
+ locator: {
1153
+ path: string;
1154
+ start_line: number;
1155
+ end_line: number;
1156
+ };
1157
+ content_digest: string;
1158
+ }[];
1708
1159
  block_id: string;
1709
1160
  layer: "semantic-prose";
1710
1161
  markdown: string;
1711
- })[];
1162
+ }[];
1712
1163
  }[];
1164
+ artifact_kind: string;
1165
+ representation: "sections";
1166
+ artifact_id: string;
1167
+ artifact_policy_variant: string;
1713
1168
  template_id?: string | undefined;
1714
1169
  })[];
1715
1170
  indexer_id: string;
@@ -1723,45 +1178,8 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1723
1178
  customization_fingerprint: string | null;
1724
1179
  source_role: string;
1725
1180
  logical_unit: {
1726
- subject_key: {
1727
- kind: string;
1728
- namespace: string;
1729
- protocol: "context.subject-key/v1";
1730
- local_key: string;
1731
- };
1732
1181
  logical_unit_ref: string;
1733
1182
  group_key: string;
1734
- target_resolution_dispositions: ({
1735
- target_node_ref: string;
1736
- disposition: "reuse-existing";
1737
- query_ref: string;
1738
- target_subject_key: {
1739
- kind: string;
1740
- namespace: string;
1741
- protocol: "context.subject-key/v1";
1742
- local_key: string;
1743
- };
1744
- } | {
1745
- subject_key: {
1746
- kind: string;
1747
- namespace: string;
1748
- protocol: "context.subject-key/v1";
1749
- local_key: string;
1750
- };
1751
- evidence_refs: string[];
1752
- disposition: "create-independent";
1753
- query_ref: string;
1754
- reason_code: string;
1755
- } | {
1756
- disposition: "request-material";
1757
- query_ref: string;
1758
- missing_facts: string[];
1759
- source_hints: string[];
1760
- } | {
1761
- disposition: "unsupported";
1762
- query_ref: string;
1763
- missing_capabilities: string[];
1764
- })[];
1765
1183
  };
1766
1184
  capability_group_evidence: {
1767
1185
  protocol: "context.indexer.capability-group-evidence/v1";
@@ -1795,7 +1213,6 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1795
1213
  dispositions: ({
1796
1214
  member_id: string;
1797
1215
  section_evidence: {
1798
- evidence_refs: string[];
1799
1216
  section_key: string;
1800
1217
  artifact_id: string;
1801
1218
  }[];
@@ -1809,19 +1226,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1809
1226
  inventory_disposition: "owned";
1810
1227
  projection_disposition: "capability-group";
1811
1228
  } | {
1812
- fact_refs: string[];
1813
1229
  member_id: string;
1814
1230
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1815
1231
  inventory_disposition: "owned";
1816
1232
  projection_disposition: "catalog-only";
1817
1233
  } | {
1818
- evidence_refs: string[];
1819
1234
  member_id: string;
1820
1235
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1821
1236
  inventory_disposition: "owned";
1822
1237
  projection_disposition: "boundary-only";
1823
1238
  } | {
1824
- evidence_refs: string[];
1825
1239
  member_id: string;
1826
1240
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
1827
1241
  inventory_disposition: "excluded-with-reason";
@@ -1839,32 +1253,16 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1839
1253
  })[];
1840
1254
  disposition_digest: string;
1841
1255
  };
1842
- evidence_bindings: {
1843
- kind: "code" | "contract" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
1844
- source_ref: string;
1845
- locator: {
1846
- path: string;
1847
- start_line: number;
1848
- end_line: number;
1849
- };
1850
- content_digest: string;
1851
- module_ref: string | null;
1852
- coverage_tier: "ast-catalog" | "lightweight-evidence";
1853
- evidence_ref: string;
1854
- binding_digest: string;
1855
- }[];
1856
1256
  artifact_bundle: {
1857
1257
  protocol: "context.indexer.artifact-bundle/v1";
1858
1258
  artifact_policy_variant: string;
1859
1259
  artifacts: ({
1860
1260
  purpose: "required" | "discretionary";
1861
- evidence_refs: string[];
1862
1261
  artifact_kind: string;
1863
1262
  artifact_id: string;
1864
1263
  reader_question_refs: string[];
1865
1264
  } | {
1866
1265
  purpose: "semantic-split";
1867
- evidence_refs: string[];
1868
1266
  artifact_kind: string;
1869
1267
  artifact_id: string;
1870
1268
  reader_question_refs: string[];
@@ -1882,64 +1280,19 @@ export declare const indexerArtifactResultSchema: z.ZodObject<{
1882
1280
  } | null;
1883
1281
  material_question_proposals: {
1884
1282
  requirement_ref: string;
1885
- source_hints: string[];
1886
1283
  proposal_ref: string;
1887
1284
  question_ref: string;
1888
1285
  question_target_key: string;
1286
+ source_hints: string[];
1889
1287
  }[];
1890
1288
  question_target_dispositions: ({
1891
1289
  state: "answered";
1892
1290
  question_target_key: string;
1893
- evidence_binding_digest: string;
1894
1291
  } | {
1895
1292
  state: "material-gap";
1896
1293
  material_question_proposal_ref: string;
1897
1294
  question_target_key: string;
1898
1295
  })[];
1899
- structured_declarations?: {
1900
- protocol: "context.indexer.structured-declaration-set/v1";
1901
- source_identity_inventory_digest: string;
1902
- declarations: {
1903
- source_ref: string;
1904
- evidence_refs: string[];
1905
- module_ref: string | null;
1906
- carrier_kind: "manifest" | "indexer-result" | "catalog" | "section-evidence";
1907
- carrier_ref: string;
1908
- declaration_kind: "locator" | "handler" | "method" | "entry" | "directory" | "store";
1909
- target: {
1910
- normalized_path: string;
1911
- target_type: "directory";
1912
- } | {
1913
- content_digest: string;
1914
- normalized_path: string;
1915
- target_type: "file";
1916
- } | {
1917
- normalized_path: string;
1918
- qualified_item_path: string;
1919
- signature_digest: string;
1920
- target_type: "item";
1921
- source_fact_ref: string;
1922
- };
1923
- declaration_ref: string;
1924
- }[];
1925
- declaration_set_digest: string;
1926
- } | undefined;
1927
- structured_claims?: {
1928
- protocol: "context.indexer.structured-claim-set/v1";
1929
- logical_unit_ref: string;
1930
- author_workset_digest: string;
1931
- claims: {
1932
- evidence_refs: string[];
1933
- claim_ref: string;
1934
- claim_kind: string;
1935
- subject_ref: string;
1936
- owner: {
1937
- section_key: string;
1938
- artifact_id: string;
1939
- };
1940
- }[];
1941
- claims_digest: string;
1942
- } | undefined;
1943
1296
  }>;
1944
1297
  export type IndexerArtifactResult = z.infer<typeof indexerArtifactResultSchema>;
1945
1298
  export type { IndexerArtifactSectionProjection };
@@ -1967,7 +1320,6 @@ export declare function validateIndexerArtifactResult(input: {
1967
1320
  customization_fingerprint: string | null;
1968
1321
  };
1969
1322
  expected_input_digest: string;
1970
- expected_subject_key: unknown;
1971
1323
  allowed_question_targets: readonly {
1972
1324
  question_target_key: string;
1973
1325
  question_ref: string;