@c4a/context 0.7.1 → 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 -428
  6. package/docs/guides/agent-guide.md +94 -518
  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 -121
  10. package/docs/reference/indexer-provider-protocol.md +43 -110
  11. package/docs/reference/package-templates.md +2 -3
  12. package/docs/reference/project-api.md +52 -986
  13. package/index.d.ts +10 -8
  14. package/index.js +4739 -7103
  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 +219 -252
  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 +66 -60
  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/indexerContractOverlay.d.ts +10 -10
  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 +491 -287
  55. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  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 -218
  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,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;