@c4a/context 0.7.8 → 0.7.10-alpha.1

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 (84) hide show
  1. package/articleStructure.d.ts +254 -0
  2. package/docs/guides/agent-dialogue.md +6 -5
  3. package/docs/guides/agent-guide.md +11 -5
  4. package/docs/guides/code-indexer-skill-authoring.md +76 -178
  5. package/docs/guides/indexer-provider-and-customization.md +93 -398
  6. package/docs/guides/indexer-skill-creation.md +107 -97
  7. package/docs/guides/knowledge-updates.md +137 -18
  8. package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
  9. package/docs/guides/package-outputs.md +213 -47
  10. package/docs/reference/indexer-provider-protocol.md +71 -102
  11. package/docs/reference/package-templates.md +39 -65
  12. package/docs/reference/project-api.md +53 -0
  13. package/docs/reference/template-variables.md +2 -3
  14. package/index.d.ts +11 -11
  15. package/index.js +5826 -8062
  16. package/indexerAgentStepProtocol.d.ts +0 -910
  17. package/indexerApprovedKnowledge.d.ts +98 -359
  18. package/indexerArticlePlan.d.ts +3 -26
  19. package/indexerArtifact.d.ts +201 -70
  20. package/indexerArtifactPolicy.d.ts +4 -22
  21. package/indexerArtifactResult.d.ts +240 -888
  22. package/indexerAuthoringFixture.d.ts +0 -13
  23. package/indexerBenchmark.d.ts +2 -2
  24. package/indexerCandidateCompile.d.ts +123 -167
  25. package/indexerCatalogFallback.d.ts +32 -374
  26. package/indexerCollectionMapping.d.ts +2 -2
  27. package/indexerContentLayers.d.ts +187 -41
  28. package/indexerContractOverlay.d.ts +30 -44
  29. package/indexerControlledInvocation.d.ts +6 -6
  30. package/indexerControlledProgram.d.ts +959 -3020
  31. package/indexerDependencyView.d.ts +96 -96
  32. package/indexerEffectiveArtifact.d.ts +381 -242
  33. package/indexerExampleDecision.d.ts +134 -134
  34. package/indexerExampleIdentity.d.ts +6 -6
  35. package/indexerExampleIdentityAudit.d.ts +6 -6
  36. package/indexerInventoryDisposition.d.ts +0 -39
  37. package/indexerLayerComposition.d.ts +1378 -852
  38. package/indexerLayoutChange.d.ts +24 -33
  39. package/indexerLayoutProposalSet.d.ts +143 -137
  40. package/indexerLayoutResolver.d.ts +116 -101
  41. package/indexerLayoutTransition.d.ts +6 -6
  42. package/indexerMainLifecycle.d.ts +1 -11
  43. package/indexerMainRunLedger.d.ts +0 -14
  44. package/indexerMainRunProtocol.d.ts +806 -2530
  45. package/indexerMainWorkset.d.ts +0 -1212
  46. package/indexerNavigationArtifactPlan.d.ts +2 -2
  47. package/indexerOverlayQuestionApplyProposal.d.ts +0 -4
  48. package/indexerParserCoordinate.d.ts +2 -2
  49. package/indexerParserExecutionPlan.d.ts +42 -42
  50. package/indexerPartitionPlan.d.ts +24 -354
  51. package/indexerPhysicalArtifactManifest.d.ts +12 -27
  52. package/indexerPostAuthorComposition.d.ts +2 -253
  53. package/indexerPostAuthorRunLedger.d.ts +860 -562
  54. package/indexerPrimaryProjection.d.ts +2 -2
  55. package/indexerPrimaryResultView.d.ts +0 -318
  56. package/indexerProfileContract.d.ts +200 -549
  57. package/indexerProgramExecutionAuthorization.d.ts +4 -4
  58. package/indexerProgramRunProtocol.d.ts +806 -2527
  59. package/indexerProjectProposal.d.ts +8 -8
  60. package/indexerProjectedArtifactFanOutAudit.d.ts +8 -8
  61. package/indexerProjectedArtifactPlan.d.ts +0 -9
  62. package/indexerProtocolHash.d.ts +2 -0
  63. package/indexerProvider.d.ts +76 -318
  64. package/indexerProviderComposition.d.ts +16 -42
  65. package/indexerQuestionAuthority.d.ts +2 -82
  66. package/indexerReaderTargetInventory.d.ts +6 -6
  67. package/indexerRegistry.d.ts +606 -0
  68. package/indexerRequirementLifecycle.d.ts +6 -6
  69. package/indexerResultReconciliation.d.ts +35 -149
  70. package/indexerSemanticInput.d.ts +10926 -5665
  71. package/indexerStructuredDeclaration.d.ts +24 -24
  72. package/indexerTemplateRendering.d.ts +239 -113
  73. package/{readingStructure.d.ts → knowledgeMap.d.ts} +21 -21
  74. package/package.json +1 -1
  75. package/packageSite.d.ts +25 -0
  76. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +13 -16
  77. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +9 -9
  78. package/indexerArtifactDependencies.d.ts +0 -693
  79. package/indexerCompositionFactDependencies.d.ts +0 -16
  80. package/indexerExampleFactDependencies.d.ts +0 -17
  81. package/indexerIncrementalImpact.d.ts +0 -221
  82. package/indexerKnowledgeDependency.d.ts +0 -46
  83. package/indexerSubjectCatalog.d.ts +0 -230
  84. package/indexerSubjectKeyAuthority.d.ts +0 -786
