@fenglimg/fabric-cli 0.1.4 → 1.0.0

package/dist/serve-4J2CQY25.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import {
+  createDebugLogger,
+  resolveDevMode
+} from "./chunk-AEOYCVBG.js";
+import {
+  paint,
+  symbol
+} from "./chunk-WWNXR34K.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
+
+// src/commands/serve.ts
+import { defineCommand } from "citty";
+import { startHttpServer } from "@fenglimg/fabric-server";
+var DEFAULT_PORT = 7373;
+var serveCommand = defineCommand({
+  meta: {
+    name: "serve",
+    description: t("cli.serve.description")
+  },
+  args: {
+    port: {
+      type: "string",
+      description: t("cli.serve.args.port.description"),
+      default: String(DEFAULT_PORT)
+    },
+    host: {
+      type: "string",
+      description: t("cli.serve.args.host.description"),
+      default: "127.0.0.1"
+    },
+    target: {
+      type: "string",
+      description: t("cli.serve.args.target.description")
+    },
+    debug: {
+      type: "boolean",
+      description: t("cli.serve.args.debug.description"),
+      default: false
+    }
+  },
+  async run({ args }) {
+    const workspaceRoot = process.cwd();
+    const logger = createDebugLogger(args.debug);
+    const resolution = resolveDevMode(args.target, workspaceRoot);
+    const port = parsePort(args.port);
+    const requestedHost = parseHost(args.host);
+    const authToken = readAuthTokenFromEnv();
+    const host = validateHost(requestedHost, authToken);
+    logger(`serve target source: ${resolution.source}`);
+    for (const step of resolution.chain) {
+      logger(step);
+    }
+    try {
+      await startHttpServer({
+        port,
+        projectRoot: resolution.target,
+        host,
+        authToken
+      });
+    } catch (error) {
+      if (isNodeError(error) && error.code === "EADDRINUSE") {
+        throw new Error(t("cli.serve.error.port-in-use", { port: String(port), nextPort: String(port + 1) }));
+      }
+      throw error;
+    }
+    console.log(`${symbol.ok} ${paint.ai(t("cli.serve.ready.title"))} ${paint.human(`http://${host}:${port}`)}`);
+  }
+});
+var serve_default = serveCommand;
+function parsePort(value) {
+  const port = Number.parseInt(value ?? String(DEFAULT_PORT), 10);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new Error(t("cli.shared.invalid-port", { value: value ?? "<unset>" }));
+  }
+  return port;
+}
+function parseHost(value) {
+  const host = value?.trim() ?? "127.0.0.1";
+  if (host.length === 0) {
+    throw new Error(t("cli.shared.invalid-host-empty"));
+  }
+  return host;
+}
+function readAuthTokenFromEnv() {
+  const token = process.env.FABRIC_AUTH_TOKEN;
+  return token === void 0 || token.length === 0 ? void 0 : token;
+}
+function validateHost(host, authToken) {
+  if (authToken !== void 0) {
+    return host;
+  }
+  if (!isLoopbackHost(host)) {
+    console.error(
+      `${symbol.warn} ${paint.warn(t("cli.serve.warning.host-fallback", { host }))}`
+    );
+    return "127.0.0.1";
+  }
+  return host;
+}
+function isLoopbackHost(host) {
+  return host === "127.0.0.1" || host === "localhost" || host === "::1";
+}
+function isNodeError(error) {
+  return error instanceof Error;
+}
+export {
+  serve_default as default,
+  serveCommand
+};

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

@@ -3,8 +3,9 @@ import {
   computeAgentsMeta,
   syncMetaCommand,
   sync_meta_default
-} from "./chunk-T3WQUWW4.js";
+} from "./chunk-5BSTO745.js";
 import "./chunk-P4KVFB2T.js";
+import "./chunk-6ICJICVU.js";
 export {
   computeAgentsMeta,
   sync_meta_default as default,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "0.1.4",
+  "version": "1.0.0",
   "type": "module",
   "bin": {
     "fab": "dist/index.js"
@@ -11,19 +11,23 @@
     "dist",
     "templates"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
   "dependencies": {
-    "@fenglimg/fabric-server": "^0.1.0",
     "@iarna/toml": "^2.2.5",
-    "citty": "^0.2.2"
+    "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"
   },
   "devDependencies": {
     "@types/iarna__toml": "^2.0.5",
     "@types/node": "^22.15.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run"
   }
-}
+}

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

@@ -1,29 +1,35 @@
 # { projectName } — L0 AGENTS.md
 
-// TODO: describe project purpose.
+<!-- This is the fallback template. If you have Claude Code, run the agents-md-init skill for a semantically richer AGENTS.md. -->
 
-<!-- TODO: tech stack: detected framework is { frameworkKind }. Verify this manually before replacing TODOs. -->
+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
 
