@c4a/context 0.6.18 → 0.7.0

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 (130) hide show
  1. package/README.md +5 -5
  2. package/README.zh-CN.md +5 -5
  3. package/codeIndexPlan.d.ts +84 -0
  4. package/contracts.d.ts +2 -1
  5. package/docs/README.md +7 -0
  6. package/docs/README.zh-CN.md +5 -0
  7. package/docs/getting-started.md +12 -12
  8. package/docs/guides/agent-guide.md +18 -9
  9. package/docs/guides/code-indexer-skill-authoring.md +124 -0
  10. package/docs/guides/indexer-provider-and-customization.md +140 -0
  11. package/docs/guides/lark-resources.md +7 -0
  12. package/docs/guides/markdown-indexer-skill-authoring.md +118 -0
  13. package/docs/guides/package-outputs.md +3 -3
  14. package/docs/reference/code-extractors.md +7 -6
  15. package/docs/reference/indexer-provider-protocol.md +819 -0
  16. package/docs/reference/package-templates.md +18 -10
  17. package/docs/reference/project-api.md +49 -24
  18. package/index.d.ts +48 -2
  19. package/index.js +28239 -3948
  20. package/indexerAgentStepProtocol.d.ts +9391 -0
  21. package/indexerArtifactDependencies.d.ts +689 -0
  22. package/indexerArtifactPolicy.d.ts +335 -0
  23. package/indexerArtifactResult.d.ts +2010 -0
  24. package/indexerAuditFacts.d.ts +66 -0
  25. package/indexerAuditOverrideReadiness.d.ts +27 -0
  26. package/indexerAuditProtocol.d.ts +238 -0
  27. package/indexerAuditRevision.d.ts +726 -0
  28. package/indexerAuditRevisionActions.d.ts +236 -0
  29. package/indexerAuthoringFixture.d.ts +152 -0
  30. package/indexerBaseQuestionAmendment.d.ts +2403 -0
  31. package/indexerBenchmark.d.ts +1062 -0
  32. package/indexerCandidateCompile.d.ts +801 -0
  33. package/indexerCapabilityGroupEvidence.d.ts +129 -0
  34. package/indexerCatalogFallback.d.ts +1262 -0
  35. package/indexerCollectionMapping.d.ts +75 -0
  36. package/indexerContentLayers.d.ts +137 -0
  37. package/indexerControlledInvocation.d.ts +512 -0
  38. package/indexerControlledProgram.d.ts +12535 -0
  39. package/indexerCoreExports.d.ts +21 -0
  40. package/indexerCustomizationDraft.d.ts +13800 -0
  41. package/indexerCustomizationLadder.d.ts +103 -0
  42. package/indexerDependencyView.d.ts +1610 -0
  43. package/indexerEvidenceAdapterResult.d.ts +504 -0
  44. package/indexerExampleDecision.d.ts +1606 -0
  45. package/indexerExampleIdentity.d.ts +132 -0
  46. package/indexerExampleIdentityAudit.d.ts +70 -0
  47. package/indexerExampleLinkageAudit.d.ts +80 -0
  48. package/indexerGeneratedAuthoringAudit.d.ts +208 -0
  49. package/indexerIncrementalImpact.d.ts +221 -0
  50. package/indexerInventoryDisposition.d.ts +443 -0
  51. package/indexerLayerComposition.d.ts +1652 -0
  52. package/indexerLayoutChange.d.ts +329 -0
  53. package/indexerLayoutProposalSet.d.ts +447 -0
  54. package/indexerLayoutResolver.d.ts +342 -0
  55. package/indexerLayoutTransition.d.ts +247 -0
  56. package/indexerLifecycle.d.ts +53 -0
  57. package/indexerMainLifecycle.d.ts +258 -0
  58. package/indexerMainRunLedger.d.ts +888 -0
  59. package/indexerMainRunProtocol.d.ts +6471 -0
  60. package/indexerMainWorkset.d.ts +2141 -0
  61. package/indexerMaterialAnswer.d.ts +738 -0
  62. package/indexerMaterialAnswerActualization.d.ts +91 -0
  63. package/indexerMaterialAnswerExecutionPlan.d.ts +2887 -0
  64. package/indexerMaterialAnswerFlow.d.ts +63 -0
  65. package/indexerMaterialAnswerLayout.d.ts +76 -0
  66. package/indexerMaterialAnswerReview.d.ts +217 -0
  67. package/indexerMaterialAnswerReviewRoute.d.ts +6145 -0
  68. package/indexerMaterialAnswerRunLedger.d.ts +918 -0
  69. package/indexerMaterialAnswerRunProtocol.d.ts +1253 -0
  70. package/indexerMaterialGapLedger.d.ts +3111 -0
  71. package/indexerMaterialQuestionExclusion.d.ts +129 -0
  72. package/indexerMaterialQuestionWorkset.d.ts +508 -0
  73. package/indexerNavigationArtifactGraph.d.ts +5 -0
  74. package/indexerNavigationArtifactPlan.d.ts +39 -0
  75. package/indexerOverlayQuestionAmendment.d.ts +2551 -0
  76. package/indexerOverlayQuestionApplyProposal.d.ts +4697 -0
  77. package/indexerOverlayTrust.d.ts +1425 -0
  78. package/indexerParserCoordinate.d.ts +222 -0
  79. package/indexerParserFactView.d.ts +503 -0
  80. package/indexerPartitionConvergence.d.ts +496 -0
  81. package/indexerPartitionPlan.d.ts +919 -0
  82. package/indexerPartitionStrategyResolution.d.ts +594 -0
  83. package/indexerPhysicalArtifactAudit.d.ts +247 -0
  84. package/indexerPhysicalArtifactManifest.d.ts +449 -0
  85. package/indexerPlannedMaterialAnswer.d.ts +116 -0
  86. package/indexerPostAuthorComposition.d.ts +2000 -0
  87. package/indexerPostAuthorRunLedger.d.ts +1972 -0
  88. package/indexerPrimaryProjection.d.ts +262 -0
  89. package/indexerProfileContract.d.ts +3034 -0
  90. package/indexerProfileMetricAudit.d.ts +218 -0
  91. package/indexerProgramExecutionAuthorization.d.ts +227 -0
  92. package/indexerProgramRunProtocol.d.ts +7642 -0
  93. package/indexerProjectProposal.d.ts +2807 -0
  94. package/indexerProjectedArtifactFanOutAudit.d.ts +159 -0
  95. package/indexerProjectedArtifactPlan.d.ts +217 -0
  96. package/indexerProtocolCommon.d.ts +29 -0
  97. package/indexerProvider.d.ts +2573 -0
  98. package/indexerProviderComposition.d.ts +1357 -0
  99. package/indexerProviderContractReferences.d.ts +13 -0
  100. package/indexerProviderProfileResolution.d.ts +20 -0
  101. package/indexerProviderResolution.d.ts +752 -0
  102. package/indexerProviderResolutionAction.d.ts +678 -0
  103. package/indexerProviderRouting.d.ts +3909 -0
  104. package/indexerProviderSelectionProposal.d.ts +3311 -0
  105. package/indexerQuestionAuthority.d.ts +419 -0
  106. package/indexerReaderTargetInventory.d.ts +161 -0
  107. package/indexerReferenceOnlyAudit.d.ts +90 -0
  108. package/indexerRegistry.d.ts +3019 -0
  109. package/indexerRequirementComparison.d.ts +44 -0
  110. package/indexerRequirementConfirmation.d.ts +1193 -0
  111. package/indexerRequirementLifecycle.d.ts +3314 -0
  112. package/indexerRestrictedSelector.d.ts +63 -0
  113. package/indexerResultReconciliation.d.ts +6844 -0
  114. package/indexerResultReconciliationRun.d.ts +15 -0
  115. package/indexerRunEnvelope.d.ts +384 -0
  116. package/indexerRunProtocolCommon.d.ts +21 -0
  117. package/indexerSharedArtifactFingerprint.d.ts +33 -0
  118. package/indexerStructuredDeclaration.d.ts +513 -0
  119. package/indexerSubjectCatalog.d.ts +230 -0
  120. package/indexerSubjectIdentity.d.ts +19 -0
  121. package/indexerSubjectKeyAuthority.d.ts +785 -0
  122. package/indexerTemplateRendering.d.ts +485 -0
  123. package/indexerToolSnapshot.d.ts +431 -0
  124. package/indexerWorksetRead.d.ts +287 -0
  125. package/package.json +1 -1
  126. package/phases.d.ts +11 -9
  127. package/templates/package-templates/kb/AGENTS.md +1 -1
  128. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +1 -1
  129. package/templates/package-templates.zh-CN/kb/AGENTS.md +1 -1
  130. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +1 -1
