refactor: kill CDP naming, delete chrome-launcher.ts dead code

The connectCDP() method and connectionMode: 'cdp' naming was a legacy
artifact — real Chrome was tried but failed (silently blocks
--load-extension), so the implementation already used Playwright's
bundled Chromium via launchPersistentContext(). The naming was
misleading.

Changes:
- Delete chrome-launcher.ts (361 LOC) — only import was in unreachable
  attemptReconnect() method
- Delete dead attemptReconnect() and reconnecting field
- Delete preExistingTabIds (was for protecting real Chrome tabs we
  never connect to)
- Rename connectCDP() → launchHeaded()
- Rename connectionMode: 'cdp' → 'headed' across all files
- Replace BROWSE_CDP_URL/BROWSE_CDP_PORT env vars with BROWSE_HEADED=1
- Regenerate SKILL.md files for updated command descriptions
- Move BrowserManager unit tests to browser-manager-unit.test.ts

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-03-22 21:21:19 -07:00
parent 08356929b3
commit 28bc69aba9
11 changed files with 79 additions and 618 deletions
+17
View File
@@ -0,0 +1,17 @@
import { describe, it, expect } from 'bun:test';
// ─── BrowserManager basic unit tests ─────────────────────────────
describe('BrowserManager defaults', () => {
it('getConnectionMode defaults to launched', async () => {
const { BrowserManager } = await import('../src/browser-manager');
const bm = new BrowserManager();
expect(bm.getConnectionMode()).toBe('launched');
});
it('getRefMap returns empty array initially', async () => {
const { BrowserManager } = await import('../src/browser-manager');
const bm = new BrowserManager();
expect(bm.getRefMap()).toEqual([]);
});
});
-145
View File
@@ -1,145 +0,0 @@
import { describe, it, expect, mock, beforeEach } from 'bun:test';
import {
findBrowserBinary,
findInstalledBrowsers,
isCdpAvailable,
getCdpWebSocketUrl,
findCdpPort,
BROWSER_BINARIES,
} from '../src/chrome-launcher';
// ─── chrome-launcher unit tests ─────────────────────────────────
describe('findBrowserBinary', () => {
it('finds Chrome by alias', () => {
const result = findBrowserBinary('chrome');
expect(result).not.toBeNull();
expect(result!.name).toBe('Chrome');
});
it('finds Chrome by name (case-insensitive)', () => {
const result = findBrowserBinary('Chrome');
expect(result).not.toBeNull();
expect(result!.name).toBe('Chrome');
});
it('finds Comet by alias', () => {
const result = findBrowserBinary('comet');
expect(result).not.toBeNull();
expect(result!.name).toBe('Comet');
});
it('finds Comet by perplexity alias', () => {
const result = findBrowserBinary('perplexity');
expect(result).not.toBeNull();
expect(result!.name).toBe('Comet');
});
it('returns null for unknown browser', () => {
expect(findBrowserBinary('netscape')).toBeNull();
});
it('returns null for empty string', () => {
expect(findBrowserBinary('')).toBeNull();
});
});
describe('BROWSER_BINARIES', () => {
it('has correct priority order (Comet first)', () => {
expect(BROWSER_BINARIES[0].name).toBe('Comet');
expect(BROWSER_BINARIES[1].name).toBe('Chrome');
});
it('all entries have required fields', () => {
for (const browser of BROWSER_BINARIES) {
expect(browser.name).toBeTruthy();
expect(browser.binary).toContain('/Applications/');
expect(browser.appName).toBeTruthy();
expect(browser.aliases.length).toBeGreaterThan(0);
}
});
});
describe('isCdpAvailable', () => {
it('returns false for port with no listener', async () => {
// Port 19999 should not have anything listening
const result = await isCdpAvailable(19999);
expect(result.available).toBe(false);
expect(result.wsUrl).toBeUndefined();
});
it('returns false for invalid port', async () => {
const result = await isCdpAvailable(0);
expect(result.available).toBe(false);
});
});
describe('getCdpWebSocketUrl', () => {
it('throws for unavailable port', async () => {
await expect(getCdpWebSocketUrl(19999)).rejects.toThrow('No CDP endpoint');
});
});
describe('findCdpPort', () => {
it('returns null when no CDP ports are available', async () => {
// This test passes in CI where no Chrome is running with debug port
// In local dev with debug port open, it would find one
const result = await findCdpPort();
// Either null (no CDP) or valid result — both are correct
if (result !== null) {
expect(result.port).toBeGreaterThan(0);
expect(result.wsUrl).toContain('ws://');
}
});
});
// ─── Runtime Detection ──────────────────────────────────────────
describe('detectRuntime', () => {
it('returns a valid runtime type', async () => {
const { detectRuntime } = await import('../src/chrome-launcher');
const runtime = detectRuntime();
expect(['conductor', 'claude-code', 'codex', 'terminal']).toContain(runtime);
});
});
describe('canManageApps', () => {
it('returns a boolean', async () => {
const { canManageApps } = await import('../src/chrome-launcher');
expect(typeof canManageApps()).toBe('boolean');
});
});
describe('isManualRestart', () => {
it('detects manual restart objects', async () => {
const { isManualRestart, BROWSER_BINARIES } = await import('../src/chrome-launcher');
const manualResult = {
needsManualRestart: true as const,
browser: BROWSER_BINARIES[0],
port: 9222,
reason: 'test',
command: 'test',
};
// isManualRestart is not directly exported, but we can test the type guard
expect(manualResult.needsManualRestart).toBe(true);
});
});
// ─── BrowserManager CDP mode guards ─────────────────────────────
describe('BrowserManager CDP mode', () => {
// These tests verify the mode guard logic without actually connecting
// to a real browser. We test the public interface.
it('getConnectionMode defaults to launched', async () => {
const { BrowserManager } = await import('../src/browser-manager');
const bm = new BrowserManager();
expect(bm.getConnectionMode()).toBe('launched');
});
it('getRefMap returns empty array initially', async () => {
const { BrowserManager } = await import('../src/browser-manager');
const bm = new BrowserManager();
expect(bm.getRefMap()).toEqual([]);
});
});