@hasna/testers 0.0.8 → 0.0.11

package/dist/cli/index.js

@@ -2560,7 +2560,10 @@ function listScenarios(filter) {
   if (conditions.length > 0) {
     sql += " WHERE " + conditions.join(" AND ");
   }
-  sql += " ORDER BY created_at DESC";
+  const sortField = filter?.sort ?? "date";
+  const sortDir = filter?.desc === false ? "ASC" : "DESC";
+  const orderByCol = sortField === "name" ? "name" : sortField === "priority" ? "CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 ELSE 4 END" : "created_at";
+  sql += ` ORDER BY ${orderByCol} ${sortDir}`;
   if (filter?.limit) {
     sql += " LIMIT ?";
     params.push(filter.limit);
@@ -2666,7 +2669,8 @@ __export(exports_runs, {
   listRuns: () => listRuns,
   getRun: () => getRun,
   deleteRun: () => deleteRun,
-  createRun: () => createRun
+  createRun: () => createRun,
+  countRuns: () => countRuns
 });
 function createRun(input) {
   const db2 = getDatabase();
@@ -2707,7 +2711,10 @@ function listRuns(filter) {
   if (conditions.length > 0) {
     sql += " WHERE " + conditions.join(" AND ");
   }
-  sql += " ORDER BY started_at DESC";
+  const sortField = filter?.sort ?? "date";
+  const sortDir = filter?.desc === false ? "ASC" : "DESC";
+  const orderByCol = sortField === "duration" ? "(CASE WHEN finished_at IS NULL THEN NULL ELSE (julianday(finished_at) - julianday(started_at)) * 86400000 END)" : sortField === "cost" ? "(SELECT COALESCE(SUM(cost_cents), 0) FROM results WHERE run_id = runs.id)" : "started_at";
+  sql += ` ORDER BY ${orderByCol} ${sortDir}`;
   if (filter?.limit) {
     sql += " LIMIT ?";
     params.push(filter.limit);
@@ -2719,6 +2726,24 @@ function listRuns(filter) {
   const rows = db2.query(sql).all(...params);
   return rows.map(runFromRow);
 }
+function countRuns(filter) {
+  const db2 = getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter?.projectId) {
+    conditions.push("project_id = ?");
+    params.push(filter.projectId);
+  }
+  if (filter?.status) {
+    conditions.push("status = ?");
+    params.push(filter.status);
+  }
+  let sql = "SELECT COUNT(*) as count FROM runs";
+  if (conditions.length > 0)
+    sql += " WHERE " + conditions.join(" AND ");
+  const row = db2.query(sql).get(...params);
+  return row.count;
+}
 function updateRun(id, updates) {
   const db2 = getDatabase();
   const existing = getRun(id);
@@ -3383,11 +3408,95 @@ var {
   Help
 } = import__.default;
 
+// src/cli/index.tsx
+import chalk5 from "chalk";
+// package.json
+var package_default = {
+  name: "@hasna/testers",
+  version: "0.0.11",
+  description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
+  type: "module",
+  main: "dist/index.js",
+  types: "dist/index.d.ts",
+  bin: {
+    testers: "dist/cli/index.js",
+    "testers-mcp": "dist/mcp/index.js",
+    "testers-serve": "dist/server/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js"
+    }
+  },
+  files: [
+    "dist/",
+    "dashboard/dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  scripts: {
+    build: "bun run build:dashboard && bun run build:cli && bun run build:mcp && bun run build:server && bun run build:lib && bun run build:types",
+    "build:cli": "bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external @anthropic-ai/sdk --external playwright",
+    "build:mcp": "bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external @anthropic-ai/sdk --external playwright",
+    "build:server": "bun build src/server/index.ts --outdir dist/server --target bun --external @anthropic-ai/sdk --external playwright",
+    "build:lib": "bun build src/index.ts --outdir dist --target bun --external playwright --external @anthropic-ai/sdk --external @modelcontextprotocol/sdk",
+    "build:types": "NODE_OPTIONS='--max-old-space-size=8192' tsc --emitDeclarationOnly --outDir dist --skipLibCheck",
+    "build:dashboard": "cd dashboard && bun run build",
+    typecheck: "tsc --noEmit",
+    test: "bun test",
+    "dev:cli": "bun run src/cli/index.tsx",
+    "dev:mcp": "bun run src/mcp/index.ts",
+    "dev:serve": "bun run src/server/index.ts",
+    prepublishOnly: "bun run build"
+  },
+  dependencies: {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    chalk: "^5.4.1",
+    commander: "^13.1.0",
+    ink: "^5.2.0",
+    playwright: "^1.50.0",
+    react: "^18.3.1",
+    zod: "^3.24.2"
+  },
+  devDependencies: {
+    "@types/bun": "latest",
+    "@types/react": "^18.3.18",
+    typescript: "^5.7.3"
+  },
+  engines: {
+    bun: ">=1.0.0"
+  },
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  repository: {
+    type: "git",
+    url: "https://github.com/hasna/open-testers.git"
+  },
+  license: "MIT",
+  keywords: [
+    "testing",
+    "qa",
+    "ai",
+    "playwright",
+    "browser",
+    "screenshot",
+    "automation",
+    "cli",
+    "mcp"
+  ]
+};
+
 // src/cli/index.tsx
 init_scenarios();
 init_runs();
-import chalk5 from "chalk";
+import { render, Box, Text, useInput, useApp } from "ink";
+import React, { useState } from "react";
 import { readFileSync as readFileSync6, readdirSync, writeFileSync as writeFileSync3 } from "fs";
+import { createInterface } from "readline";
 import { join as join6, resolve } from "path";
 
 // src/db/results.ts
@@ -4595,6 +4704,38 @@ async function dispatchWebhooks(event, run, schedule) {
   }
 }
 
+// src/lib/logs-integration.ts
+async function pushFailedRunToLogs(run, failedResults, scenarios) {
+  const logsUrl = process.env.LOGS_URL;
+  if (!logsUrl)
+    return;
+  const scenarioMap = new Map(scenarios.map((s) => [s.id, s]));
+  const entries = failedResults.map((result) => {
+    const scenario = scenarioMap.get(result.scenarioId);
+    return {
+      level: "error",
+      source: "sdk",
+      service: "testers",
+      message: `[testers] Scenario failed: ${scenario?.name ?? result.scenarioId}${result.error ? ` \u2014 ${result.error}` : ""}`,
+      metadata: {
+        run_id: run.id,
+        scenario_id: result.scenarioId,
+        scenario_name: scenario?.name,
+        url: run.url,
+        status: result.status,
+        duration_ms: result.durationMs
+      }
+    };
+  });
+  try {
+    await fetch(`${logsUrl.replace(/\/$/, "")}/api/logs`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(entries)
+    });
+  } catch {}
+}
+
 // src/lib/runner.ts
 var eventHandler = null;
 function onRunEvent(handler) {
@@ -4606,14 +4747,26 @@ function emit(event) {
 }
 function withTimeout(promise, ms, label) {
   return new Promise((resolve, reject) => {
+    const warningAt = Math.floor(ms * 0.8);
+    const warningTimer = setTimeout(() => {
+      emit({
+        type: "scenario:timeout_warning",
+        scenarioName: label,
+        timeoutMs: ms,
+        elapsedMs: warningAt
+      });
+    }, warningAt);
     const timer = setTimeout(() => {
-      reject(new Error(`Scenario timeout after ${ms}ms: ${label}`));
+      clearTimeout(warningTimer);
+      reject(new Error(`Scenario '${label}' timed out after ${ms}ms. Try: testers run --timeout ${ms * 2} or simplify the scenario steps.`));
     }, ms);
     promise.then((val) => {
       clearTimeout(timer);
+      clearTimeout(warningTimer);
       resolve(val);
     }, (err) => {
       clearTimeout(timer);
+      clearTimeout(warningTimer);
       reject(err);
     });
   });
@@ -4642,6 +4795,7 @@ async function runSingleScenario(scenario, runId, options) {
     const targetUrl = scenario.targetPath ? `${options.url.replace(/\/$/, "")}${scenario.targetPath}` : options.url;
     const scenarioTimeout = scenario.timeoutMs ?? options.timeout ?? config.browser.timeout ?? 60000;
     await page.goto(targetUrl, { timeout: Math.min(scenarioTimeout, 30000) });
+    const stepStartTimes = new Map;
     const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
@@ -4651,6 +4805,16 @@ async function runSingleScenario(scenario, runId, options) {
       runId,
       maxTurns: 30,
       onStep: (stepEvent) => {
+        let stepDurationMs;
+        if (stepEvent.type === "tool_call") {
+          stepStartTimes.set(stepEvent.stepNumber, Date.now());
+        } else if (stepEvent.type === "tool_result") {
+          const startTime = stepStartTimes.get(stepEvent.stepNumber);
+          if (startTime !== undefined) {
+            stepDurationMs = Date.now() - startTime;
+            stepStartTimes.delete(stepEvent.stepNumber);
+          }
+        }
         emit({
           type: `step:${stepEvent.type}`,
           scenarioId: scenario.id,
@@ -4660,7 +4824,8 @@ async function runSingleScenario(scenario, runId, options) {
           toolInput: stepEvent.toolInput,
           toolResult: stepEvent.toolResult,
           thinking: stepEvent.thinking,
-          stepNumber: stepEvent.stepNumber
+          stepNumber: stepEvent.stepNumber,
+          stepDurationMs
         });
       }
     }), scenarioTimeout, scenario.name);
@@ -4740,6 +4905,7 @@ async function runBatch(scenarios, options) {
     } catch {}
     return true;
   };
+  const maxRetries = options.retry ?? 0;
   if (parallel <= 1) {
     for (const scenario of sortedScenarios) {
       if (!await canRun(scenario)) {
@@ -4750,7 +4916,13 @@ async function runBatch(scenarios, options) {
         emit({ type: "scenario:error", scenarioId: scenario.id, scenarioName: scenario.name, error: "Dependency failed \u2014 skipped", runId: run.id });
         continue;
       }
-      const result = await runSingleScenario(scenario, run.id, options);
+      let result = await runSingleScenario(scenario, run.id, options);
+      let attempt = 1;
+      while ((result.status === "failed" || result.status === "error") && attempt <= maxRetries) {
+        emit({ type: "scenario:start", scenarioId: scenario.id, scenarioName: scenario.name, runId: run.id, retryAttempt: attempt + 1, maxRetries: maxRetries + 1 });
+        result = await runSingleScenario(scenario, run.id, options);
+        attempt++;
+      }
       results.push(result);
       if (result.status === "failed" || result.status === "error") {
         failedScenarioIds.add(scenario.id);
@@ -4797,6 +4969,10 @@ async function runBatch(scenarios, options) {
   emit({ type: "run:complete", runId: run.id });
   const eventType = finalRun.status === "failed" ? "failed" : "completed";
   dispatchWebhooks(eventType, finalRun).catch(() => {});
+  if (finalRun.status === "failed") {
+    const failedResults = results.filter((r) => r.status === "failed" || r.status === "error");
+    pushFailedRunToLogs(finalRun, failedResults, scenarios).catch(() => {});
+  }
   return { run: finalRun, results };
 }
 async function runByFilter(options) {
@@ -4912,13 +5088,28 @@ function estimateCost(model, tokens) {
 // src/lib/reporter.ts
 import chalk from "chalk";
 init_scenarios();
-function formatTerminal(run, results) {
+init_database();
+function useEmoji() {
+  return !process.env["NO_COLOR"] && process.argv.indexOf("--no-color") === -1;
+}
+function formatTerminal(run, results, options) {
   const lines = [];
+  const failedOnly = options?.failedOnly ?? false;
   lines.push("");
   lines.push(chalk.bold(`  Run ${run.id.slice(0, 8)} \u2014 ${run.url}`));
   lines.push(chalk.dim(`  Model: ${run.model} | Parallel: ${run.parallel} | Headed: ${run.headed ? "yes" : "no"}`));
   lines.push("");
+  if (failedOnly) {
+    const passedCount = results.filter((r) => r.status === "passed").length;
+    if (passedCount > 0) {
+      lines.push(chalk.dim(`  (${passedCount} passed scenario${passedCount !== 1 ? "s" : ""} hidden \u2014 use without --failed-only to see all)`));
+      lines.push("");
+    }
+  }
   for (const result of results) {
+    if (failedOnly && result.status !== "failed" && result.status !== "error") {
+      continue;
+    }
     const scenario = getScenario(result.scenarioId);
     const name = scenario ? `${scenario.shortId}: ${scenario.name}` : result.scenarioId.slice(0, 8);
     const screenshots = listScreenshots(result.id);
@@ -4926,21 +5117,22 @@ function formatTerminal(run, results) {
     const screenshotCount = screenshots.length;
     let statusIcon;
     let statusColor;
+    const emoji = useEmoji();
     switch (result.status) {
       case "passed":
-        statusIcon = chalk.green("PASS");
+        statusIcon = emoji ? "\u2705" : chalk.green("PASS");
         statusColor = chalk.green;
         break;
       case "failed":
-        statusIcon = chalk.red("FAIL");
+        statusIcon = emoji ? "\u274C" : chalk.red("FAIL");
         statusColor = chalk.red;
         break;
       case "error":
-        statusIcon = chalk.yellow("ERR ");
+        statusIcon = emoji ? "\u26A0\uFE0F " : chalk.yellow("ERR ");
         statusColor = chalk.yellow;
         break;
       default:
-        statusIcon = chalk.dim("SKIP");
+        statusIcon = emoji ? "\u23ED\uFE0F " : chalk.dim("SKIP");
         statusColor = chalk.dim;
         break;
     }
@@ -4953,17 +5145,34 @@ function formatTerminal(run, results) {
     }
   }
   lines.push("");
-  lines.push(formatSummary(run));
+  lines.push(formatActionableSummary(run, results));
   lines.push("");
   return lines.join(`
 `);
 }
-function formatSummary(run) {
-  const duration = run.finishedAt ? `${((new Date(run.finishedAt).getTime() - new Date(run.startedAt).getTime()) / 1000).toFixed(1)}s` : "running";
-  const passedStr = chalk.green(`${run.passed} passed`);
-  const failedStr = run.failed > 0 ? chalk.red(` ${run.failed} failed`) : "";
-  const totalStr = chalk.dim(` (${run.total} total)`);
-  return `  ${passedStr}${failedStr}${totalStr} in ${duration}`;
+function formatActionableSummary(run, results) {
+  const emoji = useEmoji();
+  const passedCount = results.filter((r) => r.status === "passed").length;
+  const failedCount = results.filter((r) => r.status === "failed" || r.status === "error").length;
+  const shortId = run.id.slice(0, 8);
+  const passStr = `${emoji ? "\u2705" : "PASS"} ${passedCount} passed`;
+  const failStr = failedCount > 0 ? `  ${emoji ? "\u274C" : "FAIL"} ${failedCount} failed` : "";
+  const lines = [];
+  lines.push(`  ${chalk.bold(passStr)}${failedCount > 0 ? chalk.bold(failStr) : ""}`);
+  if (failedCount > 0) {
+    lines.push(chalk.dim(`  retry failed: testers retry ${shortId}  |  view: testers results ${shortId}`));
+  } else {
+    lines.push(chalk.dim(`  view: testers results ${shortId}`));
+  }
+  const totalCostCents = results.reduce((sum, r) => sum + (r.costCents ?? 0), 0);
+  const totalTokens = results.reduce((sum, r) => sum + (r.tokensUsed ?? 0), 0);
+  if (totalTokens > 0) {
+    const costStr = `$${(totalCostCents / 100).toFixed(4)}`;
+    const tokensStr = totalTokens.toLocaleString();
+    lines.push(chalk.dim(`  ${emoji ? "\uD83D\uDCB0" : "cost:"} Cost: ${costStr} (${tokensStr} tokens)`));
+  }
+  return lines.join(`
+`);
 }
 function formatJSON(run, results) {
   const output = {
@@ -5043,6 +5252,15 @@ function formatRunList(runs) {
   return lines.join(`
 `);
 }
+function getScenarioRunStats(scenarioId) {
+  const db2 = getDatabase();
+  const lastRow = db2.query("SELECT status FROM results WHERE scenario_id = ? ORDER BY created_at DESC LIMIT 1").get(scenarioId);
+  const statsRow = db2.query("SELECT COUNT(*) as total, SUM(CASE WHEN status = 'passed' THEN 1 ELSE 0 END) as passed FROM results WHERE scenario_id = ?").get(scenarioId);
+  return {
+    lastStatus: lastRow ? lastRow.status : null,
+    passRate: statsRow && statsRow.total > 0 ? `${statsRow.passed}/${statsRow.total}` : "\u2014"
+  };
+}
 function formatScenarioList(scenarios) {
   const lines = [];
   lines.push("");
@@ -5057,7 +5275,21 @@ function formatScenarioList(scenarios) {
   for (const s of scenarios) {
     const priorityColor = s.priority === "critical" ? chalk.red : s.priority === "high" ? chalk.yellow : s.priority === "medium" ? chalk.blue : chalk.dim;
     const tags = s.tags.length > 0 ? chalk.dim(` [${s.tags.join(", ")}]`) : "";
-    lines.push(`  ${chalk.cyan(s.shortId)}  ${s.name}  ${priorityColor(s.priority)}${tags}`);
+    let lastStatusIcon = chalk.dim("\u2014");
+    let passRateStr = chalk.dim("\u2014");
+    if (s.id) {
+      const stats = getScenarioRunStats(s.id);
+      if (stats.lastStatus === "passed")
+        lastStatusIcon = chalk.green("\u2713");
+      else if (stats.lastStatus === "failed")
+        lastStatusIcon = chalk.red("\u2717");
+      else if (stats.lastStatus === "error")
+        lastStatusIcon = chalk.yellow("!");
+      else if (stats.lastStatus === "skipped")
+        lastStatusIcon = chalk.dim("~");
+      passRateStr = stats.passRate === "\u2014" ? chalk.dim("\u2014") : chalk.dim(stats.passRate);
+    }
+    lines.push(`  ${chalk.cyan(s.shortId)}  ${s.name}  ${priorityColor(s.priority)}${tags}  ${lastStatusIcon} ${passRateStr}`);
   }
   lines.push("");
   return lines.join(`
@@ -5251,26 +5483,146 @@ function detectFramework(dir) {
   return null;
 }
 function getStarterScenarios(framework, projectId) {
+  if (framework.name === "Next.js") {
+    const scenarios2 = [
+      {
+        name: "Homepage loads",
+        description: "Navigate to the homepage and verify it loads correctly. Check that the main heading and content are visible, and there are no console errors.",
+        tags: ["smoke"],
+        priority: "high",
+        projectId
+      },
+      {
+        name: "404 page works",
+        description: "Navigate to a non-existent URL (e.g. /this-page-does-not-exist) and verify the Next.js 404 page renders correctly.",
+        tags: ["smoke"],
+        priority: "medium",
+        projectId
+      },
+      {
+        name: "Navigation links work",
+        description: "Click through the main navigation links and verify each page loads without errors. Check that client-side routing is working correctly.",
+        tags: ["smoke"],
+        priority: "medium",
+        projectId
+      }
+    ];
+    if (framework.features.includes("hasAuth")) {
+      scenarios2.push({
+        name: "Login flow",
+        description: "Navigate to the login page, enter valid credentials, and verify successful authentication and redirect.",
+        tags: ["auth"],
+        priority: "critical",
+        projectId
+      }, {
+        name: "Protected route redirect",
+        description: "Try to access a protected route without authentication and verify you are redirected to the login page.",
+        tags: ["auth"],
+        priority: "high",
+        projectId
+      });
+    }
+    if (framework.features.includes("hasForms")) {
+      scenarios2.push({
+        name: "Form validation",
+        description: "Submit forms with empty/invalid data and verify validation errors appear correctly.",
+        tags: ["forms"],
+        priority: "medium",
+        projectId
+      });
+    }
+    return scenarios2;
+  }
+  if (framework.name === "Vite" || framework.name === "SvelteKit") {
+    const scenarios2 = [
+      {
+        name: "Homepage loads",
+        description: "Navigate to the homepage and verify it loads correctly with no console errors.",
+        tags: ["smoke"],
+        priority: "high",
+        projectId
+      },
+      {
+        name: "Mobile viewport check",
+        description: "Set the viewport to 375x812 (iPhone) and verify the homepage renders correctly without horizontal scrolling or layout issues.",
+        tags: ["responsive"],
+        priority: "medium",
+        projectId
+      },
+      {
+        name: "No console errors",
+        description: "Navigate through the app and verify there are no JavaScript errors or warnings in the browser console.",
+        tags: ["smoke"],
+        priority: "high",
+        projectId
+      }
+    ];
+    if (framework.features.includes("hasAuth")) {
+      scenarios2.push({
+        name: "Login flow",
+        description: "Navigate to the login page, enter valid credentials, and verify successful authentication.",
+        tags: ["auth"],
+        priority: "critical",
+        projectId
+      });
+    }
+    return scenarios2;
+  }
+  if (framework.name === "Nuxt") {
+    const scenarios2 = [
+      {
+        name: "Homepage loads",
+        description: "Navigate to the homepage and verify it loads correctly. Check that the main heading and content are visible.",
+        tags: ["smoke"],
+        priority: "high",
+        projectId
+      },
+      {
+        name: "Navigation works",
+        description: "Click through main navigation links and verify each page loads without errors.",
+        tags: ["smoke"],
+        priority: "medium",
+        projectId
+      },
+      {
+        name: "Mobile viewport check",
+        description: "Set the viewport to 375x812 and verify the homepage renders correctly on mobile.",
+        tags: ["responsive"],
+        priority: "medium",
+        projectId
+      }
+    ];
+    if (framework.features.includes("hasAuth")) {
+      scenarios2.push({
+        name: "Login flow",
+        description: "Navigate to the login page, enter valid credentials, and verify successful authentication.",
+        tags: ["auth"],
+        priority: "critical",
+        projectId
+      });
+    }
+    return scenarios2;
+  }
   const scenarios = [
     {
-      name: "Landing page loads",
-      description: "Navigate to the landing page and verify it loads correctly with no console errors. Check that the main heading, navigation, and primary CTA are visible.",
+      name: "Homepage loads",
+      description: "Navigate to the homepage and verify it loads correctly with no console errors. Check that the main heading, navigation, and primary CTA are visible.",
       tags: ["smoke"],
       priority: "high",
       projectId
     },
     {
-      name: "Navigation works",
-      description: "Click through main navigation links and verify each page loads without errors.",
+      name: "Form submit works",
+      description: "Find the main form on the page, fill it in with valid test data, submit it, and verify the success state.",
       tags: ["smoke"],
       priority: "medium",
       projectId
     },
     {
-      name: "No console errors",
-      description: "Navigate through the main pages and check the browser console for any JavaScript errors or warnings.",
-      tags: ["smoke"],
-      priority: "high",
+      name: "Mobile viewport check",
+      description: "Set the viewport to 375x812 (iPhone) and verify the homepage renders correctly without horizontal scrolling or layout issues.",
+      tags: ["responsive"],
+      priority: "medium",
       projectId
     }
   ];
@@ -6051,6 +6403,15 @@ function getPeriodDays(period) {
       return 30;
   }
 }
+function loadBudgetConfig() {
+  const config = loadConfig();
+  const budget = config.budget;
+  return {
+    maxPerRunCents: budget?.maxPerRunCents ?? 50,
+    maxPerDayCents: budget?.maxPerDayCents ?? 500,
+    warnAtPercent: budget?.warnAtPercent ?? 0.8
+  };
+}
 function getCostSummary(options) {
   const db2 = getDatabase();
   const period = options?.period ?? "month";
@@ -6118,6 +6479,77 @@ function getCostSummary(options) {
     estimatedMonthlyCents
   };
 }
+function getCostsByScenario(options) {
+  const db2 = getDatabase();
+  const period = options?.period ?? "month";
+  const projectId = options?.projectId;
+  const dateFilter = getDateFilter(period);
+  const projectFilter = projectId ? "AND ru.project_id = ?" : "";
+  const projectParams = projectId ? [projectId] : [];
+  const rows = db2.query(`SELECT
+        r.scenario_id,
+        COALESCE(s.name, r.scenario_id) as name,
+        COUNT(DISTINCT r.run_id) as run_count,
+        COALESCE(SUM(r.cost_cents), 0) as total_cost_cents
+      FROM results r
+      JOIN runs ru ON r.run_id = ru.id
+      LEFT JOIN scenarios s ON r.scenario_id = s.id
+      WHERE 1=1 ${dateFilter} ${projectFilter}
+      GROUP BY r.scenario_id
+      ORDER BY total_cost_cents DESC`).all(...projectParams);
+  return rows.map((row) => ({
+    scenarioId: row.scenario_id,
+    name: row.name,
+    runCount: row.run_count,
+    totalCostCents: row.total_cost_cents,
+    avgCostPerRunCents: row.run_count > 0 ? row.total_cost_cents / row.run_count : 0
+  }));
+}
+function formatCostsByScenarioTerminal(rows, period) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk4.bold(`  Cost by Scenario (${period})`));
+  lines.push("");
+  if (rows.length === 0) {
+    lines.push(chalk4.dim("  No cost data found."));
+    lines.push("");
+    return lines.join(`
+`);
+  }
+  lines.push(`  ${"Scenario".padEnd(40)} ${"Runs".padEnd(8)} ${"Total Cost".padEnd(14)} Avg/Run`);
+  lines.push(`  ${"\u2500".repeat(40)} ${"\u2500".repeat(8)} ${"\u2500".repeat(14)} ${"\u2500".repeat(10)}`);
+  for (const row of rows) {
+    const label = row.name.length > 38 ? row.name.slice(0, 35) + "..." : row.name;
+    lines.push(`  ${label.padEnd(40)} ${String(row.runCount).padEnd(8)} ${formatDollars(row.totalCostCents).padEnd(14)} ${formatDollars(row.avgCostPerRunCents)}`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function checkBudget(estimatedCostCents) {
+  const budget = loadBudgetConfig();
+  if (estimatedCostCents > budget.maxPerRunCents) {
+    return {
+      allowed: false,
+      warning: `Estimated cost (${formatDollars(estimatedCostCents)}) exceeds per-run limit (${formatDollars(budget.maxPerRunCents)})`
+    };
+  }
+  const todaySummary = getCostSummary({ period: "day" });
+  const projectedDaily = todaySummary.totalCostCents + estimatedCostCents;
+  if (projectedDaily > budget.maxPerDayCents) {
+    return {
+      allowed: false,
+      warning: `Daily spending (${formatDollars(todaySummary.totalCostCents)}) + this run (${formatDollars(estimatedCostCents)}) would exceed daily limit (${formatDollars(budget.maxPerDayCents)})`
+    };
+  }
+  if (projectedDaily > budget.maxPerDayCents * budget.warnAtPercent) {
+    return {
+      allowed: true,
+      warning: `Approaching daily limit: ${formatDollars(projectedDaily)} of ${formatDollars(budget.maxPerDayCents)} (${Math.round(projectedDaily / budget.maxPerDayCents * 100)}%)`
+    };
+  }
+  return { allowed: true };
+}
 function formatDollars(cents) {
   return `$${(cents / 100).toFixed(2)}`;
 }
@@ -6148,12 +6580,13 @@ function formatCostsTerminal(summary) {
   }
   if (summary.byScenario.length > 0) {
     lines.push("");
-    lines.push(chalk4.bold("  Top Scenarios by Cost"));
-    lines.push(`  ${"Scenario".padEnd(40)} ${"Cost".padEnd(12)} ${"Tokens".padEnd(12)} Runs`);
-    lines.push(`  ${"\u2500".repeat(40)} ${"\u2500".repeat(12)} ${"\u2500".repeat(12)} ${"\u2500".repeat(6)}`);
+    lines.push(chalk4.bold("  Scenarios by Cost (most expensive first)"));
+    lines.push(`  ${"Scenario".padEnd(40)} ${"Total Cost".padEnd(12)} ${"Avg/Run".padEnd(12)} ${"Runs".padEnd(6)} Tokens`);
+    lines.push(`  ${"\u2500".repeat(40)} ${"\u2500".repeat(12)} ${"\u2500".repeat(12)} ${"\u2500".repeat(6)} ${"\u2500".repeat(10)}`);
     for (const s of summary.byScenario) {
       const label = s.name.length > 38 ? s.name.slice(0, 35) + "..." : s.name;
-      lines.push(`  ${label.padEnd(40)} ${formatDollars(s.costCents).padEnd(12)} ${formatTokens(s.tokens).padEnd(12)} ${s.runs}`);
+      const avgPerRun = s.runs > 0 ? s.costCents / s.runs : 0;
+      lines.push(`  ${label.padEnd(40)} ${formatDollars(s.costCents).padEnd(12)} ${formatDollars(avgPerRun).padEnd(12)} ${String(s.runs).padEnd(6)} ${formatTokens(s.tokens)}`);
     }
   }
   lines.push("");
@@ -6163,6 +6596,17 @@ function formatCostsTerminal(summary) {
 function formatCostsJSON(summary) {
   return JSON.stringify(summary, null, 2);
 }
+function formatCostsCsv(summary) {
+  const lines = [];
+  lines.push("scenario,runs,total_cost_cents,avg_cost_cents,tokens");
+  for (const s of summary.byScenario) {
+    const avgCostCents = s.runs > 0 ? s.costCents / s.runs : 0;
+    const name = s.name.includes(",") ? `"${s.name.replace(/"/g, '""')}"` : s.name;
+    lines.push(`${name},${s.runs},${s.costCents},${avgCostCents.toFixed(2)},${s.tokens}`);
+  }
+  return lines.join(`
+`);
+}
 
 // src/db/schedules.ts
 init_database();
@@ -6505,6 +6949,241 @@ function parseAssertionString(str) {
 
 // src/cli/index.tsx
 import { existsSync as existsSync8, mkdirSync as mkdirSync4 } from "fs";
+import { jsxDEV } from "react/jsx-dev-runtime";
+var PRIORITIES = ["low", "medium", "high", "critical"];
+function AddForm({ onComplete }) {
+  const { exit } = useApp();
+  const [state, setState] = useState({
+    name: "",
+    url: "",
+    description: "",
+    priority: "medium",
+    tags: "",
+    field: "name",
+    buffer: ""
+  });
+  useInput((input, key) => {
+    if (key.escape) {
+      onComplete(null);
+      exit();
+      return;
+    }
+    if (key.return) {
+      if (state.field === "name") {
+        const val = state.buffer.trim();
+        if (!val)
+          return;
+        setState((s) => ({ ...s, name: val, buffer: "", field: "url" }));
+      } else if (state.field === "url") {
+        setState((s) => ({ ...s, url: s.buffer.trim(), buffer: "", field: "description" }));
+      } else if (state.field === "description") {
+        setState((s) => ({ ...s, description: s.buffer.trim(), buffer: "", field: "priority" }));
+      } else if (state.field === "priority") {
+        setState((s) => ({ ...s, buffer: "", field: "tags" }));
+      } else if (state.field === "tags") {
+        setState((s) => ({ ...s, tags: s.buffer.trim(), buffer: "", field: "confirm" }));
+      } else if (state.field === "confirm") {
+        onComplete(state);
+        exit();
+      }
+      return;
+    }
+    if (key.backspace || key.delete) {
+      if (state.field === "priority")
+        return;
+      setState((s) => ({ ...s, buffer: s.buffer.slice(0, -1) }));
+      return;
+    }
+    if (state.field === "priority") {
+      if (key.leftArrow || key.rightArrow) {
+        const idx = PRIORITIES.indexOf(state.priority);
+        const next = key.rightArrow ? PRIORITIES[(idx + 1) % PRIORITIES.length] : PRIORITIES[(idx - 1 + PRIORITIES.length) % PRIORITIES.length];
+        setState((s) => ({ ...s, priority: next }));
+      }
+      return;
+    }
+    if (!key.ctrl && !key.meta && input) {
+      setState((s) => ({ ...s, buffer: s.buffer + input }));
+    }
+  });
+  const fieldLabel = (label, field, value, hint) => {
+    const active = state.field === field;
+    const displayValue = active ? state.buffer + (active ? "\u2588" : "") : value;
+    return /* @__PURE__ */ jsxDEV(Box, {
+      flexDirection: "row",
+      gap: 1,
+      children: [
+        /* @__PURE__ */ jsxDEV(Text, {
+          color: active ? "cyan" : "gray",
+          children: active ? "\u2192" : " "
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(Text, {
+          color: active ? "white" : "gray",
+          bold: active,
+          children: [
+            label,
+            ":"
+          ]
+        }, undefined, true, undefined, this),
+        /* @__PURE__ */ jsxDEV(Text, {
+          color: active ? "white" : "gray",
+          children: displayValue || (hint ? hint : "")
+        }, undefined, false, undefined, this),
+        !displayValue && hint && /* @__PURE__ */ jsxDEV(Text, {
+          color: "gray",
+          children: " "
+        }, undefined, false, undefined, this)
+      ]
+    }, field, true, undefined, this);
+  };
+  return /* @__PURE__ */ jsxDEV(Box, {
+    flexDirection: "column",
+    gap: 0,
+    paddingY: 1,
+    children: [
+      /* @__PURE__ */ jsxDEV(Text, {
+        bold: true,
+        color: "cyan",
+        children: " New Test Scenario"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Text, {
+        color: "gray",
+        children: " \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+      }, undefined, false, undefined, this),
+      fieldLabel("  Name       ", "name", state.name),
+      fieldLabel("  URL        ", "url", state.url, "(optional)"),
+      fieldLabel("  Description", "description", state.description, "(optional)"),
+      /* @__PURE__ */ jsxDEV(Box, {
+        flexDirection: "row",
+        gap: 1,
+        children: [
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: state.field === "priority" ? "cyan" : "gray",
+            children: state.field === "priority" ? "\u2192" : " "
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: state.field === "priority" ? "white" : "gray",
+            bold: state.field === "priority",
+            children: "  Priority   :"
+          }, undefined, false, undefined, this),
+          PRIORITIES.map((p) => /* @__PURE__ */ jsxDEV(Text, {
+            color: p === state.priority ? "cyan" : "gray",
+            bold: p === state.priority,
+            children: p === state.priority ? `[${p}]` : ` ${p} `
+          }, p, false, undefined, this)),
+          state.field === "priority" && /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: " \u2190 \u2192"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      fieldLabel("  Tags       ", "tags", state.tags, "comma-separated, optional"),
+      state.field === "confirm" && /* @__PURE__ */ jsxDEV(Box, {
+        flexDirection: "column",
+        marginTop: 1,
+        children: [
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: " \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            bold: true,
+            color: "white",
+            children: " Preview:"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: [
+              "   name:        ",
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: "white",
+                children: state.name
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          state.url && /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: [
+              "   url:         ",
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: "white",
+                children: state.url
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          state.description && /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: [
+              "   description: ",
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: "white",
+                children: state.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: [
+              "   priority:    ",
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: "cyan",
+                children: state.priority
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          state.tags && /* @__PURE__ */ jsxDEV(Text, {
+            color: "gray",
+            children: [
+              "   tags:        ",
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: "white",
+                children: state.tags
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            children: " "
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: "green",
+            children: " Press Enter to save, Escape to cancel"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      state.field !== "confirm" && /* @__PURE__ */ jsxDEV(Text, {
+        color: "gray",
+        dimColor: true,
+        children: " Tab/Enter to advance \xB7 Escape to cancel"
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+async function runInteractiveAdd(projectId) {
+  let savedResult = null;
+  const { waitUntilExit } = render(React.createElement(AddForm, {
+    onComplete: (data) => {
+      savedResult = data;
+    }
+  }));
+  await waitUntilExit();
+  if (savedResult) {
+    const result = savedResult;
+    const tags = result.tags ? result.tags.split(",").map((t) => t.trim()).filter(Boolean) : [];
+    const scenario = createScenario({
+      name: result.name,
+      description: result.description || result.name,
+      steps: [],
+      tags,
+      priority: result.priority,
+      projectId
+    });
+    log(chalk5.green(`
+Created scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
+  } else {
+    log(chalk5.dim(`
+Cancelled.`));
+  }
+}
 function formatToolInput(input) {
   const parts = [];
   for (const [key, value] of Object.entries(input)) {
@@ -6515,7 +7194,19 @@ function formatToolInput(input) {
   return parts.join(" ");
 }
 var program2 = new Command;
-program2.name("testers").version("0.0.4").description("AI-powered browser testing CLI");
+var QUIET = false;
+var NO_COLOR = false;
+function log(...args) {
+  if (QUIET)
+    return;
+  console.log(...args);
+}
+function logError(...args) {
+  if (QUIET)
+    return;
+  console.error(...args);
+}
+program2.name("testers").version(package_default.version).description("AI-powered browser testing CLI").option("-q, --quiet", "Suppress all output", false).option("--no-color", "Disable color output");
 var CONFIG_DIR2 = join6(process.env["HOME"] ?? "~", ".testers");
 var CONFIG_PATH2 = join6(CONFIG_DIR2, "config.json");
 function getActiveProject() {
@@ -6530,7 +7221,7 @@ function getActiveProject() {
 function resolveProject(optProject) {
   return optProject ?? getActiveProject();
 }
-program2.command("add <name>").description("Create a new test scenario").option("-d, --description <text>", "Scenario description", "").option("-s, --steps <step>", "Test step (repeatable)", (val, acc) => {
+program2.command("add [name]").alias("create").description("Create a new test scenario (interactive if no name/flags given)").option("-d, --description <text>", "Scenario description", "").option("-s, --steps <step>", "Test step (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
 }, []).option("-t, --tag <tag>", "Tag (repeatable)", (val, acc) => {
@@ -6539,18 +7230,28 @@ program2.command("add <name>").description("Create a new test scenario").option(
 }, []).option("-p, --priority <level>", "Priority level", "medium").option("-m, --model <model>", "AI model to use").option("--path <path>", "Target path on the URL").option("--auth", "Requires authentication", false).option("--timeout <ms>", "Timeout in milliseconds").option("--project <id>", "Project ID").option("--template <name>", "Seed scenarios from a template (auth, crud, forms, nav, a11y)").option("--assert <assertion>", "Structured assertion (repeatable). Formats: selector:<sel> visible, text:<sel> contains:<text>, no-console-errors, url:contains:<path>, title:contains:<text>, count:<sel> eq:<n>", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).action((name, opts) => {
+}, []).action(async (name, opts) => {
   try {
+    const hasFlags = opts.description || opts.steps?.length || opts.tag?.length || opts.model || opts.path || opts.auth || opts.timeout || opts.template || opts.assert?.length;
+    if (!name && !hasFlags) {
+      const projectId2 = resolveProject(opts.project);
+      await runInteractiveAdd(projectId2);
+      return;
+    }
+    if (!name) {
+      logError(chalk5.red("Error: scenario name is required"));
+      process.exit(1);
+    }
     if (opts.template) {
       const template = getTemplate(opts.template);
       if (!template) {
-        console.error(chalk5.red(`Unknown template: ${opts.template}. Available: ${listTemplateNames().join(", ")}`));
+        logError(chalk5.red(`Unknown template: ${opts.template}. Available: ${listTemplateNames().join(", ")}`));
         process.exit(1);
       }
       const projectId2 = resolveProject(opts.project);
       for (const input of template) {
         const s = createScenario({ ...input, projectId: projectId2 });
-        console.log(chalk5.green(`  Created ${s.shortId}: ${s.name}`));
+        log(chalk5.green(`  Created ${s.shortId}: ${s.name}`));
       }
       return;
     }
@@ -6569,117 +7270,169 @@ program2.command("add <name>").description("Create a new test scenario").option(
       assertions: assertions.length > 0 ? assertions : undefined,
       projectId
     });
-    console.log(chalk5.green(`Created scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
+    log(chalk5.green(`Created scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("list").description("List test scenarios").option("-t, --tag <tag>", "Filter by tag").option("-p, --priority <level>", "Filter by priority").option("--project <id>", "Filter by project ID").option("-l, --limit <n>", "Limit results", "50").action((opts) => {
+program2.command("list").alias("ls").description("List test scenarios").option("-t, --tag <tag>", "Filter by tag").option("-p, --priority <level>", "Filter by priority").option("--project <id>", "Filter by project ID").option("--search <text>", "Filter by name or description (case-insensitive substring match)").option("--sort <field>", "Sort field: date, priority, name (default: date)").option("--asc", "Sort ascending instead of descending", false).option("-l, --limit <n>", "Limit results", "50").option("--offset <n>", "Skip first N results", "0").option("--json", "Output as JSON", false).action((opts) => {
   try {
     const scenarios = listScenarios({
       tags: opts.tag ? [opts.tag] : undefined,
       priority: opts.priority,
       projectId: opts.project,
-      limit: parseInt(opts.limit, 10)
+      search: opts.search,
+      sort: opts.sort,
+      desc: !opts.asc,
+      limit: parseInt(opts.limit, 10),
+      offset: parseInt(opts.offset, 10) || undefined
     });
-    console.log(formatScenarioList(scenarios));
+    if (opts.json) {
+      log(JSON.stringify(scenarios, null, 2));
+    } else {
+      log(formatScenarioList(scenarios));
+    }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("show <id>").description("Show scenario details").action((id) => {
+program2.command("show <id>").description("Show scenario details").option("--json", "Output as JSON", false).action((id, opts) => {
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${id}`));
+      logError(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
-    console.log("");
-    console.log(chalk5.bold(`  Scenario ${scenario.shortId}`));
-    console.log(`  Name:        ${scenario.name}`);
-    console.log(`  ID:          ${chalk5.dim(scenario.id)}`);
-    console.log(`  Description: ${scenario.description}`);
-    console.log(`  Priority:    ${scenario.priority}`);
-    console.log(`  Model:       ${scenario.model ?? chalk5.dim("default")}`);
-    console.log(`  Tags:        ${scenario.tags.length > 0 ? scenario.tags.join(", ") : chalk5.dim("none")}`);
-    console.log(`  Path:        ${scenario.targetPath ?? chalk5.dim("none")}`);
-    console.log(`  Auth:        ${scenario.requiresAuth ? "yes" : "no"}`);
-    console.log(`  Timeout:     ${scenario.timeoutMs ? `${scenario.timeoutMs}ms` : chalk5.dim("default")}`);
-    console.log(`  Version:     ${scenario.version}`);
-    console.log(`  Created:     ${scenario.createdAt}`);
-    console.log(`  Updated:     ${scenario.updatedAt}`);
+    if (opts.json) {
+      log(JSON.stringify(scenario, null, 2));
+      return;
+    }
+    log("");
+    log(chalk5.bold(`  Scenario ${scenario.shortId}`));
+    log(`  Name:        ${scenario.name}`);
+    log(`  ID:          ${chalk5.dim(scenario.id)}`);
+    log(`  Description: ${scenario.description}`);
+    log(`  Priority:    ${scenario.priority}`);
+    log(`  Model:       ${scenario.model ?? chalk5.dim("default")}`);
+    log(`  Tags:        ${scenario.tags.length > 0 ? scenario.tags.join(", ") : chalk5.dim("none")}`);
+    log(`  Path:        ${scenario.targetPath ?? chalk5.dim("none")}`);
+    log(`  Auth:        ${scenario.requiresAuth ? "yes" : "no"}`);
+    log(`  Timeout:     ${scenario.timeoutMs ? `${scenario.timeoutMs}ms` : chalk5.dim("default")}`);
+    log(`  Version:     ${scenario.version}`);
+    log(`  Created:     ${scenario.createdAt}`);
+    log(`  Updated:     ${scenario.updatedAt}`);
     if (scenario.steps.length > 0) {
-      console.log("");
-      console.log(chalk5.bold("  Steps:"));
+      log("");
+      log(chalk5.bold("  Steps:"));
       for (let i = 0;i < scenario.steps.length; i++) {
-        console.log(`    ${i + 1}. ${scenario.steps[i]}`);
+        log(`    ${i + 1}. ${scenario.steps[i]}`);
       }
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("update <id>").description("Update a scenario").option("-n, --name <name>", "New name").option("-d, --description <text>", "New description").option("-s, --steps <step>", "Replace steps (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("-t, --tag <tag>", "Replace tags (repeatable)", (val, acc) => {
+}, []).option("-t, --tag <tag>", "Replace all tags (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--tag-add <tag>", "Add a tag to existing tags (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--tag-remove <tag>", "Remove a tag from existing tags (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
 }, []).option("-p, --priority <level>", "New priority").option("-m, --model <model>", "New model").action((id, opts) => {
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${id}`));
+      logError(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
+    let newTags;
+    if (opts.tag.length > 0) {
+      newTags = opts.tag;
+    } else if (opts.tagAdd.length > 0 || opts.tagRemove.length > 0) {
+      const existing = new Set(scenario.tags);
+      for (const t of opts.tagAdd)
+        existing.add(t);
+      for (const t of opts.tagRemove)
+        existing.delete(t);
+      newTags = [...existing];
+    }
     const updated = updateScenario(scenario.id, {
       name: opts.name,
       description: opts.description,
       steps: opts.steps.length > 0 ? opts.steps : undefined,
-      tags: opts.tag.length > 0 ? opts.tag : undefined,
+      tags: newTags,
       priority: opts.priority,
       model: opts.model
     }, scenario.version);
-    console.log(chalk5.green(`Updated scenario ${chalk5.bold(updated.shortId)}: ${updated.name}`));
+    log(chalk5.green(`Updated scenario ${chalk5.bold(updated.shortId)}: ${updated.name}`));
+    if (newTags !== undefined) {
+      log(chalk5.dim(`  Tags: [${updated.tags.join(", ")}]`));
+    }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("delete <id>").description("Delete a scenario").action((id) => {
+program2.command("delete <id>").description("Delete a scenario").option("-y, --yes", "Skip confirmation prompt", false).action(async (id, opts) => {
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${id}`));
+      logError(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
+    if (!opts.yes) {
+      process.stdout.write(chalk5.yellow(`Delete scenario ${scenario.shortId} "${scenario.name}"? [y/N] `));
+      const answer = await new Promise((resolve2) => {
+        let buf = "";
+        process.stdin.setRawMode?.(true);
+        process.stdin.resume();
+        process.stdin.once("data", (chunk) => {
+          buf = chunk.toString().trim().toLowerCase();
+          process.stdin.setRawMode?.(false);
+          process.stdin.pause();
+          process.stdout.write(`
+`);
+          resolve2(buf);
+        });
+      });
+      if (answer !== "y" && answer !== "yes") {
+        log(chalk5.dim("Cancelled."));
+        return;
+      }
+    }
     const deleted = deleteScenario(scenario.id);
     if (deleted) {
-      console.log(chalk5.green(`Deleted scenario ${scenario.shortId}: ${scenario.name}`));
+      log(chalk5.green(`Deleted scenario ${scenario.shortId}: ${scenario.name}`));
     } else {
-      console.error(chalk5.red(`Failed to delete scenario: ${id}`));
+      logError(chalk5.red(`Failed to delete scenario: ${id}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("run [url] [description]").description("Run test scenarios against a URL").option("-t, --tag <tag>", "Filter by tag (repeatable)", (val, acc) => {
+program2.command("run [url] [description]").alias("test").description("Run test scenarios against a URL").option("-t, --tag <tag>", "Filter by tag (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--browser <engine>", "Browser engine: playwright or lightpanda", "playwright").option("--env <name>", "Use a named environment for the URL").action(async (urlArg, description, opts) => {
+}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--browser <engine>", "Browser engine: playwright or lightpanda", "playwright").option("--env <name>", "Use a named environment for the URL").option("--dry-run", "Print what would run without launching browser", false).option("--retry <n>", "Retry failed scenarios up to n times", "0").option("--verbose", "Show per-step timing and full tool results", false).option("--watch-results", "When used with --background, poll and display live results table until run completes", false).option("--failed-only", "Only show failed/error scenarios in output (passed count shown as summary)", false).action(async (urlArg, description, opts) => {
   try {
     const projectId = resolveProject(opts.project);
     let url = urlArg;
     if (!url && opts.env) {
       const env = getEnvironment(opts.env);
       if (!env) {
-        console.error(chalk5.red(`Environment not found: ${opts.env}`));
+        logError(chalk5.red(`Environment not found: ${opts.env}`));
         process.exit(1);
       }
       url = env.url;
@@ -6688,16 +7441,76 @@ program2.command("run [url] [description]").description("Run test scenarios agai
       const defaultEnv = getDefaultEnvironment();
       if (defaultEnv) {
         url = defaultEnv.url;
-        console.log(chalk5.dim(`Using default environment: ${defaultEnv.name} (${defaultEnv.url})`));
+        log(chalk5.dim(`Using default environment: ${defaultEnv.name} (${defaultEnv.url})`));
       }
     }
     if (!url) {
-      console.error(chalk5.red("No URL provided. Pass a URL argument, use --env <name>, or set a default environment with 'testers env use <name>'."));
+      logError(chalk5.red("No URL provided. Pass a URL argument, use --env <name>, or set a default environment with 'testers env use <name>'."));
       process.exit(1);
     }
+    if (!opts.dryRun && !opts.background) {
+      const budgetResult = checkBudget(0);
+      if (budgetResult.warning) {
+        log(chalk5.yellow(`  \u26A0\uFE0F  Budget warning: ${budgetResult.warning}`));
+        if (!budgetResult.allowed) {
+          if (!opts.yes) {
+            log(chalk5.yellow("  Use --yes to run anyway, or check your budget config."));
+            process.exit(1);
+          }
+          log(chalk5.yellow("  --yes passed, proceeding despite budget limit."));
+        }
+      }
+    }
     if (opts.fromTodos) {
       const result = importFromTodos({ projectId });
-      console.log(chalk5.blue(`Imported ${result.imported} scenarios from todos (${result.skipped} skipped)`));
+      log(chalk5.blue(`Imported ${result.imported} scenarios from todos (${result.skipped} skipped)`));
+    }
+    if (opts.dryRun) {
+      const dryScenarios = listScenarios({
+        tags: opts.tag.length > 0 ? opts.tag : undefined,
+        projectId
+      }).filter((s) => {
+        if (opts.scenario && s.id !== opts.scenario && s.shortId !== opts.scenario)
+          return false;
+        if (opts.priority && s.priority !== opts.priority)
+          return false;
+        return true;
+      });
+      log("");
+      log(chalk5.bold("  Dry Run \u2014 scenarios that would execute:"));
+      log("");
+      if (dryScenarios.length === 0) {
+        log(chalk5.yellow("  No matching scenarios found."));
+      } else {
+        for (const s of dryScenarios) {
+          const assertionErrors = [];
+          for (const a of s.assertions ?? []) {
+            try {
+              parseAssertionString(a);
+            } catch {
+              assertionErrors.push(a);
+            }
+          }
+          let authOk = true;
+          if (s.authPreset) {
+            const presets = listAuthPresets();
+            authOk = presets.some((p) => p.name === s.authPreset);
+          }
+          const statusIcon = assertionErrors.length === 0 && authOk ? chalk5.green("\u2713") : chalk5.red("\u2717");
+          log(`  ${statusIcon} ${chalk5.cyan(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
+          if (assertionErrors.length > 0) {
+            log(chalk5.red(`      Invalid assertions: ${assertionErrors.join(", ")}`));
+          }
+          if (!authOk) {
+            log(chalk5.red(`      Auth preset not found: ${s.authPreset}`));
+          }
+        }
+      }
+      log("");
+      log(chalk5.dim(`  URL: ${url}`));
+      log(chalk5.dim(`  Total: ${dryScenarios.length} scenarios`));
+      log("");
+      process.exit(0);
     }
     if (opts.background) {
       if (description) {
@@ -6715,52 +7528,106 @@ program2.command("run [url] [description]").description("Run test scenarios agai
         projectId,
         engine: opts.browser
       });
-      console.log(chalk5.green(`Run started in background: ${chalk5.bold(runId.slice(0, 8))}`));
-      console.log(chalk5.dim(`  Scenarios: ${scenarioCount}`));
-      console.log(chalk5.dim(`  URL: ${url}`));
-      console.log(chalk5.dim(`  Check progress: testers results ${runId.slice(0, 8)}`));
+      log(chalk5.green(`Run started in background: ${chalk5.bold(runId.slice(0, 8))}`));
+      log(chalk5.dim(`  Scenarios: ${scenarioCount}`));
+      log(chalk5.dim(`  URL: ${url}`));
+      if (opts.watchResults) {
+        log(chalk5.dim(`  Watching results (polling every 3s)...`));
+        log("");
+        const POLL_INTERVAL = 3000;
+        const DONE_STATUSES = new Set(["passed", "failed", "cancelled"]);
+        const renderTable = () => {
+          const run2 = getRun(runId);
+          if (!run2)
+            return;
+          const results2 = getResultsByRun(runId);
+          const statusIcon = run2.status === "passed" ? chalk5.green("PASS") : run2.status === "failed" ? chalk5.red("FAIL") : chalk5.blue("RUN ");
+          process.stdout.write(`\r  ${statusIcon}  ${run2.passed} passed  ${run2.failed} failed  ${run2.total - run2.passed - run2.failed} running  (${results2.length}/${run2.total})
+`);
+          for (const r of results2) {
+            const scenario = getScenario(r.scenarioId);
+            const name = scenario ? scenario.name : r.scenarioId.slice(0, 8);
+            const icon = r.status === "passed" ? chalk5.green("\u2713") : r.status === "failed" ? chalk5.red("\u2717") : r.status === "error" ? chalk5.yellow("!") : chalk5.blue("\u2026");
+            const dur = r.durationMs > 0 ? chalk5.dim(` ${(r.durationMs / 1000).toFixed(1)}s`) : "";
+            process.stdout.write(`    ${icon} ${name}${dur}
+`);
+          }
+        };
+        await new Promise((resolve2) => {
+          const poll = setInterval(() => {
+            const run2 = getRun(runId);
+            if (!run2)
+              return;
+            renderTable();
+            if (DONE_STATUSES.has(run2.status)) {
+              clearInterval(poll);
+              resolve2();
+            }
+          }, POLL_INTERVAL);
+        });
+        const finalRun = getRun(runId);
+        if (finalRun) {
+          log("");
+          const results2 = getResultsByRun(runId);
+          log(formatTerminal(finalRun, results2));
+        }
+        process.exit(finalRun ? getExitCode(finalRun) : 0);
+      }
+      log(chalk5.dim(`  Check progress: testers results ${runId.slice(0, 8)}`));
       process.exit(0);
     }
     if (!opts.json && !opts.output) {
+      const verbose = !!opts.verbose;
       onRunEvent((event) => {
         switch (event.type) {
           case "scenario:start":
-            console.log(chalk5.blue(`  [start] ${event.scenarioName ?? event.scenarioId}`));
+            if (event.retryAttempt) {
+              log(chalk5.yellow(`  [retry] Retrying scenario ${event.scenarioName ?? event.scenarioId} (attempt ${event.retryAttempt}/${event.maxRetries})...`));
+            } else {
+              log(chalk5.blue(`  [start] ${event.scenarioName ?? event.scenarioId}`));
+            }
+            break;
+          case "scenario:timeout_warning": {
+            const elapsedS = ((event.elapsedMs ?? 0) / 1000).toFixed(0);
+            const totalS = ((event.timeoutMs ?? 0) / 1000).toFixed(0);
+            log(chalk5.yellow(`  \u26A0\uFE0F  Scenario '${event.scenarioName}' at 80% timeout (${elapsedS}s/${totalS}s) \u2014 still running`));
             break;
+          }
           case "step:thinking":
             if (event.thinking) {
               const preview = event.thinking.length > 120 ? event.thinking.slice(0, 120) + "..." : event.thinking;
-              console.log(chalk5.dim(`    [think] ${preview}`));
+              log(chalk5.dim(`    [think] ${preview}`));
             }
             break;
           case "step:tool_call":
-            console.log(chalk5.cyan(`    [step ${event.stepNumber}] ${event.toolName}${event.toolInput ? ` ${formatToolInput(event.toolInput)}` : ""}`));
+            log(chalk5.cyan(`    [step ${event.stepNumber}] ${event.toolName}${event.toolInput ? ` ${formatToolInput(event.toolInput)}` : ""}`));
             break;
           case "step:tool_result":
             if (event.toolName === "report_result") {
-              console.log(chalk5.bold(`    [result] ${event.toolResult}`));
+              log(chalk5.bold(`    [result] ${event.toolResult}`));
             } else {
+              const durationStr = verbose && event.stepDurationMs !== undefined ? chalk5.dim(`[${(event.stepDurationMs / 1000).toFixed(1)}s] `) : "";
               const resultPreview = (event.toolResult ?? "").length > 100 ? (event.toolResult ?? "").slice(0, 100) + "..." : event.toolResult ?? "";
-              console.log(chalk5.dim(`    [done]  ${resultPreview}`));
+              log(chalk5.dim(`    [done]  ${durationStr}${resultPreview}`));
             }
             break;
           case "screenshot:captured":
-            console.log(chalk5.dim(`    [screenshot] ${event.screenshotPath}`));
+            log(chalk5.dim(`    [screenshot] ${event.screenshotPath}`));
             break;
           case "scenario:pass":
-            console.log(chalk5.green(`  [PASS] ${event.scenarioName}`));
+            log(chalk5.green(`  [PASS] ${event.scenarioName}`));
             break;
           case "scenario:fail":
-            console.log(chalk5.red(`  [FAIL] ${event.scenarioName}`));
+            log(chalk5.red(`  [FAIL] ${event.scenarioName}`));
             break;
           case "scenario:error":
-            console.log(chalk5.yellow(`  [ERR]  ${event.scenarioName}: ${event.error}`));
+            log(chalk5.yellow(`  [ERR]  ${event.scenarioName}: ${event.error}`));
             break;
         }
       });
-      console.log("");
-      console.log(chalk5.bold(`  Running tests against ${url}`));
-      console.log("");
+      log("");
+      log(chalk5.bold(`  Running tests against ${url}`));
+      log("");
     }
     if (description) {
       const scenario = createScenario({
@@ -6776,6 +7643,7 @@ program2.command("run [url] [description]").description("Run test scenarios agai
         headed: opts.headed,
         parallel: parseInt(opts.parallel, 10),
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+        retry: parseInt(opts.retry ?? "0", 10),
         projectId,
         engine: opts.browser
       });
@@ -6783,16 +7651,22 @@ program2.command("run [url] [description]").description("Run test scenarios agai
         const jsonOutput = formatJSON(run2, results2);
         if (opts.output) {
           writeFileSync3(opts.output, jsonOutput, "utf-8");
-          console.log(chalk5.green(`Results written to ${opts.output}`));
+          log(chalk5.green(`Results written to ${opts.output}`));
         }
         if (opts.json) {
-          console.log(jsonOutput);
+          log(jsonOutput);
         }
       } else {
-        console.log(formatTerminal(run2, results2));
+        log(formatTerminal(run2, results2, { failedOnly: opts.failedOnly }));
       }
       process.exit(getExitCode(run2));
     }
+    const noFilters = !opts.scenario && opts.tag.length === 0 && !opts.priority;
+    if (noFilters && !opts.json && !opts.output) {
+      const allScenarios = listScenarios({ projectId });
+      log(chalk5.bold(`  Running all ${allScenarios.length} scenarios...`));
+      log("");
+    }
     const { run, results } = await runByFilter({
       url,
       tags: opts.tag.length > 0 ? opts.tag : undefined,
@@ -6802,6 +7676,7 @@ program2.command("run [url] [description]").description("Run test scenarios agai
       headed: opts.headed,
       parallel: parseInt(opts.parallel, 10),
       timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+      retry: parseInt(opts.retry ?? "0", 10),
       projectId,
       engine: opts.browser
     });
@@ -6809,43 +7684,54 @@ program2.command("run [url] [description]").description("Run test scenarios agai
       const jsonOutput = formatJSON(run, results);
       if (opts.output) {
         writeFileSync3(opts.output, jsonOutput, "utf-8");
-        console.log(chalk5.green(`Results written to ${opts.output}`));
+        log(chalk5.green(`Results written to ${opts.output}`));
       }
       if (opts.json) {
-        console.log(jsonOutput);
+        log(jsonOutput);
       }
     } else {
-      console.log(formatTerminal(run, results));
+      log(formatTerminal(run, results, { failedOnly: opts.failedOnly }));
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("runs").description("List past test runs").option("--status <status>", "Filter by status").option("-l, --limit <n>", "Limit results", "20").action((opts) => {
+program2.command("runs").description("List past test runs").option("--status <status>", "Filter by status").option("--sort <field>", "Sort field: date, duration, cost (default: date)").option("--asc", "Sort ascending instead of descending", false).option("-l, --limit <n>", "Limit results", "20").option("--offset <n>", "Skip first N results", "0").option("--json", "Output as JSON", false).action((opts) => {
   try {
     const runs = listRuns({
       status: opts.status,
-      limit: parseInt(opts.limit, 10)
+      sort: opts.sort,
+      desc: !opts.asc,
+      limit: parseInt(opts.limit, 10),
+      offset: parseInt(opts.offset, 10) || undefined
     });
-    console.log(formatRunList(runs));
+    if (opts.json) {
+      log(JSON.stringify(runs, null, 2));
+    } else {
+      log(formatRunList(runs));
+    }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("results <run-id>").description("Show results for a test run").action((runId) => {
+program2.command("results <run-id>").description("Show results for a test run").option("--json", "Output as JSON", false).action((runId, opts) => {
   try {
     const run = getRun(runId);
     if (!run) {
-      console.error(chalk5.red(`Run not found: ${runId}`));
+      logError(chalk5.red(`Run not found: ${runId}`));
       process.exit(1);
     }
     const results = getResultsByRun(run.id);
-    console.log(formatTerminal(run, results));
+    if (opts.json) {
+      log(formatJSON(run, results));
+    } else {
+      log(formatTerminal(run, results));
+    }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6855,43 +7741,43 @@ program2.command("screenshots <id>").description("List screenshots for a run or
     if (run) {
       const results = getResultsByRun(run.id);
       let total = 0;
-      console.log("");
-      console.log(chalk5.bold(`  Screenshots for run ${run.id.slice(0, 8)}`));
-      console.log("");
+      log("");
+      log(chalk5.bold(`  Screenshots for run ${run.id.slice(0, 8)}`));
+      log("");
       for (const result of results) {
         const screenshots2 = listScreenshots(result.id);
         if (screenshots2.length > 0) {
           const scenario = getScenario(result.scenarioId);
           const label = scenario ? `${scenario.shortId}: ${scenario.name}` : result.scenarioId.slice(0, 8);
-          console.log(chalk5.bold(`  ${label}`));
+          log(chalk5.bold(`  ${label}`));
           for (const ss of screenshots2) {
-            console.log(`    ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
+            log(`    ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
             total++;
           }
-          console.log("");
+          log("");
         }
       }
       if (total === 0) {
-        console.log(chalk5.dim("  No screenshots found."));
-        console.log("");
+        log(chalk5.dim("  No screenshots found."));
+        log("");
       }
       return;
     }
     const screenshots = listScreenshots(id);
     if (screenshots.length > 0) {
-      console.log("");
-      console.log(chalk5.bold(`  Screenshots for result ${id.slice(0, 8)}`));
-      console.log("");
+      log("");
+      log(chalk5.bold(`  Screenshots for result ${id.slice(0, 8)}`));
+      log("");
       for (const ss of screenshots) {
-        console.log(`  ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
+        log(`  ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
       }
-      console.log("");
+      log("");
       return;
     }
-    console.error(chalk5.red(`No screenshots found for: ${id}`));
+    logError(chalk5.red(`No screenshots found for: ${id}`));
     process.exit(1);
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6900,7 +7786,7 @@ program2.command("import <dir>").description("Import markdown test files as scen
     const absDir = resolve(dir);
     const files = readdirSync(absDir).filter((f) => f.endsWith(".md"));
     if (files.length === 0) {
-      console.log(chalk5.dim("No .md files found in directory."));
+      log(chalk5.dim("No .md files found in directory."));
       return;
     }
     let imported = 0;
@@ -6930,22 +7816,87 @@ program2.command("import <dir>").description("Import markdown test files as scen
         description: descriptionLines.join(" ") || name,
         steps
       });
-      console.log(chalk5.green(`  Imported ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
+      log(chalk5.green(`  Imported ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
       imported++;
     }
-    console.log("");
-    console.log(chalk5.green(`Imported ${imported} scenario(s) from ${absDir}`));
+    log("");
+    log(chalk5.green(`Imported ${imported} scenario(s) from ${absDir}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program2.command("export [format]").description("Export scenarios as JSON (default) or markdown files").option("-o, --output <path>", "Output file (JSON) or directory (markdown)").option("-t, --tag <tag>", "Filter by tag").option("-p, --priority <level>", "Filter by priority").option("--project <id>", "Filter by project ID").action((format, opts) => {
+  try {
+    const fmt = (format ?? "json").toLowerCase();
+    if (fmt !== "json" && fmt !== "markdown") {
+      logError(chalk5.red(`Unknown format: ${fmt}. Supported: json, markdown`));
+      process.exit(1);
+    }
+    const projectId = resolveProject(opts.project);
+    const scenarios = listScenarios({
+      tags: opts.tag ? [opts.tag] : undefined,
+      priority: opts.priority,
+      projectId
+    });
+    if (scenarios.length === 0) {
+      log(chalk5.dim("No scenarios found to export."));
+      return;
+    }
+    if (fmt === "json") {
+      const outputPath = opts.output ?? "testers-export.json";
+      const data = JSON.stringify(scenarios, null, 2);
+      writeFileSync3(outputPath, data, "utf-8");
+      log(chalk5.green(`Exported ${scenarios.length} scenario(s) to ${resolve(outputPath)}`));
+      return;
+    }
+    const outputDir = opts.output ?? ".";
+    if (!existsSync8(outputDir)) {
+      mkdirSync4(outputDir, { recursive: true });
+    }
+    for (const s of scenarios) {
+      const lines = [];
+      lines.push(`# ${s.name}`);
+      lines.push("");
+      if (s.description && s.description !== s.name) {
+        lines.push(s.description);
+        lines.push("");
+      }
+      if (s.tags.length > 0) {
+        lines.push(`**Tags:** ${s.tags.join(", ")}`);
+      }
+      lines.push(`**Priority:** ${s.priority}`);
+      if (s.targetPath) {
+        lines.push(`**Path:** ${s.targetPath}`);
+      }
+      lines.push("");
+      if (s.steps.length > 0) {
+        lines.push("## Steps");
+        lines.push("");
+        for (const step of s.steps) {
+          lines.push(`- [ ] ${step}`);
+        }
+        lines.push("");
+      }
+      const safeFilename = s.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 80);
+      const filePath = join6(outputDir, `${s.shortId}-${safeFilename}.md`);
+      writeFileSync3(filePath, lines.join(`
+`), "utf-8");
+      log(chalk5.dim(`  ${s.shortId}: ${s.name} \u2192 ${filePath}`));
+    }
+    log(chalk5.green(`
+Exported ${scenarios.length} scenario(s) as markdown to ${resolve(outputDir)}`));
+  } catch (error) {
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("config").description("Show current configuration").action(() => {
   try {
     const config = loadConfig();
-    console.log(JSON.stringify(config, null, 2));
+    log(JSON.stringify(config, null, 2));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6954,33 +7905,33 @@ program2.command("status").description("Show database and auth status").action((
     const config = loadConfig();
     const hasApiKey = !!config.anthropicApiKey || !!process.env["ANTHROPIC_API_KEY"];
     const dbPath = join6(process.env["HOME"] ?? "~", ".testers", "testers.db");
-    console.log("");
-    console.log(chalk5.bold("  Open Testers Status"));
-    console.log("");
-    console.log(`  ANTHROPIC_API_KEY: ${hasApiKey ? chalk5.green("set") : chalk5.red("not set")}`);
-    console.log(`  Database:          ${dbPath}`);
-    console.log(`  Default model:     ${config.defaultModel}`);
-    console.log(`  Screenshots dir:   ${config.screenshots.dir}`);
-    console.log("");
+    log("");
+    log(chalk5.bold("  Open Testers Status"));
+    log("");
+    log(`  ANTHROPIC_API_KEY: ${hasApiKey ? chalk5.green("set") : chalk5.red("not set")}`);
+    log(`  Database:          ${dbPath}`);
+    log(`  Default model:     ${config.defaultModel}`);
+    log(`  Screenshots dir:   ${config.screenshots.dir}`);
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("install-browser").description("Install browser engine").option("--engine <engine>", "Engine to install: playwright, lightpanda, or all", "playwright").action(async (opts) => {
   try {
     if (opts.engine === "all" || opts.engine === "playwright") {
-      console.log(chalk5.blue("Installing Playwright Chromium..."));
+      log(chalk5.blue("Installing Playwright Chromium..."));
       await installBrowser("playwright");
-      console.log(chalk5.green("Playwright Chromium installed."));
+      log(chalk5.green("Playwright Chromium installed."));
     }
     if (opts.engine === "all" || opts.engine === "lightpanda") {
-      console.log(chalk5.blue("Installing Lightpanda..."));
+      log(chalk5.blue("Installing Lightpanda..."));
       await installBrowser("lightpanda");
-      console.log(chalk5.green("Lightpanda installed."));
+      log(chalk5.green("Lightpanda installed."));
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6992,9 +7943,9 @@ projectCmd.command("create <name>").description("Create a new project").option("
       path: opts.path,
       description: opts.description
     });
-    console.log(chalk5.green(`Created project ${chalk5.bold(project.name)} (${project.id})`));
+    log(chalk5.green(`Created project ${chalk5.bold(project.name)} (${project.id})`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7002,20 +7953,20 @@ projectCmd.command("list").description("List all projects").action(() => {
   try {
     const projects = listProjects();
     if (projects.length === 0) {
-      console.log(chalk5.dim("No projects found."));
+      log(chalk5.dim("No projects found."));
       return;
     }
-    console.log("");
-    console.log(chalk5.bold("  Projects"));
-    console.log("");
-    console.log(`  ${"ID".padEnd(38)} ${"Name".padEnd(24)} ${"Path".padEnd(30)} Created`);
-    console.log(`  ${"\u2500".repeat(38)} ${"\u2500".repeat(24)} ${"\u2500".repeat(30)} ${"\u2500".repeat(20)}`);
+    log("");
+    log(chalk5.bold("  Projects"));
+    log("");
+    log(`  ${"ID".padEnd(38)} ${"Name".padEnd(24)} ${"Path".padEnd(30)} Created`);
+    log(`  ${"\u2500".repeat(38)} ${"\u2500".repeat(24)} ${"\u2500".repeat(30)} ${"\u2500".repeat(20)}`);
     for (const p of projects) {
-      console.log(`  ${p.id.padEnd(38)} ${p.name.padEnd(24)} ${(p.path ?? chalk5.dim("\u2014")).toString().padEnd(30)} ${p.createdAt}`);
+      log(`  ${p.id.padEnd(38)} ${p.name.padEnd(24)} ${(p.path ?? chalk5.dim("\u2014")).toString().padEnd(30)} ${p.createdAt}`);
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7023,19 +7974,19 @@ projectCmd.command("show <id>").description("Show project details").action((id)
   try {
     const project = getProject(id);
     if (!project) {
-      console.error(chalk5.red(`Project not found: ${id}`));
+      logError(chalk5.red(`Project not found: ${id}`));
       process.exit(1);
     }
-    console.log("");
-    console.log(chalk5.bold(`  Project: ${project.name}`));
-    console.log(`  ID:          ${project.id}`);
-    console.log(`  Path:        ${project.path ?? chalk5.dim("none")}`);
-    console.log(`  Description: ${project.description ?? chalk5.dim("none")}`);
-    console.log(`  Created:     ${project.createdAt}`);
-    console.log(`  Updated:     ${project.updatedAt}`);
-    console.log("");
+    log("");
+    log(chalk5.bold(`  Project: ${project.name}`));
+    log(`  ID:          ${project.id}`);
+    log(`  Path:        ${project.path ?? chalk5.dim("none")}`);
+    log(`  Description: ${project.description ?? chalk5.dim("none")}`);
+    log(`  Created:     ${project.createdAt}`);
+    log(`  Updated:     ${project.updatedAt}`);
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7053,9 +8004,9 @@ projectCmd.command("use <name>").description("Set active project (find or create
     }
     config.activeProject = project.id;
     writeFileSync3(CONFIG_PATH2, JSON.stringify(config, null, 2), "utf-8");
-    console.log(chalk5.green(`Active project set to ${chalk5.bold(project.name)} (${project.id})`));
+    log(chalk5.green(`Active project set to ${chalk5.bold(project.name)} (${project.id})`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7080,40 +8031,44 @@ scheduleCmd.command("create <name>").description("Create a new schedule").requir
       timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
       projectId
     });
-    console.log(chalk5.green(`Created schedule ${chalk5.bold(schedule.name)} (${schedule.id})`));
+    log(chalk5.green(`Created schedule ${chalk5.bold(schedule.name)} (${schedule.id})`));
     if (schedule.nextRunAt) {
-      console.log(chalk5.dim(`  Next run at: ${schedule.nextRunAt}`));
+      log(chalk5.dim(`  Next run at: ${schedule.nextRunAt}`));
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-scheduleCmd.command("list").description("List schedules").option("--project <id>", "Filter by project ID").option("--enabled", "Show only enabled schedules").action((opts) => {
+scheduleCmd.command("list").description("List schedules").option("--project <id>", "Filter by project ID").option("--enabled", "Show only enabled schedules").option("--json", "Output as JSON", false).action((opts) => {
   try {
     const projectId = resolveProject(opts.project);
     const schedules = listSchedules({
       projectId,
       enabled: opts.enabled ? true : undefined
     });
+    if (opts.json) {
+      log(JSON.stringify(schedules, null, 2));
+      return;
+    }
     if (schedules.length === 0) {
-      console.log(chalk5.dim("No schedules found."));
+      log(chalk5.dim("No schedules found."));
       return;
     }
-    console.log("");
-    console.log(chalk5.bold("  Schedules"));
-    console.log("");
-    console.log(`  ${"Name".padEnd(20)} ${"Cron".padEnd(18)} ${"URL".padEnd(30)} ${"Enabled".padEnd(9)} ${"Next Run".padEnd(22)} Last Run`);
-    console.log(`  ${"\u2500".repeat(20)} ${"\u2500".repeat(18)} ${"\u2500".repeat(30)} ${"\u2500".repeat(9)} ${"\u2500".repeat(22)} ${"\u2500".repeat(22)}`);
+    log("");
+    log(chalk5.bold("  Schedules"));
+    log("");
+    log(`  ${"Name".padEnd(20)} ${"Cron".padEnd(18)} ${"URL".padEnd(30)} ${"Enabled".padEnd(9)} ${"Next Run".padEnd(22)} Last Run`);
+    log(`  ${"\u2500".repeat(20)} ${"\u2500".repeat(18)} ${"\u2500".repeat(30)} ${"\u2500".repeat(9)} ${"\u2500".repeat(22)} ${"\u2500".repeat(22)}`);
     for (const s of schedules) {
       const enabled = s.enabled ? chalk5.green("yes") : chalk5.red("no");
       const nextRun = s.nextRunAt ?? chalk5.dim("\u2014");
       const lastRun = s.lastRunAt ?? chalk5.dim("\u2014");
-      console.log(`  ${s.name.padEnd(20)} ${s.cronExpression.padEnd(18)} ${s.url.padEnd(30)} ${enabled.toString().padEnd(9)} ${nextRun.toString().padEnd(22)} ${lastRun}`);
+      log(`  ${s.name.padEnd(20)} ${s.cronExpression.padEnd(18)} ${s.url.padEnd(30)} ${enabled.toString().padEnd(9)} ${nextRun.toString().padEnd(22)} ${lastRun}`);
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7121,47 +8076,47 @@ scheduleCmd.command("show <id>").description("Show schedule details").action((id
   try {
     const schedule = getSchedule(id);
     if (!schedule) {
-      console.error(chalk5.red(`Schedule not found: ${id}`));
+      logError(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
     }
-    console.log("");
-    console.log(chalk5.bold(`  Schedule: ${schedule.name}`));
-    console.log(`  ID:          ${schedule.id}`);
-    console.log(`  Cron:        ${schedule.cronExpression}`);
-    console.log(`  URL:         ${schedule.url}`);
-    console.log(`  Enabled:     ${schedule.enabled ? chalk5.green("yes") : chalk5.red("no")}`);
-    console.log(`  Model:       ${schedule.model ?? chalk5.dim("default")}`);
-    console.log(`  Headed:      ${schedule.headed ? "yes" : "no"}`);
-    console.log(`  Parallel:    ${schedule.parallel}`);
-    console.log(`  Timeout:     ${schedule.timeoutMs ? `${schedule.timeoutMs}ms` : chalk5.dim("default")}`);
-    console.log(`  Project:     ${schedule.projectId ?? chalk5.dim("none")}`);
-    console.log(`  Filter:      ${JSON.stringify(schedule.scenarioFilter)}`);
-    console.log(`  Next run:    ${schedule.nextRunAt ?? chalk5.dim("not scheduled")}`);
-    console.log(`  Last run:    ${schedule.lastRunAt ?? chalk5.dim("never")}`);
-    console.log(`  Last run ID: ${schedule.lastRunId ?? chalk5.dim("none")}`);
-    console.log(`  Created:     ${schedule.createdAt}`);
-    console.log(`  Updated:     ${schedule.updatedAt}`);
-    console.log("");
+    log("");
+    log(chalk5.bold(`  Schedule: ${schedule.name}`));
+    log(`  ID:          ${schedule.id}`);
+    log(`  Cron:        ${schedule.cronExpression}`);
+    log(`  URL:         ${schedule.url}`);
+    log(`  Enabled:     ${schedule.enabled ? chalk5.green("yes") : chalk5.red("no")}`);
+    log(`  Model:       ${schedule.model ?? chalk5.dim("default")}`);
+    log(`  Headed:      ${schedule.headed ? "yes" : "no"}`);
+    log(`  Parallel:    ${schedule.parallel}`);
+    log(`  Timeout:     ${schedule.timeoutMs ? `${schedule.timeoutMs}ms` : chalk5.dim("default")}`);
+    log(`  Project:     ${schedule.projectId ?? chalk5.dim("none")}`);
+    log(`  Filter:      ${JSON.stringify(schedule.scenarioFilter)}`);
+    log(`  Next run:    ${schedule.nextRunAt ?? chalk5.dim("not scheduled")}`);
+    log(`  Last run:    ${schedule.lastRunAt ?? chalk5.dim("never")}`);
+    log(`  Last run ID: ${schedule.lastRunId ?? chalk5.dim("none")}`);
+    log(`  Created:     ${schedule.createdAt}`);
+    log(`  Updated:     ${schedule.updatedAt}`);
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 scheduleCmd.command("enable <id>").description("Enable a schedule").action((id) => {
   try {
     const schedule = updateSchedule(id, { enabled: true });
-    console.log(chalk5.green(`Enabled schedule ${chalk5.bold(schedule.name)}`));
+    log(chalk5.green(`Enabled schedule ${chalk5.bold(schedule.name)}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 scheduleCmd.command("disable <id>").description("Disable a schedule").action((id) => {
   try {
     const schedule = updateSchedule(id, { enabled: false });
-    console.log(chalk5.green(`Disabled schedule ${chalk5.bold(schedule.name)}`));
+    log(chalk5.green(`Disabled schedule ${chalk5.bold(schedule.name)}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7169,13 +8124,13 @@ scheduleCmd.command("delete <id>").description("Delete a schedule").action((id)
   try {
     const deleted = deleteSchedule(id);
     if (deleted) {
-      console.log(chalk5.green(`Deleted schedule: ${id}`));
+      log(chalk5.green(`Deleted schedule: ${id}`));
     } else {
-      console.error(chalk5.red(`Schedule not found: ${id}`));
+      logError(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7183,11 +8138,11 @@ scheduleCmd.command("run <id>").description("Manually trigger a schedule").optio
   try {
     const schedule = getSchedule(id);
     if (!schedule) {
-      console.error(chalk5.red(`Schedule not found: ${id}`));
+      logError(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
       return;
     }
-    console.log(chalk5.blue(`Running schedule ${chalk5.bold(schedule.name)} against ${schedule.url}...`));
+    log(chalk5.blue(`Running schedule ${chalk5.bold(schedule.name)} against ${schedule.url}...`));
     const { run, results } = await runByFilter({
       url: schedule.url,
       tags: schedule.scenarioFilter.tags,
@@ -7200,21 +8155,21 @@ scheduleCmd.command("run <id>").description("Manually trigger a schedule").optio
       projectId: schedule.projectId ?? undefined
     });
     if (opts.json) {
-      console.log(formatJSON(run, results));
+      log(formatJSON(run, results));
     } else {
-      console.log(formatTerminal(run, results));
+      log(formatTerminal(run, results));
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("daemon").description("Start the scheduler daemon").option("--interval <seconds>", "Check interval in seconds", "60").action(async (opts) => {
   try {
     const intervalMs = parseInt(opts.interval, 10) * 1000;
-    console.log(chalk5.blue("Scheduler daemon started. Press Ctrl+C to stop."));
-    console.log(chalk5.dim(`  Check interval: ${opts.interval}s`));
+    log(chalk5.blue("Scheduler daemon started. Press Ctrl+C to stop."));
+    log(chalk5.dim(`  Check interval: ${opts.interval}s`));
     let running = true;
     const checkAndRun = async () => {
       while (running) {
@@ -7223,7 +8178,7 @@ program2.command("daemon").description("Start the scheduler daemon").option("--i
           const now2 = new Date().toISOString();
           for (const schedule of schedules) {
             if (schedule.nextRunAt && schedule.nextRunAt <= now2) {
-              console.log(chalk5.blue(`[${new Date().toISOString()}] Triggering schedule: ${schedule.name}`));
+              log(chalk5.blue(`[${new Date().toISOString()}] Triggering schedule: ${schedule.name}`));
               try {
                 const { run } = await runByFilter({
                   url: schedule.url,
@@ -7237,60 +8192,60 @@ program2.command("daemon").description("Start the scheduler daemon").option("--i
                   projectId: schedule.projectId ?? undefined
                 });
                 const statusColor = run.status === "passed" ? chalk5.green : chalk5.red;
-                console.log(`  ${statusColor(run.status)} \u2014 ${run.passed}/${run.total} passed`);
+                log(`  ${statusColor(run.status)} \u2014 ${run.passed}/${run.total} passed`);
                 updateSchedule(schedule.id, {});
               } catch (err) {
-                console.error(chalk5.red(`  Error running schedule ${schedule.name}: ${err instanceof Error ? err.message : String(err)}`));
+                logError(chalk5.red(`  Error running schedule ${schedule.name}: ${err instanceof Error ? err.message : String(err)}`));
               }
             }
           }
         } catch (err) {
-          console.error(chalk5.red(`Daemon error: ${err instanceof Error ? err.message : String(err)}`));
+          logError(chalk5.red(`Daemon error: ${err instanceof Error ? err.message : String(err)}`));
         }
         await new Promise((resolve2) => setTimeout(resolve2, intervalMs));
       }
     };
     process.on("SIGINT", () => {
-      console.log(chalk5.yellow(`
+      log(chalk5.yellow(`
 Shutting down scheduler daemon...`));
       running = false;
       process.exit(0);
     });
     process.on("SIGTERM", () => {
-      console.log(chalk5.yellow(`
+      log(chalk5.yellow(`
 Shutting down scheduler daemon...`));
       running = false;
       process.exit(0);
     });
     await checkAndRun();
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("init").description("Initialize a new testing project").option("-n, --name <name>", "Project name").option("-u, --url <url>", "Base URL").option("-p, --path <path>", "Project path").option("--ci <provider>", "Generate CI workflow (github)").action((opts) => {
+program2.command("init").description("Initialize a new testing project").option("-n, --name <name>", "Project name").option("-u, --url <url>", "Base URL").option("-p, --path <path>", "Project path").option("--ci <provider>", "Generate CI workflow (github)").action(async (opts) => {
   try {
-    const { project, scenarios, framework } = initProject({
+    const { project, scenarios, framework, url } = initProject({
       name: opts.name,
       url: opts.url,
       path: opts.path
     });
-    console.log("");
-    console.log(chalk5.bold("  Project initialized!"));
-    console.log("");
+    log("");
+    log(chalk5.bold("  Project initialized!"));
+    log("");
     if (framework) {
-      console.log(`  Framework:  ${chalk5.cyan(framework.name)}`);
+      log(`  Framework:  ${chalk5.cyan(framework.name)}`);
       if (framework.features.length > 0) {
-        console.log(`  Features:   ${chalk5.dim(framework.features.join(", "))}`);
+        log(`  Features:   ${chalk5.dim(framework.features.join(", "))}`);
       }
     } else {
-      console.log(`  Framework:  ${chalk5.dim("not detected")}`);
+      log(`  Framework:  ${chalk5.dim("not detected")}`);
     }
-    console.log(`  Project:    ${chalk5.green(project.name)} ${chalk5.dim(`(${project.id})`)}`);
-    console.log(`  Scenarios:  ${chalk5.green(String(scenarios.length))} starter scenarios created`);
-    console.log("");
+    log(`  Project:    ${chalk5.green(project.name)} ${chalk5.dim(`(${project.id})`)}`);
+    log(`  Scenarios:  ${chalk5.green(String(scenarios.length))} starter scenarios created`);
+    log("");
     for (const s of scenarios) {
-      console.log(`    ${chalk5.dim(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
+      log(`    ${chalk5.dim(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
     }
     if (opts.ci === "github") {
       const workflowDir = join6(process.cwd(), ".github", "workflows");
@@ -7299,18 +8254,51 @@ program2.command("init").description("Initialize a new testing project").option(
       }
       const workflowPath = join6(workflowDir, "testers.yml");
       writeFileSync3(workflowPath, generateGitHubActionsWorkflow(), "utf-8");
-      console.log(`  CI:         ${chalk5.green("GitHub Actions workflow written to .github/workflows/testers.yml")}`);
+      log(`  CI:         ${chalk5.green("GitHub Actions workflow written to .github/workflows/testers.yml")}`);
     } else if (opts.ci) {
-      console.log(chalk5.yellow(`  Unknown CI provider: ${opts.ci}. Supported: github`));
-    }
-    console.log("");
-    console.log(chalk5.bold("  Next steps:"));
-    console.log(`    1. Start your dev server`);
-    console.log(`    2. Run ${chalk5.cyan("testers run <url>")} to execute tests`);
-    console.log(`    3. Add more scenarios with ${chalk5.cyan("testers add <name>")}`);
-    console.log("");
+      log(chalk5.yellow(`  Unknown CI provider: ${opts.ci}. Supported: github`));
+    }
+    log("");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((resolve2) => rl.question(q, resolve2));
+    try {
+      const envAnswer = await ask("  Would you like to configure environments? [y/N] ");
+      if (envAnswer.trim().toLowerCase() === "y") {
+        const envName = await ask("  Environment name (default: staging): ");
+        const envUrl = await ask(`  Base URL (default: ${url}): `);
+        const resolvedEnvName = envName.trim() || "staging";
+        const resolvedEnvUrl = envUrl.trim() || url;
+        createEnvironment({ name: resolvedEnvName, url: resolvedEnvUrl, projectId: project.id, isDefault: true });
+        log(chalk5.green(`  \u2713 Environment '${resolvedEnvName}' created (${resolvedEnvUrl})`));
+        log("");
+      }
+      const scenarioAnswer = await ask("  Would you like to create your first test scenario? [y/N] ");
+      if (scenarioAnswer.trim().toLowerCase() === "y") {
+        const scenarioName = await ask("  Scenario name: ");
+        const scenarioUrl = await ask(`  URL to test (default: ${url}): `);
+        const resolvedScenarioName = scenarioName.trim() || "My first scenario";
+        const resolvedScenarioUrl = scenarioUrl.trim() || url;
+        const newScenario = createScenario({
+          name: resolvedScenarioName,
+          description: `Navigate to ${resolvedScenarioUrl} and verify it loads correctly.`,
+          projectId: project.id,
+          targetPath: resolvedScenarioUrl,
+          tags: ["smoke"],
+          priority: "high"
+        });
+        log(chalk5.green(`  \u2713 Scenario '${newScenario.name}' created ${chalk5.dim(`(${newScenario.shortId})`)}`));
+        log("");
+      }
+    } finally {
+      rl.close();
+    }
+    log(chalk5.bold("  Next steps:"));
+    log(`    1. Start your dev server`);
+    log(`    2. Run ${chalk5.cyan("testers run <url>")} to execute tests`);
+    log(`    3. Add more scenarios with ${chalk5.cyan("testers add <name>")}`);
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7318,16 +8306,16 @@ program2.command("replay <run-id>").description("Re-run all scenarios from a pre
   try {
     const originalRun = getRun(runId);
     if (!originalRun) {
-      console.error(chalk5.red(`Run not found: ${runId}`));
+      logError(chalk5.red(`Run not found: ${runId}`));
       process.exit(1);
     }
     const originalResults = getResultsByRun(originalRun.id);
     const scenarioIds = originalResults.map((r) => r.scenarioId);
     if (scenarioIds.length === 0) {
-      console.log(chalk5.dim("No scenarios to replay."));
+      log(chalk5.dim("No scenarios to replay."));
       return;
     }
-    console.log(chalk5.blue(`Replaying ${scenarioIds.length} scenarios from run ${originalRun.id.slice(0, 8)}...`));
+    log(chalk5.blue(`Replaying ${scenarioIds.length} scenarios from run ${originalRun.id.slice(0, 8)}...`));
     const { run, results } = await runByFilter({
       url: opts.url ?? originalRun.url,
       scenarioIds,
@@ -7336,13 +8324,13 @@ program2.command("replay <run-id>").description("Re-run all scenarios from a pre
       parallel: parseInt(opts.parallel, 10)
     });
     if (opts.json) {
-      console.log(formatJSON(run, results));
+      log(formatJSON(run, results));
     } else {
-      console.log(formatTerminal(run, results));
+      log(formatTerminal(run, results));
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7350,16 +8338,16 @@ program2.command("retry <run-id>").description("Re-run only failed scenarios fro
   try {
     const originalRun = getRun(runId);
     if (!originalRun) {
-      console.error(chalk5.red(`Run not found: ${runId}`));
+      logError(chalk5.red(`Run not found: ${runId}`));
       process.exit(1);
     }
     const originalResults = getResultsByRun(originalRun.id);
     const failedScenarioIds = originalResults.filter((r) => r.status === "failed" || r.status === "error").map((r) => r.scenarioId);
     if (failedScenarioIds.length === 0) {
-      console.log(chalk5.green("No failed scenarios to retry. All passed!"));
+      log(chalk5.green("No failed scenarios to retry. All passed!"));
       return;
     }
-    console.log(chalk5.blue(`Retrying ${failedScenarioIds.length} failed scenarios from run ${originalRun.id.slice(0, 8)}...`));
+    log(chalk5.blue(`Retrying ${failedScenarioIds.length} failed scenarios from run ${originalRun.id.slice(0, 8)}...`));
     const { run, results } = await runByFilter({
       url: opts.url ?? originalRun.url,
       scenarioIds: failedScenarioIds,
@@ -7368,35 +8356,35 @@ program2.command("retry <run-id>").description("Re-run only failed scenarios fro
       parallel: parseInt(opts.parallel, 10)
     });
     if (!opts.json) {
-      console.log("");
-      console.log(chalk5.bold("  Comparison with original run:"));
+      log("");
+      log(chalk5.bold("  Comparison with original run:"));
       for (const result of results) {
         const original = originalResults.find((r) => r.scenarioId === result.scenarioId);
         if (original) {
           const changed = original.status !== result.status;
           const arrow = changed ? chalk5.yellow(`${original.status} \u2192 ${result.status}`) : chalk5.dim(`${result.status} (unchanged)`);
           const icon = result.status === "passed" ? chalk5.green("\u2713") : chalk5.red("\u2717");
-          console.log(`  ${icon} ${result.scenarioId.slice(0, 8)}: ${arrow}`);
+          log(`  ${icon} ${result.scenarioId.slice(0, 8)}: ${arrow}`);
         }
       }
-      console.log("");
+      log("");
     }
     if (opts.json) {
-      console.log(formatJSON(run, results));
+      log(formatJSON(run, results));
     } else {
-      console.log(formatTerminal(run, results));
+      log(formatTerminal(run, results));
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("smoke <url>").description("Run autonomous smoke test").option("-m, --model <model>", "AI model").option("--headed", "Watch browser", false).option("--timeout <ms>", "Timeout in milliseconds").option("--json", "JSON output", false).option("--project <id>", "Project ID").action(async (url, opts) => {
   try {
     const projectId = resolveProject(opts.project);
-    console.log(chalk5.blue(`Running smoke test against ${chalk5.bold(url)}...`));
-    console.log("");
+    log(chalk5.blue(`Running smoke test against ${chalk5.bold(url)}...`));
+    log("");
     const smokeResult = await runSmoke({
       url,
       model: opts.model,
@@ -7405,19 +8393,19 @@ program2.command("smoke <url>").description("Run autonomous smoke test").option(
       projectId
     });
     if (opts.json) {
-      console.log(JSON.stringify({
+      log(JSON.stringify({
         run: smokeResult.run,
         result: smokeResult.result,
         pagesVisited: smokeResult.pagesVisited,
         issues: smokeResult.issuesFound
       }, null, 2));
     } else {
-      console.log(formatSmokeReport(smokeResult));
+      log(formatSmokeReport(smokeResult));
     }
     const hasCritical = smokeResult.issuesFound.some((i) => i.severity === "critical" || i.severity === "high");
     process.exit(hasCritical ? 1 : 0);
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7425,27 +8413,27 @@ program2.command("diff <run1> <run2>").description("Compare two test runs").opti
   try {
     const diff = diffRuns(run1, run2);
     if (opts.json) {
-      console.log(formatDiffJSON(diff));
+      log(formatDiffJSON(diff));
     } else {
-      console.log(formatDiffTerminal(diff));
+      log(formatDiffTerminal(diff));
     }
     const threshold = parseFloat(opts.threshold);
     const visualResults = compareRunScreenshots(run2, run1, threshold);
     if (visualResults.length > 0) {
       if (opts.json) {
-        console.log(JSON.stringify({ visualDiff: visualResults }, null, 2));
+        log(JSON.stringify({ visualDiff: visualResults }, null, 2));
       } else {
-        console.log(formatVisualDiffTerminal(visualResults, threshold));
+        log(formatVisualDiffTerminal(visualResults, threshold));
       }
     }
     const hasVisualRegressions = visualResults.some((r) => r.isRegression);
     process.exit(diff.regressions.length > 0 || hasVisualRegressions ? 1 : 0);
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("report [run-id]").description("Generate HTML test report").option("--latest", "Use most recent run", false).option("-o, --output <file>", "Output file path", "report.html").action((runId, opts) => {
+program2.command("report [run-id]").description("Generate HTML test report").option("--latest", "Use most recent run", false).option("-o, --output <file>", "Output file path", "report.html").option("--open", "Open the report in the browser after generating", false).action((runId, opts) => {
   try {
     let html;
     if (opts.latest || !runId) {
@@ -7454,9 +8442,14 @@ program2.command("report [run-id]").description("Generate HTML test report").opt
       html = generateHtmlReport(runId);
     }
     writeFileSync3(opts.output, html, "utf-8");
-    console.log(chalk5.green(`Report generated: ${opts.output}`));
+    const absPath = resolve(opts.output);
+    log(chalk5.green(`Report generated: ${absPath}`));
+    if (opts.open) {
+      const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
+      Bun.spawn([openCmd, absPath]);
+    }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7469,9 +8462,9 @@ authCmd.command("add <name>").description("Create an auth preset").requiredOptio
       password: opts.password,
       loginPath: opts.loginPath
     });
-    console.log(chalk5.green(`Created auth preset ${chalk5.bold(preset.name)} (${preset.email})`));
+    log(chalk5.green(`Created auth preset ${chalk5.bold(preset.name)} (${preset.email})`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7479,20 +8472,20 @@ authCmd.command("list").description("List auth presets").action(() => {
   try {
     const presets = listAuthPresets();
     if (presets.length === 0) {
-      console.log(chalk5.dim("No auth presets found."));
+      log(chalk5.dim("No auth presets found."));
       return;
     }
-    console.log("");
-    console.log(chalk5.bold("  Auth Presets"));
-    console.log("");
-    console.log(`  ${"Name".padEnd(20)} ${"Email".padEnd(30)} ${"Login Path".padEnd(15)} Created`);
-    console.log(`  ${"\u2500".repeat(20)} ${"\u2500".repeat(30)} ${"\u2500".repeat(15)} ${"\u2500".repeat(22)}`);
+    log("");
+    log(chalk5.bold("  Auth Presets"));
+    log("");
+    log(`  ${"Name".padEnd(20)} ${"Email".padEnd(30)} ${"Login Path".padEnd(15)} Created`);
+    log(`  ${"\u2500".repeat(20)} ${"\u2500".repeat(30)} ${"\u2500".repeat(15)} ${"\u2500".repeat(22)}`);
     for (const p of presets) {
-      console.log(`  ${p.name.padEnd(20)} ${p.email.padEnd(30)} ${p.loginPath.padEnd(15)} ${p.createdAt}`);
+      log(`  ${p.name.padEnd(20)} ${p.email.padEnd(30)} ${p.loginPath.padEnd(15)} ${p.createdAt}`);
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7500,26 +8493,39 @@ authCmd.command("delete <name>").description("Delete an auth preset").action((na
   try {
     const deleted = deleteAuthPreset(name);
     if (deleted) {
-      console.log(chalk5.green(`Deleted auth preset: ${name}`));
+      log(chalk5.green(`Deleted auth preset: ${name}`));
     } else {
-      console.error(chalk5.red(`Auth preset not found: ${name}`));
+      logError(chalk5.red(`Auth preset not found: ${name}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("costs").description("Show cost tracking and budget status").option("--project <id>", "Project ID").option("--period <period>", "Time period", "month").option("--json", "JSON output", false).action((opts) => {
+program2.command("costs").description("Show cost tracking and budget status").option("--project <id>", "Project ID").option("--period <period>", "Time period: day, week, month, all (default: month)", "month").option("--by-scenario", "Group cost breakdown by scenario, sorted by total cost", false).option("--json", "JSON output", false).option("--csv", "CSV output", false).action((opts) => {
   try {
-    const summary = getCostSummary({ projectId: resolveProject(opts.project), period: opts.period });
-    if (opts.json) {
-      console.log(formatCostsJSON(summary));
+    const projectId = resolveProject(opts.project);
+    const period = opts.period;
+    if (opts.byScenario) {
+      const rows = getCostsByScenario({ projectId, period });
+      if (opts.json) {
+        log(JSON.stringify(rows, null, 2));
+      } else {
+        log(formatCostsByScenarioTerminal(rows, period));
+      }
+      return;
+    }
+    const summary = getCostSummary({ projectId, period });
+    if (opts.csv) {
+      log(formatCostsCsv(summary));
+    } else if (opts.json) {
+      log(formatCostsJSON(summary));
     } else {
-      console.log(formatCostsTerminal(summary));
+      log(formatCostsTerminal(summary));
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7527,18 +8533,18 @@ program2.command("chain <scenario-id>").description("Add a dependency to a scena
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
+      logError(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const dep = getScenario(opts.dependsOn) ?? getScenarioByShortId(opts.dependsOn);
     if (!dep) {
-      console.error(chalk5.red(`Dependency scenario not found: ${opts.dependsOn}`));
+      logError(chalk5.red(`Dependency scenario not found: ${opts.dependsOn}`));
       process.exit(1);
     }
     addDependency(scenario.id, dep.id);
-    console.log(chalk5.green(`${scenario.shortId} now depends on ${dep.shortId}`));
+    log(chalk5.green(`${scenario.shortId} now depends on ${dep.shortId}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7546,18 +8552,18 @@ program2.command("unchain <scenario-id>").description("Remove a dependency from
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
+      logError(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const dep = getScenario(opts.from) ?? getScenarioByShortId(opts.from);
     if (!dep) {
-      console.error(chalk5.red(`Dependency not found: ${opts.from}`));
+      logError(chalk5.red(`Dependency not found: ${opts.from}`));
       process.exit(1);
     }
     removeDependency(scenario.id, dep.id);
-    console.log(chalk5.green(`Removed dependency: ${scenario.shortId} no longer depends on ${dep.shortId}`));
+    log(chalk5.green(`Removed dependency: ${scenario.shortId} no longer depends on ${dep.shortId}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7565,34 +8571,34 @@ program2.command("deps <scenario-id>").description("Show dependencies for a scen
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
+      logError(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const deps = getDependencies(scenario.id);
     const dependents = getDependents(scenario.id);
-    console.log("");
-    console.log(chalk5.bold(`  Dependencies for ${scenario.shortId}: ${scenario.name}`));
-    console.log("");
+    log("");
+    log(chalk5.bold(`  Dependencies for ${scenario.shortId}: ${scenario.name}`));
+    log("");
     if (deps.length > 0) {
-      console.log(chalk5.dim("  Depends on:"));
+      log(chalk5.dim("  Depends on:"));
       for (const depId of deps) {
         const s = getScenario(depId);
-        console.log(`    \u2192 ${s ? `${s.shortId}: ${s.name}` : depId.slice(0, 8)}`);
+        log(`    \u2192 ${s ? `${s.shortId}: ${s.name}` : depId.slice(0, 8)}`);
       }
     } else {
-      console.log(chalk5.dim("  No dependencies"));
+      log(chalk5.dim("  No dependencies"));
     }
     if (dependents.length > 0) {
-      console.log("");
-      console.log(chalk5.dim("  Required by:"));
+      log("");
+      log(chalk5.dim("  Required by:"));
       for (const depId of dependents) {
         const s = getScenario(depId);
-        console.log(`    \u2190 ${s ? `${s.shortId}: ${s.name}` : depId.slice(0, 8)}`);
+        log(`    \u2190 ${s ? `${s.shortId}: ${s.name}` : depId.slice(0, 8)}`);
       }
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7602,7 +8608,7 @@ flowCmd.command("create <name>").description("Create a flow from scenario IDs").
     const ids = opts.chain.split(",").map((id) => {
       const s = getScenario(id.trim()) ?? getScenarioByShortId(id.trim());
       if (!s) {
-        console.error(chalk5.red(`Scenario not found: ${id.trim()}`));
+        logError(chalk5.red(`Scenario not found: ${id.trim()}`));
         process.exit(1);
       }
       return s.id;
@@ -7613,49 +8619,49 @@ flowCmd.command("create <name>").description("Create a flow from scenario IDs").
       } catch {}
     }
     const flow = createFlow({ name, scenarioIds: ids, projectId: resolveProject(opts.project) });
-    console.log(chalk5.green(`Flow created: ${flow.id.slice(0, 8)} \u2014 ${flow.name} (${ids.length} scenarios)`));
+    log(chalk5.green(`Flow created: ${flow.id.slice(0, 8)} \u2014 ${flow.name} (${ids.length} scenarios)`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 flowCmd.command("list").description("List all flows").option("--project <id>", "Project ID").action((opts) => {
   const flows = listFlows(resolveProject(opts.project) ?? undefined);
   if (flows.length === 0) {
-    console.log(chalk5.dim(`
+    log(chalk5.dim(`
   No flows found.
 `));
     return;
   }
-  console.log("");
-  console.log(chalk5.bold("  Flows"));
-  console.log("");
+  log("");
+  log(chalk5.bold("  Flows"));
+  log("");
   for (const f of flows) {
-    console.log(`  ${chalk5.dim(f.id.slice(0, 8))}  ${f.name}  ${chalk5.dim(`(${f.scenarioIds.length} scenarios)`)}`);
+    log(`  ${chalk5.dim(f.id.slice(0, 8))}  ${f.name}  ${chalk5.dim(`(${f.scenarioIds.length} scenarios)`)}`);
   }
-  console.log("");
+  log("");
 });
 flowCmd.command("show <id>").description("Show flow details").action((id) => {
   const flow = getFlow(id);
   if (!flow) {
-    console.error(chalk5.red(`Flow not found: ${id}`));
+    logError(chalk5.red(`Flow not found: ${id}`));
     process.exit(1);
   }
-  console.log("");
-  console.log(chalk5.bold(`  Flow: ${flow.name}`));
-  console.log(`  ID: ${chalk5.dim(flow.id)}`);
-  console.log(`  Scenarios (in order):`);
+  log("");
+  log(chalk5.bold(`  Flow: ${flow.name}`));
+  log(`  ID: ${chalk5.dim(flow.id)}`);
+  log(`  Scenarios (in order):`);
   for (let i = 0;i < flow.scenarioIds.length; i++) {
     const s = getScenario(flow.scenarioIds[i]);
-    console.log(`    ${i + 1}. ${s ? `${s.shortId}: ${s.name}` : flow.scenarioIds[i].slice(0, 8)}`);
+    log(`    ${i + 1}. ${s ? `${s.shortId}: ${s.name}` : flow.scenarioIds[i].slice(0, 8)}`);
   }
-  console.log("");
+  log("");
 });
 flowCmd.command("delete <id>").description("Delete a flow").action((id) => {
   if (deleteFlow(id))
-    console.log(chalk5.green("Flow deleted."));
+    log(chalk5.green("Flow deleted."));
   else {
-    console.error(chalk5.red("Flow not found."));
+    logError(chalk5.red("Flow not found."));
     process.exit(1);
   }
 });
@@ -7663,14 +8669,14 @@ flowCmd.command("run <id>").description("Run a flow (scenarios in dependency ord
   try {
     const flow = getFlow(id);
     if (!flow) {
-      console.error(chalk5.red(`Flow not found: ${id}`));
+      logError(chalk5.red(`Flow not found: ${id}`));
       process.exit(1);
     }
     if (!opts.url) {
-      console.error(chalk5.red("--url is required for flow run"));
+      logError(chalk5.red("--url is required for flow run"));
       process.exit(1);
     }
-    console.log(chalk5.blue(`Running flow: ${flow.name} (${flow.scenarioIds.length} scenarios)`));
+    log(chalk5.blue(`Running flow: ${flow.name} (${flow.scenarioIds.length} scenarios)`));
     const { run, results } = await runByFilter({
       url: opts.url,
       scenarioIds: flow.scenarioIds,
@@ -7679,12 +8685,12 @@ flowCmd.command("run <id>").description("Run a flow (scenarios in dependency ord
       parallel: 1
     });
     if (opts.json)
-      console.log(formatJSON(run, results));
+      log(formatJSON(run, results));
     else
-      console.log(formatTerminal(run, results));
+      log(formatTerminal(run, results));
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7698,9 +8704,9 @@ envCmd.command("add <name>").description("Add a named environment").requiredOpti
       projectId: opts.project,
       isDefault: opts.default
     });
-    console.log(chalk5.green(`Environment added: ${env.name} \u2192 ${env.url}${env.isDefault ? " (default)" : ""}`));
+    log(chalk5.green(`Environment added: ${env.name} \u2192 ${env.url}${env.isDefault ? " (default)" : ""}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7708,16 +8714,16 @@ envCmd.command("list").description("List all environments").option("--project <i
   try {
     const envs = listEnvironments(opts.project);
     if (envs.length === 0) {
-      console.log(chalk5.dim("No environments configured. Add one with: testers env add <name> --url <url>"));
+      log(chalk5.dim("No environments configured. Add one with: testers env add <name> --url <url>"));
       return;
     }
     for (const env of envs) {
       const marker = env.isDefault ? chalk5.green(" \u2605 default") : "";
       const auth = env.authPresetName ? chalk5.dim(` (auth: ${env.authPresetName})`) : "";
-      console.log(`  ${chalk5.bold(env.name)}  ${env.url}${auth}${marker}`);
+      log(`  ${chalk5.bold(env.name)}  ${env.url}${auth}${marker}`);
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7725,9 +8731,9 @@ envCmd.command("use <name>").description("Set an environment as the default").ac
   try {
     setDefaultEnvironment(name);
     const env = getEnvironment(name);
-    console.log(chalk5.green(`Default environment set: ${env.name} \u2192 ${env.url}`));
+    log(chalk5.green(`Default environment set: ${env.name} \u2192 ${env.url}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7735,13 +8741,13 @@ envCmd.command("delete <name>").description("Delete an environment").action((nam
   try {
     const deleted = deleteEnvironment(name);
     if (deleted) {
-      console.log(chalk5.green(`Environment deleted: ${name}`));
+      log(chalk5.green(`Environment deleted: ${name}`));
     } else {
-      console.error(chalk5.red(`Environment not found: ${name}`));
+      logError(chalk5.red(`Environment not found: ${name}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7749,9 +8755,9 @@ program2.command("baseline <run-id>").description("Set a run as the visual basel
   try {
     setBaseline(runId);
     const run = getRun(runId);
-    console.log(chalk5.green(`Baseline set: ${chalk5.bold(runId.slice(0, 8))}${run ? ` (${run.status}, ${run.total} scenarios)` : ""}`));
+    log(chalk5.green(`Baseline set: ${chalk5.bold(runId.slice(0, 8))}${run ? ` (${run.status}, ${run.total} scenarios)` : ""}`));
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -7759,29 +8765,99 @@ program2.command("import-api <spec>").description("Import test scenarios from an
   try {
     const { importFromOpenAPI: importFromOpenAPI2 } = await Promise.resolve().then(() => (init_openapi_import(), exports_openapi_import));
     const { imported, scenarios } = importFromOpenAPI2(spec, resolveProject(opts.project) ?? undefined);
-    console.log(chalk5.green(`
+    log(chalk5.green(`
 Imported ${imported} scenarios from API spec:`));
     for (const s of scenarios) {
-      console.log(`  ${chalk5.cyan(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
+      log(`  ${chalk5.cyan(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
     }
-    console.log("");
+    log("");
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("record <url>").description("Record a browser session and generate a test scenario").option("-n, --name <name>", "Scenario name", "Recorded session").option("--project <id>", "Project ID").action(async (url, opts) => {
   try {
     const { recordAndSave: recordAndSave2 } = await Promise.resolve().then(() => (init_recorder(), exports_recorder));
-    console.log(chalk5.blue("Opening browser for recording..."));
+    log(chalk5.blue("Opening browser for recording..."));
     const { recording, scenario } = await recordAndSave2(url, opts.name, resolveProject(opts.project) ?? undefined);
-    console.log("");
-    console.log(chalk5.green(`Recording saved as scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
-    console.log(chalk5.dim(`  ${recording.actions.length} actions recorded in ${(recording.duration / 1000).toFixed(0)}s`));
-    console.log(chalk5.dim(`  ${scenario.steps.length} steps generated`));
+    log("");
+    log(chalk5.green(`Recording saved as scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
+    log(chalk5.dim(`  ${recording.actions.length} actions recorded in ${(recording.duration / 1000).toFixed(0)}s`));
+    log(chalk5.dim(`  ${scenario.steps.length} steps generated`));
+  } catch (error) {
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program2.command("doctor").description("Check system setup and configuration").action(async () => {
+  let allPassed = true;
+  const hasApiKey = Boolean(process.env["ANTHROPIC_API_KEY"]);
+  if (hasApiKey) {
+    log(chalk5.green("\u2713") + " ANTHROPIC_API_KEY is set");
+  } else {
+    log(chalk5.red("\u2717") + " ANTHROPIC_API_KEY is not set (required for AI-powered tests)");
+    allPassed = false;
+  }
+  const dbPath = join6(process.env["HOME"] ?? "~", ".testers", "testers.db");
+  try {
+    const { Database: Database3 } = await import("bun:sqlite");
+    const db2 = new Database3(dbPath, { create: true });
+    db2.close();
+    log(chalk5.green("\u2713") + ` Database accessible: ${dbPath}`);
+  } catch (err) {
+    log(chalk5.red("\u2717") + ` Database not accessible at ${dbPath}: ${err instanceof Error ? err.message : String(err)}`);
+    allPassed = false;
+  }
+  try {
+    const { chromium: chromium4 } = await import("playwright");
+    const execPath = chromium4.executablePath();
+    const { existsSync: fsExists } = await import("fs");
+    if (fsExists(execPath)) {
+      log(chalk5.green("\u2713") + " Playwright chromium is installed");
+    } else {
+      log(chalk5.red("\u2717") + ` Playwright chromium executable not found at ${execPath}. Run: testers install`);
+      allPassed = false;
+    }
+  } catch {
+    log(chalk5.red("\u2717") + " Playwright is not installed. Run: testers install");
+    allPassed = false;
+  }
+  if (!allPassed) {
+    process.exit(1);
+  }
+});
+program2.command("serve").description("Start the Open Testers web dashboard").option("--no-open", "Do not open the browser after starting", false).option("--port <port>", "Port to listen on", "19450").action(async (opts) => {
+  try {
+    const port = parseInt(opts.port, 10);
+    const url = `http://localhost:${port}`;
+    const serverBin = join6(resolve(process.execPath, ".."), "..", "dist", "server", "index.js");
+    const { join: pathJoin, resolve: pathResolve, dirname: dirname2 } = await import("path");
+    const { fileURLToPath } = await import("url");
+    const serverPath = pathJoin(dirname2(fileURLToPath(import.meta.url)), "..", "server", "index.js");
+    const proc = Bun.spawn(["bun", "run", serverPath], {
+      env: { ...process.env, TESTERS_PORT: String(port) },
+      stdout: "inherit",
+      stderr: "inherit"
+    });
+    log(chalk5.green(`Open Testers dashboard starting at ${url}`));
+    if (opts.open !== false) {
+      await new Promise((r) => setTimeout(r, 1500));
+      const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
+      Bun.spawn([openCmd, url]);
+    }
+    await proc.exited;
   } catch (error) {
-    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    logError(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
+program2.hook("preAction", () => {
+  const opts = program2.opts();
+  QUIET = opts.quiet === true;
+  NO_COLOR = opts.color === false || process.env["FORCE_COLOR"] === "0";
+  if (NO_COLOR) {
+    process.env["FORCE_COLOR"] = "0";
+  }
+});
 program2.parse();