-// TODO: reference README.md sections that are source-of-truth for humans.
-// TODO: reference CONTRIBUTING.md if this project has one.
+- `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
 
-// 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.
+- 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
 
-// TODO: human-owned decisions live here. AI must not rewrite locked sentences.
-// TODO: placeholder locked sentence 1.
-// TODO: placeholder locked sentence 2.
+- 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
 
-// TODO: identify domain folders that may need scoped AGENTS.md files.
+- Promote a directory to L1 only when it has its own commands, deployment surface, or irreversible side effects.

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

@@ -0,0 +1,37 @@
+# { 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.

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

@@ -0,0 +1,37 @@
+# { 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.

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

@@ -0,0 +1,37 @@
+# { 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.

package/templates/claude-hooks/agents-md-init-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 已完成证据收集，但项目 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

@@ -0,0 +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
+- 有不确定内容时删除，不要留占位符

package/dist/chunk-BWZHNZG6.js

@@ -1,236 +0,0 @@
-#!/usr/bin/env node
-import {
-  createDebugLogger,
-  readFabricConfig,
-  resolveDevMode
-} from "./chunk-AEOYCVBG.js";
-import {
-  resolveIgnores
-} from "./chunk-P4KVFB2T.js";
-
-// src/commands/scan.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
-import { isAbsolute, join as join2, relative, resolve, sep } from "path";
-import { defineCommand } from "citty";
-
-// src/scanner/detector.ts
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function detectFramework(root) {
-  const evidence = [];
-  if (existsSync(join(root, "project.config.json"))) {
-    return {
-      kind: "cocos-creator",
-      evidence: ["project.config.json"]
-    };
-  }
-  const packageJsonPath = join(root, "package.json");
-  if (existsSync(packageJsonPath)) {
-    const packageJson = readPackageJson(packageJsonPath);
-    const deps = collectDependencyNames(packageJson);
-    for (const [dependencyName, kind] of [
-      ["next", "next"],
-      ["vite", "vite"],
-      ["react", "react"],
-      ["vue", "vue"]
-    ]) {
-      if (deps.has(dependencyName)) {
-        evidence.push(`package.json dependency: ${dependencyName}`);
-        return { kind, evidence };
-      }
-    }
-    evidence.push("package.json");
-  }
-  if (existsSync(join(root, "Cargo.toml"))) {
-    return {
-      kind: "rust",
-      evidence: ["Cargo.toml"]
-    };
-  }
-  if (existsSync(join(root, "pyproject.toml"))) {
-    return {
-      kind: "python",
-      evidence: ["pyproject.toml"]
-    };
-  }
-  return {
-    kind: "unknown",
-    evidence
-  };
-}
-function readPackageJson(packageJsonPath) {
-  try {
-    return JSON.parse(readFileSync(packageJsonPath, "utf8"));
-  } catch {
-    return {};
-  }
-}
-function collectDependencyNames(packageJson) {
-  return /* @__PURE__ */ new Set([
-    ...Object.keys(packageJson.dependencies ?? {}),
-    ...Object.keys(packageJson.devDependencies ?? {}),
-    ...Object.keys(packageJson.peerDependencies ?? {}),
-    ...Object.keys(packageJson.optionalDependencies ?? {})
-  ]);
-}
-
-// src/commands/scan.ts
-function createScanReport(targetInput = process.cwd(), fabricConfig) {
-  const target = normalizeTarget(targetInput);
-  const framework = detectFramework(target);
-  const readmeQuality = getReadmeQuality(target);
-  const hasContributing = existsSync2(join2(target, "CONTRIBUTING.md"));
-  const hasExistingFabric = existsSync2(join2(target, "AGENTS.md")) || existsSync2(join2(target, ".fabric"));
-  const walkResult = walkFiles(target, resolveIgnores(fabricConfig));
-  return {
-    target,
-    framework,
-    readmeQuality,
-    hasContributing,
-    fileCount: walkResult.fileCount,
-    ignoredCount: walkResult.ignoredCount,
-    hasExistingFabric,
-    recommendations: buildRecommendations({
-      framework,
-      readmeQuality,
-      hasContributing,
-      hasExistingFabric
-    })
-  };
-}
-var scanCommand = defineCommand({
-  meta: {
-    name: "scan",
-    description: "\u626B\u63CF\u9879\u76EE\u4EE5\u68C0\u6D4B Fabric \u5F15\u5BFC\u5019\u9009\u6A21\u5757\u3002"
-  },
-  args: {
-    target: {
-      type: "string",
-      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: "\u4EE5\u683C\u5F0F\u5316\u8F93\u51FA\u6253\u5370\u68C0\u6D4B\u8BC1\u636E\u3002",
-      default: false
-    },
-    json: {
-      type: "boolean",
-      description: "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u8BCA\u65AD\u62A5\u544A\u3002",
-      default: false
-    }
-  },
-  async run({ args }) {
-    const workspaceRoot = process.cwd();
-    const logger = createDebugLogger(args.debug);
-    const resolution = resolveDevMode(args.target, workspaceRoot);
-    const fabricConfig = readFabricConfig(workspaceRoot);
-    logger(`scan target source: ${resolution.source}`);
-    for (const step of resolution.chain) {
-      logger(step);
-    }
-    const report = createScanReport(resolution.target, fabricConfig);
-    if (args.json) {
-      console.log(JSON.stringify(report, null, 2));
-      return;
-    }
-    printPrettyReport(report, Boolean(args.debug));
-  }
-});
-var scan_default = scanCommand;
-function normalizeTarget(targetInput) {
-  return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
-}
-function getReadmeQuality(target) {
-  const readmePath = join2(target, "README.md");
-  if (!existsSync2(readmePath)) {
-    return "stub";
-  }
-  const wordCount = readFileSync2(readmePath, "utf8").trim().split(/\s+/).filter(Boolean).length;
-  return wordCount >= 200 ? "ok" : "stub";
-}
-function walkFiles(root, ignorePatterns) {
-  if (!existsSync2(root) || !statSync(root).isDirectory()) {
-    throw new Error(`Target must be an existing directory: ${root}`);
-  }
-  let fileCount = 0;
-  let ignoredCount = 0;
-  const stack = [root];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (current === void 0) {
-      continue;
-    }
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const absolutePath = join2(current, entry.name);
-      const relativePath = toPosixPath(relative(root, absolutePath));
-      if (shouldIgnore(relativePath, entry.isDirectory(), ignorePatterns)) {
-        ignoredCount += 1;
-        continue;
-      }
-      if (entry.isDirectory()) {
-        stack.push(absolutePath);
-      } else if (entry.isFile()) {
-        fileCount += 1;
-      }
-    }
-  }
-  return { fileCount, ignoredCount };
-}
-function shouldIgnore(relativePath, isDirectory, ignorePatterns) {
-  return ignorePatterns.some((pattern) => matchesIgnorePattern(relativePath, isDirectory, pattern));
-}
-function matchesIgnorePattern(relativePath, isDirectory, pattern) {
-  const normalizedPattern = toPosixPath(pattern);
-  if (normalizedPattern === "**/*.meta") {
-    return relativePath.endsWith(".meta");
-  }
-  if (normalizedPattern.endsWith("/**")) {
-    const directoryPrefix = normalizedPattern.slice(0, -3);
-    return relativePath === directoryPrefix || relativePath.startsWith(`${directoryPrefix}/`) || isDirectory && `${relativePath}/` === directoryPrefix;
-  }
-  return relativePath === normalizedPattern;
-}
-function toPosixPath(path) {
-  return path.split(sep).join("/");
-}
-function buildRecommendations(input) {
-  const recommendations = [];
-  if (!input.hasExistingFabric) {
-    recommendations.push("L0: Run fab init to scaffold AGENTS.md with TODO markers.");
-  }
-  if (input.readmeQuality === "stub") {
-    recommendations.push("L0: Expand README.md before promoting project facts into AGENTS.md references.");
-  }
-  if (!input.hasContributing) {
-    recommendations.push("L0: Add CONTRIBUTING.md or leave an AGENTS.md TODO reference for contribution flow.");
-  }
-  if (input.framework.kind === "unknown") {
-    recommendations.push("L1: Add tech-stack TODOs manually because no framework marker was detected.");
-  } else {
-    recommendations.push(`L1: Review ${input.framework.kind} directories for future scoped AGENTS.md files.`);
-  }
-  return recommendations;
-}
-function printPrettyReport(report, debug) {
-  console.log("Fabric scan report");
-  console.log(`Target: ${report.target}`);
-  console.log(`Framework: ${report.framework.kind}`);
-  if (debug) {
-    console.log(`Evidence: ${report.framework.evidence.length > 0 ? report.framework.evidence.join(", ") : "none"}`);
-  }
-  console.log(`README quality: ${report.readmeQuality}`);
-  console.log(`CONTRIBUTING.md: ${report.hasContributing ? "present" : "missing"}`);
-  console.log(`Files counted: ${report.fileCount}`);
-  console.log(`Ignored entries: ${report.ignoredCount}`);
-  console.log(`Existing Fabric files: ${report.hasExistingFabric ? "yes" : "no"}`);
-  console.log("Recommendations:");
-  for (const recommendation of report.recommendations) {
-    console.log(`- ${recommendation}`);
-  }
-}
-
-export {
-  createScanReport,
-  scanCommand,
-  scan_default
-};

package/dist/human-lint-II6TBGP4.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import {
-  humanLintCommand,
-  human_lint_default
-} from "./chunk-CZ7U6ULM.js";
-export {
-  human_lint_default as default,
-  humanLintCommand
-};