@polderlabs/bizar 3.23.1 → 4.2.0

package/cli/atomic.mjs

@@ -0,0 +1,73 @@
+/**
+ * src/server/atomic.mjs
+ *
+ * Atomic file I/O utilities for the Bizar Memory Service. Uses the
+ * proven tmp+rename pattern to ensure files are either fully written or
+ * not written at all (no partial writes on crash).
+ *
+ * tmp files use `process.ppid + process.pid` to avoid collisions when
+ * multiple processes race on the same file.
+ */
+
+import { writeFileSync, renameSync, existsSync, readFileSync } from 'node:fs';
+
+/**
+ * Atomically write a JSON file. Write to a temp file then rename over
+ * the target so readers never see a partially-written document.
+ *
+ * @param {string} filePath
+ * @param {unknown} data — will be JSON-stringified with 2-space indent
+ */
+export function atomicWriteJson(filePath, data) {
+  const tmp = `${filePath}.tmp.${process.ppid}+${process.pid}`;
+  writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf8');
+  renameSync(tmp, filePath);
+}
+
+/**
+ * Atomically write a text file.
+ *
+ * @param {string} filePath
+ * @param {string} text
+ */
+export function atomicWriteText(filePath, text) {
+  const tmp = `${filePath}.tmp.${process.ppid}+${process.pid}`;
+  writeFileSync(tmp, text, 'utf8');
+  renameSync(tmp, filePath);
+}
+
+/**
+ * Safe JSON read. Returns `fallback` on any error (missing file,
+ * empty file, malformed JSON, permission error).
+ *
+ * @template T
+ * @param {string} filePath
+ * @param {T} [fallback=null]
+ * @returns {T}
+ */
+export function safeReadJSON(filePath, fallback = null) {
+  try {
+    if (!existsSync(filePath)) return fallback;
+    const text = readFileSync(filePath, 'utf8');
+    if (!text.trim()) return fallback;
+    return JSON.parse(text);
+  } catch {
+    return fallback;
+  }
+}
+
+/**
+ * Safe text read. Returns `fallback` on any error.
+ *
+ * @param {string} filePath
+ * @param {string} [fallback='']
+ * @returns {string}
+ */
+export function safeReadText(filePath, fallback = '') {
+  try {
+    if (!existsSync(filePath)) return fallback;
+    return readFileSync(filePath, 'utf8');
+  } catch {
+    return fallback;
+  }
+}

package/cli/banner.mjs

@@ -25,7 +25,7 @@ export function showBanner() {
   console.log(chalk.hex('#6366f1').bold(RUNE_HELM));
   console.log(chalk.hex('#a855f7')('    Norse Pantheon Agent System for opencode'));
   console.log();
-  console.log(chalk.dim('    13 agents · 4 cost tiers · Obsidian vault long-term memory · RTK · Semble · Skills CLI · Mods'));
+  console.log(chalk.dim('    13 agents · 4 cost tiers · Obsidian vault long-term memory · Headroom · Semble · Skills CLI · Mods'));
   console.log();
 }
 

package/cli/bin.mjs

