@fenglimg/fabric-cli 0.1.2 → 0.1.3

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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