@fenglimg/fabric-shared 2.0.0-rc.37 → 2.0.0-rc.38

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.
@@ -55,402 +55,146 @@ 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<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
150
- relevance_scope?: "narrow" | "broad" | undefined;
151
- relevance_paths?: string[] | undefined;
152
- layer?: "personal" | "team" | undefined;
153
- maturity?: "draft" | "verified" | "proven" | undefined;
154
- layer_reason?: string | undefined;
155
- tags?: 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
176
- relevance_scope?: "narrow" | "broad" | undefined;
177
- relevance_paths?: string[] | undefined;
178
- layer?: "personal" | "team" | undefined;
179
- maturity?: "draft" | "verified" | "proven" | undefined;
180
- layer_reason?: string | undefined;
181
- tags?: 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
213
- relevance_scope?: "narrow" | "broad" | undefined;
214
- relevance_paths?: string[] | undefined;
215
- layer?: "personal" | "team" | undefined;
216
- maturity?: "draft" | "verified" | "proven" | undefined;
217
- layer_reason?: string | undefined;
218
- tags?: 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
250
- relevance_scope?: "narrow" | "broad" | undefined;
251
- relevance_paths?: string[] | undefined;
252
- layer?: "personal" | "team" | undefined;
253
- maturity?: "draft" | "verified" | "proven" | undefined;
254
- layer_reason?: string | undefined;
255
- tags?: 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<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
108
+ summary: string;
109
+ intent_clues: string[];
110
+ tech_stack: string[];
111
+ impact: string[];
112
+ must_read_if: string;
331
113
  relevance_scope?: "narrow" | "broad" | undefined;
332
114
  relevance_paths?: string[] | undefined;
333
- layer?: "personal" | "team" | undefined;
115
+ entities?: string[] | undefined;
116
+ id?: string | undefined;
117
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
334
118
  maturity?: "draft" | "verified" | "proven" | undefined;
119
+ knowledge_layer?: "personal" | "team" | undefined;
335
120
  layer_reason?: string | undefined;
121
+ created_at?: string | undefined;
336
122
  tags?: string[] | undefined;
337
123
  }, {
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
124
+ summary: string;
125
+ intent_clues: string[];
126
+ tech_stack: string[];
127
+ impact: string[];
128
+ must_read_if: string;
357
129
  relevance_scope?: "narrow" | "broad" | undefined;
358
130
  relevance_paths?: string[] | undefined;
359
- layer?: "personal" | "team" | undefined;
131
+ entities?: string[] | undefined;
132
+ id?: string | undefined;
133
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
360
134
  maturity?: "draft" | "verified" | "proven" | undefined;
135
+ knowledge_layer?: "personal" | "team" | undefined;
361
136
  layer_reason?: string | undefined;
137
+ created_at?: string | undefined;
362
138
  tags?: 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">;
139
+ }>;
383
140
  }, "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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
