@fenglimg/fabric-cli 1.5.1 → 1.6.0

package/dist/{chunk-N7EZORJZ.js → chunk-2YW5CJ32.js}

@@ -5,10 +5,10 @@ import {
 
 // src/commands/ledger-append.ts
 import { execSync } from "child_process";
-import { appendFileSync, existsSync, readFileSync, statSync } from "fs";
-import { basename, isAbsolute, join, resolve } from "path";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync } from "fs";
+import { basename, isAbsolute, resolve } from "path";
+import { getLedgerPath, getLegacyLedgerPath, LEGACY_LEDGER_PATH, LEDGER_PATH } from "@fenglimg/fabric-server";
 import { defineCommand } from "citty";
-var LEDGER_FILE = ".intent-ledger.jsonl";
 var INITIAL_PARENT_SHA = "root";
 var ledgerAppendCommand = defineCommand({
   meta: {
@@ -35,7 +35,7 @@ var ledgerAppendCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
-    const stagedFiles = getStagedFiles(target).filter((file) => file !== LEDGER_FILE);
+    const stagedFiles = getStagedFiles(target).filter((file) => file !== LEGACY_LEDGER_PATH && file !== LEDGER_PATH);
     if (stagedFiles.length === 0) {
       return;
     }
@@ -52,9 +52,11 @@ var ledgerAppendCommand = defineCommand({
     if (hasMatchingTailEntry(target, entry)) {
       return;
     }
-    appendFileSync(join(target, LEDGER_FILE), `${JSON.stringify(entry)}
+    const ledgerPath = getLedgerPath(target);
+    mkdirSync(resolve(target, ".fabric"), { recursive: true });
+    appendFileSync(ledgerPath, `${JSON.stringify(entry)}
 `, "utf8");
-    execGit(target, `git add ${LEDGER_FILE}`);
+    execGit(target, `git add ${LEDGER_PATH}`);
   }
 });
 var ledger_append_default = ledgerAppendCommand;
@@ -91,7 +93,7 @@ function deriveIntent(stagedFiles) {
   return t("cli.ledger-append.intent.auto", { head, suffix });
 }
 function hasMatchingTailEntry(target, entry) {
-  const ledgerPath = join(target, LEDGER_FILE);
+  const ledgerPath = resolveTailLedgerPath(target);
   if (!existsSync(ledgerPath)) {
     return false;
   }
@@ -106,6 +108,13 @@ function hasMatchingTailEntry(target, entry) {
     return false;
   }
 }
+function resolveTailLedgerPath(target) {
+  const canonicalPath = getLedgerPath(target);
+  if (existsSync(canonicalPath)) {
+    return canonicalPath;
+  }
+  return getLegacyLedgerPath(target);
+}
 function isLedgerEntryLine(line) {
   try {
     const parsed = JSON.parse(line);
@@ -118,7 +127,7 @@ function normalizeDiffStat(diffStat) {
   if (typeof diffStat !== "string") {
     return "";
   }
-  return diffStat.split(/\r?\n/).map((line) => line.trim()).map((line) => line.replace(/\s+\|\s+/g, " | ")).map((line) => line.replace(/\s+/g, " ")).filter((line) => line.length > 0).filter((line) => !line.includes(LEDGER_FILE)).filter((line) => !/\d+ files? changed(?:, \d+ insertions?\(\+\))?(?:, \d+ deletions?\(-\))?$/.test(line.trim())).join("\n");
+  return diffStat.split(/\r?\n/).map((line) => line.trim()).map((line) => line.replace(/\s+\|\s+/g, " | ")).map((line) => line.replace(/\s+/g, " ")).filter((line) => line.length > 0).filter((line) => !line.includes(LEGACY_LEDGER_PATH)).filter((line) => !line.includes(LEDGER_PATH)).filter((line) => !/\d+ files? changed(?:, \d+ insertions?\(\+\))?(?:, \d+ deletions?\(-\))?$/.test(line.trim())).join("\n");
 }
 function execGit(target, command) {
   return execSync(command, {

package/dist/{chunk-Q4LOVXML.js → chunk-KOAEIH72.js}

@@ -10,6 +10,7 @@ import { isAbsolute, join, relative, resolve, sep } from "path";
 import {
   agentsMetaSchema,
   deriveAgentsMetaLayer,
+  deriveAgentsMetaStableId,
   deriveAgentsMetaTopologyType
 } from "@fenglimg/fabric-shared";
 import { defineCommand } from "citty";
@@ -68,14 +69,18 @@ function computeAgentsMeta(target) {
   }
   for (const file of agentsFiles) {
     const existing = existingByFile.get(file);
+    const source = readFileSync(join(target, file), "utf8");
     const id = deriveNodeId(file);
-    const hash = sha256(readFileSync(join(target, file), "utf8"));
+    const hash = sha256(source);
     const defaults = createDefaultNodeMeta(file);
+    const identity = deriveRuleIdentity(file, source, existing?.node);
     nodes[id] = {
       ...defaults,
       ...existing?.node,
       file,
-      hash
+      hash,
+      stable_id: identity.stableId,
+      identity_source: identity.identitySource
     };
   }
   return {
@@ -168,11 +173,17 @@ function createBootstrapNode(target, existing) {
     return void 0;
   }
   const hash = sha256(readFileSync(sourcePath, "utf8"));
+  const identity = {
+    stableId: existing?.stable_id ?? deriveAgentsMetaStableId(".fabric/bootstrap/README.md"),
+    identitySource: existing?.identity_source ?? "derived"
+  };
   return {
     ...createDefaultNodeMeta(".fabric/bootstrap/README.md"),
     ...existing,
     file: ".fabric/bootstrap/README.md",
-    hash
+    hash,
+    stable_id: identity.stableId,
+    identity_source: identity.identitySource
   };
 }
 function deriveScopeGlob(file) {
@@ -200,8 +211,8 @@ function sortNodes(nodes) {
   return Object.fromEntries(Object.entries(nodes).sort(([left], [right]) => left.localeCompare(right)));
 }
 function computeRevision(nodes) {
-  const hashes = Object.values(sortNodes(nodes)).map((node) => node.hash).join("");
-  return sha256(hashes);
+  const revisionSource = Object.entries(sortNodes(nodes)).map(([id, node]) => [id, node.hash, node.stable_id ?? "", node.identity_source ?? ""].join("|")).join("\n");
+  return sha256(revisionSource);
 }
 function writeStderr(message) {
   process.stderr.write(`${message}
@@ -225,6 +236,30 @@ function toPosixPath(path) {
 function sha256(content) {
   return `sha256:${createHash("sha256").update(content).digest("hex")}`;
 }
+function deriveRuleIdentity(file, source, existing) {
+  const declaredStableId = extractDeclaredStableId(source);
+  const derivedStableId = deriveAgentsMetaStableId(file);
+  if (declaredStableId !== void 0) {
+    return {
+      stableId: declaredStableId,
+      identitySource: "declared"
+    };
+  }
+  if (existing?.identity_source === "declared" && existing.stable_id !== void 0 && existing.stable_id !== derivedStableId) {
+    return {
+      stableId: existing.stable_id,
+      identitySource: "declared"
+    };
+  }
+  return {
+    stableId: derivedStableId,
+    identitySource: "derived"
+  };
+}
+function extractDeclaredStableId(source) {
+  const match = /^(?:\uFEFF)?<!--\s*fab:rule-id\s+([A-Za-z0-9][A-Za-z0-9/_-]*)\s*-->\s*(?:\r?\n|$)/u.exec(source);
+  return match?.[1];
+}
 
 export {
   syncMetaCommand,

package/dist/{doctor-QTSG2RWF.js → doctor-4BPYHV7V.js}

@@ -13,7 +13,7 @@ import {
 
 // src/commands/doctor.ts
 import { defineCommand } from "citty";
-import { runDoctorAuditReport, runDoctorReport } from "@fenglimg/fabric-server";
+import { runDoctorAuditReport, runDoctorFix, runDoctorReport } from "@fenglimg/fabric-server";
 var DEFAULT_AUDIT_WINDOW_MINUTES = 5;
 var doctorCommand = defineCommand({
   meta: {
@@ -30,6 +30,11 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.audit.description"),
       default: false
     },
+    fix: {
+      type: "boolean",
+      description: t("cli.doctor.args.fix.description"),
+      default: false
+    },
     "window-minutes": {
       type: "string",
       description: t("cli.doctor.args.window-minutes.description"),
@@ -39,7 +44,11 @@ var doctorCommand = defineCommand({
   async run({ args }) {
     const workspaceRoot = process.cwd();
     const resolution = resolveDevMode(args.target, workspaceRoot);
-    const report = await runDoctorReport(resolution.target);
+    const fixReport = args.fix ? await runDoctorFix(resolution.target) : null;
+    const report = fixReport?.report ?? await runDoctorReport(resolution.target);
+    if (fixReport !== null) {
+      writeStdout(fixReport.message);
+    }
     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}`);

package/dist/index.js

@@ -9,15 +9,15 @@ import { defineCommand, runMain } from "citty";
 // src/commands/index.ts
 var allCommands = {
   approve: () => import("./approve-YT4DEABS.js").then((module) => module.default),
-  init: () => import("./init-QPKI2QOW.js").then((module) => module.default),
+  init: () => import("./init-LBVOI2QI.js").then((module) => module.default),
   update: () => import("./update-M5M5PYKE.js").then((module) => module.default),
   scan: () => import("./scan-QH76LC7Z.js").then((module) => module.default),
   serve: () => import("./serve-4J2CQY25.js").then((module) => module.default),
-  doctor: () => import("./doctor-QTSG2RWF.js").then((module) => module.default),
-  "sync-meta": () => import("./sync-meta-LKVSO6TS.js").then((module) => module.default),
+  doctor: () => import("./doctor-4BPYHV7V.js").then((module) => module.default),
+  "sync-meta": () => import("./sync-meta-IZR2WLIL.js").then((module) => module.default),
   "human-lint": () => import("./human-lint-YSFOZHZ7.js").then((module) => module.default),
-  "ledger-append": () => import("./ledger-append-DULKJ6Q2.js").then((module) => module.default),
-  "pre-commit": () => import("./pre-commit-IK6SJOPT.js").then((module) => module.default),
+  "ledger-append": () => import("./ledger-append-3MDNR3GU.js").then((module) => module.default),
+  "pre-commit": () => import("./pre-commit-53ENJDRZ.js").then((module) => module.default),
   bootstrap: () => import("./bootstrap-VGL3AR26.js").then((module) => module.default),
   config: () => import("./config-EC5L2QNI.js").then((module) => module.configCmd),
   hooks: () => import("./hooks-ZSWVH2JD.js").then((module) => ({
@@ -33,7 +33,7 @@ var allCommands = {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "1.5.1",
+    version: "1.6.0",
     description: 'Initialize and manage Fabric projects. Use "fabric init" for one-shot setup.'
   },
   subCommands: allCommands

package/dist/{init-QPKI2QOW.js → init-LBVOI2QI.js}

@@ -1147,7 +1147,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "1.5.1" : "unknown";
+  return true ? "1.6.0" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -1375,6 +1375,7 @@ async function buildInitFabricPlan(target, options) {
   const fabricDir = join2(target, ".fabric");
   const bootstrapPath = join2(fabricDir, "bootstrap", "README.md");
   const forensicPath = join2(fabricDir, "forensic.json");
+  const taxonomyPath = join2(fabricDir, "INITIAL_TAXONOMY.md");
   const claudeSkillPath = join2(target, ".claude", "skills", "agents-md-init", "SKILL.md");
   const codexSkillPath = join2(target, ".agents", "skills", "fabric-init", "SKILL.md");
   const codexSessionStartHookPath = join2(target, ".codex", "hooks", "fabric-session-start.cjs");
@@ -1387,11 +1388,13 @@ async function buildInitFabricPlan(target, options) {
   const replaceFabricDir = shouldReplaceWritableDirectory(fabricDir, options);
   const bootstrapAction = planFreshPath(bootstrapPath, options);
   const metaAction = planFreshPath(metaPath, options);
+  const taxonomyAction = planFreshPath(taxonomyPath, options);
   const humanLockAction = planFreshPath(humanLockPath, options);
   const forensicAction = planFreshPath(forensicPath, options);
   const forensicReport = await buildForensicReport(target);
   const humanLockTemplate = readFileSync2(findTemplatePath("templates/fabric/human-lock.json"), "utf8");
   const bootstrapContent = await buildFabricBootstrapGuide(target);
+  const taxonomyContent = buildInitialTaxonomyMarkdown(forensicReport);
   const bootstrapHash = sha256(bootstrapContent);
   const meta = createInitialMeta(bootstrapHash);
   return {
@@ -1405,6 +1408,9 @@ async function buildInitFabricPlan(target, options) {
     metaPath,
     metaAction,
     meta,
+    taxonomyPath,
+    taxonomyAction,
+    taxonomyContent,
     humanLockPath,
     humanLockAction,
     humanLockContent: humanLockTemplate.endsWith("\n") ? humanLockTemplate : `${humanLockTemplate}
@@ -1447,6 +1453,8 @@ function executeInitFabricPlan(plan) {
   preparePlannedPath(plan.metaPath, plan.metaAction);
   writeFileSync(plan.metaPath, `${JSON.stringify(plan.meta, null, 2)}
 `, "utf8");
+  preparePlannedPath(plan.taxonomyPath, plan.taxonomyAction);
+  writeFileSync(plan.taxonomyPath, ensureTrailingNewline(plan.taxonomyContent), "utf8");
   preparePlannedPath(plan.humanLockPath, plan.humanLockAction);
   writeFileSync(plan.humanLockPath, plan.humanLockContent, "utf8");
   preparePlannedPath(plan.forensicPath, plan.forensicAction);
@@ -1464,6 +1472,8 @@ function executeInitFabricPlan(plan) {
     bootstrapAction: plan.bootstrapAction,
     metaPath: plan.metaPath,
     metaAction: plan.metaAction,
+    taxonomyPath: plan.taxonomyPath,
+    taxonomyAction: plan.taxonomyAction,
     humanLockPath: plan.humanLockPath,
     humanLockAction: plan.humanLockAction,
     forensicPath: plan.forensicPath,
@@ -1526,6 +1536,7 @@ function exhaustiveInitStagePlan(value) {
 function printInitScaffoldResult(created) {
   console.log(formatInitPathAction(created.bootstrapPath, created.bootstrapAction));
   console.log(formatInitPathAction(created.metaPath, created.metaAction));
+  console.log(formatInitPathAction(created.taxonomyPath, created.taxonomyAction));
   console.log(formatInitPathAction(created.humanLockPath, created.humanLockAction));
   console.log(formatInitPathAction(created.forensicPath, created.forensicAction));
   writeStderr(formatOptionalInitPathAction(created.claudeSkillPath, created.claudeSkillAction));
@@ -1576,6 +1587,8 @@ function buildPlanOnlyScaffoldResult(plan) {
     bootstrapAction: plan.bootstrapAction,
     metaPath: plan.metaPath,
     metaAction: plan.metaAction,
+    taxonomyPath: plan.taxonomyPath,
+    taxonomyAction: plan.taxonomyAction,
     humanLockPath: plan.humanLockPath,
     humanLockAction: plan.humanLockAction,
     forensicPath: plan.forensicPath,
@@ -2003,6 +2016,60 @@ function createInitialMeta(agentsHash) {
     }
   };
 }
+function buildInitialTaxonomyMarkdown(forensicReport) {
+  const frameworkInfo = forensicReport.framework;
+  const framework = [frameworkInfo?.kind ?? "unknown", frameworkInfo?.subkind ?? ""].filter((value) => value.trim() !== "").join(" / ") || "unknown";
+  const keyDirs = forensicReport.topology?.key_dirs?.slice(0, 8) ?? [];
+  const candidateFiles = forensicReport.candidate_files?.slice(0, 8) ?? [];
+  const generatedAt = forensicReport.generated_at ?? (/* @__PURE__ */ new Date()).toISOString();
+  return `# Fabric Initial Taxonomy
+
+**Date**: ${generatedAt}
+**Base Architecture**: L0/L1/L2 Tiered System
+**Detected Framework**: ${framework}
+
+## Origin Logic
+
+- **L0 \u5224\u5B9A**: \u5168\u5C40\u534F\u4F5C\u7A33\u5B9A\u6027\u89C4\u5219\u3002\u5178\u578B\u6765\u6E90\u5305\u62EC\u4ED3\u5E93\u6839\u914D\u7F6E\u3001package metadata\u3001Fabric \u5185\u90E8\u534F\u8BAE\u548C\u4E0D\u53EF\u968F\u5C40\u90E8\u4E1A\u52A1\u6F02\u79FB\u7684\u7EA6\u675F\u3002
+- **L1 \u5224\u5B9A**: \u9886\u57DF/\u6A21\u5757\u7EA7\u89C4\u5219\u3002\u4F9D\u636E\u6280\u672F\u6808\u3001\u76EE\u5F55\u804C\u8D23\u3001\u6846\u67B6\u7279\u5F81\u548C\u529F\u80FD\u6A21\u5757\u5212\u5206\uFF0C\u800C\u4E0D\u662F\u8DEF\u5F84\u6DF1\u5EA6\u3002
+- **L2 \u5224\u5B9A**: \u5177\u4F53\u811A\u672C\u3001\u8D44\u6E90\u6216\u5C40\u90E8\u4E1A\u52A1\u72B6\u6001\u89C4\u5219\u3002\u7528\u4E8E\u627F\u8F7D\u7279\u5B9A\u6587\u4EF6\u3001\u8D44\u6E90\u3001\u5386\u53F2\u8865\u4E01\u548C\u5C40\u90E8\u5904\u7406\u7EC6\u5219\u3002
+
+## Initial L1 Buckets
+
+${formatInitialL1Buckets(keyDirs)}
+
+## L2 Candidate Signals
+
+${formatInitialL2Signals(candidateFiles)}
+
+## Evolution Guide
+
+- \u6D89\u53CA\u5168\u4ED3\u534F\u4F5C\u7A33\u5B9A\u6027\u7684\u89C4\u5219\u8FDB\u5165 L0\u3002
+- \u6D89\u53CA\u6280\u672F\u9886\u57DF\u3001\u6846\u67B6\u6A21\u5757\u6216\u529F\u80FD\u6A21\u5757\u7684\u89C4\u5219\u8FDB\u5165 L1\u3002
+- \u6D89\u53CA\u5177\u4F53\u6587\u4EF6\u3001\u5177\u4F53\u8D44\u6E90\u6216\u5C40\u90E8\u4E1A\u52A1\u72B6\u6001\u7684\u89C4\u5219\u8FDB\u5165 L2\u3002
+- \u51B2\u7A81\u65F6\u6267\u884C\u89E3\u91CA\u56FA\u5B9A\u4E3A L2 > L1 > L0\uFF1B\u540C\u5C42\u5185\u624D\u4F7F\u7528 priority \u6392\u5E8F\u3002
+`;
+}
+function formatInitialL1Buckets(keyDirs) {
+  if (keyDirs.length === 0) {
+    return "- **L1-General**: \u521D\u59CB\u5316\u65F6\u672A\u68C0\u6D4B\u5230\u7A33\u5B9A\u76EE\u5F55\u8F74\u7EBF\uFF0C\u540E\u7EED\u4F9D\u636E\u6280\u672F\u6808\u548C\u6A21\u5757\u804C\u8D23\u6F14\u8FDB\u3002";
+  }
+  return keyDirs.map((dir) => `- **L1-${sanitizeTaxonomyLabel(dir)}**: \u6302\u8F7D\u4F9D\u636E\u2014\u2014forensic topology detected \`${dir}\`.`).join("\n");
+}
+function formatInitialL2Signals(candidateFiles) {
+  if (candidateFiles.length === 0) {
+    return "- \u6682\u672A\u8BC6\u522B\u660E\u786E L2 \u5019\u9009\u6587\u4EF6\u3002";
+  }
+  return candidateFiles.map((entry) => `- \`${entry.path}\`: ${entry.family} \u2014 ${entry.rationale}`).join("\n");
+}
+function sanitizeTaxonomyLabel(value) {
+  const sanitized = value.replaceAll("\\", "/").split("/").filter(Boolean).join("-").replace(/[^A-Za-z0-9_-]+/gu, "-").replace(/^-+|-+$/gu, "");
+  return sanitized === "" ? "General" : sanitized;
+}
+function ensureTrailingNewline(value) {
+  return value.endsWith("\n") ? value : `${value}
+`;
+}
 function findTemplatePath(relativePath) {
   const currentModuleDir = dirname(fileURLToPath(import.meta.url));
   const candidates = [

package/dist/{ledger-append-DULKJ6Q2.js → ledger-append-3MDNR3GU.js}

@@ -2,7 +2,7 @@
 import {
   ledgerAppendCommand,
   ledger_append_default
-} from "./chunk-N7EZORJZ.js";
+} from "./chunk-2YW5CJ32.js";
 import "./chunk-6ICJICVU.js";
 export {
   ledger_append_default as default,

package/dist/{pre-commit-IK6SJOPT.js → pre-commit-53ENJDRZ.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   sync_meta_default
-} from "./chunk-Q4LOVXML.js";
+} from "./chunk-KOAEIH72.js";
 import {
   human_lint_default
 } from "./chunk-L43IGJ6X.js";
 import {
   ledger_append_default
-} from "./chunk-N7EZORJZ.js";
+} from "./chunk-2YW5CJ32.js";
 import {
   resolveDevModeTarget
 } from "./chunk-AEOYCVBG.js";
@@ -24,6 +24,7 @@ import process from "process";
 import { agentsMetaSchema } from "@fenglimg/fabric-shared";
 import { defineCommand } from "citty";
 import { minimatch } from "minimatch";
+import { LEGACY_LEDGER_PATH, LEDGER_PATH } from "@fenglimg/fabric-server";
 async function runOrFail(name, cmd, args) {
   try {
     await cmd.run?.({ args });
@@ -59,7 +60,7 @@ function tryReadAgentsMeta(target) {
 function matchesFabricScope(stagedFiles, meta) {
   const scopeGlobs = Object.values(meta.nodes).filter((node) => node.file !== ".fabric/bootstrap/README.md" && node.file !== "AGENTS.md").map((node) => node.scope_glob);
   return stagedFiles.some(
-    (file) => file === ".fabric/bootstrap/README.md" || file === "AGENTS.md" || file === ".fabric/agents.meta.json" || file === ".fabric/human-lock.json" || file === ".intent-ledger.jsonl" || scopeGlobs.some((pattern) => minimatch(file, pattern, { dot: true }))
+    (file) => file === ".fabric/bootstrap/README.md" || file === "AGENTS.md" || file === ".fabric/agents.meta.json" || file === ".fabric/human-lock.json" || file === LEDGER_PATH || file === LEGACY_LEDGER_PATH || scopeGlobs.some((pattern) => minimatch(file, pattern, { dot: true }))
   );
 }
 var pre_commit_default = defineCommand({

package/dist/{sync-meta-LKVSO6TS.js → sync-meta-IZR2WLIL.js}

@@ -5,7 +5,7 @@ import {
   deriveTopologyType,
   syncMetaCommand,
   sync_meta_default
-} from "./chunk-Q4LOVXML.js";
+} from "./chunk-KOAEIH72.js";
 import "./chunk-6ICJICVU.js";
 export {
   computeAgentsMeta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -22,8 +22,8 @@
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "1.5.1",
-    "@fenglimg/fabric-shared": "1.5.1"
+    "@fenglimg/fabric-server": "1.6.0",
+    "@fenglimg/fabric-shared": "1.6.0"
   },
   "devDependencies": {
     "@types/iarna__toml": "^2.0.5",