@fenglimg/fabric-cli 1.5.0 → 1.6.0

package/README.md

@@ -1,19 +1,19 @@
 # @fenglimg/fabric-cli
 
-`fabric` is the primary CLI binary for Fabric. `fab` is a permanent alias, so you can use either binary.
+`fabric` 是 Fabric 的主命令，`fab` 是永久别名，两者等价。
 
-## Quick Start
-
-1. Install dependencies from the monorepo root with `pnpm install`.
-2. Build the CLI with `pnpm --filter @fenglimg/fabric-cli build`.
-3. Run `fabric init` in the target project for the one-shot setup flow.
-4. Start `fabric serve` and verify `fab_get_rules` in your client.
-
-`fabric init` auto-runs `bootstrap install`, `config install`, and `hooks install`. Use them standalone only for targeted re-runs.
+## 快速开始
+
+1. 在 monorepo 根目录运行 `pnpm install`。
+2. 用 `pnpm --filter @fenglimg/fabric-cli build` 构建 CLI。
+3. 在目标项目运行 `fabric init`，完成一站式初始化。
+4. 启动 `fabric serve`，再去客户端里验证 `fab_get_rules`。
+
+`fabric init` 会自动执行 `bootstrap install`、`config install` 和 `hooks install`。只有在需要单独重跑某个阶段时，才需要单独调用它们。
 
-`fabric bootstrap install` refreshes the internal bootstrap guide at `.fabric/bootstrap/README.md`. It does not generate root `AGENTS.md`, `CLAUDE.md`, or `GEMINI.md`.
+`fabric bootstrap install` 只会刷新 `.fabric/bootstrap/README.md` 里的内部初始化说明，不会再生成根级 `AGENTS.md`、`CLAUDE.md` 或 `GEMINI.md`。
 
-## Common Commands
+## 常用命令
 
 - `fabric init`
 - `fabric serve`
@@ -21,10 +21,10 @@
 - `fabric approve --interactive`
 - `fabric approve --all`
 
-## Advanced Commands
+## 进阶命令
 
 - `fabric bootstrap install`
 - `fabric config install`
 - `fabric hooks install`
 
-`fabric approve` updates drifted entries in `.fabric/human-lock.json` after review. Use `--interactive` for per-entry confirmation and `--all` only when drift has already been reviewed elsewhere.
+`fabric approve` 会在审查完成后更新 `.fabric/human-lock.json` 中已经发生漂移的条目。需要逐项确认时使用 `--interactive`，只有在别处已经完成审查时才使用 `--all`。

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-YR7EVBYQ.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.0",
+    version: "1.6.0",
     description: 'Initialize and manage Fabric projects. Use "fabric init" for one-shot setup.'
   },
   subCommands: allCommands

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

