@polderlabs/bizar 5.6.0-beta.8 → 5.6.0-beta.9

package/cli/agent-browser-up.sh

@@ -132,5 +132,21 @@ case "${1:-start}" in
   status)  ensure_binary; print_status ;;
   doctor)  ensure_binary; $AB_BIN doctor ;;
   install) ensure_binary; ensure_chrome; $AB_BIN install ;;
+  help|--help|-h)
+    cat <<'AGENT_BROWSER_UP_HELP'
+agent-browser-up -- start/stop the agent-browser daemon
+
+Usage: cli/agent-browser-up.sh <command>
+
+Commands:
+  start    Start the daemon (idempotent)
+  stop     Stop the daemon
+  restart  Stop + start
+  status   Print daemon status
+  doctor   Run agent-browser doctor
+  install  Install agent-browser + download Chrome
+AGENT_BROWSER_UP_HELP
+    exit 0
+    ;;
   *)       fail "unknown command: $1 (use start|stop|restart|status|doctor|install)" ;;
 esac

package/cli/bin.mjs

@@ -13,7 +13,8 @@
  * Commands:
  *   install, audit, init, export, artifact, update, test-gate, service, dash,
  *   memory, headroom, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
- *   heads-up, bg, agent-browser, agent-browser-up, providers, deploy, plugin, marketplace
+ *   heads-up, bg, agent-browser, agent-browser-up, providers, deploy, plugin,
+ *   marketplace, plan, digest, backup, restore, clip, ocr, voice, workspace, eval
  */
 import chalk from 'chalk';
 import { existsSync, readFileSync } from 'node:fs';