package/indexerNavigationArtifactPlan.d.ts CHANGED
@@ -14,8 +14,8 @@ export declare const indexerNavigationArtifactPlanSchema: z.ZodObject<{
14
14
  output_path: string;
15
15
  artifact_kind: string;
16
16
  artifact_id: string;
17
- artifact_ref: string;
18
17
  plan_digest: string;
18
+ artifact_ref: string;
19
19
  navigation_ref: string;
20
20
  child_artifact_refs: string[];
21
21
  }, {
@@ -23,8 +23,8 @@ export declare const indexerNavigationArtifactPlanSchema: z.ZodObject<{
23
23
  output_path: string;
24
24
  artifact_kind: string;
25
25
  artifact_id: string;
26
- artifact_ref: string;
27
26
  plan_digest: string;
27
+ artifact_ref: string;
28
28
  navigation_ref: string;
29
29
  child_artifact_refs: string[];
30
30
  }>;
package/indexerOverlayQuestionApplyProposal.d.ts CHANGED
@@ -4434,7 +4434,6 @@ export declare const indexerOverlayQuestionRegistryApplyProposalSchema: z.ZodObj
4434
4434
  overlay_validation_receipt_digest: z.ZodString;
4435
4435
  rebind_receipt_digest: z.ZodString;
4436
4436
  rebound_selection_digest: z.ZodString;
4437
- subject_key_schema_set_digest: z.ZodString;
4438
4437
  finalized_validation_report_digests: z.ZodArray<z.ZodString, "many">;
4439
4438
  proposal_digest: z.ZodString;
4440
4439
  }, "strict", z.ZodTypeAny, {
@@ -4797,7 +4796,6 @@ export declare const indexerOverlayQuestionRegistryApplyProposalSchema: z.ZodObj
4797
4796
  overlay_contract_digest: string;
4798
4797
  rebind_receipt_digest: string;
4799
4798
  rebound_selection_digest: string;
4800
- subject_key_schema_set_digest: string;
4801
4799
  }, {
4802
4800
  protocol: "context.indexer.overlay-question-registry-apply-proposal/v1";
4803
4801
  project_ref: string;
@@ -5158,7 +5156,6 @@ export declare const indexerOverlayQuestionRegistryApplyProposalSchema: z.ZodObj
5158
5156
  overlay_contract_digest: string;
5159
5157
  rebind_receipt_digest: string;
5160
5158
  rebound_selection_digest: string;
5161
- subject_key_schema_set_digest: string;
5162
5159
  }>;
