@fenglimg/fabric-cli 2.0.0 → 2.0.1

package/dist/doctor-T7JWODKG.js

@@ -1,282 +0,0 @@
-#!/usr/bin/env node
-import {
-  paint,
-  symbol
-} from "./chunk-WWNXR34K.js";
-import {
-  t
-} from "./chunk-6ICJICVU.js";
-import {
-  resolveDevMode
-} from "./chunk-OBQU6NHO.js";
-
-// src/commands/doctor.ts
-import { confirm, isCancel } from "@clack/prompts";
-import { defineCommand } from "citty";
-import {
-  appendEventLedgerEvent,
-  checkLockOrThrow,
-  runDoctorApplyLint,
-  runDoctorFix,
-  runDoctorReport
-} from "@fenglimg/fabric-server";
-var APPLY_LINT_CODE_LABELS = {
-  knowledge_orphan_demote_required: "demote (maturity)",
-  knowledge_stale_archive_required: "archive (git mv)",
-  knowledge_pending_auto_archive: "archive (git mv, pending)",
-  knowledge_index_drift: "counter bump (agents.meta)",
-  knowledge_session_hints_stale: "cache delete"
-};
-var PLAN_PREVIEW_LIMIT = 12;
-var doctorCommand = defineCommand({
-  meta: {
-    name: "doctor",
-    description: t("cli.doctor.description")
-  },
-  args: {
-    target: {
-      type: "string",
-      description: t("cli.doctor.args.target.description")
-    },
-    fix: {
-      type: "boolean",
-      description: t("cli.doctor.args.fix.description"),
-      default: false
-    },
-    json: {
-      type: "boolean",
-      description: t("cli.doctor.args.json.description"),
-      default: false
-    },
-    strict: {
-      type: "boolean",
-      description: t("cli.doctor.args.strict.description"),
-      default: false
-    },
-    force: {
-      type: "boolean",
-      description: t("cli.doctor.args.force.description"),
-      default: false
-    },
-    "apply-lint": {
-      type: "boolean",
-      description: t("cli.doctor.args.apply-lint.description"),
-      default: false
-    },
-    // rc.7 T11: skip the safety confirm before mutations. Required for any
-    // non-tty invocation that wants to run --apply-lint without setting
-    // FABRIC_NONINTERACTIVE=1 in the environment.
-    yes: {
-      type: "boolean",
-      description: t("cli.doctor.args.yes.description"),
-      default: false
-    }
-  },
-  async run({ args }) {
-    const workspaceRoot = process.cwd();
-    const resolution = resolveDevMode(args.target, workspaceRoot);
-    checkLockOrThrow(resolution.target, { force: args.force });
-    const applyLint = args["apply-lint"] === true;
-    const fix = args.fix === true;
-    if (applyLint && fix) {
-      writeStderr(t("cli.doctor.errors.apply-lint-fix-mutually-exclusive"));
-      process.exitCode = 1;
-      return;
-    }
-    let applyLintReport = null;
-    let fixReport = null;
-    let report;
-    if (applyLint) {
-      const preReport = await runDoctorReport(resolution.target);
-      const plan = computeApplyLintPlan(preReport);
-      const yesFlag = args.yes === true;
-      const envBypass = process.env.FABRIC_NONINTERACTIVE === "1";
-      if (plan.totalCount === 0) {
-      } else {
-        renderApplyLintPlan(plan);
-        const decision = await resolveApplyLintConsent({
-          yesFlag,
-          envBypass,
-          plan
-        });
-        if (decision === "abort") {
-          process.exitCode = 1;
-          return;
-        }
-      }
-      applyLintReport = await runDoctorApplyLint(resolution.target);
-      report = applyLintReport.report;
-    } else if (fix) {
-      fixReport = await runDoctorFix(resolution.target);
-      report = fixReport.report;
-    } else {
-      report = await runDoctorReport(resolution.target);
-    }
-    if (args.json === true) {
-      writeStdout(JSON.stringify(applyLintReport ?? fixReport ?? report, null, 2));
-    } else {
-      if (applyLintReport !== null) {
-        writeStdout(applyLintReport.message);
-        if (applyLintReport.aborted && applyLintReport.abort_reason !== void 0) {
-          writeStderr(applyLintReport.abort_reason);
-        }
-        renderApplyLintMutations(applyLintReport);
-      } else if (fixReport !== null) {
-        writeStdout(fixReport.message);
-      }
-      renderHumanReport(report);
-    }
-    await emitDoctorRunEventBestEffort(resolution.target, {
-      mode: applyLint ? "apply-lint" : "lint",
-      issues: report.fixable_errors.length + report.manual_errors.length + report.warnings.length,
-      mutations: applyLintReport !== null ? applyLintReport.mutations.filter((m) => m.applied).length : void 0
-    });
-    if (applyLintReport !== null) {
-      if (applyLintReport.aborted) {
-        process.exitCode = 1;
-        return;
-      }
-      if (applyLintReport.mutations.some((m) => !m.applied)) {
-        process.exitCode = 1;
-        return;
-      }
-    }
-    if (report.status === "error" || args.strict === true && (report.status === "warn" || report.warnings.length > 0)) {
-      process.exitCode = 1;
-    }
-  }
-});
-var doctor_default = doctorCommand;
-function renderHumanReport(report) {
-  writeStdout(`${renderStatus(report.status)} ${paint.ai("fabric doctor")} ${paint.human(report.summary.target)}`);
-  for (const check of report.checks) {
-    writeStdout(`${renderStatus(check.status)} ${check.name}: ${check.message}`);
-  }
-  writeIssueSection(t("doctor.section.fixable"), report.fixable_errors);
-  writeIssueSection(t("doctor.section.manual"), report.manual_errors);
-  writeIssueSection(t("doctor.section.warnings"), report.warnings);
-}
-function renderApplyLintMutations(applyLintReport) {
-  if (applyLintReport.mutations.length === 0) {
-    return;
-  }
-  writeStdout("");
-  writeStdout(t("doctor.section.apply-lint-mutations"));
-  for (const mutation of applyLintReport.mutations) {
-    const marker = mutation.applied ? symbol.ok : symbol.error;
-    const errSuffix = mutation.applied || mutation.error === void 0 ? "" : ` (${mutation.error})`;
-    writeStdout(`${marker} ${mutation.kind}: ${mutation.path} [${mutation.detail}]${errSuffix}`);
-  }
-}
-function writeIssueSection(title, issues) {
-  if (issues.length === 0) {
-    return;
-  }
-  writeStdout("");
-  writeStdout(title);
-  for (const issue of issues) {
-    writeStdout(`- ${issue.code}: ${issue.message}`);
-  }
-}
-function renderStatus(status) {
-  if (status === "ok") {
-    return symbol.ok;
-  }
-  if (status === "warn") {
-    return symbol.warn;
-  }
-  return symbol.error;
-}
-function writeStdout(message) {
-  process.stdout.write(`${message}
-`);
-}
-async function emitDoctorRunEventBestEffort(projectRoot, payload) {
-  try {
-    await appendEventLedgerEvent(projectRoot, {
-      event_type: "doctor_run",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      mode: payload.mode,
-      issues: payload.issues,
-      ...payload.mutations !== void 0 ? { mutations: payload.mutations } : {}
-    });
-  } catch {
-  }
-}
-function writeStderr(message) {
-  process.stderr.write(`${message}
-`);
-}
-function computeApplyLintPlan(report) {
-  const buckets = {};
-  const sources = [
-    ...report.fixable_errors,
-    ...report.warnings
-  ];
-  for (const issue of sources) {
-    if (APPLY_LINT_CODE_LABELS[issue.code] === void 0) continue;
-    if (!Array.isArray(buckets[issue.code])) {
-      buckets[issue.code] = [];
-    }
-    buckets[issue.code].push(issue);
-  }
-  const codes = Object.keys(buckets).sort(
-    (a, b) => APPLY_LINT_CODE_LABELS[a].localeCompare(APPLY_LINT_CODE_LABELS[b])
-  );
-  const perCodeLines = [];
-  let totalCount = 0;
-  for (const code of codes) {
-    const items = buckets[code];
-    totalCount += items.length;
-    perCodeLines.push(`  - ${APPLY_LINT_CODE_LABELS[code]}: ${items.length}`);
-  }
-  const previewLines = [];
-  const flattened = codes.flatMap((c) => buckets[c]);
-  for (const item of flattened.slice(0, PLAN_PREVIEW_LIMIT)) {
-    const where = item.path !== void 0 && item.path.length > 0 ? `${item.path}` : "(no path)";
-    previewLines.push(`    \u2022 ${where} \u2014 ${item.message}`);
-  }
-  if (flattened.length > PLAN_PREVIEW_LIMIT) {
-    previewLines.push(`    \u2022 ... and ${flattened.length - PLAN_PREVIEW_LIMIT} more`);
-  }
-  return { totalCount, perCodeLines, previewLines };
-}
-function renderApplyLintPlan(plan) {
-  writeStdout("");
-  writeStdout(`${paint.warn("apply-lint mutation plan")} (${plan.totalCount} total)`);
-  for (const line of plan.perCodeLines) {
-    writeStdout(line);
-  }
-  if (plan.previewLines.length > 0) {
-    writeStdout("");
-    writeStdout("  preview:");
-    for (const line of plan.previewLines) {
-      writeStdout(line);
-    }
-  }
-}
-async function resolveApplyLintConsent(options) {
-  if (options.yesFlag || options.envBypass) {
-    return "proceed";
-  }
-  if (process.stdin.isTTY !== true) {
-    writeStderr(
-      "doctor --apply-lint: stdin is not a TTY and neither --yes nor FABRIC_NONINTERACTIVE=1 is set. Refusing to mutate."
-    );
-    return "abort";
-  }
-  const message = `About to apply ${options.plan.totalCount} mutation(s) to knowledge entries (frontmatter writes + git mv + cache deletes). Proceed?`;
-  const answer = await confirm({
-    message,
-    initialValue: false
-  });
-  if (isCancel(answer) || answer !== true) {
-    writeStderr("doctor --apply-lint: aborted by user.");
-    return "abort";
-  }
-  return "proceed";
-}
-export {
-  doctor_default as default,
-  doctorCommand
-};

