@fenglimg/fabric-shared 2.0.1 → 2.2.0-rc.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.
package/dist/index.d.ts CHANGED
@@ -1,6 +1,7 @@
1
- import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-UBqD9F0b.js';
2
- export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-UBqD9F0b.js';
3
- export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
1
+ import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-J3Xn5h2J.js';
2
+ export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as planContextTopKSchema, u as selectionTokenTtlMsSchema } from './index-J3Xn5h2J.js';
3
+ import { Translator } from './i18n/index.js';
4
+ export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
4
5
  import { z } from 'zod';
5
6
  import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';
6
7
  export { ArchiveScanInput, ArchiveScanOutput, CiteContractMetrics, CiteCoverageReport, CiteLayerTypeBreakdown, FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, FabReviewInput, FabReviewInputSchema, FabReviewInputShape, FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, KnowledgeTypeCode, KnowledgeTypeSchema, LayerSchema, Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, ProposedReason, ProposedReasonSchema, StableIdSchema, annotateIntentRequestSchema, archiveScanAnnotations, archiveScanInputSchema, archiveScanOutputSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, recallAnnotations, recallInputSchema, recallOutputSchema, structuredWarningSchema } from './schemas/api-contracts.js';
@@ -34,6 +35,7 @@ declare const ruleDescriptionSchema: z.ZodObject<{
34
35
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
35
36
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
36
37
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
38
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
37
39
  }, "strict", z.ZodTypeAny, {
38
40
  relevance_scope: "narrow" | "broad";
39
41
  relevance_paths: string[];
@@ -42,30 +44,32 @@ declare const ruleDescriptionSchema: z.ZodObject<{
42
44
  tech_stack: string[];
43
45
  impact: string[];
44
46
  must_read_if: string;
45
- entities?: string[] | undefined;
47
+ created_at?: string | undefined;
46
48
  id?: string | undefined;
49
+ entities?: string[] | undefined;
47
50
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
48
51
  maturity?: "draft" | "verified" | "proven" | undefined;
49
52
  knowledge_layer?: "personal" | "team" | undefined;
50
53
  layer_reason?: string | undefined;
51
- created_at?: string | undefined;
52
54
  tags?: string[] | undefined;
55
+ related?: string[] | undefined;
53
56
  }, {
54
57
  summary: string;
55
58
  intent_clues: string[];
56
59
  tech_stack: string[];
57
60
  impact: string[];
58
61
  must_read_if: string;
62
+ created_at?: string | undefined;
63
+ id?: string | undefined;
59
64
  relevance_scope?: "narrow" | "broad" | undefined;
60
65
  relevance_paths?: string[] | undefined;
61
66
  entities?: string[] | undefined;
62
- id?: string | undefined;
63
67
  knowledge_type?: unknown;
64
68
  maturity?: "draft" | "verified" | "proven" | undefined;
65
69
  knowledge_layer?: "personal" | "team" | undefined;
66
70
  layer_reason?: string | undefined;
67
- created_at?: string | undefined;
68
71
  tags?: string[] | undefined;
72
+ related?: string[] | undefined;
69
73
  }>;
70
74
  declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
71
75
  stable_id: z.ZodString;
@@ -88,6 +92,7 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
88
92
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
89
93
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
90
94
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
95
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
91
96
  }, "strict", z.ZodTypeAny, {
92
97
  relevance_scope: "narrow" | "broad";
93
98
  relevance_paths: string[];
@@ -96,30 +101,32 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
96
101
  tech_stack: string[];
97
102
  impact: string[];
98
103
  must_read_if: string;
99
- entities?: string[] | undefined;
104
+ created_at?: string | undefined;
100
105
  id?: string | undefined;
106
+ entities?: string[] | undefined;
101
107
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
102
108
  maturity?: "draft" | "verified" | "proven" | undefined;
103
109
  knowledge_layer?: "personal" | "team" | undefined;
104
110
  layer_reason?: string | undefined;
105
- created_at?: string | undefined;
106
111
  tags?: string[] | undefined;
112
+ related?: string[] | undefined;
107
113
  }, {
108
114
  summary: string;
109
115
  intent_clues: string[];
110
116
  tech_stack: string[];
111
117
  impact: string[];
112
118
  must_read_if: string;
119
+ created_at?: string | undefined;
120
+ id?: string | undefined;
113
121
  relevance_scope?: "narrow" | "broad" | undefined;
114
122
  relevance_paths?: string[] | undefined;
115
123
  entities?: string[] | undefined;
116
- id?: string | undefined;
117
124
  knowledge_type?: unknown;
118
125
  maturity?: "draft" | "verified" | "proven" | undefined;
119
126
  knowledge_layer?: "personal" | "team" | undefined;
120
127
  layer_reason?: string | undefined;
121
- created_at?: string | undefined;
122
128
  tags?: string[] | undefined;
129
+ related?: string[] | undefined;
123
130
  }>;
124
131
  }, "strict", z.ZodTypeAny, {
125
132
  description: {
@@ -130,14 +137,15 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
130
137
  tech_stack: string[];
131
138
  impact: string[];
132
139
  must_read_if: string;
133
- entities?: string[] | undefined;
140
+ created_at?: string | undefined;
134
141
  id?: string | undefined;
142
+ entities?: string[] | undefined;
135
143
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
136
144
  maturity?: "draft" | "verified" | "proven" | undefined;
137
145
  knowledge_layer?: "personal" | "team" | undefined;
138
146
  layer_reason?: string | undefined;
139
- created_at?: string | undefined;
140
147
  tags?: string[] | undefined;
148
+ related?: string[] | undefined;
141
149
  };
142
150
  stable_id: string;
143
151
  level: "L0" | "L1" | "L2";
@@ -150,16 +158,17 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
150
158
  tech_stack: string[];
151
159
  impact: string[];
152
160
  must_read_if: string;
161
+ created_at?: string | undefined;
162
+ id?: string | undefined;
153
163
  relevance_scope?: "narrow" | "broad" | undefined;
154
164
  relevance_paths?: string[] | undefined;
155
165
  entities?: string[] | undefined;
156
- id?: string | undefined;
157
166
  knowledge_type?: unknown;
158
167
  maturity?: "draft" | "verified" | "proven" | undefined;
159
168
  knowledge_layer?: "personal" | "team" | undefined;
160
169
  layer_reason?: string | undefined;
161
- created_at?: string | undefined;
162
170
  tags?: string[] | undefined;
171
+ related?: string[] | undefined;
163
172
  };
164
173
  stable_id: string;
165
174
  level: "L0" | "L1" | "L2";
@@ -199,6 +208,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
199
208
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
200
209
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
201
210
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
211
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
202
212
  }, "strict", z.ZodTypeAny, {
203
213
  relevance_scope: "narrow" | "broad";
204
214
  relevance_paths: string[];
@@ -207,30 +217,32 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
207
217
  tech_stack: string[];
208
218
  impact: string[];
209
219
  must_read_if: string;
210
- entities?: string[] | undefined;
220
+ created_at?: string | undefined;
211
221
  id?: string | undefined;
222
+ entities?: string[] | undefined;
212
223
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
213
224
  maturity?: "draft" | "verified" | "proven" | undefined;
214
225
  knowledge_layer?: "personal" | "team" | undefined;
215
226
  layer_reason?: string | undefined;
216
- created_at?: string | undefined;
217
227
  tags?: string[] | undefined;
228
+ related?: string[] | undefined;
218
229
  }, {
219
230
  summary: string;
220
231
  intent_clues: string[];
221
232
  tech_stack: string[];
222
233
  impact: string[];
223
234
  must_read_if: string;
235
+ created_at?: string | undefined;
236
+ id?: string | undefined;
224
237
  relevance_scope?: "narrow" | "broad" | undefined;
225
238
  relevance_paths?: string[] | undefined;
226
239
  entities?: string[] | undefined;
227
- id?: string | undefined;
228
240
  knowledge_type?: unknown;
229
241
  maturity?: "draft" | "verified" | "proven" | undefined;
230
242
  knowledge_layer?: "personal" | "team" | undefined;
231
243
  layer_reason?: string | undefined;
232
- created_at?: string | undefined;
233
244
  tags?: string[] | undefined;
245
+ related?: string[] | undefined;
234
246
  }>>;
235
247
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
236
248
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -266,6 +278,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
266
278
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
267
279
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
268
280
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
281
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
269
282
  }, "strict", z.ZodTypeAny, {
270
283
  relevance_scope: "narrow" | "broad";
271
284
  relevance_paths: string[];
@@ -274,30 +287,32 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
274
287
  tech_stack: string[];
275
288
  impact: string[];
276
289
  must_read_if: string;
277
- entities?: string[] | undefined;
290
+ created_at?: string | undefined;
278
291
  id?: string | undefined;
292
+ entities?: string[] | undefined;
279
293
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
280
294
  maturity?: "draft" | "verified" | "proven" | undefined;
281
295
  knowledge_layer?: "personal" | "team" | undefined;
282
296
  layer_reason?: string | undefined;
283
- created_at?: string | undefined;
284
297
  tags?: string[] | undefined;
298
+ related?: string[] | undefined;
285
299
  }, {
286
300
  summary: string;
287
301
  intent_clues: string[];
288
302
  tech_stack: string[];
289
303
  impact: string[];
290
304
  must_read_if: string;
305
+ created_at?: string | undefined;
306
+ id?: string | undefined;
291
307
  relevance_scope?: "narrow" | "broad" | undefined;
292
308
  relevance_paths?: string[] | undefined;
293
309
  entities?: string[] | undefined;
294
- id?: string | undefined;
295
310
  knowledge_type?: unknown;
296
311
  maturity?: "draft" | "verified" | "proven" | undefined;
297
312
  knowledge_layer?: "personal" | "team" | undefined;
298
313
  layer_reason?: string | undefined;
299
- created_at?: string | undefined;
300
314
  tags?: string[] | undefined;
315
+ related?: string[] | undefined;
301
316
  }>>;
302
317
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
303
318
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -333,6 +348,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
333
348
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
334
349
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
335
350
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
351
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
336
352
  }, "strict", z.ZodTypeAny, {
337
353
  relevance_scope: "narrow" | "broad";
338
354
  relevance_paths: string[];
@@ -341,30 +357,32 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
341
357
  tech_stack: string[];
342
358
  impact: string[];
343
359
  must_read_if: string;
344
- entities?: string[] | undefined;
360
+ created_at?: string | undefined;
345
361
  id?: string | undefined;
362
+ entities?: string[] | undefined;
346
363
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
347
364
  maturity?: "draft" | "verified" | "proven" | undefined;
348
365
  knowledge_layer?: "personal" | "team" | undefined;
349
366
  layer_reason?: string | undefined;
350
- created_at?: string | undefined;
351
367
  tags?: string[] | undefined;
368
+ related?: string[] | undefined;
352
369
  }, {
353
370
  summary: string;
354
371
  intent_clues: string[];
355
372
  tech_stack: string[];
356
373
  impact: string[];
357
374
  must_read_if: string;
375
+ created_at?: string | undefined;
376
+ id?: string | undefined;
358
377
  relevance_scope?: "narrow" | "broad" | undefined;
359
378
  relevance_paths?: string[] | undefined;
360
379
  entities?: string[] | undefined;
361
- id?: string | undefined;
362
380
  knowledge_type?: unknown;
363
381
  maturity?: "draft" | "verified" | "proven" | undefined;
364
382
  knowledge_layer?: "personal" | "team" | undefined;
365
383
  layer_reason?: string | undefined;
366
- created_at?: string | undefined;
367
384
  tags?: string[] | undefined;
385
+ related?: string[] | undefined;
368
386
  }>>;
369
387
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
370
388
  }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
@@ -400,6 +418,7 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
400
418
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
401
419
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
402
420
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
421
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
403
422
  }, "strict", z.ZodTypeAny, {
404
423
  relevance_scope: "narrow" | "broad";
405
424
  relevance_paths: string[];
@@ -408,30 +427,32 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
408
427
  tech_stack: string[];
409
428
  impact: string[];
410
429
  must_read_if: string;
411
- entities?: string[] | undefined;
430
+ created_at?: string | undefined;
412
431
  id?: string | undefined;
432
+ entities?: string[] | undefined;
413
433
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
414
434
  maturity?: "draft" | "verified" | "proven" | undefined;
415
435
  knowledge_layer?: "personal" | "team" | undefined;
416
436
  layer_reason?: string | undefined;
417
- created_at?: string | undefined;
418
437
  tags?: string[] | undefined;
438
+ related?: string[] | undefined;
419
439
  }, {
420
440
  summary: string;
421
441
  intent_clues: string[];
422
442
  tech_stack: string[];
423
443
  impact: string[];
424
444
  must_read_if: string;
445
+ created_at?: string | undefined;
446
+ id?: string | undefined;
425
447
  relevance_scope?: "narrow" | "broad" | undefined;
426
448
  relevance_paths?: string[] | undefined;
427
449
  entities?: string[] | undefined;
428
- id?: string | undefined;
429
450
  knowledge_type?: unknown;
430
451
  maturity?: "draft" | "verified" | "proven" | undefined;
431
452
  knowledge_layer?: "personal" | "team" | undefined;
432
453
  layer_reason?: string | undefined;
433
- created_at?: string | undefined;
434
454
  tags?: string[] | undefined;
455
+ related?: string[] | undefined;
435
456
  }>>;
436
457
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
437
458
  }, z.ZodTypeAny, "passthrough">, unknown>;
