@polderlabs/bizar 4.5.0 → 4.5.2

package/bizar-dash/tests/submit-feedback.test.mjs

@@ -46,7 +46,7 @@ function makeProjectRoot() {
 }
 
 function seedArtifact(projectRoot, slug, { comments = [], answers = [], status = 'draft' } = {}) {
-  const dir = join(projectRoot, 'artifacts', slug);
+  const dir = join(projectRoot, '.bizar', 'artifacts', slug);
   mkdirSync(dir, { recursive: true });
   const meta = {
     slug,
@@ -85,7 +85,7 @@ test('submitFeedback creates feedback.md', () => {
     const result = artifactsStore.submitFeedback(slug, { answers: [] }, root);
     assert.equal(result.ok, true);
     assert.equal(result.slug, slug);
-    const feedbackPath = join(root, 'artifacts', slug, 'feedback.md');
+    const feedbackPath = join(root, '.bizar', 'artifacts', slug, 'feedback.md');
     assert.ok(existsSync(feedbackPath), 'feedback.md should be created');
     const content = readFileSync(feedbackPath, 'utf8');
     assert.ok(content.includes('glyph: ' + slug), 'frontmatter glyph line');
@@ -107,7 +107,7 @@ test('submitFeedback updates meta.json status to "review"', () => {
     seedArtifact(root, slug, { status: 'draft' });
     const result = artifactsStore.submitFeedback(slug, { answers: [] }, root);
     assert.equal(result.ok, true);
-    const meta = JSON.parse(readFileSync(join(root, 'artifacts', slug, 'meta.json'), 'utf8'));
+    const meta = JSON.parse(readFileSync(join(root, '.bizar', 'artifacts', slug, 'meta.json'), 'utf8'));
     assert.equal(meta.status, 'review', 'meta.status should be "review"');
   } finally {
     rmSync(root, { recursive: true, force: true });
@@ -123,7 +123,7 @@ test('submitFeedback updates meta.json lastEdited', () => {
     const result = artifactsStore.submitFeedback(slug, { answers: [] }, root);
     const after = Date.now();
     assert.equal(result.ok, true);
-    const meta = JSON.parse(readFileSync(join(root, 'artifacts', slug, 'meta.json'), 'utf8'));
+    const meta = JSON.parse(readFileSync(join(root, '.bizar', 'artifacts', slug, 'meta.json'), 'utf8'));
     const ts = Date.parse(meta.lastEdited);
     assert.ok(Number.isFinite(ts), 'lastEdited should be a parseable timestamp');
     assert.ok(ts >= before && ts <= after, `lastEdited ${meta.lastEdited} should be in [${before}, ${after}]`);
@@ -208,7 +208,7 @@ test('submitFeedback falls back to comments.json when canvas has none', () => {
     const slug = 'glyph-comments-json-fallback';
     // Seed canvas with empty comments array, comments.json with one comment.
     seedArtifact(root, slug);
-    const dir = join(root, 'artifacts', slug);
+    const dir = join(root, '.bizar', 'artifacts', slug);
     // Replace plan.json with empty comments, populate comments.json.
     const canvas = JSON.parse(readFileSync(join(dir, 'plan.json'), 'utf8'));
     canvas.comments = [];
@@ -339,7 +339,7 @@ test('POST /api/artifacts/:slug/submit persists feedback.md on disk', async () =
         body: JSON.stringify({ answers: [] }),
       });
       assert.equal(res.status, 200);
-      const feedbackPath = join(root, 'artifacts', slug, 'feedback.md');
+      const feedbackPath = join(root, '.bizar', 'artifacts', slug, 'feedback.md');
       assert.ok(existsSync(feedbackPath), 'feedback.md should exist on disk');
       const content = readFileSync(feedbackPath, 'utf8');
       assert.ok(content.startsWith('---'), 'starts with YAML frontmatter');

package/cli/artifact.mjs

@@ -1885,13 +1885,22 @@ async function handleRequest(req, res, slug, planDir, serverPort) {
 
 // ─── Browser opening ─────────────────────────────────────────────────────────
 
+function isWSL() {
+  try {
+    const version = readFileSync('/proc/version', 'utf8');
+    if (version.toLowerCase().includes('microsoft')) return true;
+  } catch { /* not WSL */ }
+  return !!process.env.WSL_INTEROP;
+}
+
 function openBrowser(url) {
   const platform = process.platform;
+  const wsl = isWSL();
   let cmd, args;
   if (platform === 'darwin') {
     cmd = 'open';
     args = [url];
-  } else if (platform === 'win32') {
+  } else if (platform === 'win32' || wsl) {
     cmd = 'cmd';
     args = ['/c', 'start', '""', url];
   } else {
@@ -1900,9 +1909,7 @@ function openBrowser(url) {
   }
 
   // Check if the command exists
-  const probe = platform === 'win32'
-    ? spawnSync('where', [cmd], { stdio: 'ignore' })
-    : spawnSync('which', [cmd], { stdio: 'ignore' });
+  const probe = spawnSync('which', [cmd], { stdio: 'ignore' });
   if (probe.status !== 0) {
     console.log(`  ℹ Open ${url} in your browser (no ${cmd} available)`);
     return false;

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.
@@ -91,6 +109,7 @@ function showHelp() {
     service             Manage the background service daemon
     bg <subcommand>     Manage background agents (list/view/kill/logs)
     memory <subcommand> Manage project memory (Bizar Memory Service)
+    headroom <subcommand> Manage Headroom context compression
     dash <subcommand>   Manage the dashboard (start/stop/status/cleanup/tui)
     browser-harness-up  Start Chromium for browser-harness (start/stop/status/restart)
     dev-link [src]      Symlink the local plugin source into opencode's plugin dir
@@ -758,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}`;
@@ -773,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)`));
@@ -809,6 +832,168 @@ async function runUsageCommand(args) {
   }
 }
 
+function showHeadroomHelp() {
+  console.log(`
+  bizar headroom — Manage Headroom context compression
+
+  Usage:
+    bizar headroom status              Show live status (installed, proxy, wrapped)
+    bizar headroom stats              Show compression stats for the last 24h
+    bizar headroom install            Install headroom via pip or npm
+    bizar headroom wrap               Wrap opencode to route through the proxy
+    bizar headroom unwrap             Unwrap opencode
+    bizar headroom start              Start the proxy server
+    bizar headroom stop              Stop the proxy server
+    bizar headroom doctor            Run headroom doctor health check
+
+  Examples:
+    bizar headroom status
+    bizar headroom stats
+    bizar headroom install
+    bizar headroom wrap
+  `);
+}
+
+async function runHeadroomCommand(headroomArgs) {
+  const sub = headroomArgs[0];
+  const flags = headroomArgs.slice(1).filter((a) => a.startsWith('-'));
+  const positional = headroomArgs.slice(1).filter((a) => !a.startsWith('-'));
+
+  if (!sub || sub === '--help' || sub === '-h' || flags.includes('--help') || flags.includes('-h')) {
+    showHeadroomHelp();
+    return;
+  }
+
+  // Delegate to dashboard API
+  const { port, secret } = readDashboardConn();
+  const baseUrl = `http://127.0.0.1:${port}`;
+
+  async function apiGet(path) {
+    const url = `${baseUrl}${path}`;
+    const headers = { accept: 'application/json' };
+    if (secret) headers.authorization = `Basic ${Buffer.from(`opencode:${secret}`).toString('base64')}`;
+    const res = await fetch(url, { method: 'GET', headers });
+    const text = await res.text();
+    let data = null;
+    try { data = text ? JSON.parse(text) : null; } catch { /* ignore */ }
+    if (!res.ok) throw new Error(`${path}: ${data?.message || data?.error || res.statusText}`);
+    return data;
+  }
+
+  async function apiPost(path, body = {}) {
+    const url = `${baseUrl}${path}`;
+    const headers = { 'content-type': 'application/json', accept: 'application/json' };
+    if (secret) headers.authorization = `Basic ${Buffer.from(`opencode:${secret}`).toString('base64')}`;
+    const res = await fetch(url, { method: 'POST', headers, body: JSON.stringify(body) });
+    const text = await res.text();
+    let data = null;
+    try { data = text ? JSON.parse(text) : null; } catch { /* ignore */ }
+    if (!res.ok) throw new Error(`${path}: ${data?.message || data?.error || res.statusText}`);
+    return data;
+  }
+
+  if (sub === 'status') {
+    const s = await apiGet('/api/headroom/status');
+    console.log('');
+    console.log(chalk.bold('  Headroom status'));
+    console.log('');
+    console.log(`    ${chalk.dim('installed:')}   ${s.installed ? chalk.green('yes') : chalk.red('no')} ${s.version || ''}`);
+    console.log(`    ${chalk.dim('proxy:')}       ${s.proxyRunning ? chalk.green('running') : chalk.yellow('stopped')} ${s.proxyPort ? `@ ${s.proxyPort}` : ''} ${s.proxyPid ? `(PID ${s.proxyPid})` : ''}`);
+    console.log(`    ${chalk.dim('wrapped:')}     ${s.wrapped ? chalk.green('yes') : chalk.yellow('no')}`);
+    console.log(`    ${chalk.dim('healthy:')}     ${s.healthy === 'ok' ? chalk.green('ok') : s.healthy === 'warn' ? chalk.yellow('warn') : chalk.red('fail')}`);
+    if (s.messages && s.messages.length > 0) {
+      console.log('');
+      for (const m of s.messages) {
+        console.log(`    ${m}`);
+      }
+    }
+    console.log('');
+    return;
+  }
+
+  if (sub === 'stats') {
+    const hours = parseInt(positional[0], 10) || 24;
+    const st = await apiGet(`/api/headroom/stats?hours=${hours}`);
+    console.log('');
+    console.log(chalk.bold(`  Headroom stats (${hours}h)`));
+    console.log('');
+    if (st.error) {
+      console.log(chalk.yellow(`    ${st.error}`));
+    } else {
+      console.log(`    ${chalk.dim('tokens saved:')}    ${(st.tokensSaved || 0).toLocaleString()}`);
+      console.log(`    ${chalk.dim('compression:')}    ${st.compressionRatio ? `${Math.round(st.compressionRatio * 100)}%` : '—'}`);
+      console.log(`    ${chalk.dim('cache hits:')}     ${st.cacheHits ?? '—'}`);
+      console.log(`    ${chalk.dim('transforms:')}     ${st.transforms ?? '—'}`);
+    }
+    console.log('');
+    return;
+  }
+
+  if (sub === 'install') {
+    const r = await apiPost('/api/headroom/install', { force: true });
+    if (r.installed) {
+      console.log(chalk.green(`  ✓ Headroom installed via ${r.method}${r.version ? ` (${r.version})` : ''}`));
+    } else {
+      console.log(chalk.red('  ✗ Install failed. Try: pip install "headroom-ai[all]"'));
+    }
+    return;
+  }
+
+  if (sub === 'wrap') {
+    const port = parseInt(positional[0], 10) || 8787;
+    const r = await apiPost('/api/headroom/wrap', { port });
+    if (r.ok) {
+      console.log(chalk.green(`  ✓ opencode wrapped with Headroom on port ${port}`));
+    } else {
+      console.log(chalk.red(`  ✗ Wrap failed: ${r.log || 'unknown error'}`));
+    }
+    return;
+  }
+
+  if (sub === 'unwrap') {
+    const r = await apiPost('/api/headroom/unwrap');
+    if (r.ok) {
+      console.log(chalk.green('  ✓ opencode unwrapped from Headroom'));
+    } else {
+      console.log(chalk.red('  ✗ Unwrap failed'));
+    }
+    return;
+  }
+
+  if (sub === 'start') {
+    const port = parseInt(positional[0], 10) || 8787;
+    const r = await apiPost('/api/headroom/proxy/start', { port, host: '127.0.0.1' });
+    if (r.ok) {
+      console.log(chalk.green(`  ✓ Proxy started on 127.0.0.1:${port} (PID ${r.pid})`));
+    } else {
+      console.log(chalk.red('  ✗ Proxy start failed'));
+    }
+    return;
+  }
+
+  if (sub === 'stop') {
+    const r = await apiPost('/api/headroom/proxy/stop');
+    if (r.ok) {
+      console.log(chalk.green('  ✓ Proxy stopped'));
+    } else {
+      console.log(chalk.red('  ✗ Proxy stop failed'));
+    }
+    return;
+  }
+
+  if (sub === 'doctor') {
+    // Run `headroom doctor` locally
+    const { spawn } = await import('node:child_process');
+    const child = spawn('headroom', ['doctor'], { stdio: 'inherit' });
+    await new Promise((resolve) => child.on('close', resolve));
+    return;
+  }
+
+  console.error(chalk.red(`  ✗ Unknown headroom subcommand: ${sub}`));
+  showHeadroomHelp();
+  process.exit(1);
+}
+
 function showDashHelp() {
   console.log(`
   bizar dash — Manage the Bizar dashboard
@@ -920,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())
@@ -1018,8 +1207,10 @@ 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));
   } else if (args[0] === 'export') {
     if (isHelpRequest) showExportHelp();
     else await runExport(parseFlag('--target'));
@@ -1064,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.
@@ -1163,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) {
@@ -1293,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.0",
+  "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