@polderlabs/bizar 10.0.7 → 10.2.0

package/bizar-dash/src/web/v8/views/Artifacts/ClaudeArtifactView.tsx

@@ -0,0 +1,179 @@
+/**
+ * v8/views/Artifacts/ClaudeArtifactView.tsx — v10.1.0.
+ *
+ * Renders Claude-* kind artifacts (HTML / SVG / React) inside a
+ * sandboxed iframe. The server hands us a fully-compiled HTML envelope
+ * (returned from GET /api/artifacts/:slug/render) and we drop it into
+ * `srcdoc`. The iframe has `sandbox` set so even if a malicious escape
+ * slips past server-side filtering, the runtime is still constrained.
+ *
+ * Two render modes:
+ *   1. <iframe srcdoc> — for full-envelope artifacts (default).
+ *   2. Plain `<div>` for an `mdx` kind fallback (handled by caller).
+ */
+
+import { useState } from 'react';
+import { Card, CardBody } from '../../ui/data/Card.js';
+import { Inline } from '../../ui/primitives/Inline.js';
+import { Stack } from '../../ui/primitives/Stack.js';
+import { AlertTriangle, ShieldCheck, ExternalLink } from 'lucide-react';
+import { Button } from '../../ui/controls/Button.js';
+
+export interface ClaudeRenderPayload {
+  slug: string;
+  kind: 'claude-html' | 'claude-svg' | 'claude-react' | 'mdx';
+  html?: string;
+  blocks?: unknown[];
+  frontmatter?: Record<string, unknown>;
+  warnings?: Array<{ message?: string; pattern?: string }>;
+  safeMode?: boolean;
+  compiledAt?: string;
+}
+
+export function ClaudeArtifactView({
+  payload,
+  slug,
+}: {
+  payload: ClaudeRenderPayload;
+  slug: string;
+}): JSX.Element {
+  const [showSource, setShowSource] = useState(false);
+
+  if (payload.kind === 'mdx') {
+    // Legacy fallback — the server returns no `html` for mdx; just show
+    // the compiled block count.
+    return (
+      <Card variant="default" data-testid={`claude-view-${slug}`}>
+        <CardBody>
+          <Inline align="center" gap={2}>
+            <ShieldCheck size={14} aria-hidden style={{ color: 'var(--fg-muted)' }} />
+            <span style={{ fontSize: 'var(--fs-12)', color: 'var(--fg-muted)' }}>
+              Legacy MDX — {Array.isArray(payload.blocks) ? `${payload.blocks.length} blocks` : 'no blocks'}
+            </span>
+          </Inline>
+        </CardBody>
+      </Card>
+    );
+  }
+
+  if (!payload.html) {
+    return (
+      <Card variant="default" data-testid={`claude-view-${slug}`}>
+        <CardBody>
+          <span role="alert" style={{ color: 'var(--danger)' }}>
+            No HTML returned by the compiler.
+          </span>
+        </CardBody>
+      </Card>
+    );
+  }
+
+  return (
+    <Stack gap={2} data-testid={`claude-view-${slug}`}>
+      {payload.safeMode && (
+        <Inline
+          align="center"
+          gap={2}
+          style={{
+            padding: 'var(--space-2)',
+            background: 'var(--callout-warning-bg, #fdf6e3)',
+            border: '1px solid var(--callout-warning-border, #e0c97d)',
+            borderRadius: 'var(--radius-sm)',
+            fontSize: 'var(--fs-12)',
+          }}
+          role="status"
+          data-testid={`claude-safe-${slug}`}
+        >
+          <AlertTriangle size={14} aria-hidden style={{ color: '#b58900' }} />
+          <span>
+            Safe mode — the compiler stripped potentially dangerous
+            patterns in this artifact.
+          </span>
+        </Inline>
+      )}
+      {payload.warnings && payload.warnings.length > 0 && (
+        <details
+          style={{
+            fontSize: 'var(--fs-12)',
+            color: 'var(--fg-muted)',
+            padding: 'var(--space-2)',
+            background: 'var(--surface-1)',
+            borderRadius: 'var(--radius-sm)',
+          }}
+        >
+          <summary>{payload.warnings.length} warning(s)</summary>
+          <ul style={{ marginTop: 'var(--space-1)' }}>
+            {payload.warnings.map((w, i) => (
+              <li key={i}>
+                <code style={{ fontFamily: 'var(--font-mono)' }}>
+                  {w.pattern}
+                </code>{' '}
+                — {w.message}
+              </li>
+            ))}
+          </ul>
+        </details>
+      )}
+      <Inline align="center" justify="between" gap={2}>
+        <span style={{ fontSize: 'var(--fs-11)', color: 'var(--fg-muted)' }}>
+          {payload.kind} · compiled {payload.compiledAt ? new Date(payload.compiledAt).toLocaleTimeString() : 'now'}
+        </span>
+        <Inline gap={1}>
+          <Button variant="ghost" onClick={() => setShowSource((v) => !v)} data-testid={`claude-source-${slug}`}>
+            {showSource ? 'Hide source' : 'Show source'}
+          </Button>
+          <a
+            href={`/api/artifacts/${slug}/view`}
+            target="_blank"
+            rel="noopener noreferrer"
+            data-testid={`claude-blank-${slug}`}
+            style={{
+              display: 'inline-flex',
+              alignItems: 'center',
+              gap: 'var(--space-1)',
+              fontSize: 'var(--fs-12)',
+              padding: 'var(--space-1) var(--space-2)',
+              color: 'var(--fg)',
+              textDecoration: 'none',
+              border: '1px solid var(--border)',
+              borderRadius: 'var(--radius-sm)',
+              background: 'var(--surface-0)',
+            }}
+          >
+            <ExternalLink size={12} aria-hidden /> Open in new tab
+          </a>
+        </Inline>
+      </Inline>
+      <iframe
+        title={`claude-artifact-${slug}`}
+        data-testid={`claude-iframe-${slug}`}
+        sandbox="allow-scripts allow-same-origin"
+        srcDoc={payload.html}
+        style={{
+          width: '100%',
+          height: 480,
+          border: '1px solid var(--border)',
+          borderRadius: 'var(--radius-sm)',
+          background: 'white',
+        }}
+      />
+      {showSource && (
+        <pre
+          data-testid={`claude-source-text-${slug}`}
+          style={{
+            padding: 'var(--space-2)',
+            background: 'var(--surface-1)',
+            borderRadius: 'var(--radius-sm)',
+            fontSize: 'var(--fs-11)',
+            maxHeight: 320,
+            overflow: 'auto',
+            fontFamily: 'var(--font-mono)',
+            whiteSpace: 'pre-wrap',
+          }}
+        >
+          {payload.html}
+        </pre>
+      )}
+    </Stack>
+  );
+}

