@polderlabs/bizar 4.5.2 → 4.7.0

package/cli/commands/artifact.mjs

@@ -0,0 +1,20 @@
+/**
+ * cli/commands/artifact.mjs
+ *
+ * Artifact command dispatcher — delegates to ../artifact-cli.mjs.
+ * The actual implementation is split across:
+ *   artifact-cli.mjs    — CLI dispatch + flag parsing + help
+ *   artifact-server.mjs — HTTP server + routing
+ *   artifact-render.mjs  — HTML rendering + canvas helpers + MDX export
+ */
+export { runArtifact, default } from '../artifact-cli.mjs';
+
+export async function run(name, args, isHelpRequest) {
+  if (isHelpRequest) {
+    const { showHelp } = await import('../artifact-cli.mjs');
+    showHelp();
+    return;
+  }
+  const { runArtifact } = await import('../artifact-cli.mjs');
+  await runArtifact(args, {});
+}

package/cli/commands/dash.mjs

@@ -0,0 +1,160 @@
+/**
+ * cli/commands/dash.mjs
+ *
+ * Dashboard (bizar dash) subcommand dispatcher.
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { pathToFileURL } from 'node:url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const BIZAR_HOME = join(__dirname, '..', '..');
+
+export function showDashHelp() {
+  console.log(`
+  bizar dash — Manage the Bizar dashboard
+
+  Usage:
+    bizar dash <subcommand> [options]　
+
+  Subcommands:
+    start [--bg] [--port N]   Start the dashboard (default port 4321)
+    stop                       Stop the running dashboard
+    status                     Show dashboard port and URL
+    cleanup                    Find + kill zombie/orphan dashboards
+    tui [--no-web]             Launch the TUI
+
+  Options:
+    --bg                       Detach and run in background (for start)
+    --port N                   Override the default port
+    --no-web                   Skip launching the web UI (for tui)
+
+  Examples:
+    bizar dash start
+    bizar dash start --bg
+    bizar dash stop
+    bizar dash status
+    bizar dash tui
+    bizar dash tui --no-web
+
+  Note:
+    \`bizar dashboard\` is a deprecated alias for \`bizar dash\` and still
+    works, but new code should use \`bizar dash\`.
+  `);
+}
+
+// ── Option parsing ──────────────────────────────────────────────────────────────
+
+/**
+ * Parse dash-specific options from an array of args.
+ * Returns { opts, remaining } where opts have --bg / --port stripped.
+ */
+export function parseDashOpts(dashArgs) {
+  const opts = { bg: false, port: null, noWeb: false };
+  const remaining = [];
+  for (let i = 0; i < dashArgs.length; i++) {
+    const a = dashArgs[i];
+    if (a === '--bg') {
+      opts.bg = true;
+    } else if (a === '--no-web') {
+      opts.noWeb = true;
+    } else if (a === '--port' && i + 1 < dashArgs.length) {
+      opts.port = Number(dashArgs[i + 1]);
+      i++;
+    } else {
+      remaining.push(a);
+    }
+  }
+  return { opts, remaining };
+}
+
+// ── Dashboard CLI loader ───────────────────────────────────────────────────────
+
+/**
+ * Try to load the dashboard CLI module.
+ * v4.0.0: the dashboard ships inside this package at bizar-dash/src/cli.mjs.
+ * A legacy npm-global fallback is kept for the transitional period.
+ */
+export async function loadDashCli() {
+  const primary = join(__dirname, '..', '..', 'bizar-dash', 'src', 'cli.mjs');
+
+  // Legacy npm-global fallback (only computed if primary is missing)
+  let legacyFallbacks = [];
+  try {
+    const { execFileSync } = await import('node:child_process');
+    const npmRoot = execFileSync('npm', ['root', '-g'], { encoding: 'utf8', timeout: 5000 }).trim();
+    if (npmRoot) legacyFallbacks = [join(npmRoot, '@polderlabs', 'bizar-dash', 'src', 'cli.mjs')];
+  } catch { /* npm not available or no globals — fine */ }
+
+  const candidates = [primary, ...legacyFallbacks];
+
+  for (const p of candidates) {
+    try {
+      const url = pathToFileURL(p).href;
+      const mod = await import(url);
+      return mod;
+    } catch (_e) {
+      // try next
+    }
+  }
+  return null;
+}
+
+// ── Main dispatcher ────────────────────────────────────────────────────────────
+
+/**
+ * Dispatch a dashboard subcommand by loading the dashboard module and
+ * calling the appropriate exported function.
+ */
+export async function runDash(dashArgs) {
+  const { opts, remaining } = parseDashOpts(dashArgs);
+  const sub = remaining[0];
+  const subOpts = { ...opts, subArgs: remaining.slice(1) };
+
+  const dashModule = await loadDashCli();
+  if (!dashModule) {
+    console.error(chalk.red('  ✗ Dashboard not found.'));
+    console.error(chalk.dim('  this should not happen — please report a bug at github.com/DrB0rk/BizarHarness/issues'));
+    process.exit(1);
+  }
+
+  switch (sub) {
+    case 'start':
+      if (subOpts.bg) {
+        await dashModule.startInBackground(['start', ...(subOpts.subArgs || [])]);
+      } else {
+        await dashModule.start(subOpts);
+      }
+      break;
+    case 'stop':
+      await dashModule.stop(subOpts);
+      break;
+    case 'status':
+      await dashModule.status(subOpts);
+      break;
+    case 'cleanup':
+      await dashModule.cleanup(subOpts);
+      break;
+    case 'tui':
+      await dashModule.tui(subOpts);
+      break;
+    default:
+      console.error(chalk.red(`  ✗ Unknown subcommand: ${sub}`));
+      showDashHelp();
+      process.exit(1);
+  }
+}
+
+export async function run(name, args, isHelpRequest) {
+  // Handle 'dashboard' as deprecated alias for 'dash'
+  if (name === 'dashboard') {
+    process.stdout.write(chalk.yellow('  ⚠ `bizar dashboard` is deprecated, use `bizar dash` instead.\n'));
+  }
+  if (args.length === 0 || isHelpRequest) {
+    showDashHelp();
+    return;
+  }
+  await runDash(args);
+}