5163
5160
  export type IndexerOverlayQuestionRegistryApplyProposal = z.infer<typeof indexerOverlayQuestionRegistryApplyProposalSchema>;
5164
5161
  export declare function buildIndexerOverlayQuestionRegistryApplyProposal(input: {
@@ -5170,7 +5167,6 @@ export declare function buildIndexerOverlayQuestionRegistryApplyProposal(input:
5170
5167
  confirmation: unknown;
5171
5168
  rebind_receipt_digest: string;
5172
5169
  rebound_selection_digest: string;
5173
- subject_key_schema_set_digest: string;
5174
5170
  finalized_validation_report_digests: readonly string[];
5175
5171
  }): IndexerOverlayQuestionRegistryApplyProposal;
5176
5172
  export declare function validateIndexerOverlayQuestionRegistryApplyProposal(value: unknown): IndexerOverlayQuestionRegistryApplyProposal;
package/indexerParserCoordinate.d.ts CHANGED
@@ -131,6 +131,7 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
131
131
  lock_digest: z.ZodString;
132
132
  }, "strict", z.ZodTypeAny, {
133
133
  protocol: "context.indexer.parser-resolution-lock/v1";
134
+ lock_integrity: string;
134
135
  capability: string;
135
136
  abi_digest: string;
136
137
  requirement_digest: string;
@@ -140,11 +141,11 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
140
141
  export: string;
141
142
  };
142
143
  mapping_digest: string;
143
- lock_integrity: string;
144
144
  resolved_content_digest: string;
145
145
  lock_digest: string;
146
146
  }, {
147
147
  protocol: "context.indexer.parser-resolution-lock/v1";
148
+ lock_integrity: string;
148
149
  capability: string;
149
150
  abi_digest: string;
150
151
  requirement_digest: string;
@@ -154,7 +155,6 @@ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
154
155
  export: string;
155
156
  };
156
157
  mapping_digest: string;
157
- lock_integrity: string;
158
158
  resolved_content_digest: string;
159
159
  lock_digest: string;
160
160
  }>;
package/indexerParserExecutionPlan.d.ts CHANGED
@@ -14,72 +14,72 @@ export declare const indexerParserExecutionPlanEntrySchema: z.ZodEffects<z.ZodOb
14
14
  contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
15
15
  role: z.ZodEnum<["primary-owner", "enricher"]>;
16
16
  }, "strict", z.ZodTypeAny, {
17
- role: "enricher" | "primary-owner";
18
17
  content_digest: string;
18
+ role: "enricher" | "primary-owner";
19
19
  normalized_path: string;
20
20
  contract_scope: string | null;
21
21
  }, {
22
- role: "enricher" | "primary-owner";
23
22
  content_digest: string;
23
+ role: "enricher" | "primary-owner";
24
24
  normalized_path: string;
25
25
  contract_scope: string | null;
26
26
  }>, "many">;
