@polderlabs/bizar 3.12.0 → 3.12.2

package/cli/update.mjs

@@ -233,9 +233,18 @@ function latestVersion(pkg) {
 /**
  * Update opencode. Tries `opencode upgrade` first (the upstream installer's
  * own command); falls back to `npm install -g opencode-ai@latest`.
+ * Pass `{ dryRun: true }` to print what would run without executing.
  * Returns `{ ok: boolean, message: string }`.
  */
-function updateOpencode() {
+function updateOpencode({ dryRun = false } = {}) {
+  if (dryRun) {
+    console.log(
+      chalk.dim(
+        '  [dry-run] would run: opencode upgrade (fallback: npm install -g opencode-ai@latest)',
+      ),
+    );
+    return { ok: true, message: '[dry-run] opencode' };
+  }
   const r1 = spawnSync('opencode', ['upgrade'], { stdio: 'inherit' });
   if (r1.status === 0) {
     return { ok: true, message: 'opencode updated via `opencode upgrade`' };
@@ -248,7 +257,13 @@ function updateOpencode() {
   return { ok: false, message: 'opencode update failed — try `opencode upgrade` manually' };
 }
 
-function updatePackage(pkg) {
+function updatePackage(pkg, { dryRun = false } = {}) {
+  if (dryRun) {
+    console.log(
+      chalk.dim(`  [dry-run] would run: npm install -g ${pkg}@latest`),
+    );
+    return { ok: true, message: `[dry-run] ${pkg}` };
+  }
   const r = spawnSync('npm', ['install', '-g', `${pkg}@latest`], { stdio: 'inherit' });
   if (r.status !== 0) {
     return { ok: false, message: `${pkg} update failed` };
@@ -467,27 +482,43 @@ export async function runUpdate(subargs = []) {
   const assumeYes = subargs.includes('--yes') || subargs.includes('-y') || subargs.includes('--force');
   const restartAfter = !subargs.includes('--no-restart');
   const forceAll = subargs.includes('--all');
+  const dryRun = subargs.includes('--dry-run');
+
+  if (dryRun) {
+    console.log(
+      chalk.dim('  --dry-run set: no installs, kills, or restarts will be performed.\n'),
+    );
+  }
 
   // 1. Detect running instances BEFORE doing anything else.
   const instances = detectInstances();
   const runningCount = (instances.service ? 1 : 0) + (instances.dashboard ? 1 : 0);
 
   if (runningCount > 0) {
-    const ok = await confirmKill(instances, { assumeYes });
-    if (!ok) {
-      console.log(chalk.yellow('\n  Update cancelled — instances still running.'));
-      console.log(chalk.dim('  Stop them with `bizar service stop` and `bizar dashboard stop`, then retry.'));
-      process.exit(1);
-    }
-    console.log(chalk.cyan('\n  Stopping running instances...'));
-    const kills = await killInstances(instances);
-    for (const k of kills) {
-      const marker = k.ok ? chalk.green('✓') : chalk.red('✗');
-      console.log(`    ${marker} ${k.name} stopped`);
+    if (dryRun) {
+      const labels = [];
+      if (instances.service) labels.push(instances.service.label);
+      if (instances.dashboard) labels.push(instances.dashboard.label);
+      console.log(
+        chalk.dim(`  [dry-run] would stop running instances: ${labels.join(', ')}`),
+      );
+    } else {
+      const ok = await confirmKill(instances, { assumeYes });
+      if (!ok) {
+        console.log(chalk.yellow('\n  Update cancelled — instances still running.'));
+        console.log(chalk.dim('  Stop them with `bizar service stop` and `bizar dashboard stop`, then retry.'));
+        process.exit(1);
+      }
+      console.log(chalk.cyan('\n  Stopping running instances...'));
+      const kills = await killInstances(instances);
+      for (const k of kills) {
+        const marker = k.ok ? chalk.green('✓') : chalk.red('✗');
+        console.log(`    ${marker} ${k.name} stopped`);
+      }
+      // Give the kernel a moment to release any open file handles on the
+      // npm-global directory before npm tries to replace files.
+      await new Promise((resolve) => setTimeout(resolve, 500));
     }
-    // Give the kernel a moment to release any open file handles on the
-    // npm-global directory before npm tries to replace files.
-    await new Promise((resolve) => setTimeout(resolve, 500));
   } else {
     console.log(chalk.dim('  No running Bizar instances detected.'));
   }
@@ -523,8 +554,19 @@ export async function runUpdate(subargs = []) {
 
   // 3. Decide what to update.
   let selected;
-  if (forceAll || assumeYes) {
+  if (forceAll || assumeYes || dryRun) {
+    // dryRun defaults to showing everything (the whole point is to see
+    // what *would* change across the board). Pass a positional list to
+    // narrow the preview.
     selected = new Set(COMPONENTS);
+    // If the user passed positional component names alongside --dry-run,
+    // narrow the selection to those.
+    const positional = subargs.filter((a) => !a.startsWith('-'));
+    if (positional.length > 0) {
+      const valid = new Set(COMPONENTS);
+      const narrowed = positional.filter((a) => valid.has(a));
+      if (narrowed.length > 0) selected = new Set(narrowed);
+    }
   } else if (subargs.length === 0) {
     selected = await promptForUpdates(false);
   } else {
@@ -548,44 +590,57 @@ export async function runUpdate(subargs = []) {
   const results = [];
   if (selected.has('opencode')) {
     console.log(chalk.bold('  → opencode'));
-    results.push(['opencode', updateOpencode()]);
+    results.push(['opencode', updateOpencode({ dryRun })]);
   }
   if (selected.has('bizar')) {
     console.log(chalk.bold(`  → ${PKG_MAIN}`));
-    results.push(['bizar', updatePackage(PKG_MAIN)]);
+    results.push(['bizar', updatePackage(PKG_MAIN, { dryRun })]);
   }
   if (selected.has('dash')) {
     console.log(chalk.bold(`  → ${PKG_DASH}`));
-    results.push(['dash', updatePackage(PKG_DASH)]);
+    results.push(['dash', updatePackage(PKG_DASH, { dryRun })]);
   }
   if (selected.has('plugin')) {
     console.log(chalk.bold(`  → ${PKG_PLUGIN}`));
-    results.push(['plugin', updatePackage(PKG_PLUGIN)]);
+    results.push(['plugin', updatePackage(PKG_PLUGIN, { dryRun })]);
   }
 
   // 4. Re-run the install script if anything relevant changed.
   const anySuccess = results.some(([, r]) => r.ok);
   if (anySuccess && (selected.has('bizar') || selected.has('plugin'))) {
     console.log('');
-    const rerun = rerunInstallScript();
-    if (rerun.ok) {
-      console.log(chalk.green(`\n  ✓ ${rerun.message}`));
+    if (dryRun) {
+      console.log(
+        chalk.dim(
+          '  [dry-run] would re-run install script (bin.mjs --setup or install.sh)',
+        ),
+      );
     } else {
-      console.log(chalk.yellow(`\n  ⚠ ${rerun.message}`));
-      console.log(chalk.dim('    Run `bash install.sh` from the Bizar repo manually.'));
+      const rerun = rerunInstallScript();
+      if (rerun.ok) {
+        console.log(chalk.green(`\n  ✓ ${rerun.message}`));
+      } else {
+        console.log(chalk.yellow(`\n  ⚠ ${rerun.message}`));
+        console.log(chalk.dim('    Run `bash install.sh` from the Bizar repo manually.'));
+      }
     }
   }
 
   // 5. Restart the dashboard if it was running before the update.
   if (restartAfter && instances.dashboard && (selected.has('bizar') || selected.has('dash'))) {
-    console.log('');
-    console.log(chalk.cyan('  Restarting dashboard with the new code...'));
-    const res = spawnFreshDashboard({ port: instances.dashboard.port || undefined });
-    if (res.ok) {
-      console.log(chalk.green(`  ✓ ${res.message}`));
+    if (dryRun) {
+      console.log('');
+      console.log(chalk.dim('  [dry-run] would restart dashboard with the new code'));
     } else {
-      console.log(chalk.yellow(`  ⚠ ${res.message}`));
-      console.log(chalk.dim('    Start it manually with `bizar dash start --bg`.'));
+      console.log('');
+      console.log(chalk.cyan('  Restarting dashboard with the new code...'));
+      const res = spawnFreshDashboard({ port: instances.dashboard.port || undefined });
+      if (res.ok) {
+        console.log(chalk.green(`  ✓ ${res.message}`));
+      } else {
+        console.log(chalk.yellow(`  ⚠ ${res.message}`));
+        console.log(chalk.dim('    Start it manually with `bizar dash start --bg`.'));
+      }
     }
   }
 
@@ -602,5 +657,40 @@ export async function runUpdate(subargs = []) {
     console.log(chalk.yellow('\n  Some updates failed. See messages above.'));
     process.exit(1);
   }
+  if (dryRun) {
+    console.log(
+      chalk.green('\n  ✓ Dry-run complete (no installs, kills, or restarts performed)\n'),
+    );
+    return;
+  }
   console.log(chalk.green('\n  ✓ Update complete\n'));
+
+  // 7. Post-update health check (v3.12.2). Catches a bad config merge or
+  // missing files before the user discovers it via a broken opencode session.
+  try {
+    const { runDoctor } = await import('./doctor.mjs');
+    const result = await runDoctor({ silent: true });
+    if (result.failed > 0) {
+      console.log('');
+      console.log(
+        chalk.yellow('  ⚠ Post-update health check found issues:'),
+      );
+      for (const r of result.results) {
+        if (!r.ok) {
+          console.log(chalk.red(`    ✗ ${r.name}: ${r.message}`));
+        }
+      }
+      console.log(chalk.dim('  Run `bizar doctor` for details.'));
+      process.exit(1);
+    }
+  } catch (err) {
+    // Doctor import or runtime failure shouldn't crash the update —
+    // log a hint and let the user run `bizar doctor` themselves.
+    console.log(
+      chalk.yellow(
+        `  ⚠ Post-update health check could not run: ${err.message}`,
+      ),
+    );
+    console.log(chalk.dim('  Run `bizar doctor` manually to verify the install.'));
+  }
 }

package/config/AGENTS.md

@@ -103,6 +103,7 @@ BizarHarness ships always-on coding rules organized by language and concern. All
 | `rules/git.md` | Git and commit conventions |
 | `rules/testing.md` | Test methodology and coverage |
 | `rules/thinking.md` | All agents — concise thinking behavior |
+| `rules/uncertainty.md` | All agents — stop-and-research rule; reach for `websearch` / `webfetch` when uncertain or stuck; self-catch loops before the plugin loop-guard fires |
 
 ### How to Use
 
@@ -115,6 +116,10 @@ BizarHarness ships always-on coding rules organized by language and concern. All
 
 For agents with `reasoning: true` + `variant: "high"`, follow `rules/thinking.md` strictly. Cap reasoning at 2–4 sentences. No informal self-talk, no "what if" loops, no mid-thought self-correction. Think once, decide, act.
 
+### Research-Loop Rule
+
+Follow `rules/uncertainty.md` strictly. When uncertain or stuck, the next move is a research tool call (`websearch` for outside-the-repo facts, `webfetch` for official docs, `semble search` for codebase patterns, `hindsight_recall` for project memory) — not a third variation of the same edit. If you catch yourself about to retry the same failed command with slightly different arguments, stop and search first. The plugin's loop-guard (`loopThresholdWarn: 5`) is the safety net; self-correct at attempt 2.
+
 ---
 
 ## Model Routing & Agents
@@ -166,25 +171,25 @@ Odin (`@odin`) is the All-Father and primary/default agent. He analyzes each req
 
 ### Hermod
 
-- **Model**: `openrouter/minimax-m2.7` (via OpenRouter)
+- **Model**: `openrouter/minimax/minimax-m2.7` (via OpenRouter)
 - **Use for**: Git and GitHub operations — commit, push, merge, PRs, branches, conflict resolution. The swift messenger.
 - **Cost**: $0.30/M input, $1.20/M output
 
 ### Thor
 
-- **Model**: `openrouter/minimax-m2.7` (via OpenRouter)
+- **Model**: `openrouter/minimax/minimax-m2.7` (via OpenRouter)
 - **Use for**: Moderate complexity features, debugging, code review, refactoring
 - **Cost**: $0.30/M input, $1.20/M output — cheaper than Tyr, more capable than Heimdall
 
 ### Baldr
 
-- **Model**: `openrouter/minimax-m2.7` (via OpenRouter)
+- **Model**: `openrouter/minimax/minimax-m2.7` (via OpenRouter)
 - **Use for**: Design system creation, DESIGN.md, visual audit, usability planning. Creates design plans — does not implement.
 - **Cost**: $0.30/M input, $1.20/M output
 
 ### Tyr
 
-- **Model**: `openrouter/minimax-m3` (via OpenRouter)
+- **Model**: `openrouter/minimax/minimax-m3` (via OpenRouter)
 - **Use for**: Highest complexity implementation, debugging, architecture, multi-step engineering
 - **Cost**: Higher — reserved for the hardest problems
 
@@ -196,7 +201,7 @@ Odin (`@odin`) is the All-Father and primary/default agent. He analyzes each req
 
 ### Forseti
 
-- **Model**: `openrouter/minimax-m3` (via OpenRouter, audit-only, no edit permissions)
+- **Model**: `openrouter/minimax/minimax-m3` (via OpenRouter, audit-only, no edit permissions)
 - **Use for**: Adversarial plan review — audits completeness, correctness, consistency, feasibility, security
 - **Always runs before any Tier 4 or Tier 5 implementation begins**
 

package/config/agents/baldr.md

@@ -1,7 +1,7 @@
 ---
 description: Baldr — UI/UX design system specialist. Creates DESIGN.md files using Google's design.md standard (alpha). Focuses on visual consistency, usability, accessibility, and design tokens.
 mode: subagent
-model: openrouter/minimax-m2.7
+model: openrouter/minimax/minimax-m2.7
 color: "#ec4899"
 permission:
   read: allow

package/config/agents/forseti.md

@@ -1,7 +1,7 @@
 ---
 description: Forseti — Audits, criticizes, and corrects implementation plans before execution using MiniMax M3. No write permissions — review only.
 mode: subagent
-model: openrouter/minimax-m3
+model: openrouter/minimax/minimax-m3
 color: "#ef4444"
 permission:
   read: allow

package/config/agents/hermod.md

@@ -1,7 +1,7 @@
 ---
 description: Hermod — Git and GitHub operations specialist using MiniMax M2.7. Branching, commits, PRs, merge/rebase, conflict resolution, CI/CD, releases, gh CLI.
 mode: subagent
-model: openrouter/minimax-m2.7
+model: openrouter/minimax/minimax-m2.7
 color: "#06b6d4"
 permission:
   read: allow

package/config/agents/odin.md

@@ -1,7 +1,7 @@
 ---
 description: Odin — Pure router that delegates all work to subagents. Routes across Frigg (DeepSeek/Q&A), Vör (DeepSeek/clarify), Mimir (DeepSeek/research), Heimdall (DeepSeek/simple), Hermod (M2.7/git), Thor (M2.7/mid), Baldr (M2.7/design), Tyr (M3/top), Vidarr (GPT-5.5/ultra), Forseti (verifier/M3).
 mode: primary
-model: openrouter/minimax-m3
+model: openrouter/minimax/minimax-m3
 color: "#6366f1"
 permission:
   task: allow
@@ -306,7 +306,7 @@ Call `bizar_spawn_background` with:
 
 - `agent`: the agent name (e.g., "mimir", "thor", "tyr")
 - `prompt`: what to do (specific, with context)
-- `model`: optional, `"<providerID>/<modelID>"` format (e.g., `"openrouter/minimax-m3"`)
+- `model`: optional, `"<providerID>/<modelID>"` format (e.g., `"openrouter/minimax/minimax-m3"`)
 - `timeoutMs`: optional, default 5 min, max 30 min, min 1s
 
 You get an `instanceId` back immediately.

package/config/agents/quick.md

@@ -1,7 +1,7 @@
 ---
 description: Quick (quick) — fast single-shot tasks. No delegation, no parallel streams. Use for small edits, mechanical changes, one-shot questions. Routes to no one.
 mode: primary
-model: openrouter/minimax-m2.7
+model: openrouter/minimax/minimax-m2.7
 color: "#22d3ee"
 permission:
   read: allow

package/config/agents/thor.md

@@ -1,7 +1,7 @@
 ---
 description: Thor — Handles medium-complexity tasks using MiniMax M2.7 from OpenRouter. Strong and reliable, cheaper than Tyr but more capable than Heimdall.
 mode: subagent
-model: openrouter/minimax-m2.7
+model: openrouter/minimax/minimax-m2.7
 color: "#a855f7"
 permission:
   read: allow

package/config/agents/tyr.md

@@ -1,7 +1,7 @@
 ---
 description: Tyr — Handles the most complex implementation, debugging, and architectural work using MiniMax M3 via OpenRouter. Unmatched wisdom for the hardest problems.
 mode: subagent
-model: openrouter/minimax-m3
+model: openrouter/minimax/minimax-m3
 color: "#f59e0b"
 permission:
   read: allow

package/config/opencode.json.template

@@ -1,23 +1,10 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "openrouter/minimax-m3",
-  "small_model": "openrouter/minimax-m2.7",
+  "model": "openrouter/minimax/minimax-m3",
+  "small_model": "openrouter/minimax/minimax-m2.7",
   "default_agent": "odin",
   "permission": "allow",
   "snapshot": false,
-  "provider": {
-    "openrouter": {
-      "npm": "@openrouter/ai-sdk-provider",
-      "name": "OpenRouter",
-      "options": {
-        "apiKey": "{env:OPENROUTER_API_KEY}"
-      },
-      "models": {
-        "minimax-m2.7": {},
-        "minimax-m3": {}
-      }
-    }
-  },
   "mcp": {
     "supabase": {
       "type": "remote",
@@ -66,7 +53,7 @@
     "odin": {
       "description": "Odin — Pure router that delegates all work to subagents.",
       "mode": "primary",
-      "model": "openrouter/minimax-m3",
+      "model": "openrouter/minimax/minimax-m3",
       "color": "#6366f1",
       "permission": {
         "task": "allow",
@@ -80,7 +67,7 @@
     "vor": {
       "description": "Vör — The Questioning One.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#8b5cf6",
       "permission": {
         "read": "allow",
@@ -93,7 +80,7 @@
     "frigg": {
       "description": "Frigg — All-knowing Q&A agent.",
       "mode": "primary",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -111,7 +98,7 @@
     "quick": {
       "description": "Quick — Fast single-shot tasks.",
       "mode": "primary",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#22d3ee",
       "permission": {
         "read": "allow",
@@ -130,7 +117,7 @@
     "mimir": {
       "description": "Mimir — Research and codebase exploration agent.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#0ea5e9",
       "permission": {
         "read": "allow",
@@ -148,7 +135,7 @@
     "heimdall": {
       "description": "Heimdall — Simple, routine, deterministic tasks.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#10b981",
       "permission": {
         "read": "allow",
@@ -165,7 +152,7 @@
     "hermod": {
       "description": "Hermod — Git and GitHub operations specialist.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -181,7 +168,7 @@
     "thor": {
       "description": "Thor — Medium-complexity tasks, strong and reliable.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#a855f7",
       "permission": {
         "read": "allow",
@@ -198,7 +185,7 @@
     "baldr": {
       "description": "Baldr — UI/UX design system specialist.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m2.7",
+      "model": "openrouter/minimax/minimax-m2.7",
       "color": "#ec4899",
       "permission": {
         "read": "allow",
@@ -215,7 +202,7 @@
     "tyr": {
       "description": "Tyr — Complex implementation, debugging, architecture.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m3",
+      "model": "openrouter/minimax/minimax-m3",
       "color": "#f59e0b",
       "permission": {
         "read": "allow",
@@ -249,7 +236,7 @@
     "forseti": {
       "description": "Forseti — Audits and corrects plans before execution.",
       "mode": "subagent",
-      "model": "openrouter/minimax-m3",
+      "model": "openrouter/minimax/minimax-m3",
       "color": "#ef4444",
       "permission": {
         "read": "allow",
@@ -325,11 +312,17 @@
       "models": {
         "MiniMax-M3": {
           "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
+          "reasoning": true,
+          "options": {
+            "thinking": "adaptive"
+          }
         },
         "MiniMax-M2.7": {
           "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
+          "reasoning": true,
+          "options": {
+            "thinking": "adaptive"
+          }
         }
       }
     },
@@ -337,11 +330,17 @@
       "models": {
         "minimax/minimax-m3": {
           "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
+          "reasoning": true,
+          "options": {
+            "reasoning": { "enabled": true }
+          }
         },
         "minimax/minimax-m2.7": {
           "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
+          "reasoning": true,
+          "options": {
+            "reasoning": { "enabled": true }
+          }
         }
       }
     }

package/config/rules/general.md

@@ -5,4 +5,5 @@
 - All code must be reviewed by another agent before merging
 - Keep functions small and focused — a function should do one thing
 - Use meaningful names for variables, functions, and classes
-- Prefer readability over cleverness
+- Prefer readability over cleverness
+- When uncertain or stuck, reach for `websearch` / `webfetch` (or `semble search` / `hindsight_recall` for repo and project memory) before trying a third variation of the same edit — see `uncertainty.md`

package/config/skills/bizar/SKILL.md

@@ -98,8 +98,8 @@ permission:
 
 **Fix:** Check `~/.config/opencode/agents/<name>.md` for the `model:` field. Valid models:
 - `opencode/deepseek-v4-flash-free` — free
-- `openrouter/minimax-m2.7` — M2.7
-- `openrouter/minimax-m3` — M3
+- `openrouter/minimax/minimax-m2.7` — M2.7
+- `openrouter/minimax/minimax-m3` — M3
 - `openai/gpt-5.5` — GPT-5.5
 
 ### OpenRouter 404 Errors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "3.12.0",
+  "version": "3.12.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.",
   "type": "module",
   "bin": {