@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
@@ -7,10 +7,10 @@ export declare const indexerInventoryMemberSchema: z.ZodObject<{
7
7
  member_kind: z.ZodEnum<["project", "document", "entry", "route", "component", "service", "method", "example", "protocol-method", "handler", "event-branch", "timer-branch", "downstream-callsite", "store", "state-transition"]>;
8
8
  }, "strict", z.ZodTypeAny, {
9
9
  member_id: string;
10
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
10
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
11
11
  }, {
12
12
  member_id: string;
13
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
13
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
14
14
  }>;
15
15
  export type IndexerInventoryMember = z.infer<typeof indexerInventoryMemberSchema>;
16
16
  declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
@@ -38,7 +38,7 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
38
38
  section_key: string;
39
39
  artifact_id: string;
40
40
  }[];
41
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
41
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
42
42
  inventory_disposition: "owned";
43
43
  projection_disposition: "detailed";
44
44
  }, {
@@ -48,7 +48,7 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
48
48
  section_key: string;
49
49
  artifact_id: string;
50
50
  }[];
51
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
51
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
52
52
  inventory_disposition: "owned";
53
53
  projection_disposition: "detailed";
54
54
  }>, z.ZodObject<{
@@ -60,13 +60,13 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
60
60
  }, "strict", z.ZodTypeAny, {
61
61
  member_id: string;
62
62
  capability_group_ref: string;
63
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
63
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
64
64
  inventory_disposition: "owned";
65
65
  projection_disposition: "capability-group";
66
66
  }, {
67
67
  member_id: string;
68
68
  capability_group_ref: string;
69
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
69
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
70
70
  inventory_disposition: "owned";
71
71
  projection_disposition: "capability-group";
72
72
  }>, z.ZodObject<{
@@ -78,13 +78,13 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
78
78
  }, "strict", z.ZodTypeAny, {
79
79
  fact_refs: string[];
80
80
  member_id: string;
81
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
81
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
82
82
  inventory_disposition: "owned";
83
83
  projection_disposition: "catalog-only";
84
84
  }, {
85
85
  fact_refs: string[];
86
86
  member_id: string;
87
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
87
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
88
88
  inventory_disposition: "owned";
89
89
  projection_disposition: "catalog-only";
90
90
  }>, z.ZodObject<{
@@ -96,13 +96,13 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
96
96
  }, "strict", z.ZodTypeAny, {
97
97
  evidence_refs: string[];
98
98
  member_id: string;
99
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
99
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
100
100
  inventory_disposition: "owned";
101
101
  projection_disposition: "boundary-only";
102
102
  }, {
103
103
  evidence_refs: string[];
104
104
  member_id: string;
105
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
105
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
106
106
  inventory_disposition: "owned";
107
107
  projection_disposition: "boundary-only";
108
108
  }>, z.ZodObject<{
@@ -114,13 +114,13 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
114
114
  }, "strict", z.ZodTypeAny, {
115
115
  evidence_refs: string[];
116
116
  member_id: string;
117
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
117
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
118
118
  inventory_disposition: "excluded-with-reason";
119
119
  reason_code: string;
120
120
  }, {
121
121
  evidence_refs: string[];
122
122
  member_id: string;
123
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
123
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
124
124
  inventory_disposition: "excluded-with-reason";
125
125
  reason_code: string;
126
126
  }>, z.ZodObject<{
@@ -130,12 +130,12 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
130
130
  missing_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
131
131
  }, "strict", z.ZodTypeAny, {
132
132
  member_id: string;
133
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
133
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
134
134
  inventory_disposition: "unsupported";
135
135
  missing_capabilities: string[];
136
136
  }, {
137
137
  member_id: string;
138
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
138
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
139
139
  inventory_disposition: "unsupported";
140
140
  missing_capabilities: string[];
141
141
  }>, z.ZodObject<{
@@ -145,12 +145,12 @@ declare const inventoryDispositionSchema: z.ZodUnion<[z.ZodObject<{
145
145
  material_question_proposal_ref: z.ZodString;
146
146
  }, "strict", z.ZodTypeAny, {
147
147
  member_id: string;
148
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
148
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
149
149
  inventory_disposition: "request-material";
150
150
  material_question_proposal_ref: string;
151
151
  }, {
152
152
  member_id: string;
153
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
153
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
154
154
  inventory_disposition: "request-material";
155
155
  material_question_proposal_ref: string;
156
156
  }>]>;
@@ -186,7 +186,7 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
186
186
  section_key: string;
187
187
  artifact_id: string;
188
188
  }[];
189
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
189
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
190
190
  inventory_disposition: "owned";
191
191
  projection_disposition: "detailed";
