autokap 1.6.2 → 1.6.4

package/dist/cli.js

@@ -6,21 +6,13 @@ import fs from 'node:fs/promises';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 import { logger } from './logger.js';
-import { writeConfig, deleteConfig, requireConfig, getConfigPath, DEFAULT_API_BASE_URL, getDefaultApiBaseUrl, getDefaultWsUrl, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_KEY_ENV_VAR, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, } from './cli-config.js';
-import { renderSkillSingleFile, writeSkillExport } from './skill-packaging.js';
-import { displayNewVersionNoticeIfAvailable } from './version-check.js';
+import { writeConfig, requireConfig, getConfigPath, getDefaultApiBaseUrl, getDefaultWsUrl, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, } from './cli-config.js';
 // ── Program definition ──────────────────────────────────────────────
 export const program = new Command();
 program
     .name('autokap')
     .version(version)
     .description('AI-powered screenshot capture — local Playwright proxy');
-function getProjectPrimaryUrl(project) {
-    return (project.environments.local ??
-        project.environments.staging ??
-        project.environments.prod ??
-        null);
-}
 function fatal(message) {
     logger.error(message);
     process.exit(1);
@@ -53,33 +45,6 @@ async function requestJson(config, pathname, init, errorPrefix, searchParams) {
         fatal(`${errorPrefix}: ${error.message}`);
     }
 }
-async function requestText(config, pathname, init, errorPrefix, searchParams) {
-    try {
-        const response = await fetch(buildApiUrl(config, pathname, searchParams), init);
-        if (!response.ok) {
-            fatal(`${errorPrefix}: ${await readApiError(response)}`);
-        }
-        return await response.text();
-    }
-    catch (error) {
-        fatal(`${errorPrefix}: ${error.message}`);
-    }
-}
-function ensureListFormat(format) {
-    if (format !== 'json' && format !== 'table') {
-        fatal('Invalid --format. Use "json" or "table".');
-    }
-    return format;
-}
-function ensureExportFormat(format) {
-    if (format !== 'json' && format !== 'csv') {
-        fatal('Invalid --format. Use "json" or "csv".');
-    }
-    return format;
-}
-function printJson(value) {
-    console.log(JSON.stringify(value, null, 2));
-}
 function displayPresetName(preset) {
     const name = preset.name?.trim();
     return name && name.length > 0 ? name : preset.id;
@@ -114,49 +79,10 @@ function cloudCaptureProgressCheckpoint(event) {
             return null;
     }
 }
-function buildEndpointAssetUrl(config, endpointId) {
-    return `${config.apiBaseUrl}/api/v1/assets/${endpointId}`;
-}
-function toEndpointOutputRow(config, endpoint) {
-    return {
-        ...endpoint,
-        url: buildEndpointAssetUrl(config, endpoint.id),
-    };
-}
-function toCsv(rows, columns) {
-    const escape = (value) => {
-        const text = value === null || value === undefined ? '' : String(value);
-        return /[",\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
-    };
-    const header = columns.join(',');
-    const body = rows.map((row) => columns.map((column) => escape(row[column])).join(','));
-    return [header, ...body].join('\n');
-}
-async function loadProject(config, projectId) {
-    const data = await requestJson(config, `/api/v1/projects/${projectId}`, { headers: authHeaders(config) }, 'Failed to get project');
-    return data.project;
-}
-async function listProjectAccounts(config, projectId) {
-    const data = await requestJson(config, `/api/cli/projects/${projectId}/credentials`, { headers: authHeaders(config) }, 'Failed to list accounts');
-    return data.accounts;
-}
-async function resolveProjectAccount(config, projectId, accountNameOrId) {
-    const accounts = await listProjectAccounts(config, projectId);
-    const needle = accountNameOrId.toLowerCase();
-    const account = accounts.find((candidate) => candidate.id === accountNameOrId ||
-        candidate.name.toLowerCase() === needle);
-    if (!account) {
-        const available = accounts.map((candidate) => candidate.name).join(', ');
-        fatal(available
-            ? `Account "${accountNameOrId}" not found. Available accounts: ${available}`
-            : `Account "${accountNameOrId}" not found. This project has no accounts.`);
-    }
-    return account;
-}
 // ── login command ───────────────────────────────────────────────────
 program
     .command('login <key>')
-    .description('Authenticate the AutoKap CLI with your CLI key')
+    .description('Authenticate the AutoKap CLI with your API key')
     .option('--api-base-url <url>', `API base URL (env: ${API_BASE_URL_ENV_VAR})`, getDefaultApiBaseUrl())
     .option('--ws-url <url>', `WebSocket server URL (env: ${WS_URL_ENV_VAR})`)
     .action(async (key, opts) => {
@@ -166,7 +92,7 @@ program
             headers: { Authorization: `Bearer ${key}` },
         });
         if (!res.ok) {
-            logger.error('Invalid CLI key. Generate one in the AutoKap dashboard.');
+            logger.error('Invalid API key. Generate one in the AutoKap dashboard.');
             process.exit(1);
         }
     }
@@ -182,64 +108,9 @@ program
     logger.success(`Authenticated. Key stored in ${getConfigPath()}`);
     process.exit(0);
 });
