@fenglimg/fabric-shared 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +13 -0
  3. package/dist/chunk-7CX32MYL.js +2043 -0
  4. package/dist/chunk-LTDB2UDN.js +100 -0
  5. package/dist/chunk-WVPDH4BF.js +952 -0
  6. package/dist/i18n/index.d.ts +22 -2
  7. package/dist/i18n/index.js +3 -1
  8. package/dist/index-UBqD9F0b.d.ts +304 -0
  9. package/dist/index.d.ts +1440 -458
  10. package/dist/index.js +1058 -350
  11. package/dist/node/atomic-write.d.ts +16 -0
  12. package/dist/node/atomic-write.js +19 -10
  13. package/dist/node/mcp-payload-guard.d.ts +3 -1
  14. package/dist/node/mcp-payload-guard.js +6 -2
  15. package/dist/schemas/api-contracts.d.ts +1561 -814
  16. package/dist/schemas/api-contracts.js +23 -7
  17. package/dist/templates/bootstrap-canonical.d.ts +56 -0
  18. package/dist/templates/bootstrap-canonical.js +18 -0
  19. package/dist/types/index.d.ts +2 -123
  20. package/package.json +32 -4
  21. package/dist/chunk-U2SR2M4L.js +0 -958
  22. package/dist/chunk-VQDCDCJA.js +0 -555
package/dist/schemas/api-contracts.d.ts CHANGED
@@ -6,13 +6,13 @@ declare const structuredWarningSchema: z.ZodObject<{
6
6
  line: z.ZodOptional<z.ZodNumber>;
7
7
  action_hint: z.ZodString;
8
8
  }, "strip", z.ZodTypeAny, {
9
- file: string;
10
9
  code: string;
10
+ file: string;
11
11
  action_hint: string;
12
12
  line?: number | undefined;
13
13
  }, {
14
- file: string;
15
14
  code: string;
15
+ file: string;
16
16
  action_hint: string;
17
17
  line?: number | undefined;
18
18
  }>;
@@ -55,586 +55,263 @@ declare const planContextOutputSchema: z.ZodObject<{
55
55
  path: z.ZodString;
56
56
  requirement_profile: z.ZodObject<{
57
57
  target_path: z.ZodString;
58
- path_segments: z.ZodArray<z.ZodString, "many">;
59
- extension: z.ZodString;
60
58
  known_tech: z.ZodArray<z.ZodString, "many">;
61
59
  user_intent: z.ZodString;
62
60
  detected_entities: z.ZodArray<z.ZodString, "many">;
63
61
  }, "strip", z.ZodTypeAny, {
64
62
  target_path: string;
65
- path_segments: string[];
66
- extension: string;
67
63
  known_tech: string[];
68
64
  user_intent: string;
69
65
  detected_entities: string[];
70
66
  }, {
71
67
  target_path: string;
72
- path_segments: string[];
73
- extension: string;
74
68
  known_tech: string[];
75
69
  user_intent: string;
76
70
  detected_entities: string[];
77
71
  }>;
78
- description_index: z.ZodArray<z.ZodObject<{
79
- stable_id: z.ZodString;
80
- level: z.ZodEnum<["L0", "L1", "L2"]>;
81
- required: z.ZodBoolean;
82
- selectable: z.ZodBoolean;
83
- description: z.ZodObject<{
84
- summary: z.ZodString;
85
- intent_clues: z.ZodArray<z.ZodString, "many">;
86
- tech_stack: z.ZodArray<z.ZodString, "many">;
87
- impact: z.ZodArray<z.ZodString, "many">;
88
- must_read_if: z.ZodString;
89
- entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
90
- id: z.ZodOptional<z.ZodString>;
91
- knowledge_type: z.ZodOptional<z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>>;
92
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
93
- knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
94
- layer_reason: z.ZodOptional<z.ZodString>;
95
- created_at: z.ZodOptional<z.ZodString>;
96
- }, "strip", z.ZodTypeAny, {
97
- summary: string;
98
- intent_clues: string[];
99
- tech_stack: string[];
100
- impact: string[];
101
- must_read_if: string;
102
- entities?: string[] | undefined;
103
- id?: string | undefined;
104
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
105
- maturity?: "draft" | "verified" | "proven" | undefined;
106
- knowledge_layer?: "personal" | "team" | undefined;
107
- layer_reason?: string | undefined;
108
- created_at?: string | undefined;
109
- }, {
110
- summary: string;
111
- intent_clues: string[];
112
- tech_stack: string[];
113
- impact: string[];
114
- must_read_if: string;
115
- entities?: string[] | undefined;
116
- id?: string | undefined;
117
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
118
- maturity?: "draft" | "verified" | "proven" | undefined;
119
- knowledge_layer?: "personal" | "team" | undefined;
120
- layer_reason?: string | undefined;
121
- created_at?: string | undefined;
122
- }>;
123
- type: z.ZodOptional<z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>>;
124
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
125
- layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
126
- layer_reason: z.ZodOptional<z.ZodString>;
127
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
128
- relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
129
- relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
130
- }, "strip", z.ZodTypeAny, {
131
- description: {
132
- summary: string;
133
- intent_clues: string[];
134
- tech_stack: string[];
135
- impact: string[];
136
- must_read_if: string;
137
- entities?: string[] | undefined;
138
- id?: string | undefined;
139
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
140
- maturity?: "draft" | "verified" | "proven" | undefined;
141
- knowledge_layer?: "personal" | "team" | undefined;
142
- layer_reason?: string | undefined;
143
- created_at?: string | undefined;
144
- };
145
- stable_id: string;
146
- level: "L0" | "L1" | "L2";
147
- required: boolean;
148
- selectable: boolean;
149
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
150
- maturity?: "draft" | "verified" | "proven" | undefined;
151
- layer_reason?: string | undefined;
152
- layer?: "personal" | "team" | undefined;
153
- tags?: string[] | undefined;
154
- relevance_scope?: "narrow" | "broad" | undefined;
155
- relevance_paths?: string[] | undefined;
156
- }, {
157
- description: {
158
- summary: string;
159
- intent_clues: string[];
160
- tech_stack: string[];
161
- impact: string[];
162
- must_read_if: string;
163
- entities?: string[] | undefined;
164
- id?: string | undefined;
165
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
166
- maturity?: "draft" | "verified" | "proven" | undefined;
167
- knowledge_layer?: "personal" | "team" | undefined;
168
- layer_reason?: string | undefined;
169
- created_at?: string | undefined;
170
- };
171
- stable_id: string;
172
- level: "L0" | "L1" | "L2";
173
- required: boolean;
174
- selectable: boolean;
175
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
176
- maturity?: "draft" | "verified" | "proven" | undefined;
177
- layer_reason?: string | undefined;
178
- layer?: "personal" | "team" | undefined;
179
- tags?: string[] | undefined;
180
- relevance_scope?: "narrow" | "broad" | undefined;
181
- relevance_paths?: string[] | undefined;
182
- }>, "many">;
183
72
  }, "strip", z.ZodTypeAny, {
184
73
  path: string;
185
74
  requirement_profile: {
186
75
  target_path: string;
187
- path_segments: string[];
188
- extension: string;
189
76
  known_tech: string[];
190
77
  user_intent: string;
191
78
  detected_entities: string[];
192
79
  };
193
- description_index: {
194
- description: {
195
- summary: string;
196
- intent_clues: string[];
197
- tech_stack: string[];
198
- impact: string[];
199
- must_read_if: string;
200
- entities?: string[] | undefined;
201
- id?: string | undefined;
202
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
203
- maturity?: "draft" | "verified" | "proven" | undefined;
204
- knowledge_layer?: "personal" | "team" | undefined;
205
- layer_reason?: string | undefined;
206
- created_at?: string | undefined;
207
- };
208
- stable_id: string;
209
- level: "L0" | "L1" | "L2";
210
- required: boolean;
211
- selectable: boolean;
212
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
213
- maturity?: "draft" | "verified" | "proven" | undefined;
214
- layer_reason?: string | undefined;
215
- layer?: "personal" | "team" | undefined;
216
- tags?: string[] | undefined;
217
- relevance_scope?: "narrow" | "broad" | undefined;
218
- relevance_paths?: string[] | undefined;
219
- }[];
220
80
  }, {
221
81
  path: string;
222
82
  requirement_profile: {
223
83
  target_path: string;
224
- path_segments: string[];
225
- extension: string;
226
84
  known_tech: string[];
227
85
  user_intent: string;
228
86
  detected_entities: string[];
229
87
  };
230
- description_index: {
231
- description: {
232
- summary: string;
233
- intent_clues: string[];
234
- tech_stack: string[];
235
- impact: string[];
236
- must_read_if: string;
237
- entities?: string[] | undefined;
238
- id?: string | undefined;
239
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
240
- maturity?: "draft" | "verified" | "proven" | undefined;
241
- knowledge_layer?: "personal" | "team" | undefined;
242
- layer_reason?: string | undefined;
243
- created_at?: string | undefined;
244
- };
245
- stable_id: string;
246
- level: "L0" | "L1" | "L2";
247
- required: boolean;
248
- selectable: boolean;
249
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
250
- maturity?: "draft" | "verified" | "proven" | undefined;
251
- layer_reason?: string | undefined;
252
- layer?: "personal" | "team" | undefined;
253
- tags?: string[] | undefined;
254
- relevance_scope?: "narrow" | "broad" | undefined;
255
- relevance_paths?: string[] | undefined;
256
- }[];
257
88
  }>, "many">;
258
- shared: z.ZodObject<{
259
- description_index: z.ZodArray<z.ZodObject<{
260
- stable_id: z.ZodString;
261
- level: z.ZodEnum<["L0", "L1", "L2"]>;
262
- required: z.ZodBoolean;
263
- selectable: z.ZodBoolean;
264
- description: z.ZodObject<{
265
- summary: z.ZodString;
266
- intent_clues: z.ZodArray<z.ZodString, "many">;
267
- tech_stack: z.ZodArray<z.ZodString, "many">;
268
- impact: z.ZodArray<z.ZodString, "many">;
269
- must_read_if: z.ZodString;
270
- entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
271
- id: z.ZodOptional<z.ZodString>;
272
- knowledge_type: z.ZodOptional<z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>>;
273
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
274
- knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
275
- layer_reason: z.ZodOptional<z.ZodString>;
276
- created_at: z.ZodOptional<z.ZodString>;
277
- }, "strip", z.ZodTypeAny, {
278
- summary: string;
279
- intent_clues: string[];
280
- tech_stack: string[];
281
- impact: string[];
282
- must_read_if: string;
283
- entities?: string[] | undefined;
284
- id?: string | undefined;
285
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
286
- maturity?: "draft" | "verified" | "proven" | undefined;
287
- knowledge_layer?: "personal" | "team" | undefined;
288
- layer_reason?: string | undefined;
289
- created_at?: string | undefined;
290
- }, {
291
- summary: string;
292
- intent_clues: string[];
293
- tech_stack: string[];
294
- impact: string[];
295
- must_read_if: string;
296
- entities?: string[] | undefined;
297
- id?: string | undefined;
298
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
299
- maturity?: "draft" | "verified" | "proven" | undefined;
300
- knowledge_layer?: "personal" | "team" | undefined;
301
- layer_reason?: string | undefined;
302
- created_at?: string | undefined;
303
- }>;
304
- type: z.ZodOptional<z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>>;
89
+ candidates: z.ZodArray<z.ZodObject<{
90
+ stable_id: z.ZodString;
91
+ description: z.ZodObject<{
92
+ summary: z.ZodString;
93
+ intent_clues: z.ZodArray<z.ZodString, "many">;
94
+ tech_stack: z.ZodArray<z.ZodString, "many">;
95
+ impact: z.ZodArray<z.ZodString, "many">;
96
+ must_read_if: z.ZodString;
97
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
98
+ id: z.ZodOptional<z.ZodString>;
99
+ knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
305
100
  maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
306
- layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
101
+ knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
307
102
  layer_reason: z.ZodOptional<z.ZodString>;
103
+ created_at: z.ZodOptional<z.ZodString>;
308
104
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
309
105
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
310
106
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
311
107
  }, "strip", z.ZodTypeAny, {
312
- description: {
313
- summary: string;
314
- intent_clues: string[];
315
- tech_stack: string[];
316
- impact: string[];
317
- must_read_if: string;
318
- entities?: string[] | undefined;
319
- id?: string | undefined;
320
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
321
- maturity?: "draft" | "verified" | "proven" | undefined;
322
- knowledge_layer?: "personal" | "team" | undefined;
323
- layer_reason?: string | undefined;
324
- created_at?: string | undefined;
325
- };
326
- stable_id: string;
327
- level: "L0" | "L1" | "L2";
328
- required: boolean;
329
- selectable: boolean;
330
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
108
+ summary: string;
109
+ intent_clues: string[];
110
+ tech_stack: string[];
111
+ impact: string[];
112
+ must_read_if: string;
113
+ relevance_scope?: "narrow" | "broad" | undefined;
114
+ relevance_paths?: string[] | undefined;
115
+ entities?: string[] | undefined;
116
+ id?: string | undefined;
117
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
331
118
  maturity?: "draft" | "verified" | "proven" | undefined;
119
+ knowledge_layer?: "personal" | "team" | undefined;
332
120
  layer_reason?: string | undefined;
333
- layer?: "personal" | "team" | undefined;
121
+ created_at?: string | undefined;
334
122
  tags?: string[] | undefined;
123
+ }, {
124
+ summary: string;
125
+ intent_clues: string[];
126
+ tech_stack: string[];
127
+ impact: string[];
128
+ must_read_if: string;
335
129
  relevance_scope?: "narrow" | "broad" | undefined;
336
130
  relevance_paths?: string[] | undefined;
337
- }, {
338
- description: {
339
- summary: string;
340
- intent_clues: string[];
341
- tech_stack: string[];
342
- impact: string[];
343
- must_read_if: string;
344
- entities?: string[] | undefined;
345
- id?: string | undefined;
346
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
347
- maturity?: "draft" | "verified" | "proven" | undefined;
348
- knowledge_layer?: "personal" | "team" | undefined;
349
- layer_reason?: string | undefined;
350
- created_at?: string | undefined;
351
- };
352
- stable_id: string;
353
- level: "L0" | "L1" | "L2";
354
- required: boolean;
355
- selectable: boolean;
356
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
131
+ entities?: string[] | undefined;
132
+ id?: string | undefined;
133
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
357
134
  maturity?: "draft" | "verified" | "proven" | undefined;
135
+ knowledge_layer?: "personal" | "team" | undefined;
358
136
  layer_reason?: string | undefined;
359
- layer?: "personal" | "team" | undefined;
137
+ created_at?: string | undefined;
360
138
  tags?: string[] | undefined;
139
+ }>;
140
+ }, "strip", z.ZodTypeAny, {
141
+ description: {
142
+ summary: string;
143
+ intent_clues: string[];
144
+ tech_stack: string[];
145
+ impact: string[];
146
+ must_read_if: string;
361
147
  relevance_scope?: "narrow" | "broad" | undefined;
362
148
  relevance_paths?: string[] | undefined;
363
- }>, "many">;
364
- preflight_diagnostics: z.ZodArray<z.ZodObject<{
365
- code: z.ZodLiteral<"missing_description">;
366
- severity: z.ZodLiteral<"warn">;
367
- message: z.ZodString;
368
- stable_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
369
- path: z.ZodOptional<z.ZodString>;
370
- }, "strip", z.ZodTypeAny, {
371
- code: "missing_description";
372
- message: string;
373
- severity: "warn";
374
- path?: string | undefined;
375
- stable_ids?: string[] | undefined;
376
- }, {
377
- code: "missing_description";
378
- message: string;
379
- severity: "warn";
380
- path?: string | undefined;
381
- stable_ids?: string[] | undefined;
382
- }>, "many">;
383
- }, "strip", z.ZodTypeAny, {
384
- description_index: {
385
- description: {
386
- summary: string;
387
- intent_clues: string[];
388
- tech_stack: string[];
389
- impact: string[];
390
- must_read_if: string;
391
- entities?: string[] | undefined;
392
- id?: string | undefined;
393
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
394
- maturity?: "draft" | "verified" | "proven" | undefined;
395
- knowledge_layer?: "personal" | "team" | undefined;
396
- layer_reason?: string | undefined;
397
- created_at?: string | undefined;
398
- };
399
- stable_id: string;
400
- level: "L0" | "L1" | "L2";
401
- required: boolean;
402
- selectable: boolean;
403
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
149
+ entities?: string[] | undefined;
150
+ id?: string | undefined;
151
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
404
152
  maturity?: "draft" | "verified" | "proven" | undefined;
153
+ knowledge_layer?: "personal" | "team" | undefined;
405
154
  layer_reason?: string | undefined;
406
- layer?: "personal" | "team" | undefined;
155
+ created_at?: string | undefined;
407
156
  tags?: string[] | undefined;
157
+ };
158
+ stable_id: string;
159
+ }, {
160
+ description: {
161
+ summary: string;
162
+ intent_clues: string[];
163
+ tech_stack: string[];
164
+ impact: string[];
165
+ must_read_if: string;
408
166
  relevance_scope?: "narrow" | "broad" | undefined;
409
167
  relevance_paths?: string[] | undefined;
410
- }[];
411
- preflight_diagnostics: {
412
- code: "missing_description";
413
- message: string;
414
- severity: "warn";
415
- path?: string | undefined;
416
- stable_ids?: string[] | undefined;
417
- }[];
418
- }, {
419
- description_index: {
420
- description: {
421
- summary: string;
422
- intent_clues: string[];
423
- tech_stack: string[];
424
- impact: string[];
425
- must_read_if: string;
426
- entities?: string[] | undefined;
427
- id?: string | undefined;
428
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
429
- maturity?: "draft" | "verified" | "proven" | undefined;
430
- knowledge_layer?: "personal" | "team" | undefined;
431
- layer_reason?: string | undefined;
432
- created_at?: string | undefined;
433
- };
434
- stable_id: string;
435
- level: "L0" | "L1" | "L2";
436
- required: boolean;
437
- selectable: boolean;
438
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
168
+ entities?: string[] | undefined;
169
+ id?: string | undefined;
170
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
439
171
  maturity?: "draft" | "verified" | "proven" | undefined;
172
+ knowledge_layer?: "personal" | "team" | undefined;
440
173
  layer_reason?: string | undefined;
441
- layer?: "personal" | "team" | undefined;
174
+ created_at?: string | undefined;
442
175
  tags?: string[] | undefined;
443
- relevance_scope?: "narrow" | "broad" | undefined;
444
- relevance_paths?: string[] | undefined;
445
- }[];
446
- preflight_diagnostics: {
447
- code: "missing_description";
448
- message: string;
449
- severity: "warn";
450
- path?: string | undefined;
451
- stable_ids?: string[] | undefined;
452
- }[];
453
- }>;
176
+ };
177
+ stable_id: string;
178
+ }>, "many">;
179
+ preflight_diagnostics: z.ZodArray<z.ZodObject<{
180
+ code: z.ZodEnum<["missing_description", "empty_shell_suppressed"]>;
181
+ severity: z.ZodLiteral<"warn">;
182
+ message: z.ZodString;
183
+ stable_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
184
+ path: z.ZodOptional<z.ZodString>;
185
+ }, "strip", z.ZodTypeAny, {
186
+ code: "missing_description" | "empty_shell_suppressed";
187
+ message: string;
188
+ severity: "warn";
189
+ path?: string | undefined;
190
+ stable_ids?: string[] | undefined;
191
+ }, {
192
+ code: "missing_description" | "empty_shell_suppressed";
193
+ message: string;
194
+ severity: "warn";
195
+ path?: string | undefined;
196
+ stable_ids?: string[] | undefined;
197
+ }>, "many">;
454
198
  warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
