@hasna/testers 0.0.42 → 0.0.44

package/dist/cli/index.js

@@ -2120,6 +2120,11 @@ function cleanupValue(value) {
     return value;
   return;
 }
+function syncStrategyValue(value) {
+  if (value === "archive" || value === "rsync")
+    return value;
+  return;
+}
 function workflowExecutionFromValue(value) {
   const input = isRecord(value) ? value : {};
   const rawTarget = stringValue(input["target"]) ?? "local";
@@ -2134,6 +2139,7 @@ function workflowExecutionFromValue(value) {
   const sandboxImage = stringValue(input["sandboxImage"]) ?? stringValue(input["sandboxTemplate"]);
   const sandboxRemoteDir = stringValue(input["sandboxRemoteDir"]);
   const sandboxCleanup = cleanupValue(input["sandboxCleanup"]);
+  const sandboxSyncStrategy = syncStrategyValue(input["sandboxSyncStrategy"]);
   const setupCommand = stringValue(input["setupCommand"]);
   const packageSpec = stringValue(input["packageSpec"]);
   const timeoutMs = numberValue(input["timeoutMs"]);
@@ -2144,6 +2150,7 @@ function workflowExecutionFromValue(value) {
     ...sandboxImage ? { sandboxImage } : {},
     ...sandboxRemoteDir ? { sandboxRemoteDir } : {},
     ...sandboxCleanup ? { sandboxCleanup } : {},
+    ...sandboxSyncStrategy ? { sandboxSyncStrategy } : {},
     ...setupCommand ? { setupCommand } : {},
     ...packageSpec ? { packageSpec } : {},
     ...timeoutMs !== undefined ? { timeoutMs } : {},
@@ -2175,6 +2182,8 @@ function projectFromRow(row) {
     baseUrl: row.base_url ?? null,
     port: row.port ?? null,
     settings: row.settings ? JSON.parse(row.settings) : {},
+    scenarioPrefix: row.scenario_prefix ?? "TST",
+    scenarioCounter: row.scenario_counter ?? 0,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -12378,9 +12387,14 @@ function nextShortId(projectId) {
   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;
+      let next = (project.scenario_counter ?? 0) + 1;
+      let shortId = `${project.scenario_prefix || "TST"}-${next}`;
+      while (db2.query("SELECT 1 FROM scenarios WHERE short_id = ?").get(shortId)) {
+        next += 1;
+        shortId = `${project.scenario_prefix || "TST"}-${next}`;
+      }
       db2.query("UPDATE projects SET scenario_counter = ? WHERE id = ?").run(next, projectId);
-      return `${project.scenario_prefix}-${next}`;
+      return shortId;
     }
   }
   return shortUuid();
@@ -13934,6 +13948,7 @@ import { readFileSync as readFileSync2, existsSync as existsSync7 } from "fs";
 function getDefaultConfig() {
   return {
     defaultModel: "claude-haiku-4-5-20251001",
+    defaultImageModel: DEFAULT_IMAGE_MODEL,
     models: { ...MODEL_MAP },
     browser: {
       headless: true,
@@ -13960,6 +13975,7 @@ function loadConfig() {
   }
   const config = {
     defaultModel: fileConfig.defaultModel ?? defaults2.defaultModel,
+    defaultImageModel: fileConfig.defaultImageModel ?? defaults2.defaultImageModel,
     models: fileConfig.models ? { ...defaults2.models, ...fileConfig.models } : { ...defaults2.models },
     browser: fileConfig.browser ? { ...defaults2.browser, ...fileConfig.browser } : { ...defaults2.browser },
     screenshots: fileConfig.screenshots ? { ...defaults2.screenshots, ...fileConfig.screenshots } : { ...defaults2.screenshots },
@@ -13975,6 +13991,10 @@ function loadConfig() {
   if (envModel) {
     config.defaultModel = envModel;
   }
+  const envImageModel = process.env["TESTERS_IMAGE_MODEL"];
+  if (envImageModel) {
+    config.defaultImageModel = envImageModel;
+  }
   const envScreenshotsDir = process.env["TESTERS_SCREENSHOTS_DIR"];
   if (envScreenshotsDir) {
     config.screenshots.dir = envScreenshotsDir;
@@ -13989,7 +14009,7 @@ function loadConfig() {
   }
   return config;
 }
-var CONFIG_DIR3, CONFIG_PATH2;
+var CONFIG_DIR3, CONFIG_PATH2, DEFAULT_IMAGE_MODEL = "gpt-image-2";
 var init_config2 = __esm(() => {
   init_types();
   init_paths();
@@ -19165,14 +19185,19 @@ var init_reporter = __esm(() => {
 });
 
 // src/db/projects.ts
+function normalizeScenarioPrefix(prefix) {
+  const normalized = (prefix ?? "TST").trim().toUpperCase().replace(/[^A-Z0-9]/g, "");
+  return normalized || "TST";
+}
 function createProject(input) {
   const db2 = getDatabase();
   const id = uuid();
   const timestamp = now();
+  const scenarioPrefix = normalizeScenarioPrefix(input.scenarioPrefix);
   db2.query(`
-    INSERT INTO projects (id, name, path, description, base_url, port, settings, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, input.name, input.path ?? null, input.description ?? null, input.baseUrl ?? null, input.port ?? null, input.settings ? JSON.stringify(input.settings) : "{}", timestamp, timestamp);
+    INSERT INTO projects (id, name, path, description, base_url, port, settings, scenario_prefix, scenario_counter, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?)
+  `).run(id, input.name, input.path ?? null, input.description ?? null, input.baseUrl ?? null, input.port ?? null, input.settings ? JSON.stringify(input.settings) : "{}", scenarioPrefix, timestamp, timestamp);
   return getProject(id);
 }
 function getProject(id) {
@@ -27001,6 +27026,178 @@ var init_workflows = __esm(() => {
   DEFAULT_EXECUTION = { target: "local" };
 });
 
+// src/lib/workflow-runner.ts
+import { mkdtempSync, rmSync, writeFileSync as writeFileSync4 } from "fs";
+import { tmpdir } from "os";
+import { join as join16 } from "path";
+function buildWorkflowRunPlan(workflow, options) {
+  const runOptions = {
+    url: options.url,
+    model: options.model,
+    headed: options.headed,
+    parallel: options.parallel,
+    timeout: options.timeout ?? workflow.execution.timeoutMs,
+    projectId: workflow.projectId ?? undefined,
+    scenarioIds: workflow.scenarioFilter.scenarioIds,
+    tags: workflow.scenarioFilter.tags,
+    priority: workflow.scenarioFilter.priority,
+    personaIds: workflow.personaIds.length > 0 ? workflow.personaIds : undefined
+  };
+  return {
+    workflow,
+    runOptions,
+    sandbox: workflow.execution.target === "sandbox" ? buildSandboxPlan(workflow, workflow.execution, runOptions) : null
+  };
+}
+async function runTestingWorkflow(workflowId, options, dependencies = {}) {
+  const workflow = getTestingWorkflow(workflowId);
+  if (!workflow)
+    throw new Error(`Testing workflow not found: ${workflowId}`);
+  if (!workflow.enabled)
+    throw new Error(`Testing workflow is disabled: ${workflow.name}`);
+  validatePersonaIds(workflow);
+  const plan = buildWorkflowRunPlan(workflow, options);
+  if (options.dryRun)
+    return { run: null, results: [], plan };
+  if (workflow.execution.target === "sandbox") {
+    const sandboxResult = await runViaSandbox(plan, dependencies);
+    return { run: null, results: [], plan, sandboxResult };
+  }
+  const runLocal = dependencies.runByFilter ?? runByFilter;
+  const { run, results } = await runLocal(plan.runOptions);
+  return { run, results, plan };
+}
+function createWorkflowDatabaseBundle(workflow, plan) {
+  if (!plan.sandbox)
+    throw new Error(`Workflow is not configured for sandbox execution: ${workflow.name}`);
+  const localDir = mkdtempSync(join16(tmpdir(), `testers-workflow-${workflow.id.slice(0, 8)}-`));
+  writeFileSync4(join16(localDir, "testers.db"), getDatabase().serialize());
+  return {
+    localDir,
+    remoteDir: plan.sandbox.stateRemoteDir,
+    cleanup: () => rmSync(localDir, { recursive: true, force: true })
+  };
+}
+function validatePersonaIds(workflow) {
+  for (const personaId of workflow.personaIds) {
+    if (!getPersona(personaId)) {
+      throw new Error(`Persona not found for workflow ${workflow.name}: ${personaId}`);
+    }
+  }
+}
+function buildSandboxPlan(workflow, execution, runOptions) {
+  const remoteDir = execution.sandboxRemoteDir ?? `/tmp/testers-workflow-${workflow.id.slice(0, 8)}`;
+  const stateRemoteDir = `${remoteDir.replace(/\/+$/, "")}/.testers-state`;
+  return {
+    provider: execution.provider,
+    image: execution.sandboxImage,
+    name: `testers-${workflow.id.slice(0, 8)}`,
+    remoteDir,
+    stateRemoteDir,
+    cleanup: execution.sandboxCleanup ?? "delete",
+    syncStrategy: execution.sandboxSyncStrategy ?? "rsync",
+    timeoutMs: execution.timeoutMs,
+    env: execution.env,
+    command: buildSandboxCommand({
+      runOptions,
+      remoteDir,
+      dbPath: `${stateRemoteDir}/testers.db`,
+      setupCommand: execution.setupCommand,
+      packageSpec: execution.packageSpec ?? "@hasna/testers"
+    })
+  };
+}
+function buildSandboxCommand(input) {
+  const args = [
+    "bunx",
+    input.packageSpec,
+    "run",
+    input.runOptions.url,
+    ...input.runOptions.scenarioIds?.length ? ["--scenario", input.runOptions.scenarioIds.join(",")] : [],
+    ...input.runOptions.tags?.length ? input.runOptions.tags.flatMap((tag) => ["--tag", tag]) : [],
+    ...input.runOptions.priority ? ["--priority", input.runOptions.priority] : [],
+    ...input.runOptions.projectId ? ["--project", input.runOptions.projectId] : [],
+    ...input.runOptions.model ? ["--model", input.runOptions.model] : [],
+    ...input.runOptions.headed ? ["--headed"] : [],
+    ...input.runOptions.parallel ? ["--parallel", String(input.runOptions.parallel)] : [],
+    ...input.runOptions.timeout ? ["--timeout", String(input.runOptions.timeout)] : [],
+    ...input.runOptions.personaIds?.length ? ["--persona", input.runOptions.personaIds.join(",")] : [],
+    "--no-auto-generate",
+    "--json"
+  ];
+  return [
+    "set -euo pipefail",
+    `mkdir -p ${shellQuote(input.remoteDir)}`,
+    `cd ${shellQuote(input.remoteDir)}`,
+    input.setupCommand,
+    `HASNA_TESTERS_DB_PATH=${shellQuote(input.dbPath)} ${args.map(shellQuote).join(" ")}`
+  ].filter(Boolean).join(`
+`);
+}
+async function runViaSandbox(plan, dependencies) {
+  if (!plan.sandbox)
+    throw new Error("Workflow does not have a sandbox plan");
+  const sandboxes = await resolveSandboxesRuntime(dependencies);
+  const createBundle = dependencies.createDatabaseBundle ?? createWorkflowDatabaseBundle;
+  const bundle = createBundle(plan.workflow, plan);
+  try {
+    const raw = await sandboxes.runCommandInSandbox({
+      command: plan.sandbox.command,
+      provider: plan.sandbox.provider,
+      name: plan.sandbox.name,
+      image: plan.sandbox.image,
+      sandboxTimeout: plan.sandbox.timeoutMs,
+      commandTimeoutMs: plan.sandbox.timeoutMs,
+      projectId: plan.workflow.projectId ?? undefined,
+      config: {
+        source: "testers",
+        workflowId: plan.workflow.id,
+        workflowName: plan.workflow.name
+      },
+      sandboxEnvVars: plan.sandbox.env,
+      cleanup: plan.sandbox.cleanup,
+      upload: {
+        localDir: bundle.localDir,
+        remoteDir: bundle.remoteDir,
+        syncStrategy: plan.sandbox.syncStrategy
+      }
+    });
+    const exitCode = raw.result.exit_code ?? raw.result.exitCode ?? 0;
+    const stdout = raw.result.stdout ?? "";
+    const stderr = raw.result.stderr ?? "";
+    if (exitCode !== 0) {
+      throw new Error(`Sandbox workflow execution failed (${exitCode}): ${stderr || stdout}`);
+    }
+    return {
+      sandboxId: raw.sandbox.id,
+      sessionId: raw.session.id,
+      exitCode,
+      stdout,
+      stderr,
+      cleanup: raw.cleanup
+    };
+  } finally {
+    bundle.cleanup?.();
+  }
+}
+async function resolveSandboxesRuntime(dependencies) {
+  if (dependencies.sandboxes)
+    return dependencies.sandboxes;
+  if (dependencies.createSandboxesSDK)
+    return dependencies.createSandboxesSDK();
+  const mod = await import("@hasna/sandboxes");
+  return mod.createSandboxesSDK();
+}
+function shellQuote(value) {
+  return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+var init_workflow_runner = __esm(() => {
+  init_database();
+  init_workflows();
+  init_personas();
+  init_runner();
+});
+
 // src/lib/ci.ts
 var exports_ci = {};
 __export(exports_ci, {
@@ -59383,6 +59580,115 @@ var init_agents = __esm(() => {
   init_database();
 });
 
+// src/lib/workflow-fanout.ts
+var exports_workflow_fanout = {};
+__export(exports_workflow_fanout, {
+  runWorkflowFanout: () => runWorkflowFanout,
+  resolveWorkflowFanoutSelection: () => resolveWorkflowFanoutSelection,
+  normalizeFanoutWorkerCount: () => normalizeFanoutWorkerCount
+});
+function splitWorkflowIds(ids) {
+  return (ids ?? []).flatMap((item) => item.split(",")).map((item) => item.trim()).filter(Boolean);
+}
+function normalizeFanoutWorkerCount(value) {
+  const workers = Math.floor(value ?? 6);
+  if (!Number.isFinite(workers) || workers < 1 || workers > 12) {
+    throw new Error("workflow fanout workers must be between 1 and 12");
+  }
+  return workers;
+}
+function resolveWorkflowFanoutSelection(options) {
+  const ids = splitWorkflowIds(options.workflowIds);
+  const workflows = ids.length > 0 ? ids.map((id) => {
+    const workflow = getTestingWorkflow(id);
+    if (!workflow)
+      throw new Error(`Testing workflow not found: ${id}`);
+    return workflow;
+  }) : listTestingWorkflows({
+    projectId: options.projectId,
+    enabled: options.includeDisabled ? undefined : true
+  });
+  const tagSet = new Set(options.tags ?? []);
+  const filtered = tagSet.size === 0 ? workflows : workflows.filter((workflow) => workflow.scenarioFilter.tags?.some((tag) => tagSet.has(tag)));
+  if (filtered.length === 0) {
+    throw new Error("No testing workflows matched the fanout selection");
+  }
+  const nonSandbox = filtered.filter((workflow) => workflow.execution.target !== "sandbox");
+  if (nonSandbox.length > 0) {
+    throw new Error(`workflow fanout requires sandbox workflows. Recreate or update these with --target sandbox: ${nonSandbox.map((workflow) => workflow.name).join(", ")}`);
+  }
+  return filtered;
+}
+async function mapWithConcurrency(items, limit, worker) {
+  const output = new Array(items.length);
+  let next = 0;
+  async function runWorker() {
+    while (next < items.length) {
+      const index = next++;
+      output[index] = await worker(items[index], index);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => runWorker()));
+  return output;
+}
+async function runWorkflowFanout(options, dependencies = {}) {
+  const workers = normalizeFanoutWorkerCount(options.workers);
+  const workflows = resolveWorkflowFanoutSelection(options);
+  const { runTestingWorkflow: runOne = runTestingWorkflow, ...workflowDependencies } = dependencies;
+  const items = await mapWithConcurrency(workflows, workers, async (workflow) => {
+    try {
+      const output = await runOne(workflow.id, {
+        url: options.url,
+        model: options.model,
+        headed: options.headed,
+        parallel: options.parallel,
+        timeout: options.timeout,
+        dryRun: options.dryRun
+      }, workflowDependencies);
+      if (options.dryRun) {
+        return {
+          workflowId: workflow.id,
+          workflowName: workflow.name,
+          status: "dry-run",
+          plan: output.plan
+        };
+      }
+      return {
+        workflowId: workflow.id,
+        workflowName: workflow.name,
+        status: "passed",
+        sandboxId: output.sandboxResult?.sandboxId,
+        sessionId: output.sandboxResult?.sessionId,
+        exitCode: output.sandboxResult?.exitCode,
+        stdout: output.sandboxResult?.stdout,
+        stderr: output.sandboxResult?.stderr
+      };
+    } catch (error) {
+      return {
+        workflowId: workflow.id,
+        workflowName: workflow.name,
+        status: "failed",
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  });
+  const failed = items.filter((item) => item.status === "failed").length;
+  const passed = items.filter((item) => item.status === "passed").length;
+  const dryRun = options.dryRun === true;
+  return {
+    status: dryRun ? "dry-run" : failed > 0 ? "failed" : "passed",
+    workers,
+    total: items.length,
+    passed,
+    failed,
+    items
+  };
+}
+var init_workflow_fanout = __esm(() => {
+  init_workflows();
+  init_workflow_runner();
+});
+
 // node_modules/@ai-sdk/provider/dist/index.mjs
 function getErrorMessage(error) {
   if (error == null) {
@@ -94040,7 +94346,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.42",
+  version: "0.0.44",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -94086,7 +94392,7 @@ var package_default = {
     "@hasna/cloud": "^0.1.24",
     "@hasna/contacts": "^0.6.8",
     "@hasna/projects": "^0.1.42",
-    "@hasna/sandboxes": "^0.1.27",
+    "@hasna/sandboxes": "^0.1.28",
     "@modelcontextprotocol/sdk": "^1.12.1",
     ai: "^6.0.175",
     chalk: "^5.4.1",
@@ -96152,174 +96458,7 @@ function deleteAuthPreset(name) {
 // src/cli/index.tsx
 init_flows();
 init_workflows();
-
-// src/lib/workflow-runner.ts
-init_database();
-init_workflows();
-init_personas();
-init_runner();
-import { mkdtempSync, rmSync, writeFileSync as writeFileSync4 } from "fs";
-import { tmpdir } from "os";
-import { join as join16 } from "path";
-function buildWorkflowRunPlan(workflow, options) {
-  const runOptions = {
-    url: options.url,
-    model: options.model,
-    headed: options.headed,
-    parallel: options.parallel,
-    timeout: options.timeout ?? workflow.execution.timeoutMs,
-    projectId: workflow.projectId ?? undefined,
-    scenarioIds: workflow.scenarioFilter.scenarioIds,
-    tags: workflow.scenarioFilter.tags,
-    priority: workflow.scenarioFilter.priority,
-    personaIds: workflow.personaIds.length > 0 ? workflow.personaIds : undefined
-  };
-  return {
-    workflow,
-    runOptions,
-    sandbox: workflow.execution.target === "sandbox" ? buildSandboxPlan(workflow, workflow.execution, runOptions) : null
-  };
-}
-async function runTestingWorkflow(workflowId, options, dependencies = {}) {
-  const workflow = getTestingWorkflow(workflowId);
-  if (!workflow)
-    throw new Error(`Testing workflow not found: ${workflowId}`);
-  if (!workflow.enabled)
-    throw new Error(`Testing workflow is disabled: ${workflow.name}`);
-  validatePersonaIds(workflow);
-  const plan = buildWorkflowRunPlan(workflow, options);
-  if (options.dryRun)
-    return { run: null, results: [], plan };
-  if (workflow.execution.target === "sandbox") {
-    const sandboxResult = await runViaSandbox(plan, dependencies);
-    return { run: null, results: [], plan, sandboxResult };
-  }
-  const runLocal = dependencies.runByFilter ?? runByFilter;
-  const { run, results } = await runLocal(plan.runOptions);
-  return { run, results, plan };
-}
-function createWorkflowDatabaseBundle(workflow, plan) {
-  if (!plan.sandbox)
-    throw new Error(`Workflow is not configured for sandbox execution: ${workflow.name}`);
-  const localDir = mkdtempSync(join16(tmpdir(), `testers-workflow-${workflow.id.slice(0, 8)}-`));
-  writeFileSync4(join16(localDir, "testers.db"), getDatabase().serialize());
-  return {
-    localDir,
-    remoteDir: plan.sandbox.stateRemoteDir,
-    cleanup: () => rmSync(localDir, { recursive: true, force: true })
-  };
-}
-function validatePersonaIds(workflow) {
-  for (const personaId of workflow.personaIds) {
-    if (!getPersona(personaId)) {
-      throw new Error(`Persona not found for workflow ${workflow.name}: ${personaId}`);
-    }
-  }
-}
-function buildSandboxPlan(workflow, execution, runOptions) {
-  const remoteDir = execution.sandboxRemoteDir ?? `/tmp/testers-workflow-${workflow.id.slice(0, 8)}`;
-  const stateRemoteDir = `${remoteDir.replace(/\/+$/, "")}/.testers-state`;
-  return {
-    provider: execution.provider,
-    image: execution.sandboxImage,
-    name: `testers-${workflow.id.slice(0, 8)}`,
-    remoteDir,
-    stateRemoteDir,
-    cleanup: execution.sandboxCleanup ?? "delete",
-    timeoutMs: execution.timeoutMs,
-    env: execution.env,
-    command: buildSandboxCommand({
-      runOptions,
-      remoteDir,
-      dbPath: `${stateRemoteDir}/testers.db`,
-      setupCommand: execution.setupCommand,
-      packageSpec: execution.packageSpec ?? "@hasna/testers"
-    })
-  };
-}
-function buildSandboxCommand(input) {
-  const args = [
-    "bunx",
-    input.packageSpec,
-    "run",
-    input.runOptions.url,
-    ...input.runOptions.scenarioIds?.length ? ["--scenario", input.runOptions.scenarioIds.join(",")] : [],
-    ...input.runOptions.tags?.length ? input.runOptions.tags.flatMap((tag) => ["--tag", tag]) : [],
-    ...input.runOptions.priority ? ["--priority", input.runOptions.priority] : [],
-    ...input.runOptions.projectId ? ["--project", input.runOptions.projectId] : [],
-    ...input.runOptions.model ? ["--model", input.runOptions.model] : [],
-    ...input.runOptions.headed ? ["--headed"] : [],
-    ...input.runOptions.parallel ? ["--parallel", String(input.runOptions.parallel)] : [],
-    ...input.runOptions.timeout ? ["--timeout", String(input.runOptions.timeout)] : [],
-    ...input.runOptions.personaIds?.length ? ["--persona", input.runOptions.personaIds.join(",")] : [],
-    "--no-auto-generate",
-    "--json"
-  ];
-  return [
-    "set -euo pipefail",
-    `mkdir -p ${shellQuote(input.remoteDir)}`,
-    `cd ${shellQuote(input.remoteDir)}`,
-    input.setupCommand,
-    `HASNA_TESTERS_DB_PATH=${shellQuote(input.dbPath)} ${args.map(shellQuote).join(" ")}`
-  ].filter(Boolean).join(`
-`);
-}
-async function runViaSandbox(plan, dependencies) {
-  if (!plan.sandbox)
-    throw new Error("Workflow does not have a sandbox plan");
-  const sandboxes = await resolveSandboxesRuntime(dependencies);
-  const createBundle = dependencies.createDatabaseBundle ?? createWorkflowDatabaseBundle;
-  const bundle = createBundle(plan.workflow, plan);
-  try {
-    const raw = await sandboxes.runCommandInSandbox({
-      command: plan.sandbox.command,
-      provider: plan.sandbox.provider,
-      name: plan.sandbox.name,
-      image: plan.sandbox.image,
-      sandboxTimeout: plan.sandbox.timeoutMs,
-      commandTimeoutMs: plan.sandbox.timeoutMs,
-      projectId: plan.workflow.projectId ?? undefined,
-      config: {
-        source: "testers",
-        workflowId: plan.workflow.id,
-        workflowName: plan.workflow.name
-      },
-      sandboxEnvVars: plan.sandbox.env,
-      cleanup: plan.sandbox.cleanup,
-      upload: {
-        localDir: bundle.localDir,
-        remoteDir: bundle.remoteDir
-      }
-    });
-    const exitCode = raw.result.exit_code ?? raw.result.exitCode ?? 0;
-    const stdout = raw.result.stdout ?? "";
-    const stderr = raw.result.stderr ?? "";
-    if (exitCode !== 0) {
-      throw new Error(`Sandbox workflow execution failed (${exitCode}): ${stderr || stdout}`);
-    }
-    return {
-      sandboxId: raw.sandbox.id,
-      sessionId: raw.session.id,
-      exitCode,
-      stdout,
-      stderr,
-      cleanup: raw.cleanup
-    };
-  } finally {
-    bundle.cleanup?.();
-  }
-}
-async function resolveSandboxesRuntime(dependencies) {
-  if (dependencies.sandboxes)
-    return dependencies.sandboxes;
-  if (dependencies.createSandboxesSDK)
-    return dependencies.createSandboxesSDK();
-  const mod = await import("@hasna/sandboxes");
-  return mod.createSandboxesSDK();
-}
-function shellQuote(value) {
-  return `'${value.replaceAll("'", `'"'"'`)}'`;
-}
+init_workflow_runner();
 
 // src/db/environments.ts
 init_database();
@@ -98350,6 +98489,7 @@ program2.command("status").description("Show database and auth status").action((
     log(`  ANTHROPIC_API_KEY: ${hasApiKey ? chalk6.green("set") : chalk6.red("not set")}`);
     log(`  Database:          ${dbPath}`);
     log(`  Default model:     ${config2.defaultModel}`);
+    log(`  Image model:       ${config2.defaultImageModel}`);
     log(`  Screenshots dir:   ${config2.screenshots.dir}`);
     log("");
   } catch (error40) {
@@ -98380,7 +98520,8 @@ projectCmd.command("create <name>").description("Create a new project").option("
     const project = createProject({
       name: name21,
       path: opts.path,
-      description: opts.description
+      description: opts.description,
+      scenarioPrefix: opts.prefix
     });
     log(chalk6.green(`Created project ${chalk6.bold(project.name)} (${project.id})`));
   } catch (error40) {
@@ -100687,7 +100828,7 @@ workflowCmd.command("create <name>").description("Save a reusable testing workfl
 }, []).option("--priority <level>", "Scenario priority").option("--persona <ids>", "Comma-separated persona IDs").option("--goal <prompt>", "Goal prompt for the agentic testing loop").option("--success <criteria>", "Success criteria (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("--max-iterations <n>", "Goal-loop iteration cap", "10").option("--target <target>", "Execution target: local or sandbox", "local").option("--sandbox-provider <provider>", "Sandbox provider: e2b, daytona, or modal").option("--sandbox-image <image>", "Sandbox image/template").option("--sandbox-remote-dir <path>", "Remote working directory for sandbox runs").option("--sandbox-cleanup <mode>", "Sandbox cleanup mode: delete, stop, or keep", "delete").option("--sandbox-setup-command <command>", "Shell command to run before testers in the sandbox").option("--sandbox-package <spec>", "Package spec to execute in the sandbox", "@hasna/testers").option("--e2b-template <name>", "Legacy alias for --sandbox-image").option("--timeout <ms>", "Workflow timeout").option("--json", "Output as JSON", false).action((name21, opts) => {
+}, []).option("--max-iterations <n>", "Goal-loop iteration cap", "10").option("--target <target>", "Execution target: local or sandbox", "local").option("--sandbox-provider <provider>", "Sandbox provider: e2b, daytona, or modal").option("--sandbox-image <image>", "Sandbox image/template").option("--sandbox-remote-dir <path>", "Remote working directory for sandbox runs").option("--sandbox-cleanup <mode>", "Sandbox cleanup mode: delete, stop, or keep", "delete").option("--sandbox-sync <strategy>", "Sandbox upload sync strategy: rsync or archive", "rsync").option("--sandbox-setup-command <command>", "Shell command to run before testers in the sandbox").option("--sandbox-package <spec>", "Package spec to execute in the sandbox", "@hasna/testers").option("--e2b-template <name>", "Legacy alias for --sandbox-image").option("--timeout <ms>", "Workflow timeout").option("--json", "Output as JSON", false).action((name21, opts) => {
   try {
     const workflow = createTestingWorkflow({
       name: name21,
@@ -100710,6 +100851,7 @@ workflowCmd.command("create <name>").description("Save a reusable testing workfl
         sandboxImage: opts.sandboxImage ?? opts.e2bTemplate,
         sandboxRemoteDir: opts.sandboxRemoteDir,
         sandboxCleanup: opts.sandboxCleanup,
+        sandboxSyncStrategy: opts.sandboxSync,
         setupCommand: opts.sandboxSetupCommand,
         packageSpec: opts.sandboxPackage,
         timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined
@@ -100778,7 +100920,7 @@ workflowCmd.command("run <id>").description("Run a saved testing workflow").requ
       timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
       dryRun: opts.dryRun
     });
-    if (opts.json || opts.dryRun || output.connectorResult) {
+    if (opts.json || opts.dryRun || output.sandboxResult) {
       log(JSON.stringify(output, null, 2));
       return;
     }
@@ -100789,6 +100931,44 @@ workflowCmd.command("run <id>").description("Run a saved testing workflow").requ
     process.exit(1);
   }
 });
+workflowCmd.command("fanout [ids...]").description("Run multiple saved sandbox workflows concurrently").requiredOption("-u, --url <url>", "Target URL").option("--project <id>", "Project ID").option("--tag <tag>", "Workflow scenario tag filter (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--all", "Include disabled workflows when selecting by project/tag", false).option("--workers <n>", "Concurrent sandboxes, 1-12 (default: 6)", "6").option("-m, --model <model>", "AI model").option("--headed", "Run headed", false).option("--parallel <n>", "Parallel browser workers inside each sandbox").option("--timeout <ms>", "Override workflow timeout").option("--dry-run", "Print resolved sandbox plans without spawning sandboxes", false).option("--json", "Output as JSON", false).action(async (ids, opts) => {
+  try {
+    const { runWorkflowFanout: runWorkflowFanout2 } = await Promise.resolve().then(() => (init_workflow_fanout(), exports_workflow_fanout));
+    const result = await runWorkflowFanout2({
+      workflowIds: ids,
+      projectId: opts.project ? resolveProject2(opts.project) : undefined,
+      tags: opts.tag,
+      includeDisabled: opts.all,
+      workers: opts.workers ? parseInt(opts.workers, 10) : undefined,
+      url: opts.url,
+      model: opts.model,
+      headed: opts.headed,
+      parallel: opts.parallel ? parseInt(opts.parallel, 10) : undefined,
+      timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+      dryRun: opts.dryRun
+    });
+    if (opts.json || opts.dryRun) {
+      log(JSON.stringify(result, null, 2));
+    } else {
+      const status = result.status === "passed" ? chalk6.green("passed") : chalk6.red("failed");
+      log(chalk6.bold(`Sandbox workflow fanout ${status}: ${result.passed}/${result.total} passed with ${result.workers} worker(s)`));
+      for (const item of result.items) {
+        const itemStatus = item.status === "passed" ? chalk6.green(item.status) : chalk6.red(item.status);
+        const sandbox = item.sandboxId ? chalk6.dim(` sandbox=${item.sandboxId.slice(0, 8)}`) : "";
+        const error40 = item.error ? chalk6.dim(` ${item.error}`) : "";
+        log(`  ${itemStatus}  ${item.workflowName}${sandbox}${error40}`);
+      }
+    }
+    if (result.status === "failed")
+      process.exit(1);
+  } catch (error40) {
+    logError(chalk6.red(`Error: ${error40 instanceof Error ? error40.message : String(error40)}`));
+    process.exit(1);
+  }
+});
 workflowCmd.command("agent <id>").description("Run a saved workflow as a goal loop and ask the app AI to create open-todos next actions").requiredOption("-u, --url <url>", "Target URL").option("-m, --model <model>", "AI SDK model ID for planning").option("--headed", "Run headed", false).option("--parallel <n>", "Parallel workers").option("--dry-run", "Resolve the loop without launching browsers", false).option("--json", "Output as JSON", false).action(async (id, opts) => {
   try {
     const { runWorkflowGoalLoop: runWorkflowGoalLoop2 } = await Promise.resolve().then(() => (init_workflow_agent(), exports_workflow_agent));