@c4a/context 0.7.9 → 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 (78) hide show
  1. package/articleStructure.d.ts +254 -0
  2. package/docs/guides/agent-dialogue.md +1 -1
  3. package/docs/guides/code-indexer-skill-authoring.md +76 -178
  4. package/docs/guides/indexer-provider-and-customization.md +93 -453
  5. package/docs/guides/indexer-skill-creation.md +107 -97
  6. package/docs/guides/knowledge-updates.md +35 -14
  7. package/docs/guides/markdown-indexer-skill-authoring.md +57 -134
  8. package/docs/reference/indexer-provider-protocol.md +52 -102
  9. package/docs/reference/package-templates.md +39 -65
  10. package/docs/reference/template-variables.md +2 -3
  11. package/index.d.ts +6 -10
  12. package/index.js +6441 -8771
  13. package/indexerAgentStepProtocol.d.ts +0 -910
  14. package/indexerApprovedKnowledge.d.ts +98 -359
  15. package/indexerArticlePlan.d.ts +3 -26
  16. package/indexerArtifact.d.ts +201 -70
  17. package/indexerArtifactPolicy.d.ts +0 -18
  18. package/indexerArtifactResult.d.ts +240 -888
  19. package/indexerAuthoringFixture.d.ts +0 -13
  20. package/indexerBenchmark.d.ts +2 -2
  21. package/indexerCandidateCompile.d.ts +123 -167
  22. package/indexerCatalogFallback.d.ts +32 -374
  23. package/indexerCollectionMapping.d.ts +2 -2
  24. package/indexerContentLayers.d.ts +187 -41
  25. package/indexerContractOverlay.d.ts +30 -44
  26. package/indexerControlledInvocation.d.ts +6 -6
  27. package/indexerControlledProgram.d.ts +959 -3020
  28. package/indexerDependencyView.d.ts +96 -96
  29. package/indexerEffectiveArtifact.d.ts +381 -242
  30. package/indexerExampleDecision.d.ts +134 -134
  31. package/indexerExampleIdentity.d.ts +6 -6
  32. package/indexerExampleIdentityAudit.d.ts +6 -6
  33. package/indexerInventoryDisposition.d.ts +0 -39
  34. package/indexerLayerComposition.d.ts +1378 -852
  35. package/indexerLayoutChange.d.ts +24 -33
  36. package/indexerLayoutProposalSet.d.ts +143 -137
  37. package/indexerLayoutResolver.d.ts +116 -101
  38. package/indexerLayoutTransition.d.ts +6 -6
  39. package/indexerMainLifecycle.d.ts +1 -11
  40. package/indexerMainRunLedger.d.ts +0 -14
  41. package/indexerMainRunProtocol.d.ts +806 -2530
  42. package/indexerMainWorkset.d.ts +0 -1212
  43. package/indexerNavigationArtifactPlan.d.ts +2 -2
  44. package/indexerOverlayQuestionApplyProposal.d.ts +0 -4
  45. package/indexerParserCoordinate.d.ts +2 -2
  46. package/indexerParserExecutionPlan.d.ts +42 -42
  47. package/indexerPartitionPlan.d.ts +24 -354
  48. package/indexerPhysicalArtifactManifest.d.ts +12 -27
  49. package/indexerPostAuthorComposition.d.ts +2 -253
  50. package/indexerPostAuthorRunLedger.d.ts +860 -562
  51. package/indexerPrimaryProjection.d.ts +2 -2
  52. package/indexerPrimaryResultView.d.ts +0 -318
  53. package/indexerProfileContract.d.ts +200 -549
  54. package/indexerProgramExecutionAuthorization.d.ts +4 -4
  55. package/indexerProgramRunProtocol.d.ts +806 -2527
  56. package/indexerProjectProposal.d.ts +8 -8
  57. package/indexerProjectedArtifactFanOutAudit.d.ts +8 -8
  58. package/indexerProjectedArtifactPlan.d.ts +0 -9
  59. package/indexerProvider.d.ts +46 -288
  60. package/indexerProviderComposition.d.ts +16 -42
  61. package/indexerQuestionAuthority.d.ts +2 -82
  62. package/indexerReaderTargetInventory.d.ts +6 -6
  63. package/indexerRequirementLifecycle.d.ts +6 -6
  64. package/indexerResultReconciliation.d.ts +35 -149
  65. package/indexerSemanticInput.d.ts +10642 -4685
  66. package/indexerStructuredDeclaration.d.ts +24 -24
  67. package/indexerTemplateRendering.d.ts +239 -113
  68. package/knowledgeMap.d.ts +5 -5
  69. package/package.json +1 -1
  70. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +13 -16
  71. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +9 -9
  72. package/indexerArtifactDependencies.d.ts +0 -693
  73. package/indexerCompositionFactDependencies.d.ts +0 -16
  74. package/indexerExampleFactDependencies.d.ts +0 -17
  75. package/indexerIncrementalImpact.d.ts +0 -221
  76. package/indexerKnowledgeDependency.d.ts +0 -46
  77. package/indexerSubjectCatalog.d.ts +0 -230
  78. package/indexerSubjectKeyAuthority.d.ts +0 -786