455
199
  code: z.ZodString;
456
200
  file: z.ZodString;
457
201
  line: z.ZodOptional<z.ZodNumber>;
458
202
  action_hint: z.ZodString;
459
203
  }, "strip", z.ZodTypeAny, {
460
- file: string;
461
204
  code: string;
205
+ file: string;
462
206
  action_hint: string;
463
207
  line?: number | undefined;
464
208
  }, {
465
- file: string;
466
209
  code: string;
210
+ file: string;
467
211
  action_hint: string;
468
212
  line?: number | undefined;
469
213
  }>, "many">>;
214
+ auto_healed: z.ZodOptional<z.ZodBoolean>;
215
+ previous_revision_hash: z.ZodOptional<z.ZodString>;
216
+ redirects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
470
217
  }, "strip", z.ZodTypeAny, {
471
- stale: boolean;
472
218
  entries: {
473
219
  path: string;
474
220
  requirement_profile: {
475
221
  target_path: string;
476
- path_segments: string[];
477
- extension: string;
478
222
  known_tech: string[];
479
223
  user_intent: string;
480
224
  detected_entities: string[];
481
225
  };
482
- description_index: {
483
- description: {
484
- summary: string;
485
- intent_clues: string[];
486
- tech_stack: string[];
487
- impact: string[];
488
- must_read_if: string;
489
- entities?: string[] | undefined;
490
- id?: string | undefined;
491
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
492
- maturity?: "draft" | "verified" | "proven" | undefined;
493
- knowledge_layer?: "personal" | "team" | undefined;
494
- layer_reason?: string | undefined;
495
- created_at?: string | undefined;
496
- };
497
- stable_id: string;
498
- level: "L0" | "L1" | "L2";
499
- required: boolean;
500
- selectable: boolean;
501
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
502
- maturity?: "draft" | "verified" | "proven" | undefined;
503
- layer_reason?: string | undefined;
504
- layer?: "personal" | "team" | undefined;
505
- tags?: string[] | undefined;
506
- relevance_scope?: "narrow" | "broad" | undefined;
507
- relevance_paths?: string[] | undefined;
508
- }[];
509
226
  }[];
227
+ stale: boolean;
510
228
  revision_hash: string;
511
229
  selection_token: string;
512
- shared: {
513
- description_index: {
514
- description: {
515
- summary: string;
516
- intent_clues: string[];
517
- tech_stack: string[];
518
- impact: string[];
519
- must_read_if: string;
520
- entities?: string[] | undefined;
521
- id?: string | undefined;
522
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
523
- maturity?: "draft" | "verified" | "proven" | undefined;
524
- knowledge_layer?: "personal" | "team" | undefined;
525
- layer_reason?: string | undefined;
526
- created_at?: string | undefined;
527
- };
528
- stable_id: string;
529
- level: "L0" | "L1" | "L2";
530
- required: boolean;
531
- selectable: boolean;
532
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
230
+ candidates: {
231
+ description: {
232
+ summary: string;
233
+ intent_clues: string[];
234
+ tech_stack: string[];
235
+ impact: string[];
236
+ must_read_if: string;
237
+ relevance_scope?: "narrow" | "broad" | undefined;
238
+ relevance_paths?: string[] | undefined;
239
+ entities?: string[] | undefined;
240
+ id?: string | undefined;
241
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
533
242
  maturity?: "draft" | "verified" | "proven" | undefined;
243
+ knowledge_layer?: "personal" | "team" | undefined;
534
244
  layer_reason?: string | undefined;
535
- layer?: "personal" | "team" | undefined;
245
+ created_at?: string | undefined;
536
246
  tags?: string[] | undefined;
537
- relevance_scope?: "narrow" | "broad" | undefined;
538
- relevance_paths?: string[] | undefined;
539
- }[];
540
- preflight_diagnostics: {
541
- code: "missing_description";
542
- message: string;
543
- severity: "warn";
544
- path?: string | undefined;
545
- stable_ids?: string[] | undefined;
546
- }[];
547
- };
247
+ };
248
+ stable_id: string;
249
+ }[];
250
+ preflight_diagnostics: {
251
+ code: "missing_description" | "empty_shell_suppressed";
252
+ message: string;
253
+ severity: "warn";
254
+ path?: string | undefined;
255
+ stable_ids?: string[] | undefined;
256
+ }[];
548
257
  warnings?: {
549
- file: string;
550
258
  code: string;
259
+ file: string;
551
260
  action_hint: string;
552
261
  line?: number | undefined;
553
262
  }[] | undefined;
263
+ auto_healed?: boolean | undefined;
264
+ previous_revision_hash?: string | undefined;
265
+ redirects?: Record<string, string> | undefined;
554
266
  }, {
555
- stale: boolean;
556
267
  entries: {
557
268
  path: string;
558
269
  requirement_profile: {
559
270
  target_path: string;
560
- path_segments: string[];
561
- extension: string;
562
271
  known_tech: string[];
563
272
  user_intent: string;
564
273
  detected_entities: string[];
565
274
  };
566
- description_index: {
567
- description: {
568
- summary: string;
569
- intent_clues: string[];
570
- tech_stack: string[];
571
- impact: string[];
572
- must_read_if: string;
573
- entities?: string[] | undefined;
574
- id?: string | undefined;
575
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
576
- maturity?: "draft" | "verified" | "proven" | undefined;
577
- knowledge_layer?: "personal" | "team" | undefined;
578
- layer_reason?: string | undefined;
579
- created_at?: string | undefined;
580
- };
581
- stable_id: string;
582
- level: "L0" | "L1" | "L2";
583
- required: boolean;
584
- selectable: boolean;
585
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
586
- maturity?: "draft" | "verified" | "proven" | undefined;
587
- layer_reason?: string | undefined;
588
- layer?: "personal" | "team" | undefined;
589
- tags?: string[] | undefined;
590
- relevance_scope?: "narrow" | "broad" | undefined;
591
- relevance_paths?: string[] | undefined;
592
- }[];
593
275
  }[];
276
+ stale: boolean;
594
277
  revision_hash: string;
595
278
  selection_token: string;
596
- shared: {
597
- description_index: {
598
- description: {
599
- summary: string;
600
- intent_clues: string[];
601
- tech_stack: string[];
602
- impact: string[];
603
- must_read_if: string;
604
- entities?: string[] | undefined;
605
- id?: string | undefined;
606
- knowledge_type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
607
- maturity?: "draft" | "verified" | "proven" | undefined;
608
- knowledge_layer?: "personal" | "team" | undefined;
609
- layer_reason?: string | undefined;
610
- created_at?: string | undefined;
611
- };
612
- stable_id: string;
613
- level: "L0" | "L1" | "L2";
614
- required: boolean;
615
- selectable: boolean;
616
- type?: "model" | "decision" | "guideline" | "pitfall" | "process" | undefined;
279
+ candidates: {
280
+ description: {
281
+ summary: string;
282
+ intent_clues: string[];
283
+ tech_stack: string[];
284
+ impact: string[];
285
+ must_read_if: string;
286
+ relevance_scope?: "narrow" | "broad" | undefined;
287
+ relevance_paths?: string[] | undefined;
288
+ entities?: string[] | undefined;
289
+ id?: string | undefined;
290
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
617
291
  maturity?: "draft" | "verified" | "proven" | undefined;
292
+ knowledge_layer?: "personal" | "team" | undefined;
618
293
  layer_reason?: string | undefined;
619
- layer?: "personal" | "team" | undefined;
294
+ created_at?: string | undefined;
620
295
  tags?: string[] | undefined;
621
- relevance_scope?: "narrow" | "broad" | undefined;
622
- relevance_paths?: string[] | undefined;
623
- }[];
624
- preflight_diagnostics: {
625
- code: "missing_description";
626
- message: string;
627
- severity: "warn";
628
- path?: string | undefined;
629
- stable_ids?: string[] | undefined;
630
- }[];
631
- };
296
+ };
297
+ stable_id: string;
298
+ }[];
299
+ preflight_diagnostics: {
300
+ code: "missing_description" | "empty_shell_suppressed";
301
+ message: string;
302
+ severity: "warn";
303
+ path?: string | undefined;
304
+ stable_ids?: string[] | undefined;
305
+ }[];
632
306
  warnings?: {
633
- file: string;
634
307
  code: string;
308
+ file: string;
635
309
  action_hint: string;
636
310
  line?: number | undefined;
637
311
  }[] | undefined;
312
+ auto_healed?: boolean | undefined;
313
+ previous_revision_hash?: string | undefined;
314
+ redirects?: Record<string, string> | undefined;
638
315
  }>;
