@fenglimg/fabric-cli 2.0.1 → 2.2.0-rc.1

package/dist/{doctor-EJDSEJSS.js → doctor-YONYXDX6.js}

@@ -2,14 +2,24 @@
 import {
   paint,
   symbol
-} from "./chunk-WWNXR34K.js";
+} from "./chunk-BO4XIZWZ.js";
 import {
   resolveDevMode
 } from "./chunk-COI5VDFU.js";
+import {
+  missingRequiredStores
+} from "./chunk-4R2CYEA4.js";
 import {
   getDoctorTranslator,
   t
-} from "./chunk-PWLW3B57.js";
+} from "./chunk-2CY4BMTH.js";
+import {
+  loadProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  loadGlobalConfig,
+  resolveGlobalRoot
+} from "./chunk-RYAFBNES.js";
 
 // src/commands/doctor.ts
 import { confirm, isCancel } from "@clack/prompts";
@@ -24,6 +34,53 @@ import {
   runDoctorHistoryAll,
   runDoctorReport
 } from "@fenglimg/fabric-server";
+
+// src/store/doctor-checks.ts
+import { join } from "path";
+import { findStoreExecutableViolations, storeRelativePath } from "@fenglimg/fabric-shared";
+function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const diagnostics = [];
+  const global = loadGlobalConfig(globalRoot);
+  if (global === null) {
+    diagnostics.push({
+      code: "no_global_config",
+      severity: "warn",
+      message: "no global Fabric config \u2014 run `fabric install --global <url>`"
+    });
+    return diagnostics;
+  }
+  for (const missing of missingRequiredStores(projectRoot, globalRoot)) {
+    diagnostics.push({
+      code: "missing_required_store",
+      severity: "warn",
+      ref: missing.id,
+      message: `required store '${missing.id}' is not mounted; run \`fabric store add\``
+    });
+  }
+  for (const store of global.stores) {
+    if (store.remote === void 0 && store.personal !== true) {
+      diagnostics.push({
+        code: "local_only_store",
+        severity: "info",
+        ref: store.alias,
+        message: `store '${store.alias}' is local-only; add a git remote to back it up`
+      });
+    }
+    const violations = findStoreExecutableViolations(join(globalRoot, storeRelativePath(store.store_uuid)));
+    if (violations.length > 0) {
+      diagnostics.push({
+        code: "executable_in_store",
+        severity: "warn",
+        ref: store.alias,
+        message: `store '${store.alias}' contains executable/script files (${violations.slice(0, 3).join(", ")}${violations.length > 3 ? ", \u2026" : ""}) \u2014 stores are data-only; Fabric never runs them (S65)`
+      });
+    }
+  }
+  return diagnostics;
+}
+
+// src/commands/doctor.ts
+import { buildDebugBundle } from "@fenglimg/fabric-shared";
 var FIX_KNOWLEDGE_CODE_LABELS = {
   knowledge_orphan_demote_required: "demote (maturity)",
   knowledge_stale_archive_required: "archive (git mv)",
@@ -62,6 +119,14 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.strict.description"),
       default: false
     },
+    // v2.1.0-rc.1 P6 (S40): emit a redacted diagnostic bundle (config + store
+    // diagnostics; events excluded by default). Every string is secret-redacted
+    // so the bundle is safe to paste into a bug report. Read-only.
+    "debug-bundle": {
+      type: "boolean",
+      description: "Emit a redacted diagnostic bundle (config + store health) for bug reports",
+      default: false
+    },
     // rc.7 T11: skip the safety confirm before mutations. Required for any
     // non-tty invocation that wants to run --fix-knowledge without setting
     // FABRIC_NONINTERACTIVE=1 in the environment.