@@ -86,6 +86,7 @@ function showHelp() {
     update              Auto-update everything (opencode + bizar + dash + plugin)
     service             Manage the background service daemon
     bg <subcommand>     Manage background agents (list/view/kill/logs)
+    memory <subcommand> Manage project memory (Bizar Memory Service)
     dash <subcommand>   Manage the dashboard (start/stop/status/cleanup/tui)
     browser-harness-up  Start Chromium for browser-harness (start/stop/status/restart)
     dev-link [src]      Symlink the local plugin source into opencode's plugin dir
@@ -271,7 +272,7 @@ function showDoctorHelp() {
       • plugin path resolves
       • @polderlabs/bizar-plugin is installed globally
       • core agent files are installed (odin, quick, thor, tyr)
-      • rtk / semble / skills on PATH (lenient — at least one)
+      • headroom / semble / skills on PATH (lenient — at least one)
       • dashboard reachable (skipped if no port file)
       • provider.minimax block + MiniMax model flags are sane
 
@@ -487,12 +488,26 @@ function showDashHelp() {
   `);
 }
 
+function showMemoryHelp() {
+  console.log(`
+  memory <subcommand>   Manage project memory (local-only or Git-shared Obsidian vault)
+                        Subcommands: init, setup, status, link, unlink, write, pull, commit,
+                        push, sync, reindex, conflicts, doctor
+  `);
+}
+
 /**
- * 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.
+ * Detect whether the dashboard CLI is available.
+ * v4.0.0: primary path is the relative one (dashboard ships inside the
+ * same package at bizar-dash/src/cli.mjs). A global-npm fallback is
+ * kept for legacy users who still have @polderlabs/bizar-dash installed.
  */
 async function findBizarDash() {
+  // v4.0.0 — primary: relative import inside the same package
+  const primaryPath = join(import.meta.dirname, '..', 'bizar-dash', 'src', 'cli.mjs');
+  if (existsSync(primaryPath)) return primaryPath;
+
+  // Legacy fallback: global npm install of @polderlabs/bizar-dash
   const { execSync } = await import('node:child_process');
   try {
     const root = execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
@@ -513,9 +528,9 @@ async function findBizarDash() {
 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'));
+    console.log('The Bizar dashboard is part of this package.');
+    console.log('If you see this error, the install may be corrupted.');
+    console.log('Please report at: github.com/DrB0rk/BizarHarness/issues');
     return;
   }
   const { spawn } = await import('node:child_process');
@@ -627,6 +642,12 @@ async function main() {
   } else if (args[0] === 'init') {
     if (isHelpRequest) showInitHelp();
     else await runInit(process.cwd());
+  } else if (args[0] === 'memory') {
+    if (isHelpRequest && !args[1]) showMemoryHelp();
+    else {
+      const { runMemory } = await import('./memory.mjs');
+      await runMemory(args[1], args.slice(2));
+    }
   } else if (args[0] === 'export') {
     if (isHelpRequest) showExportHelp();
     else await runExport(parseFlag('--target'));
@@ -750,48 +771,25 @@ function parseDashOpts(dashArgs) {
 
 /**
  * Try to load the dashboard CLI module.
- * Try 1: import via the package exports map (@polderlabs/bizar-dash/dash-cli)
- * Try 2: file path probing for older installs or dev trees
+ * v4.0.0: the dashboard ships inside this package at bizar-dash/src/cli.mjs.
+ * A legacy npm-global fallback is kept for the transitional period.
  */
 async function loadDashCli() {
-  // Try 1: import via exports map (requires Tyr's package.json changes)
-  try {
-    const mod = await import('@polderlabs/bizar-dash/dash-cli');
-    return mod;
-  } catch (_e) {
-    // fall through to file probing
-  }
-
-  // Try 2: dynamic npm root -g (most reliable for global installs)
-  try {
-    const { execFileSync } = await import('node:child_process');
-    const { pathToFileURL } = await import('node:url');
-    const { join } = await import('node:path');
-    const npmRoot = execFileSync('npm', ['root', '-g'], { encoding: 'utf8', timeout: 5000 }).trim();
-    if (npmRoot) {
-      const cliPath = join(npmRoot, '@polderlabs', 'bizar-dash', 'src', 'cli.mjs');
-      const mod = await import(pathToFileURL(cliPath).href);
-      return mod;
-    }
-  } catch (_e) {
-    /* fall through */
-  }
-
-  // Try 3: file path probing
-  const { join } = await import('node:path');
-  const { homedir } = await import('node:os');
+  // v4.0.0 — primary: relative import inside the same package
+  const { pathToFileURL } = await import('node:url');
   const candidates = [
-    // npm global install
-    join(homedir(), '.npm-global', 'lib', 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
-    // nvm
-    join(homedir(), '.nvm', 'versions', 'node'),
-    // relative to current process
-    join(process.execPath, '..', '..', 'lib', 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
-    // local node_modules
-    join(process.cwd(), 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
+    join(import.meta.dirname, '..', 'bizar-dash', 'src', 'cli.mjs'),
+    // Legacy fallbacks for users with @polderlabs/bizar-dash still installed:
+    ...(async () => {
+      const { execFileSync } = await import('node:child_process');
+      try {
+        const npmRoot = execFileSync('npm', ['root', '-g'], { encoding: 'utf8', timeout: 5000 }).trim();
+        if (npmRoot) return [join(npmRoot, '@polderlabs', 'bizar-dash', 'src', 'cli.mjs')];
+      } catch { /* ignore */ }
+      return [];
+    })(),
   ];
 
-  const { pathToFileURL } = await import('node:url');
   for (const p of candidates) {
     try {
       const url = pathToFileURL(p).href;
@@ -815,9 +813,8 @@ async function runDash(dashArgs) {
 
   const dashModule = await loadDashCli();
   if (!dashModule) {
-    console.error(chalk.red('  ✗ Dashboard not installed.'));
-    console.error(chalk.dim('  Run: npm install -g @polderlabs/bizar-dash'));
-    console.error(chalk.dim('  Or: npx -y @polderlabs/bizar install'));
+    console.error(chalk.red('  ✗ Dashboard not found.'));
+    console.error(chalk.dim('  this should not happen — please report a bug at github.com/DrB0rk/BizarHarness/issues'));
     process.exit(1);
   }
 

package/cli/bootstrap.mjs

@@ -49,7 +49,7 @@ export function checkSetupStatus() {
  */
 function printSetupBanner() {
   // Use console.log directly to avoid chalk formatting issues in non-TTY
-  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, RTK, Semble, Skills CLI...\n');
+  console.log('\n  ⚡ First-time setup — Bizar needs to install agents, plugin, Headroom, Semble, Skills CLI...\n');
 }
 
 /**

package/cli/copy.mjs

@@ -289,6 +289,9 @@ 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/.
+    // TODO (forward-compat): when plugins/bizar + bizar-dash + packages/sdk are
+    // collapsed into one package, the plugin entry point will be
+    // src/plugin/index.ts and the copy source should be updated here.
     spinner.info(chalk.dim('  ℹ No local plugins/bizar/ — using @polderlabs/bizar-plugin from npm'));
     return { copied: 0, errors: [] };
   }
@@ -338,43 +341,49 @@ export async function installPluginBizar(projectRoot) {
   }
 }
 
-export async function installRtk() {
+export async function installHeadroom() {
   const { execSync } = await import('node:child_process');
 
   const already = await detectRtk();
   if (already) {
-    const spinner = ora({ text: 'Configuring RTK for opencode...', color: 'magenta' }).start();
+    const spinner = ora({ text: 'Configuring Headroom for opencode...', color: 'magenta' }).start();
     try {
-      execSync('rtk init -g --opencode', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('RTK configured for opencode'));
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      spinner.succeed(chalk.green('Headroom configured for opencode'));
     } catch {
-      spinner.warn(chalk.yellow('Could not auto-configure RTK — run `rtk init -g --opencode` manually'));
+      spinner.warn(chalk.yellow('Could not auto-configure Headroom — run `headroom wrap opencode` manually'));
     }
     return true;
   }
 
-  const spinner = ora({ text: 'Installing RTK (Rust Token Killer)...', color: 'magenta' }).start();
+  const spinner = ora({ text: 'Installing Headroom (context compressor)...', color: 'magenta' }).start();
 
   if (process.platform === 'win32') {
-    // RTK ships a bash-only installer; no PowerShell equivalent. On
-    // Windows the user must install RTK manually (e.g. via Cargo or
-    // prebuilt binary) and re-run `rtk init -g --opencode`.
-    spinner.fail(chalk.red('Automatic RTK install not supported on Windows. Install manually from https://github.com/rtk-ai/rtk'));
+    spinner.fail(chalk.red('Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"'));
     return false;
   }
 
   try {
     execSync(
-      'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
+      'pip install --user "headroom-ai[all]"',
       { stdio: 'pipe', timeout: 60000 },
     );
-    spinner.text = 'Configuring RTK for opencode...';
-    execSync('rtk init -g --opencode', { stdio: 'pipe' });
-    spinner.succeed(chalk.green('RTK installed and configured for opencode'));
+    spinner.text = 'Configuring Headroom for opencode...';
+    execSync('headroom wrap opencode', { stdio: 'pipe' });
+    spinner.succeed(chalk.green('Headroom installed and configured for opencode'));
     return true;
   } catch {
-    spinner.fail(chalk.red('RTK install failed. Install manually from https://github.com/rtk-ai/rtk'));
-    return false;
+    // Fall back to npm
+    try {
+      execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
+      spinner.text = 'Configuring Headroom for opencode...';
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      spinner.succeed(chalk.green('Headroom installed (npm) and configured for opencode'));
+      return true;
+    } catch {
+      spinner.fail(chalk.red('Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai'));
+      return false;
+    }
   }
 }
 

package/cli/dev-link.mjs

@@ -51,7 +51,23 @@ function pluginDest() {
  * Returns true on success, false on refusal.
  */
 export function createDevLink(sourceDir = null, opts = {}) {
-  const resolvedSource = resolve(process.cwd(), sourceDir ?? 'plugins/bizar');
+  const defaultSource = 'plugins/bizar';
+  const resolvedSource = resolve(process.cwd(), sourceDir ?? defaultSource);
+
+  // Forward-compatibility: if the legacy path doesn't exist, fall back to the
+  // collapsed layout (plugins/bizar + bizar-dash + sdk collapsed into one pkg).
+  // When that restructure ships, the plugin entry point will be src/plugin/index.ts.
+  if (!existsSync(resolvedSource)) {
+    const collapsedSource = resolve(process.cwd(), 'src', 'plugin', 'index.ts');
+    // Only switch if the collapsed path actually exists — preserve the original
+    // error for genuinely missing sources.
+    if (existsSync(collapsedSource)) {
+      // sourceDir was not explicitly passed — use the collapsed path silently
+      // so `bizar dev-link` works without args in the new layout.
+      resolvedSource = resolve(process.cwd(), 'src', 'plugin');
+    }
+  }
+
   const dest = pluginDest();
   const parentDir = join(dest, '..');
 

package/cli/doctor.mjs

@@ -9,8 +9,8 @@
  * result without re-printing the per-check output.
  *
  * The checks are intentionally tolerant: missing optional tools
- * (rtk/semble/skills) don't fail the run, and the dashboard check is
- * skipped silently if no port file exists. The goal is "is your
+ * (headroom/semble/skills) don't fail the run, and the dashboard check
+ * is skipped silently if no port file exists. The goal is "is your
  * install healthy?" not "is every conceivable thing present?".
  *
  * Usage:
@@ -187,13 +187,13 @@ async function checkAgentFilesInstalled() {
 }
 
 /**
- * Lenient: passes if at least one of rtk/semble/skills is on PATH.
+ * Lenient: passes if at least one of headroom/semble/skills is on PATH.
  * These are informational — none of them are strictly required for
  * `bizar doctor` to do its job, and missing them shouldn't fail the
  * overall health report.
  */
 async function checkToolsAvailable() {
-  const tools = ['rtk', 'semble', 'skills'];
+  const tools = ['headroom', 'semble', 'skills'];
   const found = tools.filter(which);
   if (found.length === 0) {
     throw new Error(`none of ${tools.join('/')} on PATH`);

package/cli/doctor.test.mjs

@@ -8,7 +8,7 @@
  * tmpdir, and craft the opencode.json + agents/ directory to drive
  * specific pass/fail outcomes. For checks that depend on global
  * npm-installed packages or external CLIs (e.g. opencode --version,
- * npm root -g, which rtk), we accept that they may pass or fail
+ * npm root -g, which headroom), we accept that they may pass or fail
  * depending on the test environment and just verify the framework
  * returns the right shape.
  */
@@ -116,7 +116,7 @@ describe('runDoctor() shape', () => {
 
   test('silent mode suppresses ALL output when nothing fails', async () => {
     // Build a fully healthy environment. We can't make opencode reachable
-    // or rtk installed without modifying PATH, so we settle for: no failures
+    // or headroom installed without modifying PATH, so we settle for: no failures
     // means no output at all. Since we know some checks will fail in a
     // bare tmpdir, this test is structured to assert the negative case
     // differently: we verify silent+no-fail produces 0 lines.

package/cli/init.mjs

@@ -87,7 +87,17 @@ export function writePrePushNotesFile(bizarDir) {
   console.log(chalk.green(`  ✓ Created ${ppnPath}`));
 }
 
-export async function runInit(cwd) {
+export async function runInit(cwd, opts = {}) {
+  // Extract memory-related non-interactive flags from opts.
+  // Acceptable shapes:
+  //   opts = { skipMemory: true }
+  //   opts = { memoryMode: 'managed', memoryRepoName: 'my-repo' }
+  //   opts = { memoryMode: 'local-only' }
+  // (We also accept `args` for callers that pass raw argv — uncommon since
+  // bin.mjs only calls runInit(process.cwd()) today.)
+  const skipMemory = !!opts.skipMemory || process.env.BIZAR_SKIP_INSTALL;
+  const memoryModeOpt = opts.memoryMode || null;
+  const memoryRepoNameOpt = opts.memoryRepoName || null;
   console.log(chalk.bold.hex('#10b981')('\n  ᛗ BIZARHARNESS INIT ᛗ\n'));
 
   const bizarDir = join(cwd, '.bizar');
@@ -229,6 +239,130 @@ ${stack.runner ? `- Dev: \`${stack.runner}\`` : ''}
     }
   }
 
