@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
@@ -0,0 +1,48 @@
1
+ import { type IndexerEvidenceAdapterFact } from "./indexerEvidenceAdapterResult.js";
2
+ export interface IndexerEvidenceAdapterExecution {
3
+ capability: string;
4
+ authority_domain: string;
5
+ source_ref: string;
6
+ module_ref: string | null;
7
+ result: unknown;
8
+ }
9
+ export interface IndexerEvidenceAdapterAuthorityMerge {
10
+ protocol: "context.indexer.evidence-adapter-authority-merge/v1";
11
+ execution_plan_digest: string;
12
+ result_digests: string[];
13
+ primary_owners: Array<{
14
+ source_ref: string;
15
+ module_ref: string | null;
16
+ normalized_path: string;
17
+ authority_domain: string;
18
+ capability: string;
19
+ adapter_id: string;
20
+ coverage_tier: string;
21
+ disposition: "analyzed" | "unsupported" | "excluded";
22
+ }>;
23
+ facts: Array<IndexerEvidenceAdapterFact & {
24
+ authority_domain: string;
25
+ capability: string;
26
+ adapter_id: string;
27
+ precedence: number;
28
+ }>;
29
+ conflicts: Array<{
30
+ authority_domain: string;
31
+ fact_ref: string;
32
+ winner_adapter_id: string;
33
+ shadowed_adapter_ids: string[];
34
+ }>;
35
+ blockers: Array<{
36
+ source_ref: string;
37
+ normalized_path: string;
38
+ authority_domain: string;
39
+ capability: string;
40
+ disposition: "unsupported" | "excluded";
41
+ }>;
42
+ toolchain_digest: string;
43
+ merge_digest: string;
44
+ }
45
+ export declare function mergeIndexerEvidenceAdapterExecutions(input: {
46
+ execution_plan: unknown;
47
+ executions: readonly IndexerEvidenceAdapterExecution[];
48
+ }): IndexerEvidenceAdapterAuthorityMerge;
@@ -9,16 +9,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
9
9
  digest: z.ZodString;
10
10
  }, "strict", z.ZodTypeAny, {
11
11
  id: string;
12
- export: string;
13
12
  digest: string;
14
13
  package: string;
15
14
  version: string;
15
+ export: string;
16
16
  }, {
17
17
  id: string;
18
- export: string;
19
18
  digest: string;
20
19
  package: string;
21
20
  version: string;
21
+ export: string;
22
22
  }>;
23
23
  authorized_scope: z.ZodObject<{
24
24
  source_ref: z.ZodString;
@@ -76,8 +76,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
76
76
  qualified_item_path: string;
77
77
  signature_digest: string;
78
78
  };
79
- payload_digest: string;
80
79
  fact_ref: string;
80
+ payload_digest: string;
81
81
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
82
82
  }, {
83
83
  kind: string;
@@ -88,8 +88,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
88
88
  qualified_item_path: string;
89
89
  signature_digest: string;
90
90
  };
91
- payload_digest: string;
92
91
  fact_ref: string;
92
+ payload_digest: string;
93
93
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
94
94
  }>, "many">;
95
95
  }, "strict", z.ZodTypeAny, {
@@ -104,8 +104,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
104
104
  qualified_item_path: string;
105
105
  signature_digest: string;
106
106
  };
107
- payload_digest: string;
108
107
  fact_ref: string;
108
+ payload_digest: string;
109
109
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
110
110
  }[];
111
111
  module_ref: string | null;
@@ -125,8 +125,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
125
125
  qualified_item_path: string;
126
126
  signature_digest: string;
127
127
  };
128
- payload_digest: string;
129
128
  fact_ref: string;
129
+ payload_digest: string;
130
130
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
131
131
  }[];
132
132
  module_ref: string | null;
@@ -146,8 +146,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
146
146
  qualified_item_path: string;
147
147
  signature_digest: string;
148
148
  };
149
- payload_digest: string;
150
149
  fact_ref: string;
150
+ payload_digest: string;
151
151
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
152
152
  }[];
153
153
  module_ref: string | null;
@@ -167,8 +167,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
167
167
  qualified_item_path: string;
