@fenglimg/fabric-cli 2.0.0 → 2.1.0-rc.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangzhichao (fenglimg)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,24 +1,25 @@
 # @fenglimg/fabric-cli
 
-`fabric` 是 Fabric 的主命令，`fab` 是永久别名，两者等价。
+`fabric` 是 Fabric 的 CLI 主命令。
 
 ## 快速开始
 
 1. 在 monorepo 根目录运行 `pnpm install`。
 2. 用 `pnpm --filter @fenglimg/fabric-cli build` 构建 CLI。
-3. 在目标项目运行 `fabric init`，完成一站式初始化。
+3. 在目标项目运行 `fabric install`，完成一站式安装。
 4. 启动 `fabric serve`，再去客户端里验证 `fab_plan_context` 和 `fab_get_knowledge_sections`。
 
-`fabric init` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `init`、`scan`、`doctor`、`serve`。
+`fabric install` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `install`、`doctor`、`serve`、`uninstall`、`config`（rc.23 起移除了 baseline scan 机制，知识库唯一合法来源是 Skill 路径：`fabric-archive` / `fabric-import` / `fabric-review`）。
 
 ## 常用命令
 
-- `fabric init`
-- `fabric scan`
+- `fabric install`
 - `fabric doctor`
 - `fabric doctor --json`
 - `fabric doctor --strict`
 - `fabric doctor --fix`
 - `fabric serve`
+- `fabric uninstall`
+- `fabric config`（rc.16 起将提供配置面板；当前为占位提示）
 
 `fabric doctor --fix` 只修复确定性的派生状态，例如 `.fabric/agents.meta.json`、`.fabric/.cache/knowledge-test.index.json`、缺失的 `.fabric/events.jsonl` 和 stale hashes；语义冲突、缺失 rule section、未完成的初始化确认仍需要人工处理。

package/dist/chunk-BATF4PEJ.js

