@hasna/testers 0.0.48 → 0.0.50

package/dist/cli/index.js

@@ -59150,6 +59150,511 @@ var init_openapi_import = __esm(() => {
   init_api_checks();
 });
 
+// src/lib/next-route-inventory.ts
+var exports_next_route_inventory = {};
+__export(exports_next_route_inventory, {
+  scenarioInputForNextRoute: () => scenarioInputForNextRoute,
+  importNextRouteInventory: () => importNextRouteInventory,
+  discoverNextRouteInventory: () => discoverNextRouteInventory
+});
+import { existsSync as existsSync18, readdirSync as readdirSync6, readFileSync as readFileSync9, statSync as statSync4 } from "fs";
+import { basename as basename3, join as join20, relative as relative4, resolve as resolve3 } from "path";
+function discoverNextRouteInventory(options) {
+  const rootDir = resolve3(options.rootDir);
+  const appDir = resolveAppDir(rootDir, options.appDir);
+  const includePages = options.includePages !== false;
+  const includeApi = options.includeApi !== false;
+  const files = walkRouteFiles(appDir);
+  const items = files.map((file) => routeItemFromFile(rootDir, appDir, file)).filter((item) => Boolean(item)).filter((item) => item.kind === "page" ? includePages : includeApi).sort((a2, b2) => `${a2.kind}:${a2.routePath}:${a2.file}`.localeCompare(`${b2.kind}:${b2.routePath}:${b2.file}`)).slice(0, options.limit);
+  const categories = {};
+  for (const item of items) {
+    categories[item.category] = (categories[item.category] ?? 0) + 1;
+  }
+  return {
+    rootDir,
+    appDir,
+    total: items.length,
+    pages: items.filter((item) => item.kind === "page").length,
+    apiRoutes: items.filter((item) => item.kind === "api").length,
+    dynamic: items.filter((item) => item.dynamic).length,
+    categories,
+    items
+  };
+}
+function scenarioInputForNextRoute(item, projectId) {
+  const label = item.kind === "page" ? "page" : "API route";
+  const methodList = item.methods.length > 0 ? item.methods.join(", ") : "discovered methods";
+  const fixtureStep = item.fixtureParams.length > 0 ? `Bind dynamic fixture values for ${item.fixtureParams.map((name) => `:${name}`).join(", ")} before running route actions.` : undefined;
+  const dynamicStep = item.dynamic ? "Substitute dynamic path parameters with valid fixture values from the target org before opening or calling the route." : undefined;
+  const actionSteps = item.actions.slice(0, 16).map(formatActionStep);
+  const pageSteps = [
+    fixtureStep,
+    dynamicStep,
+    `Open the Next.js ${label} ${item.routePath}.`,
+    "Wait for the route to finish loading and verify it does not show a blank shell, framework error page, or unexpected auth loop.",
+    ...actionSteps.length > 0 ? actionSteps : ["Exercise visible primary navigation, tabs, filters, dialogs, forms, and safe buttons on this route."],
+    "Verify the route stays within the expected org/workspace context and does not emit console errors."
+  ].filter(Boolean);
+  const apiSteps = [
+    fixtureStep,
+    dynamicStep,
+    `Call the ${methodList} handler(s) for ${item.routePath} using safe fixture data.`,
+    ...actionSteps,
+    "Verify expected authentication, authorization, validation, and tenant isolation behavior.",
+    "For mutating methods, use harmless test payloads and confirm the response does not create cross-org side effects.",
+    "Verify response status, JSON shape, and error messages are stable and regression-safe."
+  ].filter(Boolean);
+  return {
+    name: `Next ${label}: ${item.routePath}`,
+    description: `Source-discovered ${label} from ${item.file}. Verify route behavior and regressions for ${item.category}.`,
+    steps: item.kind === "page" ? pageSteps : apiSteps,
+    tags: item.tags,
+    priority: item.priority,
+    targetPath: item.routePath,
+    requiresAuth: item.requiresAuth,
+    assertions: item.kind === "page" ? SAFE_PAGE_ASSERTIONS : [],
+    metadata: {
+      source: "next-route-inventory",
+      routeFile: item.file,
+      routeKind: item.kind,
+      category: item.category,
+      methods: item.methods,
+      dynamic: item.dynamic,
+      fixtureParams: item.fixtureParams,
+      actions: item.actions,
+      actionCount: item.actions.length,
+      groups: item.groups
+    },
+    projectId
+  };
+}
+function importNextRouteInventory(options) {
+  const inventory = discoverNextRouteInventory(options);
+  let created = 0;
+  let updated = 0;
+  let deduped = 0;
+  const scenarios = [];
+  const workflows = [];
+  if (options.createScenarios) {
+    for (const item of inventory.items) {
+      const result = upsertScenario(scenarioInputForNextRoute(item, options.projectId));
+      scenarios.push(result.scenario);
+      if (result.action === "created")
+        created++;
+      else if (result.action === "updated")
+        updated++;
+      else
+        deduped++;
+    }
+  }
+  if (options.createWorkflows) {
+    workflows.push(...upsertRouteInventoryWorkflows(inventory, options));
+  }
+  return { inventory, created, updated, deduped, scenarios, workflows };
+}
+function upsertRouteInventoryWorkflows(inventory, options) {
+  const workflows = [];
+  const categories = Object.keys(inventory.categories).sort();
+  for (const category of categories) {
+    const kinds = new Set(inventory.items.filter((item) => item.category === category).map((item) => item.kind));
+    for (const kind of kinds) {
+      const name = `Next route inventory ${category} ${kind}`;
+      const scenarioTags = ["next-route", `area:${category}`, `route:${kind}`];
+      const execution = {
+        target: options.workflowTarget ?? "sandbox",
+        provider: options.workflowProvider,
+        sandboxCleanup: "delete",
+        sandboxSyncStrategy: "rsync",
+        ...options.workflowExecution
+      };
+      const existing = listTestingWorkflows({ projectId: options.projectId, enabled: undefined }).find((workflow) => workflow.name === name);
+      const input = {
+        name,
+        description: `Source-discovered Next.js ${kind} coverage for ${category} routes.`,
+        projectId: options.projectId,
+        scenarioFilter: { tags: scenarioTags },
+        execution
+      };
+      workflows.push(existing ? updateTestingWorkflow(existing.id, input) : createTestingWorkflow(input));
+    }
+  }
+  return workflows;
+}
+function resolveAppDir(rootDir, appDir) {
+  const candidates = appDir ? [resolve3(rootDir, appDir)] : [
+    join20(rootDir, "packages", "web", "app"),
+    join20(rootDir, "app"),
+    rootDir
+  ];
+  for (const candidate of candidates) {
+    if (existsSync18(candidate) && statSync4(candidate).isDirectory())
+      return candidate;
+  }
+  throw new Error(`Next.js app directory not found under ${rootDir}`);
+}
+function walkRouteFiles(appDir) {
+  const files = [];
+  function walk(dir) {
+    for (const entry of readdirSync6(dir)) {
+      if (WALK_EXCLUDES.has(entry))
+        continue;
+      const fullPath = join20(dir, entry);
+      const stat = statSync4(fullPath);
+      if (stat.isDirectory()) {
+        walk(fullPath);
+      } else if (ROUTE_FILE_NAMES.has(entry)) {
+        files.push(fullPath);
+      }
+    }
+  }
+  walk(appDir);
+  return files;
+}
+function routeItemFromFile(rootDir, appDir, file) {
+  const fileName = basename3(file);
+  const kind = fileName.startsWith("page.") ? "page" : "api";
+  const relativeFile = relative4(rootDir, file);
+  const appRelative = relative4(appDir, file).split(/[\\/]/);
+  const routeSegments = appRelative.slice(0, -1);
+  const groups = routeSegments.filter((segment) => segment.startsWith("(") && segment.endsWith(")")).map((segment) => segment.slice(1, -1));
+  const pathSegments = routeSegments.filter((segment) => !segment.startsWith("(")).filter((segment) => !segment.startsWith("@")).map(normalizeRouteSegment).filter(Boolean);
+  const routePath = `/${pathSegments.join("/")}`.replace(/\/+/g, "/");
+  const normalizedRoutePath = routePath === "/" ? "/" : routePath.replace(/\/$/, "");
+  const sources = collectRouteSources(rootDir, file);
+  const primarySource = sources[0]?.source ?? readFileSync9(file, "utf8");
+  const methods = kind === "api" ? extractRouteMethods(primarySource) : [];
+  const category = classifyRoute(normalizedRoutePath, groups, relativeFile);
+  const dynamic = routeSegments.some((segment) => segment.includes("["));
+  const fixtureParams = extractFixtureParams(normalizedRoutePath);
+  const actions = kind === "api" ? methods.map((method) => ({
+    kind: "api-method",
+    label: method,
+    target: normalizedRoutePath,
+    sourceFile: relativeFile,
+    destructive: isDestructiveAction(method, normalizedRoutePath),
+    requiresFixture: fixtureParams.length > 0
+  })) : extractPageActions(rootDir, sources, fixtureParams);
+  const requiresAuth = inferRequiresAuth(normalizedRoutePath, groups, kind);
+  return {
+    kind,
+    routePath: normalizedRoutePath,
+    file: relativeFile,
+    category,
+    groups,
+    methods,
+    dynamic,
+    requiresAuth,
+    fixtureParams,
+    actions,
+    tags: tagsForRoute({ kind, routePath: normalizedRoutePath, category, groups, dynamic, requiresAuth }),
+    priority: priorityForRoute(normalizedRoutePath, category, kind)
+  };
+}
+function normalizeRouteSegment(segment) {
+  if (segment.startsWith("[[...") && segment.endsWith("]]")) {
+    return `:${segment.slice(5, -2)}*?`;
+  }
+  if (segment.startsWith("[...") && segment.endsWith("]")) {
+    return `:${segment.slice(4, -1)}*`;
+  }
+  if (segment.startsWith("[") && segment.endsWith("]")) {
+    return `:${segment.slice(1, -1)}`;
+  }
+  return segment;
+}
+function extractRouteMethods(source) {
+  const methods = new Set;
+  const pattern = /\b(?:export\s+)?(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\b|\bexport\s+const\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\b/g;
+  for (const match of source.matchAll(pattern)) {
+    const method = match[1] ?? match[2];
+    if (method)
+      methods.add(method);
+  }
+  return [...methods].sort();
+}
+function collectRouteSources(rootDir, entryFile) {
+  const seen = new Set;
+  const sources = [];
+  function visit(file, depth) {
+    if (seen.has(file) || sources.length >= IMPORT_SCAN_LIMIT)
+      return;
+    if (!existsSync18(file) || !statSync4(file).isFile())
+      return;
+    seen.add(file);
+    const source = readFileSync9(file, "utf8");
+    sources.push({ file: relative4(rootDir, file), source });
+    if (depth >= IMPORT_SCAN_DEPTH)
+      return;
+    for (const specifier of localImportSpecifiers(source)) {
+      const resolved = resolveImportFile(file, specifier);
+      if (resolved)
+        visit(resolved, depth + 1);
+    }
+  }
+  visit(entryFile, 0);
+  return sources;
+}
+function localImportSpecifiers(source) {
+  const specifiers = [];
+  const pattern = /\bimport\b(?:[\s\S]*?\bfrom\s*)?["'](\.{1,2}\/[^"']+)["']|\bimport\(\s*["'](\.{1,2}\/[^"']+)["']\s*\)/g;
+  for (const match of source.matchAll(pattern)) {
+    const specifier = match[1] ?? match[2];
+    if (specifier)
+      specifiers.push(specifier);
+  }
+  return specifiers;
+}
+function resolveImportFile(fromFile, specifier) {
+  const base = resolve3(join20(fromFile, ".."), specifier);
+  const candidates = [
+    base,
+    ...SOURCE_EXTENSIONS.map((ext) => `${base}${ext}`),
+    ...SOURCE_EXTENSIONS.map((ext) => join20(base, `index${ext}`))
+  ];
+  return candidates.find((candidate) => existsSync18(candidate) && statSync4(candidate).isFile()) ?? null;
+}
+function extractPageActions(rootDir, sources, fixtureParams) {
+  const actions = [];
+  for (const source of sources) {
+    actions.push(...extractLinkedActions(source, fixtureParams));
+    actions.push(...extractButtonActions(source, fixtureParams));
+    actions.push(...extractFormActions(source, fixtureParams));
+    actions.push(...extractInputActions(source, fixtureParams));
+  }
+  const deduped = new Map;
+  for (const action of actions) {
+    const key = [
+      action.kind,
+      normalizeLabel(action.label),
+      action.target ?? "",
+      action.sourceFile
+    ].join("|");
+    if (!deduped.has(key))
+      deduped.set(key, action);
+  }
+  return [...deduped.values()].sort((a2, b2) => `${a2.kind}:${a2.label}:${a2.target ?? ""}`.localeCompare(`${b2.kind}:${b2.label}:${b2.target ?? ""}`)).slice(0, 40).map((action) => ({ ...action, sourceFile: relative4(rootDir, resolve3(rootDir, action.sourceFile)) }));
+}
+function extractLinkedActions(source, fixtureParams) {
+  const actions = [];
+  const pattern = /<(Link|a)\b([^>]*)>([\s\S]*?)<\/\1>/g;
+  for (const match of source.source.matchAll(pattern)) {
+    const attrs = match[2] ?? "";
+    const body = match[3] ?? "";
+    const href = attributeValue(attrs, "href");
+    const label = firstNonEmpty(attributeValue(attrs, "aria-label"), attributeValue(attrs, "title"), textFromJsx(body), href);
+    if (!label)
+      continue;
+    actions.push({
+      kind: "link",
+      label: clamp(label),
+      target: href ? clamp(href, 180) : undefined,
+      sourceFile: source.file,
+      destructive: isDestructiveAction(label, href ?? ""),
+      requiresFixture: requiresFixture(href ?? "", fixtureParams)
+    });
+  }
+  return actions;
+}
+function extractButtonActions(source, fixtureParams) {
+  const actions = [];
+  const pattern = /<(button|Button|IconButton|DropdownMenuItem|CommandItem|SelectItem|TabsTrigger)\b([^>]*?)(?:>([\s\S]*?)<\/\1>|\/>)/g;
+  for (const match of source.source.matchAll(pattern)) {
+    const attrs = match[2] ?? "";
+    const body = match[3] ?? "";
+    const label = firstNonEmpty(attributeValue(attrs, "aria-label"), attributeValue(attrs, "title"), attributeValue(attrs, "data-testid"), textFromJsx(body), attributeValue(attrs, "value"));
+    if (!label)
+      continue;
+    const target = attributeValue(attrs, "href") ?? attributeValue(attrs, "data-testid");
+    actions.push({
+      kind: "button",
+      label: clamp(label),
+      target: target ? clamp(target, 180) : undefined,
+      sourceFile: source.file,
+      destructive: isDestructiveAction(label, attrs),
+      requiresFixture: requiresFixture(`${label} ${target ?? ""}`, fixtureParams)
+    });
+  }
+  return actions;
+}
+function extractFormActions(source, fixtureParams) {
+  const actions = [];
+  const pattern = /<form\b([^>]*)>/g;
+  for (const match of source.source.matchAll(pattern)) {
+    const attrs = match[1] ?? "";
+    const label = firstNonEmpty(attributeValue(attrs, "aria-label"), attributeValue(attrs, "name"), attributeValue(attrs, "data-testid"), attributeValue(attrs, "action"), `form in ${source.file}`);
+    const target = attributeValue(attrs, "action");
+    actions.push({
+      kind: "form",
+      label: clamp(label),
+      target: target ? clamp(target, 180) : undefined,
+      sourceFile: source.file,
+      destructive: isDestructiveAction(label, attrs),
+      requiresFixture: requiresFixture(`${label} ${target ?? ""}`, fixtureParams)
+    });
+  }
+  return actions;
+}
+function extractInputActions(source, fixtureParams) {
+  const actions = [];
+  const pattern = /<(input|Input|Textarea|Select|Combobox)\b([^>]*?)(?:\/>|>)/g;
+  for (const match of source.source.matchAll(pattern)) {
+    const attrs = match[2] ?? "";
+    const label = firstNonEmpty(attributeValue(attrs, "aria-label"), attributeValue(attrs, "placeholder"), attributeValue(attrs, "name"), attributeValue(attrs, "data-testid"));
+    if (!label)
+      continue;
+    actions.push({
+      kind: "input",
+      label: clamp(label),
+      target: attributeValue(attrs, "name") ?? attributeValue(attrs, "data-testid") ?? undefined,
+      sourceFile: source.file,
+      destructive: false,
+      requiresFixture: requiresFixture(label, fixtureParams)
+    });
+  }
+  return actions;
+}
+function attributeValue(attrs, name) {
+  const pattern = new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|\\{\\s*["']([^"']+)["']\\s*\\})`, "i");
+  const match = attrs.match(pattern);
+  const value = match?.[1] ?? match?.[2] ?? match?.[3];
+  return value?.trim() || undefined;
+}
+function textFromJsx(value) {
+  const text = value.replace(/<[^>]+>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
+  return text || undefined;
+}
+function firstNonEmpty(...values) {
+  return values.find((value) => value && value.trim())?.trim() ?? "";
+}
+function clamp(value, max = 120) {
+  const compact = value.replace(/\s+/g, " ").trim();
+  return compact.length > max ? `${compact.slice(0, max - 1)}\u2026` : compact;
+}
+function normalizeLabel(value) {
+  return value.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function extractFixtureParams(routePath) {
+  const params = new Set;
+  for (const match of routePath.matchAll(/:([A-Za-z0-9_]+)(?:\*\??)?/g)) {
+    if (match[1])
+      params.add(match[1]);
+  }
+  return [...params];
+}
+function requiresFixture(value, fixtureParams) {
+  if (fixtureParams.length === 0)
+    return false;
+  const normalized = value.toLowerCase();
+  return fixtureParams.some((param) => normalized.includes(param.toLowerCase()) || normalized.includes(`[${param}]`));
+}
+function isDestructiveAction(label, context = "") {
+  return /\b(delete|destroy|remove|revoke|refund|void|archive|suspend|pause|disable|cancel|reset|purge|terminate)\b/i.test(`${label} ${context}`);
+}
+function formatActionStep(action) {
+  const target = action.target ? ` (${action.target})` : "";
+  const fixture = action.requiresFixture ? " after binding fixture values" : "";
+  const guard = action.destructive ? " without confirming the destructive final action" : "";
+  if (action.kind === "api-method") {
+    return `Exercise API method ${action.label}${target}${fixture}${guard}.`;
+  }
+  return `Exercise ${action.kind} "${action.label}"${target}${fixture}${guard}.`;
+}
+function classifyRoute(routePath, groups, file) {
+  const haystack = `${routePath} ${groups.join(" ")} ${file}`.toLowerCase();
+  if (haystack.includes("admin"))
+    return "admin";
+  if (haystack.includes("auth") || routePath.startsWith("/cli/device"))
+    return "auth";
+  if (haystack.includes("ai-runtime") || /\/(chat|sessions|memories|knowledge|learning|copilot|guardrails)\b/.test(routePath))
+    return "ai-runtime";
+  if (haystack.includes("commerce") || /\/(billing|shop|agent-wallet|domains|whois-profiles)\b/.test(routePath))
+    return "commerce";
+  if (haystack.includes("communications") || /\/(telephony|emails)\b/.test(routePath))
+    return "communications";
+  if (haystack.includes("crm") || routePath.includes("/contacts"))
+    return "crm";
+  if (haystack.includes("integrations") || routePath.includes("/connectors"))
+    return "integrations";
+  if (haystack.includes("dashboard") || routePath.includes(":orgSlug"))
+    return "dashboard";
+  if (haystack.includes("public") || haystack.includes("pages"))
+    return "public";
+  if (routePath.startsWith("/api/"))
+    return "api";
+  return "app";
+}
+function inferRequiresAuth(routePath, groups, kind) {
+  const haystack = `${routePath} ${groups.join(" ")}`.toLowerCase();
+  if (haystack.includes("auth") || haystack.includes("public") || haystack.includes("webhook"))
+    return false;
+  if (routePath.startsWith("/api/v1/auth/"))
+    return false;
+  if (routePath.startsWith("/api/"))
+    return true;
+  return kind === "page" && (haystack.includes("admin") || haystack.includes("dashboard") || routePath.includes(":orgSlug") || routePath.startsWith("/settings"));
+}
+function tagsForRoute(input) {
+  const tags = new Set([
+    "next-route",
+    `route:${input.kind}`,
+    `area:${input.category}`,
+    input.category
+  ]);
+  for (const group of input.groups)
+    tags.add(`group:${group}`);
+  if (input.dynamic)
+    tags.add("dynamic-route");
+  if (input.requiresAuth)
+    tags.add("auth-required");
+  if (input.routePath.startsWith("/api/"))
+    tags.add("api");
+  return [...tags];
+}
+function priorityForRoute(routePath, category, kind) {
+  if (category === "auth")
+    return "critical";
+  if (category === "commerce" || category === "ai-runtime")
+    return "critical";
+  if (category === "admin" || category === "dashboard")
+    return "high";
+  if (kind === "api")
+    return "high";
+  if (routePath === "/" || category === "public")
+    return "medium";
+  return "medium";
+}
+var ROUTE_FILE_NAMES, WALK_EXCLUDES, SAFE_PAGE_ASSERTIONS, IMPORT_SCAN_LIMIT = 40, IMPORT_SCAN_DEPTH = 3, SOURCE_EXTENSIONS;
+var init_next_route_inventory = __esm(() => {
+  init_scenarios();
+  init_workflows();
+  ROUTE_FILE_NAMES = new Set([
+    "page.tsx",
+    "page.ts",
+    "page.jsx",
+    "page.js",
+    "page.mdx",
+    "route.ts",
+    "route.js"
+  ]);
+  WALK_EXCLUDES = new Set([
+    ".git",
+    ".next",
+    ".turbo",
+    "node_modules",
+    "dist",
+    "build",
+    "coverage"
+  ]);
+  SAFE_PAGE_ASSERTIONS = [{ type: "no_console_errors" }];
+  SOURCE_EXTENSIONS = [
+    ".tsx",
+    ".ts",
+    ".jsx",
+    ".js",
+    ".mdx"
+  ];
+});
+
 // src/lib/generator.ts
 var exports_generator = {};
 __export(exports_generator, {
@@ -59448,7 +59953,7 @@ async function recordSession(url, options) {
   await Promise.race([
     page.waitForEvent("close").catch(() => {}),
     context.waitForEvent("close").catch(() => {}),
-    new Promise((resolve3) => setTimeout(resolve3, timeout))
+    new Promise((resolve4) => setTimeout(resolve4, timeout))
   ]);
   clearInterval(pollInterval);
   try {
@@ -77016,7 +77521,7 @@ function createProviderToolFactoryWithOutputSchema({
     supportsDeferredResults
   });
 }
-async function resolve3(value) {
+async function resolve4(value) {
   if (typeof value === "function") {
     value = value();
   }
@@ -78703,7 +79208,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
     try {
       const { value } = await getFromApi({
         url: `${this.config.baseURL}/config`,
-        headers: await resolve3(this.config.headers()),
+        headers: await resolve4(this.config.headers()),
         successfulResponseHandler: createJsonResponseHandler(gatewayAvailableModelsResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: exports_external2.any(),
@@ -78721,7 +79226,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
       const baseUrl = new URL(this.config.baseURL);
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/credits`,
-        headers: await resolve3(this.config.headers()),
+        headers: await resolve4(this.config.headers()),
         successfulResponseHandler: createJsonResponseHandler(gatewayCreditsResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: exports_external2.any(),
@@ -78767,7 +79272,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
       }
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/report?${searchParams.toString()}`,
-        headers: await resolve3(this.config.headers()),
+        headers: await resolve4(this.config.headers()),
         successfulResponseHandler: createJsonResponseHandler(gatewaySpendReportResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: exports_external2.any(),
@@ -78789,7 +79294,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
       const baseUrl = new URL(this.config.baseURL);
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/generation?id=${encodeURIComponent(params.id)}`,
-        headers: await resolve3(this.config.headers()),
+        headers: await resolve4(this.config.headers()),
         successfulResponseHandler: createJsonResponseHandler(gatewayGenerationInfoResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: exports_external2.any(),
@@ -78822,7 +79327,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
   async doGenerate(options) {
     const { args, warnings } = await this.getArgs(options);
     const { abortSignal } = options;
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const {
         responseHeaders,
@@ -78830,7 +79335,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
         rawValue: rawResponse
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, false), await resolve3(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, false), await resolve4(this.config.o11yHeaders)),
         body: args,
         successfulResponseHandler: createJsonResponseHandler(exports_external2.any()),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -78853,11 +79358,11 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
   async doStream(options) {
     const { args, warnings } = await this.getArgs(options);
     const { abortSignal } = options;
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const { value: response, responseHeaders } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, true), await resolve3(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, true), await resolve4(this.config.o11yHeaders)),
         body: args,
         successfulResponseHandler: createEventSourceResponseHandler(exports_external2.any()),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -78942,7 +79447,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
     providerOptions
   }) {
     var _a92;
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const {
         responseHeaders,
@@ -78950,7 +79455,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve3(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve4(this.config.o11yHeaders)),
         body: {
           values,
           ...providerOptions ? { providerOptions } : {}
@@ -79006,7 +79511,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
     abortSignal
   }) {
     var _a92, _b92, _c2, _d2;
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const {
         responseHeaders,
@@ -79014,7 +79519,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve3(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve4(this.config.o11yHeaders)),
         body: {
           prompt,
           n: n2,
@@ -79089,11 +79594,11 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
     abortSignal
   }) {
     var _a92;
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve3(this.config.o11yHeaders), { accept: "text/event-stream" }),
+        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve4(this.config.o11yHeaders), { accept: "text/event-stream" }),
         body: {
           prompt,
           n: n2,
@@ -79216,7 +79721,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
     abortSignal,
     providerOptions
   }) {
-    const resolvedHeaders = await resolve3(this.config.headers());
+    const resolvedHeaders = await resolve4(this.config.headers());
     try {
       const {
         responseHeaders,
@@ -79224,7 +79729,7 @@ var import_oidc, import_oidc2, marker17 = "vercel.ai.gateway.error", symbol18, _
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve3(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers != null ? headers : {}, this.getModelConfigHeaders(), await resolve4(this.config.o11yHeaders)),
         body: {
           documents,
           query,
@@ -88642,7 +89147,7 @@ var import_api2, import_api3, __defProp4, __export4 = (target, all) => {
   const schema = asSchema(inputSchema);
   return {
     name: "object",
-    responseFormat: resolve3(schema.jsonSchema).then((jsonSchema2) => ({
+    responseFormat: resolve4(schema.jsonSchema).then((jsonSchema2) => ({
       type: "json",
       schema: jsonSchema2,
       ...name21 != null && { name: name21 },
@@ -88703,7 +89208,7 @@ var import_api2, import_api3, __defProp4, __export4 = (target, all) => {
   const elementSchema = asSchema(inputElementSchema);
   return {
     name: "array",
-    responseFormat: resolve3(elementSchema.jsonSchema).then((jsonSchema2) => {
+    responseFormat: resolve4(elementSchema.jsonSchema).then((jsonSchema2) => {
       const { $schema, ...itemSchema } = jsonSchema2;
       return {
         type: "json",
@@ -91600,9 +92105,9 @@ var import_api2, import_api3, __defProp4, __export4 = (target, all) => {
     ...options
   }) {
     var _a21, _b16, _c2, _d2, _e2;
-    const resolvedBody = await resolve3(this.body);
-    const resolvedHeaders = await resolve3(this.headers);
-    const resolvedCredentials = await resolve3(this.credentials);
+    const resolvedBody = await resolve4(this.body);
+    const resolvedHeaders = await resolve4(this.headers);
+    const resolvedCredentials = await resolve4(this.credentials);
     const baseHeaders = {
       ...normalizeHeaders(resolvedHeaders),
       ...normalizeHeaders(options.headers)
@@ -91650,9 +92155,9 @@ var import_api2, import_api3, __defProp4, __export4 = (target, all) => {
   }
   async reconnectToStream(options) {
     var _a21, _b16, _c2, _d2, _e2;
-    const resolvedBody = await resolve3(this.body);
-    const resolvedHeaders = await resolve3(this.headers);
-    const resolvedCredentials = await resolve3(this.credentials);
+    const resolvedBody = await resolve4(this.body);
+    const resolvedHeaders = await resolve4(this.headers);
+    const resolvedCredentials = await resolve4(this.credentials);
     const baseHeaders = {
       ...normalizeHeaders(resolvedHeaders),
       ...normalizeHeaders(options.headers)
@@ -93873,7 +94378,7 @@ __export(exports_session_converter, {
   convertSessionToScenario: () => convertSessionToScenario,
   convertSessionFile: () => convertSessionFile
 });
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { extname } from "path";
 function parseRrwebSession(events) {
   const result = [];
@@ -94058,7 +94563,7 @@ ${condensed}`;
   };
 }
 async function convertSessionFile(filePath, format, options) {
-  const raw = readFileSync9(filePath, "utf-8");
+  const raw = readFileSync10(filePath, "utf-8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -94092,7 +94597,7 @@ function detectSessionFormat(filePath) {
   if (ext === ".har")
     return "har";
   try {
-    const content = readFileSync9(filePath, "utf-8").trim();
+    const content = readFileSync10(filePath, "utf-8").trim();
     const parsed = JSON.parse(content);
     if (Array.isArray(parsed) && parsed[0]?.type !== undefined && typeof parsed[0]?.timestamp === "number") {
       return "rrweb";
@@ -94536,7 +95041,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.48",
+  version: "0.0.50",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -94635,9 +95140,9 @@ init_todos_connector();
 init_browser();
 import { render, Box, Text, useInput, useApp } from "ink";
 import React, { useState } from "react";
-import { readFileSync as readFileSync10, readdirSync as readdirSync6, writeFileSync as writeFileSync7 } from "fs";
+import { readFileSync as readFileSync11, readdirSync as readdirSync7, writeFileSync as writeFileSync7 } from "fs";
 import { createInterface } from "readline";
-import { join as join20, resolve as resolve4 } from "path";
+import { join as join21, resolve as resolve5 } from "path";
 
 // src/lib/init.ts
 init_paths();
@@ -96723,7 +97228,7 @@ init_ci();
 init_assertions();
 init_paths();
 init_sessions();
-import { existsSync as existsSync18, mkdirSync as mkdirSync15 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync15 } from "fs";
 
 // src/lib/repo-discovery.ts
 init_paths();
@@ -97742,18 +98247,18 @@ program2.command("prod-debug <target>").description("Create a safe production de
   }, config2.prodDebug);
   const output = opts.json ? JSON.stringify(plan, null, 2) : formatProdDebugPlan(plan);
   if (opts.output) {
-    writeFileSync7(resolve4(opts.output), output + `
+    writeFileSync7(resolve5(opts.output), output + `
 `);
   } else {
     log(output);
   }
 });
 var CONFIG_DIR5 = getTestersDir();
-var CONFIG_PATH4 = join20(CONFIG_DIR5, "config.json");
+var CONFIG_PATH4 = join21(CONFIG_DIR5, "config.json");
 function getActiveProject() {
   try {
-    if (existsSync18(CONFIG_PATH4)) {
-      const raw = JSON.parse(readFileSync10(CONFIG_PATH4, "utf-8"));
+    if (existsSync19(CONFIG_PATH4)) {
+      const raw = JSON.parse(readFileSync11(CONFIG_PATH4, "utf-8"));
       return raw.activeProject ?? undefined;
     }
   } catch {}
@@ -97960,7 +98465,7 @@ program2.command("delete <id>").description("Delete a scenario").option("-y, --y
     }
     if (!opts.yes) {
       process.stdout.write(chalk6.yellow(`Delete scenario ${scenario.shortId} "${scenario.name}"? [y/N] `));
-      const answer = await new Promise((resolve5) => {
+      const answer = await new Promise((resolve6) => {
         let buf = "";
         process.stdin.setRawMode?.(true);
         process.stdin.resume();
@@ -97970,7 +98475,7 @@ program2.command("delete <id>").description("Delete a scenario").option("-y, --y
           process.stdin.pause();
           process.stdout.write(`
 `);
-          resolve5(buf);
+          resolve6(buf);
         });
       });
       if (answer !== "y" && answer !== "yes") {
@@ -97999,7 +98504,7 @@ program2.command("remove <id>").alias("uninstall").description("Remove a scenari
     }
     if (!opts.yes) {
       process.stdout.write(chalk6.yellow(`Remove scenario ${scenario.shortId} "${scenario.name}"? [y/N] `));
-      const answer = await new Promise((resolve5) => {
+      const answer = await new Promise((resolve6) => {
         let buf = "";
         process.stdin.setRawMode?.(true);
         process.stdin.resume();
@@ -98009,7 +98514,7 @@ program2.command("remove <id>").alias("uninstall").description("Remove a scenari
           process.stdin.pause();
           process.stdout.write(`
 `);
-          resolve5(buf);
+          resolve6(buf);
         });
       });
       if (answer !== "y" && answer !== "yes") {
@@ -98212,7 +98717,7 @@ program2.command("run [url] [description]").alias("test").description("Run test
 `);
           }
         };
-        await new Promise((resolve5) => {
+        await new Promise((resolve6) => {
           const poll = setInterval(() => {
             const run3 = getRun(runId);
             if (!run3)
@@ -98220,7 +98725,7 @@ program2.command("run [url] [description]").alias("test").description("Run test
             renderTable();
             if (DONE_STATUSES.has(run3.status)) {
               clearInterval(poll);
-              resolve5();
+              resolve6();
             }
           }, POLL_INTERVAL);
         });
@@ -98615,15 +99120,15 @@ program2.command("screenshots <id>").description("List screenshots for a run or
 });
 program2.command("import <dir>").description("Import markdown test files as scenarios").action((dir) => {
   try {
-    const absDir = resolve4(dir);
-    const files = readdirSync6(absDir).filter((f2) => f2.endsWith(".md"));
+    const absDir = resolve5(dir);
+    const files = readdirSync7(absDir).filter((f2) => f2.endsWith(".md"));
     if (files.length === 0) {
       log(chalk6.dim("No .md files found in directory."));
       return;
     }
     let imported = 0;
     for (const file2 of files) {
-      const content = readFileSync10(join20(absDir, file2), "utf-8");
+      const content = readFileSync11(join21(absDir, file2), "utf-8");
       const lines = content.split(`
 `);
       let name21 = file2.replace(/\.md$/, "");
@@ -98679,11 +99184,11 @@ program2.command("export [format]").description("Export scenarios as JSON (defau
       const outputPath = opts.output ?? "testers-export.json";
       const data = JSON.stringify(scenarios, null, 2);
       writeFileSync7(outputPath, data, "utf-8");
-      log(chalk6.green(`Exported ${scenarios.length} scenario(s) to ${resolve4(outputPath)}`));
+      log(chalk6.green(`Exported ${scenarios.length} scenario(s) to ${resolve5(outputPath)}`));
       return;
     }
     const outputDir = opts.output ?? ".";
-    if (!existsSync18(outputDir)) {
+    if (!existsSync19(outputDir)) {
       mkdirSync15(outputDir, { recursive: true });
     }
     for (const s2 of scenarios) {
@@ -98711,13 +99216,13 @@ program2.command("export [format]").description("Export scenarios as JSON (defau
         lines.push("");
       }
       const safeFilename = s2.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 80);
-      const filePath = join20(outputDir, `${s2.shortId}-${safeFilename}.md`);
+      const filePath = join21(outputDir, `${s2.shortId}-${safeFilename}.md`);
       writeFileSync7(filePath, lines.join(`
 `), "utf-8");
       log(chalk6.dim(`  ${s2.shortId}: ${s2.name} \u2192 ${filePath}`));
     }
     log(chalk6.green(`
-Exported ${scenarios.length} scenario(s) as markdown to ${resolve4(outputDir)}`));
+Exported ${scenarios.length} scenario(s) as markdown to ${resolve5(outputDir)}`));
   } catch (error40) {
     logError(chalk6.red(`Error: ${error40 instanceof Error ? error40.message : String(error40)}`));
     process.exit(1);
@@ -98736,7 +99241,7 @@ program2.command("status").description("Show database and auth status").action((
   try {
     const config2 = loadConfig();
     const hasApiKey = !!config2.anthropicApiKey || !!process.env["ANTHROPIC_API_KEY"];
-    const dbPath = join20(getTestersDir(), "testers.db");
+    const dbPath = join21(getTestersDir(), "testers.db");
     log("");
     log(chalk6.bold("  Open Testers Status"));
     log("");
@@ -98886,13 +99391,13 @@ projectCmd.command("export-open <id>").description("Register a testers project i
 projectCmd.command("use <name>").description("Set active project (find or create)").option("--json", "Output as JSON", false).action((name21, opts) => {
   try {
     const project = ensureProject(name21, process.cwd());
-    if (!existsSync18(CONFIG_DIR5)) {
+    if (!existsSync19(CONFIG_DIR5)) {
       mkdirSync15(CONFIG_DIR5, { recursive: true });
     }
     let config2 = {};
-    if (existsSync18(CONFIG_PATH4)) {
+    if (existsSync19(CONFIG_PATH4)) {
       try {
-        config2 = JSON.parse(readFileSync10(CONFIG_PATH4, "utf-8"));
+        config2 = JSON.parse(readFileSync11(CONFIG_PATH4, "utf-8"));
       } catch {}
     }
     config2.activeProject = project.id;
@@ -98910,7 +99415,7 @@ projectCmd.command("use <name>").description("Set active project (find or create
 var repoCmd = program2.command("repo").description("Discover and run repo-native Playwright tests");
 repoCmd.command("discover [path]").alias("scan").description("Discover Playwright tests in a repo").option("--refresh", "Force a fresh scan, ignoring cache", false).option("--json", "Output as JSON", false).option("--base-url <url>", "Override the suggested base URL").action((path, opts) => {
   try {
-    const repoPath = resolve4(path ?? process.cwd());
+    const repoPath = resolve5(path ?? process.cwd());
     const snapshot = discoverRepo({
       repoPath,
       refresh: opts.refresh,
@@ -98976,7 +99481,7 @@ repoCmd.command("discover [path]").alias("scan").description("Discover Playwrigh
 });
 repoCmd.command("prepare [path]").alias("prep").description("Install dependencies and browsers for repo tests").option("--all", "Run all prep steps (install, browsers, build, seed)", false).option("--install", "Install dependencies", false).option("--browsers", "Install Playwright browsers", false).option("--build", "Build the app", false).option("--seed", "Seed the database", false).option("--refresh", "Force fresh discovery scan", false).option("--json", "Output as JSON", false).action((path, opts) => {
   try {
-    const repoPath = resolve4(path ?? process.cwd());
+    const repoPath = resolve5(path ?? process.cwd());
     const snapshot = discoverRepo({ repoPath, refresh: opts.refresh });
     const steps = [];
     if (opts.all) {
@@ -99054,7 +99559,7 @@ repoCmd.command("run [path]").description("Run discovered Playwright tests nativ
   return acc;
 }, []).option("--timeout <ms>", "Timeout per spec file", "300000").option("--url <url>", "Dev server URL").option("--project <id>", "Project ID for result storage").option("--label <text>", "Run label").option("--json", "Output as JSON", false).action(async (path, opts) => {
   try {
-    const repoPath = resolve4(path ?? process.cwd());
+    const repoPath = resolve5(path ?? process.cwd());
     const snapshot = discoverRepo({
       repoPath,
       refresh: opts.refresh,
@@ -99120,7 +99625,7 @@ repoCmd.command("run [path]").description("Run discovered Playwright tests nativ
 repoCmd.command("cache [path]").description("Manage discovery cache").option("--clear", "Clear discovery cache", false).option("--status", "Show cache status", false).action((path, opts) => {
   try {
     if (opts.clear) {
-      const repoPath2 = path ? resolve4(path) : undefined;
+      const repoPath2 = path ? resolve5(path) : undefined;
       clearDiscoveryCache(repoPath2);
       if (repoPath2) {
         log(chalk6.green("Discovery cache cleared for this repo."));
@@ -99130,7 +99635,7 @@ repoCmd.command("cache [path]").description("Manage discovery cache").option("--
       return;
     }
     if (opts.status) {
-      const repoPath2 = resolve4(path ?? process.cwd());
+      const repoPath2 = resolve5(path ?? process.cwd());
       const info2 = getDiscoveryCacheInfo(repoPath2);
       if (!info2) {
         log(chalk6.dim("No discovery cache for this repo."));
@@ -99144,7 +99649,7 @@ repoCmd.command("cache [path]").description("Manage discovery cache").option("--
       log("");
       return;
     }
-    const repoPath = resolve4(path ?? process.cwd());
+    const repoPath = resolve5(path ?? process.cwd());
     const info = getDiscoveryCacheInfo(repoPath);
     if (!info) {
       log(chalk6.dim("No discovery cache. Run 'testers repo discover' to create one."));
@@ -99233,8 +99738,8 @@ sessionCmd.command("show <id>").description("Show details of a recorded session"
 });
 sessionCmd.command("import <file>").description("Import a session JSON file exported from the Chrome extension").action(async (file2) => {
   try {
-    const { readFileSync: readFileSync11 } = await import("fs");
-    const raw = readFileSync11(file2, "utf-8");
+    const { readFileSync: readFileSync12 } = await import("fs");
+    const raw = readFileSync12(file2, "utf-8");
     const data = JSON.parse(raw);
     const items = Array.isArray(data) ? data : [data];
     const { createSession: createSession2 } = await Promise.resolve().then(() => (init_sessions(), exports_sessions));
@@ -99474,7 +99979,7 @@ program2.command("daemon").description("Start the scheduler daemon").option("--i
         } catch (err) {
           logError(chalk6.red(`Daemon error: ${err instanceof Error ? err.message : String(err)}`));
         }
-        await new Promise((resolve5) => setTimeout(resolve5, intervalMs));
+        await new Promise((resolve6) => setTimeout(resolve6, intervalMs));
       }
     };
     process.on("SIGINT", () => {
@@ -99503,9 +100008,9 @@ program2.command("ci [provider]").description("Print or write a CI workflow (def
   }
   const workflow = generateGitHubActionsWorkflow();
   if (opts.output) {
-    const outPath = resolve4(opts.output);
+    const outPath = resolve5(opts.output);
     const outDir = outPath.replace(/\/[^/]*$/, "");
-    if (outDir && !existsSync18(outDir)) {
+    if (outDir && !existsSync19(outDir)) {
       mkdirSync15(outDir, { recursive: true });
     }
     writeFileSync7(outPath, workflow, "utf-8");
@@ -99539,11 +100044,11 @@ program2.command("init").description("Initialize a new testing project").option(
       log(`    ${chalk6.dim(s2.shortId)} ${s2.name} ${chalk6.dim(`[${s2.tags.join(", ")}]`)}`);
     }
     if (opts.ci === "github") {
-      const workflowDir = join20(process.cwd(), ".github", "workflows");
-      if (!existsSync18(workflowDir)) {
+      const workflowDir = join21(process.cwd(), ".github", "workflows");
+      if (!existsSync19(workflowDir)) {
         mkdirSync15(workflowDir, { recursive: true });
       }
-      const workflowPath = join20(workflowDir, "testers.yml");
+      const workflowPath = join21(workflowDir, "testers.yml");
       writeFileSync7(workflowPath, generateGitHubActionsWorkflow(), "utf-8");
       log(`  CI:         ${chalk6.green("GitHub Actions workflow written to .github/workflows/testers.yml")}`);
     } else if (opts.ci) {
@@ -99553,7 +100058,7 @@ program2.command("init").description("Initialize a new testing project").option(
     if (opts.yes)
       return;
     const rl2 = createInterface({ input: process.stdin, output: process.stdout });
-    const ask = (q2) => new Promise((resolve5) => rl2.question(q2, resolve5));
+    const ask = (q2) => new Promise((resolve6) => rl2.question(q2, resolve6));
     try {
       const envAnswer = await ask("  Would you like to configure environments? [y/N] ");
       if (envAnswer.trim().toLowerCase() === "y") {
@@ -99737,14 +100242,14 @@ program2.command("quick-qa <url>").alias("quick-check").description("Run a fast
       wcagLevel
     });
     if (opts.output) {
-      writeFileSync7(resolve4(opts.output), JSON.stringify(result, null, 2));
+      writeFileSync7(resolve5(opts.output), JSON.stringify(result, null, 2));
     }
     if (opts.json) {
       log(JSON.stringify(result, null, 2));
     } else {
       log(formatQuickQaReport(result));
       if (opts.output)
-        log(chalk6.dim(`Wrote JSON results to ${resolve4(opts.output)}`));
+        log(chalk6.dim(`Wrote JSON results to ${resolve5(opts.output)}`));
     }
     process.exit(getQuickQaExitCode(result));
   } catch (error40) {
@@ -99789,7 +100294,7 @@ program2.command("report [run-id]").description("Generate HTML test report or co
       });
       if (opts.output && opts.output !== "report.html") {
         writeFileSync7(opts.output, content, "utf-8");
-        const absPath2 = resolve4(opts.output);
+        const absPath2 = resolve5(opts.output);
         log(chalk6.green(`Compliance report written to ${absPath2}`));
       } else {
         log(content);
@@ -99803,7 +100308,7 @@ program2.command("report [run-id]").description("Generate HTML test report or co
       html = generateHtmlReport(runId);
     }
     writeFileSync7(opts.output, html, "utf-8");
-    const absPath = resolve4(opts.output);
+    const absPath = resolve5(opts.output);
     log(chalk6.green(`Report generated: ${absPath}`));
     if (opts.open) {
       const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
@@ -100160,6 +100665,62 @@ Imported ${imported} scenarios from API spec:`));
     process.exit(1);
   }
 });
+var inventoryCmd = program2.command("inventory").description("Discover source-derived app route/action inventories");
+inventoryCmd.command("next [root]").description("Discover Next.js app routes and optionally import route coverage scenarios").option("--app-dir <path>", "Next.js app directory relative to root (default: packages/web/app or app)").option("--project <id>", "Project ID").option("--no-pages", "Do not include page.tsx/page.ts routes").option("--no-api", "Do not include route.ts/route.js API routes").option("--limit <n>", "Limit discovered routes").option("--create-scenarios", "Upsert source-derived route coverage scenarios", false).option("--create-workflows", "Upsert grouped workflows by area and route kind", false).option("--workflow-target <target>", "Workflow execution target: local or sandbox", "sandbox").option("--sandbox-provider <provider>", "Sandbox provider for created workflows", "e2b").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-env-optional <name>", "Optional sandbox env var; forwards host NAME only when set (repeatable)", (val, acc) => {
+  acc.push(val);
+  return acc;
+}, []).option("--timeout <ms>", "Workflow timeout in milliseconds").option("--json", "Output as JSON", false).action(async (root, opts) => {
+  try {
+    const { importNextRouteInventory: importNextRouteInventory2 } = await Promise.resolve().then(() => (init_next_route_inventory(), exports_next_route_inventory));
+    const projectId = resolveProject2(opts.project) ?? undefined;
+    const env = parseSandboxEnv(undefined, opts.sandboxEnvOptional);
+    const result = importNextRouteInventory2({
+      rootDir: root ?? process.cwd(),
+      appDir: opts.appDir,
+      projectId,
+      includePages: opts.pages !== false,
+      includeApi: opts.api !== false,
+      limit: opts.limit ? parseInt(opts.limit, 10) : undefined,
+      createScenarios: opts.createScenarios,
+      createWorkflows: opts.createWorkflows,
+      workflowTarget: opts.workflowTarget,
+      workflowProvider: opts.workflowTarget === "sandbox" ? opts.sandboxProvider : undefined,
+      workflowExecution: {
+        target: opts.workflowTarget,
+        provider: opts.workflowTarget === "sandbox" ? opts.sandboxProvider : undefined,
+        sandboxCleanup: opts.sandboxCleanup,
+        sandboxSyncStrategy: opts.sandboxSync,
+        timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+        env
+      }
+    });
+    if (opts.json) {
+      log(JSON.stringify(result, null, 2));
+      return;
+    }
+    log("");
+    log(chalk6.bold("  Next.js Route Inventory"));
+    log(chalk6.dim(`  Root: ${result.inventory.rootDir}`));
+    log(chalk6.dim(`  App:  ${result.inventory.appDir}`));
+    log("");
+    log(`  Routes: ${chalk6.cyan(String(result.inventory.total))} (${result.inventory.pages} pages, ${result.inventory.apiRoutes} API, ${result.inventory.dynamic} dynamic)`);
+    log(`  Scenarios: ${chalk6.green(String(result.created))} created, ${chalk6.yellow(String(result.updated))} updated, ${chalk6.dim(String(result.deduped))} deduped`);
+    log(`  Workflows: ${result.workflows.length}`);
+    log("");
+    for (const [category, count] of Object.entries(result.inventory.categories).sort()) {
+      log(`  ${category.padEnd(18)} ${count}`);
+    }
+    log("");
+    if (!opts.createScenarios)
+      log(chalk6.dim("  Add --create-scenarios to upsert route scenarios."));
+    if (!opts.createWorkflows)
+      log(chalk6.dim("  Add --create-workflows to upsert grouped workflows."));
+    log("");
+  } catch (error40) {
+    logError(chalk6.red(`Error: ${error40 instanceof Error ? error40.message : String(error40)}`));
+    process.exit(1);
+  }
+});
 program2.command("generate <url>").description("Crawl app and synthesize test scenarios using AI (any provider)").option("--max <n>", "Max scenarios to generate", "10").option("--max-pages <n>", "Max pages to crawl", "10").option("--focus <topic>", "Focus on specific area e.g. 'auth flows', 'checkout'").option("--persona <desc>", "Persona perspective e.g. 'first-time user'").option("--model <model>", "AI model (claude-haiku, gpt-4o-mini, gemini-2.0-flash, etc.)").option("--save", "Persist generated scenarios to DB", false).option("--project <id>", "Project ID").option("--headed", "Run browser in headed mode", false).option("--json", "Output as JSON", false).action(async (url2, opts) => {
   try {
     const { generateScenarios: generateScenarios2 } = await Promise.resolve().then(() => (init_generator(), exports_generator));
@@ -100622,7 +101183,7 @@ program2.command("doctor").description("Check system setup and configuration").a
     log(chalk6.red("\u2717") + " ANTHROPIC_API_KEY is not set (required for AI-powered tests)");
     allPassed = false;
   }
-  const dbPath = join20(getTestersDir(), "testers.db");
+  const dbPath = join21(getTestersDir(), "testers.db");
   try {
     const { Database: Database5 } = await import("bun:sqlite");
     const db3 = new Database5(dbPath, { create: true });
@@ -100676,7 +101237,7 @@ program2.command("serve").description("Start the Open Testers web dashboard").op
   try {
     const port = parseInt(opts.port, 10);
     const url2 = `http://localhost:${port}`;
-    const serverBin = join20(resolve4(process.execPath, ".."), "..", "dist", "server", "index.js");
+    const serverBin = join21(resolve5(process.execPath, ".."), "..", "dist", "server", "index.js");
     const { join: pathJoin, resolve: pathResolve, dirname: dirname7 } = await import("path");
     const { fileURLToPath: fileURLToPath2 } = await import("url");
     const serverPath = pathJoin(dirname7(fileURLToPath2(import.meta.url)), "..", "server", "index.js");
@@ -101442,7 +102003,7 @@ personaCmd.command("delete <id>").description("Delete a persona").option("-y, --
     }
     if (!opts.yes) {
       process.stdout.write(chalk6.yellow(`Delete persona ${persona.shortId} "${persona.name}"? [y/N] `));
-      const answer = await new Promise((resolve5) => {
+      const answer = await new Promise((resolve6) => {
         let buf = "";
         process.stdin.setRawMode?.(true);
         process.stdin.resume();
@@ -101452,7 +102013,7 @@ personaCmd.command("delete <id>").description("Delete a persona").option("-y, --
           process.stdin.pause();
           process.stdout.write(`
 `);
-          resolve5(buf);
+          resolve6(buf);
         });
       });
       if (answer !== "y" && answer !== "yes") {
@@ -101613,7 +102174,7 @@ evalCmd.command("rag <url>").description("Run RAG quality evaluation \u2014 fait
     let ragTestCases = [];
     if (opts.docs) {
       try {
-        const raw = readFileSync10(opts.docs, "utf-8");
+        const raw = readFileSync11(opts.docs, "utf-8");
         ragTestCases = JSON.parse(raw);
       } catch {
         logError(chalk6.red(`Failed to read docs file: ${opts.docs}`));
@@ -101703,9 +102264,9 @@ Created golden answer check ${chalk6.bold(golden2.shortId)}`));
     }
     const ask = (prompt) => {
       const rl2 = createInterface({ input: process.stdin, output: process.stdout });
-      return new Promise((resolve5) => rl2.question(prompt, (ans) => {
+      return new Promise((resolve6) => rl2.question(prompt, (ans) => {
         rl2.close();
-        resolve5(ans.trim());
+        resolve6(ans.trim());
       }));
     };
     const question = await ask("Question (what this endpoint should answer): ");
@@ -101866,9 +102427,9 @@ program2.command("run-many <url>").description("Run scenarios \xD7 personas matr
 });
 program2.command("run-script <file>").description("Run a hybrid test script (.ts) that exports an array of HybridScenario objects").option("--url <url>", "Base URL to run against").option("--json", "Output as JSON", false).action(async (file2, opts) => {
   try {
-    const { resolve: resolve5 } = await import("path");
+    const { resolve: resolve6 } = await import("path");
     const { runHybridScenario: runHybridScenario2 } = await Promise.resolve().then(() => (init_hybrid_runner(), exports_hybrid_runner));
-    const scriptPath = resolve5(process.cwd(), file2);
+    const scriptPath = resolve6(process.cwd(), file2);
     const mod = await import(scriptPath);
     const scenarios = mod.scenarios ?? mod.default ?? [];
     if (!Array.isArray(scenarios) || scenarios.length === 0) {

package/dist/lib/next-route-inventory.d.ts

@@ -0,0 +1,66 @@
+import type { CreateScenarioInput, Scenario, ScenarioPriority, TestingWorkflow, WorkflowExecutionInput } from "../types/index.js";
+export type NextRouteKind = "page" | "api";
+export type NextRouteActionKind = "link" | "button" | "form" | "input" | "api-method";
+export interface NextRouteAction {
+    kind: NextRouteActionKind;
+    label: string;
+    target?: string;
+    sourceFile: string;
+    destructive: boolean;
+    requiresFixture: boolean;
+}
+export interface NextRouteInventoryItem {
+    kind: NextRouteKind;
+    routePath: string;
+    file: string;
+    category: string;
+    groups: string[];
+    methods: string[];
+    dynamic: boolean;
+    requiresAuth: boolean;
+    fixtureParams: string[];
+    actions: NextRouteAction[];
+    tags: string[];
+    priority: ScenarioPriority;
+}
+export interface NextRouteInventory {
+    rootDir: string;
+    appDir: string;
+    total: number;
+    pages: number;
+    apiRoutes: number;
+    dynamic: number;
+    categories: Record<string, number>;
+    items: NextRouteInventoryItem[];
+}
+export interface ImportNextRouteInventoryOptions {
+    rootDir: string;
+    appDir?: string;
+    projectId?: string;
+    includePages?: boolean;
+    includeApi?: boolean;
+    limit?: number;
+    createScenarios?: boolean;
+    createWorkflows?: boolean;
+    workflowTarget?: "local" | "sandbox";
+    workflowProvider?: string;
+    workflowExecution?: Partial<WorkflowExecutionInput>;
+}
+export interface ImportNextRouteInventoryResult {
+    inventory: NextRouteInventory;
+    created: number;
+    updated: number;
+    deduped: number;
+    scenarios: Scenario[];
+    workflows: TestingWorkflow[];
+}
+export declare function discoverNextRouteInventory(options: {
+    rootDir: string;
+    appDir?: string;
+    includePages?: boolean;
+    includeApi?: boolean;
+    limit?: number;
+}): NextRouteInventory;
+export declare function scenarioInputForNextRoute(item: NextRouteInventoryItem, projectId?: string): CreateScenarioInput;
+export declare function importNextRouteInventory(options: ImportNextRouteInventoryOptions): ImportNextRouteInventoryResult;
+//# sourceMappingURL=next-route-inventory.d.ts.map

package/dist/lib/next-route-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-route-inventory.d.ts","sourceRoot":"","sources":["../../src/lib/next-route-inventory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAC3C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAkCD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,kBAAkB,CA4BrB;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,sBAAsB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CAwDrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuBhC"}

package/dist/mcp/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/testers",
-    version: "0.0.48",
+    version: "0.0.50",
     description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
     type: "module",
     main: "dist/index.js",

package/dist/server/index.js

@@ -46937,7 +46937,7 @@ import { join as join14 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.48",
+  version: "0.0.50",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/testers",
-  "version": "0.0.48",
+  "version": "0.0.50",
   "description": "AI-powered QA testing CLI — spawns cheap AI agents to test web apps with headless browsers",
   "type": "module",
   "main": "dist/index.js",