@fenglimg/fabric-shared 2.2.0-rc.1 → 2.2.0-rc.11

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 (25) hide show
  1. package/dist/chunk-2GLIAZ5M.js +251 -0
  2. package/dist/{chunk-JEXTOQVV.js → chunk-5AKCRBKJ.js} +541 -401
  3. package/dist/{chunk-7TZ2PMVH.js → chunk-AQMDXC6J.js} +471 -519
  4. package/dist/chunk-BDJQIOQO.js +206 -0
  5. package/dist/chunk-C7WZPYZE.js +129 -0
  6. package/dist/{chunk-3SZRB42B.js → chunk-O6GIHZF3.js} +14 -0
  7. package/dist/errors/index.d.ts +12 -1
  8. package/dist/errors/index.js +9 -3
  9. package/dist/i18n/index.d.ts +29 -23
  10. package/dist/i18n/index.js +7 -3
  11. package/dist/{index-J3Xn5h2J.d.ts → index-D_gT1CEA.d.ts} +108 -34
  12. package/dist/index.d.ts +829 -582
  13. package/dist/index.js +1495 -955
  14. package/dist/node/atomic-write.js +6 -106
  15. package/dist/node/mcp-payload-guard.js +1 -1
  16. package/dist/node.d.ts +10 -1
  17. package/dist/node.js +32 -1
  18. package/dist/schemas/api-contracts.d.ts +290 -118
  19. package/dist/schemas/api-contracts.js +3 -3
  20. package/dist/templates/bootstrap-canonical.d.ts +50 -23
  21. package/dist/templates/bootstrap-canonical.js +12 -9
  22. package/dist/types/index.d.ts +1 -1
  23. package/dist/types-qg4xXVuT.d.ts +8 -0
  24. package/package.json +3 -2
  25. package/dist/chunk-TX2XZ7AW.js +0 -102
package/dist/schemas/api-contracts.d.ts CHANGED
@@ -1,19 +1,23 @@
1
1
  import { z } from 'zod';
2
+ import { L as Locale } from '../types-qg4xXVuT.js';
2
3
 
3
4
  declare const structuredWarningSchema: z.ZodObject<{
4
5
  code: z.ZodString;
5
6
  file: z.ZodString;
6
7
  line: z.ZodOptional<z.ZodNumber>;
8
+ message: z.ZodOptional<z.ZodString>;
7
9
  action_hint: z.ZodString;
8
10
  }, "strip", z.ZodTypeAny, {
9
11
  code: string;
10
12
  file: string;
11
13
  action_hint: string;
14
+ message?: string | undefined;
12
15
  line?: number | undefined;
13
16
  }, {
14
17
  code: string;
15
18
  file: string;
16
19
  action_hint: string;
20
+ message?: string | undefined;
17
21
  line?: number | undefined;
18
22
  }>;
