@fenglimg/fabric-shared 2.0.1 → 2.1.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/dist/{chunk-LTDB2UDN.js → chunk-MDWTGOAY.js} +1 -0
  2. package/dist/{chunk-7CX32MYL.js → chunk-R2J7DAED.js} +2 -2
  3. package/dist/i18n/index.js +1 -1
  4. package/dist/{index-UBqD9F0b.d.ts → index-GQpaWTm-.d.ts} +24 -0
  5. package/dist/index.d.ts +2141 -199
  6. package/dist/index.js +1591 -557
  7. package/dist/schemas/api-contracts.d.ts +34 -34
  8. package/dist/templates/bootstrap-canonical.d.ts +1 -1
  9. package/dist/templates/bootstrap-canonical.js +1 -1
  10. package/dist/types/index.d.ts +1 -1
  11. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
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';
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-GQpaWTm-.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-GQpaWTm-.js';
3
3
  export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
4
4
  import { z } from 'zod';
5
5
  import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';
@@ -42,13 +42,13 @@ declare const ruleDescriptionSchema: z.ZodObject<{
42
42
  tech_stack: string[];
43
43
  impact: string[];
44
44
  must_read_if: string;
45
- entities?: string[] | undefined;
45
+ created_at?: string | undefined;
46
46
  id?: string | undefined;
47
+ entities?: string[] | undefined;
47
48
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
48
49
  maturity?: "draft" | "verified" | "proven" | undefined;
49
50
  knowledge_layer?: "personal" | "team" | undefined;
50
51
  layer_reason?: string | undefined;
51
- created_at?: string | undefined;
52
52
  tags?: string[] | undefined;
53
53
  }, {
54
54
  summary: string;
@@ -56,15 +56,15 @@ declare const ruleDescriptionSchema: z.ZodObject<{
56
56
  tech_stack: string[];
57
57
  impact: string[];
58
58
  must_read_if: string;
59
+ created_at?: string | undefined;
60
+ id?: string | undefined;
59
61
  relevance_scope?: "narrow" | "broad" | undefined;
60
62
  relevance_paths?: string[] | undefined;
61
63
  entities?: string[] | undefined;
62
- id?: string | undefined;
63
64
  knowledge_type?: unknown;
64
65
  maturity?: "draft" | "verified" | "proven" | undefined;
65
66
  knowledge_layer?: "personal" | "team" | undefined;
66
67
  layer_reason?: string | undefined;
67
- created_at?: string | undefined;
68
68
  tags?: string[] | undefined;
69
69
  }>;
70
70
  declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
@@ -96,13 +96,13 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
96
96
  tech_stack: string[];
97
97
  impact: string[];
98
98
  must_read_if: string;
99
- entities?: string[] | undefined;
99
+ created_at?: string | undefined;
100
100
  id?: string | undefined;
101
+ entities?: string[] | undefined;
101
102
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
102
103
  maturity?: "draft" | "verified" | "proven" | undefined;
103
104
  knowledge_layer?: "personal" | "team" | undefined;
104
105
  layer_reason?: string | undefined;
105
- created_at?: string | undefined;
106
106
  tags?: string[] | undefined;
107
107
  }, {
108
108
  summary: string;
@@ -110,15 +110,15 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
110
110
  tech_stack: string[];
111
111
  impact: string[];
112
112
  must_read_if: string;
113
+ created_at?: string | undefined;
114
+ id?: string | undefined;
113
115
  relevance_scope?: "narrow" | "broad" | undefined;
114
116
  relevance_paths?: string[] | undefined;
115
117
  entities?: string[] | undefined;
116
- id?: string | undefined;
117
118
  knowledge_type?: unknown;
118
119
  maturity?: "draft" | "verified" | "proven" | undefined;
119
120
  knowledge_layer?: "personal" | "team" | undefined;
120
121
  layer_reason?: string | undefined;
121
- created_at?: string | undefined;
122
122
  tags?: string[] | undefined;
123
123
  }>;
124
124
  }, "strict", z.ZodTypeAny, {
@@ -130,13 +130,13 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
130
130
  tech_stack: string[];
131
131
  impact: string[];
132
132
  must_read_if: string;
133
- entities?: string[] | undefined;
133
+ created_at?: string | undefined;
134
134
  id?: string | undefined;
135
+ entities?: string[] | undefined;
135
136
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
136
137
  maturity?: "draft" | "verified" | "proven" | undefined;
137
138
  knowledge_layer?: "personal" | "team" | undefined;
138
139
  layer_reason?: string | undefined;
139
- created_at?: string | undefined;
140
140
  tags?: string[] | undefined;
141
141
  };
142
142
  stable_id: string;
@@ -150,15 +150,15 @@ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
150
150
  tech_stack: string[];
151
151
  impact: string[];
152
152
  must_read_if: string;
153
+ created_at?: string | undefined;
154
+ id?: string | undefined;
153
155
  relevance_scope?: "narrow" | "broad" | undefined;
154
156
  relevance_paths?: string[] | undefined;
155
157
  entities?: string[] | undefined;
156
- id?: string | undefined;
157
158
  knowledge_type?: unknown;
158
159
  maturity?: "draft" | "verified" | "proven" | undefined;
159
160
  knowledge_layer?: "personal" | "team" | undefined;
160
161
  layer_reason?: string | undefined;
161
- created_at?: string | undefined;
162
162
  tags?: string[] | undefined;
163
163
  };
164
164
  stable_id: string;
@@ -207,13 +207,13 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
207
207
  tech_stack: string[];
208
208
  impact: string[];
209
209
  must_read_if: string;
210
- entities?: string[] | undefined;
210
+ created_at?: string | undefined;
211
211
  id?: string | undefined;
212
+ entities?: string[] | undefined;
212
213
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
213
214
  maturity?: "draft" | "verified" | "proven" | undefined;
214
215
  knowledge_layer?: "personal" | "team" | undefined;
215
216
  layer_reason?: string | undefined;
216
- created_at?: string | undefined;
217
217
  tags?: string[] | undefined;
218
218
  }, {
219
219
  summary: string;
@@ -221,15 +221,15 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
221
221
  tech_stack: string[];
222
222
  impact: string[];
223
223
  must_read_if: string;
224
+ created_at?: string | undefined;
225
+ id?: string | undefined;
224
226
  relevance_scope?: "narrow" | "broad" | undefined;
225
227
  relevance_paths?: string[] | undefined;
226
228
  entities?: string[] | undefined;
227
- id?: string | undefined;
228
229
  knowledge_type?: unknown;
229
230
  maturity?: "draft" | "verified" | "proven" | undefined;
230
231
  knowledge_layer?: "personal" | "team" | undefined;
231
232
  layer_reason?: string | undefined;
232
- created_at?: string | undefined;
233
233
  tags?: string[] | undefined;
234
234
  }>>;
235
235
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -274,13 +274,13 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
274
274
  tech_stack: string[];
275
275
  impact: string[];
276
276
  must_read_if: string;
277
- entities?: string[] | undefined;
277
+ created_at?: string | undefined;
278
278
  id?: string | undefined;
279
+ entities?: string[] | undefined;
279
280
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
280
281
  maturity?: "draft" | "verified" | "proven" | undefined;
281
282
  knowledge_layer?: "personal" | "team" | undefined;
282
283
  layer_reason?: string | undefined;
283
- created_at?: string | undefined;
284
284
  tags?: string[] | undefined;
285
285
  }, {
286
286
  summary: string;
@@ -288,15 +288,15 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
288
288
  tech_stack: string[];
289
289
  impact: string[];
290
290
  must_read_if: string;
291
+ created_at?: string | undefined;
292
+ id?: string | undefined;
291
293
  relevance_scope?: "narrow" | "broad" | undefined;
292
294
  relevance_paths?: string[] | undefined;
293
295
  entities?: string[] | undefined;
294
- id?: string | undefined;
295
296
  knowledge_type?: unknown;
296
297
  maturity?: "draft" | "verified" | "proven" | undefined;
297
298
  knowledge_layer?: "personal" | "team" | undefined;
298
299
  layer_reason?: string | undefined;
299
- created_at?: string | undefined;
300
300
  tags?: string[] | undefined;
301
301
  }>>;
302
302
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -341,13 +341,13 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
341
341
  tech_stack: string[];
342
342
  impact: string[];
343
343
  must_read_if: string;
344
- entities?: string[] | undefined;
344
+ created_at?: string | undefined;
345
345
  id?: string | undefined;
346
+ entities?: string[] | undefined;
346
347
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
347
348
  maturity?: "draft" | "verified" | "proven" | undefined;
348
349
  knowledge_layer?: "personal" | "team" | undefined;
349
350
  layer_reason?: string | undefined;
350
- created_at?: string | undefined;
351
351
  tags?: string[] | undefined;
352
352
  }, {
353
353
  summary: string;
@@ -355,15 +355,15 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
355
355
  tech_stack: string[];
356
356
  impact: string[];
357
357
  must_read_if: string;
358
+ created_at?: string | undefined;
359
+ id?: string | undefined;
358
360
  relevance_scope?: "narrow" | "broad" | undefined;
359
361
  relevance_paths?: string[] | undefined;
360
362
  entities?: string[] | undefined;
361
- id?: string | undefined;
362
363
  knowledge_type?: unknown;
363
364
  maturity?: "draft" | "verified" | "proven" | undefined;
364
365
  knowledge_layer?: "personal" | "team" | undefined;
365
366
  layer_reason?: string | undefined;
366
- created_at?: string | undefined;
367
367
  tags?: string[] | undefined;
368
368
  }>>;
369
369
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -408,13 +408,13 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
408
408
  tech_stack: string[];
409
409
  impact: string[];
410
410
  must_read_if: string;
411
- entities?: string[] | undefined;
411
+ created_at?: string | undefined;
412
412
  id?: string | undefined;
413
+ entities?: string[] | undefined;
413
414
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
414
415
  maturity?: "draft" | "verified" | "proven" | undefined;
415
416
  knowledge_layer?: "personal" | "team" | undefined;
416
417
  layer_reason?: string | undefined;
417
- created_at?: string | undefined;
418
418
  tags?: string[] | undefined;
419
419
  }, {
420
420
  summary: string;
@@ -422,15 +422,15 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
422
422
  tech_stack: string[];
423
423
  impact: string[];
424
424
  must_read_if: string;
425
+ created_at?: string | undefined;
426
+ id?: string | undefined;
425
427
  relevance_scope?: "narrow" | "broad" | undefined;
426
428
  relevance_paths?: string[] | undefined;
427
429
  entities?: string[] | undefined;
428
- id?: string | undefined;
429
430
  knowledge_type?: unknown;
430
431
  maturity?: "draft" | "verified" | "proven" | undefined;
431
432
  knowledge_layer?: "personal" | "team" | undefined;
432
433
  layer_reason?: string | undefined;
433
- created_at?: string | undefined;
434
434
  tags?: string[] | undefined;
435
435
  }>>;
