@polderlabs/bizar 4.5.1 → 4.5.2

package/cli/bin.mjs

@@ -22,6 +22,13 @@ import { fileURLToPath } from 'node:url';
 
 const HOME = homedir();
 const BIZAR_HOME = join(HOME, '.config', 'bizar');
+
+// Exit codes
+const EXIT_OK = 0;
+const EXIT_ERROR = 1;
+const EXIT_USAGE = 2;
+const EXIT_MISSING_DEP = 3;
+const EXIT_TIMEOUT = 4;
 import chalk from 'chalk';
 import { runInstaller } from './install.mjs';
 import { runAudit } from './audit.mjs';
@@ -35,6 +42,17 @@ import { ensureSetup, checkSetupStatus } from './bootstrap.mjs';
 const args = process.argv.slice(2);
 const isHelpRequest = args.includes('--help') || args.includes('-h');
 const isVersionRequest = args.includes('--version') || args.includes('-v');
+const wantJson = args.includes('--json');
+const wantDebug = args.includes('--debug');
+
+if (wantDebug) {
+  process.env.DEBUG = 'bizar:*';
+  process.env.BIZAR_DEBUG = '1';
+}
+
+function dbg(...msg) {
+  if (wantDebug) console.error('[DEBUG]', ...msg);
+}
 
 // ── Bootstrap ─────────────────────────────────────────────────────────────────
 // Every bin command checks setup status on first invocation.
