@polderlabs/bizar 2.6.0 → 3.0.0

package/cli/bin.mjs

@@ -1,8 +1,25 @@
 #!/usr/bin/env node
-
-import chalk from 'chalk';
+/**
+ * cli/bin.mjs
+ *
+ * v3.0.0 — `bizar` runtime CLI.
+ *
+ * Architecture:
+ *   - `bizar` is the core runtime + installer + audit/init/export/update/plan
+ *     + service commands.
+ *   - The dashboard lives in a separate package, `@polderlabs/bizar-dash`.
+ *     If it's installed, `bizar dashboard` / `bizar --web*` will defer to it.
+ *     If not, the user is told to install it.
+ *
+ * Subcommands (unchanged from v2.7.0):
+ *   install, audit, init, export, plan, update, test-gate, service
+ *
+ * Flags (unchanged):
+ *   --web / --no-web / --web-only / --bg / --detach
+ */
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+import chalk from 'chalk';
 import { runInstaller, runPostInstall } from './install.mjs';
 import { runAudit } from './audit.mjs';
 import { runInit } from './init.mjs';
@@ -17,20 +34,33 @@ function showHelp() {
   Bizar — Norse Pantheon Agent System for opencode
 
   Usage:
-    bizar                       Run interactive installer
+    bizar                       Launch the TUI dashboard (default)
+    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)
+    bizar --bg, --detach        Launch web dashboard in background, return to shell
+    install                     Run the interactive installer
+    bizar install               Same as \`install\`
     bizar audit                 Run security audit on agent configuration
     bizar init                  Initialize .bizar/ in current project
-    bizar export [target]       Export agents/rules to another harness (claude|cursor|opencode)
-    bizar plan <subcommand>     Manage visual plans (new, open, list, delete, export, templates)
+    bizar export [target]       Export agents/rules to another harness
+    bizar plan <subcommand>     Manage visual plans
     bizar test-gate             Detect & run the project's test suite
     bizar update                Update opencode, bizar, and/or bizar-plugin
-    bizar dashboard [start|stop|status]  Launch or control the web dashboard (v2.5.0+)
+    bizar service               Manage the background service daemon
+    bizar dashboard             Launch the web dashboard (uses bizar-dash)
     bizar --help                Show this help
 
   Install:
-    npm install -g @polderlabs/bizar          Install globally, then run 'bizar'
-    npm install -g @polderlabs/bizar-plugin   Install the Bizar opencode plugin
-    npx @polderlabs/bizar                     Run without installing
+    npm install -g @polderlabs/bizar          Install globally
+    npm install -g @polderlabs/bizar-dash     Optional companion dashboard
+    npm install -g @polderlabs/bizar-plugin   Bizar opencode plugin
+
+  Notes:
+    The TUI is the default command — press 1-8 for tabs, q to quit.
+    \`bizar --bg\` launches the dashboard detached; \`bizar dashboard stop\`
+    terminates it. The web dashboard lives in the \`@polderlabs/bizar-dash\`
+    package — if it's not installed, you'll be prompted to install it.
   `);
 }
 
@@ -40,157 +70,131 @@ function showAuditHelp() {
 
   Usage:
     bizar audit
-
-  Description:
-    Scans opencode agent definitions for security issues:
-    - Agents with read/edit/bash permission conflicts
-    - Agents lacking mode or model definitions
-    - Suspicious tool access patterns
   `);
 }
 
 function showInitHelp() {
   console.log(`
   bizar init — Initialize .bizar/ in current project
-
-  Usage:
-    bizar init
-
-  Description:
-    Creates a .bizar/ directory in the current project with:
-    - PROJECT.md (living project description)
-    - AGENTS_SELF_IMPROVEMENT.md (lesson log)
   `);
 }
 
 function showExportHelp() {
   console.log(`
   bizar export — Export agents/rules to another harness
-
-  Usage:
-    bizar export --target <harness>
-
-  Targets:
-    claude     Export to Claude Code format
-    cursor     Export to Cursor format
-    opencode   Export to OpenCode format (default)
-
-  Description:
-    Converts Bizar agent definitions and rules
-    to the target harness's native format.
   `);
 }
 
 function showTestGateHelp() {
   console.log(`
   bizar test-gate — Detect & run the project's test suite
+  `);
+}
+
+function showServiceHelp() {
+  console.log(`
+  bizar service — Manage the background service daemon
 
   Usage:
-    bizar test-gate
+    bizar service start        Start the service in background
+    bizar service stop         Stop the running service
+    bizar service status       Show whether the service is running
+    bizar service logs         Tail the service log
 
   Description:
-    Auto-detects the project's test framework (npm test, pytest,
-    cargo test, go test) and runs it. Exits with non-zero on failure.
+    The service watches per-project schedules (cron / interval / once)
+    and runs them at the right time. It logs to
+    ~/.config/bizar/service.log and writes its PID to
+    ~/.config/bizar/service.pid.
   `);
 }
 
 function showDashboardHelp() {
   console.log(`