639
316
  declare const planContextAnnotations: {
640
317
  readonly readOnlyHint: true;
@@ -703,187 +380,8 @@ declare const planContextHintOutputSchema: z.ZodObject<{
703
380
  version: 1;
704
381
  broad_count: number;
705
382
  }>;
706
- declare const getKnowledgeInputSchema: z.ZodObject<{
707
- path: z.ZodString;
708
- client_hash: z.ZodOptional<z.ZodString>;
709
- correlation_id: z.ZodOptional<z.ZodString>;
710
- session_id: z.ZodOptional<z.ZodString>;
711
- }, "strip", z.ZodTypeAny, {
712
- path: string;
713
- client_hash?: string | undefined;
714
- correlation_id?: string | undefined;
715
- session_id?: string | undefined;
716
- }, {
717
- path: string;
718
- client_hash?: string | undefined;
719
- correlation_id?: string | undefined;
720
- session_id?: string | undefined;
721
- }>;
722
- declare const getKnowledgeOutputSchema: z.ZodObject<{
723
- revision_hash: z.ZodString;
724
- stale: z.ZodBoolean;
725
- rules: z.ZodObject<{
726
- L0: z.ZodString;
727
- L1: z.ZodArray<z.ZodObject<{
728
- path: z.ZodString;
729
- content: z.ZodString;
730
- }, "strip", z.ZodTypeAny, {
731
- path: string;
732
- content: string;
733
- }, {
734
- path: string;
735
- content: string;
736
- }>, "many">;
737
- L2: z.ZodArray<z.ZodObject<{
738
- path: z.ZodString;
739
- content: z.ZodString;
740
- }, "strip", z.ZodTypeAny, {
741
- path: string;
742
- content: string;
743
- }, {
744
- path: string;
745
- content: string;
746
- }>, "many">;
747
- human_locked_nearby: z.ZodArray<z.ZodObject<{
748
- file: z.ZodString;
749
- excerpt: z.ZodString;
750
- }, "strip", z.ZodTypeAny, {
751
- file: string;
752
- excerpt: string;
753
- }, {
754
- file: string;
755
- excerpt: string;
756
- }>, "many">;
757
- description_stubs: z.ZodOptional<z.ZodArray<z.ZodObject<{
758
- path: z.ZodString;
759
- description: z.ZodString;
760
- }, "strip", z.ZodTypeAny, {
761
- path: string;
762
- description: string;
763
- }, {
764
- path: string;
765
- description: string;
766
- }>, "many">>;
767
- }, "strip", z.ZodTypeAny, {
768
- L0: string;
769
- L1: {
770
- path: string;
771
- content: string;
772
- }[];
773
- L2: {
774
- path: string;
775
- content: string;
776
- }[];
777
- human_locked_nearby: {
778
- file: string;
779
- excerpt: string;
780
- }[];
781
- description_stubs?: {
782
- path: string;
783
- description: string;
784
- }[] | undefined;
785
- }, {
786
- L0: string;
787
- L1: {
788
- path: string;
789
- content: string;
790
- }[];
791
- L2: {
792
- path: string;
793
- content: string;
794
- }[];
795
- human_locked_nearby: {
796
- file: string;
797
- excerpt: string;
798
- }[];
799
- description_stubs?: {
800
- path: string;
801
- description: string;
802
- }[] | undefined;
803
- }>;
804
- warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
805
- code: z.ZodString;
806
- file: z.ZodString;
807
- line: z.ZodOptional<z.ZodNumber>;
808
- action_hint: z.ZodString;
809
- }, "strip", z.ZodTypeAny, {
810
- file: string;
811
- code: string;
812
- action_hint: string;
813
- line?: number | undefined;
814
- }, {
815
- file: string;
816
- code: string;
817
- action_hint: string;
818
- line?: number | undefined;
819
- }>, "many">>;
820
- }, "strip", z.ZodTypeAny, {
821
- stale: boolean;
822
- revision_hash: string;
823
- rules: {
824
- L0: string;
825
- L1: {
826
- path: string;
827
- content: string;
828
- }[];
829
- L2: {
830
- path: string;
831
- content: string;
832
- }[];
833
- human_locked_nearby: {
834
- file: string;
835
- excerpt: string;
836
- }[];
837
- description_stubs?: {
838
- path: string;
839
- description: string;
840
- }[] | undefined;
841
- };
842
- warnings?: {
843
- file: string;
844
- code: string;
845
- action_hint: string;
846
- line?: number | undefined;
847
- }[] | undefined;
848
- }, {
849
- stale: boolean;
850
- revision_hash: string;
851
- rules: {
852
- L0: string;
853
- L1: {
854
- path: string;
855
- content: string;
856
- }[];
857
- L2: {
858
- path: string;
859
- content: string;
860
- }[];
861
- human_locked_nearby: {
862
- file: string;
863
- excerpt: string;
864
- }[];
865
- description_stubs?: {
866
- path: string;
867
- description: string;
868
- }[] | undefined;
869
- };
870
- warnings?: {
871
- file: string;
872
- code: string;
873
- action_hint: string;
874
- line?: number | undefined;
875
- }[] | undefined;
876
- }>;
877
- declare const getKnowledgeAnnotations: {
878
- readonly readOnlyHint: true;
879
- readonly idempotentHint: true;
880
- readonly destructiveHint: false;
881
- readonly openWorldHint: false;
882
- readonly title: "Get rule content";
883
- };
884
383
  declare const knowledgeSectionsInputSchema: z.ZodObject<{
885
384
  selection_token: z.ZodString;
886
- sections: z.ZodArray<z.ZodEnum<["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"]>, "many">;
887
385
  ai_selected_stable_ids: z.ZodArray<z.ZodString, "many">;
888
386
  ai_selection_reasons: z.ZodRecord<z.ZodString, z.ZodString>;
889
387
  correlation_id: z.ZodOptional<z.ZodString>;
@@ -891,7 +389,6 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
891
389
  client_hash: z.ZodOptional<z.ZodString>;
892
390
  }, "strip", z.ZodTypeAny, {
893
391
  selection_token: string;
894
- sections: ("MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO")[];
895
392
  ai_selected_stable_ids: string[];
896
393
  ai_selection_reasons: Record<string, string>;
897
394
  client_hash?: string | undefined;
@@ -899,7 +396,6 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
899
396
  session_id?: string | undefined;
900
397
  }, {
901
398
  selection_token: string;
902
- sections: ("MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO")[];
903
399
  ai_selected_stable_ids: string[];
904
400
  ai_selection_reasons: Record<string, string>;
905
401
  client_hash?: string | undefined;
@@ -908,43 +404,24 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
908
404
  }>;
909
405
  declare const knowledgeSectionsOutputSchema: z.ZodObject<{
910
406
  revision_hash: z.ZodString;
911
- precedence: z.ZodTuple<[z.ZodLiteral<"L2">, z.ZodLiteral<"L1">, z.ZodLiteral<"L0">], null>;
912
407
  selected_stable_ids: z.ZodArray<z.ZodString, "many">;
913
408
  rules: z.ZodArray<z.ZodObject<{
914
409
  stable_id: z.ZodString;
915
410
  level: z.ZodEnum<["L0", "L1", "L2"]>;
916
411
  path: z.ZodString;
917
- sections: z.ZodRecord<z.ZodString, z.ZodString>;
412
+ body: z.ZodString;
918
413
  }, "strip", z.ZodTypeAny, {
919
414
  path: string;
920
415
  stable_id: string;
921
416
  level: "L0" | "L1" | "L2";
922
- sections: Record<string, string>;
417
+ body: string;
923
418
  }, {
924
419
  path: string;
925
420
  stable_id: string;
926
421
  level: "L0" | "L1" | "L2";
927
- sections: Record<string, string>;
422
+ body: string;
928
423
  }>, "many">;
929
- diagnostics: z.ZodArray<z.ZodDiscriminatedUnion<"code", [z.ZodObject<{
930
- code: z.ZodLiteral<"missing_section">;
931
- severity: z.ZodLiteral<"warn">;
932
- stable_id: z.ZodString;
933
- section: z.ZodEnum<["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"]>;
934
- message: z.ZodString;
935
- }, "strip", z.ZodTypeAny, {
936
- code: "missing_section";
937
- message: string;
938
- stable_id: string;
939
- severity: "warn";
940
- section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
941
- }, {
942
- code: "missing_section";
943
- message: string;
944
- stable_id: string;
945
- severity: "warn";
946
- section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
947
- }>, z.ZodObject<{
424
+ diagnostics: z.ZodArray<z.ZodObject<{
948
425
  code: z.ZodLiteral<"missing_knowledge_metadata">;
949
426
  severity: z.ZodLiteral<"warn">;
950
427
  stable_id: z.ZodString;
@@ -959,90 +436,76 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
959
436
  message: string;
960
437
  stable_id: string;
961
438
  severity: "warn";
962
- }>]>, "many">;
963
- redirect_to: z.ZodOptional<z.ZodObject<{
439
+ }>, "many">;
440
+ redirect_to: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
964
441
  stable_id: z.ZodString;
965
442
  }, "strip", z.ZodTypeAny, {
966
443
  stable_id: string;
967
444
  }, {
968
445
  stable_id: string;
969
- }>>;
446
+ }>, z.ZodRecord<z.ZodString, z.ZodString>]>>;
970
447
  warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
971
448
  code: z.ZodString;
972
449
  file: z.ZodString;
973
450
  line: z.ZodOptional<z.ZodNumber>;
974
451
  action_hint: z.ZodString;
975
452
  }, "strip", z.ZodTypeAny, {
976
- file: string;
977
453
  code: string;
454
+ file: string;
978
455
  action_hint: string;
979
456
  line?: number | undefined;
980
457
  }, {
981
- file: string;
982
458
  code: string;
459
+ file: string;
983
460
  action_hint: string;
984
461
  line?: number | undefined;
985
462
  }>, "many">>;