19
23
  declare const planContextInputSchema: z.ZodObject<{
@@ -56,17 +60,14 @@ declare const planContextOutputSchema: z.ZodObject<{
56
60
  requirement_profile: z.ZodObject<{
57
61
  target_path: z.ZodString;
58
62
  known_tech: z.ZodArray<z.ZodString, "many">;
59
- user_intent: z.ZodString;
60
63
  detected_entities: z.ZodArray<z.ZodString, "many">;
61
64
  }, "strip", z.ZodTypeAny, {
62
65
  target_path: string;
63
66
  known_tech: string[];
64
- user_intent: string;
65
67
  detected_entities: string[];
66
68
  }, {
67
69
  target_path: string;
68
70
  known_tech: string[];
69
- user_intent: string;
70
71
  detected_entities: string[];
71
72
  }>;
72
73
  }, "strip", z.ZodTypeAny, {
@@ -74,7 +75,6 @@ declare const planContextOutputSchema: z.ZodObject<{
74
75
  requirement_profile: {
75
76
  target_path: string;
76
77
  known_tech: string[];
77
- user_intent: string;
78
78
  detected_entities: string[];
79
79
  };
80
80
  }, {
@@ -82,10 +82,10 @@ declare const planContextOutputSchema: z.ZodObject<{
82
82
  requirement_profile: {
83
83
  target_path: string;
84
84
  known_tech: string[];
85
- user_intent: string;
86
85
  detected_entities: string[];
87
86
  };
88
87
  }>, "many">;
88
+ intent: z.ZodOptional<z.ZodString>;
89
89
  candidates: z.ZodArray<z.ZodObject<{
90
90
  stable_id: z.ZodString;
91
91
  description: z.ZodObject<{
@@ -140,6 +140,7 @@ declare const planContextOutputSchema: z.ZodObject<{
140
140
  tags?: string[] | undefined;
141
141
  related?: string[] | undefined;
142
142
  }>;
143
+ always_active: z.ZodOptional<z.ZodBoolean>;
143
144
  }, "strip", z.ZodTypeAny, {
144
145
  description: {
145
146
  summary: string;
@@ -160,6 +161,7 @@ declare const planContextOutputSchema: z.ZodObject<{
160
161
  related?: string[] | undefined;
161
162
  };
162
163
  stable_id: string;
164
+ always_active?: boolean | undefined;
163
165
  }, {
164
166
  description: {
165
167
  summary: string;
@@ -180,6 +182,7 @@ declare const planContextOutputSchema: z.ZodObject<{
180
182
  related?: string[] | undefined;
181
183
  };
182
184
  stable_id: string;
185
+ always_active?: boolean | undefined;
183
186
  }>, "many">;
184
187
  omitted_candidate_count: z.ZodOptional<z.ZodNumber>;
185
188
  preflight_diagnostics: z.ZodArray<z.ZodObject<{
@@ -205,28 +208,31 @@ declare const planContextOutputSchema: z.ZodObject<{
205
208
  code: z.ZodString;
206
209
  file: z.ZodString;
207
210
  line: z.ZodOptional<z.ZodNumber>;
211
+ message: z.ZodOptional<z.ZodString>;
208
212
  action_hint: z.ZodString;
209
213
  }, "strip", z.ZodTypeAny, {
210
214
  code: string;
211
215
  file: string;
212
216
  action_hint: string;
217
+ message?: string | undefined;
213
218
  line?: number | undefined;
214
219
  }, {
215
220
  code: string;
216
221
  file: string;
217
222
  action_hint: string;
223
+ message?: string | undefined;
218
224
  line?: number | undefined;
219
225
  }>, "many">>;
220
226
  auto_healed: z.ZodOptional<z.ZodBoolean>;
221
227
  previous_revision_hash: z.ZodOptional<z.ZodString>;
222
228
  redirects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
229
+ related_appended: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
223
230
  }, "strip", z.ZodTypeAny, {
224
231
  entries: {
225
232
  path: string;
226
233
  requirement_profile: {
227
234
  target_path: string;
228
235
  known_tech: string[];
229
- user_intent: string;
230
236
  detected_entities: string[];
231
237
  };
232
238
  }[];
@@ -253,6 +259,7 @@ declare const planContextOutputSchema: z.ZodObject<{
253
259
  related?: string[] | undefined;
254
260
  };
255
261
  stable_id: string;
262
+ always_active?: boolean | undefined;
256
263
  }[];
257
264
  preflight_diagnostics: {
258
265
  code: "missing_description" | "empty_shell_suppressed";
@@ -261,23 +268,25 @@ declare const planContextOutputSchema: z.ZodObject<{
261
268
  path?: string | undefined;
262
269
  stable_ids?: string[] | undefined;
263
270
  }[];
271
+ intent?: string | undefined;
264
272
  omitted_candidate_count?: number | undefined;
265
273
  warnings?: {
266
274
  code: string;
267
275
  file: string;
268
276
  action_hint: string;
277
+ message?: string | undefined;
269
278
  line?: number | undefined;
270
279
  }[] | undefined;
271
280
  auto_healed?: boolean | undefined;
272
281
  previous_revision_hash?: string | undefined;
273
282
  redirects?: Record<string, string> | undefined;
283
+ related_appended?: Record<string, string> | undefined;
274
284
  }, {
275
285
  entries: {
276
286
  path: string;
277
287
  requirement_profile: {
278
288
  target_path: string;
279
289
  known_tech: string[];
280
- user_intent: string;
281
290
  detected_entities: string[];
282
291
  };
283
292
  }[];
@@ -304,6 +313,7 @@ declare const planContextOutputSchema: z.ZodObject<{
304
313
  related?: string[] | undefined;
305
314
  };
306
315
  stable_id: string;
316
+ always_active?: boolean | undefined;
307
317
  }[];
308
318
  preflight_diagnostics: {
309
319
  code: "missing_description" | "empty_shell_suppressed";
@@ -312,16 +322,19 @@ declare const planContextOutputSchema: z.ZodObject<{
312
322
  path?: string | undefined;
313
323
  stable_ids?: string[] | undefined;
314
324
  }[];
325
+ intent?: string | undefined;
315
326
  omitted_candidate_count?: number | undefined;
316
327
  warnings?: {
317
328
  code: string;
318
329
  file: string;
319
330
  action_hint: string;
331
+ message?: string | undefined;
320
332
  line?: number | undefined;
321
333
  }[] | undefined;
322
334
  auto_healed?: boolean | undefined;
323
335
  previous_revision_hash?: string | undefined;
324
336
  redirects?: Record<string, string> | undefined;
337
+ related_appended?: Record<string, string> | undefined;
325
338
  }>;
326
339
  declare const planContextAnnotations: {
327
340
  readonly readOnlyHint: true;
@@ -335,16 +348,19 @@ declare const planContextHintNarrowEntrySchema: z.ZodObject<{
335
348
  type: z.ZodString;
336
349
  maturity: z.ZodString;
337
350
  summary: z.ZodString;
351
+ must_read_if: z.ZodOptional<z.ZodString>;
338
352
  }, "strip", z.ZodTypeAny, {
339
353
  type: string;
340
354
  id: string;
341
355
  summary: string;
342
356
  maturity: string;
357
+ must_read_if?: string | undefined;
343
358
  }, {
344
359
  type: string;
345
360
  id: string;
346
361
  summary: string;
347
362
  maturity: string;
363
+ must_read_if?: string | undefined;
348
364
  }>;
349
365
  declare const planContextHintOutputSchema: z.ZodObject<{
350
366
  version: z.ZodLiteral<1>;
@@ -355,16 +371,19 @@ declare const planContextHintOutputSchema: z.ZodObject<{
355
371
  type: z.ZodString;
356
372
  maturity: z.ZodString;
357
373
  summary: z.ZodString;
374
+ must_read_if: z.ZodOptional<z.ZodString>;
358
375
  }, "strip", z.ZodTypeAny, {
359
376
  type: string;
360
377
  id: string;
361
378
  summary: string;
362
379
  maturity: string;
380
+ must_read_if?: string | undefined;
363
381
  }, {
364
382
  type: string;
365
383
  id: string;
366
384
  summary: string;
367
385
  maturity: string;
386
+ must_read_if?: string | undefined;
368
387
  }>, "many">;
369
388
  broad_count: z.ZodNumber;
370
389
  }, "strip", z.ZodTypeAny, {
@@ -373,6 +392,7 @@ declare const planContextHintOutputSchema: z.ZodObject<{
373
392
  id: string;
374
393
  summary: string;
375
394
  maturity: string;
395
+ must_read_if?: string | undefined;
376
396
  }[];
377
397
  target_paths: string[];
378
398
  revision_hash: string;
@@ -384,6 +404,7 @@ declare const planContextHintOutputSchema: z.ZodObject<{
384
404
  id: string;
385
405
  summary: string;
386
406
  maturity: string;
407
+ must_read_if?: string | undefined;
387
408
  }[];
388
409
  target_paths: string[];
389
410
  revision_hash: string;
@@ -393,7 +414,7 @@ declare const planContextHintOutputSchema: z.ZodObject<{
393
414
  declare const knowledgeSectionsInputSchema: z.ZodObject<{
394
415
  selection_token: z.ZodString;
395
416
  ai_selected_stable_ids: z.ZodArray<z.ZodString, "many">;
396
- ai_selection_reasons: z.ZodRecord<z.ZodString, z.ZodString>;
417
+ ai_selection_reasons: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
397
418
  correlation_id: z.ZodOptional<z.ZodString>;
398
419
  session_id: z.ZodOptional<z.ZodString>;
399
420
  client_hash: z.ZodOptional<z.ZodString>;
@@ -407,42 +428,39 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
407
428
  }, {
408
429
  selection_token: string;
409
430
  ai_selected_stable_ids: string[];
410
- ai_selection_reasons: Record<string, string>;
411
431
  client_hash?: string | undefined;
412
432
  correlation_id?: string | undefined;
413
433
  session_id?: string | undefined;
434
+ ai_selection_reasons?: Record<string, string> | undefined;
414
435
  }>;
415
436
  declare const knowledgeSectionsOutputSchema: z.ZodObject<{
416
437
  revision_hash: z.ZodString;
417
438
  selected_stable_ids: z.ZodArray<z.ZodString, "many">;
418
439
  rules: z.ZodArray<z.ZodObject<{
419
440
  stable_id: z.ZodString;
420
- level: z.ZodEnum<["L0", "L1", "L2"]>;
421
441
  path: z.ZodString;
422
442
  body: z.ZodString;
423
443
  }, "strip", z.ZodTypeAny, {
424
444
  path: string;
425
445
  stable_id: string;
426
- level: "L0" | "L1" | "L2";
427
446
  body: string;
428
447
  }, {
429
448
  path: string;
430
449
  stable_id: string;
431
- level: "L0" | "L1" | "L2";
432
450
  body: string;
433
451
  }>, "many">;
434
452
  diagnostics: z.ZodArray<z.ZodObject<{
435
- code: z.ZodLiteral<"missing_knowledge_metadata">;
453
+ code: z.ZodEnum<["missing_knowledge_metadata", "unresolved_selected_id"]>;
436
454
  severity: z.ZodLiteral<"warn">;
437
455
  stable_id: z.ZodString;
438
456
  message: z.ZodString;
439
457
  }, "strip", z.ZodTypeAny, {
440
- code: "missing_knowledge_metadata";
458
+ code: "missing_knowledge_metadata" | "unresolved_selected_id";
441
459
  message: string;
442
460
  stable_id: string;
443
461
  severity: "warn";
444
462
  }, {
445
- code: "missing_knowledge_metadata";
463
+ code: "missing_knowledge_metadata" | "unresolved_selected_id";
446
464
  message: string;
447
465
  stable_id: string;
448
466
  severity: "warn";
@@ -458,16 +476,19 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
458
476
  code: z.ZodString;
459
477
  file: z.ZodString;
460
478
  line: z.ZodOptional<z.ZodNumber>;
479
+ message: z.ZodOptional<z.ZodString>;
461
480
  action_hint: z.ZodString;
462
481
  }, "strip", z.ZodTypeAny, {
463
482
  code: string;
464
483
  file: string;
465
484
  action_hint: string;
485
+ message?: string | undefined;
466
486
  line?: number | undefined;
467
487
  }, {
468
488
  code: string;
469
489
  file: string;
470
490
  action_hint: string;
491
+ message?: string | undefined;
471
492
  line?: number | undefined;
472
493
  }>, "many">>;
473
494
  }, "strip", z.ZodTypeAny, {
@@ -476,11 +497,10 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
476
497
  rules: {
477
498
  path: string;
478
499
  stable_id: string;
479
- level: "L0" | "L1" | "L2";
480
500
  body: string;
481
501
  }[];
482
502
  diagnostics: {
483
- code: "missing_knowledge_metadata";
503
+ code: "missing_knowledge_metadata" | "unresolved_selected_id";
484
504
  message: string;
485
505
  stable_id: string;
486
506
  severity: "warn";
@@ -489,6 +509,7 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
489
509
  code: string;
490
510
  file: string;
491
511
  action_hint: string;
512
+ message?: string | undefined;
492
513
  line?: number | undefined;
493
514
  }[] | undefined;
494
515
  redirect_to?: Record<string, string> | {
@@ -500,11 +521,10 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
500
521
  rules: {
501
522
  path: string;
502
523
  stable_id: string;
503
- level: "L0" | "L1" | "L2";
504
524
  body: string;
505
525
  }[];
506
526
  diagnostics: {
507
- code: "missing_knowledge_metadata";
527
+ code: "missing_knowledge_metadata" | "unresolved_selected_id";
508
528
  message: string;
509
529
  stable_id: string;
510
530
  severity: "warn";
@@ -513,6 +533,7 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
513
533
  code: string;
514
534
  file: string;
515
535
  action_hint: string;
536
+ message?: string | undefined;
516
537
  line?: number | undefined;
517
538
  }[] | undefined;
518
539
  redirect_to?: Record<string, string> | {
@@ -524,7 +545,7 @@ declare const knowledgeSectionsAnnotations: {
524
545
  readonly idempotentHint: true;
525
546
  readonly destructiveHint: false;
526
547
  readonly openWorldHint: false;
527
- readonly title: "Filter rule sections";
548
+ readonly title: "Fetch knowledge entry bodies";
528
549
  };
529
550
  declare const recallInputSchema: z.ZodObject<{
530
551
  paths: z.ZodArray<z.ZodString, "many">;
@@ -566,23 +587,19 @@ declare const recallInputSchema: z.ZodObject<{
566
587
  declare const recallOutputSchema: z.ZodObject<{
567
588
  revision_hash: z.ZodString;
568
589
  stale: z.ZodBoolean;
569
- selection_token: z.ZodString;
570
590
  entries: z.ZodArray<z.ZodObject<{
571
591
  path: z.ZodString;
572
592
  requirement_profile: z.ZodObject<{
573
593
  target_path: z.ZodString;
574
594
  known_tech: z.ZodArray<z.ZodString, "many">;
575
- user_intent: z.ZodString;
576
595
  detected_entities: z.ZodArray<z.ZodString, "many">;
577
596
  }, "strip", z.ZodTypeAny, {
578
597
  target_path: string;
579
598
  known_tech: string[];
580
- user_intent: string;
581
599
  detected_entities: string[];
582
600
  }, {
583
601
  target_path: string;
584
602
  known_tech: string[];
585
- user_intent: string;
586
603
  detected_entities: string[];
587
604
  }>;
588
605
  }, "strip", z.ZodTypeAny, {
@@ -590,7 +607,6 @@ declare const recallOutputSchema: z.ZodObject<{
590
607
  requirement_profile: {
591
608
  target_path: string;
592
609
  known_tech: string[];
593
- user_intent: string;
594
610
  detected_entities: string[];
595
611
  };
596
612
  }, {
@@ -598,10 +614,10 @@ declare const recallOutputSchema: z.ZodObject<{
598
614
  requirement_profile: {
599
615
  target_path: string;
600
616
  known_tech: string[];
601
- user_intent: string;
602
617
  detected_entities: string[];
603
618
  };
604
619
  }>, "many">;
620
+ intent: z.ZodOptional<z.ZodString>;
605
621
  candidates: z.ZodArray<z.ZodObject<{
606
622
  stable_id: z.ZodString;
607
623
  description: z.ZodObject<{
@@ -656,6 +672,7 @@ declare const recallOutputSchema: z.ZodObject<{
656
672
  tags?: string[] | undefined;
657
673
  related?: string[] | undefined;
658
674
  }>;
675
+ always_active: z.ZodOptional<z.ZodBoolean>;
659
676
  }, "strip", z.ZodTypeAny, {
660
677
  description: {
661
678
  summary: string;
@@ -676,6 +693,7 @@ declare const recallOutputSchema: z.ZodObject<{
676
693
  related?: string[] | undefined;
677
694
  };
678
695
  stable_id: string;
696
+ always_active?: boolean | undefined;
679
697
  }, {
680
698
  description: {
681
699
  summary: string;
@@ -696,6 +714,30 @@ declare const recallOutputSchema: z.ZodObject<{
696
714
  related?: string[] | undefined;
697
715
  };
698
716
  stable_id: string;
717
+ always_active?: boolean | undefined;
718
+ }>, "many">;
719
+ paths: z.ZodArray<z.ZodObject<{
720
+ stable_id: z.ZodString;
721
+ path: z.ZodString;
722
+ store: z.ZodOptional<z.ZodObject<{
723
+ alias: z.ZodString;
724
+ }, "strip", z.ZodTypeAny, {
725
+ alias: string;
726
+ }, {
727
+ alias: string;
728
+ }>>;
729
+ }, "strip", z.ZodTypeAny, {
730
+ path: string;
731
+ stable_id: string;
732
+ store?: {
733
+ alias: string;
734
+ } | undefined;
735
+ }, {
736
+ path: string;
737
+ stable_id: string;
738
+ store?: {
739
+ alias: string;
740
+ } | undefined;
699
741
  }>, "many">;
700
742
  omitted_candidate_count: z.ZodOptional<z.ZodNumber>;
701
743
  preflight_diagnostics: z.ZodArray<z.ZodObject<{
@@ -717,83 +759,49 @@ declare const recallOutputSchema: z.ZodObject<{
717
759
  path?: string | undefined;
718
760
  stable_ids?: string[] | undefined;
719
761
  }>, "many">;
720
- rules: z.ZodArray<z.ZodObject<{
721
- stable_id: z.ZodString;
722
- level: z.ZodEnum<["L0", "L1", "L2"]>;
723
- path: z.ZodString;
724
- body: z.ZodString;
725
- }, "strip", z.ZodTypeAny, {
726
- path: string;
727
- stable_id: string;
728
- level: "L0" | "L1" | "L2";
729
- body: string;
730
- }, {
731
- path: string;
732
- stable_id: string;
733
- level: "L0" | "L1" | "L2";
734
- body: string;
735
- }>, "many">;
736
- selected_stable_ids: z.ZodArray<z.ZodString, "many">;
737
- diagnostics: z.ZodArray<z.ZodObject<{
738
- code: z.ZodLiteral<"missing_knowledge_metadata">;
739
- severity: z.ZodLiteral<"warn">;
740
- stable_id: z.ZodString;
741
- message: z.ZodString;
742
- }, "strip", z.ZodTypeAny, {
743
- code: "missing_knowledge_metadata";
744
- message: string;
745
- stable_id: string;
746
- severity: "warn";
747
- }, {
748
- code: "missing_knowledge_metadata";
749
- message: string;
750
- stable_id: string;
751
- severity: "warn";
752
- }>, "many">;
753
762
  warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
754
763
  code: z.ZodString;
755
764
  file: z.ZodString;
756
765
  line: z.ZodOptional<z.ZodNumber>;
766
+ message: z.ZodOptional<z.ZodString>;
757
767
  action_hint: z.ZodString;
758
768
  }, "strip", z.ZodTypeAny, {
759
769
  code: string;
760
770
  file: string;
761
771
  action_hint: string;
772
+ message?: string | undefined;
762
773
  line?: number | undefined;
763
774
  }, {
764
775
  code: string;
765
776
  file: string;
766
777
  action_hint: string;
778
+ message?: string | undefined;
767
779
  line?: number | undefined;
768
780
  }>, "many">>;
769
781
  auto_healed: z.ZodOptional<z.ZodBoolean>;
770
782
  previous_revision_hash: z.ZodOptional<z.ZodString>;
771
783
  redirects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
784
+ related_appended: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
772
785
  directive: z.ZodString;
773
786
  next_steps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
774
- truncation: z.ZodOptional<z.ZodObject<{
775
- omitted_candidate_count: z.ZodNumber;
776
- returned_candidate_count: z.ZodNumber;
777
- }, "strip", z.ZodTypeAny, {
778
- omitted_candidate_count: number;
779
- returned_candidate_count: number;
780
- }, {
781
- omitted_candidate_count: number;
782
- returned_candidate_count: number;
783
- }>>;
784
787
  }, "strip", z.ZodTypeAny, {
785
788
  entries: {
786
789
  path: string;
787
790
  requirement_profile: {
788
791
  target_path: string;
789
792
  known_tech: string[];
790
- user_intent: string;
791
793
  detected_entities: string[];
792
794
  };
793
795
  }[];
794
796
  stale: boolean;
797
+ paths: {
798
+ path: string;
799
+ stable_id: string;
800
+ store?: {
801
+ alias: string;
802
+ } | undefined;
803
+ }[];
795
804
  revision_hash: string;
796
- selection_token: string;
797
805
  candidates: {
798
806
  description: {
799
807
  summary: string;
@@ -814,6 +822,7 @@ declare const recallOutputSchema: z.ZodObject<{
814
822
  related?: string[] | undefined;
815
823
  };
816
824
  stable_id: string;
825
+ always_active?: boolean | undefined;
817
826
  }[];
818
827
  preflight_diagnostics: {
819
828
  code: "missing_description" | "empty_shell_suppressed";
@@ -822,48 +831,39 @@ declare const recallOutputSchema: z.ZodObject<{
822
831
  path?: string | undefined;
823
832
  stable_ids?: string[] | undefined;
824
833
  }[];
825
- selected_stable_ids: string[];
826
- rules: {
827
- path: string;
828
- stable_id: string;
829
- level: "L0" | "L1" | "L2";
830
- body: string;
831
- }[];
832
- diagnostics: {
833
- code: "missing_knowledge_metadata";
834
- message: string;
835
- stable_id: string;
836
- severity: "warn";
837
- }[];
838
834
  directive: string;
835
+ intent?: string | undefined;
839
836
  omitted_candidate_count?: number | undefined;
840
837
  warnings?: {
841
838
  code: string;
842
839
  file: string;
843
840
  action_hint: string;
841
+ message?: string | undefined;
844
842
  line?: number | undefined;
845
843
  }[] | undefined;
846
844
  auto_healed?: boolean | undefined;
847
845
  previous_revision_hash?: string | undefined;
848
846
  redirects?: Record<string, string> | undefined;
847
+ related_appended?: Record<string, string> | undefined;
849
848
  next_steps?: string[] | undefined;
850
- truncation?: {
851
- omitted_candidate_count: number;
852
- returned_candidate_count: number;
853
- } | undefined;
854
849
  }, {
855
850
  entries: {
856
851
  path: string;
857
852
  requirement_profile: {
858
853
  target_path: string;
859
854
  known_tech: string[];
860
- user_intent: string;
861
855
  detected_entities: string[];
862
856
  };
863
857
  }[];
864
858
  stale: boolean;
859
+ paths: {
860
+ path: string;
861
+ stable_id: string;
862
+ store?: {
863
+ alias: string;
864
+ } | undefined;
865
+ }[];
865
866
  revision_hash: string;
866
- selection_token: string;
867
867
  candidates: {
868
868
  description: {
869
869
  summary: string;
@@ -884,6 +884,7 @@ declare const recallOutputSchema: z.ZodObject<{
884
884
  related?: string[] | undefined;
885
885
  };
886
886
  stable_id: string;
887
+ always_active?: boolean | undefined;
887
888
  }[];
888
889
  preflight_diagnostics: {
889
890
  code: "missing_description" | "empty_shell_suppressed";
@@ -892,35 +893,21 @@ declare const recallOutputSchema: z.ZodObject<{
892
893
  path?: string | undefined;
893
894
  stable_ids?: string[] | undefined;
894
895
  }[];
895
- selected_stable_ids: string[];
896
- rules: {
897
- path: string;
898
- stable_id: string;
899
- level: "L0" | "L1" | "L2";
900
- body: string;
901
- }[];
902
- diagnostics: {
903
- code: "missing_knowledge_metadata";
904
- message: string;
905
- stable_id: string;
906
- severity: "warn";
907
- }[];
908
896
  directive: string;
897
+ intent?: string | undefined;
909
898
  omitted_candidate_count?: number | undefined;
910
899
  warnings?: {
911
900
  code: string;
912
901
  file: string;
913
902
  action_hint: string;
903
+ message?: string | undefined;
914
904
  line?: number | undefined;
915
905
  }[] | undefined;
916
906
  auto_healed?: boolean | undefined;
917
907
  previous_revision_hash?: string | undefined;
918
908
  redirects?: Record<string, string> | undefined;
909
+ related_appended?: Record<string, string> | undefined;
919
910
  next_steps?: string[] | undefined;
920
- truncation?: {
921
- omitted_candidate_count: number;
922
- returned_candidate_count: number;
923
- } | undefined;
924
911
  }>;
925
912
  declare const recallAnnotations: {
926
913
  readonly readOnlyHint: true;
@@ -964,16 +951,19 @@ declare const archiveScanOutputSchema: z.ZodObject<{
964
951
  code: z.ZodString;
965
952
  file: z.ZodString;
966
953
  line: z.ZodOptional<z.ZodNumber>;
954
+ message: z.ZodOptional<z.ZodString>;
967
955
  action_hint: z.ZodString;
968
956
  }, "strip", z.ZodTypeAny, {
969
957
  code: string;
970
958
  file: string;
971
959
  action_hint: string;
960
+ message?: string | undefined;
972
961
  line?: number | undefined;
973
962
  }, {
974
963
  code: string;
975
964
  file: string;
976
965
  action_hint: string;
966
+ message?: string | undefined;
977
967
  line?: number | undefined;
978
968
  }>, "many">>;
979
969
  }, "strip", z.ZodTypeAny, {
@@ -989,6 +979,7 @@ declare const archiveScanOutputSchema: z.ZodObject<{
989
979
  code: string;
990
980
  file: string;
991
981
  action_hint: string;
982
+ message?: string | undefined;
992
983
  line?: number | undefined;
993
984
  }[] | undefined;
994
985
  }, {
@@ -1004,6 +995,7 @@ declare const archiveScanOutputSchema: z.ZodObject<{
1004
995
  code: string;
1005
996
  file: string;
1006
997
  action_hint: string;
998
+ message?: string | undefined;
1007
999
  line?: number | undefined;
1008
1000
  }[] | undefined;
1009
1001
  }>;
@@ -1018,14 +1010,15 @@ type ArchiveScanInput = z.infer<typeof archiveScanInputSchema>;
1018
1010
  type ArchiveScanOutput = z.infer<typeof archiveScanOutputSchema>;
1019
1011
  declare const ProposedReasonSchema: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1020
1012
  type ProposedReason = z.infer<typeof ProposedReasonSchema>;
1021
- declare const PROPOSED_REASON_DESCRIPTIONS: Record<ProposedReason, string>;
1013
+ declare const PROPOSED_REASON_DESCRIPTIONS_BY_LOCALE: Record<Locale, Record<ProposedReason, string>>;
1022
1014
  declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1023
- source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1015
+ source_sessions: z.ZodArray<z.ZodString, "many">;
1024
1016
  recent_paths: z.ZodArray<z.ZodString, "many">;
1025
1017
  user_messages_summary: z.ZodString;
1026
1018
  type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1027
1019
  slug: z.ZodString;
1028
1020
  layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1021
+ semantic_scope: z.ZodOptional<z.ZodString>;
1029
1022
  proposed_reason: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1030
1023
  session_context: z.ZodString;
1031
1024
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
@@ -1039,14 +1032,15 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1039
1032
  evidence_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1040
1033
  }, "strip", z.ZodTypeAny, {
1041
1034
  type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1035
+ source_sessions: string[];
1042
1036
  proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1043
1037
  session_context: string;
1044
1038
  recent_paths: string[];
1045
1039
  user_messages_summary: string;
1046
1040
  slug: string;
1041
+ semantic_scope?: string | undefined;
1047
1042
  relevance_scope?: "narrow" | "broad" | undefined;
1048
1043
  relevance_paths?: string[] | undefined;
1049
- source_sessions?: string[] | undefined;
1050
1044
  layer?: "personal" | "team" | undefined;
1051
1045
  intent_clues?: string[] | undefined;
1052
1046
  tech_stack?: string[] | undefined;
@@ -1057,14 +1051,15 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1057
1051
  evidence_paths?: string[] | undefined;
1058
1052
  }, {
1059
1053
  type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1054
+ source_sessions: string[];
1060
1055
  proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1061
1056
  session_context: string;
1062
1057
  recent_paths: string[];
1063
1058
  user_messages_summary: string;
1064
1059
  slug: string;
1060
+ semantic_scope?: string | undefined;
1065
1061
  relevance_scope?: "narrow" | "broad" | undefined;
1066
1062
  relevance_paths?: string[] | undefined;
1067
- source_sessions?: string[] | undefined;
1068
1063
  layer?: "personal" | "team" | undefined;
1069
1064
  intent_clues?: string[] | undefined;
1070
1065
  tech_stack?: string[] | undefined;
@@ -1075,14 +1070,15 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1075
1070
  evidence_paths?: string[] | undefined;
1076
1071
  }>, {
1077
1072
  type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1073
+ source_sessions: string[];
1078
1074
  proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1079
1075
  session_context: string;
1080
1076
  recent_paths: string[];
1081
1077
  user_messages_summary: string;
1082
1078
  slug: string;
1079
+ semantic_scope?: string | undefined;
1083
1080
  relevance_scope?: "narrow" | "broad" | undefined;
1084
1081
  relevance_paths?: string[] | undefined;
1085
- source_sessions?: string[] | undefined;
1086
1082
  layer?: "personal" | "team" | undefined;
1087
1083
  intent_clues?: string[] | undefined;
1088
1084
  tech_stack?: string[] | undefined;
@@ -1093,14 +1089,15 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1093
1089
  evidence_paths?: string[] | undefined;
1094
1090
  }, {
1095
1091
  type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1092
+ source_sessions: string[];
1096
1093
  proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1097
1094
  session_context: string;
1098
1095
  recent_paths: string[];
1099
1096
  user_messages_summary: string;
1100
1097
  slug: string;
1098
+ semantic_scope?: string | undefined;
1101
1099
  relevance_scope?: "narrow" | "broad" | undefined;
1102
1100
  relevance_paths?: string[] | undefined;
1103
- source_sessions?: string[] | undefined;
1104
1101
  layer?: "personal" | "team" | undefined;
1105
1102
  intent_clues?: string[] | undefined;
1106
1103
  tech_stack?: string[] | undefined;
@@ -1111,12 +1108,13 @@ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1111
1108
  evidence_paths?: string[] | undefined;
1112
1109
  }>;
1113
1110
  declare const FabExtractKnowledgeInputShape: {
1114
- source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1111
+ source_sessions: z.ZodArray<z.ZodString, "many">;
1115
1112
  recent_paths: z.ZodArray<z.ZodString, "many">;
1116
1113
  user_messages_summary: z.ZodString;
1117
1114
  type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1118
1115
  slug: z.ZodString;
1119
1116
  layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1117
+ semantic_scope: z.ZodOptional<z.ZodString>;
1120
1118
  proposed_reason: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1121
1119
  session_context: z.ZodString;
1122
1120
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
@@ -1137,16 +1135,19 @@ declare const FabExtractKnowledgeOutputSchema: z.ZodObject<{
1137
1135
  code: z.ZodString;
1138
1136
  file: z.ZodString;
1139
1137
  line: z.ZodOptional<z.ZodNumber>;
1138
+ message: z.ZodOptional<z.ZodString>;
1140
1139
  action_hint: z.ZodString;
1141
1140
  }, "strip", z.ZodTypeAny, {
1142
1141
  code: string;
1143
1142
  file: string;
1144
1143
  action_hint: string;
1144
+ message?: string | undefined;
1145
1145
  line?: number | undefined;
1146
1146
  }, {
1147
1147
  code: string;
1148
1148
  file: string;
1149
1149
  action_hint: string;
1150
+ message?: string | undefined;
1150
1151
  line?: number | undefined;
1151
1152
  }>, "many">>;
1152
1153
  }, "strip", z.ZodTypeAny, {
@@ -1156,6 +1157,7 @@ declare const FabExtractKnowledgeOutputSchema: z.ZodObject<{
1156
1157
  code: string;
1157
1158
  file: string;
1158
1159
  action_hint: string;
1160
+ message?: string | undefined;
1159
1161
  line?: number | undefined;
1160
1162
  }[] | undefined;
1161
1163
  }, {
@@ -1165,6 +1167,7 @@ declare const FabExtractKnowledgeOutputSchema: z.ZodObject<{
1165
1167
  code: string;
1166
1168
  file: string;
1167
1169
  action_hint: string;
1170
+ message?: string | undefined;
1168
1171
  line?: number | undefined;
1169
1172
  }[] | undefined;
1170
1173
  }>;
@@ -1262,45 +1265,55 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1262
1265
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1263
1266
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1264
1267
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1268
+ semantic_scope: z.ZodOptional<z.ZodString>;
1269
+ related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1265
1270
  }, "strip", z.ZodTypeAny, {
1271
+ semantic_scope?: string | undefined;
1266
1272
  relevance_scope?: "narrow" | "broad" | undefined;
1267
1273
  relevance_paths?: string[] | undefined;
1268
1274
  layer?: "personal" | "team" | undefined;
1269
1275
  summary?: string | undefined;
1270
1276
  maturity?: "draft" | "verified" | "proven" | undefined;
1271
1277
  tags?: string[] | undefined;
1278
+ related?: string[] | undefined;
1272
1279
  title?: string | undefined;
1273
1280
  }, {
1281
+ semantic_scope?: string | undefined;
1274
1282
  relevance_scope?: "narrow" | "broad" | undefined;
1275
1283
  relevance_paths?: string[] | undefined;
1276
1284
  layer?: "personal" | "team" | undefined;
1277
1285
  summary?: string | undefined;
1278
1286
  maturity?: "draft" | "verified" | "proven" | undefined;
1279
1287
  tags?: string[] | undefined;
1288
+ related?: string[] | undefined;
1280
1289
  title?: string | undefined;
1281
1290
  }>;
1282
1291
  }, "strip", z.ZodTypeAny, {
1283
1292
  pending_path: string;
1284
1293
  action: "modify";
1285
1294
  changes: {
1295
+ semantic_scope?: string | undefined;
1286
1296
  relevance_scope?: "narrow" | "broad" | undefined;
1287
1297
  relevance_paths?: string[] | undefined;
1288
1298
  layer?: "personal" | "team" | undefined;
1289
1299
  summary?: string | undefined;
1290
1300
  maturity?: "draft" | "verified" | "proven" | undefined;
1291
1301
  tags?: string[] | undefined;
1302
+ related?: string[] | undefined;
1292
1303
  title?: string | undefined;
1293
1304
  };
1294
1305
  }, {
1295
1306
  pending_path: string;
1296
1307
  action: "modify";
1297
1308
  changes: {
1309
+ semantic_scope?: string | undefined;
1298
1310
  relevance_scope?: "narrow" | "broad" | undefined;
1299
1311
  relevance_paths?: string[] | undefined;
1300
1312
  layer?: "personal" | "team" | undefined;
1301
1313
  summary?: string | undefined;
1302
1314
  maturity?: "draft" | "verified" | "proven" | undefined;
1303
1315
  tags?: string[] | undefined;
1316
+ related?: string[] | undefined;
1304
1317
  title?: string | undefined;
1305
1318
  };
1306
1319
  }>, z.ZodObject<{
@@ -1314,45 +1327,55 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1314
1327
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1315
1328
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1316
1329
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1330
+ semantic_scope: z.ZodOptional<z.ZodString>;
1331
+ related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1317
1332
  }, "strip", z.ZodTypeAny, {
1333
+ semantic_scope?: string | undefined;
1318
1334
  relevance_scope?: "narrow" | "broad" | undefined;
1319
1335
  relevance_paths?: string[] | undefined;
1320
1336
  layer?: "personal" | "team" | undefined;
1321
1337
  summary?: string | undefined;
1322
1338
  maturity?: "draft" | "verified" | "proven" | undefined;
1323
1339
  tags?: string[] | undefined;
1340
+ related?: string[] | undefined;
1324
1341
  title?: string | undefined;
1325
1342
  }, {
1343
+ semantic_scope?: string | undefined;
1326
1344
  relevance_scope?: "narrow" | "broad" | undefined;
1327
1345
  relevance_paths?: string[] | undefined;
1328
1346
  layer?: "personal" | "team" | undefined;
1329
1347
  summary?: string | undefined;
1330
1348
  maturity?: "draft" | "verified" | "proven" | undefined;
1331
1349
  tags?: string[] | undefined;
1350
+ related?: string[] | undefined;
1332
1351
  title?: string | undefined;
1333
1352
  }>;
1334
1353
  }, "strip", z.ZodTypeAny, {
1335
1354
  pending_path: string;
1336
1355
  action: "modify-content";
1337
1356
  changes: {
1357
+ semantic_scope?: string | undefined;
1338
1358
  relevance_scope?: "narrow" | "broad" | undefined;
1339
1359
  relevance_paths?: string[] | undefined;
1340
1360
  layer?: "personal" | "team" | undefined;
1341
1361
  summary?: string | undefined;
1342
1362
  maturity?: "draft" | "verified" | "proven" | undefined;
1343
1363
  tags?: string[] | undefined;
1364
+ related?: string[] | undefined;
1344
1365
  title?: string | undefined;
1345
1366
  };
1346
1367
  }, {
1347
1368
  pending_path: string;
1348
1369
  action: "modify-content";
1349
1370
  changes: {
1371
+ semantic_scope?: string | undefined;
1350
1372
  relevance_scope?: "narrow" | "broad" | undefined;
1351
1373
  relevance_paths?: string[] | undefined;
1352
1374
  layer?: "personal" | "team" | undefined;
1353
1375
  summary?: string | undefined;
1354
1376
  maturity?: "draft" | "verified" | "proven" | undefined;
1355
1377
  tags?: string[] | undefined;
1378
+ related?: string[] | undefined;
1356
1379
  title?: string | undefined;
1357
1380
  };
1358
1381
  }>, z.ZodObject<{
@@ -1365,23 +1388,29 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1365
1388
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1366
1389
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1367
1390
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1391
+ semantic_scope: z.ZodOptional<z.ZodString>;
1392
+ related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1368
1393
  } & {
1369
1394
  layer: z.ZodEnum<["team", "personal"]>;
1370
1395
  }, "strip", z.ZodTypeAny, {
1371
1396
  layer: "personal" | "team";
1397
+ semantic_scope?: string | undefined;
1372
1398
  relevance_scope?: "narrow" | "broad" | undefined;
1373
1399
  relevance_paths?: string[] | undefined;
1374
1400
  summary?: string | undefined;
1375
1401
  maturity?: "draft" | "verified" | "proven" | undefined;
1376
1402
  tags?: string[] | undefined;
1403
+ related?: string[] | undefined;
1377
1404
  title?: string | undefined;
1378
1405
  }, {
1379
1406
  layer: "personal" | "team";
1407
+ semantic_scope?: string | undefined;
1380
1408
  relevance_scope?: "narrow" | "broad" | undefined;
1381
1409
  relevance_paths?: string[] | undefined;
1382
1410
  summary?: string | undefined;
1383
1411
  maturity?: "draft" | "verified" | "proven" | undefined;
1384
1412
  tags?: string[] | undefined;
1413
+ related?: string[] | undefined;
1385
1414
  title?: string | undefined;
1386
1415
  }>;
1387
1416
  }, "strip", z.ZodTypeAny, {
@@ -1389,11 +1418,13 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1389
1418
  action: "modify-layer";
1390
1419
  changes: {
1391
1420
  layer: "personal" | "team";
1421
+ semantic_scope?: string | undefined;
1392
1422
  relevance_scope?: "narrow" | "broad" | undefined;
1393
1423
  relevance_paths?: string[] | undefined;
1394
1424
  summary?: string | undefined;
1395
1425
  maturity?: "draft" | "verified" | "proven" | undefined;
1396
1426
  tags?: string[] | undefined;
1427
+ related?: string[] | undefined;
1397
1428
  title?: string | undefined;
1398
1429
  };
1399
1430
  }, {
@@ -1401,11 +1432,13 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1401
1432
  action: "modify-layer";
1402
1433
  changes: {
1403
1434
  layer: "personal" | "team";
1435
+ semantic_scope?: string | undefined;
1404
1436
  relevance_scope?: "narrow" | "broad" | undefined;
1405
1437
  relevance_paths?: string[] | undefined;
1406
1438
  summary?: string | undefined;
1407
1439
  maturity?: "draft" | "verified" | "proven" | undefined;
1408
1440
  tags?: string[] | undefined;
1441
+ related?: string[] | undefined;
1409
1442
  title?: string | undefined;
1410
1443
  };
1411
1444
  }>, z.ZodObject<{
@@ -1523,21 +1556,27 @@ declare const FabReviewInputShape: {
1523
1556
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1524
1557
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1525
1558
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1559
+ semantic_scope: z.ZodOptional<z.ZodString>;
1560
+ related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1526
1561
  }, "strip", z.ZodTypeAny, {
1562
+ semantic_scope?: string | undefined;
1527
1563
  relevance_scope?: "narrow" | "broad" | undefined;
1528
1564
  relevance_paths?: string[] | undefined;
1529
1565
  layer?: "personal" | "team" | undefined;
1530
1566
  summary?: string | undefined;
1531
1567
  maturity?: "draft" | "verified" | "proven" | undefined;
1532
1568
  tags?: string[] | undefined;
1569
+ related?: string[] | undefined;
1533
1570
  title?: string | undefined;
1534
1571
  }, {
1572
+ semantic_scope?: string | undefined;
1535
1573
  relevance_scope?: "narrow" | "broad" | undefined;
1536
1574
  relevance_paths?: string[] | undefined;
1537
1575
  layer?: "personal" | "team" | undefined;
1538
1576
  summary?: string | undefined;
1539
1577
  maturity?: "draft" | "verified" | "proven" | undefined;
1540
1578
  tags?: string[] | undefined;
1579
+ related?: string[] | undefined;
1541
1580
  title?: string | undefined;
1542
1581
  }>>;
1543
1582
  readonly query: z.ZodOptional<z.ZodString>;
@@ -1589,16 +1628,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1589
1628
  code: z.ZodString;
1590
1629
  file: z.ZodString;
1591
1630
  line: z.ZodOptional<z.ZodNumber>;
1631
+ message: z.ZodOptional<z.ZodString>;
1592
1632
  action_hint: z.ZodString;
1593
1633
  }, "strip", z.ZodTypeAny, {
1594
1634
  code: string;
1595
1635
  file: string;
1596
1636
  action_hint: string;
1637
+ message?: string | undefined;
1597
1638
  line?: number | undefined;
1598
1639
  }, {
1599
1640
  code: string;
1600
1641
  file: string;
1601
1642
  action_hint: string;
1643
+ message?: string | undefined;
1602
1644
  line?: number | undefined;
1603
1645
  }>, "many">>;
1604
1646
  }, "strip", z.ZodTypeAny, {
@@ -1621,6 +1663,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1621
1663
  code: string;
1622
1664
  file: string;
1623
1665
  action_hint: string;
1666
+ message?: string | undefined;
1624
1667
  line?: number | undefined;
1625
1668
  }[] | undefined;
1626
1669
  }, {
@@ -1643,6 +1686,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1643
1686
  code: string;
1644
1687
  file: string;
1645
1688
  action_hint: string;
1689
+ message?: string | undefined;
1646
1690
  line?: number | undefined;
1647
1691
  }[] | undefined;
1648
1692
  }>, z.ZodObject<{
@@ -1661,16 +1705,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1661
1705
  code: z.ZodString;
1662
1706
  file: z.ZodString;
1663
1707
  line: z.ZodOptional<z.ZodNumber>;
1708
+ message: z.ZodOptional<z.ZodString>;
1664
1709
  action_hint: z.ZodString;
1665
1710
  }, "strip", z.ZodTypeAny, {
1666
1711
  code: string;
1667
1712
  file: string;
1668
1713
  action_hint: string;
1714
+ message?: string | undefined;
1669
1715
  line?: number | undefined;
1670
1716
  }, {
1671
1717
  code: string;
1672
1718
  file: string;
1673
1719
  action_hint: string;
1720
+ message?: string | undefined;
1674
1721
  line?: number | undefined;
1675
1722
  }>, "many">>;
1676
1723
  }, "strip", z.ZodTypeAny, {
@@ -1683,6 +1730,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1683
1730
  code: string;
1684
1731
  file: string;
1685
1732
  action_hint: string;
1733
+ message?: string | undefined;
1686
1734
  line?: number | undefined;
1687
1735
  }[] | undefined;
1688
1736
  }, {
@@ -1695,6 +1743,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1695
1743
  code: string;
1696
1744
  file: string;
1697
1745
  action_hint: string;
1746
+ message?: string | undefined;
1698
1747
  line?: number | undefined;
1699
1748
  }[] | undefined;
1700
1749
  }>, z.ZodObject<{
@@ -1704,16 +1753,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1704
1753
  code: z.ZodString;
1705
1754
  file: z.ZodString;
1706
1755
  line: z.ZodOptional<z.ZodNumber>;
1756
+ message: z.ZodOptional<z.ZodString>;
1707
1757
  action_hint: z.ZodString;
1708
1758
  }, "strip", z.ZodTypeAny, {
1709
1759
  code: string;
1710
1760
  file: string;
1711
1761
  action_hint: string;
1762
+ message?: string | undefined;
1712
1763
  line?: number | undefined;
1713
1764
  }, {
1714
1765
  code: string;
1715
1766
  file: string;
1716
1767
  action_hint: string;
1768
+ message?: string | undefined;
1717
1769
  line?: number | undefined;
1718
1770
  }>, "many">>;
1719
1771
  }, "strip", z.ZodTypeAny, {
@@ -1723,6 +1775,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1723
1775
  code: string;
1724
1776
  file: string;
1725
1777
  action_hint: string;
1778
+ message?: string | undefined;
1726
1779
  line?: number | undefined;
1727
1780
  }[] | undefined;
1728
1781
  }, {
@@ -1732,6 +1785,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1732
1785
  code: string;
1733
1786
  file: string;
1734
1787
  action_hint: string;
1788
+ message?: string | undefined;
1735
1789
  line?: number | undefined;
1736
1790
  }[] | undefined;
1737
1791
  }>, z.ZodObject<{
@@ -1743,16 +1797,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1743
1797
  code: z.ZodString;
1744
1798
  file: z.ZodString;
1745
1799
  line: z.ZodOptional<z.ZodNumber>;
1800
+ message: z.ZodOptional<z.ZodString>;
1746
1801
  action_hint: z.ZodString;
1747
1802
  }, "strip", z.ZodTypeAny, {
1748
1803
  code: string;
1749
1804
  file: string;
1750
1805
  action_hint: string;
1806
+ message?: string | undefined;
1751
1807
  line?: number | undefined;
1752
1808
  }, {
1753
1809
  code: string;
1754
1810
  file: string;
1755
1811
  action_hint: string;
1812
+ message?: string | undefined;
1756
1813
  line?: number | undefined;
1757
1814
  }>, "many">>;
1758
1815
  }, "strip", z.ZodTypeAny, {
@@ -1762,6 +1819,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1762
1819
  code: string;
1763
1820
  file: string;
1764
1821
  action_hint: string;
1822
+ message?: string | undefined;
1765
1823
  line?: number | undefined;
1766
1824
  }[] | undefined;
1767
1825
  prior_stable_id?: string | undefined;
@@ -1773,6 +1831,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1773
1831
  code: string;
1774
1832
  file: string;
1775
1833
  action_hint: string;
1834
+ message?: string | undefined;
1776
1835
  line?: number | undefined;
1777
1836
  }[] | undefined;
1778
1837
  prior_stable_id?: string | undefined;
@@ -1829,16 +1888,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1829
1888
  code: z.ZodString;
1830
1889
  file: z.ZodString;
1831
1890
  line: z.ZodOptional<z.ZodNumber>;
1891
+ message: z.ZodOptional<z.ZodString>;
1832
1892
  action_hint: z.ZodString;
1833
1893
  }, "strip", z.ZodTypeAny, {
1834
1894
  code: string;
1835
1895
  file: string;
1836
1896
  action_hint: string;
1897
+ message?: string | undefined;
1837
1898
  line?: number | undefined;
1838
1899
  }, {
1839
1900
  code: string;
1840
1901
  file: string;
1841
1902
  action_hint: string;
1903
+ message?: string | undefined;
1842
1904
  line?: number | undefined;
1843
1905
  }>, "many">>;
1844
1906
  }, "strip", z.ZodTypeAny, {
@@ -1863,6 +1925,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1863
1925
  code: string;
1864
1926
  file: string;
1865
1927
  action_hint: string;
1928
+ message?: string | undefined;
1866
1929
  line?: number | undefined;
1867
1930
  }[] | undefined;
1868
1931
  }, {
@@ -1887,6 +1950,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1887
1950
  code: string;
1888
1951
  file: string;
1889
1952
  action_hint: string;
1953
+ message?: string | undefined;
1890
1954
  line?: number | undefined;
1891
1955
  }[] | undefined;
1892
1956
  }>, z.ZodObject<{
@@ -1896,16 +1960,19 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1896
1960
  code: z.ZodString;
1897
1961
  file: z.ZodString;
1898
1962
  line: z.ZodOptional<z.ZodNumber>;
1963
+ message: z.ZodOptional<z.ZodString>;
1899
1964
  action_hint: z.ZodString;
1900
1965
  }, "strip", z.ZodTypeAny, {
1901
1966
  code: string;
1902
1967
  file: string;
1903
1968
  action_hint: string;
1969
+ message?: string | undefined;
1904
1970
  line?: number | undefined;
1905
1971
  }, {
1906
1972
  code: string;
1907
1973
  file: string;
1908
1974
  action_hint: string;
1975
+ message?: string | undefined;
1909
1976
  line?: number | undefined;
1910
1977
  }>, "many">>;
1911
1978
  }, "strip", z.ZodTypeAny, {
@@ -1915,6 +1982,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1915
1982
  code: string;
1916
1983
  file: string;
1917
1984
  action_hint: string;
1985
+ message?: string | undefined;
1918
1986
  line?: number | undefined;
1919
1987
  }[] | undefined;
1920
1988
  }, {
@@ -1924,6 +1992,7 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1924
1992
  code: string;
1925
1993
  file: string;
1926
1994
  action_hint: string;
1995
+ message?: string | undefined;
1927
1996
  line?: number | undefined;
1928
1997
  }[] | undefined;
1929
1998
  }>]>;
