@fenglimg/fabric-shared 2.2.0-rc.1 → 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,6 +13,7 @@ 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[];
@@ -25,10 +24,7 @@ interface RuleDescription {
25
24
  interface RuleDescriptionIndexItem {
26
25
  stable_id: string;
27
26
  description: RuleDescription;
28
- }
29
- interface AgentsMetaNodeActivation {
30
- tier: AgentsActivationTier;
31
- description?: string;
27
+ always_active?: boolean;
32
28
  }
33
29
  interface AgentsMetaNode {
34
30
  file: string;
@@ -37,12 +33,10 @@ interface AgentsMetaNode {
37
33
  hash: string;
38
34
  stable_id?: string;
39
35
  identity_source?: AgentsIdentitySource;
40
- activation?: AgentsMetaNodeActivation;
41
36
  description?: RuleDescription;
42
37
  sections?: string[];
43
38
  deps?: string[];
44
39
  priority?: "high" | "medium" | "low";
45
- level?: AgentsLayer;
46
40
  topology_type?: AgentsTopologyType;
47
41
  }
48
42
  interface AgentsMetaKnowledgeTypeCounters {
@@ -93,17 +87,14 @@ declare const auditModeSchema: z.ZodEnum<["strict", "warn", "off"]>;
93
87
  declare const clientPathsSchema: z.ZodObject<{
94
88
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
95
89
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
96
- cursor: z.ZodOptional<z.ZodString>;
97
90
  codexCLI: z.ZodOptional<z.ZodString>;
98
91
  }, "strict", z.ZodTypeAny, {
99
92
  claudeCodeCLI?: string | undefined;
100
93
  claudeCodeDesktop?: string | undefined;
101
- cursor?: string | undefined;
102
94
  codexCLI?: string | undefined;
103
95
  }, {
104
96
  claudeCodeCLI?: string | undefined;
105
97
  claudeCodeDesktop?: string | undefined;
106
- cursor?: string | undefined;
107
98
  codexCLI?: string | undefined;
108
99
  }>;
109
100
  declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
@@ -118,26 +109,48 @@ declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
118
109
  }>>;
119
110
  declare const selectionTokenTtlMsSchema: z.ZodNumber;
120
111
  declare const planContextTopKSchema: z.ZodNumber;
121
- declare const fabricLanguageSchema: z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>;
112
+ declare const fabricLanguageSchema: z.ZodEnum<["zh-CN", "en"]>;
122
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
+ }>;
123
138
  declare const fabricConfigSchema: z.ZodObject<{
124
139
  clientPaths: z.ZodOptional<z.ZodObject<{
125
140
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
126
141
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
127
- cursor: z.ZodOptional<z.ZodString>;
128
142
  codexCLI: z.ZodOptional<z.ZodString>;
129
143
  }, "strict", z.ZodTypeAny, {
130
144
  claudeCodeCLI?: string | undefined;
131
145
  claudeCodeDesktop?: string | undefined;
132
- cursor?: string | undefined;
133
146
  codexCLI?: string | undefined;
134
147
  }, {
135
148
  claudeCodeCLI?: string | undefined;
136
149
  claudeCodeDesktop?: string | undefined;
137
- cursor?: string | undefined;
138
150
  codexCLI?: string | undefined;
139
151
  }>>;
140
152
  project_id: z.ZodOptional<z.ZodString>;
153
+ workspace_binding_id: z.ZodOptional<z.ZodString>;
141
154
  required_stores: z.ZodOptional<z.ZodArray<z.ZodObject<{
142
155
  id: z.ZodString;
143
156
  suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
@@ -149,6 +162,18 @@ declare const fabricConfigSchema: z.ZodObject<{
149
162
  suggested_remote?: string | undefined;
150
163
  }>, "many">>;
151
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>;
152
177
  scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
153
178
  audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
154
179
  mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
@@ -161,8 +186,21 @@ declare const fabricConfigSchema: z.ZodObject<{
161
186
  warnBytes?: number | undefined;
162
187
  hardBytes?: number | undefined;
163
188
  }>>;
164
- fabric_language: z.ZodDefault<z.ZodOptional<z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>>>;
165
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
+ }>>;
166
204
  archive_hint_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
167
205
  underseed_node_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
168
206
  archive_edit_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -184,10 +222,14 @@ declare const fabricConfigSchema: z.ZodObject<{
184
222
  reverse_unarchive_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
185
223
  reverse_unarchive_dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
186
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>>;
187
229
  fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
188
230
  onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
189
231
  hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
190
- hint_broad_budget_chars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
232
+ broad_index_backstop: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
191
233
  hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
192
234
  cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
193
235
  self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -195,19 +237,20 @@ declare const fabricConfigSchema: z.ZodObject<{
195
237
  hint_narrow_dedup_window_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
196
238
  hint_broad_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
197
239
  hint_narrow_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
198
- orphan_demote_stable_days: z.ZodOptional<z.ZodNumber>;
199
- 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>;
200
242
  orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
201
243
  hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
202
244
  hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
203
245
  selection_token_ttl_ms: z.ZodOptional<z.ZodNumber>;
204
246
  plan_context_top_k: z.ZodOptional<z.ZodNumber>;
205
- retrieval_budget_profile: z.ZodOptional<z.ZodEnum<["conservative", "balanced", "generous"]>>;
247
+ recall_relevance_ratio: z.ZodOptional<z.ZodNumber>;
206
248
  embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
207
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"]>>>;
208
251
  }, "strip", z.ZodTypeAny, {
209
- fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
210
252
  default_layer_filter: "personal" | "team" | "both";
253
+ nudge_mode: "silent" | "minimal" | "normal" | "verbose";
211
254
  archive_hint_cooldown_hours: number;
212
255
  underseed_node_threshold: number;
213
256
  archive_edit_threshold: number;
@@ -229,9 +272,12 @@ declare const fabricConfigSchema: z.ZodObject<{
229
272
  reverse_unarchive_enabled: boolean;
230
273
  reverse_unarchive_dry_run: boolean;
231
274
  cite_evict_interval: number;
275
+ cite_recall_nudge: boolean;
276
+ cite_recall_window_minutes: number;
277
+ conflict_lint_similarity_threshold: number;
232
278
  onboard_slots_opted_out: string[];
233
279
  hint_broad_top_k: number;
234
- hint_broad_budget_chars: number;
280
+ broad_index_backstop: number;
235
281
  cite_policy_enabled: boolean;
236
282
  self_archive_policy_enabled: boolean;
237
283
  hint_narrow_top_k: number;
@@ -242,53 +288,77 @@ declare const fabricConfigSchema: z.ZodObject<{
242
288
  hint_reminder_to_context: boolean;
243
289
  embed_enabled: boolean;
244
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";
245
292
  clientPaths?: {
246
293
  claudeCodeCLI?: string | undefined;
247
294
  claudeCodeDesktop?: string | undefined;
248
- cursor?: string | undefined;
249
295
  codexCLI?: string | undefined;
250
296
  } | undefined;
251
297
  project_id?: string | undefined;
298
+ workspace_binding_id?: string | undefined;
252
299
  required_stores?: {
253
300
  id: string;
254
301
  suggested_remote?: string | undefined;
255
302
  }[] | undefined;
256
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;
257
310
  scanIgnores?: string[] | undefined;
258
311
  audit_mode?: "strict" | "warn" | "off" | undefined;
259
312
  mcpPayloadLimits?: {
260
313
  warnBytes?: number | undefined;
261
314
  hardBytes?: number | undefined;
262
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;
263
322
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
264
323
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
265
- orphan_demote_stable_days?: number | undefined;
266
- orphan_demote_endorsed_days?: number | undefined;
324
+ orphan_demote_proven_days?: number | undefined;
325
+ orphan_demote_verified_days?: number | undefined;
267
326
  orphan_demote_draft_days?: number | undefined;
268
327
  selection_token_ttl_ms?: number | undefined;
269
328
  plan_context_top_k?: number | undefined;
270
- retrieval_budget_profile?: "conservative" | "balanced" | "generous" | undefined;
329
+ recall_relevance_ratio?: number | undefined;
271
330
  }, {
272
331
  clientPaths?: {
273
332
  claudeCodeCLI?: string | undefined;
274
333
  claudeCodeDesktop?: string | undefined;
275
- cursor?: string | undefined;
276
334
  codexCLI?: string | undefined;
277
335
  } | undefined;
278
336
  project_id?: string | undefined;
337
+ workspace_binding_id?: string | undefined;
279
338
  required_stores?: {
280
339
  id: string;
281
340
  suggested_remote?: string | undefined;
282
341
  }[] | undefined;
283
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;
284
349
  scanIgnores?: string[] | undefined;
285
350
  audit_mode?: "strict" | "warn" | "off" | undefined;
286
351
  mcpPayloadLimits?: {
287
352
  warnBytes?: number | undefined;
288
353
  hardBytes?: number | undefined;
289
354
  } | undefined;
290
- fabric_language?: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid" | undefined;
291
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;
292
362
  archive_hint_cooldown_hours?: number | undefined;
293
363
  underseed_node_threshold?: number | undefined;
294
364
  archive_edit_threshold?: number | undefined;
@@ -310,10 +380,14 @@ declare const fabricConfigSchema: z.ZodObject<{
310
380
  reverse_unarchive_enabled?: boolean | undefined;
311
381
  reverse_unarchive_dry_run?: boolean | undefined;
312
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;
313
387
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
314
388
  onboard_slots_opted_out?: string[] | undefined;
315
389
  hint_broad_top_k?: number | undefined;
316
- hint_broad_budget_chars?: number | undefined;
390
+ broad_index_backstop?: number | undefined;
317
391
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
318
392
  cite_policy_enabled?: boolean | undefined;
319
393
  self_archive_policy_enabled?: boolean | undefined;
@@ -321,22 +395,22 @@ declare const fabricConfigSchema: z.ZodObject<{
321
395
  hint_narrow_dedup_window_turns?: number | undefined;
322
396
  hint_broad_cooldown_hours?: number | undefined;
323
397
  hint_narrow_cooldown_hours?: number | undefined;
324
- orphan_demote_stable_days?: number | undefined;
325
- orphan_demote_endorsed_days?: number | undefined;
398
+ orphan_demote_proven_days?: number | undefined;
399
+ orphan_demote_verified_days?: number | undefined;
326
400
  orphan_demote_draft_days?: number | undefined;
327
401
  hint_summary_max_len?: number | undefined;
328
402
  hint_reminder_to_context?: boolean | undefined;
329
403
  selection_token_ttl_ms?: number | undefined;
330
404
  plan_context_top_k?: number | undefined;
331
- retrieval_budget_profile?: "conservative" | "balanced" | "generous" | undefined;
405
+ recall_relevance_ratio?: number | undefined;
332
406
  embed_enabled?: boolean | undefined;
333
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;
334
409
  }>;
335
410
 
336
411
  interface ClientPaths {
337
412
  claudeCodeCLI?: string;
338
413
  claudeCodeDesktop?: string;
339
- cursor?: string;
340
414
  codexCLI?: string;
341
415
  }
342
416
  type AuditMode = "strict" | "warn" | "off";
@@ -348,4 +422,4 @@ type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
348
422
  type DefaultLayerFilter = "team" | "personal" | "both";
349
423
  type FabricConfig = z.input<typeof fabricConfigSchema>;
350
424
 
351
- 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, planContextTopKSchema as t, selectionTokenTtlMsSchema as u };
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 };