@c4a/context 0.7.5 → 0.7.9

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 (98) hide show
  1. package/README.md +12 -4
  2. package/README.zh-CN.md +11 -4
  3. package/docs/README.md +13 -1
  4. package/docs/README.zh-CN.md +13 -1
  5. package/docs/getting-started.md +95 -69
  6. package/docs/guides/agent-dialogue.md +20 -9
  7. package/docs/guides/agent-guide.md +48 -10
  8. package/docs/guides/code-indexer-skill-authoring.md +42 -11
  9. package/docs/guides/indexer-manifest-example.md +103 -0
  10. package/docs/guides/indexer-provider-and-customization.md +334 -15
  11. package/docs/guides/indexer-skill-creation.md +99 -0
  12. package/docs/guides/knowledge-updates.md +422 -0
  13. package/docs/guides/lark-resources.md +5 -1
  14. package/docs/guides/markdown-indexer-skill-authoring.md +16 -7
  15. package/docs/guides/note.md +37 -0
  16. package/docs/guides/package-outputs.md +231 -60
  17. package/docs/guides/sessions.md +50 -0
  18. package/docs/guides/workspace-commit.md +45 -0
  19. package/docs/guides/workspace-prepare.md +72 -0
  20. package/docs/guides/workspace-restore.md +59 -0
  21. package/docs/reference/code-extractors.md +23 -11
  22. package/docs/reference/indexer-provider-protocol.md +135 -22
  23. package/docs/reference/package-templates.md +10 -9
  24. package/docs/reference/project-api.md +100 -13
  25. package/docs/reference/template-variables.md +7 -7
  26. package/index.d.ts +15 -0
  27. package/index.js +1708 -626
  28. package/indexerAgentStepProtocol.d.ts +44 -0
  29. package/indexerApprovedKnowledge.d.ts +371 -0
  30. package/indexerArticlePlan.d.ts +83 -0
  31. package/indexerArtifact.d.ts +10 -7
  32. package/indexerArtifactDependencies.d.ts +5 -5
  33. package/indexerArtifactPolicy.d.ts +12 -12
  34. package/indexerArtifactResult.d.ts +76 -69
  35. package/indexerAuthoringFixture.d.ts +8 -8
  36. package/indexerAuthorizedWorksetView.d.ts +14 -14
  37. package/indexerBaseQuestionAmendment.d.ts +40 -0
  38. package/indexerCandidateCompile.d.ts +46 -36
  39. package/indexerCatalogFallback.d.ts +566 -48
  40. package/indexerContentLayers.d.ts +6 -4
  41. package/indexerContractDeclaration.d.ts +3 -0
  42. package/indexerControlledProgram.d.ts +1039 -238
  43. package/indexerCustomizationDraft.d.ts +188 -0
  44. package/indexerDependencyView.d.ts +17 -17
  45. package/indexerEffectiveArtifact.d.ts +26 -15
  46. package/indexerExampleFactDependencies.d.ts +17 -0
  47. package/indexerExampleIdentityAudit.d.ts +2 -2
  48. package/indexerInventoryDisposition.d.ts +44 -44
  49. package/indexerKnowledgeDependency.d.ts +46 -0
  50. package/indexerLayerComposition.d.ts +92 -54
  51. package/indexerLayoutChange.d.ts +8 -8
  52. package/indexerLayoutProposalSet.d.ts +15 -10
  53. package/indexerLayoutResolver.d.ts +15 -6
  54. package/indexerLayoutTransition.d.ts +8 -8
  55. package/indexerLifecycle.d.ts +1 -1
  56. package/indexerMainRunLedger.d.ts +3 -0
  57. package/indexerMainRunProtocol.d.ts +872 -196
  58. package/indexerMainWorkset.d.ts +50 -0
  59. package/indexerNavigationArtifactPlan.d.ts +2 -2
  60. package/indexerOverlayQuestionAmendment.d.ts +56 -16
  61. package/indexerOverlayQuestionApplyProposal.d.ts +98 -26
  62. package/indexerPartitionPlan.d.ts +585 -40
  63. package/indexerPhysicalArtifactAudit.d.ts +2 -2
  64. package/indexerPhysicalArtifactManifest.d.ts +24 -24
  65. package/indexerPostAuthorRunLedger.d.ts +60 -34
  66. package/indexerPrimaryProjection.d.ts +2 -2
  67. package/indexerProfileContract.d.ts +28 -28
  68. package/indexerProgramRunProtocol.d.ts +868 -194
  69. package/indexerProjectProposal.d.ts +36 -8
  70. package/indexerProjectedArtifactFanOutAudit.d.ts +2 -2
  71. package/indexerProtocolHash.d.ts +2 -0
  72. package/indexerProvider.d.ts +102 -58
  73. package/indexerProviderComposition.d.ts +4 -4
  74. package/indexerProviderRouting.d.ts +52 -0
  75. package/indexerProviderSelectionProposal.d.ts +48 -0
  76. package/indexerPublicContractFacts.d.ts +7 -0
  77. package/indexerPublicContractTable.d.ts +11 -0
  78. package/indexerReaderTargetInventory.d.ts +6 -6
  79. package/indexerReferenceOnlyAudit.d.ts +2 -2
  80. package/indexerRegistry.d.ts +658 -0
  81. package/indexerRequirementConfirmation.d.ts +48 -16
  82. package/indexerRequirementLifecycle.d.ts +154 -42
  83. package/indexerResultReconciliation.d.ts +12 -11
  84. package/indexerSemanticInput.d.ts +27168 -3813
  85. package/{indexerGeneratedAuthoringAudit.d.ts → indexerStructuredClaims.d.ts} +0 -84
  86. package/indexerStructuredDeclaration.d.ts +8 -8
  87. package/indexerTemplateRendering.d.ts +7 -7
  88. package/indexerToolSnapshot.d.ts +16 -16
  89. package/knowledgeMap.d.ts +188 -0
  90. package/managedSources.d.ts +15 -0
  91. package/package.json +1 -1
  92. package/packageSite.d.ts +25 -0
  93. package/phases.d.ts +0 -3
  94. package/processedScopes.d.ts +75 -0
  95. package/sessionMetadata.d.ts +49 -0
  96. package/sources.d.ts +9 -3
  97. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +15 -10
  98. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +8 -8
