@polderlabs/bizar 2.3.0 → 2.4.0

package/cli/copy.mjs

@@ -269,8 +269,11 @@ export async function installPluginBizar(projectRoot) {
   try {
     await access(srcDir, constants.F_OK);
   } catch {
-    spinner.warn(chalk.yellow('Bizar plugin source not found — skipping'));
-    return { copied: 0, errors: ['Source not found: ' + srcDir] };
+    // The Bizar plugin now lives in a separate npm package
+    // (@polderlabs/bizar-plugin). The interactive installer copies it from
+    // there; the source tree no longer carries plugins/bizar/.
+    // Silent return — no warning needed.
+    return { copied: 0, errors: [] };
   }
 
   const destDir = join(projectRoot, '.opencode', 'plugins', 'bizar');
@@ -506,3 +509,40 @@ export async function installCommands() {
   }
   return count;
 }
+
+/**
+ * Install Bizar-specific commands to commands-bizar/ (separate from ECC's
+ * commands/ symlink). This directory holds the Bizar plugin's own command
+ * templates: audit, explain, init, learn, plan, pr-review, tailscale-serve,
+ * visual-plan, and bizar.
+ *
+ * If dest is a symlink (e.g. the ECC installer symlinked it), skip with a
+ * friendly message — we don't want to follow a symlink and write into someone
+ * else's directory.
+ *
+ * @returns {Promise<number>} count of .md files copied
+ */
+export async function installCommandsBizar() {
+  const src = repoPath('config', 'commands');
+  const dest = join(opencodeConfigDir(), 'commands-bizar');
+  const { mkdirSync, readdirSync, copyFileSync, lstatSync } = await import('node:fs');
+
+  // Guard: skip if dest is a symlink (don't follow other packages' symlinks)
+  try {
+    const stat = lstatSync(dest);
+    if (stat.isSymbolicLink()) {
+      console.log('BizarHarness: commands-bizar/ is a symlink — skipping install.');
+      return 0;
+    }
+  } catch {
+    // dest does not exist — that's fine, we'll create it
+  }
+
+  mkdirSync(dest, { recursive: true });
+  let count = 0;
+  for (const file of readdirSync(src).filter(f => f.endsWith('.md'))) {
+    copyFileSync(join(src, file), join(dest, file));
+    count++;
+  }
+  return count;
+}

package/cli/install.mjs

@@ -1,11 +1,12 @@
 import chalk from 'chalk';
 import boxen from 'boxen';
 import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 
 import { showBanner, showPantheon, sectionHeading } from './banner.mjs';
 import { promptComponents, promptInstallMode, promptAgents, promptSkillPacks, promptApiKeys, promptConfirmInstall, promptRestartOpenCode } from './prompts.mjs';
 import { detectOpenCode, detectRtk, detectSemble, detectSkillsCli, buildSummary, opencodeAgentsDir, opencodeConfigDir, repoPath } from './utils.mjs';
