@fenglimg/fabric-shared 1.5.0 → 1.6.0

package/dist/index.js

@@ -6,28 +6,50 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-3W2DKFJZ.js";
+} from "./chunk-KNZIX6IL.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
 var FABRIC_AGENTS_PREFIX = ".fabric/agents/";
 var AGENTS_META_LAYERS = ["L0", "L1", "L2"];
-var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting"];
+var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting", "domain", "local", "global"];
+var AGENTS_META_IDENTITY_SOURCES = ["declared", "derived"];
 var agentsLayerSchema = z.enum(AGENTS_META_LAYERS);
 var agentsTopologyTypeSchema = z.enum(AGENTS_META_TOPOLOGY_TYPES);
+var agentsIdentitySourceSchema = z.enum(AGENTS_META_IDENTITY_SOURCES);
+var ruleDescriptionSchema = z.object({
+  summary: z.string(),
+  intent_clues: z.array(z.string()),
+  tech_stack: z.array(z.string()),
+  impact: z.array(z.string()),
+  must_read_if: z.string(),
+  entities: z.array(z.string()).optional()
+}).strict();
+var ruleDescriptionIndexItemSchema = z.object({
+  stable_id: z.string(),
+  level: agentsLayerSchema,
+  required: z.boolean(),
+  selectable: z.boolean(),
+  description: ruleDescriptionSchema
+}).strict();
 var agentsMetaNodeBaseSchema = z.object({
   file: z.string(),
+  content_ref: z.string().optional(),
   scope_glob: z.string(),
   deps: z.array(z.string()),
   priority: z.enum(["high", "medium", "low"]),
+  level: agentsLayerSchema.optional(),
   layer: agentsLayerSchema,
   topology_type: agentsTopologyTypeSchema,
   hash: z.string(),
+  stable_id: z.string().optional(),
+  identity_source: agentsIdentitySourceSchema.optional(),
   activation: z.object({
     tier: z.enum(["always", "path", "description"]),
     description: z.string().optional()
-  }).optional()
+  }).optional(),
+  description: ruleDescriptionSchema.optional()
 });
 var agentsMetaNodeSchema = z.preprocess((value) => {
   if (!isRecord(value) || typeof value.file !== "string") {
@@ -40,12 +62,31 @@ var agentsMetaSchema = z.object({
   nodes: z.record(agentsMetaNodeSchema)
 });
 function withDerivedAgentsMetaNodeDefaults(node) {
+  const stableId = node.stable_id ?? deriveAgentsMetaStableId(node.file);
+  const identitySource = deriveAgentsMetaIdentitySource(node);
   return {
     ...node,
-    layer: node.layer ?? deriveAgentsMetaLayer(node.file),
-    topology_type: node.topology_type ?? deriveAgentsMetaTopologyType(node.file)
+    layer: node.layer ?? node.level ?? deriveAgentsMetaLayer(node.file),
+    level: node.level ?? node.layer ?? deriveAgentsMetaLayer(node.file),
+    topology_type: node.topology_type ?? deriveAgentsMetaTopologyType(node.file),
+    stable_id: stableId,
+    identity_source: identitySource
   };
 }
+function deriveAgentsMetaStableId(file) {
+  const normalized = normalizePath(file);
+  if (normalized === "AGENTS.md" || normalized === ".fabric/bootstrap/README.md") {
+    return "bootstrap";
+  }
+  return getDepthSource(normalized).replace(/\.md$/u, "");
+}
+function deriveAgentsMetaIdentitySource(node) {
+  if (node.identity_source !== void 0) {
+    return node.identity_source;
+  }
+  const derivedStableId = deriveAgentsMetaStableId(node.file);
+  return node.stable_id !== void 0 && node.stable_id !== derivedStableId ? "declared" : "derived";
+}
 function deriveAgentsMetaLayer(file) {
   const normalized = normalizePath(file);
   if (normalized === "AGENTS.md" || normalized === ".fabric/bootstrap/README.md") {
@@ -359,9 +400,11 @@ var fabricEventSchema = z8.discriminatedUnion("type", [
   driftDetectedEventSchema
 ]);
 export {
+  AGENTS_META_IDENTITY_SOURCES,
   AGENTS_META_LAYERS,
   AGENTS_META_TOPOLOGY_TYPES,
   PROTECTED_TOKENS,
+  agentsIdentitySourceSchema,
   agentsLayerSchema,
   agentsMetaNodeSchema,
   agentsMetaSchema,
@@ -373,7 +416,9 @@ export {
   clientPathsSchema,
   createTranslator,
   defaultMessages,
+  deriveAgentsMetaIdentitySource,
   deriveAgentsMetaLayer,
+  deriveAgentsMetaStableId,
   deriveAgentsMetaTopologyType,
   detectNodeLocale,
   driftDetectedEventSchema,
@@ -411,6 +456,8 @@ export {
   lockDriftEventSchema,
   metaUpdatedEventSchema,
   normalizeLocale,
+  ruleDescriptionIndexItemSchema,
+  ruleDescriptionSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages
 };

package/dist/types/index.d.ts

@@ -1,19 +1,40 @@
 type AgentsLayer = "L0" | "L1" | "L2";
-type AgentsTopologyType = "mirror" | "cross-cutting";
+type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
 type AgentsActivationTier = "always" | "path" | "description";
+type AgentsIdentitySource = "declared" | "derived";
+interface RuleDescription {
+    summary: string;
+    intent_clues: string[];
+    tech_stack: string[];
+    impact: string[];
+    must_read_if: string;
+    entities?: string[];
+}
+interface RuleDescriptionIndexItem {
+    stable_id: string;
+    level: AgentsLayer;
+    required: boolean;
+    selectable: boolean;
+    description: RuleDescription;
+}
 interface AgentsMetaNodeActivation {
     tier: AgentsActivationTier;
     description?: string;
 }
 interface AgentsMetaNode {
     file: string;
+    content_ref?: string;
     scope_glob: string;
     deps: string[];
     priority: "high" | "medium" | "low";
+    level?: AgentsLayer;
     layer: AgentsLayer;
     topology_type: AgentsTopologyType;
     hash: string;
+    stable_id?: string;
+    identity_source?: AgentsIdentitySource;
     activation?: AgentsMetaNodeActivation;
+    description?: RuleDescription;
 }
 interface AgentsMeta {
     revision: string;
@@ -65,4 +86,4 @@ interface FabricConfig {
     audit_mode?: AuditMode;
 }
 
-export type { AgentsActivationTier, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry };
+export type { AgentsActivationTier, AgentsIdentitySource, AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsMetaNodeActivation, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry, RuleDescription, RuleDescriptionIndexItem };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",