@@ -541,6 +562,7 @@ declare const agentsMetaSchema: z.ZodObject<{
541
562
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
542
563
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
543
564
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
565
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
544
566
  }, "strict", z.ZodTypeAny, {
545
567
  relevance_scope: "narrow" | "broad";
546
568
  relevance_paths: string[];
@@ -549,30 +571,32 @@ declare const agentsMetaSchema: z.ZodObject<{
549
571
  tech_stack: string[];
550
572
  impact: string[];
551
573
  must_read_if: string;
552
- entities?: string[] | undefined;
574
+ created_at?: string | undefined;
553
575
  id?: string | undefined;
576
+ entities?: string[] | undefined;
554
577
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
555
578
  maturity?: "draft" | "verified" | "proven" | undefined;
556
579
  knowledge_layer?: "personal" | "team" | undefined;
557
580
  layer_reason?: string | undefined;
558
- created_at?: string | undefined;
559
581
  tags?: string[] | undefined;
582
+ related?: string[] | undefined;
560
583
  }, {
561
584
  summary: string;
562
585
  intent_clues: string[];
563
586
  tech_stack: string[];
564
587
  impact: string[];
565
588
  must_read_if: string;
589
+ created_at?: string | undefined;
590
+ id?: string | undefined;
566
591
  relevance_scope?: "narrow" | "broad" | undefined;
567
592
  relevance_paths?: string[] | undefined;
568
593
  entities?: string[] | undefined;
569
- id?: string | undefined;
570
594
  knowledge_type?: unknown;
571
595
  maturity?: "draft" | "verified" | "proven" | undefined;
572
596
  knowledge_layer?: "personal" | "team" | undefined;
573
597
  layer_reason?: string | undefined;
574
- created_at?: string | undefined;
575
598
  tags?: string[] | undefined;
599
+ related?: string[] | undefined;
576
600
  }>>;
577
601
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
578
602
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -608,6 +632,7 @@ declare const agentsMetaSchema: z.ZodObject<{
608
632
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
609
633
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
610
634
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
635
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
611
636
  }, "strict", z.ZodTypeAny, {
612
637
  relevance_scope: "narrow" | "broad";
613
638
  relevance_paths: string[];
@@ -616,30 +641,32 @@ declare const agentsMetaSchema: z.ZodObject<{
616
641
  tech_stack: string[];
617
642
  impact: string[];
618
643
  must_read_if: string;
619
- entities?: string[] | undefined;
644
+ created_at?: string | undefined;
620
645
  id?: string | undefined;
646
+ entities?: string[] | undefined;
621
647
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
622
648
  maturity?: "draft" | "verified" | "proven" | undefined;
623
649
  knowledge_layer?: "personal" | "team" | undefined;
624
650
  layer_reason?: string | undefined;
625
- created_at?: string | undefined;
626
651
  tags?: string[] | undefined;
652
+ related?: string[] | undefined;
627
653
  }, {
628
654
  summary: string;
629
655
  intent_clues: string[];
630
656
  tech_stack: string[];
631
657
  impact: string[];
632
658
  must_read_if: string;
659
+ created_at?: string | undefined;
660
+ id?: string | undefined;
633
661
  relevance_scope?: "narrow" | "broad" | undefined;
634
662
  relevance_paths?: string[] | undefined;
635
663
  entities?: string[] | undefined;
636
- id?: string | undefined;
637
664
  knowledge_type?: unknown;
638
665
  maturity?: "draft" | "verified" | "proven" | undefined;
639
666
  knowledge_layer?: "personal" | "team" | undefined;
640
667
  layer_reason?: string | undefined;
641
- created_at?: string | undefined;
642
668
  tags?: string[] | undefined;
669
+ related?: string[] | undefined;
643
670
  }>>;
644
671
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
645
672
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -675,6 +702,7 @@ declare const agentsMetaSchema: z.ZodObject<{
675
702
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
676
703
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
677
704
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
705
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
678
706
  }, "strict", z.ZodTypeAny, {
679
707
  relevance_scope: "narrow" | "broad";
680
708
  relevance_paths: string[];
@@ -683,30 +711,32 @@ declare const agentsMetaSchema: z.ZodObject<{
683
711
  tech_stack: string[];
684
712
  impact: string[];
685
713
  must_read_if: string;
686
- entities?: string[] | undefined;
714
+ created_at?: string | undefined;
687
715
  id?: string | undefined;
716
+ entities?: string[] | undefined;
688
717
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
689
718
  maturity?: "draft" | "verified" | "proven" | undefined;
690
719
  knowledge_layer?: "personal" | "team" | undefined;
691
720
  layer_reason?: string | undefined;
692
- created_at?: string | undefined;
693
721
  tags?: string[] | undefined;
722
+ related?: string[] | undefined;
694
723
  }, {
695
724
  summary: string;
696
725
  intent_clues: string[];
697
726
  tech_stack: string[];
698
727
  impact: string[];
699
728
  must_read_if: string;
729
+ created_at?: string | undefined;
730
+ id?: string | undefined;
700
731
  relevance_scope?: "narrow" | "broad" | undefined;
701
732
  relevance_paths?: string[] | undefined;
702
733
  entities?: string[] | undefined;
703
- id?: string | undefined;
704
734
  knowledge_type?: unknown;
705
735
  maturity?: "draft" | "verified" | "proven" | undefined;
706
736
  knowledge_layer?: "personal" | "team" | undefined;
707
737
  layer_reason?: string | undefined;
708
- created_at?: string | undefined;
709
738
  tags?: string[] | undefined;
739
+ related?: string[] | undefined;
710
740
  }>>;
711
741
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
712
742
  }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
@@ -742,6 +772,7 @@ declare const agentsMetaSchema: z.ZodObject<{
742
772
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
743
773
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
744
774
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
775
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
745
776
  }, "strict", z.ZodTypeAny, {
746
777
  relevance_scope: "narrow" | "broad";
747
778
  relevance_paths: string[];
@@ -750,30 +781,32 @@ declare const agentsMetaSchema: z.ZodObject<{
750
781
  tech_stack: string[];
751
782
  impact: string[];
752
783
  must_read_if: string;
753
- entities?: string[] | undefined;
784
+ created_at?: string | undefined;
754
785
  id?: string | undefined;
786
+ entities?: string[] | undefined;
755
787
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
756
788
  maturity?: "draft" | "verified" | "proven" | undefined;
757
789
  knowledge_layer?: "personal" | "team" | undefined;
758
790
  layer_reason?: string | undefined;
759
- created_at?: string | undefined;
760
791
  tags?: string[] | undefined;
792
+ related?: string[] | undefined;
761
793
  }, {
762
794
  summary: string;
763
795
  intent_clues: string[];
764
796
  tech_stack: string[];
765
797
  impact: string[];
766
798
  must_read_if: string;
799
+ created_at?: string | undefined;
800
+ id?: string | undefined;
767
801
  relevance_scope?: "narrow" | "broad" | undefined;
768
802
  relevance_paths?: string[] | undefined;
769
803
  entities?: string[] | undefined;
770
- id?: string | undefined;
771
804
  knowledge_type?: unknown;
772
805
  maturity?: "draft" | "verified" | "proven" | undefined;
773
806
  knowledge_layer?: "personal" | "team" | undefined;
774
807
  layer_reason?: string | undefined;
775
- created_at?: string | undefined;
776
808
  tags?: string[] | undefined;
809
+ related?: string[] | undefined;
777
810
  }>>;
778
811
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
779
812
  }, z.ZodTypeAny, "passthrough">, unknown>>;
@@ -882,6 +915,7 @@ declare const agentsMetaSchema: z.ZodObject<{
882
915
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
883
916
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
884
917
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
918
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
885
919
  }, "strict", z.ZodTypeAny, {
886
920
  relevance_scope: "narrow" | "broad";
887
921
  relevance_paths: string[];
@@ -890,30 +924,32 @@ declare const agentsMetaSchema: z.ZodObject<{
890
924
  tech_stack: string[];
891
925
  impact: string[];
892
926
  must_read_if: string;
893
- entities?: string[] | undefined;
927
+ created_at?: string | undefined;
894
928
  id?: string | undefined;
929
+ entities?: string[] | undefined;
895
930
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
896
931
  maturity?: "draft" | "verified" | "proven" | undefined;
897
932
  knowledge_layer?: "personal" | "team" | undefined;
898
933
  layer_reason?: string | undefined;
899
- created_at?: string | undefined;
900
934
  tags?: string[] | undefined;
935
+ related?: string[] | undefined;
901
936
  }, {
902
937
  summary: string;
903
938
  intent_clues: string[];
904
939
  tech_stack: string[];
905
940
  impact: string[];
906
941
  must_read_if: string;
942
+ created_at?: string | undefined;
943
+ id?: string | undefined;
907
944
  relevance_scope?: "narrow" | "broad" | undefined;
908
945
  relevance_paths?: string[] | undefined;
909
946
  entities?: string[] | undefined;
910
- id?: string | undefined;
911
947
  knowledge_type?: unknown;
912
948
  maturity?: "draft" | "verified" | "proven" | undefined;
913
949
  knowledge_layer?: "personal" | "team" | undefined;
914
950
  layer_reason?: string | undefined;
915
- created_at?: string | undefined;
916
951
  tags?: string[] | undefined;
952
+ related?: string[] | undefined;
917
953
  }>>;
918
954
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
919
955
  }, z.ZodTypeAny, "passthrough">>;
@@ -1276,83 +1312,2032 @@ declare const humanLockEntrySchema: z.ZodObject<{
1276
1312
  start_line: number;
1277
1313
  end_line: number;
1278
1314
  }, {
1279
- file: string;
1280
- hash: string;
1281
- start_line: number;
1282
- end_line: number;
1315
+ file: string;
1316
+ hash: string;
1317
+ start_line: number;
1318
+ end_line: number;
1319
+ }>;
1320
+ declare const humanLockFileSchema: z.ZodObject<{
1321
+ locked: z.ZodOptional<z.ZodArray<z.ZodObject<{
1322
+ file: z.ZodString;
1323
+ start_line: z.ZodNumber;
1324
+ end_line: z.ZodNumber;
1325
+ hash: z.ZodString;
1326
+ }, "strip", z.ZodTypeAny, {
1327
+ file: string;
1328
+ hash: string;
1329
+ start_line: number;
1330
+ end_line: number;
1331
+ }, {
1332
+ file: string;
1333
+ hash: string;
1334
+ start_line: number;
1335
+ end_line: number;
1336
+ }>, "many">>;
1337
+ }, "strip", z.ZodTypeAny, {
1338
+ locked?: {
1339
+ file: string;
1340
+ hash: string;
1341
+ start_line: number;
1342
+ end_line: number;
1343
+ }[] | undefined;
1344
+ }, {
1345
+ locked?: {
1346
+ file: string;
1347
+ hash: string;
1348
+ start_line: number;
1349
+ end_line: number;
1350
+ }[] | undefined;
1351
+ }>;
1352
+
1353
+ type FabricConfigSchemaShape = z.infer<typeof fabricConfigSchema>;
1354
+ type PanelFieldGroup = "A_locale" | "B_hint_threshold" | "C_audit";
1355
+ type ValidateResult = {
1356
+ ok: true;
1357
+ value: unknown;
1358
+ } | {
1359
+ ok: false;
1360
+ error: string;
1361
+ };
1362
+ interface PanelFieldMeta {
1363
+ /** Schema key this field edits — type-checked against the inferred config shape. */
1364
+ readonly key: keyof FabricConfigSchemaShape;
1365
+ /** Logical grouping for panel section headers. */
1366
+ readonly group: PanelFieldGroup;
1367
+ /** Clack widget hint — `select` for enums, `text` for free-form numbers. */
1368
+ readonly widget: "select" | "text";
1369
+ /** i18n key for the field label; strings landed in TASK-006. */
1370
+ readonly label_i18n_key: string;
1371
+ /** i18n key for the field's description / help text. */
1372
+ readonly description_i18n_key: string;
1373
+ /** Default value pulled from the Zod schema's `.default(...)`. */
1374
+ readonly default: string | number;
1375
+ /** Enum options for `select` widgets, derived from the Zod enum schema. */
1376
+ readonly enum_values?: readonly string[];
1377
+ /** Validates raw user input from the TUI prompt. */
1378
+ validate(raw: string): ValidateResult;
1379
+ /** Renders a stored value back to the panel display string. */
1380
+ format_for_display(value: unknown): string;
1381
+ }
1382
+ /**
1383
+ * Returns the per-field metadata array driving the `fabric config` clack panel.
1384
+ * Group A (2) + Group B (8) + Group C (1) = 11 entries.
1385
+ */
1386
+ declare function getPanelFields(): readonly PanelFieldMeta[];
1387
+ /**
1388
+ * Lookup a single panel field by its config key. Returns `undefined` if the
1389
+ * key is not panel-scoped (e.g. Group D/E plumbing).
1390
+ */
1391
+ declare function getPanelFieldByKey(key: string): PanelFieldMeta | undefined;
1392
+
1393
+ declare const STORE_UUID_PATTERN: RegExp;
1394
+ declare const storeUuidSchema: z.ZodString;
1395
+ declare const PERSONAL_STORE_SENTINEL: "$personal";
1396
+ declare const storeIdentitySchema: z.ZodObject<{
1397
+ store_uuid: z.ZodString;
1398
+ created_at: z.ZodString;
1399
+ canonical_alias: z.ZodOptional<z.ZodString>;
1400
+ description: z.ZodOptional<z.ZodString>;
1401
+ allowed_scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1402
+ }, "strict", z.ZodTypeAny, {
1403
+ store_uuid: string;
1404
+ created_at: string;
1405
+ description?: string | undefined;
1406
+ canonical_alias?: string | undefined;
1407
+ allowed_scopes?: string[] | undefined;
1408
+ }, {
1409
+ store_uuid: string;
1410
+ created_at: string;
1411
+ description?: string | undefined;
1412
+ canonical_alias?: string | undefined;
1413
+ allowed_scopes?: string[] | undefined;
1414
+ }>;
1415
+ type StoreIdentity = z.infer<typeof storeIdentitySchema>;
1416
+ declare const requiredStoreEntrySchema: z.ZodObject<{
1417
+ id: z.ZodString;
1418
+ suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
1419
+ }, "strict", z.ZodTypeAny, {
1420
+ id: string;
1421
+ suggested_remote?: string | undefined;
1422
+ }, {
1423
+ id: string;
1424
+ suggested_remote?: string | undefined;
1425
+ }>;
1426
+ type RequiredStoreEntry = z.infer<typeof requiredStoreEntrySchema>;
1427
+ declare const STORE_KNOWLEDGE_TYPE_DIRS: readonly ["models", "decisions", "guidelines", "pitfalls", "processes"];
1428
+ declare const STORE_LAYOUT: {
1429
+ readonly identityFile: "store.json";
1430
+ readonly knowledgeDir: "knowledge";
1431
+ readonly bindingsDir: "bindings";
1432
+ readonly stateDir: "state";
1433
+ };
1434
+ type StoreLayout = typeof STORE_LAYOUT;
1435
+ declare const STORES_ROOT_DIR = "stores";
1436
+ declare const GLOBAL_STATE_DIR = "state";
1437
+ declare const GLOBAL_BINDINGS_DIR = "bindings";
1438
+ declare function storeKnowledgeTypeDir(type: (typeof STORE_KNOWLEDGE_TYPE_DIRS)[number]): string;
1439
+ declare function storeRelativePath(storeUuid: string): string;
1440
+ declare const mountedStoreSchema: z.ZodObject<{
1441
+ store_uuid: z.ZodString;
1442
+ alias: z.ZodString;
1443
+ remote: z.ZodOptional<z.ZodString>;
1444
+ personal: z.ZodOptional<z.ZodBoolean>;
1445
+ writable: z.ZodOptional<z.ZodBoolean>;
1446
+ }, "strict", z.ZodTypeAny, {
1447
+ store_uuid: string;
1448
+ alias: string;
1449
+ personal?: boolean | undefined;
1450
+ remote?: string | undefined;
1451
+ writable?: boolean | undefined;
1452
+ }, {
1453
+ store_uuid: string;
1454
+ alias: string;
1455
+ personal?: boolean | undefined;
1456
+ remote?: string | undefined;
1457
+ writable?: boolean | undefined;
1458
+ }>;
1459
+ type MountedStore = z.infer<typeof mountedStoreSchema>;
1460
+ declare const globalConfigSchema: z.ZodObject<{
1461
+ uid: z.ZodString;
1462
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1463
+ store_uuid: z.ZodString;
1464
+ alias: z.ZodString;
1465
+ remote: z.ZodOptional<z.ZodString>;
1466
+ personal: z.ZodOptional<z.ZodBoolean>;
1467
+ writable: z.ZodOptional<z.ZodBoolean>;
1468
+ }, "strict", z.ZodTypeAny, {
1469
+ store_uuid: string;
1470
+ alias: string;
1471
+ personal?: boolean | undefined;
1472
+ remote?: string | undefined;
1473
+ writable?: boolean | undefined;
1474
+ }, {
1475
+ store_uuid: string;
1476
+ alias: string;
1477
+ personal?: boolean | undefined;
1478
+ remote?: string | undefined;
1479
+ writable?: boolean | undefined;
1480
+ }>, "many">>>;
1481
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
1482
+ uid: z.ZodString;
1483
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1484
+ store_uuid: z.ZodString;
1485
+ alias: z.ZodString;
1486
+ remote: z.ZodOptional<z.ZodString>;
1487
+ personal: z.ZodOptional<z.ZodBoolean>;
1488
+ writable: z.ZodOptional<z.ZodBoolean>;
1489
+ }, "strict", z.ZodTypeAny, {
1490
+ store_uuid: string;
1491
+ alias: string;
1492
+ personal?: boolean | undefined;
1493
+ remote?: string | undefined;
1494
+ writable?: boolean | undefined;
1495
+ }, {
1496
+ store_uuid: string;
1497
+ alias: string;
1498
+ personal?: boolean | undefined;
1499
+ remote?: string | undefined;
1500
+ writable?: boolean | undefined;
1501
+ }>, "many">>>;
1502
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
1503
+ uid: z.ZodString;
1504
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1505
+ store_uuid: z.ZodString;
1506
+ alias: z.ZodString;
1507
+ remote: z.ZodOptional<z.ZodString>;
1508
+ personal: z.ZodOptional<z.ZodBoolean>;
1509
+ writable: z.ZodOptional<z.ZodBoolean>;
1510
+ }, "strict", z.ZodTypeAny, {
1511
+ store_uuid: string;
1512
+ alias: string;
1513
+ personal?: boolean | undefined;
1514
+ remote?: string | undefined;
1515
+ writable?: boolean | undefined;
1516
+ }, {
1517
+ store_uuid: string;
1518
+ alias: string;
1519
+ personal?: boolean | undefined;
1520
+ remote?: string | undefined;
1521
+ writable?: boolean | undefined;
1522
+ }>, "many">>>;
1523
+ }, z.ZodTypeAny, "passthrough">>;
1524
+ type GlobalConfig = z.infer<typeof globalConfigSchema>;
1525
+
1526
+ declare const PERSONAL_SCOPE: "personal";
1527
+ declare const KNOWN_SCOPE_PREFIXES: readonly ["personal", "team", "project", "org"];
1528
+ declare const SCOPE_COORDINATE_PATTERN: RegExp;
1529
+ declare const scopeCoordinateSchema: z.ZodString;
1530
+ type ScopeCoordinate = z.infer<typeof scopeCoordinateSchema>;
1531
+ declare function scopeRoot(coordinate: string): string;
1532
+ declare function isPersonalScope(coordinate: string): boolean;
1533
+ declare const entryScopeMetadataSchema: z.ZodObject<{
1534
+ semantic_scope: z.ZodString;
1535
+ visibility_store: z.ZodString;
1536
+ }, "strict", z.ZodTypeAny, {
1537
+ semantic_scope: string;
1538
+ visibility_store: string;
1539
+ }, {
1540
+ semantic_scope: string;
1541
+ visibility_store: string;
1542
+ }>;
1543
+ type EntryScopeMetadata = z.infer<typeof entryScopeMetadataSchema>;
1544
+
1545
+ declare const localKnowledgeIdSchema: z.ZodString;
1546
+ type LocalKnowledgeId = z.infer<typeof localKnowledgeIdSchema>;
1547
+ declare const UID_SEGMENT_PATTERN: RegExp;
1548
+ declare const uidSchema: z.ZodString;
1549
+ type Uid = z.infer<typeof uidSchema>;
1550
+ declare const GLOBAL_REF_PATTERN: RegExp;
1551
+ declare const globalRefSchema: z.ZodString;
1552
+ type GlobalRef = z.infer<typeof globalRefSchema>;
1553
+ interface ParsedGlobalRef {
1554
+ store_uuid: string;
1555
+ uid?: string;
1556
+ local_id: string;
1557
+ }
1558
+ declare function formatGlobalRef(parts: ParsedGlobalRef): string;
1559
+ declare function parseGlobalRef(ref: string): ParsedGlobalRef | null;
1560
+ declare const storeCountersSchema: z.ZodDefault<z.ZodObject<{
1561
+ KP: z.ZodDefault<z.ZodObject<{
1562
+ MOD: z.ZodDefault<z.ZodNumber>;
1563
+ DEC: z.ZodDefault<z.ZodNumber>;
1564
+ GLD: z.ZodDefault<z.ZodNumber>;
1565
+ PIT: z.ZodDefault<z.ZodNumber>;
1566
+ PRO: z.ZodDefault<z.ZodNumber>;
1567
+ }, "strip", z.ZodTypeAny, {
1568
+ MOD: number;
1569
+ DEC: number;
1570
+ GLD: number;
1571
+ PIT: number;
1572
+ PRO: number;
1573
+ }, {
1574
+ MOD?: number | undefined;
1575
+ DEC?: number | undefined;
1576
+ GLD?: number | undefined;
1577
+ PIT?: number | undefined;
1578
+ PRO?: number | undefined;
1579
+ }>>;
1580
+ KT: z.ZodDefault<z.ZodObject<{
1581
+ MOD: z.ZodDefault<z.ZodNumber>;
1582
+ DEC: z.ZodDefault<z.ZodNumber>;
1583
+ GLD: z.ZodDefault<z.ZodNumber>;
1584
+ PIT: z.ZodDefault<z.ZodNumber>;
1585
+ PRO: z.ZodDefault<z.ZodNumber>;
1586
+ }, "strip", z.ZodTypeAny, {
1587
+ MOD: number;
1588
+ DEC: number;
1589
+ GLD: number;
1590
+ PIT: number;
1591
+ PRO: number;
1592
+ }, {
1593
+ MOD?: number | undefined;
1594
+ DEC?: number | undefined;
1595
+ GLD?: number | undefined;
1596
+ PIT?: number | undefined;
1597
+ PRO?: number | undefined;
1598
+ }>>;
1599
+ }, "strip", z.ZodTypeAny, {
1600
+ KP: {
1601
+ MOD: number;
1602
+ DEC: number;
1603
+ GLD: number;
1604
+ PIT: number;
1605
+ PRO: number;
1606
+ };
1607
+ KT: {
1608
+ MOD: number;
1609
+ DEC: number;
1610
+ GLD: number;
1611
+ PIT: number;
1612
+ PRO: number;
1613
+ };
1614
+ }, {
1615
+ KP?: {
1616
+ MOD?: number | undefined;
1617
+ DEC?: number | undefined;
1618
+ GLD?: number | undefined;
1619
+ PIT?: number | undefined;
1620
+ PRO?: number | undefined;
1621
+ } | undefined;
1622
+ KT?: {
1623
+ MOD?: number | undefined;
1624
+ DEC?: number | undefined;
1625
+ GLD?: number | undefined;
1626
+ PIT?: number | undefined;
1627
+ PRO?: number | undefined;
1628
+ } | undefined;
1629
+ }>>;
1630
+ type StoreCounters = z.infer<typeof storeCountersSchema>;
1631
+
1632
+ declare const PARITY_CLIENTS: readonly ["claudeCode", "codexCLI", "cursor"];
1633
+ declare const parityClientSchema: z.ZodEnum<["claudeCode", "codexCLI", "cursor"]>;
1634
+ type ParityClient = z.infer<typeof parityClientSchema>;
1635
+ declare const PARITY_SURFACES: readonly ["skill", "hook", "mcp", "render"];
1636
+ declare const paritySurfaceSchema: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1637
+ type ParitySurface = z.infer<typeof paritySurfaceSchema>;
1638
+ declare const parityClientExpectationSchema: z.ZodObject<{
1639
+ supported: z.ZodBoolean;
1640
+ mechanism: z.ZodOptional<z.ZodString>;
1641
+ notes: z.ZodOptional<z.ZodString>;
1642
+ }, "strict", z.ZodTypeAny, {
1643
+ supported: boolean;
1644
+ mechanism?: string | undefined;
1645
+ notes?: string | undefined;
1646
+ }, {
1647
+ supported: boolean;
1648
+ mechanism?: string | undefined;
1649
+ notes?: string | undefined;
1650
+ }>;
1651
+ type ParityClientExpectation = z.infer<typeof parityClientExpectationSchema>;
1652
+ declare const parityCapabilitySchema: z.ZodObject<{
1653
+ id: z.ZodString;
1654
+ surface: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1655
+ description: z.ZodString;
1656
+ clients: z.ZodObject<{
1657
+ claudeCode: z.ZodObject<{
1658
+ supported: z.ZodBoolean;
1659
+ mechanism: z.ZodOptional<z.ZodString>;
1660
+ notes: z.ZodOptional<z.ZodString>;
1661
+ }, "strict", z.ZodTypeAny, {
1662
+ supported: boolean;
1663
+ mechanism?: string | undefined;
1664
+ notes?: string | undefined;
1665
+ }, {
1666
+ supported: boolean;
1667
+ mechanism?: string | undefined;
1668
+ notes?: string | undefined;
1669
+ }>;
1670
+ codexCLI: z.ZodObject<{
1671
+ supported: z.ZodBoolean;
1672
+ mechanism: z.ZodOptional<z.ZodString>;
1673
+ notes: z.ZodOptional<z.ZodString>;
1674
+ }, "strict", z.ZodTypeAny, {
1675
+ supported: boolean;
1676
+ mechanism?: string | undefined;
1677
+ notes?: string | undefined;
1678
+ }, {
1679
+ supported: boolean;
1680
+ mechanism?: string | undefined;
1681
+ notes?: string | undefined;
1682
+ }>;
1683
+ cursor: z.ZodObject<{
1684
+ supported: z.ZodBoolean;
1685
+ mechanism: z.ZodOptional<z.ZodString>;
1686
+ notes: z.ZodOptional<z.ZodString>;
1687
+ }, "strict", z.ZodTypeAny, {
1688
+ supported: boolean;
1689
+ mechanism?: string | undefined;
1690
+ notes?: string | undefined;
1691
+ }, {
1692
+ supported: boolean;
1693
+ mechanism?: string | undefined;
1694
+ notes?: string | undefined;
1695
+ }>;
1696
+ }, "strict", z.ZodTypeAny, {
1697
+ cursor: {
1698
+ supported: boolean;
1699
+ mechanism?: string | undefined;
1700
+ notes?: string | undefined;
1701
+ };
1702
+ codexCLI: {
1703
+ supported: boolean;
1704
+ mechanism?: string | undefined;
1705
+ notes?: string | undefined;
1706
+ };
1707
+ claudeCode: {
1708
+ supported: boolean;
1709
+ mechanism?: string | undefined;
1710
+ notes?: string | undefined;
1711
+ };
1712
+ }, {
1713
+ cursor: {
1714
+ supported: boolean;
1715
+ mechanism?: string | undefined;
1716
+ notes?: string | undefined;
1717
+ };
1718
+ codexCLI: {
1719
+ supported: boolean;
1720
+ mechanism?: string | undefined;
1721
+ notes?: string | undefined;
1722
+ };
1723
+ claudeCode: {
1724
+ supported: boolean;
1725
+ mechanism?: string | undefined;
1726
+ notes?: string | undefined;
1727
+ };
1728
+ }>;
1729
+ }, "strict", z.ZodTypeAny, {
1730
+ description: string;
1731
+ id: string;
1732
+ surface: "skill" | "hook" | "mcp" | "render";
1733
+ clients: {
1734
+ cursor: {
1735
+ supported: boolean;
1736
+ mechanism?: string | undefined;
1737
+ notes?: string | undefined;
1738
+ };
1739
+ codexCLI: {
1740
+ supported: boolean;
1741
+ mechanism?: string | undefined;
1742
+ notes?: string | undefined;
1743
+ };
1744
+ claudeCode: {
1745
+ supported: boolean;
1746
+ mechanism?: string | undefined;
1747
+ notes?: string | undefined;
1748
+ };
1749
+ };
1750
+ }, {
1751
+ description: string;
1752
+ id: string;
1753
+ surface: "skill" | "hook" | "mcp" | "render";
1754
+ clients: {
1755
+ cursor: {
1756
+ supported: boolean;
1757
+ mechanism?: string | undefined;
1758
+ notes?: string | undefined;
1759
+ };
1760
+ codexCLI: {
1761
+ supported: boolean;
1762
+ mechanism?: string | undefined;
1763
+ notes?: string | undefined;
1764
+ };
1765
+ claudeCode: {
1766
+ supported: boolean;
1767
+ mechanism?: string | undefined;
1768
+ notes?: string | undefined;
1769
+ };
1770
+ };
1771
+ }>;
1772
+ type ParityCapability = z.infer<typeof parityCapabilitySchema>;
1773
+ declare const parityMatrixSchema: z.ZodObject<{
1774
+ version: z.ZodString;
1775
+ generated_for: z.ZodString;
1776
+ capabilities: z.ZodArray<z.ZodObject<{
1777
+ id: z.ZodString;
1778
+ surface: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1779
+ description: z.ZodString;
1780
+ clients: z.ZodObject<{
1781
+ claudeCode: z.ZodObject<{
1782
+ supported: z.ZodBoolean;
1783
+ mechanism: z.ZodOptional<z.ZodString>;
1784
+ notes: z.ZodOptional<z.ZodString>;
1785
+ }, "strict", z.ZodTypeAny, {
1786
+ supported: boolean;
1787
+ mechanism?: string | undefined;
1788
+ notes?: string | undefined;
1789
+ }, {
1790
+ supported: boolean;
1791
+ mechanism?: string | undefined;
1792
+ notes?: string | undefined;
1793
+ }>;
1794
+ codexCLI: z.ZodObject<{
1795
+ supported: z.ZodBoolean;
1796
+ mechanism: z.ZodOptional<z.ZodString>;
1797
+ notes: z.ZodOptional<z.ZodString>;
1798
+ }, "strict", z.ZodTypeAny, {
1799
+ supported: boolean;
1800
+ mechanism?: string | undefined;
1801
+ notes?: string | undefined;
1802
+ }, {
1803
+ supported: boolean;
1804
+ mechanism?: string | undefined;
1805
+ notes?: string | undefined;
1806
+ }>;
1807
+ cursor: z.ZodObject<{
1808
+ supported: z.ZodBoolean;
1809
+ mechanism: z.ZodOptional<z.ZodString>;
1810
+ notes: z.ZodOptional<z.ZodString>;
1811
+ }, "strict", z.ZodTypeAny, {
1812
+ supported: boolean;
1813
+ mechanism?: string | undefined;
1814
+ notes?: string | undefined;
1815
+ }, {
1816
+ supported: boolean;
1817
+ mechanism?: string | undefined;
1818
+ notes?: string | undefined;
1819
+ }>;
1820
+ }, "strict", z.ZodTypeAny, {
1821
+ cursor: {
1822
+ supported: boolean;
1823
+ mechanism?: string | undefined;
1824
+ notes?: string | undefined;
1825
+ };
1826
+ codexCLI: {
1827
+ supported: boolean;
1828
+ mechanism?: string | undefined;
1829
+ notes?: string | undefined;
1830
+ };
1831
+ claudeCode: {
1832
+ supported: boolean;
1833
+ mechanism?: string | undefined;
1834
+ notes?: string | undefined;
1835
+ };
1836
+ }, {
1837
+ cursor: {
1838
+ supported: boolean;
1839
+ mechanism?: string | undefined;
1840
+ notes?: string | undefined;
1841
+ };
1842
+ codexCLI: {
1843
+ supported: boolean;
1844
+ mechanism?: string | undefined;
1845
+ notes?: string | undefined;
1846
+ };
1847
+ claudeCode: {
1848
+ supported: boolean;
1849
+ mechanism?: string | undefined;
1850
+ notes?: string | undefined;
1851
+ };
1852
+ }>;
1853
+ }, "strict", z.ZodTypeAny, {
1854
+ description: string;
1855
+ id: string;
1856
+ surface: "skill" | "hook" | "mcp" | "render";
1857
+ clients: {
1858
+ cursor: {
1859
+ supported: boolean;
1860
+ mechanism?: string | undefined;
1861
+ notes?: string | undefined;
1862
+ };
1863
+ codexCLI: {
1864
+ supported: boolean;
1865
+ mechanism?: string | undefined;
1866
+ notes?: string | undefined;
1867
+ };
1868
+ claudeCode: {
1869
+ supported: boolean;
1870
+ mechanism?: string | undefined;
1871
+ notes?: string | undefined;
1872
+ };
1873
+ };
1874
+ }, {
1875
+ description: string;
1876
+ id: string;
1877
+ surface: "skill" | "hook" | "mcp" | "render";
1878
+ clients: {
1879
+ cursor: {
1880
+ supported: boolean;
1881
+ mechanism?: string | undefined;
1882
+ notes?: string | undefined;
1883
+ };
1884
+ codexCLI: {
1885
+ supported: boolean;
1886
+ mechanism?: string | undefined;
1887
+ notes?: string | undefined;
1888
+ };
1889
+ claudeCode: {
1890
+ supported: boolean;
1891
+ mechanism?: string | undefined;
1892
+ notes?: string | undefined;
1893
+ };
1894
+ };
1895
+ }>, "many">;
1896
+ }, "strict", z.ZodTypeAny, {
1897
+ version: string;
1898
+ generated_for: string;
1899
+ capabilities: {
1900
+ description: string;
1901
+ id: string;
1902
+ surface: "skill" | "hook" | "mcp" | "render";
1903
+ clients: {
1904
+ cursor: {
1905
+ supported: boolean;
1906
+ mechanism?: string | undefined;
1907
+ notes?: string | undefined;
1908
+ };
1909
+ codexCLI: {
1910
+ supported: boolean;
1911
+ mechanism?: string | undefined;
1912
+ notes?: string | undefined;
1913
+ };
1914
+ claudeCode: {
1915
+ supported: boolean;
1916
+ mechanism?: string | undefined;
1917
+ notes?: string | undefined;
1918
+ };
1919
+ };
1920
+ }[];
1921
+ }, {
1922
+ version: string;
1923
+ generated_for: string;
1924
+ capabilities: {
1925
+ description: string;
1926
+ id: string;
1927
+ surface: "skill" | "hook" | "mcp" | "render";
1928
+ clients: {
1929
+ cursor: {
1930
+ supported: boolean;
1931
+ mechanism?: string | undefined;
1932
+ notes?: string | undefined;
1933
+ };
1934
+ codexCLI: {
1935
+ supported: boolean;
1936
+ mechanism?: string | undefined;
1937
+ notes?: string | undefined;
1938
+ };
1939
+ claudeCode: {
1940
+ supported: boolean;
1941
+ mechanism?: string | undefined;
1942
+ notes?: string | undefined;
1943
+ };
1944
+ };
1945
+ }[];
1946
+ }>;
1947
+ type ParityMatrix = z.infer<typeof parityMatrixSchema>;
1948
+
1949
+ declare const PROJECT_ROOT_SIGNALS: readonly ["env", "marker", "cwd", "repo"];
1950
+ declare const projectRootSignalSchema: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
1951
+ type ProjectRootSignal = z.infer<typeof projectRootSignalSchema>;
1952
+ declare const projectRootSignalsSchema: z.ZodObject<{
1953
+ env: z.ZodOptional<z.ZodString>;
1954
+ markerDir: z.ZodOptional<z.ZodString>;
1955
+ cwd: z.ZodString;
1956
+ repoRoot: z.ZodOptional<z.ZodString>;
1957
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
1958
+ }, "strict", z.ZodTypeAny, {
1959
+ cwd: string;
1960
+ env?: string | undefined;
1961
+ markerDir?: string | undefined;
1962
+ repoRoot?: string | undefined;
1963
+ discoveredProjectId?: string | undefined;
1964
+ }, {
1965
+ cwd: string;
1966
+ env?: string | undefined;
1967
+ markerDir?: string | undefined;
1968
+ repoRoot?: string | undefined;
1969
+ discoveredProjectId?: string | undefined;
1970
+ }>;
1971
+ type ProjectRootSignals = z.infer<typeof projectRootSignalsSchema>;
1972
+ declare const projectRootResolutionSchema: z.ZodObject<{
1973
+ projectRoot: z.ZodString;
1974
+ projectId: z.ZodNullable<z.ZodString>;
1975
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
1976
+ }, "strict", z.ZodTypeAny, {
1977
+ projectRoot: string;
1978
+ projectId: string | null;
1979
+ signalUsed: "env" | "marker" | "cwd" | "repo";
1980
+ }, {
1981
+ projectRoot: string;
1982
+ projectId: string | null;
1983
+ signalUsed: "env" | "marker" | "cwd" | "repo";
1984
+ }>;
1985
+ type ProjectRootResolution = z.infer<typeof projectRootResolutionSchema>;
1986
+ interface ProjectRootResolver {
1987
+ resolve(signals: ProjectRootSignals): ProjectRootResolution | null;
1988
+ }
1989
+ declare const STORE_RESOLVER_WARNING_CODES: readonly ["missing_store", "local_only_no_remote", "alias_unresolved"];
1990
+ declare const storeResolverWarningCodeSchema: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
1991
+ type StoreResolverWarningCode = z.infer<typeof storeResolverWarningCodeSchema>;
1992
+ declare const storeResolverWarningSchema: z.ZodObject<{
1993
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
1994
+ ref: z.ZodString;
1995
+ message: z.ZodString;
1996
+ }, "strict", z.ZodTypeAny, {
1997
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
1998
+ message: string;
1999
+ ref: string;
2000
+ }, {
2001
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2002
+ message: string;
2003
+ ref: string;
2004
+ }>;
2005
+ type StoreResolverWarning = z.infer<typeof storeResolverWarningSchema>;
2006
+ declare const readSetEntrySchema: z.ZodObject<{
2007
+ store_uuid: z.ZodString;
2008
+ alias: z.ZodString;
2009
+ remote: z.ZodOptional<z.ZodString>;
2010
+ writable: z.ZodBoolean;
2011
+ }, "strict", z.ZodTypeAny, {
2012
+ store_uuid: string;
2013
+ alias: string;
2014
+ writable: boolean;
2015
+ remote?: string | undefined;
2016
+ }, {
2017
+ store_uuid: string;
2018
+ alias: string;
2019
+ writable: boolean;
2020
+ remote?: string | undefined;
2021
+ }>;
2022
+ type ReadSetEntry = z.infer<typeof readSetEntrySchema>;
2023
+ declare const storeReadSetSchema: z.ZodObject<{
2024
+ stores: z.ZodArray<z.ZodObject<{
2025
+ store_uuid: z.ZodString;
2026
+ alias: z.ZodString;
2027
+ remote: z.ZodOptional<z.ZodString>;
2028
+ writable: z.ZodBoolean;
2029
+ }, "strict", z.ZodTypeAny, {
2030
+ store_uuid: string;
2031
+ alias: string;
2032
+ writable: boolean;
2033
+ remote?: string | undefined;
2034
+ }, {
2035
+ store_uuid: string;
2036
+ alias: string;
2037
+ writable: boolean;
2038
+ remote?: string | undefined;
2039
+ }>, "many">;
2040
+ warnings: z.ZodArray<z.ZodObject<{
2041
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2042
+ ref: z.ZodString;
2043
+ message: z.ZodString;
2044
+ }, "strict", z.ZodTypeAny, {
2045
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2046
+ message: string;
2047
+ ref: string;
2048
+ }, {
2049
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2050
+ message: string;
2051
+ ref: string;
2052
+ }>, "many">;
2053
+ }, "strict", z.ZodTypeAny, {
2054
+ stores: {
2055
+ store_uuid: string;
2056
+ alias: string;
2057
+ writable: boolean;
2058
+ remote?: string | undefined;
2059
+ }[];
2060
+ warnings: {
2061
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2062
+ message: string;
2063
+ ref: string;
2064
+ }[];
2065
+ }, {
2066
+ stores: {
2067
+ store_uuid: string;
2068
+ alias: string;
2069
+ writable: boolean;
2070
+ remote?: string | undefined;
2071
+ }[];
2072
+ warnings: {
2073
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2074
+ message: string;
2075
+ ref: string;
2076
+ }[];
2077
+ }>;
2078
+ type StoreReadSet = z.infer<typeof storeReadSetSchema>;
2079
+ declare const writeTargetSchema: z.ZodObject<{
2080
+ store_uuid: z.ZodString;
2081
+ alias: z.ZodString;
2082
+ }, "strict", z.ZodTypeAny, {
2083
+ store_uuid: string;
2084
+ alias: string;
2085
+ }, {
2086
+ store_uuid: string;
2087
+ alias: string;
2088
+ }>;
2089
+ type WriteTarget = z.infer<typeof writeTargetSchema>;
2090
+ declare const storeResolveInputSchema: z.ZodObject<{
2091
+ uid: z.ZodString;
2092
+ mountedStores: z.ZodArray<z.ZodObject<{
2093
+ store_uuid: z.ZodString;
2094
+ alias: z.ZodString;
2095
+ remote: z.ZodOptional<z.ZodString>;
2096
+ writable: z.ZodDefault<z.ZodBoolean>;
2097
+ personal: z.ZodDefault<z.ZodBoolean>;
2098
+ }, "strict", z.ZodTypeAny, {
2099
+ personal: boolean;
2100
+ store_uuid: string;
2101
+ alias: string;
2102
+ writable: boolean;
2103
+ remote?: string | undefined;
2104
+ }, {
2105
+ store_uuid: string;
2106
+ alias: string;
2107
+ personal?: boolean | undefined;
2108
+ remote?: string | undefined;
2109
+ writable?: boolean | undefined;
2110
+ }>, "many">;
2111
+ requiredStores: z.ZodArray<z.ZodObject<{
2112
+ id: z.ZodString;
2113
+ suggested_remote: z.ZodOptional<z.ZodString>;
2114
+ }, "strict", z.ZodTypeAny, {
2115
+ id: string;
2116
+ suggested_remote?: string | undefined;
2117
+ }, {
2118
+ id: string;
2119
+ suggested_remote?: string | undefined;
2120
+ }>, "many">;
2121
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2122
+ }, "strict", z.ZodTypeAny, {
2123
+ uid: string;
2124
+ mountedStores: {
2125
+ personal: boolean;
2126
+ store_uuid: string;
2127
+ alias: string;
2128
+ writable: boolean;
2129
+ remote?: string | undefined;
2130
+ }[];
2131
+ requiredStores: {
2132
+ id: string;
2133
+ suggested_remote?: string | undefined;
2134
+ }[];
2135
+ activeWriteAlias?: string | undefined;
2136
+ }, {
2137
+ uid: string;
2138
+ mountedStores: {
2139
+ store_uuid: string;
2140
+ alias: string;
2141
+ personal?: boolean | undefined;
2142
+ remote?: string | undefined;
2143
+ writable?: boolean | undefined;
2144
+ }[];
2145
+ requiredStores: {
2146
+ id: string;
2147
+ suggested_remote?: string | undefined;
2148
+ }[];
2149
+ activeWriteAlias?: string | undefined;
2150
+ }>;
2151
+ type StoreResolveInput = z.infer<typeof storeResolveInputSchema>;
2152
+ interface StoreResolver {
2153
+ resolveReadSet(input: StoreResolveInput): StoreReadSet;
2154
+ resolveWriteTarget(input: StoreResolveInput, scope: string): {
2155
+ target: WriteTarget | null;
2156
+ warnings: StoreResolverWarning[];
2157
+ };
2158
+ aliasToUuid(input: StoreResolveInput, alias: string): string | undefined;
2159
+ }
2160
+ declare const projectRootGoldenCaseSchema: z.ZodObject<{
2161
+ name: z.ZodString;
2162
+ note: z.ZodOptional<z.ZodString>;
2163
+ signals: z.ZodObject<{
2164
+ env: z.ZodOptional<z.ZodString>;
2165
+ markerDir: z.ZodOptional<z.ZodString>;
2166
+ cwd: z.ZodString;
2167
+ repoRoot: z.ZodOptional<z.ZodString>;
2168
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
2169
+ }, "strict", z.ZodTypeAny, {
2170
+ cwd: string;
2171
+ env?: string | undefined;
2172
+ markerDir?: string | undefined;
2173
+ repoRoot?: string | undefined;
2174
+ discoveredProjectId?: string | undefined;
2175
+ }, {
2176
+ cwd: string;
2177
+ env?: string | undefined;
2178
+ markerDir?: string | undefined;
2179
+ repoRoot?: string | undefined;
2180
+ discoveredProjectId?: string | undefined;
2181
+ }>;
2182
+ expected: z.ZodNullable<z.ZodObject<{
2183
+ projectRoot: z.ZodString;
2184
+ projectId: z.ZodNullable<z.ZodString>;
2185
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
2186
+ }, "strict", z.ZodTypeAny, {
2187
+ projectRoot: string;
2188
+ projectId: string | null;
2189
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2190
+ }, {
2191
+ projectRoot: string;
2192
+ projectId: string | null;
2193
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2194
+ }>>;
2195
+ }, "strict", z.ZodTypeAny, {
2196
+ expected: {
2197
+ projectRoot: string;
2198
+ projectId: string | null;
2199
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2200
+ } | null;
2201
+ name: string;
2202
+ signals: {
2203
+ cwd: string;
2204
+ env?: string | undefined;
2205
+ markerDir?: string | undefined;
2206
+ repoRoot?: string | undefined;
2207
+ discoveredProjectId?: string | undefined;
2208
+ };
2209
+ note?: string | undefined;
2210
+ }, {
2211
+ expected: {
2212
+ projectRoot: string;
2213
+ projectId: string | null;
2214
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2215
+ } | null;
2216
+ name: string;
2217
+ signals: {
2218
+ cwd: string;
2219
+ env?: string | undefined;
2220
+ markerDir?: string | undefined;
2221
+ repoRoot?: string | undefined;
2222
+ discoveredProjectId?: string | undefined;
2223
+ };
2224
+ note?: string | undefined;
2225
+ }>;
2226
+ type ProjectRootGoldenCase = z.infer<typeof projectRootGoldenCaseSchema>;
2227
+ declare const projectRootGoldenFileSchema: z.ZodObject<{
2228
+ contract: z.ZodLiteral<"project-root.golden">;
2229
+ cases: z.ZodArray<z.ZodObject<{
2230
+ name: z.ZodString;
2231
+ note: z.ZodOptional<z.ZodString>;
2232
+ signals: z.ZodObject<{
2233
+ env: z.ZodOptional<z.ZodString>;
2234
+ markerDir: z.ZodOptional<z.ZodString>;
2235
+ cwd: z.ZodString;
2236
+ repoRoot: z.ZodOptional<z.ZodString>;
2237
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
2238
+ }, "strict", z.ZodTypeAny, {
2239
+ cwd: string;
2240
+ env?: string | undefined;
2241
+ markerDir?: string | undefined;
2242
+ repoRoot?: string | undefined;
2243
+ discoveredProjectId?: string | undefined;
2244
+ }, {
2245
+ cwd: string;
2246
+ env?: string | undefined;
2247
+ markerDir?: string | undefined;
2248
+ repoRoot?: string | undefined;
2249
+ discoveredProjectId?: string | undefined;
2250
+ }>;
2251
+ expected: z.ZodNullable<z.ZodObject<{
2252
+ projectRoot: z.ZodString;
2253
+ projectId: z.ZodNullable<z.ZodString>;
2254
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
2255
+ }, "strict", z.ZodTypeAny, {
2256
+ projectRoot: string;
2257
+ projectId: string | null;
2258
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2259
+ }, {
2260
+ projectRoot: string;
2261
+ projectId: string | null;
2262
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2263
+ }>>;
2264
+ }, "strict", z.ZodTypeAny, {
2265
+ expected: {
2266
+ projectRoot: string;
2267
+ projectId: string | null;
2268
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2269
+ } | null;
2270
+ name: string;
2271
+ signals: {
2272
+ cwd: string;
2273
+ env?: string | undefined;
2274
+ markerDir?: string | undefined;
2275
+ repoRoot?: string | undefined;
2276
+ discoveredProjectId?: string | undefined;
2277
+ };
2278
+ note?: string | undefined;
2279
+ }, {
2280
+ expected: {
2281
+ projectRoot: string;
2282
+ projectId: string | null;
2283
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2284
+ } | null;
2285
+ name: string;
2286
+ signals: {
2287
+ cwd: string;
2288
+ env?: string | undefined;
2289
+ markerDir?: string | undefined;
2290
+ repoRoot?: string | undefined;
2291
+ discoveredProjectId?: string | undefined;
2292
+ };
2293
+ note?: string | undefined;
2294
+ }>, "many">;
2295
+ }, "strict", z.ZodTypeAny, {
2296
+ contract: "project-root.golden";
2297
+ cases: {
2298
+ expected: {
2299
+ projectRoot: string;
2300
+ projectId: string | null;
2301
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2302
+ } | null;
2303
+ name: string;
2304
+ signals: {
2305
+ cwd: string;
2306
+ env?: string | undefined;
2307
+ markerDir?: string | undefined;
2308
+ repoRoot?: string | undefined;
2309
+ discoveredProjectId?: string | undefined;
2310
+ };
2311
+ note?: string | undefined;
2312
+ }[];
2313
+ }, {
2314
+ contract: "project-root.golden";
2315
+ cases: {
2316
+ expected: {
2317
+ projectRoot: string;
2318
+ projectId: string | null;
2319
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2320
+ } | null;
2321
+ name: string;
2322
+ signals: {
2323
+ cwd: string;
2324
+ env?: string | undefined;
2325
+ markerDir?: string | undefined;
2326
+ repoRoot?: string | undefined;
2327
+ discoveredProjectId?: string | undefined;
2328
+ };
2329
+ note?: string | undefined;
2330
+ }[];
2331
+ }>;
2332
+ declare const readSetGoldenCaseSchema: z.ZodObject<{
2333
+ name: z.ZodString;
2334
+ note: z.ZodOptional<z.ZodString>;
2335
+ input: z.ZodObject<{
2336
+ uid: z.ZodString;
2337
+ mountedStores: z.ZodArray<z.ZodObject<{
2338
+ store_uuid: z.ZodString;
2339
+ alias: z.ZodString;
2340
+ remote: z.ZodOptional<z.ZodString>;
2341
+ writable: z.ZodDefault<z.ZodBoolean>;
2342
+ personal: z.ZodDefault<z.ZodBoolean>;
2343
+ }, "strict", z.ZodTypeAny, {
2344
+ personal: boolean;
2345
+ store_uuid: string;
2346
+ alias: string;
2347
+ writable: boolean;
2348
+ remote?: string | undefined;
2349
+ }, {
2350
+ store_uuid: string;
2351
+ alias: string;
2352
+ personal?: boolean | undefined;
2353
+ remote?: string | undefined;
2354
+ writable?: boolean | undefined;
2355
+ }>, "many">;
2356
+ requiredStores: z.ZodArray<z.ZodObject<{
2357
+ id: z.ZodString;
2358
+ suggested_remote: z.ZodOptional<z.ZodString>;
2359
+ }, "strict", z.ZodTypeAny, {
2360
+ id: string;
2361
+ suggested_remote?: string | undefined;
2362
+ }, {
2363
+ id: string;
2364
+ suggested_remote?: string | undefined;
2365
+ }>, "many">;
2366
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2367
+ }, "strict", z.ZodTypeAny, {
2368
+ uid: string;
2369
+ mountedStores: {
2370
+ personal: boolean;
2371
+ store_uuid: string;
2372
+ alias: string;
2373
+ writable: boolean;
2374
+ remote?: string | undefined;
2375
+ }[];
2376
+ requiredStores: {
2377
+ id: string;
2378
+ suggested_remote?: string | undefined;
2379
+ }[];
2380
+ activeWriteAlias?: string | undefined;
2381
+ }, {
2382
+ uid: string;
2383
+ mountedStores: {
2384
+ store_uuid: string;
2385
+ alias: string;
2386
+ personal?: boolean | undefined;
2387
+ remote?: string | undefined;
2388
+ writable?: boolean | undefined;
2389
+ }[];
2390
+ requiredStores: {
2391
+ id: string;
2392
+ suggested_remote?: string | undefined;
2393
+ }[];
2394
+ activeWriteAlias?: string | undefined;
2395
+ }>;
2396
+ writeScope: z.ZodString;
2397
+ expected: z.ZodObject<{
2398
+ readSet: z.ZodObject<{
2399
+ stores: z.ZodArray<z.ZodObject<{
2400
+ store_uuid: z.ZodString;
2401
+ alias: z.ZodString;
2402
+ remote: z.ZodOptional<z.ZodString>;
2403
+ writable: z.ZodBoolean;
2404
+ }, "strict", z.ZodTypeAny, {
2405
+ store_uuid: string;
2406
+ alias: string;
2407
+ writable: boolean;
2408
+ remote?: string | undefined;
2409
+ }, {
2410
+ store_uuid: string;
2411
+ alias: string;
2412
+ writable: boolean;
2413
+ remote?: string | undefined;
2414
+ }>, "many">;
2415
+ warnings: z.ZodArray<z.ZodObject<{
2416
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2417
+ ref: z.ZodString;
2418
+ message: z.ZodString;
2419
+ }, "strict", z.ZodTypeAny, {
2420
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2421
+ message: string;
2422
+ ref: string;
2423
+ }, {
2424
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2425
+ message: string;
2426
+ ref: string;
2427
+ }>, "many">;
2428
+ }, "strict", z.ZodTypeAny, {
2429
+ stores: {
2430
+ store_uuid: string;
2431
+ alias: string;
2432
+ writable: boolean;
2433
+ remote?: string | undefined;
2434
+ }[];
2435
+ warnings: {
2436
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2437
+ message: string;
2438
+ ref: string;
2439
+ }[];
2440
+ }, {
2441
+ stores: {
2442
+ store_uuid: string;
2443
+ alias: string;
2444
+ writable: boolean;
2445
+ remote?: string | undefined;
2446
+ }[];
2447
+ warnings: {
2448
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2449
+ message: string;
2450
+ ref: string;
2451
+ }[];
2452
+ }>;
2453
+ writeTarget: z.ZodNullable<z.ZodObject<{
2454
+ store_uuid: z.ZodString;
2455
+ alias: z.ZodString;
2456
+ }, "strict", z.ZodTypeAny, {
2457
+ store_uuid: string;
2458
+ alias: string;
2459
+ }, {
2460
+ store_uuid: string;
2461
+ alias: string;
2462
+ }>>;
2463
+ writeWarnings: z.ZodArray<z.ZodObject<{
2464
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2465
+ ref: z.ZodString;
2466
+ message: z.ZodString;
2467
+ }, "strict", z.ZodTypeAny, {
2468
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2469
+ message: string;
2470
+ ref: string;
2471
+ }, {
2472
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2473
+ message: string;
2474
+ ref: string;
2475
+ }>, "many">;
2476
+ }, "strict", z.ZodTypeAny, {
2477
+ readSet: {
2478
+ stores: {
2479
+ store_uuid: string;
2480
+ alias: string;
2481
+ writable: boolean;
2482
+ remote?: string | undefined;
2483
+ }[];
2484
+ warnings: {
2485
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2486
+ message: string;
2487
+ ref: string;
2488
+ }[];
2489
+ };
2490
+ writeTarget: {
2491
+ store_uuid: string;
2492
+ alias: string;
2493
+ } | null;
2494
+ writeWarnings: {
2495
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2496
+ message: string;
2497
+ ref: string;
2498
+ }[];
2499
+ }, {
2500
+ readSet: {
2501
+ stores: {
2502
+ store_uuid: string;
2503
+ alias: string;
2504
+ writable: boolean;
2505
+ remote?: string | undefined;
2506
+ }[];
2507
+ warnings: {
2508
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2509
+ message: string;
2510
+ ref: string;
2511
+ }[];
2512
+ };
2513
+ writeTarget: {
2514
+ store_uuid: string;
2515
+ alias: string;
2516
+ } | null;
2517
+ writeWarnings: {
2518
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2519
+ message: string;
2520
+ ref: string;
2521
+ }[];
2522
+ }>;
2523
+ }, "strict", z.ZodTypeAny, {
2524
+ expected: {
2525
+ readSet: {
2526
+ stores: {
2527
+ store_uuid: string;
2528
+ alias: string;
2529
+ writable: boolean;
2530
+ remote?: string | undefined;
2531
+ }[];
2532
+ warnings: {
2533
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2534
+ message: string;
2535
+ ref: string;
2536
+ }[];
2537
+ };
2538
+ writeTarget: {
2539
+ store_uuid: string;
2540
+ alias: string;
2541
+ } | null;
2542
+ writeWarnings: {
2543
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2544
+ message: string;
2545
+ ref: string;
2546
+ }[];
2547
+ };
2548
+ name: string;
2549
+ input: {
2550
+ uid: string;
2551
+ mountedStores: {
2552
+ personal: boolean;
2553
+ store_uuid: string;
2554
+ alias: string;
2555
+ writable: boolean;
2556
+ remote?: string | undefined;
2557
+ }[];
2558
+ requiredStores: {
2559
+ id: string;
2560
+ suggested_remote?: string | undefined;
2561
+ }[];
2562
+ activeWriteAlias?: string | undefined;
2563
+ };
2564
+ writeScope: string;
2565
+ note?: string | undefined;
2566
+ }, {
2567
+ expected: {
2568
+ readSet: {
2569
+ stores: {
2570
+ store_uuid: string;
2571
+ alias: string;
2572
+ writable: boolean;
2573
+ remote?: string | undefined;
2574
+ }[];
2575
+ warnings: {
2576
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2577
+ message: string;
2578
+ ref: string;
2579
+ }[];
2580
+ };
2581
+ writeTarget: {
2582
+ store_uuid: string;
2583
+ alias: string;
2584
+ } | null;
2585
+ writeWarnings: {
2586
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2587
+ message: string;
2588
+ ref: string;
2589
+ }[];
2590
+ };
2591
+ name: string;
2592
+ input: {
2593
+ uid: string;
2594
+ mountedStores: {
2595
+ store_uuid: string;
2596
+ alias: string;
2597
+ personal?: boolean | undefined;
2598
+ remote?: string | undefined;
2599
+ writable?: boolean | undefined;
2600
+ }[];
2601
+ requiredStores: {
2602
+ id: string;
2603
+ suggested_remote?: string | undefined;
2604
+ }[];
2605
+ activeWriteAlias?: string | undefined;
2606
+ };
2607
+ writeScope: string;
2608
+ note?: string | undefined;
2609
+ }>;
2610
+ type ReadSetGoldenCase = z.infer<typeof readSetGoldenCaseSchema>;
2611
+ declare const readSetGoldenFileSchema: z.ZodObject<{
2612
+ contract: z.ZodLiteral<"read-set.golden">;
2613
+ cases: z.ZodArray<z.ZodObject<{
2614
+ name: z.ZodString;
2615
+ note: z.ZodOptional<z.ZodString>;
2616
+ input: z.ZodObject<{
2617
+ uid: z.ZodString;
2618
+ mountedStores: z.ZodArray<z.ZodObject<{
2619
+ store_uuid: z.ZodString;
2620
+ alias: z.ZodString;
2621
+ remote: z.ZodOptional<z.ZodString>;
2622
+ writable: z.ZodDefault<z.ZodBoolean>;
2623
+ personal: z.ZodDefault<z.ZodBoolean>;
2624
+ }, "strict", z.ZodTypeAny, {
2625
+ personal: boolean;
2626
+ store_uuid: string;
2627
+ alias: string;
2628
+ writable: boolean;
2629
+ remote?: string | undefined;
2630
+ }, {
2631
+ store_uuid: string;
2632
+ alias: string;
2633
+ personal?: boolean | undefined;
2634
+ remote?: string | undefined;
2635
+ writable?: boolean | undefined;
2636
+ }>, "many">;
2637
+ requiredStores: z.ZodArray<z.ZodObject<{
2638
+ id: z.ZodString;
2639
+ suggested_remote: z.ZodOptional<z.ZodString>;
2640
+ }, "strict", z.ZodTypeAny, {
2641
+ id: string;
2642
+ suggested_remote?: string | undefined;
2643
+ }, {
2644
+ id: string;
2645
+ suggested_remote?: string | undefined;
2646
+ }>, "many">;
2647
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2648
+ }, "strict", z.ZodTypeAny, {
2649
+ uid: string;
2650
+ mountedStores: {
2651
+ personal: boolean;
2652
+ store_uuid: string;
2653
+ alias: string;
2654
+ writable: boolean;
2655
+ remote?: string | undefined;
2656
+ }[];
2657
+ requiredStores: {
2658
+ id: string;
2659
+ suggested_remote?: string | undefined;
2660
+ }[];
2661
+ activeWriteAlias?: string | undefined;
2662
+ }, {
2663
+ uid: string;
2664
+ mountedStores: {
2665
+ store_uuid: string;
2666
+ alias: string;
2667
+ personal?: boolean | undefined;
2668
+ remote?: string | undefined;
2669
+ writable?: boolean | undefined;
2670
+ }[];
2671
+ requiredStores: {
2672
+ id: string;
2673
+ suggested_remote?: string | undefined;
2674
+ }[];
2675
+ activeWriteAlias?: string | undefined;
2676
+ }>;
2677
+ writeScope: z.ZodString;
2678
+ expected: z.ZodObject<{
2679
+ readSet: z.ZodObject<{
2680
+ stores: z.ZodArray<z.ZodObject<{
2681
+ store_uuid: z.ZodString;
2682
+ alias: z.ZodString;
2683
+ remote: z.ZodOptional<z.ZodString>;
2684
+ writable: z.ZodBoolean;
2685
+ }, "strict", z.ZodTypeAny, {
2686
+ store_uuid: string;
2687
+ alias: string;
2688
+ writable: boolean;
2689
+ remote?: string | undefined;
2690
+ }, {
2691
+ store_uuid: string;
2692
+ alias: string;
2693
+ writable: boolean;
2694
+ remote?: string | undefined;
2695
+ }>, "many">;
2696
+ warnings: z.ZodArray<z.ZodObject<{
2697
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2698
+ ref: z.ZodString;
2699
+ message: z.ZodString;
2700
+ }, "strict", z.ZodTypeAny, {
2701
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2702
+ message: string;
2703
+ ref: string;
2704
+ }, {
2705
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2706
+ message: string;
2707
+ ref: string;
2708
+ }>, "many">;
2709
+ }, "strict", z.ZodTypeAny, {
2710
+ stores: {
2711
+ store_uuid: string;
2712
+ alias: string;
2713
+ writable: boolean;
2714
+ remote?: string | undefined;
2715
+ }[];
2716
+ warnings: {
2717
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2718
+ message: string;
2719
+ ref: string;
2720
+ }[];
2721
+ }, {
2722
+ stores: {
2723
+ store_uuid: string;
2724
+ alias: string;
2725
+ writable: boolean;
2726
+ remote?: string | undefined;
2727
+ }[];
2728
+ warnings: {
2729
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2730
+ message: string;
2731
+ ref: string;
2732
+ }[];
2733
+ }>;
2734
+ writeTarget: z.ZodNullable<z.ZodObject<{
2735
+ store_uuid: z.ZodString;
2736
+ alias: z.ZodString;
2737
+ }, "strict", z.ZodTypeAny, {
2738
+ store_uuid: string;
2739
+ alias: string;
2740
+ }, {
2741
+ store_uuid: string;
2742
+ alias: string;
2743
+ }>>;
2744
+ writeWarnings: z.ZodArray<z.ZodObject<{
2745
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2746
+ ref: z.ZodString;
2747
+ message: z.ZodString;
2748
+ }, "strict", z.ZodTypeAny, {
2749
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2750
+ message: string;
2751
+ ref: string;
2752
+ }, {
2753
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2754
+ message: string;
2755
+ ref: string;
2756
+ }>, "many">;
2757
+ }, "strict", z.ZodTypeAny, {
2758
+ readSet: {
2759
+ stores: {
2760
+ store_uuid: string;
2761
+ alias: string;
2762
+ writable: boolean;
2763
+ remote?: string | undefined;
2764
+ }[];
2765
+ warnings: {
2766
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2767
+ message: string;
2768
+ ref: string;
2769
+ }[];
2770
+ };
2771
+ writeTarget: {
2772
+ store_uuid: string;
2773
+ alias: string;
2774
+ } | null;
2775
+ writeWarnings: {
2776
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2777
+ message: string;
2778
+ ref: string;
2779
+ }[];
2780
+ }, {
2781
+ readSet: {
2782
+ stores: {
2783
+ store_uuid: string;
2784
+ alias: string;
2785
+ writable: boolean;
2786
+ remote?: string | undefined;
2787
+ }[];
2788
+ warnings: {
2789
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2790
+ message: string;
2791
+ ref: string;
2792
+ }[];
2793
+ };
2794
+ writeTarget: {
2795
+ store_uuid: string;
2796
+ alias: string;
2797
+ } | null;
2798
+ writeWarnings: {
2799
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2800
+ message: string;
2801
+ ref: string;
2802
+ }[];
2803
+ }>;
2804
+ }, "strict", z.ZodTypeAny, {
2805
+ expected: {
2806
+ readSet: {
2807
+ stores: {
2808
+ store_uuid: string;
2809
+ alias: string;
2810
+ writable: boolean;
2811
+ remote?: string | undefined;
2812
+ }[];
2813
+ warnings: {
2814
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2815
+ message: string;
2816
+ ref: string;
2817
+ }[];
2818
+ };
2819
+ writeTarget: {
2820
+ store_uuid: string;
2821
+ alias: string;
2822
+ } | null;
2823
+ writeWarnings: {
2824
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2825
+ message: string;
2826
+ ref: string;
2827
+ }[];
2828
+ };
2829
+ name: string;
2830
+ input: {
2831
+ uid: string;
2832
+ mountedStores: {
2833
+ personal: boolean;
2834
+ store_uuid: string;
2835
+ alias: string;
2836
+ writable: boolean;
2837
+ remote?: string | undefined;
2838
+ }[];
2839
+ requiredStores: {
2840
+ id: string;
2841
+ suggested_remote?: string | undefined;
2842
+ }[];
2843
+ activeWriteAlias?: string | undefined;
2844
+ };
2845
+ writeScope: string;
2846
+ note?: string | undefined;
2847
+ }, {
2848
+ expected: {
2849
+ readSet: {
2850
+ stores: {
2851
+ store_uuid: string;
2852
+ alias: string;
2853
+ writable: boolean;
2854
+ remote?: string | undefined;
2855
+ }[];
2856
+ warnings: {
2857
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2858
+ message: string;
2859
+ ref: string;
2860
+ }[];
2861
+ };
2862
+ writeTarget: {
2863
+ store_uuid: string;
2864
+ alias: string;
2865
+ } | null;
2866
+ writeWarnings: {
2867
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2868
+ message: string;
2869
+ ref: string;
2870
+ }[];
2871
+ };
2872
+ name: string;
2873
+ input: {
2874
+ uid: string;
2875
+ mountedStores: {
2876
+ store_uuid: string;
2877
+ alias: string;
2878
+ personal?: boolean | undefined;
2879
+ remote?: string | undefined;
2880
+ writable?: boolean | undefined;
2881
+ }[];
2882
+ requiredStores: {
2883
+ id: string;
2884
+ suggested_remote?: string | undefined;
2885
+ }[];
2886
+ activeWriteAlias?: string | undefined;
2887
+ };
2888
+ writeScope: string;
2889
+ note?: string | undefined;
2890
+ }>, "many">;
2891
+ }, "strict", z.ZodTypeAny, {
2892
+ contract: "read-set.golden";
2893
+ cases: {
2894
+ expected: {
2895
+ readSet: {
2896
+ stores: {
2897
+ store_uuid: string;
2898
+ alias: string;
2899
+ writable: boolean;
2900
+ remote?: string | undefined;
2901
+ }[];
2902
+ warnings: {
2903
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2904
+ message: string;
2905
+ ref: string;
2906
+ }[];
2907
+ };
2908
+ writeTarget: {
2909
+ store_uuid: string;
2910
+ alias: string;
2911
+ } | null;
2912
+ writeWarnings: {
2913
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2914
+ message: string;
2915
+ ref: string;
2916
+ }[];
2917
+ };
2918
+ name: string;
2919
+ input: {
2920
+ uid: string;
2921
+ mountedStores: {
2922
+ personal: boolean;
2923
+ store_uuid: string;
2924
+ alias: string;
2925
+ writable: boolean;
2926
+ remote?: string | undefined;
2927
+ }[];
2928
+ requiredStores: {
2929
+ id: string;
2930
+ suggested_remote?: string | undefined;
2931
+ }[];
2932
+ activeWriteAlias?: string | undefined;
2933
+ };
2934
+ writeScope: string;
2935
+ note?: string | undefined;
2936
+ }[];
2937
+ }, {
2938
+ contract: "read-set.golden";
2939
+ cases: {
2940
+ expected: {
2941
+ readSet: {
2942
+ stores: {
2943
+ store_uuid: string;
2944
+ alias: string;
2945
+ writable: boolean;
2946
+ remote?: string | undefined;
2947
+ }[];
2948
+ warnings: {
2949
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2950
+ message: string;
2951
+ ref: string;
2952
+ }[];
2953
+ };
2954
+ writeTarget: {
2955
+ store_uuid: string;
2956
+ alias: string;
2957
+ } | null;
2958
+ writeWarnings: {
2959
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2960
+ message: string;
2961
+ ref: string;
2962
+ }[];
2963
+ };
2964
+ name: string;
2965
+ input: {
2966
+ uid: string;
2967
+ mountedStores: {
2968
+ store_uuid: string;
2969
+ alias: string;
2970
+ personal?: boolean | undefined;
2971
+ remote?: string | undefined;
2972
+ writable?: boolean | undefined;
2973
+ }[];
2974
+ requiredStores: {
2975
+ id: string;
2976
+ suggested_remote?: string | undefined;
2977
+ }[];
2978
+ activeWriteAlias?: string | undefined;
2979
+ };
2980
+ writeScope: string;
2981
+ note?: string | undefined;
2982
+ }[];
2983
+ }>;
2984
+
2985
+ declare class ResolverNotImplementedError extends Error {
2986
+ constructor(what: string);
2987
+ }
2988
+ declare function createProjectRootResolver(): ProjectRootResolver;
2989
+
2990
+ declare function createStoreResolver(): StoreResolver;
2991
+
2992
+ declare function readStoreIdentity(absDir: string): StoreIdentity | null;
2993
+ declare function recognizeStoreDir(absDir: string): boolean;
2994
+ type FindStoreExecutableViolationsOptions = {
2995
+ maxDepth?: number;
2996
+ maxEntries?: number;
2997
+ };
2998
+ declare function findStoreExecutableViolations(absDir: string, options?: FindStoreExecutableViolationsOptions): string[];
2999
+
3000
+ interface QualifiedCandidate {
3001
+ store_uuid: string;
3002
+ alias: string;
3003
+ local_id: string;
3004
+ }
3005
+ interface QualifiedIdResolution {
3006
+ resolved: QualifiedCandidate | null;
3007
+ ambiguous: boolean;
3008
+ matches: QualifiedCandidate[];
3009
+ }
3010
+ declare function resolveStoreQualifiedId(ref: string, candidates: QualifiedCandidate[]): QualifiedIdResolution;
3011
+
3012
+ interface ResolutionCandidate {
3013
+ global_ref: string;
3014
+ store_uuid: string;
3015
+ alias: string;
3016
+ local_id: string;
3017
+ semantic_scope: string;
3018
+ }
3019
+ interface ResolvedEntry extends ResolutionCandidate {
3020
+ rank: number;
3021
+ reason: string;
3022
+ }
3023
+ interface ResolutionWarning {
3024
+ code: "required_store_unavailable" | "shadowed_local_id";
3025
+ ref: string;
3026
+ message: string;
3027
+ }
3028
+ interface ResolveOptions {
3029
+ storeOrder?: string[];
3030
+ unavailableRequiredStores?: string[];
3031
+ }
3032
+ interface ResolutionResult {
3033
+ resolved: ResolvedEntry[];
3034
+ warnings: ResolutionWarning[];
3035
+ }
3036
+ declare function resolveCandidates(candidates: ResolutionCandidate[], options?: ResolveOptions): ResolutionResult;
3037
+
3038
+ declare const STORE_PENDING_DIR = "pending";
3039
+ declare const STORE_GITIGNORE: string;
3040
+ interface InitStoreOptions {
3041
+ git?: boolean;
3042
+ }
3043
+ declare function initStore(absDir: string, identity: StoreIdentity, options?: InitStoreOptions): StoreIdentity;
3044
+ interface StoreKnowledgeRef {
3045
+ store_uuid: string;
3046
+ alias: string;
3047
+ type: string;
3048
+ file: string;
3049
+ }
3050
+ interface MountedStoreDir {
3051
+ store_uuid: string;
3052
+ alias: string;
3053
+ dir: string;
3054
+ }
3055
+ declare function listStoreKnowledge(store: MountedStoreDir): StoreKnowledgeRef[];
3056
+ declare function readKnowledgeAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
3057
+ declare function aggregatePendingAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
3058
+
3059
+ interface SecretFinding {
3060
+ rule: string;
3061
+ line: number;
3062
+ }
3063
+ declare function scanForSecrets(content: string): SecretFinding[];
3064
+ declare function hasSecrets(content: string): boolean;
3065
+ declare const REDACTION_PLACEHOLDER_PREFIX = "[REDACTED:";
3066
+ declare function redactSecrets(content: string): string;
3067
+ declare function scrubRemoteUrl(remote: string): string;
3068
+
3069
+ type ScanRecommendationInput = {
3070
+ frameworkKind: string;
3071
+ hasMeta?: boolean;
3072
+ readmeOk?: boolean;
3073
+ hasContributing?: boolean;
3074
+ hasExistingFabric?: boolean;
3075
+ };
3076
+ declare function buildScanRecommendations(input: ScanRecommendationInput, t: Translator): string[];
3077
+
3078
+ type StoreVisibility = "shared" | "personal";
3079
+ interface CrossStoreRefViolation {
3080
+ code: "personal-ref-in-shared";
3081
+ ref: string;
3082
+ to_store_uuid: string;
3083
+ message: string;
3084
+ }
3085
+ interface CrossStoreLintInput {
3086
+ entryVisibility: StoreVisibility;
3087
+ referencedGlobalRefs: string[];
3088
+ storeVisibility: Record<string, StoreVisibility>;
3089
+ }
3090
+ declare function lintCrossStoreReferences(input: CrossStoreLintInput): CrossStoreRefViolation[];
3091
+ type EntryLayer = "team" | "personal";
3092
+ declare function isPersonalLeakIntoSharedStore(entryLayer: EntryLayer, storeVisibility: StoreVisibility): boolean;
3093
+
3094
+ type FailureStage = "install" | "sync" | "hook" | "mcp";
3095
+ interface FailureTrace {
3096
+ stage: FailureStage;
3097
+ code: string;
3098
+ message: string;
3099
+ context: Record<string, unknown>;
3100
+ }
3101
+ declare function buildFailureTrace(stage: FailureStage, error: unknown, context?: Record<string, unknown>, code?: string): FailureTrace;
3102
+ interface DebugBundleInput {
3103
+ config: Record<string, unknown>;
3104
+ diagnostics: unknown[];
3105
+ events?: string[];
3106
+ includeEvents?: boolean;
3107
+ }
3108
+ interface DebugBundle {
3109
+ version: 1;
3110
+ config: Record<string, unknown>;
3111
+ diagnostics: unknown[];
3112
+ events: string[];
3113
+ redacted: true;
3114
+ }
3115
+ declare function buildDebugBundle(input: DebugBundleInput): DebugBundle;
3116
+
3117
+ declare const knowledgeProvenanceSchema: z.ZodObject<{
3118
+ store_uuid: z.ZodString;
3119
+ alias: z.ZodString;
3120
+ local_id: z.ZodString;
3121
+ global_ref: z.ZodString;
3122
+ semantic_scope: z.ZodOptional<z.ZodString>;
3123
+ }, "strict", z.ZodTypeAny, {
3124
+ store_uuid: string;
3125
+ alias: string;
3126
+ local_id: string;
3127
+ global_ref: string;
3128
+ semantic_scope?: string | undefined;
3129
+ }, {
3130
+ store_uuid: string;
3131
+ alias: string;
3132
+ local_id: string;
3133
+ global_ref: string;
3134
+ semantic_scope?: string | undefined;
3135
+ }>;
3136
+ type KnowledgeProvenance = z.infer<typeof knowledgeProvenanceSchema>;
3137
+
3138
+ declare const MCP_STORE_AWARE_TOOLS: readonly ["fab_recall", "fab_plan_context", "fab_get_knowledge_sections", "fab_archive_scan", "fab_extract_knowledge", "fab_review"];
3139
+ type McpStoreAwareTool = (typeof MCP_STORE_AWARE_TOOLS)[number];
3140
+ declare const storeAwareEntrySchema: z.ZodObject<{
3141
+ stable_id: z.ZodString;
3142
+ global_ref: z.ZodString;
3143
+ provenance: z.ZodObject<{
3144
+ store_uuid: z.ZodString;
3145
+ alias: z.ZodString;
3146
+ local_id: z.ZodString;
3147
+ global_ref: z.ZodString;
3148
+ semantic_scope: z.ZodOptional<z.ZodString>;
3149
+ }, "strict", z.ZodTypeAny, {
3150
+ store_uuid: string;
3151
+ alias: string;
3152
+ local_id: string;
3153
+ global_ref: string;
3154
+ semantic_scope?: string | undefined;
3155
+ }, {
3156
+ store_uuid: string;
3157
+ alias: string;
3158
+ local_id: string;
3159
+ global_ref: string;
3160
+ semantic_scope?: string | undefined;
3161
+ }>;
3162
+ }, "strict", z.ZodTypeAny, {
3163
+ stable_id: string;
3164
+ global_ref: string;
3165
+ provenance: {
3166
+ store_uuid: string;
3167
+ alias: string;
3168
+ local_id: string;
3169
+ global_ref: string;
3170
+ semantic_scope?: string | undefined;
3171
+ };
3172
+ }, {
3173
+ stable_id: string;
3174
+ global_ref: string;
3175
+ provenance: {
3176
+ store_uuid: string;
3177
+ alias: string;
3178
+ local_id: string;
3179
+ global_ref: string;
3180
+ semantic_scope?: string | undefined;
3181
+ };
1283
3182
  }>;
