@fenglimg/fabric-cli 0.1.2 → 0.1.4

package/dist/{bootstrap-BBFPEJQP.js → bootstrap-HUDJ2E3Q.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveClients
-} from "./chunk-3FZPYATY.js";
+} from "./chunk-N7TTCGJA.js";
 import {
   readFabricConfig
 } from "./chunk-AEOYCVBG.js";
@@ -50,18 +50,18 @@ var CLIENT_TARGET_MAP = {
 var bootstrapCommand = defineCommand({
   meta: {
     name: "bootstrap",
-    description: "Install Fabric bootstrap prompt templates for supported AI clients."
+    description: "\u4E3A\u652F\u6301\u7684 AI \u5BA2\u6237\u7AEF\u5B89\u88C5 Fabric \u5F15\u5BFC\u63D0\u793A\u6A21\u677F\u3002"
   },
   subCommands: {
     install: defineCommand({
       meta: {
         name: "install",
-        description: "Copy Fabric bootstrap templates into client-native locations."
+        description: "\u5C06 Fabric \u5F15\u5BFC\u6A21\u677F\u590D\u5236\u5230\u5404\u5BA2\u6237\u7AEF\u7684\u539F\u751F\u4F4D\u7F6E\u3002"
       },
       args: {
         clients: {
           type: "string",
-          description: "Optional comma-separated client filter, e.g. claude,cursor,codex."
+          description: "\u53EF\u9009\u7684\u9017\u53F7\u5206\u9694\u5BA2\u6237\u7AEF\u8FC7\u6EE4\u5668\uFF0C\u4F8B\u5982 claude,cursor,codex\u3002"
         }
       },
       async run({ args }) {

package/dist/{chunk-SC4A43WR.js → chunk-BWZHNZG6.js}

@@ -101,21 +101,21 @@ function createScanReport(targetInput = process.cwd(), fabricConfig) {
 var scanCommand = defineCommand({
   meta: {
     name: "scan",
-    description: "Scan a project for Fabric bootstrap candidates."
+    description: "\u626B\u63CF\u9879\u76EE\u4EE5\u68C0\u6D4B Fabric \u5F15\u5BFC\u5019\u9009\u6A21\u5757\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Absolute target path to scan. Defaults to CLI target, EXTERNAL_FIXTURE_PATH, fabric.config.json, or cwd."
+      description: "\u626B\u63CF\u7684\u76EE\u6807\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json \u6216\u5F53\u524D\u76EE\u5F55\u3002"
     },
     debug: {
       type: "boolean",
-      description: "Print detector evidence in pretty output.",
+      description: "\u4EE5\u683C\u5F0F\u5316\u8F93\u51FA\u6253\u5370\u68C0\u6D4B\u8BC1\u636E\u3002",
       default: false
     },
     json: {
       type: "boolean",
-      description: "Print the diagnostic report as JSON.",
+      description: "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u8BCA\u65AD\u62A5\u544A\u3002",
       default: false
     }
   },

package/dist/{chunk-YHIKLBTB.js → chunk-CZ7U6ULM.js}

@@ -9,12 +9,12 @@ import { defineCommand } from "citty";
 var humanLintCommand = defineCommand({
   meta: {
     name: "human-lint",
-    description: "Validate locked human sections."
+    description: "\u9A8C\u8BC1\u9501\u5B9A\u7684\u4EBA\u5DE5\u7F16\u8F91\u533A\u5757\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",
       default: process.cwd()
     }
   },

package/dist/{chunk-3FZPYATY.js → chunk-N7TTCGJA.js}

@@ -89,9 +89,15 @@ var ClaudeCodeCLIWriter = class extends JsonClientConfigWriter {
   constructor(configuredPath) {
     super(configuredPath);
   }
-  defaultPath() {
-    const claudeDir = join(homedir(), ".claude");
-    return existsSync(claudeDir) ? join(claudeDir, "settings.json") : null;
+  // Writes to project-level .claude/settings.json so MCP is scoped to the project.
+  // Detection in resolver still checks ~/ to confirm Claude Code is installed.
+  defaultPath(workspaceRoot) {
+    const globalClaudeDir = join(homedir(), ".claude");
+    const projectClaudeDir = join(workspaceRoot, ".claude");
+    if (!existsSync(globalClaudeDir) && !existsSync(projectClaudeDir)) {
+      return null;
+    }
+    return join(projectClaudeDir, "settings.json");
   }
 };
 var CursorWriter = class extends JsonClientConfigWriter {
@@ -247,7 +253,7 @@ function resolveClients(workspaceRoot, fabricConfig = {}) {
   const writers = [];
   addIfDetected(
     writers,
-    existsSync4(join4(homedir4(), ".claude")),
+    existsSync4(join4(homedir4(), ".claude")) || existsSync4(join4(workspaceRoot, ".claude")),
     (configuredPath) => new ClaudeCodeCLIWriter(configuredPath),
     hasExplicitPath(clientPaths, "claudeCodeCLI") ? clientPaths.claudeCodeCLI : void 0
   );

package/dist/{chunk-ZW4M4WZB.js → chunk-T3WQUWW4.js}

@@ -11,17 +11,17 @@ import { defineCommand } from "citty";
 var syncMetaCommand = defineCommand({
   meta: {
     name: "sync-meta",
-    description: "Sync Fabric metadata from AGENTS.md files."
+    description: "\u4ECE AGENTS.md \u6587\u4EF6\u540C\u6B65 Fabric \u5143\u6570\u636E\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",
       default: process.cwd()
     },
     "check-only": {
       type: "boolean",
-      description: "Exit with code 1 if .fabric/agents.meta.json is stale.",
+      description: "\u5982\u679C .fabric/agents.meta.json \u5DF2\u8FC7\u671F\u5219\u4EE5\u4EE3\u7801 1 \u9000\u51FA\u3002",
       default: false
     }
   },

package/dist/{chunk-PJ4J4377.js → chunk-U376IPKT.js}

@@ -10,17 +10,17 @@ var INITIAL_PARENT_SHA = "root";
 var ledgerAppendCommand = defineCommand({
   meta: {
     name: "ledger-append",
-    description: "Append a Fabric intent ledger entry."
+    description: "\u5411 Fabric \u610F\u56FE\u65E5\u5FD7\u6DFB\u52A0\u4E00\u6761\u8BB0\u5F55\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",
       default: process.cwd()
     },
     staged: {
       type: "boolean",
-      description: "Derive the entry from staged changes for pre-commit.",
+      description: "\u4ECE\u6682\u5B58\u53D8\u66F4\u4E2D\u63A8\u5BFC\u8BB0\u5F55\uFF08\u7528\u4E8E pre-commit \u9636\u6BB5\uFF09\u3002",
       default: false
     }
   },

package/dist/{config-TNY6BCQ2.js → config-YKDWIRCT.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveClients
-} from "./chunk-3FZPYATY.js";
+} from "./chunk-N7TTCGJA.js";
 
 // src/commands/config.ts
 import { existsSync } from "fs";
@@ -65,22 +65,22 @@ function writeStderr(message) {
 var configCmd = defineCommand({
   meta: {
     name: "config",
-    description: "Manage Fabric MCP client configuration."
+    description: "\u7BA1\u7406 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002"
   },
   subCommands: {
     install: defineCommand({
       meta: {
         name: "install",
-        description: "Install Fabric MCP server entries into detected client configs."
+        description: "\u5C06 Fabric MCP \u670D\u52A1\u5668\u6761\u76EE\u5B89\u88C5\u5230\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u914D\u7F6E\u4E2D\u3002"
       },
       args: {
         clients: {
           type: "string",
-          description: "Optional comma-separated client filter, e.g. cursor,codex,gemini."
+          description: "\u53EF\u9009\u7684\u9017\u53F7\u5206\u9694\u5BA2\u6237\u7AEF\u8FC7\u6EE4\u5668\uFF0C\u4F8B\u5982 cursor,codex,gemini\u3002"
         },
         "dry-run": {
           type: "boolean",
-          description: "Print detected writes without changing files.",
+          description: "\u9884\u89C8\u68C0\u6D4B\u5230\u7684\u5199\u5165\u64CD\u4F5C\uFF0C\u4E0D\u4FEE\u6539\u6587\u4EF6\u3002",
           default: false
         }
       },
@@ -93,7 +93,7 @@ var configCmd = defineCommand({
           (writer) => selectedClients === null ? true : selectedClients.has(writer.clientKind)
         );
         if (writers.length === 0) {
-          writeStderr("No Fabric MCP client configs detected. Create a client directory or set fabric.config.json clientPaths.");
+          writeStderr("\u672A\u68C0\u6D4B\u5230 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002\u8BF7\u521B\u5EFA\u5BA2\u6237\u7AEF\u76EE\u5F55\u6216\u5728 fabric.config.json \u4E2D\u8BBE\u7F6E clientPaths\u3002");
           return;
         }
         for (const writer of writers) {

package/dist/{hooks-QWVCECWF.js → hooks-VXXO4VZP.js}

@@ -8,18 +8,18 @@ import { defineCommand } from "citty";
 var hooksCommand = defineCommand({
   meta: {
     name: "hooks",
-    description: "Manage Fabric git hook templates."
+    description: "\u7BA1\u7406 Fabric Git \u94A9\u5B50\u6A21\u677F\u3002"
   },
   subCommands: {
     install: defineCommand({
       meta: {
         name: "install",
-        description: "Install the Fabric Husky pre-commit hook template."
+        description: "\u5B89\u88C5 Fabric Husky pre-commit \u94A9\u5B50\u6A21\u677F\u3002"
       },
       args: {
         target: {
           type: "string",
-          description: "Target project path. Defaults to the current working directory.",
+          description: "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",
           default: process.cwd()
         }
       },
@@ -33,7 +33,23 @@ var hooksCommand = defineCommand({
           throw new Error(`package.json is required to install hooks: ${packageJsonPath}`);
         }
         mkdirSync(huskyDir, { recursive: true });
-        writeFileSync(hookPath, readFileSync(findTemplatePath("templates/husky/pre-commit"), "utf8"), "utf8");
+        const templateContent = readFileSync(findTemplatePath("templates/husky/pre-commit"), "utf8");
+        let hookAction;
+        if (existsSync(hookPath)) {
+          const existing = readFileSync(hookPath, "utf8");
+          if (existing.includes("FAB_BIN=")) {
+            hookAction = "skipped";
+          } else {
+            const fabricBlock = templateContent.replace(/^#!\/bin\/sh\n/, "");
+            const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+            writeFileSync(hookPath, `${existing}${separator}# --- Fabric ---
+${fabricBlock}`, "utf8");
+            hookAction = "appended";
+          }
+        } else {
+          writeFileSync(hookPath, templateContent, "utf8");
+          hookAction = "created";
+        }
         chmodSync(hookPath, 493);
         const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
         const scripts = packageJson.scripts && typeof packageJson.scripts === "object" && !Array.isArray(packageJson.scripts) ? packageJson.scripts : {};
@@ -44,7 +60,13 @@ var hooksCommand = defineCommand({
           writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
 `, "utf8");
         }
-        writeStderr(`Installed ${hookPath}`);
+        if (hookAction === "skipped") {
+          writeStderr(`Fabric hook already present in ${hookPath}, skipped.`);
+        } else if (hookAction === "appended") {
+          writeStderr(`Appended Fabric hook to existing ${hookPath}`);
+        } else {
+          writeStderr(`Created ${hookPath}`);
+        }
         if (hadPrepare) {
           writeStderr(`Left existing prepare script unchanged in ${packageJsonPath}`);
         } else {

package/dist/{human-lint-SV4D5LQ7.js → human-lint-II6TBGP4.js}

@@ -2,7 +2,7 @@
 import {
   humanLintCommand,
   human_lint_default
-} from "./chunk-YHIKLBTB.js";
+} from "./chunk-CZ7U6ULM.js";
 export {
   human_lint_default as default,
   humanLintCommand

package/dist/index.js

@@ -8,23 +8,23 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  bootstrap: () => import("./bootstrap-BBFPEJQP.js").then((module) => module.default),
-  init: () => import("./init-VR43EQRO.js").then((module) => module.default),
-  scan: () => import("./scan-COKVYPOH.js").then((module) => module.default),
-  "sync-meta": () => import("./sync-meta-YIB7IBHK.js").then((module) => module.default),
-  "human-lint": () => import("./human-lint-SV4D5LQ7.js").then((module) => module.default),
-  "ledger-append": () => import("./ledger-append-KYPMIAM4.js").then((module) => module.default),
-  hooks: () => import("./hooks-QWVCECWF.js").then((module) => module.default),
-  config: () => import("./config-TNY6BCQ2.js").then((module) => module.configCmd),
-  "pre-commit": () => import("./pre-commit-ICTZBF6F.js").then((module) => module.default)
+  bootstrap: () => import("./bootstrap-HUDJ2E3Q.js").then((module) => module.default),
+  init: () => import("./init-IBS7KO7A.js").then((module) => module.default),
+  scan: () => import("./scan-UASZQLQP.js").then((module) => module.default),
+  "sync-meta": () => import("./sync-meta-YTG5V3Y6.js").then((module) => module.default),
+  "human-lint": () => import("./human-lint-II6TBGP4.js").then((module) => module.default),
+  "ledger-append": () => import("./ledger-append-EGIKSMU5.js").then((module) => module.default),
+  hooks: () => import("./hooks-VXXO4VZP.js").then((module) => module.default),
+  config: () => import("./config-YKDWIRCT.js").then((module) => module.configCmd),
+  "pre-commit": () => import("./pre-commit-CXPH7BZH.js").then((module) => module.default)
 };
 
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fab",
-    version: "0.0.0",
-    description: "Fabric CLI"
+    version: "0.1.4",
+    description: "Fabric CLI - AI \u667A\u80FD\u4F53\u534F\u4F5C\u6846\u67B6"
   },
   subCommands: allCommands
 });

package/dist/{init-VR43EQRO.js → init-IBS7KO7A.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createScanReport
-} from "./chunk-SC4A43WR.js";
+} from "./chunk-BWZHNZG6.js";
 import {
   createDebugLogger,
   resolveDevMode
@@ -17,16 +17,16 @@ import { defineCommand } from "citty";
 var initCommand = defineCommand({
   meta: {
     name: "init",
-    description: "Initialize Fabric in a target project."
+    description: "\u5728\u76EE\u6807\u9879\u76EE\u4E2D\u521D\u59CB\u5316 Fabric\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to CLI target, EXTERNAL_FIXTURE_PATH, fabric.config.json, or cwd."
+      description: "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json \u6216\u5F53\u524D\u76EE\u5F55\u3002"
     },
     debug: {
       type: "boolean",
-      description: "Print target resolution details to stderr.",
+      description: "\u5C06\u76EE\u6807\u89E3\u6790\u8BE6\u60C5\u8F93\u51FA\u5230 stderr\u3002",
       default: false
     }
   },

package/dist/{ledger-append-KYPMIAM4.js → ledger-append-EGIKSMU5.js}

@@ -2,7 +2,7 @@
 import {
   ledgerAppendCommand,
   ledger_append_default
-} from "./chunk-PJ4J4377.js";
+} from "./chunk-U376IPKT.js";
 export {
   ledger_append_default as default,
   ledgerAppendCommand

package/dist/{pre-commit-ICTZBF6F.js → pre-commit-CXPH7BZH.js}

@@ -4,14 +4,14 @@ import {
 } from "./chunk-AEOYCVBG.js";
 import {
   sync_meta_default
-} from "./chunk-ZW4M4WZB.js";
+} from "./chunk-T3WQUWW4.js";
 import "./chunk-P4KVFB2T.js";
 import {
   human_lint_default
-} from "./chunk-YHIKLBTB.js";
+} from "./chunk-CZ7U6ULM.js";
 import {
   ledger_append_default
-} from "./chunk-PJ4J4377.js";
+} from "./chunk-U376IPKT.js";
 
 // src/commands/pre-commit.ts
 import { defineCommand } from "citty";
@@ -28,12 +28,12 @@ async function runOrFail(name, cmd, args) {
 var pre_commit_default = defineCommand({
   meta: {
     name: "pre-commit",
-    description: "Composite pre-commit hook \u2014 runs sync-meta --check-only, human-lint, ledger-append --staged in a single Node process for <300ms budget."
+    description: "\u590D\u5408 pre-commit \u94A9\u5B50 \u2014\u2014 \u5728\u5355\u4E00 Node \u8FDB\u7A0B\u4E2D\u4F9D\u6B21\u6267\u884C sync-meta --check-only\u3001human-lint\u3001ledger-append --staged\uFF0C300ms \u5185\u5B8C\u6210\u3002"
   },
   args: {
     target: {
       type: "string",
-      description: "Project root (default: cwd or EXTERNAL_FIXTURE_PATH)"
+      description: "\u9879\u76EE\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\u4E3A\u5F53\u524D\u76EE\u5F55\u6216 EXTERNAL_FIXTURE_PATH\uFF09\u3002"
     }
   },
   async run({ args }) {

package/dist/{scan-COKVYPOH.js → scan-UASZQLQP.js}

@@ -3,7 +3,7 @@ import {
   createScanReport,
   scanCommand,
   scan_default
-} from "./chunk-SC4A43WR.js";
+} from "./chunk-BWZHNZG6.js";
 import "./chunk-AEOYCVBG.js";
 import "./chunk-P4KVFB2T.js";
 export {

package/dist/{sync-meta-YIB7IBHK.js → sync-meta-YTG5V3Y6.js}

@@ -3,7 +3,7 @@ import {
   computeAgentsMeta,
   syncMetaCommand,
   sync_meta_default
-} from "./chunk-ZW4M4WZB.js";
+} from "./chunk-T3WQUWW4.js";
 import "./chunk-P4KVFB2T.js";
 export {
   computeAgentsMeta,

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
-    "fab": "./dist/index.js"
+    "fab": "dist/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "templates"
   ],
   "scripts": {
     "build": "tsup",

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

@@ -0,0 +1,29 @@
+# { projectName } — L0 AGENTS.md
+
+// TODO: describe project purpose.
+
+<!-- TODO: tech stack: detected framework is { frameworkKind }. Verify this manually before replacing TODOs. -->
+
+<!-- fab:index -->
+<!-- /fab:index -->
+
+## Human Documentation References
+
+// TODO: reference README.md sections that are source-of-truth for humans.
+// TODO: reference CONTRIBUTING.md if this project has one.
+
+## L0 AI Constraints
+
+// TODO: list hard constraints, e.g., ban any, require TypeScript strict.
+// TODO: list commands AI may run for validation.
+// TODO: list files or directories AI must not modify without permission.
+
+## @HUMAN
+
+// TODO: human-owned decisions live here. AI must not rewrite locked sentences.
+// TODO: placeholder locked sentence 1.
+// TODO: placeholder locked sentence 2.
+
+## L1 Candidate Notes
+
+// TODO: identify domain folders that may need scoped AGENTS.md files.

package/templates/bootstrap/CLAUDE.md

@@ -0,0 +1,8 @@
+# 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` 写一条意图记录。
+
+@AGENTS.md

package/templates/bootstrap/GEMINI.md

@@ -0,0 +1,8 @@
+# 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` 写一条意图记录。
+
+@AGENTS.md

package/templates/bootstrap/codex-AGENTS-header.md

@@ -0,0 +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` 写一条意图记录。

package/templates/bootstrap/cursor-fabric-bootstrap.mdc

@@ -0,0 +1,11 @@
+---
+alwaysApply: true
+description: Fabric Protocol bootstrap rules
+---
+
+# 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` 写一条意图记录。

package/templates/bootstrap/roo-fabric.md

@@ -0,0 +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` 写一条意图记录。

package/templates/bootstrap/windsurf-fabric.md

@@ -0,0 +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` 写一条意图记录。

package/templates/fabric/human-lock.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://fabric.local/schemas/human-lock.json",
+  "locked": [],
+  "examples": [
+    {
+      "file": "AGENTS.md",
+      "start_line": 18,
+      "end_line": 22,
+      "hash": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+    }
+  ]
+}

package/templates/husky/pre-commit

@@ -0,0 +1,24 @@
+#!/bin/sh
+# Fabric pre-commit hook — sub-300ms budget via single Node process
+# Runs: sync-meta --check-only → human-lint → ledger-append --staged → meta-guard
+# Uses local binary (no npx spawn) to avoid 3× Node startup cost.
+
+FAB_BIN="./node_modules/.bin/fab"
+
+if [ ! -x "$FAB_BIN" ]; then
+  echo "fabric: $FAB_BIN not found. Run 'pnpm install' at repo root." >&2
+  exit 1
+fi
+
+# Single Node invocation covering all three checks + meta guard.
+# The `pre-commit` meta-command chains sync-meta/human-lint/ledger-append
+# inside one process for minimal startup overhead.
+"$FAB_BIN" pre-commit || exit $?
+
+# Guard: block manual edits to .fabric/agents.meta.json
+if git diff --cached --name-only | grep -q '^\.fabric/agents\.meta\.json$'; then
+  if [ "$FAB_ALLOW_META_EDIT" != '1' ]; then
+    echo '.fabric/agents.meta.json cannot be manually edited; use fab_update_registry or set FAB_ALLOW_META_EDIT=1' >&2
+    exit 1
+  fi
+fi