@@ -154,6 +219,24 @@ var doctorCommand = defineCommand({
     const citeCoverage = args["cite-coverage"] === true;
     const enrichDesc = args["enrich-descriptions"] === true;
     const archiveHistory = args["archive-history"] === true;
+    if (args["debug-bundle"] === true) {
+      const globalRoot = resolveGlobalRoot();
+      let config = {};
+      try {
+        config = {
+          global: loadGlobalConfig(globalRoot) ?? null,
+          project: loadProjectConfig(resolution.target) ?? null
+        };
+      } catch {
+        config = {};
+      }
+      const bundle = buildDebugBundle({
+        config,
+        diagnostics: collectStoreDiagnostics(resolution.target)
+      });
+      writeStdout(JSON.stringify(bundle, null, 2));
+      return;
+    }
     if (args.since !== void 0) {
       try {
         parseSinceDuration(args.since);
@@ -290,23 +373,30 @@ var doctorCommand = defineCommand({
     if (fixKnowledge) {
       const preReport = await runDoctorReport(resolution.target);
       const plan = computeFixKnowledgePlan(preReport);
-      const yesFlag = args.yes === true;
-      const envBypass = process.env.FABRIC_NONINTERACTIVE === "1";
-      if (plan.totalCount === 0) {
+      if (args["dry-run"] === true) {
+        if (plan.totalCount > 0) {
+          renderFixKnowledgePlan(plan);
+        }
+        report = preReport;
       } else {
-        renderFixKnowledgePlan(plan);
-        const decision = await resolveFixKnowledgeConsent({
-          yesFlag,
-          envBypass,
-          plan
-        });
-        if (decision === "abort") {
-          process.exitCode = 1;
-          return;
+        const yesFlag = args.yes === true;
+        const envBypass = process.env.FABRIC_NONINTERACTIVE === "1";
+        if (plan.totalCount === 0) {
+        } else {
+          renderFixKnowledgePlan(plan);
+          const decision = await resolveFixKnowledgeConsent({
+            yesFlag,
+            envBypass,
+            plan
+          });
+          if (decision === "abort") {
+            process.exitCode = 1;
+            return;
+          }
         }
+        fixKnowledgeReport = await runDoctorFixKnowledge(resolution.target);
+        report = fixKnowledgeReport.report;
       }
-      fixKnowledgeReport = await runDoctorFixKnowledge(resolution.target);
-      report = fixKnowledgeReport.report;
     } else if (fix) {
       if (args["dry-run"] === true) {
         report = await runDoctorReport(resolution.target);
@@ -317,8 +407,15 @@ var doctorCommand = defineCommand({
     } else {
       report = await runDoctorReport(resolution.target);
     }
+    const storeDiagnostics = collectStoreDiagnostics(resolution.target);
     if (args.json === true) {
-      writeStdout(JSON.stringify(fixKnowledgeReport ?? fixReport ?? report, null, 2));
+      writeStdout(
+        JSON.stringify(
+          { ...fixKnowledgeReport ?? fixReport ?? report, store_diagnostics: storeDiagnostics },
+          null,
+          2
+        )
+      );
     } else {
       if (fixKnowledgeReport !== null) {
         writeStdout(fixKnowledgeReport.message);
@@ -328,10 +425,11 @@ var doctorCommand = defineCommand({
         renderFixKnowledgeMutations(fixKnowledgeReport, dt);
       } else if (fixReport !== null) {
         writeStdout(fixReport.message);
-      } else if (fix && args["dry-run"] === true) {
+      } else if ((fix || fixKnowledge) && args["dry-run"] === true) {
         writeStdout(dt("cli.doctor.fix-dry-run-banner"));
       }
       renderHumanReport(report, dt, args.verbose === true);
+      renderStoreDiagnostics(storeDiagnostics);
     }
     await emitDoctorRunEventBestEffort(resolution.target, {
       mode: fixKnowledge ? "fix-knowledge" : "lint",
@@ -356,7 +454,7 @@ var doctorCommand = defineCommand({
 var doctor_default = doctorCommand;
 function renderHumanReport(report, dt, verbose) {
   writeStdout(`${renderStatus(report.status)} ${paint.ai("fabric doctor")} ${paint.human(report.summary.target)}`);
-  renderTldrHeader(report);
+  renderTldrHeader(report, dt, verbose);
   for (const check of report.checks) {
     writeStdout(`${renderStatus(check.status)} ${check.name}: ${check.message}`);
   }
@@ -366,6 +464,25 @@ function renderHumanReport(report, dt, verbose) {
   writeIssueSection(dt("doctor.section.warnings"), report.warnings, opts);
   renderPayloadLimits(report, dt);
 }
+function collectStoreDiagnostics(projectRoot) {
+  try {
+    return storeDoctorChecks(projectRoot);
+  } catch {
+    return [];
+  }
+}
+function renderStoreDiagnostics(diagnostics) {
+  if (diagnostics.length === 0) {
+    return;
+  }
+  writeStdout("");
+  writeStdout(paint.ai("store health"));
+  for (const diagnostic of diagnostics) {
+    const mark = diagnostic.severity === "warn" ? symbol.warn : "[info]";
+    const ref = diagnostic.ref === void 0 ? "" : ` [${diagnostic.ref}]`;
+    writeStdout(`${mark}${ref} ${diagnostic.message}`);
+  }
+}
 function renderPayloadLimits(report, dt) {
   const limits = report.summary.payload_limits;
   if (limits === void 0) {
@@ -410,16 +527,16 @@ function writeIssueSection(title, issues, options) {
     }
   }
 }
-function renderTldrHeader(report) {
+function renderTldrHeader(report, dt, verbose) {
   const ranked = [];
   for (const issue of report.fixable_errors) {
-    ranked.push({ severity: "fixable", code: issue.code, message: issue.message });
+    ranked.push({ severity: "fixable", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   for (const issue of report.manual_errors) {
-    ranked.push({ severity: "manual", code: issue.code, message: issue.message });
+    ranked.push({ severity: "manual", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   for (const issue of report.warnings) {
-    ranked.push({ severity: "warn", code: issue.code, message: issue.message });
+    ranked.push({ severity: "warn", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   if (ranked.length === 0) {
     writeStdout(`${symbol.ok} TL;DR: all 48 checks green \u2014 nothing to fix.`);
@@ -433,6 +550,11 @@ function renderTldrHeader(report) {
     const marker = item.severity === "fixable" ? symbol.error : item.severity === "manual" ? symbol.error : symbol.warn;
     const truncated = item.message.length > 140 ? `${item.message.slice(0, 137)}...` : item.message;
     writeStdout(`  ${marker} ${item.code}: ${truncated}`);
+    if (item.actionHint !== void 0 && item.actionHint.length > 0) {
+      writeStdout(
+        item.audience === "maintainer" && !verbose ? `    \u2192 ${dt("doctor.maintainer-hint-folded")}` : `    \u2192 ${item.actionHint}`
+      );
+    }
   }
 }
 function renderStatus(status) {
@@ -806,5 +928,6 @@ function formatTimestampForTable(iso) {
 export {
   doctor_default as default,
   doctorCommand,
-  parseSinceDuration
+  parseSinceDuration,
+  renderTldrHeader
 };

package/dist/index.js

@@ -1,39 +1,87 @@
 #!/usr/bin/env node
 import {
   t
-} from "./chunk-PWLW3B57.js";
+} from "./chunk-2CY4BMTH.js";
 
 // src/index.ts
 import { realpathSync } from "fs";
 import { resolve } from "path";
 import { fileURLToPath } from "url";
-import { defineCommand, runMain } from "citty";
+import { defineCommand, runCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-EKWMFLUU.js").then((module) => module.default),
-  doctor: () => import("./doctor-EJDSEJSS.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-MH7ZIB6M.js").then((module) => module.default),
-  config: () => import("./config-XJIPZNUP.js").then((module) => module.default),
+  install: () => import("./install-74ANPCCP.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3: multi-store lifecycle command group (list/add/remove/explain).
+  store: () => import("./store-XB3ADT65.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3 (S9/S17/S37): multi-store pull --rebase + push, conflict resume.
+  sync: () => import("./sync-UJ4BBCZJ.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3 (F5): read-only identity/status info commands.
+  whoami: () => import("./whoami-2MLO4Y37.js").then((module) => module.default),
+  status: () => import("./status-GLQWLWH6.js").then((module) => module.default),
+  "scope-explain": () => import("./scope-explain-CDIZESP5.js").then((module) => module.default),
+  doctor: () => import("./doctor-YONYXDX6.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-C3QXKOO6.js").then((module) => module.default),
+  config: () => import("./config-XYRBZJDU.js").then((module) => module.default),
   "plan-context-hint": () => import("./plan-context-hint-FC6P3WFE.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-MFCAEBDO.js").then((module) => module.default),
+  "onboard-coverage": () => import("./onboard-coverage-JWQWDZW7.js").then((module) => module.default),
   // v2.0.0-rc.37 NEW-34: text dashboard over .fabric/metrics.jsonl.
-  metrics: () => import("./metrics-ACEQFPDU.js").then((module) => module.default)
+  metrics: () => import("./metrics-RER6NLFC.js").then((module) => module.default)
 };
 
+// src/lib/error-render.ts
+function hasActionHint(err) {
+  if (err === null || typeof err !== "object") return false;
+  const candidate = err;
+  return typeof candidate.message === "string" && candidate.message.length > 0 && typeof candidate.actionHint === "string" && candidate.actionHint.length > 0;
+}
+function renderFabricError(err, stream = process.stderr) {
+  stream.write(`${err.message}
+`);
+  stream.write(`  -> ${err.actionHint}
+`);
+}
+function renderTopLevelError(err, stream = process.stderr) {
+  if (hasActionHint(err)) {
+    renderFabricError(err, stream);
+    return "fabric-error";
+  }
+  return "other";
+}
+
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.1",
+    version: "2.2.0-rc.1",
     description: t("cli.main.description")
   },
   subCommands: allCommands
 });
 async function run() {
-  await runMain(main);
+  const rawArgs = process.argv.slice(2);
+  const wantsHelp = rawArgs.some((arg) => arg === "--help" || arg === "-h");
+  const wantsVersion = rawArgs.length === 1 && (rawArgs[0] === "--version" || rawArgs[0] === "-v");
+  if (wantsHelp || wantsVersion) {
+    await runMain(main, { rawArgs });
+    return;
+  }
+  try {
+    await runCommand(main, { rawArgs });
+  } catch (err) {
+    if (renderTopLevelError(err) === "fabric-error") {
+      process.exit(1);
+    }
+    const code = err !== null && typeof err === "object" ? err.code : void 0;
+    if (typeof code === "string" && code.startsWith("E_")) {
+      await runMain(main, { rawArgs });
+      return;
+    }
+    console.error(err, "\n");
+    process.exit(1);
+  }
 }
 var entrypoint = process.argv[1];
 var currentFilePath = fileURLToPath(import.meta.url);