@fenglimg/fabric-cli 1.0.0 → 1.2.0

package/dist/{pre-commit-IEIXHKOD.js → pre-commit-CJ7EDKJK.js}

@@ -1,18 +1,17 @@
 #!/usr/bin/env node
-import {
-  resolveDevModeTarget
-} from "./chunk-AEOYCVBG.js";
 import {
   sync_meta_default
-} from "./chunk-5BSTO745.js";
-import "./chunk-P4KVFB2T.js";
+} from "./chunk-6UUPKSDE.js";
 import {
   human_lint_default
 } from "./chunk-L43IGJ6X.js";
-import "./chunk-WWNXR34K.js";
 import {
   ledger_append_default
 } from "./chunk-F2BXHPM5.js";
+import "./chunk-WWNXR34K.js";
+import {
+  resolveDevModeTarget
+} from "./chunk-AEOYCVBG.js";
 import {
   t
 } from "./chunk-6ICJICVU.js";

package/dist/{scan-6CURGC3D.js → scan-WKDSKEBB.js}

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

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

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 import {
   computeAgentsMeta,
+  deriveLayer,
+  deriveTopologyType,
   syncMetaCommand,
   sync_meta_default
-} from "./chunk-5BSTO745.js";
-import "./chunk-P4KVFB2T.js";
+} from "./chunk-6UUPKSDE.js";
 import "./chunk-6ICJICVU.js";
 export {
   computeAgentsMeta,
   sync_meta_default as default,
+  deriveLayer,
+  deriveTopologyType,
   syncMetaCommand
 };

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "bin": {
-    "fab": "dist/index.js"
+    "fab": "dist/index.js",
+    "fabric": "dist/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,8 +17,8 @@
     "citty": "^0.2.2",
     "picocolors": "^1.1.1",
     "string-width": "^7.2.0",
-    "@fenglimg/fabric-shared": "1.0.0",
-    "@fenglimg/fabric-server": "1.0.0"
+    "@fenglimg/fabric-shared": "1.2.0",
+    "@fenglimg/fabric-server": "1.2.0"
   },
   "devDependencies": {
     "@types/iarna__toml": "^2.0.5",

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

@@ -1,35 +1,20 @@
-# { projectName } — L0 AGENTS.md
-
-<!-- This is the fallback template. If you have Claude Code, run the agents-md-init skill for a semantically richer AGENTS.md. -->
-
-This file is the non-AI fallback scaffold for repositories that have not gone through semantic AGENTS initialization yet.
-
-<!-- fab:index -->
-<!-- /fab:index -->
-
-## Human Documentation References
-
-- `README.md` is the source of truth for setup, scripts, runtime expectations, and product behavior.
-- `CONTRIBUTING.md`, if present, overrides local assumptions for branching, review, and release workflow.
-- When documentation and code disagree, pause and ask a human before rewriting either source.
-
-## L0 AI Constraints
-
-- Keep changes small, reversible, and validated with the narrowest relevant command before broader builds.
-- Match existing repository patterns before introducing new abstractions, tooling, or file structure.
-- Avoid modifying secrets, deployment configuration, lockfiles, or generated artifacts unless the task explicitly requires it.
-
-## Framework Baseline
-
-- Fabric did not match this repository to a first-class scaffold. Detected framework kind: `{ frameworkKind }`.
-- Treat the current source tree and existing docs as the primary evidence before writing new rules.
-- Add L1 AGENTS.md files only for directories that have clearly different runtime, build, or safety constraints.
-
-## @HUMAN
-
-- Human-owned decisions belong in this section or `.fabric/human-lock.json`; AI must pause before changing them.
-- Record release gates, product invariants, or directories that need explicit approval here.
-
-## L1 Candidate Notes
-
-- Promote a directory to L1 only when it has its own commands, deployment surface, or irreversible side effects.
+# { 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，不承载项目业务规则。
+- 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/`。
+- If `.fabric/agents/root.md` is missing, stop normal coding and run the initialization flow that creates shadow constraints.

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

@@ -1,37 +1,20 @@
-# { projectName } — L0 AGENTS.md
-
-<!-- This is the fallback template. If you have Claude Code, run the agents-md-init skill for a semantically richer AGENTS.md. -->
-
-This file is the non-AI fallback scaffold for a Cocos Creator codebase. Prefer conservative edits and preserve editor-generated assets.
-
-<!-- fab:index -->
-<!-- /fab:index -->
-
-## Human Documentation References
-
-- `README.md` is the source of truth for gameplay intent, scene flow, setup, and packaging steps.
-- Cocos Editor settings, prefab wiring, and scene structure are human-reviewed surfaces; ask before broad refactors.
-- When code and editor data disagree, inspect both before changing either side.
-
-## L0 AI Constraints
-
-- Component scripts must follow the existing Cocos pattern: import from `cc`, destructure decorators from `_decorator`, apply `@ccclass`, and extend `Component`.
-- Respect Cocos lifecycle order. Put initialization in `onLoad` or `start`, cleanup in `onDestroy`, and keep `update` lightweight and frame-safe.
-- Do not mark `update()` as `async` and do not introduce blocking or network-heavy work into frame callbacks.
-- Preserve `.meta` files, prefab references, scene bindings, and asset UUID relationships unless the task explicitly requires coordinated editor changes.
-- Prefer targeted script edits over renaming assets, moving prefab trees, or restructuring `assets/` folders.
-
-## Cocos Baseline
-
-- Keep gameplay logic inside component boundaries or small helpers that are already imported by components.
-- When adding new nodes or serialized fields, match the repository's existing decorator and property style.
-- Validate with the smallest relevant TypeScript or project command first; only ask for editor-side verification when asset wiring changes.
-
-## @HUMAN
-
-- Human-owned decisions belong in this section or `.fabric/human-lock.json`; AI must pause before changing them.
-- Record protected scenes, prefabs, release assets, or multiplayer protocol invariants here.
-
-## L1 Candidate Notes
-
-- Add scoped AGENTS.md files only for large subtrees such as `assets/scripts`, `assets/prefabs`, or `assets/scenes` when they gain distinct local rules.
+# { 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,37 +1,20 @@
-# { projectName } — L0 AGENTS.md
-
-<!-- This is the fallback template. If you have Claude Code, run the agents-md-init skill for a semantically richer AGENTS.md. -->
-
-This file is the non-AI fallback scaffold for a Next.js application using the App Router by default.
-
-<!-- fab:index -->
-<!-- /fab:index -->
-
-## Human Documentation References
-
-- `README.md` is the source of truth for product flows, local setup, and deployment expectations.
-- Operational behavior for routes, caching, auth, or background jobs should be verified against code and docs together before refactoring.
-- If `CONTRIBUTING.md` exists, follow its review and release gates over local assumptions.
-
-## L0 AI Constraints
-
-- Treat `app/` as App Router unless the repository clearly uses another convention.
-- Keep React Server Components on the server side by default. Add `"use client"` only for components that need browser APIs, local state, effects, or event handlers.
-- Do not import server-only modules into client components, and do not access browser-only globals from server components or route handlers.
-- Keep data fetching, cache behavior, and mutations aligned with existing route, server action, and API handler patterns.
-- Prefer small route-local changes over broad restructuring of layouts, middleware, or caching policy.
-
-## Next Baseline
-
-- Preserve the server/client boundary at file level so the bundle stays predictable and hydration issues stay local.
-- Reuse existing patterns for route handlers, metadata, and loading or error states before creating new abstractions.
-- Validate the narrowest route or package command first, then run the broader build once local behavior is stable.
-
-## @HUMAN
-
-- Human-owned decisions belong in this section or `.fabric/human-lock.json`; AI must pause before changing them.
-- Record protected routes, auth assumptions, cache invariants, or SEO requirements here.
-
-## L1 Candidate Notes
-
-- Add scoped AGENTS.md files only for areas such as `app`, `components`, or `lib` when they gain strong local conventions.
+# { 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,37 +1,20 @@
-# { projectName } — L0 AGENTS.md
-
-<!-- This is the fallback template. If you have Claude Code, run the agents-md-init skill for a semantically richer AGENTS.md. -->
-
-This file is the non-AI fallback scaffold for a Vite application. Treat the repository as a client-rendered app unless the code clearly establishes another pattern.
-
-<!-- fab:index -->
-<!-- /fab:index -->
-
-## Human Documentation References
-
-- `README.md` is the source of truth for setup, scripts, environment variables, and deployment assumptions.
-- Product behavior and UX expectations should be taken from shipped screens and existing docs before introducing new architecture.
-- If `CONTRIBUTING.md` exists, follow its branch, review, and validation rules over local defaults.
-
-## L0 AI Constraints
-
-- Keep browser code on the client side. Assume SSR is off unless the repository already contains an explicit server rendering path.
-- Preserve clear module boundaries: UI components stay presentation-focused, shared utilities stay framework-agnostic, and side effects remain close to the feature that needs them.
-- Match the repo's TypeScript strictness and import style; do not weaken types or introduce `any` to move faster.
-- Use `import.meta.env` for Vite environment access and avoid Node-only APIs in browser bundles.
-- Prefer incremental feature-local edits over sweeping alias, build, or routing changes.
-
-## Vite Baseline
-
-- Keep module scope cheap; avoid eager side effects that run on import when they can live in explicit startup code.
-- Reuse existing state and styling patterns before adding new stores, plugin layers, or CSS systems.
-- Validate with the narrowest app command first, then run the broader build only after local checks pass.
-
-## @HUMAN
-
-- Human-owned decisions belong in this section or `.fabric/human-lock.json`; AI must pause before changing them.
-- Record protected environment contracts, analytics events, or release-specific UI constraints here.
-
-## L1 Candidate Notes
-
-- Add scoped AGENTS.md files only when areas such as `src/features`, `src/components`, or `src/lib` accumulate their own rules.
+# { 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/dist/chunk-P4KVFB2T.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-
-// src/scanner/ignores.ts
-var DEFAULT_IGNORES = [
-  "**/*.meta",
-  "library/**",
-  "temp/**",
-  "build/**",
-  "settings/**",
-  "profiles/**",
-  "node_modules/**",
-  "dist/**",
-  ".git/**",
-  ".fabric/**"
-];
-function resolveIgnores(fabricConfig) {
-  return [...DEFAULT_IGNORES, ...fabricConfig?.scanIgnores ?? []];
-}
-
-export {
-  resolveIgnores
-};

package/dist/hooks-5S5IRVQE.js

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-import {
-  t
-} from "./chunk-6ICJICVU.js";
-
-// src/commands/hooks.ts
-import { chmodSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
-import { dirname, isAbsolute, join, parse, resolve } from "path";
-import { fileURLToPath } from "url";
-import { defineCommand } from "citty";
-var hooksCommand = defineCommand({
-  meta: {
-    name: "hooks",
-    description: t("cli.hooks.description")
-  },
-  subCommands: {
-    install: defineCommand({
-      meta: {
-        name: "install",
-        description: t("cli.hooks.install.description")
-      },
-      args: {
-        target: {
-          type: "string",
-          description: t("cli.hooks.install.args.target.description"),
-          default: process.cwd()
-        }
-      },
-      async run({ args }) {
-        const target = normalizeTarget(args.target);
-        assertExistingDirectory(target);
-        const huskyDir = join(target, ".husky");
-        const hookPath = join(huskyDir, "pre-commit");
-        const packageJsonPath = join(target, "package.json");
-        if (!existsSync(packageJsonPath)) {
-          throw new Error(t("cli.hooks.errors.package-json-required", { path: packageJsonPath }));
-        }
-        mkdirSync(huskyDir, { recursive: true });
-        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 : {};
-        const hadPrepare = typeof scripts.prepare === "string" && scripts.prepare.trim().length > 0;
-        if (!hadPrepare) {
-          scripts.prepare = "husky install";
-          packageJson.scripts = scripts;
-          writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
-`, "utf8");
-        }
-        if (hookAction === "skipped") {
-          writeStderr(t("cli.hooks.install.hook-skipped", { path: hookPath }));
-        } else if (hookAction === "appended") {
-          writeStderr(t("cli.hooks.install.hook-appended", { path: hookPath }));
-        } else {
-          writeStderr(t("cli.hooks.install.hook-created", { path: hookPath }));
-        }
-        if (hadPrepare) {
-          writeStderr(t("cli.hooks.install.prepare-left", { path: packageJsonPath }));
-        } else {
-          writeStderr(t("cli.hooks.install.prepare-added", { path: packageJsonPath }));
-        }
-      }
-    })
-  }
-});
-var hooks_default = hooksCommand;
-function normalizeTarget(targetInput) {
-  return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
-}
-function assertExistingDirectory(target) {
-  if (!existsSync(target) || !statSync(target).isDirectory()) {
-    throw new Error(t("cli.shared.target-invalid", { target }));
-  }
-}
-function findTemplatePath(relativePath) {
-  const currentModuleDir = dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    ...templateCandidatesFrom(process.cwd(), relativePath),
-    ...templateCandidatesFrom(currentModuleDir, relativePath)
-  ];
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-  }
-  throw new Error(t("cli.shared.template-not-found", { path: relativePath }));
-}
-function templateCandidatesFrom(start, relativePath) {
-  const candidates = [];
-  let current = resolve(start);
-  while (true) {
-    candidates.push(join(current, ...relativePath.split("/")));
-    const parent = dirname(current);
-    if (parent === current || parse(current).root === current) {
-      break;
-    }
-    current = parent;
-  }
-  return candidates.reverse();
-}
-function writeStderr(message) {
-  process.stderr.write(`${message}
-`);
-}
-export {
-  hooks_default as default,
-  hooksCommand
-};