27
27
  }, "strict", z.ZodTypeAny, {
28
28
  files: {
29
- role: "enricher" | "primary-owner";
30
29
  content_digest: string;
30
+ role: "enricher" | "primary-owner";
31
31
  normalized_path: string;
32
32
  contract_scope: string | null;
33
33
  }[];
34
34
  source_ref: string;
35
35
  module_ref: string | null;
36
36
  precedence: number;
37
+ authority_domain: string;
37
38
  capability: string;
38
39
  requirement_digest: string;
39
40
  parser_lock_digest: string;
40
- authority_domain: string;
41
41
  }, {
42
42
  files: {
43
- role: "enricher" | "primary-owner";
44
43
  content_digest: string;
44
+ role: "enricher" | "primary-owner";
45
45
  normalized_path: string;
46
46
  contract_scope: string | null;
47
47
  }[];
48
48
  source_ref: string;
49
49
  module_ref: string | null;
50
50
  precedence: number;
51
+ authority_domain: string;
51
52
  capability: string;
52
53
  requirement_digest: string;
53
54
  parser_lock_digest: string;
54
- authority_domain: string;
55
55
  }>, {
56
56
  files: {
57
- role: "enricher" | "primary-owner";
58
57
  content_digest: string;
58
+ role: "enricher" | "primary-owner";
59
59
  normalized_path: string;
60
60
  contract_scope: string | null;
61
61
  }[];
62
62
  source_ref: string;
63
63
  module_ref: string | null;
64
64
  precedence: number;
65
+ authority_domain: string;
65
66
  capability: string;
66
67
  requirement_digest: string;
67
68
  parser_lock_digest: string;
68
- authority_domain: string;
69
69
  }, {
70
70
  files: {
71
- role: "enricher" | "primary-owner";
72
71
  content_digest: string;
72
+ role: "enricher" | "primary-owner";
73
73
  normalized_path: string;
74
74
  contract_scope: string | null;
75
75
  }[];
76
76
  source_ref: string;
77
77
  module_ref: string | null;
78
78
  precedence: number;
79
+ authority_domain: string;
79
80
  capability: string;
80
81
  requirement_digest: string;
81
82
  parser_lock_digest: string;
82
- authority_domain: string;
83
83
  }>;
84
84
  export declare const indexerParserApplicabilitySchema: z.ZodDiscriminatedUnion<"disposition", [z.ZodObject<{
85
85
  source_ref: z.ZodString;
@@ -93,23 +93,23 @@ export declare const indexerParserApplicabilitySchema: z.ZodDiscriminatedUnion<"
93
93
  role: z.ZodEnum<["primary-owner", "enricher"]>;
94
94
  }, "strict", z.ZodTypeAny, {
95
95
  source_ref: string;
96
- role: "enricher" | "primary-owner";
97
96
  content_digest: string;
97
+ role: "enricher" | "primary-owner";
98
98
  module_ref: string | null;
99
99
  normalized_path: string;
100
100
  disposition: "applicable";
101
- capability: string;
102
101
  authority_domain: string;
102
+ capability: string;
103
103
  contract_scope: string | null;
104
104
  }, {
105
105
  source_ref: string;
106
- role: "enricher" | "primary-owner";
107
106
  content_digest: string;
107
+ role: "enricher" | "primary-owner";
108
108
  module_ref: string | null;
109
109
  normalized_path: string;
110
110
  disposition: "applicable";
111
- capability: string;
112
111
  authority_domain: string;
112
+ capability: string;
113
113
  contract_scope: string | null;
114
114
  }>, z.ZodObject<{
115
115
  source_ref: z.ZodString;
@@ -127,8 +127,8 @@ export declare const indexerParserApplicabilitySchema: z.ZodDiscriminatedUnion<"
127
127
  module_ref: string | null;
128
128
  normalized_path: string;
129
129
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
130
- capability: string;
131
130
  authority_domain: string;
131
+ capability: string;
132
132
  reason_code: string;
133
133
  contract_scope: string | null;
134
134
  }, {
@@ -137,8 +137,8 @@ export declare const indexerParserApplicabilitySchema: z.ZodDiscriminatedUnion<"
137
137
  module_ref: string | null;
138
138
  normalized_path: string;
139
139
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
140
- capability: string;
141
140
  authority_domain: string;
141
+ capability: string;
142
142
  reason_code: string;
143
143
  contract_scope: string | null;
144
144
  }>]>;
@@ -160,72 +160,72 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
160
160
  contract_scope: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
161
161
  role: z.ZodEnum<["primary-owner", "enricher"]>;
