@fenglimg/fabric-cli 1.3.0 → 1.4.0

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-FY2WKWPB.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   installMcpClients
-} from "./chunk-TO5RUB4R.js";
-import "./chunk-VMYPJPKV.js";
+} from "./chunk-BVTMVW5M.js";
+import "./chunk-BEKSXO5N.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.4.0",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -13,13 +13,14 @@
     "templates"
   ],
   "dependencies": {
+    "@clack/prompts": "^1.2.0",
     "@iarna/toml": "^2.2.5",
     "citty": "^0.2.2",
     "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-server": "1.4.0",
+    "@fenglimg/fabric-shared": "1.4.0"
   },
   "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

package/templates/bootstrap/GEMINI.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

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

@@ -1,6 +1,4 @@
 # 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`。
+- 此 header 仅用于把 Codex 引导到 Fabric 项目级规则入口。
+- 修改任何文件前必须调用 `fab_get_rules(path=<被改文件>)`。

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

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

@@ -1,6 +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
+- 本项目使用 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

@@ -1,6 +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
+- 本项目使用 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/claude-hooks/agents-md-init-reminder.cjs

@@ -1,18 +1,18 @@
-#!/usr/bin/env node
-const { existsSync } = require("node:fs");
-const { join } = require("node:path");
-
-const forensicPath = join(process.cwd(), ".fabric", "forensic.json");
-const initContextPath = join(process.cwd(), ".fabric", "init-context.json");
-
-if (!existsSync(forensicPath) || existsSync(initContextPath)) {
-  process.exit(0);
-}
-
-process.stdout.write(
-  JSON.stringify({
-    decision: "block",
-    reason:
-      "fab init 已完成证据收集，但项目 AGENTS.md 初始化尚未完成。调用 agents-md-init skill (通过 Skill 工具) 完成 3 阶段初始化访谈。参考: .claude/skills/agents-md-init/SKILL.md + .fabric/forensic.json",
-  }),
-);
+#!/usr/bin/env node
+const { existsSync } = require("node:fs");
+const { join } = require("node:path");
+
+const forensicPath = join(process.cwd(), ".fabric", "forensic.json");
+const initContextPath = join(process.cwd(), ".fabric", "init-context.json");
+
+if (!existsSync(forensicPath) || existsSync(initContextPath)) {
+  process.exit(0);
+}
+
+process.stdout.write(
+  JSON.stringify({
+    decision: "block",
+    reason:
+      "fab init 已完成证据收集，但项目 AGENTS.md 初始化尚未完成。调用 agents-md-init skill (通过 Skill 工具) 完成 3 阶段初始化访谈。参考: .claude/skills/agents-md-init/SKILL.md + .fabric/forensic.json",
+  }),
+);

package/templates/claude-skills/agents-md-init/SKILL.md

