@polderlabs/bizar 3.20.10 → 3.20.12

package/cli/bin.mjs

@@ -150,14 +150,22 @@ function showExportHelp() {
 
 function showInstallHelp() {
   console.log(`
-  bizar install — Run the interactive installer
+  bizar install — Run the canonical BizarHarness installer
 
   Usage:
     bizar install
 
   Description:
-    Installs agents, rules, commands, plugin support, RTK, Semble,
-    and the Skills CLI.
+    v3.20.11+ — thin wrapper around ./install.sh. The bash script
+    auto-installs every system dep (uv, python3.12, chrome-headless-shell
+    + runtime libs, jq), installs browser-harness via uv, syncs agents /
+    commands / hooks / skills into ~/.config/opencode/, configures
+    opencode.json + the Bizar plugin, and prints a single status banner.
+
+    No API key collection, no interactive prompts, no opencode restart —
+    the installer is safe to re-run anytime.
+
+    Run from a fresh git clone instead: \`cd BizarHarness && ./install.sh\`
   `);
 }
 

package/cli/doctor.mjs

@@ -25,7 +25,28 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { opencodeConfigDir, opencodeAgentsDir } from './utils.mjs';
 
-const REQUIRED_AGENTS = ['odin.md', 'quick.md', 'thor.md', 'tyr.md'];
+// v3.20.11: list every agent the install script is expected to deploy.
+// Adding a new agent to `config/agents/` without adding it here causes
+// doctor to silently under-count ("all 4 core agents present" when there
+// are actually 14). The list mirrors cli/install.mjs AGENT_FILES plus
+// `browser-harness.md` (added in v3.20.7) and `_shared/AGENT_BASELINE.md`
+// is intentionally excluded (it's a skill, not an agent).
+const REQUIRED_AGENTS = [
+  'odin.md',
+  'vor.md',
+  'frigg.md',
+  'quick.md',
+  'mimir.md',
+  'heimdall.md',
+  'hermod.md',
+  'thor.md',
+  'baldr.md',
+  'tyr.md',
+  'vidarr.md',
+  'forseti.md',
+  'semble-search.md',
+  'browser-harness.md',
+];
 
 // ── helpers ─────────────────────────────────────────────────────────────────
 

package/cli/doctor.test.mjs

@@ -281,16 +281,22 @@ describe('runDoctor() with fixture HOME', () => {
 
   test('agent-files-installed fails when core agents missing', async () => {
     writeOpencodeConfig({});
-    writeAgents('odin.md'); // missing quick, thor, tyr
+    writeAgents('odin.md'); // missing the other 13
     const result = await runDoctor({ silent: true });
     const r = findCheck(result, 'agent-files-installed');
     assert.equal(r.ok, false);
     assert.match(r.message, /missing/);
   });
 
-  test('agent-files-installed passes when all core agents present', async () => {
+  test('agent-files-installed passes when all 14 agents present', async () => {
     writeOpencodeConfig({});
-    writeAgents('odin.md', 'quick.md', 'thor.md', 'tyr.md');
+    // v3.20.11: doctor now expects all 14 agents (was 4 in v3.20.10).
+    writeAgents(
+      'odin.md', 'vor.md', 'frigg.md', 'quick.md',
+      'mimir.md', 'heimdall.md', 'hermod.md', 'thor.md', 'baldr.md',
+      'tyr.md', 'vidarr.md', 'forseti.md',
+      'semble-search.md', 'browser-harness.md',
+    );
     const result = await runDoctor({ silent: true });
     const r = findCheck(result, 'agent-files-installed');
     assert.equal(r.ok, true, r.message);

package/cli/install.mjs

@@ -206,231 +206,62 @@ export async function installPluginFromGlobal(opts = {}) {
   return true;
 }
 
+/**
+ * runInstaller — v3.20.11 thin wrapper.
+ *
+ * As of v3.20.11, `bizar install` is a thin wrapper around the canonical
+ * `install.sh` script at the repo root. The bash script handles all the
+ * heavy lifting: system-dep installation (uv, python3.12, chrome-headless-shell
+ * + runtime libs, jq), browser-harness via uv, Chrome lifecycle, agent /
+ * command / hook / skill sync, opencode.json merging, install-state.
+ *
+ * Why a thin wrapper instead of the old TUI:
+ *   - One source of truth. The bash script is also what `git clone` users
+ *     run (`./install.sh`), what `bizar update` re-runs, and what the npm
+ *     postinstall hook invokes. Keeping a parallel Node implementation
+ *     guarantees the two will diverge.
+ *   - No interactive prompts. The TUI asked for API keys, restart
+ *     confirmation, and component selection — none of which belong in a
+ *     `npm i -g @polderlabs/bizar` install (no TTY, secrets stay local).
+ *   - Cross-platform. The bash script already detects Windows and falls
+ *     back to the npm-based path; re-implementing that in Node is busywork.
+ *
+ * Returns the install.sh exit code (0 = success, 1 = partial failure).
+ * On platforms where bash isn't available (rare — Windows without WSL),
+ * falls back to running the npm-based path directly.
+ */
 export async function runInstaller() {
-  showBanner();
-
-  // ── Detect opencode ──
-  sectionHeading('Pre-flight');
-  const env = await detectOpenCode();
-
-  if (!env.exists) {
-    console.log(chalk.yellow('  ⚠ opencode config directory not found.'));
-    console.log(chalk.dim('  The installer will create it at:'));
-    console.log(chalk.dim(`  ${env.configDir}`));
-  } else {
-    console.log(chalk.green(`  ✓ opencode detected at ${env.configDir}`));
-    if (env.version) console.log(chalk.dim(`    version ${env.version}`));
-  }
-
-  const rtkInstalled = await detectRtk();
-  if (rtkInstalled) {
-    console.log(chalk.green('  ✓ RTK detected (token optimizer)'));
-  } else {
-    console.log(chalk.yellow('  ○ RTK not detected — will install'));
-  }
-
-  const sembleInstalled = await detectSemble();
-  if (sembleInstalled) {
-    console.log(chalk.green('  ✓ Semble detected (code search)'));
-  } else {
-    console.log(chalk.yellow('  ○ Semble not detected — will install'));
-  }
-
-  const skillsCliInstalled = await detectSkillsCli();
-  if (skillsCliInstalled) {
-    console.log(chalk.green('  ✓ Skills CLI detected (skill discovery)'));
-  } else {
-    console.log(chalk.yellow('  ○ Skills CLI not detected — will install'));
-  }
-  console.log();
-
-  // ── Step 1: Component selection ──
-  sectionHeading('Component Selection');
-  const components = await promptComponents();
-
-  // ── Step 2: Agent selection (if agents component chosen) ──
-  let selectedAgents = [];
-  if (components.includes('agents')) {
-    sectionHeading('Agent Selection');
-    selectedAgents = await promptAgents();
-  }
-
-  // ── Step 3: Install mode ──
-  sectionHeading('Installation Mode');
-  const mode = await promptInstallMode();
-
-  // ── Step 4: Skill packs (via skills.sh) ──
-  sectionHeading('Skills from skills.sh');
-  const skillPacks = await promptSkillPacks();
-
-  // ── Step 5: Build summary & confirm ──
-  const summary = buildSummary(components, selectedAgents, env.configDir, skillPacks);
-  showPantheon();
-  console.log();
-  console.log(chalk.dim('  Summary:'));
-  console.log(chalk.dim(`  Components : ${summary.components}`));
-  console.log(chalk.dim(`  Agents     : ${summary.agents}`));
-  console.log(chalk.dim(`  Target     : ${summary.target}`));
-  console.log(chalk.dim(`  Mode       : ${mode}`));
-  console.log();
-
-  const confirmed = await promptConfirmInstall(summary);
-  if (!confirmed) {
-    console.log(chalk.yellow('\n  Installation cancelled.\n'));
-    process.exit(0);
-  }
-
-  // ── Step 5: Install ──
-  console.log();
-  sectionHeading('Installing');
-
-  if (components.includes('agents') && selectedAgents.length > 0) {
-    await installAgents(selectedAgents, mode);
-  }
-
-  if (components.includes('agents-md')) {
-    await installAgentsMd(mode);
-  }
-
-  if (components.includes('skill-bizar')) {
-    await installSkill('bizar');
-  }
+  const { existsSync } = await import('node:fs');
+  const { join, dirname } = await import('node:path');
+  const { fileURLToPath } = await import('node:url');
+  const { spawnSync } = await import('node:child_process');
 
-  if (components.includes('skill-improve')) {
-    await installSkill('self-improvement');
-  }
-
-  if (components.includes('skill-cpp-std')) {
-    await installSkill('cpp-coding-standards');
-  }
-
-  if (components.includes('skill-cpp-test')) {
-    await installSkill('cpp-testing');
-  }
-
-  if (components.includes('skill-esp-idf')) {
-    await installSkill('embedded-esp-idf');
-  }
-
-  if (components.includes('opencode-json')) {
-    await installOpencodeJson(mode);
-  }
-
-  // Always attempt to merge the 7 BizarHarness tool keys idempotently.
-  // Safe to call even if opencode-json wasn't selected — skips silently.
-  {
-    const result = await mergeToolsIntoUserConfig();
-    if (result.merged) {
-      console.log(chalk.green(`  ✓ ${result.added.length} BizarHarness tool key(s) merged into opencode.json`));
-    }
-  }
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  // cli/install.mjs → ../install.sh
+  const installSh = join(__dirname, '..', 'install.sh');
 
-  if (components.includes('bizar')) {
-    await installBizarFolder();
-  }
-
-  if (components.includes('plugin-bizar')) {
-    const result = await installPluginBizar();
-    if (result.errors.length > 0) {
-      console.log(chalk.yellow(`  ⚠ Plugin install: ${result.errors.length} error(s)`));
-    }
+  if (!existsSync(installSh)) {
+    console.error(chalk.red('  ✗ install.sh not found at ' + installSh));
+    console.error(chalk.dim('    Run `git clone https://github.com/DrB0rk/BizarHarness` first, then `cd BizarHarness && ./install.sh`.'));
+    process.exit(1);
   }
 
-  // Also try to install the plugin from the separate global npm package
-  // `@polderlabs/bizar-plugin` (preferred path going forward).
-  if (components.includes('plugin-bizar')) {
-    await installPluginFromGlobal();
-  }
+  console.log(chalk.bold.hex('#6366f1')('\n  BizarHarness installer (delegating to install.sh)\n'));
 
-  // ── Rules, hooks, commands (optional components) ──
-  if (components.includes('rules')) {
-    const n = await installRules();
-    console.log(chalk.green(`  ✓ ${n} rules installed`));
-  }
-  if (components.includes('hooks')) {
-    const n = await installHooks();
-    console.log(chalk.green(`  ✓ ${n} hooks installed`));
-  }
-  if (components.includes('commands')) {
-    const n = await installCommands();
-    console.log(chalk.green(`  ✓ ${n} commands installed`));
+  const useBash = process.platform !== 'win32' || process.env.WSL_DISTRO_NAME;
+  if (useBash) {
+    const r = spawnSync('bash', [installSh], { stdio: 'inherit' });
+    process.exit(r.status ?? 1);
   }
 
-  // ── RTK (always installed — token optimization required) ──
-  await installRtk();
-
-  // ── Semble (always installed — code search required) ──
-  await installSemble();
-
-  // ── Skills CLI (always installed — skill discovery required) ──
-  await installSkillsCli();
-
-  // ── Skill packs (via skills.sh ecosystem) ──
-  for (const pack of skillPacks) {
-    await installCuratedSkills([pack]);
-  }
-
-  // ── Step 6: API keys ──
-  sectionHeading('API Keys');
-  console.log(chalk.dim('  You can configure API keys now or later via /connect in opencode.'));
-  const keys = await promptApiKeys();
-
-  if (keys.opencodeZen || keys.minimax || keys.openai) {
-    console.log(chalk.dim('\n  Keys noted. Add them to your opencode.json or run /connect in opencode.\n'));
-  }
-
-  // ── Summary ──
-  console.log();
-  console.log(boxen(
-    chalk.bold.hex('#6366f1')('  ⚡ BIZARHARNESS INSTALLED ⚡\n') +
-    '\n' +
-    chalk.dim('  Norse Pantheon active.\n') +
-    '\n' +
-    chalk.green(`  ✓ ${selectedAgents.length} agents installed`) + '\n' +
-    chalk.green(`  ✓ ${summary.parts.length} components configured`) + '\n' +
-    '\n' +
-    chalk.green('  ✓ RTK ') + chalk.dim(`(${rtkInstalled ? 'already configured' : 'installed & configured'})`) + '\n' +
-    chalk.green('  ✓ Semble ') + chalk.dim(`(${sembleInstalled ? 'ready' : 'installed'})`) + '\n' +
-    chalk.green('  ✓ Skills CLI ') + chalk.dim(`(${skillsCliInstalled ? 'ready' : 'installed'})`) + '\n' +
-    (skillPacks.length > 0 ? chalk.green(`  ✓ Skill packs: ${skillPacks.join(', ')}`) + '\n' : '') + '\n' +
-    chalk.hex('#a855f7')('  Next steps:') + '\n' +
-    chalk.hex('#a855f7')('  1. Restart opencode') + '\n' +
-    chalk.hex('#a855f7')('  2. Run /connect to add API keys') + '\n' +
-    chalk.hex('#a855f7')('  3. Run /models to verify agents'),
-    {
-      padding: 1,
-      margin: 0,
-      borderStyle: 'round',
-      borderColor: '#6366f1',
-    },
-  ));
-  console.log();
-
-  // ── Provider auto-detect (v3.16.0) — best-effort, doesn't block install
-  const { runProvidersDetect } = await import('./providers-detect.mjs');
-  try {
-    await runProvidersDetect(['--no-probe']);
-  } catch {
-    // best-effort
-  }
-
-  // ── Restart prompt ──
-  const shouldRestart = await promptRestartOpenCode();
-  if (shouldRestart) {
-    console.log(chalk.dim('  Restarting opencode...'));
-    try {
-      const { execSync } = await import('node:child_process');
-      execSync('opencode', { stdio: 'inherit' });
-    } catch {
-      console.log(chalk.yellow('  Could not restart automatically. Restart opencode manually.'));
-    }
-  }
-
-  // ── Post-install: graphify ──
-  await promptGraphifyInstall();
-
-  // ── Post-install ──
-  console.log(chalk.dim('\n  Odin watches. The Pantheon awaits. ᛟ\n'));
+  // Windows without WSL — bash isn't available. The bash script has a
+  // Windows fallback that uses npm-based install paths. Run the npm path
+  // directly: install the BizarHarness npm packages + copy plugin from
+  // global to ~/.config/opencode/plugins/bizar/. This is the same code
+  // path install.sh uses for `platform == win32`.
+  console.log(chalk.dim('  bash not available — running npm-based installer (Windows path)'));
+  console.log('');
+  await runPostInstall();
 }
 
 // ── Interactive prompts for optional packages ─────────────────────────────────

package/cli/update.mjs

@@ -290,32 +290,38 @@ function rerunInstallScript() {
     return { ok: false, message: 'could not locate npm global root; skipping install-script rerun' };
   }
   const pkgRoot = join(globalRoot, ...PKG_MAIN.split('/'));
-  const binPath = join(pkgRoot, 'cli', 'bin.mjs');
-  if (existsSync(binPath)) {
-    console.log(chalk.dim(`\n  Re-running setup via ${binPath} --setup...`));
-    const r = spawnSync(process.execPath, [binPath, '--setup'], { stdio: 'inherit' });
-    if (r.status === 0) {
-      return { ok: true, message: 'setup re-run' };
+  // v3.20.11: prefer the canonical `install.sh` script over `cli/bin.mjs
+  // --setup`. The bash script is the single source of truth (it handles
+  // system deps, chrome-headless-shell runtime libs, browser-harness,
+  // opencode.json merging, etc.); the --setup path is a legacy fallback
+  // for environments where bash isn't on PATH.
+  const installSh = join(pkgRoot, 'install.sh');
+  if (process.platform === 'win32') {
+    // On Windows without WSL, bash isn't available. The bash script has
+    // a Windows fallback that uses npm-based install paths. Fall through
+    // to the bin.mjs --setup path, which still does the agent copy +
+    // plugin-from-global install on Windows.
+    console.log(chalk.dim('  Windows: using bin.mjs --setup path (bash not available)'));
+  } else if (existsSync(installSh)) {
+    console.log(chalk.dim(`\n  Re-running install script at ${installSh}...`));
+    const r = spawnSync('bash', [installSh], { stdio: 'inherit' });
+    if (r.status !== 0) {
+      return { ok: false, message: 'install script rerun failed' };
     }
-    return { ok: false, message: 'setup rerun failed' };
+    return { ok: true, message: 'install script re-run' };
+  } else {
+    console.log(chalk.dim('  install.sh not present — falling back to bin.mjs --setup'));
   }
-  const installSh = join(pkgRoot, 'install.sh');
-  if (!existsSync(installSh)) {
+  const binPath = join(pkgRoot, 'cli', 'bin.mjs');
+  if (!existsSync(binPath)) {
     return { ok: false, message: 'could not locate a compatible setup script to re-run' };
   }
-  if (process.platform === 'win32') {
-    // On Windows, the bash install path doesn't apply. The plugin is
-    // already installed globally via the npm install
-    // (see cli/install.mjs:installPluginFromGlobal).
-    console.log(chalk.dim('  Skipping install.sh (Windows uses npm-based plugin install)'));
-    return { ok: true, message: 'install.sh skipped on Windows' };
-  }
-  console.log(chalk.dim(`\n  Re-running install script at ${installSh}...`));
-  const r = spawnSync('bash', [installSh], { stdio: 'inherit' });
-  if (r.status !== 0) {
-    return { ok: false, message: 'install script rerun failed' };
+  console.log(chalk.dim(`\n  Re-running setup via ${binPath} --setup...`));
+  const r = spawnSync(process.execPath, [binPath, '--setup'], { stdio: 'inherit' });
+  if (r.status === 0) {
+    return { ok: true, message: 'setup re-run' };
   }
-  return { ok: true, message: 'install script re-run' };
+  return { ok: false, message: 'setup rerun failed' };
 }
 
 // ---------------------------------------------------------------------------

package/install.sh

@@ -0,0 +1,562 @@
+#!/usr/bin/env bash
+#
+# install.sh — One-shot BizarHarness installer.
+#
+# v3.20.11 — Comprehensive auto-installer with full dependency
+# resolution. Replaces the older "print 4 manual next steps" flow
+# with: (1) install every system dep we can reasonably fetch
+# (uv, python3.12, chrome-headless-shell, jq, Chrome runtime libs);
+# (2) install browser-harness + register its skill; (3) start Chrome
+# for browser-driven E2E; (4) install + configure all BizarHarness
+# files (agents, commands, opencode.json, plugin); (5) print a
+# single status banner that tells the operator what is ready and
+# what (if anything) they still need to do.
+#
+# Idempotent — every step checks for the existing install and
+# skips re-work. Re-running after a failed install picks up
+# where it left off. Same script can run from a fresh `git clone`
+# or via `bizar install` (which spawns this script under bash).
+#
+# What this script does NOT do (intentional):
+#   - Configure provider API keys (MINIMAX_API_KEY, etc.). The user
+#     does that via `/connect` in opencode after install. We deliberately
+#     do not collect secrets here — the install is idempotent and safe
+#     to re-run, and asking for keys during install breaks CI / scripted
+#     deployments.
+#   - Reload opencode. The opencode session picks up the new config on
+#     next start. We print a status line at the end; we do not kill or
+#     restart the opencode process from here (it would interrupt
+#     in-flight agent sessions).
+#   - Hide `.obsidian/`. The Obsidian vault is a first-class part of
+#     the project tree. We do not add it to any .gitignore / .npmignore
+#     / IDE-exclusion list.
+#
+# Idempotent: every step checks for the existing install and skips
+# re-work. Re-running after a failed install picks up where it left off.
+#
+# Cross-platform: bash + curl work on Linux + macOS. On Windows run
+# `npm install -g @polderlabs/bizar` which triggers the npm postinstall
+# hook (cli/install.mjs → install.sh via git bash).
+set -euo pipefail
+
+BOLD='\033[1m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+DIM='\033[2m'
+NC='\033[0m'
+
+REPO_DIR="$(cd "$(dirname "$0")" && pwd)"
+CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/opencode"
+SKILLS_DIR="$HOME/.opencode/skills"
+BIZAR_STATE_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/bizar"
+BIZAR_STATE_FILE="$BIZAR_STATE_DIR/install-state.json"
+PYTHON_BIN="${PYTHON_BIN:-python3.12}"
+CHROME_PORT="${CHROME_PORT:-9222}"
+
+# Counters for the final summary.
+INSTALLED=()
+SKIPPED=()
+FAILED=()
+
+note() {
+  echo -e "  ${GREEN}✓${NC} $1"
+  INSTALLED+=("$1")
+}
+warn() {
+  echo -e "  ${YELLOW}⚠${NC} $1"
+  SKIPPED+=("$1")
+}
+err() {
+  echo -e "  ${RED}✗${NC} $1"
+  FAILED+=("$1")
+}
+section() {
+  echo ""
+  echo -e "${BOLD}${CYAN}── $1 ──${NC}"
+}
+
+# ── Pre-flight: which tools are missing? ───────────────────────────────
+section "Pre-flight: checking system tools"
+
+have_cmd() { command -v "$1" >/dev/null 2>&1; }
+have_file() { [ -e "$1" ]; }
+
+MISSING=()
+have_cmd uv || MISSING+=("uv")
+have_cmd "$PYTHON_BIN" || MISSING+=("$PYTHON_BIN")
+have_cmd jq || MISSING+=("jq")
+have_cmd npx || MISSING+=("npx")
+have_cmd git || MISSING+=("git")
+
+# Chrome detection: prefer chrome-headless-shell from puppeteer cache, then
+# system chromium / chrome / google-chrome. We don't require Chrome — the
+# installer works without it — but we report it so the operator knows.
+CHROME_BIN=""
+for cand in \
+  "$HOME/.cache/puppeteer/chrome-headless-shell"*/chrome-headless-shell/chrome-headless-shell \
+  /usr/bin/chromium \
+  /usr/bin/chrome \
+  /usr/bin/google-chrome \
+  "$(command -v chromium 2>/dev/null || true)" \
+  "$(command -v chrome 2>/dev/null || true)" \
+  "$(command -v google-chrome 2>/dev/null || true)"; do
+  [ -n "$cand" ] && [ -x "$cand" ] && CHROME_BIN="$cand" && break
+done
+
+for t in "${MISSING[@]}"; do warn "missing system tool: $t"; done
+if [ -z "$CHROME_BIN" ]; then warn "no chrome / chromium found — browser-harness won't work until installed"; fi
+[ ${#MISSING[@]} -eq 0 ] && [ -n "$CHROME_BIN" ] && note "all system tools present"
+
+# ── Install missing system tools (best effort, never abort) ─────────────
+section "Install missing system tools"
+
+# uv (Python package manager — needed for browser-harness + Semble)
+if ! have_cmd uv; then
+  echo -e "  ${CYAN}→${NC} Installing uv (Python package manager)..."
+  if have_cmd curl; then
+    if curl -LsSf https://astral.sh/uv/install.sh | sh >/dev/null 2>&1; then
+      # uv's installer drops the binary at ~/.local/bin/uv
+      export PATH="$HOME/.local/bin:$PATH"
+      if have_cmd uv; then
+        note "uv installed at $(command -v uv)"
+      else
+        warn "uv install ran but uv not on PATH — try 'export PATH=\$HOME/.local/bin:\$PATH'"
+      fi
+    else
+      warn "uv installer script failed — install manually: https://docs.astral.sh/uv/"
+    fi
+  else
+    warn "curl not found — install uv manually: https://docs.astral.sh/uv/"
+  fi
+else
+  note "uv $(uv --version 2>/dev/null | head -1)"
+fi
+
+# python3.12 (uv will manage its own python via --python 3.12, but
+# we also accept system python3.12 if present). Only install if uv
+# is available — uv can fetch its own python.
+if ! have_cmd "$PYTHON_BIN"; then
+  if have_cmd uv; then
+    echo -e "  ${CYAN}→${NC} python3.12 not on PATH — uv will fetch on first use"
+    note "python3.12 will be auto-fetched by uv (browser-harness will trigger first fetch)"
+  else
+    warn "no $PYTHON_BIN and no uv — install manually: sudo apt install python3.12 / brew install python@3.12"
+  fi
+else
+  note "$PYTHON_BIN $($PYTHON_BIN --version 2>&1 | head -1)"
+fi
+
+# jq (for safe opencode.json merging)
+if ! have_cmd jq; then
+  echo -e "  ${CYAN}→${NC} Trying to install jq..."
+  case "$(uname -s 2>/dev/null || echo unknown)" in
+    Linux)
+      if have_cmd apt-get; then sudo apt-get install -y jq 2>/dev/null && note "jq installed (apt)" || warn "apt install jq failed — install manually"
+      elif have_cmd dnf; then sudo dnf install -y jq 2>/dev/null && note "jq installed (dnf)" || warn "dnf install jq failed — install manually"
+      elif have_cmd pacman; then sudo pacman -S --noconfirm jq 2>/dev/null && note "jq installed (pacman)" || warn "pacman install jq failed — install manually"
+      elif have_cmd apk; then sudo apk add jq 2>/dev/null && note "jq installed (apk)" || warn "apk install jq failed — install manually"
+      else warn "no known package manager — install jq manually"
+      fi
+      ;;
+    Darwin)
+      if have_cmd brew; then brew install jq 2>/dev/null && note "jq installed (brew)" || warn "brew install jq failed — install manually"
+      else warn "no brew — install jq manually"
+      fi
+      ;;
+    *) warn "unknown OS — install jq manually";;
+  esac
+else
+  note "jq $(jq --version)"
+fi
+
+# Chrome (best effort — install chrome-headless-shell from chrome-for-testing
+# or the puppeteer cache). The dashboard/browser-harness will work without
+# it (the user can install later), but we try.
+if [ -z "$CHROME_BIN" ]; then
+  echo -e "  ${CYAN}→${NC} Trying to install chrome-headless-shell..."
+  PUPPETEER_CACHE_DIR="$HOME/.cache/puppeteer"
+  mkdir -p "$PUPPETEER_CACHE_DIR"
+  # chrome-for-testing JSON API — find the latest stable chrome-headless-shell
+  # URL for linux64. Fall back to nothing if the request fails.
+  CHROME_CT_URL=$(curl -fsSL "https://googlechromelabs.github.io/chrome-for-testing/last-known-good-versions-with-downloads.json" 2>/dev/null \
+    | grep -o '"url": *"[^"]*chrome-headless-shell-linux64[^"]*"' \
+    | head -1 \
+    | sed 's/.*"url": *"\([^"]*\)".*/\1/')
+  if [ -n "$CHROME_CT_URL" ]; then
+    TMP_DIR=$(mktemp -d)
+    if curl -fsSL "$CHROME_CT_URL" -o "$TMP_DIR/chrome-headless-shell.zip" 2>/dev/null; then
+      TARGET_DIR="$PUPPETEER_CACHE_DIR/chrome-headless-shell"
+      mkdir -p "$TARGET_DIR"
+      unzip -q -o "$TMP_DIR/chrome-headless-shell.zip" -d "$TARGET_DIR"
+      CHROME_BIN=$(find "$TARGET_DIR" -name chrome-headless-shell -type f 2>/dev/null | head -1)
+      [ -n "$CHROME_BIN" ] && [ -x "$CHROME_BIN" ] && note "chrome-headless-shell installed at $CHROME_BIN" || warn "chrome-headless-shell install failed"
+      rm -rf "$TMP_DIR"
+    else
+      warn "download from chrome-for-testing failed — install Chrome manually"
+    fi
+  else
+    warn "could not resolve latest chrome-for-testing URL — install Chrome manually"
+  fi
+fi
+
+# Chrome runtime libs (v3.20.11). chrome-headless-shell needs ~10 shared
+# libraries that Debian/Ubuntu don't ship by default. Without these,
+# chrome starts but immediately errors with `libnspr4.so: cannot open
+# shared object file`. We install them on apt-based systems; on others
+# we warn but continue (Chrome won't work, but the rest of the install
+# will).
+if [ -n "$CHROME_BIN" ] || [ -z "$CHROME_BIN" ]; then
+  # Check if chrome-headless-shell actually runs (libs satisfied)
+  if [ -n "$CHROME_BIN" ] && ! "$CHROME_BIN" --version >/dev/null 2>&1; then
+    case "$(uname -s 2>/dev/null || echo unknown)" in
+      Linux)
+        if have_cmd apt-get; then
+          echo -e "  ${CYAN}→${NC} chrome-headless-shell needs runtime libs — installing via apt..."
+          if sudo -n apt-get install -y --no-install-recommends \
+              libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 \
+              libxdamage1 libxkbcommon0 libasound2t64 libatspi2.0-0 \
+              2>/dev/null; then
+            note "chrome runtime libs installed (libnss3, libnspr4, libatk*, libxkbcommon, libasound, libatspi)"
+          else
+            warn "apt install of chrome runtime libs failed (needs sudo). run manually:"
+            warn "  sudo apt-get install -y libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 \\"
+            warn "    libxdamage1 libxkbcommon0 libasound2t64 libatspi2.0-0"
+          fi
+        else
+          warn "chrome-headless-shell runtime libs missing — install libnss3, libnspr4, libatk* for your distro"
+        fi
+        ;;
+      Darwin)
+        warn "chrome-headless-shell runtime libs missing — on macOS: brew install --cask chromium"
+        ;;
+      *) warn "chrome-headless-shell runtime libs missing — install via your package manager";;
+    esac
+  fi
+fi
+
+# ── npm packages (BizarHarness, optional @polderlabs/bizar-dash peer) ───
+section "Install BizarHarness npm packages"
+
+if have_cmd npm; then
+  for pkg in @polderlabs/bizar @polderlabs/bizar-dash; do
+    if npm ls -g "$pkg" --depth=0 >/dev/null 2>&1; then
+      cur=$(npm ls -g "$pkg" --depth=0 --json 2>/dev/null | grep -oE '"version":\s*"[^"]+"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/')
+      note "$pkg already installed (v$cur)"
+    else
+      echo -e "  ${CYAN}→${NC} Installing $pkg..."
+      if npm install -g "$pkg" >/dev/null 2>&1; then
+        note "$pkg installed"
+      else
+        err "$pkg install failed (run manually: npm install -g $pkg)"
+      fi
+    fi
+  done
+else
+  err "npm not found — install Node.js 20+ first: https://nodejs.org/"
+fi
+
+# ── browser-harness (Python tool via uv, requires Python 3.12) ─────────
+section "Install browser-harness (Python via uv)"
+
+if have_cmd browser-harness; then
+  note "browser-harness $(browser-harness --version 2>&1 | head -1) already installed"
+else
+  if have_cmd uv; then
+    echo -e "  ${CYAN}→${NC} uv tool install --python 3.12 --upgrade --force browser-harness"
+    if uv tool install --python 3.12 --upgrade --force browser-harness >/dev/null 2>&1; then
+      note "browser-harness installed"
+    else
+      err "browser-harness install failed (run manually: uv tool install --python 3.12 --upgrade --force browser-harness)"
+    fi
+  else
+    warn "uv not installed — skipping browser-harness (install uv first, then re-run this script)"
+  fi
+fi
+
+# Register the browser-harness skill so any agent that needs it picks it up.
+if have_cmd browser-harness; then
+  BH_SKILL_DIR="$SKILLS_DIR/browser-harness"
+  mkdir -p "$BH_SKILL_DIR"
+  if browser-harness skill > "$BH_SKILL_DIR/SKILL.md" 2>/dev/null; then
+    note "browser-harness skill registered at $BH_SKILL_DIR/SKILL.md"
+  else
+    warn "browser-harness skill registration failed (re-run: browser-harness skill > $BH_SKILL_DIR/SKILL.md)"
+  fi
+fi
+
+# ── Chrome lifecycle (start browser-harness-up.sh) ────────────────────
+section "Start Chrome for browser-harness"
+
+if [ -x "$REPO_DIR/cli/browser-harness-up.sh" ]; then
+  # The script knows how to find chrome-headless-shell from the
+  # puppeteer cache (or any system chrome).
+  if BH_OUTPUT=$("$REPO_DIR/cli/browser-harness-up.sh" start 2>&1); then
+    # Trim verbose output; just keep the success lines.
+    while IFS= read -r line; do
+      case "$line" in
+        *"✓"*|*"already"*|*"stopped"*|*"restarted"*) note "$line" ;;
+        *) ;;
+      esac
+    done <<< "$BH_OUTPUT"
+  else
+    warn "browser-harness-up.sh start failed (run manually: $REPO_DIR/cli/browser-harness-up.sh start)"
+  fi
+elif have_cmd "$REPO_DIR/../bin/bizar"; then
+  if "$REPO_DIR/../bin/bizar" browser-harness-up start 2>&1 | grep -E '✓|✗' | head -3; then
+    note "Chrome started via bizar browser-harness-up"
+  fi
+else
+  warn "cli/browser-harness-up.sh not found at $REPO_DIR — skipping Chrome auto-start"
+fi
+
+# ── BizarHarness config files ─────────────────────────────────────────
+section "Install BizarHarness config files"
+
+mkdir -p "$CONFIG_DIR/agents"
+
+# Agents — copy every .md except those already in place.
+for f in "$REPO_DIR/config/agents/"*.md; do
+  [ -f "$f" ] || continue
+  name="$(basename "$f")"
+  if [ -f "$CONFIG_DIR/agents/$name" ] && cmp -s "$f" "$CONFIG_DIR/agents/$name"; then
+    : # identical, skip silently
+  else
+    cp "$f" "$CONFIG_DIR/agents/$name"
+    INSTALLED+=("agents/$name")
+  fi
+done
+note "agents synced ($(ls "$CONFIG_DIR/agents/"*.md 2>/dev/null | wc -l) files)"
+
+# Shared baseline (used as a skill AND as the on-disk reference)
+if [ -d "$REPO_DIR/config/agents/_shared" ]; then
+  mkdir -p "$CONFIG_DIR/agents/_shared"
+  cp -R "$REPO_DIR/config/agents/_shared/." "$CONFIG_DIR/agents/_shared/"
+  note "agents/_shared/ synced"
+fi
+
+# Slash commands
+if [ -d "$REPO_DIR/config/commands/" ]; then
+  mkdir -p "$CONFIG_DIR/commands"
+  for f in "$REPO_DIR/config/commands/"*.md; do
+    [ -f "$f" ] || continue
+    name="$(basename "$f")"
+    cp "$f" "$CONFIG_DIR/commands/$name"
+  done
+  note "slash commands synced"
+fi
+
+# Hooks
+if [ -d "$REPO_DIR/config/hooks/" ]; then
+  mkdir -p "$CONFIG_DIR/hooks"
+  for entry in "$REPO_DIR/config/hooks/"*; do
+    [ -e "$entry" ] || continue
+    name="$(basename "$entry")"
+    cp -R "$entry" "$CONFIG_DIR/hooks/$name"
+  done
+  note "hooks synced"
+fi
+
+# AGENTS.md
+if [ -f "$REPO_DIR/config/AGENTS.md" ]; then
+  cp "$REPO_DIR/config/AGENTS.md" "$CONFIG_DIR/AGENTS.md"
+  note "AGENTS.md synced"
+fi
+
+# ── Bundled skills (bizar, self-improvement, agent-baseline, …) ───────
+section "Install bundled skills"
+
+mkdir -p "$SKILLS_DIR"
+for skill in bizar self-improvement cpp-coding-standards cpp-testing embedded-esp-idf; do
+  if [ -d "$REPO_DIR/config/skills/$skill" ]; then
+    mkdir -p "$SKILLS_DIR/$skill"
+    cp -R "$REPO_DIR/config/skills/$skill/." "$SKILLS_DIR/$skill/"
+    note "skill: $skill"
+  else
+    warn "skill source missing: $skill (skipping)"
+  fi
+done
+
+# Shared agent baseline skill — referenced by every agent file.
+if [ -f "$REPO_DIR/config/agents/_shared/AGENT_BASELINE.md" ]; then
+  mkdir -p "$SKILLS_DIR/agent-baseline"
+  cp "$REPO_DIR/config/agents/_shared/AGENT_BASELINE.md" "$SKILLS_DIR/agent-baseline/SKILL.md"
+  note "skill: agent-baseline (shared by all 14 agents)"
+fi
+
+# Make bundled scripts executable.
+chmod +x "$SKILLS_DIR"/embedded-esp-idf/scripts/*.sh 2>/dev/null || true
+
+# ── Domain skills via skills.sh (impeccable, ponytail, obsidian-skills) ─
+section "Install domain skills from skills.sh"
+
+if have_cmd npx; then
+  # Impeccable — UI anti-pattern detection (frontend quality)
+  if npx --yes impeccable skills install -y --scope=user --providers=opencode >/dev/null 2>&1; then
+    note "impeccable (UI anti-pattern detector)"
+  else
+    warn "impeccable install failed (run: npx impeccable skills install)"
+  fi
+
+  # Ponytail — minimal-code skill for AI agents
+  if npx --yes @dietrichgebert/ponytail install --scope=user >/dev/null 2>&1; then
+    note "ponytail (minimal-code skill)"
+  else
+    warn "ponytail install failed (run: npx @dietrichgebert/ponytail install)"
+  fi
+
+  # Obsidian skills — Obsidian Flavored Markdown, Bases, JSON Canvas, CLI
+  if npx --yes skills add https://github.com/kepano/obsidian-skills --all -y >/dev/null 2>&1; then
+    note "obsidian-skills (Obsidian Markdown/Bases/Canvas)"
+  else
+    warn "obsidian-skills install failed (run: npx skills add kepano/obsidian-skills)"
+  fi
+else
+  warn "npx not found — skipping domain skill installation"
+fi
+
+# ── Bizar plugin (mirrored from npm package to ~/.config/opencode/plugins/) ─
+section "Install Bizar opencode plugin"
+
+PLUGIN_SRC="$REPO_DIR/plugins/bizar"
+PLUGIN_DST="$CONFIG_DIR/plugins/bizar"
+if [ -d "$PLUGIN_SRC" ]; then
+  mkdir -p "$PLUGIN_DST"
+  while IFS= read -r -d '' f; do
+    rel="${f#$PLUGIN_SRC/}"
+    mkdir -p "$(dirname "$PLUGIN_DST/$rel")"
+    cp "$f" "$PLUGIN_DST/$rel"
+  done < <(find "$PLUGIN_SRC" \
+    -not -path '*/node_modules/*' \
+    -not -path '*/dist/*' \
+    -not -name '*.log' \
+    -not -name '.DS_Store' \
+    -type f -print0)
+  note "plugins/bizar/ copied (excludes node_modules, dist, *.log)"
+else
+  warn "Bizar plugin source not found at $PLUGIN_SRC — skipping"
+fi
+
+# ── Merge opencode.json (template + user's existing config) ────────────
+section "Configure opencode.json"
+
+# Prefer the .template copy; fall back to the legacy tracked file.
+if [ -f "$REPO_DIR/config/opencode.json.template" ]; then
+  TEMPLATE="$REPO_DIR/config/opencode.json.template"
+elif [ -f "$REPO_DIR/config/opencode.json" ]; then
+  TEMPLATE="$REPO_DIR/config/opencode.json"
+else
+  warn "No opencode.json template found"
+  TEMPLATE=""
+fi
+
+if [ -n "$TEMPLATE" ]; then
+  if [ -f "$CONFIG_DIR/opencode.json" ]; then
+    cp "$CONFIG_DIR/opencode.json" "$CONFIG_DIR/opencode.json.bak"
+  fi
+
+  if have_cmd jq; then
+    MERGE_TMP="$CONFIG_DIR/opencode.json.merge.$$"
+    if [ -f "$CONFIG_DIR/opencode.json" ]; then
+      jq -s '.[0] * .[1]' "$TEMPLATE" "$CONFIG_DIR/opencode.json" > "$MERGE_TMP" 2>/dev/null \
+        && mv "$MERGE_TMP" "$CONFIG_DIR/opencode.json" \
+        || { rm -f "$MERGE_TMP"; cp "$TEMPLATE" "$CONFIG_DIR/opencode.json"; }
+    else
+      cp "$TEMPLATE" "$CONFIG_DIR/opencode.json"
+    fi
+
+    # Ensure the Bizar plugin entry is registered (idempotent).
+    PLUGIN_TMP="$CONFIG_DIR/opencode.json.tmp.$$"
+    jq '
+      if (.plugin // []) | map(.[0] == "./plugins/bizar/index.ts") | any then .
+      else .plugin = (.plugin // []) + [["./plugins/bizar/index.ts", {
+        "loopThresholdWarn": 5,
+        "loopThresholdEscalate": 8,
+        "loopThresholdBlock": 12,
+        "loopWindowSize": 10
+      }]]
+      end
+    ' "$CONFIG_DIR/opencode.json" > "$PLUGIN_TMP" \
+      && mv "$PLUGIN_TMP" "$CONFIG_DIR/opencode.json" \
+      || rm -f "$PLUGIN_TMP"
+    note "opencode.json (template merged with existing config; plugin entry ensured)"
+  else
+    cp "$TEMPLATE" "$CONFIG_DIR/opencode.json"
+    warn "jq not available — copied template directly. Re-install jq for safe merging."
+  fi
+fi
+
+# ── Write install-state.json (used by `bizar update` for migrations) ───
+section "Write install-state"
+
+mkdir -p "$BIZAR_STATE_DIR"
+BH_VERSION=$(browser-harness --version 2>/dev/null | head -1 | sed 's/[^0-9.]//g' || echo "")
+BIZAR_VERSION=$(npm ls -g @polderlabs/bizar --depth=0 --json 2>/dev/null | grep -oE '"@polderlabs/bizar":\s*\{[^}]*"version":\s*"[^"]+"' | grep -oE '"version":\s*"[^"]+"' | grep -oE '"[^"]+"' | tail -1 | tr -d '"' || echo "")
+DASH_VERSION=$(npm ls -g @polderlabs/bizar-dash --depth=0 --json 2>/dev/null | grep -oE '"@polderlabs/bizar-dash":\s*\{[^}]*"version":\s*"[^"]+"' | grep -oE '"version":\s*"[^"]+"' | grep -oE '"[^"]+"' | tail -1 | tr -d '"' || echo "")
+PY_VERSION=$("$PYTHON_BIN" --version 2>/dev/null | head -1 | sed 's/[^0-9.]//g' || echo "")
+UV_VERSION=$(uv --version 2>/dev/null | head -1 | sed 's/[^0-9.]//g' || echo "")
+JQ_VERSION=$(jq --version 2>/dev/null | sed 's/[^0-9.]//g' || echo "")
+
+STATE_JSON=$(cat <<JSON
+{
+  "installedAt": "$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u +%Y-%m-%dT%H:%M:%S.%NZ | sed 's/\.[0-9]*//')",
+  "components": {
+    "bizar": "${BIZAR_VERSION:-unknown}",
+    "bizar-dash": "${DASH_VERSION:-unknown}",
+    "browser-harness": "${BH_VERSION:-unknown}",
+    "uv": "${UV_VERSION:-unknown}",
+    "python3.12": "${PY_VERSION:-unknown}",
+    "jq": "${JQ_VERSION:-unknown}"
+  }
+}
+JSON
+)
+echo "$STATE_JSON" > "$BIZAR_STATE_FILE"
+note "install-state written to $BIZAR_STATE_FILE"
+
+# ── Final status banner ──────────────────────────────────────────────
+section "Install complete"
+
+echo ""
+echo -e "${BOLD}${CYAN}┌────────────────────────────────────────────────────────────┐${NC}"
+echo -e "${BOLD}${CYAN}│${NC}  ${BOLD}BizarHarness ready.${NC}                                             │"
+echo -e "${BOLD}${CYAN}│${NC}                                                          │"
+
+if [ ${#INSTALLED[@]} -gt 0 ]; then
+  echo -e "${BOLD}${CYAN}│${NC}  ${GREEN}✓ Installed:${NC}                                                │"
+  for entry in "${INSTALLED[@]}"; do
+    short=$(echo "$entry" | head -c 56)
+    echo -e "${BOLD}${CYAN}│${NC}    • $short$(printf '%*s' $((56 - ${#short})) '') │"
+  done
+fi
+
+if [ ${#SKIPPED[@]} -gt 0 ]; then
+  echo -e "${BOLD}${CYAN}│${NC}                                                          │"
+  echo -e "${BOLD}${CYAN}│${NC}  ${YELLOW}⚠ Skipped:${NC}                                                  │"
+  for entry in "${SKIPPED[@]}"; do
+    short=$(echo "$entry" | head -c 56)
+    echo -e "${BOLD}${CYAN}│${NC}    • $short$(printf '%*s' $((56 - ${#short})) '') │"
+  done
+fi
+
+if [ ${#FAILED[@]} -gt 0 ]; then
+  echo -e "${BOLD}${CYAN}│${NC}                                                          │"
+  echo -e "${BOLD}${CYAN}│${NC}  ${RED}✗ Failed:${NC}                                                  │"
+  for entry in "${FAILED[@]}"; do
+    short=$(echo "$entry" | head -c 56)
+    echo -e "${BOLD}${CYAN}│${NC}    • $short$(printf '%*s' $((56 - ${#short})) '') │"
+  done
+fi
+
+echo -e "${BOLD}${CYAN}│${NC}                                                          │"
+echo -e "${BOLD}${CYAN}│${NC}  ${DIM}Next: open /connect in your next opencode session${NC}        │"
+echo -e "${BOLD}${CYAN}│${NC}  ${DIM}       to add API keys (opencode-zen is free; MiniMax${NC}        │"
+echo -e "${BOLD}${CYAN}│${NC}  ${DIM}       is paid). The installer never asks for keys —${NC}         │"
+echo -e "${BOLD}${CYAN}│${NC}  ${DIM}       do that part yourself so secrets stay on your${NC}        │"
+echo -e "${BOLD}${CYAN}│${NC}  ${DIM}       machine, not in any installer log.${NC}                       │"
+echo -e "${BOLD}${CYAN}└────────────────────────────────────────────────────────────┘${NC}"
+echo ""
+
+[ ${#FAILED[@]} -gt 0 ] && exit 1
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "3.20.10",
+  "version": "3.20.12",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness.",
   "type": "module",
   "bin": {
@@ -9,7 +9,9 @@
   "files": [
     "cli/",
     "config/",
-    "templates/"
+    "templates/",
+    "install.sh",
+    "cli/browser-harness-up.sh"
   ],
   "workspaces": [
     "packages/*"