package/cli/commands/headroom.mjs

@@ -0,0 +1,204 @@
+/**
+ * cli/commands/headroom.mjs
+ *
+ * Headroom context compression CLI.
+ * v3.17.0+ — status, stats, install, wrap, unwrap, start, stop, doctor.
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { spawn } from 'node:child_process';
+
+const HOME = homedir();
+const BIZAR_HOME = join(HOME, '.config', 'bizar');
+
+// ── Dashboard connection ────────────────────────────────────────────────────────
+
+function readDashboardConn() {
+  const portFile = join(BIZAR_HOME, 'dashboard.port');
+  const authFile = join(BIZAR_HOME, 'dashboard-secret');
+  let port = 4321;
+  let secret = '';
+  try {
+    if (existsSync(portFile)) {
+      const parsed = parseInt(readFileSync(portFile, 'utf8').trim(), 10);
+      if (Number.isFinite(parsed) && parsed > 0) port = parsed;
+    }
+  } catch { /* ignore */ }
+  try {
+    if (existsSync(authFile)) secret = readFileSync(authFile, 'utf8').trim();
+  } catch { /* ignore */ }
+  return { port, secret };
+}
+
+// ── Help ───────────────────────────────────────────────────────────────────────
+
+export 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
+  `);
+}
+
+// ── API helpers ────────────────────────────────────────────────────────────────
+
+async function apiGet(path) {
+  const { port, secret } = readDashboardConn();
+  const baseUrl = `http://127.0.0.1:${port}`;
+  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 { port, secret } = readDashboardConn();
+  const baseUrl = `http://127.0.0.1:${port}`;
+  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;
+}
+
+// ── Command runner ────────────────────────────────────────────────────────────
+
+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;
+  }
+
+  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 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);
+}
+
+export async function run(name, args, isHelpRequest) {
+  await runHeadroomCommand(args);
+}

