@pablovitasso/szkrabok 1.0.18 → 1.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pablovitasso/szkrabok",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "Production-grade MCP browser automation layer with persistent sessions and stealth capabilities",
   "type": "module",
   "main": "src/index.js",
@@ -36,6 +36,7 @@
     "format:check": "prettier --check \"{src,tests}/**/*.{js,json,md}\" \"*.{js,json,md}\"",
     "codegen:mcp": "node packages/runtime/mcp-client/codegen/generate-mcp-tools.mjs",
     "prepack": "git describe --exact-match --tags HEAD 2>/dev/null || (echo 'ERROR: HEAD is not tagged. Run npm run release:patch or release:minor first.' && exit 1)",
+    "prepublishOnly": "node scripts/smoke-test.js",
     "release:patch": "npm version patch --workspaces --include-workspace-root --ignore-scripts --no-git-tag-version && node scripts/release-commit.js",
     "release:minor": "npm version minor --workspaces --include-workspace-root --ignore-scripts --no-git-tag-version && node scripts/release-commit.js",
     "deps:update": "npx npm-check-updates -u --workspaces && npm install",
@@ -69,6 +70,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "commander": "^14.0.3",
     "dotenv": "^17.3.1",
     "playwright": "^1.58.2",
     "playwright-core": "^1.58.2",

package/packages/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@szkrabok/runtime",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "szkrabok — browser bootstrap, stealth, session pool, MCP client.",
   "type": "module",
   "main": "index.js",

package/scripts/patch-playwright.js

@@ -94,8 +94,11 @@ import fs from 'fs'
 import path from 'path'
 import { execSync } from 'child_process'
 import { createRequire } from 'module'
+import { fileURLToPath } from 'url'
+import { resolvePlaywrightCore } from './resolve-playwright-core.js'
 
 const require = createRequire(import.meta.url)
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
 // ── locate all playwright-core installs ───────────────────────────────────────
 // npm hoists one copy to node_modules/playwright-core but playwright itself
