@hasna/testers 0.0.49 → 0.0.51

package/dist/mcp/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   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",
@@ -15674,6 +15674,156 @@ var init_agents = __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 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, {
@@ -17407,33 +17557,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 (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 (scenario.steps.length > 0) {
+  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(`
@@ -17731,6 +17883,7 @@ function createClientForModel(model, apiKey) {
 var activeHARs, activeCoverage, BROWSER_TOOLS;
 var init_ai_client = __esm(() => {
   init_types3();
+  init_route_fixtures();
   activeHARs = new Map;
   activeCoverage = new Map;
   BROWSER_TOOLS = [
@@ -21370,9 +21523,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)
@@ -21413,7 +21567,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
   });
@@ -21449,12 +21603,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
     });
@@ -21508,7 +21662,7 @@ async function runSingleScenario(scenario, runId, options) {
     const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
-      scenario,
+      scenario: materializedScenario,
       screenshotter,
       model,
       runId,
@@ -21599,7 +21753,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
@@ -21620,6 +21774,7 @@ async function runSingleScenario(scenario, runId, options) {
       costCents: estimateCost(model, agentResult.tokensUsed),
       metadata: {
         consoleLogs,
+        ...routeFixtureResolution.params.length > 0 ? { routeFixtureResolution } : {},
         ...networkErrors.length > 0 ? networkMeta : {},
         ...structuredAssertionMeta
       }
@@ -21969,6 +22124,7 @@ var init_runner = __esm(() => {
   init_browser();
   init_screenshotter();
   init_ai_client();
+  init_route_fixtures();
   init_config2();
   init_persona_auth();
   init_session_tracker();

package/dist/server/index.js

@@ -14410,6 +14410,156 @@ var init_results = __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 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, {
@@ -16094,33 +16244,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 (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 (scenario.steps.length > 0) {
+  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(`
@@ -16418,6 +16570,7 @@ function createClientForModel(model, apiKey) {
 var activeHARs, activeCoverage, BROWSER_TOOLS;
 var init_ai_client = __esm(() => {
   init_types2();
+  init_route_fixtures();
   activeHARs = new Map;
   activeCoverage = new Map;
   BROWSER_TOOLS = [
@@ -46937,7 +47090,7 @@ import { join as join14 } from "path";
 // 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",
@@ -48526,6 +48679,7 @@ class Screenshotter {
 
 // src/lib/runner.ts
 init_ai_client();
+init_route_fixtures();
 init_config2();
 
 // src/lib/secrets-resolver.ts
@@ -49572,9 +49726,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)
@@ -49615,7 +49770,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
   });
@@ -49651,12 +49806,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
     });
@@ -49710,7 +49865,7 @@ async function runSingleScenario(scenario, runId, options) {
     const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
-      scenario,
+      scenario: materializedScenario,
       screenshotter,
       model,
       runId,
@@ -49801,7 +49956,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
@@ -49822,6 +49977,7 @@ async function runSingleScenario(scenario, runId, options) {
       costCents: estimateCost(model, agentResult.tokensUsed),
       metadata: {
         consoleLogs,
+        ...routeFixtureResolution.params.length > 0 ? { routeFixtureResolution } : {},
         ...networkErrors.length > 0 ? networkMeta : {},
         ...structuredAssertionMeta
       }

package/package.json

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