1284
- declare const humanLockFileSchema: z.ZodObject<{
1285
- locked: z.ZodOptional<z.ZodArray<z.ZodObject<{
1286
- file: z.ZodString;
1287
- start_line: z.ZodNumber;
1288
- end_line: z.ZodNumber;
1289
- hash: z.ZodString;
1290
- }, "strip", z.ZodTypeAny, {
1291
- file: string;
1292
- hash: string;
1293
- start_line: number;
1294
- end_line: number;
3183
+ type StoreAwareEntry = z.infer<typeof storeAwareEntrySchema>;
3184
+ declare const writtenToStoreSchema: z.ZodObject<{
3185
+ store_uuid: z.ZodString;
3186
+ alias: z.ZodString;
3187
+ }, "strict", z.ZodTypeAny, {
3188
+ store_uuid: string;
3189
+ alias: string;
3190
+ }, {
3191
+ store_uuid: string;
3192
+ alias: string;
3193
+ }>;
3194
+ type WrittenToStore = z.infer<typeof writtenToStoreSchema>;
3195
+ interface McpStoreAwareContract {
3196
+ tool: McpStoreAwareTool;
3197
+ surfacesEntries: boolean;
3198
+ echoesWrittenStore: boolean;
3199
+ }
3200
+ declare const MCP_STORE_AWARE_CONTRACTS: Record<McpStoreAwareTool, McpStoreAwareContract>;
3201
+
3202
+ declare const resolvedBindingsSnapshotSchema: z.ZodObject<{
3203
+ version: z.ZodLiteral<1>;
3204
+ project_id: z.ZodString;
3205
+ generated_at: z.ZodString;
3206
+ read_set: z.ZodObject<{
3207
+ stores: z.ZodArray<z.ZodObject<{
3208
+ store_uuid: z.ZodString;
3209
+ alias: z.ZodString;
3210
+ remote: z.ZodOptional<z.ZodString>;
3211
+ writable: z.ZodBoolean;
3212
+ }, "strict", z.ZodTypeAny, {
3213
+ store_uuid: string;
3214
+ alias: string;
3215
+ writable: boolean;
3216
+ remote?: string | undefined;
3217
+ }, {
3218
+ store_uuid: string;
3219
+ alias: string;
3220
+ writable: boolean;
3221
+ remote?: string | undefined;
3222
+ }>, "many">;
3223
+ warnings: z.ZodArray<z.ZodObject<{
3224
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
3225
+ ref: z.ZodString;
3226
+ message: z.ZodString;
3227
+ }, "strict", z.ZodTypeAny, {
3228
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3229
+ message: string;
3230
+ ref: string;
3231
+ }, {
3232
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3233
+ message: string;
3234
+ ref: string;
3235
+ }>, "many">;
3236
+ }, "strict", z.ZodTypeAny, {
3237
+ stores: {
3238
+ store_uuid: string;
3239
+ alias: string;
3240
+ writable: boolean;
3241
+ remote?: string | undefined;
3242
+ }[];
3243
+ warnings: {
3244
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3245
+ message: string;
3246
+ ref: string;
3247
+ }[];
1295
3248
  }, {
1296
- file: string;
1297
- hash: string;
1298
- start_line: number;
1299
- end_line: number;
1300
- }>, "many">>;
1301
- }, "strip", z.ZodTypeAny, {
1302
- locked?: {
1303
- file: string;
1304
- hash: string;
1305
- start_line: number;
1306
- end_line: number;
1307
- }[] | undefined;
3249
+ stores: {
3250
+ store_uuid: string;
3251
+ alias: string;
3252
+ writable: boolean;
3253
+ remote?: string | undefined;
3254
+ }[];
3255
+ warnings: {
3256
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3257
+ message: string;
3258
+ ref: string;
3259
+ }[];
3260
+ }>;
3261
+ write_target: z.ZodNullable<z.ZodObject<{
3262
+ store_uuid: z.ZodString;
3263
+ alias: z.ZodString;
3264
+ }, "strict", z.ZodTypeAny, {
3265
+ store_uuid: string;
3266
+ alias: string;
3267
+ }, {
3268
+ store_uuid: string;
3269
+ alias: string;
3270
+ }>>;
3271
+ }, "strict", z.ZodTypeAny, {
3272
+ project_id: string;
3273
+ version: 1;
3274
+ generated_at: string;
3275
+ read_set: {
3276
+ stores: {
3277
+ store_uuid: string;
3278
+ alias: string;
3279
+ writable: boolean;
3280
+ remote?: string | undefined;
3281
+ }[];
3282
+ warnings: {
3283
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3284
+ message: string;
3285
+ ref: string;
3286
+ }[];
3287
+ };
3288
+ write_target: {
3289
+ store_uuid: string;
3290
+ alias: string;
3291
+ } | null;
1308
3292
  }, {
1309
- locked?: {
1310
- file: string;
1311
- hash: string;
1312
- start_line: number;
1313
- end_line: number;
1314
- }[] | undefined;
3293
+ project_id: string;
3294
+ version: 1;
3295
+ generated_at: string;
3296
+ read_set: {
3297
+ stores: {
3298
+ store_uuid: string;
3299
+ alias: string;
3300
+ writable: boolean;
3301
+ remote?: string | undefined;
3302
+ }[];
3303
+ warnings: {
3304
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3305
+ message: string;
3306
+ ref: string;
3307
+ }[];
3308
+ };
3309
+ write_target: {
3310
+ store_uuid: string;
3311
+ alias: string;
3312
+ } | null;
1315
3313
  }>;
3314
+ type ResolvedBindingsSnapshot = z.infer<typeof resolvedBindingsSnapshotSchema>;
1316
3315
 
1317
- type FabricConfigSchemaShape = z.infer<typeof fabricConfigSchema>;
1318
- type PanelFieldGroup = "A_locale" | "B_hint_threshold" | "C_audit";
1319
- type ValidateResult = {
1320
- ok: true;
1321
- value: unknown;
1322
- } | {
1323
- ok: false;
1324
- error: string;
3316
+ declare function bindingsSnapshotPath(globalRoot: string, projectId: string): string;
3317
+ interface WriteBindingsSnapshotOptions {
3318
+ globalRoot: string;
3319
+ projectId: string;
3320
+ resolveInput: StoreResolveInput;
3321
+ writeScope: string;
3322
+ now: string;
3323
+ }
3324
+ declare function writeBindingsSnapshot(options: WriteBindingsSnapshotOptions): ResolvedBindingsSnapshot;
3325
+ declare function readBindingsSnapshot(globalRoot: string, projectId: string): ResolvedBindingsSnapshot | null;
3326
+
3327
+ declare function findMountedStore(config: GlobalConfig, aliasOrUuid: string): MountedStore | undefined;
3328
+ declare function addMountedStore(config: GlobalConfig, store: MountedStore): GlobalConfig;
3329
+ declare function detachMountedStore(config: GlobalConfig, alias: string): {
3330
+ config: GlobalConfig;
3331
+ detached: MountedStore | null;
1325
3332
  };
1326
- interface PanelFieldMeta {
1327
- /** Schema key this field edits — type-checked against the inferred config shape. */
1328
- readonly key: keyof FabricConfigSchemaShape;
1329
- /** Logical grouping for panel section headers. */
1330
- readonly group: PanelFieldGroup;
1331
- /** Clack widget hint — `select` for enums, `text` for free-form numbers. */
1332
- readonly widget: "select" | "text";
1333
- /** i18n key for the field label; strings landed in TASK-006. */
1334
- readonly label_i18n_key: string;
1335
- /** i18n key for the field's description / help text. */
1336
- readonly description_i18n_key: string;
1337
- /** Default value pulled from the Zod schema's `.default(...)`. */
1338
- readonly default: string | number;
1339
- /** Enum options for `select` widgets, derived from the Zod enum schema. */
1340
- readonly enum_values?: readonly string[];
1341
- /** Validates raw user input from the TUI prompt. */
1342
- validate(raw: string): ValidateResult;
1343
- /** Renders a stored value back to the panel display string. */
1344
- format_for_display(value: unknown): string;
3333
+ declare function bindRequiredStore(required: RequiredStoreEntry[], entry: RequiredStoreEntry): RequiredStoreEntry[];
3334
+ interface StoreExplain {
3335
+ alias: string;
3336
+ store_uuid: string;
3337
+ remote: string | null;
3338
+ local_only: boolean;
1345
3339
  }
1346
- /**
1347
- * Returns the per-field metadata array driving the `fabric config` clack panel.
1348
- * Group A (2) + Group B (8) + Group C (1) = 11 entries.
1349
- */
1350
- declare function getPanelFields(): readonly PanelFieldMeta[];
1351
- /**
1352
- * Lookup a single panel field by its config key. Returns `undefined` if the
1353
- * key is not panel-scoped (e.g. Group D/E plumbing).
1354
- */
1355
- declare function getPanelFieldByKey(key: string): PanelFieldMeta | undefined;
3340
+ declare function explainStore(config: GlobalConfig, alias: string): StoreExplain | null;
1356
3341
 
1357
3342
  interface ForensicCodeSample {
1358
3343
  path: string;
@@ -1582,13 +3567,13 @@ declare const forensicFrameworkSchema: z.ZodObject<{
1582
3567
  evidence: z.ZodArray<z.ZodString, "many">;
1583
3568
  }, "strip", z.ZodTypeAny, {
1584
3569
  version: string;
1585
- evidence: string[];
1586
3570
  kind: string;
3571
+ evidence: string[];
1587
3572
  subkind: string;
1588
3573
  }, {
1589
3574
  version: string;
1590
- evidence: string[];
1591
3575
  kind: string;
3576
+ evidence: string[];
1592
3577
  subkind: string;
1593
3578
  }>;
1594
3579
  declare const forensicReadmeSchema: z.ZodObject<{
@@ -1640,13 +3625,13 @@ declare const forensicReportSchema: z.ZodObject<{
1640
3625
  evidence: z.ZodArray<z.ZodString, "many">;
1641
3626
  }, "strip", z.ZodTypeAny, {
1642
3627
  version: string;
1643
- evidence: string[];
1644
3628
  kind: string;
3629
+ evidence: string[];
1645
3630
  subkind: string;
1646
3631
  }, {
1647
3632
  version: string;
1648
- evidence: string[];
1649
3633
  kind: string;
3634
+ evidence: string[];
1650
3635
  subkind: string;
1651
3636
  }>;
1652
3637
  topology: z.ZodObject<{
@@ -1804,14 +3789,14 @@ declare const forensicReportSchema: z.ZodObject<{
1804
3789
  }, "strip", z.ZodTypeAny, {
1805
3790
  version: string;
1806
3791
  generated_at: string;
3792
+ target: string;
1807
3793
  framework: {
1808
3794
  version: string;
1809
- evidence: string[];
1810
3795
  kind: string;
3796
+ evidence: string[];
1811
3797
  subkind: string;
1812
3798
  };
1813
3799
  generated_by: string;
1814
- target: string;
1815
3800
  project_name: string;
1816
3801
  topology: {
1817
3802
  total_files: number;
@@ -1866,14 +3851,14 @@ declare const forensicReportSchema: z.ZodObject<{
1866
3851
  }, {
1867
3852
  version: string;
1868
3853
  generated_at: string;
3854
+ target: string;
1869
3855
  framework: {
1870
3856
  version: string;
1871
- evidence: string[];
1872
3857
  kind: string;
3858
+ evidence: string[];
1873
3859
  subkind: string;
1874
3860
  };
1875
3861
  generated_by: string;
1876
- target: string;
1877
3862
  project_name: string;
1878
3863
  topology: {
1879
3864
  total_files: number;
@@ -2328,6 +4313,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2328
4313
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2329
4314
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2330
4315
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4316
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2331
4317
  }, "strict", z.ZodTypeAny, {
2332
4318
  relevance_scope: "narrow" | "broad";
2333
4319
  relevance_paths: string[];
@@ -2336,30 +4322,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2336
4322
  tech_stack: string[];
2337
4323
  impact: string[];
2338
4324
  must_read_if: string;
2339
- entities?: string[] | undefined;
4325
+ created_at?: string | undefined;
2340
4326
  id?: string | undefined;
4327
+ entities?: string[] | undefined;
2341
4328
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2342
4329
  maturity?: "draft" | "verified" | "proven" | undefined;
2343
4330
  knowledge_layer?: "personal" | "team" | undefined;
2344
4331
  layer_reason?: string | undefined;
2345
- created_at?: string | undefined;
2346
4332
  tags?: string[] | undefined;
4333
+ related?: string[] | undefined;
2347
4334
  }, {
2348
4335
  summary: string;
2349
4336
  intent_clues: string[];
2350
4337
  tech_stack: string[];
2351
4338
  impact: string[];
2352
4339
  must_read_if: string;
4340
+ created_at?: string | undefined;
4341
+ id?: string | undefined;
2353
4342
  relevance_scope?: "narrow" | "broad" | undefined;
2354
4343
  relevance_paths?: string[] | undefined;
2355
4344
  entities?: string[] | undefined;
2356
- id?: string | undefined;
2357
4345
  knowledge_type?: unknown;
2358
4346
  maturity?: "draft" | "verified" | "proven" | undefined;
2359
4347
  knowledge_layer?: "personal" | "team" | undefined;
2360
4348
  layer_reason?: string | undefined;
2361
- created_at?: string | undefined;
2362
4349
  tags?: string[] | undefined;
4350
+ related?: string[] | undefined;
2363
4351
  }>>;
2364
4352
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2365
4353
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -2395,6 +4383,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2395
4383
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2396
4384
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2397
4385
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4386
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2398
4387
  }, "strict", z.ZodTypeAny, {
2399
4388
  relevance_scope: "narrow" | "broad";
2400
4389
  relevance_paths: string[];
@@ -2403,30 +4392,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2403
4392
  tech_stack: string[];
2404
4393
  impact: string[];
2405
4394
  must_read_if: string;
2406
- entities?: string[] | undefined;
4395
+ created_at?: string | undefined;
2407
4396
  id?: string | undefined;
4397
+ entities?: string[] | undefined;
2408
4398
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2409
4399
  maturity?: "draft" | "verified" | "proven" | undefined;
2410
4400
  knowledge_layer?: "personal" | "team" | undefined;
2411
4401
  layer_reason?: string | undefined;
2412
- created_at?: string | undefined;
2413
4402
  tags?: string[] | undefined;
4403
+ related?: string[] | undefined;
2414
4404
  }, {
2415
4405
  summary: string;
2416
4406
  intent_clues: string[];
2417
4407
  tech_stack: string[];
2418
4408
  impact: string[];
2419
4409
  must_read_if: string;
4410
+ created_at?: string | undefined;
4411
+ id?: string | undefined;
2420
4412
  relevance_scope?: "narrow" | "broad" | undefined;
2421
4413
  relevance_paths?: string[] | undefined;
2422
4414
  entities?: string[] | undefined;
2423
- id?: string | undefined;
2424
4415
  knowledge_type?: unknown;
2425
4416
  maturity?: "draft" | "verified" | "proven" | undefined;
2426
4417
  knowledge_layer?: "personal" | "team" | undefined;
2427
4418
  layer_reason?: string | undefined;
2428
- created_at?: string | undefined;
2429
4419
  tags?: string[] | undefined;
4420
+ related?: string[] | undefined;
2430
4421
  }>>;
2431
4422
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2432
4423
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -2462,6 +4453,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2462
4453
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2463
4454
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2464
4455
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4456
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2465
4457
  }, "strict", z.ZodTypeAny, {
2466
4458
  relevance_scope: "narrow" | "broad";
2467
4459
  relevance_paths: string[];
@@ -2470,30 +4462,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2470
4462
  tech_stack: string[];
2471
4463
  impact: string[];
2472
4464
  must_read_if: string;
2473
- entities?: string[] | undefined;
4465
+ created_at?: string | undefined;
2474
4466
  id?: string | undefined;
4467
+ entities?: string[] | undefined;
2475
4468
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2476
4469
  maturity?: "draft" | "verified" | "proven" | undefined;
2477
4470
  knowledge_layer?: "personal" | "team" | undefined;
2478
4471
  layer_reason?: string | undefined;
2479
- created_at?: string | undefined;
2480
4472
  tags?: string[] | undefined;
4473
+ related?: string[] | undefined;
2481
4474
  }, {
2482
4475
  summary: string;
2483
4476
  intent_clues: string[];
2484
4477
  tech_stack: string[];
2485
4478
  impact: string[];
2486
4479
  must_read_if: string;
4480
+ created_at?: string | undefined;
4481
+ id?: string | undefined;
2487
4482
  relevance_scope?: "narrow" | "broad" | undefined;
2488
4483
  relevance_paths?: string[] | undefined;
2489
4484
  entities?: string[] | undefined;
2490
- id?: string | undefined;
2491
4485
  knowledge_type?: unknown;
2492
4486
  maturity?: "draft" | "verified" | "proven" | undefined;
2493
4487
  knowledge_layer?: "personal" | "team" | undefined;
2494
4488
  layer_reason?: string | undefined;
2495
- created_at?: string | undefined;
2496
4489
  tags?: string[] | undefined;
4490
+ related?: string[] | undefined;
2497
4491
  }>>;
2498
4492
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2499
4493
  }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
@@ -2529,6 +4523,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2529
4523
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2530
4524
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2531
4525
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4526
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2532
4527
  }, "strict", z.ZodTypeAny, {
2533
4528
  relevance_scope: "narrow" | "broad";
2534
4529
  relevance_paths: string[];
@@ -2537,30 +4532,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2537
4532
  tech_stack: string[];
2538
4533
  impact: string[];
2539
4534
  must_read_if: string;
2540
- entities?: string[] | undefined;
4535
+ created_at?: string | undefined;
2541
4536
  id?: string | undefined;
4537
+ entities?: string[] | undefined;
2542
4538
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2543
4539
  maturity?: "draft" | "verified" | "proven" | undefined;
2544
4540
  knowledge_layer?: "personal" | "team" | undefined;
2545
4541
  layer_reason?: string | undefined;
2546
- created_at?: string | undefined;
2547
4542
  tags?: string[] | undefined;
4543
+ related?: string[] | undefined;
2548
4544
  }, {
2549
4545
  summary: string;
2550
4546
  intent_clues: string[];
2551
4547
  tech_stack: string[];
2552
4548
  impact: string[];
2553
4549
  must_read_if: string;
4550
+ created_at?: string | undefined;
4551
+ id?: string | undefined;
2554
4552
  relevance_scope?: "narrow" | "broad" | undefined;
2555
4553
  relevance_paths?: string[] | undefined;
2556
4554
  entities?: string[] | undefined;
2557
- id?: string | undefined;
2558
4555
  knowledge_type?: unknown;
2559
4556
  maturity?: "draft" | "verified" | "proven" | undefined;
2560
4557
  knowledge_layer?: "personal" | "team" | undefined;
2561
4558
  layer_reason?: string | undefined;
2562
- created_at?: string | undefined;
2563
4559
  tags?: string[] | undefined;
4560
+ related?: string[] | undefined;
2564
4561
  }>>;
2565
4562
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2566
4563
  }, z.ZodTypeAny, "passthrough">, unknown>>;
@@ -2669,6 +4666,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2669
4666
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2670
4667
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2671
4668
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4669
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2672
4670
  }, "strict", z.ZodTypeAny, {
2673
4671
  relevance_scope: "narrow" | "broad";
2674
4672
  relevance_paths: string[];
@@ -2677,30 +4675,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2677
4675
  tech_stack: string[];
2678
4676
  impact: string[];
2679
4677
  must_read_if: string;
2680
- entities?: string[] | undefined;
4678
+ created_at?: string | undefined;
2681
4679
  id?: string | undefined;
4680
+ entities?: string[] | undefined;
2682
4681
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2683
4682
  maturity?: "draft" | "verified" | "proven" | undefined;
2684
4683
  knowledge_layer?: "personal" | "team" | undefined;
2685
4684
  layer_reason?: string | undefined;
2686
- created_at?: string | undefined;
2687
4685
  tags?: string[] | undefined;
4686
+ related?: string[] | undefined;
2688
4687
  }, {
2689
4688
  summary: string;
2690
4689
  intent_clues: string[];
2691
4690
  tech_stack: string[];
2692
4691
  impact: string[];
2693
4692
  must_read_if: string;
4693
+ created_at?: string | undefined;
4694
+ id?: string | undefined;
2694
4695
  relevance_scope?: "narrow" | "broad" | undefined;
2695
4696
  relevance_paths?: string[] | undefined;
2696
4697
  entities?: string[] | undefined;
2697
- id?: string | undefined;
2698
4698
  knowledge_type?: unknown;
2699
4699
  maturity?: "draft" | "verified" | "proven" | undefined;
2700
4700
  knowledge_layer?: "personal" | "team" | undefined;
2701
4701
  layer_reason?: string | undefined;
2702
- created_at?: string | undefined;
2703
4702
  tags?: string[] | undefined;
4703
+ related?: string[] | undefined;
2704
4704
  }>>;
2705
4705
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2706
4706
  }, z.ZodTypeAny, "passthrough">>;
@@ -2777,6 +4777,7 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2777
4777
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2778
4778
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
2779
4779
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
4780
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
2780
4781
  }, "strict", z.ZodTypeAny, {
2781
4782
  relevance_scope: "narrow" | "broad";
2782
4783
  relevance_paths: string[];
@@ -2785,30 +4786,32 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2785
4786
  tech_stack: string[];
2786
4787
  impact: string[];
2787
4788
  must_read_if: string;
2788
- entities?: string[] | undefined;
4789
+ created_at?: string | undefined;
2789
4790
  id?: string | undefined;
4791
+ entities?: string[] | undefined;
2790
4792
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2791
4793
  maturity?: "draft" | "verified" | "proven" | undefined;
2792
4794
  knowledge_layer?: "personal" | "team" | undefined;
2793
4795
  layer_reason?: string | undefined;
2794
- created_at?: string | undefined;
2795
4796
  tags?: string[] | undefined;
4797
+ related?: string[] | undefined;
2796
4798
  }, {
2797
4799
  summary: string;
2798
4800
  intent_clues: string[];
2799
4801
  tech_stack: string[];
2800
4802
  impact: string[];
2801
4803
  must_read_if: string;
4804
+ created_at?: string | undefined;
4805
+ id?: string | undefined;
2802
4806
  relevance_scope?: "narrow" | "broad" | undefined;
2803
4807
  relevance_paths?: string[] | undefined;
2804
4808
  entities?: string[] | undefined;
2805
- id?: string | undefined;
2806
4809
  knowledge_type?: unknown;
2807
4810
  maturity?: "draft" | "verified" | "proven" | undefined;
2808
4811
  knowledge_layer?: "personal" | "team" | undefined;
2809
4812
  layer_reason?: string | undefined;
2810
- created_at?: string | undefined;
2811
4813
  tags?: string[] | undefined;
4814
+ related?: string[] | undefined;
2812
4815
  }>>;
2813
4816
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2814
4817
  }, z.ZodTypeAny, "passthrough">>;