@@ -148,7 +148,6 @@ export declare const indexerPhysicalArtifactAuditSchema: z.ZodObject<{
148
148
  artifact_ref: string | null;
149
149
  }[];
150
150
  state: "passed" | "failed";
151
- audit_digest: string;
152
151
  summary: {
153
152
  logical_unit_count: number;
154
153
  planned_bundle_artifact_count: number;
@@ -161,6 +160,7 @@ export declare const indexerPhysicalArtifactAuditSchema: z.ZodObject<{
161
160
  missing_artifact_count: number;
162
161
  unresolved_material_artifact_count: number;
163
162
  };
163
+ audit_digest: string;
164
164
  layout_proposal_set_digest: string;
165
165
  artifact_manifest_digest: string;
166
166
  logical_unit_fan_out: {
@@ -187,7 +187,6 @@ export declare const indexerPhysicalArtifactAuditSchema: z.ZodObject<{
187
187
  artifact_ref: string | null;
188
188
  }[];
189
189
  state: "passed" | "failed";
190
- audit_digest: string;
191
190
  summary: {
192
191
  logical_unit_count: number;
193
192
  planned_bundle_artifact_count: number;
@@ -200,6 +199,7 @@ export declare const indexerPhysicalArtifactAuditSchema: z.ZodObject<{
200
199
  missing_artifact_count: number;
201
200
  unresolved_material_artifact_count: number;
202
201
  };
202
+ audit_digest: string;
203
203
  layout_proposal_set_digest: string;
204
204
  artifact_manifest_digest: string;
205
205
  logical_unit_fan_out: {
@@ -13,9 +13,9 @@ export declare const indexerPhysicalArtifactOwnerSchema: z.ZodDiscriminatedUnion
13
13
  material_state: z.ZodEnum<["ready", "blocked"]>;
14
14
  }, "strict", z.ZodTypeAny, {
15
15
  kind: "logical-unit";
16
+ purpose: "required" | "discretionary" | "semantic-split";
16
17
  artifact_kind: string;
17
18
  artifact_id: string;
18
- purpose: "required" | "discretionary" | "semantic-split";
19
19
  split_of: string | null;
20
20
  logical_unit_ref: string;
21
21
  bundle_digest: string;
@@ -25,9 +25,9 @@ export declare const indexerPhysicalArtifactOwnerSchema: z.ZodDiscriminatedUnion
25
25
  material_state: "blocked" | "ready";
26
26
  }, {
27
27
  kind: "logical-unit";
28
+ purpose: "required" | "discretionary" | "semantic-split";
28
29
  artifact_kind: string;
29
30
  artifact_id: string;
30
- purpose: "required" | "discretionary" | "semantic-split";
31
31
  split_of: string | null;
32
32
  logical_unit_ref: string;
33
33
  bundle_digest: string;
@@ -47,16 +47,16 @@ export declare const indexerPhysicalArtifactOwnerSchema: z.ZodDiscriminatedUnion
47
47
  kind: "navigation";
48
48
  artifact_kind: string;
49
49
  artifact_id: string;
50
- plan_digest: string;
51
50
  artifact_ref: string;
51
+ plan_digest: string;
52
52
  navigation_ref: string;
53
53
  child_artifact_refs: string[];
54
54
  }, {
55
55
  kind: "navigation";
56
56
  artifact_kind: string;
57
57
  artifact_id: string;
58
- plan_digest: string;
59
58
  artifact_ref: string;
59
+ plan_digest: string;
60
60
  navigation_ref: string;
61
61
  child_artifact_refs: string[];
62
62
  }>, z.ZodObject<{
@@ -90,9 +90,9 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
90
90
  material_state: z.ZodEnum<["ready", "blocked"]>;
91
91
  }, "strict", z.ZodTypeAny, {
92
92
  kind: "logical-unit";
93
+ purpose: "required" | "discretionary" | "semantic-split";
93
94
  artifact_kind: string;
94
95
  artifact_id: string;
95
- purpose: "required" | "discretionary" | "semantic-split";
96
96
  split_of: string | null;
97
97
  logical_unit_ref: string;
98
98
  bundle_digest: string;
@@ -102,9 +102,9 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
102
102
  material_state: "blocked" | "ready";
103
103
  }, {
104
104
  kind: "logical-unit";
105
+ purpose: "required" | "discretionary" | "semantic-split";
105
106
  artifact_kind: string;
106
107
  artifact_id: string;
107
- purpose: "required" | "discretionary" | "semantic-split";
108
108
  split_of: string | null;
109
109
  logical_unit_ref: string;
110
110
  bundle_digest: string;
@@ -124,16 +124,16 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
124
124
  kind: "navigation";
125
125
  artifact_kind: string;
126
126
  artifact_id: string;
127
- plan_digest: string;
128
127
  artifact_ref: string;
128
+ plan_digest: string;
129
129
  navigation_ref: string;
130
130
  child_artifact_refs: string[];
131
131
  }, {
132
132
  kind: "navigation";
133
133
  artifact_kind: string;
134
134
  artifact_id: string;
135
- plan_digest: string;
136
135
  artifact_ref: string;
136
+ plan_digest: string;
137
137
  navigation_ref: string;
138
138
  child_artifact_refs: string[];
139
139
  }>, z.ZodObject<{
@@ -151,9 +151,9 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
151
151
  empty: boolean;
152
152
  owner: {
153
153
  kind: "logical-unit";
154
+ purpose: "required" | "discretionary" | "semantic-split";
154
155
  artifact_kind: string;
155
156
  artifact_id: string;
156
- purpose: "required" | "discretionary" | "semantic-split";
157
157
  split_of: string | null;
158
158
  logical_unit_ref: string;
159
159
  bundle_digest: string;
@@ -165,8 +165,8 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
165
165
  kind: "navigation";
166
166
  artifact_kind: string;
167
167
  artifact_id: string;
168
- plan_digest: string;
169
168
  artifact_ref: string;
169
+ plan_digest: string;
170
170
  navigation_ref: string;
171
171
  child_artifact_refs: string[];
172
172
  } | {
@@ -182,9 +182,9 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
182
182
  empty: boolean;
183
183
  owner: {
184
184
  kind: "logical-unit";
185
+ purpose: "required" | "discretionary" | "semantic-split";
185
186
  artifact_kind: string;
186
187
  artifact_id: string;
187
- purpose: "required" | "discretionary" | "semantic-split";
188
188
  split_of: string | null;
189
189
  logical_unit_ref: string;
190
190
  bundle_digest: string;
@@ -196,8 +196,8 @@ declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
196
196
  kind: "navigation";
197
197
  artifact_kind: string;
198
198
  artifact_id: string;
199
- plan_digest: string;
200
199
  artifact_ref: string;
200
+ plan_digest: string;
201
201
  navigation_ref: string;
202
202
  child_artifact_refs: string[];
203
203
  } | {
@@ -233,9 +233,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
233
233
  material_state: z.ZodEnum<["ready", "blocked"]>;
234
234
  }, "strict", z.ZodTypeAny, {
235
235
  kind: "logical-unit";
236
+ purpose: "required" | "discretionary" | "semantic-split";
236
237
  artifact_kind: string;
237
238
  artifact_id: string;
238
- purpose: "required" | "discretionary" | "semantic-split";
239
239
  split_of: string | null;
240
240
  logical_unit_ref: string;
241
241
  bundle_digest: string;
@@ -245,9 +245,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
245
245
  material_state: "blocked" | "ready";
246
246
  }, {
247
247
  kind: "logical-unit";
248
+ purpose: "required" | "discretionary" | "semantic-split";
248
249
  artifact_kind: string;
249
250
  artifact_id: string;
250
- purpose: "required" | "discretionary" | "semantic-split";
251
251
  split_of: string | null;
252
252
  logical_unit_ref: string;
253
253
  bundle_digest: string;
@@ -267,16 +267,16 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
267
267
  kind: "navigation";
268
268
  artifact_kind: string;
269
269
  artifact_id: string;
270
- plan_digest: string;
271
270
  artifact_ref: string;
271
+ plan_digest: string;
272
272
  navigation_ref: string;
273
273
  child_artifact_refs: string[];
274
274
  }, {
275
275
  kind: "navigation";
276
276
  artifact_kind: string;
277
277
  artifact_id: string;
278
- plan_digest: string;
279
278
  artifact_ref: string;
279
+ plan_digest: string;
280
280
  navigation_ref: string;
281
281
  child_artifact_refs: string[];
282
282
  }>, z.ZodObject<{
@@ -294,9 +294,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
294
294
  empty: boolean;
295
295
  owner: {
296
296
  kind: "logical-unit";
297
+ purpose: "required" | "discretionary" | "semantic-split";
297
298
  artifact_kind: string;
298
299
  artifact_id: string;
299
- purpose: "required" | "discretionary" | "semantic-split";
300
300
  split_of: string | null;
301
301
  logical_unit_ref: string;
302
302
  bundle_digest: string;
@@ -308,8 +308,8 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
308
308
  kind: "navigation";
309
309
  artifact_kind: string;
310
310
  artifact_id: string;
311
- plan_digest: string;
312
311
  artifact_ref: string;
312
+ plan_digest: string;
313
313
  navigation_ref: string;
314
314
  child_artifact_refs: string[];
315
315
  } | {
@@ -325,9 +325,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
325
325
  empty: boolean;
326
326
  owner: {
327
327
  kind: "logical-unit";
328
+ purpose: "required" | "discretionary" | "semantic-split";
328
329
  artifact_kind: string;
329
330
  artifact_id: string;
330
- purpose: "required" | "discretionary" | "semantic-split";
331
331
  split_of: string | null;
332
332
  logical_unit_ref: string;
333
333
  bundle_digest: string;
@@ -339,8 +339,8 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
339
339
  kind: "navigation";
340
340
  artifact_kind: string;
341
341
  artifact_id: string;
342
- plan_digest: string;
343
342
  artifact_ref: string;
343
+ plan_digest: string;
344
344
  navigation_ref: string;
345
345
  child_artifact_refs: string[];
346
346
  } | {
@@ -360,9 +360,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
360
360
  empty: boolean;
361
361
  owner: {
362
362
  kind: "logical-unit";
363
+ purpose: "required" | "discretionary" | "semantic-split";
363
364
  artifact_kind: string;
364
365
  artifact_id: string;
365
- purpose: "required" | "discretionary" | "semantic-split";
366
366
  split_of: string | null;
367
367
  logical_unit_ref: string;
368
368
  bundle_digest: string;
@@ -374,8 +374,8 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
374
374
  kind: "navigation";
375
375
  artifact_kind: string;
376
376
  artifact_id: string;
377
- plan_digest: string;
378
377
  artifact_ref: string;
378
+ plan_digest: string;
379
379
  navigation_ref: string;
380
380
  child_artifact_refs: string[];
381
381
  } | {
@@ -396,9 +396,9 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
396
396
  empty: boolean;
397
397
  owner: {
398
398
  kind: "logical-unit";
399
+ purpose: "required" | "discretionary" | "semantic-split";
399
400
  artifact_kind: string;
400
401
  artifact_id: string;
401
- purpose: "required" | "discretionary" | "semantic-split";
402
402
  split_of: string | null;
403
403
  logical_unit_ref: string;
404
404
  bundle_digest: string;
@@ -410,8 +410,8 @@ export declare const indexerArtifactManifestSchema: z.ZodObject<{
410
410
  kind: "navigation";
411
411
  artifact_kind: string;
412
412
  artifact_id: string;
413
- plan_digest: string;
414
413
  artifact_ref: string;
414
+ plan_digest: string;
415
415
  navigation_ref: string;
416
416
  child_artifact_refs: string[];
417
417
  } | {