436
436
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -549,13 +549,13 @@ declare const agentsMetaSchema: z.ZodObject<{
549
549
  tech_stack: string[];
550
550
  impact: string[];
551
551
  must_read_if: string;
552
- entities?: string[] | undefined;
552
+ created_at?: string | undefined;
553
553
  id?: string | undefined;
554
+ entities?: string[] | undefined;
554
555
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
555
556
  maturity?: "draft" | "verified" | "proven" | undefined;
556
557
  knowledge_layer?: "personal" | "team" | undefined;
557
558
  layer_reason?: string | undefined;
558
- created_at?: string | undefined;
559
559
  tags?: string[] | undefined;
560
560
  }, {
561
561
  summary: string;
@@ -563,15 +563,15 @@ declare const agentsMetaSchema: z.ZodObject<{
563
563
  tech_stack: string[];
564
564
  impact: string[];
565
565
  must_read_if: string;
566
+ created_at?: string | undefined;
567
+ id?: string | undefined;
566
568
  relevance_scope?: "narrow" | "broad" | undefined;
567
569
  relevance_paths?: string[] | undefined;
568
570
  entities?: string[] | undefined;
569
- id?: string | undefined;
570
571
  knowledge_type?: unknown;
571
572
  maturity?: "draft" | "verified" | "proven" | undefined;
572
573
  knowledge_layer?: "personal" | "team" | undefined;
573
574
  layer_reason?: string | undefined;
574
- created_at?: string | undefined;
575
575
  tags?: string[] | undefined;
576
576
  }>>;
577
577
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -616,13 +616,13 @@ declare const agentsMetaSchema: z.ZodObject<{
616
616
  tech_stack: string[];
617
617
  impact: string[];
618
618
  must_read_if: string;
619
- entities?: string[] | undefined;
619
+ created_at?: string | undefined;
620
620
  id?: string | undefined;
621
+ entities?: string[] | undefined;
621
622
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
622
623
  maturity?: "draft" | "verified" | "proven" | undefined;
623
624
  knowledge_layer?: "personal" | "team" | undefined;
624
625
  layer_reason?: string | undefined;
625
- created_at?: string | undefined;
626
626
  tags?: string[] | undefined;
627
627
  }, {
628
628
  summary: string;
@@ -630,15 +630,15 @@ declare const agentsMetaSchema: z.ZodObject<{
630
630
  tech_stack: string[];
631
631
  impact: string[];
632
632
  must_read_if: string;
633
+ created_at?: string | undefined;
634
+ id?: string | undefined;
633
635
  relevance_scope?: "narrow" | "broad" | undefined;
634
636
  relevance_paths?: string[] | undefined;
635
637
  entities?: string[] | undefined;
636
- id?: string | undefined;
637
638
  knowledge_type?: unknown;
638
639
  maturity?: "draft" | "verified" | "proven" | undefined;
639
640
  knowledge_layer?: "personal" | "team" | undefined;
640
641
  layer_reason?: string | undefined;
641
- created_at?: string | undefined;
642
642
  tags?: string[] | undefined;
643
643
  }>>;
644
644
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -683,13 +683,13 @@ declare const agentsMetaSchema: z.ZodObject<{
683
683
  tech_stack: string[];
684
684
  impact: string[];
685
685
  must_read_if: string;
686
- entities?: string[] | undefined;
686
+ created_at?: string | undefined;
687
687
  id?: string | undefined;
688
+ entities?: string[] | undefined;
688
689
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
689
690
  maturity?: "draft" | "verified" | "proven" | undefined;
690
691
  knowledge_layer?: "personal" | "team" | undefined;
691
692
  layer_reason?: string | undefined;
692
- created_at?: string | undefined;
693
693
  tags?: string[] | undefined;
694
694
  }, {
695
695
  summary: string;
@@ -697,15 +697,15 @@ declare const agentsMetaSchema: z.ZodObject<{
697
697
  tech_stack: string[];
698
698
  impact: string[];
699
699
  must_read_if: string;
700
+ created_at?: string | undefined;
701
+ id?: string | undefined;
700
702
  relevance_scope?: "narrow" | "broad" | undefined;
701
703
  relevance_paths?: string[] | undefined;
702
704
  entities?: string[] | undefined;
703
- id?: string | undefined;
704
705
  knowledge_type?: unknown;
705
706
  maturity?: "draft" | "verified" | "proven" | undefined;
706
707
  knowledge_layer?: "personal" | "team" | undefined;
707
708
  layer_reason?: string | undefined;
708
- created_at?: string | undefined;
709
709
  tags?: string[] | undefined;
710
710
  }>>;
711
711
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -750,13 +750,13 @@ declare const agentsMetaSchema: z.ZodObject<{
750
750
  tech_stack: string[];
751
751
  impact: string[];
752
752
  must_read_if: string;
753
- entities?: string[] | undefined;
753
+ created_at?: string | undefined;
754
754
  id?: string | undefined;
755
+ entities?: string[] | undefined;
755
756
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
756
757
  maturity?: "draft" | "verified" | "proven" | undefined;
757
758
  knowledge_layer?: "personal" | "team" | undefined;
758
759
  layer_reason?: string | undefined;
759
- created_at?: string | undefined;
760
760
  tags?: string[] | undefined;
761
761
  }, {
762
762
  summary: string;
@@ -764,15 +764,15 @@ declare const agentsMetaSchema: z.ZodObject<{
764
764
  tech_stack: string[];
765
765
  impact: string[];
766
766
  must_read_if: string;
767
+ created_at?: string | undefined;
768
+ id?: string | undefined;
767
769
  relevance_scope?: "narrow" | "broad" | undefined;
768
770
  relevance_paths?: string[] | undefined;
769
771
  entities?: string[] | undefined;
770
- id?: string | undefined;
771
772
  knowledge_type?: unknown;
772
773
  maturity?: "draft" | "verified" | "proven" | undefined;
773
774
  knowledge_layer?: "personal" | "team" | undefined;
774
775
  layer_reason?: string | undefined;
775
- created_at?: string | undefined;
776
776
  tags?: string[] | undefined;
777
777
  }>>;
778
778
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -890,13 +890,13 @@ declare const agentsMetaSchema: z.ZodObject<{
890
890
  tech_stack: string[];
891
891
  impact: string[];
892
892
  must_read_if: string;
893
- entities?: string[] | undefined;
893
+ created_at?: string | undefined;
894
894
  id?: string | undefined;
895
+ entities?: string[] | undefined;
895
896
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
896
897
  maturity?: "draft" | "verified" | "proven" | undefined;
897
898
  knowledge_layer?: "personal" | "team" | undefined;
898
899
  layer_reason?: string | undefined;
899
- created_at?: string | undefined;
900
900
  tags?: string[] | undefined;
901
901
  }, {
902
902
  summary: string;
@@ -904,15 +904,15 @@ declare const agentsMetaSchema: z.ZodObject<{
904
904
  tech_stack: string[];
905
905
  impact: string[];
906
906
  must_read_if: string;
907
+ created_at?: string | undefined;
908
+ id?: string | undefined;
907
909
  relevance_scope?: "narrow" | "broad" | undefined;
908
910
  relevance_paths?: string[] | undefined;
909
911
  entities?: string[] | undefined;
910
- id?: string | undefined;
911
912
  knowledge_type?: unknown;
912
913
  maturity?: "draft" | "verified" | "proven" | undefined;
913
914
  knowledge_layer?: "personal" | "team" | undefined;
914
915
  layer_reason?: string | undefined;
915
- created_at?: string | undefined;
916
916
  tags?: string[] | undefined;
917
917
  }>>;
918
918
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1293,66 +1293,2001 @@ declare const humanLockFileSchema: z.ZodObject<{
1293
1293
  start_line: number;
1294
1294
  end_line: number;
1295
1295
  }, {
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;
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;
1308
+ }, {
1309
+ locked?: {
1310
+ file: string;
1311
+ hash: string;
1312
+ start_line: number;
1313
+ end_line: number;
1314
+ }[] | undefined;
1315
+ }>;
1316
+
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;
1325
+ };
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;
1345
+ }
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;
1356
+
1357
+ declare const STORE_UUID_PATTERN: RegExp;
1358
+ declare const storeUuidSchema: z.ZodString;
1359
+ declare const PERSONAL_STORE_SENTINEL: "$personal";
1360
+ declare const storeIdentitySchema: z.ZodObject<{
1361
+ store_uuid: z.ZodString;
1362
+ created_at: z.ZodString;
1363
+ canonical_alias: z.ZodOptional<z.ZodString>;
1364
+ description: z.ZodOptional<z.ZodString>;
1365
+ allowed_scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1366
+ }, "strict", z.ZodTypeAny, {
1367
+ store_uuid: string;
1368
+ created_at: string;
1369
+ description?: string | undefined;
1370
+ canonical_alias?: string | undefined;
1371
+ allowed_scopes?: string[] | undefined;
1372
+ }, {
1373
+ store_uuid: string;
1374
+ created_at: string;
1375
+ description?: string | undefined;
1376
+ canonical_alias?: string | undefined;
1377
+ allowed_scopes?: string[] | undefined;
1378
+ }>;
1379
+ type StoreIdentity = z.infer<typeof storeIdentitySchema>;
1380
+ declare const requiredStoreEntrySchema: z.ZodObject<{
1381
+ id: z.ZodString;
1382
+ suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
1383
+ }, "strict", z.ZodTypeAny, {
1384
+ id: string;
1385
+ suggested_remote?: string | undefined;
1386
+ }, {
1387
+ id: string;
1388
+ suggested_remote?: string | undefined;
1389
+ }>;
1390
+ type RequiredStoreEntry = z.infer<typeof requiredStoreEntrySchema>;
1391
+ declare const STORE_KNOWLEDGE_TYPE_DIRS: readonly ["models", "decisions", "guidelines", "pitfalls", "processes"];
1392
+ declare const STORE_LAYOUT: {
1393
+ readonly identityFile: "store.json";
1394
+ readonly knowledgeDir: "knowledge";
1395
+ readonly bindingsDir: "bindings";
1396
+ readonly stateDir: "state";
1397
+ };
1398
+ type StoreLayout = typeof STORE_LAYOUT;
1399
+ declare const STORES_ROOT_DIR = "stores";
1400
+ declare const GLOBAL_STATE_DIR = "state";
1401
+ declare const GLOBAL_BINDINGS_DIR = "bindings";
1402
+ declare function storeKnowledgeTypeDir(type: (typeof STORE_KNOWLEDGE_TYPE_DIRS)[number]): string;
1403
+ declare function storeRelativePath(storeUuid: string): string;
1404
+ declare const mountedStoreSchema: z.ZodObject<{
1405
+ store_uuid: z.ZodString;
1406
+ alias: z.ZodString;
1407
+ remote: z.ZodOptional<z.ZodString>;
1408
+ personal: z.ZodOptional<z.ZodBoolean>;
1409
+ writable: z.ZodOptional<z.ZodBoolean>;
1410
+ }, "strict", z.ZodTypeAny, {
1411
+ store_uuid: string;
1412
+ alias: string;
1413
+ personal?: boolean | undefined;
1414
+ remote?: string | undefined;
1415
+ writable?: boolean | undefined;
1416
+ }, {
1417
+ store_uuid: string;
1418
+ alias: string;
1419
+ personal?: boolean | undefined;
1420
+ remote?: string | undefined;
1421
+ writable?: boolean | undefined;
1422
+ }>;
1423
+ type MountedStore = z.infer<typeof mountedStoreSchema>;
1424
+ declare const globalConfigSchema: z.ZodObject<{
1425
+ uid: z.ZodString;
1426
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1427
+ store_uuid: z.ZodString;
1428
+ alias: z.ZodString;
1429
+ remote: z.ZodOptional<z.ZodString>;
1430
+ personal: z.ZodOptional<z.ZodBoolean>;
1431
+ writable: z.ZodOptional<z.ZodBoolean>;
1432
+ }, "strict", z.ZodTypeAny, {
1433
+ store_uuid: string;
1434
+ alias: string;
1435
+ personal?: boolean | undefined;
1436
+ remote?: string | undefined;
1437
+ writable?: boolean | undefined;
1438
+ }, {
1439
+ store_uuid: string;
1440
+ alias: string;
1441
+ personal?: boolean | undefined;
1442
+ remote?: string | undefined;
1443
+ writable?: boolean | undefined;
1444
+ }>, "many">>>;
1445
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
1446
+ uid: z.ZodString;
1447
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1448
+ store_uuid: z.ZodString;
1449
+ alias: z.ZodString;
1450
+ remote: z.ZodOptional<z.ZodString>;
1451
+ personal: z.ZodOptional<z.ZodBoolean>;
1452
+ writable: z.ZodOptional<z.ZodBoolean>;
1453
+ }, "strict", z.ZodTypeAny, {
1454
+ store_uuid: string;
1455
+ alias: string;
1456
+ personal?: boolean | undefined;
1457
+ remote?: string | undefined;
1458
+ writable?: boolean | undefined;
1459
+ }, {
1460
+ store_uuid: string;
1461
+ alias: string;
1462
+ personal?: boolean | undefined;
1463
+ remote?: string | undefined;
1464
+ writable?: boolean | undefined;
1465
+ }>, "many">>>;
1466
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
1467
+ uid: z.ZodString;
1468
+ stores: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
1469
+ store_uuid: z.ZodString;
1470
+ alias: z.ZodString;
1471
+ remote: z.ZodOptional<z.ZodString>;
1472
+ personal: z.ZodOptional<z.ZodBoolean>;
1473
+ writable: z.ZodOptional<z.ZodBoolean>;
1474
+ }, "strict", z.ZodTypeAny, {
1475
+ store_uuid: string;
1476
+ alias: string;
1477
+ personal?: boolean | undefined;
1478
+ remote?: string | undefined;
1479
+ writable?: boolean | undefined;
1480
+ }, {
1481
+ store_uuid: string;
1482
+ alias: string;
1483
+ personal?: boolean | undefined;
1484
+ remote?: string | undefined;
1485
+ writable?: boolean | undefined;
1486
+ }>, "many">>>;
1487
+ }, z.ZodTypeAny, "passthrough">>;
1488
+ type GlobalConfig = z.infer<typeof globalConfigSchema>;
1489
+
1490
+ declare const PERSONAL_SCOPE: "personal";
1491
+ declare const KNOWN_SCOPE_PREFIXES: readonly ["personal", "team", "project", "org"];
1492
+ declare const SCOPE_COORDINATE_PATTERN: RegExp;
1493
+ declare const scopeCoordinateSchema: z.ZodString;
1494
+ type ScopeCoordinate = z.infer<typeof scopeCoordinateSchema>;
1495
+ declare function scopeRoot(coordinate: string): string;
1496
+ declare function isPersonalScope(coordinate: string): boolean;
1497
+ declare const entryScopeMetadataSchema: z.ZodObject<{
1498
+ semantic_scope: z.ZodString;
1499
+ visibility_store: z.ZodString;
1500
+ }, "strict", z.ZodTypeAny, {
1501
+ semantic_scope: string;
1502
+ visibility_store: string;
1503
+ }, {
1504
+ semantic_scope: string;
1505
+ visibility_store: string;
1506
+ }>;
1507
+ type EntryScopeMetadata = z.infer<typeof entryScopeMetadataSchema>;
1508
+
1509
+ declare const localKnowledgeIdSchema: z.ZodString;
1510
+ type LocalKnowledgeId = z.infer<typeof localKnowledgeIdSchema>;
1511
+ declare const UID_SEGMENT_PATTERN: RegExp;
1512
+ declare const uidSchema: z.ZodString;
1513
+ type Uid = z.infer<typeof uidSchema>;
1514
+ declare const GLOBAL_REF_PATTERN: RegExp;
1515
+ declare const globalRefSchema: z.ZodString;
1516
+ type GlobalRef = z.infer<typeof globalRefSchema>;
1517
+ interface ParsedGlobalRef {
1518
+ store_uuid: string;
1519
+ uid?: string;
1520
+ local_id: string;
1521
+ }
1522
+ declare function formatGlobalRef(parts: ParsedGlobalRef): string;
1523
+ declare function parseGlobalRef(ref: string): ParsedGlobalRef | null;
1524
+ declare const storeCountersSchema: z.ZodDefault<z.ZodObject<{
1525
+ KP: z.ZodDefault<z.ZodObject<{
1526
+ MOD: z.ZodDefault<z.ZodNumber>;
1527
+ DEC: z.ZodDefault<z.ZodNumber>;
1528
+ GLD: z.ZodDefault<z.ZodNumber>;
1529
+ PIT: z.ZodDefault<z.ZodNumber>;
1530
+ PRO: z.ZodDefault<z.ZodNumber>;
1531
+ }, "strip", z.ZodTypeAny, {
1532
+ MOD: number;
1533
+ DEC: number;
1534
+ GLD: number;
1535
+ PIT: number;
1536
+ PRO: number;
1537
+ }, {
1538
+ MOD?: number | undefined;
1539
+ DEC?: number | undefined;
1540
+ GLD?: number | undefined;
1541
+ PIT?: number | undefined;
1542
+ PRO?: number | undefined;
1543
+ }>>;
1544
+ KT: z.ZodDefault<z.ZodObject<{
1545
+ MOD: z.ZodDefault<z.ZodNumber>;
1546
+ DEC: z.ZodDefault<z.ZodNumber>;
1547
+ GLD: z.ZodDefault<z.ZodNumber>;
1548
+ PIT: z.ZodDefault<z.ZodNumber>;
1549
+ PRO: z.ZodDefault<z.ZodNumber>;
1550
+ }, "strip", z.ZodTypeAny, {
1551
+ MOD: number;
1552
+ DEC: number;
1553
+ GLD: number;
1554
+ PIT: number;
1555
+ PRO: number;
1556
+ }, {
1557
+ MOD?: number | undefined;
1558
+ DEC?: number | undefined;
1559
+ GLD?: number | undefined;
1560
+ PIT?: number | undefined;
1561
+ PRO?: number | undefined;
1562
+ }>>;
1563
+ }, "strip", z.ZodTypeAny, {
1564
+ KP: {
1565
+ MOD: number;
1566
+ DEC: number;
1567
+ GLD: number;
1568
+ PIT: number;
1569
+ PRO: number;
1570
+ };
1571
+ KT: {
1572
+ MOD: number;
1573
+ DEC: number;
1574
+ GLD: number;
1575
+ PIT: number;
1576
+ PRO: number;
1577
+ };
1578
+ }, {
1579
+ KP?: {
1580
+ MOD?: number | undefined;
1581
+ DEC?: number | undefined;
1582
+ GLD?: number | undefined;
1583
+ PIT?: number | undefined;
1584
+ PRO?: number | undefined;
1585
+ } | undefined;
1586
+ KT?: {
1587
+ MOD?: number | undefined;
1588
+ DEC?: number | undefined;
1589
+ GLD?: number | undefined;
1590
+ PIT?: number | undefined;
1591
+ PRO?: number | undefined;
1592
+ } | undefined;
1593
+ }>>;
1594
+ type StoreCounters = z.infer<typeof storeCountersSchema>;
1595
+
1596
+ declare const PARITY_CLIENTS: readonly ["claudeCode", "codexCLI", "cursor"];
1597
+ declare const parityClientSchema: z.ZodEnum<["claudeCode", "codexCLI", "cursor"]>;
1598
+ type ParityClient = z.infer<typeof parityClientSchema>;
1599
+ declare const PARITY_SURFACES: readonly ["skill", "hook", "mcp", "render"];
1600
+ declare const paritySurfaceSchema: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1601
+ type ParitySurface = z.infer<typeof paritySurfaceSchema>;
1602
+ declare const parityClientExpectationSchema: z.ZodObject<{
1603
+ supported: z.ZodBoolean;
1604
+ mechanism: z.ZodOptional<z.ZodString>;
1605
+ notes: z.ZodOptional<z.ZodString>;
1606
+ }, "strict", z.ZodTypeAny, {
1607
+ supported: boolean;
1608
+ mechanism?: string | undefined;
1609
+ notes?: string | undefined;
1610
+ }, {
1611
+ supported: boolean;
1612
+ mechanism?: string | undefined;
1613
+ notes?: string | undefined;
1614
+ }>;
1615
+ type ParityClientExpectation = z.infer<typeof parityClientExpectationSchema>;
1616
+ declare const parityCapabilitySchema: z.ZodObject<{
1617
+ id: z.ZodString;
1618
+ surface: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1619
+ description: z.ZodString;
1620
+ clients: z.ZodObject<{
1621
+ claudeCode: z.ZodObject<{
1622
+ supported: z.ZodBoolean;
1623
+ mechanism: z.ZodOptional<z.ZodString>;
1624
+ notes: z.ZodOptional<z.ZodString>;
1625
+ }, "strict", z.ZodTypeAny, {
1626
+ supported: boolean;
1627
+ mechanism?: string | undefined;
1628
+ notes?: string | undefined;
1629
+ }, {
1630
+ supported: boolean;
1631
+ mechanism?: string | undefined;
1632
+ notes?: string | undefined;
1633
+ }>;
1634
+ codexCLI: z.ZodObject<{
1635
+ supported: z.ZodBoolean;
1636
+ mechanism: z.ZodOptional<z.ZodString>;
1637
+ notes: z.ZodOptional<z.ZodString>;
1638
+ }, "strict", z.ZodTypeAny, {
1639
+ supported: boolean;
1640
+ mechanism?: string | undefined;
1641
+ notes?: string | undefined;
1642
+ }, {
1643
+ supported: boolean;
1644
+ mechanism?: string | undefined;
1645
+ notes?: string | undefined;
1646
+ }>;
1647
+ cursor: z.ZodObject<{
1648
+ supported: z.ZodBoolean;
1649
+ mechanism: z.ZodOptional<z.ZodString>;
1650
+ notes: z.ZodOptional<z.ZodString>;
1651
+ }, "strict", z.ZodTypeAny, {
1652
+ supported: boolean;
1653
+ mechanism?: string | undefined;
1654
+ notes?: string | undefined;
1655
+ }, {
1656
+ supported: boolean;
1657
+ mechanism?: string | undefined;
1658
+ notes?: string | undefined;
1659
+ }>;
1660
+ }, "strict", z.ZodTypeAny, {
1661
+ cursor: {
1662
+ supported: boolean;
1663
+ mechanism?: string | undefined;
1664
+ notes?: string | undefined;
1665
+ };
1666
+ codexCLI: {
1667
+ supported: boolean;
1668
+ mechanism?: string | undefined;
1669
+ notes?: string | undefined;
1670
+ };
1671
+ claudeCode: {
1672
+ supported: boolean;
1673
+ mechanism?: string | undefined;
1674
+ notes?: string | undefined;
1675
+ };
1676
+ }, {
1677
+ cursor: {
1678
+ supported: boolean;
1679
+ mechanism?: string | undefined;
1680
+ notes?: string | undefined;
1681
+ };
1682
+ codexCLI: {
1683
+ supported: boolean;
1684
+ mechanism?: string | undefined;
1685
+ notes?: string | undefined;
1686
+ };
1687
+ claudeCode: {
1688
+ supported: boolean;
1689
+ mechanism?: string | undefined;
1690
+ notes?: string | undefined;
1691
+ };
1692
+ }>;
1693
+ }, "strict", z.ZodTypeAny, {
1694
+ description: string;
1695
+ id: string;
1696
+ surface: "skill" | "hook" | "mcp" | "render";
1697
+ clients: {
1698
+ cursor: {
1699
+ supported: boolean;
1700
+ mechanism?: string | undefined;
1701
+ notes?: string | undefined;
1702
+ };
1703
+ codexCLI: {
1704
+ supported: boolean;
1705
+ mechanism?: string | undefined;
1706
+ notes?: string | undefined;
1707
+ };
1708
+ claudeCode: {
1709
+ supported: boolean;
1710
+ mechanism?: string | undefined;
1711
+ notes?: string | undefined;
1712
+ };
1713
+ };
1714
+ }, {
1715
+ description: string;
1716
+ id: string;
1717
+ surface: "skill" | "hook" | "mcp" | "render";
1718
+ clients: {
1719
+ cursor: {
1720
+ supported: boolean;
1721
+ mechanism?: string | undefined;
1722
+ notes?: string | undefined;
1723
+ };
1724
+ codexCLI: {
1725
+ supported: boolean;
1726
+ mechanism?: string | undefined;
1727
+ notes?: string | undefined;
1728
+ };
1729
+ claudeCode: {
1730
+ supported: boolean;
1731
+ mechanism?: string | undefined;
1732
+ notes?: string | undefined;
1733
+ };
1734
+ };
1735
+ }>;
1736
+ type ParityCapability = z.infer<typeof parityCapabilitySchema>;
1737
+ declare const parityMatrixSchema: z.ZodObject<{
1738
+ version: z.ZodString;
1739
+ generated_for: z.ZodString;
1740
+ capabilities: z.ZodArray<z.ZodObject<{
1741
+ id: z.ZodString;
1742
+ surface: z.ZodEnum<["skill", "hook", "mcp", "render"]>;
1743
+ description: z.ZodString;
1744
+ clients: z.ZodObject<{
1745
+ claudeCode: z.ZodObject<{
1746
+ supported: z.ZodBoolean;
1747
+ mechanism: z.ZodOptional<z.ZodString>;
1748
+ notes: z.ZodOptional<z.ZodString>;
1749
+ }, "strict", z.ZodTypeAny, {
1750
+ supported: boolean;
1751
+ mechanism?: string | undefined;
1752
+ notes?: string | undefined;
1753
+ }, {
1754
+ supported: boolean;
1755
+ mechanism?: string | undefined;
1756
+ notes?: string | undefined;
1757
+ }>;
1758
+ codexCLI: z.ZodObject<{
1759
+ supported: z.ZodBoolean;
1760
+ mechanism: z.ZodOptional<z.ZodString>;
1761
+ notes: z.ZodOptional<z.ZodString>;
1762
+ }, "strict", z.ZodTypeAny, {
1763
+ supported: boolean;
1764
+ mechanism?: string | undefined;
1765
+ notes?: string | undefined;
1766
+ }, {
1767
+ supported: boolean;
1768
+ mechanism?: string | undefined;
1769
+ notes?: string | undefined;
1770
+ }>;
1771
+ cursor: z.ZodObject<{
1772
+ supported: z.ZodBoolean;
1773
+ mechanism: z.ZodOptional<z.ZodString>;
1774
+ notes: z.ZodOptional<z.ZodString>;
1775
+ }, "strict", z.ZodTypeAny, {
1776
+ supported: boolean;
1777
+ mechanism?: string | undefined;
1778
+ notes?: string | undefined;
1779
+ }, {
1780
+ supported: boolean;
1781
+ mechanism?: string | undefined;
1782
+ notes?: string | undefined;
1783
+ }>;
1784
+ }, "strict", z.ZodTypeAny, {
1785
+ cursor: {
1786
+ supported: boolean;
1787
+ mechanism?: string | undefined;
1788
+ notes?: string | undefined;
1789
+ };
1790
+ codexCLI: {
1791
+ supported: boolean;
1792
+ mechanism?: string | undefined;
1793
+ notes?: string | undefined;
1794
+ };
1795
+ claudeCode: {
1796
+ supported: boolean;
1797
+ mechanism?: string | undefined;
1798
+ notes?: string | undefined;
1799
+ };
1800
+ }, {
1801
+ cursor: {
1802
+ supported: boolean;
1803
+ mechanism?: string | undefined;
1804
+ notes?: string | undefined;
1805
+ };
1806
+ codexCLI: {
1807
+ supported: boolean;
1808
+ mechanism?: string | undefined;
1809
+ notes?: string | undefined;
1810
+ };
1811
+ claudeCode: {
1812
+ supported: boolean;
1813
+ mechanism?: string | undefined;
1814
+ notes?: string | undefined;
1815
+ };
1816
+ }>;
1817
+ }, "strict", z.ZodTypeAny, {
1818
+ description: string;
1819
+ id: string;
1820
+ surface: "skill" | "hook" | "mcp" | "render";
1821
+ clients: {
1822
+ cursor: {
1823
+ supported: boolean;
1824
+ mechanism?: string | undefined;
1825
+ notes?: string | undefined;
1826
+ };
1827
+ codexCLI: {
1828
+ supported: boolean;
1829
+ mechanism?: string | undefined;
1830
+ notes?: string | undefined;
1831
+ };
1832
+ claudeCode: {
1833
+ supported: boolean;
1834
+ mechanism?: string | undefined;
1835
+ notes?: string | undefined;
1836
+ };
1837
+ };
1838
+ }, {
1839
+ description: string;
1840
+ id: string;
1841
+ surface: "skill" | "hook" | "mcp" | "render";
1842
+ clients: {
1843
+ cursor: {
1844
+ supported: boolean;
1845
+ mechanism?: string | undefined;
1846
+ notes?: string | undefined;
1847
+ };
1848
+ codexCLI: {
1849
+ supported: boolean;
1850
+ mechanism?: string | undefined;
1851
+ notes?: string | undefined;
1852
+ };
1853
+ claudeCode: {
1854
+ supported: boolean;
1855
+ mechanism?: string | undefined;
1856
+ notes?: string | undefined;
1857
+ };
1858
+ };
1859
+ }>, "many">;
1860
+ }, "strict", z.ZodTypeAny, {
1861
+ version: string;
1862
+ generated_for: string;
1863
+ capabilities: {
1864
+ description: string;
1865
+ id: string;
1866
+ surface: "skill" | "hook" | "mcp" | "render";
1867
+ clients: {
1868
+ cursor: {
1869
+ supported: boolean;
1870
+ mechanism?: string | undefined;
1871
+ notes?: string | undefined;
1872
+ };
1873
+ codexCLI: {
1874
+ supported: boolean;
1875
+ mechanism?: string | undefined;
1876
+ notes?: string | undefined;
1877
+ };
1878
+ claudeCode: {
1879
+ supported: boolean;
1880
+ mechanism?: string | undefined;
1881
+ notes?: string | undefined;
1882
+ };
1883
+ };
1884
+ }[];
1885
+ }, {
1886
+ version: string;
1887
+ generated_for: string;
1888
+ capabilities: {
1889
+ description: string;
1890
+ id: string;
1891
+ surface: "skill" | "hook" | "mcp" | "render";
1892
+ clients: {
1893
+ cursor: {
1894
+ supported: boolean;
1895
+ mechanism?: string | undefined;
1896
+ notes?: string | undefined;
1897
+ };
1898
+ codexCLI: {
1899
+ supported: boolean;
1900
+ mechanism?: string | undefined;
1901
+ notes?: string | undefined;
1902
+ };
1903
+ claudeCode: {
1904
+ supported: boolean;
1905
+ mechanism?: string | undefined;
1906
+ notes?: string | undefined;
1907
+ };
1908
+ };
1909
+ }[];
1910
+ }>;
1911
+ type ParityMatrix = z.infer<typeof parityMatrixSchema>;
1912
+
1913
+ declare const PROJECT_ROOT_SIGNALS: readonly ["env", "marker", "cwd", "repo"];
1914
+ declare const projectRootSignalSchema: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
1915
+ type ProjectRootSignal = z.infer<typeof projectRootSignalSchema>;
1916
+ declare const projectRootSignalsSchema: z.ZodObject<{
1917
+ env: z.ZodOptional<z.ZodString>;
1918
+ markerDir: z.ZodOptional<z.ZodString>;
1919
+ cwd: z.ZodString;
1920
+ repoRoot: z.ZodOptional<z.ZodString>;
1921
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
1922
+ }, "strict", z.ZodTypeAny, {
1923
+ cwd: string;
1924
+ env?: string | undefined;
1925
+ markerDir?: string | undefined;
1926
+ repoRoot?: string | undefined;
1927
+ discoveredProjectId?: string | undefined;
1928
+ }, {
1929
+ cwd: string;
1930
+ env?: string | undefined;
1931
+ markerDir?: string | undefined;
1932
+ repoRoot?: string | undefined;
1933
+ discoveredProjectId?: string | undefined;
1934
+ }>;
1935
+ type ProjectRootSignals = z.infer<typeof projectRootSignalsSchema>;
1936
+ declare const projectRootResolutionSchema: z.ZodObject<{
1937
+ projectRoot: z.ZodString;
1938
+ projectId: z.ZodNullable<z.ZodString>;
1939
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
1940
+ }, "strict", z.ZodTypeAny, {
1941
+ projectRoot: string;
1942
+ projectId: string | null;
1943
+ signalUsed: "env" | "marker" | "cwd" | "repo";
1944
+ }, {
1945
+ projectRoot: string;
1946
+ projectId: string | null;
1947
+ signalUsed: "env" | "marker" | "cwd" | "repo";
1948
+ }>;
1949
+ type ProjectRootResolution = z.infer<typeof projectRootResolutionSchema>;
1950
+ interface ProjectRootResolver {
1951
+ resolve(signals: ProjectRootSignals): ProjectRootResolution | null;
1952
+ }
1953
+ declare const STORE_RESOLVER_WARNING_CODES: readonly ["missing_store", "local_only_no_remote", "alias_unresolved"];
1954
+ declare const storeResolverWarningCodeSchema: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
1955
+ type StoreResolverWarningCode = z.infer<typeof storeResolverWarningCodeSchema>;
1956
+ declare const storeResolverWarningSchema: z.ZodObject<{
1957
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
1958
+ ref: z.ZodString;
1959
+ message: z.ZodString;
1960
+ }, "strict", z.ZodTypeAny, {
1961
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
1962
+ message: string;
1963
+ ref: string;
1964
+ }, {
1965
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
1966
+ message: string;
1967
+ ref: string;
1968
+ }>;
1969
+ type StoreResolverWarning = z.infer<typeof storeResolverWarningSchema>;
1970
+ declare const readSetEntrySchema: z.ZodObject<{
1971
+ store_uuid: z.ZodString;
1972
+ alias: z.ZodString;
1973
+ remote: z.ZodOptional<z.ZodString>;
1974
+ writable: z.ZodBoolean;
1975
+ }, "strict", z.ZodTypeAny, {
1976
+ store_uuid: string;
1977
+ alias: string;
1978
+ writable: boolean;
1979
+ remote?: string | undefined;
1980
+ }, {
1981
+ store_uuid: string;
1982
+ alias: string;
1983
+ writable: boolean;
1984
+ remote?: string | undefined;
1985
+ }>;
1986
+ type ReadSetEntry = z.infer<typeof readSetEntrySchema>;
1987
+ declare const storeReadSetSchema: z.ZodObject<{
1988
+ stores: z.ZodArray<z.ZodObject<{
1989
+ store_uuid: z.ZodString;
1990
+ alias: z.ZodString;
1991
+ remote: z.ZodOptional<z.ZodString>;
1992
+ writable: z.ZodBoolean;
1993
+ }, "strict", z.ZodTypeAny, {
1994
+ store_uuid: string;
1995
+ alias: string;
1996
+ writable: boolean;
1997
+ remote?: string | undefined;
1998
+ }, {
1999
+ store_uuid: string;
2000
+ alias: string;
2001
+ writable: boolean;
2002
+ remote?: string | undefined;
2003
+ }>, "many">;
2004
+ warnings: z.ZodArray<z.ZodObject<{
2005
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2006
+ ref: z.ZodString;
2007
+ message: z.ZodString;
2008
+ }, "strict", z.ZodTypeAny, {
2009
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2010
+ message: string;
2011
+ ref: string;
2012
+ }, {
2013
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2014
+ message: string;
2015
+ ref: string;
2016
+ }>, "many">;
2017
+ }, "strict", z.ZodTypeAny, {
2018
+ stores: {
2019
+ store_uuid: string;
2020
+ alias: string;
2021
+ writable: boolean;
2022
+ remote?: string | undefined;
2023
+ }[];
2024
+ warnings: {
2025
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2026
+ message: string;
2027
+ ref: string;
2028
+ }[];
2029
+ }, {
2030
+ stores: {
2031
+ store_uuid: string;
2032
+ alias: string;
2033
+ writable: boolean;
2034
+ remote?: string | undefined;
2035
+ }[];
2036
+ warnings: {
2037
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2038
+ message: string;
2039
+ ref: string;
2040
+ }[];
2041
+ }>;
2042
+ type StoreReadSet = z.infer<typeof storeReadSetSchema>;
2043
+ declare const writeTargetSchema: z.ZodObject<{
2044
+ store_uuid: z.ZodString;
2045
+ alias: z.ZodString;
2046
+ }, "strict", z.ZodTypeAny, {
2047
+ store_uuid: string;
2048
+ alias: string;
2049
+ }, {
2050
+ store_uuid: string;
2051
+ alias: string;
2052
+ }>;
2053
+ type WriteTarget = z.infer<typeof writeTargetSchema>;
2054
+ declare const storeResolveInputSchema: z.ZodObject<{
2055
+ uid: z.ZodString;
2056
+ mountedStores: z.ZodArray<z.ZodObject<{
2057
+ store_uuid: z.ZodString;
2058
+ alias: z.ZodString;
2059
+ remote: z.ZodOptional<z.ZodString>;
2060
+ writable: z.ZodDefault<z.ZodBoolean>;
2061
+ personal: z.ZodDefault<z.ZodBoolean>;
2062
+ }, "strict", z.ZodTypeAny, {
2063
+ personal: boolean;
2064
+ store_uuid: string;
2065
+ alias: string;
2066
+ writable: boolean;
2067
+ remote?: string | undefined;
2068
+ }, {
2069
+ store_uuid: string;
2070
+ alias: string;
2071
+ personal?: boolean | undefined;
2072
+ remote?: string | undefined;
2073
+ writable?: boolean | undefined;
2074
+ }>, "many">;
2075
+ requiredStores: z.ZodArray<z.ZodObject<{
2076
+ id: z.ZodString;
2077
+ suggested_remote: z.ZodOptional<z.ZodString>;
2078
+ }, "strict", z.ZodTypeAny, {
2079
+ id: string;
2080
+ suggested_remote?: string | undefined;
2081
+ }, {
2082
+ id: string;
2083
+ suggested_remote?: string | undefined;
2084
+ }>, "many">;
2085
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2086
+ }, "strict", z.ZodTypeAny, {
2087
+ uid: string;
2088
+ mountedStores: {
2089
+ personal: boolean;
2090
+ store_uuid: string;
2091
+ alias: string;
2092
+ writable: boolean;
2093
+ remote?: string | undefined;
2094
+ }[];
2095
+ requiredStores: {
2096
+ id: string;
2097
+ suggested_remote?: string | undefined;
2098
+ }[];
2099
+ activeWriteAlias?: string | undefined;
2100
+ }, {
2101
+ uid: string;
2102
+ mountedStores: {
2103
+ store_uuid: string;
2104
+ alias: string;
2105
+ personal?: boolean | undefined;
2106
+ remote?: string | undefined;
2107
+ writable?: boolean | undefined;
2108
+ }[];
2109
+ requiredStores: {
2110
+ id: string;
2111
+ suggested_remote?: string | undefined;
2112
+ }[];
2113
+ activeWriteAlias?: string | undefined;
2114
+ }>;
2115
+ type StoreResolveInput = z.infer<typeof storeResolveInputSchema>;
2116
+ interface StoreResolver {
2117
+ resolveReadSet(input: StoreResolveInput): StoreReadSet;
2118
+ resolveWriteTarget(input: StoreResolveInput, scope: string): {
2119
+ target: WriteTarget | null;
2120
+ warnings: StoreResolverWarning[];
2121
+ };
2122
+ aliasToUuid(input: StoreResolveInput, alias: string): string | undefined;
2123
+ }
2124
+ declare const projectRootGoldenCaseSchema: z.ZodObject<{
2125
+ name: z.ZodString;
2126
+ note: z.ZodOptional<z.ZodString>;
2127
+ signals: z.ZodObject<{
2128
+ env: z.ZodOptional<z.ZodString>;
2129
+ markerDir: z.ZodOptional<z.ZodString>;
2130
+ cwd: z.ZodString;
2131
+ repoRoot: z.ZodOptional<z.ZodString>;
2132
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
2133
+ }, "strict", z.ZodTypeAny, {
2134
+ cwd: string;
2135
+ env?: string | undefined;
2136
+ markerDir?: string | undefined;
2137
+ repoRoot?: string | undefined;
2138
+ discoveredProjectId?: string | undefined;
2139
+ }, {
2140
+ cwd: string;
2141
+ env?: string | undefined;
2142
+ markerDir?: string | undefined;
2143
+ repoRoot?: string | undefined;
2144
+ discoveredProjectId?: string | undefined;
2145
+ }>;
2146
+ expected: z.ZodNullable<z.ZodObject<{
2147
+ projectRoot: z.ZodString;
2148
+ projectId: z.ZodNullable<z.ZodString>;
2149
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
2150
+ }, "strict", z.ZodTypeAny, {
2151
+ projectRoot: string;
2152
+ projectId: string | null;
2153
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2154
+ }, {
2155
+ projectRoot: string;
2156
+ projectId: string | null;
2157
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2158
+ }>>;
2159
+ }, "strict", z.ZodTypeAny, {
2160
+ expected: {
2161
+ projectRoot: string;
2162
+ projectId: string | null;
2163
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2164
+ } | null;
2165
+ name: string;
2166
+ signals: {
2167
+ cwd: string;
2168
+ env?: string | undefined;
2169
+ markerDir?: string | undefined;
2170
+ repoRoot?: string | undefined;
2171
+ discoveredProjectId?: string | undefined;
2172
+ };
2173
+ note?: string | undefined;
2174
+ }, {
2175
+ expected: {
2176
+ projectRoot: string;
2177
+ projectId: string | null;
2178
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2179
+ } | null;
2180
+ name: string;
2181
+ signals: {
2182
+ cwd: string;
2183
+ env?: string | undefined;
2184
+ markerDir?: string | undefined;
2185
+ repoRoot?: string | undefined;
2186
+ discoveredProjectId?: string | undefined;
2187
+ };
2188
+ note?: string | undefined;
2189
+ }>;
2190
+ type ProjectRootGoldenCase = z.infer<typeof projectRootGoldenCaseSchema>;
2191
+ declare const projectRootGoldenFileSchema: z.ZodObject<{
2192
+ contract: z.ZodLiteral<"project-root.golden">;
2193
+ cases: z.ZodArray<z.ZodObject<{
2194
+ name: z.ZodString;
2195
+ note: z.ZodOptional<z.ZodString>;
2196
+ signals: z.ZodObject<{
2197
+ env: z.ZodOptional<z.ZodString>;
2198
+ markerDir: z.ZodOptional<z.ZodString>;
2199
+ cwd: z.ZodString;
2200
+ repoRoot: z.ZodOptional<z.ZodString>;
2201
+ discoveredProjectId: z.ZodOptional<z.ZodString>;
2202
+ }, "strict", z.ZodTypeAny, {
2203
+ cwd: string;
2204
+ env?: string | undefined;
2205
+ markerDir?: string | undefined;
2206
+ repoRoot?: string | undefined;
2207
+ discoveredProjectId?: string | undefined;
2208
+ }, {
2209
+ cwd: string;
2210
+ env?: string | undefined;
2211
+ markerDir?: string | undefined;
2212
+ repoRoot?: string | undefined;
2213
+ discoveredProjectId?: string | undefined;
2214
+ }>;
2215
+ expected: z.ZodNullable<z.ZodObject<{
2216
+ projectRoot: z.ZodString;
2217
+ projectId: z.ZodNullable<z.ZodString>;
2218
+ signalUsed: z.ZodEnum<["env", "marker", "cwd", "repo"]>;
2219
+ }, "strict", z.ZodTypeAny, {
2220
+ projectRoot: string;
2221
+ projectId: string | null;
2222
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2223
+ }, {
2224
+ projectRoot: string;
2225
+ projectId: string | null;
2226
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2227
+ }>>;
2228
+ }, "strict", z.ZodTypeAny, {
2229
+ expected: {
2230
+ projectRoot: string;
2231
+ projectId: string | null;
2232
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2233
+ } | null;
2234
+ name: string;
2235
+ signals: {
2236
+ cwd: string;
2237
+ env?: string | undefined;
2238
+ markerDir?: string | undefined;
2239
+ repoRoot?: string | undefined;
2240
+ discoveredProjectId?: string | undefined;
2241
+ };
2242
+ note?: string | undefined;
2243
+ }, {
2244
+ expected: {
2245
+ projectRoot: string;
2246
+ projectId: string | null;
2247
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2248
+ } | null;
2249
+ name: string;
2250
+ signals: {
2251
+ cwd: string;
2252
+ env?: string | undefined;
2253
+ markerDir?: string | undefined;
2254
+ repoRoot?: string | undefined;
2255
+ discoveredProjectId?: string | undefined;
2256
+ };
2257
+ note?: string | undefined;
2258
+ }>, "many">;
2259
+ }, "strict", z.ZodTypeAny, {
2260
+ contract: "project-root.golden";
2261
+ cases: {
2262
+ expected: {
2263
+ projectRoot: string;
2264
+ projectId: string | null;
2265
+ signalUsed: "env" | "marker" | "cwd" | "repo";
2266
+ } | null;
2267
+ name: string;
2268
+ signals: {
2269
+ cwd: string;
2270
+ env?: string | undefined;
2271
+ markerDir?: string | undefined;
2272
+ repoRoot?: string | undefined;
2273
+ discoveredProjectId?: string | undefined;
2274
+ };
2275
+ note?: string | undefined;
2276
+ }[];
2277
+ }, {
2278
+ contract: "project-root.golden";
2279
+ cases: {
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
+ }[];
2295
+ }>;
2296
+ declare const readSetGoldenCaseSchema: z.ZodObject<{
2297
+ name: z.ZodString;
2298
+ note: z.ZodOptional<z.ZodString>;
2299
+ input: z.ZodObject<{
2300
+ uid: z.ZodString;
2301
+ mountedStores: z.ZodArray<z.ZodObject<{
2302
+ store_uuid: z.ZodString;
2303
+ alias: z.ZodString;
2304
+ remote: z.ZodOptional<z.ZodString>;
2305
+ writable: z.ZodDefault<z.ZodBoolean>;
2306
+ personal: z.ZodDefault<z.ZodBoolean>;
2307
+ }, "strict", z.ZodTypeAny, {
2308
+ personal: boolean;
2309
+ store_uuid: string;
2310
+ alias: string;
2311
+ writable: boolean;
2312
+ remote?: string | undefined;
2313
+ }, {
2314
+ store_uuid: string;
2315
+ alias: string;
2316
+ personal?: boolean | undefined;
2317
+ remote?: string | undefined;
2318
+ writable?: boolean | undefined;
2319
+ }>, "many">;
2320
+ requiredStores: z.ZodArray<z.ZodObject<{
2321
+ id: z.ZodString;
2322
+ suggested_remote: z.ZodOptional<z.ZodString>;
2323
+ }, "strict", z.ZodTypeAny, {
2324
+ id: string;
2325
+ suggested_remote?: string | undefined;
2326
+ }, {
2327
+ id: string;
2328
+ suggested_remote?: string | undefined;
2329
+ }>, "many">;
2330
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2331
+ }, "strict", z.ZodTypeAny, {
2332
+ uid: string;
2333
+ mountedStores: {
2334
+ personal: boolean;
2335
+ store_uuid: string;
2336
+ alias: string;
2337
+ writable: boolean;
2338
+ remote?: string | undefined;
2339
+ }[];
2340
+ requiredStores: {
2341
+ id: string;
2342
+ suggested_remote?: string | undefined;
2343
+ }[];
2344
+ activeWriteAlias?: string | undefined;
2345
+ }, {
2346
+ uid: string;
2347
+ mountedStores: {
2348
+ store_uuid: string;
2349
+ alias: string;
2350
+ personal?: boolean | undefined;
2351
+ remote?: string | undefined;
2352
+ writable?: boolean | undefined;
2353
+ }[];
2354
+ requiredStores: {
2355
+ id: string;
2356
+ suggested_remote?: string | undefined;
2357
+ }[];
2358
+ activeWriteAlias?: string | undefined;
2359
+ }>;
2360
+ writeScope: z.ZodString;
2361
+ expected: z.ZodObject<{
2362
+ readSet: z.ZodObject<{
2363
+ stores: z.ZodArray<z.ZodObject<{
2364
+ store_uuid: z.ZodString;
2365
+ alias: z.ZodString;
2366
+ remote: z.ZodOptional<z.ZodString>;
2367
+ writable: z.ZodBoolean;
2368
+ }, "strict", z.ZodTypeAny, {
2369
+ store_uuid: string;
2370
+ alias: string;
2371
+ writable: boolean;
2372
+ remote?: string | undefined;
2373
+ }, {
2374
+ store_uuid: string;
2375
+ alias: string;
2376
+ writable: boolean;
2377
+ remote?: string | undefined;
2378
+ }>, "many">;
2379
+ warnings: z.ZodArray<z.ZodObject<{
2380
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2381
+ ref: z.ZodString;
2382
+ message: z.ZodString;
2383
+ }, "strict", z.ZodTypeAny, {
2384
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2385
+ message: string;
2386
+ ref: string;
2387
+ }, {
2388
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2389
+ message: string;
2390
+ ref: string;
2391
+ }>, "many">;
2392
+ }, "strict", z.ZodTypeAny, {
2393
+ stores: {
2394
+ store_uuid: string;
2395
+ alias: string;
2396
+ writable: boolean;
2397
+ remote?: string | undefined;
2398
+ }[];
2399
+ warnings: {
2400
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2401
+ message: string;
2402
+ ref: string;
2403
+ }[];
2404
+ }, {
2405
+ stores: {
2406
+ store_uuid: string;
2407
+ alias: string;
2408
+ writable: boolean;
2409
+ remote?: string | undefined;
2410
+ }[];
2411
+ warnings: {
2412
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2413
+ message: string;
2414
+ ref: string;
2415
+ }[];
2416
+ }>;
2417
+ writeTarget: z.ZodNullable<z.ZodObject<{
2418
+ store_uuid: z.ZodString;
2419
+ alias: z.ZodString;
2420
+ }, "strict", z.ZodTypeAny, {
2421
+ store_uuid: string;
2422
+ alias: string;
2423
+ }, {
2424
+ store_uuid: string;
2425
+ alias: string;
2426
+ }>>;
2427
+ writeWarnings: z.ZodArray<z.ZodObject<{
2428
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2429
+ ref: z.ZodString;
2430
+ message: z.ZodString;
2431
+ }, "strict", z.ZodTypeAny, {
2432
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2433
+ message: string;
2434
+ ref: string;
2435
+ }, {
2436
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2437
+ message: string;
2438
+ ref: string;
2439
+ }>, "many">;
2440
+ }, "strict", z.ZodTypeAny, {
2441
+ readSet: {
2442
+ stores: {
2443
+ store_uuid: string;
2444
+ alias: string;
2445
+ writable: boolean;
2446
+ remote?: string | undefined;
2447
+ }[];
2448
+ warnings: {
2449
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2450
+ message: string;
2451
+ ref: string;
2452
+ }[];
2453
+ };
2454
+ writeTarget: {
2455
+ store_uuid: string;
2456
+ alias: string;
2457
+ } | null;
2458
+ writeWarnings: {
2459
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2460
+ message: string;
2461
+ ref: string;
2462
+ }[];
2463
+ }, {
2464
+ readSet: {
2465
+ stores: {
2466
+ store_uuid: string;
2467
+ alias: string;
2468
+ writable: boolean;
2469
+ remote?: string | undefined;
2470
+ }[];
2471
+ warnings: {
2472
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2473
+ message: string;
2474
+ ref: string;
2475
+ }[];
2476
+ };
2477
+ writeTarget: {
2478
+ store_uuid: string;
2479
+ alias: string;
2480
+ } | null;
2481
+ writeWarnings: {
2482
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2483
+ message: string;
2484
+ ref: string;
2485
+ }[];
2486
+ }>;
2487
+ }, "strict", z.ZodTypeAny, {
2488
+ expected: {
2489
+ readSet: {
2490
+ stores: {
2491
+ store_uuid: string;
2492
+ alias: string;
2493
+ writable: boolean;
2494
+ remote?: string | undefined;
2495
+ }[];
2496
+ warnings: {
2497
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2498
+ message: string;
2499
+ ref: string;
2500
+ }[];
2501
+ };
2502
+ writeTarget: {
2503
+ store_uuid: string;
2504
+ alias: string;
2505
+ } | null;
2506
+ writeWarnings: {
2507
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2508
+ message: string;
2509
+ ref: string;
2510
+ }[];
2511
+ };
2512
+ name: string;
2513
+ input: {
2514
+ uid: string;
2515
+ mountedStores: {
2516
+ personal: boolean;
2517
+ store_uuid: string;
2518
+ alias: string;
2519
+ writable: boolean;
2520
+ remote?: string | undefined;
2521
+ }[];
2522
+ requiredStores: {
2523
+ id: string;
2524
+ suggested_remote?: string | undefined;
2525
+ }[];
2526
+ activeWriteAlias?: string | undefined;
2527
+ };
2528
+ writeScope: string;
2529
+ note?: string | undefined;
2530
+ }, {
2531
+ expected: {
2532
+ readSet: {
2533
+ stores: {
2534
+ store_uuid: string;
2535
+ alias: string;
2536
+ writable: boolean;
2537
+ remote?: string | undefined;
2538
+ }[];
2539
+ warnings: {
2540
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2541
+ message: string;
2542
+ ref: string;
2543
+ }[];
2544
+ };
2545
+ writeTarget: {
2546
+ store_uuid: string;
2547
+ alias: string;
2548
+ } | null;
2549
+ writeWarnings: {
2550
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2551
+ message: string;
2552
+ ref: string;
2553
+ }[];
2554
+ };
2555
+ name: string;
2556
+ input: {
2557
+ uid: string;
2558
+ mountedStores: {
2559
+ store_uuid: string;
2560
+ alias: string;
2561
+ personal?: boolean | undefined;
2562
+ remote?: string | undefined;
2563
+ writable?: boolean | undefined;
2564
+ }[];
2565
+ requiredStores: {
2566
+ id: string;
2567
+ suggested_remote?: string | undefined;
2568
+ }[];
2569
+ activeWriteAlias?: string | undefined;
2570
+ };
2571
+ writeScope: string;
2572
+ note?: string | undefined;
2573
+ }>;
2574
+ type ReadSetGoldenCase = z.infer<typeof readSetGoldenCaseSchema>;
2575
+ declare const readSetGoldenFileSchema: z.ZodObject<{
2576
+ contract: z.ZodLiteral<"read-set.golden">;
2577
+ cases: z.ZodArray<z.ZodObject<{
2578
+ name: z.ZodString;
2579
+ note: z.ZodOptional<z.ZodString>;
2580
+ input: z.ZodObject<{
2581
+ uid: z.ZodString;
2582
+ mountedStores: z.ZodArray<z.ZodObject<{
2583
+ store_uuid: z.ZodString;
2584
+ alias: z.ZodString;
2585
+ remote: z.ZodOptional<z.ZodString>;
2586
+ writable: z.ZodDefault<z.ZodBoolean>;
2587
+ personal: z.ZodDefault<z.ZodBoolean>;
2588
+ }, "strict", z.ZodTypeAny, {
2589
+ personal: boolean;
2590
+ store_uuid: string;
2591
+ alias: string;
2592
+ writable: boolean;
2593
+ remote?: string | undefined;
2594
+ }, {
2595
+ store_uuid: string;
2596
+ alias: string;
2597
+ personal?: boolean | undefined;
2598
+ remote?: string | undefined;
2599
+ writable?: boolean | undefined;
2600
+ }>, "many">;
2601
+ requiredStores: z.ZodArray<z.ZodObject<{
2602
+ id: z.ZodString;
2603
+ suggested_remote: z.ZodOptional<z.ZodString>;
2604
+ }, "strict", z.ZodTypeAny, {
2605
+ id: string;
2606
+ suggested_remote?: string | undefined;
2607
+ }, {
2608
+ id: string;
2609
+ suggested_remote?: string | undefined;
2610
+ }>, "many">;
2611
+ activeWriteAlias: z.ZodOptional<z.ZodString>;
2612
+ }, "strict", z.ZodTypeAny, {
2613
+ uid: string;
2614
+ mountedStores: {
2615
+ personal: boolean;
2616
+ store_uuid: string;
2617
+ alias: string;
2618
+ writable: boolean;
2619
+ remote?: string | undefined;
2620
+ }[];
2621
+ requiredStores: {
2622
+ id: string;
2623
+ suggested_remote?: string | undefined;
2624
+ }[];
2625
+ activeWriteAlias?: string | undefined;
2626
+ }, {
2627
+ uid: string;
2628
+ mountedStores: {
2629
+ store_uuid: string;
2630
+ alias: string;
2631
+ personal?: boolean | undefined;
2632
+ remote?: string | undefined;
2633
+ writable?: boolean | undefined;
2634
+ }[];
2635
+ requiredStores: {
2636
+ id: string;
2637
+ suggested_remote?: string | undefined;
2638
+ }[];
2639
+ activeWriteAlias?: string | undefined;
2640
+ }>;
2641
+ writeScope: z.ZodString;
2642
+ expected: z.ZodObject<{
2643
+ readSet: z.ZodObject<{
2644
+ stores: z.ZodArray<z.ZodObject<{
2645
+ store_uuid: z.ZodString;
2646
+ alias: z.ZodString;
2647
+ remote: z.ZodOptional<z.ZodString>;
2648
+ writable: z.ZodBoolean;
2649
+ }, "strict", z.ZodTypeAny, {
2650
+ store_uuid: string;
2651
+ alias: string;
2652
+ writable: boolean;
2653
+ remote?: string | undefined;
2654
+ }, {
2655
+ store_uuid: string;
2656
+ alias: string;
2657
+ writable: boolean;
2658
+ remote?: string | undefined;
2659
+ }>, "many">;
2660
+ warnings: z.ZodArray<z.ZodObject<{
2661
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2662
+ ref: z.ZodString;
2663
+ message: z.ZodString;
2664
+ }, "strict", z.ZodTypeAny, {
2665
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2666
+ message: string;
2667
+ ref: string;
2668
+ }, {
2669
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2670
+ message: string;
2671
+ ref: string;
2672
+ }>, "many">;
2673
+ }, "strict", z.ZodTypeAny, {
2674
+ stores: {
2675
+ store_uuid: string;
2676
+ alias: string;
2677
+ writable: boolean;
2678
+ remote?: string | undefined;
2679
+ }[];
2680
+ warnings: {
2681
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2682
+ message: string;
2683
+ ref: string;
2684
+ }[];
2685
+ }, {
2686
+ stores: {
2687
+ store_uuid: string;
2688
+ alias: string;
2689
+ writable: boolean;
2690
+ remote?: string | undefined;
2691
+ }[];
2692
+ warnings: {
2693
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2694
+ message: string;
2695
+ ref: string;
2696
+ }[];
2697
+ }>;
2698
+ writeTarget: z.ZodNullable<z.ZodObject<{
2699
+ store_uuid: z.ZodString;
2700
+ alias: z.ZodString;
2701
+ }, "strict", z.ZodTypeAny, {
2702
+ store_uuid: string;
2703
+ alias: string;
2704
+ }, {
2705
+ store_uuid: string;
2706
+ alias: string;
2707
+ }>>;
2708
+ writeWarnings: z.ZodArray<z.ZodObject<{
2709
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
2710
+ ref: z.ZodString;
2711
+ message: z.ZodString;
2712
+ }, "strict", z.ZodTypeAny, {
2713
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2714
+ message: string;
2715
+ ref: string;
2716
+ }, {
2717
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2718
+ message: string;
2719
+ ref: string;
2720
+ }>, "many">;
2721
+ }, "strict", z.ZodTypeAny, {
2722
+ readSet: {
2723
+ stores: {
2724
+ store_uuid: string;
2725
+ alias: string;
2726
+ writable: boolean;
2727
+ remote?: string | undefined;
2728
+ }[];
2729
+ warnings: {
2730
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2731
+ message: string;
2732
+ ref: string;
2733
+ }[];
2734
+ };
2735
+ writeTarget: {
2736
+ store_uuid: string;
2737
+ alias: string;
2738
+ } | null;
2739
+ writeWarnings: {
2740
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2741
+ message: string;
2742
+ ref: string;
2743
+ }[];
2744
+ }, {
2745
+ readSet: {
2746
+ stores: {
2747
+ store_uuid: string;
2748
+ alias: string;
2749
+ writable: boolean;
2750
+ remote?: string | undefined;
2751
+ }[];
2752
+ warnings: {
2753
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2754
+ message: string;
2755
+ ref: string;
2756
+ }[];
2757
+ };
2758
+ writeTarget: {
2759
+ store_uuid: string;
2760
+ alias: string;
2761
+ } | null;
2762
+ writeWarnings: {
2763
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2764
+ message: string;
2765
+ ref: string;
2766
+ }[];
2767
+ }>;
2768
+ }, "strict", z.ZodTypeAny, {
2769
+ expected: {
2770
+ readSet: {
2771
+ stores: {
2772
+ store_uuid: string;
2773
+ alias: string;
2774
+ writable: boolean;
2775
+ remote?: string | undefined;
2776
+ }[];
2777
+ warnings: {
2778
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2779
+ message: string;
2780
+ ref: string;
2781
+ }[];
2782
+ };
2783
+ writeTarget: {
2784
+ store_uuid: string;
2785
+ alias: string;
2786
+ } | null;
2787
+ writeWarnings: {
2788
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2789
+ message: string;
2790
+ ref: string;
2791
+ }[];
2792
+ };
2793
+ name: string;
2794
+ input: {
2795
+ uid: string;
2796
+ mountedStores: {
2797
+ personal: boolean;
2798
+ store_uuid: string;
2799
+ alias: string;
2800
+ writable: boolean;
2801
+ remote?: string | undefined;
2802
+ }[];
2803
+ requiredStores: {
2804
+ id: string;
2805
+ suggested_remote?: string | undefined;
2806
+ }[];
2807
+ activeWriteAlias?: string | undefined;
2808
+ };
2809
+ writeScope: string;
2810
+ note?: string | undefined;
2811
+ }, {
2812
+ expected: {
2813
+ readSet: {
2814
+ stores: {
2815
+ store_uuid: string;
2816
+ alias: string;
2817
+ writable: boolean;
2818
+ remote?: string | undefined;
2819
+ }[];
2820
+ warnings: {
2821
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2822
+ message: string;
2823
+ ref: string;
2824
+ }[];
2825
+ };
2826
+ writeTarget: {
2827
+ store_uuid: string;
2828
+ alias: string;
2829
+ } | null;
2830
+ writeWarnings: {
2831
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2832
+ message: string;
2833
+ ref: string;
2834
+ }[];
2835
+ };
2836
+ name: string;
2837
+ input: {
2838
+ uid: string;
2839
+ mountedStores: {
2840
+ store_uuid: string;
2841
+ alias: string;
2842
+ personal?: boolean | undefined;
2843
+ remote?: string | undefined;
2844
+ writable?: boolean | undefined;
2845
+ }[];
2846
+ requiredStores: {
2847
+ id: string;
2848
+ suggested_remote?: string | undefined;
2849
+ }[];
2850
+ activeWriteAlias?: string | undefined;
2851
+ };
2852
+ writeScope: string;
2853
+ note?: string | undefined;
2854
+ }>, "many">;
2855
+ }, "strict", z.ZodTypeAny, {
2856
+ contract: "read-set.golden";
2857
+ cases: {
2858
+ expected: {
2859
+ readSet: {
2860
+ stores: {
2861
+ store_uuid: string;
2862
+ alias: string;
2863
+ writable: boolean;
2864
+ remote?: string | undefined;
2865
+ }[];
2866
+ warnings: {
2867
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2868
+ message: string;
2869
+ ref: string;
2870
+ }[];
2871
+ };
2872
+ writeTarget: {
2873
+ store_uuid: string;
2874
+ alias: string;
2875
+ } | null;
2876
+ writeWarnings: {
2877
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2878
+ message: string;
2879
+ ref: string;
2880
+ }[];
2881
+ };
2882
+ name: string;
2883
+ input: {
2884
+ uid: string;
2885
+ mountedStores: {
2886
+ personal: boolean;
2887
+ store_uuid: string;
2888
+ alias: string;
2889
+ writable: boolean;
2890
+ remote?: string | undefined;
2891
+ }[];
2892
+ requiredStores: {
2893
+ id: string;
2894
+ suggested_remote?: string | undefined;
2895
+ }[];
2896
+ activeWriteAlias?: string | undefined;
2897
+ };
2898
+ writeScope: string;
2899
+ note?: string | undefined;
2900
+ }[];
2901
+ }, {
2902
+ contract: "read-set.golden";
2903
+ cases: {
2904
+ expected: {
2905
+ readSet: {
2906
+ stores: {
2907
+ store_uuid: string;
2908
+ alias: string;
2909
+ writable: boolean;
2910
+ remote?: string | undefined;
2911
+ }[];
2912
+ warnings: {
2913
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2914
+ message: string;
2915
+ ref: string;
2916
+ }[];
2917
+ };
2918
+ writeTarget: {
2919
+ store_uuid: string;
2920
+ alias: string;
2921
+ } | null;
2922
+ writeWarnings: {
2923
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
2924
+ message: string;
2925
+ ref: string;
2926
+ }[];
2927
+ };
2928
+ name: string;
2929
+ input: {
2930
+ uid: string;
2931
+ mountedStores: {
2932
+ store_uuid: string;
2933
+ alias: string;
2934
+ personal?: boolean | undefined;
2935
+ remote?: string | undefined;
2936
+ writable?: boolean | undefined;
2937
+ }[];
2938
+ requiredStores: {
2939
+ id: string;
2940
+ suggested_remote?: string | undefined;
2941
+ }[];
2942
+ activeWriteAlias?: string | undefined;
2943
+ };
2944
+ writeScope: string;
2945
+ note?: string | undefined;
2946
+ }[];
2947
+ }>;
2948
+
2949
+ declare class ResolverNotImplementedError extends Error {
2950
+ constructor(what: string);
2951
+ }
2952
+ declare function createProjectRootResolver(): ProjectRootResolver;
2953
+
2954
+ declare function createStoreResolver(): StoreResolver;
2955
+
2956
+ declare function readStoreIdentity(absDir: string): StoreIdentity | null;
2957
+ declare function recognizeStoreDir(absDir: string): boolean;
2958
+ declare function findStoreExecutableViolations(absDir: string): string[];
2959
+
2960
+ interface QualifiedCandidate {
2961
+ store_uuid: string;
2962
+ alias: string;
2963
+ local_id: string;
2964
+ }
2965
+ interface QualifiedIdResolution {
2966
+ resolved: QualifiedCandidate | null;
2967
+ ambiguous: boolean;
2968
+ matches: QualifiedCandidate[];
2969
+ }
2970
+ declare function resolveStoreQualifiedId(ref: string, candidates: QualifiedCandidate[]): QualifiedIdResolution;
2971
+
2972
+ interface ResolutionCandidate {
2973
+ global_ref: string;
2974
+ store_uuid: string;
2975
+ alias: string;
2976
+ local_id: string;
2977
+ semantic_scope: string;
2978
+ }
2979
+ interface ResolvedEntry extends ResolutionCandidate {
2980
+ rank: number;
2981
+ reason: string;
2982
+ }
2983
+ interface ResolutionWarning {
2984
+ code: "required_store_unavailable" | "shadowed_local_id";
2985
+ ref: string;
2986
+ message: string;
2987
+ }
2988
+ interface ResolveOptions {
2989
+ storeOrder?: string[];
2990
+ unavailableRequiredStores?: string[];
2991
+ }
2992
+ interface ResolutionResult {
2993
+ resolved: ResolvedEntry[];
2994
+ warnings: ResolutionWarning[];
2995
+ }
2996
+ declare function resolveCandidates(candidates: ResolutionCandidate[], options?: ResolveOptions): ResolutionResult;
2997
+
2998
+ declare const STORE_PENDING_DIR = "pending";
2999
+ declare const STORE_GITIGNORE: string;
3000
+ interface InitStoreOptions {
3001
+ git?: boolean;
3002
+ }
3003
+ declare function initStore(absDir: string, identity: StoreIdentity, options?: InitStoreOptions): StoreIdentity;
3004
+ interface StoreKnowledgeRef {
3005
+ store_uuid: string;
3006
+ alias: string;
3007
+ type: string;
3008
+ file: string;
3009
+ }
3010
+ interface MountedStoreDir {
3011
+ store_uuid: string;
3012
+ alias: string;
3013
+ dir: string;
3014
+ }
3015
+ declare function listStoreKnowledge(store: MountedStoreDir): StoreKnowledgeRef[];
3016
+ declare function readKnowledgeAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
3017
+ declare function aggregatePendingAcrossStores(stores: MountedStoreDir[]): StoreKnowledgeRef[];
3018
+
3019
+ interface SecretFinding {
3020
+ rule: string;
3021
+ line: number;
3022
+ }
3023
+ declare function scanForSecrets(content: string): SecretFinding[];
3024
+ declare function hasSecrets(content: string): boolean;
3025
+ declare const REDACTION_PLACEHOLDER_PREFIX = "[REDACTED:";
3026
+ declare function redactSecrets(content: string): string;
3027
+
3028
+ type StoreVisibility = "shared" | "personal";
3029
+ interface CrossStoreRefViolation {
3030
+ code: "personal-ref-in-shared";
3031
+ ref: string;
3032
+ to_store_uuid: string;
3033
+ message: string;
3034
+ }
3035
+ interface CrossStoreLintInput {
3036
+ entryVisibility: StoreVisibility;
3037
+ referencedGlobalRefs: string[];
3038
+ storeVisibility: Record<string, StoreVisibility>;
3039
+ }
3040
+ declare function lintCrossStoreReferences(input: CrossStoreLintInput): CrossStoreRefViolation[];
3041
+ type EntryLayer = "team" | "personal";
3042
+ declare function isPersonalLeakIntoSharedStore(entryLayer: EntryLayer, storeVisibility: StoreVisibility): boolean;
3043
+
3044
+ type FailureStage = "install" | "sync" | "hook" | "mcp";
3045
+ interface FailureTrace {
3046
+ stage: FailureStage;
3047
+ code: string;
3048
+ message: string;
3049
+ context: Record<string, unknown>;
3050
+ }
3051
+ declare function buildFailureTrace(stage: FailureStage, error: unknown, context?: Record<string, unknown>, code?: string): FailureTrace;
3052
+ interface DebugBundleInput {
3053
+ config: Record<string, unknown>;
3054
+ diagnostics: unknown[];
3055
+ events?: string[];
3056
+ includeEvents?: boolean;
3057
+ }
3058
+ interface DebugBundle {
3059
+ version: 1;
3060
+ config: Record<string, unknown>;
3061
+ diagnostics: unknown[];
3062
+ events: string[];
3063
+ redacted: true;
3064
+ }
3065
+ declare function buildDebugBundle(input: DebugBundleInput): DebugBundle;
3066
+
3067
+ declare const knowledgeProvenanceSchema: z.ZodObject<{
3068
+ store_uuid: z.ZodString;
3069
+ alias: z.ZodString;
3070
+ local_id: z.ZodString;
3071
+ global_ref: z.ZodString;
3072
+ semantic_scope: z.ZodOptional<z.ZodString>;
3073
+ }, "strict", z.ZodTypeAny, {
3074
+ store_uuid: string;
3075
+ alias: string;
3076
+ local_id: string;
3077
+ global_ref: string;
3078
+ semantic_scope?: string | undefined;
3079
+ }, {
3080
+ store_uuid: string;
3081
+ alias: string;
3082
+ local_id: string;
3083
+ global_ref: string;
3084
+ semantic_scope?: string | undefined;
3085
+ }>;
3086
+ type KnowledgeProvenance = z.infer<typeof knowledgeProvenanceSchema>;
3087
+
3088
+ declare const MCP_STORE_AWARE_TOOLS: readonly ["fab_recall", "fab_plan_context", "fab_get_knowledge_sections", "fab_archive_scan", "fab_extract_knowledge", "fab_review"];
3089
+ type McpStoreAwareTool = (typeof MCP_STORE_AWARE_TOOLS)[number];
3090
+ declare const storeAwareEntrySchema: z.ZodObject<{
3091
+ stable_id: z.ZodString;
3092
+ global_ref: z.ZodString;
3093
+ provenance: z.ZodObject<{
3094
+ store_uuid: z.ZodString;
3095
+ alias: z.ZodString;
3096
+ local_id: z.ZodString;
3097
+ global_ref: z.ZodString;
3098
+ semantic_scope: z.ZodOptional<z.ZodString>;
3099
+ }, "strict", z.ZodTypeAny, {
3100
+ store_uuid: string;
3101
+ alias: string;
3102
+ local_id: string;
3103
+ global_ref: string;
3104
+ semantic_scope?: string | undefined;
3105
+ }, {
3106
+ store_uuid: string;
3107
+ alias: string;
3108
+ local_id: string;
3109
+ global_ref: string;
3110
+ semantic_scope?: string | undefined;
3111
+ }>;
3112
+ }, "strict", z.ZodTypeAny, {
3113
+ stable_id: string;
3114
+ global_ref: string;
3115
+ provenance: {
3116
+ store_uuid: string;
3117
+ alias: string;
3118
+ local_id: string;
3119
+ global_ref: string;
3120
+ semantic_scope?: string | undefined;
3121
+ };
3122
+ }, {
3123
+ stable_id: string;
3124
+ global_ref: string;
3125
+ provenance: {
3126
+ store_uuid: string;
3127
+ alias: string;
3128
+ local_id: string;
3129
+ global_ref: string;
3130
+ semantic_scope?: string | undefined;
3131
+ };
3132
+ }>;
3133
+ type StoreAwareEntry = z.infer<typeof storeAwareEntrySchema>;
3134
+ declare const writtenToStoreSchema: z.ZodObject<{
3135
+ store_uuid: z.ZodString;
3136
+ alias: z.ZodString;
3137
+ }, "strict", z.ZodTypeAny, {
3138
+ store_uuid: string;
3139
+ alias: string;
3140
+ }, {
3141
+ store_uuid: string;
3142
+ alias: string;
3143
+ }>;
3144
+ type WrittenToStore = z.infer<typeof writtenToStoreSchema>;
3145
+ interface McpStoreAwareContract {
3146
+ tool: McpStoreAwareTool;
3147
+ surfacesEntries: boolean;
3148
+ echoesWrittenStore: boolean;
3149
+ }
3150
+ declare const MCP_STORE_AWARE_CONTRACTS: Record<McpStoreAwareTool, McpStoreAwareContract>;
3151
+
3152
+ declare const resolvedBindingsSnapshotSchema: z.ZodObject<{
3153
+ version: z.ZodLiteral<1>;
3154
+ project_id: z.ZodString;
3155
+ generated_at: z.ZodString;
3156
+ read_set: z.ZodObject<{
3157
+ stores: z.ZodArray<z.ZodObject<{
3158
+ store_uuid: z.ZodString;
3159
+ alias: z.ZodString;
3160
+ remote: z.ZodOptional<z.ZodString>;
3161
+ writable: z.ZodBoolean;
3162
+ }, "strict", z.ZodTypeAny, {
3163
+ store_uuid: string;
3164
+ alias: string;
3165
+ writable: boolean;
3166
+ remote?: string | undefined;
3167
+ }, {
3168
+ store_uuid: string;
3169
+ alias: string;
3170
+ writable: boolean;
3171
+ remote?: string | undefined;
3172
+ }>, "many">;
3173
+ warnings: z.ZodArray<z.ZodObject<{
3174
+ code: z.ZodEnum<["missing_store", "local_only_no_remote", "alias_unresolved"]>;
3175
+ ref: z.ZodString;
3176
+ message: z.ZodString;
3177
+ }, "strict", z.ZodTypeAny, {
3178
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3179
+ message: string;
3180
+ ref: string;
3181
+ }, {
3182
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3183
+ message: string;
3184
+ ref: string;
3185
+ }>, "many">;
3186
+ }, "strict", z.ZodTypeAny, {
3187
+ stores: {
3188
+ store_uuid: string;
3189
+ alias: string;
3190
+ writable: boolean;
3191
+ remote?: string | undefined;
3192
+ }[];
3193
+ warnings: {
3194
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3195
+ message: string;
3196
+ ref: string;
3197
+ }[];
3198
+ }, {
3199
+ stores: {
3200
+ store_uuid: string;
3201
+ alias: string;
3202
+ writable: boolean;
3203
+ remote?: string | undefined;
3204
+ }[];
3205
+ warnings: {
3206
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3207
+ message: string;
3208
+ ref: string;
3209
+ }[];
3210
+ }>;
3211
+ write_target: z.ZodNullable<z.ZodObject<{
3212
+ store_uuid: z.ZodString;
3213
+ alias: z.ZodString;
3214
+ }, "strict", z.ZodTypeAny, {
3215
+ store_uuid: string;
3216
+ alias: string;
3217
+ }, {
3218
+ store_uuid: string;
3219
+ alias: string;
3220
+ }>>;
3221
+ }, "strict", z.ZodTypeAny, {
3222
+ project_id: string;
3223
+ version: 1;
3224
+ generated_at: string;
3225
+ read_set: {
3226
+ stores: {
3227
+ store_uuid: string;
3228
+ alias: string;
3229
+ writable: boolean;
3230
+ remote?: string | undefined;
3231
+ }[];
3232
+ warnings: {
3233
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3234
+ message: string;
3235
+ ref: string;
3236
+ }[];
3237
+ };
3238
+ write_target: {
3239
+ store_uuid: string;
3240
+ alias: string;
3241
+ } | null;
1308
3242
  }, {
1309
- locked?: {
1310
- file: string;
1311
- hash: string;
1312
- start_line: number;
1313
- end_line: number;
1314
- }[] | undefined;
3243
+ project_id: string;
3244
+ version: 1;
3245
+ generated_at: string;
3246
+ read_set: {
3247
+ stores: {
3248
+ store_uuid: string;
3249
+ alias: string;
3250
+ writable: boolean;
3251
+ remote?: string | undefined;
3252
+ }[];
3253
+ warnings: {
3254
+ code: "missing_store" | "local_only_no_remote" | "alias_unresolved";
3255
+ message: string;
3256
+ ref: string;
3257
+ }[];
3258
+ };
3259
+ write_target: {
3260
+ store_uuid: string;
3261
+ alias: string;
3262
+ } | null;
1315
3263
  }>;
