@fenglimg/fabric-cli 2.0.0-rc.15 → 2.0.0-rc.21

package/dist/chunk-UTF4YBDN.js

@@ -1,366 +0,0 @@
-#!/usr/bin/env node
-import {
-  deepMerge
-} from "./chunk-SKSYUHKK.js";
-
-// src/install/skills-and-hooks.ts
-import { chmodSync, existsSync, readFileSync } from "fs";
-import { mkdir, readFile } from "fs/promises";
-import { dirname, join, parse, resolve } from "path";
-import { fileURLToPath } from "url";
-import { atomicWriteJson, atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
-var SKILL_TEMPLATE_REL = "skills/fabric-archive/SKILL.md";
-var SKILL_REVIEW_TEMPLATE_REL = "skills/fabric-review/SKILL.md";
-var SKILL_IMPORT_TEMPLATE_REL = "skills/fabric-import/SKILL.md";
-var HOOK_SCRIPT_TEMPLATE_REL = "hooks/fabric-hint.cjs";
-var HOOK_BROAD_SCRIPT_TEMPLATE_REL = "hooks/knowledge-hint-broad.cjs";
-var HOOK_NARROW_SCRIPT_TEMPLATE_REL = "hooks/knowledge-hint-narrow.cjs";
-var CLAUDE_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/claude-code.json";
-var CODEX_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/codex-hooks.json";
-var CURSOR_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/cursor-hooks.json";
-var SKILL_DESTINATIONS = {
-  fabricArchive: [
-    ".claude/skills/fabric-archive/SKILL.md",
-    ".codex/skills/fabric-archive/SKILL.md"
-  ],
-  fabricReview: [
-    ".claude/skills/fabric-review/SKILL.md",
-    ".codex/skills/fabric-review/SKILL.md"
-  ],
-  fabricImport: [
-    ".claude/skills/fabric-import/SKILL.md",
-    ".codex/skills/fabric-import/SKILL.md"
-  ]
-};
-var HOOK_SCRIPT_DESTINATIONS = {
-  fabricHint: [
-    ".claude/hooks/fabric-hint.cjs",
-    ".codex/hooks/fabric-hint.cjs",
-    ".cursor/hooks/fabric-hint.cjs"
-  ],
-  knowledgeHintBroad: [
-    ".claude/hooks/knowledge-hint-broad.cjs",
-    ".codex/hooks/knowledge-hint-broad.cjs",
-    ".cursor/hooks/knowledge-hint-broad.cjs"
-  ],
-  knowledgeHintNarrow: [
-    ".claude/hooks/knowledge-hint-narrow.cjs",
-    ".codex/hooks/knowledge-hint-narrow.cjs",
-    ".cursor/hooks/knowledge-hint-narrow.cjs"
-  ]
-};
-var HOOK_CONFIG_TARGETS = {
-  claudeCode: ".claude/settings.json",
-  codex: ".codex/hooks.json",
-  cursor: ".cursor/hooks.json"
-};
-var HOOK_CONFIG_ARRAY_PATHS = {
-  claudeCode: ["hooks.Stop", "hooks.SessionStart", "hooks.PreToolUse"],
-  codex: ["events.Stop", "events.SessionStart", "events.PreToolUse"],
-  cursor: ["hooks.stop", "hooks.sessionStart", "hooks.preToolUse"]
-};
-var FABRIC_HOOK_COMMAND_PATHS = {
-  claudeCode: {
-    fabricHint: ".claude/hooks/fabric-hint.cjs",
-    knowledgeHintBroad: ".claude/hooks/knowledge-hint-broad.cjs",
-    knowledgeHintNarrow: ".claude/hooks/knowledge-hint-narrow.cjs"
-  },
-  codex: {
-    fabricHint: ".codex/hooks/fabric-hint.cjs",
-    knowledgeHintBroad: ".codex/hooks/knowledge-hint-broad.cjs",
-    knowledgeHintNarrow: ".codex/hooks/knowledge-hint-narrow.cjs"
-  },
-  cursor: {
-    fabricHint: ".cursor/hooks/fabric-hint.cjs",
-    knowledgeHintBroad: ".cursor/hooks/knowledge-hint-broad.cjs",
-    knowledgeHintNarrow: ".cursor/hooks/knowledge-hint-narrow.cjs"
-  }
-};
-var SECTION_TARGETS = ["CLAUDE.md", "AGENTS.md", join(".cursor", "rules")];
-var FABRIC_SECTION_BEGIN_MARKER = "<!-- fabric:knowledge-base:begin -->";
-var FABRIC_SECTION_END_MARKER = "<!-- fabric:knowledge-base:end -->";
-var FABRIC_SECTION_REGEX = /(?:\r?\n){0,2}<!-- fabric:knowledge-base:begin -->[\s\S]*?<!-- fabric:knowledge-base:end -->/;
-function readFabricLanguagePreference(projectRoot) {
-  const configPath = join(projectRoot, ".fabric", "fabric-config.json");
-  if (!existsSync(configPath)) {
-    return "match-existing";
-  }
-  try {
-    const raw = readFileSync(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return "match-existing";
-    }
-    const value = parsed["fabric_language"];
-    return typeof value === "string" && value.length > 0 ? value : "match-existing";
-  } catch {
-    return "match-existing";
-  }
-}
-function buildFabricKnowledgeBaseSection(fabricLanguage) {
-  return `${FABRIC_SECTION_BEGIN_MARKER}
-
-## Fabric Knowledge Base
-
-This project uses Fabric for persistent project knowledge under \`.fabric/knowledge/\`.
-
-- **Discovery**: SessionStart lists available entries (broad menu); editing files may surface narrow hints
-- **Usage**: call \`fab_get_knowledge_sections\` to fetch full content of any entry by id
-- **Write flows**: see fabric-archive (record), fabric-review (validate), fabric-import (backfill) Skills
-- **Language**: rendered per \`fabric_language\` in \`.fabric/fabric-config.json\` (current: \`${fabricLanguage}\`)
-
-${FABRIC_SECTION_END_MARKER}`;
-}
-async function installFabricArchiveSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_TEMPLATE_REL);
-  const targets = SKILL_DESTINATIONS.fabricArchive.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    results.push(await copyTextIdempotent("skill", source, target));
-  }
-  return results;
-}
-async function installFabricReviewSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_REVIEW_TEMPLATE_REL);
-  const targets = SKILL_DESTINATIONS.fabricReview.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    results.push(await copyTextIdempotent("skill-review", source, target));
-  }
-  return results;
-}
-async function installFabricImportSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_IMPORT_TEMPLATE_REL);
-  const targets = SKILL_DESTINATIONS.fabricImport.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    results.push(await copyTextIdempotent("skill-import", source, target));
-  }
-  return results;
-}
-async function installArchiveHintHook(projectRoot, _options = {}) {
-  const source = await readTemplate(HOOK_SCRIPT_TEMPLATE_REL);
-  const targets = HOOK_SCRIPT_DESTINATIONS.fabricHint.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const result = await copyTextIdempotent("hook-script", source, target);
-    if (result.status === "written" && process.platform !== "win32") {
-      try {
-        chmodSync(target, 493);
-      } catch {
-      }
-    }
-    results.push(result);
-  }
-  return results;
-}
-async function installKnowledgeHintBroadHook(projectRoot, _options = {}) {
-  const source = await readTemplate(HOOK_BROAD_SCRIPT_TEMPLATE_REL);
-  const targets = HOOK_SCRIPT_DESTINATIONS.knowledgeHintBroad.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const result = await copyTextIdempotent("hook-broad-script", source, target);
-    if (result.status === "written" && process.platform !== "win32") {
-      try {
-        chmodSync(target, 493);
-      } catch {
-      }
-    }
-    results.push(result);
-  }
-  return results;
-}
-async function installKnowledgeHintNarrowHook(projectRoot, _options = {}) {
-  const source = await readTemplate(HOOK_NARROW_SCRIPT_TEMPLATE_REL);
-  const targets = HOOK_SCRIPT_DESTINATIONS.knowledgeHintNarrow.map((rel) => join(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const result = await copyTextIdempotent("hook-narrow-script", source, target);
-    if (result.status === "written" && process.platform !== "win32") {
-      try {
-        chmodSync(target, 493);
-      } catch {
-      }
-    }
-    results.push(result);
-  }
-  return results;
-}
-async function mergeClaudeCodeHookConfig(projectRoot, _options = {}) {
-  const fragment = await readJsonTemplate(CLAUDE_HOOK_CONFIG_TEMPLATE_REL);
-  const targetPath = join(projectRoot, HOOK_CONFIG_TARGETS.claudeCode);
-  return mergeJsonIdempotent(
-    "claude-hook-config",
-    targetPath,
-    fragment,
-    [...HOOK_CONFIG_ARRAY_PATHS.claudeCode]
-  );
-}
-async function mergeCodexHookConfig(projectRoot, _options = {}) {
-  const fragment = await readJsonTemplate(CODEX_HOOK_CONFIG_TEMPLATE_REL);
-  const targetPath = join(projectRoot, HOOK_CONFIG_TARGETS.codex);
-  return mergeJsonIdempotent(
-    "codex-hook-config",
-    targetPath,
-    fragment,
-    [...HOOK_CONFIG_ARRAY_PATHS.codex]
-  );
-}
-async function mergeCursorHookConfig(projectRoot, _options = {}) {
-  const fragment = await readJsonTemplate(CURSOR_HOOK_CONFIG_TEMPLATE_REL);
-  const targetPath = join(projectRoot, HOOK_CONFIG_TARGETS.cursor);
-  return mergeJsonIdempotent(
-    "cursor-hook-config",
-    targetPath,
-    fragment,
-    [...HOOK_CONFIG_ARRAY_PATHS.cursor]
-  );
-}
-async function addFabricKnowledgeBaseSection(projectRoot, fabricLanguage, _options = {}) {
-  const sectionBody = buildFabricKnowledgeBaseSection(fabricLanguage);
-  const results = [];
-  for (const rel of SECTION_TARGETS) {
-    const target = join(projectRoot, rel);
-    if (!existsSync(target)) {
-      results.push({ step: "section", path: target, status: "skipped", message: "absent" });
-      continue;
-    }
-    let existing;
-    try {
-      existing = await readFile(target, "utf8");
-    } catch (error) {
-      results.push({
-        step: "section",
-        path: target,
-        status: "error",
-        message: error instanceof Error ? error.message : String(error)
-      });
-      continue;
-    }
-    let next;
-    const match = existing.match(FABRIC_SECTION_REGEX);
-    if (match !== null) {
-      const before = existing.slice(0, match.index ?? 0);
-      const after = existing.slice((match.index ?? 0) + match[0].length);
-      const stripped = `${before}${after.replace(/^\r?\n/, "")}`;
-      const trailingNewline = stripped.length === 0 || stripped.endsWith("\n") ? "" : "\n";
-      next = `${stripped}${trailingNewline}
-${sectionBody}
-`;
-    } else {
-      const trailingNewline = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
-      next = `${existing}${trailingNewline}
-${sectionBody}
-`;
-    }
-    if (next === existing) {
-      results.push({ step: "section", path: target, status: "skipped", message: "up-to-date" });
-      continue;
-    }
-    try {
-      await atomicWriteText(target, next);
-      results.push({ step: "section", path: target, status: "written" });
-    } catch (error) {
-      results.push({
-        step: "section",
-        path: target,
-        status: "error",
-        message: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
-  return results;
-}
-async function copyTextIdempotent(step, source, target) {
-  if (existsSync(target)) {
-    try {
-      const existing = readFileSync(target, "utf8");
-      if (existing === source) {
-        return { step, path: target, status: "skipped", message: "up-to-date" };
-      }
-    } catch {
-    }
-  }
-  await mkdir(dirname(target), { recursive: true });
-  await atomicWriteText(target, source);
-  return { step, path: target, status: "written" };
-}
-async function mergeJsonIdempotent(step, target, fragment, arrayAppendPaths) {
-  const existing = await readJsonObjectOrEmpty(target);
-  const merged = deepMerge(existing, fragment, { arrayAppendPaths });
-  if (jsonEqual(existing, merged)) {
-    return { step, path: target, status: "skipped", message: "up-to-date" };
-  }
-  await mkdir(dirname(target), { recursive: true });
-  await atomicWriteJson(target, merged, { indent: 2 });
-  return { step, path: target, status: "written" };
-}
-async function readJsonObjectOrEmpty(path) {
-  try {
-    const raw = await readFile(path, "utf8");
-    if (raw.trim().length === 0) {
-      return {};
-    }
-    const parsed = JSON.parse(raw);
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return {};
-    }
-    return parsed;
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return {};
-    }
-    throw error;
-  }
-}
-function jsonEqual(a, b) {
-  return JSON.stringify(a) === JSON.stringify(b);
-}
-async function readTemplate(relativePath) {
-  const path = findTemplatePath(relativePath);
-  return readFile(path, "utf8");
-}
-async function readJsonTemplate(relativePath) {
-  const raw = await readTemplate(relativePath);
-  const parsed = JSON.parse(raw);
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`Template at ${relativePath} is not a JSON object`);
-  }
-  return parsed;
-}
-function findTemplatePath(relativePath) {
-  const startDir = dirname(fileURLToPath(import.meta.url));
-  let current = resolve(startDir);
-  while (true) {
-    const candidate = join(current, "templates", relativePath);
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-    const parent = dirname(current);
-    if (parent === current || parse(current).root === current) {
-      throw new Error(`Template not found: templates/${relativePath} (searched up from ${startDir})`);
-    }
-    current = parent;
-  }
-}
-
-export {
-  SKILL_DESTINATIONS,
-  HOOK_SCRIPT_DESTINATIONS,
-  HOOK_CONFIG_TARGETS,
-  HOOK_CONFIG_ARRAY_PATHS,
-  FABRIC_HOOK_COMMAND_PATHS,
-  SECTION_TARGETS,
-  FABRIC_SECTION_REGEX,
-  readFabricLanguagePreference,
-  installFabricArchiveSkill,
-  installFabricReviewSkill,
-  installFabricImportSkill,
-  installArchiveHintHook,
-  installKnowledgeHintBroadHook,
-  installKnowledgeHintNarrowHook,
-  mergeClaudeCodeHookConfig,
-  mergeCodexHookConfig,
-  mergeCursorHookConfig,
-  addFabricKnowledgeBaseSection
-};

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

@@ -1,59 +0,0 @@
-# { projectName } — Fabric Bootstrap Protocol
-
-## CORE RULES (DO NOT TRANSLATE)
-
-MUST: Treat this file as the Fabric Protocol bootstrap for this repository.
-MUST: Treat `.fabric/knowledge/` as the source of truth for all Fabric knowledge entries.
-MUST: Before ANY code reading, architecture planning, or logic modification, call `fab_plan_context(paths=[<target file>])`, then call `fab_get_knowledge_sections`.
-MUST: When creating or changing a knowledge entry, keep `.fabric/agents.meta.json` synchronized through Fabric tooling (never hand-edit).
-MUST: Preserve protected tokens exactly: `AGENTS.md`, `.fabric/knowledge/`, `.fabric/agents.meta.json`, `fab_plan_context`, `fab_get_knowledge_sections`, `knowledge sources`, `MUST`, `NEVER`.
-NEVER: Add import-style directive lines to this bootstrap file.
-NEVER: Put domain knowledge bodies, framework rules, or repository specifics in this file.
-NEVER: Create colocated `AGENTS.md` knowledge files under source directories.
-NEVER: Hand-edit anything under `.fabric/knowledge/pending/` outside of the proposal/review workflow.
-
-## 使用说明 / Explanation
-
-- 本文件只负责启动 Fabric Bootstrap Protocol，不承载项目业务知识。
-- 详细 bootstrap 说明位于 `.fabric/bootstrap/README.md`。
-- Detected framework kind: `{ frameworkKind }`.
-- This repository uses `knowledge mirroring`: source directories contain ZERO knowledge files, while `.fabric/knowledge/` holds all AI-facing constraints, organized by knowledge type.
-- 跨领域、根级知识应放在对应的 `.fabric/knowledge/{type}/` 子目录下。
-- If `.fabric/knowledge/` is empty after init, continue with the Fabric initialization flow before normal coding.
-
-## Knowledge layer (v2)
-
-Fabric v2 organises every AI-facing knowledge entry along three orthogonal axes: **type**, **maturity**, and **layer**. All entries live as flat markdown files with YAML frontmatter — no nesting, no implicit hierarchies.
-
-### 5 knowledge types
-
-Each entry lives in exactly one of these subdirectories of `.fabric/knowledge/`:
-
-- `decisions/` — architectural / design decisions (the "why" behind a choice, with rejected alternatives)
-- `pitfalls/` — known traps, footguns, and "do-not-do-X" lessons learned the hard way
-- `guidelines/` — actionable rules and conventions the AI should follow when generating or modifying code
-- `models/` — domain models, data shapes, and conceptual abstractions (entities, invariants)
-- `processes/` — multi-step workflows, runbooks, and operational sequences
-
-### 3 maturity levels
-
-The `maturity` frontmatter field expresses how trusted an entry is:
-
-- `draft` — newly captured, not yet reviewed; the AI may consult it but should treat it as provisional
-- `verified` — reviewed and confirmed correct in the current codebase; safe to rely on
-- `proven` — verified and battle-tested across multiple changes; treat as authoritative
-
-Promotion is one-way (`draft` → `verified` → `proven`); demotion happens only via the review workflow.
-
-### 2 layers (dual-root)
-
-Knowledge lives in two physical roots that share the same schema:
-
-- `~/.fabric/knowledge/` — **personal layer** (per-user, NOT committed). Entries here use the `KP-` stable_id prefix. Use this layer for individual preferences, scratch notes, and cross-project habits.
-- `<repo>/.fabric/knowledge/` — **team layer** (committed to the repo). Entries here use the `KT-` stable_id prefix. Use this layer for anything every contributor (human or AI) should respect.
-
-A given entry belongs to exactly one layer; layer-flip (KP ↔ KT) is the only legal mutation of stable_id.
-
-### Proposal staging: `pending/`
-
-`.fabric/knowledge/pending/` is the staging area for proposed entries awaiting review. The async-review workflow (`fabric-review` skill, rc.3) promotes pending entries into one of the 5 type subdirectories once accepted, or archives them on rejection. **Never** hand-edit files under `pending/` directly — use the proposal tooling.

package/templates/bootstrap/CLAUDE.md

@@ -1,8 +0,0 @@
-# Fabric Bootstrap
-- 主说明文档已收敛到 `.fabric/bootstrap/README.md`。
-- 项目级 bootstrap 入口仍然是 `AGENTS.md`。
-- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_knowledge_sections` 获取规则段落。
-MCP 和 doctor 会写入 `.fabric/events.jsonl`。
-- 规则 baseline 变更通过 `fabric doctor --fix` 接受。
-
-@AGENTS.md

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

@@ -1,6 +0,0 @@
-# Fabric Bootstrap
-- 主说明文档已收敛到 `.fabric/bootstrap/README.md`。
-- 此 header 仅用于把 Codex 引导到 Fabric 项目级规则入口。
-- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_knowledge_sections` 获取规则段落。
-MCP 和 doctor 会写入 `.fabric/events.jsonl`。
-- 规则 baseline 变更通过 `fabric doctor --fix` 接受。

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

@@ -1,10 +0,0 @@
----
-alwaysApply: true
-description: Fabric Protocol bootstrap rules
----
-
-# Fabric Bootstrap
-- 本项目使用 Fabric Protocol 管理规则。
-- **任何文件修改前**，必须先调 MCP tool `fab_plan_context(paths=[<被改文件>])`，再调 `fab_get_knowledge_sections` 获取规则段落。
-- 新建或调整 L1/L2 节点时，修改规则源文件后运行 `fabric doctor --fix` 接受 baseline，**严禁**直接编辑 `.fabric/agents.meta.json`。
-Fabric 会把 MCP 和 doctor 行为写入 `.fabric/events.jsonl`。