@@ -2034,16 +2103,19 @@ declare const FabReviewOutputShape: {
2034
2103
  code: z.ZodString;
2035
2104
  file: z.ZodString;
2036
2105
  line: z.ZodOptional<z.ZodNumber>;
2106
+ message: z.ZodOptional<z.ZodString>;
2037
2107
  action_hint: z.ZodString;
2038
2108
  }, "strip", z.ZodTypeAny, {
2039
2109
  code: string;
2040
2110
  file: string;
2041
2111
  action_hint: string;
2112
+ message?: string | undefined;
2042
2113
  line?: number | undefined;
2043
2114
  }, {
2044
2115
  code: string;
2045
2116
  file: string;
2046
2117
  action_hint: string;
2118
+ message?: string | undefined;
2047
2119
  line?: number | undefined;
2048
2120
  }>, "many">>;
2049
2121
  };
@@ -2096,7 +2168,7 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2096
2168
  marker_ts: z.ZodNumber;
2097
2169
  marker_emitted_now: z.ZodBoolean;
2098
2170
  since_ts: z.ZodNumber;
2099
- client_filter: z.ZodEnum<["cc", "codex", "cursor", "all"]>;
2171
+ client_filter: z.ZodEnum<["cc", "codex", "all"]>;
2100
2172
  layer_filter: z.ZodOptional<z.ZodEnum<["team", "personal", "all"]>>;