3264
+ type ResolvedBindingsSnapshot = z.infer<typeof resolvedBindingsSnapshotSchema>;
1316
3265
 
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;
3266
+ declare function bindingsSnapshotPath(globalRoot: string, projectId: string): string;
3267
+ interface WriteBindingsSnapshotOptions {
3268
+ globalRoot: string;
3269
+ projectId: string;
3270
+ resolveInput: StoreResolveInput;
3271
+ writeScope: string;
3272
+ now: string;
3273
+ }
3274
+ declare function writeBindingsSnapshot(options: WriteBindingsSnapshotOptions): ResolvedBindingsSnapshot;
3275
+ declare function readBindingsSnapshot(globalRoot: string, projectId: string): ResolvedBindingsSnapshot | null;
3276
+
3277
+ declare function findMountedStore(config: GlobalConfig, aliasOrUuid: string): MountedStore | undefined;
3278
+ declare function addMountedStore(config: GlobalConfig, store: MountedStore): GlobalConfig;
3279
+ declare function detachMountedStore(config: GlobalConfig, alias: string): {
3280
+ config: GlobalConfig;
3281
+ detached: MountedStore | null;
1325
3282
  };
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;
3283
+ declare function bindRequiredStore(required: RequiredStoreEntry[], entry: RequiredStoreEntry): RequiredStoreEntry[];
3284
+ interface StoreExplain {
3285
+ alias: string;
3286
+ store_uuid: string;
3287
+ remote: string | null;
3288
+ local_only: boolean;
1345
3289
  }
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;
3290
+ declare function explainStore(config: GlobalConfig, alias: string): StoreExplain | null;
1356
3291
 
