@polderlabs/bizar 4.9.0 → 5.0.1

package/cli/commands/workspace.mjs

@@ -0,0 +1,247 @@
+/**
+ * cli/commands/workspace.mjs
+ *
+ * v5.0.0 — Workspace management CLI — talks to the running dashboard's HTTP API.
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const HOME = homedir();
+
+// ── Config dir helper ──────────────────────────────────────────────────────────
+
+function getBizarConfigDir() {
+  if (process.platform === 'win32') {
+    return process.env.APPDATA
+      ? join(process.env.APPDATA, 'bizar')
+      : join(homedir(), '.config', 'bizar');
+  }
+  return process.env.XDG_CONFIG_HOME
+    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
+    : join(homedir(), '.config', 'bizar');
+}
+
+function getDashboardPort() {
+  const portFile = join(getBizarConfigDir(), 'dashboard.port');
+  try {
+    const port = parseInt(readFileSync(portFile, 'utf8').trim(), 10);
+    if (Number.isFinite(port) && port > 0) return port;
+  } catch {
+    /* fall through */
+  }
+  return null;
+}
+
+// ── API helpers ───────────────────────────────────────────────────────────────
+
+async function postJson(baseUrl, path, body) {
+  const res = await fetch(`${baseUrl}${path}`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body || {}),
+  });
+  const text = await res.text();
+  let json = null;
+  try { json = text ? JSON.parse(text) : null; } catch { /* keep raw */ }
+  if (!res.ok) {
+    const msg = json?.message || json?.error || text || `HTTP ${res.status}`;
+    throw new Error(`${path} failed: ${msg}`);
+  }
+  return json;
+}
+
+async function getJson(baseUrl, path) {
+  const res = await fetch(`${baseUrl}${path}`);
+  const text = await res.text();
+  let json = null;
+  try { json = text ? JSON.parse(text) : null; } catch { /* keep raw */ }
+  if (!res.ok) {
+    const msg = json?.message || json?.error || text || `HTTP ${res.status}`;
+    throw new Error(`${path} failed: ${msg}`);
+  }
+  return json;
+}
+
+async function delJson(baseUrl, path) {
+  const res = await fetch(`${baseUrl}${path}`, { method: 'DELETE' });
+  const text = await res.text();
+  let json = null;
+  try { json = text ? JSON.parse(text) : null; } catch { /* keep raw */ }
+  if (!res.ok) {
+    const msg = json?.message || json?.error || text || `HTTP ${res.status}`;
+    throw new Error(`${path} failed: ${msg}`);
+  }
+  return json;
+}
+
+// ── Help ───────────────────────────────────────────────────────────────────────
+
+export function showWorkspaceHelp() {
+  console.log(`
+  bizar workspace — Manage workspaces (via the dashboard's HTTP API)
+
+  Usage:
+    bizar workspace list                    List all workspaces
+    bizar workspace create <name>           Create a new workspace
+    bizar workspace switch <id>             Set active workspace
+    bizar workspace invite <email> [role]   Generate invite URL (role: admin|editor|viewer)
+    bizar workspace accept <token>          Accept an invite
+    bizar workspace members                 List workspace members
+    bizar workspace remove-member <userId>  Remove a member
+
+  Description:
+    Subcommands call the running dashboard's HTTP API. If no dashboard is
+    reachable, you'll be told to run \`bizar dash start\` first.
+
+    Workspaces let you share access with team members. Each workspace has
+    its own members, settings, and data.
+
+  Examples:
+    bizar workspace list
+    bizar workspace create "Engineering"
+    bizar workspace invite alice@example.com editor
+    bizar workspace accept abc123def456
+    bizar workspace members
+    bizar workspace remove-member usr_abc123
+  `);
+}
+
+// ── Command runner ───────────────────────────────────────────────────────────
+
+export async function runWorkspaceCommand(args) {
+  const sub = args[0];
+  const positional = args.slice(1).filter((a) => !a.startsWith('-'));
+  const flags = args.slice(1).filter((a) => a.startsWith('-'));
+
+  if (!sub || sub === '--help' || sub === '-h' || flags.includes('--help') || flags.includes('-h')) {
+    showWorkspaceHelp();
+    return;
+  }
+
+  const port = getDashboardPort();
+  if (!port) {
+    console.error(chalk.red('  ✗ Dashboard is not running (no port file).'));
+    console.error(chalk.dim('  Start it first: `bizar dash start --bg`'));
+    process.exit(1);
+  }
+  const baseUrl = `http://127.0.0.1:${port}`;
+
+  try {
+    if (sub === 'list') {
+      const r = await getJson(baseUrl, '/api/workspaces');
+      const workspaces = r.workspaces || [];
+      if (workspaces.length === 0) {
+        console.log(chalk.dim('  (no workspaces)'));
+        return;
+      }
+      console.log(chalk.bold('  Workspaces:'));
+      for (const { workspace, role } of workspaces) {
+        const badge = role === 'admin' ? chalk.green('admin') : role === 'editor' ? chalk.yellow('editor') : chalk.blue('viewer');
+        console.log(`  ${workspace.id.padEnd(20)} ${workspace.name.padEnd(30)} ${badge}`);
+      }
+    } else if (sub === 'create') {
+      const name = positional[0];
+      if (!name) {
+        console.error(chalk.red('  ✗ Missing workspace name. Usage: bizar workspace create <name>'));
+        process.exit(1);
+      }
+      const r = await postJson(baseUrl, '/api/workspaces', { name });
+      console.log(chalk.green(`  ✓ Created workspace "${r.workspace.name}" (${r.workspace.id})`));
+    } else if (sub === 'switch') {
+      const wsId = positional[0];
+      if (!wsId) {
+        console.error(chalk.red('  ✗ Missing workspace id. Usage: bizar workspace switch <id>'));
+        process.exit(1);
+      }
+      // Verify workspace exists
+      try {
+        await getJson(baseUrl, `/api/workspaces/${wsId}`);
+      } catch {
+        console.error(chalk.red(`  ✗ Workspace not found: ${wsId}`));
+        process.exit(1);
+      }
+      console.log(chalk.green(`  ✓ Switched to workspace ${wsId}`));
+      console.log(chalk.dim('  Note: Run `bizar workspace list` to see workspace ids'));
+    } else if (sub === 'invite') {
+      const email = positional[0];
+      if (!email) {
+        console.error(chalk.red('  ✗ Missing email. Usage: bizar workspace invite <email> [role]'));
+        process.exit(1);
+      }
+      const role = positional[1] || 'editor';
+      if (!['admin', 'editor', 'viewer'].includes(role)) {
+        console.error(chalk.red(`  ✗ Invalid role: ${role}. Must be admin, editor, or viewer.`));
+        process.exit(1);
+      }
+      // Get first workspace id (or use BIZAR_WORKSPACE_ID env)
+      const wsId = process.env.BIZAR_WORKSPACE_ID;
+      if (!wsId) {
+        console.error(chalk.red('  ✗ Set BIZAR_WORKSPACE_ID env var or run from a workspace context.'));
+        console.error(chalk.dim('  Run `bizar workspace list` to find your workspace id.'));
+        process.exit(1);
+      }
+      const r = await postJson(baseUrl, `/api/workspaces/${wsId}/invites`, { email, role });
+      console.log(chalk.green(`  ✓ Invite created for ${email} as ${role}`));
+      console.log(chalk.dim('  Invite URL:'));
+      console.log(`  ${r.url}`);
+    } else if (sub === 'accept') {
+      const token = positional[0];
+      if (!token) {
+        console.error(chalk.red('  ✗ Missing invite token. Usage: bizar workspace accept <token>'));
+        process.exit(1);
+      }
+      // For CLI acceptance, we need user info - prompt or use env
+      const email = process.env.BIZAR_USER_EMAIL;
+      const name = process.env.BIZAR_USER_NAME || 'CLI User';
+      if (!email) {
+        console.error(chalk.red('  ✗ Set BIZAR_USER_EMAIL env var with your email address.'));
+        process.exit(1);
+      }
+      const r = await postJson(baseUrl, `/api/invites/${token}/accept`, { email, name });
+      console.log(chalk.green(`  ✓ Joined workspace "${r.workspace.name}" as ${r.role}`));
+    } else if (sub === 'members') {
+      const wsId = process.env.BIZAR_WORKSPACE_ID;
+      if (!wsId) {
+        console.error(chalk.red('  ✗ Set BIZAR_WORKSPACE_ID env var or run from a workspace context.'));
+        process.exit(1);
+      }
+      const r = await getJson(baseUrl, `/api/workspaces/${wsId}`);
+      const members = r.members || [];
+      if (members.length === 0) {
+        console.log(chalk.dim('  (no members)'));
+        return;
+      }
+      console.log(chalk.bold(`  Members of ${r.workspace.name}:`));
+      for (const m of members) {
+        const badge = m.role === 'admin' ? chalk.green('admin') : m.role === 'editor' ? chalk.yellow('editor') : chalk.blue('viewer');
+        console.log(`  ${m.userId.padEnd(20)} ${(m.name || m.email).padEnd(20)} ${badge}`);
+      }
+    } else if (sub === 'remove-member') {
+      const userId = positional[0];
+      if (!userId) {
+        console.error(chalk.red('  ✗ Missing user id. Usage: bizar workspace remove-member <userId>'));
+        process.exit(1);
+      }
+      const wsId = process.env.BIZAR_WORKSPACE_ID;
+      if (!wsId) {
+        console.error(chalk.red('  ✗ Set BIZAR_WORKSPACE_ID env var.'));
+        process.exit(1);
+      }
+      await delJson(baseUrl, `/api/workspaces/${wsId}/members/${userId}`);
+      console.log(chalk.green(`  ✓ Removed member ${userId}`));
+    } else {
+      console.error(chalk.red(`  ✗ Unknown workspace subcommand: ${sub}`));
+      showWorkspaceHelp();
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error(chalk.red(`  ✗ ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function run(name, args, isHelpRequest) {
+  await runWorkspaceCommand(args);
+}

package/cli/tests/minimax-cli.test.mjs

@@ -0,0 +1,79 @@
+/**
+ * cli/tests/minimax-cli.test.mjs
+ *
+ * Tests for MiniMax CLI bar rendering.
+ * Verifies bar shows CONSUMED quota as filled blocks (not remaining).
+ */
+
+import { test, describe } from 'node:test';
+import assert from 'node:assert';
+
+// ── Bar rendering helper (mirrors minimax.mjs logic) ──────────────────────────
+
+/**
+ * Render a quota bar string.
+ * @param {number} remainingPct - percentage of quota remaining (0-100)
+ * @returns {string} bar string like '██░░░░░░░░░░░░░░░░░' (20 chars total)
+ */
+function renderBar(remainingPct) {
+  const consumed = 100 - remainingPct;
+  const filled = Math.round(consumed / 5);
+  const empty = 20 - filled;
+  return '█'.repeat(filled) + '░'.repeat(empty);
+}
+
+// ── Tests ───────────────────────────────────────────────────────────────────
+
+describe('MiniMax CLI bar rendering', () => {
+
+  test('91% remaining → 9% consumed → 2 filled blocks (9/5 rounds to 2)', () => {
+    const bar = renderBar(91);
+    const filledCount = (bar.match(/█/g) || []).length;
+    assert.strictEqual(filledCount, 2, `Expected 2 filled blocks for 91% remaining, got ${filledCount}`);
+    assert.strictEqual(bar.length, 20, `Bar should be exactly 20 chars`);
+  });
+
+  test('100% remaining → 0% consumed → 0 filled blocks', () => {
+    const bar = renderBar(100);
+    const filledCount = (bar.match(/█/g) || []).length;
+    assert.strictEqual(filledCount, 0, `Expected 0 filled blocks for 100% remaining`);
+  });
+
+  test('0% remaining → 100% consumed → 20 filled blocks', () => {
+    const bar = renderBar(0);
+    const filledCount = (bar.match(/█/g) || []).length;
+    assert.strictEqual(filledCount, 20, `Expected 20 filled blocks for 0% remaining`);
+  });
+
+  test('75% remaining → 25% consumed → 5 filled blocks', () => {
+    const bar = renderBar(75);
+    const filledCount = (bar.match(/█/g) || []).length;
+    assert.strictEqual(filledCount, 5, `Expected 5 filled blocks for 75% remaining`);
+  });
+
+  test('25% remaining → 75% consumed → 15 filled blocks', () => {
+    const bar = renderBar(25);
+    const filledCount = (bar.match(/█/g) || []).length;
+    assert.strictEqual(filledCount, 15, `Expected 15 filled blocks for 25% remaining`);
+  });
+
+  test('bar is always exactly 20 characters', () => {
+    for (const remaining of [0, 10, 25, 50, 75, 90, 100]) {
+      const bar = renderBar(remaining);
+      assert.strictEqual(bar.length, 20, `Bar for ${remaining}% remaining should be 20 chars, got ${bar.length}`);
+    }
+  });
+
+  test('filled blocks increase as remaining decreases', () => {
+    const bars = [100, 91, 75, 50, 25, 10, 0].map(r => ({
+      remaining: r,
+      filled: (renderBar(r).match(/█/g) || []).length
+    }));
+    for (let i = 1; i < bars.length; i++) {
+      assert.ok(
+        bars[i].filled >= bars[i-1].filled,
+        `${bars[i].remaining}% remaining (${bars[i].filled} blocks) should have >= filled blocks than ${bars[i-1].remaining}% remaining (${bars[i-1].filled} blocks)`
+      );
+    }
+  });
+});

package/config/agents/frigg.md

@@ -1,7 +1,7 @@
 ---
 description: Frigg — Read-only codebase Q&A. Answers questions about the project with file references, never modifies anything. Routes to no one.
 mode: subagent
-model: opencode/deepseek-v4-flash-free
+model: minimax/MiniMax-M2.7
 color: "#f472b6"
 permission:
   read: allow

package/config/agents/heimdall.md

@@ -1,7 +1,7 @@
 ---
 description: Heimdall — Simple, routine, and deterministic tasks using DeepSeek. Quick edits, mechanical work, file operations. The ever-watchful guardian.
 mode: subagent
-model: opencode/deepseek-v4-flash-free
+model: minimax/MiniMax-M2.7
 color: "#10b981"
 permission:
   read: allow

package/config/agents/mimir.md

@@ -1,7 +1,7 @@
 ---
 description: Mimir — Deep codebase research and exploration. Uses Semble as primary search tool. Architecture analysis, pattern discovery, documentation research, and project initialization.
 mode: subagent
-model: opencode/deepseek-v4-flash-free
+model: minimax/MiniMax-M2.7
 color: "#06b6d4"
 permission:
   read: allow

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: minimax/MiniMax-M2.7
+model: minimax/MiniMax-M2.7-Flash
 color: "#22d3ee"
 permission:
   read: allow

package/config/agents/semble-search.md

@@ -1,7 +1,7 @@
 ---
 description: Code search agent for exploring any codebase. Use for finding code by intent, locating implementations, understanding how something works, or discovering related code. Prefer over Bash/Read for any semantic or exploratory question.
 mode: subagent
-model: opencode/deepseek-v4-flash-free
+model: minimax/MiniMax-M2.7
 color: "#64748b"
 permission:
   read: allow

package/config/agents/vor.md

@@ -1,7 +1,7 @@
 ---
 description: Vör — Asks clarifying questions for ambiguous or incomplete requests. Reads project context first, then asks one targeted, project-specific question.
 mode: subagent
-model: opencode/deepseek-v4-flash-free
+model: minimax/MiniMax-M2.7
 color: "#a78bfa"
 permission:
   read: allow

package/config/opencode.json

@@ -37,7 +37,14 @@
       "loopThresholdWarn": 5,
       "loopThresholdEscalate": 8,
       "loopThresholdBlock": 12,
-      "loopWindowSize": 10
+      "loopWindowSize": 10,
+      "compaction": {
+        "auto": true,
+        "threshold": 0.5,
+        "preserve_recent": 10,
+        "strategy": "summarize",
+        "model": "minimax/MiniMax-M3-Reasoning"
+      }
     }]
   ],
   "tools": {
@@ -66,9 +73,9 @@
       }
     },
     "vor": {
-      "description": "Vör — Tier 2 clarifier. Reads project context first and asks targeted, project-specific questions when requests are ambiguous. Backed by DeepSeek V4 Flash. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "Vör — Tier 2 clarifier. Reads project context first and asks targeted, project-specific questions when requests are ambiguous. Backed by MiniMax M2.7. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
+      "model": "minimax/MiniMax-M2.7",
       "color": "#8b5cf6",
       "permission": {
         "read": "allow",
@@ -77,9 +84,9 @@
       }
     },
     "frigg": {
-      "description": "Frigg — Tier 1 primary. Read-only Q&A agent that answers codebase questions with file:line citations, never edits. Backed by DeepSeek V4 Flash. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "Frigg — Tier 1 primary. Read-only Q&A agent that answers codebase questions with file:line citations, never edits. Backed by MiniMax M2.7. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "primary",
-      "model": "opencode/deepseek-v4-flash-free",
+      "model": "minimax/MiniMax-M2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -93,9 +100,9 @@
       }
     },
     "quick": {
-      "description": "Quick — Tier 1 primary. Fast single-shot escape hatch for small edits, mechanical changes, and one-shot questions. No delegation, no parallel streams. Backed by MiniMax M2.7. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "Quick — Tier 1 primary. Fast single-shot escape hatch for small edits, mechanical changes, and one-shot questions. No delegation, no parallel streams. Backed by MiniMax M2.7 Flash. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "primary",
-      "model": "minimax/MiniMax-M2.7",
+      "model": "minimax/MiniMax-M2.7-Flash",
       "color": "#22d3ee",
       "permission": {
         "read": "allow",
@@ -112,9 +119,9 @@
       }
     },
     "mimir": {
-      "description": "Mimir — Tier 2 research. Dedicated codebase exploration agent who uses Semble as primary search tool for deep analysis, pattern discovery, and documentation research. Backed by DeepSeek V4 Flash. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "Mimir — Tier 2 research. Dedicated codebase exploration agent who uses Semble as primary search tool for deep analysis, pattern discovery, and documentation research. Backed by MiniMax M2.7. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
+      "model": "minimax/MiniMax-M2.7",
       "color": "#0ea5e9",
       "permission": {
         "read": "allow",
@@ -130,9 +137,9 @@
       }
     },
     "heimdall": {
-      "description": "Heimdall — Tier 2 mechanical. Handles simple, routine, deterministic engineering tasks with speed and precision using DeepSeek V4 Flash. The ever-watchful guardian. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "Heimdall — Tier 2 mechanical. Handles simple, routine, deterministic engineering tasks with speed and precision using MiniMax M2.7. The ever-watchful guardian. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
+      "model": "minimax/MiniMax-M2.7",
       "color": "#10b981",
       "permission": {
         "read": "allow",
@@ -249,9 +256,9 @@
       }
     },
     "semble-search": {
-      "description": "semble-search — Tier 2 research. Code search agent for exploring any codebase using Semble's semantic search. For finding code by intent, locating implementations, and understanding how things work. Backed by DeepSeek V4 Flash. Operates inside BizarHarness alongside 13 sibling agents.",
+      "description": "semble-search — Tier 2 research. Code search agent for exploring any codebase using Semble's semantic search. For finding code by intent, locating implementations, and understanding how things work. Backed by MiniMax M2.7. Operates inside BizarHarness alongside 13 sibling agents.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
+      "model": "minimax/MiniMax-M2.7",
       "color": "#0ea5e9",
       "permission": {
         "bash": "allow",
@@ -312,15 +319,15 @@
   },
   "provider": {
     "minimax": {
+      "options": {
+        "baseURL": "https://api.minimax.io/v1",
+        "apiKey": "{env:MiniMax_API_KEY}"
+      },
       "models": {
-        "MiniMax-M3": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
-        },
-        "MiniMax-M2.7": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true
-        }
+        "MiniMax-M2.7-Flash": { "name": "MiniMax M2.7 Flash", "interleaved": { "field": "reasoning_details" }, "reasoning": true },
+        "MiniMax-M2.7": { "name": "MiniMax M2.7", "interleaved": { "field": "reasoning_details" }, "reasoning": true },
+        "MiniMax-M3": { "name": "MiniMax M3", "interleaved": { "field": "reasoning_details" }, "reasoning": true },
+        "MiniMax-M3-Reasoning": { "name": "MiniMax M3 Reasoning", "interleaved": { "field": "reasoning_details" }, "reasoning": true }
       }
     }
   }

package/config/opencode.json.template

@@ -28,7 +28,14 @@
       "loopThresholdWarn": 5,
       "loopThresholdEscalate": 8,
       "loopThresholdBlock": 12,
-      "loopWindowSize": 10
+      "loopWindowSize": 10,
+      "compaction": {
+        "auto": true,
+        "threshold": 0.5,
+        "preserve_recent": 10,
+        "strategy": "summarize",
+        "model": "minimax/MiniMax-M3-Reasoning"
+      }
     }]
   ],
   "tools": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "4.9.0",
+  "version": "5.0.1",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. v4 ships as a single npm package bundling the dashboard server, opencode plugin, and typed SDK.",
   "type": "module",
   "bin": {
@@ -55,6 +55,7 @@
     "cors": "^2.8.6",
     "croner": "^10.0.1",
     "express": "^4.22.0",
+    "formidable": "^3.5.0",
     "fuse.js": "^7.0.0",
     "inquirer": "^12.0.0",
     "lucide-react": "^0.460.0",
@@ -65,8 +66,15 @@
     "react-dom": "^18.3.0",
     "react-markdown": "^9.0.0",
     "remark-gfm": "^4.0.0",
+    "tesseract.js": "^5.1.1",
     "ws": "^8.18.0",
-    "zod": "4.1.8"
+    "zod": "4.1.8",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.52.1",
+    "@opentelemetry/resources": "^1.30.1",
+    "@opentelemetry/sdk-node": "^0.52.1",
+    "@opentelemetry/sdk-trace-node": "^1.30.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.17.0"
@@ -78,12 +86,6 @@
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.17.7",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.52.0",
-    "@opentelemetry/resources": "^1.25.0",
-    "@opentelemetry/sdk-node": "^0.52.0",
-    "@opentelemetry/sdk-trace-node": "^1.25.0",
-    "@opentelemetry/semantic-conventions": "^1.25.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -93,7 +95,9 @@
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.0",
+    "js-yaml": "^5.2.1",
     "jsdom": "^25.0.1",
+    "smol-toml": "^1.7.0",
     "typescript": "^5.6.0",
     "vite": "^5.0.0",
     "vitest": "^4.1.9"

package/plugins/bizar/index.ts

@@ -143,6 +143,18 @@ import { executeSideEffect, type ExecuteOptions } from "./src/commands-impl.js";
 import { join as pathJoin } from "node:path";
 import { homedir } from "node:os";
 
+// v0.6.3 — Compaction gate. Configures the compaction threshold from
+// `rawOptions.compaction.threshold` (default 0.5) and wires two opencode
+// hooks: `experimental.session.compacting` (push a Bizar-policy note onto
+// the compaction prompt) and `experimental.compaction.autocontinue`
+// (skip the synthetic "continue" turn when our policy decides to compact).
+// The pure decision logic lives in `src/compaction.mjs`.
+import {
+  getCompactionThreshold,
+  setCompactionThreshold,
+  resetCompactionDefaults,
+} from "./src/compaction.mjs";
+
 // --- Env-var constants (per spec §8) -------------------------------------
 
 /** `BIZAR_SERVE_PORT` — default 0 (random). */
@@ -402,6 +414,29 @@ async function init(
   const logger = createLogger(input.client as unknown as Parameters<typeof createLogger>[0]);
   loggerHandle = logger;
 
+  // v0.6.3 — Compaction gate. Read the user-configured threshold from
+  // `rawOptions.compaction.threshold` (default 0.5). Invalid values are
+  // caught by `setCompactionThreshold` and logged; we fall back to the
+  // module default rather than crashing init (per spec §8.1: any init
+  // error must not break the plugin).
+  resetCompactionDefaults();
+  const compactionCfg = (rawOptions as Record<string, unknown> | undefined)
+    ?.compaction as { threshold?: unknown } | undefined;
+  if (compactionCfg && typeof compactionCfg.threshold === "number") {
+    try {
+      setCompactionThreshold(compactionCfg.threshold);
+      logger.info(
+        `bizar: compaction threshold set to ${compactionCfg.threshold} (from plugin options)`,
+      );
+    } catch (err) {
+      logger.warn(
+        `bizar: invalid compaction threshold ${String(compactionCfg.threshold)}; using default ${getCompactionThreshold()}: ${
+          err instanceof Error ? err.message : String(err)
+        }`,
+      );
+    }
+  }
+
   // §6.4 — refuse to start if logDir or stateDir is inside a secret dir.
   const offending = findOffendingPath(options);
   if (offending !== null) {
@@ -1412,6 +1447,48 @@ function buildHooks(ctx: RuntimeContext, bg: BgDeps): Hooks {
     // v0.4.2 — register the 4 background tools.
     tool: tools,
 
+    // v0.6.3 — Compaction gate. Called by opencode BEFORE it starts a
+    // session compaction. We append a one-line Bizar policy note so the
+    // model summarises with our threshold in mind (the default opencode
+    // compaction prompt doesn't know about our 50% trigger). The threshold
+    // itself was set during `init()` from `rawOptions.compaction.threshold`.
+    "experimental.session.compacting": async (_input, output) => {
+      try {
+        const threshold = getCompactionThreshold();
+        output.context.push(
+          `Bizar compaction policy: this compaction was triggered at the configured ${threshold} ratio of context usage. Preserve technical decisions, file paths, error messages, and unresolved questions verbatim in the summary; compress conversational filler.`,
+        );
+      } catch (err) {
+        ctx.logger.warn(
+          `bizar: experimental.session.compacting failed (passing through): ${
+            err instanceof Error ? err.message : String(err)
+          }`,
+        );
+      }
+    },
+
+    // v0.6.3 — Compaction auto-continue gate. Called by opencode AFTER
+    // compaction succeeds and BEFORE it injects a synthetic user "continue"
+    // message. We disable auto-continue when compaction was actually
+    // triggered (so the user sees the compacted state and can drive the
+    // next step), and let auto-continue proceed otherwise. We can't read
+    // the live usage ratio here, so we use the configured threshold as a
+    // proxy: if it's been lowered below 1.0, the policy is "compact
+    // early", and we want the user in the loop.
+    "experimental.compaction.autocontinue": async (_input, output) => {
+      try {
+        if (getCompactionThreshold() < 1.0) {
+          output.enabled = false;
+        }
+      } catch (err) {
+        ctx.logger.warn(
+          `bizar: experimental.compaction.autocontinue failed (passing through): ${
+            err instanceof Error ? err.message : String(err)
+          }`,
+        );
+      }
+    },
+
     // v0.4.2 — dispose hook. Opencode calls this when the plugin is
     // being torn down. We do a best-effort cleanup similar to the
     // signal trap, but we do NOT call `process.exit` — that's the