@@ -1147,7 +1147,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "1.5.0" : "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.0",
+  "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.0",
-    "@fenglimg/fabric-shared": "1.5.0"
+    "@fenglimg/fabric-server": "1.6.0",
+    "@fenglimg/fabric-shared": "1.6.0"
   },
   "devDependencies": {
     "@types/iarna__toml": "^2.0.5",

package/templates/codex-hooks/fabric-session-start.cjs

@@ -13,7 +13,7 @@ process.stdout.write(
   JSON.stringify({
     hookSpecificOutput: {
       additionalContext:
-        "Fabric initialization is still pending in this repository. Read .fabric/forensic.json, .fabric/bootstrap/README.md, and use the repo skill at .agents/skills/fabric-init/SKILL.md before proceeding. If Codex hooks are not firing, ensure features.codex_hooks = true is enabled in your Codex config.",
+        "这个仓库的 Fabric 初始化还没完成。继续操作前，请先查看 .fabric/forensic.json 和 .fabric/bootstrap/README.md，并使用仓库内的 .agents/skills/fabric-init/SKILL.md。若 Codex hooks 没有触发，请确认配置里已启用 features.codex_hooks = true。",
     },
   }),
 );

package/templates/codex-hooks/fabric-stop-reminder.cjs

@@ -13,6 +13,6 @@ process.stdout.write(
   JSON.stringify({
     decision: "block",
     reason:
-      "fab init has collected Fabric evidence, but initialization follow-up is still pending. Ensure features.codex_hooks = true is enabled, then use the repo skill at .agents/skills/fabric-init/SKILL.md and review .fabric/forensic.json plus .fabric/bootstrap/README.md before continuing.",
+      "fab init 已经收集完当前仓库的初始化依据，但后续初始化还没完成。请先确认 Codex 已启用 features.codex_hooks = true，然后查看 .fabric/forensic.json 和 .fabric/bootstrap/README.md，并使用仓库内的 .agents/skills/fabric-init/SKILL.md 继续初始化。",
   }),
 );

package/templates/codex-skills/fabric-init/SKILL.md

@@ -1,27 +1,27 @@
 ---
 name: fabric-init
-description: Use this skill when `.fabric/forensic.json` exists and Fabric initialization follow-up still needs to be completed for this repository.
+description: Use this skill when `.fabric/forensic.json` exists and this repository still needs the remaining Fabric initialization steps.
 ---
 
-## Hard Rules (DO NOT TRANSLATE)
+## Hard Rules (不要翻译受保护 token)
 
-MUST: Read `.fabric/forensic.json` before taking any other action.
-MUST: Treat `.fabric/bootstrap/README.md` as the current bootstrap contract for this repository.
-MUST: If `.fabric/init-context.json` already exists, stop and report that initialization follow-up appears complete.
-MUST: Use evidence from `.fabric/forensic.json` and the repository layout to guide the initialization follow-up.
+MUST: 先读取 `.fabric/forensic.json`，再做其他动作。
+MUST: 把 `.fabric/bootstrap/README.md` 视为当前仓库的初始化说明。
+MUST: 如果 `.fabric/init-context.json` 已存在，立即停止并报告当前仓库看起来已经完成后续初始化。
+MUST: 使用 `.fabric/forensic.json` 和仓库结构中的依据，判断接下来该做什么。
 MUST: Preserve protected tokens exactly: `AGENTS.md`, `FABRIC.md`, `.fabric/agents.meta.json`, `.fabric/human-lock.json`, `.fabric/init-context.json`, `.fabric/forensic.json`, `MUST`, `NEVER`.
-NEVER: Claim initialization is complete without checking `.fabric/init-context.json`.
-NEVER: Rewrite or translate protected tokens.
-NEVER: ignore `.fabric/bootstrap/README.md` while deciding next initialization steps.
+NEVER: 在没有检查 `.fabric/init-context.json` 的情况下声称初始化已经完成。
+NEVER: 改写或翻译受保护 token。
+NEVER: 在判断下一步初始化动作时忽略 `.fabric/bootstrap/README.md`。
 
 ## Purpose
 
-Use this skill after `fab init` when Codex is working inside the repository and Fabric's evidence pack already exists. The goal is to continue the repository-specific initialization workflow using the generated forensic evidence and bootstrap contract.
+当你在 Codex 中处理这个仓库，并且 `fab init` 已经生成 `.fabric/forensic.json` 时，使用这个 skill 继续完成仓库专属的 Fabric 初始化。目标是基于当前仓库的初始化依据和内部说明，明确下一步该做什么，而不是重新解释一遍通用流程。
 
 ## Workflow
 
-1. Read `.fabric/forensic.json`.
-2. Read `.fabric/bootstrap/README.md`.
-3. Check whether `.fabric/init-context.json` exists.
-4. If initialization is still pending, summarize the next repository-specific initialization actions Codex should take.
-5. Keep the guidance tightly scoped to Fabric initialization follow-up for this repository.
+1. 读取 `.fabric/forensic.json`。
+2. 读取 `.fabric/bootstrap/README.md`。
+3. 检查 `.fabric/init-context.json` 是否已经存在。
+4. 如果初始化仍未完成，明确总结当前仓库接下来要做的初始化动作。
+5. 只讨论这个仓库的后续初始化，不扩展到无关建议。