@fenglimg/fabric-shared 2.1.0-rc.2 → 2.2.0-rc.10

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.
@@ -1,8 +1,6 @@
1
1
  import { z } from 'zod';
2
2
 
3
- type AgentsLayer = "L0" | "L1" | "L2";
4
3
  type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
5
- type AgentsActivationTier = "always" | "path" | "description";
6
4
  type AgentsIdentitySource = "declared" | "derived";
7
5
  interface RuleDescription {
8
6
  summary: string;
@@ -15,19 +13,18 @@ interface RuleDescription {
15
13
  knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes";
16
14
  maturity?: "draft" | "verified" | "proven";
17
15
  knowledge_layer?: "personal" | "team";
16
+ semantic_scope?: string;
18
17
  layer_reason?: string;
19
18
  created_at?: string;
20
19
  tags?: string[];
21
20
  relevance_scope?: "narrow" | "broad";
22
21
  relevance_paths?: string[];
22
+ related?: string[];
23
23
  }
24
24
  interface RuleDescriptionIndexItem {
25
25
  stable_id: string;
26
26
  description: RuleDescription;
27
- }
28
- interface AgentsMetaNodeActivation {
29
- tier: AgentsActivationTier;
30
- description?: string;
27
+ always_active?: boolean;
31
28
  }
32
29
  interface AgentsMetaNode {
33
30
  file: string;
@@ -36,12 +33,10 @@ interface AgentsMetaNode {
36
33
  hash: string;
37
34
  stable_id?: string;
38
35
  identity_source?: AgentsIdentitySource;
39
- activation?: AgentsMetaNodeActivation;
40
36
  description?: RuleDescription;
41
37
  sections?: string[];
42
38
  deps?: string[];
43
39
  priority?: "high" | "medium" | "low";
44
- level?: AgentsLayer;
45
40
  topology_type?: AgentsTopologyType;
46
41
  }
47
42
  interface AgentsMetaKnowledgeTypeCounters {
@@ -92,17 +87,14 @@ declare const auditModeSchema: z.ZodEnum<["strict", "warn", "off"]>;
92
87
  declare const clientPathsSchema: z.ZodObject<{
93
88
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
94
89
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
95
- cursor: z.ZodOptional<z.ZodString>;
96
90
  codexCLI: z.ZodOptional<z.ZodString>;
97
91
  }, "strict", z.ZodTypeAny, {
98
92
  claudeCodeCLI?: string | undefined;
99
93
  claudeCodeDesktop?: string | undefined;
100
- cursor?: string | undefined;
101
94
  codexCLI?: string | undefined;
102
95
  }, {
103
96
  claudeCodeCLI?: string | undefined;
104
97
  claudeCodeDesktop?: string | undefined;
105
- cursor?: string | undefined;
106
98
  codexCLI?: string | undefined;
107
99
  }>;
108
100
  declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
@@ -116,26 +108,49 @@ declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
116
108
  hardBytes?: number | undefined;
117
109
  }>>;
118
110
  declare const selectionTokenTtlMsSchema: z.ZodNumber;
119
- declare const fabricLanguageSchema: z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>;
111
+ declare const planContextTopKSchema: z.ZodNumber;
112
+ declare const fabricLanguageSchema: z.ZodEnum<["zh-CN", "en"]>;
120
113
  declare const defaultLayerFilterSchema: z.ZodEnum<["team", "personal", "both"]>;
114
+ declare const nudgeModeSchema: z.ZodEnum<["silent", "minimal", "normal", "verbose"]>;
115
+ declare const observeConfigSchema: z.ZodObject<{
116
+ session_start: z.ZodOptional<z.ZodBoolean>;
117
+ pre_tool_use: z.ZodOptional<z.ZodBoolean>;
118
+ stop: z.ZodOptional<z.ZodBoolean>;
119
+ }, "strict", z.ZodTypeAny, {
120
+ session_start?: boolean | undefined;
121
+ pre_tool_use?: boolean | undefined;
122
+ stop?: boolean | undefined;
123
+ }, {
124
+ session_start?: boolean | undefined;
125
+ pre_tool_use?: boolean | undefined;
126
+ stop?: boolean | undefined;
127
+ }>;
128
+ declare const writeRouteSchema: z.ZodObject<{
129
+ scope: z.ZodString;
130
+ store: z.ZodString;
131
+ }, "strict", z.ZodTypeAny, {
132
+ scope: string;
133
+ store: string;
134
+ }, {
135
+ scope: string;
136
+ store: string;
137
+ }>;
121
138
  declare const fabricConfigSchema: z.ZodObject<{
122
139
  clientPaths: z.ZodOptional<z.ZodObject<{
123
140
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
124
141
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
125
- cursor: z.ZodOptional<z.ZodString>;
126
142
  codexCLI: z.ZodOptional<z.ZodString>;
127
143
  }, "strict", z.ZodTypeAny, {
128
144
  claudeCodeCLI?: string | undefined;
129
145
  claudeCodeDesktop?: string | undefined;
130
- cursor?: string | undefined;
131
146
  codexCLI?: string | undefined;
132
147
  }, {
133
148
  claudeCodeCLI?: string | undefined;
134
149
  claudeCodeDesktop?: string | undefined;
135
- cursor?: string | undefined;
136
150
  codexCLI?: string | undefined;
137
151
  }>>;
138
152
  project_id: z.ZodOptional<z.ZodString>;
153
+ workspace_binding_id: z.ZodOptional<z.ZodString>;
139
154
  required_stores: z.ZodOptional<z.ZodArray<z.ZodObject<{
140
155
  id: z.ZodString;
141
156
  suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
@@ -147,6 +162,18 @@ declare const fabricConfigSchema: z.ZodObject<{
147
162
  suggested_remote?: string | undefined;
148
163
  }>, "many">>;
149
164
  active_write_store: z.ZodOptional<z.ZodString>;
165
+ active_project: z.ZodOptional<z.ZodString>;
166
+ write_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
167
+ scope: z.ZodString;
168
+ store: z.ZodString;
169
+ }, "strict", z.ZodTypeAny, {
170
+ scope: string;
171
+ store: string;
172
+ }, {
173
+ scope: string;
174
+ store: string;
175
+ }>, "many">>;
176
+ default_write_store: z.ZodOptional<z.ZodString>;
150
177
  scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
151
178
  audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
152
179
  mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
@@ -159,8 +186,21 @@ declare const fabricConfigSchema: z.ZodObject<{
159
186
  warnBytes?: number | undefined;
160
187
  hardBytes?: number | undefined;
161
188
  }>>;
162
- fabric_language: z.ZodDefault<z.ZodOptional<z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>>>;
163
189
  default_layer_filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>>;
190
+ nudge_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["silent", "minimal", "normal", "verbose"]>>>;
191
+ observe: z.ZodOptional<z.ZodObject<{
192
+ session_start: z.ZodOptional<z.ZodBoolean>;
193
+ pre_tool_use: z.ZodOptional<z.ZodBoolean>;
194
+ stop: z.ZodOptional<z.ZodBoolean>;
195
+ }, "strict", z.ZodTypeAny, {
196
+ session_start?: boolean | undefined;
197
+ pre_tool_use?: boolean | undefined;
198
+ stop?: boolean | undefined;
199
+ }, {
200
+ session_start?: boolean | undefined;
201
+ pre_tool_use?: boolean | undefined;
202
+ stop?: boolean | undefined;
203
+ }>>;
164
204
  archive_hint_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
165
205
  underseed_node_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
166
206
  archive_edit_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -182,23 +222,35 @@ declare const fabricConfigSchema: z.ZodObject<{
182
222
  reverse_unarchive_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
183
223
  reverse_unarchive_dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
184
224
  cite_evict_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
225
+ cite_recall_nudge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
226
+ cite_recall_window_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
227
+ cite_nudge_ignore_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
228
+ conflict_lint_similarity_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
185
229
  fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
186
230
  onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
187
231
  hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
232
+ broad_index_backstop: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
188
233
  hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
234
+ cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
235
+ self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
189
236
  hint_narrow_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
190
237
  hint_narrow_dedup_window_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
191
238
  hint_broad_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
192
239
  hint_narrow_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
193
- orphan_demote_stable_days: z.ZodOptional<z.ZodNumber>;
194
- orphan_demote_endorsed_days: z.ZodOptional<z.ZodNumber>;
240
+ orphan_demote_proven_days: z.ZodOptional<z.ZodNumber>;
241
+ orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
195
242
  orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
196
243
  hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
197
244
  hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
198
245
  selection_token_ttl_ms: z.ZodOptional<z.ZodNumber>;
246
+ plan_context_top_k: z.ZodOptional<z.ZodNumber>;
247
+ recall_relevance_ratio: z.ZodOptional<z.ZodNumber>;
248
+ embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
249
+ embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
250
+ embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
199
251
  }, "strip", z.ZodTypeAny, {
200
- fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
201
252
  default_layer_filter: "personal" | "team" | "both";
253
+ nudge_mode: "silent" | "minimal" | "normal" | "verbose";
202
254
  archive_hint_cooldown_hours: number;
203
255
  underseed_node_threshold: number;
204
256
  archive_edit_threshold: number;
@@ -220,59 +272,93 @@ declare const fabricConfigSchema: z.ZodObject<{
220
272
  reverse_unarchive_enabled: boolean;
221
273
  reverse_unarchive_dry_run: boolean;
222
274
  cite_evict_interval: number;
275
+ cite_recall_nudge: boolean;
276
+ cite_recall_window_minutes: number;
277
+ conflict_lint_similarity_threshold: number;
223
278
  onboard_slots_opted_out: string[];
224
279
  hint_broad_top_k: number;
280
+ broad_index_backstop: number;
281
+ cite_policy_enabled: boolean;
282
+ self_archive_policy_enabled: boolean;
225
283
  hint_narrow_top_k: number;
226
284
  hint_narrow_dedup_window_turns: number;
227
285
  hint_broad_cooldown_hours: number;
228
286
  hint_narrow_cooldown_hours: number;
229
287
  hint_summary_max_len: number;
230
288
  hint_reminder_to_context: boolean;
289
+ embed_enabled: boolean;
290
+ embed_weight: number;
291
+ embed_model: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2";
231
292
  clientPaths?: {
232
293
  claudeCodeCLI?: string | undefined;
233
294
  claudeCodeDesktop?: string | undefined;
234
- cursor?: string | undefined;
235
295
  codexCLI?: string | undefined;
236
296
  } | undefined;
237
297
  project_id?: string | undefined;
298
+ workspace_binding_id?: string | undefined;
238
299
  required_stores?: {
239
300
  id: string;
240
301
  suggested_remote?: string | undefined;
241
302
  }[] | undefined;
242
303
  active_write_store?: string | undefined;
304
+ active_project?: string | undefined;
305
+ write_routes?: {
306
+ scope: string;
307
+ store: string;
308
+ }[] | undefined;
309
+ default_write_store?: string | undefined;
243
310
  scanIgnores?: string[] | undefined;
244
311
  audit_mode?: "strict" | "warn" | "off" | undefined;
245
312
  mcpPayloadLimits?: {
246
313
  warnBytes?: number | undefined;
247
314
  hardBytes?: number | undefined;
248
315
  } | undefined;
316
+ observe?: {
317
+ session_start?: boolean | undefined;
318
+ pre_tool_use?: boolean | undefined;
319
+ stop?: boolean | undefined;
320
+ } | undefined;
321
+ cite_nudge_ignore_globs?: string[] | undefined;
249
322
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
250
323
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
251
- orphan_demote_stable_days?: number | undefined;
252
- orphan_demote_endorsed_days?: number | undefined;
324
+ orphan_demote_proven_days?: number | undefined;
325
+ orphan_demote_verified_days?: number | undefined;
253
326
  orphan_demote_draft_days?: number | undefined;
254
327
  selection_token_ttl_ms?: number | undefined;
328
+ plan_context_top_k?: number | undefined;
329
+ recall_relevance_ratio?: number | undefined;
255
330
  }, {
256
331
  clientPaths?: {
257
332
  claudeCodeCLI?: string | undefined;
258
333
  claudeCodeDesktop?: string | undefined;
259
- cursor?: string | undefined;
260
334
  codexCLI?: string | undefined;
261
335
  } | undefined;
262
336
  project_id?: string | undefined;
337
+ workspace_binding_id?: string | undefined;
263
338
  required_stores?: {
264
339
  id: string;
265
340
  suggested_remote?: string | undefined;
266
341
  }[] | undefined;
267
342
  active_write_store?: string | undefined;
343
+ active_project?: string | undefined;
344
+ write_routes?: {
345
+ scope: string;
346
+ store: string;
347
+ }[] | undefined;
348
+ default_write_store?: string | undefined;
268
349
  scanIgnores?: string[] | undefined;
269
350
  audit_mode?: "strict" | "warn" | "off" | undefined;
270
351
  mcpPayloadLimits?: {
271
352
  warnBytes?: number | undefined;
272
353
  hardBytes?: number | undefined;
273
354
  } | undefined;
274
- fabric_language?: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid" | undefined;
275
355
  default_layer_filter?: "personal" | "team" | "both" | undefined;
356
+ nudge_mode?: "silent" | "minimal" | "normal" | "verbose" | undefined;
357
+ observe?: {
358
+ session_start?: boolean | undefined;
359
+ pre_tool_use?: boolean | undefined;
360
+ stop?: boolean | undefined;
361
+ } | undefined;
276
362
  archive_hint_cooldown_hours?: number | undefined;
277
363
  underseed_node_threshold?: number | undefined;
278
364
  archive_edit_threshold?: number | undefined;
@@ -294,26 +380,37 @@ declare const fabricConfigSchema: z.ZodObject<{
294
380
  reverse_unarchive_enabled?: boolean | undefined;
295
381
  reverse_unarchive_dry_run?: boolean | undefined;
296
382
  cite_evict_interval?: number | undefined;
383
+ cite_recall_nudge?: boolean | undefined;
384
+ cite_recall_window_minutes?: number | undefined;
385
+ cite_nudge_ignore_globs?: string[] | undefined;
386
+ conflict_lint_similarity_threshold?: number | undefined;
297
387
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
298
388
  onboard_slots_opted_out?: string[] | undefined;
299
389
  hint_broad_top_k?: number | undefined;
390
+ broad_index_backstop?: number | undefined;
300
391
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
392
+ cite_policy_enabled?: boolean | undefined;
393
+ self_archive_policy_enabled?: boolean | undefined;
301
394
  hint_narrow_top_k?: number | undefined;
302
395
  hint_narrow_dedup_window_turns?: number | undefined;
303
396
  hint_broad_cooldown_hours?: number | undefined;
304
397
  hint_narrow_cooldown_hours?: number | undefined;
305
- orphan_demote_stable_days?: number | undefined;
306
- orphan_demote_endorsed_days?: number | undefined;
398
+ orphan_demote_proven_days?: number | undefined;
399
+ orphan_demote_verified_days?: number | undefined;
307
400
  orphan_demote_draft_days?: number | undefined;
308
401
  hint_summary_max_len?: number | undefined;
309
402
  hint_reminder_to_context?: boolean | undefined;
310
403
  selection_token_ttl_ms?: number | undefined;
404
+ plan_context_top_k?: number | undefined;
405
+ recall_relevance_ratio?: number | undefined;
406
+ embed_enabled?: boolean | undefined;
407
+ embed_weight?: number | undefined;
408
+ embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
311
409
  }>;
312
410
 
313
411
  interface ClientPaths {
314
412
  claudeCodeCLI?: string;
315
413
  claudeCodeDesktop?: string;
316
- cursor?: string;
317
414
  codexCLI?: string;
318
415
  }
319
416
  type AuditMode = "strict" | "warn" | "off";
@@ -325,4 +422,4 @@ type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
325
422
  type DefaultLayerFilter = "team" | "personal" | "both";
326
423
  type FabricConfig = z.input<typeof fabricConfigSchema>;
327
424
 
328
- export { type AgentsMetaNode as A, type ClientPaths as C, type DefaultLayerFilter as D, type FabricConfig as F, type HumanLockEntry as H, type LedgerEntry as L, type McpPayloadLimits as M, type RuleDescription as R, type AgentsIdentitySource as a, type AgentsLayer as b, type AgentsTopologyType as c, type AgentsMeta as d, type AgentsActivationTier as e, fabricConfigSchema as f, type AgentsMetaCountersEnvelope as g, type AgentsMetaKnowledgeTypeCounters as h, type AgentsMetaNodeActivation as i, type AiLedgerEntry as j, type AuditMode as k, type FabricLanguage as l, type HumanLedgerEntry as m, type RuleDescriptionIndexItem as n, auditModeSchema as o, clientPathsSchema as p, defaultLayerFilterSchema as q, fabricLanguageSchema as r, mcpPayloadLimitsSchema as s, selectionTokenTtlMsSchema as t };
425
+ export { type AgentsMetaNode as A, type ClientPaths as C, type DefaultLayerFilter as D, type FabricConfig as F, type HumanLockEntry as H, type LedgerEntry as L, type McpPayloadLimits as M, type RuleDescription as R, type AgentsIdentitySource as a, type AgentsTopologyType as b, type AgentsMeta as c, type AgentsMetaCountersEnvelope as d, type AgentsMetaKnowledgeTypeCounters as e, fabricConfigSchema as f, type AiLedgerEntry as g, type AuditMode as h, type FabricLanguage as i, type HumanLedgerEntry as j, type RuleDescriptionIndexItem as k, auditModeSchema as l, clientPathsSchema as m, defaultLayerFilterSchema as n, fabricLanguageSchema as o, mcpPayloadLimitsSchema as p, nudgeModeSchema as q, observeConfigSchema as r, planContextTopKSchema as s, selectionTokenTtlMsSchema as t, writeRouteSchema as w };