+  // ── Memory configuration (Bizar Memory Service Phase 1) ──────────────────
+  // Writes `.bizar/memory.json` so the dashboard / API knows where the vault
+  // lives and which mode we're in. Gated on `BIZAR_SKIP_INSTALL` and the
+  // explicit `--skip-memory` opt (callers that pre-supply a config file pass
+  // `skipMemory: true` to avoid the interactive prompt).
+  console.log(chalk.bold('\n--- Memory ---\n'));
+  const memoryJsonPath = join(bizarDir, 'memory.json');
+  if (existsSync(memoryJsonPath)) {
+    console.log(chalk.dim(`  - memory config already exists at ${memoryJsonPath} (skipped)`));
+  } else if (skipMemory) {
+    console.log(chalk.dim('  - memory config: skipped (BIZAR_SKIP_INSTALL or skipMemory opt)'));
+  } else {
+    try {
+      const inquirer = (await import('inquirer')).default;
+      const initialMode = memoryModeOpt
+        ? memoryModeOpt
+        : (await inquirer.prompt([{
+            type: 'list',
+            name: 'memoryMode',
+            message: 'Memory backend',
+            choices: [
+              { name: 'managed (shared user-level repo at ~/.local/share/bizar/memory/bizar-memory/)', value: 'managed' },
+              { name: 'local-only (vault stays in this project at .obsidian/)', value: 'local-only' },
+            ],
+            default: 'managed',
+          }])).memoryMode;
+      const memoryMode = initialMode === 'managed' ? 'managed' : 'local-only';
+
+      let repoName = memoryMode === 'managed'
+        ? (memoryRepoNameOpt || 'bizar-memory')
+        : null;
+      if (memoryMode === 'managed' && !memoryRepoNameOpt) {
+        const answer = await inquirer.prompt([{
+          type: 'input',
+          name: 'repoName',
+          message: 'Memory repo name',
+          default: 'bizar-memory',
+        }]);
+        repoName = answer.repoName || 'bizar-memory';
+      }
+
+      const projectId = basename(cwd) || 'project';
+      const home = process.env.HOME || process.env.USERPROFILE || process.cwd();
+      const managedPath = join(home, '.local', 'share', 'bizar', 'memory', repoName || 'bizar-memory');
+      const vaultPath = memoryMode === 'managed' ? managedPath : join(cwd, '.obsidian');
+
+      const { atomicWriteJson } = await import('./atomic.mjs');
+      const config = {
+        version: 1,
+        backend: 'bizar-local',
+        projectId,
+        memoryRepo: {
+          mode: memoryMode,
+          path: vaultPath,
+          remote: null,
+          branch: 'main',
+          namespace: memoryMode === 'managed' ? `projects/${projectId}` : null,
+        },
+        namespaces: {
+          project: `projects/${projectId}`,
+          global: 'global/bizar',
+          user: `users/${process.env.USER || process.env.USERNAME || 'local'}`,
+        },
+        lightrag: {
+          enabled: false,
+          host: '127.0.0.1',
+          port: 9621,
+          workingDir: join(cwd, '.bizar', 'lightrag'),
+        },
+        git: {
+          autoPullOnSessionStart: false,
+          autoCommitOnMemoryWrite: false,
+          autoPushOnSessionEnd: false,
+          commitAuthor: 'Bizar Memory <bizar-memory@local>',
+          commitMessageTemplate: `memory(${projectId}): {summary}`,
+        },
+      };
+      atomicWriteJson(memoryJsonPath, config);
+      console.log(chalk.green(`  ✓ Created ${memoryJsonPath} (mode: ${memoryMode})`));
+      if (memoryMode === 'managed') {
+        console.log(chalk.dim(`  Vault path: ${vaultPath} (shared user-level repo)`));
+      } else {
+        console.log(chalk.dim(`  Vault path: ${vaultPath} (local-only)`));
+      }
+    } catch (err) {
+      // Inquirer prompt can throw if stdin is not a TTY (CI). Fall back to
+      // a minimal local-only config so init still completes cleanly.
+      console.log(chalk.yellow(`  ⚠ Memory config prompt failed (${err.message || err}); defaulting to local-only.`));
+      try {
+        const projectId = basename(cwd) || 'project';
+        const { atomicWriteJson } = await import('./atomic.mjs');
+        const fallback = {
+          version: 1,
+          backend: 'bizar-local',
+          projectId,
+          memoryRepo: {
+            mode: 'local-only',
+            path: join(cwd, '.obsidian'),
+            remote: null,
+            branch: 'main',
+            namespace: null,
+          },
+          namespaces: {
+            project: `projects/${projectId}`,
+            global: 'global/bizar',
+            user: `users/${process.env.USER || process.env.USERNAME || 'local'}`,
+          },
+          lightrag: { enabled: false, host: '127.0.0.1', port: 9621, workingDir: join(cwd, '.bizar', 'lightrag') },
+          git: {
+            autoPullOnSessionStart: false,
+            autoCommitOnMemoryWrite: false,
+            autoPushOnSessionEnd: false,
+            commitAuthor: 'Bizar Memory <bizar-memory@local>',
+            commitMessageTemplate: `memory(${projectId}): {summary}`,
+          },
+        };
+        atomicWriteJson(memoryJsonPath, fallback);
+        console.log(chalk.green(`  ✓ Created ${memoryJsonPath} (mode: local-only — fallback)`));
+      } catch (innerErr) {
+        console.log(chalk.dim(`  - memory config write failed (${innerErr.message || innerErr}); skipping`));
+      }
+    }
+  }
+
   console.log(chalk.dim('\n  Project initialized. Run `@frigg` to ask questions about the codebase.\n'));
   return true;
 }