986
463
  }, "strip", z.ZodTypeAny, {
987
464
  revision_hash: string;
465
+ selected_stable_ids: string[];
988
466
  rules: {
989
467
  path: string;
990
468
  stable_id: string;
991
469
  level: "L0" | "L1" | "L2";
992
- sections: Record<string, string>;
470
+ body: string;
993
471
  }[];
994
- precedence: ["L2", "L1", "L0"];
995
- selected_stable_ids: string[];
996
- diagnostics: ({
997
- code: "missing_section";
998
- message: string;
999
- stable_id: string;
1000
- severity: "warn";
1001
- section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
1002
- } | {
472
+ diagnostics: {
1003
473
  code: "missing_knowledge_metadata";
1004
474
  message: string;
1005
475
  stable_id: string;
1006
476
  severity: "warn";
1007
- })[];
477
+ }[];
1008
478
  warnings?: {
1009
- file: string;
1010
479
  code: string;
480
+ file: string;
1011
481
  action_hint: string;
1012
482
  line?: number | undefined;
1013
483
  }[] | undefined;
1014
- redirect_to?: {
484
+ redirect_to?: Record<string, string> | {
1015
485
  stable_id: string;
1016
486
  } | undefined;
1017
487
  }, {
1018
488
  revision_hash: string;
489
+ selected_stable_ids: string[];
1019
490
  rules: {
1020
491
  path: string;
1021
492
  stable_id: string;
1022
493
  level: "L0" | "L1" | "L2";
1023
- sections: Record<string, string>;
494
+ body: string;
1024
495
  }[];
1025
- precedence: ["L2", "L1", "L0"];
1026
- selected_stable_ids: string[];
1027
- diagnostics: ({
1028
- code: "missing_section";
1029
- message: string;
1030
- stable_id: string;
1031
- severity: "warn";
1032
- section: "MISSION_STATEMENT" | "MANDATORY_INJECTION" | "BUSINESS_LOGIC_CHUNKS" | "CONTEXT_INFO";
1033
- } | {
496
+ diagnostics: {
1034
497
  code: "missing_knowledge_metadata";
1035
498
  message: string;
1036
499
  stable_id: string;
1037
500
  severity: "warn";
1038
- })[];
501
+ }[];
1039
502
  warnings?: {
1040
- file: string;
1041
503
  code: string;
504
+ file: string;
1042
505
  action_hint: string;
1043
506
  line?: number | undefined;
1044
507
  }[] | undefined;
1045
- redirect_to?: {
508
+ redirect_to?: Record<string, string> | {
1046
509
  stable_id: string;
1047
510
  } | undefined;
1048
511
  }>;
@@ -1053,63 +516,555 @@ declare const knowledgeSectionsAnnotations: {
1053
516
  readonly openWorldHint: false;
1054
517
  readonly title: "Filter rule sections";
1055
518
  };
1056
- declare const ProposedReasonSchema: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1057
- type ProposedReason = z.infer<typeof ProposedReasonSchema>;
1058
- declare const PROPOSED_REASON_DESCRIPTIONS: Record<ProposedReason, string>;
1059
- declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
1060
- source_sessions: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
1061
- source_session: z.ZodOptional<z.ZodString>;
1062
- recent_paths: z.ZodArray<z.ZodString, "many">;
1063
- user_messages_summary: z.ZodString;
1064
- type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1065
- slug: z.ZodString;
1066
- layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1067
- proposed_reason: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1068
- session_context: z.ZodString;
519
+ declare const recallInputSchema: z.ZodObject<{
520
+ paths: z.ZodArray<z.ZodString, "many">;
521
+ intent: z.ZodOptional<z.ZodString>;
522
+ known_tech: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
523
+ detected_entities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
524
+ client_hash: z.ZodOptional<z.ZodString>;
525
+ correlation_id: z.ZodOptional<z.ZodString>;
526
+ session_id: z.ZodOptional<z.ZodString>;
527
+ layer_filter: z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>;
528
+ target_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
529
+ ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1069
530
  }, "strip", z.ZodTypeAny, {
1070
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1071
- recent_paths: string[];
1072
- user_messages_summary: string;
1073
- slug: string;
1074
- proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1075
- session_context: string;
1076
- layer?: "personal" | "team" | undefined;
1077
- source_sessions?: string[] | undefined;
1078
- source_session?: string | undefined;
531
+ paths: string[];
532
+ known_tech?: string[] | undefined;
533
+ detected_entities?: Record<string, string[]> | undefined;
534
+ intent?: string | undefined;
535
+ client_hash?: string | undefined;
536
+ correlation_id?: string | undefined;
537
+ session_id?: string | undefined;
538
+ layer_filter?: "personal" | "team" | "both" | undefined;
539
+ target_paths?: string[] | undefined;
540
+ ids?: string[] | undefined;
1079
541
  }, {
1080
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1081
- recent_paths: string[];
1082
- user_messages_summary: string;
1083
- slug: string;
1084
- proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1085
- session_context: string;
1086
- layer?: "personal" | "team" | undefined;
1087
- source_sessions?: unknown;
1088
- source_session?: string | undefined;
1089
- }>, {
1090
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1091
- recent_paths: string[];
1092
- user_messages_summary: string;
1093
- slug: string;
1094
- proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1095
- session_context: string;
1096
- layer?: "personal" | "team" | undefined;
542
+ paths: string[];
543
+ known_tech?: string[] | undefined;
544
+ detected_entities?: Record<string, string[]> | undefined;
545
+ intent?: string | undefined;
546
+ client_hash?: string | undefined;
547
+ correlation_id?: string | undefined;
548
+ session_id?: string | undefined;
549
+ layer_filter?: "personal" | "team" | "both" | undefined;
550
+ target_paths?: string[] | undefined;
551
+ ids?: string[] | undefined;
552
+ }>;
553
+ declare const recallOutputSchema: z.ZodObject<{
554
+ revision_hash: z.ZodString;
555
+ stale: z.ZodBoolean;
556
+ selection_token: z.ZodString;
557
+ entries: z.ZodArray<z.ZodObject<{
558
+ path: z.ZodString;
559
+ requirement_profile: z.ZodObject<{
560
+ target_path: z.ZodString;
561
+ known_tech: z.ZodArray<z.ZodString, "many">;
562
+ user_intent: z.ZodString;
563
+ detected_entities: z.ZodArray<z.ZodString, "many">;
564
+ }, "strip", z.ZodTypeAny, {
565
+ target_path: string;
566
+ known_tech: string[];
567
+ user_intent: string;
568
+ detected_entities: string[];
569
+ }, {
570
+ target_path: string;
571
+ known_tech: string[];
572
+ user_intent: string;
573
+ detected_entities: string[];
574
+ }>;
575
+ }, "strip", z.ZodTypeAny, {
576
+ path: string;
577
+ requirement_profile: {
578
+ target_path: string;
579
+ known_tech: string[];
580
+ user_intent: string;
581
+ detected_entities: string[];
582
+ };
583
+ }, {
584
+ path: string;
585
+ requirement_profile: {
586
+ target_path: string;
587
+ known_tech: string[];
588
+ user_intent: string;
589
+ detected_entities: string[];
590
+ };
591
+ }>, "many">;
592
+ candidates: z.ZodArray<z.ZodObject<{
593
+ stable_id: z.ZodString;
594
+ description: z.ZodObject<{
595
+ summary: z.ZodString;
596
+ intent_clues: z.ZodArray<z.ZodString, "many">;
597
+ tech_stack: z.ZodArray<z.ZodString, "many">;
598
+ impact: z.ZodArray<z.ZodString, "many">;
599
+ must_read_if: z.ZodString;
600
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
601
+ id: z.ZodOptional<z.ZodString>;
602
+ knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
603
+ maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
604
+ knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
605
+ layer_reason: z.ZodOptional<z.ZodString>;
606
+ created_at: z.ZodOptional<z.ZodString>;
607
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
608
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
609
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
610
+ }, "strip", z.ZodTypeAny, {
611
+ summary: string;
612
+ intent_clues: string[];
613
+ tech_stack: string[];
614
+ impact: string[];
615
+ must_read_if: string;
616
+ relevance_scope?: "narrow" | "broad" | undefined;
617
+ relevance_paths?: string[] | undefined;
618
+ entities?: string[] | undefined;
619
+ id?: string | undefined;
620
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
621
+ maturity?: "draft" | "verified" | "proven" | undefined;
622
+ knowledge_layer?: "personal" | "team" | undefined;
623
+ layer_reason?: string | undefined;
624
+ created_at?: string | undefined;
625
+ tags?: string[] | undefined;
626
+ }, {
627
+ summary: string;
628
+ intent_clues: string[];
629
+ tech_stack: string[];
630
+ impact: string[];
631
+ must_read_if: string;
632
+ relevance_scope?: "narrow" | "broad" | undefined;
633
+ relevance_paths?: string[] | undefined;
634
+ entities?: string[] | undefined;
635
+ id?: string | undefined;
636
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
637
+ maturity?: "draft" | "verified" | "proven" | undefined;
638
+ knowledge_layer?: "personal" | "team" | undefined;
639
+ layer_reason?: string | undefined;
640
+ created_at?: string | undefined;
641
+ tags?: string[] | undefined;
642
+ }>;
643
+ }, "strip", z.ZodTypeAny, {
644
+ description: {
645
+ summary: string;
646
+ intent_clues: string[];
647
+ tech_stack: string[];
648
+ impact: string[];
649
+ must_read_if: string;
650
+ relevance_scope?: "narrow" | "broad" | undefined;
651
+ relevance_paths?: string[] | undefined;
652
+ entities?: string[] | undefined;
653
+ id?: string | undefined;
654
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
655
+ maturity?: "draft" | "verified" | "proven" | undefined;
656
+ knowledge_layer?: "personal" | "team" | undefined;
657
+ layer_reason?: string | undefined;
658
+ created_at?: string | undefined;
659
+ tags?: string[] | undefined;
660
+ };
661
+ stable_id: string;
662
+ }, {
663
+ description: {
664
+ summary: string;
665
+ intent_clues: string[];
666
+ tech_stack: string[];
667
+ impact: string[];
668
+ must_read_if: string;
669
+ relevance_scope?: "narrow" | "broad" | undefined;
670
+ relevance_paths?: string[] | undefined;
671
+ entities?: string[] | undefined;
672
+ id?: string | undefined;
673
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
674
+ maturity?: "draft" | "verified" | "proven" | undefined;
675
+ knowledge_layer?: "personal" | "team" | undefined;
676
+ layer_reason?: string | undefined;
677
+ created_at?: string | undefined;
678
+ tags?: string[] | undefined;
679
+ };
680
+ stable_id: string;
681
+ }>, "many">;
682
+ preflight_diagnostics: z.ZodArray<z.ZodObject<{
683
+ code: z.ZodEnum<["missing_description", "empty_shell_suppressed"]>;
684
+ severity: z.ZodLiteral<"warn">;
685
+ message: z.ZodString;
686
+ stable_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
687
+ path: z.ZodOptional<z.ZodString>;
688
+ }, "strip", z.ZodTypeAny, {
689
+ code: "missing_description" | "empty_shell_suppressed";
690
+ message: string;
691
+ severity: "warn";
692
+ path?: string | undefined;
693
+ stable_ids?: string[] | undefined;
694
+ }, {
695
+ code: "missing_description" | "empty_shell_suppressed";
696
+ message: string;
697
+ severity: "warn";
698
+ path?: string | undefined;
699
+ stable_ids?: string[] | undefined;
700
+ }>, "many">;
701
+ rules: z.ZodArray<z.ZodObject<{
702
+ stable_id: z.ZodString;
703
+ level: z.ZodEnum<["L0", "L1", "L2"]>;
704
+ path: z.ZodString;
705
+ body: z.ZodString;
706
+ }, "strip", z.ZodTypeAny, {
707
+ path: string;
708
+ stable_id: string;
709
+ level: "L0" | "L1" | "L2";
710
+ body: string;
711
+ }, {
712
+ path: string;
713
+ stable_id: string;
714
+ level: "L0" | "L1" | "L2";
715
+ body: string;
716
+ }>, "many">;
717
+ selected_stable_ids: z.ZodArray<z.ZodString, "many">;
718
+ diagnostics: z.ZodArray<z.ZodObject<{
719
+ code: z.ZodLiteral<"missing_knowledge_metadata">;
720
+ severity: z.ZodLiteral<"warn">;
721
+ stable_id: z.ZodString;
722
+ message: z.ZodString;
723
+ }, "strip", z.ZodTypeAny, {
724
+ code: "missing_knowledge_metadata";
725
+ message: string;
726
+ stable_id: string;
727
+ severity: "warn";
728
+ }, {
729
+ code: "missing_knowledge_metadata";
730
+ message: string;
731
+ stable_id: string;
732
+ severity: "warn";
733
+ }>, "many">;
734
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
735
+ code: z.ZodString;
736
+ file: z.ZodString;
737
+ line: z.ZodOptional<z.ZodNumber>;
738
+ action_hint: z.ZodString;
739
+ }, "strip", z.ZodTypeAny, {
740
+ code: string;
741
+ file: string;
742
+ action_hint: string;
743
+ line?: number | undefined;
744
+ }, {
745
+ code: string;
746
+ file: string;
747
+ action_hint: string;
748
+ line?: number | undefined;
749
+ }>, "many">>;
750
+ auto_healed: z.ZodOptional<z.ZodBoolean>;
751
+ previous_revision_hash: z.ZodOptional<z.ZodString>;
752
+ redirects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
753
+ }, "strip", z.ZodTypeAny, {
754
+ entries: {
755
+ path: string;
756
+ requirement_profile: {
757
+ target_path: string;
758
+ known_tech: string[];
759
+ user_intent: string;
760
+ detected_entities: string[];
761
+ };
762
+ }[];
763
+ stale: boolean;
764
+ revision_hash: string;
765
+ selection_token: string;
766
+ candidates: {
767
+ description: {
768
+ summary: string;
769
+ intent_clues: string[];
770
+ tech_stack: string[];
771
+ impact: string[];
772
+ must_read_if: string;
773
+ relevance_scope?: "narrow" | "broad" | undefined;
774
+ relevance_paths?: string[] | undefined;
775
+ entities?: string[] | undefined;
776
+ id?: string | undefined;
777
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
778
+ maturity?: "draft" | "verified" | "proven" | undefined;
779
+ knowledge_layer?: "personal" | "team" | undefined;
780
+ layer_reason?: string | undefined;
781
+ created_at?: string | undefined;
782
+ tags?: string[] | undefined;
783
+ };
784
+ stable_id: string;
785
+ }[];
786
+ preflight_diagnostics: {
787
+ code: "missing_description" | "empty_shell_suppressed";
788
+ message: string;
789
+ severity: "warn";
790
+ path?: string | undefined;
791
+ stable_ids?: string[] | undefined;
792
+ }[];
793
+ selected_stable_ids: string[];
794
+ rules: {
795
+ path: string;
796
+ stable_id: string;
797
+ level: "L0" | "L1" | "L2";
798
+ body: string;
799
+ }[];
800
+ diagnostics: {
801
+ code: "missing_knowledge_metadata";
802
+ message: string;
803
+ stable_id: string;
804
+ severity: "warn";
805
+ }[];
806
+ warnings?: {
807
+ code: string;
808
+ file: string;
809
+ action_hint: string;
810
+ line?: number | undefined;
811
+ }[] | undefined;
812
+ auto_healed?: boolean | undefined;
813
+ previous_revision_hash?: string | undefined;
814
+ redirects?: Record<string, string> | undefined;
815
+ }, {
816
+ entries: {
817
+ path: string;
818
+ requirement_profile: {
819
+ target_path: string;
820
+ known_tech: string[];
821
+ user_intent: string;
822
+ detected_entities: string[];
823
+ };
824
+ }[];
825
+ stale: boolean;
826
+ revision_hash: string;
827
+ selection_token: string;
828
+ candidates: {
829
+ description: {
830
+ summary: string;
831
+ intent_clues: string[];
832
+ tech_stack: string[];
833
+ impact: string[];
834
+ must_read_if: string;
835
+ relevance_scope?: "narrow" | "broad" | undefined;
836
+ relevance_paths?: string[] | undefined;
837
+ entities?: string[] | undefined;
838
+ id?: string | undefined;
839
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
840
+ maturity?: "draft" | "verified" | "proven" | undefined;
841
+ knowledge_layer?: "personal" | "team" | undefined;
842
+ layer_reason?: string | undefined;
843
+ created_at?: string | undefined;
844
+ tags?: string[] | undefined;
845
+ };
846
+ stable_id: string;
847
+ }[];
848
+ preflight_diagnostics: {
849
+ code: "missing_description" | "empty_shell_suppressed";
850
+ message: string;
851
+ severity: "warn";
852
+ path?: string | undefined;
853
+ stable_ids?: string[] | undefined;
854
+ }[];
855
+ selected_stable_ids: string[];
856
+ rules: {
857
+ path: string;
858
+ stable_id: string;
859
+ level: "L0" | "L1" | "L2";
860
+ body: string;
861
+ }[];
862
+ diagnostics: {
863
+ code: "missing_knowledge_metadata";
864
+ message: string;
865
+ stable_id: string;
866
+ severity: "warn";
867
+ }[];
868
+ warnings?: {
869
+ code: string;
870
+ file: string;
871
+ action_hint: string;
872
+ line?: number | undefined;
873
+ }[] | undefined;
874
+ auto_healed?: boolean | undefined;
875
+ previous_revision_hash?: string | undefined;
876
+ redirects?: Record<string, string> | undefined;
877
+ }>;
878
+ declare const recallAnnotations: {
879
+ readonly readOnlyHint: true;
880
+ readonly idempotentHint: true;
881
+ readonly destructiveHint: false;
882
+ readonly openWorldHint: false;
883
+ readonly title: "Recall Fabric knowledge (one-call)";
884
+ };
885
+ declare const archiveScanInputSchema: z.ZodObject<{
886
+ range: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodLiteral<"all">]>>;
887
+ now_ms: z.ZodOptional<z.ZodNumber>;
888
+ correlation_id: z.ZodOptional<z.ZodString>;
889
+ session_id: z.ZodOptional<z.ZodString>;
890
+ }, "strip", z.ZodTypeAny, {
891
+ correlation_id?: string | undefined;
892
+ session_id?: string | undefined;
893
+ range?: string[] | "all" | undefined;
894
+ now_ms?: number | undefined;
895
+ }, {
896
+ correlation_id?: string | undefined;
897
+ session_id?: string | undefined;
898
+ range?: string[] | "all" | undefined;
899
+ now_ms?: number | undefined;
900
+ }>;
901
+ declare const archiveScanOutputSchema: z.ZodObject<{
902
+ anchor_ts: z.ZodNullable<z.ZodNumber>;
903
+ session_ids: z.ZodArray<z.ZodString, "many">;
904
+ dropped: z.ZodArray<z.ZodObject<{
905
+ session_id: z.ZodString;
906
+ reason: z.ZodEnum<["user_dismissed", "cooldown", "no_new_signal"]>;
907
+ }, "strip", z.ZodTypeAny, {
908
+ session_id: string;
909
+ reason: "user_dismissed" | "cooldown" | "no_new_signal";
910
+ }, {
911
+ session_id: string;
912
+ reason: "user_dismissed" | "cooldown" | "no_new_signal";
913
+ }>, "many">;
914
+ covered_through_ts: z.ZodNullable<z.ZodNumber>;
915
+ already_proposed_keys: z.ZodArray<z.ZodString, "many">;
916
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
917
+ code: z.ZodString;
918
+ file: z.ZodString;
919
+ line: z.ZodOptional<z.ZodNumber>;
920
+ action_hint: z.ZodString;
921
+ }, "strip", z.ZodTypeAny, {
922
+ code: string;
923
+ file: string;
924
+ action_hint: string;
925
+ line?: number | undefined;
926
+ }, {
927
+ code: string;
928
+ file: string;
929
+ action_hint: string;
930
+ line?: number | undefined;
931
+ }>, "many">>;
932
+ }, "strip", z.ZodTypeAny, {
933
+ anchor_ts: number | null;
934
+ session_ids: string[];
935
+ dropped: {
936
+ session_id: string;
937
+ reason: "user_dismissed" | "cooldown" | "no_new_signal";
938
+ }[];
939
+ covered_through_ts: number | null;
940
+ already_proposed_keys: string[];
941
+ warnings?: {
942
+ code: string;
943
+ file: string;
944
+ action_hint: string;
945
+ line?: number | undefined;
946
+ }[] | undefined;
947
+ }, {
948
+ anchor_ts: number | null;
949
+ session_ids: string[];
950
+ dropped: {
951
+ session_id: string;
952
+ reason: "user_dismissed" | "cooldown" | "no_new_signal";
953
+ }[];
954
+ covered_through_ts: number | null;
955
+ already_proposed_keys: string[];
956
+ warnings?: {
957
+ code: string;
958
+ file: string;
959
+ action_hint: string;
960
+ line?: number | undefined;
961
+ }[] | undefined;
962
+ }>;
963
+ declare const archiveScanAnnotations: {
964
+ readonly readOnlyHint: true;
965
+ readonly idempotentHint: true;
966
+ readonly destructiveHint: false;
967
+ readonly openWorldHint: false;
968
+ readonly title: "Scan event ledger for archive candidates (deterministic)";
969
+ };
970
+ type ArchiveScanInput = z.infer<typeof archiveScanInputSchema>;
971
+ type ArchiveScanOutput = z.infer<typeof archiveScanOutputSchema>;
972
+ declare const ProposedReasonSchema: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
973
+ type ProposedReason = z.infer<typeof ProposedReasonSchema>;
974
+ declare const PROPOSED_REASON_DESCRIPTIONS: Record<ProposedReason, string>;
975
+ declare const FabExtractKnowledgeInputSchema: z.ZodEffects<z.ZodObject<{
976
+ source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
977
+ recent_paths: z.ZodArray<z.ZodString, "many">;
978
+ user_messages_summary: z.ZodString;
979
+ type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
980
+ slug: z.ZodString;
981
+ layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
982
+ proposed_reason: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
983
+ session_context: z.ZodString;
984
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
985
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
986
+ intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
987
+ tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
988
+ impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
989
+ must_read_if: z.ZodOptional<z.ZodString>;
990
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
991
+ onboard_slot: z.ZodOptional<z.ZodEnum<["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"]>>;
992
+ evidence_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
993
+ }, "strip", z.ZodTypeAny, {
994
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
995
+ proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
996
+ session_context: string;
997
+ recent_paths: string[];
998
+ user_messages_summary: string;
999
+ slug: string;
1000
+ relevance_scope?: "narrow" | "broad" | undefined;
1001
+ relevance_paths?: string[] | undefined;
1097
1002
  source_sessions?: string[] | undefined;
1098
- source_session?: string | undefined;
1003
+ layer?: "personal" | "team" | undefined;
1004
+ intent_clues?: string[] | undefined;
1005
+ tech_stack?: string[] | undefined;
1006
+ impact?: string[] | undefined;
1007
+ must_read_if?: string | undefined;
1008
+ tags?: string[] | undefined;
1009
+ onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
1010
+ evidence_paths?: string[] | undefined;
1099
1011
  }, {
1100
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1012
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1013
+ proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1014
+ session_context: string;
1015
+ recent_paths: string[];
1016
+ user_messages_summary: string;
1017
+ slug: string;
1018
+ relevance_scope?: "narrow" | "broad" | undefined;
1019
+ relevance_paths?: string[] | undefined;
1020
+ source_sessions?: string[] | undefined;
1021
+ layer?: "personal" | "team" | undefined;
1022
+ intent_clues?: string[] | undefined;
1023
+ tech_stack?: string[] | undefined;
1024
+ impact?: string[] | undefined;
1025
+ must_read_if?: string | undefined;
1026
+ tags?: string[] | undefined;
1027
+ onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
1028
+ evidence_paths?: string[] | undefined;
1029
+ }>, {
1030
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1031
+ proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1032
+ session_context: string;
1101
1033
  recent_paths: string[];
1102
1034
  user_messages_summary: string;
1103
1035
  slug: string;
1036
+ relevance_scope?: "narrow" | "broad" | undefined;
1037
+ relevance_paths?: string[] | undefined;
1038
+ source_sessions?: string[] | undefined;
1039
+ layer?: "personal" | "team" | undefined;
1040
+ intent_clues?: string[] | undefined;
1041
+ tech_stack?: string[] | undefined;
1042
+ impact?: string[] | undefined;
1043
+ must_read_if?: string | undefined;
1044
+ tags?: string[] | undefined;
1045
+ onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
1046
+ evidence_paths?: string[] | undefined;
1047
+ }, {
1048
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1104
1049
  proposed_reason: "explicit-user-mark" | "diagnostic-then-fix" | "decision-confirmation" | "wrong-turn-revert" | "new-dependency-or-pattern" | "dismissal-with-reason";
1105
1050
  session_context: string;
1051
+ recent_paths: string[];
1052
+ user_messages_summary: string;
1053
+ slug: string;
1054
+ relevance_scope?: "narrow" | "broad" | undefined;
1055
+ relevance_paths?: string[] | undefined;
1056
+ source_sessions?: string[] | undefined;
1106
1057
  layer?: "personal" | "team" | undefined;
1107
- source_sessions?: unknown;
1108
- source_session?: string | undefined;
1058
+ intent_clues?: string[] | undefined;
1059
+ tech_stack?: string[] | undefined;
1060
+ impact?: string[] | undefined;
1061
+ must_read_if?: string | undefined;
1062
+ tags?: string[] | undefined;
1063
+ onboard_slot?: "tech-stack-decision" | "architecture-pattern" | "code-style-tone" | "build-system-idiom" | "domain-vocabulary" | undefined;
1064
+ evidence_paths?: string[] | undefined;
1109
1065
  }>;
