@fenglimg/fabric-shared 1.5.1 → 1.6.0

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.
@@ -51,6 +51,7 @@ var enMessages = {
51
51
  "cli.doctor.description": "Run Fabric doctor checks and optional compliance audit reporting.",
52
52
  "cli.doctor.args.target.description": "Target project path. Defaults to CLI arg, EXTERNAL_FIXTURE_PATH, fabric.config.json, then cwd.",
53
53
  "cli.doctor.args.audit.description": "Print fab_get_rules compliance violations for AI edit intents.",
54
+ "cli.doctor.args.fix.description": "Migrate the legacy root ledger into .fabric/.intent-ledger.jsonl when needed.",
54
55
  "cli.doctor.args.window-minutes.description": "Audit lookback window in minutes for matching fab_get_rules calls. Default 5.",
55
56
  "cli.doctor.errors.invalid-window": "Invalid audit window: {value}",
56
57
  "cli.doctor.audit.preview-only": "auditMode is off in fabric.config.json; running fab doctor --audit as a manual preview only.",
@@ -482,6 +483,7 @@ var zhCNMessages = {
482
483
  "cli.doctor.description": "\u8FD0\u884C Fabric doctor \u68C0\u67E5\uFF0C\u5E76\u53EF\u9009\u8F93\u51FA\u5408\u89C4\u5BA1\u8BA1\u62A5\u544A\u3002",
483
484
  "cli.doctor.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json\u3001\u5F53\u524D\u76EE\u5F55\u3002",
484
485
  "cli.doctor.args.audit.description": "\u8F93\u51FA AI \u7F16\u8F91\u610F\u56FE\u7F3A\u5C11 fab_get_rules \u524D\u7F6E\u8C03\u7528\u7684\u8FDD\u89C4\u9879\u3002",
486
+ "cli.doctor.args.fix.description": "\u9700\u8981\u65F6\u5C06\u65E7\u7684\u6839\u76EE\u5F55 ledger \u8FC1\u79FB\u5230 .fabric/.intent-ledger.jsonl\u3002",
485
487
  "cli.doctor.args.window-minutes.description": "\u5339\u914D fab_get_rules \u8C03\u7528\u7684\u56DE\u770B\u65F6\u95F4\u7A97\u53E3\uFF0C\u5355\u4F4D\u4E3A\u5206\u949F\u3002\u9ED8\u8BA4 5 \u5206\u949F\u3002",
486
488
  "cli.doctor.errors.invalid-window": "\u65E0\u6548\u7684\u5BA1\u8BA1\u65F6\u95F4\u7A97\u53E3\uFF1A{value}",
487
489
  "cli.doctor.audit.preview-only": "fabric.config.json \u4E2D auditMode \u4E3A off\uFF1B\u5F53\u524D fab doctor --audit \u4EC5\u6267\u884C\u624B\u52A8\u9884\u89C8\uFF0C\u4E0D\u4F1A\u6539\u53D8\u9000\u51FA\u7801\u3002",
@@ -924,7 +926,7 @@ var PROTECTED_TOKENS = [
924
926
  ".fabric/human-lock.json",
925
927
  ".fabric/init-context.json",
926
928
  ".fabric/forensic.json",
927
- ".intent-ledger.jsonl",
929
+ ".fabric/.intent-ledger.jsonl",
928
930
  "@HUMAN",
929
931
  "shadow constraints",
930
932
  "Shadow Mirroring",
@@ -12,7 +12,7 @@ declare function detectNodeLocale(): Locale;
12
12
 
13
13
  declare function normalizeLocale(raw: string | null | undefined): Locale;
14
14
 
15
- declare const PROTECTED_TOKENS: readonly ["fab_get_rules", "fab_append_intent", "fab_update_registry", "fabric_rules", "ledger_entry", "ledger_entry_id", "agent_meta", "AGENTS.md", "FABRIC.md", ".fabric/agents/", ".fabric/agents/_cross/", ".fabric/agents.meta.json", ".fabric/human-lock.json", ".fabric/init-context.json", ".fabric/forensic.json", ".intent-ledger.jsonl", "@HUMAN", "shadow constraints", "Shadow Mirroring", "CORE RULES", "DO NOT TRANSLATE", "MUST", "NEVER"];
15
+ declare const PROTECTED_TOKENS: readonly ["fab_get_rules", "fab_append_intent", "fab_update_registry", "fabric_rules", "ledger_entry", "ledger_entry_id", "agent_meta", "AGENTS.md", "FABRIC.md", ".fabric/agents/", ".fabric/agents/_cross/", ".fabric/agents.meta.json", ".fabric/human-lock.json", ".fabric/init-context.json", ".fabric/forensic.json", ".fabric/.intent-ledger.jsonl", "@HUMAN", "shadow constraints", "Shadow Mirroring", "CORE RULES", "DO NOT TRANSLATE", "MUST", "NEVER"];
16
16
  type ProtectedToken = (typeof PROTECTED_TOKENS)[number];
17
17
 
18
18
  declare const enMessages: Messages;
@@ -6,7 +6,7 @@ import {
6
6
  enMessages,
7
7
  normalizeLocale,
8
8
  zhCNMessages
9
- } from "../chunk-XEVK2HU2.js";
9
+ } from "../chunk-KNZIX6IL.js";
10
10
  export {
11
11
  PROTECTED_TOKENS,
12
12
  createTranslator,
package/dist/index.d.ts CHANGED
@@ -1,21 +1,103 @@
1
- import { AgentsLayer, AgentsTopologyType, AgentsMetaNode, HumanLockEntry, AgentsMeta, LedgerEntry } from './types/index.js';
2
- export { AgentsActivationTier, AgentsMetaNodeActivation, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry } from './types/index.js';
1
+ import { AgentsMetaNode, AgentsIdentitySource, AgentsLayer, AgentsTopologyType, HumanLockEntry, AgentsMeta, LedgerEntry } from './types/index.js';
2
+ export { AgentsActivationTier, AgentsMetaNodeActivation, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, RuleDescription, RuleDescriptionIndexItem } from './types/index.js';
3
3
  export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, zhCNMessages } from './i18n/index.js';
4
4
  import { z } from 'zod';
5
5
 
6
6
  declare const AGENTS_META_LAYERS: readonly ["L0", "L1", "L2"];
7
- declare const AGENTS_META_TOPOLOGY_TYPES: readonly ["mirror", "cross-cutting"];
7
+ declare const AGENTS_META_TOPOLOGY_TYPES: readonly ["mirror", "cross-cutting", "domain", "local", "global"];
8
+ declare const AGENTS_META_IDENTITY_SOURCES: readonly ["declared", "derived"];
8
9
  declare const agentsLayerSchema: z.ZodEnum<["L0", "L1", "L2"]>;
9
- declare const agentsTopologyTypeSchema: z.ZodEnum<["mirror", "cross-cutting"]>;
10
+ declare const agentsTopologyTypeSchema: z.ZodEnum<["mirror", "cross-cutting", "domain", "local", "global"]>;
11
+ declare const agentsIdentitySourceSchema: z.ZodEnum<["declared", "derived"]>;
10
12
  type AgentsMetaNodeInput = Omit<AgentsMetaNode, "layer" | "topology_type"> & Partial<Pick<AgentsMetaNode, "layer" | "topology_type">>;
13
+ declare const ruleDescriptionSchema: z.ZodObject<{
14
+ summary: z.ZodString;
15
+ intent_clues: z.ZodArray<z.ZodString, "many">;
16
+ tech_stack: z.ZodArray<z.ZodString, "many">;
17
+ impact: z.ZodArray<z.ZodString, "many">;
18
+ must_read_if: z.ZodString;
19
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
20
+ }, "strict", z.ZodTypeAny, {
21
+ summary: string;
22
+ intent_clues: string[];
23
+ tech_stack: string[];
24
+ impact: string[];
25
+ must_read_if: string;
26
+ entities?: string[] | undefined;
27
+ }, {
28
+ summary: string;
29
+ intent_clues: string[];
30
+ tech_stack: string[];
31
+ impact: string[];
32
+ must_read_if: string;
33
+ entities?: string[] | undefined;
34
+ }>;
35
+ declare const ruleDescriptionIndexItemSchema: z.ZodObject<{
36
+ stable_id: z.ZodString;
37
+ level: z.ZodEnum<["L0", "L1", "L2"]>;
38
+ required: z.ZodBoolean;
39
+ selectable: z.ZodBoolean;
40
+ description: z.ZodObject<{
41
+ summary: z.ZodString;
42
+ intent_clues: z.ZodArray<z.ZodString, "many">;
43
+ tech_stack: z.ZodArray<z.ZodString, "many">;
44
+ impact: z.ZodArray<z.ZodString, "many">;
45
+ must_read_if: z.ZodString;
46
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
47
+ }, "strict", z.ZodTypeAny, {
48
+ summary: string;
49
+ intent_clues: string[];
50
+ tech_stack: string[];
51
+ impact: string[];
52
+ must_read_if: string;
53
+ entities?: string[] | undefined;
54
+ }, {
55
+ summary: string;
56
+ intent_clues: string[];
57
+ tech_stack: string[];
58
+ impact: string[];
59
+ must_read_if: string;
60
+ entities?: string[] | undefined;
61
+ }>;
62
+ }, "strict", z.ZodTypeAny, {
63
+ description: {
64
+ summary: string;
65
+ intent_clues: string[];
66
+ tech_stack: string[];
67
+ impact: string[];
68
+ must_read_if: string;
69
+ entities?: string[] | undefined;
70
+ };
71
+ level: "L0" | "L1" | "L2";
72
+ stable_id: string;
73
+ required: boolean;
74
+ selectable: boolean;
75
+ }, {
76
+ description: {
77
+ summary: string;
78
+ intent_clues: string[];
79
+ tech_stack: string[];
80
+ impact: string[];
81
+ must_read_if: string;
82
+ entities?: string[] | undefined;
83
+ };
84
+ level: "L0" | "L1" | "L2";
85
+ stable_id: string;
86
+ required: boolean;
87
+ selectable: boolean;
88
+ }>;
11
89
  declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
12
90
  file: z.ZodString;
91
+ content_ref: z.ZodOptional<z.ZodString>;
13
92
  scope_glob: z.ZodString;
14
93
  deps: z.ZodArray<z.ZodString, "many">;
15
94
  priority: z.ZodEnum<["high", "medium", "low"]>;
95
+ level: z.ZodOptional<z.ZodEnum<["L0", "L1", "L2"]>>;
16
96
  layer: z.ZodEnum<["L0", "L1", "L2"]>;
17
- topology_type: z.ZodEnum<["mirror", "cross-cutting"]>;
97
+ topology_type: z.ZodEnum<["mirror", "cross-cutting", "domain", "local", "global"]>;
18
98
  hash: z.ZodString;
99
+ stable_id: z.ZodOptional<z.ZodString>;
100
+ identity_source: z.ZodOptional<z.ZodEnum<["declared", "derived"]>>;
19
101
  activation: z.ZodOptional<z.ZodObject<{
20
102
  tier: z.ZodEnum<["always", "path", "description"]>;
21
103
  description: z.ZodOptional<z.ZodString>;
@@ -26,14 +108,48 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
26
108
  tier: "always" | "path" | "description";
27
109
  description?: string | undefined;
28
110
  }>>;
111
+ description: z.ZodOptional<z.ZodObject<{
112
+ summary: z.ZodString;
113
+ intent_clues: z.ZodArray<z.ZodString, "many">;
114
+ tech_stack: z.ZodArray<z.ZodString, "many">;
115
+ impact: z.ZodArray<z.ZodString, "many">;
116
+ must_read_if: z.ZodString;
117
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
118
+ }, "strict", z.ZodTypeAny, {
119
+ summary: string;
120
+ intent_clues: string[];
121
+ tech_stack: string[];
122
+ impact: string[];
123
+ must_read_if: string;
124
+ entities?: string[] | undefined;
125
+ }, {
126
+ summary: string;
127
+ intent_clues: string[];
128
+ tech_stack: string[];
129
+ impact: string[];
130
+ must_read_if: string;
131
+ entities?: string[] | undefined;
132
+ }>>;
29
133
  }, "strip", z.ZodTypeAny, {
30
134
  file: string;
31
135
  priority: "high" | "medium" | "low";
32
136
  hash: string;
33
137
  layer: "L0" | "L1" | "L2";
34
- topology_type: "mirror" | "cross-cutting";
138
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
35
139
  scope_glob: string;
36
140
  deps: string[];
141
+ description?: {
142
+ summary: string;
143
+ intent_clues: string[];
144
+ tech_stack: string[];
145
+ impact: string[];
146
+ must_read_if: string;
147
+ entities?: string[] | undefined;
148
+ } | undefined;
149
+ content_ref?: string | undefined;
150
+ level?: "L0" | "L1" | "L2" | undefined;
151
+ stable_id?: string | undefined;
152
+ identity_source?: "declared" | "derived" | undefined;
37
153
  activation?: {
38
154
  tier: "always" | "path" | "description";
39
155
  description?: string | undefined;
@@ -43,9 +159,21 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
43
159
  priority: "high" | "medium" | "low";
44
160
  hash: string;
45
161
  layer: "L0" | "L1" | "L2";
46
- topology_type: "mirror" | "cross-cutting";
162
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
47
163
  scope_glob: string;
48
164
  deps: string[];
165
+ description?: {
166
+ summary: string;
167
+ intent_clues: string[];
168
+ tech_stack: string[];
169
+ impact: string[];
170
+ must_read_if: string;
171
+ entities?: string[] | undefined;
172
+ } | undefined;
173
+ content_ref?: string | undefined;
174
+ level?: "L0" | "L1" | "L2" | undefined;
175
+ stable_id?: string | undefined;
176
+ identity_source?: "declared" | "derived" | undefined;
49
177
  activation?: {
50
178
  tier: "always" | "path" | "description";
51
179
  description?: string | undefined;
@@ -55,9 +183,21 @@ declare const agentsMetaNodeSchema: z.ZodEffects<z.ZodObject<{
55
183
  priority: "high" | "medium" | "low";
56
184
  hash: string;
57
185
  layer: "L0" | "L1" | "L2";
58
- topology_type: "mirror" | "cross-cutting";
186
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
59
187
  scope_glob: string;
60
188
  deps: string[];
189
+ description?: {
190
+ summary: string;
191
+ intent_clues: string[];
192
+ tech_stack: string[];
193
+ impact: string[];
194
+ must_read_if: string;
195
+ entities?: string[] | undefined;
196
+ } | undefined;
197
+ content_ref?: string | undefined;
198
+ level?: "L0" | "L1" | "L2" | undefined;
199
+ stable_id?: string | undefined;
200
+ identity_source?: "declared" | "derived" | undefined;
61
201
  activation?: {
62
202
  tier: "always" | "path" | "description";
63
203
  description?: string | undefined;
@@ -67,12 +207,16 @@ declare const agentsMetaSchema: z.ZodObject<{
67
207
  revision: z.ZodString;
68
208
  nodes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
69
209
  file: z.ZodString;
210
+ content_ref: z.ZodOptional<z.ZodString>;
70
211
  scope_glob: z.ZodString;
71
212
  deps: z.ZodArray<z.ZodString, "many">;
72
213
  priority: z.ZodEnum<["high", "medium", "low"]>;
214
+ level: z.ZodOptional<z.ZodEnum<["L0", "L1", "L2"]>>;
73
215
  layer: z.ZodEnum<["L0", "L1", "L2"]>;
74
- topology_type: z.ZodEnum<["mirror", "cross-cutting"]>;
216
+ topology_type: z.ZodEnum<["mirror", "cross-cutting", "domain", "local", "global"]>;
75
217
  hash: z.ZodString;
218
+ stable_id: z.ZodOptional<z.ZodString>;
219
+ identity_source: z.ZodOptional<z.ZodEnum<["declared", "derived"]>>;
76
220
  activation: z.ZodOptional<z.ZodObject<{
77
221
  tier: z.ZodEnum<["always", "path", "description"]>;
78
222
  description: z.ZodOptional<z.ZodString>;
@@ -83,14 +227,48 @@ declare const agentsMetaSchema: z.ZodObject<{
83
227
  tier: "always" | "path" | "description";
84
228
  description?: string | undefined;
85
229
  }>>;
230
+ description: z.ZodOptional<z.ZodObject<{
231
+ summary: z.ZodString;
232
+ intent_clues: z.ZodArray<z.ZodString, "many">;
233
+ tech_stack: z.ZodArray<z.ZodString, "many">;
234
+ impact: z.ZodArray<z.ZodString, "many">;
235
+ must_read_if: z.ZodString;
236
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
237
+ }, "strict", z.ZodTypeAny, {
238
+ summary: string;
239
+ intent_clues: string[];
240
+ tech_stack: string[];
241
+ impact: string[];
242
+ must_read_if: string;
243
+ entities?: string[] | undefined;
244
+ }, {
245
+ summary: string;
246
+ intent_clues: string[];
247
+ tech_stack: string[];
248
+ impact: string[];
249
+ must_read_if: string;
250
+ entities?: string[] | undefined;
251
+ }>>;
86
252
  }, "strip", z.ZodTypeAny, {
87
253
  file: string;
88
254
  priority: "high" | "medium" | "low";
89
255
  hash: string;
90
256
  layer: "L0" | "L1" | "L2";
91
- topology_type: "mirror" | "cross-cutting";
257
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
92
258
  scope_glob: string;
93
259
  deps: string[];
260
+ description?: {
261
+ summary: string;
262
+ intent_clues: string[];
263
+ tech_stack: string[];
264
+ impact: string[];
265
+ must_read_if: string;
266
+ entities?: string[] | undefined;
267
+ } | undefined;
268
+ content_ref?: string | undefined;
269
+ level?: "L0" | "L1" | "L2" | undefined;
270
+ stable_id?: string | undefined;
271
+ identity_source?: "declared" | "derived" | undefined;
94
272
  activation?: {
95
273
  tier: "always" | "path" | "description";
96
274
  description?: string | undefined;
@@ -100,9 +278,21 @@ declare const agentsMetaSchema: z.ZodObject<{
100
278
  priority: "high" | "medium" | "low";
101
279
  hash: string;
102
280
  layer: "L0" | "L1" | "L2";
103
- topology_type: "mirror" | "cross-cutting";
281
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
104
282
  scope_glob: string;
105
283
  deps: string[];
284
+ description?: {
285
+ summary: string;
286
+ intent_clues: string[];
287
+ tech_stack: string[];
288
+ impact: string[];
289
+ must_read_if: string;
290
+ entities?: string[] | undefined;
291
+ } | undefined;
292
+ content_ref?: string | undefined;
293
+ level?: "L0" | "L1" | "L2" | undefined;
294
+ stable_id?: string | undefined;
295
+ identity_source?: "declared" | "derived" | undefined;
106
296
  activation?: {
107
297
  tier: "always" | "path" | "description";
108
298
  description?: string | undefined;
@@ -112,9 +302,21 @@ declare const agentsMetaSchema: z.ZodObject<{
112
302
  priority: "high" | "medium" | "low";
113
303
  hash: string;
114
304
  layer: "L0" | "L1" | "L2";
115
- topology_type: "mirror" | "cross-cutting";
305
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
116
306
  scope_glob: string;
117
307
  deps: string[];
308
+ description?: {
309
+ summary: string;
310
+ intent_clues: string[];
311
+ tech_stack: string[];
312
+ impact: string[];
313
+ must_read_if: string;
314
+ entities?: string[] | undefined;
315
+ } | undefined;
316
+ content_ref?: string | undefined;
317
+ level?: "L0" | "L1" | "L2" | undefined;
318
+ stable_id?: string | undefined;
319
+ identity_source?: "declared" | "derived" | undefined;
118
320
  activation?: {
119
321
  tier: "always" | "path" | "description";
120
322
  description?: string | undefined;
@@ -127,9 +329,21 @@ declare const agentsMetaSchema: z.ZodObject<{
127
329
  priority: "high" | "medium" | "low";
128
330
  hash: string;
129
331
  layer: "L0" | "L1" | "L2";
130
- topology_type: "mirror" | "cross-cutting";
332
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
131
333
  scope_glob: string;
132
334
  deps: string[];
335
+ description?: {
336
+ summary: string;
337
+ intent_clues: string[];
338
+ tech_stack: string[];
339
+ impact: string[];
340
+ must_read_if: string;
341
+ entities?: string[] | undefined;
342
+ } | undefined;
343
+ content_ref?: string | undefined;
344
+ level?: "L0" | "L1" | "L2" | undefined;
345
+ stable_id?: string | undefined;
346
+ identity_source?: "declared" | "derived" | undefined;
133
347
  activation?: {
134
348
  tier: "always" | "path" | "description";
135
349
  description?: string | undefined;
@@ -140,6 +354,8 @@ declare const agentsMetaSchema: z.ZodObject<{
140
354
  nodes: Record<string, unknown>;
141
355
  }>;
142
356
  declare function withDerivedAgentsMetaNodeDefaults(node: AgentsMetaNodeInput): AgentsMetaNode;
357
+ declare function deriveAgentsMetaStableId(file: string): string;
358
+ declare function deriveAgentsMetaIdentitySource(node: Pick<AgentsMetaNode, "file"> & Partial<Pick<AgentsMetaNode, "stable_id" | "identity_source">>): AgentsIdentitySource;
143
359
  declare function deriveAgentsMetaLayer(file: string): AgentsLayer;
144
360
  declare function deriveAgentsMetaTopologyType(file: string): AgentsTopologyType;
145
361
 
@@ -623,7 +839,7 @@ declare const forensicAssertionSchema: z.ZodObject<{
623
839
  proposed_rule: z.ZodOptional<z.ZodString>;
624
840
  alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
625
841
  }, "strip", z.ZodTypeAny, {
626
- type: "framework" | "pattern" | "invariant" | "domain";
842
+ type: "domain" | "framework" | "pattern" | "invariant";
627
843
  statement: string;
628
844
  confidence: "HIGH" | "MEDIUM" | "LOW";
629
845
  evidence: {
@@ -640,7 +856,7 @@ declare const forensicAssertionSchema: z.ZodObject<{
640
856
  proposed_rule?: string | undefined;
641
857
  alternatives?: string[] | undefined;
642
858
  }, {
643
- type: "framework" | "pattern" | "invariant" | "domain";
859
+ type: "domain" | "framework" | "pattern" | "invariant";
644
860
  statement: string;
645
861
  confidence: "HIGH" | "MEDIUM" | "LOW";
646
862
  evidence: {
@@ -841,7 +1057,7 @@ declare const forensicReportSchema: z.ZodObject<{
841
1057
  proposed_rule: z.ZodOptional<z.ZodString>;
842
1058
  alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
843
1059
  }, "strip", z.ZodTypeAny, {
844
- type: "framework" | "pattern" | "invariant" | "domain";
1060
+ type: "domain" | "framework" | "pattern" | "invariant";
845
1061
  statement: string;
846
1062
  confidence: "HIGH" | "MEDIUM" | "LOW";
847
1063
  evidence: {
@@ -858,7 +1074,7 @@ declare const forensicReportSchema: z.ZodObject<{
858
1074
  proposed_rule?: string | undefined;
859
1075
  alternatives?: string[] | undefined;
860
1076
  }, {
861
- type: "framework" | "pattern" | "invariant" | "domain";
1077
+ type: "domain" | "framework" | "pattern" | "invariant";
862
1078
  statement: string;
863
1079
  confidence: "HIGH" | "MEDIUM" | "LOW";
864
1080
  evidence: {
@@ -942,7 +1158,7 @@ declare const forensicReportSchema: z.ZodObject<{
942
1158
  pattern_hint: string;
943
1159
  }[];
944
1160
  assertions: {
945
- type: "framework" | "pattern" | "invariant" | "domain";
1161
+ type: "domain" | "framework" | "pattern" | "invariant";
946
1162
  statement: string;
947
1163
  confidence: "HIGH" | "MEDIUM" | "LOW";
948
1164
  evidence: {
@@ -1004,7 +1220,7 @@ declare const forensicReportSchema: z.ZodObject<{
1004
1220
  pattern_hint: string;
1005
1221
  }[];
1006
1222
  assertions: {
1007
- type: "framework" | "pattern" | "invariant" | "domain";
1223
+ type: "domain" | "framework" | "pattern" | "invariant";
1008
1224
  statement: string;
1009
1225
  confidence: "HIGH" | "MEDIUM" | "LOW";
1010
1226
  evidence: {
@@ -1408,12 +1624,16 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1408
1624
  revision: z.ZodString;
1409
1625
  nodes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
1410
1626
  file: z.ZodString;
1627
+ content_ref: z.ZodOptional<z.ZodString>;
1411
1628
  scope_glob: z.ZodString;
1412
1629
  deps: z.ZodArray<z.ZodString, "many">;
1413
1630
  priority: z.ZodEnum<["high", "medium", "low"]>;
1631
+ level: z.ZodOptional<z.ZodEnum<["L0", "L1", "L2"]>>;
1414
1632
  layer: z.ZodEnum<["L0", "L1", "L2"]>;
1415
- topology_type: z.ZodEnum<["mirror", "cross-cutting"]>;
1633
+ topology_type: z.ZodEnum<["mirror", "cross-cutting", "domain", "local", "global"]>;
1416
1634
  hash: z.ZodString;
1635
+ stable_id: z.ZodOptional<z.ZodString>;
1636
+ identity_source: z.ZodOptional<z.ZodEnum<["declared", "derived"]>>;
1417
1637
  activation: z.ZodOptional<z.ZodObject<{
1418
1638
  tier: z.ZodEnum<["always", "path", "description"]>;
1419
1639
  description: z.ZodOptional<z.ZodString>;
@@ -1424,14 +1644,48 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1424
1644
  tier: "always" | "path" | "description";
1425
1645
  description?: string | undefined;
1426
1646
  }>>;
1647
+ description: z.ZodOptional<z.ZodObject<{
1648
+ summary: z.ZodString;
1649
+ intent_clues: z.ZodArray<z.ZodString, "many">;
1650
+ tech_stack: z.ZodArray<z.ZodString, "many">;
1651
+ impact: z.ZodArray<z.ZodString, "many">;
1652
+ must_read_if: z.ZodString;
1653
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1654
+ }, "strict", z.ZodTypeAny, {
1655
+ summary: string;
1656
+ intent_clues: string[];
1657
+ tech_stack: string[];
1658
+ impact: string[];
1659
+ must_read_if: string;
1660
+ entities?: string[] | undefined;
1661
+ }, {
1662
+ summary: string;
1663
+ intent_clues: string[];
1664
+ tech_stack: string[];
1665
+ impact: string[];
1666
+ must_read_if: string;
1667
+ entities?: string[] | undefined;
1668
+ }>>;
1427
1669
  }, "strip", z.ZodTypeAny, {
1428
1670
  file: string;
1429
1671
  priority: "high" | "medium" | "low";
1430
1672
  hash: string;
1431
1673
  layer: "L0" | "L1" | "L2";
1432
- topology_type: "mirror" | "cross-cutting";
1674
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
1433
1675
  scope_glob: string;
1434
1676
  deps: string[];
1677
+ description?: {
1678
+ summary: string;
1679
+ intent_clues: string[];
1680
+ tech_stack: string[];
1681
+ impact: string[];
1682
+ must_read_if: string;
1683
+ entities?: string[] | undefined;
1684
+ } | undefined;
1685
+ content_ref?: string | undefined;
1686
+ level?: "L0" | "L1" | "L2" | undefined;
1687
+ stable_id?: string | undefined;
1688
+ identity_source?: "declared" | "derived" | undefined;
1435
1689
  activation?: {
1436
1690
  tier: "always" | "path" | "description";
1437
1691
  description?: string | undefined;
@@ -1441,9 +1695,21 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1441
1695
  priority: "high" | "medium" | "low";
1442
1696
  hash: string;
1443
1697
  layer: "L0" | "L1" | "L2";
1444
- topology_type: "mirror" | "cross-cutting";
1698
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
1445
1699
  scope_glob: string;
1446
1700
  deps: string[];
1701
+ description?: {
1702
+ summary: string;
1703
+ intent_clues: string[];
1704
+ tech_stack: string[];
1705
+ impact: string[];
1706
+ must_read_if: string;
1707
+ entities?: string[] | undefined;
1708
+ } | undefined;
1709
+ content_ref?: string | undefined;
1710
+ level?: "L0" | "L1" | "L2" | undefined;
1711
+ stable_id?: string | undefined;
1712
+ identity_source?: "declared" | "derived" | undefined;
1447
1713
  activation?: {
1448
1714
  tier: "always" | "path" | "description";
1449
1715
  description?: string | undefined;
@@ -1453,9 +1719,21 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1453
1719
  priority: "high" | "medium" | "low";
1454
1720
  hash: string;
1455
1721
  layer: "L0" | "L1" | "L2";
1456
- topology_type: "mirror" | "cross-cutting";
1722
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
1457
1723
  scope_glob: string;
1458
1724
  deps: string[];
1725
+ description?: {
1726
+ summary: string;
1727
+ intent_clues: string[];
1728
+ tech_stack: string[];
1729
+ impact: string[];
1730
+ must_read_if: string;
1731
+ entities?: string[] | undefined;
1732
+ } | undefined;
1733
+ content_ref?: string | undefined;
1734
+ level?: "L0" | "L1" | "L2" | undefined;
1735
+ stable_id?: string | undefined;
1736
+ identity_source?: "declared" | "derived" | undefined;
1459
1737
  activation?: {
1460
1738
  tier: "always" | "path" | "description";
1461
1739
  description?: string | undefined;
@@ -1468,9 +1746,21 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1468
1746
  priority: "high" | "medium" | "low";
1469
1747
  hash: string;
1470
1748
  layer: "L0" | "L1" | "L2";
1471
- topology_type: "mirror" | "cross-cutting";
1749
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
1472
1750
  scope_glob: string;
1473
1751
  deps: string[];
1752
+ description?: {
1753
+ summary: string;
1754
+ intent_clues: string[];
1755
+ tech_stack: string[];
1756
+ impact: string[];
1757
+ must_read_if: string;
1758
+ entities?: string[] | undefined;
1759
+ } | undefined;
1760
+ content_ref?: string | undefined;
1761
+ level?: "L0" | "L1" | "L2" | undefined;
1762
+ stable_id?: string | undefined;
1763
+ identity_source?: "declared" | "derived" | undefined;
1474
1764
  activation?: {
1475
1765
  tier: "always" | "path" | "description";
1476
1766
  description?: string | undefined;
@@ -1489,9 +1779,21 @@ declare const metaUpdatedEventSchema: z.ZodObject<{
1489
1779
  priority: "high" | "medium" | "low";
1490
1780
  hash: string;
1491
1781
  layer: "L0" | "L1" | "L2";
1492
- topology_type: "mirror" | "cross-cutting";
1782
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
1493
1783
  scope_glob: string;
1494
1784
  deps: string[];
1785
+ description?: {
1786
+ summary: string;
1787
+ intent_clues: string[];
1788
+ tech_stack: string[];
1789
+ impact: string[];
1790
+ must_read_if: string;
1791
+ entities?: string[] | undefined;
1792
+ } | undefined;
1793
+ content_ref?: string | undefined;
1794
+ level?: "L0" | "L1" | "L2" | undefined;
1795
+ stable_id?: string | undefined;
1796
+ identity_source?: "declared" | "derived" | undefined;
1495
1797
  activation?: {
1496
1798
  tier: "always" | "path" | "description";
1497
1799
  description?: string | undefined;
@@ -1895,7 +2197,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
1895
2197
  proposed_rule: z.ZodOptional<z.ZodString>;
1896
2198
  alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1897
2199
  }, "strip", z.ZodTypeAny, {
1898
- type: "framework" | "pattern" | "invariant" | "domain";
2200
+ type: "domain" | "framework" | "pattern" | "invariant";
1899
2201
  statement: string;
1900
2202
  confidence: "HIGH" | "MEDIUM" | "LOW";
1901
2203
  evidence: {
@@ -1912,7 +2214,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
1912
2214
  proposed_rule?: string | undefined;
1913
2215
  alternatives?: string[] | undefined;
1914
2216
  }, {
1915
- type: "framework" | "pattern" | "invariant" | "domain";
2217
+ type: "domain" | "framework" | "pattern" | "invariant";
1916
2218
  statement: string;
1917
2219
  confidence: "HIGH" | "MEDIUM" | "LOW";
1918
2220
  evidence: {
@@ -1996,7 +2298,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
1996
2298
  pattern_hint: string;
1997
2299
  }[];
1998
2300
  assertions: {
1999
- type: "framework" | "pattern" | "invariant" | "domain";
2301
+ type: "domain" | "framework" | "pattern" | "invariant";
2000
2302
  statement: string;
2001
2303
  confidence: "HIGH" | "MEDIUM" | "LOW";
2002
2304
  evidence: {
@@ -2058,7 +2360,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
2058
2360
  pattern_hint: string;
2059
2361
  }[];
2060
2362
  assertions: {
2061
- type: "framework" | "pattern" | "invariant" | "domain";
2363
+ type: "domain" | "framework" | "pattern" | "invariant";
2062
2364
  statement: string;
2063
2365
  confidence: "HIGH" | "MEDIUM" | "LOW";
2064
2366
  evidence: {
@@ -2123,7 +2425,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
2123
2425
  pattern_hint: string;
2124
2426
  }[];
2125
2427
  assertions: {
2126
- type: "framework" | "pattern" | "invariant" | "domain";
2428
+ type: "domain" | "framework" | "pattern" | "invariant";
2127
2429
  statement: string;
2128
2430
  confidence: "HIGH" | "MEDIUM" | "LOW";
2129
2431
  evidence: {
@@ -2188,7 +2490,7 @@ declare const driftDetectedEventSchema: z.ZodObject<{
2188
2490
  pattern_hint: string;
2189
2491
  }[];
2190
2492
  assertions: {
2191
- type: "framework" | "pattern" | "invariant" | "domain";
2493
+ type: "domain" | "framework" | "pattern" | "invariant";
2192
2494
  statement: string;
2193
2495
  confidence: "HIGH" | "MEDIUM" | "LOW";
2194
2496
  evidence: {
@@ -2228,12 +2530,16 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2228
2530
  revision: z.ZodString;
2229
2531
  nodes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
2230
2532
  file: z.ZodString;
2533
+ content_ref: z.ZodOptional<z.ZodString>;
2231
2534
  scope_glob: z.ZodString;
2232
2535
  deps: z.ZodArray<z.ZodString, "many">;
2233
2536
  priority: z.ZodEnum<["high", "medium", "low"]>;
2537
+ level: z.ZodOptional<z.ZodEnum<["L0", "L1", "L2"]>>;
2234
2538
  layer: z.ZodEnum<["L0", "L1", "L2"]>;
2235
- topology_type: z.ZodEnum<["mirror", "cross-cutting"]>;
2539
+ topology_type: z.ZodEnum<["mirror", "cross-cutting", "domain", "local", "global"]>;
2236
2540
  hash: z.ZodString;
2541
+ stable_id: z.ZodOptional<z.ZodString>;
2542
+ identity_source: z.ZodOptional<z.ZodEnum<["declared", "derived"]>>;
2237
2543
  activation: z.ZodOptional<z.ZodObject<{
2238
2544
  tier: z.ZodEnum<["always", "path", "description"]>;
2239
2545
  description: z.ZodOptional<z.ZodString>;
@@ -2244,14 +2550,48 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2244
2550
  tier: "always" | "path" | "description";
2245
2551
  description?: string | undefined;
2246
2552
  }>>;
2553
+ description: z.ZodOptional<z.ZodObject<{
2554
+ summary: z.ZodString;
2555
+ intent_clues: z.ZodArray<z.ZodString, "many">;
2556
+ tech_stack: z.ZodArray<z.ZodString, "many">;
2557
+ impact: z.ZodArray<z.ZodString, "many">;
2558
+ must_read_if: z.ZodString;
2559
+ entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2560
+ }, "strict", z.ZodTypeAny, {
2561
+ summary: string;
2562
+ intent_clues: string[];
2563
+ tech_stack: string[];
2564
+ impact: string[];
2565
+ must_read_if: string;
2566
+ entities?: string[] | undefined;
2567
+ }, {
2568
+ summary: string;
2569
+ intent_clues: string[];
2570
+ tech_stack: string[];
2571
+ impact: string[];
2572
+ must_read_if: string;
2573
+ entities?: string[] | undefined;
2574
+ }>>;
2247
2575
  }, "strip", z.ZodTypeAny, {
2248
2576
  file: string;
2249
2577
  priority: "high" | "medium" | "low";
2250
2578
  hash: string;
2251
2579
  layer: "L0" | "L1" | "L2";
2252
- topology_type: "mirror" | "cross-cutting";
2580
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
2253
2581
  scope_glob: string;
2254
2582
  deps: string[];
2583
+ description?: {
2584
+ summary: string;
2585
+ intent_clues: string[];
2586
+ tech_stack: string[];
2587
+ impact: string[];
2588
+ must_read_if: string;
2589
+ entities?: string[] | undefined;
2590
+ } | undefined;
2591
+ content_ref?: string | undefined;
2592
+ level?: "L0" | "L1" | "L2" | undefined;
2593
+ stable_id?: string | undefined;
2594
+ identity_source?: "declared" | "derived" | undefined;
2255
2595
  activation?: {
2256
2596
  tier: "always" | "path" | "description";
2257
2597
  description?: string | undefined;
@@ -2261,9 +2601,21 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2261
2601
  priority: "high" | "medium" | "low";
2262
2602
  hash: string;
2263
2603
  layer: "L0" | "L1" | "L2";
2264
- topology_type: "mirror" | "cross-cutting";
2604
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
2265
2605
  scope_glob: string;
2266
2606
  deps: string[];
2607
+ description?: {
2608
+ summary: string;
2609
+ intent_clues: string[];
2610
+ tech_stack: string[];
2611
+ impact: string[];
2612
+ must_read_if: string;
2613
+ entities?: string[] | undefined;
2614
+ } | undefined;
2615
+ content_ref?: string | undefined;
2616
+ level?: "L0" | "L1" | "L2" | undefined;
2617
+ stable_id?: string | undefined;
2618
+ identity_source?: "declared" | "derived" | undefined;
2267
2619
  activation?: {
2268
2620
  tier: "always" | "path" | "description";
2269
2621
  description?: string | undefined;
@@ -2273,9 +2625,21 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2273
2625
  priority: "high" | "medium" | "low";
2274
2626
  hash: string;
2275
2627
  layer: "L0" | "L1" | "L2";
2276
- topology_type: "mirror" | "cross-cutting";
2628
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
2277
2629
  scope_glob: string;
2278
2630
  deps: string[];
2631
+ description?: {
2632
+ summary: string;
2633
+ intent_clues: string[];
2634
+ tech_stack: string[];
2635
+ impact: string[];
2636
+ must_read_if: string;
2637
+ entities?: string[] | undefined;
2638
+ } | undefined;
2639
+ content_ref?: string | undefined;
2640
+ level?: "L0" | "L1" | "L2" | undefined;
2641
+ stable_id?: string | undefined;
2642
+ identity_source?: "declared" | "derived" | undefined;
2279
2643
  activation?: {
2280
2644
  tier: "always" | "path" | "description";
2281
2645
  description?: string | undefined;
@@ -2288,9 +2652,21 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2288
2652
  priority: "high" | "medium" | "low";
2289
2653
  hash: string;
2290
2654
  layer: "L0" | "L1" | "L2";
2291
- topology_type: "mirror" | "cross-cutting";
2655
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
2292
2656
  scope_glob: string;
2293
2657
  deps: string[];
2658
+ description?: {
2659
+ summary: string;
2660
+ intent_clues: string[];
2661
+ tech_stack: string[];
2662
+ impact: string[];
2663
+ must_read_if: string;
2664
+ entities?: string[] | undefined;
2665
+ } | undefined;
2666
+ content_ref?: string | undefined;
2667
+ level?: "L0" | "L1" | "L2" | undefined;
2668
+ stable_id?: string | undefined;
2669
+ identity_source?: "declared" | "derived" | undefined;
2294
2670
  activation?: {
2295
2671
  tier: "always" | "path" | "description";
2296
2672
  description?: string | undefined;
@@ -2309,9 +2685,21 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2309
2685
  priority: "high" | "medium" | "low";
2310
2686
  hash: string;
2311
2687
  layer: "L0" | "L1" | "L2";
2312
- topology_type: "mirror" | "cross-cutting";
2688
+ topology_type: "mirror" | "cross-cutting" | "domain" | "local" | "global";
2313
2689
  scope_glob: string;
2314
2690
  deps: string[];
2691
+ description?: {
2692
+ summary: string;
2693
+ intent_clues: string[];
2694
+ tech_stack: string[];
2695
+ impact: string[];
2696
+ must_read_if: string;
2697
+ entities?: string[] | undefined;
2698
+ } | undefined;
2699
+ content_ref?: string | undefined;
2700
+ level?: "L0" | "L1" | "L2" | undefined;
2701
+ stable_id?: string | undefined;
2702
+ identity_source?: "declared" | "derived" | undefined;
2315
2703
  activation?: {
2316
2704
  tier: "always" | "path" | "description";
2317
2705
  description?: string | undefined;
@@ -2711,7 +3099,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2711
3099
  proposed_rule: z.ZodOptional<z.ZodString>;
2712
3100
  alternatives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2713
3101
  }, "strip", z.ZodTypeAny, {
2714
- type: "framework" | "pattern" | "invariant" | "domain";
3102
+ type: "domain" | "framework" | "pattern" | "invariant";
2715
3103
  statement: string;
2716
3104
  confidence: "HIGH" | "MEDIUM" | "LOW";
2717
3105
  evidence: {
@@ -2728,7 +3116,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2728
3116
  proposed_rule?: string | undefined;
2729
3117
  alternatives?: string[] | undefined;
2730
3118
  }, {
2731
- type: "framework" | "pattern" | "invariant" | "domain";
3119
+ type: "domain" | "framework" | "pattern" | "invariant";
2732
3120
  statement: string;
2733
3121
  confidence: "HIGH" | "MEDIUM" | "LOW";
2734
3122
  evidence: {
@@ -2812,7 +3200,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2812
3200
  pattern_hint: string;
2813
3201
  }[];
2814
3202
  assertions: {
2815
- type: "framework" | "pattern" | "invariant" | "domain";
3203
+ type: "domain" | "framework" | "pattern" | "invariant";
2816
3204
  statement: string;
2817
3205
  confidence: "HIGH" | "MEDIUM" | "LOW";
2818
3206
  evidence: {
@@ -2874,7 +3262,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2874
3262
  pattern_hint: string;
2875
3263
  }[];
2876
3264
  assertions: {
2877
- type: "framework" | "pattern" | "invariant" | "domain";
3265
+ type: "domain" | "framework" | "pattern" | "invariant";
2878
3266
  statement: string;
2879
3267
  confidence: "HIGH" | "MEDIUM" | "LOW";
2880
3268
  evidence: {
@@ -2939,7 +3327,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
2939
3327
  pattern_hint: string;
2940
3328
  }[];
2941
3329
  assertions: {
2942
- type: "framework" | "pattern" | "invariant" | "domain";
3330
+ type: "domain" | "framework" | "pattern" | "invariant";
2943
3331
  statement: string;
2944
3332
  confidence: "HIGH" | "MEDIUM" | "LOW";
2945
3333
  evidence: {
@@ -3004,7 +3392,7 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3004
3392
  pattern_hint: string;
3005
3393
  }[];
3006
3394
  assertions: {
3007
- type: "framework" | "pattern" | "invariant" | "domain";
3395
+ type: "domain" | "framework" | "pattern" | "invariant";
3008
3396
  statement: string;
3009
3397
  confidence: "HIGH" | "MEDIUM" | "LOW";
3010
3398
  evidence: {
@@ -3039,4 +3427,4 @@ declare const fabricEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
3039
3427
  };
3040
3428
  }>]>;
3041
3429
 
3042
- export { AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsTopologyType, type CandidateFileEntry, type CandidateFileFamily, type DriftDetectedEvent, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type MetaUpdatedEvent, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, annotateIntentRequestSchema, auditModeSchema, candidateFileEntrySchema, clientPathsSchema, deriveAgentsMetaLayer, deriveAgentsMetaTopologyType, driftDetectedEventSchema, fabricConfigSchema, fabricEventSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, historyStateQuerySchema, humanLedgerEntrySchema, humanLockApproveRequestSchema, humanLockEntrySchema, humanLockFileParamsSchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, ledgerAppendedEventSchema, ledgerEntrySchema, ledgerQuerySchema, ledgerSourceSchema, lockApprovedEventSchema, lockDriftEventSchema, metaUpdatedEventSchema, withDerivedAgentsMetaNodeDefaults };
3430
+ export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsTopologyType, type CandidateFileEntry, type CandidateFileFamily, type DriftDetectedEvent, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type MetaUpdatedEvent, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, annotateIntentRequestSchema, auditModeSchema, candidateFileEntrySchema, clientPathsSchema, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, driftDetectedEventSchema, fabricConfigSchema, fabricEventSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, historyStateQuerySchema, humanLedgerEntrySchema, humanLockApproveRequestSchema, humanLockEntrySchema, humanLockFileParamsSchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, ledgerAppendedEventSchema, ledgerEntrySchema, ledgerQuerySchema, ledgerSourceSchema, lockApprovedEventSchema, lockDriftEventSchema, metaUpdatedEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, withDerivedAgentsMetaNodeDefaults };
package/dist/index.js CHANGED
@@ -6,28 +6,50 @@ import {
6
6
  enMessages,
7
7
  normalizeLocale,
8
8
  zhCNMessages
9
- } from "./chunk-XEVK2HU2.js";
9
+ } from "./chunk-KNZIX6IL.js";
10
10
  import "./chunk-LXNCAKJZ.js";
11
11
 
12
12
  // src/schemas/agents-meta.ts
13
13
  import { z } from "zod";
14
14
  var FABRIC_AGENTS_PREFIX = ".fabric/agents/";
15
15
  var AGENTS_META_LAYERS = ["L0", "L1", "L2"];
16
- var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting"];
16
+ var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting", "domain", "local", "global"];
17
+ var AGENTS_META_IDENTITY_SOURCES = ["declared", "derived"];
17
18
  var agentsLayerSchema = z.enum(AGENTS_META_LAYERS);
18
19
  var agentsTopologyTypeSchema = z.enum(AGENTS_META_TOPOLOGY_TYPES);
20
+ var agentsIdentitySourceSchema = z.enum(AGENTS_META_IDENTITY_SOURCES);
21
+ var ruleDescriptionSchema = z.object({
22
+ summary: z.string(),
23
+ intent_clues: z.array(z.string()),
24
+ tech_stack: z.array(z.string()),
25
+ impact: z.array(z.string()),
26
+ must_read_if: z.string(),
27
+ entities: z.array(z.string()).optional()
28
+ }).strict();
29
+ var ruleDescriptionIndexItemSchema = z.object({
30
+ stable_id: z.string(),
31
+ level: agentsLayerSchema,
32
+ required: z.boolean(),
33
+ selectable: z.boolean(),
34
+ description: ruleDescriptionSchema
35
+ }).strict();
19
36
  var agentsMetaNodeBaseSchema = z.object({
20
37
  file: z.string(),
38
+ content_ref: z.string().optional(),
21
39
  scope_glob: z.string(),
22
40
  deps: z.array(z.string()),
23
41
  priority: z.enum(["high", "medium", "low"]),
42
+ level: agentsLayerSchema.optional(),
24
43
  layer: agentsLayerSchema,
25
44
  topology_type: agentsTopologyTypeSchema,
26
45
  hash: z.string(),
46
+ stable_id: z.string().optional(),
47
+ identity_source: agentsIdentitySourceSchema.optional(),
27
48
  activation: z.object({
28
49
  tier: z.enum(["always", "path", "description"]),
29
50
  description: z.string().optional()
30
- }).optional()
51
+ }).optional(),
52
+ description: ruleDescriptionSchema.optional()
31
53
  });
32
54
  var agentsMetaNodeSchema = z.preprocess((value) => {
33
55
  if (!isRecord(value) || typeof value.file !== "string") {
@@ -40,12 +62,31 @@ var agentsMetaSchema = z.object({
40
62
  nodes: z.record(agentsMetaNodeSchema)
41
63
  });
42
64
  function withDerivedAgentsMetaNodeDefaults(node) {
65
+ const stableId = node.stable_id ?? deriveAgentsMetaStableId(node.file);
66
+ const identitySource = deriveAgentsMetaIdentitySource(node);
43
67
  return {
44
68
  ...node,
45
- layer: node.layer ?? deriveAgentsMetaLayer(node.file),
46
- topology_type: node.topology_type ?? deriveAgentsMetaTopologyType(node.file)
69
+ layer: node.layer ?? node.level ?? deriveAgentsMetaLayer(node.file),
70
+ level: node.level ?? node.layer ?? deriveAgentsMetaLayer(node.file),
71
+ topology_type: node.topology_type ?? deriveAgentsMetaTopologyType(node.file),
72
+ stable_id: stableId,
73
+ identity_source: identitySource
47
74
  };
48
75
  }
76
+ function deriveAgentsMetaStableId(file) {
77
+ const normalized = normalizePath(file);
78
+ if (normalized === "AGENTS.md" || normalized === ".fabric/bootstrap/README.md") {
79
+ return "bootstrap";
80
+ }
81
+ return getDepthSource(normalized).replace(/\.md$/u, "");
82
+ }
83
+ function deriveAgentsMetaIdentitySource(node) {
84
+ if (node.identity_source !== void 0) {
85
+ return node.identity_source;
86
+ }
87
+ const derivedStableId = deriveAgentsMetaStableId(node.file);
88
+ return node.stable_id !== void 0 && node.stable_id !== derivedStableId ? "declared" : "derived";
89
+ }
49
90
  function deriveAgentsMetaLayer(file) {
50
91
  const normalized = normalizePath(file);
51
92
  if (normalized === "AGENTS.md" || normalized === ".fabric/bootstrap/README.md") {
@@ -359,9 +400,11 @@ var fabricEventSchema = z8.discriminatedUnion("type", [
359
400
  driftDetectedEventSchema
360
401
  ]);
361
402
  export {
403
+ AGENTS_META_IDENTITY_SOURCES,
362
404
  AGENTS_META_LAYERS,
363
405
  AGENTS_META_TOPOLOGY_TYPES,
364
406
  PROTECTED_TOKENS,
407
+ agentsIdentitySourceSchema,
365
408
  agentsLayerSchema,
366
409
  agentsMetaNodeSchema,
367
410
  agentsMetaSchema,
@@ -373,7 +416,9 @@ export {
373
416
  clientPathsSchema,
374
417
  createTranslator,
375
418
  defaultMessages,
419
+ deriveAgentsMetaIdentitySource,
376
420
  deriveAgentsMetaLayer,
421
+ deriveAgentsMetaStableId,
377
422
  deriveAgentsMetaTopologyType,
378
423
  detectNodeLocale,
379
424
  driftDetectedEventSchema,
@@ -411,6 +456,8 @@ export {
411
456
  lockDriftEventSchema,
412
457
  metaUpdatedEventSchema,
413
458
  normalizeLocale,
459
+ ruleDescriptionIndexItemSchema,
460
+ ruleDescriptionSchema,
414
461
  withDerivedAgentsMetaNodeDefaults,
415
462
  zhCNMessages
416
463
  };
@@ -1,19 +1,40 @@
1
1
  type AgentsLayer = "L0" | "L1" | "L2";
2
- type AgentsTopologyType = "mirror" | "cross-cutting";
2
+ type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
3
3
  type AgentsActivationTier = "always" | "path" | "description";
4
+ type AgentsIdentitySource = "declared" | "derived";
5
+ interface RuleDescription {
6
+ summary: string;
7
+ intent_clues: string[];
8
+ tech_stack: string[];
9
+ impact: string[];
10
+ must_read_if: string;
11
+ entities?: string[];
12
+ }
13
+ interface RuleDescriptionIndexItem {
14
+ stable_id: string;
15
+ level: AgentsLayer;
16
+ required: boolean;
17
+ selectable: boolean;
18
+ description: RuleDescription;
19
+ }
4
20
  interface AgentsMetaNodeActivation {
5
21
  tier: AgentsActivationTier;
6
22
  description?: string;
7
23
  }
8
24
  interface AgentsMetaNode {
9
25
  file: string;
26
+ content_ref?: string;
10
27
  scope_glob: string;
11
28
  deps: string[];
12
29
  priority: "high" | "medium" | "low";
30
+ level?: AgentsLayer;
13
31
  layer: AgentsLayer;
14
32
  topology_type: AgentsTopologyType;
15
33
  hash: string;
34
+ stable_id?: string;
35
+ identity_source?: AgentsIdentitySource;
16
36
  activation?: AgentsMetaNodeActivation;
37
+ description?: RuleDescription;
17
38
  }
18
39
  interface AgentsMeta {
19
40
  revision: string;
@@ -65,4 +86,4 @@ interface FabricConfig {
65
86
  audit_mode?: AuditMode;
66
87
  }
67
88
 
68
- export type { AgentsActivationTier, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry };
89
+ export type { AgentsActivationTier, AgentsIdentitySource, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry, RuleDescription, RuleDescriptionIndexItem };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fenglimg/fabric-shared",
3
- "version": "1.5.1",
3
+ "version": "1.6.0",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",