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

package/dist/doctor-S6KPGS35.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {
+  doctorCommand,
+  doctor_default,
+  renderDoctorChecks,
+  renderDoctorFilteredHelp,
+  renderDoctorHeader,
+  renderDoctorStoreHealth,
+  renderTldrHeader
+} from "./chunk-PP7QVRXH.js";
+import "./chunk-VQKXTMWH.js";
+import "./chunk-WA3DYGSY.js";
+import "./chunk-SL77FXX7.js";
+import "./chunk-GGDVZCD6.js";
+import "./chunk-7V4XMLQ2.js";
+import "./chunk-I5F5BHWI.js";
+import "./chunk-FNHDQTPC.js";
+import "./chunk-HORSMSZL.js";
+export {
+  doctor_default as default,
+  doctorCommand,
+  renderDoctorChecks,
+  renderDoctorFilteredHelp,
+  renderDoctorHeader,
+  renderDoctorStoreHealth,
+  renderTldrHeader
+};

package/dist/index.js

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 import {
   renderDoctorFilteredHelp
-} from "./chunk-E7HJUU34.js";
-import "./chunk-3D7B2UAZ.js";
+} from "./chunk-PP7QVRXH.js";
+import "./chunk-VQKXTMWH.js";
 import "./chunk-WA3DYGSY.js";
-import "./chunk-NLNH64A3.js";
-import "./chunk-PTGQAZEW.js";
-import "./chunk-EOT63RDH.js";
-import "./chunk-QPAW6IYT.js";
-import "./chunk-QFIVFZRH.js";
+import {
+  paint,
+  symbol
+} from "./chunk-SL77FXX7.js";
+import "./chunk-GGDVZCD6.js";
+import "./chunk-7V4XMLQ2.js";
+import "./chunk-I5F5BHWI.js";
 import "./chunk-FNHDQTPC.js";
 import {
   t
@@ -23,30 +25,32 @@ import { defineCommand, renderUsage, runCommand, runMain } from "citty";
 // src/commands/index.ts
 var allCommands = {
   // v2.2.0-rc.5: pipeline-based install with TUI renderer (EPIC-005/006/007/008)
-  install: () => import("./install-v2-3KJX3YRO.js").then((module) => module.installCommand),
+  install: () => import("./install-v2-KGIDII4H.js").then((module) => module.installCommand),
   // v2.1.0-rc.1 P3: multi-store lifecycle command group (list/add/remove/explain).
-  store: () => import("./store-HOCORVL3.js").then((module) => module.default),
+  store: () => import("./store-GF4SFBMJ.js").then((module) => module.default),
   // v2.1.0-rc.1 P3 (S9/S17/S37): multi-store pull --rebase + push, conflict resume.
-  sync: () => import("./sync-DT5UJMMR.js").then((module) => module.default),
-  // EPIC-010: Unified info command (replaces whoami/status/scope-explain).
-  info: () => import("./info-7FKBTMVO.js").then((module) => module.default),
-  // v2.1.0-rc.1 P3 (F5): read-only identity/status info commands.
-  // DEPRECATED: Use `fabric info` instead. These will be removed in v3.
-  whoami: () => import("./whoami-ITGEFWH4.js").then((module) => module.default),
-  status: () => import("./status-4R3TM4FJ.js").then((module) => module.default),
-  "scope-explain": () => import("./scope-explain-HLJZ2M33.js").then((module) => module.default),
-  doctor: () => import("./doctor-MDTZWKBK.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-IFN2KYBK.js").then((module) => module.default),
+  sync: () => import("./sync-3XCIRDPK.js").then((module) => module.default),
+  // EPIC-010: Unified info command (replaces the retired whoami/status aliases).
+  // W3-F: `info scope <coord>` is now a real subcommand (was the retired
+  // top-level `scope-explain` command); skills call `fabric info scope`.
+  info: () => import("./info-NJEY26H6.js").then((module) => module.default),
+  doctor: () => import("./doctor-S6KPGS35.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-BG4ML4FC.js").then((module) => module.default),
   config: () => import("./config-A3LTECAY.js").then((module) => module.default),
   "plan-context-hint": () => import("./plan-context-hint-5TNGH3R4.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-XSG77LL3.js").then((module) => module.default),
-  // v2.0.0-rc.37 NEW-34: text dashboard over .fabric/metrics.jsonl.
-  metrics: () => import("./metrics-HMFH4YHK.js").then((module) => module.default),
-  // Block 5 (Option X): show what SessionStart injects (shared renderer with the
-  // hook → byte-identical). --explain for per-entry provenance.
-  context: () => import("./context-UJCGYOT6.js").then((module) => module.default)
+  // W3-D (UX northstar): knowledge & telemetry audit group — the surfaces that
+  // used to ride on `fabric doctor --<flag>` (cite / conflicts / history /
+  // descriptions / metrics / retired). doctor now keeps only health + fix.
+  // W3-F: the metrics dashboard is reachable ONLY as `fabric audit metrics`
+  // (top-level `metrics` alias retired — metrics.ts lives on as that subcommand).
+  audit: () => import("./audit-PURSJJFH.js").then((module) => module.default),
+  // Block 5 (Option X) / W3-F: show what SessionStart injects (shared renderer
+  // with the hook → byte-identical). Renamed from `context`. --explain for
+  // per-entry provenance.
+  inspect: () => import("./inspect-5YZMJPFM.js").then((module) => module.default)
 };
 
 // src/lib/error-render.ts
@@ -64,59 +68,68 @@ function renderTopLevelError(err, stream = process.stderr) {
   }
   return "other";
 }