168
168
  signature_digest: string;
169
169
  };
170
- payload_digest: string;
171
170
  fact_ref: string;
171
+ payload_digest: string;
172
172
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
173
173
  }[];
174
174
  module_ref: string | null;
@@ -203,37 +203,37 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
203
203
  input_digest: z.ZodString;
204
204
  output_digest: z.ZodString;
205
205
  }, "strict", z.ZodTypeAny, {
206
- export: string;
207
206
  digest: string;
208
207
  package: string;
209
208
  version: string;
209
+ export: string;
210
210
  step: string;
211
211
  capabilities: string[];
212
212
  input_digest: string;
213
213
  output_digest: string;
214
214
  }, {
215
- export: string;
216
215
  digest: string;
217
216
  package: string;
218
217
  version: string;
218
+ export: string;
219
219
  step: string;
220
220
  capabilities: string[];
221
221
  input_digest: string;
222
222
  output_digest: string;
223
223
  }>, {
224
- export: string;
225
224
  digest: string;
226
225
  package: string;
227
226
  version: string;
227
+ export: string;
228
228
  step: string;
229
229
  capabilities: string[];
230
230
  input_digest: string;
231
231
  output_digest: string;
232
232
  }, {
233
- export: string;
234
233
  digest: string;
235
234
  package: string;
236
235
  version: string;
236
+ export: string;
237
237
  step: string;
238
238
  capabilities: string[];
239
239
  input_digest: string;
@@ -241,14 +241,6 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
241
241
  }>, "many">;
242
242
  output_digest: z.ZodString;
243
243
  }, "strict", z.ZodTypeAny, {
244
- adapter: {
245
- id: string;
246
- export: string;
247
- digest: string;
248
- package: string;
249
- version: string;
250
- };
251
- protocol: "context.indexer.evidence-adapter-result/v1";
252
244
  files: {
253
245
  source_ref: string;
254
246
  role: "enricher" | "primary-owner";
@@ -261,8 +253,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
261
253
  qualified_item_path: string;
262
254
  signature_digest: string;
263
255
  };
264
- payload_digest: string;
265
256
  fact_ref: string;
257
+ payload_digest: string;
266
258
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
267
259
  }[];
268
260
  module_ref: string | null;
@@ -271,8 +263,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
271
263
  coverage_tier: "ast-catalog" | "lightweight-evidence";
272
264
  disposition: "analyzed" | "unsupported" | "excluded";
273
265
  }[];
266
+ protocol: "context.indexer.evidence-adapter-result/v1";
274
267
  input_digest: string;
275
268
  output_digest: string;
269
+ adapter: {
270
+ id: string;
271
+ digest: string;
272
+ package: string;
273
+ version: string;
274
+ export: string;
275
+ };
276
276
  authorized_scope: {
277
277
  source_ref: string;
278
278
  module_refs: string[];
@@ -286,24 +286,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
286
286
  fact_ref?: string | undefined;
287
287
  }[];
288
288
  toolchain: {
289
- export: string;
290
289
  digest: string;
291
290
  package: string;
292
291
  version: string;
292
+ export: string;
293
293
  step: string;
294
294
  capabilities: string[];
295
295
  input_digest: string;
296
296
  output_digest: string;
297
297
  }[];
298
298
  }, {
299
- adapter: {
300
- id: string;
301
- export: string;
302
- digest: string;
303
- package: string;
304
- version: string;
305
- };
306
- protocol: "context.indexer.evidence-adapter-result/v1";
307
299
  files: {
308
300
  source_ref: string;
309
301
  role: "enricher" | "primary-owner";
@@ -316,8 +308,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
316
308
  qualified_item_path: string;
317
309
  signature_digest: string;
318
310
  };
319
- payload_digest: string;
320
311
  fact_ref: string;
312
+ payload_digest: string;
321
313
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
322
314
  }[];
323
315
  module_ref: string | null;
@@ -326,8 +318,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
326
318
  coverage_tier: "ast-catalog" | "lightweight-evidence";
327
319
  disposition: "analyzed" | "unsupported" | "excluded";