@@ -0,0 +1,66 @@
1
+ import { z } from "zod";
2
+ export declare const indexerAuditFactsSchema: z.ZodObject<{
3
+ protocol: z.ZodLiteral<"context.indexer.audit-facts/v1">;
4
+ audit: z.ZodObject<{
5
+ baseline_clear: z.ZodBoolean;
6
+ profile_state: z.ZodEnum<["not-applicable", "passed", "revision-required", "human-guidance-required"]>;
7
+ problem_lineage_id: z.ZodNullable<z.ZodString>;
8
+ profile_attempt_count: z.ZodNumber;
9
+ profile_report_digest: z.ZodNullable<z.ZodString>;
10
+ profile_override_eligible: z.ZodBoolean;
11
+ profile_override_receipt_digest: z.ZodNullable<z.ZodString>;
12
+ }, "strict", z.ZodTypeAny, {
13
+ profile_override_receipt_digest: string | null;
14
+ profile_report_digest: string | null;
15
+ baseline_clear: boolean;
16
+ profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
17
+ problem_lineage_id: string | null;
18
+ profile_attempt_count: number;
19
+ profile_override_eligible: boolean;
20
+ }, {
21
+ profile_override_receipt_digest: string | null;
22
+ profile_report_digest: string | null;
23
+ baseline_clear: boolean;
24
+ profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
25
+ problem_lineage_id: string | null;
26
+ profile_attempt_count: number;
27
+ profile_override_eligible: boolean;
28
+ }>;
29
+ facts_digest: z.ZodString;
30
+ }, "strict", z.ZodTypeAny, {
31
+ protocol: "context.indexer.audit-facts/v1";
32
+ audit: {
33
+ profile_override_receipt_digest: string | null;
34
+ profile_report_digest: string | null;
35
+ baseline_clear: boolean;
36
+ profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
37
+ problem_lineage_id: string | null;
38
+ profile_attempt_count: number;
39
+ profile_override_eligible: boolean;
40
+ };
41
+ facts_digest: string;
42
+ }, {
43
+ protocol: "context.indexer.audit-facts/v1";
44
+ audit: {
45
+ profile_override_receipt_digest: string | null;
46
+ profile_report_digest: string | null;
47
+ baseline_clear: boolean;
48
+ profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
49
+ problem_lineage_id: string | null;
50
+ profile_attempt_count: number;
51
+ profile_override_eligible: boolean;
52
+ };
53
+ facts_digest: string;
54
+ }>;
55
+ export type IndexerAuditFacts = z.infer<typeof indexerAuditFactsSchema>;
56
+ interface IndexerAuditFactsInput {
57
+ precompile_report: unknown;
58
+ postcompile_report: unknown;
59
+ lineage?: unknown;
60
+ ledger?: unknown;
61
+ failure_report?: unknown;
62
+ override_receipt?: unknown;
63
+ }
64
+ export declare function buildIndexerAuditFacts(input: IndexerAuditFactsInput): IndexerAuditFacts;
65
+ export declare function validateIndexerAuditFacts(value: unknown): IndexerAuditFacts;
66
+ export {};
@@ -0,0 +1,27 @@
1
+ export declare function evaluateIndexerCandidateReviewReadinessWithOverride(input: {
2
+ request: unknown;
3
+ precompile_report: unknown;
4
+ postcompile_report: unknown;
5
+ profile_override_receipt: unknown;
6
+ }): {
7
+ graph_outcome: "completed";
8
+ result_digest: string;
9
+ protocol: "context.indexer.candidate-review-readiness-result/v1";
10
+ state: "ready";
11
+ binding: {
12
+ inventory_digest: string;
13
+ requirement_set_digest: string;
14
+ registry_digest: string;
15
+ candidate_set_digest: string;
16
+ layout_digest: string;
17
+ effective_revision_digest: string;
18
+ };
19
+ precompile_audit_report_digest: string;
20
+ postcompile_audit_report_digest: string;
21
+ baseline_failed_check_ids: string[];
22
+ profile_state: "passed" | "not-applicable" | "revision-required" | "human-guidance-required";
23
+ profile_failed_metric_ids: string[];
24
+ profile_override_receipt_digest: string | null;
25
+ profile_override_applied: boolean;
26
+ review_binding_digest: string;
27
+ };
@@ -0,0 +1,238 @@
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
+ };