package/cli/commands/install.mjs

@@ -0,0 +1,169 @@
+/**
+ * cli/commands/install.mjs
+ *
+ * install + update command families.
+ * v4.4.11+ — 'bizar install' and 'bizar update' share the same code path.
+ */
+import chalk from 'chalk';
+import { runInstaller } from '../install.mjs';
+import { runUpdate } from '../update.mjs';
+import { runRepair } from '../repair.mjs';
+
+// ── Help texts ──────────────────────────────────────────────────────────────────
+
+export function showInstallHelp() {
+  console.log(`
+  bizar install — Run the unified BizarHarness installer
+
+  Usage:
+    bizar install                       Install (or refresh) every component
+    bizar install --dry-run             Print what would happen, change nothing
+    bizar install --force               Overwrite existing files
+    bizar install --with-mods a,b,c     Opt-in: install specific mods as part of the run
+    bizar install --help                Show this help
+
+  Description:
+    v4.4.7+ — unified installer. Same code path as 'bizar update'; the
+    difference is just mode=install vs mode=update. Every step is
+    idempotent — running this twice is safe.
+
+    1. Installs @polderlabs/bizar via npm (skipped if already current).
+    2. Shells to ./install.sh for platform-specific system deps (uv,
+       python3.12, jq, gh on Linux; brew on macOS) + service registration
+       (systemd / launchd / Task Scheduler).
+    3. Syncs agent files, slash commands, and bundled skills into
+       ~/.config/opencode/.
+    4. Copies plugins/bizar/ from the npm install into
+       ~/.config/opencode/plugins/bizar/ (preserves dev symlinks).
+    5. Patches ~/.config/opencode/opencode.json with the Bizar plugin
+       entry (skipped if already present).
+    6. Runs 'bizar doctor' as a post-install health check.
+
+    No API key collection, no interactive prompts.
+  `);
+}
+
+export function showUpdateHelp() {
+  console.log(`
+  bizar update — Update opencode + @polderlabs/bizar (which bundles the
+  plugin and dashboard). Detects what's installed and only touches what's
+  missing or out of date.
+
+  Usage:
+    bizar update                       Update EVERYTHING (default; auto-kills + restarts)
+    bizar update --check               Only print current vs. latest; do not update
+    bizar update --channel=stable|beta Pick the npm dist-tag (default: stable)
+    bizar update --no-restart          Don't auto-restart the dashboard after update
+    bizar update --dry-run             Print what would happen, change nothing
+    bizar update --force               Override .bizar/PRE_PUSH_NOTES.md blockers
+    bizar update --yes                 Same as --force, but named for one-line scripts
+    bizar update --with-mods a,b,c     Opt-in: install specific mods as part of the run
+    bizar update --help                Show this help
+
+  Components updated:
+    opencode-ai   the opencode CLI itself
+    @polderlabs/bizar    this CLI + dashboard + plugin (one package)
+
+  Behavior (v4.4.7+):
+    • Single unified provisioner. 'bizar install' and 'bizar update' are
+      the same code path with different mode flags. Every step is
+      idempotent — re-running is safe.
+    • Detects running Bizar instances (background service daemon, web
+      dashboard) by reading ~/.config/bizar/{service,dashboard}.pid and
+      cleans up any stale or empty PID files.
+    • Auto-kills running instances with a brief notice.
+    • Sends SIGTERM, waits up to 5s, escalates to SIGKILL if needed.
+    • Re-runs the install script so the deployed plugin source matches
+      the just-upgraded npm version (avoids the version-skew trap).
+    • If the dashboard was running and bizar was updated, spawns a
+      fresh detached dashboard process with the new code (skipped with
+      --no-restart).
+    • Runs 'bizar doctor' after a successful update to catch config
+      regressions before opencode tries to start.
+    • With --check: prints the version matrix and release-notes excerpt
+      between current and latest, exits non-zero if an update is available.
+
+  Examples:
+    bizar update                       Full auto-update (recommended)
+    bizar update --check               Show version matrix + notes, do nothing
+    bizar update --channel=beta        Upgrade to latest beta build
+    bizar update --dry-run             Preview what would change
+    bizar update plugin --no-restart   Plugin-only, leave dashboard alone
+
+  Errors:
+    Network failures (registry offline / DNS) and npm permission issues
+    are surfaced with the raw npm output. The provisioner never silently
+    swallows them — look for the ✗ marker in the step output.
+  `);
+}
+
+// ── parseWithMods flag ─────────────────────────────────────────────────────────
+
+/**
+ * v4.4.11 — Parse `--with-mods <csv>` from the given subargs slice.
+ * 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.
+ */
+export function parseWithModsFlag(subargs) {
+  const idx = subargs.indexOf('--with-mods');
+  if (idx === -1) return null;
+  const raw = subargs[idx + 1];
+  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())
+    .filter(Boolean);
+}
+
+// ── Command runners ────────────────────────────────────────────────────────────
+
+export async function install(args, isHelpRequest) {
+  if (isHelpRequest) {
+    showInstallHelp();
+    return;
+  }
+  // v4.4.11 — Parse --with-mods <csv> to opt into mod installs during the run.
+  const withMods = parseWithModsFlag(args);
+  await runInstaller({ withMods });
+  // v4.4.3 — After install, repair any stale bin symlinks so the
+  // user picks up the new code.
+  try {
+    const r = await runRepair({});
+    if (r.fixed.length > 0) {
+      console.log(chalk.cyan('\n  Repair: repointed stale bin symlinks:'));
+      for (const f of r.fixed) console.log(`    ${f}`);
+      console.log(chalk.dim('    Re-run your shell or `hash -r` to pick up the new path.'));
+    }
+  } catch (err) {
+    console.log(chalk.dim(`  Repair skipped: ${err.message}`));
+  }
+}
+
+export async function update(args, isHelpRequest) {
+  if (isHelpRequest) {
+    showUpdateHelp();
+    return;
+  }
+  const withMods = parseWithModsFlag(args);
+  // Filter --with-mods <csv> out of subargs since the provisioner takes it via opts.
+  const subargs = args.filter((a, i, arr) => {
+    if (a === '--with-mods') return false;
+    if (arr[i - 1] === '--with-mods') return false;
+    return true;
+  });
+  await runUpdate(subargs, { withMods });
+}
+
+// ── run() entry point (used by bin.mjs dispatcher) ──────────────────────────────
+
+export async function run(name, args, isHelpRequest) {
+  if (name === 'install') {
+    await install(args, isHelpRequest);
+  } else if (name === 'update') {
+    await update(args, isHelpRequest);
+  }
+}

package/cli/commands/memory.mjs

@@ -0,0 +1,25 @@
+/**
+ * cli/commands/memory.mjs
+ *
+ * Memory subcommand dispatcher — delegates to ../memory.mjs.
+ */
+import { runMemory } from '../memory.mjs';
+
+export function showMemoryHelp() {
+  console.log(`
+  memory <subcommand>   Manage project memory (local-only or Git-shared Obsidian vault)
+                        Subcommands: init, setup, status, link, unlink, write, pull, commit,
+                        push, sync, reindex, conflicts, doctor
+  `);
+}
+
+export async function run(name, args, isHelpRequest) {
+  // Only show parent help if no subcommand given. If --help is for a
+  // specific subcommand, pass it through so runMemory can show the
+  // subcommand's own help (which includes "Usage:").
+  if (!args[0]) {
+    showMemoryHelp();
+    return;
+  }
+  await runMemory(args[0], args.slice(1), { wantJson: false });
+}