@polderlabs/bizar 3.2.1 → 3.3.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "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",