@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
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;