1110
1066
  declare const FabExtractKnowledgeInputShape: {
1111
- source_sessions: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
1112
- source_session: z.ZodOptional<z.ZodString>;
1067
+ source_sessions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1113
1068
  recent_paths: z.ZodArray<z.ZodString, "many">;
1114
1069
  user_messages_summary: z.ZodString;
1115
1070
  type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
@@ -1117,17 +1072,54 @@ declare const FabExtractKnowledgeInputShape: {
1117
1072
  layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1118
1073
  proposed_reason: z.ZodEnum<["explicit-user-mark", "diagnostic-then-fix", "decision-confirmation", "wrong-turn-revert", "new-dependency-or-pattern", "dismissal-with-reason"]>;
1119
1074
  session_context: z.ZodString;
1075
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1076
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1077
+ intent_clues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1078
+ tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1079
+ impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1080
+ must_read_if: z.ZodOptional<z.ZodString>;
1081
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1082
+ onboard_slot: z.ZodOptional<z.ZodEnum<["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"]>>;
1083
+ evidence_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1120
1084
  };
1121
1085
  type FabExtractKnowledgeInput = z.infer<typeof FabExtractKnowledgeInputSchema>;
1122
1086
  declare const FabExtractKnowledgeOutputSchema: z.ZodObject<{
1123
1087
  pending_path: z.ZodString;
1124
1088
  idempotency_key: z.ZodString;
1089
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1090
+ code: z.ZodString;
1091
+ file: z.ZodString;
1092
+ line: z.ZodOptional<z.ZodNumber>;
1093
+ action_hint: z.ZodString;
1094
+ }, "strip", z.ZodTypeAny, {
1095
+ code: string;
1096
+ file: string;
1097
+ action_hint: string;
1098
+ line?: number | undefined;
1099
+ }, {
1100
+ code: string;
1101
+ file: string;
1102
+ action_hint: string;
1103
+ line?: number | undefined;
1104
+ }>, "many">>;
1125
1105
  }, "strip", z.ZodTypeAny, {
1126
1106
  pending_path: string;
1127
1107
  idempotency_key: string;
1108
+ warnings?: {
1109
+ code: string;
1110
+ file: string;
1111
+ action_hint: string;
1112
+ line?: number | undefined;
1113
+ }[] | undefined;
1128
1114
  }, {
1129
1115
  pending_path: string;
1130
1116
  idempotency_key: string;
1117
+ warnings?: {
1118
+ code: string;
1119
+ file: string;
1120
+ action_hint: string;
1121
+ line?: number | undefined;
1122
+ }[] | undefined;
1131
1123
  }>;
1132
1124
  type FabExtractKnowledgeOutput = z.infer<typeof FabExtractKnowledgeOutputSchema>;
1133
1125
  declare const fabExtractKnowledgeAnnotations: {
@@ -1145,36 +1137,51 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1145
1137
  maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1146
1138
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1147
1139
  created_after: z.ZodOptional<z.ZodString>;
1140
+ include_rejected: z.ZodOptional<z.ZodBoolean>;
1141
+ include_deferred: z.ZodOptional<z.ZodBoolean>;
1142
+ include_body: z.ZodOptional<z.ZodBoolean>;
1148
1143
  }, "strip", z.ZodTypeAny, {
1149
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1150
- maturity?: "draft" | "verified" | "proven" | undefined;
1144
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1151
1145
  layer?: "personal" | "team" | "both" | undefined;
1146
+ maturity?: "draft" | "verified" | "proven" | undefined;
1152
1147
  tags?: string[] | undefined;
1153
1148
  created_after?: string | undefined;
1149
+ include_rejected?: boolean | undefined;
1150
+ include_deferred?: boolean | undefined;
1151
+ include_body?: boolean | undefined;
1154
1152
  }, {
1155
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1156
- maturity?: "draft" | "verified" | "proven" | undefined;
1153
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1157
1154
  layer?: "personal" | "team" | "both" | undefined;
1155
+ maturity?: "draft" | "verified" | "proven" | undefined;
1158
1156
  tags?: string[] | undefined;
1159
1157
  created_after?: string | undefined;
1158
+ include_rejected?: boolean | undefined;
1159
+ include_deferred?: boolean | undefined;
1160
+ include_body?: boolean | undefined;
1160
1161
  }>>;
1161
1162
  }, "strip", z.ZodTypeAny, {
1162
1163
  action: "list";
1163
1164
  filters?: {
1164
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1165
- maturity?: "draft" | "verified" | "proven" | undefined;
1165
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1166
1166
  layer?: "personal" | "team" | "both" | undefined;
1167
+ maturity?: "draft" | "verified" | "proven" | undefined;
1167
1168
  tags?: string[] | undefined;
1168
1169
  created_after?: string | undefined;
1170
+ include_rejected?: boolean | undefined;
1171
+ include_deferred?: boolean | undefined;
1172
+ include_body?: boolean | undefined;
1169
1173
  } | undefined;
1170
1174
  }, {
1171
1175
  action: "list";
1172
1176
  filters?: {
1173
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1174
- maturity?: "draft" | "verified" | "proven" | undefined;
1177
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1175
1178
  layer?: "personal" | "team" | "both" | undefined;
1179
+ maturity?: "draft" | "verified" | "proven" | undefined;
1176
1180
  tags?: string[] | undefined;
1177
1181
  created_after?: string | undefined;
1182
+ include_rejected?: boolean | undefined;
1183
+ include_deferred?: boolean | undefined;
1184
+ include_body?: boolean | undefined;
1178
1185
  } | undefined;
1179
1186
  }>, z.ZodObject<{
1180
1187
  action: z.ZodLiteral<"approve">;
@@ -1190,13 +1197,13 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1190
1197
  pending_paths: z.ZodArray<z.ZodString, "many">;
1191
1198
  reason: z.ZodString;
1192
1199
  }, "strip", z.ZodTypeAny, {
1200
+ reason: string;
1193
1201
  action: "reject";
1194
1202
  pending_paths: string[];
1195
- reason: string;
1196
1203
  }, {
1204
+ reason: string;
1197
1205
  action: "reject";
1198
1206
  pending_paths: string[];
1199
- reason: string;
1200
1207
  }>, z.ZodObject<{
1201
1208
  action: z.ZodLiteral<"modify">;
1202
1209
  pending_path: z.ZodString;
@@ -1209,44 +1216,149 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1209
1216
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1210
1217
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1211
1218
  }, "strip", z.ZodTypeAny, {
1219
+ relevance_scope?: "narrow" | "broad" | undefined;
1220
+ relevance_paths?: string[] | undefined;
1221
+ layer?: "personal" | "team" | undefined;
1212
1222
  summary?: string | undefined;
1213
1223
  maturity?: "draft" | "verified" | "proven" | undefined;
1224
+ tags?: string[] | undefined;
1225
+ title?: string | undefined;
1226
+ }, {
1227
+ relevance_scope?: "narrow" | "broad" | undefined;
1228
+ relevance_paths?: string[] | undefined;
1214
1229
  layer?: "personal" | "team" | undefined;
1230
+ summary?: string | undefined;
1231
+ maturity?: "draft" | "verified" | "proven" | undefined;
1215
1232
  tags?: string[] | undefined;
1233
+ title?: string | undefined;
1234
+ }>;
1235
+ }, "strip", z.ZodTypeAny, {
1236
+ pending_path: string;
1237
+ action: "modify";
1238
+ changes: {
1216
1239
  relevance_scope?: "narrow" | "broad" | undefined;
1217
1240
  relevance_paths?: string[] | undefined;
1241
+ layer?: "personal" | "team" | undefined;
1242
+ summary?: string | undefined;
1243
+ maturity?: "draft" | "verified" | "proven" | undefined;
1244
+ tags?: string[] | undefined;
1218
1245
  title?: string | undefined;
1219
- }, {
1246
+ };
1247
+ }, {
1248
+ pending_path: string;
1249
+ action: "modify";
1250
+ changes: {
1251
+ relevance_scope?: "narrow" | "broad" | undefined;
1252
+ relevance_paths?: string[] | undefined;
1253
+ layer?: "personal" | "team" | undefined;
1220
1254
  summary?: string | undefined;
1221
1255
  maturity?: "draft" | "verified" | "proven" | undefined;
1256
+ tags?: string[] | undefined;
1257
+ title?: string | undefined;
1258
+ };
1259
+ }>, z.ZodObject<{
1260
+ action: z.ZodLiteral<"modify-content">;
1261
+ pending_path: z.ZodString;
1262
+ changes: z.ZodObject<{
1263
+ title: z.ZodOptional<z.ZodString>;
1264
+ summary: z.ZodOptional<z.ZodString>;
1265
+ layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1266
+ maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1267
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1268
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1269
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1270
+ }, "strip", z.ZodTypeAny, {
1271
+ relevance_scope?: "narrow" | "broad" | undefined;
1272
+ relevance_paths?: string[] | undefined;
1222
1273
  layer?: "personal" | "team" | undefined;
1274
+ summary?: string | undefined;
1275
+ maturity?: "draft" | "verified" | "proven" | undefined;
1223
1276
  tags?: string[] | undefined;
1277
+ title?: string | undefined;
1278
+ }, {
1224
1279
  relevance_scope?: "narrow" | "broad" | undefined;
1225
1280
  relevance_paths?: string[] | undefined;
1281
+ layer?: "personal" | "team" | undefined;
1282
+ summary?: string | undefined;
1283
+ maturity?: "draft" | "verified" | "proven" | undefined;
1284
+ tags?: string[] | undefined;
1226
1285
  title?: string | undefined;
1227
1286
  }>;
1228
1287
  }, "strip", z.ZodTypeAny, {
1229
1288
  pending_path: string;
1230
- action: "modify";
1289
+ action: "modify-content";
1231
1290
  changes: {
1291
+ relevance_scope?: "narrow" | "broad" | undefined;
1292
+ relevance_paths?: string[] | undefined;
1293
+ layer?: "personal" | "team" | undefined;
1232
1294
  summary?: string | undefined;
1233
1295
  maturity?: "draft" | "verified" | "proven" | undefined;
1234
- layer?: "personal" | "team" | undefined;
1235
1296
  tags?: string[] | undefined;
1297
+ title?: string | undefined;
1298
+ };
1299
+ }, {
1300
+ pending_path: string;
1301
+ action: "modify-content";
1302
+ changes: {
1236
1303
  relevance_scope?: "narrow" | "broad" | undefined;
1237
1304
  relevance_paths?: string[] | undefined;
1305
+ layer?: "personal" | "team" | undefined;
1306
+ summary?: string | undefined;
1307
+ maturity?: "draft" | "verified" | "proven" | undefined;
1308
+ tags?: string[] | undefined;
1238
1309
  title?: string | undefined;
1239
1310
  };
1240
- }, {
1311
+ }>, z.ZodObject<{
1312
+ action: z.ZodLiteral<"modify-layer">;
1313
+ pending_path: z.ZodString;
1314
+ changes: z.ZodObject<{
1315
+ title: z.ZodOptional<z.ZodString>;
1316
+ summary: z.ZodOptional<z.ZodString>;
1317
+ maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1318
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1319
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1320
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1321
+ } & {
1322
+ layer: z.ZodEnum<["team", "personal"]>;
1323
+ }, "strip", z.ZodTypeAny, {
1324
+ layer: "personal" | "team";
1325
+ relevance_scope?: "narrow" | "broad" | undefined;
1326
+ relevance_paths?: string[] | undefined;
1327
+ summary?: string | undefined;
1328
+ maturity?: "draft" | "verified" | "proven" | undefined;
1329
+ tags?: string[] | undefined;
1330
+ title?: string | undefined;
1331
+ }, {
1332
+ layer: "personal" | "team";
1333
+ relevance_scope?: "narrow" | "broad" | undefined;
1334
+ relevance_paths?: string[] | undefined;
1335
+ summary?: string | undefined;
1336
+ maturity?: "draft" | "verified" | "proven" | undefined;
1337
+ tags?: string[] | undefined;
1338
+ title?: string | undefined;
1339
+ }>;
1340
+ }, "strip", z.ZodTypeAny, {
1241
1341
  pending_path: string;
1242
- action: "modify";
1342
+ action: "modify-layer";
1243
1343
  changes: {
1344
+ layer: "personal" | "team";
1345
+ relevance_scope?: "narrow" | "broad" | undefined;
1346
+ relevance_paths?: string[] | undefined;
1244
1347
  summary?: string | undefined;
1245
1348
  maturity?: "draft" | "verified" | "proven" | undefined;
1246
- layer?: "personal" | "team" | undefined;
1247
1349
  tags?: string[] | undefined;
1350
+ title?: string | undefined;
1351
+ };
1352
+ }, {
1353
+ pending_path: string;
1354
+ action: "modify-layer";
1355
+ changes: {
1356
+ layer: "personal" | "team";
1248
1357
  relevance_scope?: "narrow" | "broad" | undefined;
1249
1358
  relevance_paths?: string[] | undefined;
1359
+ summary?: string | undefined;
1360
+ maturity?: "draft" | "verified" | "proven" | undefined;
1361
+ tags?: string[] | undefined;
1250
1362
  title?: string | undefined;
1251
1363
  };
1252
1364
  }>, z.ZodObject<{
@@ -1258,38 +1370,53 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1258
1370
  maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1259
1371
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1260
1372
  created_after: z.ZodOptional<z.ZodString>;
1373
+ include_rejected: z.ZodOptional<z.ZodBoolean>;
1374
+ include_deferred: z.ZodOptional<z.ZodBoolean>;
1375
+ include_body: z.ZodOptional<z.ZodBoolean>;
1261
1376
  }, "strip", z.ZodTypeAny, {
1262
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1263
- maturity?: "draft" | "verified" | "proven" | undefined;
1377
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1264
1378
  layer?: "personal" | "team" | "both" | undefined;
1379
+ maturity?: "draft" | "verified" | "proven" | undefined;
1265
1380
  tags?: string[] | undefined;
1266
1381
  created_after?: string | undefined;
1382
+ include_rejected?: boolean | undefined;
1383
+ include_deferred?: boolean | undefined;
1384
+ include_body?: boolean | undefined;
1267
1385
  }, {
1268
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1269
- maturity?: "draft" | "verified" | "proven" | undefined;
1386
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1270
1387
  layer?: "personal" | "team" | "both" | undefined;
1388
+ maturity?: "draft" | "verified" | "proven" | undefined;
1271
1389
  tags?: string[] | undefined;
1272
1390
  created_after?: string | undefined;
1391
+ include_rejected?: boolean | undefined;
1392
+ include_deferred?: boolean | undefined;
1393
+ include_body?: boolean | undefined;
1273
1394
  }>>;
