publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/dist/src/discovery.js

@@ -1,280 +1,2 @@
-/**
- * CLI discovery: finds JS CLI definitions and registers them.
- *
- * Supports two modes:
- * 1. FAST PATH (manifest): If a pre-compiled cli-manifest.json exists,
- *    registers commands instantly. JS modules are loaded lazily only
- *    when their command is executed.
- * 2. FALLBACK (filesystem scan): Traditional runtime discovery for development.
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { Strategy, registerCommand } from './registry.js';
-import { getErrorMessage } from './errors.js';
-import { log } from './logger.js';
-import { findPackageRoot, getCliManifestPath } from './package-paths.js';
-/** User runtime directory: ~/.opencli */
-export const USER_OPENCLI_DIR = path.join(os.homedir(), '.opencli');
-/** User CLIs directory: ~/.opencli/clis */
-export const USER_CLIS_DIR = path.join(USER_OPENCLI_DIR, 'clis');
-/** Plugins directory: ~/.opencli/plugins/ */
-export const PLUGINS_DIR = path.join(USER_OPENCLI_DIR, 'plugins');
-/** Matches files that register commands via cli() or lifecycle hooks */
-const PLUGIN_MODULE_PATTERN = /\b(?:cli|registerSiteAuthCommands|onStartup|onBeforeExecute|onAfterExecute)\s*\(/;
-function parseStrategy(rawStrategy, fallback = Strategy.COOKIE) {
-    if (!rawStrategy)
-        return fallback;
-    const key = rawStrategy.toUpperCase();
-    return Strategy[key] ?? fallback;
-}
-const PACKAGE_ROOT = findPackageRoot(fileURLToPath(import.meta.url));
-/**
- * Ensure ~/.opencli/node_modules/@jackwener/opencli symlink exists so that
- * user CLIs in ~/.opencli/clis/ can `import { cli } from '@jackwener/opencli/registry'`.
- *
- * This is the sole resolution mechanism — adapters use package exports
- * (e.g. `@jackwener/opencli/registry`, `@jackwener/opencli/errors`) and
- * Node.js resolves them through this symlink.
- */
-export async function ensureUserCliCompatShims(baseDir = USER_OPENCLI_DIR) {
-    await fs.promises.mkdir(baseDir, { recursive: true });
-    // package.json for ESM resolution in ~/.opencli/
-    const pkgJsonPath = path.join(baseDir, 'package.json');
-    const pkgJsonContent = `${JSON.stringify({ name: 'opencli-user-runtime', private: true, type: 'module' }, null, 2)}\n`;
-    try {
-        const existing = await fs.promises.readFile(pkgJsonPath, 'utf-8');
-        if (existing !== pkgJsonContent)
-            await fs.promises.writeFile(pkgJsonPath, pkgJsonContent, 'utf-8');
-    }
-    catch {
-        await fs.promises.writeFile(pkgJsonPath, pkgJsonContent, 'utf-8');
-    }
-    // Create node_modules/@jackwener/opencli symlink pointing to the installed package root.
-    const opencliRoot = PACKAGE_ROOT;
-    const symlinkDir = path.join(baseDir, 'node_modules', '@jackwener');
-    const symlinkPath = path.join(symlinkDir, 'opencli');
-    try {
-        let needsUpdate = true;
-        try {
-            const existing = await fs.promises.readlink(symlinkPath);
-            if (existing === opencliRoot)
-                needsUpdate = false;
-        }
-        catch { /* doesn't exist */ }
-        if (needsUpdate) {
-            await fs.promises.mkdir(symlinkDir, { recursive: true });
-            try {
-                await fs.promises.rm(symlinkPath, { recursive: true, force: true });
-            }
-            catch { /* doesn't exist */ }
-            const symlinkType = process.platform === 'win32' ? 'junction' : 'dir';
-            await fs.promises.symlink(opencliRoot, symlinkPath, symlinkType);
-        }
-    }
-    catch (err) {
-        log.warn(`Could not create symlink at ${symlinkPath}: ${getErrorMessage(err)}`);
-    }
-}
-/**
- * Ensure the user adapters directory exists.
- *
- * With smart sync, ~/.opencli/clis/ only holds files that differ from the
- * package baseline (upstream-synced cache + autofix output + user overrides).
- * Built-in adapters are loaded directly from the installed package.
- */
-export async function ensureUserAdapters() {
-    await fs.promises.mkdir(USER_CLIS_DIR, { recursive: true });
-}
-/**
- * Discover and register CLI commands.
- * Uses pre-compiled manifest when available for instant startup.
- */
-export async function discoverClis(...dirs) {
-    // Fast path: try manifest first (production / post-build)
-    for (const dir of dirs) {
-        const manifestPath = getCliManifestPath(dir);
-        try {
-            await fs.promises.access(manifestPath);
-            const loaded = await loadFromManifest(manifestPath, dir);
-            if (loaded)
-                continue; // Skip filesystem scan only when manifest is usable
-        }
-        catch {
-            // Fall through to filesystem scan
-        }
-        await discoverClisFromFs(dir);
-    }
-}
-/**
- * Fast-path: register commands from pre-compiled manifest.
- * TS modules are deferred — loaded lazily on first execution.
- */
-async function loadFromManifest(manifestPath, clisDir) {
-    try {
-        const raw = await fs.promises.readFile(manifestPath, 'utf-8');
-        const manifest = JSON.parse(raw);
-        for (const entry of manifest) {
-            if (!entry.modulePath)
-                continue;
-            const modulePath = path.resolve(clisDir, entry.modulePath);
-            const cmd = {
-                site: entry.site,
-                name: entry.name,
-                aliases: entry.aliases,
-                description: entry.description ?? '',
-                access: entry.access,
-                example: entry.example,
-                domain: entry.domain,
-                strategy: parseStrategy(entry.strategy),
-                browser: entry.browser,
-                args: entry.args ?? [],
-                columns: entry.columns,
-                defaultFormat: entry.defaultFormat,
-                pipeline: entry.pipeline,
-                source: entry.sourceFile ? path.resolve(clisDir, entry.sourceFile) : modulePath,
-                navigateBefore: entry.navigateBefore,
-                siteSession: entry.siteSession,
-                defaultWindowMode: entry.defaultWindowMode,
-                _lazy: true,
-                _modulePath: modulePath,
-            };
-            // normalizeCommand inside registerCommand handles strategy → browser/navigateBefore
-            registerCommand(cmd);
-        }
-        return true;
-    }
-    catch (err) {
-        log.warn(`Failed to load manifest ${manifestPath}: ${getErrorMessage(err)}`);
-        return false;
-    }
-}
-/**
- * Fallback: traditional filesystem scan (used during development with tsx).
- */
-async function discoverClisFromFs(dir) {
-    try {
-        await fs.promises.access(dir);
-    }
-    catch {
-        return;
-    }
-    const entries = await fs.promises.readdir(dir, { withFileTypes: true });
-    const sitePromises = entries
-        .filter(entry => entry.isDirectory())
-        .map(async (entry) => {
-        const site = entry.name;
-        const siteDir = path.join(dir, site);
-        const files = await fs.promises.readdir(siteDir);
-        await Promise.all(files.map(async (file) => {
-            const filePath = path.join(siteDir, file);
-            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-                return;
-            }
-            if (file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts')) {
-                log.warn(`Ignoring TypeScript adapter ${filePath} — .ts adapters are no longer loaded. Rename to .js or convert to JavaScript.`);
-                return;
-            }
-            if (file.endsWith('.js') && !file.endsWith('.d.js') && !file.endsWith('.test.js')) {
-                if (!(await isCliModule(filePath)))
-                    return;
-                await import(pathToFileURL(filePath).href).catch((err) => {
-                    log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);
-                });
-            }
-        }));
-    });
-    await Promise.all(sitePromises);
-}
-/**
- * Discover and register plugins from ~/.opencli/plugins/.
- * Each subdirectory is treated as a plugin (site = directory name).
- * Files inside are scanned flat (no nested site subdirs).
- */
-export async function discoverPlugins() {
-    try {
-        await fs.promises.access(PLUGINS_DIR);
-    }
-    catch {
-        return;
-    }
-    const entries = await fs.promises.readdir(PLUGINS_DIR, { withFileTypes: true });
-    await Promise.all(entries.map(async (entry) => {
-        const pluginDir = path.join(PLUGINS_DIR, entry.name);
-        if (!(await isDiscoverablePluginDir(entry, pluginDir)))
-            return;
-        await discoverPluginDir(pluginDir, entry.name);
-    }));
-}
-/**
- * Flat scan: read ts/js files directly in a plugin directory.
- * Unlike discoverClisFromFs, this does NOT expect nested site subdirectories.
- */
-async function discoverPluginDir(dir, site) {
-    let files;
-    try {
-        files = await fs.promises.readdir(dir);
-    }
-    catch (err) {
-        // The directory can disappear between the parent scan and this read
-        // (e.g. a concurrent `opencli plugin remove`). Mirror the broken-symlink
-        // handling in isDiscoverablePluginDir: treat a vanished directory as
-        // "no plugin here" rather than letting startup crash.
-        const code = err.code;
-        if (code !== 'ENOENT' && code !== 'ENOTDIR') {
-            log.warn(`Failed to scan plugin directory ${dir}: ${getErrorMessage(err)}`);
-        }
-        return;
-    }
-    const fileSet = new Set(files);
-    await Promise.all(files.map(async (file) => {
-        const filePath = path.join(dir, file);
-        if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-            return;
-        }
-        if (file.endsWith('.js') && !file.endsWith('.d.js')) {
-            if (!(await isCliModule(filePath)))
-                return;
-            await import(pathToFileURL(filePath).href).catch((err) => {
-                log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
-            });
-        }
-        else if (file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts')) {
-            const jsFile = file.replace(/\.ts$/, '.js');
-            // Prefer compiled .js — skip the .ts source file
-            if (fileSet.has(jsFile))
-                return;
-            // No compiled .js found — cannot import raw .ts in production Node.js.
-            // This typically means esbuild transpilation failed during plugin install.
-            log.warn(`Plugin ${site}/${file}: no compiled .js found. ` +
-                `Run "opencli plugin update ${site}" to re-transpile, or install esbuild.`);
-        }
-    }));
-}
-async function isCliModule(filePath) {
-    try {
-        const source = await fs.promises.readFile(filePath, 'utf-8');
-        return PLUGIN_MODULE_PATTERN.test(source);
-    }
-    catch (err) {
-        log.warn(`Failed to inspect module ${filePath}: ${getErrorMessage(err)}`);
-        return false;
-    }
-}
-async function isDiscoverablePluginDir(entry, pluginDir) {
-    if (entry.isDirectory())
-        return true;
-    if (!entry.isSymbolicLink())
-        return false;
-    try {
-        return (await fs.promises.stat(pluginDir)).isDirectory();
-    }
-    catch (err) {
-        const code = err.code;
-        if (code !== 'ENOENT' && code !== 'ENOTDIR') {
-            log.warn(`Failed to inspect plugin link ${pluginDir}: ${getErrorMessage(err)}`);
-        }
-        return false;
-    }
-}
+import*as H from"node:fs";import*as G from"node:os";import*as Y from"node:path";import{fileURLToPath as F,pathToFileURL as v}from"node:url";import{Strategy as A,registerCommand as J}from"./registry.js";import{getErrorMessage as $}from"./errors.js";import{log as Z}from"./logger.js";import{findPackageRoot as O,getCliManifestPath as N}from"./package-paths.js";export const USER_OPENCLI_DIR=Y.join(G.homedir(),".opencli"),USER_CLIS_DIR=Y.join(USER_OPENCLI_DIR,"clis"),PLUGINS_DIR=Y.join(USER_OPENCLI_DIR,"plugins");const T=/\b(?:cli|registerSiteAuthCommands|onStartup|onBeforeExecute|onAfterExecute)\s*\(/;function b(z,x=A.COOKIE){if(!z)return x;const B=z.toUpperCase();return A[B]??x}const L=O(F(import.meta.url));export async function ensureUserCliCompatShims(z=USER_OPENCLI_DIR){await H.promises.mkdir(z,{recursive:!0});const x=Y.join(z,"package.json"),B=`${JSON.stringify({name:"opencli-user-runtime",private:!0,type:"module"},null,2)}
+`;try{if(await H.promises.readFile(x,"utf-8")!==B)await H.promises.writeFile(x,B,"utf-8")}catch{await H.promises.writeFile(x,B,"utf-8")}const V=L,q=Y.join(z,"node_modules","@jackwener"),Q=Y.join(q,"opencli");try{let W=!0;try{if(await H.promises.readlink(Q)===V)W=!1}catch{}if(W){await H.promises.mkdir(q,{recursive:!0});try{await H.promises.rm(Q,{recursive:!0,force:!0})}catch{}const X=process.platform==="win32"?"junction":"dir";await H.promises.symlink(V,Q,X)}}catch(W){Z.warn(`Could not create symlink at ${Q}: ${$(W)}`)}}export async function ensureUserAdapters(){await H.promises.mkdir(USER_CLIS_DIR,{recursive:!0})}export async function discoverClis(...z){for(const x of z){const B=N(x);try{await H.promises.access(B);if(await M(B,x))continue}catch{}await C(x)}}async function M(z,x){try{const B=await H.promises.readFile(z,"utf-8"),V=JSON.parse(B);for(const q of V){if(!q.modulePath)continue;const Q=Y.resolve(x,q.modulePath),W={site:q.site,name:q.name,aliases:q.aliases,description:q.description??"",access:q.access,example:q.example,domain:q.domain,strategy:b(q.strategy),browser:q.browser,args:q.args??[],columns:q.columns,defaultFormat:q.defaultFormat,pipeline:q.pipeline,source:q.sourceFile?Y.resolve(x,q.sourceFile):Q,navigateBefore:q.navigateBefore,siteSession:q.siteSession,defaultWindowMode:q.defaultWindowMode,_lazy:!0,_modulePath:Q};J(W)}return!0}catch(B){Z.warn(`Failed to load manifest ${z}: ${$(B)}`);return!1}}async function C(z){try{await H.promises.access(z)}catch{return}const B=(await H.promises.readdir(z,{withFileTypes:!0})).filter((V)=>V.isDirectory()).map(async(V)=>{const q=V.name,Q=Y.join(z,q),W=await H.promises.readdir(Q);await Promise.all(W.map(async(X)=>{const K=Y.join(Q,X);if(X.endsWith(".yaml")||X.endsWith(".yml"))return;if(X.endsWith(".ts")&&!X.endsWith(".d.ts")&&!X.endsWith(".test.ts")){Z.warn(`Ignoring TypeScript adapter ${K} — .ts adapters are no longer loaded. Rename to .js or convert to JavaScript.`);return}if(X.endsWith(".js")&&!X.endsWith(".d.js")&&!X.endsWith(".test.js")){if(!await j(K))return;await import(v(K).href).catch((w)=>{Z.warn(`Failed to load module ${K}: ${$(w)}`)})}}))});await Promise.all(B)}export async function discoverPlugins(){try{await H.promises.access(PLUGINS_DIR)}catch{return}const z=await H.promises.readdir(PLUGINS_DIR,{withFileTypes:!0});await Promise.all(z.map(async(x)=>{const B=Y.join(PLUGINS_DIR,x.name);if(!await _(x,B))return;await U(B,x.name)}))}async function U(z,x){let B;try{B=await H.promises.readdir(z)}catch(q){const Q=q.code;if(Q!=="ENOENT"&&Q!=="ENOTDIR")Z.warn(`Failed to scan plugin directory ${z}: ${$(q)}`);return}const V=new Set(B);await Promise.all(B.map(async(q)=>{const Q=Y.join(z,q);if(q.endsWith(".yaml")||q.endsWith(".yml"))return;if(q.endsWith(".js")&&!q.endsWith(".d.js")){if(!await j(Q))return;await import(v(Q).href).catch((W)=>{Z.warn(`Plugin ${x}/${q}: ${$(W)}`)})}else if(q.endsWith(".ts")&&!q.endsWith(".d.ts")&&!q.endsWith(".test.ts")){const W=q.replace(/\.ts$/,".js");if(V.has(W))return;Z.warn(`Plugin ${x}/${q}: no compiled .js found. Run "opencli plugin update ${x}" to re-transpile, or install esbuild.`)}}))}async function j(z){try{const x=await H.promises.readFile(z,"utf-8");return T.test(x)}catch(x){Z.warn(`Failed to inspect module ${z}: ${$(x)}`);return!1}}async function _(z,x){if(z.isDirectory())return!0;if(!z.isSymbolicLink())return!1;try{return(await H.promises.stat(x)).isDirectory()}catch(B){const V=B.code;if(V!=="ENOENT"&&V!=="ENOTDIR")Z.warn(`Failed to inspect plugin link ${x}: ${$(B)}`);return!1}}

package/dist/src/doctor.js

@@ -1,230 +1,17 @@
-/**
- * opencli doctor — diagnose browser connectivity.
- *
- * Simplified for the daemon-based architecture.
- */
-import { DEFAULT_DAEMON_PORT } from './constants.js';
-import { BrowserBridge } from './browser/index.js';
-import { getDaemonHealth } from './browser/daemon-client.js';
-import { getErrorMessage } from './errors.js';
-import { getRuntimeLabel } from './runtime-detect.js';
-import { getCachedLatestExtensionVersion } from './update-check.js';
-import { aliasForContextId, loadProfileConfig } from './browser/profile.js';
-import { formatDaemonVersion, isDaemonStale, staleDaemonIssue } from './browser/daemon-version.js';
-import { findShadowedUserAdapters, formatAdapterShadowIssue } from './adapter-shadow.js';
-const DOCTOR_LIVE_TIMEOUT_SECONDS = 8;
-const DOCTOR_SESSION = '__doctor__';
-/** Parse a semver string into [major, minor, patch]. Returns null on invalid input. */
-function parseSemver(v) {
-    const parts = v.replace(/^v/, '').split('-')[0].split('.').map(Number);
-    if (parts.length < 3 || parts.some(isNaN))
-        return null;
-    return [parts[0], parts[1], parts[2]];
-}
-/** Returns true if `a` is strictly newer than `b`. */
-function isNewerVersion(a, b) {
-    const va = parseSemver(a);
-    const vb = parseSemver(b);
-    if (!va || !vb)
-        return false;
-    const cmp = va[0] - vb[0] || va[1] - vb[1] || va[2] - vb[2];
-    return cmp > 0;
-}
-/** Check if version satisfies a simple range like ">=1.7.0". */
-function satisfiesRange(version, range) {
-    const match = range.match(/^(>=?)\s*(\S+)$/);
-    if (!match)
-        return true; // Unknown range format — don't block
-    const [, op, rangeVer] = match;
-    const v = parseSemver(version);
-    const r = parseSemver(rangeVer);
-    if (!v || !r)
-        return true;
-    const cmp = v[0] - r[0] || v[1] - r[1] || v[2] - r[2];
-    return op === '>=' ? cmp >= 0 : cmp > 0;
-}
-/**
- * Test connectivity by attempting a real browser command.
- */
-export async function checkConnectivity(opts) {
-    const start = Date.now();
-    try {
-        const bridge = new BrowserBridge();
-        const page = await bridge.connect({
-            timeout: opts?.timeout ?? DOCTOR_LIVE_TIMEOUT_SECONDS,
-            session: DOCTOR_SESSION,
-            surface: 'browser',
-        });
-        try {
-            // Try a simple eval to verify end-to-end connectivity.
-            await page.evaluate('1 + 1');
-            await page.closeWindow?.();
-        }
-        finally {
-            await bridge.close();
-        }
-        return { ok: true, durationMs: Date.now() - start };
-    }
-    catch (err) {
-        return { ok: false, error: getErrorMessage(err), durationMs: Date.now() - start };
-    }
-}
-export async function runBrowserDoctor(opts = {}) {
-    // Live connectivity check is the core of doctor — it doubles as auto-start
-    // (bridge.connect spawns daemon) and validates end-to-end browser bridge health.
-    const connectivity = await checkConnectivity();
-    // Single status read *after* connectivity side-effects settle.
-    const health = await getDaemonHealth();
-    const daemonRunning = health.state !== 'stopped';
-    const extensionConnected = health.state === 'ready';
-    const daemonFlaky = connectivity.ok && !daemonRunning;
-    const extensionFlaky = connectivity.ok && daemonRunning && !extensionConnected;
-    const daemonStale = isDaemonStale(health.status, opts.cliVersion);
-    const profiles = health.status?.profiles;
-    const extensionVersion = health.status?.extensionVersion;
-    const adapterShadows = findShadowedUserAdapters();
-    const issues = [];
-    if (daemonFlaky) {
-        issues.push('Daemon connectivity is unstable. The live browser test succeeded, but the daemon was no longer running immediately afterward.\n' +
-            'This usually means the daemon crashed or exited right after serving the live probe.');
-    }
-    else if (!daemonRunning) {
-        issues.push('Daemon is not running. It should start automatically when you run an opencli browser command.');
-    }
-    if (daemonStale && opts.cliVersion) {
-        issues.push(staleDaemonIssue(health.status, opts.cliVersion));
-    }
-    if (extensionFlaky) {
-        issues.push('Extension connection is unstable. The live browser test succeeded, but the daemon reported the extension disconnected immediately afterward.\n' +
-            'This usually means the Browser Bridge service worker is reconnecting slowly or Chrome suspended it.');
-    }
-    else if (daemonRunning && !extensionConnected) {
-        if (health.state === 'profile-required') {
-            issues.push('Multiple Chrome profiles are connected to the daemon, but no default profile was selected.\n' +
-                '  Run opencli profile list, then opencli profile use <name>, or pass --profile <name>.');
-        }
-        else if (health.state === 'profile-disconnected') {
-            issues.push(`Selected browser profile is not connected: ${health.status?.contextId ?? 'unknown'}.\n` +
-                '  Open that Chrome profile and make sure the OpenCLI extension is enabled.');
-        }
-        else {
-            issues.push('Daemon is running but the Chrome/Chromium extension is not connected.\n' +
-                'If the extension is already installed, try: opencli daemon restart\n' +
-                'If the extension is not installed:\n' +
-                '  1. Download from https://github.com/jackwener/opencli/releases\n' +
-                '  2. Open chrome://extensions/ → Enable Developer Mode\n' +
-                '  3. Click "Load unpacked" → select the extension folder');
-        }
-    }
-    if (extensionConnected && !extensionVersion) {
-        issues.push('Extension is connected but did not report a version.\n' +
-            '  This usually means an outdated Browser Bridge extension.\n' +
-            '  Reload or reinstall the extension from: https://github.com/jackwener/opencli/releases');
-    }
-    if (!connectivity.ok) {
-        issues.push(`Browser connectivity test failed: ${connectivity.error ?? 'unknown'}`);
-    }
-    const extensionCompatRange = health.status?.extensionCompatRange;
-    if (extensionVersion && opts.cliVersion && extensionCompatRange) {
-        if (!satisfiesRange(opts.cliVersion, extensionCompatRange)) {
-            issues.push(`CLI version incompatible with extension: extension v${extensionVersion} requires CLI ${extensionCompatRange}, but CLI is v${opts.cliVersion}\n` +
-                '  Update the CLI: npm install -g @jackwener/opencli\n' +
-                '  Or download a compatible extension from: https://github.com/jackwener/opencli/releases');
-        }
-    }
-    else if (extensionVersion && opts.cliVersion) {
-        // Fallback for older extensions that don't send compatRange
-        const extMajor = extensionVersion.split('.')[0];
-        const cliMajor = opts.cliVersion.split('.')[0];
-        if (extMajor !== cliMajor) {
-            issues.push(`Extension major version mismatch: extension v${extensionVersion} ≠ CLI v${opts.cliVersion}\n` +
-                '  Download the latest extension from: https://github.com/jackwener/opencli/releases');
-        }
-    }
-    // Extension update check (from cached background fetch)
-    const latestExtensionVersion = getCachedLatestExtensionVersion();
-    if (extensionVersion && latestExtensionVersion && isNewerVersion(latestExtensionVersion, extensionVersion)) {
-        issues.push(`Extension update available: v${extensionVersion} → v${latestExtensionVersion}\n` +
-            '  Download from: https://github.com/jackwener/opencli/releases');
-    }
-    if (adapterShadows.length > 0) {
-        issues.push(formatAdapterShadowIssue(adapterShadows));
-    }
-    return {
-        cliVersion: opts.cliVersion,
-        daemonRunning,
-        daemonFlaky,
-        daemonStale,
-        daemonVersion: health.status?.daemonVersion,
-        extensionConnected,
-        extensionFlaky,
-        extensionVersion,
-        latestExtensionVersion,
-        connectivity,
-        profiles,
-        adapterShadows,
-        issues,
-    };
-}
-export function renderBrowserDoctorReport(report) {
-    const lines = [`opencli v${report.cliVersion ?? 'unknown'} doctor` + ` (${getRuntimeLabel()})`, ''];
-    // Daemon status
-    const daemonIcon = report.daemonFlaky
-        ? '[WARN]'
-        : report.daemonStale
-            ? '[WARN]'
-            : report.daemonRunning ? '[OK]' : '[MISSING]';
-    const daemonLabel = report.daemonFlaky
-        ? 'unstable (running during live check, then stopped)'
-        : report.daemonRunning
-            ? `running on port ${DEFAULT_DAEMON_PORT} (${report.daemonStale
-                ? `${formatDaemonVersion(report)}, stale; CLI v${report.cliVersion ?? 'unknown'}`
-                : formatDaemonVersion(report)})`
-            : 'not running';
-    lines.push(`${daemonIcon} Daemon: ${daemonLabel}`);
-    // Extension status
-    const extIcon = report.extensionFlaky || (report.extensionConnected && !report.extensionVersion)
-        ? '[WARN]'
-        : report.extensionConnected ? '[OK]' : '[MISSING]';
-    const extUpdateHint = report.extensionVersion && report.latestExtensionVersion && isNewerVersion(report.latestExtensionVersion, report.extensionVersion)
-        ? ` → v${report.latestExtensionVersion} available`
-        : '';
-    const extVersion = !report.extensionConnected
-        ? ''
-        : report.extensionVersion
-            ? ` (v${report.extensionVersion})` + extUpdateHint
-            : ' (version unknown)';
-    const extLabel = report.extensionFlaky
-        ? 'unstable (connected during live check, then disconnected)'
-        : report.extensionConnected ? 'connected' : 'not connected';
-    lines.push(`${extIcon} Extension: ${extLabel}${extVersion}`);
-    if (report.profiles && report.profiles.length > 0) {
-        const config = loadProfileConfig();
-        lines.push('', 'Profiles:');
-        for (const profile of report.profiles) {
-            const alias = aliasForContextId(config, profile.contextId);
-            const aliasText = alias ? ` (${alias})` : '';
-            const defaultText = config.defaultContextId === profile.contextId ? ', default' : '';
-            const version = profile.extensionVersion ? `v${profile.extensionVersion}` : 'version unknown';
-            lines.push(`  • ${profile.contextId}${aliasText}: connected ${version}${defaultText}`);
-        }
-    }
-    // Connectivity
-    if (report.connectivity) {
-        const connIcon = report.connectivity.ok ? '[OK]' : '[FAIL]';
-        const detail = report.connectivity.ok
-            ? `connected in ${(report.connectivity.durationMs / 1000).toFixed(1)}s`
-            : `failed (${report.connectivity.error ?? 'unknown'})`;
-        lines.push(`${connIcon} Connectivity: ${detail}`);
-    }
-    if (report.issues.length) {
-        lines.push('', 'Issues:');
-        for (const issue of report.issues) {
-            lines.push(`  • ${issue}`);
-        }
-    }
-    else if (report.daemonRunning && report.extensionConnected) {
-        lines.push('', 'Everything looks good!');
-    }
-    return lines.join('\n');
-}
+import{DEFAULT_DAEMON_PORT as L}from"./constants.js";import{BrowserBridge as _}from"./browser/index.js";import{getDaemonHealth as k}from"./browser/daemon-client.js";import{getErrorMessage as T}from"./errors.js";import{getRuntimeLabel as I}from"./runtime-detect.js";import{getCachedLatestExtensionVersion as O}from"./update-check.js";import{aliasForContextId as j,loadProfileConfig as y}from"./browser/profile.js";import{formatDaemonVersion as U,isDaemonStale as D,staleDaemonIssue as w}from"./browser/daemon-version.js";import{findShadowedUserAdapters as R,formatAdapterShadowIssue as E}from"./adapter-shadow.js";const C=8,b="__doctor__";function A(q){const z=q.replace(/^v/,"").split("-")[0].split(".").map(Number);if(z.length<3||z.some(isNaN))return null;return[z[0],z[1],z[2]]}function M(q,z){const G=A(q),K=A(z);if(!G||!K)return!1;return(G[0]-K[0]||G[1]-K[1]||G[2]-K[2])>0}function S(q,z){const G=z.match(/^(>=?)\s*(\S+)$/);if(!G)return!0;const[,K,W]=G,X=A(q),Y=A(W);if(!X||!Y)return!0;const $=X[0]-Y[0]||X[1]-Y[1]||X[2]-Y[2];return K===">="?$>=0:$>0}export async function checkConnectivity(q){const z=Date.now();try{const G=new _,K=await G.connect({timeout:q?.timeout??C,session:b,surface:"browser"});try{await K.evaluate("1 + 1");await K.closeWindow?.()}finally{await G.close()}return{ok:!0,durationMs:Date.now()-z}}catch(G){return{ok:!1,error:T(G),durationMs:Date.now()-z}}}export async function runBrowserDoctor(q={}){const z=await checkConnectivity(),G=await k(),K=G.state!=="stopped",W=G.state==="ready",X=z.ok&&!K,Y=z.ok&&K&&!W,$=D(G.status,q.cliVersion),Z=G.status?.profiles,J=G.status?.extensionVersion,B=R(),Q=[];if(X)Q.push(`Daemon connectivity is unstable. The live browser test succeeded, but the daemon was no longer running immediately afterward.
+This usually means the daemon crashed or exited right after serving the live probe.`);else if(!K)Q.push("Daemon is not running. It should start automatically when you run an opencli browser command.");if($&&q.cliVersion)Q.push(w(G.status,q.cliVersion));if(Y)Q.push(`Extension connection is unstable. The live browser test succeeded, but the daemon reported the extension disconnected immediately afterward.
+This usually means the Browser Bridge service worker is reconnecting slowly or Chrome suspended it.`);else if(K&&!W)if(G.state==="profile-required")Q.push(`Multiple Chrome profiles are connected to the daemon, but no default profile was selected.
+  Run opencli profile list, then opencli profile use <name>, or pass --profile <name>.`);else if(G.state==="profile-disconnected")Q.push(`Selected browser profile is not connected: ${G.status?.contextId??"unknown"}.
+  Open that Chrome profile and make sure the OpenCLI extension is enabled.`);else Q.push(`Daemon is running but the Chrome/Chromium extension is not connected.
+If the extension is already installed, try: opencli daemon restart
+If the extension is not installed:
+  1. Download from https://github.com/jackwener/opencli/releases
+`+`  2. Open chrome://extensions/ → Enable Developer Mode
+`+'  3. Click "Load unpacked" → select the extension folder');if(W&&!J)Q.push(`Extension is connected but did not report a version.
+  This usually means an outdated Browser Bridge extension.
+  Reload or reinstall the extension from: https://github.com/jackwener/opencli/releases`);if(!z.ok)Q.push(`Browser connectivity test failed: ${z.error??"unknown"}`);const P=G.status?.extensionCompatRange;if(J&&q.cliVersion&&P){if(!S(q.cliVersion,P))Q.push(`CLI version incompatible with extension: extension v${J} requires CLI ${P}, but CLI is v${q.cliVersion}
+  Update the CLI: npm install -g @jackwener/opencli
+  Or download a compatible extension from: https://github.com/jackwener/opencli/releases`)}else if(J&&q.cliVersion){const N=J.split(".")[0],F=q.cliVersion.split(".")[0];if(N!==F)Q.push(`Extension major version mismatch: extension v${J} ≠ CLI v${q.cliVersion}
+  Download the latest extension from: https://github.com/jackwener/opencli/releases`)}const H=O();if(J&&H&&M(H,J))Q.push(`Extension update available: v${J} → v${H}
+  Download from: https://github.com/jackwener/opencli/releases`);if(B.length>0)Q.push(E(B));return{cliVersion:q.cliVersion,daemonRunning:K,daemonFlaky:X,daemonStale:$,daemonVersion:G.status?.daemonVersion,extensionConnected:W,extensionFlaky:Y,extensionVersion:J,latestExtensionVersion:H,connectivity:z,profiles:Z,adapterShadows:B,issues:Q}}export function renderBrowserDoctorReport(q){const z=[`opencli v${q.cliVersion??"unknown"} doctor (${I()})`,""],G=q.daemonFlaky?"[WARN]":q.daemonStale?"[WARN]":q.daemonRunning?"[OK]":"[MISSING]",K=q.daemonFlaky?"unstable (running during live check, then stopped)":q.daemonRunning?`running on port ${L} (${q.daemonStale?`${U(q)}, stale; CLI v${q.cliVersion??"unknown"}`:U(q)})`:"not running";z.push(`${G} Daemon: ${K}`);const W=q.extensionFlaky||q.extensionConnected&&!q.extensionVersion?"[WARN]":q.extensionConnected?"[OK]":"[MISSING]",X=q.extensionVersion&&q.latestExtensionVersion&&M(q.latestExtensionVersion,q.extensionVersion)?` → v${q.latestExtensionVersion} available`:"",Y=!q.extensionConnected?"":q.extensionVersion?` (v${q.extensionVersion})`+X:" (version unknown)",$=q.extensionFlaky?"unstable (connected during live check, then disconnected)":q.extensionConnected?"connected":"not connected";z.push(`${W} Extension: ${$}${Y}`);if(q.profiles&&q.profiles.length>0){const Z=y();z.push("","Profiles:");for(const J of q.profiles){const B=j(Z,J.contextId),Q=B?` (${B})`:"",P=Z.defaultContextId===J.contextId?", default":"",H=J.extensionVersion?`v${J.extensionVersion}`:"version unknown";z.push(`  • ${J.contextId}${Q}: connected ${H}${P}`)}}if(q.connectivity){const Z=q.connectivity.ok?"[OK]":"[FAIL]",J=q.connectivity.ok?`connected in ${(q.connectivity.durationMs/1000).toFixed(1)}s`:`failed (${q.connectivity.error??"unknown"})`;z.push(`${Z} Connectivity: ${J}`)}if(q.issues.length){z.push("","Issues:");for(const Z of q.issues)z.push(`  • ${Z}`)}else if(q.daemonRunning&&q.extensionConnected)z.push("","Everything looks good!");return z.join(`
+`)}