@hasna/testers 0.0.49 → 0.0.51

package/dist/cli/index.js

@@ -12394,6 +12394,18 @@ __export(exports_scenarios, {
   createScenario: () => createScenario,
   countScenarios: () => countScenarios
 });
+function stableJson(value) {
+  if (value === undefined)
+    return "";
+  if (value === null)
+    return "null";
+  if (Array.isArray(value))
+    return `[${value.map(stableJson).join(",")}]`;
+  if (typeof value === "object") {
+    return `{${Object.entries(value).filter(([, val]) => val !== undefined).sort(([a], [b]) => a.localeCompare(b)).map(([key, val]) => `${JSON.stringify(key)}:${stableJson(val)}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
 function nextShortId(projectId) {
   const db2 = getDatabase();
   if (projectId) {
@@ -12653,9 +12665,12 @@ function upsertScenario(input) {
   }
   const existingSteps = JSON.parse(existing.steps);
   const existingTags = JSON.parse(existing.tags);
+  const existingMetadata = existing.metadata ? JSON.parse(existing.metadata) : undefined;
+  const existingAssertions = JSON.parse(existing.assertions || "[]");
+  const existingParameters = existing.parameters ? JSON.parse(existing.parameters) : undefined;
   const newSteps = input.steps ?? [];
   const newTags = input.tags ?? [];
-  const isIdentical = existing.description === (input.description ?? "") && existingSteps.length === newSteps.length && existingSteps.every((s, i) => s === newSteps[i]) && existingTags.length === newTags.length && existingTags.every((t, i) => t === newTags[i]) && existing.priority === (input.priority ?? "medium");
+  const isIdentical = existing.description === (input.description ?? "") && existingSteps.length === newSteps.length && existingSteps.every((s, i) => s === newSteps[i]) && existingTags.length === newTags.length && existingTags.every((t, i) => t === newTags[i]) && existing.priority === (input.priority ?? "medium") && existing.target_path === (input.targetPath ?? null) && Boolean(existing.requires_auth) === Boolean(input.requiresAuth) && stableJson(existingMetadata) === stableJson(input.metadata) && stableJson(existingAssertions) === stableJson(input.assertions ?? []) && stableJson(existingParameters) === stableJson(input.parameters);
   if (isIdentical) {
     return { scenario: scenarioFromRow(existing), action: "deduped" };
   }
@@ -12705,6 +12720,10 @@ function upsertScenario(input) {
     sets.push("assertions = ?");
     params.push(JSON.stringify(input.assertions));
   }
+  if (input.parameters !== undefined) {
+    sets.push("parameters = ?");
+    params.push(JSON.stringify(input.parameters));
+  }
   sets.push("version = ?", "updated_at = ?");
   params.push(existing.version + 1, now());
   params.push(existing.id);
@@ -13057,6 +13076,159 @@ var init_screenshots = __esm(() => {
   init_database();
 });
 
+// src/lib/route-fixtures.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function envNameForParam(prefix, param) {
+  return `${prefix}_${param.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[^A-Za-z0-9]+/g, "_").toUpperCase()}`;
+}
+function readString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function resolveReference(value, env) {
+  if (value.startsWith("$?"))
+    return env[value.slice(2)]?.trim() || undefined;
+  if (value.startsWith("$"))
+    return env[value.slice(1)]?.trim() || undefined;
+  return value;
+}
+function scenarioFixtureValue(params, name, env) {
+  if (!params)
+    return;
+  const routeFixtures = isRecord2(params["routeFixtures"]) ? params["routeFixtures"] : {};
+  const raw = readString(routeFixtures[name]) ?? readString(params[name]);
+  return raw ? resolveReference(raw, env) : undefined;
+}
+function envFixtureValue(name, env) {
+  const candidates = [
+    envNameForParam("TESTERS_ROUTE", name),
+    envNameForParam("TESTERS_FIXTURE", name),
+    envNameForParam("ALUMIA_FIXTURE", name),
+    ...PARAM_ENV_CANDIDATES[name] ?? []
+  ];
+  for (const candidate of candidates) {
+    const value = env[candidate]?.trim();
+    if (value)
+      return value;
+  }
+  return;
+}
+function defaultFixtureValue(name) {
+  if (name === "orgSlug")
+    return "test-org";
+  if (name.toLowerCase().endsWith("slug")) {
+    return `test-${name.replace(/Slug$/i, "").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase() || "slug"}`;
+  }
+  if (name === "id" || name.toLowerCase().endsWith("id"))
+    return DEFAULT_UUID;
+  if (name.toLowerCase().includes("token"))
+    return "test-token";
+  return `test-${name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase()}`;
+}
+function routeParamsFromPath(path) {
+  if (!path)
+    return [];
+  const params = new Set;
+  for (const match of path.matchAll(/:([A-Za-z0-9_]+)(?:\*\??)?/g)) {
+    if (match[1])
+      params.add(match[1]);
+  }
+  return [...params];
+}
+function defaultRouteFixturesForParams(params) {
+  return Object.fromEntries(params.map((param) => [param, defaultFixtureValue(param)]));
+}
+function resolveRouteFixtures(scenario, env = process.env) {
+  const metadataParams = Array.isArray(scenario.metadata?.["fixtureParams"]) ? scenario.metadata["fixtureParams"].filter((value) => typeof value === "string") : [];
+  const params = [...new Set([...metadataParams, ...routeParamsFromPath(scenario.targetPath)])];
+  const values = {};
+  const sources = {};
+  const synthetic = [];
+  for (const param of params) {
+    const scenarioValue = scenarioFixtureValue(scenario.parameters, param, env);
+    if (scenarioValue) {
+      values[param] = scenarioValue;
+      sources[param] = "scenario";
+      continue;
+    }
+    const envValue = envFixtureValue(param, env);
+    if (envValue) {
+      values[param] = envValue;
+      sources[param] = "env";
+      continue;
+    }
+    values[param] = defaultFixtureValue(param);
+    sources[param] = "default";
+    synthetic.push(param);
+  }
+  const resolvedPath = scenario.targetPath ? resolveRoutePath(scenario.targetPath, values) : null;
+  return {
+    originalPath: scenario.targetPath,
+    resolvedPath,
+    params,
+    values,
+    sources,
+    synthetic
+  };
+}
+function resolveRoutePath(path, values) {
+  return path.replace(/\/:([A-Za-z0-9_]+)\*\?/g, (_match, name) => {
+    const value = values[name];
+    return value ? `/${encodeRouteFixture(value, true)}` : "";
+  }).replace(/:([A-Za-z0-9_]+)\*/g, (_match, name) => encodeRouteFixture(values[name] ?? defaultFixtureValue(name), true)).replace(/:([A-Za-z0-9_]+)/g, (_match, name) => encodeRouteFixture(values[name] ?? defaultFixtureValue(name), false));
+}
+function encodeRouteFixture(value, allowSlash) {
+  if (allowSlash)
+    return value.split("/").filter(Boolean).map(encodeURIComponent).join("/");
+  return encodeURIComponent(value);
+}
+function materializeScenarioRoute(scenario, env = process.env) {
+  const resolution = resolveRouteFixtures(scenario, env);
+  if (!resolution.resolvedPath || resolution.resolvedPath === scenario.targetPath) {
+    return { scenario, resolution };
+  }
+  const steps = scenario.steps.map((step) => {
+    let next = step;
+    for (const [name, value] of Object.entries(resolution.values)) {
+      next = next.replaceAll(`:${name}`, value).replaceAll(`[${name}]`, value).replaceAll(`{${name}}`, value);
+    }
+    return next.replaceAll(scenario.targetPath ?? "", resolution.resolvedPath ?? "");
+  });
+  return {
+    scenario: {
+      ...scenario,
+      targetPath: resolution.resolvedPath,
+      steps,
+      metadata: {
+        ...scenario.metadata ?? {},
+        routeFixtureResolution: resolution
+      }
+    },
+    resolution
+  };
+}
+function resolveStartUrl(baseUrl, targetPath) {
+  try {
+    return new URL(targetPath, baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).toString();
+  } catch {
+    return `${baseUrl.replace(/\/+$/, "")}/${targetPath.replace(/^\/+/, "")}`;
+  }
+}
+var DEFAULT_UUID = "00000000-0000-4000-8000-000000000000", PARAM_ENV_CANDIDATES;
+var init_route_fixtures = __esm(() => {
+  PARAM_ENV_CANDIDATES = {
+    orgSlug: ["TESTERS_ORG_SLUG", "SMOKE_ORG_SLUG", "ORG_SLUG"],
+    orgId: ["TESTERS_ORG_ID", "SMOKE_ORG_ID", "ORG_ID"],
+    projectSlug: ["TESTERS_PROJECT_SLUG", "SMOKE_PROJECT_SLUG", "PROJECT_SLUG"],
+    projectId: ["TESTERS_PROJECT_ID", "SMOKE_PROJECT_ID", "PROJECT_ID"],
+    workspaceId: ["TESTERS_WORKSPACE_ID", "SMOKE_WORKSPACE_ID", "WORKSPACE_ID"],
+    agentId: ["TESTERS_AGENT_ID", "SMOKE_AGENT_ID", "AGENT_ID"],
+    sessionId: ["TESTERS_SESSION_ID", "SMOKE_SESSION_ID", "SESSION_ID"],
+    userId: ["TESTERS_USER_ID", "SMOKE_USER_ID", "USER_ID"]
+  };
+});
+
 // src/lib/browser-lightpanda.ts
 var exports_browser_lightpanda = {};
 __export(exports_browser_lightpanda, {
@@ -14777,33 +14949,35 @@ ${filtered.join(`
     return { result: `Error executing ${toolName}: ${message}` };
   }
 }
-function resolveStartUrl(baseUrl, targetPath) {
-  try {
-    return new URL(targetPath, baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).toString();
-  } catch {
-    return `${baseUrl.replace(/\/+$/, "")}/${targetPath.replace(/^\/+/, "")}`;
-  }
-}
 function buildScenarioUserMessage(scenario, baseUrl) {
+  const { scenario: materializedScenario, resolution } = materializeScenarioRoute(scenario);
   const userParts = [
-    `**Scenario:** ${scenario.name}`,
-    `**Description:** ${scenario.description}`
+    `**Scenario:** ${materializedScenario.name}`,
+    `**Description:** ${materializedScenario.description}`
   ];
   if (baseUrl) {
     const normalizedBaseUrl = baseUrl.replace(/\/+$/, "");
     userParts.push(`**Base URL:** ${normalizedBaseUrl}`);
-    if (scenario.targetPath) {
-      userParts.push(`**Start URL:** ${resolveStartUrl(normalizedBaseUrl, scenario.targetPath)}`);
+    if (materializedScenario.targetPath) {
+      userParts.push(`**Start URL:** ${resolveStartUrl(normalizedBaseUrl, materializedScenario.targetPath)}`);
     }
     userParts.push("**Navigation Boundary:** Treat the Base URL as the application under test. Resolve relative paths and in-app navigation against this origin. Do not navigate to another host unless a step explicitly includes an absolute external URL.");
   }
-  if (scenario.targetPath) {
-    userParts.push(`**Target Path:** ${scenario.targetPath}`);
+  if (materializedScenario.targetPath) {
+    userParts.push(`**Target Path:** ${materializedScenario.targetPath}`);
   }
-  if (scenario.steps.length > 0) {
+  if (resolution.params.length > 0) {
+    userParts.push("**Route Fixtures:**");
+    for (const param of resolution.params) {
+      const source = resolution.sources[param];
+      const synthetic = source === "default" ? " synthetic" : "";
+      userParts.push(`- :${param} = ${resolution.values[param]} (${source}${synthetic})`);
+    }
+  }
+  if (materializedScenario.steps.length > 0) {
     userParts.push("**Steps:**");
-    for (let i = 0;i < scenario.steps.length; i++) {
-      userParts.push(`${i + 1}. ${scenario.steps[i]}`);
+    for (let i = 0;i < materializedScenario.steps.length; i++) {
+      userParts.push(`${i + 1}. ${materializedScenario.steps[i]}`);
     }
   }
   return userParts.join(`
@@ -15101,6 +15275,7 @@ function createClientForModel(model, apiKey) {
 var activeHARs, activeCoverage, BROWSER_TOOLS;
 var init_ai_client = __esm(() => {
   init_types();
+  init_route_fixtures();
   activeHARs = new Map;
   activeCoverage = new Map;
   BROWSER_TOOLS = [
@@ -18321,9 +18496,10 @@ function withTimeout(promise, ms, label) {
   });
 }
 async function runSingleScenario(scenario, runId, options) {
-  const scenarioType = scenario.scenarioType ?? "browser";
+  const { scenario: materializedScenario, resolution: routeFixtureResolution } = materializeScenarioRoute(scenario);
+  const scenarioType = materializedScenario.scenarioType ?? "browser";
   if (scenarioType === "eval") {
-    return runEvalScenario(scenario, { runId, baseUrl: options.url });
+    return runEvalScenario(materializedScenario, { runId, baseUrl: options.url });
   }
   const config = loadConfig();
   if (options.selfHeal !== undefined)
@@ -18364,7 +18540,7 @@ async function runSingleScenario(scenario, runId, options) {
     runId,
     scenarioId: scenario.id,
     model,
-    stepsTotal: scenario.steps.length || 10,
+    stepsTotal: materializedScenario.steps.length || 10,
     personaId: persona?.id ?? null,
     personaName: persona?.name ?? null
   });
@@ -18400,12 +18576,12 @@ async function runSingleScenario(scenario, runId, options) {
         engine: effectiveOptions.engine
       });
     }
-    const targetUrl = scenario.targetPath ? `${options.url.replace(/\/$/, "")}${scenario.targetPath}` : options.url;
-    const scenarioTimeout = scenario.timeoutMs ?? options.timeout ?? config.browser.timeout ?? 60000;
+    const targetUrl = materializedScenario.targetPath ? resolveStartUrl(options.url.replace(/\/$/, ""), materializedScenario.targetPath) : options.url;
+    const scenarioTimeout = materializedScenario.timeoutMs ?? options.timeout ?? config.browser.timeout ?? 60000;
     registerSession({
       resultId: result.id,
       runId,
-      scenarioId: scenario.id,
+      scenarioId: materializedScenario.id,
       engine: effectiveOptions.engine ?? "playwright",
       startUrl: targetUrl
     });
@@ -18459,7 +18635,7 @@ async function runSingleScenario(scenario, runId, options) {
     const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
-      scenario,
+      scenario: materializedScenario,
       screenshotter,
       model,
       runId,
@@ -18550,7 +18726,7 @@ async function runSingleScenario(scenario, runId, options) {
     const baseReasoning = agentResult.reasoning ? agentResult.reasoning + lightpandaNote : lightpandaNote || "";
     const assertionOutcome = await applyStructuredAssertionsToResult({
       page,
-      scenario,
+      scenario: materializedScenario,
       consoleErrors,
       status: agentResult.status,
       reasoning: baseReasoning
@@ -18571,6 +18747,7 @@ async function runSingleScenario(scenario, runId, options) {
       costCents: estimateCost(model, agentResult.tokensUsed),
       metadata: {
         consoleLogs,
+        ...routeFixtureResolution.params.length > 0 ? { routeFixtureResolution } : {},
         ...networkErrors.length > 0 ? networkMeta : {},
         ...structuredAssertionMeta
       }
@@ -18920,6 +19097,7 @@ var init_runner = __esm(() => {
   init_browser();
   init_screenshotter();
   init_ai_client();
+  init_route_fixtures();
   init_config2();
   init_persona_auth();
   init_session_tracker();
@@ -59184,17 +59362,22 @@ function discoverNextRouteInventory(options) {
 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.",
-    "Exercise visible primary navigation, tabs, filters, dialogs, forms, and safe buttons on this route.",
+    ...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."
@@ -59215,8 +59398,15 @@ function scenarioInputForNextRoute(item, projectId) {
       category: item.category,
       methods: item.methods,
       dynamic: item.dynamic,
+      fixtureParams: item.fixtureParams,
+      actions: item.actions,
+      actionCount: item.actions.length,
       groups: item.groups
     },
+    parameters: item.fixtureParams.length > 0 ? {
+      routeFixtures: defaultRouteFixturesForParams(item.fixtureParams),
+      routeFixtureParams: item.fixtureParams
+    } : undefined,
     projectId
   };
 }
@@ -59312,9 +59502,20 @@ function routeItemFromFile(rootDir, appDir, file) {
   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 methods = kind === "api" ? extractRouteMethods(file) : [];
+  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,
@@ -59325,6 +59526,8 @@ function routeItemFromFile(rootDir, appDir, file) {
     methods,
     dynamic,
     requiresAuth,
+    fixtureParams,
+    actions,
     tags: tagsForRoute({ kind, routePath: normalizedRoutePath, category, groups, dynamic, requiresAuth }),
     priority: priorityForRoute(normalizedRoutePath, category, kind)
   };
@@ -59341,8 +59544,7 @@ function normalizeRouteSegment(segment) {
   }
   return segment;
 }
-function extractRouteMethods(file) {
-  const source = readFileSync9(file, "utf8");
+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)) {
@@ -59352,6 +59554,193 @@ function extractRouteMethods(file) {
   }
   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"))
@@ -59416,10 +59805,11 @@ function priorityForRoute(routePath, category, kind) {
     return "medium";
   return "medium";
 }
-var ROUTE_FILE_NAMES, WALK_EXCLUDES, SAFE_PAGE_ASSERTIONS;
+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();
+  init_route_fixtures();
   ROUTE_FILE_NAMES = new Set([
     "page.tsx",
     "page.ts",
@@ -59439,6 +59829,13 @@ var init_next_route_inventory = __esm(() => {
     "coverage"
   ]);
   SAFE_PAGE_ASSERTIONS = [{ type: "no_console_errors" }];
+  SOURCE_EXTENSIONS = [
+    ".tsx",
+    ".ts",
+    ".jsx",
+    ".js",
+    ".mdx"
+  ];
 });
 
 // src/lib/generator.ts
@@ -94827,7 +95224,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.49",
+  version: "0.0.51",
   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/db/scenarios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../src/db/scenarios.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAC;AA6B3B,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA+BnE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAmBvD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIrE;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,EAAE,CAoFjE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAwFhG;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CA8B9D;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBhE;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAuDlG"}
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../src/db/scenarios.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAC;AA2C3B,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA+BnE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAmBvD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIrE;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,EAAE,CAoFjE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAwFhG;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CA8B9D;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBhE;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAgElG"}