package/bizar-dash/tests/cli-bugfixes.test.mjs

@@ -86,7 +86,7 @@ describe('B7 — check-deps.mjs which() uses path.join()', () => {
     const { checkDeps } = await import('../../scripts/check-deps.mjs');
     const result = await checkDeps({ strict: false });
     const names = [...result.present, ...result.missing].map(d => d.name);
-    const required = ['node', 'bun', 'cline', 'tmux', 'git', 'python3', 'pip', 'jq', 'gh', 'headroom', 'semble', 'skills'];
+    const required = ['node', 'bun', 'cline', 'tmux', 'git', 'python3', 'pip', 'jq', 'gh', 'semble', 'skills'];
     for (const dep of required) {
       assert.ok(names.includes(dep), `expected ${dep} to be checked`);
     }

package/bizar-dash/tests/cli-error-visibility.test.mjs

@@ -138,7 +138,7 @@ describe('command module null-check produces user-visible error', () => {
     // Count `if (!mod)` checks that follow `importCommand`
     const nullCheckCount = (binSrc.match(/if \(!mod\)/g) || []).length;
     // We have 9 case groups that call importCommand: install/update, service, dash,
-    // minimax, headroom, mod, artifact, memory, usage, and util (utility commands)
+    // minimax, mod, artifact, memory, usage, and util (utility commands)
     assert.ok(
       nullCheckCount >= 9,
       `Expected at least 9 null checks after importCommand, found ${nullCheckCount}`,

package/bizar-dash/tests/cli-refactor.test.mjs

@@ -73,7 +73,6 @@ const COMMAND_FILES = [
   'service',
   'dash',
   'minimax',
-  'headroom',
   'mod',
   'artifact',
   'memory',

package/bizar-dash/tests/diagnostics-store.test.mjs

@@ -151,7 +151,6 @@ describe('collectDiagnostics', () => {
     assert.ok(snap.disk && typeof snap.disk.exists === 'boolean');
     assert.ok(snap.services);
     assert.ok(snap.services.dashboard);
-    assert.ok(snap.services.headroom);
     assert.ok(snap.services.lightrag);
     assert.ok(snap.services.cline);
     assert.ok(snap.counts);

package/cli/bin.mjs

@@ -12,7 +12,7 @@
  *
  * Commands:
  *   install, audit, init, export, artifact, update, test-gate, service, dash,
- *   memory, headroom, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
+ *   memory, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
  *   heads-up, bg, agent-browser, agent-browser-up, providers, deploy, plugin,
  *   marketplace, plan, digest, backup, restore, clip, ocr, voice, workspace, eval
  */
@@ -133,7 +133,6 @@ function showHelp() {
     service             Manage the background service daemon
     dash <subcommand>   Manage the dashboard (start/stop/status/cleanup/tui)
     memory <subcommand> Manage project memory (Bizar Memory Service)
-    headroom <subcommand> Manage Headroom context compression
     lightrag <subcommand> Manage the LightRAG knowledge-graph server (status/start/autostart)
     minimax <subcommand>   Manage MiniMax Token Plan integration
     tailscale <subcommand> Manage Tailscale integration (auth, serve, status)
@@ -347,19 +346,6 @@ async function main() {
       break;
     }
 
-    case 'headroom': {
-      const mod = await importCommand('headroom');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load headroom command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'headroom');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
     case 'lightrag': {
       // v5.x — LightRAG management CLI (issue #6).
       // Subcommands: status, start, autostart.

package/cli/cli-commands-validation.test.mjs

@@ -25,7 +25,7 @@ const ALL_COMMANDS = [
   'install', 'update',
   'service',
   'dash', 'dashboard',
-  'minimax', 'tailscale', 'headroom', 'lightrag',
+  'minimax', 'tailscale', 'lightrag',
   'mod', 'usage',
   'deploy', 'plugin', 'marketplace',
   'artifact',

package/cli/commands/lightrag.mjs

@@ -8,7 +8,7 @@
  *                      the current working directory's project. Used by
  *                      `install.sh` and by operators who want to manually
  *                      start LightRAG without opening the dashboard.
- *   start              Alias for `autostart` (matches `headroom start`).
+ *   start              Alias for `autostart`.
  *   status             Print whether the LightRAG server is running.
  *
  * The dashboard server already auto-invokes `lightragStartupHook()` on

package/cli/commands/util.mjs

@@ -120,7 +120,7 @@ export function showDoctorHelp() {
       • 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)
+      • semble / skills on PATH (lenient — at least one)
       • dashboard reachable (skipped if no port file)
       • provider.minimax block + MiniMax model flags are sane
 

package/cli/copy.mjs

@@ -3,7 +3,7 @@ import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import ora from 'ora';
 import chalk from 'chalk';
-import { repoPath, clineConfigDir, clineAgentsDir, detectRtk, detectSemble, detectUv, detectSkillsCli } from './utils.mjs';
+import { repoPath, clineConfigDir, clineAgentsDir, detectSemble, detectUv, detectSkillsCli } from './utils.mjs';
 
 async function fileExists(path) {
   try {
@@ -341,52 +341,6 @@ export async function installPluginBizar(projectRoot) {
   }
 }
 
-export async function installHeadroom() {
-  const { execSync } = await import('node:child_process');
-
-  const already = await detectRtk();
-  if (already) {
-    const spinner = ora({ text: 'Configuring Headroom for cline...', color: 'magenta' }).start();
-    try {
-      execSync('headroom wrap cline', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('Headroom configured for cline'));
-    } catch {
-      spinner.warn(chalk.yellow('Could not auto-configure Headroom — run `headroom wrap cline` manually'));
-    }
-    return true;
-  }
-
-  const spinner = ora({ text: 'Installing Headroom (context compressor)...', color: 'magenta' }).start();
-
-  if (process.platform === 'win32') {
-    spinner.fail(chalk.red('Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"'));
-    return false;
-  }
-
-  try {
-    execSync(
-      'pip install --user "headroom-ai[all]"',
-      { stdio: 'pipe', timeout: 60000 },
-    );
-    spinner.text = 'Configuring Headroom for cline...';
-    execSync('headroom wrap cline', { stdio: 'pipe' });
-    spinner.succeed(chalk.green('Headroom installed and configured for cline'));
-    return true;
-  } catch {
-    // Fall back to npm
-    try {
-      execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
-      spinner.text = 'Configuring Headroom for cline...';
-      execSync('headroom wrap cline', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('Headroom installed (npm) and configured for cline'));
-      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;
-    }
-  }
-}
-
 export async function installSemble() {
   const { execSync } = await import('node:child_process');
 

package/cli/doctor.mjs

@@ -15,7 +15,7 @@
  *   hooks-wired:             settings.json has PreToolUse/PostToolUse/etc
  *   agent-files-installed:   agent .md files deployed
  *   skill-files-installed:   SKILL.md files deployed
- *   tools-on-path:           at least one of headroom/semble/skills/claude
+ *   tools-on-path:           at least one of semble/skills/claude
  *   memory-vault:            BIZAR_HOME exists (memory subdir lazy)
  *   9router-reachable:       provider gateway responds
  *
@@ -109,13 +109,13 @@ async function checkSkillFilesInstalled() {
 }
 
 /**
- * Lenient: passes if at least one of headroom/semble/skills is on PATH.
+ * Lenient: passes if at least one of semble/skills/claude 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 = ['headroom', 'semble', 'skills', 'claude'];
+  const tools = ['semble', 'skills', 'claude'];
   const found = tools.filter(which);
   if (found.length === 0) {
     throw new Error(`none of ${tools.join('/')} on PATH`);

package/cli/install.mjs

@@ -15,8 +15,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 
 import { showBanner, showPantheon, sectionHeading } from './banner.mjs';
 import { promptComponents, promptInstallMode, promptAgents, promptSkillPacks, promptApiKeys, promptConfirmInstall, promptRestartCline } from './prompts.mjs';
-import { detectClaude, detectHeadroom, detectSemble, detectSkillsCli, detectUv, buildSummary, claudeAgentsDir, claudeConfigDir, repoPath } from './utils.mjs';
-import { installAgents, installAgentsMd, installSkill, installClineJson, installBizarFolder, installPluginBizar, installHeadroom, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
+import { detectClaude, detectSemble, detectSkillsCli, detectUv, buildSummary, claudeAgentsDir, claudeConfigDir, repoPath } from './utils.mjs';
+import { installAgents, installAgentsMd, installSkill, installClineJson, installBizarFolder, installPluginBizar, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
 
 const AGENT_FILES = [
   'odin.md', 'vor.md', 'frigg.md', 'quick.md',
@@ -514,7 +514,7 @@ export async function runPostInstall() {
   // is a thin Claude Code-native bootstrap that:
   //   - copies `config/settings.json` template on first install
   //   - installs agents into `~/.claude/agents/`
-  //   - probes for headroom / semble / skills-cli
+  //   - probes for semble / skills-cli
   //   - installs Headroom via pip or npm
   const { mkdirSync, copyFileSync, existsSync } = await import('node:fs');
   const { execSync } = await import('node:child_process');
@@ -546,40 +546,6 @@ export async function runPostInstall() {
   }
   console.log('BizarHarness: agents installed.');
 
-  // Install Headroom
-  const headroomPresent = await detectHeadroom();
-  if (!headroomPresent) {
-    console.log('BizarHarness: installing Headroom (context compressor)...');
-    try {
-      if (process.platform === 'win32') {
-        console.log('BizarHarness: Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"');
-      } else {
-        execSync(
-          'pip install --user "headroom-ai[all]"',
-          { stdio: 'pipe', timeout: 60000 },
-        );
-        execSync('headroom wrap claude', { stdio: 'pipe' });
-        console.log('BizarHarness: Headroom installed and configured.');
-      }
-    } catch {
-      // Fall back to npm
-      try {
-        execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
-        execSync('headroom wrap claude', { 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('headroom wrap claude', { stdio: 'pipe' });
-      console.log('BizarHarness: Headroom configured for claude.');
-    } catch {
-      console.log('BizarHarness: could not configure Headroom. Run `headroom wrap claude` manually.');
-    }
-  }
-
   // Install Semble
   const semblePresent = await detectSemble();
   if (!semblePresent) {

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).
  *