@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
@@ -7,7 +7,6 @@ export declare function reconcileIndexerResults(input: {
7
7
  allowed_selector_fact_paths: ReadonlySet<string>;
8
8
  author_results: readonly unknown[];
9
9
  registered_material_sources: readonly unknown[];
10
- retained_material_gap_ledger?: unknown;
11
10
  }): IndexerCoverageCompletionReport;
12
11
  export declare function validateIndexerCoverageCompletionReport(input: {
13
12
  report: unknown;
@@ -2,9 +2,9 @@ import { z } from "zod";
2
2
  import type { IndexerMainWorkset } from "./indexerMainWorkset.js";
3
3
  import { type IndexerRunFinalAuthority } from "./indexerRunProtocolCommon.js";
4
4
  export declare const indexerRunEnvironmentSchema: z.ZodObject<{
5
- protocol: z.ZodLiteral<"context.indexer.run-environment/v1">;
5
+ protocol: z.ZodLiteral<"context.indexer.run-environment/v2">;
6
6
  source_snapshot_digest: z.ZodString;
7
- parser_dependency_fingerprint: z.ZodString;
7
+ source_dependency_fingerprint: z.ZodString;
8
8
  source_role: z.ZodEffects<z.ZodString, string, string>;
9
9
  source_precedence_digest: z.ZodString;
10
10
  metric_set_digest: z.ZodString;
@@ -26,14 +26,14 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
26
26
  ref: z.ZodString;
27
27
  digest: z.ZodString;
28
28
  }, "strict", z.ZodTypeAny, {
29
- kind: string;
30
29
  ref: string;
30
+ kind: string;
31
31
  digest: string;
32
32
  layer_ref: string;
33
33
  phase: "primary" | "pre-authority";
34
34
  }, {
35
- kind: string;
36
35
  ref: string;
36
+ kind: string;
37
37
  digest: string;
38
38
  layer_ref: string;
39
39
  phase: "primary" | "pre-authority";
@@ -76,8 +76,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
76
76
  config_digest: string;
77
77
  cli_contract_digest: string;
78
78
  resources: {
79
- kind: string;
80
79
  ref: string;
80
+ kind: string;
81
81
  digest: string;
82
82
  layer_ref: string;
83
83
  phase: "primary" | "pre-authority";
@@ -103,8 +103,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
103
103
  config_digest: string;
104
104
  cli_contract_digest: string;
105
105
  resources: {
106
- kind: string;
107
106
  ref: string;
107
+ kind: string;
108
108
  digest: string;
109
109
  layer_ref: string;
110
110
  phase: "primary" | "pre-authority";
@@ -130,8 +130,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
130
130
  config_digest: string;
131
131
  cli_contract_digest: string;
132
132
  resources: {
133
- kind: string;
134
133
  ref: string;
134
+ kind: string;
135
135
  digest: string;
136
136
  layer_ref: string;
137
137
  phase: "primary" | "pre-authority";
@@ -157,8 +157,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
157
157
  config_digest: string;
158
158
  cli_contract_digest: string;
159
159
  resources: {
160
- kind: string;
161
160
  ref: string;
161
+ kind: string;
162
162
  digest: string;
163
163
  layer_ref: string;
164
164
  phase: "primary" | "pre-authority";
@@ -175,10 +175,10 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
175
175
  } & {
176
176
  environment_digest: z.ZodString;
177
177
  }, "strict", z.ZodTypeAny, {
178
- protocol: "context.indexer.run-environment/v1";
178
+ protocol: "context.indexer.run-environment/v2";
179
179
  source_role: string;
180
180
  source_snapshot_digest: string;
181
- parser_dependency_fingerprint: string;
181
+ source_dependency_fingerprint: string;
182
182
  source_precedence_digest: string;
183
183
  metric_set_digest: string;
184
184
  dependency_view_digest: string | null;
@@ -195,8 +195,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
195
195
  config_digest: string;
196
196
  cli_contract_digest: string;
197
197
  resources: {
198
- kind: string;
199
198
  ref: string;
199
+ kind: string;
200
200
  digest: string;
201
201
  layer_ref: string;
202
202
  phase: "primary" | "pre-authority";
@@ -212,10 +212,10 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
212
212
  };
213
213
  environment_digest: string;
214
214
  }, {
215
- protocol: "context.indexer.run-environment/v1";
215
+ protocol: "context.indexer.run-environment/v2";
216
216
  source_role: string;
217
217
  source_snapshot_digest: string;
218
- parser_dependency_fingerprint: string;
218
+ source_dependency_fingerprint: string;
219
219
  source_precedence_digest: string;
220
220
  metric_set_digest: string;
221
221
  dependency_view_digest: string | null;
@@ -232,8 +232,8 @@ export declare const indexerRunEnvironmentSchema: z.ZodObject<{
232
232
  config_digest: string;
233
233
  cli_contract_digest: string;
234
234
  resources: {
235
- kind: string;
236
235
  ref: string;
236
+ kind: string;
237
237
  digest: string;
238
238
  layer_ref: string;
239
239
  phase: "primary" | "pre-authority";
@@ -254,7 +254,7 @@ export declare function indexerRunEnvironmentDigest(value: Omit<IndexerRunEnviro
254
254
  export declare function buildIndexerRunEnvironment(input: Omit<IndexerRunEnvironment, "protocol" | "environment_digest">): IndexerRunEnvironment;
255
255
  export declare function validateIndexerRunEnvironment(value: unknown): IndexerRunEnvironment;
256
256
  export declare const indexerRunEnvelopeSchema: z.ZodObject<{
257
- protocol: z.ZodLiteral<"context.indexer.run-envelope/v1">;
257
+ protocol: z.ZodLiteral<"context.indexer.run-envelope/v2">;
258
258
  stage: z.ZodEnum<["partition", "author"]>;
259
259
  workset_digest: z.ZodString;
260
260
  execution_request_digest: z.ZodString;
@@ -295,7 +295,7 @@ export declare const indexerRunEnvelopeSchema: z.ZodObject<{
295
295
  template_fingerprint: string;
296
296
  fingerprint_digest: string;
297
297
  }>;
298
- parser_dependency_fingerprint: z.ZodString;
298
+ source_dependency_fingerprint: z.ZodString;
299
299
  source_role: z.ZodEffects<z.ZodString, string, string>;
300
300
  source_precedence_digest: z.ZodString;
301
301
  metric_set_digest: z.ZodString;
@@ -305,7 +305,7 @@ export declare const indexerRunEnvelopeSchema: z.ZodObject<{
305
305
  envelope_digest: z.ZodString;
306
306
  }, "strict", z.ZodTypeAny, {
307
307
  source_ref: string;
308
- protocol: "context.indexer.run-envelope/v1";
308
+ protocol: "context.indexer.run-envelope/v2";
309
309
  workset_digest: string;
310
310
  module_ref: string | null;
311
311
  indexer_id: string;
@@ -327,7 +327,7 @@ export declare const indexerRunEnvelopeSchema: z.ZodObject<{
327
327
  fingerprint_digest: string;
328
328
  };
329
329
  source_snapshot_digest: string;
330
- parser_dependency_fingerprint: string;
330
+ source_dependency_fingerprint: string;
331
331
  source_precedence_digest: string;
332
332
  metric_set_digest: string;
333
333
  dependency_view_digest: string | null;
@@ -339,7 +339,7 @@ export declare const indexerRunEnvelopeSchema: z.ZodObject<{
339
339
  envelope_digest: string;
340
340
  }, {
341
341
  source_ref: string;
342
- protocol: "context.indexer.run-envelope/v1";
342
+ protocol: "context.indexer.run-envelope/v2";
343
343
  workset_digest: string;
344
344
  module_ref: string | null;
345
345
  indexer_id: string;
@@ -361,7 +361,7 @@ export declare const indexerRunEnvelopeSchema: z.ZodObject<{
361
361
  fingerprint_digest: string;
362
362
  };
363
363
  source_snapshot_digest: string;
364
- parser_dependency_fingerprint: string;
364
+ source_dependency_fingerprint: string;
365
365
  source_precedence_digest: string;
366
366
  metric_set_digest: string;
367
367
  dependency_view_digest: string | null;