+function renderUnexpectedError(err, showStack, stream = process.stderr) {
+  const message = err instanceof Error ? err.message : String(err);
+  stream.write(`${symbol.error} ${paint.error(message)}
+`);
+  if (showStack && err instanceof Error && err.stack) {
+    stream.write(`${err.stack}
+`);
+  } else if (!showStack) {
+    stream.write(
+      `${paint.muted("  Run with --debug (or FABRIC_DEBUG=1) for the full stack trace.")}
+`
+    );
+  }
+}
 
 // src/lib/grouped-help.ts
+var GROUP_ORDER = ["Knowledge", "Project", "Maintain"];
+var DEFAULT_GROUP = "Project";
+var COMMAND_META = {
+  // Knowledge — the store/sync heart of Fabric.
+  store: { group: "Knowledge", descriptionKey: "cli.help.group.knowledge.store" },
+  sync: { group: "Knowledge", descriptionKey: "cli.help.group.knowledge.sync" },
+  // Project — single-repo onboarding, config, status, and injection inspection.
+  install: { group: "Project", descriptionKey: "cli.help.group.project.install" },
+  uninstall: { group: "Project" },
+  config: { group: "Project", descriptionKey: "cli.help.group.project.config" },
+  info: { group: "Project", descriptionKey: "cli.help.group.project.info" },
+  inspect: { group: "Project", descriptionKey: "cli.help.group.project.inspect" },
+  // Maintain — health + telemetry, kept cleanly separate (D1).
+  doctor: { group: "Maintain", descriptionKey: "cli.help.group.maintain.doctor" },
+  audit: { group: "Maintain", descriptionKey: "cli.help.group.maintain.audit" },
+  // Internal RPCs — hidden from human help, invoked by hooks/skills.
+  "plan-context-hint": { internal: true },
+  "onboard-coverage": { internal: true }
+};
+function describe(name, meta) {
+  if (name === "uninstall") {
+    return t("cli.uninstall.description").split("\n")[0] ?? "Uninstall Fabric";
+  }
+  if (meta?.descriptionKey) {
+    return t(meta.descriptionKey);
+  }
+  return name;
+}
 function getGroupedCommands() {
-  const groups = [
-    {
-      name: "Setup",
-      commands: [
-        { name: "install", description: t("cli.help.group.setup.install") },
-        { name: "uninstall", description: t("cli.uninstall.description").split("\n")[0] ?? "Uninstall Fabric" },
-        { name: "config", description: t("cli.help.group.setup.config") }
-      ]
-    },
-    {
-      name: "Daily",
-      commands: [
-        { name: "sync", description: t("cli.help.group.daily.sync") },
-        { name: "info", description: t("cli.help.group.daily.info") }
-      ]
-    },
-    {
-      name: "Diagnostic",
-      commands: [
-        { name: "doctor", description: t("cli.help.group.diagnostic.doctor") }
-      ]
-    },
-    {
-      name: "Advanced",
-      commands: [
-        { name: "store", description: t("cli.help.group.advanced.store") },
-        {
-          name: "whoami",
-          description: t("cli.help.group.advanced.whoami"),
-          deprecated: true,
-          deprecatedNote: t("cli.help.group.advanced.whoami.deprecated")
-        },
-        {
-          name: "status",
-          description: t("cli.help.group.advanced.status"),
-          deprecated: true,
-          deprecatedNote: t("cli.help.group.advanced.status.deprecated")
-        },
-        {
-          name: "scope-explain",
-          description: t("cli.help.group.advanced.scope-explain"),
-          deprecated: true,
-          deprecatedNote: t("cli.help.group.advanced.scope-explain.deprecated")
-        }
-      ]
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const group of GROUP_ORDER) {
+    byGroup.set(group, []);
+  }
+  for (const name of Object.keys(allCommands)) {
+    const meta = COMMAND_META[name];
+    if (meta?.internal) {
+      continue;
     }
-  ];
-  return groups;
+    const group = meta?.group ?? DEFAULT_GROUP;
+    byGroup.get(group)?.push({ name, description: describe(name, meta) });
+  }
+  return GROUP_ORDER.map((name) => ({ name, commands: byGroup.get(name) ?? [] })).filter(
+    (g) => g.commands.length > 0
+  );
 }
