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

package/README.md

@@ -9,7 +9,7 @@
 3. 在目标项目运行 `fabric install`，完成一站式安装。
 4. 启动 `fabric serve`，再去客户端里验证 `fab_plan_context` 和 `fab_get_knowledge_sections`。
 
-`fabric install` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `install`、`doctor`、`serve`、`uninstall`、`config`（rc.15 起 `fab scan` 已折叠到 `fab doctor --rescan`）。
+`fabric install` 会自动准备 bootstrap、MCP 配置和 git hooks。公共命令面只保留 `install`、`doctor`、`serve`、`uninstall`、`config`（rc.23 起移除了 baseline scan 机制，知识库唯一合法来源是 Skill 路径：`fabric-archive` / `fabric-import` / `fabric-review`）。
 
 ## 常用命令
 
@@ -18,7 +18,6 @@
 - `fabric doctor --json`
 - `fabric doctor --strict`
 - `fabric doctor --fix`
-- `fabric doctor --rescan`（替代旧的 `fabric scan`）
 - `fabric serve`
 - `fabric uninstall`
 - `fabric config`（rc.16 起将提供配置面板；当前为占位提示）

package/dist/{chunk-4HC5ZK7H.js → chunk-AXKII55Y.js}

@@ -109,14 +109,14 @@ var HOOK_CONFIG_ARRAY_PATHS = {
 };
 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"
+    fabricHint: "${CLAUDE_PROJECT_DIR}/.claude/hooks/fabric-hint.cjs",
+    knowledgeHintBroad: "${CLAUDE_PROJECT_DIR}/.claude/hooks/knowledge-hint-broad.cjs",
+    knowledgeHintNarrow: "${CLAUDE_PROJECT_DIR}/.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"
+    fabricHint: '"$(git rev-parse --show-toplevel)/.codex/hooks/fabric-hint.cjs"',
+    knowledgeHintBroad: '"$(git rev-parse --show-toplevel)/.codex/hooks/knowledge-hint-broad.cjs"',
+    knowledgeHintNarrow: '"$(git rev-parse --show-toplevel)/.codex/hooks/knowledge-hint-narrow.cjs"'
   },
   cursor: {
     fabricHint: ".cursor/hooks/fabric-hint.cjs",

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

@@ -3,17 +3,6 @@
 // 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 directTarget = normalizeTarget(cliTarget, workspaceRoot);
@@ -51,7 +40,6 @@ function formatResolutionStep(source, value) {
 }
 
 export {
-  readFabricConfig,
   resolveDevMode,
   createDebugLogger
 };

package/dist/{chunk-KZ2YITOS.js → chunk-STLR2GHP.js}

@@ -12,7 +12,10 @@ 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 } from "@fenglimg/fabric-shared";
+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) {
@@ -33,6 +36,131 @@ function resolveServerPath(override) {
 }
 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 \`fab 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 \`fab 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",
@@ -45,7 +173,15 @@ var configCmd = defineCommand({
       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");

package/dist/{config-AYP5F72E.js → config-XGUUAYX6.js}

@@ -3,7 +3,7 @@ import {
   configCmd,
   config_default,
   installMcpClients
-} from "./chunk-KZ2YITOS.js";
+} from "./chunk-STLR2GHP.js";
 import "./chunk-MF3OTILQ.js";
 import "./chunk-6ICJICVU.js";
 export {

package/dist/{doctor-L6TIXXIX.js → doctor-R2E2XO6A.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  runInitScan
-} from "./chunk-FNO7CQDG.js";
 import {
   hasActionHint,
   paint,
@@ -13,7 +10,7 @@ import {
 } from "./chunk-6ICJICVU.js";
 import {
   resolveDevMode
-} from "./chunk-ZSESMG6L.js";
+} from "./chunk-COI5VDFU.js";
 
 // src/commands/doctor.ts
 import { confirm, isCancel } from "@clack/prompts";
@@ -21,6 +18,7 @@ import { defineCommand } from "citty";
 import {
   appendEventLedgerEvent,
   checkLockOrThrow,
+  enrichDescriptions,
   runDoctorApplyLint as runDoctorFixKnowledge,
   runDoctorCiteCoverage,
   runDoctorFix,
@@ -59,11 +57,6 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.json.description"),
       default: false
     },
-    rescan: {
-      type: "boolean",
-      description: t("cli.doctor.args.rescan.description"),
-      default: false
-    },
     strict: {
       type: "boolean",
       description: t("cli.doctor.args.strict.description"),
@@ -95,6 +88,24 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.client.description"),
       default: "all",
       valueHint: "cc|codex|cursor|all"
+    },
+    // rc.23 TASK-007 (a-C2): description-grade back-fill flag set. Read-side
+    // by default; `--auto` flips the writer arm on. Mutually exclusive with
+    // --fix / --fix-knowledge / --cite-coverage (different mutation surfaces).
+    "enrich-descriptions": {
+      type: "boolean",
+      description: t("cli.doctor.args.enrich-descriptions.description"),
+      default: false
+    },
+    auto: {
+      type: "boolean",
+      description: t("cli.doctor.args.auto.description"),
+      default: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: t("cli.doctor.args.dry-run.description"),
+      default: false
     }
   },
   async run({ args }) {
@@ -111,8 +122,27 @@ var doctorCommand = defineCommand({
     }
     const fixKnowledge = args["fix-knowledge"] === true;
     const fix = args.fix === true;
-    const rescan = args.rescan === true;
     const citeCoverage = args["cite-coverage"] === true;
+    const enrichDesc = args["enrich-descriptions"] === true;
+    if (enrichDesc) {
+      if (fix || fixKnowledge || citeCoverage) {
+        writeStderr(t("cli.doctor.errors.enrich-descriptions-mutex"));
+        process.exitCode = 1;
+        return;
+      }
+      const autoFlag = args.auto === true;
+      const dryRun = args["dry-run"] === true;
+      const report2 = await enrichDescriptions(resolution.target, {
+        auto: autoFlag,
+        dryRun
+      });
+      if (args.json === true) {
+        writeStdout(JSON.stringify(report2, null, 2));
+      } else {
+        renderEnrichDescriptionsReport(report2);
+      }
+      return;
+    }
     if (citeCoverage) {
       if (fix || fixKnowledge) {
         writeStderr(t("cli.doctor.errors.cite-coverage-mutex"));
@@ -145,9 +175,6 @@ var doctorCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
-    if (rescan) {
-      await runInitScan(resolution.target, { source: "doctor-rescan" });
-    }
     let fixKnowledgeReport = null;
     let fixReport = null;
     let report;
@@ -392,8 +419,40 @@ function renderCiteCoverageReport(report, jsonMode) {
       lines.push(`  ${label}: ${count}`);
     }
   }
+  if (report.none_reason_histogram !== void 0 && Object.keys(report.none_reason_histogram).length > 0) {
+    lines.push("");
+    lines.push(`### ${t("doctor.cite.section.noneReasons")}`);
+    for (const [reason, count] of Object.entries(report.none_reason_histogram)) {
+      const label = t(`doctor.cite.none.${reason}`);
+      lines.push(`  ${label}: ${count}`);
+    }
+  }
   writeStdout(lines.join("\n"));
 }
