@fenglimg/fabric-shared 1.0.0 → 1.2.0

package/dist/index.js

@@ -6,22 +6,79 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-2MXNG23L.js";
+} from "./chunk-HVAUI6VN.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
-var agentsMetaNodeSchema = z.object({
+var FABRIC_AGENTS_PREFIX = ".fabric/agents/";
+var AGENTS_META_LAYERS = ["L0", "L1", "L2"];
+var AGENTS_META_TOPOLOGY_TYPES = ["mirror", "cross-cutting"];
+var agentsLayerSchema = z.enum(AGENTS_META_LAYERS);
+var agentsTopologyTypeSchema = z.enum(AGENTS_META_TOPOLOGY_TYPES);
+var agentsMetaNodeBaseSchema = z.object({
   file: z.string(),
   scope_glob: z.string(),
   deps: z.array(z.string()),
   priority: z.enum(["high", "medium", "low"]),
+  layer: agentsLayerSchema,
+  topology_type: agentsTopologyTypeSchema,
   hash: z.string()
 });
+var agentsMetaNodeSchema = z.preprocess((value) => {
+  if (!isRecord(value) || typeof value.file !== "string") {
+    return value;
+  }
+  return withDerivedAgentsMetaNodeDefaults(value);
+}, agentsMetaNodeBaseSchema);
 var agentsMetaSchema = z.object({
   revision: z.string(),
   nodes: z.record(agentsMetaNodeSchema)
 });
+function withDerivedAgentsMetaNodeDefaults(node) {
+  return {
+    ...node,
+    layer: node.layer ?? deriveAgentsMetaLayer(node.file),
+    topology_type: node.topology_type ?? deriveAgentsMetaTopologyType(node.file)
+  };
+}
+function deriveAgentsMetaLayer(file) {
+  const normalized = normalizePath(file);
+  if (normalized === "AGENTS.md") {
+    return "L0";
+  }
+  if (hasCrossCuttingSegment(normalized)) {
+    return "L1";
+  }
+  const depthSource = getDepthSource(normalized);
+  const directoryDepth = getDirectoryDepth(depthSource);
+  if (directoryDepth === 0) {
+    return "L0";
+  }
+  if (directoryDepth <= 2) {
+    return "L1";
+  }
+  return "L2";
+}
+function deriveAgentsMetaTopologyType(file) {
+  return hasCrossCuttingSegment(normalizePath(file)) ? "cross-cutting" : "mirror";
+}
+function getDepthSource(file) {
+  return file.startsWith(FABRIC_AGENTS_PREFIX) ? file.slice(FABRIC_AGENTS_PREFIX.length) : file;
+}
+function getDirectoryDepth(file) {
+  const segments = file.split("/").filter(Boolean);
+  return Math.max(segments.length - 1, 0);
+}
+function hasCrossCuttingSegment(file) {
+  return file.split("/").includes("_cross");
+}
+function normalizePath(value) {
+  return value.replaceAll("\\", "/");
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
 
 // src/schemas/api-contracts.ts
 import { z as z2 } from "zod";
@@ -123,6 +180,7 @@ var humanLockFileSchema = z4.object({
 
 // src/schemas/fabric-config.ts
 import { z as z5 } from "zod";
+var auditModeSchema = z5.enum(["strict", "warn", "off"]);
 var clientPathsSchema = z5.object({
   claudeCodeCLI: z5.string().optional(),
   claudeCodeDesktop: z5.string().optional(),
@@ -135,7 +193,9 @@ var clientPathsSchema = z5.object({
 var fabricConfigSchema = z5.object({
   clientPaths: clientPathsSchema.optional(),
   externalFixturePath: z5.string().optional(),
-  scanIgnores: z5.array(z5.string()).optional()
+  scanIgnores: z5.array(z5.string()).optional(),
+  auditMode: auditModeSchema.optional(),
+  audit_mode: auditModeSchema.optional()
 });
 
 // src/schemas/forensic-report.ts
@@ -146,6 +206,26 @@ var forensicCodeSampleSchema = z6.object({
   snippet: z6.string(),
   pattern_hint: z6.string()
 });
+var forensicEvidenceAnchorSchema = z6.object({
+  file: z6.string(),
+  line: z6.string(),
+  snippet: z6.string()
+});
+var forensicAssertionCoverageSchema = z6.object({
+  ratio: z6.number().min(0).max(1),
+  total: z6.number().int().nonnegative(),
+  matched: z6.number().int().nonnegative(),
+  co_occurring_patterns: z6.array(z6.string())
+});
+var forensicAssertionSchema = z6.object({
+  type: z6.enum(["framework", "pattern", "invariant", "domain"]),
+  statement: z6.string(),
+  confidence: z6.enum(["HIGH", "MEDIUM", "LOW"]),
+  evidence: z6.array(forensicEvidenceAnchorSchema),
+  coverage: forensicAssertionCoverageSchema,
+  proposed_rule: z6.string().optional(),
+  alternatives: z6.array(z6.string()).optional()
+});
 var forensicTopologySchema = z6.object({
   total_files: z6.number().int().nonnegative(),
   by_ext: z6.record(z6.number().int().nonnegative()),
@@ -168,6 +248,15 @@ var forensicReadmeSchema = z6.object({
   line_count: z6.number().int().nonnegative(),
   has_contributing: z6.boolean()
 });
+var candidateFileEntrySchema = z6.object({
+  path: z6.string(),
+  family: z6.enum(["entry", "component", "config", "test", "domain"]),
+  rationale: z6.string()
+});
+var forensicSamplingBudgetSchema = z6.object({
+  max_files: z6.literal(15),
+  max_lines_per_file: z6.literal(100)
+});
 var forensicReportSchema = z6.object({
   version: z6.string(),
   generated_at: z6.string(),
@@ -178,8 +267,11 @@ var forensicReportSchema = z6.object({
   topology: forensicTopologySchema,
   entry_points: z6.array(forensicEntryPointSchema),
   code_samples: z6.array(forensicCodeSampleSchema),
+  assertions: z6.array(forensicAssertionSchema),
+  candidate_files: z6.array(candidateFileEntrySchema),
+  sampling_budget: forensicSamplingBudgetSchema,
   readme: forensicReadmeSchema,
-  recommendations_for_skill: z6.array(z6.string())
+  recommendations_for_skill: z6.array(z6.string()).optional()
 });
 
 // src/schemas/init-context.ts
@@ -189,20 +281,34 @@ var initContextFrameworkSchema = z7.object({
   version: z7.string(),
   subkind: z7.string()
 });
+var initContextInvariantConfidenceSnapshotSchema = z7.object({
+  confidence: z7.enum(["HIGH", "MEDIUM", "LOW"]),
+  evidence_refs: z7.array(z7.string())
+});
+var initContextSourceEvidenceSchema = z7.object({
+  file: z7.string(),
+  lines: z7.string()
+});
 var initContextInvariantSchema = z7.object({
   type: z7.enum(["ban", "require", "protect"]),
   rule: z7.string(),
-  rationale: z7.string().optional()
+  rationale: z7.string().optional(),
+  confidence_snapshot: initContextInvariantConfidenceSnapshotSchema.optional(),
+  source_evidence: z7.array(initContextSourceEvidenceSchema).optional()
 });
 var initContextDomainGroupSchema = z7.object({
   name: z7.string(),
   paths: z7.array(z7.string()),
-  summary: z7.string().optional()
+  summary: z7.string().optional(),
+  topology_type: z7.enum(["mirror", "cross-cutting"]).optional(),
+  target_path: z7.string().optional()
 });
 var initContextInterviewTrailEntrySchema = z7.object({
   phase: z7.string(),
   question: z7.string(),
-  answer: z7.string()
+  answer: z7.string(),
+  presentation: z7.string().optional(),
+  user_corrections: z7.array(z7.string()).optional()
 });
 var initContextSchema = z7.object({
   framework: initContextFrameworkSchema,
@@ -248,135 +354,37 @@ var fabricEventSchema = z8.discriminatedUnion("type", [
   ledgerAppendedEventSchema,
   driftDetectedEventSchema
 ]);
-
-// src/detector.ts
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function detectFramework(root) {
-  const evidence = [];
-  const creatorConfigPath = join(root, "project.config.json");
-  if (existsSync(creatorConfigPath)) {
-    const version = readCreatorVersion(creatorConfigPath);
-    return {
-      kind: "cocos-creator",
-      version,
-      subkind: inferCocosSubkind(root, version),
-      evidence: version === "unknown" ? ["project.config.json"] : [`project.config.json: creator.version=${version}`]
-    };
-  }
-  const packageJsonPath = join(root, "package.json");
-  if (existsSync(packageJsonPath)) {
-    const packageJson = readPackageJson(packageJsonPath);
-    const deps = collectDependencyVersions(packageJson);
-    for (const [dependencyName, kind] of [
-      ["next", "next"],
-      ["vite", "vite"],
-      ["react", "react"],
-      ["vue", "vue"]
-    ]) {
-      if (deps.has(dependencyName)) {
-        const version = deps.get(dependencyName) ?? "unknown";
-        evidence.push(`package.json dependency: ${dependencyName}@${version}`);
-        return {
-          kind,
-          version,
-          subkind: inferPackageSubkind(kind),
-          evidence
-        };
-      }
-    }
-    evidence.push("package.json");
-  }
-  if (existsSync(join(root, "Cargo.toml"))) {
-    return {
-      kind: "rust",
-      version: "unknown",
-      subkind: "cargo-project",
-      evidence: ["Cargo.toml"]
-    };
-  }
-  if (existsSync(join(root, "pyproject.toml"))) {
-    return {
-      kind: "python",
-      version: "unknown",
-      subkind: "pyproject",
-      evidence: ["pyproject.toml"]
-    };
-  }
-  return {
-    kind: "unknown",
-    version: "unknown",
-    subkind: "unknown",
-    evidence
-  };
-}
-function readPackageJson(packageJsonPath) {
-  try {
-    return JSON.parse(readFileSync(packageJsonPath, "utf8"));
-  } catch {
-    return {};
-  }
-}
-function readCreatorVersion(creatorConfigPath) {
-  try {
-    const creatorConfig = JSON.parse(readFileSync(creatorConfigPath, "utf8"));
-    return creatorConfig.creator?.version ?? "unknown";
-  } catch {
-    return "unknown";
-  }
-}
-function collectDependencyVersions(packageJson) {
-  return new Map([
-    ...Object.entries(packageJson.dependencies ?? {}),
-    ...Object.entries(packageJson.devDependencies ?? {}),
-    ...Object.entries(packageJson.peerDependencies ?? {}),
-    ...Object.entries(packageJson.optionalDependencies ?? {})
-  ]);
-}
-function inferCocosSubkind(root, version) {
-  const majorVersion = Number.parseInt(version.split(".")[0] ?? "", 10);
-  if (majorVersion === 2) {
-    return "javascript-traditional";
-  }
-  if (majorVersion >= 3) {
-    return "typescript-component";
-  }
-  return existsSync(join(root, "tsconfig.json")) ? "typescript-component" : "javascript-traditional";
-}
-function inferPackageSubkind(kind) {
-  switch (kind) {
-    case "next":
-      return "next-application";
-    case "vite":
-      return "vite-application";
-    case "react":
-      return "react-application";
-    case "vue":
-      return "vue-application";
-    default:
-      return "unknown";
-  }
-}
 export {
+  AGENTS_META_LAYERS,
+  AGENTS_META_TOPOLOGY_TYPES,
   PROTECTED_TOKENS,
+  agentsLayerSchema,
   agentsMetaNodeSchema,
   agentsMetaSchema,
+  agentsTopologyTypeSchema,
   aiLedgerEntrySchema,
   annotateIntentRequestSchema,
+  auditModeSchema,
+  candidateFileEntrySchema,
   clientPathsSchema,
   createTranslator,
   defaultMessages,
-  detectFramework,
+  deriveAgentsMetaLayer,
+  deriveAgentsMetaTopologyType,
   detectNodeLocale,
   driftDetectedEventSchema,
   enMessages,
   fabricConfigSchema,
   fabricEventSchema,
+  forensicAssertionCoverageSchema,
+  forensicAssertionSchema,
   forensicCodeSampleSchema,
   forensicEntryPointSchema,
+  forensicEvidenceAnchorSchema,
   forensicFrameworkSchema,
   forensicReadmeSchema,
   forensicReportSchema,
+  forensicSamplingBudgetSchema,
   forensicTopologySchema,
   historyStateQuerySchema,
   humanLedgerEntrySchema,
@@ -387,8 +395,10 @@ export {
   initContextDomainGroupSchema,
   initContextFrameworkSchema,
   initContextInterviewTrailEntrySchema,
+  initContextInvariantConfidenceSnapshotSchema,
   initContextInvariantSchema,
   initContextSchema,
+  initContextSourceEvidenceSchema,
   ledgerAppendedEventSchema,
   ledgerEntrySchema,
   ledgerQuerySchema,
@@ -397,5 +407,6 @@ export {
   lockDriftEventSchema,
   metaUpdatedEventSchema,
   normalizeLocale,
+  withDerivedAgentsMetaNodeDefaults,
   zhCNMessages
 };

package/dist/node.d.ts

@@ -0,0 +1,9 @@
+type FrameworkInfo = {
+    kind: "vite" | "next" | "react" | "vue" | "cocos-creator" | "rust" | "python" | "unknown";
+    version: string;
+    subkind: string;
+    evidence: string[];
+};
+declare function detectFramework(root: string): FrameworkInfo;
+
+export { type FrameworkInfo, detectFramework };

package/dist/node.js

@@ -0,0 +1,111 @@
+// src/detector.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+function detectFramework(root) {
+  const evidence = [];
+  const creatorConfigPath = join(root, "project.config.json");
+  if (existsSync(creatorConfigPath)) {
+    const version = readCreatorVersion(creatorConfigPath);
+    return {
+      kind: "cocos-creator",
+      version,
+      subkind: inferCocosSubkind(root, version),
+      evidence: version === "unknown" ? ["project.config.json"] : [`project.config.json: creator.version=${version}`]
+    };
+  }
+  const packageJsonPath = join(root, "package.json");
+  if (existsSync(packageJsonPath)) {
+    const packageJson = readPackageJson(packageJsonPath);
+    const deps = collectDependencyVersions(packageJson);
+    for (const [dependencyName, kind] of [
+      ["next", "next"],
+      ["vite", "vite"],
+      ["react", "react"],
+      ["vue", "vue"]
+    ]) {
+      if (deps.has(dependencyName)) {
+        const version = deps.get(dependencyName) ?? "unknown";
+        evidence.push(`package.json dependency: ${dependencyName}@${version}`);
+        return {
+          kind,
+          version,
+          subkind: inferPackageSubkind(kind),
+          evidence
+        };
+      }
+    }
+    evidence.push("package.json");
+  }
+  if (existsSync(join(root, "Cargo.toml"))) {
+    return {
+      kind: "rust",
+      version: "unknown",
+      subkind: "cargo-project",
+      evidence: ["Cargo.toml"]
+    };
+  }
+  if (existsSync(join(root, "pyproject.toml"))) {
+    return {
+      kind: "python",
+      version: "unknown",
+      subkind: "pyproject",
+      evidence: ["pyproject.toml"]
+    };
+  }
+  return {
+    kind: "unknown",
+    version: "unknown",
+    subkind: "unknown",
+    evidence
+  };
+}
+function readPackageJson(packageJsonPath) {
+  try {
+    return JSON.parse(readFileSync(packageJsonPath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function readCreatorVersion(creatorConfigPath) {
+  try {
+    const creatorConfig = JSON.parse(readFileSync(creatorConfigPath, "utf8"));
+    return creatorConfig.creator?.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function collectDependencyVersions(packageJson) {
+  return new Map([
+    ...Object.entries(packageJson.dependencies ?? {}),
+    ...Object.entries(packageJson.devDependencies ?? {}),
+    ...Object.entries(packageJson.peerDependencies ?? {}),
+    ...Object.entries(packageJson.optionalDependencies ?? {})
+  ]);
+}
+function inferCocosSubkind(root, version) {
+  const majorVersion = Number.parseInt(version.split(".")[0] ?? "", 10);
+  if (majorVersion === 2) {
+    return "javascript-traditional";
+  }
+  if (majorVersion >= 3) {
+    return "typescript-component";
+  }
+  return existsSync(join(root, "tsconfig.json")) ? "typescript-component" : "javascript-traditional";
+}
+function inferPackageSubkind(kind) {
+  switch (kind) {
+    case "next":
+      return "next-application";
+    case "vite":
+      return "vite-application";
+    case "react":
+      return "react-application";
+    case "vue":
+      return "vue-application";
+    default:
+      return "unknown";
+  }
+}
+export {
+  detectFramework
+};

package/dist/types/index.d.ts

@@ -1,8 +1,12 @@
+type AgentsLayer = "L0" | "L1" | "L2";
+type AgentsTopologyType = "mirror" | "cross-cutting";
 interface AgentsMetaNode {
     file: string;
     scope_glob: string;
     deps: string[];
     priority: "high" | "medium" | "low";
+    layer: AgentsLayer;
+    topology_type: AgentsTopologyType;
     hash: string;
 }
 interface AgentsMeta {
@@ -46,10 +50,13 @@ interface ClientPaths {
     geminiCLI?: string;
     codexCLI?: string;
 }
+type AuditMode = "strict" | "warn" | "off";
 interface FabricConfig {
     clientPaths?: ClientPaths;
     externalFixturePath?: string;
     scanIgnores?: string[];
+    auditMode?: AuditMode;
+    audit_mode?: AuditMode;
 }
 
-export type { AgentsMeta, AgentsMetaNode, AiLedgerEntry, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry };
+export type { AgentsLayer, AgentsMeta, AgentsMetaNode, AgentsTopologyType, AiLedgerEntry, AuditMode, ClientPaths, FabricConfig, HumanLedgerEntry, HumanLockEntry, LedgerEntry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,10 @@
     "./types": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/types/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
     }
   },
   "files": [
@@ -25,11 +29,12 @@
     "zod": "^3.25.0"
   },
   "devDependencies": {
+    "@types/node": "^22.15.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/i18n/index.ts src/types/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/i18n/index.ts src/types/index.ts --format esm --dts --watch"
+    "build": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/i18n/index.ts src/types/index.ts src/node.ts --format esm --dts --watch"
   }
 }