@@ -120,6 +121,13 @@ function showHelp() {
     providers detect    Auto-detect provider API keys from env + cline.json
     clip <subcommand>       Manage web clipper saved clips (list/delete/configure)
     ocr <subcommand>        OCR operations on images (list/process/configure)
+    digest                 Manage weekly digests (list/view/generate)
+    backup                 Create / list / verify / delete backups of BizarHarness state
+    restore                Restore BizarHarness from a backup
+    voice                  Manage voice notes (via the dashboard's HTTP API)
+    workspace              Manage workspaces (via the dashboard's HTTP API)
+    eval                   Evaluate AI agent outputs against golden fixtures
+    plan                   [v6.0.0+] Reserved for future plan management
 
   Examples:
     bizar install
@@ -189,8 +197,30 @@ async function main() {
   }
 
   if (isHelpRequest && !cmd.startsWith('-')) {
-    // Pass --help to the command
-    const mod = await importCommand(cmd);
+    // Pass --help to the command. Commands dispatched through util.mjs
+    // (audit, init, export, doctor, backup, restore, etc.) don't have
+    // their own cli/commands/<name>.mjs — they all live in util.mjs.
+    const UTIL_COMMANDS = new Set([
+      'audit', 'init', 'export', 'test-gate', 'dev-link', 'dev-unlink',
+      'doctor', 'repair', 'heads-up', 'bg', 'digest', 'backup', 'restore',
+      'agent-browser', 'update', 'providers', 'plan',
+    ]);
+    const UTIL_ALIASES = new Set(['dashboard', 'agent-browser-up']);
+    let mod;
+    if (UTIL_COMMANDS.has(cmd)) {
+      // util-based commands: audit, init, etc.
+      mod = await importCommand('util');
+    } else if (UTIL_ALIASES.has(cmd)) {
+      // util aliases: dashboard → dash, agent-browser-up → bash script
+      if (cmd === 'dashboard') {
+        mod = await importCommand('dash');
+      } else if (cmd === 'agent-browser-up') {
+        // Run via util.mjs's `agent-browser-up` case
+        mod = await importCommand('util');
+      }
+    } else {
+      mod = await importCommand(cmd);
+    }
     if (mod && typeof mod.run === 'function') {
       await mod.run(cmd, cmdArgs, true);
       return;
@@ -430,6 +460,8 @@ async function main() {
     case 'heads-up':
     case 'bg':
     case 'digest':
+    case 'backup':
+    case 'restore':
     case 'agent-browser':
     case 'agent-browser-up':
     case 'providers':
@@ -451,6 +483,20 @@ async function main() {
       break;
     }
 
+    case 'voice':
+    case 'workspace':
+    case 'eval': {
+      // Each of these has its own module file in cli/commands/.
+      const mod = await importCommand(cmd);
+      if (!mod) {
+        console.error(chalk.red(`  ✗ Could not load ${cmd} command module`));
+        process.exit(EXIT_ERROR);
+        return;
+      }
+      if (mod.run) await mod.run(cmd, cmdArgs, isHelpRequest);
+      break;
+    }
+
     default: {
       console.error(chalk.red(`  ✗ Unknown command: ${cmd}`));
       showHelp();

package/cli/cli-commands-validation.test.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * /tmp/test-cli-commands.mjs
+ * Comprehensive validation of every `bizar` CLI command.
+ *
+ * Tests:
+ *   - All case branches in cli/bin.mjs respond to --help
+ *   - All case branches in cli/commands/util.mjs respond to --help
+ *   - Module exports are loadable
+ *
+ * Usage:  node /tmp/test-cli-commands.mjs
+ */
+
+import { spawnSync } from 'node:child_process';
+
+const REPO = process.cwd();
+const BIN = `${REPO}/cli/bin.mjs`;
+
+const ALL_COMMANDS = [
+  // Util-based (live in cli/commands/util.mjs)
+  'audit', 'init', 'export', 'test-gate', 'dev-link', 'dev-unlink',
+  'doctor', 'repair', 'heads-up', 'bg', 'digest', 'backup', 'restore',
+  'agent-browser', 'agent-browser-up', 'providers',
+  // Own module
+  'install', 'update',
+  'service',
+  'dash', 'dashboard',
+  'minimax', 'tailscale', 'headroom', 'lightrag',
+  'mod', 'usage',
+  'deploy', 'plugin', 'marketplace',
+  'artifact',
+  'memory',
+  'memory',
+  'clip', 'ocr',
+  'voice', 'workspace', 'eval',
+];
+
+const NON_OWN_MODULE = new Set([
+  'audit', 'init', 'export', 'test-gate', 'dev-link', 'dev-unlink',
+  'doctor', 'repair', 'heads-up', 'bg', 'digest', 'backup', 'restore',
+  'agent-browser', 'agent-browser-up', 'providers', 'install', 'update',
+]);
+
+const seen = new Set();
+const passed = [];
+const failed = [];
+
+for (const cmd of ALL_COMMANDS) {
+  if (seen.has(cmd)) continue;
+  seen.add(cmd);
+
+  // Run `node cli/bin.mjs <cmd> --help` and check exit code + that it prints help
+  const r = spawnSync('node', [BIN, cmd, '--help'], {
+    timeout: 15_000,
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  const stdout = r.stdout || '';
+  const stderr = r.stderr || '';
+  const exitCode = r.status;
+
+  // Pass criteria:
+  //  - Exit code 0 OR 2 (CLINE exit code for usage/help is 2 sometimes)
+  //  - stdout mentions the command name or contains a recognizable help string
+  //  - stderr is empty OR mentions the command name (not "module not found")
+  const hasModuleError = stderr.includes('Cannot find module') ||
+                         stderr.includes('Failed to load command module');
+  const hasHelp = stdout.toLowerCase().includes(cmd) ||
+                  stdout.includes('Usage:') ||
+                  stdout.includes('Subcommands:') ||
+                  stdout.includes('Description:');
+
+  if ((exitCode === 0 || exitCode === 2) && !hasModuleError && (hasHelp || stdout.length > 50)) {
+    passed.push({ cmd, exitCode, stdoutLines: stdout.split('\n').length });
+  } else {
+    failed.push({ cmd, exitCode, hasModuleError, hasHelp, stdout: stdout.slice(0, 200), stderr: stderr.slice(0, 200) });
+  }
+}
+
+console.log(`\n=== CLI command validation ===\n`);
+console.log(`Passed: ${passed.length}/${seen.size}`);
+console.log(`Failed: ${failed.length}\n`);
+
+if (passed.length > 0) {
+  console.log('=== Passing commands ===');
+  for (const p of passed) {
+    console.log(`  ✓ ${p.cmd.padEnd(20)} (exit ${p.exitCode}, ${p.stdoutLines} lines)`);
+  }
+  console.log();
+}
+
+if (failed.length > 0) {
+  console.log('=== FAILING commands ===');
+  for (const f of failed) {
+    console.log(`  ✗ ${f.cmd.padEnd(20)} exitCode=${f.exitCode} moduleErr=${f.hasModuleError} hasHelp=${f.hasHelp}`);
+    if (f.hasModuleError) {
+      console.log(`      stderr: ${f.stderr.trim()}`);
+    } else if (f.exitCode !== 0 && f.exitCode !== 2) {
+      console.log(`      stderr: ${f.stderr.trim().slice(0, 200)}`);
+      console.log(`      stdout: ${f.stdout.trim().slice(0, 200)}`);
+    }
+  }
+  console.log();
+}
+
+process.exit(failed.length > 0 ? 1 : 0);

package/cli/commands/clip.mjs

@@ -10,7 +10,24 @@
  */
 
 import chalk from 'chalk';
-import { readDashboardConn } from './headroom.mjs';
+// Mirror `readDashboardConn` from clip.mjs / minimax.mjs / usage.mjs.
+function readDashboardConn() {
+  const cfgDir = process.env.XDG_CONFIG_HOME
+    ? require_('node:path').join(process.env.XDG_CONFIG_HOME, 'bizar')
+    : require_('node:path').join(require_('node:os').homedir(), '.config', 'bizar');
+  const portPath = require_('node:path').join(cfgDir, 'dashboard.port');
+  const secretPath = require_('node:path').join(cfgDir, 'dashboard.secret');
+  const port = require_('node:fs').existsSync(portPath)
+    ? parseInt(require_('node:fs').readFileSync(portPath, 'utf8').trim(), 10)
+    : 4321;
+  const secret = require_('node:fs').existsSync(secretPath)
+    ? require_('node:fs').readFileSync(secretPath, 'utf8').trim()
+    : '';
+  return {
+    port: Number.isFinite(port) && port > 0 ? port : 4321,
+    secret,
+  };
+}
 
 // ── API helpers ────────────────────────────────────────────────────────────────
 

package/cli/commands/eval.mjs

@@ -15,7 +15,25 @@ import chalk from 'chalk';
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
-import { readDashboardConn } from './headroom.mjs';
+
+// Mirror `readDashboardConn` from clip.mjs / minimax.mjs / usage.mjs.
+function readDashboardConn() {
+  const cfgDir = process.env.XDG_CONFIG_HOME
+    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
+    : join(homedir(), '.config', 'bizar');
+  const portPath = join(cfgDir, 'dashboard.port');
+  const secretPath = join(cfgDir, 'dashboard.secret');
+  const port = existsSync(portPath)
+    ? parseInt(readFileSync(portPath, 'utf8').trim(), 10)
+    : 4321;
+  const secret = existsSync(secretPath)
+    ? readFileSync(secretPath, 'utf8').trim()
+    : '';
+  return {
+    port: Number.isFinite(port) && port > 0 ? port : 4321,
+    secret,
+  };
+}
 
 const HOME = homedir();
 const TEMPLATES_DIR = join(HOME, '.config', 'bizar', 'templates', 'eval-fixtures');

package/cli/commands/lightrag.mjs

@@ -18,7 +18,6 @@
 import chalk from 'chalk';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { process } from 'node:process';
 
 export function showLightragHelp() {
   console.log(`

package/cli/commands/ocr.mjs

@@ -11,7 +11,24 @@
 
 import chalk from 'chalk';
 import { readFileSync, existsSync } from 'node:fs';
-import { readDashboardConn } from './headroom.mjs';
+// Mirror `readDashboardConn` from clip.mjs / minimax.mjs / usage.mjs.
+function readDashboardConn() {
+  const cfgDir = process.env.XDG_CONFIG_HOME
+    ? require_('node:path').join(process.env.XDG_CONFIG_HOME, 'bizar')
+    : require_('node:path').join(require_('node:os').homedir(), '.config', 'bizar');
+  const portPath = require_('node:path').join(cfgDir, 'dashboard.port');
+  const secretPath = require_('node:path').join(cfgDir, 'dashboard.secret');
+  const port = require_('node:fs').existsSync(portPath)
+    ? parseInt(require_('node:fs').readFileSync(portPath, 'utf8').trim(), 10)
+    : 4321;
+  const secret = require_('node:fs').existsSync(secretPath)
+    ? require_('node:fs').readFileSync(secretPath, 'utf8').trim()
+    : '';
+  return {
+    port: Number.isFinite(port) && port > 0 ? port : 4321,
+    secret,
+  };
+}
 
 // ── API helpers ────────────────────────────────────────────────────────────────
 

package/cli/commands/usage.mjs

@@ -105,5 +105,9 @@ async function runUsageCommand(args, wantJson = false) {
 }
 
 export async function run(name, args, isHelpRequest) {
+  if (isHelpRequest || args.length === 0) {
+    showUsageHelp();
+    return;
+  }
   await runUsageCommand(args, false);
 }

package/cli/commands/util.mjs

@@ -154,6 +154,24 @@ export function showBackupHelp() {
   `);
 }
 
+export function showProvidersHelp() {
+  console.log(`
+  bizar providers - Auto-detect provider API keys
+
+  Usage:
+    bizar providers detect     Auto-detect provider API keys from env + cline.json
+    bizar providers --help     Show this help
+
+  Description:
+    Scans process.env + ~/.config/cline/cline.json for known provider
+    API keys (OpenAI, Anthropic, OpenRouter, MiniMax, etc.) and reports
+    what's available. Useful before the first \`bizar install\` to verify
+    credentials are picked up.
+
+  No API keys are sent over the network - detection is local.
+  `);
+}
+
 export function showRestoreHelp() {
   console.log(`
   bizar restore — Restore BizarHarness from a backup
@@ -209,6 +227,18 @@ export async function runTestGate() {
 
 export async function run(name, args, isHelpRequest) {
   switch (name) {
+    case 'update':
+      // `bizar update` lives in commands/install.mjs (the install/update
+      // pair share a code path). Proxy to it.
+      if (isHelpRequest) {
+        const { showUpdateHelp } = await import('./install.mjs');
+        showUpdateHelp();
+      } else {
+        const { runUpdate } = await import('./install.mjs');
+        await runUpdate(args, {});
+      }
+      break;
+
     case 'audit':
       if (isHelpRequest) showAuditHelp();
       else {
@@ -506,6 +536,10 @@ export async function run(name, args, isHelpRequest) {
     }
 
     case 'providers':
+      if (isHelpRequest || args.length === 0) {
+        showProvidersHelp();
+        break;
+      }
       if (args[0] === 'detect') {
         const { runProvidersDetect } = await import('../providers-detect.mjs');
         await runProvidersDetect(args.slice(1));

package/cli/digest.mjs

@@ -13,7 +13,7 @@
 import chalk from 'chalk';
 import { readFileSync, existsSync } from 'node:fs';
 
-function showDigestHelp() {
+export function showDigestHelp() {
   console.log(`
   bizar digest — Manage weekly digests
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "5.6.0-beta.8",
+  "version": "5.6.0-beta.9",
   "description": "Norse-pantheon multi-agent system for cline — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. v4 ships as a single npm package bundling the dashboard server, cline plugin, and typed SDK.",
   "type": "module",
   "bin": {

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar-sdk",
-  "version": "0.2.0-beta.8",
+  "version": "0.2.0-beta.9",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",