@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,236 +0,0 @@
1
- import { z } from "zod";
2
- export declare const indexerProfileRevisionRecordInputSchema: z.ZodObject<{
3
- protocol: z.ZodLiteral<"context.indexer.profile-revision-record-input/v1">;
4
- lineage: z.ZodObject<{
5
- protocol: z.ZodLiteral<"context.indexer.profile-problem-lineage/v1">;
6
- requirement_lineage_id: z.ZodString;
7
- source_material_epoch: z.ZodString;
8
- unit_ref: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
9
- problem_class: z.ZodEffects<z.ZodString, string, string>;
10
- lineage_id: z.ZodString;
11
- }, "strict", z.ZodTypeAny, {
12
- protocol: "context.indexer.profile-problem-lineage/v1";
13
- requirement_lineage_id: string;
14
- source_material_epoch: string;
15
- unit_ref: string;
16
- problem_class: string;
17
- lineage_id: string;
18
- }, {
19
- protocol: "context.indexer.profile-problem-lineage/v1";
20
- requirement_lineage_id: string;
21
- source_material_epoch: string;
22
- unit_ref: string;
23
- problem_class: string;
24
- lineage_id: string;
25
- }>;
26
- precompile_audit_report_digest: z.ZodString;
27
- audit_report_digest: z.ZodString;
28
- indexer_result_fingerprint: z.ZodString;
29
- actions_taken: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
30
- unresolved_reasons: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
31
- expected_ledger_digest: z.ZodString;
32
- input_digest: z.ZodString;
33
- }, "strict", z.ZodTypeAny, {
34
- protocol: "context.indexer.profile-revision-record-input/v1";
35
- input_digest: string;
36
- precompile_audit_report_digest: string;
37
- audit_report_digest: string;
38
- indexer_result_fingerprint: string;
39
- actions_taken: string[];
40
- unresolved_reasons: string[];
41
- lineage: {
42
- protocol: "context.indexer.profile-problem-lineage/v1";
43
- requirement_lineage_id: string;
44
- source_material_epoch: string;
45
- unit_ref: string;
46
- problem_class: string;
47
- lineage_id: string;
48
- };
49
- expected_ledger_digest: string;
50
- }, {
51
- protocol: "context.indexer.profile-revision-record-input/v1";
52
- input_digest: string;
53
- precompile_audit_report_digest: string;
54
- audit_report_digest: string;
55
- indexer_result_fingerprint: string;
56
- actions_taken: string[];
57
- unresolved_reasons: string[];
58
- lineage: {
59
- protocol: "context.indexer.profile-problem-lineage/v1";
60
- requirement_lineage_id: string;
61
- source_material_epoch: string;
62
- unit_ref: string;
63
- problem_class: string;
64
- lineage_id: string;
65
- };
66
- expected_ledger_digest: string;
67
- }>;
68
- export declare const indexerProfileFailureReportInputSchema: z.ZodObject<{
69
- protocol: z.ZodLiteral<"context.indexer.profile-failure-report-input/v1">;
70
- lineage_id: z.ZodString;
71
- precompile_audit_report_digest: z.ZodString;
72
- audit_report_digest: z.ZodString;
73
- expected_ledger_digest: z.ZodString;
74
- module_profiles: z.ZodArray<z.ZodObject<{
75
- unit_ref: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
76
- classification: z.ZodEffects<z.ZodString, string, string>;
77
- primary_profile: z.ZodEffects<z.ZodString, string, string>;
78
- additional_profiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
79
- composers: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
80
- profile_contract_digests: z.ZodArray<z.ZodString, "many">;
81
- }, "strict", z.ZodTypeAny, {
82
- composers: string[];
83
- classification: string;
84
- profile_contract_digests: string[];
85
- unit_ref: string;
86
- primary_profile: string;
87
- additional_profiles: string[];
88
- }, {
89
- composers: string[];
90
- classification: string;
91
- profile_contract_digests: string[];
92
- unit_ref: string;
93
- primary_profile: string;
94
- additional_profiles: string[];
95
- }>, "many">;
96
- expected_artifacts: z.ZodArray<z.ZodObject<{
97
- classification: z.ZodEffects<z.ZodString, string, string>;
98
- bundle_variant: z.ZodEffects<z.ZodString, string, string>;
99
- expected_artifact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
100
- anonymous_example: z.ZodEffects<z.ZodString, string, string>;
101
- anonymous_anti_example: z.ZodEffects<z.ZodString, string, string>;
102
- }, "strict", z.ZodTypeAny, {
103
- classification: string;
104
- bundle_variant: string;
105
- expected_artifact_kinds: string[];
106
- anonymous_example: string;
107
- anonymous_anti_example: string;
108
- }, {
109
- classification: string;
110
- bundle_variant: string;
111
- expected_artifact_kinds: string[];
112
- anonymous_example: string;
113
- anonymous_anti_example: string;
114
- }>, "many">;
115
- metrics: z.ZodArray<z.ZodObject<{
116
- metric_id: z.ZodEffects<z.ZodString, string, string>;
117
- unit: z.ZodEnum<["percent", "count", "ratio", "boolean"]>;
118
- recommended: z.ZodNullable<z.ZodNumber>;
119
- hard_gate: z.ZodNullable<z.ZodNumber>;
120
- observed: z.ZodNullable<z.ZodNumber>;
121
- denominator: z.ZodNumber;
122
- sample_refs: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
123
- }, "strict", z.ZodTypeAny, {
124
- denominator: number;
125
- unit: "boolean" | "count" | "ratio" | "percent";
126
- recommended: number | null;
127
- metric_id: string;
128
- hard_gate: number | null;
129
- observed: number | null;
130
- sample_refs: string[];
131
- }, {
132
- denominator: number;
133
- unit: "boolean" | "count" | "ratio" | "percent";
134
- recommended: number | null;
135
- metric_id: string;
136
- hard_gate: number | null;
137
- observed: number | null;
138
- sample_refs: string[];
139
- }>, "many">;
140
- likely_missing_inputs: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
141
- capability_losses: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
142
- options: z.ZodArray<z.ZodEnum<["provide-material", "change-scope", "correct-classification", "force-approve-risk"]>, "many">;
143
- input_digest: z.ZodString;
144
- }, "strict", z.ZodTypeAny, {
145
- protocol: "context.indexer.profile-failure-report-input/v1";
146
- options: ("provide-material" | "change-scope" | "correct-classification" | "force-approve-risk")[];
147
- metrics: {
148
- denominator: number;
149
- unit: "boolean" | "count" | "ratio" | "percent";
150
- recommended: number | null;
151
- metric_id: string;
152
- hard_gate: number | null;
153
- observed: number | null;
154
- sample_refs: string[];
155
- }[];
156
- input_digest: string;
157
- precompile_audit_report_digest: string;
158
- lineage_id: string;
159
- audit_report_digest: string;
160
- module_profiles: {
161
- composers: string[];
162
- classification: string;
163
- profile_contract_digests: string[];
164
- unit_ref: string;
165
- primary_profile: string;
166
- additional_profiles: string[];
167
- }[];
168
- expected_artifacts: {
169
- classification: string;
170
- bundle_variant: string;
171
- expected_artifact_kinds: string[];
172
- anonymous_example: string;
173
- anonymous_anti_example: string;
174
- }[];
175
- likely_missing_inputs: string[];
176
- capability_losses: string[];
177
- expected_ledger_digest: string;
178
- }, {
179
- protocol: "context.indexer.profile-failure-report-input/v1";
180
- options: ("provide-material" | "change-scope" | "correct-classification" | "force-approve-risk")[];
181
- metrics: {
182
- denominator: number;
183
- unit: "boolean" | "count" | "ratio" | "percent";
184
- recommended: number | null;
185
- metric_id: string;
186
- hard_gate: number | null;
187
- observed: number | null;
188
- sample_refs: string[];
189
- }[];
190
- input_digest: string;
191
- precompile_audit_report_digest: string;
192
- lineage_id: string;
193
- audit_report_digest: string;
194
- module_profiles: {
195
- composers: string[];
196
- classification: string;
197
- profile_contract_digests: string[];
198
- unit_ref: string;
199
- primary_profile: string;
200
- additional_profiles: string[];
201
- }[];
202
- expected_artifacts: {
203
- classification: string;
204
- bundle_variant: string;
205
- expected_artifact_kinds: string[];
206
- anonymous_example: string;
207
- anonymous_anti_example: string;
208
- }[];
209
- likely_missing_inputs: string[];
210
- capability_losses: string[];
211
- expected_ledger_digest: string;
212
- }>;
213
- export declare const indexerProfileFailureInspectionInputSchema: z.ZodObject<{
214
- protocol: z.ZodLiteral<"context.indexer.profile-failure-inspection-input/v1">;
215
- failure_report_digest: z.ZodString;
216
- input_digest: z.ZodString;
217
- }, "strict", z.ZodTypeAny, {
218
- protocol: "context.indexer.profile-failure-inspection-input/v1";
219
- input_digest: string;
220
- failure_report_digest: string;
221
- }, {
222
- protocol: "context.indexer.profile-failure-inspection-input/v1";
223
- input_digest: string;
224
- failure_report_digest: string;
225
- }>;
226
- export type IndexerProfileRevisionRecordInput = z.infer<typeof indexerProfileRevisionRecordInputSchema>;
227
- export type IndexerProfileFailureReportInput = z.infer<typeof indexerProfileFailureReportInputSchema>;
228
- export type IndexerProfileFailureInspectionInput = z.infer<typeof indexerProfileFailureInspectionInputSchema>;
229
- export declare function buildIndexerProfileRevisionRecordInput(input: Omit<IndexerProfileRevisionRecordInput, "protocol" | "input_digest">): IndexerProfileRevisionRecordInput;
230
- export declare function validateIndexerProfileRevisionRecordInput(value: unknown): IndexerProfileRevisionRecordInput;
231
- export declare function buildIndexerProfileFailureReportInput(input: Omit<IndexerProfileFailureReportInput, "protocol" | "input_digest">): IndexerProfileFailureReportInput;
232
- export declare function validateIndexerProfileFailureReportInput(value: unknown): IndexerProfileFailureReportInput;
233
- export declare function buildIndexerProfileFailureInspectionInput(input: {
234
- failure_report_digest: string;
235
- }): IndexerProfileFailureInspectionInput;
236
- export declare function validateIndexerProfileFailureInspectionInput(value: unknown): IndexerProfileFailureInspectionInput;