@@ -3152,13 +5155,13 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3152
5155
  evidence: z.ZodArray<z.ZodString, "many">;
3153
5156
  }, "strip", z.ZodTypeAny, {
3154
5157
  version: string;
3155
- evidence: string[];
3156
5158
  kind: string;
5159
+ evidence: string[];
3157
5160
  subkind: string;
3158
5161
  }, {
3159
5162
  version: string;
3160
- evidence: string[];
3161
5163
  kind: string;
5164
+ evidence: string[];
3162
5165
  subkind: string;
3163
5166
  }>;
3164
5167
  topology: z.ZodObject<{
@@ -3316,14 +5319,14 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3316
5319
  }, "strip", z.ZodTypeAny, {
3317
5320
  version: string;
3318
5321
  generated_at: string;
5322
+ target: string;
3319
5323
  framework: {
3320
5324
  version: string;
3321
- evidence: string[];
3322
5325
  kind: string;
5326
+ evidence: string[];
3323
5327
  subkind: string;
3324
5328
  };
3325
5329
  generated_by: string;
3326
- target: string;
3327
5330
  project_name: string;
3328
5331
  topology: {
3329
5332
  total_files: number;
@@ -3378,14 +5381,14 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3378
5381
  }, {
3379
5382
  version: string;
3380
5383
  generated_at: string;
5384
+ target: string;
3381
5385
  framework: {
3382
5386
  version: string;
3383
- evidence: string[];
3384
5387
  kind: string;
5388
+ evidence: string[];
3385
5389
  subkind: string;
3386
5390
  };
3387
5391
  generated_by: string;
3388
- target: string;
3389
5392
  project_name: string;
3390
5393
  topology: {
3391
5394
  total_files: number;
@@ -3443,14 +5446,14 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3443
5446
  payload: {
3444
5447
  version: string;
3445
5448
  generated_at: string;
5449
+ target: string;
3446
5450
  framework: {
3447
5451
  version: string;
3448
- evidence: string[];
3449
5452
  kind: string;
5453
+ evidence: string[];
3450
5454
  subkind: string;
3451
5455
  };
3452
5456
  generated_by: string;
3453
- target: string;
3454
5457
  project_name: string;
3455
5458
  topology: {
3456
5459
  total_files: number;
@@ -3508,14 +5511,14 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3508
5511
  payload: {
3509
5512
  version: string;
3510
5513
  generated_at: string;
5514
+ target: string;
3511
5515
  framework: {
3512
5516
  version: string;
3513
- evidence: string[];
3514
5517
  kind: string;
5518
+ evidence: string[];
3515
5519
  subkind: string;
3516
5520
  };
3517
5521
  generated_by: string;
3518
- target: string;
3519
5522
  project_name: string;
3520
5523
  topology: {
3521
5524
  total_files: number;
@@ -3606,6 +5609,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3606
5609
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3607
5610
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
3608
5611
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
5612
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3609
5613
  }, "strict", z.ZodTypeAny, {
3610
5614
  relevance_scope: "narrow" | "broad";
3611
5615
  relevance_paths: string[];
@@ -3614,30 +5618,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3614
5618
  tech_stack: string[];
3615
5619
  impact: string[];
3616
5620
  must_read_if: string;
3617
- entities?: string[] | undefined;
5621
+ created_at?: string | undefined;
3618
5622
  id?: string | undefined;
5623
+ entities?: string[] | undefined;
3619
5624
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3620
5625
  maturity?: "draft" | "verified" | "proven" | undefined;
3621
5626
  knowledge_layer?: "personal" | "team" | undefined;
3622
5627
  layer_reason?: string | undefined;
3623
- created_at?: string | undefined;
3624
5628
  tags?: string[] | undefined;
5629
+ related?: string[] | undefined;
3625
5630
  }, {
3626
5631
  summary: string;
3627
5632
  intent_clues: string[];
3628
5633
  tech_stack: string[];
3629
5634
  impact: string[];
3630
5635
  must_read_if: string;
5636
+ created_at?: string | undefined;
5637
+ id?: string | undefined;
3631
5638
  relevance_scope?: "narrow" | "broad" | undefined;
3632
5639
  relevance_paths?: string[] | undefined;
3633
5640
  entities?: string[] | undefined;
3634
- id?: string | undefined;
3635
5641
  knowledge_type?: unknown;
3636
5642
  maturity?: "draft" | "verified" | "proven" | undefined;
3637
5643
  knowledge_layer?: "personal" | "team" | undefined;
3638
5644
  layer_reason?: string | undefined;
3639
- created_at?: string | undefined;
3640
5645
  tags?: string[] | undefined;
5646
+ related?: string[] | undefined;
3641
5647
  }>>;
3642
5648
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3643
5649
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -3673,6 +5679,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3673
5679
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3674
5680
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
3675
5681
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
5682
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3676
5683
  }, "strict", z.ZodTypeAny, {
3677
5684
  relevance_scope: "narrow" | "broad";
3678
5685
  relevance_paths: string[];
@@ -3681,30 +5688,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3681
5688
  tech_stack: string[];
3682
5689
  impact: string[];
3683
5690
  must_read_if: string;
3684
- entities?: string[] | undefined;
5691
+ created_at?: string | undefined;
3685
5692
  id?: string | undefined;
5693
+ entities?: string[] | undefined;
3686
5694
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3687
5695
  maturity?: "draft" | "verified" | "proven" | undefined;
3688
5696
  knowledge_layer?: "personal" | "team" | undefined;
3689
5697
  layer_reason?: string | undefined;
3690
- created_at?: string | undefined;
3691
5698
  tags?: string[] | undefined;
5699
+ related?: string[] | undefined;
3692
5700
  }, {
3693
5701
  summary: string;
3694
5702
  intent_clues: string[];
3695
5703
  tech_stack: string[];
3696
5704
  impact: string[];
3697
5705
  must_read_if: string;
5706
+ created_at?: string | undefined;
5707
+ id?: string | undefined;
3698
5708
  relevance_scope?: "narrow" | "broad" | undefined;
3699
5709
  relevance_paths?: string[] | undefined;
3700
5710
  entities?: string[] | undefined;
3701
- id?: string | undefined;
3702
5711
  knowledge_type?: unknown;
3703
5712
  maturity?: "draft" | "verified" | "proven" | undefined;
3704
5713
  knowledge_layer?: "personal" | "team" | undefined;
3705
5714
  layer_reason?: string | undefined;
3706
- created_at?: string | undefined;
3707
5715
  tags?: string[] | undefined;
5716
+ related?: string[] | undefined;
3708
5717
  }>>;
3709
5718
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3710
5719
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -3740,6 +5749,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3740
5749
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3741
5750
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
3742
5751
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
5752
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3743
5753
  }, "strict", z.ZodTypeAny, {
3744
5754
  relevance_scope: "narrow" | "broad";
3745
5755
  relevance_paths: string[];
@@ -3748,30 +5758,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3748
5758
  tech_stack: string[];
3749
5759
  impact: string[];
3750
5760
  must_read_if: string;
3751
- entities?: string[] | undefined;
5761
+ created_at?: string | undefined;
3752
5762
  id?: string | undefined;
5763
+ entities?: string[] | undefined;
3753
5764
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3754
5765
  maturity?: "draft" | "verified" | "proven" | undefined;
3755
5766
  knowledge_layer?: "personal" | "team" | undefined;
3756
5767
  layer_reason?: string | undefined;
3757
- created_at?: string | undefined;
3758
5768
  tags?: string[] | undefined;
5769
+ related?: string[] | undefined;
3759
5770
  }, {
3760
5771
  summary: string;
3761
5772
  intent_clues: string[];
3762
5773
  tech_stack: string[];
3763
5774
  impact: string[];
3764
5775
  must_read_if: string;
5776
+ created_at?: string | undefined;
5777
+ id?: string | undefined;
3765
5778
  relevance_scope?: "narrow" | "broad" | undefined;
3766
5779
  relevance_paths?: string[] | undefined;
3767
5780
  entities?: string[] | undefined;
3768
- id?: string | undefined;
3769
5781
  knowledge_type?: unknown;
3770
5782
  maturity?: "draft" | "verified" | "proven" | undefined;
3771
5783
  knowledge_layer?: "personal" | "team" | undefined;
3772
5784
  layer_reason?: string | undefined;
3773
- created_at?: string | undefined;
3774
5785
  tags?: string[] | undefined;
5786
+ related?: string[] | undefined;
3775
5787
  }>>;
3776
5788
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3777
5789
  }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
@@ -3807,6 +5819,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3807
5819
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3808
5820
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
3809
5821
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
5822
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3810
5823
  }, "strict", z.ZodTypeAny, {
3811
5824
  relevance_scope: "narrow" | "broad";
3812
5825
  relevance_paths: string[];
@@ -3815,30 +5828,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3815
5828
  tech_stack: string[];
3816
5829
  impact: string[];
3817
5830
  must_read_if: string;
3818
- entities?: string[] | undefined;
5831
+ created_at?: string | undefined;
3819
5832
  id?: string | undefined;
5833
+ entities?: string[] | undefined;
3820
5834
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3821
5835
  maturity?: "draft" | "verified" | "proven" | undefined;
3822
5836
  knowledge_layer?: "personal" | "team" | undefined;
3823
5837
  layer_reason?: string | undefined;
3824
- created_at?: string | undefined;
3825
5838
  tags?: string[] | undefined;
5839
+ related?: string[] | undefined;
3826
5840
  }, {
3827
5841
  summary: string;
3828
5842
  intent_clues: string[];
3829
5843
  tech_stack: string[];
3830
5844
  impact: string[];
3831
5845
  must_read_if: string;
5846
+ created_at?: string | undefined;
5847
+ id?: string | undefined;
3832
5848
  relevance_scope?: "narrow" | "broad" | undefined;
3833
5849
  relevance_paths?: string[] | undefined;
3834
5850
  entities?: string[] | undefined;
3835
- id?: string | undefined;
3836
5851
  knowledge_type?: unknown;
3837
5852
  maturity?: "draft" | "verified" | "proven" | undefined;
3838
5853
  knowledge_layer?: "personal" | "team" | undefined;
3839
5854
  layer_reason?: string | undefined;
3840
- created_at?: string | undefined;
3841
5855
  tags?: string[] | undefined;
5856
+ related?: string[] | undefined;
3842
5857
  }>>;
3843
5858
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3844
5859
  }, z.ZodTypeAny, "passthrough">, unknown>>;
@@ -3947,6 +5962,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3947
5962
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3948
5963
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
3949
5964
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
5965
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
3950
5966
  }, "strict", z.ZodTypeAny, {
3951
5967
  relevance_scope: "narrow" | "broad";
3952
5968
  relevance_paths: string[];
@@ -3955,30 +5971,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3955
5971
  tech_stack: string[];
3956
5972
  impact: string[];
3957
5973
  must_read_if: string;
3958
- entities?: string[] | undefined;
5974
+ created_at?: string | undefined;
3959
5975
  id?: string | undefined;
5976
+ entities?: string[] | undefined;
3960
5977
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3961
5978
  maturity?: "draft" | "verified" | "proven" | undefined;
3962
5979
  knowledge_layer?: "personal" | "team" | undefined;
3963
5980
  layer_reason?: string | undefined;
3964
- created_at?: string | undefined;
3965
5981
  tags?: string[] | undefined;
5982
+ related?: string[] | undefined;
3966
5983
  }, {
3967
5984
  summary: string;
3968
5985
  intent_clues: string[];
3969
5986
  tech_stack: string[];
3970
5987
  impact: string[];
3971
5988
  must_read_if: string;
5989
+ created_at?: string | undefined;
5990
+ id?: string | undefined;
3972
5991
  relevance_scope?: "narrow" | "broad" | undefined;
3973
5992
  relevance_paths?: string[] | undefined;
3974
5993
  entities?: string[] | undefined;
3975
- id?: string | undefined;
3976
5994
  knowledge_type?: unknown;
3977
5995
  maturity?: "draft" | "verified" | "proven" | undefined;
3978
5996
  knowledge_layer?: "personal" | "team" | undefined;
3979
5997
  layer_reason?: string | undefined;
3980
- created_at?: string | undefined;
3981
5998
  tags?: string[] | undefined;
5999
+ related?: string[] | undefined;
3982
6000
  }>>;
