@fenglimg/fabric-cli 1.0.0 → 1.1.0

package/dist/{chunk-5BSTO745.js → chunk-6UUPKSDE.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  resolveIgnores
-} from "./chunk-P4KVFB2T.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";
@@ -10,6 +7,11 @@ import {
 import { createHash } from "crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
 import { isAbsolute, join, relative, resolve, sep } from "path";
+import {
+  agentsMetaSchema,
+  deriveAgentsMetaLayer,
+  deriveAgentsMetaTopologyType
+} from "@fenglimg/fabric-shared";
 import { defineCommand } from "citty";
 var syncMetaCommand = defineCommand({
   meta: {
@@ -55,11 +57,15 @@ function computeAgentsMeta(target) {
   const metaPath = join(target, ".fabric", "agents.meta.json");
   const existingMeta = readExistingMeta(metaPath);
   const existingByFile = indexExistingNodesByFile(existingMeta);
-  const agentsFiles = findAgentsFiles(target);
+  const agentsFiles = findFabricAgentsFiles(target);
   const nodes = {};
+  const bootstrapNode = createBootstrapNode(target, existingByFile.get("AGENTS.md")?.node);
+  if (bootstrapNode !== void 0) {
+    nodes.L0 = bootstrapNode;
+  }
   for (const file of agentsFiles) {
     const existing = existingByFile.get(file);
-    const id = existing?.id ?? deriveNodeId(file);
+    const id = deriveNodeId(file);
     const hash = sha256(readFileSync(join(target, file), "utf8"));
     const defaults = createDefaultNodeMeta(file);
     nodes[id] = {
@@ -88,15 +94,18 @@ function readExistingMeta(metaPath) {
     return void 0;
   }
   try {
-    return JSON.parse(readFileSync(metaPath, "utf8"));
+    return agentsMetaSchema.parse(JSON.parse(readFileSync(metaPath, "utf8")));
   } catch {
     return void 0;
   }
 }
-function findAgentsFiles(target) {
-  const ignorePatterns = resolveIgnores();
+function findFabricAgentsFiles(target) {
+  const agentsRoot = join(target, ".fabric", "agents");
+  if (!existsSync(agentsRoot) || !statSync(agentsRoot).isDirectory()) {
+    return [];
+  }
   const files = [];
-  const stack = [target];
+  const stack = [agentsRoot];
   while (stack.length > 0) {
     const current = stack.pop();
     if (current === void 0) {
@@ -105,31 +114,20 @@ function findAgentsFiles(target) {
     for (const entry of readdirSync(current, { withFileTypes: true })) {
       const absolutePath = join(current, entry.name);
       const relativePath = toPosixPath(relative(target, absolutePath));
-      if (shouldIgnore(relativePath, entry.isDirectory(), ignorePatterns)) {
-        continue;
-      }
       if (entry.isDirectory()) {
         stack.push(absolutePath);
-      } else if (entry.isFile() && entry.name === "AGENTS.md") {
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
         files.push(relativePath);
       }
     }
   }
   return files.sort();
 }
-function shouldIgnore(relativePath, isDirectory, ignorePatterns) {
-  return ignorePatterns.some((pattern) => matchesIgnorePattern(relativePath, isDirectory, pattern));
+function deriveLayer(relativePath) {
+  return deriveAgentsMetaLayer(relativePath);
 }
-function matchesIgnorePattern(relativePath, isDirectory, pattern) {
-  const normalizedPattern = toPosixPath(pattern);
-  if (normalizedPattern === "**/*.meta") {
-    return relativePath.endsWith(".meta");
-  }
-  if (normalizedPattern.endsWith("/**")) {
-    const directoryPrefix = normalizedPattern.slice(0, -3);
-    return relativePath === directoryPrefix || relativePath.startsWith(`${directoryPrefix}/`) || isDirectory && `${relativePath}/` === directoryPrefix;
-  }
-  return relativePath === normalizedPattern;
+function deriveTopologyType(relativePath) {
+  return deriveAgentsMetaTopologyType(relativePath);
 }
 function indexExistingNodesByFile(existingMeta) {
   const byFile = /* @__PURE__ */ new Map();
@@ -142,18 +140,57 @@ function deriveNodeId(file) {
   if (file === "AGENTS.md") {
     return "L0";
   }
-  return file.replace(/\/AGENTS\.md$/, "");
+  const layer = deriveLayer(file);
+  const relativeStem = getMirrorRelativeStem(file);
+  return `${layer}/${relativeStem}`;
 }
 function createDefaultNodeMeta(file) {
-  const scope = file === "AGENTS.md" ? "**" : `${file.replace(/\/AGENTS\.md$/, "")}/**`;
+  const layer = deriveLayer(file);
+  const topologyType = deriveTopologyType(file);
   return {
     file,
-    scope_glob: scope,
-    deps: file === "AGENTS.md" ? [] : ["L0"],
-    priority: file === "AGENTS.md" ? "high" : "medium",
+    scope_glob: deriveScopeGlob(file),
+    deps: layer === "L0" ? [] : ["L0"],
+    priority: layer === "L0" ? "high" : "medium",
+    layer,
+    topology_type: topologyType,
     hash: ""
   };
 }
+function createBootstrapNode(target, existing) {
+  const bootstrapPath = join(target, "AGENTS.md");
+  if (!existsSync(bootstrapPath)) {
+    return void 0;
+  }
+  const hash = sha256(readFileSync(bootstrapPath, "utf8"));
+  return {
+    ...createDefaultNodeMeta("AGENTS.md"),
+    ...existing,
+    file: "AGENTS.md",
+    hash
+  };
+}
+function deriveScopeGlob(file) {
+  if (file === "AGENTS.md") {
+    return "**";
+  }
+  const stem = getMirrorRelativeStem(file);
+  const segments = stem.split("/").filter(Boolean);
+  if (segments.length === 0 || stem === "root") {
+    return "**";
+  }
+  if (segments[0] === "_cross") {
+    return "**";
+  }
+  if (segments.at(-1) === "rules") {
+    segments.pop();
+  }
+  const scopePath = segments.join("/");
+  return scopePath === "" ? "**" : `${scopePath}/**`;
+}
+function getMirrorRelativeStem(file) {
+  return file.replace(/^\.fabric\/agents\//, "").replace(/\.md$/, "");
+}
 function sortNodes(nodes) {
   return Object.fromEntries(Object.entries(nodes).sort(([left], [right]) => left.localeCompare(right)));
 }
@@ -187,5 +224,7 @@ function sha256(content) {
 export {
   syncMetaCommand,
   sync_meta_default,
-  computeAgentsMeta
+  computeAgentsMeta,
+  deriveLayer,
+  deriveTopologyType
 };

package/dist/{chunk-DKQ3HOTK.js → chunk-JWUO6TIS.js}

@@ -4,9 +4,6 @@ import {
   readFabricConfig,
   resolveDevMode
 } from "./chunk-AEOYCVBG.js";
-import {
-  resolveIgnores
-} from "./chunk-P4KVFB2T.js";
 import {
   displayWidth,
   padEnd,
@@ -23,7 +20,24 @@ import { isAbsolute, join, relative, resolve, sep } from "path";
 import { defineCommand } from "citty";
 
 // src/scanner/detector.ts
-import { detectFramework } from "@fenglimg/fabric-shared";
+import { detectFramework } from "@fenglimg/fabric-shared/node";
+
+// src/scanner/ignores.ts
+var DEFAULT_IGNORES = [
+  "**/*.meta",
+  "library/**",
+  "temp/**",
+  "build/**",
+  "settings/**",
+  "profiles/**",
+  "node_modules/**",
+  "dist/**",
+  ".git/**",
+  ".fabric/**"
+];
+function resolveIgnores(fabricConfig) {
+  return [...DEFAULT_IGNORES, ...fabricConfig?.scanIgnores ?? []];
+}
 
 // src/commands/scan.ts
 function createScanReport(targetInput = process.cwd(), fabricConfig) {

package/dist/doctor-QTSG2RWF.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import {
+  resolveDevMode
+} from "./chunk-AEOYCVBG.js";
+import {
+  padEnd,
+  paint,
+  symbol
+} from "./chunk-WWNXR34K.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
+
+// src/commands/doctor.ts
+import { defineCommand } from "citty";
+import { runDoctorAuditReport, runDoctorReport } from "@fenglimg/fabric-server";
+var DEFAULT_AUDIT_WINDOW_MINUTES = 5;
+var doctorCommand = defineCommand({
+  meta: {
+    name: "doctor",
+    description: t("cli.doctor.description")
+  },
+  args: {
+    target: {
+      type: "string",
+      description: t("cli.doctor.args.target.description")
+    },
+    audit: {
+      type: "boolean",
+      description: t("cli.doctor.args.audit.description"),
+      default: false
+    },
+    "window-minutes": {
+      type: "string",
+      description: t("cli.doctor.args.window-minutes.description"),
+      default: String(DEFAULT_AUDIT_WINDOW_MINUTES)
+    }
+  },
+  async run({ args }) {
+    const workspaceRoot = process.cwd();
+    const resolution = resolveDevMode(args.target, workspaceRoot);
+    const report = await runDoctorReport(resolution.target);
+    writeStdout(`${renderStatus(report.status)} ${paint.ai("fab doctor")} ${paint.human(resolution.target)}`);
+    for (const check of report.checks) {
+      writeStdout(`${renderStatus(check.status)} ${check.name}: ${check.message}`);
+    }
+    if (!args.audit) {
+      return;
+    }
+    const auditReport = await runDoctorAuditReport(resolution.target, {
+      force: true,
+      windowMs: parseWindowMinutes(args["window-minutes"])
+    });
+    if (auditReport.mode === "off") {
+      writeStderr(t("cli.doctor.audit.preview-only"));
+    }
+    if (auditReport.checkedPathCount === 0) {
+      writeStderr(t("cli.doctor.audit.none"));
+      return;
+    }
+    if (auditReport.violationCount === 0) {
+      writeStderr(
+        `${symbol.ok} ${t("cli.doctor.audit.clean", {
+          count: String(auditReport.checkedPathCount),
+          window: formatDuration(auditReport.windowMs)
+        })}`
+      );
+      return;
+    }
+    const writer = auditReport.mode === "strict" ? console.error : console.warn;
+    writer(
+      t("cli.doctor.audit.violations", {
+        count: String(auditReport.violationCount),
+        window: formatDuration(auditReport.windowMs)
+      })
+    );
+    writeStderr(
+      `${padEnd(t("cli.doctor.audit.table.path"), 32)} ${padEnd(t("cli.doctor.audit.table.edit"), 22)} ${padEnd(t("cli.doctor.audit.table.rules"), 22)} ${t("cli.doctor.audit.table.intent")}`
+    );
+    for (const violation of auditReport.violations) {
+      writeStderr(
+        `${padEnd(violation.path, 32)} ${padEnd(new Date(violation.editTs).toISOString(), 22)} ${padEnd(formatRulesTs(violation.lastGetRulesTs), 22)} ${violation.intent}`
+      );
+    }
+    if (auditReport.mode === "strict") {
+      process.exitCode = 1;
+    }
+  }
+});
+var doctor_default = doctorCommand;
+function renderStatus(status) {
+  if (status === "ok") {
+    return symbol.ok;
+  }
+  if (status === "warn") {
+    return symbol.warn;
+  }
+  return symbol.error;
+}
+function parseWindowMinutes(value) {
+  const minutes = Number.parseInt(value ?? String(DEFAULT_AUDIT_WINDOW_MINUTES), 10);
+  if (!Number.isInteger(minutes) || minutes < 1) {
+    throw new Error(t("cli.doctor.errors.invalid-window", { value: value ?? "<unset>" }));
+  }
+  return minutes * 60 * 1e3;
+}
+function formatDuration(durationMs) {
+  const minutes = Math.max(Math.floor(durationMs / (60 * 1e3)), 1);
+  return `${minutes}m`;
+}
+function formatRulesTs(value) {
+  return value === null ? t("cli.shared.none") : new Date(value).toISOString();
+}
+function writeStdout(message) {
+  process.stdout.write(`${message}
+`);
+}
+function writeStderr(message) {
+  process.stderr.write(`${message}
+`);
+}
+export {
+  doctor_default as default,
+  doctorCommand
+};

package/dist/index.js

@@ -12,22 +12,23 @@ import { defineCommand, runMain } from "citty";
 // src/commands/index.ts
 var allCommands = {
   bootstrap: () => import("./bootstrap-PMIA4W6G.js").then((module) => module.default),
-  init: () => import("./init-G6Q3OOMC.js").then((module) => module.default),
-  scan: () => import("./scan-6CURGC3D.js").then((module) => module.default),
+  doctor: () => import("./doctor-QTSG2RWF.js").then((module) => module.default),
+  init: () => import("./init-R73E5YTG.js").then((module) => module.default),
+  scan: () => import("./scan-JBGFRB7P.js").then((module) => module.default),
   serve: () => import("./serve-4J2CQY25.js").then((module) => module.default),
-  "sync-meta": () => import("./sync-meta-L6M4AEUT.js").then((module) => module.default),
+  "sync-meta": () => import("./sync-meta-THZSEM7Y.js").then((module) => module.default),
   "human-lint": () => import("./human-lint-YSFOZHZ7.js").then((module) => module.default),
   "ledger-append": () => import("./ledger-append-XZ5SX4O5.js").then((module) => module.default),
   hooks: () => import("./hooks-5S5IRVQE.js").then((module) => module.default),
   config: () => import("./config-PXEEXWLM.js").then((module) => module.configCmd),
-  "pre-commit": () => import("./pre-commit-IEIXHKOD.js").then((module) => module.default)
+  "pre-commit": () => import("./pre-commit-BLSUMT3P.js").then((module) => module.default)
 };
 
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fab",
-    version: "1.0.0",
+    version: "1.1.0",
     description: t("cli.main.description")
   },
   subCommands: allCommands