@@ -1,86 +1,86 @@
----
-name: agents-md-init
-description: Use this skill when fab init just completed, when forensic.json generated, or when the user is asking to initialize AGENTS.md. This skill runs a 3-phase initialization interview, writes .fabric/init-context.json, generates layered AGENTS.md, and updates .fabric/agents.meta.json.
-allowed-tools: Read, Write, Glob, Grep, Bash
----
-
-## Precondition
-
-必须先 Read `.fabric/forensic.json`。若该文件不存在，终止 skill 并告知用户：`请先运行 fab init 生成证据包`。
-
-把以下状态视为 initialization pending：
-
-- `.fabric/forensic.json` 存在
-- `.fabric/init-context.json` 不存在
-
-## 执行流程 (3 Phase / 3 Round)
-
-### Phase 1 — 框架确认(1 轮,高效)
-
-展示 `.fabric/forensic.json` 的 `framework`、`topology.by_ext`、`entry_points` 摘要，向用户提 1-2 个框架架构澄清问题。
-
-示例(Cocos Creator 3.x)：
-
-> 我检测到 Cocos Creator 3.8 项目，主要脚本在 `assets/scripts`，采用 `@ccclass + extends Component` 模式。请确认：(1) 这是 TypeScript 项目(非 JavaScript)对吗？(2) 节点引用主要通过 `@property(Node)` 注入，还是 `find/getChildByName`？
-
-将用户确认结果暂存为已验证 framework assumptions。
-
-### Phase 2 — 不变式提取(1 轮,关键)
-
-基于 `.fabric/forensic.json` 的 `recommendations_for_skill` 列表，向用户提 3-5 个 invariants 问题，覆盖三类：
-
-- `ban`：禁止 any、禁止 update() 中 async、禁止 find-by-name 等
-- `require`：必须 strict TypeScript、必须 `@ccclass` decorator、必须 import from `cc` only 等
-- `protect`：哪些目录或文件 AI 不能修改，一般是 `assets/prefabs/**`、`assets/scenes/**`、`**/*.meta`
-
-原则：
-
-- 只问 invariants，不问 preferences
-- 每个问题只接受 yes/no/具体规则，不接受模糊回答
-- 不要自动推测用户未确认的硬约束
-
-### Phase 3 — 构造与落地(1 轮,自动)
-
-1. 写入 `.fabric/init-context.json`，包含：
-
-- `framework`
-- `architecture_patterns`
-- `invariants`
-- `domain_groups`
-- `interview_trail`
-- `forensic_ref`
-
-写入规则：
-
-- `invariants[].type` 必须是 `ban`、`require`、`protect`
-- `domain_groups` 由 `entry_points` 和访谈结果推断
-- `interview_trail[]` 必须记录 Phase 1 和 Phase 2 的原始问答
-- `forensic_ref` 必须为 `.fabric/forensic.json`
-
-2. 生成分层 `AGENTS.md`：
-
-- 根 `AGENTS.md` 必须在 300 行以内，结构包含：
-- `# {projectName} — L0 AGENTS.md`
-- `<!-- fab:index -->`：填充 `domain_groups` 索引
-- `## L0 AI Constraints`：从 invariants 派生，按 `ban`、`require`、`protect` 分段
-- `## @HUMAN`：protect 路径和用户声明的人类保护规则
-- `## L1 Candidate Notes`：domain_groups 对应的候选子模块说明
-
-如果 `domain_groups.length >= 2`，为每个 group 生成 `{group_path}/AGENTS.md`。最多到 L3，总嵌套不超过 4 层。
-
-3. 更新 `.fabric/agents.meta.json` 的 nodes 树，保持 revision hash 链一致：
-
-- nodes 结构与生成后的 AGENTS 层级一致
-- 更新所有变更 AGENTS 文件的 hash
-- 保持 revision hash 链内部一致
-
-4. 最终输出：向用户列出生成文件清单，并建议后续维护时运行 `fab sync-meta`。
-
-## Hard Rules
-
-- Zero TODO: 不生成任何 `TODO`、`TBD`、placeholder、stub
-- No YAML frontmatter in outputs: 除本 skill 自身外，生成的 `AGENTS.md` 不得包含 YAML frontmatter
-- Root AGENTS.md <= 300 lines
-- AGENTS 嵌套总层级 <= 4
-- 不得自动推测用户未确认的 invariants
-- 有不确定内容时删除，不要留占位符
+---
+name: agents-md-init
+description: Use this skill when fab init just completed, when forensic.json generated, or when the user is asking to initialize AGENTS.md. This skill runs a 3-phase initialization interview, writes .fabric/init-context.json, generates layered AGENTS.md, and updates .fabric/agents.meta.json.
+allowed-tools: Read, Write, Glob, Grep, Bash
+---
+
+## Precondition
+
+必须先 Read `.fabric/forensic.json`。若该文件不存在，终止 skill 并告知用户：`请先运行 fab init 生成证据包`。
+
+把以下状态视为 initialization pending：
+
+- `.fabric/forensic.json` 存在
+- `.fabric/init-context.json` 不存在
+
+## 执行流程 (3 Phase / 3 Round)
+
+### Phase 1 — 框架确认(1 轮,高效)
+
+展示 `.fabric/forensic.json` 的 `framework`、`topology.by_ext`、`entry_points` 摘要，向用户提 1-2 个框架架构澄清问题。
+
+示例(Cocos Creator 3.x)：
+
+> 我检测到 Cocos Creator 3.8 项目，主要脚本在 `assets/scripts`，采用 `@ccclass + extends Component` 模式。请确认：(1) 这是 TypeScript 项目(非 JavaScript)对吗？(2) 节点引用主要通过 `@property(Node)` 注入，还是 `find/getChildByName`？
+
+将用户确认结果暂存为已验证 framework assumptions。
+
+### Phase 2 — 不变式提取(1 轮,关键)
+
+基于 `.fabric/forensic.json` 的 `recommendations_for_skill` 列表，向用户提 3-5 个 invariants 问题，覆盖三类：
+
+- `ban`：禁止 any、禁止 update() 中 async、禁止 find-by-name 等
+- `require`：必须 strict TypeScript、必须 `@ccclass` decorator、必须 import from `cc` only 等
+- `protect`：哪些目录或文件 AI 不能修改，一般是 `assets/prefabs/**`、`assets/scenes/**`、`**/*.meta`
+
+原则：
+
+- 只问 invariants，不问 preferences
+- 每个问题只接受 yes/no/具体规则，不接受模糊回答
+- 不要自动推测用户未确认的硬约束
+
+### Phase 3 — 构造与落地(1 轮,自动)
+
+1. 写入 `.fabric/init-context.json`，包含：
+
+- `framework`
+- `architecture_patterns`
+- `invariants`
+- `domain_groups`
+- `interview_trail`
+- `forensic_ref`
+
+写入规则：
+
+- `invariants[].type` 必须是 `ban`、`require`、`protect`
+- `domain_groups` 由 `entry_points` 和访谈结果推断
+- `interview_trail[]` 必须记录 Phase 1 和 Phase 2 的原始问答
+- `forensic_ref` 必须为 `.fabric/forensic.json`
+
+2. 生成分层 `AGENTS.md`：
+
+- 根 `AGENTS.md` 必须在 300 行以内，结构包含：
+- `# {projectName} — L0 AGENTS.md`
+- `<!-- fab:index -->`：填充 `domain_groups` 索引
+- `## L0 AI Constraints`：从 invariants 派生，按 `ban`、`require`、`protect` 分段
+- `## @HUMAN`：protect 路径和用户声明的人类保护规则
+- `## L1 Candidate Notes`：domain_groups 对应的候选子模块说明
+
+如果 `domain_groups.length >= 2`，为每个 group 生成 `{group_path}/AGENTS.md`。最多到 L3，总嵌套不超过 4 层。
+
+3. 更新 `.fabric/agents.meta.json` 的 nodes 树，保持 revision hash 链一致：
+
+- nodes 结构与生成后的 AGENTS 层级一致
+- 更新所有变更 AGENTS 文件的 hash
+- 保持 revision hash 链内部一致
+
+4. 最终输出：向用户列出生成文件清单，并建议后续维护时运行 `fab sync-meta`。
+
+## Hard Rules
+
+- Zero TODO: 不生成任何 `TODO`、`TBD`、placeholder、stub
+- No YAML frontmatter in outputs: 除本 skill 自身外，生成的 `AGENTS.md` 不得包含 YAML frontmatter
+- Root AGENTS.md <= 300 lines
+- AGENTS 嵌套总层级 <= 4
+- 不得自动推测用户未确认的 invariants
+- 有不确定内容时删除，不要留占位符

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+const { existsSync } = require("node:fs");
+const { join } = require("node:path");
+
+const forensicPath = join(process.cwd(), ".fabric", "forensic.json");
+const initContextPath = join(process.cwd(), ".fabric", "init-context.json");
+
+if (!existsSync(forensicPath) || existsSync(initContextPath)) {
+  process.exit(0);
+}
+
+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.",
+    },
+  }),
+);

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

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { existsSync } = require("node:fs");
+const { join } = require("node:path");
+
+const forensicPath = join(process.cwd(), ".fabric", "forensic.json");
+const initContextPath = join(process.cwd(), ".fabric", "init-context.json");
+
+if (!existsSync(forensicPath) || existsSync(initContextPath)) {
+  process.exit(0);
+}
+
+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.",
+  }),
+);