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

package/dist/index.js

@@ -1,42 +1,56 @@
 #!/usr/bin/env node
+import {
+  renderDoctorFilteredHelp
+} from "./chunk-E7HJUU34.js";
+import "./chunk-3D7B2UAZ.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 "./chunk-FNHDQTPC.js";
 import {
   t
-} from "./chunk-2CY4BMTH.js";
+} from "./chunk-HORSMSZL.js";
 
 // src/index.ts
 import { realpathSync } from "fs";
 import { resolve } from "path";
 import { fileURLToPath } from "url";
-import { defineCommand, runCommand, runMain } from "citty";
+import { defineCommand, renderUsage, runCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-74ANPCCP.js").then((module) => module.default),
+  // v2.2.0-rc.5: pipeline-based install with TUI renderer (EPIC-005/006/007/008)
+  install: () => import("./install-v2-RINEA24K.js").then((module) => module.installCommand),
   // v2.1.0-rc.1 P3: multi-store lifecycle command group (list/add/remove/explain).
-  store: () => import("./store-XB3ADT65.js").then((module) => module.default),
+  store: () => import("./store-HOCORVL3.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),
+  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.
-  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),
+  // 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),
+  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-JWQWDZW7.js").then((module) => module.default),
+  "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-RER6NLFC.js").then((module) => module.default)
+  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)
 };
 
 // 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;
-}
+import { hasActionHint } from "@fenglimg/fabric-shared/errors";
 function renderFabricError(err, stream = process.stderr) {
   stream.write(`${err.message}
 `);
@@ -51,21 +65,117 @@ function renderTopLevelError(err, stream = process.stderr) {
   return "other";
 }
 
+// src/lib/grouped-help.ts
+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")
+        }
+      ]
+    }
+  ];
+  return groups;
+}
+function renderGroupedHelp(cmd, version) {
+  const groups = getGroupedCommands();
+  const lines = [];
+  lines.push("fabric - Cross-client AI knowledge layer");
+  lines.push("");
+  lines.push(`First time? Run: fabric install`);
+  lines.push("");
+  for (const group of groups) {
+    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("");
+  }
+  lines.push(`Run \`fabric <command> --help\` for details.`);
+  return lines.join("\n");
+}
+async function customShowUsageGrouped(cmd, parent, version) {
+  const cmdMeta = await (typeof cmd.meta === "function" ? cmd.meta() : cmd.meta);
+  if (cmdMeta?.name === "fabric" && parent === void 0) {
+    const ver = version || cmdMeta?.version || "";
+    console.log(renderGroupedHelp(cmd, ver));
+  } else {
+    const { renderUsage: renderUsage2 } = await import("citty");
+    console.log(await renderUsage2(cmd, parent) + "\n");
+  }
+}
+
 // src/index.ts
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.2.0-rc.1",
+    version: "2.2.0-rc.10",
     description: t("cli.main.description")
   },
   subCommands: allCommands
 });
+async function customShowUsage(cmd, parent) {
+  const cmdMeta = await (typeof cmd.meta === "function" ? cmd.meta() : cmd.meta);
+  if (cmdMeta?.name === "doctor" && parent !== void 0) {
+    renderDoctorFilteredHelp();
+    return;
+  }
+  if (cmdMeta?.name === "fabric" && parent === void 0) {
+    await customShowUsageGrouped(cmd, parent, "2.2.0-rc.10");
+    return;
+  }
+  console.log(await renderUsage(cmd, parent) + "\n");
+}
 async function run() {
   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 });
+    await runMain(main, { rawArgs, showUsage: customShowUsage });
     return;
   }
   try {
@@ -75,7 +185,8 @@ async function run() {
       process.exit(1);
     }
     const code = err !== null && typeof err === "object" ? err.code : void 0;
-    if (typeof code === "string" && code.startsWith("E_")) {
+    const isCittyUsageError = err instanceof Error && err.name === "CLIError" || typeof code === "string" && (code.startsWith("E_") || code.startsWith("EARG") || code === "EUSAGE");
+    if (isCittyUsageError) {
       await runMain(main, { rawArgs });
       return;
     }

package/dist/info-7FKBTMVO.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import {
+  scopeExplain
+} from "./chunk-EOT63RDH.js";
+import {
+  projectStatus,
+  warnUnknownFlags,
+  whoami
+} from "./chunk-27HK6H5Y.js";
+import "./chunk-QPAW6IYT.js";
+import "./chunk-QFIVFZRH.js";
+import "./chunk-FNHDQTPC.js";
+import {
+  getProjectTranslator
+} from "./chunk-HORSMSZL.js";
+
+// src/commands/info.ts
+import { defineCommand } from "citty";
+import { FabricError } from "@fenglimg/fabric-shared/errors";
+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",
+      alias: "g"
+    },
+    json: {
+      type: "boolean",
+      description: "Emit machine-readable JSON instead of text"
+    }
+  },
+  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;
+    }
+  }
+});
+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) {
+    console.log(JSON.stringify(info, null, 2));
+    return;
+  }
+  const t = getProjectTranslator();
+  if (info === null) {
+    console.log(t("cli.cmd.no-global-config"));
+    return;
+  }
+  console.log(t("cli.whoami.uid", { uid: info.uid }));
+  if (info.stores.length === 0) {
+    console.log(t("cli.whoami.stores-none"));
+    return;
+  }
+  console.log(t("cli.whoami.stores-label"));
+  const localOnly = t("cli.shared.local-only");
+  for (const store of info.stores) {
+    console.log(
+      `  ${store.alias}	${store.mount_name ?? store.store_uuid}	${store.store_uuid}${store.local_only ? `	${localOnly}` : ""}`
+    );
+  }
+}
+function runStatus(json) {
+  const status = projectStatus(process.cwd());
+  if (json === true) {
+    console.log(JSON.stringify(status, null, 2));
+    return;
+  }
+  console.log(`uid:            ${status.uid ?? "(no global config)"}`);
+  const projectIdLabel = status.project_id ?? (status.is_fabric_project ? "(unset)" : "(not a Fabric project)");
+  console.log(`project_id:     ${projectIdLabel}`);
+  console.log(`mounted stores: ${status.mounted.length > 0 ? status.mounted.join(", ") : "(none)"}`);
+  console.log(`required:       ${status.required.length > 0 ? status.required.join(", ") : "(none)"}`);
+  console.log(`default write:  ${status.default_write_store ?? status.active_write_store ?? "(none \u2014 personal scope only)"}`);
+  console.log(`write routes:   ${status.write_routes.length}`);
+}
+function runScopeExplain(scope) {
+  const projectRoot = process.cwd();
+  let result;
+  try {
+    result = scopeExplain(projectRoot, scope);
+  } catch (error) {
+    if (error instanceof FabricError) {
+      console.error(`${error.message}
+\u2192 ${error.actionHint}`);
+      process.exitCode = 1;
+      return;
+    }
+    throw error;
+  }
+  if (result === null) {
+    console.log(getProjectTranslator(projectRoot)("cli.cmd.no-global-config"));
+    return;
+  }
+  console.log(JSON.stringify(result, null, 2));
+}
+export {
+  info_default as default
+};