@@ -11,8 +11,8 @@ declare const exampleObservationSchema: z.ZodObject<{
11
11
  evidence_refs: z.ZodArray<z.ZodString, "many">;
12
12
  }, "strict", z.ZodTypeAny, {
13
13
  source_ref: string;
14
- evidence_refs: string[];
15
14
  content_digest: string;
15
+ evidence_refs: string[];
16
16
  module_ref: string | null;
17
17
  observation_ref: string;
18
18
  example_ref: string;
@@ -21,8 +21,8 @@ declare const exampleObservationSchema: z.ZodObject<{
21
21
  full_relative_path: string;
22
22
  }, {
23
23
  source_ref: string;
24
- evidence_refs: string[];
25
24
  content_digest: string;
25
+ evidence_refs: string[];
26
26
  module_ref: string | null;
27
27
  observation_ref: string;
28
28
  example_ref: string;
@@ -45,8 +45,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
45
45
  evidence_refs: z.ZodArray<z.ZodString, "many">;
46
46
  }, "strict", z.ZodTypeAny, {
47
47
  source_ref: string;
48
- evidence_refs: string[];
49
48
  content_digest: string;
49
+ evidence_refs: string[];
50
50
  module_ref: string | null;
51
51
  observation_ref: string;
52
52
  example_ref: string;
@@ -55,8 +55,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
55
55
  full_relative_path: string;
56
56
  }, {
57
57
  source_ref: string;
58
- evidence_refs: string[];
59
58
  content_digest: string;
59
+ evidence_refs: string[];
60
60
  module_ref: string | null;
61
61
  observation_ref: string;
62
62
  example_ref: string;
@@ -71,8 +71,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
71
71
  source_scope_digest: string;
72
72
  observations: {
73
73
  source_ref: string;
74
- evidence_refs: string[];
75
74
  content_digest: string;
75
+ evidence_refs: string[];
76
76
  module_ref: string | null;
77
77
  observation_ref: string;
78
78
  example_ref: string;
@@ -86,8 +86,8 @@ export declare const indexerExampleInventorySchema: z.ZodObject<{
86
86
  source_scope_digest: string;
87
87
  observations: {
88
88
  source_ref: string;
89
- evidence_refs: string[];
90
89
  content_digest: string;
90
+ evidence_refs: string[];
91
91
  module_ref: string | null;
92
92
  observation_ref: string;
93
93
  example_ref: string;
@@ -29,6 +29,9 @@ export declare const indexerExampleIdentityAuditSchema: z.ZodObject<{
29
29
  }, "strict", z.ZodTypeAny, {
30
30
  protocol: "context.indexer.example-identity-audit/v1";
31
31
  inventory_digest: string;
32
+ observation_count: number;
33
+ unique_example_count: number;
34
+ collision_count: number;
32
35
  collisions: {
33
36
  example_ref: string;
34
37
  public_target_ref: string;
@@ -36,14 +39,14 @@ export declare const indexerExampleIdentityAuditSchema: z.ZodObject<{
36
39
  full_relative_path: string;
37
40
  observation_refs: string[];
38
41
  }[];
39
- observation_count: number;
40
- unique_example_count: number;
41
- collision_count: number;
42
42
  pass: boolean;
43
43
  audit_digest: string;
44
44
  }, {
45
45
  protocol: "context.indexer.example-identity-audit/v1";
46
46
  inventory_digest: string;
47
+ observation_count: number;
48
+ unique_example_count: number;
49
+ collision_count: number;
47
50
  collisions: {
48
51
  example_ref: string;
49
52
  public_target_ref: string;
@@ -51,9 +54,6 @@ export declare const indexerExampleIdentityAuditSchema: z.ZodObject<{
51
54
  full_relative_path: string;
52
55
  observation_refs: string[];
53
56
  }[];
54
- observation_count: number;
55
- unique_example_count: number;
56
- collision_count: number;
57
57
  pass: boolean;
58
58
  audit_digest: string;
59
59
  }>;
@@ -21,20 +21,16 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
21
21
  section_evidence: z.ZodArray<z.ZodObject<{
22
22
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
23
23
  section_key: z.ZodEffects<z.ZodString, string, string>;
24
- evidence_refs: z.ZodArray<z.ZodString, "many">;
25
24
  }, "strict", z.ZodTypeAny, {
26
- evidence_refs: string[];
27
25
  section_key: string;
28
26
  artifact_id: string;
29
27
  }, {
30
- evidence_refs: string[];
31
28
  section_key: string;
32
29
  artifact_id: string;
33
30
  }>, "many">;
34
31
  }, "strict", z.ZodTypeAny, {
35
32
  member_id: string;
36
33
  section_evidence: {
37
- evidence_refs: string[];
38
34
  section_key: string;
39
35
  artifact_id: string;
40
36
  }[];
@@ -44,7 +40,6 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
44
40
  }, {
45
41
  member_id: string;
46
42
  section_evidence: {
47
- evidence_refs: string[];
48
43
  section_key: string;
49
44
  artifact_id: string;
50
45
  }[];
@@ -74,15 +69,12 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
74
69
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
75
70
  inventory_disposition: z.ZodLiteral<"owned">;
76
71
  projection_disposition: z.ZodLiteral<"catalog-only">;
77
- fact_refs: z.ZodArray<z.ZodString, "many">;
78
72
  }, "strict", z.ZodTypeAny, {
79
- fact_refs: string[];
80
73
  member_id: string;
81
74
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
82
75
  inventory_disposition: "owned";
83
76
  projection_disposition: "catalog-only";
84
77
  }, {
85
- fact_refs: string[];
86
78
  member_id: string;
87
79
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
88
80
  inventory_disposition: "owned";
@@ -92,15 +84,12 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
92
84
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
93
85
  inventory_disposition: z.ZodLiteral<"owned">;
94
86
  projection_disposition: z.ZodLiteral<"boundary-only">;
95
- evidence_refs: z.ZodArray<z.ZodString, "many">;
96
87
  }, "strict", z.ZodTypeAny, {
97
- evidence_refs: string[];
98
88
  member_id: string;
99
89
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
100
90
  inventory_disposition: "owned";
101
91
  projection_disposition: "boundary-only";
102
92
  }, {
103
- evidence_refs: string[];
104
93
  member_id: string;
105
94
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
106
95
  inventory_disposition: "owned";
@@ -110,15 +99,12 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
110
99
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
111
100
  inventory_disposition: z.ZodLiteral<"excluded-with-reason">;
112
101
  reason_code: z.ZodEffects<z.ZodString, string, string>;
113
- evidence_refs: z.ZodArray<z.ZodString, "many">;
114
102
  }, "strict", z.ZodTypeAny, {
115
- evidence_refs: string[];
116
103
  member_id: string;
117
104
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
118
105
  inventory_disposition: "excluded-with-reason";
119
106
  reason_code: string;
120
107
  }, {
121
- evidence_refs: string[];
122
108
  member_id: string;
123
109
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
124
110
  inventory_disposition: "excluded-with-reason";
@@ -169,20 +155,16 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
169
155
  section_evidence: z.ZodArray<z.ZodObject<{
170
156
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
171
157
  section_key: z.ZodEffects<z.ZodString, string, string>;
172
- evidence_refs: z.ZodArray<z.ZodString, "many">;
173
158
  }, "strict", z.ZodTypeAny, {
174
- evidence_refs: string[];
175
159
  section_key: string;
176
160
  artifact_id: string;
177
161
  }, {
178
- evidence_refs: string[];
179
162
  section_key: string;
180
163
  artifact_id: string;
181
164
  }>, "many">;
182
165
  }, "strict", z.ZodTypeAny, {
183
166
  member_id: string;
184
167
  section_evidence: {
185
- evidence_refs: string[];
186
168
  section_key: string;
187
169
  artifact_id: string;
188
170
  }[];
@@ -192,7 +174,6 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
192
174
  }, {
193
175
  member_id: string;
194
176
  section_evidence: {
195
- evidence_refs: string[];
196
177
  section_key: string;
197
178
  artifact_id: string;
198
179
  }[];
@@ -222,15 +203,12 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
222
203
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
223
204
  inventory_disposition: z.ZodLiteral<"owned">;
224
205
  projection_disposition: z.ZodLiteral<"catalog-only">;
225
- fact_refs: z.ZodArray<z.ZodString, "many">;
226
206
  }, "strict", z.ZodTypeAny, {
227
- fact_refs: string[];
228
207
  member_id: string;
229
208
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
230
209
  inventory_disposition: "owned";
231
210
  projection_disposition: "catalog-only";
232
211
  }, {
233
- fact_refs: string[];
234
212
  member_id: string;
235
213
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
236
214
  inventory_disposition: "owned";
@@ -240,15 +218,12 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
240
218
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
241
219
  inventory_disposition: z.ZodLiteral<"owned">;
242
220
  projection_disposition: z.ZodLiteral<"boundary-only">;
243
- evidence_refs: z.ZodArray<z.ZodString, "many">;
244
221
  }, "strict", z.ZodTypeAny, {
245
- evidence_refs: string[];
246
222
  member_id: string;
247
223
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
248
224
  inventory_disposition: "owned";
249
225
  projection_disposition: "boundary-only";
250
226
  }, {
251
- evidence_refs: string[];
252
227
  member_id: string;
253
228
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
254
229
  inventory_disposition: "owned";
@@ -258,15 +233,12 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
258
233
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
259
234
  inventory_disposition: z.ZodLiteral<"excluded-with-reason">;
260
235
  reason_code: z.ZodEffects<z.ZodString, string, string>;
261
- evidence_refs: z.ZodArray<z.ZodString, "many">;
262
236
  }, "strict", z.ZodTypeAny, {
263
- evidence_refs: string[];
264
237
  member_id: string;
265
238
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
266
239
  inventory_disposition: "excluded-with-reason";
267
240
  reason_code: string;
268
241
  }, {
269
- evidence_refs: string[];
270
242
  member_id: string;
271
243
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
272
244
  inventory_disposition: "excluded-with-reason";
@@ -313,7 +285,6 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
313
285
  dispositions: ({
314
286
  member_id: string;
315
287
  section_evidence: {
316
- evidence_refs: string[];
317
288
  section_key: string;
318
289
  artifact_id: string;
319
290
  }[];
@@ -327,19 +298,16 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
327
298
  inventory_disposition: "owned";
328
299
  projection_disposition: "capability-group";
329
300
  } | {
330
- fact_refs: string[];
331
301
  member_id: string;
332
302
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
333
303
  inventory_disposition: "owned";
334
304
  projection_disposition: "catalog-only";
335
305
  } | {
336
- evidence_refs: string[];
337
306
  member_id: string;
338
307
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
339
308
  inventory_disposition: "owned";
340
309
  projection_disposition: "boundary-only";
341
310
  } | {
342
- evidence_refs: string[];
343
311
  member_id: string;
344
312
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
345
313
  inventory_disposition: "excluded-with-reason";
@@ -366,7 +334,6 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
366
334
  dispositions: ({
367
335
  member_id: string;
368
336
  section_evidence: {
369
- evidence_refs: string[];
370
337
  section_key: string;
371
338
  artifact_id: string;
372
339
  }[];
@@ -380,19 +347,16 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
380
347
  inventory_disposition: "owned";
381
348
  projection_disposition: "capability-group";
382
349
  } | {
383
- fact_refs: string[];
384
350
  member_id: string;
385
351
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
386
352
  inventory_disposition: "owned";
387
353
  projection_disposition: "catalog-only";
388
354
  } | {
389
- evidence_refs: string[];
390
355
  member_id: string;
391
356
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
392
357
  inventory_disposition: "owned";
393
358
  projection_disposition: "boundary-only";
394
359
  } | {
395
- evidence_refs: string[];
396
360
  member_id: string;
397
361
  member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
398
362
  inventory_disposition: "excluded-with-reason";
@@ -415,7 +379,6 @@ export type IndexerInventoryDispositionSet = z.infer<typeof indexerInventoryDisp
415
379
  export interface IndexerDispositionSectionEvidenceInventoryItem {
416
380
  artifact_id: string;
417
381
  section_key: string;
418
- evidence_refs: readonly string[];
419
382
  }
420
383
  export interface IndexerDispositionCapabilityGroupMembership {
421
384
  capability_group_ref: string;
@@ -434,8 +397,6 @@ export declare function buildIndexerInventoryDispositionSet(input: {
434
397
  export declare function validateIndexerInventoryDispositionSet(input: {
435
398
  value: unknown;
436
399
  workset: IndexerMainAuthorWorkset;
437
- known_evidence_refs: readonly string[];
438
- known_fact_refs: readonly string[];
439
400
  section_evidence_inventory: readonly IndexerDispositionSectionEvidenceInventoryItem[];
440
401
  capability_group_memberships: readonly IndexerDispositionCapabilityGroupMembership[];
441
402
  material_gap_proposal_refs: readonly string[];