package/dist/hooks-Y74Y5LQS.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import {
-  hooksCommand,
-  hooks_default,
-  installHooks
-} from "./chunk-74SZWYPH.js";
-import "./chunk-6ICJICVU.js";
-export {
-  hooks_default as default,
-  hooksCommand,
-  installHooks
-};

package/dist/scan-LMK3UCWL.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-import {
-  __testing__,
-  createScanReport,
-  deriveTagsFromForensic,
-  formatKnowledgeId,
-  runInitScan,
-  scanCommand,
-  scan_default
-} from "./chunk-EYIDD2YS.js";
-import "./chunk-WWNXR34K.js";
-import "./chunk-6ICJICVU.js";
-import "./chunk-OBQU6NHO.js";
-export {
-  __testing__,
-  createScanReport,
-  scan_default as default,
-  deriveTagsFromForensic,
-  formatKnowledgeId,
-  runInitScan,
-  scanCommand
-};

package/dist/serve-H554BHLG.js

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-import {
-  paint,
-  symbol
-} from "./chunk-WWNXR34K.js";
-import {
-  t
-} from "./chunk-6ICJICVU.js";
-import {
-  createDebugLogger,
-  resolveDevMode
-} from "./chunk-OBQU6NHO.js";
-
-// src/commands/serve.ts
-import { defineCommand } from "citty";
-import { acquireLock, releaseLock, 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
-    },
-    force: {
-      type: "boolean",
-      description: t("cli.serve.args.force.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);
-    const projectRoot = resolution.target;
-    acquireLock(projectRoot, { force: args.force });
-    process.on("exit", () => {
-      releaseLock(projectRoot);
-    });
-    logger(`serve target source: ${resolution.source}`);
-    for (const step of resolution.chain) {
-      logger(step);
-    }
-    try {
-      await startHttpServer({
-        port,
-        projectRoot,
-        host,
-        authToken
-      });
-    } catch (error) {
-      if (isNodeError(error) && error.code === "EADDRINUSE") {
-        releaseLock(projectRoot);
-        throw new Error(t("cli.serve.error.port-in-use", { port: String(port), nextPort: String(port + 1) }));
-      }
-      releaseLock(projectRoot);
-      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/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`。