-function renderGroupedHelp(cmd, version) {
+function renderGroupedHelp(_cmd, _version) {
   const groups = getGroupedCommands();
   const lines = [];
   lines.push("fabric - Cross-client AI knowledge layer");
@@ -127,11 +140,7 @@ function renderGroupedHelp(cmd, version) {
     lines.push(`${group.name}:`);
     for (const command of group.commands) {
       const name = command.name.padEnd(14);
-      let line = `  ${name}${command.description}`;
-      if (command.deprecated) {
-        line += ` (${command.deprecatedNote})`;
-      }
-      lines.push(line);
+      lines.push(`  ${name}${command.description}`);
     }
     lines.push("");
   }
@@ -153,7 +162,7 @@ async function customShowUsageGrouped(cmd, parent, version) {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.2.0",
+    version: "2.3.0-rc.1",
     description: t("cli.main.description")
   },
   subCommands: allCommands
@@ -165,7 +174,7 @@ async function customShowUsage(cmd, parent) {
     return;
   }
   if (cmdMeta?.name === "fabric" && parent === void 0) {
-    await customShowUsageGrouped(cmd, parent, "2.2.0");
+    await customShowUsageGrouped(cmd, parent, "2.3.0-rc.1");
     return;
   }
   console.log(await renderUsage(cmd, parent) + "\n");
@@ -190,7 +199,8 @@ async function run() {
       await runMain(main, { rawArgs });
       return;
     }
-    console.error(err, "\n");
+    const showStack = rawArgs.includes("--debug") || process.env.FABRIC_DEBUG === "1";
+    renderUnexpectedError(err, showStack);
     process.exit(1);
   }
 }

package/dist/{info-7FKBTMVO.js → info-NJEY26H6.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
+  storeGitRemote
+} from "./chunk-7V4XMLQ2.js";
+import {
+  loadProjectConfig,
   scopeExplain
-} from "./chunk-EOT63RDH.js";
+} from "./chunk-I5F5BHWI.js";
 import {
-  projectStatus,
-  warnUnknownFlags,
-  whoami
-} from "./chunk-27HK6H5Y.js";
-import "./chunk-QPAW6IYT.js";
-import "./chunk-QFIVFZRH.js";
-import "./chunk-FNHDQTPC.js";
+  loadGlobalConfig,
+  resolveGlobalRoot
+} from "./chunk-FNHDQTPC.js";
 import {
   getProjectTranslator
 } from "./chunk-HORSMSZL.js";
