@c4a/context 0.7.1 → 0.7.5

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 (119) hide show
  1. package/README.md +67 -171
  2. package/README.zh-CN.md +53 -130
  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 +104 -518
  7. package/docs/guides/code-indexer-skill-authoring.md +38 -13
  8. package/docs/guides/indexer-provider-and-customization.md +32 -20
  9. package/docs/guides/markdown-indexer-skill-authoring.md +22 -13
  10. package/docs/reference/code-extractors.md +29 -121
  11. package/docs/reference/indexer-provider-protocol.md +43 -110
  12. package/docs/reference/package-templates.md +2 -3
  13. package/docs/reference/project-api.md +52 -986
  14. package/index.d.ts +10 -8
  15. package/index.js +13132 -15249
  16. package/indexerAgentStepProtocol.d.ts +1326 -8429
  17. package/indexerArtifact.d.ts +225 -0
  18. package/indexerArtifactDependencies.d.ts +43 -39
  19. package/indexerArtifactResult.d.ts +219 -252
  20. package/indexerAuthorizedWorksetView.d.ts +368 -0
  21. package/indexerBaseQuestionAmendment.d.ts +484 -280
  22. package/indexerBenchmark.d.ts +16 -16
  23. package/indexerCandidateCompile.d.ts +66 -60
  24. package/indexerCapabilityGroupEvidence.d.ts +6 -6
  25. package/indexerCatalogFallback.d.ts +122 -128
  26. package/indexerCollectionMapping.d.ts +13 -13
  27. package/indexerCompositionFactDependencies.d.ts +16 -0
  28. package/indexerContentLayers.d.ts +8 -8
  29. package/indexerContractOverlay.d.ts +10 -10
  30. package/indexerControlledInvocation.d.ts +12 -12
  31. package/indexerControlledProgram.d.ts +2467 -2797
  32. package/indexerCoreExports.d.ts +6 -6
  33. package/indexerCustomizationDraft.d.ts +3315 -2091
  34. package/indexerCustomizationLadder.d.ts +2 -2
  35. package/indexerDependencyView.d.ts +108 -108
  36. package/indexerEffectiveArtifact.d.ts +1134 -0
  37. package/indexerEvidenceAdapterAuthorityMerge.d.ts +48 -0
  38. package/indexerEvidenceAdapterResult.d.ts +52 -52
  39. package/indexerExampleDecision.d.ts +128 -128
  40. package/indexerExampleIdentity.d.ts +6 -6
  41. package/indexerGeneratedAuthoringAudit.d.ts +18 -18
  42. package/indexerIncrementalImpact.d.ts +16 -16
  43. package/indexerInspectorWorksetProjection.d.ts +6 -0
  44. package/indexerInventoryDisposition.d.ts +70 -70
  45. package/indexerLayerComposition.d.ts +2139 -373
  46. package/indexerLayoutChange.d.ts +10 -10
  47. package/indexerLayoutProposalSet.d.ts +71 -66
  48. package/indexerLayoutResolver.d.ts +53 -48
  49. package/indexerLayoutTransition.d.ts +0 -50
  50. package/indexerLifecycle.d.ts +0 -13
  51. package/indexerMainLifecycle.d.ts +10 -0
  52. package/indexerMainRunLedger.d.ts +142 -11
  53. package/indexerMainRunProtocol.d.ts +1406 -785
  54. package/indexerMainWorkset.d.ts +460 -206
  55. package/indexerMaterialGapLedger.d.ts +13 -2904
  56. package/indexerOverlayQuestionAmendment.d.ts +491 -287
  57. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  58. package/indexerParserCapabilityCatalog.d.ts +136 -0
  59. package/indexerParserCoordinate.d.ts +16 -16
  60. package/indexerParserDependencyIntent.d.ts +22 -0
  61. package/indexerParserExecutionPlan.d.ts +388 -0
  62. package/indexerParserFactView.d.ts +42 -22
  63. package/indexerPartitionConvergence.d.ts +0 -3
  64. package/indexerPartitionInventory.d.ts +2 -0
  65. package/indexerPartitionPlan.d.ts +101 -99
  66. package/indexerPhysicalArtifactManifest.d.ts +8 -8
  67. package/indexerPostAuthorComposition.d.ts +116 -1156
  68. package/indexerPostAuthorRunLedger.d.ts +1434 -280
  69. package/indexerPrimaryProjection.d.ts +10 -10
  70. package/indexerPrimaryResultView.d.ts +435 -0
  71. package/indexerProfileContract.d.ts +181 -181
  72. package/indexerProgramExecutionAuthorization.d.ts +12 -12
  73. package/indexerProgramRunProtocol.d.ts +2141 -2749
  74. package/indexerProjectProposal.d.ts +496 -292
  75. package/indexerProjectedArtifactFanOutAudit.d.ts +0 -3
  76. package/indexerProtocolCommon.d.ts +4 -1
  77. package/indexerProvider.d.ts +134 -218
  78. package/indexerProviderComposition.d.ts +53 -53
  79. package/indexerProviderResolution.d.ts +12 -12
  80. package/indexerProviderResolutionAction.d.ts +14 -14
  81. package/indexerProviderRouting.d.ts +923 -515
  82. package/indexerProviderSelectionProposal.d.ts +893 -485
  83. package/indexerQuestionAuthority.d.ts +46 -47
  84. package/indexerReaderTargetInventory.d.ts +8 -8
  85. package/indexerRegistry.d.ts +765 -357
  86. package/indexerRequirementConfirmation.d.ts +98 -98
  87. package/indexerRequirementLifecycle.d.ts +224 -224
  88. package/indexerResultReconciliation.d.ts +204 -5919
  89. package/indexerResultReconciliationRun.d.ts +0 -1
  90. package/indexerRunEnvelope.d.ts +20 -20
  91. package/indexerSemanticInput.d.ts +5794 -0
  92. package/indexerStructuredDeclaration.d.ts +57 -53
  93. package/indexerSubjectCatalog.d.ts +14 -14
  94. package/indexerSubjectIdentity.d.ts +2 -2
  95. package/indexerSubjectKeyAuthority.d.ts +31 -30
  96. package/indexerTemplateRendering.d.ts +64 -64
  97. package/indexerToolSnapshot.d.ts +8 -8
  98. package/package.json +1 -1
  99. package/phases.d.ts +3 -183
  100. package/codeIndexPlan.d.ts +0 -158
  101. package/indexerAuditFacts.d.ts +0 -66
  102. package/indexerAuditOverrideReadiness.d.ts +0 -27
  103. package/indexerAuditProtocol.d.ts +0 -238
  104. package/indexerAuditRevision.d.ts +0 -726
  105. package/indexerAuditRevisionActions.d.ts +0 -236
  106. package/indexerMaterialAnswer.d.ts +0 -738
  107. package/indexerMaterialAnswerActualization.d.ts +0 -91
  108. package/indexerMaterialAnswerExecutionPlan.d.ts +0 -2887
  109. package/indexerMaterialAnswerFlow.d.ts +0 -63
  110. package/indexerMaterialAnswerLayout.d.ts +0 -76
  111. package/indexerMaterialAnswerReview.d.ts +0 -217
  112. package/indexerMaterialAnswerReviewRoute.d.ts +0 -6145
  113. package/indexerMaterialAnswerRunLedger.d.ts +0 -918
  114. package/indexerMaterialAnswerRunProtocol.d.ts +0 -1253
  115. package/indexerMaterialQuestionExclusion.d.ts +0 -129
  116. package/indexerMaterialQuestionWorkset.d.ts +0 -508
  117. package/indexerPlannedMaterialAnswer.d.ts +0 -116
  118. package/indexerProfileMetricAudit.d.ts +0 -218
  119. 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;