@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
@@ -1,238 +0,0 @@
1
- import { z } from "zod";
2
- export declare const indexerAuditBindingSchema: z.ZodObject<{
3
- requirement_set_digest: z.ZodString;
4
- registry_digest: z.ZodString;
5
- inventory_digest: z.ZodString;
6
- layout_digest: z.ZodNullable<z.ZodString>;
7
- candidate_set_digest: z.ZodNullable<z.ZodString>;
8
- effective_revision_digest: z.ZodNullable<z.ZodString>;
9
- }, "strict", z.ZodTypeAny, {
10
- inventory_digest: string;
11
- requirement_set_digest: string;
12
- registry_digest: string;
13
- candidate_set_digest: string | null;
14
- layout_digest: string | null;
15
- effective_revision_digest: string | null;
16
- }, {
17
- inventory_digest: string;
18
- requirement_set_digest: string;
19
- registry_digest: string;
20
- candidate_set_digest: string | null;
21
- layout_digest: string | null;
22
- effective_revision_digest: string | null;
23
- }>;
24
- export declare const indexerAuditReportSchema: z.ZodObject<{
25
- protocol: z.ZodLiteral<"context.indexer.audit/v1">;
26
- stage: z.ZodEnum<["precompile", "postcompile"]>;
27
- binding: z.ZodObject<{
28
- requirement_set_digest: z.ZodString;
29
- registry_digest: z.ZodString;
30
- inventory_digest: z.ZodString;
31
- layout_digest: z.ZodNullable<z.ZodString>;
32
- candidate_set_digest: z.ZodNullable<z.ZodString>;
33
- effective_revision_digest: z.ZodNullable<z.ZodString>;
34
- }, "strict", z.ZodTypeAny, {
35
- inventory_digest: string;
36
- requirement_set_digest: string;
37
- registry_digest: string;
38
- candidate_set_digest: string | null;
39
- layout_digest: string | null;
40
- effective_revision_digest: string | null;
41
- }, {
42
- inventory_digest: string;
43
- requirement_set_digest: string;
44
- registry_digest: string;
45
- candidate_set_digest: string | null;
46
- layout_digest: string | null;
47
- effective_revision_digest: string | null;
48
- }>;
49
- baseline: z.ZodObject<{
50
- clear: z.ZodBoolean;
51
- failed_check_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
52
- finding_digests: z.ZodArray<z.ZodString, "many">;
53
- }, "strict", z.ZodTypeAny, {
54
- clear: boolean;
55
- failed_check_ids: string[];
56
- finding_digests: string[];
57
- }, {
58
- clear: boolean;
59
- failed_check_ids: string[];
60
- finding_digests: string[];
61
- }>;
62
- profile: z.ZodObject<{
63
- state: z.ZodEnum<["not-applicable", "passed", "revision-required", "human-guidance-required"]>;
64
- failed_metric_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
65
- report_digest: z.ZodNullable<z.ZodString>;
66
- }, "strict", z.ZodTypeAny, {
67
- state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
68
- report_digest: string | null;
69
- failed_metric_ids: string[];
70
- }, {
71
- state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
72
- report_digest: string | null;
73
- failed_metric_ids: string[];
74
- }>;
75
- report_digest: z.ZodString;
76
- }, "strict", z.ZodTypeAny, {
77
- protocol: "context.indexer.audit/v1";
78
- profile: {
79
- state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
80
- report_digest: string | null;
81
- failed_metric_ids: string[];
82
- };
83
- report_digest: string;
84
- stage: "precompile" | "postcompile";
85
- binding: {
86
- inventory_digest: string;
87
- requirement_set_digest: string;
88
- registry_digest: string;
89
- candidate_set_digest: string | null;
90
- layout_digest: string | null;
91
- effective_revision_digest: string | null;
92
- };
93
- baseline: {
94
- clear: boolean;
95
- failed_check_ids: string[];
96
- finding_digests: string[];
97
- };
98
- }, {
99
- protocol: "context.indexer.audit/v1";
100
- profile: {
101
- state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
102
- report_digest: string | null;
103
- failed_metric_ids: string[];
104
- };
105
- report_digest: string;
106
- stage: "precompile" | "postcompile";
107
- binding: {
108
- inventory_digest: string;
109
- requirement_set_digest: string;
110
- registry_digest: string;
111
- candidate_set_digest: string | null;
112
- layout_digest: string | null;
113
- effective_revision_digest: string | null;
114
- };
115
- baseline: {
116
- clear: boolean;
117
- failed_check_ids: string[];
118
- finding_digests: string[];
119
- };
120
- }>;
121
- export declare const indexerCandidateReviewBindingSchema: z.ZodObject<{
122
- requirement_set_digest: z.ZodString;
123
- registry_digest: z.ZodString;
124
- inventory_digest: z.ZodString;
125
- layout_digest: z.ZodString;
126
- candidate_set_digest: z.ZodString;
127
- effective_revision_digest: z.ZodString;
128
- }, "strict", z.ZodTypeAny, {
129
- inventory_digest: string;
130
- requirement_set_digest: string;
131
- registry_digest: string;
132
- candidate_set_digest: string;
133
- layout_digest: string;
134
- effective_revision_digest: string;
135
- }, {
136
- inventory_digest: string;
137
- requirement_set_digest: string;
138
- registry_digest: string;
139
- candidate_set_digest: string;
140
- layout_digest: string;
141
- effective_revision_digest: string;
142
- }>;
143
- export declare const indexerCandidateReviewReadinessInputSchema: z.ZodObject<{
144
- protocol: z.ZodLiteral<"context.indexer.candidate-review-readiness-input/v1">;
145
- binding: z.ZodObject<{
146
- requirement_set_digest: z.ZodString;
147
- registry_digest: z.ZodString;
148
- inventory_digest: z.ZodString;
149
- layout_digest: z.ZodString;
150
- candidate_set_digest: z.ZodString;
151
- effective_revision_digest: z.ZodString;
152
- }, "strict", z.ZodTypeAny, {
153
- inventory_digest: string;
154
- requirement_set_digest: string;
155
- registry_digest: string;
156
- candidate_set_digest: string;
157
- layout_digest: string;
158
- effective_revision_digest: string;
159
- }, {
160
- inventory_digest: string;
161
- requirement_set_digest: string;
162
- registry_digest: string;
163
- candidate_set_digest: string;
164
- layout_digest: string;
165
- effective_revision_digest: string;
166
- }>;
167
- precompile_audit_report_digest: z.ZodString;
168
- postcompile_audit_report_digest: z.ZodString;
169
- profile_override_receipt_digest: z.ZodNullable<z.ZodString>;
170
- input_digest: z.ZodString;
171
- }, "strict", z.ZodTypeAny, {
172
- protocol: "context.indexer.candidate-review-readiness-input/v1";
173
- input_digest: string;
174
- binding: {
175
- inventory_digest: string;
176
- requirement_set_digest: string;
177
- registry_digest: string;
178
- candidate_set_digest: string;
179
- layout_digest: string;
180
- effective_revision_digest: string;
181
- };
182
- precompile_audit_report_digest: string;
183
- postcompile_audit_report_digest: string;
184
- profile_override_receipt_digest: string | null;
185
- }, {
186
- protocol: "context.indexer.candidate-review-readiness-input/v1";
187
- input_digest: string;
188
- binding: {
189
- inventory_digest: string;
190
- requirement_set_digest: string;
191
- registry_digest: string;
192
- candidate_set_digest: string;
193
- layout_digest: string;
194
- effective_revision_digest: string;
195
- };
196
- precompile_audit_report_digest: string;
197
- postcompile_audit_report_digest: string;
198
- profile_override_receipt_digest: string | null;
199
- }>;
200
- export type IndexerAuditBinding = z.infer<typeof indexerAuditBindingSchema>;
201
- export type IndexerAuditReport = z.infer<typeof indexerAuditReportSchema>;
202
- export type IndexerCandidateReviewBinding = z.infer<typeof indexerCandidateReviewBindingSchema>;
203
- export type IndexerCandidateReviewReadinessInput = z.infer<typeof indexerCandidateReviewReadinessInputSchema>;
204
- export declare function validateIndexerAuditReport(value: unknown): IndexerAuditReport;
205
- export declare function buildIndexerAuditReport(input: Omit<IndexerAuditReport, "report_digest">): IndexerAuditReport;
206
- export declare function buildIndexerCandidateReviewReadinessInput(input: {
207
- binding: IndexerCandidateReviewBinding;
208
- precompile_audit_report_digest: string;
209
- postcompile_audit_report_digest: string;
210
- profile_override_receipt_digest?: string | null;
211
- }): IndexerCandidateReviewReadinessInput;
212
- export declare function validateIndexerCandidateReviewReadinessInput(value: unknown): IndexerCandidateReviewReadinessInput;
213
- export declare function evaluateIndexerCandidateReviewReadiness(input: {
214
- request: unknown;
215
- precompile_report: unknown;
216
- postcompile_report: unknown;
217
- }): {
218
- graph_outcome: "failed" | "completed" | "blocked";
219
- result_digest: string;
220
- protocol: "context.indexer.candidate-review-readiness-result/v1";
221
- state: "baseline-blocked" | "profile-blocked" | "ready";
222
- binding: {
223
- inventory_digest: string;
224
- requirement_set_digest: string;
225
- registry_digest: string;
226
- candidate_set_digest: string;
227
- layout_digest: string;
228
- effective_revision_digest: string;
229
- };
230
- precompile_audit_report_digest: string;
231
- postcompile_audit_report_digest: string;
232
- baseline_failed_check_ids: string[];
233
- profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
234
- profile_failed_metric_ids: string[];
235
- profile_override_receipt_digest: string | null;
236
- profile_override_applied: boolean;
237
- review_binding_digest: string;
238
- };