@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
package/indexerExampleIdentity.d.ts CHANGED
@@ -12,8 +12,8 @@ declare const exampleObservationSchema: z.ZodObject<{
12
12
  }, "strict", z.ZodTypeAny, {
13
13
  source_ref: string;
14
14
  evidence_refs: string[];
15
- module_ref: string | null;
16
15
  content_digest: string;
16
+ module_ref: string | null;
17
17
  observation_ref: string;
18
18
  example_ref: string;
19
19
  public_target_ref: string;
@@ -22,8 +22,8 @@ declare const exampleObservationSchema: z.ZodObject<{
22
22
  }, {
23
23
  source_ref: string;
24
24
  evidence_refs: string[];
25
- module_ref: string | null;
26
25
  content_digest: string;
26
+ module_ref: string | null;
27
27
  observation_ref: string;
28
28
  example_ref: string;
29
29
  public_target_ref: string;
@@ -46,8 +46,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
46
46
  }, "strict", z.ZodTypeAny, {
47
47
  source_ref: string;
48
48
  evidence_refs: string[];
49
- module_ref: string | null;
50
49
  content_digest: string;
50
+ module_ref: string | null;
51
51
  observation_ref: string;
52
52
  example_ref: string;
53
53
  public_target_ref: string;
@@ -56,8 +56,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
56
56
  }, {
57
57
  source_ref: string;
58
58
  evidence_refs: string[];
59
- module_ref: string | null;
60
59
  content_digest: string;
60
+ module_ref: string | null;
61
61
  observation_ref: string;
62
62
  example_ref: string;
63
63
  public_target_ref: string;
@@ -72,8 +72,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
72
72
  observations: {
73
73
  source_ref: string;
74
74
  evidence_refs: string[];
75
- module_ref: string | null;
76
75
  content_digest: string;
76
+ module_ref: string | null;
77
77
  observation_ref: string;
78
78
  example_ref: string;
79
79
  public_target_ref: string;
@@ -87,8 +87,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
87
87
  observations: {
88
88
  source_ref: string;
89
89
  evidence_refs: string[];
90
- module_ref: string | null;
91
90
  content_digest: string;
91
+ module_ref: string | null;
92
92
  observation_ref: string;
93
93
  example_ref: string;
94
94
  public_target_ref: string;
package/indexerGeneratedAuthoringAudit.d.ts CHANGED
@@ -8,11 +8,11 @@ declare const structuredClaimSchema: z.ZodObject<{
8
8
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
9
9
  section_key: z.ZodEffects<z.ZodString, string, string>;
10
10
  }, "strict", z.ZodTypeAny, {
11
- artifact_id: string;
12
11
  section_key: string;
13
- }, {
14
12
  artifact_id: string;
13
+ }, {
15
14
  section_key: string;
15
+ artifact_id: string;
16
16
  }>;
17
17
  evidence_refs: z.ZodArray<z.ZodString, "many">;
18
18
  }, "strict", z.ZodTypeAny, {
@@ -21,8 +21,8 @@ declare const structuredClaimSchema: z.ZodObject<{
21
21
  claim_kind: string;
22
22
  subject_ref: string;
23
23
  owner: {
24
- artifact_id: string;
25
24
  section_key: string;
25
+ artifact_id: string;
26
26
  };
27
27
  }, {
28
28
  evidence_refs: string[];
@@ -30,8 +30,8 @@ declare const structuredClaimSchema: z.ZodObject<{
30
30
  claim_kind: string;
31
31
  subject_ref: string;
32
32
  owner: {
33
- artifact_id: string;
34
33
  section_key: string;
34
+ artifact_id: string;
35
35
  };
36
36
  }>;
37
37
  export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
@@ -46,11 +46,11 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
46
46
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
47
47
  section_key: z.ZodEffects<z.ZodString, string, string>;
48
48
  }, "strict", z.ZodTypeAny, {
49
- artifact_id: string;
50
49
  section_key: string;
51
- }, {
52
50
  artifact_id: string;
51
+ }, {
53
52
  section_key: string;
53
+ artifact_id: string;
54
54
  }>;
55
55
  evidence_refs: z.ZodArray<z.ZodString, "many">;
56
56
  }, "strict", z.ZodTypeAny, {
@@ -59,8 +59,8 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
59
59
  claim_kind: string;
60
60
  subject_ref: string;
61
61
  owner: {
62
- artifact_id: string;
63
62
  section_key: string;
63
+ artifact_id: string;
64
64
  };
65
65
  }, {
66
66
  evidence_refs: string[];
@@ -68,8 +68,8 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
68
68
  claim_kind: string;
69
69
  subject_ref: string;
70
70
  owner: {
71
- artifact_id: string;
72
71
  section_key: string;
72
+ artifact_id: string;
73
73
  };
74
74
  }>, "many">;
75
75
  claims_digest: z.ZodString;
@@ -83,8 +83,8 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
83
83
  claim_kind: string;
84
84
  subject_ref: string;
85
85
  owner: {
86
- artifact_id: string;
87
86
  section_key: string;
87
+ artifact_id: string;
88
88
  };
89
89
  }[];
90
90
  claims_digest: string;
@@ -98,8 +98,8 @@ export declare const indexerStructuredClaimSetSchema: z.ZodObject<{
98
98
  claim_kind: string;
99
99
  subject_ref: string;
100
100
  owner: {
101
- artifact_id: string;
102
101
  section_key: string;
102
+ artifact_id: string;
103
103
  };
104
104
  }[];
105
105
  claims_digest: string;
@@ -114,13 +114,13 @@ export declare const indexerGeneratedAuthoringAuditSchema: z.ZodObject<{
114
114
  content_ref: z.ZodString;
115
115
  }, "strict", z.ZodTypeAny, {
116
116
  code: "generated-placeholder" | "empty-required-section";
117
- artifact_id: string;
118
117
  section_key: string | null;
118
+ artifact_id: string;
119
119
  content_ref: string;
120
120
  }, {
121
121
  code: "generated-placeholder" | "empty-required-section";
122
- artifact_id: string;
123
122
  section_key: string | null;
123
+ artifact_id: string;
124
124
  content_ref: string;
125
125
  }>, "many">;
126
126
  structured_claim_count: z.ZodNumber;
@@ -131,13 +131,13 @@ export declare const indexerGeneratedAuthoringAuditSchema: z.ZodObject<{
131
131
  content_ref: z.ZodString;
132
132
  advisory_code: z.ZodLiteral<"semantic-prose-agent-review-required">;
133
133
  }, "strict", z.ZodTypeAny, {
134
- artifact_id: string;
135
134
  section_key: string | null;
135
+ artifact_id: string;
136
136
  content_ref: string;
137
137
  advisory_code: "semantic-prose-agent-review-required";
138
138
  }, {
139
- artifact_id: string;
140
139
  section_key: string | null;
140
+ artifact_id: string;
141
141
  content_ref: string;
142
142
  advisory_code: "semantic-prose-agent-review-required";
143
143
  }>, "many">;
@@ -148,15 +148,15 @@ export declare const indexerGeneratedAuthoringAuditSchema: z.ZodObject<{
148
148
  artifact_result_digest: string;
149
149
  hard_findings: {
150
150
  code: "generated-placeholder" | "empty-required-section";
151
- artifact_id: string;
152
151
  section_key: string | null;
152
+ artifact_id: string;
153
153
  content_ref: string;
154
154
  }[];
155
155
  structured_claim_count: number;
156
156
  evidence_covered_structured_claim_count: number;
157
157
  semantic_prose_review_targets: {
158
- artifact_id: string;
159
158
  section_key: string | null;
159
+ artifact_id: string;
160
160
  content_ref: string;
161
161
  advisory_code: "semantic-prose-agent-review-required";
162
162
  }[];
@@ -167,15 +167,15 @@ export declare const indexerGeneratedAuthoringAuditSchema: z.ZodObject<{
167
167
  artifact_result_digest: string;
168
168
  hard_findings: {
169
169
  code: "generated-placeholder" | "empty-required-section";
170
- artifact_id: string;
171
170
  section_key: string | null;
171
+ artifact_id: string;
172
172
  content_ref: string;
173
173
  }[];
174
174
  structured_claim_count: number;
175
175
  evidence_covered_structured_claim_count: number;
176
176
  semantic_prose_review_targets: {
177
- artifact_id: string;
178
177
  section_key: string | null;
178
+ artifact_id: string;
179
179
  content_ref: string;
180
180
  advisory_code: "semantic-prose-agent-review-required";
181
181
  }[];
package/indexerIncrementalImpact.d.ts CHANGED
@@ -33,11 +33,11 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
33
33
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
34
34
  section_key: z.ZodEffects<z.ZodString, string, string>;
35
35
  }, "strict", z.ZodTypeAny, {
36
- artifact_id: string;
37
36
  section_key: string;
38
- }, {
39
37
  artifact_id: string;
38
+ }, {
40
39
  section_key: string;
40
+ artifact_id: string;
41
41
  }>, "many">;
42
42
  }, "strict", z.ZodTypeAny, {
43
43
  kind: string;
@@ -48,8 +48,8 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
48
48
  current_dependency_ref: string | null;
49
49
  affected_artifact_ids: string[];
50
50
  affected_sections: {
51
- artifact_id: string;
52
51
  section_key: string;
52
+ artifact_id: string;
53
53
  }[];
54
54
  }, {
55
55
  kind: string;
@@ -60,8 +60,8 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
60
60
  current_dependency_ref: string | null;
61
61
  affected_artifact_ids: string[];
62
62
  affected_sections: {
63
- artifact_id: string;
64
63
  section_key: string;
64
+ artifact_id: string;
65
65
  }[];
66
66
  }>, "many">;
67
67
  artifacts: z.ZodArray<z.ZodObject<{
@@ -74,33 +74,33 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
74
74
  state: z.ZodEnum<["current", "stale"]>;
75
75
  changed_node_refs: z.ZodArray<z.ZodString, "many">;
76
76
  }, "strict", z.ZodTypeAny, {
77
- state: "current" | "stale";
78
77
  section_key: string;
78
+ state: "current" | "stale";
79
79
  changed_node_refs: string[];
80
80
  }, {
81
- state: "current" | "stale";
82
81
  section_key: string;
82
+ state: "current" | "stale";
83
83
  changed_node_refs: string[];
84
84
  }>, "many">;
85
85
  }, "strict", z.ZodTypeAny, {
86
86
  artifact_kind: string;
87
- state: "current" | "stale";
88
87
  artifact_id: string;
89
88
  sections: {
90
- state: "current" | "stale";
91
89
  section_key: string;
90
+ state: "current" | "stale";
92
91
  changed_node_refs: string[];
93
92
  }[];
93
+ state: "current" | "stale";
94
94
  changed_node_refs: string[];
95
95
  }, {
96
96
  artifact_kind: string;
97
- state: "current" | "stale";
98
97
  artifact_id: string;
99
98
  sections: {
100
- state: "current" | "stale";
101
99
  section_key: string;
100
+ state: "current" | "stale";
102
101
  changed_node_refs: string[];
103
102
  }[];
103
+ state: "current" | "stale";
104
104
  changed_node_refs: string[];
105
105
  }>, "many">;
106
106
  logical_unit_state: z.ZodEnum<["current", "stale"]>;
@@ -115,13 +115,13 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
115
115
  protocol: "context.indexer.incremental-impact-report/v1";
116
116
  artifacts: {
117
117
  artifact_kind: string;
118
- state: "current" | "stale";
119
118
  artifact_id: string;
120
119
  sections: {
121
- state: "current" | "stale";
122
120
  section_key: string;
121
+ state: "current" | "stale";
123
122
  changed_node_refs: string[];
124
123
  }[];
124
+ state: "current" | "stale";
125
125
  changed_node_refs: string[];
126
126
  }[];
127
127
  indexer_id: string;
@@ -146,8 +146,8 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
146
146
  current_dependency_ref: string | null;
147
147
  affected_artifact_ids: string[];
148
148
  affected_sections: {
149
- artifact_id: string;
150
149
  section_key: string;
150
+ artifact_id: string;
151
151
  }[];
152
152
  }[];