-import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installRtk, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, mergeToolsIntoUserConfig } from './copy.mjs';
+import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installRtk, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
 
 const AGENT_FILES = [
   'odin.md', 'vor.md', 'frigg.md', 'quick.md',
@@ -295,13 +296,25 @@ export async function runInstaller() {
 
 export async function runPostInstall() {
   const { mkdirSync, copyFileSync, existsSync } = await import('node:fs');
-  const { join } = await import('node:path');
   const { execSync } = await import('node:child_process');
 
+  const dest = join(opencodeConfigDir(), 'opencode.json');
+  const templateSrc = repoPath('config', 'opencode.json');
+  if (!existsSync(dest)) {
+    if (existsSync(templateSrc)) {
+      mkdirSync(opencodeConfigDir(), { recursive: true });
+      copyFileSync(templateSrc, dest);
+      console.log('  ✓ opencode.json bootstrapped from package template');
+    }
+  }
+
+  // Install Bizar commands to commands-bizar/ (separate from ECC's commands symlink)
+  await installCommandsBizar();
+
   const env = await detectOpenCode();
   if (!env.exists) {
-    console.log('BizarHarness: opencode not detected — skipping auto-install.');
-    return;
+    mkdirSync(opencodeConfigDir(), { recursive: true });
+    console.log('BizarHarness: created ~/.config/opencode/');
   }
 
   mkdirSync(opencodeAgentsDir(), { recursive: true });

package/config/commands/bizar.md

@@ -0,0 +1,44 @@
+# Bizar Plugin Menu
+
+You are @odin, the routing agent. The user invoked /bizar. They wrote: $ARGUMENTS
+
+Based on their request, route them to the right Bizar action.
+
+## Available commands
+
+- `/visual-plan on|off|status` — Toggle the Bizar visual plan canvas
+- `/plan new <slug> [template]` — Create a new visual plan
+- `/plan list` — List existing plans
+- `/plan open <slug>` — Open a plan
+- `/plan get <slug>` — Get plan content
+- `/plan add <slug> --title "..."` — Add element to plan
+- `/plan update <slug> <id> ...` — Update element
+- `/plan delete <slug> <id>` — Delete element
+- `/plan comment <slug> [id] "..."` — Add comment
+- `/plan comments <slug> [id]` — List comments
+- `/plan status <slug> <status>` — Set plan status
+- `/plan wait <slug>` — Wait for plan feedback
+- `/audit` — Run a security audit
+- `/explain <question>` — Read-only Q&A (routes to @frigg)
+- `/init` — Initialize Bizar in the current project
+- `/learn` — Extract patterns from the session (routes to @heimdall)
+- `/pr-review` — Run a PR review with @mimir + @forseti (routes to @hermod)
+- `/tailscale-serve` — Set up Tailscale Serve
+
+## Routing rules
+
+1. If the user wants to read code or understand something without changes → invoke `/explain` or answer as @frigg
+2. If the user wants to plan work visually → `/visual-plan on` then `/plan new <slug>`
+3. If the user wants to do a security audit → `/audit`
+4. If the user wants to review a PR → `/pr-review`
+5. If the user wants to learn patterns from a session → `/learn`
+6. If the user wants to initialize Bizar → `/init`
+7. Otherwise, ask a clarifying question and route to the appropriate sub-agent
+
+## Response format
+
+Briefly explain what you'll do, then either:
+- Run the appropriate slash command, OR
+- Ask one clarifying question if the request is ambiguous
+
+Never make changes to the codebase. You are a router, not an executor.

package/config/commands/plan.md

@@ -0,0 +1,26 @@
+Open or manage a Bizar visual plan. Plans are collaborative canvases for structuring work across agents.
+
+## Usage
+
+```
+/plan new <slug> [template]  — Create a new plan with a unique slug
+/plan list                   — List all existing plans
+/plan open <slug>            — Open a plan (returns the canvas URL)
+/plan get <slug>             — Get full plan content as JSON
+/plan add <slug> --title "..." — Add a new element to a plan
+/plan update <slug> <id> ...  — Update an element's content/title/status
+/plan delete <slug> <id>    — Delete an element from a plan
+/plan comment <slug> [id] "..." — Add a comment to a plan or element
+/plan comments <slug> [id]   — List comments on a plan or element
+/plan status <slug> <status> — Set plan status (draft|approved|rejected|in-progress|done)
+/plan wait <slug>            — Block until the plan receives feedback
+```
+
+## Routing
+
+- If the user wants to create a new plan → `/plan new <slug>`
+- If the user wants to see existing plans → `/plan list`
+- If the user wants to open/view a plan → `/plan open <slug>`
+- If the user wants to add content to a plan → `/plan add <slug> --title "..."`
+- If the user wants to modify a plan element → `/plan update <slug> <id> ...`
+- If the user wants to discuss/approve/reject → `/plan status <slug> <status>`

package/config/commands/visual-plan.md

@@ -0,0 +1,15 @@
+Toggle the Bizar visual plan canvas or check its current status.
+
+## Usage
+
+```
+/visual-plan on   — Enable the visual plan canvas in the current session
+/visual-plan off  — Disable the visual plan canvas
+/visual-plan status — Show whether the canvas is currently enabled
+```
+
+## Notes
+
+The visual plan canvas shows plans as interactive node graphs. When enabled, plan elements appear as draggable nodes on a canvas that agents can manipulate directly. This is useful for visual thinkers or when planning complex multi-step work.
+
+This is a session-level toggle — it affects the current opencode session only.

package/config/opencode.json

@@ -2,7 +2,7 @@
   "$schema": "https://opencode.ai/config.json",
   "model": "minimax/MiniMax-M3",
   "small_model": "minimax/MiniMax-M2.7",
-  "default_agent": "quick",
+  "default_agent": "odin",
   "permission": "allow",
   "snapshot": false,
   "mcp": {
@@ -48,5 +48,263 @@
     "bizar_status": true,
     "bizar_collect": true,
     "bizar_kill": true
+  },
+  "agent": {
+    "odin": {
+      "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": "minimax/MiniMax-M3",
+      "color": "#6366f1",
+      "permission": {
+        "task": "allow",
+        "read": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "vor": {
+      "description": "Vör — The Questioning One. When a task is ambiguous, incomplete, or unclear, Vör asks the right clarifying questions before any work begins.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#8b5cf6",
+      "permission": {
+        "read": "allow",
+        "list": "allow",
+        "question": "allow",
+        "hindsight_recall": "allow",
+        "hindsight_retain": "allow"
+      }
+    },
+    "frigg": {
+      "description": "Frigg — All-knowing Q&A agent. Read-only codebase questions and answers. Never edits, never writes, only answers.",
+      "mode": "primary",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#06b6d4",
+      "permission": {
+        "read": "allow",
+        "list": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "bash": "allow",
+        "webfetch": "allow",
+        "websearch": "allow",
+        "hindsight_recall": "allow",
+        "hindsight_retain": "allow",
+        "question": "allow"
+      }
+    },
+    "quick": {
+      "description": "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": "minimax/MiniMax-M2.7",
+      "color": "#22d3ee",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "write": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow",
+        "task": "deny"
+      }
+    },
+    "mimir": {
+      "description": "Mimir — Dedicated research and codebase exploration agent. Uses Semble as primary search tool. Deep codebase analysis, pattern discovery, and documentation research.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#0ea5e9",
+      "permission": {
+        "read": "allow",
+        "write": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "webfetch": "allow",
+        "websearch": "allow",
+        "todowrite": "allow"
+      }
+    },
+    "heimdall": {
+      "description": "Heimdall — Simple, routine, and deterministic tasks using DeepSeek. Quick edits, mechanical work, file operations. The ever-watchful guardian.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#10b981",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "hermod": {
+      "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": "minimax/MiniMax-M2.7",
+      "color": "#06b6d4",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "thor": {
+      "description": "Thor — Handles medium-complexity tasks using MiniMax M2.7 from minimax.io. Strong and reliable, cheaper than Tyr but more capable than Heimdall.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#a855f7",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "baldr": {
+      "description": "Baldr — UI/UX design system specialist. Creates DESIGN.md files using Google's design.md standard. Focuses on visual consistency, usability, accessibility, and design tokens.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M2.7",
+      "color": "#ec4899",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "tyr": {
+      "description": "Tyr — Handles the most complex implementation, debugging, and architectural work using MiniMax M3 via minimax.io. Unmatched wisdom for the hardest problems.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M3",
+      "color": "#f59e0b",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "vidarr": {
+      "description": "Vidarr — The ultimate fallback using GPT-5.5 via OpenAI ChatGPT subscription. For the hardest problems when debugging stalls or nothing else works. Use sparingly — highest cost.",
+      "mode": "subagent",
+      "model": "openai/gpt-5.5",
+      "color": "#dc2626",
+      "permission": {
+        "read": "allow",
+        "edit": "allow",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "forseti": {
+      "description": "Forseti — Audits, criticizes, and corrects implementation plans before execution using MiniMax M3. No write permissions — review only.",
+      "mode": "subagent",
+      "model": "minimax/MiniMax-M3",
+      "color": "#ef4444",
+      "permission": {
+        "read": "allow",
+        "edit": "deny",
+        "bash": "allow",
+        "glob": "allow",
+        "grep": "allow",
+        "list": "allow",
+        "todowrite": "allow",
+        "question": "allow",
+        "webfetch": "allow",
+        "websearch": "allow"
+      }
+    },
+    "semble-search": {
+      "description": "Code search agent for exploring any codebase. Use for finding code by intent, locating implementations, understanding how something works.",
+      "mode": "subagent",
+      "permission": {
+        "bash": "allow",
+        "read": "allow"
+      }
+    }
+  },
+  "command": {
+    "audit": {
+      "description": "Run bizar audit to scan agent configuration for security issues.",
+      "agent": "forseti",
+      "template": "commands-bizar/audit.md"
+    },
+    "explain": {
+      "description": "Route to @frigg for read-only codebase Q&A. She will explore the code and answer without making any changes.",
+      "agent": "frigg",
+      "template": "commands-bizar/explain.md"
+    },
+    "init": {
+      "description": "Run bizar init to detect project stack, install relevant skills, and create .bizar/PROJECT.md.",
+      "agent": "heimdall",
+      "template": "commands-bizar/init.md"
+    },
+    "learn": {
+      "description": "Route to @heimdall. Extract patterns from the current session and append to .bizar/AGENTS_SELF_IMPROVEMENT.md.",
+      "agent": "heimdall",
+      "template": "commands-bizar/learn.md"
+    },
+    "plan": {
+      "description": "Open the Bizar visual plan canvas or manage existing plans.",
+      "agent": "odin",
+      "template": "commands-bizar/plan.md"
+    },
+    "pr-review": {
+      "description": "Route to @hermod for PR review mode. Launches @mimir (research) and @forseti (audit) in parallel, then posts the combined review as a PR comment.",
+      "agent": "hermod",
+      "template": "commands-bizar/pr-review.md"
+    },
+    "tailscale-serve": {
+      "description": "Authenticate Tailscale Serve and expose a local port on your tailnet.",
+      "agent": "heimdall",
+      "template": "commands-bizar/tailscale-serve.md"
+    },
+    "visual-plan": {
+      "description": "Toggle the Bizar visual plan canvas on or off, or check its current status.",
+      "agent": "odin",
+      "template": "commands-bizar/visual-plan.md"
+    },
+    "bizar": {
+      "description": "Bizar Plugin Menu — route to the right Bizar action based on the user's request.",
+      "agent": "odin",
+      "template": "commands-bizar/bizar.md\n\n$ARGUMENTS"
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing and per-project Hindsight memory",
   "type": "module",
   "bin": {

package/config/opencode.json.template

@@ -1,52 +0,0 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "model": "opencode/deepseek-v4-flash-free",
-  "small_model": "opencode/deepseek-v4-flash-free",
-  "default_agent": "odin",
-  "permission": "allow",
-  "snapshot": false,
-  "mcp": {
-    "supabase": {
-      "type": "remote",
-      "url": "https://mcp.supabase.com/mcp",
-      "enabled": true
-    },
-    "hindsight": {
-      "type": "remote",
-      "url": "https://memory-api.polderlabs.io/mcp",
-      "enabled": true,
-      "oauth": false,
-      "headers": {
-        "Authorization": "Bearer YOUR_HINDSIGHT_API_KEY",
-        "Content-Type": "application/json"
-      }
-    },
-    "semble": {
-      "type": "local",
-      "command": [
-        "uvx",
-        "--from",
-        "semble[mcp]",
-        "semble"
-      ],
-      "enabled": true
-    }
-  },
-  "plugin": [
-    ["./plugins/bizar/index.ts", {
-      "loopThresholdWarn": 5,
-      "loopThresholdEscalate": 8,
-      "loopThresholdBlock": 12,
-      "loopWindowSize": 10
-    }]
-  ],
-  "tools": {
-    "bizar_plan_action": true,
-    "bizar_get_plan_comments": true,
-    "bizar_wait_for_feedback": true,
-    "bizar_spawn_background": true,
-    "bizar_status": true,
-    "bizar_collect": true,
-    "bizar_kill": true
-  }
-}