@c4a/context 0.7.0 → 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 -422
  6. package/docs/guides/agent-guide.md +94 -523
  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 -136
  10. package/docs/reference/indexer-provider-protocol.md +60 -138
  11. package/docs/reference/package-templates.md +2 -3
  12. package/docs/reference/project-api.md +52 -985
  13. package/index.d.ts +12 -10
  14. package/index.js +12749 -15335
  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 +221 -255
  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 +206 -16
  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/{indexerOverlayTrust.d.ts → indexerContractOverlay.d.ts} +23 -569
  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 +497 -293
  55. package/indexerOverlayQuestionApplyProposal.d.ts +1030 -622
  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 -281
  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
@@ -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
- };