bitfab-cli 0.2.183 → 0.2.184

package/dist/index.js

@@ -30875,6 +30875,17 @@ function ensureLatestPlugin(pull) {
 }
 
 // src/cliEditor.ts
+function buildAnalyzeRepoCommand(base, opts = {}) {
+  const parts = [base];
+  if (opts.limit !== void 0) {
+    parts.push(`limit=${opts.limit}`);
+  }
+  const prompt = opts.prompt?.trim();
+  if (prompt) {
+    parts.push(`guidance: ${prompt}`);
+  }
+  return parts.join(" ");
+}
 function makeCliAuthCheck({
   cli,
   args,
@@ -31042,7 +31053,7 @@ function pullLatestClaudePlugin() {
 function ensureLatestClaudePlugin() {
   ensureLatestPlugin(pullLatestClaudePlugin);
 }
-async function runClaudeAnalyzeRepo(captureOverride, limit) {
+async function runClaudeAnalyzeRepo(captureOverride, limit, prompt) {
   const auth = checkClaudeAuth();
   if (!auth.ok) {
     throw new Error(auth.message);
@@ -31054,7 +31065,10 @@ async function runClaudeAnalyzeRepo(captureOverride, limit) {
   if (captureOverride !== void 0) {
     env.BITFAB_CAPTURE_SESSIONS = captureOverride ? "1" : "0";
   }
-  const command = limit === void 0 ? ANALYZE_REPO_COMMAND : `${ANALYZE_REPO_COMMAND} limit=${limit}`;
+  const command = buildAnalyzeRepoCommand(ANALYZE_REPO_COMMAND, {
+    limit,
+    prompt
+  });
   const out = fs20.createWriteStream(logPath);
   const spinner6 = p3.spinner();
   spinner6.start("Analyzing repo and drafting trace plans");
@@ -31359,7 +31373,7 @@ function runCodexInstall() {
   }
   p4.log.success("Bitfab plugin ready in Codex");
 }
-async function runCodexAnalyzeRepo(captureOverride, limit) {
+async function runCodexAnalyzeRepo(captureOverride, limit, prompt) {
   const auth = checkCodexAuth();
   if (!auth.ok) {
     throw new Error(auth.message);
@@ -31371,7 +31385,10 @@ async function runCodexAnalyzeRepo(captureOverride, limit) {
   if (captureOverride !== void 0) {
     env.BITFAB_CAPTURE_SESSIONS = captureOverride ? "1" : "0";
   }
-  const command = limit === void 0 ? ANALYZE_REPO_COMMAND2 : `${ANALYZE_REPO_COMMAND2} limit=${limit}`;
+  const command = buildAnalyzeRepoCommand(ANALYZE_REPO_COMMAND2, {
+    limit,
+    prompt
+  });
   const out = fs21.createWriteStream(logPath);
   const spinner6 = p4.spinner();
   spinner6.start("Analyzing repo and drafting trace plans");
@@ -31718,7 +31735,7 @@ function runCursorSetup(skipPermissions) {
   }
   p5.log.info(`To complete setup, run ${SETUP_COMMAND3} in Cursor.`);
 }
-async function runCursorAnalyzeRepo(captureOverride, limit) {
+async function runCursorAnalyzeRepo(captureOverride, limit, prompt) {
   ensureCursorAuthenticated();
   const pluginDir = resolveCursorPluginDir();
   if (!pluginDir) {
@@ -31736,7 +31753,10 @@ async function runCursorAnalyzeRepo(captureOverride, limit) {
   if (captureOverride !== void 0) {
     env.BITFAB_CAPTURE_SESSIONS = captureOverride ? "1" : "0";
   }
-  const command = limit === void 0 ? ANALYZE_REPO_COMMAND3 : `${ANALYZE_REPO_COMMAND3} limit=${limit}`;
+  const command = buildAnalyzeRepoCommand(ANALYZE_REPO_COMMAND3, {
+    limit,
+    prompt
+  });
   const out = fs22.createWriteStream(logPath);
   const spinner6 = p5.spinner();
   spinner6.start("Analyzing repo and drafting trace plans");
@@ -32206,7 +32226,7 @@ async function runAnalyzeRepo(opts) {
   }
   await ensureAnalyzeRepoAuth();
   const captureOverride = await resolveCaptureOverride(opts.uploadLogs);
-  await ADAPTERS[chosen].analyzeRepo(captureOverride, opts.limit);
+  await ADAPTERS[chosen].analyzeRepo(captureOverride, opts.limit, opts.prompt);
   p6.outro("Done!");
 }
 async function ensureAnalyzeRepoAuth(canPrompt = Boolean(process.stdin.isTTY)) {
@@ -32366,7 +32386,7 @@ Commands:
   logout                              Remove stored credentials
   session-logs [status|enable|disable] Read or update session log collection
   setup [--editor <name>]             Launch /bitfab:setup in the editor
-  analyze-repo [--editor <name>]      Headless scan: draft + upload trace plans (no prompts, no code edits)
+  analyze-repo [--editor <name>] [prompt]  Headless scan: draft + upload trace plans (no prompts, no code edits)
   assistant [--editor <name>] [args]  Launch /bitfab:assistant in the editor
   update [--editor <name>] [mode]      Update plugin, then launch SDK update (mode: all|plugin|sdk)
   help                                Show this help
@@ -32378,12 +32398,14 @@ Options:
   --upload-logs          analyze-repo: upload the run's session logs to Bitfab (skips the prompt)
   --no-upload-logs       analyze-repo: keep session logs local (skips the prompt)
   --limit <n>            analyze-repo: cap how many draft trace plans to upload (default 5)
+  --prompt, -p <text>    analyze-repo: free-text guidance steering what to focus on
 
 Examples:
   bitfab init                              Full setup (detect editor, install, login, setup)
   bitfab init --editor claude              Full setup for Claude Code
   bitfab analyze-repo                      Scan the repo and upload draft trace plans (headless)
   bitfab analyze-repo --limit 3            Scan the repo and upload at most 3 draft trace plans
+  bitfab analyze-repo "focus on billing"   Scan with free-text guidance on what to prioritize
   bitfab session-logs enable               Enable session log collection
   bitfab session-logs disable              Disable session log collection
   bitfab assistant investigate             Investigate traces
@@ -32466,24 +32488,29 @@ Examples:
   bitfab setup --editor codex
   bitfab setup --skip-permissions
 `,
-  "analyze-repo": `Usage: bitfab analyze-repo [--editor <name>] [--limit <n>] [--upload-logs | --no-upload-logs]
+  "analyze-repo": `Usage: bitfab analyze-repo [--editor <name>] [--limit <n>] [--prompt <text>] [--upload-logs | --no-upload-logs] [prompt]
 
 Headlessly scan the repository for AI workflows and upload draft trace plans for the top candidates, with no prompts and no code edits.
 
+Pass free-text guidance to steer what the scan prioritizes, either with --prompt or as a trailing quoted argument.
+
 Options:
   --editor, -e <name>    Target editor: claude, codex, cursor
   --limit <n>            Cap how many draft trace plans to upload (default 5)
+  --prompt, -p <text>    Free-text guidance steering what the scan focuses on
   --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 --prompt "focus on the billing and checkout flows"
+  bitfab analyze-repo "only the agent orchestration code"
   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.
+Launch the Bitfab assistant in the selected editor. Extra arguments are passed through to the editor command. To pass an argument that looks like a bitfab flag, put it after \`--\`: everything after \`--\` is forwarded verbatim.
 
 Options:
   --editor, -e <name>    Target editor: claude, codex, cursor
@@ -32494,10 +32521,11 @@ Examples:
   bitfab assistant
   bitfab assistant investigate
   bitfab assistant --editor claude --skip-permissions
+  bitfab assistant -- --editor-flag value
 `,
   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.
+Update the Bitfab plugin, then launch the SDK update flow in the selected editor. Extra arguments are passed through to the editor command; use \`--\` to forward arguments that look like bitfab flags.
 
 Arguments:
   all       Update plugin and SDKs (default)
@@ -32534,6 +32562,15 @@ function parseLimit(raw) {
   }
   return n;
 }
+function resolveAnalyzeRepoPrompt(prompt, rest) {
+  if (prompt !== void 0) {
+    return prompt;
+  }
+  if (rest.length > 0) {
+    return rest.join(" ");
+  }
+  return void 0;
+}
 function isHelpCommand(command) {
   return command !== void 0 && Object.hasOwn(COMMAND_HELP_TEXT, command);
 }
@@ -32568,46 +32605,131 @@ function getHelpText(topic) {
 function wantsHelp(argv) {
   return getHelpTopic(argv) !== null;
 }
+var COMMAND_SPECS = {
+  init: { flags: ["editor", "skipPermissions"], unknownOption: "error" },
+  "plugin-install": { flags: ["editor"], unknownOption: "error" },
+  login: { flags: [], unknownOption: "error" },
+  logout: { flags: [], unknownOption: "error" },
+  "session-logs": { flags: [], unknownOption: "error" },
+  setup: { flags: ["editor", "skipPermissions"], unknownOption: "error" },
+  "analyze-repo": {
+    flags: ["editor", "uploadLogs", "limit", "prompt"],
+    unknownOption: "error"
+  },
+  assistant: { flags: ["editor", "skipPermissions"], unknownOption: "forward" },
+  update: { flags: ["editor", "skipPermissions"], unknownOption: "forward" },
+  help: { flags: [], unknownOption: "forward" }
+};
+var FALLBACK_SPEC = { flags: [], unknownOption: "forward" };
+function applyFlag(key, token, next, values) {
+  switch (key) {
+    case "editor":
+      if (token === "--editor" || token === "-e") {
+        if (next === void 0) {
+          throw new Error("--editor flag requires a value");
+        }
+        values.editor = next;
+        return 2;
+      }
+      if (token.startsWith("--editor=")) {
+        values.editor = token.slice("--editor=".length);
+        return 1;
+      }
+      return null;
+    case "skipPermissions":
+      if (token === "--skip-permissions") {
+        values.skipPermissions = true;
+        return 1;
+      }
+      if (token === "--no-skip-permissions") {
+        values.skipPermissions = false;
+        return 1;
+      }
+      return null;
+    case "uploadLogs":
+      if (token === "--upload-logs") {
+        values.uploadLogs = true;
+        return 1;
+      }
+      if (token === "--no-upload-logs") {
+        values.uploadLogs = false;
+        return 1;
+      }
+      return null;
+    case "limit":
+      if (token === "--limit") {
+        if (next === void 0) {
+          throw new Error("--limit flag requires a value");
+        }
+        values.limit = parseLimit(next);
+        return 2;
+      }
+      if (token.startsWith("--limit=")) {
+        values.limit = parseLimit(token.slice("--limit=".length));
+        return 1;
+      }
+      return null;
+    case "prompt":
+      if (token === "--prompt" || token === "-p") {
+        if (next === void 0) {
+          throw new Error("--prompt flag requires a value");
+        }
+        values.prompt = next;
+        return 2;
+      }
+      if (token.startsWith("--prompt=")) {
+        values.prompt = token.slice("--prompt=".length);
+        return 1;
+      }
+      return null;
+  }
+}
 function parseArgs2(argv) {
   const [command, ...tail] = argv;
-  let editor;
-  let skipPermissions;
-  let uploadLogs;
-  let limit;
+  const spec = command !== void 0 ? COMMAND_SPECS[command] ?? FALLBACK_SPEC : FALLBACK_SPEC;
+  const values = {};
   const rest = [];
   for (let i = 0; i < tail.length; i++) {
-    const arg = tail[i];
-    if (arg === "--editor" || arg === "-e") {
-      if (i + 1 < tail.length) {
-        editor = tail[i + 1];
-        i++;
-      } else {
-        throw new Error("--editor flag requires a value");
-      }
-    } else if (arg?.startsWith("--editor=")) {
-      editor = arg.slice("--editor=".length);
-    } else if (arg === "--skip-permissions") {
-      skipPermissions = true;
-    } else if (arg === "--no-skip-permissions") {
-      skipPermissions = false;
-    } else if (arg === "--upload-logs") {
-      uploadLogs = true;
-    } else if (arg === "--no-upload-logs") {
-      uploadLogs = false;
-    } else if (arg === "--limit") {
-      if (i + 1 < tail.length) {
-        limit = parseLimit(tail[i + 1]);
-        i++;
-      } else {
-        throw new Error("--limit flag requires a value");
+    const token = tail[i];
+    if (token === void 0) {
+      continue;
+    }
+    if (token === "--") {
+      for (let j = i + 1; j < tail.length; j++) {
+        rest.push(tail[j]);
+      }
+      break;
+    }
+    let claimed = false;
+    for (const key of spec.flags) {
+      const consumed = applyFlag(key, token, tail[i + 1], values);
+      if (consumed !== null) {
+        if (consumed === 2) {
+          i++;
+        }
+        claimed = true;
+        break;
       }
-    } else if (arg?.startsWith("--limit=")) {
-      limit = parseLimit(arg.slice("--limit=".length));
-    } else if (arg !== void 0) {
-      rest.push(arg);
     }
+    if (claimed) {
+      continue;
+    }
+    const isOption = token.startsWith("-") && token !== "-";
+    const isHelp = token === "-h" || token === "--help";
+    if (isOption && !isHelp && spec.unknownOption === "error") {
+      throw new Error(`unknown option '${token}' for command '${command}'`);
+    }
+    rest.push(token);
   }
-  return { command, editor, skipPermissions, uploadLogs, limit, rest };
+  return {
+    command,
+    editor: values.editor,
+    skipPermissions: values.skipPermissions,
+    uploadLogs: values.uploadLogs,
+    limit: values.limit,
+    prompt: values.prompt,
+    rest
+  };
 }
 async function main() {
   const argv = process.argv.slice(2);
@@ -32625,7 +32747,7 @@ ${GLOBAL_HELP_TEXT}`
     process.stdout.write(helpText);
     return;
   }
-  const { command, editor, skipPermissions, uploadLogs, limit, rest } = parseArgs2(argv);
+  const { command, editor, skipPermissions, uploadLogs, limit, prompt, rest } = parseArgs2(argv);
   const abortUpdateCheck = startUpdateCheck();
   if (command === "init") {
     await runInit({ editor, skipPermissions });
@@ -32658,7 +32780,13 @@ ${GLOBAL_HELP_TEXT}`
     return;
   }
   if (command === "analyze-repo") {
-    await runAnalyzeRepo({ editor, skipPermissions, uploadLogs, limit });
+    await runAnalyzeRepo({
+      editor,
+      skipPermissions,
+      uploadLogs,
+      limit,
+      prompt: resolveAnalyzeRepoPrompt(prompt, rest)
+    });
     abortUpdateCheck();
     return;
   }
@@ -32700,5 +32828,6 @@ export {
   getHelpTopic,
   isEntrypoint,
   parseArgs2 as parseArgs,
+  resolveAnalyzeRepoPrompt,
   wantsHelp
 };

package/package.json

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