@@ -759,7 +777,7 @@ function showUsageHelp() {
   `);
 }
 
-async function runUsageCommand(args) {
+async function runUsageCommand(args, wantJson = false) {
   const range = (args[0] && ['24h', '7d', '30d'].includes(args[0])) ? args[0] : '24h';
   const { port, secret } = readDashboardConn();
   const url = `http://127.0.0.1:${port}/api/usage?range=${range}`;
@@ -774,6 +792,10 @@ async function runUsageCommand(args) {
       console.error(chalk.red(`  ✗ Failed to load usage data: ${data?.message ?? resp.statusText}`));
       process.exit(1);
     }
+    if (wantJson) {
+      process.stdout.write(JSON.stringify(data) + '\n');
+      return;
+    }
     const t = data.totals;
     console.log('');
     console.log(chalk.bold(`  Usage summary — ${range} (from JSONL store)`));
@@ -1083,11 +1105,15 @@ function parseFlag(name) {
  * Returns `null` if the flag isn't present (the provisioner's
  * "don't touch mods" default), or a string[] of mod ids if it is.
  */
-function parseWithModsFlag(subargs) {
+export function parseWithModsFlag(subargs) {
   const idx = subargs.indexOf('--with-mods');
   if (idx === -1) return null;
   const raw = subargs[idx + 1];
-  if (!raw || raw.startsWith('--')) return [];
+  if (!raw || raw.startsWith('--')) {
+    console.error('bizar: --with-mods requires a value (e.g. --with-mods a,b,c)');
+    console.error('Usage: bizar install --with-mods <mod-id,mod-id>');
+    process.exit(2);
+  }
   return raw
     .split(',')
     .map((s) => s.trim())
@@ -1181,7 +1207,7 @@ async function main() {
     if (isHelpRequest && !args[1]) showMemoryHelp();
     else {
       const { runMemory } = await import('./memory.mjs');
-      await runMemory(args[1], args.slice(2));
+      await runMemory(args[1], args.slice(2), { wantJson });
     }
   } else if (args[0] === 'headroom') {
     await runHeadroomCommand(args.slice(1));
@@ -1229,8 +1255,11 @@ async function main() {
     if (isHelpRequest) showDoctorHelp();
     else {
       const { runDoctor } = await import('./doctor.mjs');
-      const result = await runDoctor();
-      if (result.failed > 0) process.exit(1);
+      const result = await runDoctor({ silent: wantJson, json: wantJson });
+      if (wantJson) {
+        process.stdout.write(JSON.stringify(result) + '\n');
+      }
+      if (result.failed > 0) process.exit(EXIT_ERROR);
     }
   } else if (args[0] === 'repair') {
     // v4.4.3 — One-shot repair for stale `bizar` bin symlinks.
@@ -1328,11 +1357,11 @@ async function main() {
     await runMinimaxCommand(args.slice(1));
   } else if (args[0] === 'usage') {
     // v4.6.0 — Compact usage analytics summary from the JSONL store.
-    await runUsageCommand(args.slice(1));
+    await runUsageCommand(args.slice(1), wantJson);
   } else if (args[0] === 'dash' || args[0] === 'dashboard') {
     // `bizar dashboard` is a deprecated alias for `bizar dash`
     if (args[0] === 'dashboard') {
-      console.warn(chalk.yellow('  ⚠ `bizar dashboard` is deprecated, use `bizar dash` instead.'));
+      process.stdout.write(chalk.yellow('  ⚠ `bizar dashboard` is deprecated, use `bizar dash` instead.\n'));
     }
     const dashArgs = args.slice(1); // everything after 'dash' or 'dashboard'
     if (dashArgs.length === 0 || isHelpRequest) {
@@ -1458,7 +1487,12 @@ async function runDash(dashArgs) {
 
 // ── Main ──────────────────────────────────────────────────────────────────────
 
-await main().catch((err) => {
-  console.error(chalk.red(`bizar: ${err && err.message ? err.message : String(err)}`));
-  process.exit(1);
-});
+// Only run main() when bin.mjs is executed directly (not imported as a module in tests)
+const thisFile = fileURLToPath(import.meta.url);
+const isMainModule = process.argv[1] === thisFile;
+if (isMainModule) {
+  await main().catch((err) => {
+    console.error(chalk.red(`bizar: ${err && err.message ? err.message : String(err)}`));
+    process.exit(1);
+  });
+}

package/cli/doctor.mjs

@@ -269,10 +269,12 @@ const CHECKS = [
 
 /**
  * Run all health checks. Prints per-check output unless `opts.silent`.
- * Always prints a final summary line. Returns `{ passed, failed, results }`.
+ * Prints a final summary line unless `opts.json` is true.
+ * Returns `{ passed, failed, results }`.
  */
 export async function runDoctor(opts = {}) {
   const silent = !!opts.silent;
+  const jsonMode = !!opts.json;
   const results = [];
   for (const [name, fn] of CHECKS) {
     const r = await runCheck(name, fn);
@@ -288,8 +290,8 @@ export async function runDoctor(opts = {}) {
   const passed = results.filter((r) => r.ok).length;
   const failed = results.length - passed;
 
-  // Always print a summary line if there were failures, or if not silent.
-  if (failed > 0 || !silent) {
+  // Print summary line only when not in JSON mode
+  if (!jsonMode && (failed > 0 || !silent)) {
     console.log('');
     if (failed === 0) {
       console.log(

package/cli/memory.mjs

@@ -755,7 +755,8 @@ function printSetupResult({ mode, remote, vaultPath }) {
 /**
  * `bizar memory status`
  */
-async function cmdStatus(_args) {
+async function cmdStatus(_args, opts = {}) {
+  const { wantJson = false } = opts;
   const projectRoot = getProjectRoot();
   const { loadConfig, resolveVault, initVault, listNotes } = memoryStore;
   const { isGitInstalled, status: gitStatus } = memoryGit;
@@ -768,19 +769,15 @@ async function cmdStatus(_args) {
 
   const { vaultRoot, mode, projectId, branch } = resolveVault(projectRoot);
 
-  console.log(chalk.bold('\n  Bizar Memory Status'));
-  console.log('  ─────────────────────────────');
-  kv('mode', mode);
-  kv('projectId', projectId);
-  kv('vault', vaultRoot);
-  kv('branch', branch);
+  const out = { mode, projectId, vault: vaultRoot, branch };
 
   // Ensure vault exists
   if (!existsSync(vaultRoot)) {
-    warn(`vault directory does not exist — run \`bizar memory init\` or \`bizar memory sync\``);
+    out.vaultExists = false;
   } else {
+    out.vaultExists = true;
     const notes = listNotes(projectRoot);
-    kv('noteCount', String(notes.length));
+    out.noteCount = notes.length;
   }
 
   // Git status if managed
@@ -788,14 +785,14 @@ async function cmdStatus(_args) {
     if (isGitInstalled()) {
       const gs = gitStatus(vaultRoot);
       if (gs.ok) {
-        kv('git', `${gs.branch} (${gs.clean ? chalk.green('clean') : chalk.red('dirty')})`);
-        if (gs.ahead > 0) kv('ahead', String(gs.ahead));
-        if (gs.behind > 0) kv('behind', String(gs.behind));
+        out.git = { branch: gs.branch, clean: gs.clean };
+        if (gs.ahead > 0) out.git.ahead = gs.ahead;
+        if (gs.behind > 0) out.git.behind = gs.behind;
       } else {
-        kv('git', chalk.yellow(`not a git repo`));
+        out.git = { error: 'not a git repo' };
       }
     } else {
-      kv('git', chalk.yellow(`git not installed`));
+      out.git = { error: 'git not installed' };
     }
   }
 
@@ -804,15 +801,15 @@ async function cmdStatus(_args) {
     const { isLightRAGRunning, isLightRAGInstalled, resolveLightRAGConfig } = memoryStore;
     const cfg = resolveLightRAGConfig(projectRoot);
     if (!cfg.enabled) {
-      kv('lightrag', chalk.gray('disabled'));
+      out.lightrag = { enabled: false };
     } else if (!(await isLightRAGInstalled())) {
-      kv('lightrag', chalk.yellow('not installed — `uv tool install "lightrag-hku[api]"`'));
+      out.lightrag = { enabled: true, installed: false };
     } else {
       const running = await isLightRAGRunning(cfg);
-      kv('lightrag', running ? chalk.green(`${cfg.host}:${cfg.port} (running)`) : chalk.yellow(`${cfg.host}:${cfg.port} (not running — run \`bizar memory reindex\`)`));
+      out.lightrag = { enabled: true, installed: true, running, host: cfg.host, port: cfg.port };
     }
   } catch (err) {
-    kv('lightrag', chalk.gray(`status unavailable (${err.message})`));
+    out.lightrag = { error: err.message };
   }
 
   // Last reindex attempt
@@ -820,10 +817,55 @@ async function cmdStatus(_args) {
   if (existsSync(reindexMarker)) {
     try {
       const { finishedAt, ok, inserted, failed, noteCount } = JSON.parse(readFileSync(reindexMarker, 'utf8'));
-      kv('lastReindex', `${new Date(finishedAt).toLocaleString()} — ${ok ? chalk.green(`${inserted}/${noteCount} ok`) : chalk.red(`${failed} failed`)}`);
+      out.lastReindex = { finishedAt, ok, inserted, failed, noteCount };
     } catch { /* ignore */ }
   }
 
+  if (wantJson) {
+    process.stdout.write(JSON.stringify(out) + '\n');
+    return;
+  }
+
+  console.log(chalk.bold('\n  Bizar Memory Status'));
+  console.log('  ─────────────────────────────');
+  kv('mode', mode);
+  kv('projectId', projectId);
+  kv('vault', vaultRoot);
+  kv('branch', branch);
+  if (!out.vaultExists) {
+    warn(`vault directory does not exist — run \`bizar memory init\` or \`bizar memory sync\``);
+  } else {
+    kv('noteCount', String(out.noteCount));
+  }
+  if (out.git) {
+    if (out.git.error) {
+      kv('git', chalk.yellow(out.git.error));
+    } else {
+      const cleanStr = out.git.clean ? chalk.green('clean') : chalk.red('dirty');
+      kv('git', `${out.git.branch} (${cleanStr})`);
+      if (out.git.ahead) kv('ahead', String(out.git.ahead));
+      if (out.git.behind) kv('behind', String(out.git.behind));
+    }
+  }
+  if (out.lightrag) {
+    if (out.lightrag.error) {
+      kv('lightrag', chalk.gray(`status unavailable (${out.lightrag.error})`));
+    } else if (!out.lightrag.enabled) {
+      kv('lightrag', chalk.gray('disabled'));
+    } else if (!out.lightrag.installed) {
+      kv('lightrag', chalk.yellow('not installed — `uv tool install "lightrag-hku[api]"`'));
+    } else {
+      const runningStr = out.lightrag.running
+        ? chalk.green(`${out.lightrag.host}:${out.lightrag.port} (running)`)
+        : chalk.yellow(`${out.lightrag.host}:${out.lightrag.port} (not running)`);
+      kv('lightrag', runningStr);
+    }
+  }
+  if (out.lastReindex) {
+    const lr = out.lastReindex;
+    const lrStr = `${new Date(lr.finishedAt).toLocaleString()} — ${lr.ok ? chalk.green(`${lr.inserted}/${lr.noteCount} ok`) : chalk.red(`${lr.failed} failed`)}`;
+    kv('lastReindex', lrStr);
+  }
   console.log();
 }
 
@@ -1606,8 +1648,10 @@ async function cmdDelete(args) {
 /**
  * @param {string} subcommand
  * @param {string[]} args
+ * @param {{ wantJson?: boolean }} opts
  */
-export async function runMemory(subcommand, args) {
+export async function runMemory(subcommand, args, opts = {}) {
+  const { wantJson = false } = opts;
   switch (subcommand) {
     case 'init':
       await cmdInit(args);
@@ -1616,7 +1660,7 @@ export async function runMemory(subcommand, args) {
       await cmdSetup(args);
       break;
     case 'status':
-      await cmdStatus(args);
+      await cmdStatus(args, { wantJson });
       break;
     case 'link':
       await cmdLink(args);

package/cli/provision.mjs

@@ -446,7 +446,10 @@ export async function ensureNpmPackage(pkg, { mode, dryRun, force }) {
   // processes are reading files inside the npm-global install dir. We
   // can't replace those files atomically while they're open. The caller
   // is expected to have already killed them via ensureInstancesKilled().
-  const r = spawnSync('npm', ['install', '-g', `${pkg}@latest`], { stdio: 'inherit' });
+  const r = spawnSync('npm', ['install', '-g', `${pkg}@latest`], { stdio: 'inherit', timeout: 600000 });
+  if (r.status === null && r.error?.code === 'ETIMEDOUT') {
+    return { ok: false, message: `${pkg} install timed out after 10 minutes`, installed: current };
+  }
   if (r.status !== 0) {
     return { ok: false, message: `${pkg} install failed`, installed: current };
   }
@@ -471,7 +474,10 @@ export async function updateOpencodeCli({ dryRun, force }) {
     return { ok: true, message: 'opencode updated via `opencode upgrade`' };
   }
   console.log(chalk.dim('  opencode upgrade not available; falling back to npm'));
-  const r2 = spawnSync('npm', ['install', '-g', 'opencode-ai@latest'], { stdio: 'inherit' });
+  const r2 = spawnSync('npm', ['install', '-g', 'opencode-ai@latest'], { stdio: 'inherit', timeout: 600000 });
+  if (r2.status === null && r2.error?.code === 'ETIMEDOUT') {
+    return { ok: false, message: 'opencode install timed out after 10 minutes' };
+  }
   if (r2.status === 0) {
     return { ok: true, message: 'opencode updated via npm' };
   }

package/install.sh

@@ -322,8 +322,6 @@ main() {
       ;;
   esac
 
-  print_banner
-
   # ── Hand off to the unified provisioner (Node) ─────────────────────────
   # All cross-OS work (agent files, plugin copy, opencode.json patching,
   # skills install, doctor check) lives in `cli/provision.mjs:runProvision`.
@@ -350,6 +348,7 @@ main() {
       warn "provisioner exited with code $rc"
       exit "$rc"
     fi
+    print_banner
   else
     warn "cli/provision.mjs not found — agent files / plugin / opencode.json"
     warn "    were NOT synced. Run \`bizar install\` from a checkout to fix."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "4.5.1",
+  "version": "4.5.2",
   "description": "Norse-pantheon multi-agent system for opencode — 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, opencode plugin, and typed SDK.",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "build:dash": "vite build",
     "test:sdk": "node_modules/.bin/vitest run --root packages/sdk",
     "test:sdk:watch": "node_modules/.bin/vitest --root packages/sdk",
-    "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/opencode-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/opencode-sessions-detail.test.mjs bizar-dash/tests/opencode-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs bizar-dash/tests/memory-cli-readlistdelete.test.mjs bizar-dash/tests/memory-cli-setup.test.mjs bizar-dash/tests/memory-conflicts.test.mjs bizar-dash/tests/memory-namespace.test.mjs bizar-dash/tests/memory-path-safety.test.mjs bizar-dash/tests/memory-protocol-drift.test.mjs bizar-dash/tests/memory-roundtrip.test.mjs",
+    "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/opencode-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/opencode-sessions-detail.test.mjs bizar-dash/tests/opencode-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs bizar-dash/tests/memory-cli-readlistdelete.test.mjs bizar-dash/tests/memory-cli-setup.test.mjs bizar-dash/tests/memory-conflicts.test.mjs bizar-dash/tests/memory-namespace.test.mjs bizar-dash/tests/memory-path-safety.test.mjs bizar-dash/tests/memory-protocol-drift.test.mjs bizar-dash/tests/memory-roundtrip.test.mjs bizar-dash/tests/cli-bugfixes.test.mjs bizar-dash/tests/server-bugfixes.test.mjs bizar-dash/tests/frontend-bugfixes.test.mjs",
     "build": "npm run build:sdk && npm run build:dash",
     "prepublishOnly": "npm run build"
   },
@@ -85,7 +85,7 @@
     "@vitejs/plugin-react": "^4.3.0",
     "typescript": "^5.6.0",
     "vite": "^5.0.0",
-    "vitest": "^2.1.0"
+    "vitest": "^4.1.9"
   },
   "allowScripts": {
     "better-sqlite3@12.11.1": true