@hasna/testers 0.0.50 → 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 (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(`
@@ -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();
@@ -59225,6 +59403,10 @@ function scenarioInputForNextRoute(item, projectId) {
       actionCount: item.actions.length,
       groups: item.groups
     },
+    parameters: item.fixtureParams.length > 0 ? {
+      routeFixtures: defaultRouteFixturesForParams(item.fixtureParams),
+      routeFixtureParams: item.fixtureParams
+    } : undefined,
     projectId
   };
 }
@@ -59627,6 +59809,7 @@ var ROUTE_FILE_NAMES, WALK_EXCLUDES, SAFE_PAGE_ASSERTIONS, IMPORT_SCAN_LIMIT = 4
 var init_next_route_inventory = __esm(() => {
   init_scenarios();
   init_workflows();
+  init_route_fixtures();
   ROUTE_FILE_NAMES = new Set([
     "page.tsx",
     "page.ts",
@@ -95041,7 +95224,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.50",
+  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"}

package/dist/index.js

@@ -11567,6 +11567,156 @@ var init_browser = __esm(() => {
   DEFAULT_VIEWPORT = { width: 1280, height: 720 };
 });
 
+// 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/scanners/a11y.ts
 var exports_a11y = {};
 __export(exports_a11y, {
@@ -12409,33 +12559,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(`
@@ -12733,6 +12885,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 = [
@@ -15482,6 +15635,7 @@ function savePersonaAuthCookies(id, cookies) {
 // src/lib/runner.ts
 init_browser();
 init_ai_client();
+init_route_fixtures();
 init_config2();
 
 // src/lib/secrets-resolver.ts
@@ -16625,9 +16779,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)
@@ -16668,7 +16823,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
   });
@@ -16704,12 +16859,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
     });
@@ -16763,7 +16918,7 @@ async function runSingleScenario(scenario, runId, options) {
     const agentResult = await withTimeout(runAgentLoop({
       client,
       page,
-      scenario,
+      scenario: materializedScenario,
       screenshotter,
       model,
       runId,
@@ -16854,7 +17009,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
@@ -16875,6 +17030,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/dist/lib/ai-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/lib/ai-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/lib/ai-client.ts"],"names":[],"mappings":"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"}

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

@@ -1 +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"}
+{"version":3,"file":"next-route-inventory.d.ts","sourceRoot":"","sources":["../../src/lib/next-route-inventory.ts"],"names":[],"mappings":"AAKA,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,CA8DrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuBhC"}

package/dist/lib/route-fixtures.d.ts

@@ -0,0 +1,20 @@
+import type { Scenario } from "../types/index.js";
+export interface RouteFixtureResolution {
+    originalPath: string | null;
+    resolvedPath: string | null;
+    params: string[];
+    values: Record<string, string>;
+    sources: Record<string, "scenario" | "env" | "default">;
+    synthetic: string[];
+}
+export interface MaterializedRouteScenario {
+    scenario: Scenario;
+    resolution: RouteFixtureResolution;
+}
+export declare function routeParamsFromPath(path: string | null | undefined): string[];
+export declare function defaultRouteFixturesForParams(params: string[]): Record<string, string>;
+export declare function resolveRouteFixtures(scenario: Scenario, env?: Record<string, string | undefined>): RouteFixtureResolution;
+export declare function resolveRoutePath(path: string, values: Record<string, string>): string;
+export declare function materializeScenarioRoute(scenario: Scenario, env?: Record<string, string | undefined>): MaterializedRouteScenario;
+export declare function resolveStartUrl(baseUrl: string, targetPath: string): string;
+//# sourceMappingURL=route-fixtures.d.ts.map

package/dist/lib/route-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-fixtures.d.ts","sourceRoot":"","sources":["../../src/lib/route-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,sBAAsB,CAAC;CACpC;AAoED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAO7E;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtF;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,sBAAsB,CAoCxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQrF;AAOD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,yBAAyB,CA6B3B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM3E"}

package/dist/lib/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/testers",
-    version: "0.0.50",
+    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.50",
+  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.50",
+  "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",