package/cli/install.mjs

@@ -5,8 +5,8 @@ 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, detectUv, buildSummary, opencodeAgentsDir, opencodeConfigDir, repoPath } from './utils.mjs';
-import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installRtk, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
+import { detectOpenCode, detectHeadroom, detectSemble, detectSkillsCli, detectUv, buildSummary, opencodeAgentsDir, opencodeConfigDir, repoPath } from './utils.mjs';
+import { installAgents, installAgentsMd, installSkill, installOpencodeJson, installBizarFolder, installPluginBizar, installHeadroom, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
 
 const AGENT_FILES = [
   'odin.md', 'vor.md', 'frigg.md', 'quick.md',
@@ -327,30 +327,17 @@ async function promptAndInstallOptional() {
     console.log('  ✓ @polderlabs/bizar-plugin already installed');
   }
 
-  // Dashboard
-  const dashInstalled = await isPackageInstalled('@polderlabs/bizar-dash');
-  if (!dashInstalled) {
-    console.log('');
-    console.log('  The Bizar dashboard provides the web UI (React + Vite) and TUI (blessed).');
-    console.log('  It\'s optional — install it for the full experience, or use the CLI alone.');
-    const install = await promptYesNo(
-      'Install @polderlabs/bizar-dash?',
-      true,
-    );
-    if (install) {
-      try {
-        console.log('  Installing @polderlabs/bizar-dash...');
-        execSync('npm install -g @polderlabs/bizar-dash', { stdio: 'inherit' });
-        console.log('  ✓ @polderlabs/bizar-dash installed');
-      } catch (err) {
-        console.log(`  ✗ Failed to install @polderlabs/bizar-dash: ${err.message}`);
-        console.log('  You can install it later with: npm install -g @polderlabs/bizar-dash');
-      }
-    } else {
-      console.log('  Skipped. Install later with: npm install -g @polderlabs/bizar-dash');
-    }
+  // Dashboard — v4.0.0: ships inside this package at <repo>/bizar-dash/
+  // Verify the directory is present; it's a corrupted install if missing.
+  const dashDir = join(__dirname, '..', 'bizar-dash');
+  const dashPkgJson = join(dashDir, 'package.json');
+  if (!existsSync(dashPkgJson)) {
+    console.error('');
+    console.error('  ✗ Dashboard directory not found at bizar-dash/.');
+    console.error('    This looks like a corrupted install.');
+    console.error('    Please report at: github.com/DrB0rk/BizarHarness/issues');
   } else {
-    console.log('  ✓ @polderlabs/bizar-dash already installed');
+    console.log('  ✓ Dashboard directory present (bizar-dash/)');
   }
 }
 
@@ -567,32 +554,37 @@ export async function runPostInstall() {
   }
   console.log('BizarHarness: agents installed.');
 
-  // Install RTK
-  const rtkPresent = await detectRtk();
-  if (!rtkPresent) {
-    console.log('BizarHarness: installing RTK (token optimizer)...');
+  // Install Headroom
+  const headroomPresent = await detectHeadroom();
+  if (!headroomPresent) {
+    console.log('BizarHarness: installing Headroom (context compressor)...');
     try {
       if (process.platform === 'win32') {
-        // RTK ships a bash-only installer; on Windows the user installs it
-        // manually (e.g. `cargo install --git https://github.com/rtk-ai/rtk`).
-        console.log('BizarHarness: RTK bash installer does not run on Windows. Install manually from https://github.com/rtk-ai/rtk');
+        console.log('BizarHarness: Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"');
       } else {
         execSync(
-          'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
+          'pip install --user "headroom-ai[all]"',
           { stdio: 'pipe', timeout: 60000 },
         );
-        execSync('rtk init -g --opencode', { stdio: 'pipe' });
-        console.log('BizarHarness: RTK installed and configured.');
+        execSync('headroom wrap opencode', { stdio: 'pipe' });
+        console.log('BizarHarness: Headroom installed and configured.');
       }
     } catch {
-      console.log('BizarHarness: RTK install failed. Install manually from https://github.com/rtk-ai/rtk');
+      // Fall back to npm
+      try {
+        execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
+        execSync('headroom wrap opencode', { stdio: 'pipe' });
+        console.log('BizarHarness: Headroom installed (npm) and configured.');
+      } catch {
+        console.log('BizarHarness: Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai');
+      }
     }
   } else {
     try {
-      execSync('rtk init -g --opencode', { stdio: 'pipe' });
-      console.log('BizarHarness: RTK configured for opencode.');
+      execSync('headroom wrap opencode', { stdio: 'pipe' });
+      console.log('BizarHarness: Headroom configured for opencode.');
     } catch {
-      console.log('BizarHarness: could not configure RTK. Run `rtk init -g --opencode` manually.');
+      console.log('BizarHarness: could not configure Headroom. Run `headroom wrap opencode` manually.');
     }
   }