153
153
  logical_unit_state: "current" | "stale";
@@ -160,13 +160,13 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
160
160
  protocol: "context.indexer.incremental-impact-report/v1";
161
161
  artifacts: {
162
162
  artifact_kind: string;
163
- state: "current" | "stale";
164
163
  artifact_id: string;
165
164
  sections: {
166
- state: "current" | "stale";
167
165
  section_key: string;
166
+ state: "current" | "stale";
168
167
  changed_node_refs: string[];
169
168
  }[];
169
+ state: "current" | "stale";
170
170
  changed_node_refs: string[];
171
171
  }[];
172
172
  indexer_id: string;
@@ -191,8 +191,8 @@ export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
191
191
  current_dependency_ref: string | null;
192
192
  affected_artifact_ids: string[];
193
193
  affected_sections: {
194
- artifact_id: string;
195
194
  section_key: string;
195
+ artifact_id: string;
196
196
  }[];
197
197
  }[];
198
198
  logical_unit_state: "current" | "stale";
package/indexerInspectorWorksetProjection.d.ts ADDED
@@ -0,0 +1,6 @@
1
+ import { type IndexerAuthorizedWorksetViewSource } from "./indexerAuthorizedWorksetView.js";
2
+ export declare function buildIndexerInspectorWorksetViewSource(input: {
3
+ request: unknown;
4
+ inspector_request: unknown;
5
+ inspector_result: unknown;
6
+ }): IndexerAuthorizedWorksetViewSource;