3983
6001
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3984
6002
  }, z.ZodTypeAny, "passthrough">>;
@@ -4055,6 +6073,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4055
6073
  tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
4056
6074
  relevance_scope: z.ZodDefault<z.ZodEnum<["narrow", "broad"]>>;
4057
6075
  relevance_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
6076
+ related: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
4058
6077
  }, "strict", z.ZodTypeAny, {
4059
6078
  relevance_scope: "narrow" | "broad";
4060
6079
  relevance_paths: string[];
@@ -4063,30 +6082,32 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4063
6082
  tech_stack: string[];
4064
6083
  impact: string[];
4065
6084
  must_read_if: string;
4066
- entities?: string[] | undefined;
6085
+ created_at?: string | undefined;
4067
6086
  id?: string | undefined;
6087
+ entities?: string[] | undefined;
4068
6088
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
4069
6089
  maturity?: "draft" | "verified" | "proven" | undefined;
4070
6090
  knowledge_layer?: "personal" | "team" | undefined;
4071
6091
  layer_reason?: string | undefined;
4072
- created_at?: string | undefined;
4073
6092
  tags?: string[] | undefined;
6093
+ related?: string[] | undefined;
4074
6094
  }, {
4075
6095
  summary: string;
4076
6096
  intent_clues: string[];
4077
6097
  tech_stack: string[];
4078
6098
  impact: string[];
4079
6099
  must_read_if: string;
6100
+ created_at?: string | undefined;
6101
+ id?: string | undefined;
4080
6102
  relevance_scope?: "narrow" | "broad" | undefined;
4081
6103
  relevance_paths?: string[] | undefined;
4082
6104
  entities?: string[] | undefined;
4083
- id?: string | undefined;
4084
6105
  knowledge_type?: unknown;
4085
6106
  maturity?: "draft" | "verified" | "proven" | undefined;
4086
6107
  knowledge_layer?: "personal" | "team" | undefined;
4087
6108
  layer_reason?: string | undefined;
4088
- created_at?: string | undefined;
4089
6109
  tags?: string[] | undefined;
6110
+ related?: string[] | undefined;
4090
6111
  }>>;
