bitfab-cli 0.2.170 → 0.2.171

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
@@ -31665,7 +31666,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 +31699,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 +31843,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 +31919,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 +31983,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.171",
   "description": "Install and configure the Bitfab plugin in Claude Code, Codex, or Cursor.",
   "type": "module",
   "main": "dist/index.js",