@polderlabs/bizar 10.7.2 → 10.11.0

package/cli/bin.mjs

@@ -5,16 +5,9 @@
  * v4.6 — `bizar` runtime CLI entrypoint.
  *
  * Architecture:
- *   - `bizar` is the core runtime + installer + audit/init/export/update/artifact
- *     + service + dash commands.
- *   - The dashboard lives in `@polderlabs/bizar-dash` as a library.
+ *   - `bizar` is the core runtime plus installer, audit, init, export,
+ *     update, guarded team/subagent, cost, claim, and task commands.
  *   - Subcommand implementations are in `cli/commands/*.mjs`.
- *
- * Commands:
- *   install, audit, init, export, artifact, update, test-gate, service, dash,
- *   memory, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
- *   heads-up, bg, kevin, kevin-up, providers, deploy, plugin,
- *   marketplace, plan, digest, backup, restore, clip, ocr, voice, workspace, eval
  */
 import chalk from 'chalk';
 import { existsSync, readFileSync } from 'node:fs';
@@ -64,41 +57,19 @@ function dbg(...msg) {
 const onlyGlobalFlag = args.length === 1 && (args[0] === '--help' || args[0] === '-h' || args[0] === '--version' || args[0] === '-v' || args[0] === '--json');
 const dispatchArgs = onlyGlobalFlag ? [] : args;
 
-// ── Bootstrap ──────────────────────────────────────────────────────────────────
-if (
-  !args.includes('--postinstall') &&
-  !args.includes('--check') &&
-  !isHelpRequest &&
-  !isVersionRequest &&
-  !process.env.BIZAR_SKIP_INSTALL
-) {
-  await ensureSetup({ silent: true });
-}
-
-// ── Build guard (v8.0.2) ─────────────────────────────────────────────────────
-// The dashboard imports `packages/sdk/dist/memory/index.js` and the
-// plugin loader expects `plugins/bizar/dist/index.js`. On a fresh npm
-// install these directories are missing because the tarball ships only
-// TS source. Build them once on entry so `bizar dash start` (and any
-// other subcommand that touches the dashboard) never crashes with
-// `Cannot find module .../packages/sdk/dist/memory/index.js` or
-// `Plugin source not found at .../plugins/bizar`. Both builders are
-// idempotent and skip when dist/ already exists.
+// ── Build guard ───────────────────────────────────────────────────────────────
+// The tarball ships TypeScript source. Build the SDK once on entry.
 if (
   !isHelpRequest &&
   !isVersionRequest &&
   !process.env.BIZAR_SKIP_BUILD
 ) {
   try {
-    const { buildSdk, buildPlugin } = await import('./provision.mjs');
+    const { buildSdk } = await import('./provision.mjs');
     const sdkRes = await buildSdk();
     if (sdkRes.ok && !sdkRes.skipped) {
       console.error(chalk.dim(`  → ${sdkRes.message}`));
     }
-    const plugRes = await buildPlugin();
-    if (plugRes.ok && !plugRes.skipped) {
-      console.error(chalk.dim(`  → ${plugRes.message}`));
-    }
   } catch (err) {
     // Best-effort: never abort the user command on a build hiccup.
     if (process.env.BIZAR_DEBUG) {
@@ -110,7 +81,7 @@ if (
 // ── Banner ─────────────────────────────────────────────────────────────────────
 
 function showBanner() {
-  console.log(chalk.bold.cyan('  ᛭ Bizar — Norse Pantheon Agent System for Claude Code'));
+  console.log(chalk.bold.cyan('  Bizar — guarded autonomous workflows for Claude Code'));
   console.log();
 }
 
@@ -124,60 +95,32 @@ function showHelp() {
 
   Commands:
     install             Run the interactive installer
-    migrate             Migrate legacy ~/.config/cline/ or ~/.config/bizar/ to ~/.claude/
+    migrate             Migrate retired ~/.config/cline/ config to ~/.claude/
     audit               Run security audit on agent configuration
     init                Initialize .bizar/ in current project
     export [target]     Export agents/rules to another harness
-    artifact <subcommand>  Manage visual artifacts
     test-gate           Detect & run the project's test suite
-    update              Auto-update everything (claude + bizar + dash + sdk)
-    service             Manage the background service daemon
-    dash <subcommand>   Manage the dashboard (start/stop/status/cleanup/tui)
-    memory <subcommand> Manage project memory (Bizar Memory Service)
-    lightrag <subcommand> Manage the LightRAG knowledge-graph server (status/start/autostart)
-    minimax <subcommand>   Manage MiniMax Token Plan integration
-    tailscale <subcommand> Manage Tailscale integration (auth, serve, status)
-    mod <subcommand>       Manage mods (install/upgrade/list via the dashboard API)
-    usage                 Show compact usage analytics summary (24h rolling)
+    update              Update Claude Code, Bizar, and the SDK
     doctor              Check the BizarHarness install for health issues
     repair              Fix common install issues
-    dev-link            Symlink local SDK source into Claude Code's plugin dir
-    dev-unlink          Remove the dev symlink and restore the deployed copy
     heads-up <subcommand>  Manage pre-push / pre-release heads-ups
-    bg <subcommand>     Manage background agents (list/view/kill/logs)
-    deploy              One-click deploy to Vercel, Cloudflare, Fly.io, or Docker
-    plugin <subcommand> Manage marketplace plugins (search/install/config/invoke)
-    marketplace <subcommand>  Browse and install plugins from the public marketplace
-    kevin      Install / update / verify the kevin CLI
-    kevin-up    Start Chromium for kevin (start/stop/status)
-    providers detect    Auto-detect provider API keys from env + ~/.claude/settings.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)
+    browser                Install, update, and verify agent-browser
     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
-    validate               Validate the Bizar install (21 checks)
+    validate               Validate the Bizar install
     setup-provider         Configure a provider in ~/.claude/settings.json (since v6.2.2 installer doesn't touch providers)
-    config                 Show current Claude Code configuration (pass-through to claude config)
-    history                List session history (pass-through to claude history)
-    hub                    Manage the local hub daemon (pass-through to claude hub)
-    hook                   Handle a hook payload from stdin (pass-through to claude hook)
-    team                   Spawn an agent team from CLI (wraps claude --team-name)
-    subagent               Spawn a read-only research subagent from CLI
+    team                   Run the office-manager orchestration agent
+    subagent               Run a named agent in read-only plan mode
+    run                    Run Claude Code once (optionally --bg)
     rca                    Analyze a GitHub issue (Claude Code CLI sample)
     cost <subcommand>      Atomic cost gate (SQLite-backed room budget tracker)
     claim <subcommand>     GitHub-style claim protocol over feature_list.json
+    task <subcommand>      Durable dependency/worktree/path task coordination
+    control <subcommand>   Machine-readable agents/tasks/sessions/messages API
 
   Examples:
     bizar install
     bizar audit
-    bizar dash start
-    bizar dash start --bg
-    bizar dash stop
     bizar doctor
     bizar update --all --dry-run
 
@@ -243,25 +186,21 @@ async function main() {
     // (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',
-      'kevin', 'update', 'providers', 'plan', 'validate',
-      'setup-provider', 'config', 'history', 'hub', 'hook',
-      'team', 'subagent', 'rca',
+      'audit', 'init', 'export', 'test-gate',
+      'doctor', 'repair', 'heads-up', 'backup', 'restore',
+      'browser',
     ]);
-    const UTIL_ALIASES = new Set(['dashboard', 'kevin-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, kevin-up → bash script
-      if (cmd === 'dashboard') {
-        mod = await importCommand('dash');
-      } else if (cmd === 'kevin-up') {
-        // Run via util.mjs's `kevin-up` case
-        mod = await importCommand('util');
-      }
+    } else if (cmd === 'install' || cmd === 'update') {
+      mod = await importCommand('install');
+    } else if (cmd === 'team' || cmd === 'subagent' || cmd === 'run') {
+      mod = await importCommand('claude-cmd');
+    } else if (cmd === 'migrate') {
+      const { runMigrate } = await import('./migrate.mjs');
+      await runMigrate(['--help']);
+      return;
     } else {
       mod = await importCommand(cmd);
     }
@@ -300,239 +239,6 @@ async function main() {
       break;
     }
 
-    case 'service': {
-      const mod = await importCommand('service');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load service command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'service');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'dash':
-    case 'dashboard': {
-      const mod = await importCommand('dash');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load dash command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'dash');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'minimax': {
-      const mod = await importCommand('minimax');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load minimax command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'minimax');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'tailscale': {
-      const mod = await importCommand('tailscale');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load tailscale command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'tailscale');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'lightrag': {
-      // v5.x — LightRAG management CLI (issue #6).
-      // Subcommands: status, start, autostart.
-      const mod = await importCommand('lightrag');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load lightrag command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'lightrag');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'mod': {
-      const mod = await importCommand('mod');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load mod command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'mod');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'artifact': {
-      const mod = await importCommand('artifact');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load artifact command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'artifact');
-      await mod.runArtifact(cmdArgs, { wantJson });
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'memory': {
-      const mod = await importCommand('memory');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load memory command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'memory');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'usage': {
-      const mod = await importCommand('usage');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load usage command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'usage');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'deploy': {
-      const mod = await importCommand('deploy');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load deploy command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'deploy');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'plugin': {
-      const mod = await importCommand('plugin');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load plugin command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'plugin');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'marketplace': {
-      const mod = await importCommand('marketplace');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load marketplace command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'marketplace');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-      case 'clip': {
-      const mod = await importCommand('clip');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load clip command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'clip');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-    case 'ocr': {
-      const mod = await importCommand('ocr');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load ocr command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'ocr');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
-  // All other utility commands
-    case 'audit':
-    case 'init':
-    case 'export':
-    case 'test-gate':
-    case 'dev-link':
-    case 'dev-unlink':
-    case 'doctor':
-    case 'repair':
-    case 'heads-up':
-    case 'bg':
-    case 'digest':
-    case 'backup':
-    case 'restore':
-    case 'kevin':
-    case 'kevin-up':
-    case 'providers':
-    case 'plan': {
-      const mod = await importCommand('util');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load util command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'util');
-      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      if (!found) {
-        console.error(chalk.red(`  ✗ Unknown command: ${cmd}`));
-        showHelp();
-        process.exit(EXIT_ERROR);
-      }
-      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;
-    }
 
     case 'validate': {
       const mod = await importCommand('validate');
@@ -568,14 +274,9 @@ async function main() {
       break;
     }
 
-    case 'config':
-    case 'history':
-    case 'hub':
-    case 'hook':
     case 'team':
-    case 'subagent': {
-      // v6.3.0 — Pass-through wrappers for Claude Code CLI commands.
-      // These live in cli/commands/claude-cmd.mjs.
+    case 'subagent':
+    case 'run': {
       const mod = await importCommand('claude-cmd');
       if (!mod) {
         console.error(chalk.red(`  ✗ Could not load claude-cmd module`));
@@ -593,7 +294,7 @@ async function main() {
     }
 
     case 'rca': {
-      // v6.2.3 — GitHub Issue RCA sample (adapted from Cline docs).
+      // Read-only GitHub Issue RCA through Claude Code plan mode.
       const mod = await importCommand('rca');
       if (!mod) {
         console.error(chalk.red(`  ✗ Could not load rca command module`));
@@ -610,9 +311,28 @@ async function main() {
       break;
     }
 
+    case 'audit':
+    case 'init':
+    case 'export':
+    case 'test-gate':
+    case 'doctor':
+    case 'repair':
+    case 'heads-up':
+    case 'backup':
+    case 'restore':
+    case 'browser': {
+      const mod = await importCommand('util');
+      if (!mod) {
+        process.exit(EXIT_ERROR);
+        return;
+      }
+      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
+      if (!found) process.exitCode = EXIT_USAGE;
+      break;
+    }
+
     case 'sandbox': {
-      // v6.3.0 — CubeSandbox (E2B-compatible KVM microVM) wrapper.
-      // Subcommands: doctor | run | list | kill | install-template | config
+      // CubeSandbox (E2B-compatible KVM microVM) wrapper.
       const mod = await importCommand('sandbox');
       if (!mod) {
         console.error(chalk.red(`  ✗ Could not load sandbox command module`));
@@ -660,6 +380,38 @@ async function main() {
       break;
     }
 
+    case 'task': {
+      const mod = await importCommand('task');
+      if (!mod) {
+        console.error(chalk.red(`  ✗ Could not load task command module`));
+        process.exit(EXIT_ERROR);
+        return;
+      }
+      dbg('loaded command module:', 'task');
+      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
+      if (found === false) {
+        console.error(chalk.red(`  ✗ Usage: bizar task <subcommand> — run 'bizar task --help'`));
+        process.exit(EXIT_USAGE);
+      }
+      break;
+    }
+
+    case 'control': {
+      const mod = await importCommand('control');
+      if (!mod) {
+        console.error(chalk.red(`  ✗ Could not load control command module`));
+        process.exit(EXIT_ERROR);
+        return;
+      }
+      dbg('loaded command module:', 'control');
+      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
+      if (found === false) {
+        console.error(chalk.red(`  ✗ Usage: bizar control <subcommand> — run 'bizar control --help'`));
+        process.exit(EXIT_USAGE);
+      }
+      break;
+    }
+
     default: {
       console.error(chalk.red(`  ✗ Unknown command: ${cmd}`));
       showHelp();
@@ -671,7 +423,7 @@ async function main() {
 // ── Run ───────────────────────────────────────────────────────────────────────
 
 const thisFile = fileURLToPath(import.meta.url);
-// Resolve symlinks: when invoked via a symlink (e.g. /home/drb0rk/.local/bin/bizar),
+// Resolve symlinks: when invoked via a symlink (e.g. /home/user/.local/bin/bizar),
 // process.argv[1] is the symlink path, but import.meta.url is the resolved target.
 // Compare via realpath so main() runs regardless of how the script is invoked.
 const { realpathSync } = await import('node:fs');

package/cli/bootstrap.mjs

@@ -3,22 +3,19 @@
  *
  * v3.2.2 — Self-bootstrap on first bin invocation.
  *
- * Replaces the postinstall hook (which npm v10+ blocks by default).
- * Every `bizar` bin command now checks setup status on entry and runs
- * the postinstall logic automatically if anything is missing.
+ * Explicit setup status and installation helper.
  *
  * Key design:
  *   - Checks for SETUP_MARKERS (odyssey files that prove setup was done)
  *   - If ALL markers exist → silent no-op
- *   - If ANY marker is missing → runs postinstall logic
- *   - Idempotent: already-installed components are skipped by the postinstall
+ *   - If ANY marker is missing → the explicit setup action runs the provisioner
  */
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import chalk from 'chalk';
 
-import { clineAgentsDir, clineConfigDir } from './utils.mjs';
-import { runPostInstall } from './install.mjs';
+import { claudeAgentsDir, claudeConfigDir } from './utils.mjs';
+import { runInstaller } from './install.mjs';
 
 /**
  * Key files that prove setup has been run at least once.
@@ -26,8 +23,8 @@ import { runPostInstall } from './install.mjs';
  * If ANY are missing → setup is needed.
  */
 const SETUP_MARKERS = [
-  join(clineAgentsDir(), 'mike.md'),           // core agent installed
-  join(clineConfigDir(), 'plugins', 'bizar'),   // plugin installed
+  join(claudeAgentsDir(), 'office-manager.md'),
+  join(claudeConfigDir(), 'settings.json'),
 ];
 
 /**
@@ -49,7 +46,7 @@ export function checkSetupStatus() {
  */
 function printSetupBanner() {
   // Use console.log directly to avoid chalk formatting issues in non-TTY
-  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, Semble, Skills CLI...\n');
+  console.log('\n  ⚡ First-time setup — Bizar needs to install Claude Code agents, hooks, skills, and settings...\n');
 }
 
 /**
@@ -59,7 +56,7 @@ function printSetupBanner() {
  *   autoApprove — if true, skip interactive prompts (BIZAR_SKIP_OPTIONAL_INSTALLS already set by caller)
  *   silent       — if true, suppress the "first-time setup" banner (used when invoked silently on bin entry)
  *
- * Idempotent: runPostInstall() skips already-installed components.
+ * Idempotent: the provisioner skips already-installed components.
  */
 export async function ensureSetup({ silent = false } = {}) {
   const status = checkSetupStatus();
@@ -73,5 +70,5 @@ export async function ensureSetup({ silent = false } = {}) {
     printSetupBanner();
   }
 
-  await runPostInstall();
+  await runInstaller({ mode: 'install' });
 }