141
+ description: {
142
+ summary: string;
143
+ intent_clues: string[];
144
+ tech_stack: string[];
145
+ impact: string[];
146
+ must_read_if: string;
404
147
  relevance_scope?: "narrow" | "broad" | undefined;
405
148
  relevance_paths?: string[] | undefined;
406
- layer?: "personal" | "team" | undefined;
149
+ entities?: string[] | undefined;
150
+ id?: string | undefined;
151
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
407
152
  maturity?: "draft" | "verified" | "proven" | undefined;
153
+ knowledge_layer?: "personal" | "team" | undefined;
408
154
  layer_reason?: string | undefined;
155
+ created_at?: string | undefined;
409
156
  tags?: 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
- }[];
157
+ };
158
+ stable_id: string;
418
159
  }, {
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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | 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?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
160
+ description: {
161
+ summary: string;
162
+ intent_clues: string[];
163
+ tech_stack: string[];
164
+ impact: string[];
165
+ must_read_if: string;
439
166
  relevance_scope?: "narrow" | "broad" | undefined;
440
167
  relevance_paths?: string[] | undefined;
441
- layer?: "personal" | "team" | undefined;
168
+ entities?: string[] | undefined;
169
+ id?: string | undefined;
170
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
442
171
  maturity?: "draft" | "verified" | "proven" | undefined;
172
+ knowledge_layer?: "personal" | "team" | undefined;
443
173
  layer_reason?: string | undefined;
174
+ created_at?: string | undefined;
444
175
  tags?: 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;
@@ -475,79 +219,41 @@ declare const planContextOutputSchema: z.ZodObject<{
475
219
  path: string;
476
220
  requirement_profile: {
477
221
  target_path: string;
478
- path_segments: string[];
479
- extension: string;
480
222
  known_tech: string[];
481
223
  user_intent: string;
482
224
  detected_entities: string[];
483
225
  };
484
- description_index: {
485
- description: {
486
- summary: string;
487
- intent_clues: string[];
488
- tech_stack: string[];
489
- impact: string[];
490
- must_read_if: string;
491
- entities?: string[] | undefined;
492
- id?: string | undefined;
493
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
494
- maturity?: "draft" | "verified" | "proven" | undefined;
495
- knowledge_layer?: "personal" | "team" | undefined;
496
- layer_reason?: string | undefined;
497
- created_at?: string | undefined;
498
- };
499
- stable_id: string;
500
- level: "L0" | "L1" | "L2";
501
- required: boolean;
502
- selectable: boolean;
503
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
504
- relevance_scope?: "narrow" | "broad" | undefined;
505
- relevance_paths?: string[] | undefined;
506
- layer?: "personal" | "team" | undefined;
507
- maturity?: "draft" | "verified" | "proven" | undefined;
508
- layer_reason?: string | undefined;
509
- tags?: string[] | undefined;
510
- }[];
511
226
  }[];
512
227
  stale: boolean;
513
228
  revision_hash: string;
514
229
  selection_token: string;
515
- shared: {
516
- description_index: {
517
- description: {
518
- summary: string;
519
- intent_clues: string[];
520
- tech_stack: string[];
521
- impact: string[];
522
- must_read_if: string;
523
- entities?: string[] | undefined;
524
- id?: string | undefined;
525
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
526
- maturity?: "draft" | "verified" | "proven" | undefined;
527
- knowledge_layer?: "personal" | "team" | undefined;
528
- layer_reason?: string | undefined;
529
- created_at?: string | undefined;
530
- };
531
- stable_id: string;
532
- level: "L0" | "L1" | "L2";
533
- required: boolean;
534
- selectable: boolean;
535
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
230
+ candidates: {
231
+ description: {
232
+ summary: string;
233
+ intent_clues: string[];
234
+ tech_stack: string[];
235
+ impact: string[];
236
+ must_read_if: string;
536
237
  relevance_scope?: "narrow" | "broad" | undefined;
537
238
  relevance_paths?: string[] | undefined;
538
- layer?: "personal" | "team" | undefined;
239
+ entities?: string[] | undefined;
240
+ id?: string | undefined;
241
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
539
242
  maturity?: "draft" | "verified" | "proven" | undefined;
243
+ knowledge_layer?: "personal" | "team" | undefined;
540
244
  layer_reason?: string | undefined;
245
+ created_at?: string | undefined;
541
246
  tags?: string[] | undefined;
542
- }[];
543
- preflight_diagnostics: {
544
- code: "missing_description";
545
- message: string;
546
- severity: "warn";
547
- path?: string | undefined;
548
- stable_ids?: string[] | undefined;
549
- }[];
550
- };
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
+ }[];
551
257
  warnings?: {
552
258
  code: string;
553
259
  file: string;
@@ -562,79 +268,41 @@ declare const planContextOutputSchema: z.ZodObject<{
562
268
  path: string;
563
269
  requirement_profile: {
564
270
  target_path: string;
565
- path_segments: string[];
566
- extension: string;
567
271
  known_tech: string[];
568
272
  user_intent: string;
569
273
  detected_entities: string[];
570
274
  };
571
- description_index: {
572
- description: {
573
- summary: string;
574
- intent_clues: string[];
575
- tech_stack: string[];
576
- impact: string[];
577
- must_read_if: string;
578
- entities?: string[] | undefined;
579
- id?: string | undefined;
580
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
581
- maturity?: "draft" | "verified" | "proven" | undefined;
582
- knowledge_layer?: "personal" | "team" | undefined;
583
- layer_reason?: string | undefined;
584
- created_at?: string | undefined;
585
- };
586
- stable_id: string;
587
- level: "L0" | "L1" | "L2";
588
- required: boolean;
589
- selectable: boolean;
590
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
591
- relevance_scope?: "narrow" | "broad" | undefined;
592
- relevance_paths?: string[] | undefined;
593
- layer?: "personal" | "team" | undefined;
594
- maturity?: "draft" | "verified" | "proven" | undefined;
595
- layer_reason?: string | undefined;
596
- tags?: string[] | undefined;
597
- }[];
598
275
  }[];
599
276
  stale: boolean;
600
277
  revision_hash: string;
601
278
  selection_token: string;
602
- shared: {
603
- description_index: {
604
- description: {
605
- summary: string;
606
- intent_clues: string[];
607
- tech_stack: string[];
608
- impact: string[];
609
- must_read_if: string;
610
- entities?: string[] | undefined;
611
- id?: string | undefined;
612
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
613
- maturity?: "draft" | "verified" | "proven" | undefined;
614
- knowledge_layer?: "personal" | "team" | undefined;
615
- layer_reason?: string | undefined;
616
- created_at?: string | undefined;
617
- };
618
- stable_id: string;
619
- level: "L0" | "L1" | "L2";
620
- required: boolean;
621
- selectable: boolean;
622
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
279
+ candidates: {
280
+ description: {
281
+ summary: string;
282
+ intent_clues: string[];
283
+ tech_stack: string[];
284
+ impact: string[];
285
+ must_read_if: string;
623
286
  relevance_scope?: "narrow" | "broad" | undefined;
624
287
  relevance_paths?: string[] | undefined;
625
- layer?: "personal" | "team" | undefined;
288
+ entities?: string[] | undefined;
289
+ id?: string | undefined;
290
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
626
291
  maturity?: "draft" | "verified" | "proven" | undefined;
292
+ knowledge_layer?: "personal" | "team" | undefined;
627
293
  layer_reason?: string | undefined;
294
+ created_at?: string | undefined;
628
295
  tags?: string[] | undefined;
629
- }[];
630
- preflight_diagnostics: {
631
- code: "missing_description";
632
- message: string;
633
- severity: "warn";
634
- path?: string | undefined;
635
- stable_ids?: string[] | undefined;
636
- }[];
637
- };
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
+ }[];
638
306
  warnings?: {
639
307
  code: string;
640
308
  file: string;
@@ -736,14 +404,6 @@ declare const knowledgeSectionsInputSchema: z.ZodObject<{
736
404
  }>;
737
405
  declare const knowledgeSectionsOutputSchema: z.ZodObject<{
738
406
  revision_hash: z.ZodString;
739
- /**
740
- * @deprecated rc.23 TASK-002 F3 — removed in rc.24. The L0/L1/L2 selection
741
- * ceremony was fully retired in rc.5 A3 (see comment above
742
- * `planContextOutputSchema`); downstream consumers should use
743
- * `rules[].level` directly. Kept as optional for one rc to avoid breaking
744
- * pre-rc.23 clients that destructure this field.
745
- */
746
- precedence: z.ZodOptional<z.ZodTuple<[z.ZodLiteral<"L2">, z.ZodLiteral<"L1">, z.ZodLiteral<"L0">], null>>;
747
407
  selected_stable_ids: z.ZodArray<z.ZodString, "many">;
748
408
  rules: z.ZodArray<z.ZodObject<{
749
409
  stable_id: z.ZodString;
@@ -821,7 +481,6 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
821
481
  action_hint: string;
822
482
  line?: number | undefined;
823
483
  }[] | undefined;
824
- precedence?: ["L2", "L1", "L0"] | undefined;
825
484
  redirect_to?: Record<string, string> | {
826
485
  stable_id: string;
827
486
  } | undefined;
@@ -846,7 +505,6 @@ declare const knowledgeSectionsOutputSchema: z.ZodObject<{
846
505
  action_hint: string;
847
506
  line?: number | undefined;
848
507
  }[] | undefined;
849
- precedence?: ["L2", "L1", "L0"] | undefined;
850
508
  redirect_to?: Record<string, string> | {
851
509
  stable_id: string;
852
510
  } | undefined;
@@ -900,402 +558,146 @@ declare const recallOutputSchema: z.ZodObject<{
900
558
  path: z.ZodString;
901
559
  requirement_profile: z.ZodObject<{
902
560
  target_path: z.ZodString;
903
- path_segments: z.ZodArray<z.ZodString, "many">;
904
- extension: z.ZodString;
905
561
  known_tech: z.ZodArray<z.ZodString, "many">;
906
562
  user_intent: z.ZodString;
907
563
  detected_entities: z.ZodArray<z.ZodString, "many">;
908
564
  }, "strip", z.ZodTypeAny, {
909
565
  target_path: string;
910
- path_segments: string[];
911
- extension: string;
912
566
  known_tech: string[];
913
567
  user_intent: string;
914
568
  detected_entities: string[];
915
569
  }, {
916
570
  target_path: string;
917
- path_segments: string[];
918
- extension: string;
919
571
  known_tech: string[];
920
572
  user_intent: string;
921
573
  detected_entities: string[];
922
574
  }>;
923
- description_index: z.ZodArray<z.ZodObject<{
924
- stable_id: z.ZodString;
925
- level: z.ZodEnum<["L0", "L1", "L2"]>;
926
- required: z.ZodBoolean;
927
- selectable: z.ZodBoolean;
928
- description: z.ZodObject<{
929
- summary: z.ZodString;
930
- intent_clues: z.ZodArray<z.ZodString, "many">;
931
- tech_stack: z.ZodArray<z.ZodString, "many">;
932
- impact: z.ZodArray<z.ZodString, "many">;
933
- must_read_if: z.ZodString;
934
- entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
935
- id: z.ZodOptional<z.ZodString>;
936
- knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
937
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
938
- knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
939
- layer_reason: z.ZodOptional<z.ZodString>;
940
- created_at: z.ZodOptional<z.ZodString>;
941
- }, "strip", z.ZodTypeAny, {
942
- summary: string;
943
- intent_clues: string[];
944
- tech_stack: string[];
945
- impact: string[];
946
- must_read_if: string;
947
- entities?: string[] | undefined;
948
- id?: string | undefined;
949
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
950
- maturity?: "draft" | "verified" | "proven" | undefined;
951
- knowledge_layer?: "personal" | "team" | undefined;
952
- layer_reason?: string | undefined;
953
- created_at?: string | undefined;
954
- }, {
955
- summary: string;
956
- intent_clues: string[];
957
- tech_stack: string[];
958
- impact: string[];
959
- must_read_if: string;
960
- entities?: string[] | undefined;
961
- id?: string | undefined;
962
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
963
- maturity?: "draft" | "verified" | "proven" | undefined;
964
- knowledge_layer?: "personal" | "team" | undefined;
965
- layer_reason?: string | undefined;
966
- created_at?: string | undefined;
967
- }>;
968
- type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
969
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
970
- layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
971
- layer_reason: z.ZodOptional<z.ZodString>;
972
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
973
- relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
974
- relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
975
- }, "strip", z.ZodTypeAny, {
976
- description: {
977
- summary: string;
978
- intent_clues: string[];
979
- tech_stack: string[];
980
- impact: string[];
981
- must_read_if: string;
982
- entities?: string[] | undefined;
983
- id?: string | undefined;
984
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
985
- maturity?: "draft" | "verified" | "proven" | undefined;
986
- knowledge_layer?: "personal" | "team" | undefined;
987
- layer_reason?: string | undefined;
988
- created_at?: string | undefined;
989
- };
990
- stable_id: string;
991
- level: "L0" | "L1" | "L2";
992
- required: boolean;
993
- selectable: boolean;
994
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
995
- relevance_scope?: "narrow" | "broad" | undefined;
996
- relevance_paths?: string[] | undefined;
997
- layer?: "personal" | "team" | undefined;
998
- maturity?: "draft" | "verified" | "proven" | undefined;
999
- layer_reason?: string | undefined;
1000
- tags?: string[] | undefined;
1001
- }, {
1002
- description: {
1003
- summary: string;
1004
- intent_clues: string[];
1005
- tech_stack: string[];
1006
- impact: string[];
1007
- must_read_if: string;
1008
- entities?: string[] | undefined;
1009
- id?: string | undefined;
1010
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1011
- maturity?: "draft" | "verified" | "proven" | undefined;
1012
- knowledge_layer?: "personal" | "team" | undefined;
1013
- layer_reason?: string | undefined;
1014
- created_at?: string | undefined;
1015
- };
1016
- stable_id: string;
1017
- level: "L0" | "L1" | "L2";
1018
- required: boolean;
1019
- selectable: boolean;
1020
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1021
- relevance_scope?: "narrow" | "broad" | undefined;
1022
- relevance_paths?: string[] | undefined;
1023
- layer?: "personal" | "team" | undefined;
1024
- maturity?: "draft" | "verified" | "proven" | undefined;
1025
- layer_reason?: string | undefined;
1026
- tags?: string[] | undefined;
1027
- }>, "many">;
1028
575
  }, "strip", z.ZodTypeAny, {
1029
576
  path: string;
1030
577
  requirement_profile: {
1031
578
  target_path: string;
1032
- path_segments: string[];
1033
- extension: string;
1034
579
  known_tech: string[];
1035
580
  user_intent: string;
1036
581
  detected_entities: string[];
1037
582
  };
1038
- description_index: {
1039
- description: {
1040
- summary: string;
1041
- intent_clues: string[];
1042
- tech_stack: string[];
1043
- impact: string[];
1044
- must_read_if: string;
1045
- entities?: string[] | undefined;
1046
- id?: string | undefined;
1047
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1048
- maturity?: "draft" | "verified" | "proven" | undefined;
1049
- knowledge_layer?: "personal" | "team" | undefined;
1050
- layer_reason?: string | undefined;
1051
- created_at?: string | undefined;
1052
- };
1053
- stable_id: string;
1054
- level: "L0" | "L1" | "L2";
1055
- required: boolean;
1056
- selectable: boolean;
1057
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1058
- relevance_scope?: "narrow" | "broad" | undefined;
1059
- relevance_paths?: string[] | undefined;
1060
- layer?: "personal" | "team" | undefined;
1061
- maturity?: "draft" | "verified" | "proven" | undefined;
1062
- layer_reason?: string | undefined;
1063
- tags?: string[] | undefined;
1064
- }[];
1065
583
  }, {
1066
584
  path: string;
1067
585
  requirement_profile: {
1068
586
  target_path: string;
1069
- path_segments: string[];
1070
- extension: string;
1071
587
  known_tech: string[];
1072
588
  user_intent: string;
1073
589
  detected_entities: string[];
1074
590
  };
1075
- description_index: {
1076
- description: {
1077
- summary: string;
1078
- intent_clues: string[];
1079
- tech_stack: string[];
1080
- impact: string[];
1081
- must_read_if: string;
1082
- entities?: string[] | undefined;
1083
- id?: string | undefined;
1084
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1085
- maturity?: "draft" | "verified" | "proven" | undefined;
1086
- knowledge_layer?: "personal" | "team" | undefined;
1087
- layer_reason?: string | undefined;
1088
- created_at?: string | undefined;
1089
- };
1090
- stable_id: string;
1091
- level: "L0" | "L1" | "L2";
1092
- required: boolean;
1093
- selectable: boolean;
1094
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1095
- relevance_scope?: "narrow" | "broad" | undefined;
1096
- relevance_paths?: string[] | undefined;
1097
- layer?: "personal" | "team" | undefined;
1098
- maturity?: "draft" | "verified" | "proven" | undefined;
1099
- layer_reason?: string | undefined;
1100
- tags?: string[] | undefined;
1101
- }[];
1102
591
  }>, "many">;
1103
- shared: z.ZodObject<{
1104
- description_index: z.ZodArray<z.ZodObject<{
1105
- stable_id: z.ZodString;
1106
- level: z.ZodEnum<["L0", "L1", "L2"]>;
1107
- required: z.ZodBoolean;
1108
- selectable: z.ZodBoolean;
1109
- description: z.ZodObject<{
1110
- summary: z.ZodString;
1111
- intent_clues: z.ZodArray<z.ZodString, "many">;
1112
- tech_stack: z.ZodArray<z.ZodString, "many">;
1113
- impact: z.ZodArray<z.ZodString, "many">;
1114
- must_read_if: z.ZodString;
1115
- entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1116
- id: z.ZodOptional<z.ZodString>;
1117
- knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
1118
- maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1119
- knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
1120
- layer_reason: z.ZodOptional<z.ZodString>;
1121
- created_at: z.ZodOptional<z.ZodString>;
1122
- }, "strip", z.ZodTypeAny, {
1123
- summary: string;
1124
- intent_clues: string[];
1125
- tech_stack: string[];
1126
- impact: string[];
1127
- must_read_if: string;
1128
- entities?: string[] | undefined;
1129
- id?: string | undefined;
1130
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1131
- maturity?: "draft" | "verified" | "proven" | undefined;
1132
- knowledge_layer?: "personal" | "team" | undefined;
1133
- layer_reason?: string | undefined;
1134
- created_at?: string | undefined;
1135
- }, {
1136
- summary: string;
1137
- intent_clues: string[];
1138
- tech_stack: string[];
1139
- impact: string[];
1140
- must_read_if: string;
1141
- entities?: string[] | undefined;
1142
- id?: string | undefined;
1143
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1144
- maturity?: "draft" | "verified" | "proven" | undefined;
1145
- knowledge_layer?: "personal" | "team" | undefined;
1146
- layer_reason?: string | undefined;
1147
- created_at?: string | undefined;
1148
- }>;
1149
- type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
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"]>>;
1150
603
  maturity: z.ZodOptional<z.ZodEnum<["draft", "verified", "proven"]>>;
1151
- layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
604
+ knowledge_layer: z.ZodOptional<z.ZodEnum<["personal", "team"]>>;
1152
605
  layer_reason: z.ZodOptional<z.ZodString>;
606
+ created_at: z.ZodOptional<z.ZodString>;
1153
607
  tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1154
608
  relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
1155
609
  relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1156
610
  }, "strip", z.ZodTypeAny, {
1157
- description: {
1158
- summary: string;
1159
- intent_clues: string[];
1160
- tech_stack: string[];
1161
- impact: string[];
1162
- must_read_if: string;
1163
- entities?: string[] | undefined;
1164
- id?: string | undefined;
1165
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1166
- maturity?: "draft" | "verified" | "proven" | undefined;
1167
- knowledge_layer?: "personal" | "team" | undefined;
1168
- layer_reason?: string | undefined;
1169
- created_at?: string | undefined;
1170
- };
1171
- stable_id: string;
1172
- level: "L0" | "L1" | "L2";
1173
- required: boolean;
1174
- selectable: boolean;
1175
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
611
+ summary: string;
612
+ intent_clues: string[];
613
+ tech_stack: string[];
614
+ impact: string[];
615
+ must_read_if: string;
1176
616
  relevance_scope?: "narrow" | "broad" | undefined;
1177
617
  relevance_paths?: string[] | undefined;
1178
- layer?: "personal" | "team" | undefined;
618
+ entities?: string[] | undefined;
619
+ id?: string | undefined;
620
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1179
621
  maturity?: "draft" | "verified" | "proven" | undefined;
622
+ knowledge_layer?: "personal" | "team" | undefined;
1180
623
  layer_reason?: string | undefined;
624
+ created_at?: string | undefined;
1181
625
  tags?: string[] | undefined;
1182
626
  }, {
1183
- description: {
1184
- summary: string;
1185
- intent_clues: string[];
1186
- tech_stack: string[];
1187
- impact: string[];
1188
- must_read_if: string;
1189
- entities?: string[] | undefined;
1190
- id?: string | undefined;
1191
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1192
- maturity?: "draft" | "verified" | "proven" | undefined;
1193
- knowledge_layer?: "personal" | "team" | undefined;
1194
- layer_reason?: string | undefined;
1195
- created_at?: string | undefined;
1196
- };
1197
- stable_id: string;
1198
- level: "L0" | "L1" | "L2";
1199
- required: boolean;
1200
- selectable: boolean;
1201
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
627
+ summary: string;
628
+ intent_clues: string[];
629
+ tech_stack: string[];
630
+ impact: string[];
631
+ must_read_if: string;
1202
632
  relevance_scope?: "narrow" | "broad" | undefined;
1203
633
  relevance_paths?: string[] | undefined;
1204
- layer?: "personal" | "team" | undefined;
634
+ entities?: string[] | undefined;
635
+ id?: string | undefined;
636
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1205
637
  maturity?: "draft" | "verified" | "proven" | undefined;
638
+ knowledge_layer?: "personal" | "team" | undefined;
1206
639
  layer_reason?: string | undefined;
640
+ created_at?: string | undefined;
1207
641
  tags?: string[] | undefined;
1208
- }>, "many">;
1209
- preflight_diagnostics: z.ZodArray<z.ZodObject<{
1210
- code: z.ZodLiteral<"missing_description">;
1211
- severity: z.ZodLiteral<"warn">;
1212
- message: z.ZodString;
1213
- stable_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1214
- path: z.ZodOptional<z.ZodString>;
1215
- }, "strip", z.ZodTypeAny, {
1216
- code: "missing_description";
1217
- message: string;
1218
- severity: "warn";
1219
- path?: string | undefined;
1220
- stable_ids?: string[] | undefined;
1221
- }, {
1222
- code: "missing_description";
1223
- message: string;
1224
- severity: "warn";
1225
- path?: string | undefined;
1226
- stable_ids?: string[] | undefined;
1227
- }>, "many">;
642
+ }>;
1228
643
  }, "strip", z.ZodTypeAny, {
1229
- description_index: {
1230
- description: {
1231
- summary: string;
1232
- intent_clues: string[];
1233
- tech_stack: string[];
1234
- impact: string[];
1235
- must_read_if: string;
1236
- entities?: string[] | undefined;
1237
- id?: string | undefined;
1238
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1239
- maturity?: "draft" | "verified" | "proven" | undefined;
1240
- knowledge_layer?: "personal" | "team" | undefined;
1241
- layer_reason?: string | undefined;
1242
- created_at?: string | undefined;
1243
- };
1244
- stable_id: string;
1245
- level: "L0" | "L1" | "L2";
1246
- required: boolean;
1247
- selectable: boolean;
1248
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
644
+ description: {
645
+ summary: string;
646
+ intent_clues: string[];
647
+ tech_stack: string[];
648
+ impact: string[];
649
+ must_read_if: string;
1249
650
  relevance_scope?: "narrow" | "broad" | undefined;
1250
651
  relevance_paths?: string[] | undefined;
1251
- layer?: "personal" | "team" | undefined;
652
+ entities?: string[] | undefined;
653
+ id?: string | undefined;
654
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1252
655
  maturity?: "draft" | "verified" | "proven" | undefined;
656
+ knowledge_layer?: "personal" | "team" | undefined;
1253
657
  layer_reason?: string | undefined;
658
+ created_at?: string | undefined;
1254
659
  tags?: string[] | undefined;
1255
- }[];
1256
- preflight_diagnostics: {
1257
- code: "missing_description";
1258
- message: string;
1259
- severity: "warn";
1260
- path?: string | undefined;
1261
- stable_ids?: string[] | undefined;
1262
- }[];
660
+ };
661
+ stable_id: string;
1263
662
  }, {
1264
- description_index: {
1265
- description: {
1266
- summary: string;
1267
- intent_clues: string[];
1268
- tech_stack: string[];
1269
- impact: string[];
1270
- must_read_if: string;
1271
- entities?: string[] | undefined;
1272
- id?: string | undefined;
1273
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1274
- maturity?: "draft" | "verified" | "proven" | undefined;
1275
- knowledge_layer?: "personal" | "team" | undefined;
1276
- layer_reason?: string | undefined;
1277
- created_at?: string | undefined;
1278
- };
1279
- stable_id: string;
1280
- level: "L0" | "L1" | "L2";
1281
- required: boolean;
1282
- selectable: boolean;
1283
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
663
+ description: {
664
+ summary: string;
665
+ intent_clues: string[];
666
+ tech_stack: string[];
667
+ impact: string[];
668
+ must_read_if: string;
1284
669
  relevance_scope?: "narrow" | "broad" | undefined;
1285
670
  relevance_paths?: string[] | undefined;
1286
- layer?: "personal" | "team" | undefined;
671
+ entities?: string[] | undefined;
672
+ id?: string | undefined;
673
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1287
674
  maturity?: "draft" | "verified" | "proven" | undefined;
675
+ knowledge_layer?: "personal" | "team" | undefined;
1288
676
  layer_reason?: string | undefined;
677
+ created_at?: string | undefined;
1289
678
  tags?: string[] | undefined;
1290
- }[];
1291
- preflight_diagnostics: {
1292
- code: "missing_description";
1293
- message: string;
1294
- severity: "warn";
1295
- path?: string | undefined;
1296
- stable_ids?: string[] | undefined;
1297
- }[];
1298
- }>;
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">;
1299
701
  rules: z.ZodArray<z.ZodObject<{
1300
702
  stable_id: z.ZodString;
1301
703
  level: z.ZodEnum<["L0", "L1", "L2"]>;
@@ -1353,79 +755,41 @@ declare const recallOutputSchema: z.ZodObject<{
1353
755
  path: string;
1354
756
  requirement_profile: {
1355
757
  target_path: string;
1356
- path_segments: string[];
1357
- extension: string;
1358
758
  known_tech: string[];
1359
759
  user_intent: string;
1360
760
  detected_entities: string[];
1361
761
  };
1362
- description_index: {
1363
- description: {
1364
- summary: string;
1365
- intent_clues: string[];
1366
- tech_stack: string[];
1367
- impact: string[];
1368
- must_read_if: string;
1369
- entities?: string[] | undefined;
1370
- id?: string | undefined;
1371
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1372
- maturity?: "draft" | "verified" | "proven" | undefined;
1373
- knowledge_layer?: "personal" | "team" | undefined;
1374
- layer_reason?: string | undefined;
1375
- created_at?: string | undefined;
1376
- };
1377
- stable_id: string;
1378
- level: "L0" | "L1" | "L2";
1379
- required: boolean;
1380
- selectable: boolean;
1381
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1382
- relevance_scope?: "narrow" | "broad" | undefined;
1383
- relevance_paths?: string[] | undefined;
1384
- layer?: "personal" | "team" | undefined;
1385
- maturity?: "draft" | "verified" | "proven" | undefined;
1386
- layer_reason?: string | undefined;
1387
- tags?: string[] | undefined;
1388
- }[];
1389
762
  }[];
1390
763
  stale: boolean;
1391
764
  revision_hash: string;
1392
765
  selection_token: string;
1393
- shared: {
1394
- description_index: {
1395
- description: {
1396
- summary: string;
1397
- intent_clues: string[];
1398
- tech_stack: string[];
1399
- impact: string[];
1400
- must_read_if: string;
1401
- entities?: string[] | undefined;
1402
- id?: string | undefined;
1403
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1404
- maturity?: "draft" | "verified" | "proven" | undefined;
1405
- knowledge_layer?: "personal" | "team" | undefined;
1406
- layer_reason?: string | undefined;
1407
- created_at?: string | undefined;
1408
- };
1409
- stable_id: string;
1410
- level: "L0" | "L1" | "L2";
1411
- required: boolean;
1412
- selectable: boolean;
1413
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
766
+ candidates: {
767
+ description: {
768
+ summary: string;
769
+ intent_clues: string[];
770
+ tech_stack: string[];
771
+ impact: string[];
772
+ must_read_if: string;
1414
773
  relevance_scope?: "narrow" | "broad" | undefined;
1415
774
  relevance_paths?: string[] | undefined;
1416
- layer?: "personal" | "team" | undefined;
775
+ entities?: string[] | undefined;
776
+ id?: string | undefined;
777
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1417
778
  maturity?: "draft" | "verified" | "proven" | undefined;
779
+ knowledge_layer?: "personal" | "team" | undefined;
1418
780
  layer_reason?: string | undefined;
781
+ created_at?: string | undefined;
1419
782
  tags?: string[] | undefined;
1420
- }[];
1421
- preflight_diagnostics: {
1422
- code: "missing_description";
1423
- message: string;
1424
- severity: "warn";
1425
- path?: string | undefined;
1426
- stable_ids?: string[] | undefined;
1427
- }[];
1428
- };
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
+ }[];
1429
793
  selected_stable_ids: string[];
1430
794
  rules: {
1431
795
  path: string;
@@ -1453,79 +817,41 @@ declare const recallOutputSchema: z.ZodObject<{
1453
817
  path: string;
1454
818
  requirement_profile: {
1455
819
  target_path: string;
1456
- path_segments: string[];
1457
- extension: string;
1458
820
  known_tech: string[];
1459
821
  user_intent: string;
1460
822
  detected_entities: string[];
1461
823
  };
1462
- description_index: {
1463
- description: {
1464
- summary: string;
1465
- intent_clues: string[];
1466
- tech_stack: string[];
1467
- impact: string[];
1468
- must_read_if: string;
1469
- entities?: string[] | undefined;
1470
- id?: string | undefined;
1471
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1472
- maturity?: "draft" | "verified" | "proven" | undefined;
1473
- knowledge_layer?: "personal" | "team" | undefined;
1474
- layer_reason?: string | undefined;
1475
- created_at?: string | undefined;
1476
- };
1477
- stable_id: string;
1478
- level: "L0" | "L1" | "L2";
1479
- required: boolean;
1480
- selectable: boolean;
1481
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1482
- relevance_scope?: "narrow" | "broad" | undefined;
1483
- relevance_paths?: string[] | undefined;
1484
- layer?: "personal" | "team" | undefined;
1485
- maturity?: "draft" | "verified" | "proven" | undefined;
1486
- layer_reason?: string | undefined;
1487
- tags?: string[] | undefined;
1488
- }[];
1489
824
  }[];
1490
825
  stale: boolean;
1491
826
  revision_hash: string;
1492
827
  selection_token: string;
1493
- shared: {
1494
- description_index: {
1495
- description: {
1496
- summary: string;
1497
- intent_clues: string[];
1498
- tech_stack: string[];
1499
- impact: string[];
1500
- must_read_if: string;
1501
- entities?: string[] | undefined;
1502
- id?: string | undefined;
1503
- knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1504
- maturity?: "draft" | "verified" | "proven" | undefined;
1505
- knowledge_layer?: "personal" | "team" | undefined;
1506
- layer_reason?: string | undefined;
1507
- created_at?: string | undefined;
1508
- };
1509
- stable_id: string;
1510
- level: "L0" | "L1" | "L2";
1511
- required: boolean;
1512
- selectable: boolean;
1513
- type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
828
+ candidates: {
829
+ description: {
830
+ summary: string;
831
+ intent_clues: string[];
832
+ tech_stack: string[];
833
+ impact: string[];
834
+ must_read_if: string;
1514
835
  relevance_scope?: "narrow" | "broad" | undefined;
1515
836
  relevance_paths?: string[] | undefined;
1516
- layer?: "personal" | "team" | undefined;
837
+ entities?: string[] | undefined;
838
+ id?: string | undefined;
839
+ knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
1517
840
  maturity?: "draft" | "verified" | "proven" | undefined;
841
+ knowledge_layer?: "personal" | "team" | undefined;
1518
842
  layer_reason?: string | undefined;
843
+ created_at?: string | undefined;
1519
844
  tags?: string[] | undefined;
1520
- }[];
1521
- preflight_diagnostics: {
1522
- code: "missing_description";
1523
- message: string;
1524
- severity: "warn";
1525
- path?: string | undefined;
1526
- stable_ids?: string[] | undefined;
1527
- }[];
1528
- };
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
+ }[];
1529
855
  selected_stable_ids: string[];
1530
856
  rules: {
1531
857
  path: string;
@@ -2429,8 +1755,8 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
2429
1755
  area: "canonical" | "pending";
2430
1756
  status?: "active" | "rejected" | "deferred" | undefined;
2431
1757
  summary?: string | undefined;
2432
- stable_id?: string | undefined;
2433
1758
  tags?: string[] | undefined;
1759
+ stable_id?: string | undefined;
2434
1760
  body?: string | undefined;
2435
1761
  title?: string | undefined;
2436
1762
  origin?: "personal" | "team" | undefined;
@@ -2444,8 +1770,8 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
2444
1770
  area: "canonical" | "pending";
2445
1771
  status?: "active" | "rejected" | "deferred" | undefined;
2446
1772
  summary?: string | undefined;
2447
- stable_id?: string | undefined;
2448
1773
  tags?: string[] | undefined;
1774
+ stable_id?: string | undefined;
2449
1775
  body?: string | undefined;
2450
1776
  title?: string | undefined;
2451
1777
  origin?: "personal" | "team" | undefined;
@@ -2478,8 +1804,8 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
2478
1804
  area: "canonical" | "pending";
2479
1805
  status?: "active" | "rejected" | "deferred" | undefined;
2480
1806
  summary?: string | undefined;
2481
- stable_id?: string | undefined;
2482
1807
  tags?: string[] | undefined;
1808
+ stable_id?: string | undefined;
2483
1809
  body?: string | undefined;
2484
1810
  title?: string | undefined;
2485
1811
  origin?: "personal" | "team" | undefined;
@@ -2502,8 +1828,8 @@ declare const FabReviewOutputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObj
2502
1828
  area: "canonical" | "pending";
2503
1829
  status?: "active" | "rejected" | "deferred" | undefined;
2504
1830
  summary?: string | undefined;
2505
- stable_id?: string | undefined;
2506
1831
  tags?: string[] | undefined;
1832
+ stable_id?: string | undefined;
2507
1833
  body?: string | undefined;
2508
1834
  title?: string | undefined;
2509
1835
  origin?: "personal" | "team" | undefined;
@@ -2619,8 +1945,8 @@ declare const FabReviewOutputShape: {
2619
1945
  area: "canonical" | "pending";
2620
1946
  status?: "active" | "rejected" | "deferred" | undefined;
2621
1947
  summary?: string | undefined;
2622
- stable_id?: string | undefined;
2623
1948
  tags?: string[] | undefined;
1949
+ stable_id?: string | undefined;
2624
1950
  body?: string | undefined;
2625
1951
  title?: string | undefined;
2626
1952
  origin?: "personal" | "team" | undefined;
@@ -2634,8 +1960,8 @@ declare const FabReviewOutputShape: {
2634
1960
  area: "canonical" | "pending";
2635
1961
  status?: "active" | "rejected" | "deferred" | undefined;
2636
1962
  summary?: string | undefined;
2637
- stable_id?: string | undefined;
2638
1963
  tags?: string[] | undefined;
1964
+ stable_id?: string | undefined;
2639
1965
  body?: string | undefined;
2640
1966
  title?: string | undefined;
2641
1967
  origin?: "personal" | "team" | undefined;
@@ -2731,18 +2057,30 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2731
2057
  recalled_unverified: z.ZodNumber;
2732
2058
  expected_but_missed: z.ZodNumber;
2733
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>;
2734
2064
  }, "strip", z.ZodTypeAny, {
2735
2065
  edits_touched: number;
2736
2066
  qualifying_cites: number;
2737
2067
  recalled_unverified: number;
2738
2068
  expected_but_missed: number;
2739
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;
2740
2074
  }, {
2741
2075
  edits_touched: number;
2742
2076
  qualifying_cites: number;
2743
2077
  recalled_unverified: number;
2744
2078
  expected_but_missed: number;
2745
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;
2746
2084
  }>;
2747
2085
  per_client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
2748
2086
  edits_touched: z.ZodOptional<z.ZodNumber>;
@@ -2815,6 +2153,10 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2815
2153
  recalled_unverified: number;
2816
2154
  expected_but_missed: number;
2817
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;
2818
2160
  };
2819
2161
  generated_at: string;
2820
2162
  layer_filter?: "personal" | "team" | "all" | undefined;
@@ -2854,6 +2196,10 @@ declare const citeCoverageReportSchema: z.ZodObject<{
2854
2196
  recalled_unverified: number;
2855
2197
  expected_but_missed: number;
2856
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;
2857
2203
  };
2858
2204
  generated_at: string;
2859
2205
  layer_filter?: "personal" | "team" | "all" | undefined;