@fenglimg/fabric-cli 1.3.0 → 1.3.1

package/dist/index.js

@@ -8,17 +8,17 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  init: () => import("./init-BZ73IUHH.js").then((module) => module.default),
-  update: () => import("./update-JZPUJ36D.js").then((module) => module.default),
-  scan: () => import("./scan-WKDSKEBB.js").then((module) => module.default),
-  serve: () => import("./serve-MMN4GYLM.js").then((module) => module.default),
-  doctor: () => import("./doctor-5KJGOV2P.js").then((module) => module.default),
-  "sync-meta": () => import("./sync-meta-THZSEM7Y.js").then((module) => module.default),
+  init: () => import("./init-T3LGMGAO.js").then((module) => module.default),
+  update: () => import("./update-AN3FYF2O.js").then((module) => module.default),
+  scan: () => import("./scan-43R3IBLR.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),
   "human-lint": () => import("./human-lint-YSFOZHZ7.js").then((module) => module.default),
-  "ledger-append": () => import("./ledger-append-XZ5SX4O5.js").then((module) => module.default),
-  "pre-commit": () => import("./pre-commit-AK55G73F.js").then((module) => module.default),
-  bootstrap: () => import("./bootstrap-IUL4SAAK.js").then((module) => module.default),
-  config: () => import("./config-MKWKDE32.js").then((module) => module.configCmd),
+  "ledger-append": () => import("./ledger-append-DULKJ6Q2.js").then((module) => module.default),
+  "pre-commit": () => import("./pre-commit-IK6SJOPT.js").then((module) => module.default),
+  bootstrap: () => import("./bootstrap-3PUKUYTY.js").then((module) => module.default),
+  config: () => import("./config-GINBGANU.js").then((module) => module.configCmd),
   hooks: () => import("./hooks-ZSWVH2JD.js").then((module) => ({
     ...module.default,
     meta: {
@@ -32,7 +32,7 @@ var allCommands = {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "1.3.0",
+    version: "1.3.1",
     description: 'Initialize and manage Fabric projects. Use "fabric init" for one-shot setup.'
   },
   subCommands: allCommands

package/dist/{init-BZ73IUHH.js → init-T3LGMGAO.js}

@@ -1,25 +1,29 @@
 #!/usr/bin/env node
 import {
+  buildFabricBootstrapGuide,
   installBootstrap
-} from "./chunk-RUQCZA2Q.js";
+} from "./chunk-TKTWHAKV.js";
 import {
-  createScanReport,
   detectFramework
-} from "./chunk-N4DCTOXW.js";
+} from "./chunk-AZRKMFRY.js";
 import {
   installMcpClients
-} from "./chunk-TO5RUB4R.js";
-import "./chunk-VMYPJPKV.js";
+} from "./chunk-XFSQM3LJ.js";
+import {
+  detectClientSupports
+} from "./chunk-VOQKQ6W2.js";
 import {
   installHooks
 } from "./chunk-YDZJRLHL.js";
-import {
-  paint
-} from "./chunk-WWNXR34K.js";
 import {
   createDebugLogger,
   resolveDevMode
 } from "./chunk-AEOYCVBG.js";
+import {
+  displayWidth,
+  padEnd,
+  paint
+} from "./chunk-WWNXR34K.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";
@@ -852,7 +856,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "1.3.0" : "unknown";
+  return true ? "1.3.1" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -862,11 +866,6 @@ function toPosixPath(path) {
 }
 
 // src/commands/init.ts
-var AGENTS_TEMPLATE_BY_FRAMEWORK = {
-  "cocos-creator": "templates/agents-md/variants/cocos.md",
-  vite: "templates/agents-md/variants/vite.md",
-  next: "templates/agents-md/variants/next.md"
-};
 var CLAUDE_INIT_SKILL_TEMPLATE = "templates/claude-skills/agents-md-init/SKILL.md";
 var CLAUDE_INIT_REMINDER_HOOK_TEMPLATE = "templates/claude-hooks/agents-md-init-reminder.cjs";
 var CLAUDE_INIT_REMINDER_COMMAND = ".claude/hooks/agents-md-init-reminder.cjs";
@@ -907,6 +906,11 @@ var initCommand = defineCommand({
       default: true,
       negativeDescription: t("cli.init.args.no-hooks.description")
     },
+    interactive: {
+      type: "boolean",
+      description: t("cli.init.args.interactive.description"),
+      default: true
+    },
     "mcp-install": {
       type: "string",
       default: "global",
@@ -928,11 +932,16 @@ var initCommand = defineCommand({
     for (const step of resolution.chain) {
       logger(step);
     }
+    const supports = detectClientSupports(target);
+    const interactive = args.interactive !== false && isInteractiveInit();
     if (options.force) {
       writeStderr(t("cli.init.force.warning", { path: target }));
     }
+    if (interactive) {
+      printInitPlanSummary(target, options, mcpInstallMode, supports);
+    }
     const created = initFabric(target, options);
-    console.log(formatInitPathAction(created.agentsPath, created.agentsAction));
+    console.log(formatInitPathAction(created.bootstrapPath, created.bootstrapAction));
     console.log(formatInitPathAction(created.metaPath, created.metaAction));
     console.log(formatInitPathAction(created.humanLockPath, created.humanLockAction));
     console.log(formatInitPathAction(created.forensicPath, created.forensicAction));
@@ -1020,37 +1029,37 @@ var initCommand = defineCommand({
     console.log(
       t("cli.init.reason-message", {
         label: reasonLabel(),
-        message: paint.muted(t("cli.init.reason-message.body"))
+        message: paint.muted(formatInitReasonMessage(supports))
       })
     );
     printInitStageSummary(stageResults);
+    printInitCapabilitySummary(supports, stageResults, options);
   }
 });
 var init_default = initCommand;
 function initFabric(target, options) {
   assertExistingDirectory2(target);
-  const agentsPath = join2(target, "AGENTS.md");
   const fabricDir = join2(target, ".fabric");
+  const bootstrapPath = join2(fabricDir, "bootstrap", "README.md");
   const forensicPath = join2(fabricDir, "forensic.json");
   const claudeSkillPath = join2(target, ".claude", "skills", "agents-md-init", "SKILL.md");
   const claudeHookPath = join2(target, ".claude", "hooks", "agents-md-init-reminder.cjs");
   const claudeSettingsPath = join2(target, ".claude", "settings.json");
-  const forensicGuardAction = prepareFreshPath(forensicPath, options);
-  const agentsAction = prepareFreshPath(agentsPath, options);
-  const fabricDirAction = prepareFreshPath(fabricDir, options);
-  const forensicAction = forensicGuardAction === "overwritten" || fabricDirAction === "overwritten" ? "overwritten" : "created";
-  const scanReport = createScanReport(target);
-  const forensicReport = buildForensicReport(target);
-  const template = readFileSync2(findAgentsTemplatePath(scanReport.framework.kind), "utf8");
-  const humanLockTemplate = readFileSync2(findTemplatePath("templates/fabric/human-lock.json"), "utf8");
-  const packageName = readPackageName(target) ?? parse(target).base;
-  const agentsContent = template.replaceAll("{ projectName }", packageName).replaceAll("{ frameworkKind }", scanReport.framework.kind);
-  const agentsHash = sha256(agentsContent);
-  const meta = createInitialMeta(agentsHash);
   const metaPath = join2(fabricDir, "agents.meta.json");
   const humanLockPath = join2(fabricDir, "human-lock.json");
-  mkdirSync(fabricDir, { recursive: false });
-  writeNewFile(agentsPath, agentsContent, options);
+  prepareWritableDirectory(fabricDir, options);
+  const bootstrapAction = prepareFreshPath(bootstrapPath, options);
+  const metaAction = prepareFreshPath(metaPath, options);
+  const humanLockAction = prepareFreshPath(humanLockPath, options);
+  const forensicAction = prepareFreshPath(forensicPath, options);
+  const forensicReport = buildForensicReport(target);
+  const humanLockTemplate = readFileSync2(findTemplatePath("templates/fabric/human-lock.json"), "utf8");
+  const bootstrapContent = buildFabricBootstrapGuide(target);
+  const bootstrapHash = sha256(bootstrapContent);
+  const meta = createInitialMeta(bootstrapHash);
+  mkdirSync(fabricDir, { recursive: true });
+  mkdirSync(dirname(bootstrapPath), { recursive: true });
+  writeNewFile(bootstrapPath, bootstrapContent, options);
   writeNewFile(metaPath, `${JSON.stringify(meta, null, 2)}
 `, options);
   writeNewFile(humanLockPath, humanLockTemplate.endsWith("\n") ? humanLockTemplate : `${humanLockTemplate}
@@ -1065,12 +1074,12 @@ function initFabric(target, options) {
   );
   const claudeSettingsAction = mergeClaudeStopHook(claudeSettingsPath, options);
   return {
-    agentsPath,
-    agentsAction,
+    bootstrapPath,
+    bootstrapAction,
     metaPath,
-    metaAction: fabricDirAction,
+    metaAction,
     humanLockPath,
-    humanLockAction: fabricDirAction,
+    humanLockAction,
     forensicPath,
     forensicAction,
     claudeSkillPath,
@@ -1081,10 +1090,6 @@ function initFabric(target, options) {
     claudeSettingsAction
   };
 }
-function findAgentsTemplatePath(frameworkKind) {
-  const relativePath = AGENTS_TEMPLATE_BY_FRAMEWORK[frameworkKind] ?? "templates/agents-md/AGENTS.md.template";
-  return findTemplatePath(relativePath);
-}
 function normalizeTarget2(targetInput) {
   return isAbsolute2(targetInput) ? targetInput : resolve2(process.cwd(), targetInput);
 }
@@ -1126,7 +1131,7 @@ function createInitialMeta(agentsHash) {
     revision: sha256(agentsHash),
     nodes: {
       L0: {
-        file: "AGENTS.md",
+        file: ".fabric/bootstrap/README.md",
         scope_glob: "**",
         deps: [],
         priority: "high",
@@ -1137,18 +1142,6 @@ function createInitialMeta(agentsHash) {
     }
   };
 }
-function readPackageName(target) {
-  const packageJsonPath = join2(target, "package.json");
-  if (!existsSync2(packageJsonPath)) {
-    return void 0;
-  }
-  try {
-    const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf8"));
-    return packageJson.name;
-  } catch {
-    return void 0;
-  }
-}
 function findTemplatePath(relativePath) {
   const currentModuleDir = dirname(fileURLToPath(import.meta.url));
   const candidates = [
@@ -1185,6 +1178,15 @@ function prepareFreshPath(path, options) {
   rmSync(path, { recursive: true, force: true });
   return "overwritten";
 }
+function prepareWritableDirectory(path, options) {
+  if (!existsSync2(path) || statSync2(path).isDirectory()) {
+    return;
+  }
+  if (!options?.force) {
+    throw new Error(t("cli.init.errors.abort-existing", { path }));
+  }
+  rmSync(path, { force: true });
+}
 function writeNewFile(path, content, options) {
   const existed = existsSync2(path);
   if (existed && !options?.force) {
@@ -1329,6 +1331,120 @@ function collectInitStageNames(stageResults, disposition) {
 function shouldPrintHooksNextStep(options, stageResults) {
   return Boolean(options.skipHooks) || stageResults.some((stage) => stage.name === "hooks" && stage.disposition === "failed");
 }
+function isInteractiveInit() {
+  return Boolean(process.stdout.isTTY) && Boolean(process.stderr.isTTY);
+}
+function printInitPlanSummary(target, options, mcpInstallMode, supports) {
+  console.log(t("cli.init.plan.title"));
+  console.log(t("cli.init.plan.target", { target }));
+  console.log(
+    t("cli.init.plan.actions", {
+      bootstrap: yesNoLabel(!options.skipBootstrap),
+      mcp: yesNoLabel(!options.skipMcp),
+      hooks: yesNoLabel(!options.skipHooks),
+      mcpInstall: mcpInstallMode
+    })
+  );
+  const detected = supports.filter((support) => support.detected);
+  console.log(
+    t("cli.init.plan.detected", {
+      clients: detected.length > 0 ? detected.map((support) => support.label).join(", ") : t("cli.shared.none")
+    })
+  );
+  console.log(t("cli.init.plan.writes"));
+  console.log(`  - ${target}/.fabric/bootstrap/README.md`);
+  console.log(`  - ${target}/.fabric/agents.meta.json`);
+  console.log(`  - ${target}/.fabric/human-lock.json`);
+  console.log(`  - ${target}/.fabric/forensic.json`);
+}
+function printInitCapabilitySummary(supports, stageResults, options) {
+  const detected = supports.filter((support) => support.detected);
+  if (detected.length === 0) {
+    console.log(t("cli.init.capabilities.none"));
+    return;
+  }
+  console.log(t("cli.init.capabilities.title"));
+  const rows = detected.map((support) => toCapabilityRow(support, stageResults, options));
+  const headers = {
+    client: t("cli.init.capabilities.header.client"),
+    bootstrap: t("cli.init.capabilities.header.bootstrap"),
+    mcp: t("cli.init.capabilities.header.mcp"),
+    hook: t("cli.init.capabilities.header.hook"),
+    skill: t("cli.init.capabilities.header.skill"),
+    followUp: t("cli.init.capabilities.header.follow-up")
+  };
+  const widths = {
+    client: Math.max(displayWidth(headers.client), ...rows.map((row) => displayWidth(row.client))),
+    bootstrap: Math.max(displayWidth(headers.bootstrap), ...rows.map((row) => displayWidth(row.bootstrap))),
+    mcp: Math.max(displayWidth(headers.mcp), ...rows.map((row) => displayWidth(row.mcp))),
+    hook: Math.max(displayWidth(headers.hook), ...rows.map((row) => displayWidth(row.hook))),
+    skill: Math.max(displayWidth(headers.skill), ...rows.map((row) => displayWidth(row.skill))),
+    followUp: Math.max(displayWidth(headers.followUp), ...rows.map((row) => displayWidth(row.followUp)))
+  };
+  console.log(formatCapabilityTableRow(headers, widths));
+  console.log(formatCapabilityDivider(widths));
+  for (const row of rows) {
+    console.log(formatCapabilityTableRow(row, widths));
+  }
+}
+function toCapabilityRow(support, stageResults, options) {
+  const stage = (name) => stageResults.find((entry) => entry.name === name)?.disposition ?? null;
+  const bootstrap = support.capabilities.bootstrap ? capabilityStatus(options.skipBootstrap ? "skipped" : stage("bootstrap")) : t("cli.init.capabilities.status.na");
+  const mcp = support.capabilities.mcp ? capabilityStatus(options.skipMcp ? "skipped" : stage("mcp")) : t("cli.init.capabilities.status.na");
+  const hook = support.capabilities.hook ? capabilityStatus("ran") : t("cli.init.capabilities.status.na");
+  const skill = support.capabilities.skill ? t("cli.init.capabilities.status.installed") : t("cli.init.capabilities.status.manual");
+  return {
+    client: support.label,
+    bootstrap,
+    mcp,
+    hook,
+    skill,
+    followUp: support.capabilities.skill ? t("cli.init.capabilities.follow-up.ready") : t("cli.init.capabilities.follow-up.manual")
+  };
+}
+function capabilityStatus(disposition) {
+  switch (disposition) {
+    case "ran":
+      return t("cli.init.capabilities.status.ready");
+    case "skipped":
+      return t("cli.init.capabilities.status.skipped");
+    case "failed":
+      return t("cli.init.capabilities.status.failed");
+    case null:
+      return t("cli.init.capabilities.status.na");
+    default:
+      return t("cli.init.capabilities.status.ready");
+  }
+}
+function formatCapabilityTableRow(row, widths) {
+  return [
+    padEnd(row.client, widths.client),
+    padEnd(row.bootstrap, widths.bootstrap),
+    padEnd(row.mcp, widths.mcp),
+    padEnd(row.hook, widths.hook),
+    padEnd(row.skill, widths.skill),
+    padEnd(row.followUp, widths.followUp)
+  ].join("  ");
+}
+function formatCapabilityDivider(widths) {
+  return [
+    "".padEnd(widths.client, "-"),
+    "".padEnd(widths.bootstrap, "-"),
+    "".padEnd(widths.mcp, "-"),
+    "".padEnd(widths.hook, "-"),
+    "".padEnd(widths.skill, "-"),
+    "".padEnd(widths.followUp, "-")
+  ].join("  ");
+}
+function formatInitReasonMessage(supports) {
+  if (supports.some((support) => support.detected && support.capabilities.skill)) {
+    return t("cli.init.reason-message.body");
+  }
+  return t("cli.init.reason-message.manual-body");
+}
+function yesNoLabel(value) {
+  return value ? t("cli.shared.yes") : t("cli.shared.no");
+}
 function formatInitPathAction(path, action) {
   return t("cli.init.created-path", { label: labelForInitWriteAction(action), path });
 }

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

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

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

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   sync_meta_default
-} from "./chunk-6UUPKSDE.js";
+} from "./chunk-Q4LOVXML.js";
 import {
   human_lint_default
 } from "./chunk-L43IGJ6X.js";
 import {
   ledger_append_default
-} from "./chunk-F2BXHPM5.js";
-import "./chunk-WWNXR34K.js";
+} from "./chunk-N7EZORJZ.js";
 import {
   resolveDevModeTarget
 } from "./chunk-AEOYCVBG.js";
+import "./chunk-WWNXR34K.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";
@@ -57,9 +57,9 @@ function tryReadAgentsMeta(target) {
   }
 }
 function matchesFabricScope(stagedFiles, meta) {
-  const scopeGlobs = Object.values(meta.nodes).filter((node) => node.file !== "AGENTS.md").map((node) => node.scope_glob);
+  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 === "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 === ".intent-ledger.jsonl" || scopeGlobs.some((pattern) => minimatch(file, pattern, { dot: true }))
   );
 }
 var pre_commit_default = defineCommand({

package/dist/{scan-WKDSKEBB.js → scan-43R3IBLR.js}

@@ -3,9 +3,9 @@ import {
   createScanReport,
   scanCommand,
   scan_default
-} from "./chunk-N4DCTOXW.js";
-import "./chunk-WWNXR34K.js";
+} from "./chunk-AZRKMFRY.js";
 import "./chunk-AEOYCVBG.js";
+import "./chunk-WWNXR34K.js";
 import "./chunk-6ICJICVU.js";
 export {
   createScanReport,

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

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

package/dist/{update-JZPUJ36D.js → update-AN3FYF2O.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   installMcpClients
-} from "./chunk-TO5RUB4R.js";
-import "./chunk-VMYPJPKV.js";
+} from "./chunk-XFSQM3LJ.js";
+import "./chunk-VOQKQ6W2.js";
 import {
   installHooks
 } from "./chunk-YDZJRLHL.js";
-import {
-  paint
-} from "./chunk-WWNXR34K.js";
 import {
   resolveDevModeTarget
 } from "./chunk-AEOYCVBG.js";
+import {
+  paint
+} from "./chunk-WWNXR34K.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -18,8 +18,8 @@
     "minimatch": "^10.0.1",
     "picocolors": "^1.1.1",
     "string-width": "^7.2.0",
-    "@fenglimg/fabric-server": "1.3.0",
-    "@fenglimg/fabric-shared": "1.3.0"
+    "@fenglimg/fabric-shared": "1.3.1",
+    "@fenglimg/fabric-server": "1.3.1"
   },
   "devDependencies": {
     "@types/iarna__toml": "^2.0.5",

package/templates/agents-md/AGENTS.md.template

@@ -1,19 +1,20 @@
-# { projectName } — Fabric Bootstrap Protocol
-
-## CORE RULES (DO NOT TRANSLATE)
-
-MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
-MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
-MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
-MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
-MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
-NEVER: Add import-style directive lines to this bootstrap file.
-NEVER: Put framework, domain, repository rule bodies, or submodule rules in this file.
-NEVER: Create colocated `AGENTS.md` rule files under source directories.
-
+# { projectName } — Fabric Bootstrap Protocol
+
+## CORE RULES (DO NOT TRANSLATE)
+
+MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
+MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
+MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
+MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
+MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
+NEVER: Add import-style directive lines to this bootstrap file.
+NEVER: Put framework, domain, repository rule bodies, or submodule rules in this file.
+NEVER: Create colocated `AGENTS.md` rule files under source directories.
+
 ## 使用说明 / Explanation
 
 - 本文件只负责启动 Fabric Bootstrap Protocol，不承载项目业务规则。
+- 详细 bootstrap 说明位于 `.fabric/bootstrap/README.md`。
 - Detected framework kind: `{ frameworkKind }`.
 - This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
 - 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。

package/templates/agents-md/variants/cocos.md

@@ -1,20 +1,20 @@
-# { projectName } — Fabric Bootstrap Protocol
-
-## CORE RULES (DO NOT TRANSLATE)
-
-MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
-MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
-MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
-MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
-MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
-NEVER: Add import-style directive lines to this bootstrap file.
-NEVER: Put Cocos, asset, prefab, scene, repository rule bodies, or submodule rules in this file.
-NEVER: Create colocated `AGENTS.md` rule files under source directories.
-
-## 使用说明 / Explanation
-
-- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Cocos 业务或编辑器规则。
-- Detected framework kind: `cocos-creator`.
-- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
-- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
-- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.
+# { projectName } — Fabric Bootstrap Protocol
+
+## CORE RULES (DO NOT TRANSLATE)
+
+MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
+MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
+MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
+MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
+MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
+NEVER: Add import-style directive lines to this bootstrap file.
+NEVER: Put Cocos, asset, prefab, scene, repository rule bodies, or submodule rules in this file.
+NEVER: Create colocated `AGENTS.md` rule files under source directories.
+
+## 使用说明 / Explanation
+
+- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Cocos 业务或编辑器规则。
+- Detected framework kind: `cocos-creator`.
+- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
+- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
+- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.

package/templates/agents-md/variants/next.md

@@ -1,20 +1,20 @@
-# { projectName } — Fabric Bootstrap Protocol
-
-## CORE RULES (DO NOT TRANSLATE)
-
-MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
-MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
-MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
-MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
-MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
-NEVER: Add import-style directive lines to this bootstrap file.
-NEVER: Put Next.js, route, repository rule bodies, or submodule rules in this file.
-NEVER: Create colocated `AGENTS.md` rule files under source directories.
-
-## 使用说明 / Explanation
-
-- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Next.js 业务或路由规则。
-- Detected framework kind: `next`.
-- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
-- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
-- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.
+# { projectName } — Fabric Bootstrap Protocol
+
+## CORE RULES (DO NOT TRANSLATE)
+
+MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
+MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
+MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
+MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
+MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
+NEVER: Add import-style directive lines to this bootstrap file.
+NEVER: Put Next.js, route, repository rule bodies, or submodule rules in this file.
+NEVER: Create colocated `AGENTS.md` rule files under source directories.
+
+## 使用说明 / Explanation
+
+- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Next.js 业务或路由规则。
+- Detected framework kind: `next`.
+- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
+- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
+- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.

package/templates/agents-md/variants/vite.md

@@ -1,20 +1,20 @@
-# { projectName } — Fabric Bootstrap Protocol
-
-## CORE RULES (DO NOT TRANSLATE)
-
-MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
-MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
-MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
-MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
-MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
-NEVER: Add import-style directive lines to this bootstrap file.
-NEVER: Put Vite, browser, repository rule bodies, or submodule rules in this file.
-NEVER: Create colocated `AGENTS.md` rule files under source directories.
-
-## 使用说明 / Explanation
-
-- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Vite 业务或浏览器规则。
-- Detected framework kind: `vite`.
-- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
-- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
-- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.
+# { projectName } — Fabric Bootstrap Protocol
+
+## CORE RULES (DO NOT TRANSLATE)
+
+MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
+MUST: Treat `.fabric/agents/` as the authoritative home for all AI shadow constraints.
+MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_get_rules(path=<target file>)`.
+MUST: When creating or changing an L1/L2 rule node, keep `.fabric/agents.meta.json` synchronized through Fabric tooling.
+MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/agents/`, `.fabric/agents.meta.json`, `fab_get_rules`, `shadow constraints`, `Shadow Mirroring`, `MUST`, `NEVER`.
+NEVER: Add import-style directive lines to this bootstrap file.
+NEVER: Put Vite, browser, repository rule bodies, or submodule rules in this file.
+NEVER: Create colocated `AGENTS.md` rule files under source directories.
+
+## 使用说明 / Explanation
+
+- 本文件只负责启动 Fabric Bootstrap Protocol，不承载 Vite 业务或浏览器规则。
+- Detected framework kind: `vite`.
+- This repository uses `Shadow Mirroring`: source directories contain ZERO rule files, while `.fabric/agents/` mirrors source paths for AI constraints.
+- 根级规则应放在 `.fabric/agents/root.md`；跨领域规则应放在 `.fabric/agents/_cross/`。
+- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.

package/templates/bootstrap/CLAUDE.md

@@ -1,8 +1,6 @@
 # Fabric Bootstrap
-- 本项目使用 Fabric Protocol 管理规则。
-- **任何文件修改前**，必须调 MCP tool `fab_get_rules(path=<被改文件>)` 获取规则。
-- 新建 L1/L2 节点时，必须调 `fab_update_registry`，**严禁**直接编辑 `.fabric/agents.meta.json`。
-- 涉及 @HUMAN 段（`.fabric/human-lock.json` 中列出）时，必须停下来请示人类。
-- 每次完整任务结束，调 `fab_append_intent` 写一条意图记录。
+- 主说明文档已收敛到 `.fabric/bootstrap/README.md`。
+- 项目级 bootstrap 入口仍然是 `AGENTS.md`。
+- 修改任何文件前必须调用 `fab_get_rules(path=<被改文件>)`。
 
 @AGENTS.md