+function renderEnrichDescriptionsReport(report) {
+  const header = `${symbol.ok} ${paint.ai("fab doctor --enrich-descriptions")} mode=${report.mode}${report.dryRun ? " (dry-run)" : ""} scanned=${report.scanned} modified=${report.modified} skipped=${report.skipped}`;
+  writeStdout(header);
+  if (report.candidates.length === 0) {
+    writeStdout(t("doctor.enrich.allComplete"));
+    return;
+  }
+  writeStdout("");
+  for (const candidate of report.candidates) {
+    if (candidate.error !== void 0) {
+      writeStdout(`${symbol.error} ${candidate.path} \u2014 ${candidate.error}`);
+      continue;
+    }
+    const missing = candidate.missing.join(", ");
+    if (candidate.modified) {
+      const added = candidate.added_fields.join(", ");
+      writeStdout(
+        `${symbol.ok} ${candidate.path} \u2014 missing: ${missing} \u2192 added: ${added}`
+      );
+    } else {
+      writeStdout(`${symbol.warn} ${candidate.path} \u2014 missing: ${missing}`);
+    }
+  }
+}
 function parseSinceDuration(input) {
   const trimmed = input.trim();
   if (trimmed.length === 0) {

package/dist/index.js

@@ -11,19 +11,22 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-DNZXGFHJ.js").then((module) => module.default),
-  doctor: () => import("./doctor-L6TIXXIX.js").then((module) => module.default),
-  serve: () => import("./serve-6PPQX7AW.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-L2HEEOU3.js").then((module) => module.default),
-  config: () => import("./config-AYP5F72E.js").then((module) => module.default),
-  "plan-context-hint": () => import("./plan-context-hint-CFDGXHCA.js").then((module) => module.default)
+  install: () => import("./install-TDZYZV54.js").then((module) => module.default),
+  doctor: () => import("./doctor-R2E2XO6A.js").then((module) => module.default),
+  serve: () => import("./serve-NPCI342P.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-MQM6NUFM.js").then((module) => module.default),
+  config: () => import("./config-XGUUAYX6.js").then((module) => module.default),
+  "plan-context-hint": () => import("./plan-context-hint-KPGOW3QC.js").then((module) => module.default),
+  // v2.0.0-rc.23 TASK-014 (F8c): S5 onboard-slot coverage. Used by the
+  // fabric-archive Skill's first-run phase to detect unclaimed slots.
+  "onboard-coverage": () => import("./onboard-coverage-JJ5NGU7I.js").then((module) => module.default)
 };
 
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.0-rc.21",
+    version: "2.0.0-rc.23",
     description: t("cli.main.description")
   },
   subCommands: allCommands