@@ -105,22 +108,24 @@ const require = createRequire(import.meta.url)
 
 function findPkgRoots() {
   const roots = []
-  const nmDir = path.resolve('node_modules')
+  const pkgRoot = path.resolve(__dirname, '..')
 
-  // 1. top-level playwright-core
-  const top = path.join(nmDir, 'playwright-core')
-  if (fs.existsSync(path.join(top, 'package.json'))) roots.push(top)
+  const primary = resolvePlaywrightCore(pkgRoot, fs.existsSync.bind(fs), path)
+  if (primary) roots.push(primary)
 
-  // 2. any nested playwright-core inside other packages
+  // Also find playwright's own nested playwright-core copy
+  const enclosingNm = pkgRoot.includes('node_modules')
+    ? pkgRoot.slice(0, pkgRoot.lastIndexOf('node_modules') + 'node_modules'.length)
+    : path.join(pkgRoot, 'node_modules')
   try {
     const out = execSync(
-      'find node_modules -maxdepth 4 -name "package.json" -path "*/playwright-core/package.json" 2>/dev/null',
+      `find ${enclosingNm}/playwright -maxdepth 3 -name "package.json" -path "*/playwright-core/package.json" 2>/dev/null`,
       { encoding: 'utf8' }
     )
     for (const line of out.trim().split('\n')) {
       if (!line) continue
-      const dir = path.dirname(path.resolve(line))
-      if (!roots.includes(dir)) roots.push(dir)
+      const nested = path.dirname(path.resolve(line))
+      if (!roots.includes(nested)) roots.push(nested)
     }
   } catch {}
 
@@ -129,7 +134,8 @@ function findPkgRoots() {
 
 const pkgRoots = findPkgRoots()
 if (!pkgRoots.length) {
-  console.error('[patch-playwright] ERROR: playwright-core not found in node_modules.')
+  console.error('[patch-playwright] ERROR: playwright-core not found.')
+  console.error(`  Searched: ${path.resolve(__dirname, '..', 'node_modules', 'playwright-core')}`)
   console.error('  Run `npm install` first.')
   process.exit(1)
 }

package/scripts/resolve-playwright-core.js

@@ -0,0 +1,24 @@
+/**
+ * Shared utility: find playwright-core root relative to a given package root.
+ * Handles npm hoisting — playwright-core may be in an ancestor node_modules dir.
+ *
+ * @param {string} pkgRoot - absolute path to the package root (dir containing package.json)
+ * @param {function} existsSync - fs.existsSync
+ * @param {object} path - node:path module (needs join)
+ * @returns {string|null} absolute path to playwright-core dir, or null if not found
+ */
+export function resolvePlaywrightCore(pkgRoot, existsSync, path) {
+  // When installed via npm, playwright-core is hoisted to the enclosing node_modules.
+  const enclosingNm = pkgRoot.includes('node_modules')
+    ? pkgRoot.slice(0, pkgRoot.lastIndexOf('node_modules') + 'node_modules'.length)
+    : path.join(pkgRoot, 'node_modules');
+
+  const hoisted = path.join(enclosingNm, 'playwright-core');
+  if (existsSync(path.join(hoisted, 'package.json'))) return hoisted;
+
+  // Fallback: own nested node_modules (non-hoisted or dev workspace)
+  const own = path.join(pkgRoot, 'node_modules', 'playwright-core');
+  if (existsSync(path.join(own, 'package.json'))) return own;
+
+  return null;
+}

package/scripts/smoke-test.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * smoke-test.js — run as prepublishOnly to catch packaging bugs before npm publish.
+ *
+ * 1. Packs the tarball (npm pack --dry-run to get file list, then real pack)
+ * 2. Installs it in a fresh temp directory (no pre-existing node_modules)
+ * 3. Runs `szkrabok --version` from that install
+ * 4. Runs `szkrabok doctor` from that install
+ * 5. Cleans up and exits non-zero on any failure
+ */
+
+import { execSync, spawnSync } from 'node:child_process';
+import { mkdtempSync, rmSync, existsSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { tmpdir, homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const run = (cmd, opts = {}) => execSync(cmd, { cwd: root, stdio: 'inherit', ...opts });
+const runCapture = (cmd, opts = {}) =>
+  execSync(cmd, { cwd: root, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], ...opts });
+
+let tmpDir;
+
+const cleanup = () => {
+  if (tmpDir && existsSync(tmpDir)) {
+    try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
+  }
+};
+
+process.on('exit', cleanup);
+process.on('SIGINT', () => process.exit(1));
+
+console.log('[smoke-test] Packing tarball...');
+const packOutput = runCapture('npm pack --json', { env: { ...process.env, npm_config_ignore_scripts: 'true' } });
+const packInfo = JSON.parse(packOutput);
+const tarball = resolve(root, packInfo[0].filename);
+console.log(`[smoke-test] Packed: ${tarball}`);
+
+tmpDir = mkdtempSync(join(tmpdir(), 'szkrabok-smoke-'));
+console.log(`[smoke-test] Installing into ${tmpDir}...`);
+
+try {
+  execSync(`npm install --ignore-scripts ${tarball}`, {
+    cwd: tmpDir,
+    stdio: 'inherit',
+    env: { ...process.env, SZKRABOK_SKIP_BROWSER_INSTALL: '1' },
+  });
+} catch (err) {
+  console.error('[smoke-test] FAIL: npm install failed');
+  process.exit(1);
+}
+
+// Now run postinstall scripts manually so we control env
+const pkgBin = join(tmpDir, 'node_modules', '.bin', 'szkrabok');
+if (!existsSync(pkgBin)) {
+  console.error(`[smoke-test] FAIL: binary not found at ${pkgBin}`);
+  process.exit(1);
+}
+
+// patch-playwright (skip browser install)
+console.log('[smoke-test] Running patch-playwright...');
+const patchResult = spawnSync(
+  'node',
+  [join(tmpDir, 'node_modules', '@pablovitasso', 'szkrabok', 'scripts', 'patch-playwright.js')],
+  { cwd: tmpDir, stdio: 'inherit' }
+);
+if (patchResult.status !== 0) {
+  console.error('[smoke-test] FAIL: patch-playwright.js failed');
+  process.exit(1);
+}
+
+// --version
+console.log('[smoke-test] Running szkrabok --version...');
+const versionResult = spawnSync(pkgBin, ['--version'], {
+  cwd: tmpDir,
+  stdio: ['ignore', 'pipe', 'pipe'],
+  env: { ...process.env, SZKRABOK_SKIP_BROWSER_INSTALL: '1' },
+});
+if (versionResult.status !== 0) {
+  console.error('[smoke-test] FAIL: szkrabok --version failed');
+  console.error(versionResult.stderr?.toString());
+  process.exit(1);
+}
+console.log(`[smoke-test] version output: ${versionResult.stdout.toString().trim()}`);
+
+// doctor
+console.log('[smoke-test] Running szkrabok doctor...');
+const doctorResult = spawnSync(pkgBin, ['doctor'], {
+  cwd: tmpDir,
+  stdio: 'inherit',
+  env: { ...process.env, SZKRABOK_SKIP_BROWSER_INSTALL: '1' },
+});
+if (doctorResult.status !== 0) {
+  console.error('[smoke-test] FAIL: szkrabok doctor reported failures');
+  process.exit(1);
+}
+
+// remove the tarball
+try { rmSync(tarball); } catch {}
+
+console.log('\n[smoke-test] PASS: package installs and starts correctly.');

package/src/cli/commands/detect-browser.js

@@ -0,0 +1,22 @@
+export function register(program, { safe, getRuntime }) {
+  program
+    .command('detect-browser')
+    .description('Detect Chrome/Chromium')
+    .action(
+      safe(async () => {
+        const { findChromiumPath } = await getRuntime();
+        const chromiumPath = await findChromiumPath();
+
+        if (!chromiumPath) {
+          console.log('No Chromium detected\n');
+          console.log('  szkrabok install-browser');
+          process.exit(1);
+        }
+
+        console.log(chromiumPath);
+        console.log('\nRecommended config:\n');
+        console.log('[default]');
+        console.log(`executablePath = "${chromiumPath}"`);
+      })
+    );
+}

package/src/cli/commands/doctor.js

@@ -0,0 +1,89 @@
+import fs from 'node:fs/promises';
+import { existsSync, readdirSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { resolvePlaywrightCore } from '../../../scripts/resolve-playwright-core.js';
+
+const pass = (label, detail = '') =>
+  console.log(`  [pass] ${label}${detail ? ': ' + detail : ''}`);
+
+const fail = (label, detail = '') => {
+  console.error(`  [FAIL] ${label}${detail ? ': ' + detail : ''}`);
+  return true; // signals failure
+};
+
+const warn = (label, detail = '') =>
+  console.log(`  [warn] ${label}${detail ? ': ' + detail : ''}`);
+
+export function register(program) {
+  program
+    .command('doctor')
+    .description('Check szkrabok environment and dependencies')
+    .action(async () => {
+      let failed = false;
+      console.log('szkrabok doctor\n');
+
+      // 1. Node version
+      const [major] = process.versions.node.split('.').map(Number);
+      if (major >= 20) pass('node version', process.versions.node);
+      else failed = fail('node version', `${process.versions.node} (need >=20)`);
+
+      // 2. playwright-core installed — hoisting-aware resolution
+      const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+      const pwCorePath = resolvePlaywrightCore(pkgRoot, existsSync, { join });
+      if (pwCorePath) {
+        const { version } = JSON.parse(await fs.readFile(join(pwCorePath, 'package.json'), 'utf8'));
+        pass('playwright-core installed', version);
+
+        // 3. playwright-core patched
+        const crConnectionJs = join(pwCorePath, 'lib', 'server', 'chromium', 'crConnection.js');
+        if (existsSync(crConnectionJs)) {
+          const src = await fs.readFile(crConnectionJs, 'utf8');
+          if (src.includes('__re__emitExecutionContext')) pass('playwright-core patched (stealth)');
+          else warn('playwright-core not patched', 'run: node scripts/patch-playwright.js');
+        } else {
+          warn('playwright-core patch check skipped', 'crConnection.js not found');
+        }
+      } else {
+        failed = fail('playwright-core installed', `not found near ${pkgRoot}`);
+      }
+
+      // 4. Chromium available
+      const playwrightCache = join(homedir(), '.cache', 'ms-playwright');
+      let chromiumFound = null;
+      if (existsSync(playwrightCache)) {
+        const dirs = readdirSync(playwrightCache)
+          .filter(d => d.startsWith('chromium-'))
+          .sort()
+          .reverse();
+        outer: for (const dir of dirs) {
+          for (const bin of ['chrome-linux/chrome', 'chrome-linux64/chrome']) {
+            const p = join(playwrightCache, dir, bin);
+            if (existsSync(p)) { chromiumFound = p; break outer; }
+          }
+        }
+      }
+      for (const p of ['/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome']) {
+        if (!chromiumFound && existsSync(p)) chromiumFound = p;
+      }
+      if (chromiumFound) pass('chromium', chromiumFound);
+      else failed = fail('chromium not found', 'run: szkrabok install-browser');
+
+      // 5. MCP server imports
+      try {
+        await import('../../server.js');
+        pass('server.js imports');
+      } catch (err) {
+        failed = fail('server.js imports', err?.message);
+      }
+
+      // 6. Startup log
+      const logFile = join(homedir(), '.cache', 'szkrabok', 'startup.log');
+      if (existsSync(logFile)) pass('startup log exists', logFile);
+      else pass('startup log', `will be created at ${logFile}`);
+
+      console.log(`\n${failed ? 'Some checks failed.' : 'All checks passed.'}`);
+      process.exit(failed ? 1 : 0);
+    });
+}

package/src/cli/commands/endpoint.js

@@ -0,0 +1,14 @@
+import { endpoint } from '../../tools/szkrabok_session.js';
+
+export function register(program, { safe }) {
+  program
+    .command('endpoint <sessionName>')
+    .description('Print CDP and WS endpoints')
+    .action(
+      safe(async sessionName => {
+        const result = await endpoint({ sessionName });
+        console.log(`CDP: ${result.cdpEndpoint}`);
+        if (result.wsEndpoint) console.log(`WS:  ${result.wsEndpoint}`);
+      })
+    );
+}

package/src/cli/commands/init.js

@@ -0,0 +1,23 @@
+export function register(program, { safe }) {
+  program
+    .command('init')
+    .description('Scaffold minimal config')
+    .action(
+      safe(async () => {
+        const { init } = await import('../../tools/scaffold.js');
+
+        const result = await init({
+          dir: process.cwd(),
+          preset: 'minimal',
+          install: false,
+        });
+
+        if (result.created.length) console.error(`Created: ${result.created.join(', ')}`);
+        if (result.merged.length) console.error(`Merged: ${result.merged.join(', ')}`);
+        if (result.skipped.length) console.error(`Skipped: ${result.skipped.join(', ')}`);
+        for (const w of result.warnings) console.error(`Warning: ${w}`);
+
+        console.error('Done. Run "szkrabok install-browser" if Chromium is not installed.');
+      })
+    );
+}

package/src/cli/commands/install-browser.js

@@ -0,0 +1,11 @@
+export function register(program) {
+  program
+    .command('install-browser')
+    .description('Install Chromium via Playwright')
+    .action(() => {
+      import('node:child_process').then(({ spawn }) => {
+        const proc = spawn('npx', ['playwright', 'install', 'chromium'], { stdio: 'inherit' });
+        proc.on('close', code => process.exit(code ?? 0));
+      });
+    });
+}

package/src/cli/commands/open.js

@@ -0,0 +1,25 @@
+export function register(program, { safe, getRuntime, attachShutdown }) {
+  program
+    .command('open <profile>')
+    .description('Launch persistent browser and print CDP endpoint')
+    .option('--preset <preset>')
+    .option('--headless')
+    .action(
+      safe(async (profile, options) => {
+        const { launch } = await getRuntime();
+
+        const handle = await launch({
+          profile,
+          preset: options.preset,
+          headless: options.headless ?? undefined,
+          reuse: false,
+        });
+
+        console.log(handle.cdpEndpoint);
+
+        attachShutdown(handle);
+
+        await new Promise(() => {});
+      })
+    );
+}

package/src/cli/commands/session.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { list, deleteSession } from '../../tools/szkrabok_session.js';
+
+const SESSIONS_DIR = path.join(process.cwd(), 'sessions');
+
+const readJson = async file => {
+  try { return JSON.parse(await fs.readFile(file, 'utf8')); } catch { return null; }
+};
+
+export function register(program, { safe }) {
+  const session = program.command('session').description('Session management');
+
+  session
+    .command('list')
+    .action(
+      safe(async () => {
+        const { sessions } = await list();
+        console.table(
+          sessions.map(s => ({
+            ID: s.id,
+            Active: s.active ? 'yes' : 'no',
+            Preset: s.preset ?? 'N/A',
+            Label: s.label ?? 'N/A',
+          }))
+        );
+      })
+    );
+
+  session
+    .command('inspect <id>')
+    .action(
+      safe(async id => {
+        const dir = path.join(SESSIONS_DIR, id);
+        const [meta, state] = await Promise.all([
+          readJson(path.join(dir, 'meta.json')),
+          readJson(path.join(dir, 'state.json')),
+        ]);
+
+        if (!meta || !state) throw new Error(`Session ${id} not found`);
+
+        console.log('=== METADATA ===');
+        console.log(JSON.stringify(meta, null, 2));
+        console.log('\n=== COOKIES ===');
+        console.log(state.cookies?.length ?? 0, 'cookies');
+        console.log('\n=== LOCALSTORAGE ===');
+        for (const origin of state.origins ?? []) {
+          console.log(origin.origin, ':', origin.localStorage?.length ?? 0, 'items');
+        }
+      })
+    );
+
+  session
+    .command('delete <id>')
+    .action(
+      safe(async id => {
+        await deleteSession({ sessionName: id });
+        console.log(`Session ${id} deleted`);
+      })
+    );
+
+  session
+    .command('cleanup')
+    .option('--days <days>', 'delete sessions older than N days', '30')
+    .action(
+      safe(async options => {
+        const days = Number(options.days) || 30;
+        const cutoff = Date.now() - days * 86400000;
+
+        let entries;
+        try {
+          entries = await fs.readdir(SESSIONS_DIR, { withFileTypes: true });
+        } catch {
+          console.log('No sessions directory');
+          return;
+        }
+
+        await Promise.all(
+          entries
+            .filter(e => e.isDirectory())
+            .map(async e => {
+              const meta = await readJson(path.join(SESSIONS_DIR, e.name, 'meta.json'));
+              if (meta?.lastUsed && meta.lastUsed < cutoff) {
+                await deleteSession({ sessionName: e.name });
+                console.log(`Deleted: ${e.name}`);
+              }
+            })
+        );
+      })
+    );
+}

package/src/cli/index.js

@@ -0,0 +1,63 @@
+import { program } from 'commander';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+import { register as registerInit } from './commands/init.js';
+import { register as registerSession } from './commands/session.js';
+import { register as registerOpen } from './commands/open.js';
+import { register as registerEndpoint } from './commands/endpoint.js';
+import { register as registerDetectBrowser } from './commands/detect-browser.js';
+import { register as registerInstallBrowser } from './commands/install-browser.js';
+import { register as registerDoctor } from './commands/doctor.js';
+
+/* ---------- shared helpers ---------- */
+
+const safe = fn => async (...args) => {
+  try {
+    await fn(...args);
+  } catch (err) {
+    console.error(err?.message ?? err);
+    process.exit(1);
+  }
+};
+
+const attachShutdown = handle => {
+  let closing = false;
+  const shutdown = async () => {
+    if (closing) return;
+    closing = true;
+    try { await handle.close(); } finally { process.exit(0); }
+  };
+  process.once('SIGINT', shutdown);
+  process.once('SIGTERM', shutdown);
+};
+
+let _runtime;
+const getRuntime = async () => {
+  if (!_runtime) _runtime = await import('#runtime');
+  return _runtime;
+};
+
+/* ---------- version from package.json ---------- */
+
+const _require = createRequire(import.meta.url);
+const { version } = _require(resolve(dirname(fileURLToPath(import.meta.url)), '../../package.json'));
+
+/* ---------- program ---------- */
+
+program.name('szkrabok').description('szkrabok CLI').version(version);
+
+const ctx = { safe, attachShutdown, getRuntime };
+
+registerInit(program, ctx);
+registerSession(program, ctx);
+registerOpen(program, ctx);
+registerEndpoint(program, ctx);
+registerDetectBrowser(program, ctx);
+registerInstallBrowser(program, ctx);
+registerDoctor(program, ctx);
+
+export async function runCli() {
+  await program.parseAsync(process.argv);
+}

package/src/index.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 import 'dotenv/config';
+import { mkdirSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 
-const CLI_COMMANDS = new Set(['session', 'open', 'endpoint', 'detect-browser', 'install-browser', 'init']);
+const CLI_COMMANDS = new Set(['session', 'open', 'endpoint', 'detect-browser', 'install-browser', 'init', 'doctor']);
 const args = process.argv.slice(2);
 const firstArg = args[0];
 
 // --- CLI mode ---
 if (firstArg && (CLI_COMMANDS.has(firstArg) || firstArg === '--setup' || firstArg === '--help' || firstArg === '-h' || firstArg === '--version' || firstArg === '-V')) {
-  const { runCli } = await import('./cli.js');
+  const { runCli } = await import('./cli/index.js');
   await runCli();
   process.exit(0);
 }
@@ -17,9 +20,21 @@ if (args.includes('--no-headless') || args.includes('--headful')) {
   process.env.HEADLESS = 'false';
 }
 
+// Always write fatal startup errors to a fixed log so they survive MCP client restarts.
+const _logDir = join(homedir(), '.cache', 'szkrabok');
+const _logFile = join(_logDir, 'startup.log');
+const _writeStartupLog = msg => {
+  try {
+    mkdirSync(_logDir, { recursive: true });
+    appendFileSync(_logFile, `[${new Date().toISOString()}] ${msg}\n`);
+  } catch {}
+};
+
 const { createServer } = await import('./server.js');
 const { log, logError } = await import('./utils/logger.js');
 
+_writeStartupLog(`starting szkrabok pid=${process.pid}`);
+
 const server = createServer();
 
 process.on('SIGINT', async () => {
@@ -29,11 +44,15 @@ process.on('SIGINT', async () => {
 });
 
 process.on('uncaughtException', err => {
+  const msg = `uncaughtException: ${err?.message}\n${err?.stack}`;
+  _writeStartupLog(msg);
   logError('Uncaught exception', err);
   process.exit(1);
 });
 
 server.connect().catch(err => {
+  const msg = `Failed to start server: ${err?.message}\n${err?.stack}`;
+  _writeStartupLog(msg);
   logError('Failed to start server', err);
   process.exit(1);
 });

package/src/cli.js

@@ -1,277 +0,0 @@
-import { program } from 'commander';
-import path from 'node:path';
-import fs from 'node:fs/promises';
-
-import { list, deleteSession, endpoint } from './tools/szkrabok_session.js';
-
-const SESSIONS_DIR = path.join(process.cwd(), 'sessions');
-
-/* ---------- lazy runtime ---------- */
-
-let runtime;
-const getRuntime = async () => {
-  if (!runtime) runtime = await import('#runtime');
-  return runtime;
-};
-
-/* ---------- helpers ---------- */
-
-const readJson = async file => {
-  try {
-    return JSON.parse(await fs.readFile(file, 'utf8'));
-  } catch {
-    return null;
-  }
-};
-
-const safe = fn => async (...args) => {
-  try {
-    await fn(...args);
-  } catch (err) {
-    console.error(err?.message ?? err);
-    process.exit(1);
-  }
-};
-
-const attachShutdown = handle => {
-  let closing = false;
-
-  const shutdown = async () => {
-    if (closing) return;
-    closing = true;
-
-    try {
-      await handle.close();
-    } finally {
-      process.exit(0);
-    }
-  };
-
-  process.once('SIGINT', shutdown);
-  process.once('SIGTERM', shutdown);
-};
-
-/* ---------- program ---------- */
-
-program
-  .name('szkrabok')
-  .description('szkrabok CLI')
-  .version('1.0.16');
-
-/* ---------- init ---------- */
-
-program
-  .command('init')
-  .description('Scaffold minimal config')
-  .action(
-    safe(async () => {
-      const { init } = await import('./tools/scaffold.js');
-
-      const result = await init({
-        dir: process.cwd(),
-        preset: 'minimal',
-        install: false,
-      });
-
-      if (result.created.length)
-        console.error(`Created: ${result.created.join(', ')}`);
-
-      if (result.merged.length)
-        console.error(`Merged: ${result.merged.join(', ')}`);
-
-      if (result.skipped.length)
-        console.error(`Skipped: ${result.skipped.join(', ')}`);
-
-      for (const w of result.warnings)
-        console.error(`Warning: ${w}`);
-
-      console.error(
-        'Done. Run "szkrabok install-browser" if Chromium is not installed.'
-      );
-    })
-  );
-
-/* ---------- session ---------- */
-
-const session = program.command('session').description('Session management');
-
-session
-  .command('list')
-  .action(
-    safe(async () => {
-      const { sessions } = await list();
-
-      console.table(
-        sessions.map(s => ({
-          ID: s.id,
-          Active: s.active ? 'yes' : 'no',
-          Preset: s.preset ?? 'N/A',
-          Label: s.label ?? 'N/A',
-        }))
-      );
-    })
-  );
-
-session
-  .command('inspect <id>')
-  .action(
-    safe(async id => {
-      const dir = path.join(SESSIONS_DIR, id);
-
-      const [meta, state] = await Promise.all([
-        readJson(path.join(dir, 'meta.json')),
-        readJson(path.join(dir, 'state.json')),
-      ]);
-
-      if (!meta || !state)
-        throw new Error(`Session ${id} not found`);
-
-      console.log('=== METADATA ===');
-      console.log(JSON.stringify(meta, null, 2));
-
-      console.log('\n=== COOKIES ===');
-      console.log(state.cookies?.length ?? 0, 'cookies');
-
-      console.log('\n=== LOCALSTORAGE ===');
-
-      for (const origin of state.origins ?? []) {
-        console.log(
-          origin.origin,
-          ':',
-          origin.localStorage?.length ?? 0,
-          'items'
-        );
-      }
-    })
-  );
-
-session
-  .command('delete <id>')
-  .action(
-    safe(async id => {
-      await deleteSession({ sessionName: id });
-      console.log(`Session ${id} deleted`);
-    })
-  );
-
-session
-  .command('cleanup')
-  .option('--days <days>', 'delete sessions older than N days', '30')
-  .action(
-    safe(async options => {
-      const days = Number(options.days) || 30;
-      const cutoff = Date.now() - days * 86400000;
-
-      let entries;
-
-      try {
-        entries = await fs.readdir(SESSIONS_DIR, { withFileTypes: true });
-      } catch {
-        console.log('No sessions directory');
-        return;
-      }
-
-      await Promise.all(
-        entries
-          .filter(e => e.isDirectory())
-          .map(async e => {
-            const meta = await readJson(
-              path.join(SESSIONS_DIR, e.name, 'meta.json')
-            );
-
-            if (meta?.lastUsed && meta.lastUsed < cutoff) {
-              await deleteSession({ sessionName: e.name });
-              console.log(`Deleted: ${e.name}`);
-            }
-          })
-      );
-    })
-  );
-
-/* ---------- open ---------- */
-
-program
-  .command('open <profile>')
-  .description('Launch persistent browser and print CDP endpoint')
-  .option('--preset <preset>')
-  .option('--headless')
-  .action(
-    safe(async (profile, options) => {
-      const { launch } = await getRuntime();
-
-      const handle = await launch({
-        profile,
-        preset: options.preset,
-        headless: options.headless ?? undefined,
-        reuse: false,
-      });
-
-      console.log(handle.cdpEndpoint);
-
-      attachShutdown(handle);
-
-      await new Promise(() => {});
-    })
-  );
-
-/* ---------- endpoint ---------- */
-
-program
-  .command('endpoint <sessionName>')
-  .description('Print CDP and WS endpoints')
-  .action(
-    safe(async sessionName => {
-      const result = await endpoint({ sessionName });
-
-      console.log(`CDP: ${result.cdpEndpoint}`);
-
-      if (result.wsEndpoint)
-        console.log(`WS:  ${result.wsEndpoint}`);
-    })
-  );
-
-/* ---------- detect browser ---------- */
-
-program
-  .command('detect-browser')
-  .description('Detect Chrome/Chromium')
-  .action(
-    safe(async () => {
-      const { findChromiumPath } = await getRuntime();
-
-      const chromiumPath = await findChromiumPath();
-
-      if (!chromiumPath) {
-        console.log('No Chromium detected\n');
-        console.log('  szkrabok install-browser');
-        process.exit(1);
-      }
-
-      console.log(chromiumPath);
-
-      console.log('\nRecommended config:\n');
-      console.log('[default]');
-      console.log(`executablePath = "${chromiumPath}"`);
-    })
-  );
-
-/* ---------- install browser ---------- */
-
-program
-  .command('install-browser')
-  .description('Install Chromium via Playwright')
-  .action(() => {
-    import('node:child_process').then(({ spawn }) => {
-      const proc = spawn('npx', ['playwright', 'install', 'chromium'], {
-        stdio: 'inherit',
-      });
-
-      proc.on('close', code => process.exit(code ?? 0));
-    });
-  });
-
-/* ---------- export ---------- */
-
-export async function runCli() {
-  await program.parseAsync(process.argv);
-}