192
192
  }, {
@@ -196,7 +196,7 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
196
196
  section_key: string;
197
197
  artifact_id: string;
198
198
  }[];
199
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
199
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
200
200
  inventory_disposition: "owned";
201
201
  projection_disposition: "detailed";
202
202
  }>, z.ZodObject<{
@@ -208,13 +208,13 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
208
208
  }, "strict", z.ZodTypeAny, {
209
209
  member_id: string;
210
210
  capability_group_ref: string;
211
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
211
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
212
212
  inventory_disposition: "owned";
213
213
  projection_disposition: "capability-group";
214
214
  }, {
215
215
  member_id: string;
216
216
  capability_group_ref: string;
217
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
217
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
218
218
  inventory_disposition: "owned";
219
219
  projection_disposition: "capability-group";
220
220
  }>, z.ZodObject<{
@@ -226,13 +226,13 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
226
226
  }, "strict", z.ZodTypeAny, {
227
227
  fact_refs: string[];
228
228
  member_id: string;
229
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
229
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
230
230
  inventory_disposition: "owned";
231
231
  projection_disposition: "catalog-only";
232
232
  }, {
233
233
  fact_refs: string[];
234
234
  member_id: string;
235
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
235
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
236
236
  inventory_disposition: "owned";
237
237
  projection_disposition: "catalog-only";
238
238
  }>, z.ZodObject<{
@@ -244,13 +244,13 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
244
244
  }, "strict", z.ZodTypeAny, {
245
245
  evidence_refs: string[];
246
246
  member_id: string;
247
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
247
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
248
248
  inventory_disposition: "owned";
249
249
  projection_disposition: "boundary-only";
250
250
  }, {
251
251
  evidence_refs: string[];
252
252
  member_id: string;
253
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
253
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
254
254
  inventory_disposition: "owned";
255
255
  projection_disposition: "boundary-only";
256
256
  }>, z.ZodObject<{
@@ -262,13 +262,13 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
262
262
  }, "strict", z.ZodTypeAny, {
263
263
  evidence_refs: string[];
264
264
  member_id: string;
265
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
265
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
266
266
  inventory_disposition: "excluded-with-reason";
267
267
  reason_code: string;
268
268
  }, {
269
269
  evidence_refs: string[];
270
270
  member_id: string;
271
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
271
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
272
272
  inventory_disposition: "excluded-with-reason";
273
273
  reason_code: string;
274
274
  }>, z.ZodObject<{
@@ -278,12 +278,12 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
278
278
  missing_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
279
279
  }, "strict", z.ZodTypeAny, {
280
280
  member_id: string;
281
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
281
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
282
282
  inventory_disposition: "unsupported";
283
283
  missing_capabilities: string[];
284
284
  }, {
285
285
  member_id: string;
286
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
286
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
287
287
  inventory_disposition: "unsupported";
288
288
  missing_capabilities: string[];
289
289
  }>, z.ZodObject<{
@@ -293,12 +293,12 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
293
293
  material_question_proposal_ref: z.ZodString;
294
294
  }, "strict", z.ZodTypeAny, {
295
295
  member_id: string;
296
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
296
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
297
297
  inventory_disposition: "request-material";
298
298
  material_question_proposal_ref: string;
299
299
  }, {
300
300
  member_id: string;
301
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
301
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
302
302
  inventory_disposition: "request-material";
303
303
  material_question_proposal_ref: string;
304
304
  }>]>, "many">;
@@ -317,41 +317,41 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
317
317
  section_key: string;
318
318
  artifact_id: string;
319
319
  }[];
320
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
320
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
321
321
  inventory_disposition: "owned";
322
322
  projection_disposition: "detailed";
323
323
  } | {
324
324
  member_id: string;
325
325
  capability_group_ref: string;
326
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
326
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
327
327
  inventory_disposition: "owned";
328
328
  projection_disposition: "capability-group";
329
329
  } | {
330
330
  fact_refs: string[];
331
331
  member_id: string;
332
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
332
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
333
333
  inventory_disposition: "owned";
334
334
  projection_disposition: "catalog-only";
335
335
  } | {
336
336
  evidence_refs: string[];
337
337
  member_id: string;
338
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
338
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
339
339
  inventory_disposition: "owned";
340
340
  projection_disposition: "boundary-only";
341
341
  } | {
342
342
  evidence_refs: string[];
343
343
  member_id: string;
344
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
344
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
345
345
  inventory_disposition: "excluded-with-reason";
346
346
  reason_code: string;
347
347
  } | {
348
348
  member_id: string;
349
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
349
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
350
350
  inventory_disposition: "unsupported";
351
351
  missing_capabilities: string[];
352
352
  } | {
353
353
  member_id: string;
354
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
354
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
355
355
  inventory_disposition: "request-material";
356
356
  material_question_proposal_ref: string;
357
357
  })[];