2101
2173
  metrics: z.ZodObject<{
2102
2174
  edits_touched: z.ZodNumber;
@@ -2108,6 +2180,42 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2108
2180
  compliant_cites: z.ZodOptional<z.ZodNumber>;
2109
2181
  noncompliant_cites: z.ZodOptional<z.ZodNumber>;
2110
2182
  uncorrelatable_edits: z.ZodOptional<z.ZodNumber>;
2183
+ recall_backed_edits: z.ZodOptional<z.ZodNumber>;
2184
+ recall_coverage_rate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
2185
+ exposed_and_mutated: z.ZodOptional<z.ZodObject<{
2186
+ count: z.ZodNumber;
2187
+ ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2188
+ }, "strip", z.ZodTypeAny, {
2189
+ count: number;
2190
+ ids?: string[] | undefined;
2191
+ }, {
2192
+ count: number;
2193
+ ids?: string[] | undefined;
2194
+ }>>;
2195
+ mutations_observed: z.ZodOptional<z.ZodObject<{
2196
+ count: z.ZodNumber;
2197
+ }, "strip", z.ZodTypeAny, {
2198
+ count: number;
2199
+ }, {
2200
+ count: number;
2201
+ }>>;
2202
+ mutation_pool: z.ZodOptional<z.ZodObject<{
2203
+ attributed: z.ZodNumber;
2204
+ unattributed_workspace_dirty: z.ZodNumber;
2205
+ }, "strip", z.ZodTypeAny, {
2206
+ attributed: number;
2207
+ unattributed_workspace_dirty: number;
2208
+ }, {
2209
+ attributed: number;
2210
+ unattributed_workspace_dirty: number;
2211
+ }>>;
2212
+ sessions_closed: z.ZodOptional<z.ZodObject<{
2213
+ count: z.ZodNumber;
2214
+ }, "strip", z.ZodTypeAny, {
2215
+ count: number;
2216
+ }, {
2217
+ count: number;
2218
+ }>>;
2111
2219
  }, "strip", z.ZodTypeAny, {
2112
2220
  edits_touched: number;
2113
2221
  qualifying_cites: number;
@@ -2118,6 +2226,22 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2118
2226
  compliant_cites?: number | undefined;
2119
2227
  noncompliant_cites?: number | undefined;
2120
2228
  uncorrelatable_edits?: number | undefined;
2229
+ recall_backed_edits?: number | undefined;
2230
+ recall_coverage_rate?: number | null | undefined;
2231
+ exposed_and_mutated?: {
2232
+ count: number;
2233
+ ids?: string[] | undefined;
2234
+ } | undefined;
2235
+ mutations_observed?: {
2236
+ count: number;
2237
+ } | undefined;
2238
+ mutation_pool?: {
2239
+ attributed: number;
2240
+ unattributed_workspace_dirty: number;
2241
+ } | undefined;
2242
+ sessions_closed?: {
2243
+ count: number;
2244
+ } | undefined;
2121
2245
  }, {
2122
2246
  edits_touched: number;
2123
2247
  qualifying_cites: number;
@@ -2128,6 +2252,22 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2128
2252
  compliant_cites?: number | undefined;
2129
2253
  noncompliant_cites?: number | undefined;
2130
2254
  uncorrelatable_edits?: number | undefined;
2255
+ recall_backed_edits?: number | undefined;
2256
+ recall_coverage_rate?: number | null | undefined;
2257
+ exposed_and_mutated?: {
2258
+ count: number;
2259
+ ids?: string[] | undefined;
2260
+ } | undefined;
2261
+ mutations_observed?: {
2262
+ count: number;
2263
+ } | undefined;
2264
+ mutation_pool?: {
2265
+ attributed: number;
2266
+ unattributed_workspace_dirty: number;
2267
+ } | undefined;
2268
+ sessions_closed?: {
2269
+ count: number;
2270
+ } | undefined;
2131
2271
  }>;