1274
1395
  }, "strip", z.ZodTypeAny, {
1275
1396
  action: "search";
1276
1397
  query: string;
1277
1398
  filters?: {
1278
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1279
- maturity?: "draft" | "verified" | "proven" | undefined;
1399
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1280
1400
  layer?: "personal" | "team" | "both" | undefined;
1401
+ maturity?: "draft" | "verified" | "proven" | undefined;
1281
1402
  tags?: string[] | undefined;
1282
1403
  created_after?: string | undefined;
1404
+ include_rejected?: boolean | undefined;
1405
+ include_deferred?: boolean | undefined;
1406
+ include_body?: boolean | undefined;
1283
1407
  } | undefined;
1284
1408
  }, {
1285
1409
  action: "search";
1286
1410
  query: string;
1287
1411
  filters?: {
1288
- type?: "decisions" | "pitfalls" | "guidelines" | "models" | "processes" | undefined;
1289
- maturity?: "draft" | "verified" | "proven" | undefined;
1412
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1290
1413
  layer?: "personal" | "team" | "both" | undefined;
1414
+ maturity?: "draft" | "verified" | "proven" | undefined;
1291
1415
  tags?: string[] | undefined;
1292
1416
  created_after?: string | undefined;
1417
+ include_rejected?: boolean | undefined;
1418
+ include_deferred?: boolean | undefined;
1419
+ include_body?: boolean | undefined;
1293
1420
  } | undefined;
1294
1421
  }>, z.ZodObject<{
1295
1422
  action: z.ZodLiteral<"defer">;
@@ -1308,10 +1435,72 @@ declare const FabReviewInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObje
1308
1435
  until?: string | undefined;
1309
1436
  }>]>;
1310
1437
  type FabReviewInput = z.infer<typeof FabReviewInputSchema>;
1438
+ declare const FabReviewInputShape: {
1439
+ readonly action: z.ZodEnum<["list", "approve", "reject", "modify", "modify-content", "modify-layer", "search", "defer"]>;
1440
+ readonly filters: z.ZodOptional<z.ZodObject<{
1441
+ type: z.ZodOptional<z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>>;
1442
+ layer: z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>;
1443
+ maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1444
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1445
+ created_after: z.ZodOptional<z.ZodString>;
1446
+ include_rejected: z.ZodOptional<z.ZodBoolean>;
1447
+ include_deferred: z.ZodOptional<z.ZodBoolean>;
1448
+ include_body: z.ZodOptional<z.ZodBoolean>;
1449
+ }, "strip", z.ZodTypeAny, {
1450
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1451
+ layer?: "personal" | "team" | "both" | undefined;
1452
+ maturity?: "draft" | "verified" | "proven" | undefined;
1453
+ tags?: string[] | undefined;
1454
+ created_after?: string | undefined;
1455
+ include_rejected?: boolean | undefined;
1456
+ include_deferred?: boolean | undefined;
1457
+ include_body?: boolean | undefined;
1458
+ }, {
1459
+ type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1460
+ layer?: "personal" | "team" | "both" | undefined;
1461
+ maturity?: "draft" | "verified" | "proven" | undefined;
1462
+ tags?: string[] | undefined;
1463
+ created_after?: string | undefined;
1464
+ include_rejected?: boolean | undefined;
1465
+ include_deferred?: boolean | undefined;
1466
+ include_body?: boolean | undefined;
1467
+ }>>;
1468
+ readonly pending_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1469
+ readonly pending_path: z.ZodOptional<z.ZodString>;
1470
+ readonly reason: z.ZodOptional<z.ZodString>;
1471
+ readonly changes: z.ZodOptional<z.ZodObject<{
1472
+ title: z.ZodOptional<z.ZodString>;
1473
+ summary: z.ZodOptional<z.ZodString>;
1474
+ layer: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1475
+ maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1476
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1477
+ relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1478
+ relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1479
+ }, "strip", z.ZodTypeAny, {
1480
+ relevance_scope?: "narrow" | "broad" | undefined;
1481
+ relevance_paths?: string[] | undefined;
1482
+ layer?: "personal" | "team" | undefined;
1483
+ summary?: string | undefined;
1484
+ maturity?: "draft" | "verified" | "proven" | undefined;
1485
+ tags?: string[] | undefined;
1486
+ title?: string | undefined;
1487
+ }, {
1488
+ relevance_scope?: "narrow" | "broad" | undefined;
1489
+ relevance_paths?: string[] | undefined;
1490
+ layer?: "personal" | "team" | undefined;
1491
+ summary?: string | undefined;
1492
+ maturity?: "draft" | "verified" | "proven" | undefined;
1493
+ tags?: string[] | undefined;
1494
+ title?: string | undefined;
1495
+ }>>;
1496
+ readonly query: z.ZodOptional<z.ZodString>;
1497
+ readonly until: z.ZodOptional<z.ZodString>;
1498
+ };
1311
1499
  declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
1312
1500
  action: z.ZodLiteral<"list">;
1313
1501
  items: z.ZodArray<z.ZodObject<{
1314
1502
  pending_path: z.ZodString;
1503
+ pending_path_absolute: z.ZodOptional<z.ZodString>;
1315
1504
  type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1316
1505
  layer: z.ZodEnum<["team", "personal"]>;
1317
1506
  maturity: z.ZodEnum<["draft", "verified", "proven"]>;
@@ -1319,101 +1508,234 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1319
1508
  title: z.ZodOptional<z.ZodString>;
1320
1509
  summary: z.ZodOptional<z.ZodString>;
1321
1510
  origin: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1511
+ status: z.ZodOptional<z.ZodEnum<["active", "rejected", "deferred"]>>;
1512
+ deferred_until: z.ZodOptional<z.ZodString>;
1513
+ body: z.ZodOptional<z.ZodString>;
1322
1514
  }, "strip", z.ZodTypeAny, {
1323
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1324
- maturity: "draft" | "verified" | "proven";
1515
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1325
1516
  layer: "personal" | "team";
1326
1517
  pending_path: string;
1518
+ maturity: "draft" | "verified" | "proven";
1519
+ status?: "active" | "rejected" | "deferred" | undefined;
1327
1520
  summary?: string | undefined;
1328
1521
  tags?: string[] | undefined;
1522
+ body?: string | undefined;
1329
1523
  title?: string | undefined;
1524
+ pending_path_absolute?: string | undefined;
1330
1525
  origin?: "personal" | "team" | undefined;
1526
+ deferred_until?: string | undefined;
1331
1527
  }, {
1332
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1333
- maturity: "draft" | "verified" | "proven";
1528
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1334
1529
  layer: "personal" | "team";
1335
1530
  pending_path: string;
1531
+ maturity: "draft" | "verified" | "proven";
1532
+ status?: "active" | "rejected" | "deferred" | undefined;
1336
1533
  summary?: string | undefined;
1337
1534
  tags?: string[] | undefined;
1535
+ body?: string | undefined;
1338
1536
  title?: string | undefined;
1537
+ pending_path_absolute?: string | undefined;
1339
1538
  origin?: "personal" | "team" | undefined;
1539
+ deferred_until?: string | undefined;
1340
1540
  }>, "many">;