4091
6112
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4092
6113
  }, z.ZodTypeAny, "passthrough">>;
@@ -4426,13 +6447,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4426
6447
  evidence: z.ZodArray<z.ZodString, "many">;
4427
6448
  }, "strip", z.ZodTypeAny, {
4428
6449
  version: string;
4429
- evidence: string[];
4430
6450
  kind: string;
6451
+ evidence: string[];
4431
6452
  subkind: string;
4432
6453
  }, {
4433
6454
  version: string;
4434
- evidence: string[];
4435
6455
  kind: string;
6456
+ evidence: string[];
4436
6457
  subkind: string;
4437
6458
  }>;
4438
6459
  topology: z.ZodObject<{
@@ -4590,14 +6611,14 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4590
6611
  }, "strip", z.ZodTypeAny, {
4591
6612
  version: string;
4592
6613
  generated_at: string;
6614
+ target: string;
4593
6615
  framework: {
4594
6616
  version: string;
4595
- evidence: string[];
4596
6617
  kind: string;
6618
+ evidence: string[];
4597
6619
  subkind: string;
4598
6620
  };
4599
6621
  generated_by: string;
4600
- target: string;
4601
6622
  project_name: string;
4602
6623
  topology: {
4603
6624
  total_files: number;
@@ -4652,14 +6673,14 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4652
6673
  }, {
4653
6674
  version: string;
4654
6675
  generated_at: string;
6676
+ target: string;
4655
6677
  framework: {
4656
6678
  version: string;
4657
- evidence: string[];
4658
6679
  kind: string;
6680
+ evidence: string[];
4659
6681
  subkind: string;
4660
6682
  };
4661
6683
  generated_by: string;
4662
- target: string;
4663
6684
  project_name: string;
4664
6685
  topology: {
4665
6686
  total_files: number;
@@ -4717,14 +6738,14 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4717
6738
  payload: {
4718
6739
  version: string;
4719
6740
  generated_at: string;
6741
+ target: string;
4720
6742
  framework: {
4721
6743
  version: string;
4722
- evidence: string[];
4723
6744
  kind: string;
6745
+ evidence: string[];
4724
6746
  subkind: string;
4725
6747
  };
4726
6748
  generated_by: string;
4727
- target: string;
4728
6749
  project_name: string;
4729
6750
  topology: {
4730
6751
  total_files: number;
@@ -4782,14 +6803,14 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4782
6803
  payload: {
4783
6804
  version: string;
4784
6805
  generated_at: string;
6806
+ target: string;
4785
6807
  framework: {
4786
6808
  version: string;
4787
- evidence: string[];
4788
6809
  kind: string;
6810
+ evidence: string[];
4789
6811
  subkind: string;
4790
6812
  };
4791
6813
  generated_by: string;
4792
- target: string;
4793
6814
  project_name: string;
4794
6815
  topology: {
4795
6816
  total_files: number;
@@ -5197,25 +7218,25 @@ declare const installDiffAppliedEventSchema: z.ZodObject<{
5197
7218
  correlation_id: z.ZodOptional<z.ZodString>;
5198
7219
  session_id: z.ZodOptional<z.ZodString>;
5199
7220
  }, "strip", z.ZodTypeAny, {
7221
+ id: string;
5200
7222
  canonical: string[];
5201
7223
  drifted: string[];
5202
- id: string;
5203
7224
  ts: number;
5204
7225
  schema_version: 1;
5205
7226
  kind: "fabric-event";
5206
- event_type: "install_diff_applied";
5207
7227
  applied: string[];
7228
+ event_type: "install_diff_applied";
5208
7229
  correlation_id?: string | undefined;
5209
7230
  session_id?: string | undefined;
5210
7231
  }, {
7232
+ id: string;
5211
7233
  canonical: string[];
5212
7234
  drifted: string[];
5213
- id: string;
5214
7235
  ts: number;
5215
7236
  schema_version: 1;
5216
7237
  kind: "fabric-event";
5217
- event_type: "install_diff_applied";
5218
7238
  applied: string[];
7239
+ event_type: "install_diff_applied";
5219
7240
  correlation_id?: string | undefined;
5220
7241
  session_id?: string | undefined;
5221
7242
  }>;
@@ -5512,7 +7533,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
5512
7533
  written_stable_ids: string[];
5513
7534
  correlation_id?: string | undefined;
5514
7535
  session_id?: string | undefined;
5515
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
7536
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
5516
7537
  }, {
5517
7538
  id: string;
5518
7539
  ts: number;
@@ -5523,7 +7544,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
5523
7544
  written_stable_ids: string[];
5524
7545
  correlation_id?: string | undefined;
5525
7546
  session_id?: string | undefined;
5526
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
7547
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
5527
7548
  }>;
5528
7549
  declare const knowledgeProposedEventSchema: z.ZodObject<{
5529
7550
  event_type: z.ZodLiteral<"knowledge_proposed">;
@@ -6182,8 +8203,8 @@ declare const pendingAutoArchivedEventSchema: z.ZodObject<{
6182
8203
  correlation_id: z.ZodOptional<z.ZodString>;
6183
8204
  session_id: z.ZodOptional<z.ZodString>;
6184
8205
  }, "strip", z.ZodTypeAny, {
6185
- pending_path: string;
6186
8206
  id: string;
8207
+ pending_path: string;
6187
8208
  reason: string;
6188
8209
  ts: number;
6189
8210
  schema_version: 1;
@@ -6193,8 +8214,8 @@ declare const pendingAutoArchivedEventSchema: z.ZodObject<{
6193
8214
  correlation_id?: string | undefined;
6194
8215
  session_id?: string | undefined;
6195
8216
  }, {
6196
- pending_path: string;
6197
8217
  id: string;
8218
+ pending_path: string;
6198
8219
  reason: string;
6199
8220
  ts: number;
6200
8221
  schema_version: 1;
@@ -6208,7 +8229,7 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6208
8229
  event_type: z.ZodLiteral<"assistant_turn_observed">;
6209
8230
  kb_line_raw: z.ZodNullable<z.ZodString>;
6210
8231
  cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
6211
- cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
8232
+ cite_tags: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEnum<["applied", "dismissed", "none"]>, "none" | "applied" | "dismissed", unknown>, "many">>;
6212
8233
  cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
6213
8234
  operators: z.ZodArray<z.ZodObject<{
6214
8235
  kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
@@ -6253,7 +8274,7 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6253
8274
  timestamp: string;
6254
8275
  kb_line_raw: string | null;
6255
8276
  cite_ids: string[];
6256
- cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
8277
+ cite_tags: ("none" | "applied" | "dismissed")[];
6257
8278
  cite_commitments: {
6258
8279
  operators: {
6259
8280
  kind: "require" | "edit" | "not_edit" | "forbid";
@@ -6278,7 +8299,7 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6278
8299
  correlation_id?: string | undefined;
6279
8300
  session_id?: string | undefined;
6280
8301
  cite_ids?: string[] | undefined;
6281
- cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
8302
+ cite_tags?: unknown[] | undefined;
6282
8303
  cite_commitments?: {
6283
8304
  operators: {
6284
8305
  kind: "require" | "edit" | "not_edit" | "forbid";
@@ -6516,16 +8537,410 @@ declare const sessionArchiveAttemptedEventSchema: z.ZodObject<{
6516
8537
  session_id?: string | undefined;
6517
8538
  }, {
6518
8539
  id: string;
6519
- covered_through_ts: number;
8540
+ covered_through_ts: number;
8541
+ ts: number;
8542
+ schema_version: 1;
8543
+ kind: "fabric-event";
8544
+ event_type: "session_archive_attempted";
8545
+ outcome: "user_dismissed" | "proposed" | "viability_failed" | "skipped_no_signal";
8546
+ correlation_id?: string | undefined;
8547
+ session_id?: string | undefined;
8548
+ candidates_proposed?: number | undefined;
8549
+ knowledge_proposed_ids?: string[] | undefined;
8550
+ }>;
8551
+ declare const hookSurfaceEmittedEventSchema: z.ZodObject<{
8552
+ event_type: z.ZodLiteral<"hook_surface_emitted">;
8553
+ hook_name: z.ZodString;
8554
+ client: z.ZodEnum<["cc", "codex", "cursor"]>;
8555
+ target_channel: z.ZodString;
8556
+ rendered_ids: z.ZodArray<z.ZodString, "many">;
8557
+ delivery_status: z.ZodEnum<["delivered", "suppressed", "error"]>;
8558
+ suppression_reason: z.ZodOptional<z.ZodString>;
8559
+ kind: z.ZodLiteral<"fabric-event">;
8560
+ id: z.ZodString;
8561
+ ts: z.ZodNumber;
8562
+ schema_version: z.ZodLiteral<1>;
8563
+ correlation_id: z.ZodOptional<z.ZodString>;
8564
+ session_id: z.ZodOptional<z.ZodString>;
8565
+ }, "strip", z.ZodTypeAny, {
8566
+ id: string;
8567
+ ts: number;
8568
+ schema_version: 1;
8569
+ kind: "fabric-event";
8570
+ event_type: "hook_surface_emitted";
8571
+ client: "cursor" | "cc" | "codex";
8572
+ hook_name: string;
8573
+ target_channel: string;
8574
+ rendered_ids: string[];
8575
+ delivery_status: "error" | "delivered" | "suppressed";
8576
+ correlation_id?: string | undefined;
8577
+ session_id?: string | undefined;
8578
+ suppression_reason?: string | undefined;
8579
+ }, {
8580
+ id: string;
8581
+ ts: number;
8582
+ schema_version: 1;
8583
+ kind: "fabric-event";
8584
+ event_type: "hook_surface_emitted";
8585
+ client: "cursor" | "cc" | "codex";
8586
+ hook_name: string;
8587
+ target_channel: string;
8588
+ rendered_ids: string[];
8589
+ delivery_status: "error" | "delivered" | "suppressed";
8590
+ correlation_id?: string | undefined;
8591
+ session_id?: string | undefined;
8592
+ suppression_reason?: string | undefined;
8593
+ }>;
8594
+ declare const hookSignalEmittedEventSchema: z.ZodObject<{
8595
+ event_type: z.ZodLiteral<"hook_signal_emitted">;
8596
+ signal_type: z.ZodEnum<["archive", "review", "maintenance", "other"]>;
8597
+ threshold: z.ZodNumber;
8598
+ actual_value: z.ZodNumber;
8599
+ fired: z.ZodBoolean;
8600
+ kind: z.ZodLiteral<"fabric-event">;
8601
+ id: z.ZodString;
8602
+ ts: z.ZodNumber;
8603
+ schema_version: z.ZodLiteral<1>;
8604
+ correlation_id: z.ZodOptional<z.ZodString>;
8605
+ session_id: z.ZodOptional<z.ZodString>;
8606
+ }, "strip", z.ZodTypeAny, {
8607
+ id: string;
8608
+ ts: number;
8609
+ schema_version: 1;
8610
+ kind: "fabric-event";
8611
+ event_type: "hook_signal_emitted";
8612
+ signal_type: "archive" | "review" | "maintenance" | "other";
8613
+ threshold: number;
8614
+ actual_value: number;
8615
+ fired: boolean;
8616
+ correlation_id?: string | undefined;
8617
+ session_id?: string | undefined;
8618
+ }, {
8619
+ id: string;
8620
+ ts: number;
8621
+ schema_version: 1;
8622
+ kind: "fabric-event";
8623
+ event_type: "hook_signal_emitted";
8624
+ signal_type: "archive" | "review" | "maintenance" | "other";
8625
+ threshold: number;
8626
+ actual_value: number;
8627
+ fired: boolean;
8628
+ correlation_id?: string | undefined;
8629
+ session_id?: string | undefined;
8630
+ }>;
8631
+ declare const mcpStdioTraceEventSchema: z.ZodObject<{
8632
+ event_type: z.ZodLiteral<"mcp_stdio_trace">;
8633
+ tool_name: z.ZodString;
8634
+ request_id: z.ZodString;
8635
+ duration_ms: z.ZodNumber;
8636
+ status: z.ZodEnum<["ok", "error"]>;
8637
+ payload_bytes_in: z.ZodNumber;
8638
+ payload_bytes_out: z.ZodNumber;
8639
+ error_code: z.ZodOptional<z.ZodString>;
8640
+ kind: z.ZodLiteral<"fabric-event">;
8641
+ id: z.ZodString;
8642
+ ts: z.ZodNumber;
8643
+ schema_version: z.ZodLiteral<1>;
8644
+ correlation_id: z.ZodOptional<z.ZodString>;
8645
+ session_id: z.ZodOptional<z.ZodString>;
8646
+ }, "strip", z.ZodTypeAny, {
8647
+ status: "ok" | "error";
8648
+ id: string;
8649
+ ts: number;
8650
+ schema_version: 1;
8651
+ kind: "fabric-event";
8652
+ event_type: "mcp_stdio_trace";
8653
+ duration_ms: number;
8654
+ tool_name: string;
8655
+ request_id: string;
8656
+ payload_bytes_in: number;
8657
+ payload_bytes_out: number;
8658
+ correlation_id?: string | undefined;
8659
+ session_id?: string | undefined;
8660
+ error_code?: string | undefined;
8661
+ }, {
8662
+ status: "ok" | "error";
8663
+ id: string;
8664
+ ts: number;
8665
+ schema_version: 1;
8666
+ kind: "fabric-event";
8667
+ event_type: "mcp_stdio_trace";
8668
+ duration_ms: number;
8669
+ tool_name: string;
8670
+ request_id: string;
8671
+ payload_bytes_in: number;
8672
+ payload_bytes_out: number;
8673
+ correlation_id?: string | undefined;
8674
+ session_id?: string | undefined;
8675
+ error_code?: string | undefined;
8676
+ }>;
8677
+ declare const payloadGuardObservedEventSchema: z.ZodObject<{
8678
+ event_type: z.ZodLiteral<"payload_guard_observed">;
8679
+ tool_name: z.ZodString;
8680
+ path_count: z.ZodNumber;
8681
+ tokens_estimated: z.ZodNumber;
8682
+ truncated: z.ZodBoolean;
8683
+ cap: z.ZodNumber;
8684
+ kind: z.ZodLiteral<"fabric-event">;
8685
+ id: z.ZodString;
8686
+ ts: z.ZodNumber;
8687
+ schema_version: z.ZodLiteral<1>;
8688
+ correlation_id: z.ZodOptional<z.ZodString>;
8689
+ session_id: z.ZodOptional<z.ZodString>;
8690
+ }, "strip", z.ZodTypeAny, {
8691
+ id: string;
8692
+ ts: number;
8693
+ schema_version: 1;
8694
+ kind: "fabric-event";
8695
+ event_type: "payload_guard_observed";
8696
+ tool_name: string;
8697
+ path_count: number;
8698
+ tokens_estimated: number;
8699
+ truncated: boolean;
8700
+ cap: number;
8701
+ correlation_id?: string | undefined;
8702
+ session_id?: string | undefined;
8703
+ }, {
8704
+ id: string;
8705
+ ts: number;
8706
+ schema_version: 1;
8707
+ kind: "fabric-event";
8708
+ event_type: "payload_guard_observed";
8709
+ tool_name: string;
8710
+ path_count: number;
8711
+ tokens_estimated: number;
8712
+ truncated: boolean;
8713
+ cap: number;
8714
+ correlation_id?: string | undefined;
8715
+ session_id?: string | undefined;
8716
+ }>;
8717
+ declare const skillInvocationStartedEventSchema: z.ZodObject<{
8718
+ event_type: z.ZodLiteral<"skill_invocation_started">;
8719
+ skill_name: z.ZodString;
8720
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
8721
+ entry_point: z.ZodString;
8722
+ kind: z.ZodLiteral<"fabric-event">;
8723
+ id: z.ZodString;
8724
+ ts: z.ZodNumber;
8725
+ schema_version: z.ZodLiteral<1>;
8726
+ correlation_id: z.ZodOptional<z.ZodString>;
8727
+ session_id: z.ZodOptional<z.ZodString>;
8728
+ }, "strip", z.ZodTypeAny, {
8729
+ id: string;
8730
+ ts: number;
8731
+ schema_version: 1;
8732
+ kind: "fabric-event";
8733
+ event_type: "skill_invocation_started";
8734
+ skill_name: string;
8735
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8736
+ entry_point: string;
8737
+ correlation_id?: string | undefined;
8738
+ session_id?: string | undefined;
8739
+ }, {
8740
+ id: string;
8741
+ ts: number;
8742
+ schema_version: 1;
8743
+ kind: "fabric-event";
8744
+ event_type: "skill_invocation_started";
8745
+ skill_name: string;
8746
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8747
+ entry_point: string;
8748
+ correlation_id?: string | undefined;
8749
+ session_id?: string | undefined;
8750
+ }>;
8751
+ declare const skillInvocationCompletedEventSchema: z.ZodObject<{
8752
+ event_type: z.ZodLiteral<"skill_invocation_completed">;
8753
+ skill_name: z.ZodString;
8754
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
8755
+ entry_point: z.ZodString;
8756
+ outcome: z.ZodEnum<["completed", "aborted", "error", "no_op"]>;
8757
+ elapsed_ms: z.ZodOptional<z.ZodNumber>;
8758
+ kind: z.ZodLiteral<"fabric-event">;
8759
+ id: z.ZodString;
8760
+ ts: z.ZodNumber;
8761
+ schema_version: z.ZodLiteral<1>;
8762
+ correlation_id: z.ZodOptional<z.ZodString>;
8763
+ session_id: z.ZodOptional<z.ZodString>;
8764
+ }, "strip", z.ZodTypeAny, {
8765
+ id: string;
8766
+ ts: number;
8767
+ schema_version: 1;
8768
+ kind: "fabric-event";
8769
+ event_type: "skill_invocation_completed";
8770
+ outcome: "aborted" | "completed" | "error" | "no_op";
8771
+ skill_name: string;
8772
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8773
+ entry_point: string;
8774
+ correlation_id?: string | undefined;
8775
+ session_id?: string | undefined;
8776
+ elapsed_ms?: number | undefined;
8777
+ }, {
8778
+ id: string;
8779
+ ts: number;
8780
+ schema_version: 1;
8781
+ kind: "fabric-event";
8782
+ event_type: "skill_invocation_completed";
8783
+ outcome: "aborted" | "completed" | "error" | "no_op";
8784
+ skill_name: string;
8785
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8786
+ entry_point: string;
8787
+ correlation_id?: string | undefined;
8788
+ session_id?: string | undefined;
8789
+ elapsed_ms?: number | undefined;
8790
+ }>;
8791
+ declare const skillPhaseTransitionEventSchema: z.ZodObject<{
8792
+ event_type: z.ZodLiteral<"skill_phase_transition">;
8793
+ skill_name: z.ZodString;
8794
+ phase: z.ZodString;
8795
+ status: z.ZodEnum<["entered", "completed", "skipped", "failed"]>;
8796
+ checkpoint: z.ZodOptional<z.ZodString>;
8797
+ elapsed_ms: z.ZodOptional<z.ZodNumber>;
8798
+ kind: z.ZodLiteral<"fabric-event">;
8799
+ id: z.ZodString;
8800
+ ts: z.ZodNumber;
8801
+ schema_version: z.ZodLiteral<1>;
8802
+ correlation_id: z.ZodOptional<z.ZodString>;
8803
+ session_id: z.ZodOptional<z.ZodString>;
8804
+ }, "strip", z.ZodTypeAny, {
8805
+ status: "skipped" | "completed" | "failed" | "entered";
8806
+ id: string;
8807
+ ts: number;
8808
+ schema_version: 1;
8809
+ kind: "fabric-event";
8810
+ phase: string;
8811
+ event_type: "skill_phase_transition";
8812
+ skill_name: string;
8813
+ correlation_id?: string | undefined;
8814
+ session_id?: string | undefined;
8815
+ elapsed_ms?: number | undefined;
8816
+ checkpoint?: string | undefined;
8817
+ }, {
8818
+ status: "skipped" | "completed" | "failed" | "entered";
8819
+ id: string;
8820
+ ts: number;
8821
+ schema_version: 1;
8822
+ kind: "fabric-event";
8823
+ phase: string;
8824
+ event_type: "skill_phase_transition";
8825
+ skill_name: string;
8826
+ correlation_id?: string | undefined;
8827
+ session_id?: string | undefined;
8828
+ elapsed_ms?: number | undefined;
8829
+ checkpoint?: string | undefined;
8830
+ }>;
8831
+ declare const skillTriggerCandidateEventSchema: z.ZodObject<{
8832
+ event_type: z.ZodLiteral<"skill_trigger_candidate">;
8833
+ skill_name: z.ZodString;
8834
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
8835
+ signal: z.ZodString;
8836
+ invoked: z.ZodBoolean;
8837
+ kind: z.ZodLiteral<"fabric-event">;
8838
+ id: z.ZodString;
8839
+ ts: z.ZodNumber;
8840
+ schema_version: z.ZodLiteral<1>;
8841
+ correlation_id: z.ZodOptional<z.ZodString>;
8842
+ session_id: z.ZodOptional<z.ZodString>;
8843
+ }, "strip", z.ZodTypeAny, {
8844
+ id: string;
8845
+ ts: number;
8846
+ schema_version: 1;
8847
+ kind: "fabric-event";
8848
+ event_type: "skill_trigger_candidate";
8849
+ skill_name: string;
8850
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8851
+ signal: string;
8852
+ invoked: boolean;
8853
+ correlation_id?: string | undefined;
8854
+ session_id?: string | undefined;
8855
+ }, {
8856
+ id: string;
8857
+ ts: number;
8858
+ schema_version: 1;
8859
+ kind: "fabric-event";
8860
+ event_type: "skill_trigger_candidate";
8861
+ skill_name: string;
8862
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
8863
+ signal: string;
8864
+ invoked: boolean;
8865
+ correlation_id?: string | undefined;
8866
+ session_id?: string | undefined;
8867
+ }>;
8868
+ declare const llmJudgeRunEventSchema: z.ZodObject<{
8869
+ event_type: z.ZodLiteral<"llm_judge_run">;
8870
+ prompt: z.ZodString;
8871
+ version: z.ZodString;
8872
+ model: z.ZodString;
8873
+ input_trace_id: z.ZodString;
8874
+ score: z.ZodNumber;
8875
+ rationale: z.ZodString;
8876
+ kind: z.ZodLiteral<"fabric-event">;
8877
+ id: z.ZodString;
8878
+ ts: z.ZodNumber;
8879
+ schema_version: z.ZodLiteral<1>;
8880
+ correlation_id: z.ZodOptional<z.ZodString>;
8881
+ session_id: z.ZodOptional<z.ZodString>;
8882
+ }, "strip", z.ZodTypeAny, {
8883
+ id: string;
8884
+ version: string;
8885
+ ts: number;
8886
+ model: string;
8887
+ schema_version: 1;
8888
+ kind: "fabric-event";
8889
+ rationale: string;
8890
+ event_type: "llm_judge_run";
8891
+ prompt: string;
8892
+ input_trace_id: string;
8893
+ score: number;
8894
+ correlation_id?: string | undefined;
8895
+ session_id?: string | undefined;
8896
+ }, {
8897
+ id: string;
8898
+ version: string;
8899
+ ts: number;
8900
+ model: string;
8901
+ schema_version: 1;
8902
+ kind: "fabric-event";
8903
+ rationale: string;
8904
+ event_type: "llm_judge_run";
8905
+ prompt: string;
8906
+ input_trace_id: string;
8907
+ score: number;
8908
+ correlation_id?: string | undefined;
8909
+ session_id?: string | undefined;
8910
+ }>;
8911
+ declare const clientCapabilitySnapshotEventSchema: z.ZodObject<{
8912
+ event_type: z.ZodLiteral<"client_capability_snapshot">;
8913
+ client: z.ZodEnum<["cc", "codex", "cursor"]>;
8914
+ capabilities: z.ZodArray<z.ZodString, "many">;
8915
+ version: z.ZodString;
8916
+ kind: z.ZodLiteral<"fabric-event">;
8917
+ id: z.ZodString;
8918
+ ts: z.ZodNumber;
8919
+ schema_version: z.ZodLiteral<1>;
8920
+ correlation_id: z.ZodOptional<z.ZodString>;
8921
+ session_id: z.ZodOptional<z.ZodString>;
8922
+ }, "strip", z.ZodTypeAny, {
8923
+ id: string;
8924
+ version: string;
8925
+ ts: number;
8926
+ schema_version: 1;
8927
+ capabilities: string[];
8928
+ kind: "fabric-event";
8929
+ event_type: "client_capability_snapshot";
8930
+ client: "cursor" | "cc" | "codex";
8931
+ correlation_id?: string | undefined;
8932
+ session_id?: string | undefined;
8933
+ }, {
8934
+ id: string;
8935
+ version: string;
6520
8936
  ts: number;
6521
8937
  schema_version: 1;
8938
+ capabilities: string[];
6522
8939
  kind: "fabric-event";
6523
- event_type: "session_archive_attempted";
6524
- outcome: "user_dismissed" | "proposed" | "viability_failed" | "skipped_no_signal";
8940
+ event_type: "client_capability_snapshot";
8941
+ client: "cursor" | "cc" | "codex";
6525
8942
  correlation_id?: string | undefined;
6526
8943
  session_id?: string | undefined;
6527
- candidates_proposed?: number | undefined;
6528
- knowledge_proposed_ids?: string[] | undefined;
6529
8944
  }>;
6530
8945
  declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.ZodObject<{
6531
8946
  event_type: z.ZodLiteral<"knowledge_context_planned">;
@@ -6873,25 +9288,25 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
6873
9288
  correlation_id: z.ZodOptional<z.ZodString>;
6874
9289
  session_id: z.ZodOptional<z.ZodString>;
6875
9290
  }, "strip", z.ZodTypeAny, {
9291
+ id: string;
6876
9292
  canonical: string[];
6877
9293
  drifted: string[];
6878
- id: string;
6879
9294
  ts: number;
6880
9295
  schema_version: 1;
6881
9296
  kind: "fabric-event";
6882
- event_type: "install_diff_applied";
6883
9297
  applied: string[];
9298
+ event_type: "install_diff_applied";
6884
9299
  correlation_id?: string | undefined;
6885
9300
  session_id?: string | undefined;
6886
9301
  }, {
9302
+ id: string;
6887
9303
  canonical: string[];
6888
9304
  drifted: string[];
6889
- id: string;
6890
9305
  ts: number;
6891
9306
  schema_version: 1;
6892
9307
  kind: "fabric-event";
6893
- event_type: "install_diff_applied";
6894
9308
  applied: string[];
9309
+ event_type: "install_diff_applied";
6895
9310
  correlation_id?: string | undefined;
6896
9311
  session_id?: string | undefined;
6897
9312
  }>, z.ZodObject<{
@@ -7179,7 +9594,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7179
9594
  written_stable_ids: string[];
7180
9595
  correlation_id?: string | undefined;
7181
9596
  session_id?: string | undefined;
7182
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
9597
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
7183
9598
  }, {
7184
9599
  id: string;
7185
9600
  ts: number;
@@ -7190,7 +9605,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7190
9605
  written_stable_ids: string[];
7191
9606
  correlation_id?: string | undefined;
7192
9607
  session_id?: string | undefined;
7193
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
9608
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
7194
9609
  }>, z.ZodObject<{
7195
9610
  event_type: z.ZodLiteral<"knowledge_proposed">;
7196
9611
  stable_id: z.ZodOptional<z.ZodString>;
@@ -7731,8 +10146,8 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7731
10146
  correlation_id: z.ZodOptional<z.ZodString>;
7732
10147
  session_id: z.ZodOptional<z.ZodString>;
7733
10148
  }, "strip", z.ZodTypeAny, {
7734
- pending_path: string;
7735
10149
  id: string;
10150
+ pending_path: string;
7736
10151
  reason: string;
7737
10152
  ts: number;
7738
10153
  schema_version: 1;
@@ -7742,8 +10157,8 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7742
10157
  correlation_id?: string | undefined;
7743
10158
  session_id?: string | undefined;
7744
10159
  }, {
7745
- pending_path: string;
7746
10160
  id: string;
10161
+ pending_path: string;
7747
10162
  reason: string;
7748
10163
  ts: number;
7749
10164
  schema_version: 1;
@@ -7855,7 +10270,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7855
10270
  event_type: z.ZodLiteral<"assistant_turn_observed">;
7856
10271
  kb_line_raw: z.ZodNullable<z.ZodString>;
7857
10272
  cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
7858
- cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
10273
+ cite_tags: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEnum<["applied", "dismissed", "none"]>, "none" | "applied" | "dismissed", unknown>, "many">>;
7859
10274
  cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
7860
10275
  operators: z.ZodArray<z.ZodObject<{
7861
10276
  kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
@@ -7900,7 +10315,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7900
10315
  timestamp: string;
7901
10316
  kb_line_raw: string | null;
7902
10317
  cite_ids: string[];
7903
- cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
10318
+ cite_tags: ("none" | "applied" | "dismissed")[];
7904
10319
  cite_commitments: {
7905
10320
  operators: {
7906
10321
  kind: "require" | "edit" | "not_edit" | "forbid";
@@ -7925,7 +10340,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7925
10340
  correlation_id?: string | undefined;
7926
10341
  session_id?: string | undefined;
7927
10342
  cite_ids?: string[] | undefined;
7928
- cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
10343
+ cite_tags?: unknown[] | undefined;
7929
10344
  cite_commitments?: {
7930
10345
  operators: {
7931
10346
  kind: "require" | "edit" | "not_edit" | "forbid";
@@ -8166,6 +10581,390 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
8166
10581
  session_id?: string | undefined;
8167
10582
  candidates_proposed?: number | undefined;
8168
10583
  knowledge_proposed_ids?: string[] | undefined;
10584
+ }>, z.ZodObject<{
10585
+ event_type: z.ZodLiteral<"hook_surface_emitted">;
10586
+ hook_name: z.ZodString;
10587
+ client: z.ZodEnum<["cc", "codex", "cursor"]>;
10588
+ target_channel: z.ZodString;
10589
+ rendered_ids: z.ZodArray<z.ZodString, "many">;
10590
+ delivery_status: z.ZodEnum<["delivered", "suppressed", "error"]>;
10591
+ suppression_reason: z.ZodOptional<z.ZodString>;
10592
+ kind: z.ZodLiteral<"fabric-event">;
10593
+ id: z.ZodString;
10594
+ ts: z.ZodNumber;
10595
+ schema_version: z.ZodLiteral<1>;
10596
+ correlation_id: z.ZodOptional<z.ZodString>;
10597
+ session_id: z.ZodOptional<z.ZodString>;
10598
+ }, "strip", z.ZodTypeAny, {
10599
+ id: string;
10600
+ ts: number;
10601
+ schema_version: 1;
10602
+ kind: "fabric-event";
10603
+ event_type: "hook_surface_emitted";
10604
+ client: "cursor" | "cc" | "codex";
10605
+ hook_name: string;
10606
+ target_channel: string;
10607
+ rendered_ids: string[];
10608
+ delivery_status: "error" | "delivered" | "suppressed";
10609
+ correlation_id?: string | undefined;
10610
+ session_id?: string | undefined;
10611
+ suppression_reason?: string | undefined;
10612
+ }, {
10613
+ id: string;
10614
+ ts: number;
10615
+ schema_version: 1;
10616
+ kind: "fabric-event";
10617
+ event_type: "hook_surface_emitted";
10618
+ client: "cursor" | "cc" | "codex";
10619
+ hook_name: string;
10620
+ target_channel: string;
10621
+ rendered_ids: string[];
10622
+ delivery_status: "error" | "delivered" | "suppressed";
10623
+ correlation_id?: string | undefined;
10624
+ session_id?: string | undefined;
10625
+ suppression_reason?: string | undefined;
10626
+ }>, z.ZodObject<{
10627
+ event_type: z.ZodLiteral<"hook_signal_emitted">;
10628
+ signal_type: z.ZodEnum<["archive", "review", "maintenance", "other"]>;
10629
+ threshold: z.ZodNumber;
10630
+ actual_value: z.ZodNumber;
10631
+ fired: z.ZodBoolean;
10632
+ kind: z.ZodLiteral<"fabric-event">;
10633
+ id: z.ZodString;
10634
+ ts: z.ZodNumber;
10635
+ schema_version: z.ZodLiteral<1>;
10636
+ correlation_id: z.ZodOptional<z.ZodString>;
10637
+ session_id: z.ZodOptional<z.ZodString>;
10638
+ }, "strip", z.ZodTypeAny, {
10639
+ id: string;
10640
+ ts: number;
10641
+ schema_version: 1;
10642
+ kind: "fabric-event";
10643
+ event_type: "hook_signal_emitted";
10644
+ signal_type: "archive" | "review" | "maintenance" | "other";
10645
+ threshold: number;
10646
+ actual_value: number;
10647
+ fired: boolean;
10648
+ correlation_id?: string | undefined;
10649
+ session_id?: string | undefined;
10650
+ }, {
10651
+ id: string;
10652
+ ts: number;
10653
+ schema_version: 1;
10654
+ kind: "fabric-event";
10655
+ event_type: "hook_signal_emitted";
10656
+ signal_type: "archive" | "review" | "maintenance" | "other";
10657
+ threshold: number;
10658
+ actual_value: number;
10659
+ fired: boolean;
10660
+ correlation_id?: string | undefined;
10661
+ session_id?: string | undefined;
10662
+ }>, z.ZodObject<{
10663
+ event_type: z.ZodLiteral<"mcp_stdio_trace">;
10664
+ tool_name: z.ZodString;
10665
+ request_id: z.ZodString;
10666
+ duration_ms: z.ZodNumber;
10667
+ status: z.ZodEnum<["ok", "error"]>;
10668
+ payload_bytes_in: z.ZodNumber;
10669
+ payload_bytes_out: z.ZodNumber;
10670
+ error_code: z.ZodOptional<z.ZodString>;
10671
+ kind: z.ZodLiteral<"fabric-event">;
10672
+ id: z.ZodString;
10673
+ ts: z.ZodNumber;
10674
+ schema_version: z.ZodLiteral<1>;
10675
+ correlation_id: z.ZodOptional<z.ZodString>;
10676
+ session_id: z.ZodOptional<z.ZodString>;
10677
+ }, "strip", z.ZodTypeAny, {
10678
+ status: "ok" | "error";
10679
+ id: string;
10680
+ ts: number;
10681
+ schema_version: 1;
10682
+ kind: "fabric-event";
10683
+ event_type: "mcp_stdio_trace";
10684
+ duration_ms: number;
10685
+ tool_name: string;
10686
+ request_id: string;
10687
+ payload_bytes_in: number;
10688
+ payload_bytes_out: number;
10689
+ correlation_id?: string | undefined;
10690
+ session_id?: string | undefined;
10691
+ error_code?: string | undefined;
10692
+ }, {
10693
+ status: "ok" | "error";
10694
+ id: string;
10695
+ ts: number;
10696
+ schema_version: 1;
10697
+ kind: "fabric-event";
10698
+ event_type: "mcp_stdio_trace";
10699
+ duration_ms: number;
10700
+ tool_name: string;
10701
+ request_id: string;
10702
+ payload_bytes_in: number;
10703
+ payload_bytes_out: number;
10704
+ correlation_id?: string | undefined;
10705
+ session_id?: string | undefined;
10706
+ error_code?: string | undefined;
10707
+ }>, z.ZodObject<{
10708
+ event_type: z.ZodLiteral<"payload_guard_observed">;
10709
+ tool_name: z.ZodString;
10710
+ path_count: z.ZodNumber;
10711
+ tokens_estimated: z.ZodNumber;
10712
+ truncated: z.ZodBoolean;
10713
+ cap: z.ZodNumber;
10714
+ kind: z.ZodLiteral<"fabric-event">;
10715
+ id: z.ZodString;
10716
+ ts: z.ZodNumber;
10717
+ schema_version: z.ZodLiteral<1>;
10718
+ correlation_id: z.ZodOptional<z.ZodString>;
10719
+ session_id: z.ZodOptional<z.ZodString>;
10720
+ }, "strip", z.ZodTypeAny, {
10721
+ id: string;
10722
+ ts: number;
10723
+ schema_version: 1;
10724
+ kind: "fabric-event";
10725
+ event_type: "payload_guard_observed";
10726
+ tool_name: string;
10727
+ path_count: number;
10728
+ tokens_estimated: number;
10729
+ truncated: boolean;
10730
+ cap: number;
10731
+ correlation_id?: string | undefined;
10732
+ session_id?: string | undefined;
10733
+ }, {
10734
+ id: string;
10735
+ ts: number;
10736
+ schema_version: 1;
10737
+ kind: "fabric-event";
10738
+ event_type: "payload_guard_observed";
10739
+ tool_name: string;
10740
+ path_count: number;
10741
+ tokens_estimated: number;
10742
+ truncated: boolean;
10743
+ cap: number;
10744
+ correlation_id?: string | undefined;
10745
+ session_id?: string | undefined;
10746
+ }>, z.ZodObject<{
10747
+ event_type: z.ZodLiteral<"skill_invocation_started">;
10748
+ skill_name: z.ZodString;
10749
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
10750
+ entry_point: z.ZodString;
10751
+ kind: z.ZodLiteral<"fabric-event">;
10752
+ id: z.ZodString;
10753
+ ts: z.ZodNumber;
10754
+ schema_version: z.ZodLiteral<1>;
10755
+ correlation_id: z.ZodOptional<z.ZodString>;
10756
+ session_id: z.ZodOptional<z.ZodString>;
10757
+ }, "strip", z.ZodTypeAny, {
10758
+ id: string;
10759
+ ts: number;
10760
+ schema_version: 1;
10761
+ kind: "fabric-event";
10762
+ event_type: "skill_invocation_started";
10763
+ skill_name: string;
10764
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10765
+ entry_point: string;
10766
+ correlation_id?: string | undefined;
10767
+ session_id?: string | undefined;
10768
+ }, {
10769
+ id: string;
10770
+ ts: number;
10771
+ schema_version: 1;
10772
+ kind: "fabric-event";
10773
+ event_type: "skill_invocation_started";
10774
+ skill_name: string;
10775
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10776
+ entry_point: string;
10777
+ correlation_id?: string | undefined;
10778
+ session_id?: string | undefined;
10779
+ }>, z.ZodObject<{
10780
+ event_type: z.ZodLiteral<"skill_invocation_completed">;
10781
+ skill_name: z.ZodString;
10782
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
10783
+ entry_point: z.ZodString;
10784
+ outcome: z.ZodEnum<["completed", "aborted", "error", "no_op"]>;
10785
+ elapsed_ms: z.ZodOptional<z.ZodNumber>;
10786
+ kind: z.ZodLiteral<"fabric-event">;
10787
+ id: z.ZodString;
10788
+ ts: z.ZodNumber;
10789
+ schema_version: z.ZodLiteral<1>;
10790
+ correlation_id: z.ZodOptional<z.ZodString>;
10791
+ session_id: z.ZodOptional<z.ZodString>;
10792
+ }, "strip", z.ZodTypeAny, {
10793
+ id: string;
10794
+ ts: number;
10795
+ schema_version: 1;
10796
+ kind: "fabric-event";
10797
+ event_type: "skill_invocation_completed";
10798
+ outcome: "aborted" | "completed" | "error" | "no_op";
10799
+ skill_name: string;
10800
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10801
+ entry_point: string;
10802
+ correlation_id?: string | undefined;
10803
+ session_id?: string | undefined;
10804
+ elapsed_ms?: number | undefined;
10805
+ }, {
10806
+ id: string;
10807
+ ts: number;
10808
+ schema_version: 1;
10809
+ kind: "fabric-event";
10810
+ event_type: "skill_invocation_completed";
10811
+ outcome: "aborted" | "completed" | "error" | "no_op";
10812
+ skill_name: string;
10813
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10814
+ entry_point: string;
10815
+ correlation_id?: string | undefined;
10816
+ session_id?: string | undefined;
10817
+ elapsed_ms?: number | undefined;
10818
+ }>, z.ZodObject<{
10819
+ event_type: z.ZodLiteral<"skill_phase_transition">;
10820
+ skill_name: z.ZodString;
10821
+ phase: z.ZodString;
10822
+ status: z.ZodEnum<["entered", "completed", "skipped", "failed"]>;
10823
+ checkpoint: z.ZodOptional<z.ZodString>;
10824
+ elapsed_ms: z.ZodOptional<z.ZodNumber>;
10825
+ kind: z.ZodLiteral<"fabric-event">;
10826
+ id: z.ZodString;
10827
+ ts: z.ZodNumber;
10828
+ schema_version: z.ZodLiteral<1>;
10829
+ correlation_id: z.ZodOptional<z.ZodString>;
10830
+ session_id: z.ZodOptional<z.ZodString>;
10831
+ }, "strip", z.ZodTypeAny, {
10832
+ status: "skipped" | "completed" | "failed" | "entered";
10833
+ id: string;
10834
+ ts: number;
10835
+ schema_version: 1;
10836
+ kind: "fabric-event";
10837
+ phase: string;
10838
+ event_type: "skill_phase_transition";
10839
+ skill_name: string;
10840
+ correlation_id?: string | undefined;
10841
+ session_id?: string | undefined;
10842
+ elapsed_ms?: number | undefined;
10843
+ checkpoint?: string | undefined;
10844
+ }, {
10845
+ status: "skipped" | "completed" | "failed" | "entered";
10846
+ id: string;
10847
+ ts: number;
10848
+ schema_version: 1;
10849
+ kind: "fabric-event";
10850
+ phase: string;
10851
+ event_type: "skill_phase_transition";
10852
+ skill_name: string;
10853
+ correlation_id?: string | undefined;
10854
+ session_id?: string | undefined;
10855
+ elapsed_ms?: number | undefined;
10856
+ checkpoint?: string | undefined;
10857
+ }>, z.ZodObject<{
10858
+ event_type: z.ZodLiteral<"skill_trigger_candidate">;
10859
+ skill_name: z.ZodString;
10860
+ trigger_source: z.ZodEnum<["user", "auto_invoke", "ai_self_trigger", "chained"]>;
10861
+ signal: z.ZodString;
10862
+ invoked: z.ZodBoolean;
10863
+ kind: z.ZodLiteral<"fabric-event">;
10864
+ id: z.ZodString;
10865
+ ts: z.ZodNumber;
10866
+ schema_version: z.ZodLiteral<1>;
10867
+ correlation_id: z.ZodOptional<z.ZodString>;
10868
+ session_id: z.ZodOptional<z.ZodString>;
10869
+ }, "strip", z.ZodTypeAny, {
10870
+ id: string;
10871
+ ts: number;
10872
+ schema_version: 1;
10873
+ kind: "fabric-event";
10874
+ event_type: "skill_trigger_candidate";
10875
+ skill_name: string;
10876
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10877
+ signal: string;
10878
+ invoked: boolean;
10879
+ correlation_id?: string | undefined;
10880
+ session_id?: string | undefined;
10881
+ }, {
10882
+ id: string;
10883
+ ts: number;
10884
+ schema_version: 1;
10885
+ kind: "fabric-event";
10886
+ event_type: "skill_trigger_candidate";
10887
+ skill_name: string;
10888
+ trigger_source: "user" | "auto_invoke" | "ai_self_trigger" | "chained";
10889
+ signal: string;
10890
+ invoked: boolean;
10891
+ correlation_id?: string | undefined;
10892
+ session_id?: string | undefined;
10893
+ }>, z.ZodObject<{
10894
+ event_type: z.ZodLiteral<"llm_judge_run">;
10895
+ prompt: z.ZodString;
10896
+ version: z.ZodString;
10897
+ model: z.ZodString;
10898
+ input_trace_id: z.ZodString;
10899
+ score: z.ZodNumber;
10900
+ rationale: z.ZodString;
10901
+ kind: z.ZodLiteral<"fabric-event">;
10902
+ id: z.ZodString;
10903
+ ts: z.ZodNumber;
10904
+ schema_version: z.ZodLiteral<1>;
10905
+ correlation_id: z.ZodOptional<z.ZodString>;
10906
+ session_id: z.ZodOptional<z.ZodString>;
10907
+ }, "strip", z.ZodTypeAny, {
10908
+ id: string;
10909
+ version: string;
10910
+ ts: number;
10911
+ model: string;
10912
+ schema_version: 1;
10913
+ kind: "fabric-event";
10914
+ rationale: string;
10915
+ event_type: "llm_judge_run";
10916
+ prompt: string;
10917
+ input_trace_id: string;
10918
+ score: number;
10919
+ correlation_id?: string | undefined;
10920
+ session_id?: string | undefined;
10921
+ }, {
10922
+ id: string;
10923
+ version: string;
10924
+ ts: number;
10925
+ model: string;
10926
+ schema_version: 1;
10927
+ kind: "fabric-event";
10928
+ rationale: string;
10929
+ event_type: "llm_judge_run";
10930
+ prompt: string;
10931
+ input_trace_id: string;
10932
+ score: number;
10933
+ correlation_id?: string | undefined;
10934
+ session_id?: string | undefined;
10935
+ }>, z.ZodObject<{
10936
+ event_type: z.ZodLiteral<"client_capability_snapshot">;
10937
+ client: z.ZodEnum<["cc", "codex", "cursor"]>;
10938
+ capabilities: z.ZodArray<z.ZodString, "many">;
10939
+ version: z.ZodString;
10940
+ kind: z.ZodLiteral<"fabric-event">;
10941
+ id: z.ZodString;
10942
+ ts: z.ZodNumber;
10943
+ schema_version: z.ZodLiteral<1>;
10944
+ correlation_id: z.ZodOptional<z.ZodString>;
10945
+ session_id: z.ZodOptional<z.ZodString>;
10946
+ }, "strip", z.ZodTypeAny, {
10947
+ id: string;
10948
+ version: string;
10949
+ ts: number;
10950
+ schema_version: 1;
10951
+ capabilities: string[];
10952
+ kind: "fabric-event";
10953
+ event_type: "client_capability_snapshot";
10954
+ client: "cursor" | "cc" | "codex";
10955
+ correlation_id?: string | undefined;
10956
+ session_id?: string | undefined;
10957
+ }, {
10958
+ id: string;
10959
+ version: string;
10960
+ ts: number;
10961
+ schema_version: 1;
10962
+ capabilities: string[];
10963
+ kind: "fabric-event";
10964
+ event_type: "client_capability_snapshot";
10965
+ client: "cursor" | "cc" | "codex";
10966
+ correlation_id?: string | undefined;
10967
+ session_id?: string | undefined;
8169
10968
  }>]>;
8170
10969
  type KnowledgeContextPlannedEvent = z.infer<typeof knowledgeContextPlannedEventSchema>;
8171
10970
  type KnowledgeSelectionEvent = z.infer<typeof knowledgeSelectionEventSchema>;
@@ -8211,12 +11010,22 @@ type EventsRotatedEvent = z.infer<typeof eventsRotatedEventSchema>;
8211
11010
  type ServeLockClearedEvent = z.infer<typeof serveLockClearedEventSchema>;
8212
11011
  type KnowledgeEnrichedEvent = z.infer<typeof knowledgeEnrichedEventSchema>;
8213
11012
  type SessionArchiveAttemptedEvent = z.infer<typeof sessionArchiveAttemptedEventSchema>;
8214
- type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | InstallDiffAppliedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeIdRedirectEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeUnarchivedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent | CiteContractPolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent | ServeLockClearedEvent | KnowledgeEnrichedEvent | SessionArchiveAttemptedEvent;
11013
+ type HookSurfaceEmittedEvent = z.infer<typeof hookSurfaceEmittedEventSchema>;
11014
+ type HookSignalEmittedEvent = z.infer<typeof hookSignalEmittedEventSchema>;
11015
+ type McpStdioTraceEvent = z.infer<typeof mcpStdioTraceEventSchema>;
11016
+ type PayloadGuardObservedEvent = z.infer<typeof payloadGuardObservedEventSchema>;
11017
+ type SkillInvocationStartedEvent = z.infer<typeof skillInvocationStartedEventSchema>;
11018
+ type SkillInvocationCompletedEvent = z.infer<typeof skillInvocationCompletedEventSchema>;
11019
+ type SkillPhaseTransitionEvent = z.infer<typeof skillPhaseTransitionEventSchema>;
11020
+ type SkillTriggerCandidateEvent = z.infer<typeof skillTriggerCandidateEventSchema>;
11021
+ type LlmJudgeRunEvent = z.infer<typeof llmJudgeRunEventSchema>;
11022
+ type ClientCapabilitySnapshotEvent = z.infer<typeof clientCapabilitySnapshotEventSchema>;
11023
+ type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | InstallDiffAppliedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeIdRedirectEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeUnarchivedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent | CiteContractPolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent | ServeLockClearedEvent | KnowledgeEnrichedEvent | SessionArchiveAttemptedEvent | HookSurfaceEmittedEvent | HookSignalEmittedEvent | McpStdioTraceEvent | PayloadGuardObservedEvent | SkillInvocationStartedEvent | SkillInvocationCompletedEvent | SkillPhaseTransitionEvent | SkillTriggerCandidateEvent | LlmJudgeRunEvent | ClientCapabilitySnapshotEvent;
8215
11024
  type EventLedgerEventType = EventLedgerEvent["event_type"];
8216
11025
  type EventLedgerEventInputFor<T extends EventLedgerEvent> = T extends EventLedgerEvent ? Omit<T, "kind" | "id" | "ts" | "schema_version" | "correlation_id" | "session_id"> & Partial<Pick<T, "id" | "ts" | "correlation_id" | "session_id">> : never;
8217
11026
  type EventLedgerEventInput = EventLedgerEventInputFor<EventLedgerEvent>;
8218
11027
 
8219
- type CiteTag = "planned" | "recalled" | "chained-from" | "dismissed" | "none";
11028
+ type CiteTag = "applied" | "dismissed" | "none";
8220
11029
  type CiteCommitmentOperatorKind = "edit" | "not_edit" | "require" | "forbid";
8221
11030
  interface CiteCommitmentOperator {
8222
11031
  kind: CiteCommitmentOperatorKind;
@@ -8230,7 +11039,14 @@ interface ParseCiteLineResult {
8230
11039
  cite_ids: string[];
8231
11040
  cite_tags: CiteTag[];
8232
11041
  cite_commitments: CiteCommitment[];
11042
+ cite_stores: (string | null)[];
8233
11043
  }
11044
+ /**
11045
+ * Normalize a raw cite tag (with optional tail) into the 2-state vocabulary.
11046
+ * `applied` / `dismissed` / `none` pass through; the three legacy tags remap to
11047
+ * `applied`; anything else degrades to `none` (forward/back-compat tolerance).
11048
+ */
11049
+ declare function normalizeCiteTag(rawTag: string): CiteTag;
8234
11050
  /**
8235
11051
  * Parse one or more newline-separated `KB:` cite lines into structured
8236
11052
  * arrays matching the assistant_turn_observed event-ledger fields.
@@ -8246,4 +11062,44 @@ interface ParseCiteLineResult {
8246
11062
  */
8247
11063
  declare function parseCiteLine(raw: string): ParseCiteLineResult;
8248
11064
 
8249
- export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, type FabricConfigSchemaShape, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, type InstallDiffAppliedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeIdRedirectEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, type KnowledgeUnarchivedEvent, Layer, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type McpConfigMigratedEvent, type McpEventLedgerEvent, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, type PanelFieldGroup, type PanelFieldMeta, type ParseCiteLineResult, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, installDiffAppliedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeIdRedirectEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, knowledgeUnarchivedEventSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, onboardSlotSchema, parseCiteLine, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, withDerivedAgentsMetaNodeDefaults };
11065
+ /**
11066
+ * Tokenize bilingual text into BM25 terms.
11067
+ *
11068
+ * Latin/digit runs become lower-cased word tokens; CJK runs become overlapping
11069
+ * character bigrams (singleton for length-1 runs). Returns terms in document
11070
+ * order, including duplicates — callers that need term frequencies count them,
11071
+ * callers that need a vocabulary dedupe.
11072
+ */
11073
+ declare function tokenize(text: string): string[];
11074
+
11075
+ type RetrievalBudgetProfile = "conservative" | "balanced" | "generous";
11076
+ interface ResolvedRetrievalBudget {
11077
+ /** MCP layer — max candidates returned by fab_plan_context (count). */
11078
+ topK: number;
11079
+ /** MCP layer — payload soft-warn threshold (bytes). */
11080
+ payloadWarnBytes: number;
11081
+ /** MCP layer — payload hard trim ceiling (bytes). */
11082
+ payloadHardBytes: number;
11083
+ /** Injection layer — SessionStart broad-menu body char budget. */
11084
+ injectionChars: number;
11085
+ }
11086
+ declare const DEFAULT_RETRIEVAL_BUDGET_PROFILE: RetrievalBudgetProfile;
11087
+ /** The per-field overrides that, when present, take precedence over the profile. */
11088
+ interface RetrievalBudgetOverrides {
11089
+ profile?: RetrievalBudgetProfile;
11090
+ topK?: number;
11091
+ payloadWarnBytes?: number;
11092
+ payloadHardBytes?: number;
11093
+ injectionChars?: number;
11094
+ }
11095
+ /**
11096
+ * Resolve the layered retrieval budget: start from the named profile (default
11097
+ * `balanced`), then let any explicitly-supplied per-field override win. Each
11098
+ * field is resolved independently, so an operator can pin a single knob (e.g.
11099
+ * payloadHardBytes) while the rest follow the chosen profile.
11100
+ */
11101
+ declare function resolveRetrievalBudget(overrides?: RetrievalBudgetOverrides): ResolvedRetrievalBudget;
11102
+ /** Exposed for tests / introspection — the raw profile table. */
11103
+ declare function retrievalBudgetProfile(profile: RetrievalBudgetProfile): ResolvedRetrievalBudget;
11104
+
11105
+ export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type ClientCapabilitySnapshotEvent, type CodexSkillPathMigratedEvent, type CrossStoreLintInput, type CrossStoreRefViolation, DEFAULT_RETRIEVAL_BUDGET_PROFILE, type DebugBundle, type DebugBundleInput, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EntryLayer, type EntryScopeMetadata, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, type FabricConfigSchemaShape, type FabricEvent, type FailureStage, type FailureTrace, type FindStoreExecutableViolationsOptions, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, GLOBAL_BINDINGS_DIR, GLOBAL_REF_PATTERN, GLOBAL_STATE_DIR, type GlobalConfig, type GlobalRef, type HookSignalEmittedEvent, type HookSurfaceEmittedEvent, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, type InitStoreOptions, type InstallDiffAppliedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, KNOWN_SCOPE_PREFIXES, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeIdRedirectEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeProvenance, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, type KnowledgeUnarchivedEvent, Layer, type LedgerAppendedEvent, LedgerEntry, type LlmJudgeRunEvent, type LocalKnowledgeId, type LockApprovedEvent, type LockDriftEvent, MCP_STORE_AWARE_CONTRACTS, MCP_STORE_AWARE_TOOLS, type McpConfigMigratedEvent, type McpEventLedgerEvent, type McpStdioTraceEvent, type McpStoreAwareContract, type McpStoreAwareTool, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, type MountedStore, type MountedStoreDir, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, PARITY_CLIENTS, PARITY_SURFACES, PERSONAL_SCOPE, PERSONAL_STORE_SENTINEL, PROJECT_ROOT_SIGNALS, type PanelFieldGroup, type PanelFieldMeta, type ParityCapability, type ParityClient, type ParityClientExpectation, type ParityMatrix, type ParitySurface, type ParseCiteLineResult, type ParsedGlobalRef, type PayloadGuardObservedEvent, type PendingAutoArchivedEvent, type ProjectRootGoldenCase, type ProjectRootResolution, type ProjectRootResolver, type ProjectRootSignal, type ProjectRootSignals, type QualifiedCandidate, type QualifiedIdResolution, REDACTION_PLACEHOLDER_PREFIX, type ReadSetEntry, type ReadSetGoldenCase, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type RequiredStoreEntry, type ResolutionCandidate, type ResolutionResult, type ResolutionWarning, type ResolveOptions, type ResolvedBindingsSnapshot, type ResolvedEntry, type ResolvedRetrievalBudget, ResolverNotImplementedError, type RetrievalBudgetOverrides, type RetrievalBudgetProfile, SCOPE_COORDINATE_PATTERN, STORES_ROOT_DIR, STORE_GITIGNORE, STORE_KNOWLEDGE_TYPE_DIRS, STORE_LAYOUT, STORE_PENDING_DIR, STORE_RESOLVER_WARNING_CODES, STORE_UUID_PATTERN, type ScanRecommendationInput, type ScopeCoordinate, type SecretFinding, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, type SkillInvocationCompletedEvent, type SkillInvocationStartedEvent, type SkillPhaseTransitionEvent, type SkillTriggerCandidateEvent, StableId, type StoreAwareEntry, type StoreCounters, type StoreExplain, type StoreIdentity, type StoreKnowledgeRef, type StoreLayout, type StoreReadSet, type StoreResolveInput, type StoreResolver, type StoreResolverWarning, type StoreResolverWarningCode, type StoreVisibility, Translator, UID_SEGMENT_PATTERN, type Uid, type ValidateResult, type WriteBindingsSnapshotOptions, type WriteTarget, type WrittenToStore, addMountedStore, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aggregatePendingAcrossStores, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, bindRequiredStore, bindingsSnapshotPath, bootstrapMarkerMigratedEventSchema, buildDebugBundle, buildFailureTrace, buildScanRecommendations, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientCapabilitySnapshotEventSchema, codexSkillPathMigratedEventSchema, createProjectRootResolver, createStoreResolver, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, detachMountedStore, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, entryScopeMetadataSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, explainStore, fabricConfigSchema, fabricEventSchema, findMountedStore, findStoreExecutableViolations, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, formatGlobalRef, getPanelFieldByKey, getPanelFields, globalConfigSchema, globalRefSchema, hasSecrets, hookSignalEmittedEventSchema, hookSurfaceEmittedEventSchema, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, initStore, installDiffAppliedEventSchema, isKnowledgeStableId, isPersonalLeakIntoSharedStore, isPersonalScope, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeIdRedirectEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeProvenanceSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, knowledgeUnarchivedEventSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lintCrossStoreReferences, listStoreKnowledge, llmJudgeRunEventSchema, localKnowledgeIdSchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpStdioTraceEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, mountedStoreSchema, normalizeCiteTag, onboardSlotSchema, parityCapabilitySchema, parityClientExpectationSchema, parityClientSchema, parityMatrixSchema, paritySurfaceSchema, parseCiteLine, parseGlobalRef, payloadGuardObservedEventSchema, pendingAutoArchivedEventSchema, projectRootGoldenCaseSchema, projectRootGoldenFileSchema, projectRootResolutionSchema, projectRootSignalSchema, projectRootSignalsSchema, readBindingsSnapshot, readKnowledgeAcrossStores, readSetEntrySchema, readSetGoldenCaseSchema, readSetGoldenFileSchema, readStoreIdentity, reapplyCompletedEventSchema, recognizeStoreDir, redactSecrets, relevanceMigrationRunEventSchema, requiredStoreEntrySchema, resolveCandidates, resolveRetrievalBudget, resolveStoreQualifiedId, resolvedBindingsSnapshotSchema, retrievalBudgetProfile, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, scanForSecrets, scopeCoordinateSchema, scopeRoot, scrubRemoteUrl, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, skillInvocationCompletedEventSchema, skillInvocationStartedEventSchema, skillPhaseTransitionEventSchema, skillTriggerCandidateEventSchema, storeAwareEntrySchema, storeCountersSchema, storeIdentitySchema, storeKnowledgeTypeDir, storeReadSetSchema, storeRelativePath, storeResolveInputSchema, storeResolverWarningCodeSchema, storeResolverWarningSchema, storeUuidSchema, tokenize, uidSchema, withDerivedAgentsMetaNodeDefaults, writeBindingsSnapshot, writeTargetSchema, writtenToStoreSchema };