@polderlabs/bizar 10.0.7 → 10.1.0

package/cli/service-controller.mjs

@@ -102,9 +102,6 @@ function linuxUnitPath() {
 function linuxEnvPath() {
   return join(bizarConfigDir(), 'service.env');
 }
-function linuxHeadroomUnitPath() {
-  return join(userUnitDir(), 'bizar-headroom.service');
-}
 function darwinPlistPath() {
   return join(launchAgentsDir(), 'com.bizar.dashboard.plist');
 }
@@ -178,161 +175,6 @@ function linuxEnvFileContent({ projectRoot }) {
   return buildServiceEnvFile({ bizarHome: bizarConfigDir(), repoPath: projectRoot });
 }
 
-// ── Headroom companion service (Linux) ─────────────────────────────────────────
-
-function linuxHeadroomUnitContent() {
-  const envPath = join(bizarConfigDir(), 'service.env');
-  return [
-    '[Unit]',
-    'Description=Bizar Headroom context-compression proxy',
-    'After=bizar.service',
-    'Wants=bizar.service',
-    '',
-    '[Service]',
-    'Type=simple',
-    `EnvironmentFile=${envPath}`,
-    'ExecStart=/bin/sh -c "command -v headroom >/dev/null 2>&1 && headroom proxy cline || exit 0"',
-    'Restart=on-failure',
-    'RestartSec=10',
-    'TimeoutStopSec=15',
-    '',
-    '[Install]',
-    'WantedBy=default.target',
-    '',
-  ].join('\n');
-}
-
-function darwinHeadroomPlistPath() {
-  return join(launchAgentsDir(), 'com.bizar.headroom.plist');
-}
-
-function darwinHeadroomPlistContent({ nodePath, projectRoot }) {
-  const envContent = buildServiceEnvFile({ bizarHome: bizarConfigDir(), repoPath: projectRoot });
-  const envVars = parseEnvFile(envContent);
-  const envXml = envVars
-    .map(([k, v]) => `      <key>${xmlEscape(k)}</key>\n      <string>${xmlEscape(v)}</string>`)
-    .join('\n');
-  return [
-    '<?xml version="1.0" encoding="UTF-8"?>',
-    '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
-    '<plist version="1.0">',
-    '<dict>',
-    '  <key>Label</key>',
-    '  <string>com.bizar.headroom</string>',
-    '  <key>ProgramArguments</key>',
-    '  <array>',
-    `    <string>${xmlEscape(nodePath)}</string>`,
-    '    <string>-c</string>',
-    '    <string>command -v headroom >/dev/null 2>&1 && headroom proxy cline || exit 0</string>',
-    '  </array>',
-    '  <key>EnvironmentVariables</key>',
-    '  <dict>',
-    envXml,
-    '  </dict>',
-    '  <key>KeepAlive</key>',
-    '  <true/>',
-    '  <key>RunAtLoad</key>',
-    '  <true/>',
-    '  <key>StandardOutPath</key>',
-    `  <string>${xmlEscape(join(bizarConfigDir(), 'headroom.log'))}</string>`,
-    '  <key>StandardErrorPath</key>',
-    `  <string>${xmlEscape(join(bizarConfigDir(), 'headroom.log'))}</string>`,
-    '  <key>WorkingDirectory</key>',
-    `  <string>${xmlEscape(projectRoot)}</string>`,
-    '</dict>',
-    '</plist>',
-    '',
-  ].join('\n');
-}
-
-function installHeadroomServiceLinux({ force = false }) {
-  // Honour BIZAR_HEADROOM_AUTOSTART from process.env (already merged by buildServiceEnvFile)
-  const headroomAutoStart = process.env.BIZAR_HEADROOM_AUTOSTART !== '0';
-  if (!headroomAutoStart) {
-    return ok({ note: 'headroom autostart disabled via BIZAR_HEADROOM_AUTOSTART=0' });
-  }
-  if (!existsSync(userUnitDir())) {
-    try { mkdirSync(userUnitDir(), { recursive: true }); } catch (err) {
-      return fail(`cannot create ${userUnitDir()}: ${err.message}`);
-    }
-  }
-  const unitPath = linuxHeadroomUnitPath();
-  const want = linuxHeadroomUnitContent();
-  if (!force && existsSync(unitPath)) {
-    const have = readFileSync(unitPath, 'utf8').trim() + '\n';
-    if (have === want.trim() + '\n') {
-      return ok({ alreadyInstalled: true, unitPath, note: 'headroom unit already matches' });
-    }
-  }
-  try {
-    writeFileSync(unitPath, want, { encoding: 'utf8', mode: 0o644 });
-  } catch (err) {
-    return fail(`write ${unitPath}: ${err.message}`);
-  }
-  runCmd('systemctl', ['--user', 'daemon-reload']);
-  const r = runCmd('systemctl', ['--user', 'enable', '--now', 'bizar-headroom.service']);
-  if (r.error || (r.status !== 0 && r.status !== null)) {
-    return fail(`headroom service enable failed: ${r.stderr || r.error?.message || `exit ${r.status}`}`, { unitPath });
-  }
-  return ok({ unitPath, note: 'headroom companion service installed and started' });
-}
-
-function uninstallHeadroomServiceLinux() {
-  const unitPath = linuxHeadroomUnitPath();
-  if (!existsSync(unitPath)) {
-    return ok({ unitPath: null, note: 'no headroom systemd unit installed' });
-  }
-  runCmd('systemctl', ['--user', 'disable', '--now', 'bizar-headroom.service']);
-  try { unlinkSync(unitPath); } catch { /* ignore */ }
-  runCmd('systemctl', ['--user', 'daemon-reload']);
-  return ok({ unitPath: null, note: 'headroom systemd unit removed' });
-}
-
-function installHeadroomServiceDarwin({ nodePath, projectRoot, force = false }) {
-  const headroomAutoStart = process.env.BIZAR_HEADROOM_AUTOSTART !== '0';
-  if (!headroomAutoStart) {
-    return ok({ note: 'headroom autostart disabled via BIZAR_HEADROOM_AUTOSTART=0' });
-  }
-  const dir = launchAgentsDir();
-  if (!existsSync(dir)) {
-    try { mkdirSync(dir, { recursive: true }); } catch (err) {
-      return fail(`cannot create ${dir}: ${err.message}`);
-    }
-  }
-  const plistPath = darwinHeadroomPlistPath();
-  const want = darwinHeadroomPlistContent({ nodePath, projectRoot });
-  if (!force && existsSync(plistPath)) {
-    const have = readFileSync(plistPath, 'utf8').trim() + '\n';
-    if (have === want.trim() + '\n') {
-      const lst = runCmd('launchctl', ['list']);
-      if (lst.status === 0 && /com\.bizar\.headroom/.test(lst.stdout)) {
-        return ok({ alreadyInstalled: true, unitPath: plistPath, note: 'headroom plist matches and is loaded' });
-      }
-    }
-  }
-  try {
-    writeFileSync(plistPath, want, { encoding: 'utf8', mode: 0o644 });
-    try { chmodSync(plistPath, 0o644); } catch { /* best-effort */ }
-  } catch (err) {
-    return fail(`write ${plistPath}: ${err.message}`);
-  }
-  runCmd('launchctl', ['unload', plistPath]);
-  const load = runCmd('launchctl', ['load', '-w', plistPath]);
-  if (load.error || (load.status !== 0 && load.status !== null)) {
-    return fail(`launchctl load failed for headroom: ${load.stderr || load.error?.message || `exit ${load.status}`}`, { unitPath: plistPath });
-  }
-  return ok({ unitPath: plistPath, note: 'headroom companion plist installed and loaded' });
-}
-
-function uninstallHeadroomServiceDarwin() {
-  const plistPath = darwinHeadroomPlistPath();
-  if (!existsSync(plistPath)) {
-    return ok({ unitPath: null, note: 'no headroom launchd plist installed' });
-  }
-  runCmd('launchctl', ['unload', plistPath]);
-  try { unlinkSync(plistPath); } catch { /* ignore */ }
-  return ok({ unitPath: null, note: 'headroom launchd plist removed' });
-}
 
 function installServiceLinux({ nodePath, projectRoot, force = false }) {
   if (!existsSync(userUnitDir())) {
@@ -393,13 +235,6 @@ function installServiceLinux({ nodePath, projectRoot, force = false }) {
     return fail(`systemctl --user enable --now failed: ${r.stderr || r.error?.message || `exit ${r.status}`}`, { unitPath });
   }
 
-  // Also install headroom companion service (non-fatal if it fails)
-  const hr = installHeadroomServiceLinux({ force });
-  if (!hr.ok) {
-    // Non-fatal: headroom is optional
-    console.log(`  ${hr.error || 'headroom companion install failed'}`);
-  }
-
   return ok({
     unitPath,
     note: 'systemd user unit installed and started (or already running)',
@@ -562,12 +397,6 @@ function installServiceDarwin({ nodePath, projectRoot, force = false }) {
     return fail(`launchctl load failed: ${load.stderr || load.error?.message || `exit ${load.status}`}`, { unitPath: plistPath });
   }
 
-  // Also install headroom companion service (non-fatal if it fails)
-  const hr = installHeadroomServiceDarwin({ nodePath, projectRoot, force });
-  if (!hr.ok) {
-    console.log(`  ${hr.error || 'headroom companion install failed'}`);
-  }
-
   return ok({ unitPath: plistPath, note: 'plist installed and loaded' });
 }
 
@@ -755,30 +584,9 @@ export function uninstallService() {
   else if (PLATFORM === 'darwin') result = uninstallServiceDarwin();
   else if (PLATFORM === 'win32') result = uninstallServiceWindows();
   else return fail(`unsupported platform: ${PLATFORM}`);
-  // Also uninstall headroom companion
-  if (PLATFORM === 'linux') uninstallHeadroomServiceLinux();
-  if (PLATFORM === 'darwin') uninstallHeadroomServiceDarwin();
   return result;
 }
 
-/**
- * Install the headroom companion service only (does NOT install the
- * main dashboard service). Idempotent. Safe to re-run.
- */
-export function installHeadroomService(opts = {}) {
-  const nodePath = resolveNodePath(opts.nodePath);
-  const projectRoot = resolveRepoRoot(opts.projectRoot);
-  if (PLATFORM === 'linux') return installHeadroomServiceLinux({ force: !!opts.force });
-  if (PLATFORM === 'darwin') return installHeadroomServiceDarwin({ nodePath, projectRoot, force: !!opts.force });
-  return ok({ note: `headroom companion not supported on ${PLATFORM}` });
-}
-
-export function uninstallHeadroomService() {
-  if (PLATFORM === 'linux') return uninstallHeadroomServiceLinux();
-  if (PLATFORM === 'darwin') return uninstallHeadroomServiceDarwin();
-  return ok({ note: `headroom companion not supported on ${PLATFORM}` });
-}
-
 /**
  * v5.x — Restart the service (issue #7).
  *

package/cli/service-env.mjs

@@ -4,7 +4,7 @@
  * v5.x — Central env file builder for the Bizar service.
  *
  * Produces the content for `~/.config/bizar/service.env` (mode 0600),
- * which is sourced by the systemd/launchd service and the headroom companion.
+ * which is sourced by the systemd/launchd service.
  *
  * All BIZAR_* vars are written here so the service has a consistent view
  * of the environment. Values already present in `process.env` are honoured
@@ -31,7 +31,6 @@ export function defaultBizarEnv() {
     BIZAR_DASHBOARD_PORT: '4097',
     BIZAR_DASHBOARD_HOST: '127.0.0.1',
     BIZAR_LOG_LEVEL: 'info',
-    BIZAR_HEADROOM_AUTOSTART: '1',
     BIZAR_LIGHTRAG_AUTOSTART: '1',
     BIZAR_MEMORY_VAULT: join(home, '.bizar_memory'),
     CLINE_SERVER_PASSWORD: '',
@@ -77,11 +76,10 @@ function generatePassword() {
  * @param {object} opts
  * @param {string} [opts.bizarHome]   – default: ~/.config/bizar
  * @param {string} [opts.repoPath]    – absolute path to the repo root
- * @param {boolean} [opts.headroomAutoStart] – default: true
  * @param {boolean} [opts.lightragAutoStart] – default: true
  * @returns {string} env file content (does NOT write to disk)
  */
-export function buildServiceEnvFile({ bizarHome, repoPath, headroomAutoStart = true, lightragAutoStart = true } = {}) {
+export function buildServiceEnvFile({ bizarHome, repoPath, lightragAutoStart = true } = {}) {
   const home = homedir();
   const defaults = defaultBizarEnv();
 
@@ -91,11 +89,6 @@ export function buildServiceEnvFile({ bizarHome, repoPath, headroomAutoStart = t
     BIZAR_DASHBOARD_PORT:  process.env.BIZAR_DASHBOARD_PORT  || defaults.BIZAR_DASHBOARD_PORT,
     BIZAR_DASHBOARD_HOST:  process.env.BIZAR_DASHBOARD_HOST  || defaults.BIZAR_DASHBOARD_HOST,
     BIZAR_LOG_LEVEL:       process.env.BIZAR_LOG_LEVEL       || defaults.BIZAR_LOG_LEVEL,
-    BIZAR_HEADROOM_AUTOSTART: String(
-      process.env.BIZAR_HEADROOM_AUTOSTART !== undefined
-        ? (process.env.BIZAR_HEADROOM_AUTOSTART === '1' || process.env.BIZAR_HEADROOM_AUTOSTART === 'true' ? '1' : '0')
-        : (headroomAutoStart ? '1' : '0')
-    ),
     BIZAR_LIGHTRAG_AUTOSTART: String(
       process.env.BIZAR_LIGHTRAG_AUTOSTART !== undefined
         ? (process.env.BIZAR_LIGHTRAG_AUTOSTART === '1' || process.env.BIZAR_LIGHTRAG_AUTOSTART === 'true' ? '1' : '0')

package/cli/utils.mjs

@@ -121,13 +121,6 @@ export async function detectClaude() {
   return { exists, version, configDir: claudeConfigDir(), agentsDir: claudeAgentsDir() };
 }
 
-export async function detectHeadroom() {
-  return commandExists('headroom');
-}
-
-// Alias for backward-compat during migration
-export const detectRtk = detectHeadroom;
-
 export async function detectSemble() {
   if (commandExists('semble')) {
     return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "10.0.7",
+  "version": "10.1.0",
   "description": "Norse-pantheon multi-agent system for Claude Code — 14 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. Ships as a single npm package with the dashboard server, Claude Code MCP server, and typed SDK.",
   "type": "module",
   "bin": {

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar-sdk",
-  "version": "10.0.7",
+  "version": "10.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/scripts/check-deps.mjs

@@ -152,13 +152,6 @@ function readGhVersion() {
   return m ? m[1] : raw.split(' ')[0];
 }
 
-function readHeadroomVersion() {
-  const raw = safeExec('headroom', ['--version']);
-  if (!raw) return null;
-  const m = raw.match(/(\d+\.\d+\.\d+)/);
-  return m ? m[1] : raw.split(' ')[0];
-}
-
 function readSembleVersion() {
   const raw = safeExec('semble', ['--version']);
   if (!raw) return null;
@@ -187,7 +180,6 @@ function windowsInstallCmd(name) {
     case 'pip':    return 'python -m pip install --upgrade pip 2>nul || pip install --upgrade pip 2>nul';
     case 'jq':     return 'winget install jqlang.jq 2>nul || choco install jq -y 2>nul';
     case 'gh':     return 'winget install GitHub.cli 2>nul || choco install gh -y 2>nul';
-    case 'headroom':
     case 'semble': return 'npm install -g ' + name + ' 2>nul';
     default:       return null;
   }
@@ -204,7 +196,6 @@ function macInstallCmd(name) {
     case 'pip':    return 'python3 -m pip install --upgrade pip';
     case 'jq':     return 'brew install jq';
     case 'gh':     return 'brew install gh';
-    case 'headroom':
     case 'semble': return 'npm install -g ' + name;
     default:       return null;
   }
@@ -219,7 +210,6 @@ function linuxInstallCmd(name) {
       case 'jq':     return 'nix-shell -p jq';
       case 'git':    return 'nix-shell -p git';
       case 'gh':     return 'nix-shell -p gh';
-      case 'headroom':
       case 'semble': return `nix-env -iA nixpkgs.${name}`;
       default: return null;
     }
@@ -264,7 +254,6 @@ function linuxInstallCmd(name) {
       if (LINUX_DISTRO === 'alpine') return `${sudo}apk add --no-cache gh`;
       if (LINUX_DISTRO === 'void') return `${sudo}xbps-install -S gh`;
       return `${sudo}${pm} install -y gh`;
-    case 'headroom':
     case 'semble':
       return `npm install -g ${name}`;
     default:
@@ -425,19 +414,6 @@ export async function checkDeps({ strict = false } = {}) {
     }
   }
 
-  // --- headroom ---
-  {
-    const current = readHeadroomVersion();
-    const entry = { name: 'headroom', status: 'missing', current, required: 'recommended' };
-    if (which('headroom')) {
-      entry.status = 'present';
-      present.push(entry);
-    } else {
-      entry.installCmd = installCmdFor('headroom');
-      missing.push(entry);
-    }
-  }
-
   // --- semble ---
   {
     const current = readSembleVersion();

package/bizar-dash/skills/headroom/SKILL.md

@@ -1,94 +0,0 @@
----
-name: headroom
-description: Headroom — context compression layer for AI agents. Routes cline and other LLM clients through a local proxy that compresses tool outputs, logs, RAG chunks, and conversation history by 60–95%.
----
-
-# Headroom
-
-Headroom is a context compression layer that sits between cline (or any LLM client) and the upstream provider. It intercepts tool call outputs, conversation history, and RAG chunks and compresses them before they reach the model — typically reducing token usage by 60–95% with no loss in answer quality.
-
-## When to Use
-
-- **Token budget is tight**: If a task is approaching the context window limit, Headroom can reclaim 60–90% of the tokens spent on tool outputs.
-- **Long conversations**: The compression is cumulative — the longer the session, the more Headroom saves.
-- **Verbose tool output**: RAG retrieval, file globbing, grep results, and diagnostic output are the highest-value compression targets.
-- **Multi-step implementation**: Large features with many tool calls benefit most.
-
-## Architecture
-
-```
-cline → headroom proxy (localhost:8787) → LLM provider
-             ↓
-        compresses tool outputs, logs, RAG chunks
-        caches responses
-        measures savings
-```
-
-## Key Concepts
-
-### Compression ratio
-The fraction of tokens Headroom eliminates. A 0.85 compression ratio means 85% of the tokens were removed before reaching the provider.
-
-### Wrapped vs unwrapped
-`headroom wrap cline` modifies `~/.config/cline/cline.json` to route traffic through the proxy. `headroom unwrap cline` restores the original configuration.
-
-### Proxy vs wrap
-- **Proxy** (`headroom proxy`): The actual HTTP proxy server running on port 8787.
-- **Wrap** (`headroom wrap cline`): The act of configuring cline to use the proxy.
-
-You can run the proxy standalone (`headroom proxy`) and point any OpenAI-compatible client at it. The wrap command is just a convenience for cline.
-
-## Dashboard Integration
-
-The Bizar dashboard manages Headroom through Settings → Headroom:
-
-- **Status widget**: Shows live proxy status, compression ratio, tokens saved
-- **Controls**: Install, wrap/unwrap, start/stop proxy, open dashboard
-- **Settings**: Auto-install, auto-start, auto-wrap, route-all-providers, port, host, backend, output shaper, telemetry, budget
-
-API endpoints:
-- `GET /api/headroom/status` — live status
-- `GET /api/headroom/stats?hours=24` — compression statistics
-- `POST /api/headroom/install` — install headroom
-- `POST /api/headroom/wrap` — wrap cline
-- `POST /api/headroom/unwrap` — unwrap cline
-- `POST /api/headroom/proxy/start` — start proxy
-- `POST /api/headroom/proxy/stop` — stop proxy
-- `POST /api/headroom/auto-route` — configure all providers to route through the proxy
-
-CLI:
-```bash
-bizar headroom status   # live status
-bizar headroom stats    # compression stats
-bizar headroom install  # install headroom
-bizar headroom wrap     # wrap cline
-bizar headroom unwrap   # unwrap
-bizar headroom start    # start proxy
-bizar headroom stop     # stop proxy
-bizar headroom doctor   # health check
-```
-
-## Environment Variables
-
-| Variable | Default | Description |
-|---|---|---|
-| `HEADROOM_HOST` | `127.0.0.1` | Proxy bind host |
-| `HEADROOM_PORT` | `8787` | Proxy port |
-| `HEADROOM_OUTPUT_SHAPER` | `0` | Set to `1` to enable output shaping |
-| `HEADROOM_TELEMETRY` | (on) | Set to `off` to disable |
-| `HEADROOM_BUDGET` | `0` | Monthly USD cap (0 = unlimited) |
-| `HEADROOM_CONTEXT_TOOL` | `rtk` | Context tool: `rtk` or `lean-ctx` |
-
-## Common Gotchas
-
-1. **Proxy must be running before cline starts**: If the proxy is down when cline launches, cline will fail to make LLM calls. Start the proxy first, or enable `autoStart` in Headroom settings.
-
-2. **`headroom wrap` edits cline.json**: The wrap command modifies `~/.config/cline/cline.json`. If you use version control for this file, you'll see a diff on every wrap. Use `headroom unwrap` before committing, or ignore the changes.
-
-3. **Headroom 0.30.0 doesn't have `headroom plan --tokens`**: This command was removed. Use `headroom perf --hours 24` for actual token savings data.
-
-4. **Token savings are cumulative**: The compression ratio compounds over a session. A 15-step implementation that saves 80% at each step uses roughly the same tokens as a 3-step implementation without Headroom.
-
-5. **Cache hits**: Headroom caches semantically similar tool calls. Repeated operations (file reads, API probes) can be served from cache entirely, bypassing the LLM.
-
-6. **Provider baseURL**: When `routeAllProviders` is enabled, the dashboard rewrites provider baseURLs to point at the proxy. If you configure a new provider manually, you may need to update its baseURL to go through the proxy.