bitfab-cli 0.2.170 → 0.2.172

package/README.md

@@ -12,4 +12,6 @@ npx bitfab-cli init --editor cursor       # Install for Cursor
 npx bitfab-cli session-logs enable        # Enable session log collection
 npx bitfab-cli session-logs disable       # Disable session log collection
 npx bitfab-cli session-logs status        # Show the saved session log setting
+npx bitfab-cli analyze-repo --help        # Show help for analyze-repo
+npx bitfab-cli help setup                 # Show help for setup
 ```

package/dist/index.js

@@ -8816,6 +8816,7 @@ var require_dist = __commonJS({
 });
 
 // src/index.ts
+import { pathToFileURL } from "url";
 import { cancel as cancel2 } from "@clack/prompts";
 
 // src/init.ts
@@ -30789,13 +30790,23 @@ function skipFlags(skip, flag) {
   return skip ? [flag] : [];
 }
 function runCli(bin, args) {
-  const result = spawnSync(bin, [...args], { stdio: "pipe", ...SHELL_OPTS });
-  if (result.status !== 0) {
+  const result = runCliResult(bin, args);
+  if (result.status !== 0 || result.error) {
+    const output = result.output.trim();
     throw new Error(
-      `${bin} ${args.join(" ")} failed${result.status === null ? "" : ` with status ${result.status}`}`
+      `${bin} ${args.join(" ")} failed${result.status === null ? "" : ` with status ${result.status}`}${output ? `
+${output}` : ""}`
     );
   }
-  return (result.stdout?.toString() ?? "") + (result.stderr?.toString() ?? "");
+  return result.output;
+}
+function runCliResult(bin, args) {
+  const result = spawnSync(bin, [...args], { stdio: "pipe", ...SHELL_OPTS });
+  return {
+    status: result.status,
+    output: (result.stdout?.toString() ?? "") + (result.stderr?.toString() ?? ""),
+    error: result.error
+  };
 }
 function launchCli(bin, args) {
   spawnSync(bin, [...args], { stdio: "inherit", ...SHELL_OPTS });
@@ -30834,7 +30845,44 @@ function ensureLatestPlugin(pull) {
 }
 
 // src/cliEditor.ts
+function makeCliAuthCheck({
+  cli,
+  args,
+  label,
+  loginCommand,
+  parseAuthenticated
+}) {
+  return () => {
+    const result = runCliResult(cli, args);
+    if (result.error) {
+      return {
+        ok: false,
+        message: `Failed to run ${cli}: ${result.error.message}`
+      };
+    }
+    if (result.status === 0 && parseAuthenticated(result.output)) {
+      return { ok: true };
+    }
+    const output = result.output.trim();
+    return {
+      ok: false,
+      message: [
+        `${label} is not logged in. Run \`${loginCommand}\` and try again before launching the Bitfab agent.`,
+        output ? `
+${label} said:
+${output}` : ""
+      ].join("")
+    };
+  };
+}
+function ensureCliAuthenticated(cfg) {
+  const result = cfg.authCheck?.();
+  if (result?.ok === false) {
+    throw new Error(result.message);
+  }
+}
 function cliSetup(cfg, skipPermissions) {
+  ensureCliAuthenticated(cfg);
   p2.log.info(`Launching ${cfg.setupCommand}...
 `);
   launchCli(cfg.cli, [
@@ -30843,6 +30891,7 @@ function cliSetup(cfg, skipPermissions) {
   ]);
 }
 function cliAssistant(cfg, args, skipPermissions) {
+  ensureCliAuthenticated(cfg);
   const cmd = [cfg.assistantCommand, ...args].join(" ");
   p2.log.info(`Launching ${cmd}...
 `);
@@ -30867,6 +30916,7 @@ function cliUpdate(cfg, args, skipPermissions) {
     s.stop(formatPluginRefreshResult(out));
   }
   if (mode === "sdk" || mode === "all") {
+    ensureCliAuthenticated(cfg);
     p2.log.info(`Launching ${cfg.updateCommand} sdk...
 `);
     launchCli(cfg.cli, [
@@ -30887,6 +30937,21 @@ var SETUP_COMMAND = "/bitfab:setup";
 var ANALYZE_REPO_COMMAND = "/bitfab:setup analyze-repo";
 var ASSISTANT_COMMAND = "/bitfab:assistant";
 var UPDATE_COMMAND = "/bitfab:update";
+function isClaudeAuthStatusLoggedIn(output) {
+  try {
+    const status = JSON.parse(output);
+    return status.loggedIn === true;
+  } catch {
+    return false;
+  }
+}
+var checkClaudeAuth = makeCliAuthCheck({
+  cli: CLI,
+  args: ["auth", "status"],
+  label: "Claude Code",
+  loginCommand: "claude auth login",
+  parseAuthenticated: isClaudeAuthStatusLoggedIn
+});
 function runClaudeInstall() {
   const s = p3.spinner();
   s.start("Adding bitfab marketplace");
@@ -30927,6 +30992,10 @@ function ensureLatestClaudePlugin() {
   ensureLatestPlugin(pullLatestClaudePlugin);
 }
 async function runClaudeAnalyzeRepo(captureOverride, limit) {
+  const auth = checkClaudeAuth();
+  if (!auth.ok) {
+    throw new Error(auth.message);
+  }
   const logPath = analyzeRepoLogPath();
   const env = { ...process.env };
   if (captureOverride !== void 0) {
@@ -31127,6 +31196,7 @@ var config2 = {
   setupCommand: SETUP_COMMAND,
   assistantCommand: ASSISTANT_COMMAND,
   updateCommand: UPDATE_COMMAND,
+  authCheck: checkClaudeAuth,
   pullLatest: pullLatestClaudePlugin
 };
 var claudeAdapter = {
@@ -31152,6 +31222,16 @@ var PLUGIN_KEY2 = "bitfab@bitfab";
 var SETUP_COMMAND2 = "$bitfab:setup";
 var ASSISTANT_COMMAND2 = "$bitfab:assistant";
 var UPDATE_COMMAND2 = "$bitfab:update";
+function isCodexLoginStatusLoggedIn(output) {
+  return /logged in/i.test(output) && !/not logged in/i.test(output);
+}
+var checkCodexAuth = makeCliAuthCheck({
+  cli: CLI2,
+  args: ["login", "status"],
+  label: "Codex",
+  loginCommand: "codex login",
+  parseAuthenticated: isCodexLoginStatusLoggedIn
+});
 function pullLatestCodexPlugin() {
   return runCli(CLI2, ["plugin", "marketplace", "upgrade", MARKETPLACE2]);
 }
@@ -31229,6 +31309,7 @@ var config3 = {
   setupCommand: SETUP_COMMAND2,
   assistantCommand: ASSISTANT_COMMAND2,
   updateCommand: UPDATE_COMMAND2,
+  authCheck: checkCodexAuth,
   pullLatest: pullLatestCodexPlugin
 };
 var codexAdapter = {
@@ -31250,6 +31331,27 @@ var ADD_PLUGIN_CMD = `/add-plugin ${REPO3}`;
 var SETUP_COMMAND3 = "/bitfab-setup";
 var ASSISTANT_COMMAND3 = "/bitfab-assistant";
 var UPDATE_COMMAND3 = "/bitfab-update";
+function isCursorAgentStatusAuthenticated(output) {
+  try {
+    const status = JSON.parse(output);
+    return status.isAuthenticated === true || status.status === "authenticated";
+  } catch {
+    return false;
+  }
+}
+var checkCursorAuth = makeCliAuthCheck({
+  cli: "cursor",
+  args: ["agent", "status", "--format", "json"],
+  label: "Cursor Agent",
+  loginCommand: "cursor agent login",
+  parseAuthenticated: isCursorAgentStatusAuthenticated
+});
+function ensureCursorAuthenticated() {
+  const result = checkCursorAuth();
+  if (result.ok === false) {
+    throw new Error(result.message);
+  }
+}
 function runCursorInstall() {
   const copied = copyToClipboard(ADD_PLUGIN_CMD);
   if (copied) {
@@ -31278,6 +31380,7 @@ function runCursorInstall() {
 function ensureLatestCursorPlugin() {
 }
 function runCursorSetup(skipPermissions) {
+  ensureCursorAuthenticated();
   if (skipPermissions) {
     p5.log.warn("--skip-permissions is not supported for Cursor");
   }
@@ -31290,6 +31393,7 @@ function runCursorAnalyzeRepo() {
   p5.log.info(`To run it in Cursor, run ${SETUP_COMMAND3} analyze-repo manually.`);
 }
 function runCursorAssistant(args, skipPermissions) {
+  ensureCursorAuthenticated();
   if (skipPermissions) {
     p5.log.warn("--skip-permissions is not supported for Cursor");
   }
@@ -31297,6 +31401,7 @@ function runCursorAssistant(args, skipPermissions) {
   p5.log.info(`To start the assistant, run ${cmd} in Cursor.`);
 }
 function runCursorUpdate(args, skipPermissions) {
+  ensureCursorAuthenticated();
   if (skipPermissions) {
     p5.log.warn("--skip-permissions is not supported for Cursor");
   }
@@ -31665,7 +31770,7 @@ function startUpdateCheck() {
 }
 
 // src/index.ts
-var HELP_TEXT = `Usage: bitfab <command> [options]
+var GLOBAL_HELP_TEXT = `Usage: bitfab <command> [options]
 
 Commands:
   init [--editor <name>]              Full onboarding: plugin-install, login, and setup
@@ -31698,6 +31803,143 @@ Examples:
   bitfab setup --skip-permissions          Setup without permission prompts
   bitfab assistant --skip-permissions      Run assistant autonomously
 `;
+var COMMAND_HELP_TEXT = {
+  init: `Usage: bitfab init [--editor <name>] [--skip-permissions | --no-skip-permissions]
+
+Full onboarding: install the Bitfab plugin, authenticate with Bitfab, and launch setup in the selected editor.
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+  --skip-permissions     Skip permission prompts when launching the setup agent
+  --no-skip-permissions  Keep permission prompts without being asked
+
+Examples:
+  bitfab init
+  bitfab init --editor claude
+  bitfab init --editor codex --no-skip-permissions
+`,
+  "plugin-install": `Usage: bitfab plugin-install [--editor <name>]
+
+Install the Bitfab plugin in one editor without authenticating or launching setup.
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+
+Examples:
+  bitfab plugin-install
+  bitfab plugin-install --editor cursor
+`,
+  login: `Usage: bitfab login
+
+Authenticate with Bitfab in the browser and save credentials locally.
+
+Options:
+  This command has no options.
+
+Examples:
+  bitfab login
+`,
+  logout: `Usage: bitfab logout
+
+Remove locally stored Bitfab credentials.
+
+Options:
+  This command has no options.
+
+Examples:
+  bitfab logout
+`,
+  "session-logs": `Usage: bitfab session-logs [status|enable|disable|set true|set false]
+
+Read or update the saved session-log collection preference used by setup and analyze-repo.
+
+Arguments:
+  status      Show the saved setting (default)
+  enable      Enable session log collection
+  disable     Disable session log collection
+  set true    Enable session log collection
+  set false   Disable session log collection
+
+Examples:
+  bitfab session-logs status
+  bitfab session-logs enable
+  bitfab session-logs disable
+`,
+  setup: `Usage: bitfab setup [--editor <name>] [--skip-permissions | --no-skip-permissions]
+
+Launch the Bitfab setup command in the selected editor without reinstalling the plugin.
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+  --skip-permissions     Skip permission prompts when launching the setup agent
+  --no-skip-permissions  Keep permission prompts without being asked
+
+Examples:
+  bitfab setup
+  bitfab setup --editor codex
+  bitfab setup --skip-permissions
+`,
+  "analyze-repo": `Usage: bitfab analyze-repo [--editor <name>] [--limit <n>] [--upload-logs | --no-upload-logs]
+
+Headlessly scan the repository for AI workflows and upload draft trace plans for the top candidates, with no prompts and no code edits.
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+  --limit <n>            Cap how many draft trace plans to upload (default 5)
+  --upload-logs          Upload this run's session logs to Bitfab
+  --no-upload-logs       Keep this run's session logs local
+
+Examples:
+  bitfab analyze-repo
+  bitfab analyze-repo --limit 3
+  bitfab analyze-repo --no-upload-logs
+`,
+  assistant: `Usage: bitfab assistant [--editor <name>] [--skip-permissions | --no-skip-permissions] [args...]
+
+Launch the Bitfab assistant in the selected editor. Extra arguments are passed through to the editor command.
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+  --skip-permissions     Skip permission prompts when launching the assistant agent
+  --no-skip-permissions  Keep permission prompts without being asked
+
+Examples:
+  bitfab assistant
+  bitfab assistant investigate
+  bitfab assistant --editor claude --skip-permissions
+`,
+  update: `Usage: bitfab update [--editor <name>] [--skip-permissions | --no-skip-permissions] [all|plugin|sdk]
+
+Update the Bitfab plugin, then launch the SDK update flow in the selected editor.
+
+Arguments:
+  all       Update plugin and SDKs (default)
+  plugin    Update only the plugin
+  sdk       Update only SDKs
+
+Options:
+  --editor, -e <name>    Target editor: claude, codex, cursor
+  --skip-permissions     Skip permission prompts when launching the update agent
+  --no-skip-permissions  Keep permission prompts without being asked
+
+Examples:
+  bitfab update
+  bitfab update plugin
+  bitfab update --editor codex sdk
+`,
+  help: `Usage: bitfab help [command]
+
+Show global help or help for a specific command.
+
+Arguments:
+  command    One of: init, plugin-install, login, logout, session-logs, setup, analyze-repo, assistant, update, help
+
+Examples:
+  bitfab help
+  bitfab help analyze-repo
+  bitfab setup --help
+`
+};
 function parseLimit(raw) {
   const n = Number(raw);
   if (!Number.isInteger(n) || n < 1) {
@@ -31705,9 +31947,39 @@ function parseLimit(raw) {
   }
   return n;
 }
+function isHelpCommand(command) {
+  return command !== void 0 && Object.hasOwn(COMMAND_HELP_TEXT, command);
+}
+function getHelpTopic(argv) {
+  const [command, maybeTopic] = argv;
+  if (command === void 0) {
+    return void 0;
+  }
+  if (command === "help") {
+    if (maybeTopic === "-h" || maybeTopic === "--help") {
+      return "help";
+    }
+    return maybeTopic;
+  }
+  if (command === "-h" || command === "--help") {
+    return void 0;
+  }
+  if (argv.includes("-h") || argv.includes("--help")) {
+    return command;
+  }
+  return null;
+}
+function getHelpText(topic) {
+  if (topic === void 0) {
+    return GLOBAL_HELP_TEXT;
+  }
+  if (isHelpCommand(topic)) {
+    return COMMAND_HELP_TEXT[topic];
+  }
+  return void 0;
+}
 function wantsHelp(argv) {
-  const command = argv[0];
-  return !command || command === "help" || argv.includes("-h") || argv.includes("--help");
+  return getHelpTopic(argv) !== null;
 }
 function parseArgs2(argv) {
   const [command, ...tail] = argv;
@@ -31751,13 +32023,23 @@ function parseArgs2(argv) {
   return { command, editor, skipPermissions, uploadLogs, limit, rest };
 }
 async function main() {
-  const { command, editor, skipPermissions, uploadLogs, limit, rest } = parseArgs2(process.argv.slice(2));
-  const abortUpdateCheck = startUpdateCheck();
-  if (wantsHelp(process.argv.slice(2))) {
-    process.stdout.write(HELP_TEXT);
-    abortUpdateCheck();
+  const argv = process.argv.slice(2);
+  const helpTopic = getHelpTopic(argv);
+  if (helpTopic !== null) {
+    const helpText = getHelpText(helpTopic);
+    if (helpText === void 0) {
+      process.stderr.write(
+        `Unknown command: ${helpTopic}
+
+${GLOBAL_HELP_TEXT}`
+      );
+      process.exit(1);
+    }
+    process.stdout.write(helpText);
     return;
   }
+  const { command, editor, skipPermissions, uploadLogs, limit, rest } = parseArgs2(argv);
+  const abortUpdateCheck = startUpdateCheck();
   if (command === "init") {
     await runInit({ editor, skipPermissions });
     abortUpdateCheck();
@@ -31805,16 +32087,24 @@ async function main() {
   }
   process.stderr.write(`Unknown command: ${command}
 
-${HELP_TEXT}`);
+${GLOBAL_HELP_TEXT}`);
   abortUpdateCheck();
   process.exit(1);
 }
-main().catch((err) => {
-  const message = err instanceof Error ? err.message : String(err);
-  cancel2(message);
-  process.exit(1);
-});
+function isDirectRun() {
+  const entrypoint = process.argv[1];
+  return entrypoint !== void 0 && import.meta.url === pathToFileURL(entrypoint).href;
+}
+if (isDirectRun()) {
+  main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    cancel2(message);
+    process.exit(1);
+  });
+}
 export {
+  getHelpText,
+  getHelpTopic,
   parseArgs2 as parseArgs,
   wantsHelp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitfab-cli",
-  "version": "0.2.170",
+  "version": "0.2.172",
   "description": "Install and configure the Bitfab plugin in Claude Code, Codex, or Cursor.",
   "type": "module",
   "main": "dist/index.js",