@@ -0,0 +1,361 @@
+#!/usr/bin/env node
+import {
+  resolveClients
+} from "./chunk-MF3OTILQ.js";
+import {
+  t
+} from "./chunk-PWLW3B57.js";
+
+// src/commands/config.ts
+import { existsSync, statSync } from "fs";
+import { readFile } from "fs/promises";
+import { join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { cancel, intro, isCancel, log, outro, select, text } from "@clack/prompts";
+import {
+  getPanelFields,
+  ONBOARD_SLOT_NAMES
+} from "@fenglimg/fabric-shared";
+import { atomicWriteJson } from "@fenglimg/fabric-shared/node/atomic-write";
+import { defineCommand } from "citty";
+async function loadFabricConfig(workspaceRoot) {
+  const configPath = resolve(workspaceRoot, "fabric.config.json");
+  if (!existsSync(configPath)) {
+    return {};
+  }
+  const parsed = JSON.parse(await readFile(configPath, "utf8"));
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(t("cli.config.errors.expected-object", { path: configPath }));
+  }
+  return parsed;
+}
+function resolveServerPath(override) {
+  if (override) return override;
+  if (process.env.FAB_SERVER_PATH) return resolve(process.env.FAB_SERVER_PATH);
+  return fileURLToPath(import.meta.resolve("@fenglimg/fabric-server"));
+}
+var PANEL_CONFIG_RELATIVE_PATH = [".fabric", "fabric-config.json"];
+var EXIT_CHOICE = "__exit__";
+async function readOnboardSlotsList(configPath) {
+  const raw = await readFile(configPath, "utf8");
+  const parsed = JSON.parse(raw);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(t("cli.config.errors.expected-object", { path: configPath }));
+  }
+  const obj = parsed;
+  const list = obj.onboard_slots_opted_out;
+  const optedOut = Array.isArray(list) ? list.filter((v) => typeof v === "string") : [];
+  return { config: obj, optedOut };
+}
+function ensureUninitGate(workspaceRoot) {
+  const configPath = join(workspaceRoot, ...PANEL_CONFIG_RELATIVE_PATH);
+  const fabricDir = join(workspaceRoot, ".fabric");
+  const fabricDirOk = existsSync(fabricDir) && statSync(fabricDir).isDirectory();
+  const configOk = fabricDirOk && existsSync(configPath);
+  if (!configOk) {
+    console.error(t("cli.config.errors.uninit-workspace.message"));
+    return null;
+  }
+  return configPath;
+}
+function validateSlotArg(slot) {
+  if (slot === void 0 || slot.length === 0) {
+    console.error(`Missing required <slot> argument. Valid slots: ${ONBOARD_SLOT_NAMES.join(", ")}.`);
+    return null;
+  }
+  if (!ONBOARD_SLOT_NAMES.includes(slot)) {
+    console.error(`Unknown slot "${slot}". Valid slots: ${ONBOARD_SLOT_NAMES.join(", ")}.`);
+    return null;
+  }
+  return slot;
+}
+var dismissSlotCmd = defineCommand({
+  meta: {
+    name: "dismiss-slot",
+    description: "Add an S5 onboard slot to the opted-out list (fabric-archive Skill onboard phase invokes this).",
+    hidden: true
+  },
+  args: {
+    slot: {
+      type: "positional",
+      description: "Slot name to dismiss (one of the locked S5 set).",
+      required: true
+    },
+    target: {
+      type: "string",
+      description: "Override the project root (defaults to cwd)."
+    }
+  },
+  async run({ args }) {
+    const slot = validateSlotArg(args.slot);
+    if (slot === null) {
+      process.exitCode = 1;
+      return;
+    }
+    const workspaceRoot = resolve(args.target ?? process.cwd());
+    const configPath = ensureUninitGate(workspaceRoot);
+    if (configPath === null) {
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const { config, optedOut } = await readOnboardSlotsList(configPath);
+      if (optedOut.includes(slot)) {
+        console.log(`Slot "${slot}" already opted out; no-op.`);
+        return;
+      }
+      const next = [...optedOut, slot];
+      const merged = { ...config, onboard_slots_opted_out: next };
+      await atomicWriteJson(configPath, merged);
+      console.log(`Dismissed onboard slot "${slot}". Run \`fabric config onboard-reset ${slot}\` to re-open.`);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(`dismiss-slot failed: ${message}`);
+      process.exitCode = 1;
+    }
+  }
+});
+var onboardResetCmd = defineCommand({
+  meta: {
+    name: "onboard-reset",
+    description: "Remove an S5 onboard slot from the opted-out list \u2014 re-opens the slot for future fabric-archive onboard prompts.",
+    hidden: true
+  },
+  args: {
+    slot: {
+      type: "positional",
+      description: "Slot name to reset (one of the locked S5 set).",
+      required: true
+    },
+    target: {
+      type: "string",
+      description: "Override the project root (defaults to cwd)."
+    }
+  },
+  async run({ args }) {
+    const slot = validateSlotArg(args.slot);
+    if (slot === null) {
+      process.exitCode = 1;
+      return;
+    }
+    const workspaceRoot = resolve(args.target ?? process.cwd());
+    const configPath = ensureUninitGate(workspaceRoot);
+    if (configPath === null) {
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const { config, optedOut } = await readOnboardSlotsList(configPath);
+      if (!optedOut.includes(slot)) {
+        console.log(`Slot "${slot}" not opted out; no-op.`);
+        return;
+      }
+      const next = optedOut.filter((s) => s !== slot);
+      const merged = { ...config, onboard_slots_opted_out: next };
+      await atomicWriteJson(configPath, merged);
+      console.log(`Reset onboard slot "${slot}"; it will appear in \`fabric onboard-coverage\` as missing again.`);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(`onboard-reset failed: ${message}`);
+      process.exitCode = 1;
+    }
+  }
+});
+var configCmd = defineCommand({
+  meta: {
+    name: "config",
+    description: t("cli.config.description")
+  },
+  args: {
+    target: {
+      type: "string",
+      description: t("cli.config.args.target.description"),
+      valueHint: "path"
+    }
+  },
+  subCommands: {
+    "dismiss-slot": dismissSlotCmd,
+    "onboard-reset": onboardResetCmd
+  },
+  async run({ args }) {
+    const argvSub = process.argv[3];
+    if (argvSub === "dismiss-slot" || argvSub === "onboard-reset") {
+      return;
+    }
+    const workspaceRoot = resolve(args.target ?? process.cwd());
+    const configPath = join(workspaceRoot, ...PANEL_CONFIG_RELATIVE_PATH);
+    const fabricDir = join(workspaceRoot, ".fabric");
+    const fabricDirOk = existsSync(fabricDir) && statSync(fabricDir).isDirectory();
+    const configOk = fabricDirOk && existsSync(configPath);
+    if (!configOk) {
+      console.error(t("cli.config.errors.uninit-workspace.message"));
+      process.exitCode = 1;
+      return;
+    }
+    if (!isInteractiveConfig()) {
+      console.log(t("cli.config.intro"));
+      console.log(t("cli.config.non-tty-notice"));
+      return;
+    }
+    intro(t("cli.config.intro"));
+    let edited = false;
+    while (true) {
+      const current = await readPanelConfig(configPath);
+      const fields = getPanelFields();
+      const fieldChoice = await select({
+        message: t("cli.config.menu.field-select"),
+        options: [
+          ...fields.map((field2) => ({
+            value: field2.key,
+            label: formatFieldMenuLabel(field2, current)
+          })),
+          { value: EXIT_CHOICE, label: t("cli.config.menu.exit") }
+        ]
+      });
+      if (isCancel(fieldChoice)) {
+        cancel(t("cli.config.cancel"));
+        return;
+      }
+      if (fieldChoice === EXIT_CHOICE) {
+        outro(edited ? t("cli.config.outro") : t("cli.config.outro-no-changes"));
+        return;
+      }
+      const field = fields.find((f) => f.key === fieldChoice);
+      if (!field) {
+        log.warn(t("cli.config.errors.unknown-field"));
+        continue;
+      }
+      const newValue = await promptFieldValue(field, current);
+      if (newValue === CANCELLED) {
+        cancel(t("cli.config.cancel"));
+        return;
+      }
+      if (newValue === SKIPPED) {
+        continue;
+      }
+      try {
+        const refreshed = await readPanelConfig(configPath);
+        const merged = { ...refreshed, [field.key]: newValue };
+        await atomicWriteJson(configPath, merged);
+        edited = true;
+        log.success(
+          t("cli.config.write.success", {
+            key: field.key,
+            value: field.format_for_display(newValue)
+          })
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error(t("cli.config.write.failure", { message }));
+      }
+    }
+  }
+});
+var config_default = configCmd;
+var CANCELLED = /* @__PURE__ */ Symbol("config-cancelled");
+var SKIPPED = /* @__PURE__ */ Symbol("config-skipped");
+async function promptFieldValue(field, current) {
+  const currentValue = current[field.key];
+  const currentDisplay = field.format_for_display(currentValue);
+  if (field.widget === "select") {
+    const enumValues = field.enum_values ?? [];
+    if (enumValues.length === 0) {
+      log.warn(t("cli.config.errors.no-enum-options"));
+      return SKIPPED;
+    }
+    const initialValue = enumValues.includes(String(currentValue)) ? String(currentValue) : enumValues.includes(String(field.default)) ? String(field.default) : enumValues[0];
+    const picked = await select({
+      message: t("cli.config.prompt.select", {
+        key: field.key,
+        current: currentDisplay
+      }),
+      options: enumValues.map((value) => ({ value, label: value })),
+      initialValue
+    });
+    if (isCancel(picked)) {
+      return CANCELLED;
+    }
+    const result = field.validate(String(picked));
+    if (!result.ok) {
+      log.error(result.error);
+      return SKIPPED;
+    }
+    return result.value;
+  }
+  const entered = await text({
+    message: t("cli.config.prompt.text", {
+      key: field.key,
+      current: currentDisplay
+    }),
+    placeholder: currentDisplay,
+    initialValue: currentDisplay,
+    validate(raw) {
+      const result = field.validate(raw ?? "");
+      return result.ok ? void 0 : result.error;
+    }
+  });
+  if (isCancel(entered)) {
+    return CANCELLED;
+  }
+  const finalResult = field.validate(String(entered));
+  if (!finalResult.ok) {
+    log.error(finalResult.error);
+    return SKIPPED;
+  }
+  return finalResult.value;
+}
+function formatFieldMenuLabel(field, current) {
+  const key = field.key;
+  const rawValue = current[key];
+  const display = field.format_for_display(rawValue);
+  const isDefault = rawValue === void 0 || rawValue === null;
+  const labelText = t(field.label_i18n_key);
+  const valueLabel = isDefault ? `${display} ${t("cli.config.value.default-marker")}` : display;
+  return `[${field.group}] ${key} (${labelText}) \u2014 ${t("cli.config.value.current", { value: valueLabel })}`;
+}
+async function readPanelConfig(configPath) {
+  const raw = await readFile(configPath, "utf8");
+  const parsed = JSON.parse(raw);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(t("cli.config.errors.expected-object", { path: configPath }));
+  }
+  return parsed;
+}
+function isInteractiveConfig() {
+  return Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY) && Boolean(process.stderr.isTTY);
+}
+async function installMcpClients(target, options = {}) {
+  const workspaceRoot = resolve(target);
+  const fabricConfig = await loadFabricConfig(workspaceRoot);
+  const selectedClients = options.clients === void 0 ? null : new Set(options.clients);
+  const serverPath = resolveServerPath(options.localServerPath);
+  const writers = resolveClients(workspaceRoot, fabricConfig, { claudeMcpScope: options.claudeMcpScope }).filter(
+    (writer) => selectedClients === null ? true : selectedClients.has(writer.clientKind)
+  );
+  const installed = [];
+  const skipped = [];
+  const details = [];
+  for (const writer of writers) {
+    const configPath = await writer.detect(workspaceRoot);
+    if (configPath === null) {
+      skipped.push(writer.clientKind);
+      details.push({ client: writer.clientKind, path: null, action: "skipped" });
+      continue;
+    }
+    if (options.dryRun) {
+      skipped.push(writer.clientKind);
+      details.push({ client: writer.clientKind, path: configPath, action: "dry-run" });
+      continue;
+    }
+    await writer.write(serverPath, workspaceRoot);
+    installed.push(writer.clientKind);
+    details.push({ client: writer.clientKind, path: configPath, action: "wrote" });
+  }
+  return { installed, skipped, details };
+}
+
+export {
+  configCmd,
+  config_default,
+  installMcpClients
+};