2132
2272
  per_client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
2133
2273
  edits_touched: z.ZodOptional<z.ZodNumber>;
@@ -2193,7 +2333,7 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2193
2333
  marker_ts: number;
2194
2334
  marker_emitted_now: boolean;
2195
2335
  since_ts: number;
2196
- client_filter: "cursor" | "all" | "cc" | "codex";
2336
+ client_filter: "all" | "cc" | "codex";
2197
2337
  metrics: {
2198
2338
  edits_touched: number;
2199
2339
  qualifying_cites: number;
@@ -2204,6 +2344,22 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2204
2344
  compliant_cites?: number | undefined;
2205
2345
  noncompliant_cites?: number | undefined;
2206
2346
  uncorrelatable_edits?: number | undefined;
2347
+ recall_backed_edits?: number | undefined;
2348
+ recall_coverage_rate?: number | null | undefined;
2349
+ exposed_and_mutated?: {
2350
+ count: number;
2351
+ ids?: string[] | undefined;
2352
+ } | undefined;
2353
+ mutations_observed?: {
2354
+ count: number;
2355
+ } | undefined;
2356
+ mutation_pool?: {
2357
+ attributed: number;
2358
+ unattributed_workspace_dirty: number;
2359
+ } | undefined;
2360
+ sessions_closed?: {
2361
+ count: number;
2362
+ } | undefined;
2207
2363
  };