-  bizar dashboard — Launch or control the Bizar web dashboard
+  bizar dashboard — Launch the web dashboard (uses @polderlabs/bizar-dash)
 
   Usage:
-    bizar dashboard             Start the dashboard (default action = start)
-    bizar dashboard start       Start the dashboard in the current process
-    bizar dashboard stop        Kill the running dashboard (reads PID file)
-    bizar dashboard status      Print port + URL of any running dashboard
+    bizar dashboard             Start the dashboard
+    bizar dashboard start       Same
+    bizar dashboard stop        Kill the running dashboard
+    bizar dashboard status      Show port + URL
 
   Description:
-    Starts a local Express + WebSocket server on 127.0.0.1, opens the
-    user's default browser to the dashboard URL, and broadcasts live
-    file-change events from config/, agents/, commands-bizar/, .bizar/,
-    and plans/. The server binds loopback only — never expose it.
+    The dashboard lives in a separate package. If it's not installed,
+    you'll see an install hint pointing at @polderlabs/bizar-dash.
   `);
 }
 
-async function runDashboard(action) {
-  const sub = action || 'start';
-  const { launchDashboard, PORT_FILE, PID_FILE } = await import('./dashboard.mjs');
-  const { existsSync, readFileSync, unlinkSync } = await import('node:fs');
-
-  if (sub === 'status') {
-    if (existsSync(PORT_FILE)) {
-      const port = readFileSync(PORT_FILE, 'utf8').trim();
-      console.log(`Bizar dashboard is running at http://localhost:${port}/`);
-      if (existsSync(PID_FILE)) {
-        console.log(`PID: ${readFileSync(PID_FILE, 'utf8').trim()}`);
-      }
-    } else {
-      console.log('No Bizar dashboard is running. Use: bizar dashboard start');
-    }
-    return;
-  }
-
-  if (sub === 'stop') {
-    if (!existsSync(PID_FILE)) {
-      console.log('No Bizar dashboard is running.');
-      return;
-    }
-    const pid = parseInt(readFileSync(PID_FILE, 'utf8').trim(), 10);
-    if (!Number.isFinite(pid)) {
-      console.log(`Bad PID file: ${PID_FILE}`);
-      return;
-    }
-    try {
-      process.kill(pid, 'SIGTERM');
-      console.log(`Stopped Bizar dashboard (pid ${pid}).`);
-    } catch (err) {
-      console.log(`Could not stop dashboard (pid ${pid}): ${err.message}`);
-    }
-    try { unlinkSync(PORT_FILE); } catch { /* ignore */ }
-    try { unlinkSync(PID_FILE); } catch { /* ignore */ }
-    return;
+/**
+ * Detect whether @polderlabs/bizar-dash is installed locally.
+ * We probe the global npm root, but also look in the local node_modules
+ * of the bizar package itself.
+ */
+async function findBizarDash() {
+  const { execSync } = await import('node:child_process');
+  try {
+    const root = execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+    const dashPath = join(root, '@polderlabs', 'bizar-dash', 'src', 'cli.mjs');
+    if (existsSync(dashPath)) return dashPath;
+  } catch {
+    /* fall through */
   }
+  // Local fallback — node_modules of this package
+  const here = new URL('..', import.meta.url);
+  const localPath = join(here.pathname, '..', 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs');
+  if (existsSync(localPath)) return localPath;
+  return null;
+}
 
-  if (sub !== 'start') {
-    showDashboardHelp();
+/**
+ * Delegate a subcommand to the bizar-dash CLI, if installed.
+ */
+async function delegateToDash(argsForDash) {
+  const dashPath = await findBizarDash();
+  if (!dashPath) {
+    console.log('The Bizar dashboard lives in a separate package.');
+    console.log('Install it with:');
+    console.log(chalk.cyan('  npm install -g @polderlabs/bizar-dash'));
     return;
   }
-
-  // Start — keep the process alive so the server stays up
-  await launchDashboard();
-  console.log(chalk.dim('  Press Ctrl-C to stop the dashboard.'));
-  // Wait forever; SIGINT will exit the process.
-  await new Promise(() => {});
+  const { spawn } = await import('node:child_process');
+  const child = spawn(process.execPath, [dashPath, ...argsForDash], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env,
+  });
+  await new Promise((resolve, reject) => {
+    child.on('exit', (code) => (code === 0 ? resolve() : reject(new Error(`exit ${code}`))));
+    child.on('error', reject);
+  });
 }
 
-function showUpdateHelp() {
-  console.log(`
-  bizar update — Update opencode, bizar, and/or bizar-plugin
-
-  Usage:
-    bizar update                Interactive: ask which components to update
-    bizar update --all          Update everything non-interactively
-    bizar update opencode       Update only opencode
-    bizar update bizar          Update only the bizar CLI package
-    bizar update plugin         Update only the @polderlabs/bizar-plugin package
-
-  Description:
-    By default, prompts for each component (opencode, @polderlabs/bizar,
-    @polderlabs/bizar-plugin) before running its update. With --all, runs
-    every update without prompting. With explicit subcommands, runs only
-    the named update.
+function parseFlag(name) {
+  const idx = args.indexOf(name);
+  if (idx === -1) return null;
+  return args[idx + 1] || null;
+}
 
-    "opencode" here means the underlying opencode CLI on $PATH — the
-    update uses the opencode installer's own update command.
-    "@polderlabs/bizar" and "@polderlabs/bizar-plugin" are updated via
-    'npm install -g <pkg>@latest'.
-  `);
+async function readAutoLaunchWeb() {
+  try {
+    const fs = await import('node:fs');
+    const os = await import('node:os');
+    const path = await import('node:path');
+    const file = path.join(os.homedir(), '.config', 'bizar', 'settings.json');
+    if (!fs.existsSync(file)) return true;
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (parsed && parsed.dashboard && typeof parsed.dashboard.autoLaunchWeb === 'boolean') {
+      return parsed.dashboard.autoLaunchWeb;
+    }
+  } catch {
+    /* fall through */
+  }
+  return true;
 }
 
 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' },
@@ -198,7 +202,6 @@ async function runTestGate() {
     { cmd: 'cargo test', check: 'Cargo.toml' },
     { cmd: 'go test ./...', check: 'go.mod' },
   ];
-
   for (const suite of possible) {
     try {
       if (existsSync(join(cwd, suite.check))) {
@@ -212,18 +215,21 @@ async function runTestGate() {
       process.exit(1);
     }
   }
-
   console.log('  No test suite detected. Install one to use the test gate.\n');
   return false;
 }
 
-function parseFlag(name) {
-  const idx = args.indexOf(name);
-  if (idx === -1) return null;
-  return args[idx + 1] || null;
+/**
+ * Service commands — start / stop / status / logs.
+ *
+ * Implementation lives in cli/service.mjs (created below).
+ */
+async function runServiceCommand(sub) {
+  const { runService } = await import('./service.mjs');
+  await runService(sub || 'status', args.slice(2));
 }
 
-if (args.includes('--postinstall')) {
+if (args[0] === '--postinstall') {
   await runPostInstall();
 } else if (args[0] === 'audit') {
   if (args.includes('--help') || args.includes('-h')) showAuditHelp();
@@ -233,27 +239,49 @@ if (args.includes('--postinstall')) {
   else await runInit(process.cwd());
 } else if (args[0] === 'export') {
   if (args.includes('--help') || args.includes('-h')) showExportHelp();
-  else {
-    const target = parseFlag('--target');
-    await runExport(target);
-  }
+  else await runExport(parseFlag('--target'));
 } else if (args[0] === 'test-gate') {
   if (args.includes('--help') || args.includes('-h')) showTestGateHelp();
   else await runTestGate();
 } else if (args[0] === 'update') {
   if (args.includes('--help') || args.includes('-h')) {
-    showUpdateHelp();
+    console.log('Run bizar update [opencode|bizar|plugin]');
   } else {
     await runUpdate(args.slice(1));
   }
 } else if (args[0] === 'plan') {
-  const planArgs = args.slice(1);
-  await runPlan(planArgs, {});
+  await runPlan(args.slice(1), {});
+} else if (args[0] === 'install') {
+  await runInstaller();
+} else if (args[0] === 'service') {
+  if (args.includes('--help') || args.includes('-h')) showServiceHelp();
+  else await runServiceCommand(args[1]);
 } else if (args[0] === 'dashboard') {
   if (args.includes('--help') || args.includes('-h')) showDashboardHelp();
-  else await runDashboard(args[1]);
+  else await delegateToDash(args.slice(1));
+} else if (args.includes('--bg') || args.includes('--detach')) {
+  // Delegate to bizarre-dash
+  await delegateToDash(['--bg']);
+} else if (args.includes('--web-only')) {
+  await delegateToDash(['--web-only']);
 } else if (args.includes('--help') || args.includes('-h')) {
   showHelp();
 } else {
-  await runInstaller();
+  // Default: launch the TUI dashboard. The TUI lives in bizar-dash.
+  // We try to use the bizar-dash package's TUI, but we also support a
+  // bundled fallback that imports from this package's local copy.
+  const dashPath = await findBizarDash();
+  if (dashPath) {
+    const skipWeb = args.includes('--no-web');
+    const forceWeb = args.includes('--web');
+    const settingAuto = await readAutoLaunchWeb();
+    const launchWeb = !skipWeb && (forceWeb || settingAuto);
+    await delegateToDash(['tui', ...(launchWeb ? [] : ['--no-web'])]);
+  } else {
+    console.log('The Bizar dashboard is in a separate package:');
+    console.log(chalk.cyan('  npm install -g @polderlabs/bizar-dash'));
+    console.log('');
+    console.log('Or run the installer to set up everything:');
+    console.log(chalk.cyan('  npx -y @polderlabs/bizar install'));
+  }
 }

package/cli/copy.mjs

@@ -272,48 +272,53 @@ export async function installPluginBizar(projectRoot) {
     // 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.
+    spinner.info(chalk.dim('  ℹ No local plugins/bizar/ — using @polderlabs/bizar-plugin from npm'));
     return { copied: 0, errors: [] };
   }
 
-  const destDir = join(projectRoot, '.opencode', 'plugins', 'bizar');
-  await mkdir(destDir, { recursive: true });
-
-  // Exclude patterns per spec §9.2
-  const isExcluded = (entry) => {
-    const parts = entry.split('/');
-    return parts.some(part =>
-      part === 'node_modules' ||
-      part === 'dist' ||
-      part === '.DS_Store' ||
-      part.endsWith('.log')
-    );
-  };
+  try {
+    const destDir = join(projectRoot, '.opencode', 'plugins', 'bizar');
+    await mkdir(destDir, { recursive: true });
+
+    // Exclude patterns per spec §9.2
+    const isExcluded = (entry) => {
+      const parts = entry.split('/');
+      return parts.some(part =>
+        part === 'node_modules' ||
+        part === 'dist' ||
+        part === '.DS_Store' ||
+        part.endsWith('.log')
+      );
+    };
 
-  const files = await readdirRecursive(srcDir);
-  const errors = [];
-  let copied = 0;
+    const files = await readdirRecursive(srcDir);
+    const errors = [];
+    let copied = 0;
 
-  for (const file of files) {
-    if (isExcluded(file)) continue;
-    const src = join(srcDir, file);
-    const dst = join(destDir, file);
-    const dstParent = dirname(dst);
-    try {
-      await mkdir(dstParent, { recursive: true });
-      await copyFile(src, dst);
-      copied++;
-    } catch (err) {
-      errors.push(`Failed to copy ${file}: ${err.message}`);
+    for (const file of files) {
+      if (isExcluded(file)) continue;
+      const src = join(srcDir, file);
+      const dst = join(destDir, file);
+      const dstParent = dirname(dst);
+      try {
+        await mkdir(dstParent, { recursive: true });
+        await copyFile(src, dst);
+        copied++;
+      } catch (err) {
+        errors.push(`Failed to copy ${file}: ${err.message}`);
+      }
     }
-  }
 
-  if (errors.length === 0) {
-    spinner.succeed(chalk.green(`Installed Bizar plugin (${copied} files)`));
-  } else {
-    spinner.warn(chalk.yellow(`Installed Bizar plugin (${copied} files, ${errors.length} errors)`));
+    if (errors.length === 0) {
+      spinner.succeed(chalk.green(`Installed Bizar plugin (${copied} files)`));
+    } else {
+      spinner.warn(chalk.yellow(`Installed Bizar plugin (${copied} files, ${errors.length} errors)`));
+    }
+    return { copied, errors };
+  } catch (err) {
+    spinner.fail(chalk.red(`Failed to install Bizar plugin: ${err.message}`));
+    return { copied: 0, errors: [err.message] };
   }
-  return { copied, errors };
 }
 
 export async function installRtk() {