cssprobe-cli 0.2.6 → 0.2.8

package/dist/cli/program.js

@@ -12,9 +12,7 @@ const command_1 = require("./command");
 const commands_1 = require("./commands");
 const output_1 = require("./output");
 const config_1 = require("../config/config");
-const launcher_1 = require("../browser/launcher");
-const analyzer_1 = require("../engine/analyzer");
-const renderer_1 = require("../engine/renderer");
+const session_1 = require("../daemon/session");
 const globalOptions = ['json', 'raw', 'help', 'h', 'version', 'v', 'p', 'profile'];
 const booleanGlobalOptions = ['help', 'json', 'raw', 'version', 'v', 'h'];
 async function program() {
@@ -39,19 +37,33 @@ async function program() {
         return;
     if (handleSkillCommands(commandName, command, rawArgs, output))
         return;
-    if (commandName === 'login') {
-        await handleLogin(command, cmdEntry, rawArgs, output);
-        return;
-    }
-    if (commandName === 'state-import') {
-        await handleStateImport(command, cmdEntry, rawArgs, output);
-        return;
-    }
-    if (commandName === 'interactive') {
-        await handleInteractive(command, cmdEntry, rawArgs, output);
-        return;
+    // Session-based commands
+    switch (commandName) {
+        case 'open':
+            await handleOpen(command, rawArgs, output);
+            return;
+        case 'close':
+            await handleClose(output);
+            return;
+        case 'status':
+            await handleStatus(output);
+            return;
+        case 'state-import':
+            await handleStateImport(command, rawArgs, output);
+            return;
+        case 'inspect':
+        case 'tree':
+        case 'layout':
+        case 'findings':
+        case 'inject-css':
+        case 'screenshot':
+        case 'eval':
+        case 'resize':
+        case 'playwright':
+            await handleSessionCommand(commandName, command, rawArgs, output);
+            return;
     }
-    await handleInspect(command, cmdEntry, rawArgs, output);
+    output.error(`Unknown command: ${commandName}. Run 'cssprobe-cli --help' for usage.`);
 }
 function parseArgs(help) {
     return (0, minimist_1.minimist)(process.argv.slice(2), {
@@ -91,121 +103,171 @@ function validateFlags(args, cmdEntry) {
     if (unknownFlags.length)
         throw new Error(`Unknown option${unknownFlags.length > 1 ? 's' : ''}: ${unknownFlags.map(f => `--${f}`).join(', ')}`);
 }
-// ── inspect ──
-async function handleInspect(command, cmdEntry, args, output) {
-    if (command.name !== 'inspect') {
-        output.error(`Unknown command: ${command.name}`);
-        return;
-    }
+// ── session commands ──
+async function handleOpen(command, args, output) {
     try {
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-        const config = (0, config_1.loadConfig)(args);
-        const url = parsed.url;
-        const selector = parsed.selector;
-        const zoom = !!parsed.zoom;
-        const depthRaw = parsed.depth;
-        let depth;
-        if (depthRaw === 'auto' || depthRaw === undefined) {
-            depth = 0; // placeholder, resolved after browser opens
-        }
-        else {
-            depth = Number(depthRaw);
-        }
-        const maxNodes = parsed['max-nodes'] || 60;
-        const upTo = parsed['up-to'] || 'html';
-        const wait = !!parsed.wait;
-        const headed = !!parsed.headed || config.headed || wait;
-        const browser = parsed.browser || config.browser;
-        const state = parsed.state || undefined;
-        const brief = !!parsed.brief;
-        const layout = !!parsed.layout;
-        if (!url)
-            output.error('URL is required. Usage: cssprobe-cli inspect <url> [selector]');
-        // Auto-detect root selector if not provided
-        let rootSelector = selector;
-        if (!rootSelector) {
-            const detected = await autoDetectRoot(url, { browser, headed, state, viewport: config.viewport });
-            if (!detected) {
-                output.error('Could not auto-detect a root element. Please provide a selector: cssprobe-cli inspect <url> <selector>');
+        const url = parsed.url || 'about:blank';
+        const browser = parsed.browser || 'chromium';
+        const headed = !!parsed.headed;
+        const viewportStr = parsed.viewport;
+        // Parse viewport
+        let viewport;
+        if (viewportStr) {
+            const parts = viewportStr.split('x');
+            if (parts.length !== 2) {
+                output.error('Invalid viewport format. Use WxH (e.g. 1280x720)');
                 return;
             }
-            rootSelector = detected;
-            console.error(`Auto-detected root: ${rootSelector}`);
-        }
-        const launcher = new launcher_1.BrowserLauncher({ browser, headed, state, viewport: config.viewport });
-        await launcher.open(url);
-        // Wait for user interaction if --wait
-        if (wait) {
-            await launcher.waitForUser();
+            const width = parseInt(parts[0], 10);
+            const height = parseInt(parts[1], 10);
+            if (isNaN(width) || isNaN(height)) {
+                output.error('Invalid viewport dimensions. Must be numbers.');
+                return;
+            }
+            viewport = { width, height };
         }
-        // Resolve auto depth
-        if (depth === 0) {
-            const measured = await launcher.measureDepth(rootSelector);
-            depth = Math.min(measured, 20) || 6;
-            console.error(`Auto-detected depth: ${measured} (using ${depth})`);
+        // Start daemon
+        const { pid } = await session_1.Session.startDaemon({
+            browser,
+            headed,
+            viewport,
+            _: ['open', url],
+        }, 'open');
+        // Wait a bit for daemon to start
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        // Load session and navigate
+        const session = await (0, session_1.loadSession)();
+        if (session) {
+            await session.run({ _: ['goto', url] });
         }
-        const collectCfg = {
-            rootSelector,
-            upTo,
-            downDepth: depth,
-            maxNodes,
+        const result = {
+            sessionId: 'default',
+            pid,
+            url,
+            viewport: viewport || { width: 1280, height: 720 },
         };
-        const snapshot = await launcher.collect(collectCfg);
-        await launcher.close();
-        const findings = (0, analyzer_1.analyze)(snapshot);
         if (output.json) {
-            console.log(output.format((0, renderer_1.renderJSON)(snapshot, findings, brief)));
+            console.log(JSON.stringify(result, null, 2));
         }
         else {
-            console.log((0, renderer_1.renderMarkdown)(snapshot, findings, brief, layout));
+            console.log(`Browser opened at ${url}`);
+            console.log(`Session ID: default`);
+            console.log(`PID: ${pid}`);
+            console.log(`Viewport: ${viewport?.width || 1280}x${viewport?.height || 720}`);
         }
     }
     catch (e) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
-async function autoDetectRoot(url, opts) {
-    const launcher = new launcher_1.BrowserLauncher(opts);
+async function handleClose(output) {
     try {
-        await launcher.open(url);
-        const candidates = await launcher.autoDetectRoot();
-        if (candidates.length > 0)
-            return candidates[0];
-        return null;
+        const session = await (0, session_1.loadSession)();
+        if (!session) {
+            output.error('No active session. Run: cssprobe-cli open <url>');
+            return;
+        }
+        await session.stop();
+        if (output.json) {
+            console.log(JSON.stringify({ closed: true, sessionId: 'default' }, null, 2));
+        }
+        else {
+            console.log('Browser closed.');
+        }
     }
-    finally {
-        await launcher.close();
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
     }
 }
-// ── login ──
-async function handleLogin(command, cmdEntry, args, output) {
+async function handleStatus(output) {
     try {
-        const cmdArgs = splitArgs(args);
-        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-        const config = (0, config_1.loadConfig)(args);
-        const url = parsed.url;
-        const browser = parsed.browser || config.browser;
-        const outPath = parsed.out || defaultStatePath(url);
-        if (!url)
-            output.error('URL is required. Usage: cssprobe-cli login <url>');
-        const launcher = new launcher_1.BrowserLauncher({ browser, headed: true });
-        const savedPath = await launcher.loginAndSave(url, outPath);
-        await launcher.close();
-        console.log(output.format({ saved: savedPath, usage: `cssprobe-cli inspect <url> --state ${savedPath}` }));
+        const session = await (0, session_1.loadSession)();
+        if (!session) {
+            const result = { sessionId: 'default', alive: false };
+            if (output.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log('No active session.');
+            }
+            return;
+        }
+        const canConnect = await session.canConnect();
+        const result = {
+            sessionId: 'default',
+            alive: canConnect,
+            config: session.config,
+        };
+        if (output.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`Session: default`);
+            console.log(`Status: ${canConnect ? 'alive' : 'dead'}`);
+            if (canConnect) {
+                console.log(`Browser: ${session.config.browser.browserName}`);
+            }
+        }
     }
     catch (e) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
-function defaultStatePath(url) {
+async function handleSessionCommand(commandName, command, args, output) {
     try {
-        const hostname = new URL(url).hostname.replace(/[^a-z0-9.-]/g, '_');
-        const dir = path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states');
-        return path_1.default.join(dir, `${hostname}.json`);
+        const session = await (0, session_1.loadSession)();
+        if (!session) {
+            output.error('No active session. Run: cssprobe-cli open <url>');
+            return;
+        }
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        // Build command args for daemon
+        const daemonArgs = [commandName];
+        // Add positional args
+        if (command.args) {
+            const argsSchema = command.args;
+            const argNames = Object.keys(argsSchema.shape);
+            for (const name of argNames) {
+                if (parsed[name] !== undefined) {
+                    daemonArgs.push(String(parsed[name]));
+                }
+            }
+        }
+        // Add options
+        if (command.options) {
+            const optionsSchema = command.options;
+            const optionNames = Object.keys(optionsSchema.shape);
+            for (const name of optionNames) {
+                if (parsed[name] !== undefined) {
+                    if (typeof parsed[name] === 'boolean') {
+                        if (parsed[name])
+                            daemonArgs.push(`--${name}`);
+                    }
+                    else {
+                        daemonArgs.push(`--${name}=${parsed[name]}`);
+                    }
+                }
+            }
+        }
+        // Run command in session
+        const result = await session.run({ ...cmdArgs, _: daemonArgs });
+        if (output.json) {
+            try {
+                console.log(JSON.parse(result.text));
+            }
+            catch {
+                console.log(result.text);
+            }
+        }
+        else {
+            console.log(result.text);
+        }
     }
-    catch {
-        return path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', 'default.json');
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
     }
 }
 // ── config commands ──
@@ -301,12 +363,6 @@ function handleSkillCommands(commandName, command, args, output) {
     }
     return false;
 }
-/**
- * Parse Netscape cookie format (tab-separated):
- * domain  flag  path  secure  expires  name  value
- *
- * Also supports lines starting with # as comments, and blank lines.
- */
 function parseNetscapeCookies(content) {
     const cookies = [];
     const lines = content.split('\n');
@@ -318,7 +374,7 @@ function parseNetscapeCookies(content) {
         if (parts.length < 7)
             continue;
         const [domain, flag, path, secure, expires, name, ...valueParts] = parts;
-        const value = valueParts.join('\t'); // value may contain tabs
+        const value = valueParts.join('\t');
         const expiresNum = parseInt(expires, 10);
         cookies.push({
             name,
@@ -333,14 +389,13 @@ function parseNetscapeCookies(content) {
     }
     return cookies;
 }
-async function handleStateImport(command, cmdEntry, args, output) {
+async function handleStateImport(command, args, output) {
     try {
         const cmdArgs = splitArgs(args);
         const parsed = (0, command_1.parseCommand)(command, cmdArgs);
         const filePath = parsed.file;
         const outPath = parsed.out || path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', 'imported.json');
         const mergePath = parsed.merge;
-        // Read cookie content from file or stdin
         let content;
         if (filePath) {
             const resolved = path_1.default.resolve(filePath);
@@ -351,7 +406,6 @@ async function handleStateImport(command, cmdEntry, args, output) {
             content = fs_1.default.readFileSync(resolved, 'utf-8');
         }
         else {
-            // Read from stdin
             content = '';
             for await (const chunk of process.stdin) {
                 content += chunk;
@@ -361,13 +415,11 @@ async function handleStateImport(command, cmdEntry, args, output) {
             output.error('No cookie data provided. Provide a file path or pipe data to stdin.');
             return;
         }
-        // Parse cookies
         const newCookies = parseNetscapeCookies(content);
         if (newCookies.length === 0) {
             output.error('No valid cookies found. Expected Netscape format (tab-separated: domain\\tflag\\tpath\\tsecure\\texpires\\tname\\tvalue)');
             return;
         }
-        // Load existing state if merging
         let state;
         if (mergePath && fs_1.default.existsSync(mergePath)) {
             state = JSON.parse(fs_1.default.readFileSync(mergePath, 'utf-8'));
@@ -376,7 +428,6 @@ async function handleStateImport(command, cmdEntry, args, output) {
         else {
             state = { cookies: [], origins: [] };
         }
-        // Merge cookies (new cookies override existing ones with same domain+name+path)
         const keyed = {};
         for (const c of state.cookies) {
             keyed[`${c.domain}|${c.name}|${c.path}`] = c;
@@ -385,7 +436,6 @@ async function handleStateImport(command, cmdEntry, args, output) {
             keyed[`${nc.domain}|${nc.name}|${nc.path}`] = nc;
         }
         state.cookies = Object.values(keyed);
-        // Write output
         const resolvedOut = path_1.default.resolve(outPath);
         const dir = path_1.default.dirname(resolvedOut);
         if (!fs_1.default.existsSync(dir))
@@ -402,275 +452,4 @@ async function handleStateImport(command, cmdEntry, args, output) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
-// ── interactive ──
-const REPL_COMMANDS = {
-    tree: '<selector>           Show DOM tree',
-    layout: '<selector>           Show ASCII layout diagram',
-    sketch: '<selector>           Show tree sketch (issues only)',
-    findings: '<selector>           Show findings only',
-    json: '<selector>           Show JSON output',
-    report: '<selector>           Show full report',
-    navigate: '<url>                Navigate to a new URL',
-    depth: '<n>                  Set depth (default: auto)',
-    help: '                     Show this help',
-    quit: '                     Close browser and exit',
-};
-async function handleInteractive(command, cmdEntry, args, _output) {
-    const cmdArgs = splitArgs(args);
-    const parsed = (0, command_1.parseCommand)(command, cmdArgs);
-    const url = parsed.url;
-    const browser = parsed.browser || 'chromium';
-    const state = parsed.state || undefined;
-    const depthRaw = parsed.depth;
-    let depth = depthRaw === 'auto' || depthRaw === undefined ? 0 : Number(depthRaw);
-    if (!url) {
-        console.error('Error: URL is required. Usage: cssprobe-cli interactive <url>');
-        process.exit(1);
-    }
-    const config = (0, config_1.loadConfig)(args);
-    const launcher = new launcher_1.BrowserLauncher({ browser, headed: true, state, viewport: config.viewport });
-    await launcher.open(url);
-    let currentUrl = url;
-    // Resolve auto depth
-    if (depth === 0) {
-        try {
-            const candidates = await launcher.autoDetectRoot();
-            const selector = candidates[0] || 'body';
-            const measured = await launcher.measureDepth(selector);
-            depth = Math.min(measured, 20) || 6;
-            console.error(`Auto-detected depth: ${measured} (using ${depth})`);
-        }
-        catch {
-            depth = 6;
-        }
-    }
-    console.error('');
-    console.error(`Browser opened at ${currentUrl}`);
-    console.error("Type 'help' for available commands, 'quit' to exit.");
-    console.error('');
-    const rl = require('readline').createInterface({
-        input: process.stdin,
-        output: process.stderr,
-        prompt: 'inspect> ',
-    });
-    rl.prompt();
-    rl.on('line', async (line) => {
-        const trimmed = line.trim();
-        if (!trimmed) {
-            rl.prompt();
-            return;
-        }
-        // Parse: command [selector] [--options]
-        const parts = trimmed.split(/\s+/);
-        const cmd = parts[0];
-        const rest = parts.slice(1);
-        try {
-            switch (cmd) {
-                case 'help': {
-                    console.error('');
-                    console.error('Commands:');
-                    for (const [name, desc] of Object.entries(REPL_COMMANDS)) {
-                        console.error(`  ${name.padEnd(12)} ${desc}`);
-                    }
-                    console.error('');
-                    break;
-                }
-                case 'quit':
-                case 'exit': {
-                    await launcher.close();
-                    console.error('Browser closed.');
-                    rl.close();
-                    process.exit(0);
-                }
-                case 'navigate': {
-                    const newUrl = rest[0];
-                    if (!newUrl) {
-                        console.error('Usage: navigate <url>');
-                        break;
-                    }
-                    await launcher.navigate(newUrl);
-                    currentUrl = newUrl;
-                    console.error(`Navigated to ${currentUrl}`);
-                    break;
-                }
-                case 'depth': {
-                    const n = parseInt(rest[0], 10);
-                    if (isNaN(n) || n < 1) {
-                        console.error('Usage: depth <n>');
-                        break;
-                    }
-                    depth = Math.min(n, 20);
-                    console.error(`Depth set to ${depth}`);
-                    break;
-                }
-                case 'tree':
-                case 'layout':
-                case 'sketch':
-                case 'findings':
-                case 'json':
-                case 'report': {
-                    // Parse selector + options from remaining args
-                    let selector = '';
-                    let useBrief = false;
-                    let useLayout = false;
-                    let useJson = false;
-                    for (const arg of rest) {
-                        if (arg === '--brief')
-                            useBrief = true;
-                        else if (arg === '--layout')
-                            useLayout = true;
-                        else if (arg === '--json')
-                            useJson = true;
-                        else if (!arg.startsWith('-') && !selector)
-                            selector = arg;
-                    }
-                    // Command-specific defaults
-                    if (cmd === 'layout')
-                        useLayout = true;
-                    if (cmd === 'sketch')
-                        useBrief = true;
-                    if (cmd === 'json')
-                        useJson = true;
-                    if (!selector) {
-                        console.error('Usage: ' + cmd + ' <selector> [--brief] [--layout] [--json]');
-                        break;
-                    }
-                    // Measure depth if needed
-                    let useDepth = depth;
-                    if (useDepth === 0) {
-                        try {
-                            const measured = await launcher.measureDepth(selector);
-                            useDepth = Math.min(measured, 20) || 6;
-                        }
-                        catch {
-                            useDepth = 6;
-                        }
-                    }
-                    const collectCfg = {
-                        rootSelector: selector,
-                        upTo: 'html',
-                        downDepth: useDepth,
-                        maxNodes: 60,
-                    };
-                    const snapshot = await launcher.collect(collectCfg);
-                    if (snapshot.error) {
-                        console.error(`Error: ${snapshot.error}`);
-                        if (snapshot.candidates?.length) {
-                            console.error(`Similar nodes: ${snapshot.candidates.join(', ')}`);
-                        }
-                        break;
-                    }
-                    const findings = (0, analyzer_1.analyze)(snapshot);
-                    if (cmd === 'findings') {
-                        // Only show findings section
-                        const important = findings.filter(f => f.level === 'warning' || f.level === 'error');
-                        if (important.length === 0) {
-                            console.log('No warnings or errors');
-                        }
-                        else {
-                            for (const f of important) {
-                                const icon = f.level === 'error' ? '\u26A0' : '\u26A0';
-                                console.log(`- ${icon} ${f.message} [${f.confidence}]${f.location ? ` @ ${f.location}` : ''}`);
-                            }
-                        }
-                    }
-                    else if (useJson) {
-                        console.log(JSON.stringify((0, renderer_1.renderJSON)(snapshot, findings, useBrief), null, 2));
-                    }
-                    else if (cmd === 'tree') {
-                        // Only DOM tree
-                        const lines = [];
-                        lines.push(`## DOM tree (${snapshot.downDepth} levels deep)`);
-                        lines.push('```');
-                        // Inline renderNode
-                        const renderNodeLocal = (node, indent) => {
-                            if (!node)
-                                return;
-                            const cls = node.classes?.length ? `.${node.classes.join('.')}` : '';
-                            const id = node.id ? `#${node.id}` : '';
-                            const m = node.metrics;
-                            const s = node.shape || {};
-                            const shapeStr = s.role ? `[${s.role} h:${s.heightStrategy} w:${s.widthStrategy}]` : '';
-                            const flag = [];
-                            if (node.flags?.overflowsParent)
-                                flag.push('\u26A0parent-overflow');
-                            if (node.flags?.overflowsViewport)
-                                flag.push('\u26A0viewport-overflow');
-                            if (m?.clientHeight === 0 && m?.offsetHeight === 0)
-                                flag.push('\u26A0collapsed');
-                            lines.push(`${'  '.repeat(indent)}<${node.tag}${id}${cls}> ${shapeStr} [${node.props?.position},${node.props?.display}] rect(${m?.rect?.width}\u00D7${m?.rect?.height})${flag.length ? ' ' + flag.join(' ') : ''}`);
-                            for (const child of node.children || [])
-                                renderNodeLocal(child, indent + 1);
-                        };
-                        renderNodeLocal(snapshot.tree, 0);
-                        lines.push('```');
-                        console.log(lines.join('\n'));
-                    }
-                    else {
-                        console.log((0, renderer_1.renderMarkdown)(snapshot, findings, useBrief, useLayout));
-                    }
-                    break;
-                }
-                default: {
-                    // Try as a direct selector (shorthand for 'report <selector>')
-                    if (!cmd.startsWith('-')) {
-                        const selector = cmd;
-                        let useBrief = false;
-                        let useLayout = false;
-                        for (const arg of rest) {
-                            if (arg === '--brief')
-                                useBrief = true;
-                            if (arg === '--layout')
-                                useLayout = true;
-                        }
-                        let useDepth = depth;
-                        if (useDepth === 0) {
-                            try {
-                                const measured = await launcher.measureDepth(selector);
-                                useDepth = Math.min(measured, 20) || 6;
-                            }
-                            catch {
-                                useDepth = 6;
-                            }
-                        }
-                        const collectCfg = {
-                            rootSelector: selector,
-                            upTo: 'html',
-                            downDepth: useDepth,
-                            maxNodes: 60,
-                        };
-                        const snapshot = await launcher.collect(collectCfg);
-                        if (snapshot.error) {
-                            console.error(`Error: ${snapshot.error}`);
-                            if (snapshot.candidates?.length) {
-                                console.error(`Similar nodes: ${snapshot.candidates.join(', ')}`);
-                            }
-                        }
-                        else {
-                            const findings = (0, analyzer_1.analyze)(snapshot);
-                            console.log((0, renderer_1.renderMarkdown)(snapshot, findings, useBrief, useLayout));
-                        }
-                    }
-                    else {
-                        console.error(`Unknown command: ${cmd}. Type 'help' for available commands.`);
-                    }
-                }
-            }
-        }
-        catch (e) {
-            console.error(`Error: ${e.message || e}`);
-        }
-        rl.prompt();
-    });
-    rl.on('close', async () => {
-        await launcher.close().catch(() => { });
-        process.exit(0);
-    });
-    // Handle SIGINT gracefully
-    process.on('SIGINT', async () => {
-        console.error('\nClosing browser...');
-        await launcher.close().catch(() => { });
-        process.exit(0);
-    });
-}
 //# sourceMappingURL=program.js.map

package/dist/config/helpGenerator.js

@@ -80,7 +80,9 @@ function generateCommandHelp(command) {
     return lines.join('\n');
 }
 const categories = [
-    { name: 'core', title: 'Inspection' },
+    { name: 'core', title: 'Session Management' },
+    { name: 'cssprobe', title: 'CSS Inspection' },
+    { name: 'export', title: 'Export' },
     { name: 'config', title: 'Configuration' },
     { name: 'skill', title: 'Agent Skills' },
 ];