@polderlabs/bizar 4.5.2 → 4.7.0

package/cli/commands/util.mjs

@@ -0,0 +1,306 @@
+/**
+ * cli/commands/util.mjs
+ *
+ * Miscellaneous utility commands:
+ *   audit, init, export, test-gate, dev-link, dev-unlink,
+ *   doctor, repair, heads-up, bg, browser-harness-up, providers detect
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+// ── Help texts ──────────────────────────────────────────────────────────────────
+
+export function showAuditHelp() {
+  console.log(`
+  bizar audit — Run security audit on agent configuration
+
+  Usage:
+    bizar audit
+  `);
+}
+
+export function showInitHelp() {
+  console.log(`
+  bizar init — Initialize .bizar/ in current project
+
+  Usage:
+    bizar init
+
+  Description:
+    Detects the project stack, creates .bizar/PROJECT.md and
+    .bizar/AGENTS_SELF_IMPROVEMENT.md and installs relevant skills.
+    The per-project knowledge graph (in .bizar/graph/) is provided
+    by the graphify mod — install it from the mod registry for
+    that feature.
+  `);
+}
+
+export function showExportHelp() {
+  console.log(`
+  bizar export — Export agents/rules to another harness
+
+  Usage:
+    bizar export [claude|cursor|opencode]
+
+  Description:
+    Copies installed Bizar agents and rules into another harness format.
+  `);
+}
+
+export function showTestGateHelp() {
+  console.log(`
+  bizar test-gate — Detect & run the project's test suite
+  `);
+}
+
+export function showDevLinkHelp() {
+  console.log(`
+  bizar dev-link / dev-unlink — Manage a symlink from the opencode plugin dir
+  to a local source checkout, so edits propagate to opencode on next session.
+
+  Usage:
+    bizar dev-link [source-dir]    Symlink source-dir (default: ./plugins/bizar)
+                                   to ~/.config/opencode/plugins/bizar
+    bizar dev-link --force         Replace an existing deployed copy
+    bizar dev-unlink               Remove the dev symlink + restore from npm
+    bizar dev-unlink --force       Remove even if not a symlink (destructive)
+
+  Description:
+    By default, opencode loads the Bizar plugin from
+    ~/.config/opencode/plugins/bizar, which is a real directory copied
+    from the npm package. Edits to plugins/bizar/ in the BizarHarness
+    repo don't propagate until you re-run the installer.
+
+    \`bizar dev-link\` replaces that directory with a symlink pointing
+    at your local checkout, so source edits are picked up immediately.
+    \`bizar dev-unlink\` reverses the change by removing the symlink
+    and re-installing the deployed copy from the npm package.
+
+    While the dev link is in place, \`bizar update\` will skip the
+    plugin-copy step (and print a warning) so it doesn't clobber the
+    link. Run \`bizar dev-unlink\` first, or pass --force to overwrite.
+
+  Examples:
+    bizar dev-link
+    bizar dev-link /home/me/projects/bizar/plugins/bizar
+    bizar dev-link --force
+    bizar dev-unlink
+  `);
+}
+
+export function showDoctorHelp() {
+  console.log(`
+  bizar doctor — Check the BizarHarness install for health issues
+
+  Usage:
+    bizar doctor
+
+  Description:
+    Runs a battery of health checks against the local install:
+      • opencode CLI reachable
+      • ~/.config/opencode/opencode.json parses as JSON
+      • the Bizar plugin is registered
+      • plugin path resolves
+      • @polderlabs/bizar-plugin is installed globally
+      • core agent files are installed (odin, quick, thor, tyr)
+      • headroom / semble / skills on PATH (lenient — at least one)
+      • dashboard reachable (skipped if no port file)
+      • provider.minimax block + MiniMax model flags are sane
+
+    Prints ✓/✗ for each check and a final summary. Exits non-zero
+    if any check fails. Use \`bizar doctor\` after a manual config
+    edit or to diagnose "why is opencode misbehaving?" questions.
+
+  Related:
+    bizar update              Update + auto-run doctor on success
+  `);
+}
+
+export function showRepairHelp() {
+  console.log(`
+  bizar repair — Fix common install issues
+
+  Usage:
+    bizar repair                Diagnose + fix stale bin symlinks and mismatched versions
+    bizar repair --dry-run      Show what would change without modifying anything
+    bizar repair --bin-only     Only fix the bin symlink; skip version checks
+  `);
+}
+
+// ── Test gate ──────────────────────────────────────────────────────────────────
+
+export async function runTestGate() {
+  console.log(chalk.bold.hex('#a855f7')('\n  ᚦ TEST GATE ᚦ\n'));
+  const { execSync } = await import('node:child_process');
+  const cwd = process.cwd();
+  const possible = [
+    { cmd: 'npm test', check: 'package.json' },
+    { cmd: 'pytest', check: 'pyproject.toml' },
+    { cmd: 'cargo test', check: 'Cargo.toml' },
+    { cmd: 'go test ./...', check: 'go.mod' },
+  ];
+  for (const suite of possible) {
+    try {
+      if (existsSync(join(cwd, suite.check))) {
+        console.log(`  Running: ${suite.cmd}`);
+        execSync(suite.cmd, { stdio: 'inherit', timeout: 120000, cwd });
+        console.log('\n  ✓ Test gate passed\n');
+        return true;
+      }
+    } catch {
+      console.log(`\n  ✗ Test gate failed: ${suite.cmd}\n`);
+      process.exit(1);
+    }
+  }
+  console.log('  No test suite detected. Install one to use the test gate.\n');
+  return false;
+}
+
+// ── Main dispatcher ────────────────────────────────────────────────────────────
+
+export async function run(name, args, isHelpRequest) {
+  switch (name) {
+    case 'audit':
+      if (isHelpRequest) showAuditHelp();
+      else {
+        const { runAudit } = await import('../audit.mjs');
+        await runAudit();
+      }
+      break;
+
+    case 'init':
+      if (isHelpRequest) showInitHelp();
+      else {
+        const { runInit } = await import('../init.mjs');
+        await runInit(process.cwd());
+      }
+      break;
+
+    case 'export':
+      if (isHelpRequest) showExportHelp();
+      else {
+        const { runExport } = await import('../export.mjs');
+        const targetFlag = args.includes('--target') ? args[args.indexOf('--target') + 1] : null;
+        await runExport(targetFlag);
+      }
+      break;
+
+    case 'test-gate':
+      if (isHelpRequest) showTestGateHelp();
+      else await runTestGate();
+      break;
+
+    case 'dev-link':
+      if (isHelpRequest) showDevLinkHelp();
+      else {
+        const { createDevLink } = await import('../dev-link.mjs');
+        const positional = args.filter((a) => !a.startsWith('-'));
+        const flags = args.filter((a) => a.startsWith('-'));
+        const sourceDir = positional[0] ?? null;
+        const force = flags.includes('--force') || flags.includes('-f');
+        const ok = createDevLink(sourceDir, { force });
+        if (!ok) process.exit(1);
+      }
+      break;
+
+    case 'dev-unlink':
+      if (isHelpRequest) showDevLinkHelp();
+      else {
+        const { removeDevLink } = await import('../dev-link.mjs');
+        const force = args.includes('--force') || args.includes('-f');
+        const ok = await removeDevLink({ force });
+        if (!ok) process.exit(1);
+      }
+      break;
+
+    case 'doctor':
+      if (isHelpRequest) showDoctorHelp();
+      else {
+        const { runDoctor } = await import('../doctor.mjs');
+        const wantJson = args.includes('--json');
+        const result = await runDoctor({ silent: wantJson, json: wantJson });
+        if (wantJson) process.stdout.write(JSON.stringify(result) + '\n');
+        if (result.failed > 0) process.exit(1);
+      }
+      break;
+
+    case 'repair':
+      if (isHelpRequest) showRepairHelp();
+      else {
+        const { runRepair } = await import('../repair.mjs');
+        const dryRun = args.includes('--dry-run');
+        const binOnly = args.includes('--bin-only');
+        const result = await runRepair({ dryRun, binOnly });
+        if (!result.ok) {
+          for (const n of result.notes) console.log(`  ${n}`);
+          process.exit(1);
+        }
+        for (const n of result.notes) console.log(`  ${n}`);
+        if (result.fixed.length > 0) {
+          console.log(chalk.green('\n  Repair complete. Re-run your shell or `hash -r` to pick up the new path.'));
+        }
+      }
+      break;
+
+    case 'heads-up':
+      if (isHelpRequest) {
+        console.log('  heads-up <subcommand>   Manage pre-push / pre-release heads-ups (list/check/archive)');
+      } else {
+        const { runHeadsUp } = await import('../heads-up.mjs');
+        await runHeadsUp(args[0], args.slice(1));
+      }
+      break;
+
+    case 'bg':
+      if (isHelpRequest) {
+        console.log('  bg <subcommand>   Manage background agents (list/view/kill/logs)');
+      } else {
+        const { runBg } = await import('../bg.mjs');
+        await runBg(args[0], args.slice(1));
+      }
+      break;
+
+    case 'browser-harness-up': {
+      const { execFileSync } = await import('node:child_process');
+      const sub = args[0] || 'start';
+      const __dirname = fileURLToPath(new URL('.', import.meta.url));
+      const scriptPath = join(__dirname, '..', 'browser-harness-up.sh');
+      try {
+        const out = execFileSync('bash', [scriptPath, sub], {
+          encoding: 'utf8',
+          stdio: 'inherit',
+        });
+        if (out) process.stdout.write(out);
+      } catch (err) {
+        console.error(chalk.red(`  ✗ browser-harness-up ${sub} failed (exit ${err.status ?? 1})`));
+        process.exit(err.status || 1);
+      }
+      break;
+    }
+
+    case 'providers':
+      if (args[0] === 'detect') {
+        const { runProvidersDetect } = await import('../providers-detect.mjs');
+        await runProvidersDetect(args.slice(1));
+      }
+      break;
+
+    case 'plan':
+      // Alias for artifact
+      if (isHelpRequest) {
+        const { showHelp } = await import('../artifact-cli.mjs');
+        showHelp();
+      } else {
+        const { runArtifact } = await import('../artifact-cli.mjs');
+        await runArtifact(args, {});
+      }
+      break;
+
+    default:
+      return false;
+  }
+  return true;
+}

package/cli/doctor.mjs

@@ -21,9 +21,8 @@
 import chalk from 'chalk';
 import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { opencodeConfigDir, opencodeAgentsDir } from './utils.mjs';
+import { opencodeConfigDir, opencodeAgentsDir, which, bizarConfigDir } from './utils.mjs';
 
 // v3.20.11: list every agent the install script is expected to deploy.
 // Adding a new agent to `config/agents/` without adding it here causes
@@ -50,12 +49,6 @@ const REQUIRED_AGENTS = [
 
 // ── helpers ─────────────────────────────────────────────────────────────────
 
-function bizarConfigDir() {
-  return process.env.XDG_CONFIG_HOME
-    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
-    : join(homedir(), '.config', 'bizar');
-}
-
 /**
  * Run a check function and capture its result. The check either
  * returns a string message (pass) or throws an Error (fail).
@@ -73,11 +66,6 @@ async function runCheck(name, fn) {
   }
 }
 
-function which(cmd) {
-  const probe = spawnSync('which', [cmd], { stdio: 'ignore' });
-  return probe.status === 0;
-}
-
 // ── individual checks ───────────────────────────────────────────────────────
 
 async function checkOpencodeReachable() {

package/cli/provision.mjs

@@ -42,9 +42,11 @@ import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync, mkdirSync
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { bizarConfigDir } from './utils.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+const HOME = homedir();
 
 // `cli/provision.mjs` lives at `<pkg>/cli/provision.mjs`. The repo root
 // (where `plugins/bizar/`, `bizar-dash/`, `package.json` etc. live) is
@@ -53,19 +55,6 @@ const __dirname = dirname(__filename);
 export const REPO_ROOT = join(__dirname, '..');
 export const PKG_MAIN = '@polderlabs/bizar';
 
-const HOME = homedir();
-
-function bizarConfigDir() {
-  if (process.platform === 'win32') {
-    return process.env.APPDATA
-      ? join(process.env.APPDATA, 'bizar')
-      : join(HOME, '.config', 'bizar');
-  }
-  return process.env.XDG_CONFIG_HOME
-    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
-    : join(HOME, '.config', 'bizar');
-}
-
 export const BIZAR_HOME = bizarConfigDir();
 export const OPENCODE_DIR =
   process.platform === 'win32'

package/cli/service-controller.mjs

@@ -39,6 +39,7 @@ import {
 import { homedir, platform } from 'node:os';
 import { join, dirname, resolve, isAbsolute } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { bizarConfigDir } from './utils.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -47,17 +48,6 @@ const PLATFORM = platform();
 
 // ── Path helpers ──────────────────────────────────────────────────────────────
 
-function bizarConfigDir() {
-  if (PLATFORM === 'win32') {
-    return process.env.APPDATA
-      ? join(process.env.APPDATA, 'bizar')
-      : join(HOME, '.config', 'bizar');
-  }
-  return process.env.XDG_CONFIG_HOME
-    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
-    : join(HOME, '.config', 'bizar');
-}
-
 function userUnitDir() {
   if (PLATFORM === 'win32') return null;
   return process.env.XDG_CONFIG_HOME

package/cli/service.mjs

@@ -35,22 +35,12 @@ import { join, dirname, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
+import { bizarConfigDir } from './utils.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const HOME = homedir();
 
-function bizarConfigDir() {
-  if (process.platform === 'win32') {
-    return process.env.APPDATA
-      ? join(process.env.APPDATA, 'bizar')
-      : join(HOME, '.config', 'bizar');
-  }
-  return process.env.XDG_CONFIG_HOME
-    ? join(process.env.XDG_CONFIG_HOME, 'bizar')
-    : join(HOME, '.config', 'bizar');
-}
-
 const BIZAR_HOME = bizarConfigDir();
 const LOG_FILE = join(BIZAR_HOME, 'service.log');
 const PID_FILE = join(BIZAR_HOME, 'service.pid');

package/cli/utils.mjs

@@ -1,8 +1,9 @@
 import { access, constants, readFile } from 'node:fs/promises';
-import { spawnSync } from 'node:child_process';
+import { spawnSync, execFileSync } from 'node:child_process';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { existsSync, readFileSync } from 'node:fs';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 const REPO_ROOT = join(__dirname, '..');
@@ -153,3 +154,42 @@ export function buildSummary(components, agents, target, skillPacks = []) {
     parts,
   };
 }
+
+// ── Path helpers ─────────────────────────────────────────────────────────────────
+
+/**
+ * Return the platform-specific Bizar config directory.
+ * Windows: %APPDATA%\bizar
+ * Unix: $XDG_CONFIG_HOME/bizar (default: ~/.config/bizar)
+ */
+export function bizarConfigDir() {
+  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');
+}
+
+/**
+ * Check if a command exists on PATH.
+ * Returns true if found, false otherwise.
+ */
+export function which(cmd) {
+  const probe = spawnSync('which', [cmd], { stdio: 'ignore' });
+  return probe.status === 0;
+}
+
+/**
+ * Check if a command exists on PATH (bg.mjs variant that returns the path or null).
+ */
+export function whichPath(cmd) {
+  try {
+    const out = execFileSync('which', [cmd], { encoding: 'utf8' });
+    return out.trim() || null;
+  } catch {
+    return null;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "4.5.2",
+  "version": "4.7.0",
   "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": {
@@ -21,6 +21,7 @@
     "build:sdk": "tsc -p packages/sdk/tsconfig.json",
     "build:dash": "vite build",
     "test:sdk": "node_modules/.bin/vitest run --root packages/sdk",
+    "test:web": "cd bizar-dash && npx vitest run",
     "test:sdk:watch": "node_modules/.bin/vitest --root packages/sdk",
     "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/opencode-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/opencode-sessions-detail.test.mjs bizar-dash/tests/opencode-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs bizar-dash/tests/memory-cli-readlistdelete.test.mjs bizar-dash/tests/memory-cli-setup.test.mjs bizar-dash/tests/memory-conflicts.test.mjs bizar-dash/tests/memory-namespace.test.mjs bizar-dash/tests/memory-path-safety.test.mjs bizar-dash/tests/memory-protocol-drift.test.mjs bizar-dash/tests/memory-roundtrip.test.mjs bizar-dash/tests/cli-bugfixes.test.mjs bizar-dash/tests/server-bugfixes.test.mjs bizar-dash/tests/frontend-bugfixes.test.mjs",
     "build": "npm run build:sdk && npm run build:dash",
@@ -77,12 +78,16 @@
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.17.7",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
     "@types/better-sqlite3": "^7.6.13",
     "@types/bun": "latest",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.0",
+    "jsdom": "^25.0.1",
     "typescript": "^5.6.0",
     "vite": "^5.0.0",
     "vitest": "^4.1.9"