162
162
  }, "strict", z.ZodTypeAny, {
163
- role: "enricher" | "primary-owner";
164
163
  content_digest: string;
164
+ role: "enricher" | "primary-owner";
165
165
  normalized_path: string;
166
166
  contract_scope: string | null;
167
167
  }, {
168
- role: "enricher" | "primary-owner";
169
168
  content_digest: string;
169
+ role: "enricher" | "primary-owner";
170
170
  normalized_path: string;
171
171
  contract_scope: string | null;
172
172
  }>, "many">;
173
173
  }, "strict", z.ZodTypeAny, {
174
174
  files: {
175
- role: "enricher" | "primary-owner";
176
175
  content_digest: string;
176
+ role: "enricher" | "primary-owner";
177
177
  normalized_path: string;
178
178
  contract_scope: string | null;
179
179
  }[];
180
180
  source_ref: string;
181
181
  module_ref: string | null;
182
182
  precedence: number;
183
+ authority_domain: string;
183
184
  capability: string;
184
185
  requirement_digest: string;
185
186
  parser_lock_digest: string;
186
- authority_domain: string;
187
187
  }, {
188
188
  files: {
189
- role: "enricher" | "primary-owner";
190
189
  content_digest: string;
190
+ role: "enricher" | "primary-owner";
191
191
  normalized_path: string;
192
192
  contract_scope: string | null;
193
193
  }[];
194
194
  source_ref: string;
195
195
  module_ref: string | null;
196
196
  precedence: number;
197
+ authority_domain: string;
197
198
  capability: string;
198
199
  requirement_digest: string;
199
200
  parser_lock_digest: string;
200
- authority_domain: string;
201
201
  }>, {
202
202
  files: {
203
- role: "enricher" | "primary-owner";
204
203
  content_digest: string;
204
+ role: "enricher" | "primary-owner";
205
205
  normalized_path: string;
206
206
  contract_scope: string | null;
207
207
  }[];
208
208
  source_ref: string;
209
209
  module_ref: string | null;
210
210
  precedence: number;
211
+ authority_domain: string;
211
212
  capability: string;
212
213
  requirement_digest: string;
213
214
  parser_lock_digest: string;
214
- authority_domain: string;
215
215
  }, {
216
216
  files: {
217
- role: "enricher" | "primary-owner";
218
217
  content_digest: string;
218
+ role: "enricher" | "primary-owner";
219
219
  normalized_path: string;
220
220
  contract_scope: string | null;
221
221
  }[];
222
222
  source_ref: string;
223
223
  module_ref: string | null;
224
224
  precedence: number;
225
+ authority_domain: string;
225
226
  capability: string;
226
227
  requirement_digest: string;
227
228
  parser_lock_digest: string;
228
- authority_domain: string;
229
229
  }>, "many">;
230
230
  applicability: z.ZodArray<z.ZodDiscriminatedUnion<"disposition", [z.ZodObject<{
231
231
  source_ref: z.ZodString;
@@ -239,23 +239,23 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
239
239
  role: z.ZodEnum<["primary-owner", "enricher"]>;
240
240
  }, "strict", z.ZodTypeAny, {
241
241
  source_ref: string;
242
- role: "enricher" | "primary-owner";
243
242
  content_digest: string;
243
+ role: "enricher" | "primary-owner";
244
244
  module_ref: string | null;
245
245
  normalized_path: string;
246
246
  disposition: "applicable";
247
- capability: string;
248
247
  authority_domain: string;
248
+ capability: string;
249
249
  contract_scope: string | null;
250
250
  }, {
251
251
  source_ref: string;
252
- role: "enricher" | "primary-owner";
253
252
  content_digest: string;
253
+ role: "enricher" | "primary-owner";
254
254
  module_ref: string | null;
255
255
  normalized_path: string;
256
256
  disposition: "applicable";
257
- capability: string;
258
257
  authority_domain: string;
258
+ capability: string;
259
259
  contract_scope: string | null;
260
260
  }>, z.ZodObject<{
261
261
  source_ref: z.ZodString;
@@ -273,8 +273,8 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
273
273
  module_ref: string | null;
274
274
  normalized_path: string;
275
275
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
276
- capability: string;
277
276
  authority_domain: string;
277
+ capability: string;
278
278
  reason_code: string;
279
279
  contract_scope: string | null;
280
280
  }, {
@@ -283,8 +283,8 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
283
283
  module_ref: string | null;
284
284
  normalized_path: string;
285
285
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
286
- capability: string;
287
286
  authority_domain: string;
287
+ capability: string;
288
288
  reason_code: string;
289
289
  contract_scope: string | null;
290
290
  }>]>, "many">;
