@polderlabs/bizar 3.2.0 → 3.2.2

package/cli/bin.mjs

@@ -26,15 +26,29 @@ import { runInit } from './init.mjs';
 import { runExport } from './export.mjs';
 import runPlan from './plan.mjs';
 import { runUpdate } from './update.mjs';
+import { ensureSetup, checkSetupStatus } from './bootstrap.mjs';
 
 const args = process.argv.slice(2);
 
+// ── Bootstrap ─────────────────────────────────────────────────────────────────
+// Every bin command checks setup status on first invocation.
+// Skip only when: --postinstall (manual trigger), --check (status only),
+// BIZAR_SKIP_INSTALL=1 (disabled), or already handled via npm script.
+if (
+  !args.includes('--postinstall') &&
+  !args.includes('--check') &&
+  !process.env.BIZAR_SKIP_INSTALL
+) {
+  await ensureSetup({ silent: true });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+
 function showHelp() {
   console.log(`
   Bizar — Norse Pantheon Agent System for opencode
 
   Usage:
-    bizar                       Launch the TUI dashboard (default)
+    bizar                       Launch the TUI dashboard (auto-runs first-time setup if needed)
     bizar --web                 Launch TUI + auto-open web dashboard
     bizar --no-web              Launch TUI only (no browser)
     bizar --web-only            Web dashboard only (no TUI, in browser)
@@ -49,6 +63,8 @@ function showHelp() {
     bizar update                Update opencode, bizar, and/or bizar-plugin
     bizar service               Manage the background service daemon
     bizar dashboard             Launch the web dashboard (uses bizar-dash)
+    bizar --setup               Re-run setup manually (agents, plugin, RTK, Semble, Skills CLI)
+    bizar --check               Print setup status as JSON, exit 1 if setup needed
     bizar --help                Show this help
 
   Install:
@@ -229,8 +245,17 @@ async function runServiceCommand(sub) {
   await runService(sub || 'status', args.slice(2));
 }
 
-if (args[0] === '--postinstall') {
-  await runPostInstall();
+if (args.includes('--check')) {
+  const status = checkSetupStatus();
+  console.log(JSON.stringify(status, null, 2));
+  process.exit(status.needed ? 1 : 0);
+} else if (args.includes('--setup')) {
+  await ensureSetup({ silent: false });
+  process.exit(0);
+} else if (args.includes('--postinstall')) {
+  // Legacy manual trigger — now an alias for --setup
+  await ensureSetup({ silent: false });
+  process.exit(0);
 } else if (args[0] === 'audit') {
   if (args.includes('--help') || args.includes('-h')) showAuditHelp();
   else await runAudit();

package/cli/bootstrap.mjs

@@ -0,0 +1,77 @@
+/**
+ * cli/bootstrap.mjs
+ *
+ * v3.2.2 — Self-bootstrap on first bin invocation.
+ *
+ * Replaces the postinstall hook (which npm v10+ blocks by default).
+ * Every `bizar` bin command now checks setup status on entry and runs
+ * the postinstall logic automatically if anything is missing.
+ *
+ * Key design:
+ *   - Checks for SETUP_MARKERS (odyssey files that prove setup was done)
+ *   - If ALL markers exist → silent no-op
+ *   - If ANY marker is missing → runs postinstall logic
+ *   - Idempotent: already-installed components are skipped by the postinstall
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+
+import { opencodeAgentsDir, opencodeConfigDir } from './utils.mjs';
+import { runPostInstall } from './install.mjs';
+
+/**
+ * Key files that prove setup has been run at least once.
+ * If ALL exist → setup is considered complete.
+ * If ANY are missing → setup is needed.
+ */
+const SETUP_MARKERS = [
+  join(opencodeAgentsDir(), 'odin.md'),           // core agent installed
+  join(opencodeConfigDir(), 'plugins', 'bizar'),   // plugin installed
+];
+
+/**
+ * Check which markers are currently present.
+ * Returns { needed: true, missing: [...] } if any marker is absent.
+ * Returns { needed: false } if all markers are present.
+ */
+export function checkSetupStatus() {
+  const missing = SETUP_MARKERS.filter((p) => !existsSync(p));
+  if (missing.length > 0) {
+    return { needed: true, missing };
+  }
+  return { needed: false };
+}
+
+/**
+ * Print a first-run setup message.
+ * Uses chalk — kept minimal to avoid polluting stdout before the TUI loads.
+ */
+function printSetupBanner() {
+  // Use console.log directly to avoid chalk formatting issues in non-TTY
+  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, RTK, Semble, Skills CLI...\n');
+}
+
+/**
+ * Run setup if anything is missing.
+ *
+ * Options:
+ *   autoApprove — if true, skip interactive prompts (BIZAR_SKIP_OPTIONAL_INSTALLS already set by caller)
+ *   silent       — if true, suppress the "first-time setup" banner (used when invoked silently on bin entry)
+ *
+ * Idempotent: runPostInstall() skips already-installed components.
+ */
+export async function ensureSetup({ silent = false } = {}) {
+  const status = checkSetupStatus();
+
+  if (!status.needed) {
+    return; // already done, nothing to do
+  }
+
+  // Something is missing — run setup
+  if (!silent) {
+    printSetupBanner();
+  }
+
+  await runPostInstall();
+}

package/cli/install.mjs

@@ -294,7 +294,102 @@ export async function runInstaller() {
   console.log(chalk.dim('\n  Odin watches. The Pantheon awaits. ᛟ\n'));
 }
 
+// ── Interactive prompts for optional packages ─────────────────────────────────
+
+import { execSync } from 'node:child_process';
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+
+async function promptYesNo(question, defaultYes = true) {
+  // If not a TTY (CI, automated install), skip the prompt
+  if (!stdin.isTTY || !stdout.isTTY) {
+    return false;
+  }
+
+  const rl = createInterface({ input: stdin, output: stdout });
+  try {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    const answer = (await rl.question(`  ${question} ${hint}: `)).trim().toLowerCase();
+    rl.close();
+
+    if (answer === '') return defaultYes;
+    if (['y', 'yes'].includes(answer)) return true;
+    if (['n', 'no'].includes(answer)) return false;
+    return defaultYes;
+  } catch {
+    rl.close();
+    return false;
+  }
+}
+
+async function isPackageInstalled(name) {
+  try {
+    const globalRoot = execSync('npm root -g', { encoding: 'utf8' }).trim();
+    require.resolve(name, { paths: [globalRoot] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function promptAndInstallOptional() {
+  // Plugin
+  const pluginInstalled = await isPackageInstalled('@polderlabs/bizar-plugin');
+  if (!pluginInstalled) {
+    console.log('');
+    console.log('  The Bizar opencode plugin is required for the /bizar command and agent integration.');
+    const install = await promptYesNo(
+      'Install @polderlabs/bizar-plugin?',
+      true,
+    );
+    if (install) {
+      try {
+        console.log('  Installing @polderlabs/bizar-plugin...');
+        execSync('npm install -g @polderlabs/bizar-plugin', { stdio: 'inherit' });
+        console.log('  ✓ @polderlabs/bizar-plugin installed');
+      } catch (err) {
+        console.log(`  ✗ Failed to install @polderlabs/bizar-plugin: ${err.message}`);
+        console.log('  You can install it later with: npm install -g @polderlabs/bizar-plugin');
+      }
+    } else {
+      console.log('  Skipped. Install later with: npm install -g @polderlabs/bizar-plugin');
+    }
+  } else {
+    console.log('  ✓ @polderlabs/bizar-plugin already installed');
+  }
+
+  // Dashboard
+  const dashInstalled = await isPackageInstalled('@polderlabs/bizar-dash');
+  if (!dashInstalled) {
+    console.log('');
+    console.log('  The Bizar dashboard provides the web UI (React + Vite) and TUI (blessed).');
+    console.log('  It\'s optional — install it for the full experience, or use the CLI alone.');
+    const install = await promptYesNo(
+      'Install @polderlabs/bizar-dash?',
+      true,
+    );
+    if (install) {
+      try {
+        console.log('  Installing @polderlabs/bizar-dash...');
+        execSync('npm install -g @polderlabs/bizar-dash', { stdio: 'inherit' });
+        console.log('  ✓ @polderlabs/bizar-dash installed');
+      } catch (err) {
+        console.log(`  ✗ Failed to install @polderlabs/bizar-dash: ${err.message}`);
+        console.log('  You can install it later with: npm install -g @polderlabs/bizar-dash');
+      }
+    } else {
+      console.log('  Skipped. Install later with: npm install -g @polderlabs/bizar-dash');
+    }
+  } else {
+    console.log('  ✓ @polderlabs/bizar-dash already installed');
+  }
+}
+
 export async function runPostInstall() {
+  // Skip interactive prompts in CI / non-TTY environments
+  if (!process.env.BIZAR_SKIP_OPTIONAL_INSTALLS) {
+    await promptAndInstallOptional();
+  }
   const { mkdirSync, copyFileSync, existsSync } = await import('node:fs');
   const { execSync } = await import('node:child_process');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing, per-project Hindsight memory, mods, schedules, and a background service daemon",
   "type": "module",
   "bin": {
@@ -13,8 +13,7 @@
     "templates/"
   ],
   "scripts": {
-    "typecheck": "tsc --noEmit",
-    "postinstall": "node cli/bin.mjs --postinstall"
+    "typecheck": "tsc --noEmit"
   },
   "keywords": [
     "opencode",