1357
3292
  interface ForensicCodeSample {
1358
3293
  path: string;
@@ -1804,6 +3739,7 @@ declare const forensicReportSchema: z.ZodObject<{
1804
3739
  }, "strip", z.ZodTypeAny, {
1805
3740
  version: string;
1806
3741
  generated_at: string;
3742
+ target: string;
1807
3743
  framework: {
1808
3744
  version: string;
1809
3745
  evidence: string[];
@@ -1811,7 +3747,6 @@ declare const forensicReportSchema: z.ZodObject<{
1811
3747
  subkind: string;
1812
3748
  };
1813
3749
  generated_by: string;
1814
- target: string;
1815
3750
  project_name: string;
1816
3751
  topology: {
1817
3752
  total_files: number;
@@ -1866,6 +3801,7 @@ declare const forensicReportSchema: z.ZodObject<{
1866
3801
  }, {
1867
3802
  version: string;
1868
3803
  generated_at: string;
3804
+ target: string;
1869
3805
  framework: {
1870
3806
  version: string;
1871
3807
  evidence: string[];
@@ -1873,7 +3809,6 @@ declare const forensicReportSchema: z.ZodObject<{
1873
3809
  subkind: string;
1874
3810
  };
1875
3811
  generated_by: string;
1876
- target: string;
1877
3812
  project_name: string;
1878
3813
  topology: {
1879
3814
  total_files: number;
@@ -2336,13 +4271,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2336
4271
  tech_stack: string[];
2337
4272
  impact: string[];
2338
4273
  must_read_if: string;
2339
- entities?: string[] | undefined;
4274
+ created_at?: string | undefined;
2340
4275
  id?: string | undefined;
4276
+ entities?: string[] | undefined;
2341
4277
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2342
4278
  maturity?: "draft" | "verified" | "proven" | undefined;
2343
4279
  knowledge_layer?: "personal" | "team" | undefined;
2344
4280
  layer_reason?: string | undefined;
2345
- created_at?: string | undefined;
2346
4281
  tags?: string[] | undefined;
2347
4282
  }, {
2348
4283
  summary: string;
@@ -2350,15 +4285,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2350
4285
  tech_stack: string[];
2351
4286
  impact: string[];
2352
4287
  must_read_if: string;
4288
+ created_at?: string | undefined;
4289
+ id?: string | undefined;
2353
4290
  relevance_scope?: "narrow" | "broad" | undefined;
2354
4291
  relevance_paths?: string[] | undefined;
2355
4292
  entities?: string[] | undefined;
2356
- id?: string | undefined;
2357
4293
  knowledge_type?: unknown;
2358
4294
  maturity?: "draft" | "verified" | "proven" | undefined;
2359
4295
  knowledge_layer?: "personal" | "team" | undefined;
2360
4296
  layer_reason?: string | undefined;
2361
- created_at?: string | undefined;
2362
4297
  tags?: string[] | undefined;
2363
4298
  }>>;
2364
4299
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2403,13 +4338,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2403
4338
  tech_stack: string[];
2404
4339
  impact: string[];
2405
4340
  must_read_if: string;
2406
- entities?: string[] | undefined;
4341
+ created_at?: string | undefined;
2407
4342
  id?: string | undefined;
4343
+ entities?: string[] | undefined;
2408
4344
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2409
4345
  maturity?: "draft" | "verified" | "proven" | undefined;
2410
4346
  knowledge_layer?: "personal" | "team" | undefined;
2411
4347
  layer_reason?: string | undefined;
2412
- created_at?: string | undefined;
2413
4348
  tags?: string[] | undefined;
2414
4349
  }, {
2415
4350
  summary: string;
@@ -2417,15 +4352,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2417
4352
  tech_stack: string[];
2418
4353
  impact: string[];
2419
4354
  must_read_if: string;
4355
+ created_at?: string | undefined;
4356
+ id?: string | undefined;
2420
4357
  relevance_scope?: "narrow" | "broad" | undefined;
2421
4358
  relevance_paths?: string[] | undefined;
2422
4359
  entities?: string[] | undefined;
2423
- id?: string | undefined;
2424
4360
  knowledge_type?: unknown;
2425
4361
  maturity?: "draft" | "verified" | "proven" | undefined;
2426
4362
  knowledge_layer?: "personal" | "team" | undefined;
2427
4363
  layer_reason?: string | undefined;
2428
- created_at?: string | undefined;
2429
4364
  tags?: string[] | undefined;
2430
4365
  }>>;
2431
4366
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2470,13 +4405,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2470
4405
  tech_stack: string[];
2471
4406
  impact: string[];
2472
4407
  must_read_if: string;
2473
- entities?: string[] | undefined;
4408
+ created_at?: string | undefined;
2474
4409
  id?: string | undefined;
4410
+ entities?: string[] | undefined;
2475
4411
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2476
4412
  maturity?: "draft" | "verified" | "proven" | undefined;
2477
4413
  knowledge_layer?: "personal" | "team" | undefined;
2478
4414
  layer_reason?: string | undefined;
2479
- created_at?: string | undefined;
2480
4415
  tags?: string[] | undefined;
2481
4416
  }, {
2482
4417
  summary: string;
@@ -2484,15 +4419,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2484
4419
  tech_stack: string[];
2485
4420
  impact: string[];
2486
4421
  must_read_if: string;
4422
+ created_at?: string | undefined;
4423
+ id?: string | undefined;
2487
4424
  relevance_scope?: "narrow" | "broad" | undefined;
2488
4425
  relevance_paths?: string[] | undefined;
2489
4426
  entities?: string[] | undefined;
2490
- id?: string | undefined;
2491
4427
  knowledge_type?: unknown;
2492
4428
  maturity?: "draft" | "verified" | "proven" | undefined;
2493
4429
  knowledge_layer?: "personal" | "team" | undefined;
2494
4430
  layer_reason?: string | undefined;
2495
- created_at?: string | undefined;
2496
4431
  tags?: string[] | undefined;
2497
4432
  }>>;
2498
4433
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2537,13 +4472,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2537
4472
  tech_stack: string[];
2538
4473
  impact: string[];
2539
4474
  must_read_if: string;
2540
- entities?: string[] | undefined;
4475
+ created_at?: string | undefined;
2541
4476
  id?: string | undefined;
4477
+ entities?: string[] | undefined;
2542
4478
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2543
4479
  maturity?: "draft" | "verified" | "proven" | undefined;
2544
4480
  knowledge_layer?: "personal" | "team" | undefined;
2545
4481
  layer_reason?: string | undefined;
2546
- created_at?: string | undefined;
2547
4482
  tags?: string[] | undefined;
2548
4483
  }, {
2549
4484
  summary: string;
@@ -2551,15 +4486,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2551
4486
  tech_stack: string[];
2552
4487
  impact: string[];
2553
4488
  must_read_if: string;
4489
+ created_at?: string | undefined;
4490
+ id?: string | undefined;
2554
4491
  relevance_scope?: "narrow" | "broad" | undefined;
2555
4492
  relevance_paths?: string[] | undefined;
2556
4493
  entities?: string[] | undefined;
2557
- id?: string | undefined;
2558
4494
  knowledge_type?: unknown;
2559
4495
  maturity?: "draft" | "verified" | "proven" | undefined;
2560
4496
  knowledge_layer?: "personal" | "team" | undefined;
2561
4497
  layer_reason?: string | undefined;
2562
- created_at?: string | undefined;
2563
4498
  tags?: string[] | undefined;
2564
4499
  }>>;
2565
4500
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2677,13 +4612,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2677
4612
  tech_stack: string[];
2678
4613
  impact: string[];
2679
4614
  must_read_if: string;
2680
- entities?: string[] | undefined;
4615
+ created_at?: string | undefined;
2681
4616
  id?: string | undefined;
4617
+ entities?: string[] | undefined;
2682
4618
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2683
4619
  maturity?: "draft" | "verified" | "proven" | undefined;
2684
4620
  knowledge_layer?: "personal" | "team" | undefined;
2685
4621
  layer_reason?: string | undefined;
2686
- created_at?: string | undefined;
2687
4622
  tags?: string[] | undefined;
2688
4623
  }, {
2689
4624
  summary: string;
@@ -2691,15 +4626,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2691
4626
  tech_stack: string[];
2692
4627
  impact: string[];
2693
4628
  must_read_if: string;
4629
+ created_at?: string | undefined;
4630
+ id?: string | undefined;
2694
4631
  relevance_scope?: "narrow" | "broad" | undefined;
2695
4632
  relevance_paths?: string[] | undefined;
2696
4633
  entities?: string[] | undefined;
2697
- id?: string | undefined;
2698
4634
  knowledge_type?: unknown;
2699
4635
  maturity?: "draft" | "verified" | "proven" | undefined;
2700
4636
  knowledge_layer?: "personal" | "team" | undefined;
2701
4637
  layer_reason?: string | undefined;
2702
- created_at?: string | undefined;
2703
4638
  tags?: string[] | undefined;
2704
4639
  }>>;
2705
4640
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2785,13 +4720,13 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2785
4720
  tech_stack: string[];
2786
4721
  impact: string[];
2787
4722
  must_read_if: string;
2788
- entities?: string[] | undefined;
4723
+ created_at?: string | undefined;
2789
4724
  id?: string | undefined;
4725
+ entities?: string[] | undefined;
2790
4726
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
2791
4727
  maturity?: "draft" | "verified" | "proven" | undefined;
2792
4728
  knowledge_layer?: "personal" | "team" | undefined;
2793
4729
  layer_reason?: string | undefined;
2794
- created_at?: string | undefined;
2795
4730
  tags?: string[] | undefined;
2796
4731
  }, {
2797
4732
  summary: string;
@@ -2799,15 +4734,15 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
2799
4734
  tech_stack: string[];
2800
4735
  impact: string[];
2801
4736
  must_read_if: string;
4737
+ created_at?: string | undefined;
4738
+ id?: string | undefined;
2802
4739
  relevance_scope?: "narrow" | "broad" | undefined;
2803
4740
  relevance_paths?: string[] | undefined;
2804
4741
  entities?: string[] | undefined;
2805
- id?: string | undefined;
2806
4742
  knowledge_type?: unknown;
2807
4743
  maturity?: "draft" | "verified" | "proven" | undefined;
2808
4744
  knowledge_layer?: "personal" | "team" | undefined;
2809
4745
  layer_reason?: string | undefined;
2810
- created_at?: string | undefined;
2811
4746
  tags?: string[] | undefined;
2812
4747
  }>>;
2813
4748
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3316,6 +5251,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3316
5251
  }, "strip", z.ZodTypeAny, {
3317
5252
  version: string;
3318
5253
  generated_at: string;
5254
+ target: string;
3319
5255
  framework: {
3320
5256
  version: string;
3321
5257
  evidence: string[];
@@ -3323,7 +5259,6 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3323
5259
  subkind: string;
3324
5260
  };
3325
5261
  generated_by: string;
3326
- target: string;
3327
5262
  project_name: string;
3328
5263
  topology: {
3329
5264
  total_files: number;
@@ -3378,6 +5313,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3378
5313
  }, {
3379
5314
  version: string;
3380
5315
  generated_at: string;
5316
+ target: string;
3381
5317
  framework: {
3382
5318
  version: string;
3383
5319
  evidence: string[];
@@ -3385,7 +5321,6 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3385
5321
  subkind: string;
3386
5322
  };
3387
5323
  generated_by: string;
3388
- target: string;
3389
5324
  project_name: string;
3390
5325
  topology: {
3391
5326
  total_files: number;
@@ -3443,6 +5378,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3443
5378
  payload: {
3444
5379
  version: string;
3445
5380
  generated_at: string;
5381
+ target: string;
3446
5382
  framework: {
3447
5383
  version: string;
3448
5384
  evidence: string[];
@@ -3450,7 +5386,6 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3450
5386
  subkind: string;
3451
5387
  };
3452
5388
  generated_by: string;
3453
- target: string;
3454
5389
  project_name: string;
3455
5390
  topology: {
3456
5391
  total_files: number;
@@ -3508,6 +5443,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3508
5443
  payload: {
3509
5444
  version: string;
3510
5445
  generated_at: string;
5446
+ target: string;
3511
5447
  framework: {
3512
5448
  version: string;
3513
5449
  evidence: string[];
@@ -3515,7 +5451,6 @@ declare const driftDetectedEventSchema: z.ZodObject<{
3515
5451
  subkind: string;
3516
5452
  };
3517
5453
  generated_by: string;
3518
- target: string;
3519
5454
  project_name: string;
3520
5455
  topology: {
3521
5456
  total_files: number;
@@ -3614,13 +5549,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3614
5549
  tech_stack: string[];
3615
5550
  impact: string[];
3616
5551
  must_read_if: string;
3617
- entities?: string[] | undefined;
5552
+ created_at?: string | undefined;
3618
5553
  id?: string | undefined;
5554
+ entities?: string[] | undefined;
3619
5555
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3620
5556
  maturity?: "draft" | "verified" | "proven" | undefined;
3621
5557
  knowledge_layer?: "personal" | "team" | undefined;
3622
5558
  layer_reason?: string | undefined;
3623
- created_at?: string | undefined;
3624
5559
  tags?: string[] | undefined;
3625
5560
  }, {
3626
5561
  summary: string;
@@ -3628,15 +5563,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3628
5563
  tech_stack: string[];
3629
5564
  impact: string[];
3630
5565
  must_read_if: string;
5566
+ created_at?: string | undefined;
5567
+ id?: string | undefined;
3631
5568
  relevance_scope?: "narrow" | "broad" | undefined;
3632
5569
  relevance_paths?: string[] | undefined;
3633
5570
  entities?: string[] | undefined;
3634
- id?: string | undefined;
3635
5571
  knowledge_type?: unknown;
3636
5572
  maturity?: "draft" | "verified" | "proven" | undefined;
3637
5573
  knowledge_layer?: "personal" | "team" | undefined;
3638
5574
  layer_reason?: string | undefined;
3639
- created_at?: string | undefined;
3640
5575
  tags?: string[] | undefined;
3641
5576
  }>>;
3642
5577
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3681,13 +5616,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3681
5616
  tech_stack: string[];
3682
5617
  impact: string[];
3683
5618
  must_read_if: string;
3684
- entities?: string[] | undefined;
5619
+ created_at?: string | undefined;
3685
5620
  id?: string | undefined;
5621
+ entities?: string[] | undefined;
3686
5622
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3687
5623
  maturity?: "draft" | "verified" | "proven" | undefined;
3688
5624
  knowledge_layer?: "personal" | "team" | undefined;
3689
5625
  layer_reason?: string | undefined;
3690
- created_at?: string | undefined;
3691
5626
  tags?: string[] | undefined;
3692
5627
  }, {
3693
5628
  summary: string;
@@ -3695,15 +5630,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3695
5630
  tech_stack: string[];
3696
5631
  impact: string[];
3697
5632
  must_read_if: string;
5633
+ created_at?: string | undefined;
5634
+ id?: string | undefined;
3698
5635
  relevance_scope?: "narrow" | "broad" | undefined;
3699
5636
  relevance_paths?: string[] | undefined;
3700
5637
  entities?: string[] | undefined;
3701
- id?: string | undefined;
3702
5638
  knowledge_type?: unknown;
3703
5639
  maturity?: "draft" | "verified" | "proven" | undefined;
3704
5640
  knowledge_layer?: "personal" | "team" | undefined;
3705
5641
  layer_reason?: string | undefined;
3706
- created_at?: string | undefined;
3707
5642
  tags?: string[] | undefined;
3708
5643
  }>>;
3709
5644
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3748,13 +5683,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3748
5683
  tech_stack: string[];
3749
5684
  impact: string[];
3750
5685
  must_read_if: string;
3751
- entities?: string[] | undefined;
5686
+ created_at?: string | undefined;
3752
5687
  id?: string | undefined;
5688
+ entities?: string[] | undefined;
3753
5689
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3754
5690
  maturity?: "draft" | "verified" | "proven" | undefined;
3755
5691
  knowledge_layer?: "personal" | "team" | undefined;
3756
5692
  layer_reason?: string | undefined;
3757
- created_at?: string | undefined;
3758
5693
  tags?: string[] | undefined;
3759
5694
  }, {
3760
5695
  summary: string;
@@ -3762,15 +5697,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3762
5697
  tech_stack: string[];
3763
5698
  impact: string[];
3764
5699
  must_read_if: string;
5700
+ created_at?: string | undefined;
5701
+ id?: string | undefined;
3765
5702
  relevance_scope?: "narrow" | "broad" | undefined;
3766
5703
  relevance_paths?: string[] | undefined;
3767
5704
  entities?: string[] | undefined;
3768
- id?: string | undefined;
3769
5705
  knowledge_type?: unknown;
3770
5706
  maturity?: "draft" | "verified" | "proven" | undefined;
3771
5707
  knowledge_layer?: "personal" | "team" | undefined;
3772
5708
  layer_reason?: string | undefined;
3773
- created_at?: string | undefined;
3774
5709
  tags?: string[] | undefined;
3775
5710
  }>>;
3776
5711
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3815,13 +5750,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3815
5750
  tech_stack: string[];
3816
5751
  impact: string[];
3817
5752
  must_read_if: string;
3818
- entities?: string[] | undefined;
5753
+ created_at?: string | undefined;
3819
5754
  id?: string | undefined;
5755
+ entities?: string[] | undefined;
3820
5756
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3821
5757
  maturity?: "draft" | "verified" | "proven" | undefined;
3822
5758
  knowledge_layer?: "personal" | "team" | undefined;
3823
5759
  layer_reason?: string | undefined;
3824
- created_at?: string | undefined;
3825
5760
  tags?: string[] | undefined;
3826
5761
  }, {
3827
5762
  summary: string;
@@ -3829,15 +5764,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3829
5764
  tech_stack: string[];
3830
5765
  impact: string[];
3831
5766
  must_read_if: string;
5767
+ created_at?: string | undefined;
5768
+ id?: string | undefined;
3832
5769
  relevance_scope?: "narrow" | "broad" | undefined;
3833
5770
  relevance_paths?: string[] | undefined;
3834
5771
  entities?: string[] | undefined;
3835
- id?: string | undefined;
3836
5772
  knowledge_type?: unknown;
3837
5773
  maturity?: "draft" | "verified" | "proven" | undefined;
3838
5774
  knowledge_layer?: "personal" | "team" | undefined;
3839
5775
  layer_reason?: string | undefined;
3840
- created_at?: string | undefined;
3841
5776
  tags?: string[] | undefined;
3842
5777
  }>>;
3843
5778
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3955,13 +5890,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3955
5890
  tech_stack: string[];
3956
5891
  impact: string[];
3957
5892
  must_read_if: string;
3958
- entities?: string[] | undefined;
5893
+ created_at?: string | undefined;
3959
5894
  id?: string | undefined;
5895
+ entities?: string[] | undefined;
3960
5896
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
3961
5897
  maturity?: "draft" | "verified" | "proven" | undefined;
3962
5898
  knowledge_layer?: "personal" | "team" | undefined;
3963
5899
  layer_reason?: string | undefined;
3964
- created_at?: string | undefined;
3965
5900
  tags?: string[] | undefined;
3966
5901
  }, {
3967
5902
  summary: string;
@@ -3969,15 +5904,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3969
5904
  tech_stack: string[];
3970
5905
  impact: string[];
3971
5906
  must_read_if: string;
5907
+ created_at?: string | undefined;
5908
+ id?: string | undefined;
3972
5909
  relevance_scope?: "narrow" | "broad" | undefined;
3973
5910
  relevance_paths?: string[] | undefined;
3974
5911
  entities?: string[] | undefined;
3975
- id?: string | undefined;
3976
5912
  knowledge_type?: unknown;
3977
5913
  maturity?: "draft" | "verified" | "proven" | undefined;
3978
5914
  knowledge_layer?: "personal" | "team" | undefined;
3979
5915
  layer_reason?: string | undefined;
3980
- created_at?: string | undefined;
3981
5916
  tags?: string[] | undefined;
3982
5917
  }>>;
3983
5918
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4063,13 +5998,13 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4063
5998
  tech_stack: string[];
4064
5999
  impact: string[];
4065
6000
  must_read_if: string;
4066
- entities?: string[] | undefined;
6001
+ created_at?: string | undefined;
4067
6002
  id?: string | undefined;
6003
+ entities?: string[] | undefined;
4068
6004
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
4069
6005
  maturity?: "draft" | "verified" | "proven" | undefined;
4070
6006
  knowledge_layer?: "personal" | "team" | undefined;
4071
6007
  layer_reason?: string | undefined;
4072
- created_at?: string | undefined;
4073
6008
  tags?: string[] | undefined;
4074
6009
  }, {
4075
6010
  summary: string;
@@ -4077,15 +6012,15 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4077
6012
  tech_stack: string[];
4078
6013
  impact: string[];
4079
6014
  must_read_if: string;
6015
+ created_at?: string | undefined;
6016
+ id?: string | undefined;
4080
6017
  relevance_scope?: "narrow" | "broad" | undefined;
4081
6018
  relevance_paths?: string[] | undefined;
4082
6019
  entities?: string[] | undefined;
4083
- id?: string | undefined;
4084
6020
  knowledge_type?: unknown;
4085
6021
  maturity?: "draft" | "verified" | "proven" | undefined;
4086
6022
  knowledge_layer?: "personal" | "team" | undefined;
4087
6023
  layer_reason?: string | undefined;
4088
- created_at?: string | undefined;
4089
6024
  tags?: string[] | undefined;
4090
6025
  }>>;
4091
6026
  sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4590,6 +6525,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4590
6525
  }, "strip", z.ZodTypeAny, {
4591
6526
  version: string;
4592
6527
  generated_at: string;
6528
+ target: string;
4593
6529
  framework: {
4594
6530
  version: string;
4595
6531
  evidence: string[];
@@ -4597,7 +6533,6 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4597
6533
  subkind: string;
4598
6534
  };
4599
6535
  generated_by: string;
4600
- target: string;
4601
6536
  project_name: string;
4602
6537
  topology: {
4603
6538
  total_files: number;
@@ -4652,6 +6587,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4652
6587
  }, {
4653
6588
  version: string;
4654
6589
  generated_at: string;
6590
+ target: string;
4655
6591
  framework: {
4656
6592
  version: string;
4657
6593
  evidence: string[];
@@ -4659,7 +6595,6 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4659
6595
  subkind: string;
4660
6596
  };
4661
6597
  generated_by: string;
4662
- target: string;
4663
6598
  project_name: string;
4664
6599
  topology: {
4665
6600
  total_files: number;
@@ -4717,6 +6652,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4717
6652
  payload: {
4718
6653
  version: string;
4719
6654
  generated_at: string;
6655
+ target: string;
4720
6656
  framework: {
4721
6657
  version: string;
4722
6658
  evidence: string[];
@@ -4724,7 +6660,6 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4724
6660
  subkind: string;
4725
6661
  };
4726
6662
  generated_by: string;
4727
- target: string;
4728
6663
  project_name: string;
4729
6664
  topology: {
4730
6665
  total_files: number;
@@ -4782,6 +6717,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4782
6717
  payload: {
4783
6718
  version: string;
4784
6719
  generated_at: string;
6720
+ target: string;
4785
6721
  framework: {
4786
6722
  version: string;
4787
6723
  evidence: string[];
@@ -4789,7 +6725,6 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
4789
6725
  subkind: string;
4790
6726
  };
4791
6727
  generated_by: string;
4792
- target: string;
4793
6728
  project_name: string;
4794
6729
  topology: {
4795
6730
  total_files: number;
@@ -5197,25 +7132,25 @@ declare const installDiffAppliedEventSchema: z.ZodObject<{
5197
7132
  correlation_id: z.ZodOptional<z.ZodString>;
5198
7133
  session_id: z.ZodOptional<z.ZodString>;
5199
7134
  }, "strip", z.ZodTypeAny, {
7135
+ id: string;
5200
7136
  canonical: string[];
5201
7137
  drifted: string[];
5202
- id: string;
5203
7138
  ts: number;
5204
7139
  schema_version: 1;
5205
7140
  kind: "fabric-event";
5206
- event_type: "install_diff_applied";
5207
7141
  applied: string[];
7142
+ event_type: "install_diff_applied";
5208
7143
  correlation_id?: string | undefined;
5209
7144
  session_id?: string | undefined;
5210
7145
  }, {
7146
+ id: string;
5211
7147
  canonical: string[];
5212
7148
  drifted: string[];
5213
- id: string;
5214
7149
  ts: number;
5215
7150
  schema_version: 1;
5216
7151
  kind: "fabric-event";
5217
- event_type: "install_diff_applied";
5218
7152
  applied: string[];
7153
+ event_type: "install_diff_applied";
5219
7154
  correlation_id?: string | undefined;
5220
7155
  session_id?: string | undefined;
5221
7156
  }>;
@@ -5512,7 +7447,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
5512
7447
  written_stable_ids: string[];
5513
7448
  correlation_id?: string | undefined;
5514
7449
  session_id?: string | undefined;
5515
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
7450
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
5516
7451
  }, {
5517
7452
  id: string;
5518
7453
  ts: number;
@@ -5523,7 +7458,7 @@ declare const initScanCompletedEventSchema: z.ZodObject<{
5523
7458
  written_stable_ids: string[];
5524
7459
  correlation_id?: string | undefined;
5525
7460
  session_id?: string | undefined;
5526
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
7461
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
5527
7462
  }>;
5528
7463
  declare const knowledgeProposedEventSchema: z.ZodObject<{
5529
7464
  event_type: z.ZodLiteral<"knowledge_proposed">;
@@ -6182,8 +8117,8 @@ declare const pendingAutoArchivedEventSchema: z.ZodObject<{
6182
8117
  correlation_id: z.ZodOptional<z.ZodString>;
6183
8118
  session_id: z.ZodOptional<z.ZodString>;
6184
8119
  }, "strip", z.ZodTypeAny, {
6185
- pending_path: string;
6186
8120
  id: string;
8121
+ pending_path: string;
6187
8122
  reason: string;
6188
8123
  ts: number;
6189
8124
  schema_version: 1;
@@ -6193,8 +8128,8 @@ declare const pendingAutoArchivedEventSchema: z.ZodObject<{
6193
8128
  correlation_id?: string | undefined;
6194
8129
  session_id?: string | undefined;
6195
8130
  }, {
6196
- pending_path: string;
6197
8131
  id: string;
8132
+ pending_path: string;
6198
8133
  reason: string;
6199
8134
  ts: number;
6200
8135
  schema_version: 1;
@@ -6208,29 +8143,29 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6208
8143
  event_type: z.ZodLiteral<"assistant_turn_observed">;
6209
8144
  kb_line_raw: z.ZodNullable<z.ZodString>;
6210
8145
  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">>;
8146
+ cite_tags: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEnum<["applied", "dismissed", "none"]>, "none" | "applied" | "dismissed", unknown>, "many">>;
6212
8147
  cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
6213
8148
  operators: z.ZodArray<z.ZodObject<{
6214
8149
  kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
6215
8150
  target: z.ZodString;
6216
8151
  }, "strip", z.ZodTypeAny, {
6217
- kind: "require" | "edit" | "not_edit" | "forbid";
6218
8152
  target: string;
6219
- }, {
6220
8153
  kind: "require" | "edit" | "not_edit" | "forbid";
8154
+ }, {
6221
8155
  target: string;
8156
+ kind: "require" | "edit" | "not_edit" | "forbid";
6222
8157
  }>, "many">;
6223
8158
  skip_reason: z.ZodNullable<z.ZodString>;
6224
8159
  }, "strip", z.ZodTypeAny, {
6225
8160
  operators: {
6226
- kind: "require" | "edit" | "not_edit" | "forbid";
6227
8161
  target: string;
8162
+ kind: "require" | "edit" | "not_edit" | "forbid";
6228
8163
  }[];
6229
8164
  skip_reason: string | null;
6230
8165
  }, {
6231
8166
  operators: {
6232
- kind: "require" | "edit" | "not_edit" | "forbid";
6233
8167
  target: string;
8168
+ kind: "require" | "edit" | "not_edit" | "forbid";
6234
8169
  }[];
6235
8170
  skip_reason: string | null;
6236
8171
  }>, "many">>;
@@ -6253,11 +8188,11 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6253
8188
  timestamp: string;
6254
8189
  kb_line_raw: string | null;
6255
8190
  cite_ids: string[];
6256
- cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
8191
+ cite_tags: ("none" | "applied" | "dismissed")[];
6257
8192
  cite_commitments: {
6258
8193
  operators: {
6259
- kind: "require" | "edit" | "not_edit" | "forbid";
6260
8194
  target: string;
8195
+ kind: "require" | "edit" | "not_edit" | "forbid";
6261
8196
  }[];
6262
8197
  skip_reason: string | null;
6263
8198
  }[];
@@ -6278,11 +8213,11 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
6278
8213
  correlation_id?: string | undefined;
6279
8214
  session_id?: string | undefined;
6280
8215
  cite_ids?: string[] | undefined;
6281
- cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
8216
+ cite_tags?: unknown[] | undefined;
6282
8217
  cite_commitments?: {
6283
8218
  operators: {
6284
- kind: "require" | "edit" | "not_edit" | "forbid";
6285
8219
  target: string;
8220
+ kind: "require" | "edit" | "not_edit" | "forbid";
6286
8221
  }[];
6287
8222
  skip_reason: string | null;
6288
8223
  }[] | undefined;
@@ -6873,25 +8808,25 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
6873
8808
  correlation_id: z.ZodOptional<z.ZodString>;
6874
8809
  session_id: z.ZodOptional<z.ZodString>;
6875
8810
  }, "strip", z.ZodTypeAny, {
8811
+ id: string;
6876
8812
  canonical: string[];
6877
8813
  drifted: string[];
6878
- id: string;
6879
8814
  ts: number;
6880
8815
  schema_version: 1;
6881
8816
  kind: "fabric-event";
6882
- event_type: "install_diff_applied";
6883
8817
  applied: string[];
8818
+ event_type: "install_diff_applied";
6884
8819
  correlation_id?: string | undefined;
6885
8820
  session_id?: string | undefined;
6886
8821
  }, {
8822
+ id: string;
6887
8823
  canonical: string[];
6888
8824
  drifted: string[];
6889
- id: string;
6890
8825
  ts: number;
6891
8826
  schema_version: 1;
6892
8827
  kind: "fabric-event";
6893
- event_type: "install_diff_applied";
6894
8828
  applied: string[];
8829
+ event_type: "install_diff_applied";
6895
8830
  correlation_id?: string | undefined;
6896
8831
  session_id?: string | undefined;
6897
8832
  }>, z.ZodObject<{
@@ -7179,7 +9114,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7179
9114
  written_stable_ids: string[];
7180
9115
  correlation_id?: string | undefined;
7181
9116
  session_id?: string | undefined;
7182
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
9117
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
7183
9118
  }, {
7184
9119
  id: string;
7185
9120
  ts: number;
@@ -7190,7 +9125,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7190
9125
  written_stable_ids: string[];
7191
9126
  correlation_id?: string | undefined;
7192
9127
  session_id?: string | undefined;
7193
- source?: "doctor_fix" | "init" | "scan" | "doctor-rescan" | undefined;
9128
+ source?: "init" | "doctor_fix" | "scan" | "doctor-rescan" | undefined;
7194
9129
  }>, z.ZodObject<{
7195
9130
  event_type: z.ZodLiteral<"knowledge_proposed">;
7196
9131
  stable_id: z.ZodOptional<z.ZodString>;
@@ -7731,8 +9666,8 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7731
9666
  correlation_id: z.ZodOptional<z.ZodString>;
7732
9667
  session_id: z.ZodOptional<z.ZodString>;
7733
9668
  }, "strip", z.ZodTypeAny, {
7734
- pending_path: string;
7735
9669
  id: string;
9670
+ pending_path: string;
7736
9671
  reason: string;
7737
9672
  ts: number;
7738
9673
  schema_version: 1;
@@ -7742,8 +9677,8 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7742
9677
  correlation_id?: string | undefined;
7743
9678
  session_id?: string | undefined;
7744
9679
  }, {
7745
- pending_path: string;
7746
9680
  id: string;
9681
+ pending_path: string;
7747
9682
  reason: string;
7748
9683
  ts: number;
7749
9684
  schema_version: 1;
@@ -7855,29 +9790,29 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7855
9790
  event_type: z.ZodLiteral<"assistant_turn_observed">;
7856
9791
  kb_line_raw: z.ZodNullable<z.ZodString>;
7857
9792
  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">>;
9793
+ cite_tags: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEnum<["applied", "dismissed", "none"]>, "none" | "applied" | "dismissed", unknown>, "many">>;
7859
9794
  cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
7860
9795
  operators: z.ZodArray<z.ZodObject<{
7861
9796
  kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
7862
9797
  target: z.ZodString;
7863
9798
  }, "strip", z.ZodTypeAny, {
7864
- kind: "require" | "edit" | "not_edit" | "forbid";
7865
9799
  target: string;
7866
- }, {
7867
9800
  kind: "require" | "edit" | "not_edit" | "forbid";
9801
+ }, {
7868
9802
  target: string;
9803
+ kind: "require" | "edit" | "not_edit" | "forbid";
7869
9804
  }>, "many">;
7870
9805
  skip_reason: z.ZodNullable<z.ZodString>;
7871
9806
  }, "strip", z.ZodTypeAny, {
7872
9807
  operators: {
7873
- kind: "require" | "edit" | "not_edit" | "forbid";
7874
9808
  target: string;
9809
+ kind: "require" | "edit" | "not_edit" | "forbid";
7875
9810
  }[];
7876
9811
  skip_reason: string | null;
7877
9812
  }, {
7878
9813
  operators: {
7879
- kind: "require" | "edit" | "not_edit" | "forbid";
7880
9814
  target: string;
9815
+ kind: "require" | "edit" | "not_edit" | "forbid";
7881
9816
  }[];
7882
9817
  skip_reason: string | null;
7883
9818
  }>, "many">>;
@@ -7900,11 +9835,11 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7900
9835
  timestamp: string;
7901
9836
  kb_line_raw: string | null;
7902
9837
  cite_ids: string[];
7903
- cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
9838
+ cite_tags: ("none" | "applied" | "dismissed")[];
7904
9839
  cite_commitments: {
7905
9840
  operators: {
7906
- kind: "require" | "edit" | "not_edit" | "forbid";
7907
9841
  target: string;
9842
+ kind: "require" | "edit" | "not_edit" | "forbid";
7908
9843
  }[];
7909
9844
  skip_reason: string | null;
7910
9845
  }[];
@@ -7925,11 +9860,11 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
7925
9860
  correlation_id?: string | undefined;
7926
9861
  session_id?: string | undefined;
7927
9862
  cite_ids?: string[] | undefined;
7928
- cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
9863
+ cite_tags?: unknown[] | undefined;
7929
9864
  cite_commitments?: {
7930
9865
  operators: {
7931
- kind: "require" | "edit" | "not_edit" | "forbid";
7932
9866
  target: string;
9867
+ kind: "require" | "edit" | "not_edit" | "forbid";
7933
9868
  }[];
7934
9869
  skip_reason: string | null;
7935
9870
  }[] | undefined;
@@ -8216,7 +10151,7 @@ type EventLedgerEventType = EventLedgerEvent["event_type"];
8216
10151
  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
10152
  type EventLedgerEventInput = EventLedgerEventInputFor<EventLedgerEvent>;
8218
10153
 
8219
- type CiteTag = "planned" | "recalled" | "chained-from" | "dismissed" | "none";
10154
+ type CiteTag = "applied" | "dismissed" | "none";
8220
10155
  type CiteCommitmentOperatorKind = "edit" | "not_edit" | "require" | "forbid";
8221
10156
  interface CiteCommitmentOperator {
8222
10157
  kind: CiteCommitmentOperatorKind;
@@ -8230,7 +10165,14 @@ interface ParseCiteLineResult {
8230
10165
  cite_ids: string[];
8231
10166
  cite_tags: CiteTag[];
8232
10167
  cite_commitments: CiteCommitment[];
10168
+ cite_stores: (string | null)[];
8233
10169
  }
10170
+ /**
10171
+ * Normalize a raw cite tag (with optional tail) into the 2-state vocabulary.
10172
+ * `applied` / `dismissed` / `none` pass through; the three legacy tags remap to
10173
+ * `applied`; anything else degrades to `none` (forward/back-compat tolerance).
10174
+ */
10175
+ declare function normalizeCiteTag(rawTag: string): CiteTag;
8234
10176
  /**
8235
10177
  * Parse one or more newline-separated `KB:` cite lines into structured
8236
10178
  * arrays matching the assistant_turn_observed event-ledger fields.
@@ -8246,4 +10188,4 @@ interface ParseCiteLineResult {
8246
10188
  */
8247
10189
  declare function parseCiteLine(raw: string): ParseCiteLineResult;
8248
10190
 
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 };
10191
+ 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 CrossStoreLintInput, type CrossStoreRefViolation, 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 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, 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 LocalKnowledgeId, type LockApprovedEvent, type LockDriftEvent, MCP_STORE_AWARE_CONTRACTS, MCP_STORE_AWARE_TOOLS, type McpConfigMigratedEvent, type McpEventLedgerEvent, 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 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, ResolverNotImplementedError, 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 ScopeCoordinate, type SecretFinding, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, 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, 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, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, 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, 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, localKnowledgeIdSchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, mountedStoreSchema, normalizeCiteTag, onboardSlotSchema, parityCapabilitySchema, parityClientExpectationSchema, parityClientSchema, parityMatrixSchema, paritySurfaceSchema, parseCiteLine, parseGlobalRef, pendingAutoArchivedEventSchema, projectRootGoldenCaseSchema, projectRootGoldenFileSchema, projectRootResolutionSchema, projectRootSignalSchema, projectRootSignalsSchema, readBindingsSnapshot, readKnowledgeAcrossStores, readSetEntrySchema, readSetGoldenCaseSchema, readSetGoldenFileSchema, readStoreIdentity, reapplyCompletedEventSchema, recognizeStoreDir, redactSecrets, relevanceMigrationRunEventSchema, requiredStoreEntrySchema, resolveCandidates, resolveStoreQualifiedId, resolvedBindingsSnapshotSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, scanForSecrets, scopeCoordinateSchema, scopeRoot, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, storeAwareEntrySchema, storeCountersSchema, storeIdentitySchema, storeKnowledgeTypeDir, storeReadSetSchema, storeRelativePath, storeResolveInputSchema, storeResolverWarningCodeSchema, storeResolverWarningSchema, storeUuidSchema, uidSchema, withDerivedAgentsMetaNodeDefaults, writeBindingsSnapshot, writeTargetSchema, writtenToStoreSchema };