-// ── ping command ───────────────────────────────────────────────────
-program
-    .command('ping')
-    .description('Verify CLI connection with the AutoKap server')
-    .action(async () => {
-    const config = await requireConfig();
-    try {
-        const res = await fetch(`${config.apiBaseUrl}/api/cli/validate`, {
-            headers: { Authorization: `Bearer ${config.apiKey}` },
-        });
-        if (!res.ok) {
-            logger.error('CLI key is no longer valid. Run `npx autokap@latest init --cli-key <key>` to re-authenticate.');
-            process.exit(1);
-        }
-    }
-    catch (err) {
-        logger.error(`Cannot reach API: ${err.message}`);
-        process.exit(1);
-    }
-    logger.success('Connection verified. Stored CLI key is active.');
-    process.exit(0);
-});
-// ── logout command ─────────────────────────────────────────────────
-program
-    .command('logout')
-    .description('Remove stored credentials')
-    .action(async () => {
-    await deleteConfig();
-    logger.success(`Logged out. Credentials removed from ${getConfigPath()}`);
-    process.exit(0);
-});
-// ── whoami command ─────────────────────────────────────────────────
-program
-    .command('whoami')
-    .description('Show the account linked to the current CLI key')
-    .action(async () => {
-    const config = await requireConfig();
-    try {
-        const res = await fetch(`${config.apiBaseUrl}/api/cli/validate`, {
-            headers: { Authorization: `Bearer ${config.apiKey}` },
-        });
-        if (!res.ok) {
-            logger.error('CLI key is no longer valid. Run `npx autokap@latest init --cli-key <key>` to re-authenticate.');
-            process.exit(1);
-        }
-        const data = await res.json();
-        const display = data.name
-            ? `${data.name} (${data.email})`
-            : data.email ?? 'Unknown';
-        logger.info(`Logged in as: ${display}`);
-        logger.info(`Server: ${config.apiBaseUrl}`);
-    }
-    catch (err) {
-        logger.error(`Cannot reach API: ${err.message}`);
-        process.exit(1);
-    }
-    process.exit(0);
-});
+// Auth commands (whoami / logout / ping) live in @autokap/mcp; this binary keeps
+// `login` only for CI / Cloud Run. Local dev can still inspect the config via
+// `autokap doctor` or `cat ~/.autokap/config.json`.
 async function runOutdatedPresetsLocally(opts) {
     if (opts.output) {
         fatal('`--output` is not supported with `--outdated`; run an individual preset when local copies are needed.');
@@ -356,8 +227,19 @@ program
     // launched on Fly.io. When present, we POST a completion callback at exit
     // so the `capture_runs` row flips out of `queued` — without this the
     // backend rate-limiter blocks future cloud recaptures.
+    //
+    // Both `--cloud` AND `AUTOKAP_RUN_ID` are required to enable checkpoint
+    // posts. Earlier code keyed only on `AUTOKAP_RUN_ID`, so a stray env var
+    // (e.g. leaked from a parent shell that recently ran a cloud job) would
+    // silently start firing checkpoints during a plain local recapture. Worse,
+    // the row pointed to by that stale id might already be terminal, so the
+    // posts would 4xx and pollute the dashboard's error logs. Gate strictly.
     const cloudRunId = process.env.AUTOKAP_RUN_ID;
-    const checkpointUrl = cloudRunId
+    if (cloudRunId && !opts.cloud) {
+        throw new Error('AUTOKAP_RUN_ID is set but --cloud was not passed. AUTOKAP_RUN_ID is reserved for ' +
+            '`auto-recapture --cloud` runs dispatched by the AutoKap cloud orchestrator. Unset the env var or add --cloud.');
+    }
+    const checkpointUrl = opts.cloud && cloudRunId
         ? buildApiUrl(config, `/api/cli/cloud-recapture/${cloudRunId}/checkpoint`)
         : null;
     if (opts.cloud && cloudRunId) {
@@ -608,1035 +490,15 @@ program
     });
     process.exit(0);
 });