328
320
  }[];
321
+ protocol: "context.indexer.evidence-adapter-result/v1";
329
322
  input_digest: string;
330
323
  output_digest: string;
324
+ adapter: {
325
+ id: string;
326
+ digest: string;
327
+ package: string;
328
+ version: string;
329
+ export: string;
330
+ };
331
331
  authorized_scope: {
332
332
  source_ref: string;
333
333
  module_refs: string[];
@@ -341,24 +341,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
341
341
  fact_ref?: string | undefined;
342
342
  }[];
343
343
  toolchain: {
344
- export: string;
345
344
  digest: string;
346
345
  package: string;
347
346
  version: string;
347
+ export: string;
348
348
  step: string;
349
349
  capabilities: string[];
350
350
  input_digest: string;
351
351
  output_digest: string;
352
352
  }[];
353
353
  }>, {
354
- adapter: {
355
- id: string;
356
- export: string;
357
- digest: string;
358
- package: string;
359
- version: string;
360
- };
361
- protocol: "context.indexer.evidence-adapter-result/v1";
362
354
  files: {
363
355
  source_ref: string;
364
356
  role: "enricher" | "primary-owner";
@@ -371,8 +363,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
371
363
  qualified_item_path: string;
372
364
  signature_digest: string;
373
365
  };
374
- payload_digest: string;
375
366
  fact_ref: string;
367
+ payload_digest: string;
376
368
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
377
369
  }[];
378
370
  module_ref: string | null;
@@ -381,8 +373,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
381
373
  coverage_tier: "ast-catalog" | "lightweight-evidence";
382
374
  disposition: "analyzed" | "unsupported" | "excluded";
383
375
  }[];
376
+ protocol: "context.indexer.evidence-adapter-result/v1";
384
377
  input_digest: string;
385
378
  output_digest: string;
379
+ adapter: {
380
+ id: string;
381
+ digest: string;
382
+ package: string;
383
+ version: string;
384
+ export: string;
385
+ };
386
386
  authorized_scope: {
387
387
  source_ref: string;
388
388
  module_refs: string[];
@@ -396,24 +396,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
396
396
  fact_ref?: string | undefined;
397
397
  }[];
398
398
  toolchain: {
399
- export: string;
400
399
  digest: string;
401
400
  package: string;
402
401
  version: string;
402
+ export: string;
403
403
  step: string;
404
404
  capabilities: string[];
405
405
  input_digest: string;
406
406
  output_digest: string;
407
407
  }[];
408
408
  }, {
409
- adapter: {
410
- id: string;
411
- export: string;
412
- digest: string;
413
- package: string;
414
- version: string;
415
- };
416
- protocol: "context.indexer.evidence-adapter-result/v1";
417
409
  files: {
418
410
  source_ref: string;
419
411
  role: "enricher" | "primary-owner";
@@ -426,8 +418,8 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
426
418
  qualified_item_path: string;
427
419
  signature_digest: string;
428
420
  };
429
- payload_digest: string;
430
421
  fact_ref: string;
422
+ payload_digest: string;
431
423
  denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
432
424
  }[];
433
425
  module_ref: string | null;
@@ -436,8 +428,16 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
436
428
  coverage_tier: "ast-catalog" | "lightweight-evidence";
437
429
  disposition: "analyzed" | "unsupported" | "excluded";
438
430
  }[];
431
+ protocol: "context.indexer.evidence-adapter-result/v1";
439
432
  input_digest: string;
440
433
  output_digest: string;
434
+ adapter: {
435
+ id: string;
436
+ digest: string;
437
+ package: string;
438
+ version: string;
439
+ export: string;
440
+ };
441
441
  authorized_scope: {
442
442
  source_ref: string;
443
443
  module_refs: string[];
@@ -451,10 +451,10 @@ export declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObjec
451
451
  fact_ref?: string | undefined;
452
452
  }[];
453
453
  toolchain: {
454
- export: string;
455
454
  digest: string;
456
455
  package: string;
457
456
  version: string;
457
+ export: string;
458
458
  step: string;
459
459
  capabilities: string[];
460
460
  input_digest: string;