1541
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1542
+ code: z.ZodString;
1543
+ file: z.ZodString;
1544
+ line: z.ZodOptional<z.ZodNumber>;
1545
+ action_hint: z.ZodString;
1546
+ }, "strip", z.ZodTypeAny, {
1547
+ code: string;
1548
+ file: string;
1549
+ action_hint: string;
1550
+ line?: number | undefined;
1551
+ }, {
1552
+ code: string;
1553
+ file: string;
1554
+ action_hint: string;
1555
+ line?: number | undefined;
1556
+ }>, "many">>;
1341
1557
  }, "strip", z.ZodTypeAny, {
1342
1558
  action: "list";
1343
1559
  items: {
1344
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1345
- maturity: "draft" | "verified" | "proven";
1560
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1346
1561
  layer: "personal" | "team";
1347
1562
  pending_path: string;
1563
+ maturity: "draft" | "verified" | "proven";
1564
+ status?: "active" | "rejected" | "deferred" | undefined;
1348
1565
  summary?: string | undefined;
1349
1566
  tags?: string[] | undefined;
1567
+ body?: string | undefined;
1350
1568
  title?: string | undefined;
1569
+ pending_path_absolute?: string | undefined;
1351
1570
  origin?: "personal" | "team" | undefined;
1571
+ deferred_until?: string | undefined;
1352
1572
  }[];
1573
+ warnings?: {
1574
+ code: string;
1575
+ file: string;
1576
+ action_hint: string;
1577
+ line?: number | undefined;
1578
+ }[] | undefined;
1353
1579
  }, {
1354
1580
  action: "list";
1355
1581
  items: {
1356
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1357
- maturity: "draft" | "verified" | "proven";
1582
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1358
1583
  layer: "personal" | "team";
1359
1584
  pending_path: string;
1585
+ maturity: "draft" | "verified" | "proven";
1586
+ status?: "active" | "rejected" | "deferred" | undefined;
1360
1587
  summary?: string | undefined;
1361
1588
  tags?: string[] | undefined;
1589
+ body?: string | undefined;
1362
1590
  title?: string | undefined;
1591
+ pending_path_absolute?: string | undefined;
1363
1592
  origin?: "personal" | "team" | undefined;
1593
+ deferred_until?: string | undefined;
1364
1594
  }[];
1595
+ warnings?: {
1596
+ code: string;
1597
+ file: string;
1598
+ action_hint: string;
1599
+ line?: number | undefined;
1600
+ }[] | undefined;
1365
1601
  }>, z.ZodObject<{
1366
1602
  action: z.ZodLiteral<"approve">;
1367
1603
  approved: z.ZodArray<z.ZodObject<{
1368
1604
  pending_path: z.ZodString;
1369
1605
  stable_id: z.ZodString;
1370
1606
  }, "strip", z.ZodTypeAny, {
1371
- stable_id: string;
1372
1607
  pending_path: string;
1373
- }, {
1374
1608
  stable_id: string;
1609
+ }, {
1375
1610
  pending_path: string;
1611
+ stable_id: string;
1376
1612
  }>, "many">;
1613
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1614
+ code: z.ZodString;
1615
+ file: z.ZodString;
1616
+ line: z.ZodOptional<z.ZodNumber>;
1617
+ action_hint: z.ZodString;
1618
+ }, "strip", z.ZodTypeAny, {
1619
+ code: string;
1620
+ file: string;
1621
+ action_hint: string;
1622
+ line?: number | undefined;
1623
+ }, {
1624
+ code: string;
1625
+ file: string;
1626
+ action_hint: string;
1627
+ line?: number | undefined;
1628
+ }>, "many">>;
1377
1629
  }, "strip", z.ZodTypeAny, {
1378
1630
  approved: {
1379
- stable_id: string;
1380
1631
  pending_path: string;
1632
+ stable_id: string;
1381
1633
  }[];
1382
1634
  action: "approve";
1635
+ warnings?: {
1636
+ code: string;
1637
+ file: string;
1638
+ action_hint: string;
1639
+ line?: number | undefined;
1640
+ }[] | undefined;
1383
1641
  }, {
1384
1642
  approved: {
1385
- stable_id: string;
1386
1643
  pending_path: string;
1644
+ stable_id: string;
1387
1645
  }[];
1388
1646
  action: "approve";
1647
+ warnings?: {
1648
+ code: string;
1649
+ file: string;
1650
+ action_hint: string;
1651
+ line?: number | undefined;
1652
+ }[] | undefined;
1389
1653
  }>, z.ZodObject<{
1390
1654
  action: z.ZodLiteral<"reject">;
1391
1655
  rejected: z.ZodArray<z.ZodString, "many">;
1656
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1657
+ code: z.ZodString;
1658
+ file: z.ZodString;
1659
+ line: z.ZodOptional<z.ZodNumber>;
1660
+ action_hint: z.ZodString;
1661
+ }, "strip", z.ZodTypeAny, {
1662
+ code: string;
1663
+ file: string;
1664
+ action_hint: string;
1665
+ line?: number | undefined;
1666
+ }, {
1667
+ code: string;
1668
+ file: string;
1669
+ action_hint: string;
1670
+ line?: number | undefined;
1671
+ }>, "many">>;
1392
1672
  }, "strip", z.ZodTypeAny, {
1393
1673
  action: "reject";
1394
1674
  rejected: string[];
1675
+ warnings?: {
1676
+ code: string;
1677
+ file: string;
1678
+ action_hint: string;
1679
+ line?: number | undefined;
1680
+ }[] | undefined;
1395
1681
  }, {
1396
1682
  action: "reject";
1397
1683
  rejected: string[];
1684
+ warnings?: {
1685
+ code: string;
1686
+ file: string;
1687
+ action_hint: string;
1688
+ line?: number | undefined;
1689
+ }[] | undefined;
1398
1690
  }>, z.ZodObject<{
1399
1691
  action: z.ZodLiteral<"modify">;
1400
1692
  pending_path: z.ZodString;
1401
1693
  prior_stable_id: z.ZodOptional<z.ZodString>;
1402
1694
  new_stable_id: z.ZodOptional<z.ZodString>;
1695
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1696
+ code: z.ZodString;
1697
+ file: z.ZodString;
1698
+ line: z.ZodOptional<z.ZodNumber>;
1699
+ action_hint: z.ZodString;
1700
+ }, "strip", z.ZodTypeAny, {
1701
+ code: string;
1702
+ file: string;
1703
+ action_hint: string;
1704
+ line?: number | undefined;
1705
+ }, {
1706
+ code: string;
1707
+ file: string;
1708
+ action_hint: string;
1709
+ line?: number | undefined;
1710
+ }>, "many">>;
1403
1711
  }, "strip", z.ZodTypeAny, {
1404
1712
  pending_path: string;
1405
1713
  action: "modify";
1714
+ warnings?: {
1715
+ code: string;
1716
+ file: string;
1717
+ action_hint: string;
1718
+ line?: number | undefined;
1719
+ }[] | undefined;
1406
1720
  prior_stable_id?: string | undefined;
1407
1721
  new_stable_id?: string | undefined;
1408
1722
  }, {
1409
1723
  pending_path: string;
1410
1724
  action: "modify";
1725
+ warnings?: {
1726
+ code: string;
1727
+ file: string;
1728
+ action_hint: string;
1729
+ line?: number | undefined;
1730
+ }[] | undefined;
1411
1731
  prior_stable_id?: string | undefined;
1412
1732
  new_stable_id?: string | undefined;
1413
1733
  }>, z.ZodObject<{
1414
1734
  action: z.ZodLiteral<"search">;
1415
1735
  items: z.ZodArray<z.ZodObject<{
1416
- pending_path: z.ZodString;
1736
+ area: z.ZodEnum<["pending", "canonical"]>;
1737
+ path: z.ZodString;
1738
+ path_absolute: z.ZodOptional<z.ZodString>;
1417
1739
  type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1418
1740
  layer: z.ZodEnum<["team", "personal"]>;
1419
1741
  maturity: z.ZodEnum<["draft", "verified", "proven"]>;
@@ -1421,60 +1743,263 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
1421
1743
  title: z.ZodOptional<z.ZodString>;
1422
1744
  summary: z.ZodOptional<z.ZodString>;
1423
1745
  origin: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1746
+ status: z.ZodOptional<z.ZodEnum<["active", "rejected", "deferred"]>>;
1747
+ deferred_until: z.ZodOptional<z.ZodString>;
1748
+ body: z.ZodOptional<z.ZodString>;
1749
+ stable_id: z.ZodOptional<z.ZodString>;
1424
1750
  }, "strip", z.ZodTypeAny, {
1425
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1426
- maturity: "draft" | "verified" | "proven";
1751
+ path: string;
1752
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1427
1753
  layer: "personal" | "team";
1428
- pending_path: string;
1754
+ maturity: "draft" | "verified" | "proven";
1755
+ area: "canonical" | "pending";
1756
+ status?: "active" | "rejected" | "deferred" | undefined;
1429
1757
  summary?: string | undefined;
1430
1758
  tags?: string[] | undefined;
1759
+ stable_id?: string | undefined;
1760
+ body?: string | undefined;
1431
1761
  title?: string | undefined;
1432
1762
  origin?: "personal" | "team" | undefined;
1763
+ deferred_until?: string | undefined;
1764
+ path_absolute?: string | undefined;
1433
1765
  }, {
1434
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1435
- maturity: "draft" | "verified" | "proven";
1766
+ path: string;
1767
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1436
1768
  layer: "personal" | "team";
1437
- pending_path: string;
1769
+ maturity: "draft" | "verified" | "proven";
1770
+ area: "canonical" | "pending";
1771
+ status?: "active" | "rejected" | "deferred" | undefined;
1438
1772
  summary?: string | undefined;
1439
1773
  tags?: string[] | undefined;
1774
+ stable_id?: string | undefined;
1775
+ body?: string | undefined;
1440
1776
  title?: string | undefined;
1441
1777
  origin?: "personal" | "team" | undefined;
1778
+ deferred_until?: string | undefined;
1779
+ path_absolute?: string | undefined;
1442
1780
  }>, "many">;
1781
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1782
+ code: z.ZodString;
1783
+ file: z.ZodString;
1784
+ line: z.ZodOptional<z.ZodNumber>;
1785
+ action_hint: z.ZodString;
1786
+ }, "strip", z.ZodTypeAny, {
1787
+ code: string;
1788
+ file: string;
1789
+ action_hint: string;
1790
+ line?: number | undefined;
1791
+ }, {
1792
+ code: string;
1793
+ file: string;
1794
+ action_hint: string;
1795
+ line?: number | undefined;
1796
+ }>, "many">>;
1443
1797
  }, "strip", z.ZodTypeAny, {
1444
1798
  action: "search";
1445
1799
  items: {
1446
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1447
- maturity: "draft" | "verified" | "proven";
1800
+ path: string;
1801
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1448
1802
  layer: "personal" | "team";
1449
- pending_path: string;
1803
+ maturity: "draft" | "verified" | "proven";
1804
+ area: "canonical" | "pending";
1805
+ status?: "active" | "rejected" | "deferred" | undefined;
1450
1806
  summary?: string | undefined;
1451
1807
  tags?: string[] | undefined;
1808
+ stable_id?: string | undefined;
1809
+ body?: string | undefined;
1452
1810
  title?: string | undefined;
1453
1811
  origin?: "personal" | "team" | undefined;
1812
+ deferred_until?: string | undefined;
1813
+ path_absolute?: string | undefined;
1454
1814
  }[];
1815
+ warnings?: {
1816
+ code: string;
1817
+ file: string;
1818
+ action_hint: string;
1819
+ line?: number | undefined;
1820
+ }[] | undefined;
1455
1821
  }, {
1456
1822
  action: "search";
1457
1823
  items: {
1458
- type: "decisions" | "pitfalls" | "guidelines" | "models" | "processes";
1459
- maturity: "draft" | "verified" | "proven";
1824
+ path: string;
1825
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1460
1826
  layer: "personal" | "team";
1461
- pending_path: string;
1827
+ maturity: "draft" | "verified" | "proven";
1828
+ area: "canonical" | "pending";
1829
+ status?: "active" | "rejected" | "deferred" | undefined;
1462
1830
  summary?: string | undefined;
1463
1831
  tags?: string[] | undefined;
1832
+ stable_id?: string | undefined;
1833
+ body?: string | undefined;
1464
1834
  title?: string | undefined;
1465
1835
  origin?: "personal" | "team" | undefined;
1836
+ deferred_until?: string | undefined;
1837
+ path_absolute?: string | undefined;
1466
1838
  }[];
1839
+ warnings?: {
1840
+ code: string;
1841
+ file: string;
1842
+ action_hint: string;
1843
+ line?: number | undefined;
1844
+ }[] | undefined;
1467
1845
  }>, z.ZodObject<{
1468
1846
  action: z.ZodLiteral<"defer">;
1469
1847
  deferred: z.ZodArray<z.ZodString, "many">;
1848
+ warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1849
+ code: z.ZodString;
1850
+ file: z.ZodString;
1851
+ line: z.ZodOptional<z.ZodNumber>;
1852
+ action_hint: z.ZodString;
1853
+ }, "strip", z.ZodTypeAny, {
1854
+ code: string;
1855
+ file: string;
1856
+ action_hint: string;
1857
+ line?: number | undefined;
1858
+ }, {
1859
+ code: string;
1860
+ file: string;
1861
+ action_hint: string;
1862
+ line?: number | undefined;
1863
+ }>, "many">>;
1470
1864
  }, "strip", z.ZodTypeAny, {
1471
1865
  action: "defer";
1472
1866
  deferred: string[];
1867
+ warnings?: {
1868
+ code: string;
1869
+ file: string;
1870
+ action_hint: string;
1871
+ line?: number | undefined;
1872
+ }[] | undefined;
1473
1873
  }, {
1474
1874
  action: "defer";
1475
1875
  deferred: string[];
1876
+ warnings?: {
1877
+ code: string;
1878
+ file: string;
1879
+ action_hint: string;
1880
+ line?: number | undefined;
1881
+ }[] | undefined;
1476
1882
  }>]>;
1477
1883
  type FabReviewOutput = z.infer<typeof FabReviewOutputSchema>;
