@hasna/testers 0.0.6 → 0.0.7

package/dist/cli/index.js

@@ -2090,6 +2090,7 @@ function scenarioFromRow(row) {
     requiresAuth: row.requires_auth === 1,
     authConfig: row.auth_config ? JSON.parse(row.auth_config) : null,
     metadata: row.metadata ? JSON.parse(row.metadata) : null,
+    assertions: JSON.parse(row.assertions || "[]"),
     version: row.version,
     createdAt: row.created_at,
     updatedAt: row.updated_at
@@ -2109,7 +2110,8 @@ function runFromRow(row) {
     failed: row.failed,
     startedAt: row.started_at,
     finishedAt: row.finished_at,
-    metadata: row.metadata ? JSON.parse(row.metadata) : null
+    metadata: row.metadata ? JSON.parse(row.metadata) : null,
+    isBaseline: row.is_baseline === 1
   };
 }
 function resultFromRow(row) {
@@ -2464,10 +2466,199 @@ var init_database = __esm(() => {
   CREATE INDEX IF NOT EXISTS idx_deps_scenario ON scenario_dependencies(scenario_id);
   CREATE INDEX IF NOT EXISTS idx_deps_depends ON scenario_dependencies(depends_on);
   CREATE INDEX IF NOT EXISTS idx_flows_project ON flows(project_id);
+  `,
+    `
+  ALTER TABLE scenarios ADD COLUMN assertions TEXT DEFAULT '[]';
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS environments (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    url TEXT NOT NULL,
+    auth_preset_name TEXT,
+    project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    is_default INTEGER NOT NULL DEFAULT 0,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `,
+    `
+  ALTER TABLE runs ADD COLUMN is_baseline INTEGER NOT NULL DEFAULT 0;
   `
   ];
 });
 
+// src/db/scenarios.ts
+function nextShortId(projectId) {
+  const db2 = getDatabase();
+  if (projectId) {
+    const project = db2.query("SELECT scenario_prefix, scenario_counter FROM projects WHERE id = ?").get(projectId);
+    if (project) {
+      const next = project.scenario_counter + 1;
+      db2.query("UPDATE projects SET scenario_counter = ? WHERE id = ?").run(next, projectId);
+      return `${project.scenario_prefix}-${next}`;
+    }
+  }
+  return shortUuid();
+}
+function createScenario(input) {
+  const db2 = getDatabase();
+  const id = uuid();
+  const short_id = nextShortId(input.projectId);
+  const timestamp = now();
+  db2.query(`
+    INSERT INTO scenarios (id, short_id, project_id, name, description, steps, tags, priority, model, timeout_ms, target_path, requires_auth, auth_config, metadata, assertions, version, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
+  `).run(id, short_id, input.projectId ?? null, input.name, input.description, JSON.stringify(input.steps ?? []), JSON.stringify(input.tags ?? []), input.priority ?? "medium", input.model ?? null, input.timeoutMs ?? null, input.targetPath ?? null, input.requiresAuth ? 1 : 0, input.authConfig ? JSON.stringify(input.authConfig) : null, input.metadata ? JSON.stringify(input.metadata) : null, JSON.stringify(input.assertions ?? []), timestamp, timestamp);
+  return getScenario(id);
+}
+function getScenario(id) {
+  const db2 = getDatabase();
+  let row = db2.query("SELECT * FROM scenarios WHERE id = ?").get(id);
+  if (row)
+    return scenarioFromRow(row);
+  row = db2.query("SELECT * FROM scenarios WHERE short_id = ?").get(id);
+  if (row)
+    return scenarioFromRow(row);
+  const fullId = resolvePartialId("scenarios", id);
+  if (fullId) {
+    row = db2.query("SELECT * FROM scenarios WHERE id = ?").get(fullId);
+    if (row)
+      return scenarioFromRow(row);
+  }
+  return null;
+}
+function getScenarioByShortId(shortId) {
+  const db2 = getDatabase();
+  const row = db2.query("SELECT * FROM scenarios WHERE short_id = ?").get(shortId);
+  return row ? scenarioFromRow(row) : null;
+}
+function listScenarios(filter) {
+  const db2 = getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter?.projectId) {
+    conditions.push("project_id = ?");
+    params.push(filter.projectId);
+  }
+  if (filter?.tags && filter.tags.length > 0) {
+    for (const tag of filter.tags) {
+      conditions.push("tags LIKE ?");
+      params.push(`%"${tag}"%`);
+    }
+  }
+  if (filter?.priority) {
+    conditions.push("priority = ?");
+    params.push(filter.priority);
+  }
+  if (filter?.search) {
+    conditions.push("(name LIKE ? OR description LIKE ?)");
+    const term = `%${filter.search}%`;
+    params.push(term, term);
+  }
+  let sql = "SELECT * FROM scenarios";
+  if (conditions.length > 0) {
+    sql += " WHERE " + conditions.join(" AND ");
+  }
+  sql += " ORDER BY created_at DESC";
+  if (filter?.limit) {
+    sql += " LIMIT ?";
+    params.push(filter.limit);
+  }
+  if (filter?.offset) {
+    sql += " OFFSET ?";
+    params.push(filter.offset);
+  }
+  const rows = db2.query(sql).all(...params);
+  return rows.map(scenarioFromRow);
+}
+function updateScenario(id, input, version) {
+  const db2 = getDatabase();
+  const existing = getScenario(id);
+  if (!existing) {
+    throw new Error(`Scenario not found: ${id}`);
+  }
+  if (existing.version !== version) {
+    throw new VersionConflictError("scenario", existing.id);
+  }
+  const sets = [];
+  const params = [];
+  if (input.name !== undefined) {
+    sets.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.description !== undefined) {
+    sets.push("description = ?");
+    params.push(input.description);
+  }
+  if (input.steps !== undefined) {
+    sets.push("steps = ?");
+    params.push(JSON.stringify(input.steps));
+  }
+  if (input.tags !== undefined) {
+    sets.push("tags = ?");
+    params.push(JSON.stringify(input.tags));
+  }
+  if (input.priority !== undefined) {
+    sets.push("priority = ?");
+    params.push(input.priority);
+  }
+  if (input.model !== undefined) {
+    sets.push("model = ?");
+    params.push(input.model);
+  }
+  if (input.timeoutMs !== undefined) {
+    sets.push("timeout_ms = ?");
+    params.push(input.timeoutMs);
+  }
+  if (input.targetPath !== undefined) {
+    sets.push("target_path = ?");
+    params.push(input.targetPath);
+  }
+  if (input.requiresAuth !== undefined) {
+    sets.push("requires_auth = ?");
+    params.push(input.requiresAuth ? 1 : 0);
+  }
+  if (input.authConfig !== undefined) {
+    sets.push("auth_config = ?");
+    params.push(JSON.stringify(input.authConfig));
+  }
+  if (input.metadata !== undefined) {
+    sets.push("metadata = ?");
+    params.push(JSON.stringify(input.metadata));
+  }
+  if (input.assertions !== undefined) {
+    sets.push("assertions = ?");
+    params.push(JSON.stringify(input.assertions));
+  }
+  if (sets.length === 0) {
+    return existing;
+  }
+  sets.push("version = ?");
+  params.push(version + 1);
+  sets.push("updated_at = ?");
+  params.push(now());
+  params.push(existing.id);
+  params.push(version);
+  const result = db2.query(`UPDATE scenarios SET ${sets.join(", ")} WHERE id = ? AND version = ?`).run(...params);
+  if (result.changes === 0) {
+    throw new VersionConflictError("scenario", existing.id);
+  }
+  return getScenario(existing.id);
+}
+function deleteScenario(id) {
+  const db2 = getDatabase();
+  const scenario = getScenario(id);
+  if (!scenario)
+    return false;
+  const result = db2.query("DELETE FROM scenarios WHERE id = ?").run(scenario.id);
+  return result.changes > 0;
+}
+var init_scenarios = __esm(() => {
+  init_types();
+  init_database();
+});
+
 // src/db/runs.ts
 var exports_runs = {};
 __export(exports_runs, {
@@ -2580,6 +2771,10 @@ function updateRun(id, updates) {
     sets.push("metadata = ?");
     params.push(updates.metadata);
   }
+  if (updates.is_baseline !== undefined) {
+    sets.push("is_baseline = ?");
+    params.push(updates.is_baseline);
+  }
   if (sets.length === 0) {
     return existing;
   }
@@ -2751,194 +2946,287 @@ var init_flows = __esm(() => {
   init_types();
 });
 
-// node_modules/commander/esm.mjs
-var import__ = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  Command,
-  Argument,
-  Option,
-  Help
-} = import__.default;
-
-// src/cli/index.tsx
-import chalk4 from "chalk";
-import { readFileSync as readFileSync4, readdirSync, writeFileSync as writeFileSync3 } from "fs";
-import { join as join6, resolve } from "path";
-
-// src/db/scenarios.ts
-init_types();
-init_database();
-function nextShortId(projectId) {
-  const db2 = getDatabase();
-  if (projectId) {
-    const project = db2.query("SELECT scenario_prefix, scenario_counter FROM projects WHERE id = ?").get(projectId);
-    if (project) {
-      const next = project.scenario_counter + 1;
-      db2.query("UPDATE projects SET scenario_counter = ? WHERE id = ?").run(next, projectId);
-      return `${project.scenario_prefix}-${next}`;
+// src/lib/openapi-import.ts
+var exports_openapi_import = {};
+__export(exports_openapi_import, {
+  parseOpenAPISpec: () => parseOpenAPISpec,
+  importFromOpenAPI: () => importFromOpenAPI
+});
+import { readFileSync as readFileSync5 } from "fs";
+function parseSpec(content) {
+  try {
+    return JSON.parse(content);
+  } catch {
+    throw new Error("Only JSON specs are supported. Convert YAML to JSON first: `cat spec.yaml | python -c 'import sys,yaml,json; json.dump(yaml.safe_load(sys.stdin),sys.stdout)' > spec.json`");
+  }
+}
+function methodPriority(method) {
+  switch (method.toUpperCase()) {
+    case "GET":
+      return "medium";
+    case "POST":
+      return "high";
+    case "PUT":
+      return "high";
+    case "DELETE":
+      return "critical";
+    case "PATCH":
+      return "medium";
+    default:
+      return "low";
+  }
+}
+function parseOpenAPISpec(filePathOrUrl) {
+  let content;
+  if (filePathOrUrl.startsWith("http")) {
+    throw new Error("URL fetching not supported yet. Download the spec file first.");
+  }
+  content = readFileSync5(filePathOrUrl, "utf-8");
+  const spec = parseSpec(content);
+  const isOpenAPI3 = !!spec.openapi;
+  const isSwagger2 = !!spec.swagger;
+  if (!isOpenAPI3 && !isSwagger2) {
+    throw new Error("Not a valid OpenAPI 3.x or Swagger 2.0 spec");
+  }
+  const scenarios = [];
+  const paths = spec.paths ?? {};
+  for (const [path, methods] of Object.entries(paths)) {
+    for (const [method, operation] of Object.entries(methods)) {
+      if (["get", "post", "put", "delete", "patch"].indexOf(method.toLowerCase()) === -1)
+        continue;
+      const op = operation;
+      const name = op.summary ?? op.operationId ?? `${method.toUpperCase()} ${path}`;
+      const tags = op.tags ?? [];
+      const requiresAuth = !!(op.security?.length ?? spec.security?.length);
+      const steps = [];
+      steps.push(`Navigate to the API endpoint: ${method.toUpperCase()} ${path}`);
+      if (op.parameters?.length) {
+        const required = op.parameters.filter((p) => p.required);
+        if (required.length > 0) {
+          steps.push(`Fill required parameters: ${required.map((p) => p.name).join(", ")}`);
+        }
+      }
+      if (["post", "put", "patch"].includes(method.toLowerCase())) {
+        steps.push("Fill the request body with valid test data");
+      }
+      steps.push("Submit the request");
+      const responses = op.responses ?? {};
+      const successCodes = Object.keys(responses).filter((c) => c.startsWith("2"));
+      if (successCodes.length > 0) {
+        steps.push(`Verify response status is ${successCodes.join(" or ")}`);
+      } else {
+        steps.push("Verify the response is successful");
+      }
+      const description = [
+        op.description ?? `Test the ${method.toUpperCase()} ${path} endpoint.`,
+        requiresAuth ? "This endpoint requires authentication." : ""
+      ].filter(Boolean).join(" ");
+      scenarios.push({
+        name,
+        description,
+        steps,
+        tags: [...tags, "api", method.toLowerCase()],
+        priority: methodPriority(method),
+        targetPath: path,
+        requiresAuth
+      });
     }
   }
-  return shortUuid();
-}
-function createScenario(input) {
-  const db2 = getDatabase();
-  const id = uuid();
-  const short_id = nextShortId(input.projectId);
-  const timestamp = now();
-  db2.query(`
-    INSERT INTO scenarios (id, short_id, project_id, name, description, steps, tags, priority, model, timeout_ms, target_path, requires_auth, auth_config, metadata, version, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
-  `).run(id, short_id, input.projectId ?? null, input.name, input.description, JSON.stringify(input.steps ?? []), JSON.stringify(input.tags ?? []), input.priority ?? "medium", input.model ?? null, input.timeoutMs ?? null, input.targetPath ?? null, input.requiresAuth ? 1 : 0, input.authConfig ? JSON.stringify(input.authConfig) : null, input.metadata ? JSON.stringify(input.metadata) : null, timestamp, timestamp);
-  return getScenario(id);
-}
-function getScenario(id) {
-  const db2 = getDatabase();
-  let row = db2.query("SELECT * FROM scenarios WHERE id = ?").get(id);
-  if (row)
-    return scenarioFromRow(row);
-  row = db2.query("SELECT * FROM scenarios WHERE short_id = ?").get(id);
-  if (row)
-    return scenarioFromRow(row);
-  const fullId = resolvePartialId("scenarios", id);
-  if (fullId) {
-    row = db2.query("SELECT * FROM scenarios WHERE id = ?").get(fullId);
-    if (row)
-      return scenarioFromRow(row);
-  }
-  return null;
+  return scenarios;
 }
-function getScenarioByShortId(shortId) {
-  const db2 = getDatabase();
-  const row = db2.query("SELECT * FROM scenarios WHERE short_id = ?").get(shortId);
-  return row ? scenarioFromRow(row) : null;
+function importFromOpenAPI(filePathOrUrl, projectId) {
+  const inputs = parseOpenAPISpec(filePathOrUrl);
+  const scenarios = inputs.map((input) => createScenario({ ...input, projectId }));
+  return { imported: scenarios.length, scenarios };
 }
-function listScenarios(filter) {
-  const db2 = getDatabase();
-  const conditions = [];
-  const params = [];
-  if (filter?.projectId) {
-    conditions.push("project_id = ?");
-    params.push(filter.projectId);
-  }
-  if (filter?.tags && filter.tags.length > 0) {
-    for (const tag of filter.tags) {
-      conditions.push("tags LIKE ?");
-      params.push(`%"${tag}"%`);
+var init_openapi_import = __esm(() => {
+  init_scenarios();
+});
+
+// src/lib/recorder.ts
+var exports_recorder = {};
+__export(exports_recorder, {
+  recordSession: () => recordSession,
+  recordAndSave: () => recordAndSave,
+  actionsToScenarioInput: () => actionsToScenarioInput
+});
+import { chromium as chromium2 } from "playwright";
+async function recordSession(url, options) {
+  const browser = await chromium2.launch({ headless: false });
+  const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });
+  const page = await context.newPage();
+  const actions = [];
+  const startTime = Date.now();
+  const timeout = options?.timeout ?? 300000;
+  page.on("framenavigated", (frame) => {
+    if (frame === page.mainFrame()) {
+      actions.push({ type: "navigate", url: frame.url(), timestamp: Date.now() - startTime });
+    }
+  });
+  await page.addInitScript(() => {
+    document.addEventListener("click", (e) => {
+      const target = e.target;
+      const selector = buildSelector(target);
+      window.postMessage({ __testers_action: "click", selector }, "*");
+    }, true);
+    document.addEventListener("input", (e) => {
+      const target = e.target;
+      const selector = buildSelector(target);
+      window.postMessage({ __testers_action: "fill", selector, value: target.value }, "*");
+    }, true);
+    document.addEventListener("change", (e) => {
+      const target = e.target;
+      if (target.tagName === "SELECT") {
+        const selector = buildSelector(target);
+        window.postMessage({ __testers_action: "select", selector, value: target.value }, "*");
+      }
+    }, true);
+    document.addEventListener("keydown", (e) => {
+      if (["Enter", "Tab", "Escape"].includes(e.key)) {
+        window.postMessage({ __testers_action: "press", key: e.key }, "*");
+      }
+    }, true);
+    function buildSelector(el) {
+      if (el.id)
+        return `#${el.id}`;
+      if (el.getAttribute("data-testid"))
+        return `[data-testid="${el.getAttribute("data-testid")}"]`;
+      if (el.getAttribute("name"))
+        return `${el.tagName.toLowerCase()}[name="${el.getAttribute("name")}"]`;
+      if (el.getAttribute("aria-label"))
+        return `[aria-label="${el.getAttribute("aria-label")}"]`;
+      if (el.className && typeof el.className === "string") {
+        const classes = el.className.trim().split(/\s+/).slice(0, 2).join(".");
+        if (classes)
+          return `${el.tagName.toLowerCase()}.${classes}`;
+      }
+      const text = el.textContent?.trim().slice(0, 30);
+      if (text)
+        return `text="${text}"`;
+      return el.tagName.toLowerCase();
+    }
+  });
+  const pollInterval = setInterval(async () => {
+    try {
+      const newActions = await page.evaluate(() => {
+        const collected = window.__testers_collected ?? [];
+        window.__testers_collected = [];
+        return collected;
+      });
+      for (const a of newActions) {
+        actions.push({
+          type: a["type"],
+          selector: a["selector"],
+          value: a["value"],
+          key: a["key"],
+          timestamp: Date.now() - startTime
+        });
+      }
+    } catch {}
+  }, 500);
+  await page.exposeFunction("__testersRecord", (action) => {
+    actions.push({ ...action, timestamp: Date.now() - startTime });
+  });
+  await page.addInitScript(() => {
+    window.addEventListener("message", (e) => {
+      if (e.data?.__testers_action) {
+        const { __testers_action, ...rest } = e.data;
+        window.__testersRecord({ type: __testers_action, ...rest });
+      }
+    });
+  });
+  await page.goto(url);
+  actions.push({ type: "navigate", url, timestamp: 0 });
+  console.log(`
+  Recording started. Interact with the browser.`);
+  console.log(`  Close the browser window or wait ${timeout / 1000}s to stop.
+`);
+  await Promise.race([
+    page.waitForEvent("close").catch(() => {}),
+    context.waitForEvent("close").catch(() => {}),
+    new Promise((resolve) => setTimeout(resolve, timeout))
+  ]);
+  clearInterval(pollInterval);
+  try {
+    await browser.close();
+  } catch {}
+  return {
+    actions,
+    url,
+    duration: Date.now() - startTime
+  };
+}
+function actionsToScenarioInput(recording, name, projectId) {
+  const steps = [];
+  const seenFills = new Map;
+  for (const action of recording.actions) {
+    switch (action.type) {
+      case "navigate":
+        if (action.url)
+          steps.push(`Navigate to ${action.url}`);
+        break;
+      case "click":
+        if (action.selector)
+          steps.push(`Click ${action.selector}`);
+        break;
+      case "fill":
+        if (action.selector && action.value) {
+          seenFills.set(action.selector, action.value);
+        }
+        break;
+      case "select":
+        if (action.selector && action.value)
+          steps.push(`Select "${action.value}" in ${action.selector}`);
+        break;
+      case "press":
+        if (action.key)
+          steps.push(`Press ${action.key}`);
+        break;
     }
   }
-  if (filter?.priority) {
-    conditions.push("priority = ?");
-    params.push(filter.priority);
-  }
-  if (filter?.search) {
-    conditions.push("(name LIKE ? OR description LIKE ?)");
-    const term = `%${filter.search}%`;
-    params.push(term, term);
-  }
-  let sql = "SELECT * FROM scenarios";
-  if (conditions.length > 0) {
-    sql += " WHERE " + conditions.join(" AND ");
-  }
-  sql += " ORDER BY created_at DESC";
-  if (filter?.limit) {
-    sql += " LIMIT ?";
-    params.push(filter.limit);
-  }
-  if (filter?.offset) {
-    sql += " OFFSET ?";
-    params.push(filter.offset);
-  }
-  const rows = db2.query(sql).all(...params);
-  return rows.map(scenarioFromRow);
-}
-function updateScenario(id, input, version) {
-  const db2 = getDatabase();
-  const existing = getScenario(id);
-  if (!existing) {
-    throw new Error(`Scenario not found: ${id}`);
-  }
-  if (existing.version !== version) {
-    throw new VersionConflictError("scenario", existing.id);
-  }
-  const sets = [];
-  const params = [];
-  if (input.name !== undefined) {
-    sets.push("name = ?");
-    params.push(input.name);
-  }
-  if (input.description !== undefined) {
-    sets.push("description = ?");
-    params.push(input.description);
-  }
-  if (input.steps !== undefined) {
-    sets.push("steps = ?");
-    params.push(JSON.stringify(input.steps));
-  }
-  if (input.tags !== undefined) {
-    sets.push("tags = ?");
-    params.push(JSON.stringify(input.tags));
-  }
-  if (input.priority !== undefined) {
-    sets.push("priority = ?");
-    params.push(input.priority);
-  }
-  if (input.model !== undefined) {
-    sets.push("model = ?");
-    params.push(input.model);
-  }
-  if (input.timeoutMs !== undefined) {
-    sets.push("timeout_ms = ?");
-    params.push(input.timeoutMs);
-  }
-  if (input.targetPath !== undefined) {
-    sets.push("target_path = ?");
-    params.push(input.targetPath);
-  }
-  if (input.requiresAuth !== undefined) {
-    sets.push("requires_auth = ?");
-    params.push(input.requiresAuth ? 1 : 0);
-  }
-  if (input.authConfig !== undefined) {
-    sets.push("auth_config = ?");
-    params.push(JSON.stringify(input.authConfig));
-  }
-  if (input.metadata !== undefined) {
-    sets.push("metadata = ?");
-    params.push(JSON.stringify(input.metadata));
-  }
-  if (sets.length === 0) {
-    return existing;
-  }
-  sets.push("version = ?");
-  params.push(version + 1);
-  sets.push("updated_at = ?");
-  params.push(now());
-  params.push(existing.id);
-  params.push(version);
-  const result = db2.query(`UPDATE scenarios SET ${sets.join(", ")} WHERE id = ? AND version = ?`).run(...params);
-  if (result.changes === 0) {
-    throw new VersionConflictError("scenario", existing.id);
+  for (const [selector, value] of seenFills) {
+    steps.push(`Fill ${selector} with "${value}"`);
   }
-  return getScenario(existing.id);
+  return {
+    name,
+    description: `Recorded session on ${recording.url} (${(recording.duration / 1000).toFixed(0)}s, ${recording.actions.length} actions)`,
+    steps,
+    tags: ["recorded"],
+    projectId
+  };
 }
-function deleteScenario(id) {
-  const db2 = getDatabase();
-  const scenario = getScenario(id);
-  if (!scenario)
-    return false;
-  const result = db2.query("DELETE FROM scenarios WHERE id = ?").run(scenario.id);
-  return result.changes > 0;
+async function recordAndSave(url, name, projectId) {
+  const recording = await recordSession(url);
+  const input = actionsToScenarioInput(recording, name, projectId);
+  const scenario = createScenario(input);
+  return { recording, scenario };
 }
+var init_recorder = __esm(() => {
+  init_scenarios();
+});
+
+// node_modules/commander/esm.mjs
+var import__ = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  Command,
+  Argument,
+  Option,
+  Help
+} = import__.default;
 
 // src/cli/index.tsx
+init_scenarios();
 init_runs();
+import chalk5 from "chalk";
+import { readFileSync as readFileSync6, readdirSync, writeFileSync as writeFileSync3 } from "fs";
+import { join as join6, resolve } from "path";
 
 // src/db/results.ts
 init_types();
@@ -3044,6 +3332,7 @@ function listScreenshots(resultId) {
 
 // src/lib/runner.ts
 init_runs();
+init_scenarios();
 
 // src/lib/browser.ts
 init_types();
@@ -4025,6 +4314,104 @@ function loadConfig() {
   return config;
 }
 
+// src/lib/webhooks.ts
+init_database();
+function fromRow(row) {
+  return {
+    id: row.id,
+    url: row.url,
+    events: JSON.parse(row.events),
+    projectId: row.project_id,
+    secret: row.secret,
+    active: row.active === 1,
+    createdAt: row.created_at
+  };
+}
+function listWebhooks(projectId) {
+  const db2 = getDatabase();
+  let query = "SELECT * FROM webhooks WHERE active = 1";
+  const params = [];
+  if (projectId) {
+    query += " AND (project_id = ? OR project_id IS NULL)";
+    params.push(projectId);
+  }
+  query += " ORDER BY created_at DESC";
+  const rows = db2.query(query).all(...params);
+  return rows.map(fromRow);
+}
+function signPayload(body, secret) {
+  const encoder = new TextEncoder;
+  const key = encoder.encode(secret);
+  const data = encoder.encode(body);
+  let hash = 0;
+  for (let i = 0;i < data.length; i++) {
+    hash = (hash << 5) - hash + data[i] + (key[i % key.length] ?? 0) | 0;
+  }
+  return `sha256=${Math.abs(hash).toString(16).padStart(16, "0")}`;
+}
+function formatSlackPayload(payload) {
+  const status = payload.run.status === "passed" ? ":white_check_mark:" : ":x:";
+  const color = payload.run.status === "passed" ? "#22c55e" : "#ef4444";
+  return {
+    attachments: [
+      {
+        color,
+        blocks: [
+          {
+            type: "section",
+            text: {
+              type: "mrkdwn",
+              text: `${status} *Test Run ${payload.run.status.toUpperCase()}*
+` + `URL: ${payload.run.url}
+` + `Results: ${payload.run.passed}/${payload.run.total} passed` + (payload.run.failed > 0 ? ` (${payload.run.failed} failed)` : "") + (payload.schedule ? `
+Schedule: ${payload.schedule.name}` : "")
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
+async function dispatchWebhooks(event, run, schedule) {
+  const webhooks = listWebhooks(run.projectId ?? undefined);
+  const payload = {
+    event,
+    run: {
+      id: run.id,
+      url: run.url,
+      status: run.status,
+      passed: run.passed,
+      failed: run.failed,
+      total: run.total
+    },
+    schedule,
+    timestamp: new Date().toISOString()
+  };
+  for (const webhook of webhooks) {
+    if (!webhook.events.includes(event) && !webhook.events.includes("*"))
+      continue;
+    const isSlack = webhook.url.includes("hooks.slack.com");
+    const body = isSlack ? JSON.stringify(formatSlackPayload(payload)) : JSON.stringify(payload);
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (webhook.secret) {
+      headers["X-Testers-Signature"] = signPayload(body, webhook.secret);
+    }
+    try {
+      const response = await fetch(webhook.url, {
+        method: "POST",
+        headers,
+        body
+      });
+      if (!response.ok) {
+        await new Promise((r) => setTimeout(r, 5000));
+        await fetch(webhook.url, { method: "POST", headers, body });
+      }
+    } catch {}
+  }
+}
+
 // src/lib/runner.ts
 var eventHandler = null;
 function onRunEvent(handler) {
@@ -4034,6 +4421,20 @@ function emit(event) {
   if (eventHandler)
     eventHandler(event);
 }
+function withTimeout(promise, ms, label) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      reject(new Error(`Scenario timeout after ${ms}ms: ${label}`));
+    }, ms);
+    promise.then((val) => {
+      clearTimeout(timer);
+      resolve(val);
+    }, (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
 async function runSingleScenario(scenario, runId, options) {
   const config = loadConfig();
   const model = resolveModel(options.model ?? scenario.model ?? config.defaultModel);
@@ -4056,8 +4457,9 @@ async function runSingleScenario(scenario, runId, options) {
       viewport: config.browser.viewport
     });
     const targetUrl = scenario.targetPath ? `${options.url.replace(/\/$/, "")}${scenario.targetPath}` : options.url;
-    await page.goto(targetUrl, { timeout: options.timeout ?? config.browser.timeout });
-    const agentResult = await runAgentLoop({
+    const scenarioTimeout = scenario.timeoutMs ?? options.timeout ?? config.browser.timeout ?? 60000;
+    await page.goto(targetUrl, { timeout: Math.min(scenarioTimeout, 30000) });
+    const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
       scenario,
@@ -4078,7 +4480,7 @@ async function runSingleScenario(scenario, runId, options) {
           stepNumber: stepEvent.stepNumber
         });
       }
-    });
+    }), scenarioTimeout, scenario.name);
     for (const ss of agentResult.screenshots) {
       createScreenshot({
         resultId: result.id,
@@ -4210,6 +4612,8 @@ async function runBatch(scenarios, options) {
     finished_at: new Date().toISOString()
   });
   emit({ type: "run:complete", runId: run.id });
+  const eventType = finalRun.status === "failed" ? "failed" : "completed";
+  dispatchWebhooks(eventType, finalRun).catch(() => {});
   return { run: finalRun, results };
 }
 async function runByFilter(options) {
@@ -4295,6 +4699,9 @@ function startRunAsync(options) {
         finished_at: new Date().toISOString()
       });
       emit({ type: "run:complete", runId: run.id });
+      const asyncRun = getRun(run.id);
+      if (asyncRun)
+        dispatchWebhooks(asyncRun.status === "failed" ? "failed" : "completed", asyncRun).catch(() => {});
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
       updateRun(run.id, {
@@ -4302,6 +4709,9 @@ function startRunAsync(options) {
         finished_at: new Date().toISOString()
       });
       emit({ type: "run:complete", runId: run.id, error: errorMsg });
+      const failedRun = getRun(run.id);
+      if (failedRun)
+        dispatchWebhooks("failed", failedRun).catch(() => {});
     }
   })();
   return { runId: run.id, scenarioCount: scenarios.length };
@@ -4318,6 +4728,7 @@ function estimateCost(model, tokens) {
 
 // src/lib/reporter.ts
 import chalk from "chalk";
+init_scenarios();
 function formatTerminal(run, results) {
   const lines = [];
   lines.push("");
@@ -4471,11 +4882,12 @@ function formatScenarioList(scenarios) {
 }
 
 // src/lib/todos-connector.ts
+init_scenarios();
+init_types();
 import { Database as Database2 } from "bun:sqlite";
 import { existsSync as existsSync4 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir4 } from "os";
-init_types();
 function resolveTodosDbPath() {
   const envPath = process.env["TODOS_DB_PATH"];
   if (envPath)
@@ -4573,6 +4985,7 @@ function importFromTodos(options = {}) {
 }
 
 // src/lib/init.ts
+init_scenarios();
 import { existsSync as existsSync5, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3 } from "fs";
 import { join as join5, basename } from "path";
 import { homedir as homedir5 } from "os";
@@ -4730,6 +5143,7 @@ function initProject(options) {
 }
 
 // src/lib/smoke.ts
+init_scenarios();
 init_runs();
 var SMOKE_DESCRIPTION = `You are performing an autonomous smoke test of this web application. Your job is to explore as many pages as possible and find issues. Follow these instructions:
 
@@ -4951,6 +5365,7 @@ function formatSmokeReport(result) {
 // src/lib/diff.ts
 init_runs();
 import chalk2 from "chalk";
+init_scenarios();
 function diffRuns(runId1, runId2) {
   const run1 = getRun(runId1);
   if (!run1) {
@@ -5096,14 +5511,145 @@ function formatDiffJSON(diff) {
   return JSON.stringify(diff, null, 2);
 }
 
+// src/lib/visual-diff.ts
+import { readFileSync as readFileSync3, existsSync as existsSync6 } from "fs";
+import chalk3 from "chalk";
+init_runs();
+init_scenarios();
+init_database();
+var DEFAULT_THRESHOLD = 0.1;
+function setBaseline(runId) {
+  const run = getRun(runId);
+  if (!run) {
+    throw new Error(`Run not found: ${runId}`);
+  }
+  const db2 = getDatabase();
+  if (run.projectId) {
+    db2.query("UPDATE runs SET is_baseline = 0 WHERE project_id = ? AND is_baseline = 1").run(run.projectId);
+  } else {
+    db2.query("UPDATE runs SET is_baseline = 0 WHERE project_id IS NULL AND is_baseline = 1").run();
+  }
+  updateRun(run.id, { is_baseline: 1 });
+}
+function compareImages(image1Path, image2Path) {
+  if (!existsSync6(image1Path)) {
+    throw new Error(`Baseline image not found: ${image1Path}`);
+  }
+  if (!existsSync6(image2Path)) {
+    throw new Error(`Current image not found: ${image2Path}`);
+  }
+  const buf1 = readFileSync3(image1Path);
+  const buf2 = readFileSync3(image2Path);
+  if (buf1.equals(buf2)) {
+    const estimatedPixels = Math.max(1, Math.floor(buf1.length / 4));
+    return { diffPercent: 0, diffPixels: 0, totalPixels: estimatedPixels };
+  }
+  if (buf1.length !== buf2.length) {
+    const maxLen = Math.max(buf1.length, buf2.length);
+    const estimatedPixels = Math.max(1, Math.floor(maxLen / 4));
+    return { diffPercent: 100, diffPixels: estimatedPixels, totalPixels: estimatedPixels };
+  }
+  let diffBytes = 0;
+  for (let i = 0;i < buf1.length; i++) {
+    if (buf1[i] !== buf2[i]) {
+      diffBytes++;
+    }
+  }
+  const totalPixels = Math.max(1, Math.floor(buf1.length / 4));
+  const diffPixels = Math.max(1, Math.floor(diffBytes / 4));
+  const diffPercent = parseFloat((diffBytes / buf1.length * 100).toFixed(4));
+  return { diffPercent, diffPixels, totalPixels };
+}
+function compareRunScreenshots(runId, baselineRunId, threshold = DEFAULT_THRESHOLD) {
+  const run = getRun(runId);
+  if (!run)
+    throw new Error(`Run not found: ${runId}`);
+  const baselineRun = getRun(baselineRunId);
+  if (!baselineRun)
+    throw new Error(`Baseline run not found: ${baselineRunId}`);
+  const currentResults = getResultsByRun(run.id);
+  const baselineResults = getResultsByRun(baselineRun.id);
+  const baselineMap = new Map;
+  for (const result of baselineResults) {
+    const screenshots = listScreenshots(result.id);
+    for (const ss of screenshots) {
+      const key = `${result.scenarioId}:${ss.stepNumber}`;
+      baselineMap.set(key, { path: ss.filePath, action: ss.action });
+    }
+  }
+  const results = [];
+  for (const result of currentResults) {
+    const screenshots = listScreenshots(result.id);
+    for (const ss of screenshots) {
+      const key = `${result.scenarioId}:${ss.stepNumber}`;
+      const baseline = baselineMap.get(key);
+      if (!baseline)
+        continue;
+      if (!existsSync6(baseline.path) || !existsSync6(ss.filePath))
+        continue;
+      try {
+        const comparison = compareImages(baseline.path, ss.filePath);
+        results.push({
+          scenarioId: result.scenarioId,
+          stepNumber: ss.stepNumber,
+          action: ss.action,
+          baselinePath: baseline.path,
+          currentPath: ss.filePath,
+          diffPercent: comparison.diffPercent,
+          isRegression: comparison.diffPercent > threshold
+        });
+      } catch {}
+    }
+  }
+  return results;
+}
+function formatVisualDiffTerminal(results, threshold = DEFAULT_THRESHOLD) {
+  if (results.length === 0) {
+    return chalk3.dim(`
+  No screenshot comparisons found.
+`);
+  }
+  const lines = [];
+  lines.push("");
+  lines.push(chalk3.bold("  Visual Regression Summary"));
+  lines.push("");
+  const regressions = results.filter((r) => r.diffPercent >= threshold);
+  const passed = results.filter((r) => r.diffPercent < threshold);
+  if (regressions.length > 0) {
+    lines.push(chalk3.red.bold(`  Regressions (${regressions.length}):`));
+    for (const r of regressions) {
+      const scenario = getScenario(r.scenarioId);
+      const label = scenario ? `${scenario.shortId}: ${scenario.name}` : r.scenarioId.slice(0, 8);
+      const pct = chalk3.red(`${r.diffPercent.toFixed(2)}%`);
+      lines.push(`    ${chalk3.red("!")} ${label} step ${r.stepNumber} (${r.action}) \u2014 ${pct} diff`);
+    }
+    lines.push("");
+  }
+  if (passed.length > 0) {
+    lines.push(chalk3.green.bold(`  Passed (${passed.length}):`));
+    for (const r of passed) {
+      const scenario = getScenario(r.scenarioId);
+      const label = scenario ? `${scenario.shortId}: ${scenario.name}` : r.scenarioId.slice(0, 8);
+      const pct = chalk3.green(`${r.diffPercent.toFixed(2)}%`);
+      lines.push(`    ${chalk3.green("\u2713")} ${label} step ${r.stepNumber} (${r.action}) \u2014 ${pct} diff`);
+    }
+    lines.push("");
+  }
+  lines.push(chalk3.bold(`  Visual Summary: ${regressions.length} regressions, ${passed.length} passed (threshold: ${threshold}%)`));
+  lines.push("");
+  return lines.join(`
+`);
+}
+
 // src/lib/report.ts
 init_runs();
-import { readFileSync as readFileSync3, existsSync as existsSync6 } from "fs";
+import { readFileSync as readFileSync4, existsSync as existsSync7 } from "fs";
+init_scenarios();
 function imageToBase64(filePath) {
-  if (!filePath || !existsSync6(filePath))
+  if (!filePath || !existsSync7(filePath))
     return "";
   try {
-    const buffer = readFileSync3(filePath);
+    const buffer = readFileSync4(filePath);
     const base64 = buffer.toString("base64");
     return `data:image/png;base64,${base64}`;
   } catch {
@@ -5297,7 +5843,7 @@ function generateLatestReport() {
 
 // src/lib/costs.ts
 init_database();
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 function getDateFilter(period) {
   switch (period) {
     case "day":
@@ -5402,15 +5948,15 @@ function formatTokens(tokens) {
 function formatCostsTerminal(summary) {
   const lines = [];
   lines.push("");
-  lines.push(chalk3.bold(`  Cost Summary (${summary.period})`));
+  lines.push(chalk4.bold(`  Cost Summary (${summary.period})`));
   lines.push("");
-  lines.push(`  Total:     ${chalk3.yellow(formatDollars(summary.totalCostCents))} (${formatTokens(summary.totalTokens)} tokens across ${summary.runCount} runs)`);
-  lines.push(`  Avg/run:   ${chalk3.yellow(formatDollars(summary.avgCostPerRun))}`);
-  lines.push(`  Est/month: ${chalk3.yellow(formatDollars(summary.estimatedMonthlyCents))}`);
+  lines.push(`  Total:     ${chalk4.yellow(formatDollars(summary.totalCostCents))} (${formatTokens(summary.totalTokens)} tokens across ${summary.runCount} runs)`);
+  lines.push(`  Avg/run:   ${chalk4.yellow(formatDollars(summary.avgCostPerRun))}`);
+  lines.push(`  Est/month: ${chalk4.yellow(formatDollars(summary.estimatedMonthlyCents))}`);
   const modelEntries = Object.entries(summary.byModel);
   if (modelEntries.length > 0) {
     lines.push("");
-    lines.push(chalk3.bold("  By Model"));
+    lines.push(chalk4.bold("  By Model"));
     lines.push(`  ${"Model".padEnd(40)} ${"Cost".padEnd(12)} ${"Tokens".padEnd(12)} Runs`);
     lines.push(`  ${"\u2500".repeat(40)} ${"\u2500".repeat(12)} ${"\u2500".repeat(12)} ${"\u2500".repeat(6)}`);
     for (const [model, data] of modelEntries) {
@@ -5419,7 +5965,7 @@ function formatCostsTerminal(summary) {
   }
   if (summary.byScenario.length > 0) {
     lines.push("");
-    lines.push(chalk3.bold("  Top Scenarios by Cost"));
+    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)}`);
     for (const s of summary.byScenario) {
@@ -5588,7 +6134,7 @@ function listTemplateNames() {
 
 // src/db/auth-presets.ts
 init_database();
-function fromRow(row) {
+function fromRow2(row) {
   return {
     id: row.id,
     name: row.name,
@@ -5612,12 +6158,12 @@ function createAuthPreset(input) {
 function getAuthPreset(name) {
   const db2 = getDatabase();
   const row = db2.query("SELECT * FROM auth_presets WHERE name = ?").get(name);
-  return row ? fromRow(row) : null;
+  return row ? fromRow2(row) : null;
 }
 function listAuthPresets() {
   const db2 = getDatabase();
   const rows = db2.query("SELECT * FROM auth_presets ORDER BY created_at DESC").all();
-  return rows.map(fromRow);
+  return rows.map(fromRow2);
 }
 function deleteAuthPreset(name) {
   const db2 = getDatabase();
@@ -5627,7 +6173,155 @@ function deleteAuthPreset(name) {
 
 // src/cli/index.tsx
 init_flows();
-import { existsSync as existsSync7, mkdirSync as mkdirSync4 } from "fs";
+
+// src/db/environments.ts
+init_database();
+function fromRow3(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    url: row.url,
+    authPresetName: row.auth_preset_name,
+    projectId: row.project_id,
+    isDefault: row.is_default === 1,
+    createdAt: row.created_at
+  };
+}
+function createEnvironment(input) {
+  const db2 = getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  db2.query(`
+    INSERT INTO environments (id, name, url, auth_preset_name, project_id, is_default, metadata, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, '{}', ?)
+  `).run(id, input.name, input.url, input.authPresetName ?? null, input.projectId ?? null, input.isDefault ? 1 : 0, timestamp);
+  return getEnvironment(input.name);
+}
+function getEnvironment(name) {
+  const db2 = getDatabase();
+  const row = db2.query("SELECT * FROM environments WHERE name = ?").get(name);
+  return row ? fromRow3(row) : null;
+}
+function listEnvironments(projectId) {
+  const db2 = getDatabase();
+  if (projectId) {
+    const rows2 = db2.query("SELECT * FROM environments WHERE project_id = ? ORDER BY is_default DESC, created_at DESC").all(projectId);
+    return rows2.map(fromRow3);
+  }
+  const rows = db2.query("SELECT * FROM environments ORDER BY is_default DESC, created_at DESC").all();
+  return rows.map(fromRow3);
+}
+function deleteEnvironment(name) {
+  const db2 = getDatabase();
+  const result = db2.query("DELETE FROM environments WHERE name = ?").run(name);
+  return result.changes > 0;
+}
+function setDefaultEnvironment(name) {
+  const db2 = getDatabase();
+  db2.exec("UPDATE environments SET is_default = 0");
+  const result = db2.query("UPDATE environments SET is_default = 1 WHERE name = ?").run(name);
+  if (result.changes === 0) {
+    throw new Error(`Environment not found: ${name}`);
+  }
+}
+function getDefaultEnvironment() {
+  const db2 = getDatabase();
+  const row = db2.query("SELECT * FROM environments WHERE is_default = 1 LIMIT 1").get();
+  return row ? fromRow3(row) : null;
+}
+
+// src/lib/ci.ts
+function generateGitHubActionsWorkflow() {
+  return `name: AI QA Tests
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install -g @hasna/testers
+      - run: testers install-browser
+      - run: testers run \${{ env.TEST_URL }} --json --output results.json
+        env:
+          ANTHROPIC_API_KEY: \${{ secrets.ANTHROPIC_API_KEY }}
+          TEST_URL: \${{ vars.TEST_URL || 'http://localhost:3000' }}
+      - run: testers report --latest --output report.html
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-report
+          path: |
+            report.html
+            results.json
+`;
+}
+
+// src/lib/assertions.ts
+function parseAssertionString(str) {
+  const trimmed = str.trim();
+  if (trimmed === "no-console-errors") {
+    return { type: "no_console_errors", description: "No console errors" };
+  }
+  if (trimmed.startsWith("url:contains:")) {
+    const expected = trimmed.slice("url:contains:".length);
+    return { type: "url_contains", expected, description: `URL contains "${expected}"` };
+  }
+  if (trimmed.startsWith("title:contains:")) {
+    const expected = trimmed.slice("title:contains:".length);
+    return { type: "title_contains", expected, description: `Title contains "${expected}"` };
+  }
+  if (trimmed.startsWith("count:")) {
+    const rest = trimmed.slice("count:".length);
+    const eqIdx = rest.indexOf(" eq:");
+    if (eqIdx === -1) {
+      throw new Error(`Invalid count assertion format: ${str}. Expected "count:<selector> eq:<number>"`);
+    }
+    const selector = rest.slice(0, eqIdx);
+    const expected = parseInt(rest.slice(eqIdx + " eq:".length), 10);
+    return { type: "element_count", selector, expected, description: `${selector} count equals ${expected}` };
+  }
+  if (trimmed.startsWith("text:")) {
+    const rest = trimmed.slice("text:".length);
+    const containsIdx = rest.indexOf(" contains:");
+    const equalsIdx = rest.indexOf(" equals:");
+    if (containsIdx !== -1) {
+      const selector = rest.slice(0, containsIdx);
+      const expected = rest.slice(containsIdx + " contains:".length);
+      return { type: "text_contains", selector, expected, description: `${selector} text contains "${expected}"` };
+    }
+    if (equalsIdx !== -1) {
+      const selector = rest.slice(0, equalsIdx);
+      const expected = rest.slice(equalsIdx + " equals:".length);
+      return { type: "text_equals", selector, expected, description: `${selector} text equals "${expected}"` };
+    }
+    throw new Error(`Invalid text assertion format: ${str}. Expected "text:<selector> contains:<text>" or "text:<selector> equals:<text>"`);
+  }
+  if (trimmed.startsWith("selector:")) {
+    const rest = trimmed.slice("selector:".length);
+    const lastSpace = rest.lastIndexOf(" ");
+    if (lastSpace === -1) {
+      throw new Error(`Invalid selector assertion format: ${str}. Expected "selector:<selector> visible" or "selector:<selector> not-visible"`);
+    }
+    const selector = rest.slice(0, lastSpace);
+    const action = rest.slice(lastSpace + 1);
+    if (action === "visible") {
+      return { type: "visible", selector, description: `${selector} is visible` };
+    }
+    if (action === "not-visible") {
+      return { type: "not_visible", selector, description: `${selector} is not visible` };
+    }
+    throw new Error(`Unknown selector action: "${action}". Expected "visible" or "not-visible"`);
+  }
+  throw new Error(`Cannot parse assertion: "${str}". See --help for assertion formats.`);
+}
+
+// src/cli/index.tsx
+import { existsSync as existsSync8, mkdirSync as mkdirSync4 } from "fs";
 function formatToolInput(input) {
   const parts = [];
   for (const [key, value] of Object.entries(input)) {
@@ -5643,8 +6337,8 @@ var CONFIG_DIR2 = join6(process.env["HOME"] ?? "~", ".testers");
 var CONFIG_PATH2 = join6(CONFIG_DIR2, "config.json");
 function getActiveProject() {
   try {
-    if (existsSync7(CONFIG_PATH2)) {
-      const raw = JSON.parse(readFileSync4(CONFIG_PATH2, "utf-8"));
+    if (existsSync8(CONFIG_PATH2)) {
+      const raw = JSON.parse(readFileSync6(CONFIG_PATH2, "utf-8"));
       return raw.activeProject ?? undefined;
     }
   } catch {}
@@ -5659,21 +6353,25 @@ program2.command("add <name>").description("Create a new test scenario").option(
 }, []).option("-t, --tag <tag>", "Tag (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).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)").action((name, opts) => {
+}, []).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) => {
   try {
     if (opts.template) {
       const template = getTemplate(opts.template);
       if (!template) {
-        console.error(chalk4.red(`Unknown template: ${opts.template}. Available: ${listTemplateNames().join(", ")}`));
+        console.error(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(chalk4.green(`  Created ${s.shortId}: ${s.name}`));
+        console.log(chalk5.green(`  Created ${s.shortId}: ${s.name}`));
       }
       return;
     }
+    const assertions = opts.assert.map(parseAssertionString);
     const projectId = resolveProject(opts.project);
     const scenario = createScenario({
       name,
@@ -5685,11 +6383,12 @@ program2.command("add <name>").description("Create a new test scenario").option(
       targetPath: opts.path,
       requiresAuth: opts.auth,
       timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+      assertions: assertions.length > 0 ? assertions : undefined,
       projectId
     });
-    console.log(chalk4.green(`Created scenario ${chalk4.bold(scenario.shortId)}: ${scenario.name}`));
+    console.log(chalk5.green(`Created scenario ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5703,7 +6402,7 @@ program2.command("list").description("List test scenarios").option("-t, --tag <t
     });
     console.log(formatScenarioList(scenarios));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5711,33 +6410,33 @@ program2.command("show <id>").description("Show scenario details").action((id) =
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${id}`));
+      console.error(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
     console.log("");
-    console.log(chalk4.bold(`  Scenario ${scenario.shortId}`));
+    console.log(chalk5.bold(`  Scenario ${scenario.shortId}`));
     console.log(`  Name:        ${scenario.name}`);
-    console.log(`  ID:          ${chalk4.dim(scenario.id)}`);
+    console.log(`  ID:          ${chalk5.dim(scenario.id)}`);
     console.log(`  Description: ${scenario.description}`);
     console.log(`  Priority:    ${scenario.priority}`);
-    console.log(`  Model:       ${scenario.model ?? chalk4.dim("default")}`);
-    console.log(`  Tags:        ${scenario.tags.length > 0 ? scenario.tags.join(", ") : chalk4.dim("none")}`);
-    console.log(`  Path:        ${scenario.targetPath ?? chalk4.dim("none")}`);
+    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` : chalk4.dim("default")}`);
+    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 (scenario.steps.length > 0) {
       console.log("");
-      console.log(chalk4.bold("  Steps:"));
+      console.log(chalk5.bold("  Steps:"));
       for (let i = 0;i < scenario.steps.length; i++) {
         console.log(`    ${i + 1}. ${scenario.steps[i]}`);
       }
     }
     console.log("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5751,7 +6450,7 @@ program2.command("update <id>").description("Update a scenario").option("-n, --n
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${id}`));
+      console.error(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
     const updated = updateScenario(scenario.id, {
@@ -5762,9 +6461,9 @@ program2.command("update <id>").description("Update a scenario").option("-n, --n
       priority: opts.priority,
       model: opts.model
     }, scenario.version);
-    console.log(chalk4.green(`Updated scenario ${chalk4.bold(updated.shortId)}: ${updated.name}`));
+    console.log(chalk5.green(`Updated scenario ${chalk5.bold(updated.shortId)}: ${updated.name}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5772,30 +6471,50 @@ program2.command("delete <id>").description("Delete a scenario").action((id) =>
   try {
     const scenario = getScenario(id) ?? getScenarioByShortId(id);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${id}`));
+      console.error(chalk5.red(`Scenario not found: ${id}`));
       process.exit(1);
     }
     const deleted = deleteScenario(scenario.id);
     if (deleted) {
-      console.log(chalk4.green(`Deleted scenario ${scenario.shortId}: ${scenario.name}`));
+      console.log(chalk5.green(`Deleted scenario ${scenario.shortId}: ${scenario.name}`));
     } else {
-      console.error(chalk4.red(`Failed to delete scenario: ${id}`));
+      console.error(chalk5.red(`Failed to delete scenario: ${id}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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]").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).action(async (url, 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("--env <name>", "Use a named environment for the URL").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}`));
+        process.exit(1);
+      }
+      url = env.url;
+    }
+    if (!url) {
+      const defaultEnv = getDefaultEnvironment();
+      if (defaultEnv) {
+        url = defaultEnv.url;
+        console.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>'."));
+      process.exit(1);
+    }
     if (opts.fromTodos) {
       const result = importFromTodos({ projectId });
-      console.log(chalk4.blue(`Imported ${result.imported} scenarios from todos (${result.skipped} skipped)`));
+      console.log(chalk5.blue(`Imported ${result.imported} scenarios from todos (${result.skipped} skipped)`));
     }
     if (opts.background) {
       if (description) {
@@ -5812,51 +6531,51 @@ program2.command("run <url> [description]").description("Run test scenarios agai
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
         projectId
       });
-      console.log(chalk4.green(`Run started in background: ${chalk4.bold(runId.slice(0, 8))}`));
-      console.log(chalk4.dim(`  Scenarios: ${scenarioCount}`));
-      console.log(chalk4.dim(`  URL: ${url}`));
-      console.log(chalk4.dim(`  Check progress: testers results ${runId.slice(0, 8)}`));
+      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)}`));
       process.exit(0);
     }
     if (!opts.json && !opts.output) {
       onRunEvent((event) => {
         switch (event.type) {
           case "scenario:start":
-            console.log(chalk4.blue(`  [start] ${event.scenarioName ?? event.scenarioId}`));
+            console.log(chalk5.blue(`  [start] ${event.scenarioName ?? event.scenarioId}`));
             break;
           case "step:thinking":
             if (event.thinking) {
               const preview = event.thinking.length > 120 ? event.thinking.slice(0, 120) + "..." : event.thinking;
-              console.log(chalk4.dim(`    [think] ${preview}`));
+              console.log(chalk5.dim(`    [think] ${preview}`));
             }
             break;
           case "step:tool_call":
-            console.log(chalk4.cyan(`    [step ${event.stepNumber}] ${event.toolName}${event.toolInput ? ` ${formatToolInput(event.toolInput)}` : ""}`));
+            console.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(chalk4.bold(`    [result] ${event.toolResult}`));
+              console.log(chalk5.bold(`    [result] ${event.toolResult}`));
             } else {
               const resultPreview = (event.toolResult ?? "").length > 100 ? (event.toolResult ?? "").slice(0, 100) + "..." : event.toolResult ?? "";
-              console.log(chalk4.dim(`    [done]  ${resultPreview}`));
+              console.log(chalk5.dim(`    [done]  ${resultPreview}`));
             }
             break;
           case "screenshot:captured":
-            console.log(chalk4.dim(`    [screenshot] ${event.screenshotPath}`));
+            console.log(chalk5.dim(`    [screenshot] ${event.screenshotPath}`));
             break;
           case "scenario:pass":
-            console.log(chalk4.green(`  [PASS] ${event.scenarioName}`));
+            console.log(chalk5.green(`  [PASS] ${event.scenarioName}`));
             break;
           case "scenario:fail":
-            console.log(chalk4.red(`  [FAIL] ${event.scenarioName}`));
+            console.log(chalk5.red(`  [FAIL] ${event.scenarioName}`));
             break;
           case "scenario:error":
-            console.log(chalk4.yellow(`  [ERR]  ${event.scenarioName}: ${event.error}`));
+            console.log(chalk5.yellow(`  [ERR]  ${event.scenarioName}: ${event.error}`));
             break;
         }
       });
       console.log("");
-      console.log(chalk4.bold(`  Running tests against ${url}`));
+      console.log(chalk5.bold(`  Running tests against ${url}`));
       console.log("");
     }
     if (description) {
@@ -5879,7 +6598,7 @@ 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(chalk4.green(`Results written to ${opts.output}`));
+          console.log(chalk5.green(`Results written to ${opts.output}`));
         }
         if (opts.json) {
           console.log(jsonOutput);
@@ -5904,7 +6623,7 @@ 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(chalk4.green(`Results written to ${opts.output}`));
+        console.log(chalk5.green(`Results written to ${opts.output}`));
       }
       if (opts.json) {
         console.log(jsonOutput);
@@ -5914,7 +6633,7 @@ program2.command("run <url> [description]").description("Run test scenarios agai
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5926,7 +6645,7 @@ program2.command("runs").description("List past test runs").option("--status <st
     });
     console.log(formatRunList(runs));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5934,13 +6653,13 @@ program2.command("results <run-id>").description("Show results for a test run").
   try {
     const run = getRun(runId);
     if (!run) {
-      console.error(chalk4.red(`Run not found: ${runId}`));
+      console.error(chalk5.red(`Run not found: ${runId}`));
       process.exit(1);
     }
     const results = getResultsByRun(run.id);
     console.log(formatTerminal(run, results));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5951,23 +6670,23 @@ program2.command("screenshots <id>").description("List screenshots for a run or
       const results = getResultsByRun(run.id);
       let total = 0;
       console.log("");
-      console.log(chalk4.bold(`  Screenshots for run ${run.id.slice(0, 8)}`));
+      console.log(chalk5.bold(`  Screenshots for run ${run.id.slice(0, 8)}`));
       console.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(chalk4.bold(`  ${label}`));
+          console.log(chalk5.bold(`  ${label}`));
           for (const ss of screenshots2) {
-            console.log(`    ${chalk4.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk4.dim(ss.filePath)}`);
+            console.log(`    ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
             total++;
           }
           console.log("");
         }
       }
       if (total === 0) {
-        console.log(chalk4.dim("  No screenshots found."));
+        console.log(chalk5.dim("  No screenshots found."));
         console.log("");
       }
       return;
@@ -5975,18 +6694,18 @@ program2.command("screenshots <id>").description("List screenshots for a run or
     const screenshots = listScreenshots(id);
     if (screenshots.length > 0) {
       console.log("");
-      console.log(chalk4.bold(`  Screenshots for result ${id.slice(0, 8)}`));
+      console.log(chalk5.bold(`  Screenshots for result ${id.slice(0, 8)}`));
       console.log("");
       for (const ss of screenshots) {
-        console.log(`  ${chalk4.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk4.dim(ss.filePath)}`);
+        console.log(`  ${chalk5.dim(String(ss.stepNumber).padStart(3, "0"))} ${ss.action} \u2014 ${chalk5.dim(ss.filePath)}`);
       }
       console.log("");
       return;
     }
-    console.error(chalk4.red(`No screenshots found for: ${id}`));
+    console.error(chalk5.red(`No screenshots found for: ${id}`));
     process.exit(1);
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -5995,12 +6714,12 @@ 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(chalk4.dim("No .md files found in directory."));
+      console.log(chalk5.dim("No .md files found in directory."));
       return;
     }
     let imported = 0;
     for (const file of files) {
-      const content = readFileSync4(join6(absDir, file), "utf-8");
+      const content = readFileSync6(join6(absDir, file), "utf-8");
       const lines = content.split(`
 `);
       let name = file.replace(/\.md$/, "");
@@ -6025,13 +6744,13 @@ program2.command("import <dir>").description("Import markdown test files as scen
         description: descriptionLines.join(" ") || name,
         steps
       });
-      console.log(chalk4.green(`  Imported ${chalk4.bold(scenario.shortId)}: ${scenario.name}`));
+      console.log(chalk5.green(`  Imported ${chalk5.bold(scenario.shortId)}: ${scenario.name}`));
       imported++;
     }
     console.log("");
-    console.log(chalk4.green(`Imported ${imported} scenario(s) from ${absDir}`));
+    console.log(chalk5.green(`Imported ${imported} scenario(s) from ${absDir}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6040,7 +6759,7 @@ program2.command("config").description("Show current configuration").action(() =
     const config = loadConfig();
     console.log(JSON.stringify(config, null, 2));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6050,25 +6769,25 @@ program2.command("status").description("Show database and auth status").action((
     const hasApiKey = !!config.anthropicApiKey || !!process.env["ANTHROPIC_API_KEY"];
     const dbPath = join6(process.env["HOME"] ?? "~", ".testers", "testers.db");
     console.log("");
-    console.log(chalk4.bold("  Open Testers Status"));
+    console.log(chalk5.bold("  Open Testers Status"));
     console.log("");
-    console.log(`  ANTHROPIC_API_KEY: ${hasApiKey ? chalk4.green("set") : chalk4.red("not set")}`);
+    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("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 program2.command("install-browser").description("Install Playwright Chromium browser").action(async () => {
   try {
-    console.log(chalk4.blue("Installing Playwright Chromium..."));
+    console.log(chalk5.blue("Installing Playwright Chromium..."));
     await installBrowser();
-    console.log(chalk4.green("Browser installed successfully."));
+    console.log(chalk5.green("Browser installed successfully."));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6080,9 +6799,9 @@ projectCmd.command("create <name>").description("Create a new project").option("
       path: opts.path,
       description: opts.description
     });
-    console.log(chalk4.green(`Created project ${chalk4.bold(project.name)} (${project.id})`));
+    console.log(chalk5.green(`Created project ${chalk5.bold(project.name)} (${project.id})`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6090,20 +6809,20 @@ projectCmd.command("list").description("List all projects").action(() => {
   try {
     const projects = listProjects();
     if (projects.length === 0) {
-      console.log(chalk4.dim("No projects found."));
+      console.log(chalk5.dim("No projects found."));
       return;
     }
     console.log("");
-    console.log(chalk4.bold("  Projects"));
+    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)}`);
     for (const p of projects) {
-      console.log(`  ${p.id.padEnd(38)} ${p.name.padEnd(24)} ${(p.path ?? chalk4.dim("\u2014")).toString().padEnd(30)} ${p.createdAt}`);
+      console.log(`  ${p.id.padEnd(38)} ${p.name.padEnd(24)} ${(p.path ?? chalk5.dim("\u2014")).toString().padEnd(30)} ${p.createdAt}`);
     }
     console.log("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6111,39 +6830,39 @@ projectCmd.command("show <id>").description("Show project details").action((id)
   try {
     const project = getProject(id);
     if (!project) {
-      console.error(chalk4.red(`Project not found: ${id}`));
+      console.error(chalk5.red(`Project not found: ${id}`));
       process.exit(1);
     }
     console.log("");
-    console.log(chalk4.bold(`  Project: ${project.name}`));
+    console.log(chalk5.bold(`  Project: ${project.name}`));
     console.log(`  ID:          ${project.id}`);
-    console.log(`  Path:        ${project.path ?? chalk4.dim("none")}`);
-    console.log(`  Description: ${project.description ?? chalk4.dim("none")}`);
+    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("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
 projectCmd.command("use <name>").description("Set active project (find or create)").action((name) => {
   try {
     const project = ensureProject(name, process.cwd());
-    if (!existsSync7(CONFIG_DIR2)) {
+    if (!existsSync8(CONFIG_DIR2)) {
       mkdirSync4(CONFIG_DIR2, { recursive: true });
     }
     let config = {};
-    if (existsSync7(CONFIG_PATH2)) {
+    if (existsSync8(CONFIG_PATH2)) {
       try {
-        config = JSON.parse(readFileSync4(CONFIG_PATH2, "utf-8"));
+        config = JSON.parse(readFileSync6(CONFIG_PATH2, "utf-8"));
       } catch {}
     }
     config.activeProject = project.id;
     writeFileSync3(CONFIG_PATH2, JSON.stringify(config, null, 2), "utf-8");
-    console.log(chalk4.green(`Active project set to ${chalk4.bold(project.name)} (${project.id})`));
+    console.log(chalk5.green(`Active project set to ${chalk5.bold(project.name)} (${project.id})`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6168,12 +6887,12 @@ scheduleCmd.command("create <name>").description("Create a new schedule").requir
       timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
       projectId
     });
-    console.log(chalk4.green(`Created schedule ${chalk4.bold(schedule.name)} (${schedule.id})`));
+    console.log(chalk5.green(`Created schedule ${chalk5.bold(schedule.name)} (${schedule.id})`));
     if (schedule.nextRunAt) {
-      console.log(chalk4.dim(`  Next run at: ${schedule.nextRunAt}`));
+      console.log(chalk5.dim(`  Next run at: ${schedule.nextRunAt}`));
     }
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6185,23 +6904,23 @@ scheduleCmd.command("list").description("List schedules").option("--project <id>
       enabled: opts.enabled ? true : undefined
     });
     if (schedules.length === 0) {
-      console.log(chalk4.dim("No schedules found."));
+      console.log(chalk5.dim("No schedules found."));
       return;
     }
     console.log("");
-    console.log(chalk4.bold("  Schedules"));
+    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)}`);
     for (const s of schedules) {
-      const enabled = s.enabled ? chalk4.green("yes") : chalk4.red("no");
-      const nextRun = s.nextRunAt ?? chalk4.dim("\u2014");
-      const lastRun = s.lastRunAt ?? chalk4.dim("\u2014");
+      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}`);
     }
     console.log("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6209,47 +6928,47 @@ scheduleCmd.command("show <id>").description("Show schedule details").action((id
   try {
     const schedule = getSchedule(id);
     if (!schedule) {
-      console.error(chalk4.red(`Schedule not found: ${id}`));
+      console.error(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
     }
     console.log("");
-    console.log(chalk4.bold(`  Schedule: ${schedule.name}`));
+    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 ? chalk4.green("yes") : chalk4.red("no")}`);
-    console.log(`  Model:       ${schedule.model ?? chalk4.dim("default")}`);
+    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` : chalk4.dim("default")}`);
-    console.log(`  Project:     ${schedule.projectId ?? chalk4.dim("none")}`);
+    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 ?? chalk4.dim("not scheduled")}`);
-    console.log(`  Last run:    ${schedule.lastRunAt ?? chalk4.dim("never")}`);
-    console.log(`  Last run ID: ${schedule.lastRunId ?? chalk4.dim("none")}`);
+    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("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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(chalk4.green(`Enabled schedule ${chalk4.bold(schedule.name)}`));
+    console.log(chalk5.green(`Enabled schedule ${chalk5.bold(schedule.name)}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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(chalk4.green(`Disabled schedule ${chalk4.bold(schedule.name)}`));
+    console.log(chalk5.green(`Disabled schedule ${chalk5.bold(schedule.name)}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6257,13 +6976,13 @@ scheduleCmd.command("delete <id>").description("Delete a schedule").action((id)
   try {
     const deleted = deleteSchedule(id);
     if (deleted) {
-      console.log(chalk4.green(`Deleted schedule: ${id}`));
+      console.log(chalk5.green(`Deleted schedule: ${id}`));
     } else {
-      console.error(chalk4.red(`Schedule not found: ${id}`));
+      console.error(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6271,11 +6990,11 @@ scheduleCmd.command("run <id>").description("Manually trigger a schedule").optio
   try {
     const schedule = getSchedule(id);
     if (!schedule) {
-      console.error(chalk4.red(`Schedule not found: ${id}`));
+      console.error(chalk5.red(`Schedule not found: ${id}`));
       process.exit(1);
       return;
     }
-    console.log(chalk4.blue(`Running schedule ${chalk4.bold(schedule.name)} against ${schedule.url}...`));
+    console.log(chalk5.blue(`Running schedule ${chalk5.bold(schedule.name)} against ${schedule.url}...`));
     const { run, results } = await runByFilter({
       url: schedule.url,
       tags: schedule.scenarioFilter.tags,
@@ -6294,15 +7013,15 @@ scheduleCmd.command("run <id>").description("Manually trigger a schedule").optio
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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(chalk4.blue("Scheduler daemon started. Press Ctrl+C to stop."));
-    console.log(chalk4.dim(`  Check interval: ${opts.interval}s`));
+    console.log(chalk5.blue("Scheduler daemon started. Press Ctrl+C to stop."));
+    console.log(chalk5.dim(`  Check interval: ${opts.interval}s`));
     let running = true;
     const checkAndRun = async () => {
       while (running) {
@@ -6311,7 +7030,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(chalk4.blue(`[${new Date().toISOString()}] Triggering schedule: ${schedule.name}`));
+              console.log(chalk5.blue(`[${new Date().toISOString()}] Triggering schedule: ${schedule.name}`));
               try {
                 const { run } = await runByFilter({
                   url: schedule.url,
@@ -6324,39 +7043,39 @@ program2.command("daemon").description("Start the scheduler daemon").option("--i
                   timeout: schedule.timeoutMs ?? undefined,
                   projectId: schedule.projectId ?? undefined
                 });
-                const statusColor = run.status === "passed" ? chalk4.green : chalk4.red;
+                const statusColor = run.status === "passed" ? chalk5.green : chalk5.red;
                 console.log(`  ${statusColor(run.status)} \u2014 ${run.passed}/${run.total} passed`);
                 updateSchedule(schedule.id, {});
               } catch (err) {
-                console.error(chalk4.red(`  Error running schedule ${schedule.name}: ${err instanceof Error ? err.message : String(err)}`));
+                console.error(chalk5.red(`  Error running schedule ${schedule.name}: ${err instanceof Error ? err.message : String(err)}`));
               }
             }
           }
         } catch (err) {
-          console.error(chalk4.red(`Daemon error: ${err instanceof Error ? err.message : String(err)}`));
+          console.error(chalk5.red(`Daemon error: ${err instanceof Error ? err.message : String(err)}`));
         }
         await new Promise((resolve2) => setTimeout(resolve2, intervalMs));
       }
     };
     process.on("SIGINT", () => {
-      console.log(chalk4.yellow(`
+      console.log(chalk5.yellow(`
 Shutting down scheduler daemon...`));
       running = false;
       process.exit(0);
     });
     process.on("SIGTERM", () => {
-      console.log(chalk4.yellow(`
+      console.log(chalk5.yellow(`
 Shutting down scheduler daemon...`));
       running = false;
       process.exit(0);
     });
     await checkAndRun();
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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").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((opts) => {
   try {
     const { project, scenarios, framework } = initProject({
       name: opts.name,
@@ -6364,30 +7083,41 @@ program2.command("init").description("Initialize a new testing project").option(
       path: opts.path
     });
     console.log("");
-    console.log(chalk4.bold("  Project initialized!"));
+    console.log(chalk5.bold("  Project initialized!"));
     console.log("");
     if (framework) {
-      console.log(`  Framework:  ${chalk4.cyan(framework.name)}`);
+      console.log(`  Framework:  ${chalk5.cyan(framework.name)}`);
       if (framework.features.length > 0) {
-        console.log(`  Features:   ${chalk4.dim(framework.features.join(", "))}`);
+        console.log(`  Features:   ${chalk5.dim(framework.features.join(", "))}`);
       }
     } else {
-      console.log(`  Framework:  ${chalk4.dim("not detected")}`);
+      console.log(`  Framework:  ${chalk5.dim("not detected")}`);
     }
-    console.log(`  Project:    ${chalk4.green(project.name)} ${chalk4.dim(`(${project.id})`)}`);
-    console.log(`  Scenarios:  ${chalk4.green(String(scenarios.length))} starter scenarios created`);
+    console.log(`  Project:    ${chalk5.green(project.name)} ${chalk5.dim(`(${project.id})`)}`);
+    console.log(`  Scenarios:  ${chalk5.green(String(scenarios.length))} starter scenarios created`);
     console.log("");
     for (const s of scenarios) {
-      console.log(`    ${chalk4.dim(s.shortId)} ${s.name} ${chalk4.dim(`[${s.tags.join(", ")}]`)}`);
+      console.log(`    ${chalk5.dim(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
+    }
+    if (opts.ci === "github") {
+      const workflowDir = join6(process.cwd(), ".github", "workflows");
+      if (!existsSync8(workflowDir)) {
+        mkdirSync4(workflowDir, { recursive: true });
+      }
+      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")}`);
+    } else if (opts.ci) {
+      console.log(chalk5.yellow(`  Unknown CI provider: ${opts.ci}. Supported: github`));
     }
     console.log("");
-    console.log(chalk4.bold("  Next steps:"));
+    console.log(chalk5.bold("  Next steps:"));
     console.log(`    1. Start your dev server`);
-    console.log(`    2. Run ${chalk4.cyan("testers run <url>")} to execute tests`);
-    console.log(`    3. Add more scenarios with ${chalk4.cyan("testers add <name>")}`);
+    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("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6395,16 +7125,16 @@ program2.command("replay <run-id>").description("Re-run all scenarios from a pre
   try {
     const originalRun = getRun(runId);
     if (!originalRun) {
-      console.error(chalk4.red(`Run not found: ${runId}`));
+      console.error(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(chalk4.dim("No scenarios to replay."));
+      console.log(chalk5.dim("No scenarios to replay."));
       return;
     }
-    console.log(chalk4.blue(`Replaying ${scenarioIds.length} scenarios from run ${originalRun.id.slice(0, 8)}...`));
+    console.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,
@@ -6419,7 +7149,7 @@ program2.command("replay <run-id>").description("Re-run all scenarios from a pre
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6427,16 +7157,16 @@ program2.command("retry <run-id>").description("Re-run only failed scenarios fro
   try {
     const originalRun = getRun(runId);
     if (!originalRun) {
-      console.error(chalk4.red(`Run not found: ${runId}`));
+      console.error(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(chalk4.green("No failed scenarios to retry. All passed!"));
+      console.log(chalk5.green("No failed scenarios to retry. All passed!"));
       return;
     }
-    console.log(chalk4.blue(`Retrying ${failedScenarioIds.length} failed scenarios from run ${originalRun.id.slice(0, 8)}...`));
+    console.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,
@@ -6446,13 +7176,13 @@ program2.command("retry <run-id>").description("Re-run only failed scenarios fro
     });
     if (!opts.json) {
       console.log("");
-      console.log(chalk4.bold("  Comparison with original run:"));
+      console.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 ? chalk4.yellow(`${original.status} \u2192 ${result.status}`) : chalk4.dim(`${result.status} (unchanged)`);
-          const icon = result.status === "passed" ? chalk4.green("\u2713") : chalk4.red("\u2717");
+          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}`);
         }
       }
@@ -6465,14 +7195,14 @@ program2.command("retry <run-id>").description("Re-run only failed scenarios fro
     }
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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(chalk4.blue(`Running smoke test against ${chalk4.bold(url)}...`));
+    console.log(chalk5.blue(`Running smoke test against ${chalk5.bold(url)}...`));
     console.log("");
     const smokeResult = await runSmoke({
       url,
@@ -6494,11 +7224,11 @@ program2.command("smoke <url>").description("Run autonomous smoke test").option(
     const hasCritical = smokeResult.issuesFound.some((i) => i.severity === "critical" || i.severity === "high");
     process.exit(hasCritical ? 1 : 0);
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
-program2.command("diff <run1> <run2>").description("Compare two test runs").option("--json", "JSON output", false).action((run1, run2, opts) => {
+program2.command("diff <run1> <run2>").description("Compare two test runs").option("--json", "JSON output", false).option("--threshold <percent>", "Visual diff threshold percentage", "0.1").action((run1, run2, opts) => {
   try {
     const diff = diffRuns(run1, run2);
     if (opts.json) {
@@ -6506,9 +7236,19 @@ program2.command("diff <run1> <run2>").description("Compare two test runs").opti
     } else {
       console.log(formatDiffTerminal(diff));
     }
-    process.exit(diff.regressions.length > 0 ? 1 : 0);
+    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));
+      } else {
+        console.log(formatVisualDiffTerminal(visualResults, threshold));
+      }
+    }
+    const hasVisualRegressions = visualResults.some((r) => r.isRegression);
+    process.exit(diff.regressions.length > 0 || hasVisualRegressions ? 1 : 0);
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6521,9 +7261,9 @@ program2.command("report [run-id]").description("Generate HTML test report").opt
       html = generateHtmlReport(runId);
     }
     writeFileSync3(opts.output, html, "utf-8");
-    console.log(chalk4.green(`Report generated: ${opts.output}`));
+    console.log(chalk5.green(`Report generated: ${opts.output}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6536,9 +7276,9 @@ authCmd.command("add <name>").description("Create an auth preset").requiredOptio
       password: opts.password,
       loginPath: opts.loginPath
     });
-    console.log(chalk4.green(`Created auth preset ${chalk4.bold(preset.name)} (${preset.email})`));
+    console.log(chalk5.green(`Created auth preset ${chalk5.bold(preset.name)} (${preset.email})`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6546,11 +7286,11 @@ authCmd.command("list").description("List auth presets").action(() => {
   try {
     const presets = listAuthPresets();
     if (presets.length === 0) {
-      console.log(chalk4.dim("No auth presets found."));
+      console.log(chalk5.dim("No auth presets found."));
       return;
     }
     console.log("");
-    console.log(chalk4.bold("  Auth Presets"));
+    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)}`);
@@ -6559,7 +7299,7 @@ authCmd.command("list").description("List auth presets").action(() => {
     }
     console.log("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6567,13 +7307,13 @@ authCmd.command("delete <name>").description("Delete an auth preset").action((na
   try {
     const deleted = deleteAuthPreset(name);
     if (deleted) {
-      console.log(chalk4.green(`Deleted auth preset: ${name}`));
+      console.log(chalk5.green(`Deleted auth preset: ${name}`));
     } else {
-      console.error(chalk4.red(`Auth preset not found: ${name}`));
+      console.error(chalk5.red(`Auth preset not found: ${name}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6586,7 +7326,7 @@ program2.command("costs").description("Show cost tracking and budget status").op
       console.log(formatCostsTerminal(summary));
     }
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6594,18 +7334,18 @@ program2.command("chain <scenario-id>").description("Add a dependency to a scena
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${scenarioId}`));
+      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const dep = getScenario(opts.dependsOn) ?? getScenarioByShortId(opts.dependsOn);
     if (!dep) {
-      console.error(chalk4.red(`Dependency scenario not found: ${opts.dependsOn}`));
+      console.error(chalk5.red(`Dependency scenario not found: ${opts.dependsOn}`));
       process.exit(1);
     }
     addDependency(scenario.id, dep.id);
-    console.log(chalk4.green(`${scenario.shortId} now depends on ${dep.shortId}`));
+    console.log(chalk5.green(`${scenario.shortId} now depends on ${dep.shortId}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6613,18 +7353,18 @@ program2.command("unchain <scenario-id>").description("Remove a dependency from
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${scenarioId}`));
+      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const dep = getScenario(opts.from) ?? getScenarioByShortId(opts.from);
     if (!dep) {
-      console.error(chalk4.red(`Dependency not found: ${opts.from}`));
+      console.error(chalk5.red(`Dependency not found: ${opts.from}`));
       process.exit(1);
     }
     removeDependency(scenario.id, dep.id);
-    console.log(chalk4.green(`Removed dependency: ${scenario.shortId} no longer depends on ${dep.shortId}`));
+    console.log(chalk5.green(`Removed dependency: ${scenario.shortId} no longer depends on ${dep.shortId}`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6632,26 +7372,26 @@ program2.command("deps <scenario-id>").description("Show dependencies for a scen
   try {
     const scenario = getScenario(scenarioId) ?? getScenarioByShortId(scenarioId);
     if (!scenario) {
-      console.error(chalk4.red(`Scenario not found: ${scenarioId}`));
+      console.error(chalk5.red(`Scenario not found: ${scenarioId}`));
       process.exit(1);
     }
     const deps = getDependencies(scenario.id);
     const dependents = getDependents(scenario.id);
     console.log("");
-    console.log(chalk4.bold(`  Dependencies for ${scenario.shortId}: ${scenario.name}`));
+    console.log(chalk5.bold(`  Dependencies for ${scenario.shortId}: ${scenario.name}`));
     console.log("");
     if (deps.length > 0) {
-      console.log(chalk4.dim("  Depends on:"));
+      console.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)}`);
       }
     } else {
-      console.log(chalk4.dim("  No dependencies"));
+      console.log(chalk5.dim("  No dependencies"));
     }
     if (dependents.length > 0) {
       console.log("");
-      console.log(chalk4.dim("  Required by:"));
+      console.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)}`);
@@ -6659,7 +7399,7 @@ program2.command("deps <scenario-id>").description("Show dependencies for a scen
     }
     console.log("");
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });
@@ -6669,7 +7409,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(chalk4.red(`Scenario not found: ${id.trim()}`));
+        console.error(chalk5.red(`Scenario not found: ${id.trim()}`));
         process.exit(1);
       }
       return s.id;
@@ -6680,37 +7420,37 @@ flowCmd.command("create <name>").description("Create a flow from scenario IDs").
       } catch {}
     }
     const flow = createFlow({ name, scenarioIds: ids, projectId: resolveProject(opts.project) });
-    console.log(chalk4.green(`Flow created: ${flow.id.slice(0, 8)} \u2014 ${flow.name} (${ids.length} scenarios)`));
+    console.log(chalk5.green(`Flow created: ${flow.id.slice(0, 8)} \u2014 ${flow.name} (${ids.length} scenarios)`));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(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(chalk4.dim(`
+    console.log(chalk5.dim(`
   No flows found.
 `));
     return;
   }
   console.log("");
-  console.log(chalk4.bold("  Flows"));
+  console.log(chalk5.bold("  Flows"));
   console.log("");
   for (const f of flows) {
-    console.log(`  ${chalk4.dim(f.id.slice(0, 8))}  ${f.name}  ${chalk4.dim(`(${f.scenarioIds.length} scenarios)`)}`);
+    console.log(`  ${chalk5.dim(f.id.slice(0, 8))}  ${f.name}  ${chalk5.dim(`(${f.scenarioIds.length} scenarios)`)}`);
   }
   console.log("");
 });
 flowCmd.command("show <id>").description("Show flow details").action((id) => {
   const flow = getFlow(id);
   if (!flow) {
-    console.error(chalk4.red(`Flow not found: ${id}`));
+    console.error(chalk5.red(`Flow not found: ${id}`));
     process.exit(1);
   }
   console.log("");
-  console.log(chalk4.bold(`  Flow: ${flow.name}`));
-  console.log(`  ID: ${chalk4.dim(flow.id)}`);
+  console.log(chalk5.bold(`  Flow: ${flow.name}`));
+  console.log(`  ID: ${chalk5.dim(flow.id)}`);
   console.log(`  Scenarios (in order):`);
   for (let i = 0;i < flow.scenarioIds.length; i++) {
     const s = getScenario(flow.scenarioIds[i]);
@@ -6720,9 +7460,9 @@ flowCmd.command("show <id>").description("Show flow details").action((id) => {
 });
 flowCmd.command("delete <id>").description("Delete a flow").action((id) => {
   if (deleteFlow(id))
-    console.log(chalk4.green("Flow deleted."));
+    console.log(chalk5.green("Flow deleted."));
   else {
-    console.error(chalk4.red("Flow not found."));
+    console.error(chalk5.red("Flow not found."));
     process.exit(1);
   }
 });
@@ -6730,14 +7470,14 @@ flowCmd.command("run <id>").description("Run a flow (scenarios in dependency ord
   try {
     const flow = getFlow(id);
     if (!flow) {
-      console.error(chalk4.red(`Flow not found: ${id}`));
+      console.error(chalk5.red(`Flow not found: ${id}`));
       process.exit(1);
     }
     if (!opts.url) {
-      console.error(chalk4.red("--url is required for flow run"));
+      console.error(chalk5.red("--url is required for flow run"));
       process.exit(1);
     }
-    console.log(chalk4.blue(`Running flow: ${flow.name} (${flow.scenarioIds.length} scenarios)`));
+    console.log(chalk5.blue(`Running flow: ${flow.name} (${flow.scenarioIds.length} scenarios)`));
     const { run, results } = await runByFilter({
       url: opts.url,
       scenarioIds: flow.scenarioIds,
@@ -6751,7 +7491,103 @@ flowCmd.command("run <id>").description("Run a flow (scenarios in dependency ord
       console.log(formatTerminal(run, results));
     process.exit(getExitCode(run));
   } catch (error) {
-    console.error(chalk4.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+var envCmd = program2.command("env").description("Manage environments");
+envCmd.command("add <name>").description("Add a named environment").requiredOption("--url <url>", "Environment URL").option("--auth <preset>", "Auth preset name").option("--project <id>", "Project ID").option("--default", "Set as default environment", false).action((name, opts) => {
+  try {
+    const env = createEnvironment({
+      name,
+      url: opts.url,
+      authPresetName: opts.auth,
+      projectId: opts.project,
+      isDefault: opts.default
+    });
+    console.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)}`));
+    process.exit(1);
+  }
+});
+envCmd.command("list").description("List all environments").option("--project <id>", "Filter by project ID").action((opts) => {
+  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>"));
+      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}`);
+    }
+  } catch (error) {
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+envCmd.command("use <name>").description("Set an environment as the default").action((name) => {
+  try {
+    setDefaultEnvironment(name);
+    const env = getEnvironment(name);
+    console.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)}`));
+    process.exit(1);
+  }
+});
+envCmd.command("delete <name>").description("Delete an environment").action((name) => {
+  try {
+    const deleted = deleteEnvironment(name);
+    if (deleted) {
+      console.log(chalk5.green(`Environment deleted: ${name}`));
+    } else {
+      console.error(chalk5.red(`Environment not found: ${name}`));
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program2.command("baseline <run-id>").description("Set a run as the visual baseline").action((runId) => {
+  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)` : ""}`));
+  } catch (error) {
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program2.command("import-api <spec>").description("Import test scenarios from an OpenAPI/Swagger spec file").option("--project <id>", "Project ID").action(async (spec, opts) => {
+  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(`
+Imported ${imported} scenarios from API spec:`));
+    for (const s of scenarios) {
+      console.log(`  ${chalk5.cyan(s.shortId)} ${s.name} ${chalk5.dim(`[${s.tags.join(", ")}]`)}`);
+    }
+    console.log("");
+  } catch (error) {
+    console.error(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..."));
+    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`));
+  } catch (error) {
+    console.error(chalk5.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 });