@@ -17,24 +17,88 @@ import {
 // src/commands/info.ts
 import { defineCommand } from "citty";
 import { FabricError } from "@fenglimg/fabric-shared/errors";
+
+// src/lib/unknown-flags.ts
+function warnUnknownFlags(known) {
+  const knownSet = /* @__PURE__ */ new Set([...known, "help", "version"]);
+  const unknown = [];
+  for (const tok of process.argv.slice(2)) {
+    if (!tok.startsWith("--")) continue;
+    const name = tok.slice(2).split("=")[0].replace(/^no-/, "");
+    if (name.length === 0) continue;
+    if (!knownSet.has(name)) unknown.push(tok.split("=")[0]);
+  }
+  if (unknown.length > 0) {
+    process.stderr.write(`[fabric] ignored unknown flag(s): ${unknown.join(", ")}
+`);
+  }
+}
+
+// src/store/info-ops.ts
+function whoami(globalRoot = resolveGlobalRoot()) {
+  const config = loadGlobalConfig(globalRoot);
+  if (config === null) {
+    return null;
+  }
+  return {
+    uid: config.uid,
+    stores: config.stores.map((s) => ({
+      alias: s.alias,
+      mount_name: s.mount_name ?? null,
+      store_uuid: s.store_uuid,
+      // F4: parity with `fabric store list` — local-only reflects the store
+      // repo's TRUE git remote (what sync actually pushes to), not the registry
+      // metadata. A store with a physical `origin` but no registry `remote`
+      // (e.g. the personal store) was misreported as local-only by whoami while
+      // `store list` honestly showed its remote. Both now read the same source.
+      local_only: storeGitRemote(s.alias, globalRoot) === void 0
+    }))
+  };
+}
+function projectStatus(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const global = loadGlobalConfig(globalRoot);
+  const project = loadProjectConfig(projectRoot);
+  return {
+    uid: global?.uid ?? null,
+    mounted: (global?.stores ?? []).map((s) => s.alias),
+    project_id: project?.project_id ?? null,
+    is_fabric_project: project !== null,
+    required: (project?.required_stores ?? []).map((r) => r.id),
+    active_write_store: project?.active_write_store ?? null,
+    default_write_store: project?.default_write_store ?? null,
+    write_routes: project?.write_routes ?? []
+  };
+}
+
+// src/commands/info.ts
+var scopeCommand = defineCommand({
+  meta: {
+    name: "scope",
+    description: "Resolve a scope coordinate's read-set + write target (JSON)"
+  },
+  args: {
+    coord: {
+      type: "positional",
+      required: true,
+      description: "Scope coordinate (e.g. team, project:x, personal)"
+    },
+    // Accepted for symmetry with other commands; scope output is always JSON.
+    json: {
+      type: "boolean",
+      description: "Emit machine-readable JSON (scope always emits JSON)"
+    }
+  },
+  run({ args }) {
+    warnUnknownFlags(["json"]);
+    runScopeExplain(args.coord);
+  }
+});
 var info_default = defineCommand({
   meta: {
     name: "info",
     description: "Unified information command for Fabric identity, project status, and scope resolution"
   },
   args: {
-    // Subcommand detection
-    subcommand: {
-      type: "positional",
-      required: false,
-      description: "Subcommand: 'scope' for scope explanation"
-    },
-    scope: {
-      type: "positional",
-      required: false,
-      description: "Scope coordinate (used with 'scope' subcommand)"
-    },
-    // Flags
     global: {
       type: "boolean",
       description: "Show global identity (whoami) instead of project status",
@@ -45,37 +109,18 @@ var info_default = defineCommand({
       description: "Emit machine-readable JSON instead of text"
     }
   },
+  subCommands: {
+    scope: scopeCommand
+  },
   run({ args }) {
     warnUnknownFlags(["global", "g", "json"]);
-    const mode = resolveMode(args);
-    switch (mode) {
-      case "whoami":
-        runWhoami(args.json);
-        break;
-      case "scope-explain":
-        if (typeof args.scope !== "string" || args.scope.length === 0) {
-          console.error("Usage: fabric info scope <scope>");
-          process.exitCode = 1;
-          break;
-        }
-        runScopeExplain(args.scope);
-        break;
-      case "status":
-      default:
-        runStatus(args.json);
-        break;
+    if (args.global === true) {
+      runWhoami(args.json);
+      return;
     }
+    runStatus(args.json);
   }
 });
-function resolveMode(args) {
-  if (args.subcommand === "scope") {
-    return "scope-explain";
-  }
-  if (args.global === true) {
-    return "whoami";
-  }
-  return "status";
-}
 function runWhoami(json) {
   const info = whoami();
   if (json === true) {

package/dist/{context-UJCGYOT6.js → inspect-5YZMJPFM.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-722JU5BP.js";
 import "./chunk-WA3DYGSY.js";
 
-// src/commands/context.ts
+// src/commands/inspect.ts
 import { existsSync } from "fs";
 import { createRequire } from "module";
 import { dirname, join, parse, resolve } from "path";
@@ -59,7 +59,7 @@ function renderExplain(sinks) {
   }
   return lines.join("\n");
 }
-async function runContext(opts) {
+async function runInspect(opts) {
   const cwd = opts.target ? resolve(opts.target) : process.cwd();
   const payload = opts.payload !== void 0 ? opts.payload : await runPlanContextHint({ all: true, target: opts.target });
   const renderer = loadHookRenderer();
@@ -75,9 +75,9 @@ async function runContext(opts) {
   if (base.length === 0 && !sinks.hasRenderedContent) return "";
   return opts.explain === true ? base + "\n" + renderExplain(sinks) : base;
 }
-var contextCommand = defineCommand({
+var inspectCommand = defineCommand({
   meta: {
-    name: "context",
+    name: "inspect",
     description: "Show what Fabric injects at SessionStart (the knowledge spine). --explain for per-entry provenance."
   },
   args: {
@@ -98,20 +98,20 @@ var contextCommand = defineCommand({
   async run({ args }) {
     try {
       const render = args.render === "human" || args.render === "ai" ? args.render : void 0;
-      const out = await runContext({ render, explain: args.explain === true, target: args.target });
+      const out = await runInspect({ render, explain: args.explain === true, target: args.target });
       if (out.length > 0) process.stdout.write(`${out}
 `);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      process.stderr.write(`context failed: ${message}
+      process.stderr.write(`inspect failed: ${message}
 `);
       process.exitCode = 1;
     }
   }
 });
-var context_default = contextCommand;
+var inspect_default = inspectCommand;
 export {
-  contextCommand,
-  context_default as default,
-  runContext
+  inspect_default as default,
+  inspectCommand,
+  runInspect
 };