-// ── project commands ───────────────────────────────────────────────
-const projectCmd = program
-    .command('project')
-    .description('Manage projects');
-projectCmd
-    .command('list')
-    .description('List accessible projects')
-    .action(async () => {
-    const config = await requireConfig();
-    const data = await requestJson(config, '/api/v1/projects', { headers: authHeaders(config) }, 'Failed to list projects');
-    printJson(data.projects);
-    process.exit(0);
-});
-projectCmd
-    .command('get <project-id>')
-    .description('Get project details')
-    .action(async (projectId) => {
-    const config = await requireConfig();
-    const project = await loadProject(config, projectId);
-    printJson(project);
-    process.exit(0);
-});
-projectCmd
-    .command('create')
-    .description('Create a project')
-    .requiredOption('--name <name>', 'Project name')
-    .requiredOption('--base-url <url>', 'Base URL of the chosen environment')
-    .option('--environment <name>', "Environment slot to seed: 'local' or 'prod'", 'local')
-    .option('--description <text>', 'Project description')
-    .action(async (opts) => {
-    const config = await requireConfig();
-    const env = opts.environment.toLowerCase();
-    if (env !== 'local' && env !== 'prod') {
-        logger.error("--environment must be 'local' or 'prod'");
-        process.exit(1);
-    }
-    const data = await requestJson(config, '/api/v1/projects', {
-        method: 'POST',
-        headers: authHeaders(config, { 'Content-Type': 'application/json' }),
-        body: JSON.stringify({
-            name: opts.name,
-            environment: env,
-            base_url: opts.baseUrl,
-            description: opts.description,
-        }),
-    }, 'Failed to create project');
-    console.log(data.project.id);
-    process.exit(0);
-});
-// ── capture commands ───────────────────────────────────────────────
-const captureCmd = program
-    .command('capture')
-    .description('Query captured outputs');
-captureCmd
-    .command('list')
-    .description('List captures')
-    .option('--project <id>', 'Filter by project ID')
-    .option('--preset <id>', 'Filter by preset ID')
-    .option('--limit <n>', 'Limit results', '50')
-    .option('--offset <n>', 'Offset results', '0')
-    .action(async (opts) => {
-    const config = await requireConfig();
-    const searchParams = new URLSearchParams();
-    if (opts.project)
-        searchParams.set('project_id', opts.project);
-    if (opts.preset)
-        searchParams.set('preset_id', opts.preset);
-    searchParams.set('limit', String(Math.max(1, Number.parseInt(opts.limit, 10) || 50)));
-    searchParams.set('offset', String(Math.max(0, Number.parseInt(opts.offset, 10) || 0)));
-    const data = await requestJson(config, '/api/v1/captures', { headers: authHeaders(config) }, 'Failed to list captures', searchParams);
-    printJson(data);
-    process.exit(0);
-});
-program
-    .command('usage')
-    .description('Show usage for the current billing period')
-    .action(async () => {
-    const config = await requireConfig();
-    const data = await requestJson(config, '/api/v1/usage', { headers: authHeaders(config) }, 'Failed to get usage');
-    printJson(data);
-    process.exit(0);
-});
-// ── preset commands ────────────────────────────────────────────────
-async function readJsonInput(filePath) {
-    if (filePath === '-') {
-        const chunks = [];
-        for await (const chunk of process.stdin)
-            chunks.push(chunk);
-        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
-    }
-    const raw = await fs.readFile(filePath, 'utf8');
-    return JSON.parse(raw);
-}
-async function readSecretFromStdin(label) {
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(chunk);
-    const value = Buffer.concat(chunks).toString('utf8').trim();
-    if (!value) {
-        fatal(`${label} is empty on stdin.`);
-    }
-    return value;
-}
-const presetCmd = program
-    .command('preset')
-    .description('Manage capture presets');
-presetCmd
-    .command('create')
-    .description('Create a new preset from a JSON config file')
-    .requiredOption('--project <id>', 'Project ID')
-    .requiredOption('--name <name>', 'Preset name')
-    .option('--description <text>', 'Preset description', '')
-    .requiredOption('--config <file>', 'Path to config JSON file (use "-" for stdin)')
-    .action(async (opts) => {
-    const cfg = await requireConfig();
-    let configJson;
-    try {
-        configJson = await readJsonInput(opts.config);
-    }
-    catch (err) {
-        logger.error(`Failed to read config: ${err.message}`);
-        process.exit(1);
-    }
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/presets`, {
-        method: 'POST',
-        headers: {
-            Authorization: `Bearer ${cfg.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({
-            project_id: opts.project,
-            name: opts.name,
-            description: opts.description,
-            config: configJson,
-        }),
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to create preset: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    // Output only the preset ID so callers can chain: autokap run $(autokap preset create ...)
-    console.log(data.preset.id);
-    process.exit(0);
-});
-presetCmd
-    .command('update <preset-id>')
-    .description('Update an existing preset config')
-    .option('--name <name>', 'New preset name')
-    .option('--description <text>', 'New description')
-    .requiredOption('--config <file>', 'Path to config JSON file (use "-" for stdin)')
-    .action(async (presetId, opts) => {
-    const cfg = await requireConfig();
-    let configJson;
-    try {
-        configJson = await readJsonInput(opts.config);
-    }
-    catch (err) {
-        logger.error(`Failed to read config: ${err.message}`);
-        process.exit(1);
-    }
-    const payload = { config: configJson };
-    if (opts.name !== undefined)
-        payload.name = opts.name;
-    if (opts.description !== undefined)
-        payload.description = opts.description;
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/presets/${presetId}`, {
-        method: 'PATCH',
-        headers: {
-            Authorization: `Bearer ${cfg.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(payload),
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to update preset: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    console.log(data.preset.id);
-    process.exit(0);
-});
-presetCmd
-    .command('delete <preset-id>')
-    .description('Delete a preset (soft-delete)')
-    .action(async (presetId) => {
-    const cfg = await requireConfig();
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/presets/${presetId}`, {
-        method: 'DELETE',
-        headers: { Authorization: `Bearer ${cfg.apiKey}` },
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to delete preset: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    logger.success(`Preset ${presetId} deleted`);
-    process.exit(0);
-});
-presetCmd
-    .command('get <preset-id>')
-    .description('Get preset details')
-    .action(async (presetId) => {
-    const cfg = await requireConfig();
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/presets/${presetId}`, {
-        headers: { Authorization: `Bearer ${cfg.apiKey}` },
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to get preset: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    console.log(JSON.stringify(data.preset, null, 2));
-    process.exit(0);
-});
-presetCmd
-    .command('list')
-    .description('List presets for a project')
-    .requiredOption('--project <id>', 'Project ID')
-    .action(async (opts) => {
-    const cfg = await requireConfig();
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/presets?project_id=${encodeURIComponent(opts.project)}`, { headers: { Authorization: `Bearer ${cfg.apiKey}` } });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to list presets: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    const rows = data.presets.map((p) => ({
-        id: p.id,
-        name: p.name,
-        description: p.description ?? '',
-    }));
-    console.log(JSON.stringify(rows, null, 2));
-    process.exit(0);
-});
-presetCmd
-    .command('info <preset-id>')
-    .description('Get structured integration info for a preset (endpoints, variants, URL params)')
-    .action(async (presetId) => {
-    const cfg = await requireConfig();
-    // Fetch preset + endpoints in parallel
-    const [presetRes, endpointsRes] = await Promise.all([
-        fetch(`${cfg.apiBaseUrl}/api/v1/presets/${presetId}`, {
-            headers: { Authorization: `Bearer ${cfg.apiKey}` },
-        }),
-        fetch(`${cfg.apiBaseUrl}/api/v1/endpoints?preset_id=${encodeURIComponent(presetId)}`, {
-            headers: { Authorization: `Bearer ${cfg.apiKey}` },
-        }),
-    ]);
-    if (!presetRes.ok) {
-        const body = await presetRes.json().catch(() => ({ error: presetRes.statusText }));
-        logger.error(`Failed to get preset: ${body.error || presetRes.statusText}`);
-        process.exit(1);
-    }
-    if (!endpointsRes.ok) {
-        const body = await endpointsRes.json().catch(() => ({ error: endpointsRes.statusText }));
-        logger.error(`Failed to list endpoints: ${body.error || endpointsRes.statusText}`);
-        process.exit(1);
-    }
-    const { preset } = await presetRes.json();
-    const { endpoints } = await endpointsRes.json();
-    // Extract variants from config
-    const config = preset.config ?? {};
-    const langs = Array.isArray(config.langs) ? config.langs : [];
-    const themes = Array.isArray(config.themes) ? config.themes : [];
-    const targets = Array.isArray(config.targets)
-        ? config.targets
-            .map((t) => ({ id: t.id, label: t.label, viewport: t.viewport, deviceFrame: t.deviceFrame ?? null }))
-        : [];
-    const captureMode = config.captureMode ?? 'screenshot';
-    // Build per-endpoint info with type-specific URL params
-    const endpointEntries = endpoints.map((ep) => {
-        const assetType = ep.asset_type ?? 'screenshot';
-        const url = `${cfg.apiBaseUrl}/api/v1/assets/${ep.id}`;
-        let urlParams;
-        if (assetType === 'screenshot') {
-            urlParams = {
-                lang: 'Language variant',
-                theme: 'Color theme ("light" or "dark")',
-                target: 'Device target ID',
-                w: 'Max width in px (1-2560)',
-                quality: 'Image quality 1-100',
-                format: 'Output format: "webp", "png", "jpg"',
-                scale: 'Resolution multiplier (0.5-4)',
-            };
-        }
-        else if (assetType === 'clip') {
-            urlParams = {
-                lang: 'Language variant',
-                theme: 'Color theme ("light" or "dark")',
-                target: 'Device target ID',
-                format: 'Output format: "gif" (default), "mp4"',
-            };
-        }
-        else {
-            urlParams = {};
-        }
-        return {
-            id: ep.id,
-            label: ep.label ?? null,
-            capture_name: ep.capture_name ?? null,
-            asset_type: assetType,
-            url,
-            url_params: urlParams,
-        };
-    });
-    const info = {
-        preset: {
-            id: preset.id,
-            name: preset.name,
-            description: preset.description ?? null,
-            capture_mode: captureMode,
-        },
-        variants: { langs, themes, targets },
-        endpoints: endpointEntries,
-    };
-    console.log(JSON.stringify(info, null, 2));
-    process.exit(0);
-});
-// ── video commands ─────────────────────────────────────────────────
-//
-// Mirrors the preset commands but targets `/api/video-projects` (CLI-keyed
-// route used by the IDE skill flow). The payload file contains the full
-// body expected by the API (projectId, title, user_script, legacy
-// narration_voice/narration_locale aliases, narration_by_app_locale,
-// app_locale/app_locales, app_theme/app_themes, cursor_theme,
-// credentials_account_id, mockDataInjection, program). On `update`, the same payload shape is sent
-// via PATCH. TTS is generated later by `autokap run`.
-const videoCmd = program
-    .command('video')
-    .description('Manage demo videos');
-videoCmd
-    .command('create')
-    .description('Create a new demo video from a JSON payload file')
-    .requiredOption('--payload <file>', 'Path to payload JSON file (use "-" for stdin)')
-    .action(async (opts) => {
-    const cfg = await requireConfig();
-    let payload;
-    try {
-        payload = await readJsonInput(opts.payload);
-    }
-    catch (err) {
-        logger.error(`Failed to read payload: ${err.message}`);
-        process.exit(1);
-    }
-    const res = await fetch(`${cfg.apiBaseUrl}/api/video-projects`, {
-        method: 'POST',
-        headers: {
-            Authorization: `Bearer ${cfg.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(payload),
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to create video: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    // Output only the video ID so callers can chain: autokap run $(autokap video create ...)
-    console.log(data.video.id);
-    process.exit(0);
-});
-videoCmd
-    .command('update <video-id>')
-    .description('Update an existing demo video from a JSON payload file')
-    .requiredOption('--payload <file>', 'Path to payload JSON file (use "-" for stdin)')
-    .action(async (videoId, opts) => {
-    const cfg = await requireConfig();
-    let payload;
-    try {
-        payload = await readJsonInput(opts.payload);
-    }
-    catch (err) {
-        logger.error(`Failed to read payload: ${err.message}`);
-        process.exit(1);
-    }
-    const res = await fetch(`${cfg.apiBaseUrl}/api/video-projects/${videoId}`, {
-        method: 'PATCH',
-        headers: {
-            Authorization: `Bearer ${cfg.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(payload),
-    });
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to update video: ${body.error || res.statusText}`);
-        process.exit(1);
-    }
-    const data = await res.json();
-    console.log(data.video.id);
-    process.exit(0);
-});
-// ── auth commands ──────────────────────────────────────────────────
-const authCmd = program
-    .command('auth')
-    .description('Manage authentication sessions for project credentials accounts');
-authCmd
-    .command('capture <project-id>')
-    .description('Open a browser, let you log in, and save the resulting session to a project credentials account')
-    .option('--account <name-or-id>', 'Account name or ID to attach the session to. If omitted, lists accounts to choose from.')
-    .option('--url <url>', 'URL to open in the browser. Defaults to the project URL.')
-    .action(async (projectId, opts) => {
-    const cfg = await requireConfig();
-    const allAccounts = await listProjectAccounts(cfg, projectId);
-    const accounts = allAccounts.filter((a) => a.type === 'session');
-    if (!accounts.length) {
-        if (allAccounts.length > 0) {
-            logger.error(`No session-type accounts in project ${projectId}. This project has ${allAccounts.length} credentials account(s), but none are session accounts. Create a new account with type "session" in Settings → Login accounts.`);
-        }
-        else {
-            logger.error(`No accounts found for project ${projectId}. Create a session account in Settings → Login accounts first.`);
-        }
-        process.exit(1);
-    }
-    let account;
-    if (opts.account) {
-        const needle = opts.account.toLowerCase();
-        account = accounts.find((a) => a.id === opts.account || a.name.toLowerCase() === needle);
-        if (!account) {
-            // If the account exists but is a credentials account, give a precise error.
-            const otherTypeMatch = allAccounts.find((a) => a.id === opts.account || a.name.toLowerCase() === needle);
-            if (otherTypeMatch) {
-                logger.error(`Account "${opts.account}" exists but is a credentials account (email/password). auth capture only works with session accounts.`);
-            }
-            else {
-                logger.error(`Account "${opts.account}" not found in project ${projectId}.`);
-                logger.info(`Available session accounts: ${accounts.map((a) => a.name).join(', ')}`);
-            }
-            process.exit(1);
-        }
-    }
-    else if (accounts.length === 1) {
-        account = accounts[0];
-        logger.info(`Using the only session account in this project: "${account.name}"`);
-    }
-    else {
-        logger.info('Multiple session accounts found. Re-run with --account <name>:');
-        for (const a of accounts) {
-            const status = a.storage_state_updated_at
-                ? `session updated ${a.storage_state_updated_at}`
-                : 'no session yet';
-            logger.info(`  • ${a.name}  (${status})`);
-        }
-        process.exit(0);
-    }
-    let startUrl = opts.url;
-    if (!startUrl) {
-        const project = await loadProject(cfg, projectId);
-        startUrl = getProjectPrimaryUrl(project) ?? undefined;
-    }
-    if (!startUrl) {
-        logger.error(`No environment URL configured for project ${projectId}. Configure local/staging/prod in the AutoKap web UI, or pass --url.`);
-        process.exit(1);
-    }
-    logger.info(`Opening ${startUrl}`);
-    const { captureAuthSession } = await import('./auth-capture.js');
-    await captureAuthSession({
-        apiBaseUrl: cfg.apiBaseUrl,
-        apiKey: cfg.apiKey,
-        projectId,
-        accountId: account.id,
-        startUrl,
-    });
-});
-const authAccountCmd = authCmd
-    .command('account')
-    .description('Manage project credential accounts');
-authAccountCmd
-    .command('list <project-id>')
-    .description('List accounts for a project')
-    .action(async (projectId) => {
-    const config = await requireConfig();
-    const accounts = await listProjectAccounts(config, projectId);
-    printJson(accounts);
-    process.exit(0);
-});
-authAccountCmd
-    .command('create <project-id>')
-    .description('Create a project credential account')
-    .requiredOption('--name <name>', 'Account name')
-    .option('--type <type>', 'Account type: credentials or session', 'credentials')
-    .option('--email <email>', 'Email for credentials accounts')
-    .option('--password-stdin', 'Read the password for credentials accounts from stdin', false)
-    .action(async (projectId, opts) => {
-    const type = opts.type === 'session' ? 'session' : opts.type === 'credentials' ? 'credentials' : null;
-    if (!type) {
-        fatal('Invalid --type. Use "credentials" or "session".');
-    }
-    const password = opts.passwordStdin
-        ? await readSecretFromStdin('Password')
-        : undefined;
-    if (type === 'session' && (opts.email || password)) {
-        fatal('Session accounts do not accept --email or --password-stdin.');
-    }
-    const config = await requireConfig();
-    const data = await requestJson(config, `/api/cli/projects/${projectId}/credentials`, {
-        method: 'POST',
-        headers: authHeaders(config, { 'Content-Type': 'application/json' }),
-        body: JSON.stringify({
-            name: opts.name,
-            type,
-            email: opts.email,
-            password,
-        }),
-    }, 'Failed to create account');
-    console.log(data.account.id);
-    process.exit(0);
-});
-authAccountCmd
-    .command('update <project-id>')
-    .description('Update a project credential account')
-    .requiredOption('--account <name-or-id>', 'Account name or ID')
-    .option('--name <name>', 'New account name')
-    .option('--email <email>', 'Replace the email on a credentials account')
-    .option('--password-stdin', 'Read the replacement password from stdin', false)
-    .option('--clear-email', 'Remove the stored email from a credentials account', false)
-    .option('--clear-password', 'Remove the stored password from a credentials account', false)
-    .action(async (projectId, opts) => {
-    if (opts.email && opts.clearEmail)
-        fatal('Cannot use --email and --clear-email together.');
-    if (opts.passwordStdin && opts.clearPassword)
-        fatal('Cannot use --password-stdin and --clear-password together.');
-    const password = opts.passwordStdin
-        ? await readSecretFromStdin('Password')
-        : undefined;
-    const config = await requireConfig();
-    const account = await resolveProjectAccount(config, projectId, opts.account);
-    const payload = {};
-    if (opts.name !== undefined)
-        payload.name = opts.name;
-    if (opts.email !== undefined)
-        payload.email = opts.email;
-    if (password !== undefined)
-        payload.password = password;
-    if (opts.clearEmail)
-        payload.email = null;
-    if (opts.clearPassword)
-        payload.password = null;
-    if (Object.keys(payload).length === 0) {
-        fatal('No changes provided. Pass at least one update option.');
-    }
-    const data = await requestJson(config, `/api/cli/projects/${projectId}/credentials/${account.id}`, {
-        method: 'PATCH',
-        headers: authHeaders(config, { 'Content-Type': 'application/json' }),
-        body: JSON.stringify(payload),
-    }, 'Failed to update account');
-    console.log(data.account.id);
-    process.exit(0);
-});
-authAccountCmd
-    .command('delete <project-id>')
-    .description('Delete a project credential account')
-    .requiredOption('--account <name-or-id>', 'Account name or ID')
-    .action(async (projectId, opts) => {
-    const config = await requireConfig();
-    const account = await resolveProjectAccount(config, projectId, opts.account);
-    await requestJson(config, `/api/cli/projects/${projectId}/credentials/${account.id}`, {
-        method: 'DELETE',
-        headers: authHeaders(config),
-    }, 'Failed to delete account');
-    logger.success(`Account ${account.name} deleted`);
-    process.exit(0);
-});
-const authSessionCmd = authCmd
-    .command('session')
-    .description('Manage captured browser sessions');
-authSessionCmd
-    .command('clear <project-id>')
-    .description('Clear the stored browser session for a session account')
-    .requiredOption('--account <name-or-id>', 'Account name or ID')
-    .action(async (projectId, opts) => {
-    const config = await requireConfig();
-    const account = await resolveProjectAccount(config, projectId, opts.account);
-    if (account.type !== 'session') {
-        fatal(`Account "${account.name}" is a credentials account. Only session accounts can clear a stored browser session.`);
-    }
-    await requestJson(config, `/api/cli/projects/${projectId}/credentials/${account.id}/session`, {
-        method: 'DELETE',
-        headers: authHeaders(config),
-    }, 'Failed to clear session');
-    logger.success(`Cleared session for ${account.name}`);
-    process.exit(0);
-});
-// ── endpoints commands ─────────────────────────────────────────────
-const endpointsCmd = program
-    .command('endpoints')
-    .description('Manage screenshot endpoints (dev links)');
-endpointsCmd
-    .command('list')
-    .description('List endpoints for a preset or project')
-    .option('--preset <id>', 'Preset ID')
-    .option('--project <id>', 'Project ID')
-    .option('--format <fmt>', 'Output format: json or table', 'json')
-    .action(async (opts) => {
-    if ((opts.preset ? 1 : 0) + (opts.project ? 1 : 0) !== 1) {
-        fatal('Pass exactly one of --preset or --project.');
-    }
-    const format = ensureListFormat(opts.format);
-    const cfg = await requireConfig();
-    const searchParams = new URLSearchParams();
-    if (opts.preset)
-        searchParams.set('preset_id', opts.preset);
-    if (opts.project)
-        searchParams.set('project_id', opts.project);
-    const data = await requestJson(cfg, '/api/v1/endpoints', { headers: authHeaders(cfg) }, 'Failed to list endpoints', searchParams);
-    const rows = data.endpoints.map((endpoint) => toEndpointOutputRow(cfg, endpoint));
-    if (format === 'table') {
-        console.table(rows.map((row) => ({
-            id: row.id,
-            capture_name: row.capture_name ?? '(default)',
-            label: row.label,
-            asset_type: row.asset_type ?? 'screenshot',
-            url: row.url,
-        })));
-    }
-    else {
-        printJson(rows);
-    }
-    process.exit(0);
-});
-endpointsCmd
-    .command('get <endpoint-id>')
-    .description('Get endpoint details')
-    .action(async (endpointId) => {
-    const cfg = await requireConfig();
-    const data = await requestJson(cfg, `/api/v1/endpoints/${endpointId}`, { headers: authHeaders(cfg) }, 'Failed to get endpoint');
-    printJson(toEndpointOutputRow(cfg, data.endpoint));
-    process.exit(0);
-});
-endpointsCmd
-    .command('export')
-    .description('Export endpoints as JSON or CSV')
-    .option('--preset <id>', 'Preset ID')
-    .option('--project <id>', 'Project ID')
-    .option('--format <fmt>', 'Output format: json or csv', 'json')
-    .action(async (opts) => {
-    if ((opts.preset ? 1 : 0) + (opts.project ? 1 : 0) !== 1) {
-        fatal('Pass exactly one of --preset or --project.');
-    }
-    const format = ensureExportFormat(opts.format);
-    const cfg = await requireConfig();
-    if (opts.preset) {
-        const searchParams = new URLSearchParams({
-            preset_id: opts.preset,
-            format,
-        });
-        if (format === 'csv') {
-            const csv = await requestText(cfg, '/api/v1/endpoints/export', { headers: authHeaders(cfg) }, 'Failed to export endpoints', searchParams);
-            process.stdout.write(csv);
-        }
-        else {
-            const data = await requestJson(cfg, '/api/v1/endpoints/export', { headers: authHeaders(cfg) }, 'Failed to export endpoints', searchParams);
-            printJson(data);
-        }
-        process.exit(0);
-    }
-    const searchParams = new URLSearchParams({ project_id: opts.project });
-    const data = await requestJson(cfg, '/api/v1/endpoints', { headers: authHeaders(cfg) }, 'Failed to list endpoints', searchParams);
-    const rows = data.endpoints.map((endpoint) => toEndpointOutputRow(cfg, endpoint));
-    if (format === 'csv') {
-        process.stdout.write(`${toCsv(rows, ['id', 'label', 'url', 'capture_type', 'asset_type', 'capture_name'])}\n`);
-    }
-    else {
-        printJson({ endpoints: rows });
-    }
-    process.exit(0);
-});
-// ── skill command ───────────────────────────────────────────────────
-// Agent output path mappings
-const AGENT_PATHS = {
-    claude: '.claude/commands/autokap-preset.md',
-    codex: '.agents/skills/autokap-preset/SKILL.md',
-    cursor: '.cursor/rules/autokap-preset.md',
-    windsurf: '.windsurf/rules/autokap-preset.md',
-    copilot: '.github/instructions/autokap-preset.instructions.md',
-};
-program
-    .command('skill')
-    .description('Output or install an AutoKap skill for AI coding agents')
-    .option('--output <path>', 'Write the generated skill output to this path instead of stdout')
-    .option('--agent <name>', 'Target AI coding agent: claude, codex, cursor, windsurf, copilot (auto-resolves output path and packaging mode)')
-    .option('--project-url <url>', 'Replace the project URL placeholder in the skill')
-    .option('--project-id <id>', 'Replace the project ID placeholder in the skill')
-    .option('--api-base-url <url>', 'Replace the API base URL placeholder (default: https://autokap.app)')
-    .action(async (opts) => {
-    const pathMap = AGENT_PATHS;
-    // Resolve --agent to an output path
-    if (opts.agent) {
-        const agentKey = opts.agent.toLowerCase();
-        if (!pathMap[agentKey]) {
-            logger.error(`Unknown agent "${opts.agent}". Supported: ${Object.keys(pathMap).join(', ')}`);
-            process.exit(1);
-        }
-        if (opts.output) {
-            logger.error('Cannot use both --agent and --output. Pick one.');
-            process.exit(1);
-        }
-        opts.output = pathMap[agentKey];
-    }
-    try {
-        if (opts.output) {
-            const result = await writeSkillExport({
-                type: 'preset',
-                agent: opts.agent?.toLowerCase(),
-                outputPath: opts.output,
-                placeholders: opts,
-            });
-            if (result.mode === 'bundle') {
-                logger.success(`Skill bundle written to: ${path.dirname(opts.output)}`);
-            }
-            else {
-                logger.success(`Skill file written to: ${opts.output}`);
-            }
-        }
-        else {
-            const content = await renderSkillSingleFile({
-                type: 'preset',
-                agent: opts.agent?.toLowerCase(),
-                placeholders: opts,
-            });
-            process.stdout.write(content);
-        }
-    }
-    catch (error) {
-        logger.error(error.message);
-        process.exit(1);
-    }
-    process.exit(0);
-});
-// ── init command ───────────────────────────────────────────────────
-program
-    .command('init')
-    .description('Set up AutoKap: authenticate and install the AI skill in one step')
-    .option('--cli-key <key>', 'Your AutoKap CLI key')
-    .option('--project-id <id>', 'Your project ID (optional, can be set later)')
-    .option('--agent <name>', 'Target AI coding agent: claude, codex, cursor, windsurf, copilot (default: auto-detect)')
-    .option('--api-base-url <url>', `API base URL (env: ${API_BASE_URL_ENV_VAR})`, getDefaultApiBaseUrl())
-    .option('--ws-url <url>', `WebSocket server URL (env: ${WS_URL_ENV_VAR})`)
-    .action(async (opts) => {
-    const wsUrl = opts.wsUrl?.trim() || getDefaultWsUrl(opts.apiBaseUrl);
-    // If --cli-key not provided, prompt interactively
-    let cliKey = opts.cliKey;
-    if (!cliKey) {
-        if (process.stdin.isTTY === false) {
-            logger.error(`CLI key is required in non-interactive shells. Pass --cli-key <key> or set ${API_KEY_ENV_VAR} for CI runs.`);
-            process.exit(1);
-        }
-        const readline = await import('node:readline');
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        cliKey = await new Promise((resolve) => {
-            rl.question('Enter your AutoKap CLI key:', (answer) => {
-                rl.close();
-                resolve(answer.trim());
-            });
-        });
-        if (!cliKey) {
-            logger.error('CLI key is required. Get one at https://autokap.app/settings');
-            process.exit(1);
-        }
-    }
-    // Validate the key
-    logger.info('Validating CLI key...');
-    try {
-        const res = await fetch(`${opts.apiBaseUrl}/api/cli/validate`, {
-            headers: { Authorization: `Bearer ${cliKey}` },
-        });
-        if (!res.ok) {
-            logger.error('Invalid CLI key. Generate one at https://autokap.app/settings');
-            process.exit(1);
-        }
-    }
-    catch (err) {
-        logger.error(`Cannot reach API: ${err.message}`);
-        process.exit(1);
-    }
-    // Store credentials
-    await writeConfig({
-        apiKey: cliKey,
-        apiBaseUrl: opts.apiBaseUrl,
-        wsUrl,
-    });
-    logger.success(`Authenticated. Key stored in ${getConfigPath()}`);
-    // Determine agent target
-    let agentKey = opts.agent?.toLowerCase();
-    if (!agentKey) {
-        // Auto-detect from directory structure
-        const detectors = [
-            ['.claude', 'claude'],
-            ['.agents', 'codex'],
-            ['.cursor', 'cursor'],
-            ['.windsurf', 'windsurf'],
-            ['.github/instructions', 'copilot'],
-        ];
-        for (const [dir, key] of detectors) {
-            try {
-                await fs.access(dir);
-                agentKey = key;
-                break;
-            }
-            catch { /* try next */ }
-        }
-        if (!agentKey)
-            agentKey = 'claude'; // Default
-        logger.info(`Detected agent: ${agentKey}`);
-    }
-    if (!AGENT_PATHS[agentKey]) {
-        logger.error(`Unknown agent "${agentKey}". Supported: ${Object.keys(AGENT_PATHS).join(', ')}`);
-        process.exit(1);
-    }
-    // Install skill file
-    const skillOutput = AGENT_PATHS[agentKey];
-    try {
-        const result = await writeSkillExport({
-            type: 'preset',
-            agent: agentKey,
-            outputPath: skillOutput,
-            placeholders: {
-                projectId: opts.projectId,
-                apiBaseUrl: opts.apiBaseUrl !== DEFAULT_API_BASE_URL ? opts.apiBaseUrl : undefined,
-            },
-        });
-        if (result.mode === 'bundle') {
-            logger.success(`Skill bundle installed to: ${path.dirname(skillOutput)}`);
-        }
-        else {
-            logger.success(`Skill installed to: ${skillOutput}`);
-        }
-    }
-    catch (error) {
-        logger.error(error.message);
-        process.exit(1);
-    }
-    console.log('');
-    console.log('Setup complete! You can now:');
-    console.log(`  - Ask your AI agent to create presets using the autokap-preset skill`);
-    console.log(`  - Run captures locally: autokap run <preset-id>`);
-    process.exit(0);
-});
-// ── proxy command ──────────────────────────────────────────────────
-const proxyCmd = program
-    .command('proxy')
-    .description('Manage capture proxy for edge caching');
-proxyCmd
-    .command('register')
-    .description('Register a user-side proxy for faster capture loading')
-    .requiredOption('--project <id>', 'Project ID')
-    .requiredOption('--proxy-url <url>', 'Proxy base URL (e.g. https://myapp.com/api/autokap/assets)')
-    .option('--webhook-url <url>', 'Webhook URL for cache invalidation (e.g. https://myapp.com/api/autokap/webhook)')
-    .option('--signing-secret <secret>', 'Webhook signing secret (auto-generated if omitted)')
-    .action(async (opts) => {
-    const cfg = await requireConfig();
-    const body = {
-        proxy_base_url: opts.proxyUrl,
-    };
-    if (opts.webhookUrl)
-        body.webhook_url = opts.webhookUrl;
-    if (opts.signingSecret)
-        body.signing_secret = opts.signingSecret;
-    const res = await fetch(`${cfg.apiBaseUrl}/api/v1/projects/${opts.project}/proxy`, {
-        method: 'PATCH',
-        headers: {
-            Authorization: `Bearer ${cfg.apiKey}`,
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(body),
-    });
-    if (!res.ok) {
-        const data = await res.json().catch(() => ({ error: res.statusText }));
-        logger.error(`Failed to register proxy: ${data.error || res.statusText}`);
-        process.exit(1);
-    }
-    const result = await res.json();
-    logger.info(`Proxy registered: ${result.proxy_base_url}`);
-    if (result.webhook_url) {
-        logger.info(`Webhook configured: ${result.webhook_url}`);
-    }
-    if (result.signing_secret) {
-        console.log('');
-        console.log('Add this to your environment variables:');
-        console.log(`  AUTOKAP_WEBHOOK_SECRET=${result.signing_secret}`);
-        console.log('');
-    }
-    process.exit(0);
-});
-proxyCmd
-    .command('verify')
-    .description('Verify the configured proxy for a project')
-    .requiredOption('--project <id>', 'Project ID')
-    .action(async (opts) => {
-    const config = await requireConfig();
-    const project = await loadProject(config, opts.project);
-    if (!project.proxy_base_url) {
-        fatal(`Project ${opts.project} has no proxy configured. Run "autokap proxy register" first.`);
-    }
-    const result = await requestJson(config, '/api/v1/proxy/verify', {
-        method: 'POST',
-        headers: authHeaders(config, { 'Content-Type': 'application/json' }),
-        body: JSON.stringify({
-            project_id: opts.project,
-            proxy_base_url: project.proxy_base_url,
-        }),
-    }, 'Failed to verify proxy');
-    printJson(result);
-    if (!result.success) {
-        process.exit(1);
-    }
-    process.exit(0);
-});
-// ── branding command ───────────────────────────────────────────────
-const brandingCmd = program
-    .command('branding')
-    .description('Manage project branding and design system');
-brandingCmd
-    .command('import <file-path>')
-    .description('Import a design.md file as the project design system')
-    .requiredOption('--project <id>', 'Project ID')
-    .option('--dry', 'Validate and extract tokens without persisting', false)
-    .option('--json', 'JSON output for IDE assistants', false)
-    .option('--force-light-only', 'Skip dark-mode AI derivation', false)
-    .action(async (filePath, opts) => {
-    const config = await requireConfig();
-    const resolved = path.resolve(process.cwd(), filePath);
-    let content;
-    try {
-        content = await fs.readFile(resolved, 'utf8');
-    }
-    catch (e) {
-        fatal(`Cannot read file at ${resolved}: ${e.message}`);
-    }
-    if (content.length > 200_000) {
-        fatal(`File too large (${content.length} bytes, max 200000).`);
-    }
-    if (content.trim().length === 0) {
-        fatal(`File at ${resolved} is empty.`);
-    }
-    const result = await requestJson(config, `/api/cli/projects/${opts.project}/design-system/import`, {
-        method: 'POST',
-        headers: authHeaders(config, { 'Content-Type': 'application/json' }),
-        body: JSON.stringify({
-            source_markdown: content,
-            source_path: filePath,
-            options: {
-                dry_run: opts.dry,
-                force_light_only: opts.forceLightOnly,
-            },
-        }),
-    }, 'Failed to import design.md');
-    if (opts.json) {
-        printJson(result);
-        process.exit(0);
-    }
-    const ds = result.design_system;
-    if (ds?.meta?.name) {
-        logger.info(`Design system "${ds.meta.name}" imported for project ${opts.project}.`);
-    }
-    else {
-        logger.info(`Design system imported for project ${opts.project}.`);
-    }
-    const lightColors = ds?.light?.colors ?? {};
-    const colorKeys = Object.keys(lightColors);
-    if (colorKeys.length > 0) {
-        logger.info(`  Colors: ${colorKeys.length} (${colorKeys.slice(0, 5).join(', ')}${colorKeys.length > 5 ? '…' : ''})`);
-    }
-    const titleFont = ds?.light?.typography?.title?.fontFamily;
-    if (titleFont) {
-        logger.info(`  Title font: ${titleFont}`);
-    }
-    if (ds?.dark?.colors) {
-        logger.info(`  Dark mode: derived (${Object.keys(ds.dark.colors).length} colors)`);
-    }
-    if (Array.isArray(result.warnings) && result.warnings.length > 0) {
-        logger.info(`  Warnings:`);
-        for (const w of result.warnings) {
-            logger.info(`    - ${w}`);
-        }
-    }
-    if (opts.dry) {
-        logger.info(`  (dry-run: nothing persisted)`);
-    }
-    process.exit(0);
-});
-brandingCmd
-    .command('export')
-    .description('Export the project design system as design.md (or JSON)')
-    .requiredOption('--project <id>', 'Project ID')
-    .option('--out <path>', 'Write to file instead of stdout')
-    .option('--format <fmt>', 'Output format: md or json', 'md')
-    .action(async (opts) => {
-    if (opts.format !== 'md' && opts.format !== 'json') {
-        fatal('Invalid --format. Use "md" or "json".');
-    }
-    const config = await requireConfig();
-    const searchParams = opts.format === 'json' ? new URLSearchParams({ format: 'json' }) : undefined;
-    if (opts.format === 'json') {
-        const payload = await requestJson(config, `/api/cli/projects/${opts.project}/design-system`, { headers: authHeaders(config) }, 'Failed to export design system', searchParams);
-        const body = JSON.stringify(payload, null, 2);
-        if (opts.out) {
-            await fs.writeFile(path.resolve(process.cwd(), opts.out), body, 'utf8');
-            logger.info(`Wrote design system JSON to ${opts.out}`);
-        }
-        else {
-            process.stdout.write(`${body}\n`);
-        }
-        process.exit(0);
-    }
-    const result = await requestJson(config, `/api/cli/projects/${opts.project}/design-system`, { headers: authHeaders(config) }, 'Failed to export design system');
-    if (opts.out) {
-        await fs.writeFile(path.resolve(process.cwd(), opts.out), result.content, 'utf8');
-        logger.info(`Wrote design.md to ${opts.out}`);
-    }
-    else {
-        process.stdout.write(result.content);
-        if (!result.content.endsWith('\n'))
-            process.stdout.write('\n');
-    }
-    process.exit(0);
-});
+// Project, preset, capture, usage, video, auth, endpoints, skill, init, proxy,
+// and branding workflows live in @autokap/mcp. This binary exposes only the
+// commands needed by CI and Cloud Run (login / run / auto-recapture / doctor).
+// See MIGRATION-v1-to-v2.md for the CLI→MCP tool mapping (kept for older users).
 // ── doctor command ──────────────────────────────────────────────────
 program
     .command('doctor')
-    .description('Check environment and dependencies (Node, Chromium, ffmpeg, config, skill, version)')
-    .option('--fix', 'Attempt to auto-fix detected issues (Chromium install, skill reinstall)', false)
-    .option('--agent <name>', 'Override agent for skill check: claude, codex, cursor, windsurf, copilot')
+    .description('Check environment and dependencies (Node, Chromium, ffmpeg, config, API key)')
+    .option('--fix', 'Attempt to auto-fix detected issues (Chromium install)', false)
     .option('--json', 'Output a structured JSON report to stdout (for AI assistants and tooling)', false)
     .action(async (opts) => {
     const { runDoctor } = await import('./cli-doctor.js');
@@ -1649,7 +511,6 @@ const isDirectExecution = resolvedArgv && await resolvedArgv.then(p => {
     return base === 'cli.js' || base === 'cli.ts';
 });
 if (isDirectExecution) {
-    await displayNewVersionNoticeIfAvailable(version);
     program.parseAsync().catch(async (err) => {
         logger.error(err.message);
         process.exit(1);