@@ -370,41 +370,41 @@ export declare const indexerInventoryDispositionSetSchema: z.ZodObject<{
370
370
  section_key: string;
371
371
  artifact_id: string;
372
372
  }[];
373
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
373
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
374
374
  inventory_disposition: "owned";
375
375
  projection_disposition: "detailed";
376
376
  } | {
377
377
  member_id: string;
378
378
  capability_group_ref: string;
379
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
379
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
380
380
  inventory_disposition: "owned";
381
381
  projection_disposition: "capability-group";
382
382
  } | {
383
383
  fact_refs: string[];
384
384
  member_id: string;
385
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
385
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
386
386
  inventory_disposition: "owned";
387
387
  projection_disposition: "catalog-only";
388
388
  } | {
389
389
  evidence_refs: string[];
390
390
  member_id: string;
391
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
391
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
392
392
  inventory_disposition: "owned";
393
393
  projection_disposition: "boundary-only";
394
394
  } | {
395
395
  evidence_refs: string[];
396
396
  member_id: string;
397
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
397
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
398
398
  inventory_disposition: "excluded-with-reason";
399
399
  reason_code: string;
400
400
  } | {
401
401
  member_id: string;
402
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
402
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
403
403
  inventory_disposition: "unsupported";
404
404
  missing_capabilities: string[];
405
405
  } | {
406
406
  member_id: string;
407
- member_kind: "document" | "handler" | "entry" | "project" | "route" | "component" | "service" | "method" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
407
+ member_kind: "document" | "component" | "handler" | "method" | "entry" | "project" | "route" | "service" | "example" | "protocol-method" | "event-branch" | "timer-branch" | "downstream-callsite" | "store" | "state-transition";
408
408
  inventory_disposition: "request-material";
409
409
  material_question_proposal_ref: string;
410
410
  })[];
@@ -0,0 +1,46 @@
1
+ import { z } from "zod";
2
+ /** Supporting knowledge is referenced by identity, never copied into the
3
+ * primary inventory ownership of a second topic. */
4
+ export declare const indexerKnowledgeDependencySchema: z.ZodObject<{
5
+ artifact_ref: z.ZodString;
6
+ section_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
7
+ required: z.ZodDefault<z.ZodBoolean>;
8
+ }, "strict", z.ZodTypeAny, {
9
+ required: boolean;
10
+ artifact_ref: string;
11
+ section_refs: string[];
12
+ }, {
13
+ artifact_ref: string;
14
+ required?: boolean | undefined;
15
+ section_refs?: string[] | undefined;
16
+ }>;
17
+ export type IndexerKnowledgeDependency = z.infer<typeof indexerKnowledgeDependencySchema>;
18
+ export interface IndexerKnowledgeDependencyNode {
19
+ artifact_ref: string;
20
+ dependencies: readonly IndexerKnowledgeDependency[];
21
+ }
22
+ export declare class IndexerKnowledgeDependencyCycleError extends TypeError {
23
+ readonly artifact_refs: readonly string[];
24
+ constructor(artifact_refs: readonly string[]);
25
+ }
26
+ /** Missing dependencies may be produced later. Cycles cannot become ready by
27
+ * waiting, so reject them before any Author is scheduled. */
28
+ export declare function validateIndexerKnowledgeDependencyGraph(nodes: readonly IndexerKnowledgeDependencyNode[]): void;
29
+ export declare const indexerKnowledgeDependencyVersionSchema: z.ZodObject<{
30
+ artifact_ref: z.ZodString;
31
+ approved_content_digest: z.ZodString;
32
+ projection_digest: z.ZodString;
33
+ }, "strict", z.ZodTypeAny, {
34
+ artifact_ref: string;
35
+ approved_content_digest: string;
36
+ projection_digest: string;
37
+ }, {
38
+ artifact_ref: string;
39
+ approved_content_digest: string;
40
+ projection_digest: string;
41
+ }>;
42
+ export type IndexerKnowledgeDependencyVersion = z.infer<typeof indexerKnowledgeDependencyVersionSchema>;
43
+ export declare function indexerKnowledgeDependencyFingerprint(versions: readonly IndexerKnowledgeDependencyVersion[]): string;
44
+ /** A changed or removed dependency invalidates transitive readers as well.
45
+ * This returns identities for the existing update flow, not another queue. */
46
+ export declare function impactedIndexerKnowledgeArticles(nodes: readonly IndexerKnowledgeDependencyNode[], changed: ReadonlySet<string>): string[];