@@ -293,31 +293,31 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
293
293
  }, "strict", z.ZodTypeAny, {
294
294
  entries: {
295
295
  files: {
296
- role: "enricher" | "primary-owner";
297
296
  content_digest: string;
297
+ role: "enricher" | "primary-owner";
298
298
  normalized_path: string;
299
299
  contract_scope: string | null;
300
300
  }[];
301
301
  source_ref: string;
302
302
  module_ref: string | null;
303
303
  precedence: number;
304
+ authority_domain: string;
304
305
  capability: string;
305
306
  requirement_digest: string;
306
307
  parser_lock_digest: string;
307
- authority_domain: string;
308
308
  }[];
309
309
  protocol: "context.indexer.parser-execution-plan/v1";
310
310
  profile_contract_digest: string;
311
311
  source_registry_digest: string;
312
312
  applicability: ({
313
313
  source_ref: string;
314
- role: "enricher" | "primary-owner";
315
314
  content_digest: string;
315
+ role: "enricher" | "primary-owner";
316
316
  module_ref: string | null;
317
317
  normalized_path: string;
318
318
  disposition: "applicable";
319
- capability: string;
320
319
  authority_domain: string;
320
+ capability: string;
321
321
  contract_scope: string | null;
322
322
  } | {
323
323
  source_ref: string;
@@ -325,8 +325,8 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
325
325
  module_ref: string | null;
326
326
  normalized_path: string;
327
327
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
328
- capability: string;
329
328
  authority_domain: string;
329
+ capability: string;
330
330
  reason_code: string;
331
331
  contract_scope: string | null;
332
332
  })[];
@@ -334,31 +334,31 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
334
334
  }, {
335
335
  entries: {
336
336
  files: {
337
- role: "enricher" | "primary-owner";
338
337
  content_digest: string;
338
+ role: "enricher" | "primary-owner";
339
339
  normalized_path: string;
340
340
  contract_scope: string | null;
341
341
  }[];
342
342
  source_ref: string;
343
343
  module_ref: string | null;
344
344
  precedence: number;
345
+ authority_domain: string;
345
346
  capability: string;
346
347
  requirement_digest: string;
347
348
  parser_lock_digest: string;
348
- authority_domain: string;
349
349
  }[];
350
350
  protocol: "context.indexer.parser-execution-plan/v1";
351
351
  profile_contract_digest: string;
352
352
  source_registry_digest: string;
353
353
  applicability: ({
354
354
  source_ref: string;
355
- role: "enricher" | "primary-owner";
356
355
  content_digest: string;
356
+ role: "enricher" | "primary-owner";
357
357
  module_ref: string | null;
358
358
  normalized_path: string;
359
359
  disposition: "applicable";
360
- capability: string;
361
360
  authority_domain: string;
361
+ capability: string;
362
362
  contract_scope: string | null;
363
363
  } | {
364
364
  source_ref: string;
@@ -366,8 +366,8 @@ export declare const indexerParserExecutionPlanSchema: z.ZodObject<{
366
366
  module_ref: string | null;
367
367
  normalized_path: string;
368
368
  disposition: "not-applicable" | "excluded-by-scope" | "unsupported-format";
369
- capability: string;
370
369
  authority_domain: string;
370
+ capability: string;
371
371
  reason_code: string;
372
372
  contract_scope: string | null;
373
373
  })[];