2208
2364
  generated_at: string;
2209
2365
  layer_filter?: "personal" | "team" | "all" | undefined;
@@ -2236,7 +2392,7 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2236
2392
  marker_ts: number;
2237
2393
  marker_emitted_now: boolean;
2238
2394
  since_ts: number;
2239
- client_filter: "cursor" | "all" | "cc" | "codex";
2395
+ client_filter: "all" | "cc" | "codex";
2240
2396
  metrics: {
2241
2397
  edits_touched: number;
2242
2398
  qualifying_cites: number;
@@ -2247,6 +2403,22 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2247
2403
  compliant_cites?: number | undefined;
2248
2404
  noncompliant_cites?: number | undefined;
2249
2405
  uncorrelatable_edits?: number | undefined;
2406
+ recall_backed_edits?: number | undefined;
2407
+ recall_coverage_rate?: number | null | undefined;
2408
+ exposed_and_mutated?: {
2409
+ count: number;
2410
+ ids?: string[] | undefined;
2411
+ } | undefined;
2412
+ mutations_observed?: {
2413
+ count: number;
2414
+ } | undefined;
2415
+ mutation_pool?: {
2416
+ attributed: number;
2417
+ unattributed_workspace_dirty: number;
2418
+ } | undefined;
2419
+ sessions_closed?: {
2420
+ count: number;
2421
+ } | undefined;
2250
2422
  };
2251
2423
  generated_at: string;
2252
2424
  layer_filter?: "personal" | "team" | "all" | undefined;
@@ -2382,4 +2554,4 @@ declare function parseKnowledgeId(id: string): {
2382
2554
  counter: number;
2383
2555
  } | null;
2384
2556
 
2385
- export { type ArchiveScanInput, type ArchiveScanOutput, type CiteContractMetrics, type CiteCoverageReport, type CiteLayerTypeBreakdown, type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, archiveScanAnnotations, archiveScanInputSchema, archiveScanOutputSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, recallAnnotations, recallInputSchema, recallOutputSchema, structuredWarningSchema };
2557
+ export { type ArchiveScanInput, type ArchiveScanOutput, type CiteContractMetrics, type CiteCoverageReport, type CiteLayerTypeBreakdown, type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS_BY_LOCALE, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, archiveScanAnnotations, archiveScanInputSchema, archiveScanOutputSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, recallAnnotations, recallInputSchema, recallOutputSchema, structuredWarningSchema };