package/dist/{chunk-OBQU6NHO.js → chunk-COI5VDFU.js}

@@ -3,26 +3,12 @@
 // src/dev-mode.ts
 import { existsSync, readFileSync } from "fs";
 import { isAbsolute, join, resolve } from "path";
-function readFabricConfig(workspaceRoot = process.cwd()) {
-  const configPath = join(workspaceRoot, "fabric.config.json");
-  if (!existsSync(configPath)) {
-    return {};
-  }
-  const parsed = JSON.parse(readFileSync(configPath, "utf8"));
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`Expected object in ${configPath}`);
-  }
-  return parsed;
-}
 function resolveDevMode(cliTarget, workspaceRoot = process.cwd()) {
   const envTarget = normalizeTarget(process.env.EXTERNAL_FIXTURE_PATH, workspaceRoot);
-  const fabricConfig = readFabricConfig(workspaceRoot);
-  const configTarget = normalizeTarget(fabricConfig.externalFixturePath, workspaceRoot);
   const directTarget = normalizeTarget(cliTarget, workspaceRoot);
   const chain = [
     formatResolutionStep("cliTarget", directTarget),
     formatResolutionStep("EXTERNAL_FIXTURE_PATH", envTarget),
-    formatResolutionStep("fabric.config.json.externalFixturePath", configTarget),
     formatResolutionStep("process.cwd()", workspaceRoot)
   ];
   if (directTarget !== void 0) {
@@ -31,9 +17,6 @@ function resolveDevMode(cliTarget, workspaceRoot = process.cwd()) {
   if (envTarget !== void 0) {
     return { target: envTarget, source: "env", chain };
   }
-  if (configTarget !== void 0) {
-    return { target: configTarget, source: "config", chain };
-  }
   return { target: workspaceRoot, source: "cwd", chain };
 }
 function createDebugLogger(debug) {
@@ -57,7 +40,6 @@ function formatResolutionStep(source, value) {
 }
 
 export {
-  readFabricConfig,
   resolveDevMode,
   createDebugLogger
 };