1884
+ declare const FabReviewOutputShape: {
1885
+ readonly action: z.ZodEnum<["list", "approve", "reject", "modify", "search", "defer"]>;
1886
+ readonly items: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
1887
+ pending_path: z.ZodString;
1888
+ pending_path_absolute: z.ZodOptional<z.ZodString>;
1889
+ type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1890
+ layer: z.ZodEnum<["team", "personal"]>;
1891
+ maturity: z.ZodEnum<["draft", "verified", "proven"]>;
1892
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1893
+ title: z.ZodOptional<z.ZodString>;
1894
+ summary: z.ZodOptional<z.ZodString>;
1895
+ origin: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1896
+ status: z.ZodOptional<z.ZodEnum<["active", "rejected", "deferred"]>>;
1897
+ deferred_until: z.ZodOptional<z.ZodString>;
1898
+ body: z.ZodOptional<z.ZodString>;
1899
+ }, "strip", z.ZodTypeAny, {
1900
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1901
+ layer: "personal" | "team";
1902
+ pending_path: string;
1903
+ maturity: "draft" | "verified" | "proven";
1904
+ status?: "active" | "rejected" | "deferred" | undefined;
1905
+ summary?: string | undefined;
1906
+ tags?: string[] | undefined;
1907
+ body?: string | undefined;
1908
+ title?: string | undefined;
1909
+ pending_path_absolute?: string | undefined;
1910
+ origin?: "personal" | "team" | undefined;
1911
+ deferred_until?: string | undefined;
1912
+ }, {
1913
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1914
+ layer: "personal" | "team";
1915
+ pending_path: string;
1916
+ maturity: "draft" | "verified" | "proven";
1917
+ status?: "active" | "rejected" | "deferred" | undefined;
1918
+ summary?: string | undefined;
1919
+ tags?: string[] | undefined;
1920
+ body?: string | undefined;
1921
+ title?: string | undefined;
1922
+ pending_path_absolute?: string | undefined;
1923
+ origin?: "personal" | "team" | undefined;
1924
+ deferred_until?: string | undefined;
1925
+ }>, z.ZodObject<{
1926
+ area: z.ZodEnum<["pending", "canonical"]>;
1927
+ path: z.ZodString;
1928
+ path_absolute: z.ZodOptional<z.ZodString>;
1929
+ type: z.ZodEnum<["decisions", "pitfalls", "guidelines", "models", "processes"]>;
1930
+ layer: z.ZodEnum<["team", "personal"]>;
1931
+ maturity: z.ZodEnum<["draft", "verified", "proven"]>;
1932
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1933
+ title: z.ZodOptional<z.ZodString>;
1934
+ summary: z.ZodOptional<z.ZodString>;
1935
+ origin: z.ZodOptional<z.ZodEnum<["team", "personal"]>>;
1936
+ status: z.ZodOptional<z.ZodEnum<["active", "rejected", "deferred"]>>;
1937
+ deferred_until: z.ZodOptional<z.ZodString>;
1938
+ body: z.ZodOptional<z.ZodString>;
1939
+ stable_id: z.ZodOptional<z.ZodString>;
1940
+ }, "strip", z.ZodTypeAny, {
1941
+ path: string;
1942
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1943
+ layer: "personal" | "team";
1944
+ maturity: "draft" | "verified" | "proven";
1945
+ area: "canonical" | "pending";
1946
+ status?: "active" | "rejected" | "deferred" | undefined;
1947
+ summary?: string | undefined;
1948
+ tags?: string[] | undefined;
1949
+ stable_id?: string | undefined;
1950
+ body?: string | undefined;
1951
+ title?: string | undefined;
1952
+ origin?: "personal" | "team" | undefined;
1953
+ deferred_until?: string | undefined;
1954
+ path_absolute?: string | undefined;
1955
+ }, {
1956
+ path: string;
1957
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
1958
+ layer: "personal" | "team";
1959
+ maturity: "draft" | "verified" | "proven";
1960
+ area: "canonical" | "pending";
1961
+ status?: "active" | "rejected" | "deferred" | undefined;
1962
+ summary?: string | undefined;
1963
+ tags?: string[] | undefined;
1964
+ stable_id?: string | undefined;
1965
+ body?: string | undefined;
1966
+ title?: string | undefined;
1967
+ origin?: "personal" | "team" | undefined;
1968
+ deferred_until?: string | undefined;
1969
+ path_absolute?: string | undefined;
1970
+ }>]>, "many">>;
1971
+ readonly approved: z.ZodOptional<z.ZodArray<z.ZodObject<{
1972
+ pending_path: z.ZodString;
1973
+ stable_id: z.ZodString;
1974
+ }, "strip", z.ZodTypeAny, {
1975
+ pending_path: string;
1976
+ stable_id: string;
1977
+ }, {
1978
+ pending_path: string;
1979
+ stable_id: string;
1980
+ }>, "many">>;
1981
+ readonly rejected: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1982
+ readonly pending_path: z.ZodOptional<z.ZodString>;
1983
+ readonly prior_stable_id: z.ZodOptional<z.ZodString>;
1984
+ readonly new_stable_id: z.ZodOptional<z.ZodString>;
1985
+ readonly deferred: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1986
+ readonly warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
1987
+ code: z.ZodString;
1988
+ file: z.ZodString;
1989
+ line: z.ZodOptional<z.ZodNumber>;
1990
+ action_hint: z.ZodString;
1991
+ }, "strip", z.ZodTypeAny, {
1992
+ code: string;
1993
+ file: string;
1994
+ action_hint: string;
1995
+ line?: number | undefined;
1996
+ }, {
1997
+ code: string;
1998
+ file: string;
1999
+ action_hint: string;
2000
+ line?: number | undefined;
2001
+ }>, "many">>;
2002
+ };
1478
2003
  declare const fabReviewAnnotations: {
1479
2004
  readonly readOnlyHint: false;
1480
2005
  readonly idempotentHint: false;
@@ -1482,6 +2007,228 @@ declare const fabReviewAnnotations: {
1482
2007
  readonly openWorldHint: false;
1483
2008
  readonly title: "Review pending knowledge entries";
1484
2009
  };
2010
+ declare const citeContractMetricsSchema: z.ZodObject<{
2011
+ decisions_cited: z.ZodNumber;
2012
+ pitfalls_cited: z.ZodNumber;
2013
+ contract_with: z.ZodNumber;
2014
+ contract_missing: z.ZodNumber;
2015
+ hard_violated: z.ZodNumber;
2016
+ cite_id_unresolved: z.ZodNumber;
2017
+ skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
2018
+ }, "strip", z.ZodTypeAny, {
2019
+ decisions_cited: number;
2020
+ pitfalls_cited: number;
2021
+ contract_with: number;
2022
+ contract_missing: number;
2023
+ hard_violated: number;
2024
+ cite_id_unresolved: number;
2025
+ skip_count: Record<string, number>;
2026
+ }, {
2027
+ decisions_cited: number;
2028
+ pitfalls_cited: number;
2029
+ contract_with: number;
2030
+ contract_missing: number;
2031
+ hard_violated: number;
2032
+ cite_id_unresolved: number;
2033
+ skip_count: Record<string, number>;
2034
+ }>;
2035
+ type CiteContractMetrics = z.infer<typeof citeContractMetricsSchema>;
2036
+ declare const citeLayerTypeBreakdownSchema: z.ZodObject<{
2037
+ team: z.ZodRecord<z.ZodString, z.ZodNumber>;
2038
+ personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
2039
+ }, "strip", z.ZodTypeAny, {
2040
+ personal: Record<string, number>;
2041
+ team: Record<string, number>;
2042
+ }, {
2043
+ personal: Record<string, number>;
2044
+ team: Record<string, number>;
2045
+ }>;
2046
+ type CiteLayerTypeBreakdown = z.infer<typeof citeLayerTypeBreakdownSchema>;
2047
+ declare const citeCoverageReportSchema: z.ZodObject<{
2048
+ status: z.ZodEnum<["ok", "skipped"]>;
2049
+ marker_ts: z.ZodNumber;
2050
+ marker_emitted_now: z.ZodBoolean;
2051
+ since_ts: z.ZodNumber;
2052
+ client_filter: z.ZodEnum<["cc", "codex", "cursor", "all"]>;
2053
+ layer_filter: z.ZodOptional<z.ZodEnum<["team", "personal", "all"]>>;
2054
+ metrics: z.ZodObject<{
2055
+ edits_touched: z.ZodNumber;
2056
+ qualifying_cites: z.ZodNumber;
2057
+ recalled_unverified: z.ZodNumber;
2058
+ expected_but_missed: z.ZodNumber;
2059
+ total_turns: z.ZodNumber;
2060
+ cite_compliance_rate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
2061
+ compliant_cites: z.ZodOptional<z.ZodNumber>;
2062
+ noncompliant_cites: z.ZodOptional<z.ZodNumber>;
2063
+ uncorrelatable_edits: z.ZodOptional<z.ZodNumber>;
2064
+ }, "strip", z.ZodTypeAny, {
2065
+ edits_touched: number;
2066
+ qualifying_cites: number;
2067
+ recalled_unverified: number;
2068
+ expected_but_missed: number;
2069
+ total_turns: number;
2070
+ cite_compliance_rate?: number | null | undefined;
2071
+ compliant_cites?: number | undefined;
2072
+ noncompliant_cites?: number | undefined;
2073
+ uncorrelatable_edits?: number | undefined;
2074
+ }, {
2075
+ edits_touched: number;
2076
+ qualifying_cites: number;
2077
+ recalled_unverified: number;
2078
+ expected_but_missed: number;
2079
+ total_turns: number;
2080
+ cite_compliance_rate?: number | null | undefined;
2081
+ compliant_cites?: number | undefined;
2082
+ noncompliant_cites?: number | undefined;
2083
+ uncorrelatable_edits?: number | undefined;
2084
+ }>;
2085
+ per_client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
2086
+ edits_touched: z.ZodOptional<z.ZodNumber>;
2087
+ qualifying_cites: z.ZodOptional<z.ZodNumber>;
2088
+ recalled_unverified: z.ZodOptional<z.ZodNumber>;
2089
+ expected_but_missed: z.ZodOptional<z.ZodNumber>;
2090
+ total_turns: z.ZodOptional<z.ZodNumber>;
2091
+ }, "strip", z.ZodTypeAny, {
2092
+ edits_touched?: number | undefined;
2093
+ qualifying_cites?: number | undefined;
2094
+ recalled_unverified?: number | undefined;
2095
+ expected_but_missed?: number | undefined;
2096
+ total_turns?: number | undefined;
2097
+ }, {
2098
+ edits_touched?: number | undefined;
2099
+ qualifying_cites?: number | undefined;
2100
+ recalled_unverified?: number | undefined;
2101
+ expected_but_missed?: number | undefined;
2102
+ total_turns?: number | undefined;
2103
+ }>>>;
2104
+ dismissed_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
2105
+ none_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
2106
+ contract_metrics_status: z.ZodOptional<z.ZodEnum<["ok", "skipped:bootstrap_drift", "awaiting_marker"]>>;
2107
+ contract_metrics: z.ZodOptional<z.ZodObject<{
2108
+ decisions_cited: z.ZodNumber;
2109
+ pitfalls_cited: z.ZodNumber;
2110
+ contract_with: z.ZodNumber;
2111
+ contract_missing: z.ZodNumber;
2112
+ hard_violated: z.ZodNumber;
2113
+ cite_id_unresolved: z.ZodNumber;
2114
+ skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
2115
+ }, "strip", z.ZodTypeAny, {
2116
+ decisions_cited: number;
2117
+ pitfalls_cited: number;
2118
+ contract_with: number;
2119
+ contract_missing: number;
2120
+ hard_violated: number;
2121
+ cite_id_unresolved: number;
2122
+ skip_count: Record<string, number>;
2123
+ }, {
2124
+ decisions_cited: number;
2125
+ pitfalls_cited: number;
2126
+ contract_with: number;
2127
+ contract_missing: number;
2128
+ hard_violated: number;
2129
+ cite_id_unresolved: number;
2130
+ skip_count: Record<string, number>;
2131
+ }>>;
2132
+ per_layer_type: z.ZodOptional<z.ZodObject<{
2133
+ team: z.ZodRecord<z.ZodString, z.ZodNumber>;
2134
+ personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
2135
+ }, "strip", z.ZodTypeAny, {
2136
+ personal: Record<string, number>;
2137
+ team: Record<string, number>;
2138
+ }, {
2139
+ personal: Record<string, number>;
2140
+ team: Record<string, number>;
2141
+ }>>;
2142
+ contract_marker_ts: z.ZodOptional<z.ZodNumber>;
2143
+ generated_at: z.ZodString;
2144
+ }, "strip", z.ZodTypeAny, {
2145
+ status: "ok" | "skipped";
2146
+ marker_ts: number;
2147
+ marker_emitted_now: boolean;
2148
+ since_ts: number;
2149
+ client_filter: "cursor" | "all" | "cc" | "codex";
2150
+ metrics: {
2151
+ edits_touched: number;
2152
+ qualifying_cites: number;
2153
+ recalled_unverified: number;
2154
+ expected_but_missed: number;
2155
+ total_turns: number;
2156
+ cite_compliance_rate?: number | null | undefined;
2157
+ compliant_cites?: number | undefined;
2158
+ noncompliant_cites?: number | undefined;
2159
+ uncorrelatable_edits?: number | undefined;
2160
+ };
2161
+ generated_at: string;
2162
+ layer_filter?: "personal" | "team" | "all" | undefined;
2163
+ per_client?: Record<string, {
2164
+ edits_touched?: number | undefined;
2165
+ qualifying_cites?: number | undefined;
2166
+ recalled_unverified?: number | undefined;
2167
+ expected_but_missed?: number | undefined;
2168
+ total_turns?: number | undefined;
2169
+ }> | undefined;
2170
+ dismissed_reason_histogram?: Record<string, number> | undefined;
2171
+ none_reason_histogram?: Record<string, number> | undefined;
2172
+ contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
2173
+ contract_metrics?: {
2174
+ decisions_cited: number;
2175
+ pitfalls_cited: number;
2176
+ contract_with: number;
2177
+ contract_missing: number;
2178
+ hard_violated: number;
2179
+ cite_id_unresolved: number;
2180
+ skip_count: Record<string, number>;
2181
+ } | undefined;
2182
+ per_layer_type?: {
2183
+ personal: Record<string, number>;
2184
+ team: Record<string, number>;
2185
+ } | undefined;
2186
+ contract_marker_ts?: number | undefined;
2187
+ }, {
2188
+ status: "ok" | "skipped";
2189
+ marker_ts: number;
2190
+ marker_emitted_now: boolean;
2191
+ since_ts: number;
2192
+ client_filter: "cursor" | "all" | "cc" | "codex";
2193
+ metrics: {
2194
+ edits_touched: number;
2195
+ qualifying_cites: number;
2196
+ recalled_unverified: number;
2197
+ expected_but_missed: number;
2198
+ total_turns: number;
2199
+ cite_compliance_rate?: number | null | undefined;
2200
+ compliant_cites?: number | undefined;
2201
+ noncompliant_cites?: number | undefined;
2202
+ uncorrelatable_edits?: number | undefined;
2203
+ };
2204
+ generated_at: string;
2205
+ layer_filter?: "personal" | "team" | "all" | undefined;
2206
+ per_client?: Record<string, {
2207
+ edits_touched?: number | undefined;
2208
+ qualifying_cites?: number | undefined;
2209
+ recalled_unverified?: number | undefined;
2210
+ expected_but_missed?: number | undefined;
2211
+ total_turns?: number | undefined;
2212
+ }> | undefined;
2213
+ dismissed_reason_histogram?: Record<string, number> | undefined;
2214
+ none_reason_histogram?: Record<string, number> | undefined;
2215
+ contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
2216
+ contract_metrics?: {
2217
+ decisions_cited: number;
2218
+ pitfalls_cited: number;
2219
+ contract_with: number;
2220
+ contract_missing: number;
2221
+ hard_violated: number;
2222
+ cite_id_unresolved: number;
2223
+ skip_count: Record<string, number>;
2224
+ } | undefined;
2225
+ per_layer_type?: {
2226
+ personal: Record<string, number>;
2227
+ team: Record<string, number>;
2228
+ } | undefined;
2229
+ contract_marker_ts?: number | undefined;
2230
+ }>;
2231
+ type CiteCoverageReport = z.infer<typeof citeCoverageReportSchema>;
1485
2232
  declare const ledgerSourceSchema: z.ZodEnum<["ai", "human"]>;
1486
2233
  declare const ledgerQuerySchema: z.ZodObject<{
1487
2234
  source: z.ZodOptional<z.ZodEnum<["ai", "human"]>>;
@@ -1542,7 +2289,7 @@ declare const annotateIntentRequestSchema: z.ZodObject<{
1542
2289
  ledger_entry_id: string;
1543
2290
  annotation: string;
1544
2291
  }>;
1545
- declare const KnowledgeTypeSchema: z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>;
2292
+ declare const KnowledgeTypeSchema: z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>;
1546
2293
  type KnowledgeType = z.infer<typeof KnowledgeTypeSchema>;
1547
2294
  declare const MaturitySchema: z.ZodEnum<["draft", "verified", "proven"]>;
1548
2295
  type Maturity = z.infer<typeof MaturitySchema>;
@@ -1552,33 +2299,33 @@ declare const StableIdSchema: z.ZodString;
1552
2299
  type StableId = z.infer<typeof StableIdSchema>;
1553
2300
  declare const KnowledgeEntryFrontmatterSchema: z.ZodObject<{
1554
2301
  id: z.ZodString;
1555
- type: z.ZodEnum<["model", "decision", "guideline", "pitfall", "process"]>;
2302
+ type: z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>;
1556
2303
  maturity: z.ZodEnum<["draft", "verified", "proven"]>;
1557
2304
  layer: z.ZodEnum<["personal", "team"]>;
1558
2305
  layer_reason: z.ZodOptional<z.ZodString>;
1559
2306
  created_at: z.ZodString;
1560
2307
  }, "strip", z.ZodTypeAny, {
1561
- type: "model" | "decision" | "guideline" | "pitfall" | "process";
2308
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
2309
+ layer: "personal" | "team";
1562
2310
  id: string;
1563
2311
  maturity: "draft" | "verified" | "proven";
1564
2312
  created_at: string;
1565
- layer: "personal" | "team";
1566
2313
  layer_reason?: string | undefined;
1567
2314
  }, {
1568
- type: "model" | "decision" | "guideline" | "pitfall" | "process";
2315
+ type: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
2316
+ layer: "personal" | "team";
1569
2317
  id: string;
1570
2318
  maturity: "draft" | "verified" | "proven";
1571
2319
  created_at: string;
1572
- layer: "personal" | "team";
1573
2320
  layer_reason?: string | undefined;
1574
2321
  }>;
1575
2322
  type KnowledgeEntryFrontmatter = z.infer<typeof KnowledgeEntryFrontmatterSchema>;
1576
2323
  declare const KNOWLEDGE_TYPE_CODES: {
1577
- readonly model: "MOD";
1578
- readonly decision: "DEC";
1579
- readonly guideline: "GLD";
1580
- readonly pitfall: "PIT";
1581
- readonly process: "PRO";
2324
+ readonly models: "MOD";
2325
+ readonly decisions: "DEC";
2326
+ readonly guidelines: "GLD";
2327
+ readonly pitfalls: "PIT";
2328
+ readonly processes: "PRO";
1582
2329
  };
1583
2330
  type KnowledgeTypeCode = (typeof KNOWLEDGE_TYPE_CODES)[KnowledgeType];
1584
2331
  declare function formatKnowledgeId(layer: Layer, type: KnowledgeType, counter: number): StableId;
@@ -1588,4 +2335,4 @@ declare function parseKnowledgeId(id: string): {
1588
2335
  counter: number;
1589
2336
  } | null;
1590
2337
 
1591
- export { type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, type FabReviewOutput, FabReviewOutputSchema, 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, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, getKnowledgeAnnotations, getKnowledgeInputSchema, getKnowledgeOutputSchema, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema };
2338
+ 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 };