@elench/testkit 0.1.54 → 0.1.56

package/README.md

@@ -341,6 +341,27 @@ const suite = defineDalSuite(({ db }) => {
 export default suite;
 ```
 
+Scenario suites:
+
+```ts
+import { defineScenarioSuite } from "@elench/testkit";
+
+const suite = defineScenarioSuite(({ rawReq, scenario }) => {
+  const plan = scenario.choose("journey", {
+    endpoint: scenario.pick("endpoint", ["/health", "/message"]),
+    includeHealthCheck: scenario.maybe("includeHealthCheck", 1),
+  });
+
+  const selected = scenario.resource("selected-endpoint", () => rawReq("GET", plan.endpoint));
+
+  scenario.step("fetch selected endpoint", () => {
+    selected.get();
+  });
+});
+
+export default suite;
+```
+
 Low-level runtime primitives remain available:
 
 ```ts
@@ -375,6 +396,7 @@ Example layouts:
 
 - `*.int.testkit.ts`
 - `*.e2e.testkit.ts`
+- `*.scenario.testkit.ts`
 - `*.dal.testkit.ts`
 - `*.load.testkit.ts`
 - `*.pw.testkit.ts`

package/lib/bundler/index.mjs

@@ -132,7 +132,7 @@ function normalizeTestkitSuite(module) {
   const candidate = module?.default;
   if (!candidate || typeof candidate !== "object") {
     throw new Error(
-      "testkit suite files must default-export the suite object returned by defineHttpSuite(...) or defineDalSuite(...). Example: export default defineHttpSuite(...) or const suite = defineHttpSuite(...); export default suite;"
+      "testkit suite files must default-export the suite object returned by defineHttpSuite(...), defineScenarioSuite(...), or defineDalSuite(...). Example: export default defineHttpSuite(...) or const suite = defineScenarioSuite(...); export default suite;"
     );
   }
   if (typeof candidate.exec !== "function") {

package/lib/bundler/index.test.mjs

@@ -75,6 +75,35 @@ describe("runtime bundler", () => {
     expect(bundled).toContain('import sql from "k6/x/sql"');
   });
 
+  it("bundles scenario execution through the public package surface", async () => {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
+    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
+
+    const sourceFile = path.join(tmpDir, "scenario.js");
+    fs.writeFileSync(
+      sourceFile,
+      [
+        'import { defineScenarioSuite } from "@elench/testkit";',
+        "const suite = defineScenarioSuite(({ scenario }) => {",
+        "  const plan = scenario.choose('journey', { endpoint: scenario.pick('endpoint', ['/a', '/b']) });",
+        "  scenario.step('record choice', () => plan.endpoint);",
+        "});",
+        "export default suite;",
+        "",
+      ].join("\n")
+    );
+
+    const bundledFile = await bundleK6File({
+      productDir: tmpDir,
+      serviceName: "api",
+      sourceFile,
+    });
+
+    const bundled = fs.readFileSync(bundledFile, "utf8");
+    expect(bundled).toContain("defineScenarioSuite");
+    expect(bundled).toContain("createScenarioRuntime");
+  });
+
   it("normalizes a default-exported suite object with no setup override", async () => {
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
     cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));

package/lib/cli/args.mjs

@@ -5,7 +5,7 @@ import {
   parseWorkersOption,
 } from "../runner/execution-config.mjs";
 
-export const POSITIONAL_TYPES = new Set(["int", "e2e", "dal", "load", "pw", "all"]);
+export const POSITIONAL_TYPES = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
 export const LIFECYCLE = new Set(["status", "destroy", "cleanup"]);
 export const KNOWN_FAILURES_ACTIONS = new Set(["render", "validate"]);
 export const RESERVED = new Set([...POSITIONAL_TYPES, ...LIFECYCLE]);
@@ -45,7 +45,7 @@ export function resolveCliSelection({ first, second, third }) {
   } else if (first) {
     throw new Error(
       `Unknown argument "${first}". Expected a lifecycle command (status, destroy, cleanup) ` +
-      `or suite type (int, e2e, dal, load, pw, all).`
+      `or suite type (int, e2e, scenario, dal, load, pw, all).`
     );
   }
 

package/lib/cli/args.test.mjs

@@ -79,11 +79,17 @@ describe("cli-args", () => {
   });
 
   it("parses types and suite selectors", () => {
-    expect(parseTypeOption(["e2e,dal"], "int")).toEqual(["int", "e2e", "dal"]);
+    expect(parseTypeOption(["e2e,scenario,dal"], "int")).toEqual([
+      "int",
+      "e2e",
+      "scenario",
+      "dal",
+    ]);
     expect(() => parseTypeOption(["all", "int"])).toThrow("cannot be combined");
 
-    expect(parseSuiteOption(["auth,dal:queries"])).toEqual([
+    expect(parseSuiteOption(["auth,scenario:journeys,dal:queries"])).toEqual([
       { kind: "plain", name: "auth", raw: "auth" },
+      { kind: "typed", type: "scenario", name: "journeys", raw: "scenario:journeys" },
       { kind: "typed", type: "dal", name: "queries", raw: "dal:queries" },
     ]);
   });

package/lib/cli/command-helpers.mjs

@@ -26,7 +26,7 @@ export const runFlags = {
   type: Flags.string({
     char: "t",
     multiple: true,
-    description: "Run specific suite type(s): int, e2e, dal, load, pw, all",
+    description: "Run specific suite type(s): int, e2e, scenario, dal, load, pw, all",
   }),
   suite: Flags.string({
     char: "s",
@@ -47,6 +47,9 @@ export const runFlags = {
   shard: Flags.string({
     description: "Run only shard i of n at suite granularity",
   }),
+  seed: Flags.string({
+    description: "Deterministic seed for scenario suites",
+  }),
   "write-status": Flags.boolean({
     description: "Write a deterministic testkit.status.json snapshot",
     default: false,
@@ -111,6 +114,7 @@ export async function executeRunCommand(command, flags, positionalType = null) {
       workers,
       fileTimeoutSeconds,
       shard,
+      scenarioSeed: flags.seed || null,
       serviceFilter: flags.service || null,
       reporter,
       writeStatus: flags["write-status"],

package/lib/cli/commands/artifacts.mjs

@@ -1,6 +1,6 @@
 import { Args, Command } from "@oclif/core";
 import { sharedFlags } from "../command-helpers.mjs";
-import { collectArtifactEntries, loadLatestRunArtifact } from "../viewer.mjs";
+import { collectArtifactEntries, loadCurrentRunArtifact } from "../viewer.mjs";
 
 export default class ArtifactsCommand extends Command {
   static summary = "List persisted artifacts from the latest run";
@@ -19,7 +19,7 @@ export default class ArtifactsCommand extends Command {
   async run() {
     const { args, flags } = await this.parse(ArtifactsCommand);
     const productDir = flags.dir || process.cwd();
-    const runArtifact = loadLatestRunArtifact(productDir);
+    const runArtifact = loadCurrentRunArtifact(productDir);
     const entries = collectArtifactEntries(productDir, runArtifact, args.file || null, flags.service || null)
       .map((entry) => ({
         service: entry.service.name,

package/lib/cli/commands/logs.mjs

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from "@oclif/core";
 import { sharedFlags } from "../command-helpers.mjs";
 import { readLogTail } from "../../runner/logs.mjs";
-import { getServiceLogRefs, loadLatestRunArtifact, resolveFileSubject } from "../viewer.mjs";
+import { getServiceLogRefs, loadCurrentRunArtifact, resolveFileSubject } from "../viewer.mjs";
 import path from "path";
 
 export default class LogsCommand extends Command {
@@ -27,7 +27,7 @@ export default class LogsCommand extends Command {
   async run() {
     const { args, flags } = await this.parse(LogsCommand);
     const productDir = flags.dir || process.cwd();
-    const runArtifact = loadLatestRunArtifact(productDir);
+    const runArtifact = loadCurrentRunArtifact(productDir);
     const subject = resolveFileSubject(runArtifact, args.file || null, flags.service || null);
     const logs = getServiceLogRefs(runArtifact, subject.service.name).map((entry) => ({
       ...entry,

package/lib/cli/commands/run.mjs

@@ -8,9 +8,9 @@ export default class RunCommand extends Command {
 
   static args = {
     type: Args.string({
-      description: "Optional suite type shortcut: int, e2e, dal, load, pw, all",
+      description: "Optional suite type shortcut: int, e2e, scenario, dal, load, pw, all",
       required: false,
-      options: ["int", "e2e", "dal", "load", "pw", "all"],
+      options: ["int", "e2e", "scenario", "dal", "load", "pw", "all"],
     }),
   };
 

package/lib/cli/commands/show.mjs

@@ -1,6 +1,6 @@
 import { Args, Command, Flags } from "@oclif/core";
 import { sharedFlags } from "../command-helpers.mjs";
-import { formatFileDetail, loadLatestRunArtifact, resolveFileSubject } from "../viewer.mjs";
+import { formatFileDetail, loadCurrentRunArtifact, resolveFileSubject } from "../viewer.mjs";
 
 export default class ShowCommand extends Command {
   static summary = "Show the most useful details for one file from the latest run";
@@ -25,7 +25,7 @@ export default class ShowCommand extends Command {
   async run() {
     const { args, flags } = await this.parse(ShowCommand);
     const productDir = flags.dir || process.cwd();
-    const runArtifact = loadLatestRunArtifact(productDir);
+    const runArtifact = loadCurrentRunArtifact(productDir);
     const subject = resolveFileSubject(runArtifact, args.file || null, flags.service || null);
     const result = {
       file: subject.file,

package/lib/cli/db.mjs

@@ -3,6 +3,9 @@ import os from "os";
 import path from "path";
 import { loadConfigs, resolveProductDir } from "../config/index.mjs";
 import { captureDatabaseTemplateSnapshot, prepareDatabaseRuntime } from "../database/index.mjs";
+import { createRunReporter } from "./presentation/run-reporter.mjs";
+import { createRunLogRegistry } from "../runner/logs.mjs";
+import { createSetupOperationRegistry } from "../runner/setup-operations.mjs";
 import { resolveRuntimeInstanceConfigs } from "../runner/template.mjs";
 
 export async function runDatabaseSnapshotCaptureCommand(options = {}) {
@@ -28,16 +31,28 @@ export async function runDatabaseSnapshotCaptureCommand(options = {}) {
   }
 
   const absoluteOutputPath = path.resolve(productDir, outputPath);
+  const reporter = createRunReporter({ outputMode: options.debug ? "debug" : "compact" });
+  const logRegistry = createRunLogRegistry(productDir);
+  const setupRegistry = createSetupOperationRegistry({ logRegistry });
   try {
     for (const config of topologicallySortConfigs(resolvedConfigs)) {
       if (config.name === resolvedTarget.name) continue;
       if (config.testkit.database?.provider === "local") {
-        await prepareDatabaseRuntime(config);
+        await prepareDatabaseRuntime(config, {
+          reporter,
+          logRegistry,
+          setupRegistry,
+        });
       }
     }
-    await captureDatabaseTemplateSnapshot(resolvedTarget, absoluteOutputPath);
+    await captureDatabaseTemplateSnapshot(resolvedTarget, absoluteOutputPath, {
+      reporter,
+      logRegistry,
+      setupRegistry,
+    });
     console.log(`Wrote ${path.relative(productDir, absoluteOutputPath)}`);
   } finally {
+    logRegistry.closeAll();
     fs.rmSync(runtimeRoot, { recursive: true, force: true });
   }
 }

package/lib/cli/entrypoint.mjs

@@ -16,7 +16,7 @@ export function normalizeCliArgs(argv) {
     "--version",
     "-v",
   ]);
-  const runTypeShortcuts = new Set(["int", "e2e", "dal", "load", "pw", "all"]);
+  const runTypeShortcuts = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
   const valueFlags = new Set([
     "--dir",
     "--service",
@@ -26,6 +26,7 @@ export function normalizeCliArgs(argv) {
     "--workers",
     "--file-timeout-seconds",
     "--shard",
+    "--seed",
     "--input",
     "--output",
     "--status",

package/lib/cli/presentation/run-reporter.mjs

@@ -26,6 +26,27 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
         `[testkit] ${config.runtimeLabel || config.name}:${config.name} toolchain ${resolvedToolchain.summary}\n`
       );
     },
+    setupOperationFinished(operation) {
+      if (!operation) return;
+      if (mode === "json") return;
+      if (operation.status === "cached") return;
+      const duration = formatDuration(operation.durationMs || 0);
+      if (operation.status === "failed") {
+        const detail = shortenMessage(operation.error || operation.summary || operation.stage);
+        stdout.write(
+          `${colorStatus("FAIL")} ${"SETUP"} ${operation.serviceName} ${operation.stage} ${dim(duration)} ${detail}\n`
+        );
+        return;
+      }
+      if (
+        mode === "compact" &&
+        isHighLevelSetupOperation(operation) &&
+        (operation.durationMs || 0) >= 5_000
+      ) {
+        const summary = shortenMessage(operation.summary || operation.stage);
+        stdout.write(`${colorStatus("RUN")} ${"SETUP"} ${operation.serviceName} ${summary} ${dim(duration)}\n`);
+      }
+    },
     localServiceStarting(config, command) {
       if (mode !== "debug") return;
       stdout.write(`Starting ${config.runtimeLabel}:${config.name}: ${command}\n`);
@@ -98,3 +119,7 @@ function isThresholdWrapperMessage(message) {
 function normalizePath(filePath) {
   return String(filePath).split(path.sep).join("/");
 }
+
+function isHighLevelSetupOperation(operation) {
+  return operation.kind === "database-template" || operation.kind === "runtime-prepare";
+}

package/lib/cli/presentation/run-reporter.test.mjs

@@ -0,0 +1,80 @@
+import { Writable } from "stream";
+import { describe, expect, it } from "vitest";
+import { createRunReporter } from "./run-reporter.mjs";
+
+describe("run reporter setup output", () => {
+  it("prints concise high-level setup summaries in compact mode", () => {
+    let stdout = "";
+    const reporter = createRunReporter({
+      outputMode: "compact",
+      stdout: new Writable({
+        write(chunk, _encoding, callback) {
+          stdout += chunk.toString();
+          callback();
+        },
+      }),
+    });
+
+    reporter.setupOperationFinished({
+      serviceName: "api",
+      stage: "template",
+      kind: "database-template",
+      summary: "template rebuild",
+      status: "passed",
+      durationMs: 8_000,
+    });
+
+    expect(stdout).toContain("RUN SETUP api template rebuild");
+    expect(stdout).toContain("8s");
+  });
+
+  it("does not print low-level setup steps in compact mode", () => {
+    let stdout = "";
+    const reporter = createRunReporter({
+      outputMode: "compact",
+      stdout: new Writable({
+        write(chunk, _encoding, callback) {
+          stdout += chunk.toString();
+          callback();
+        },
+      }),
+    });
+
+    reporter.setupOperationFinished({
+      serviceName: "api",
+      stage: "template:migrate:api:1",
+      kind: "setup-step",
+      summary: "sql-file: db/schema.sql",
+      status: "passed",
+      durationMs: 8_000,
+    });
+
+    expect(stdout).toBe("");
+  });
+
+  it("prints concise setup failures", () => {
+    let stdout = "";
+    const reporter = createRunReporter({
+      outputMode: "compact",
+      stdout: new Writable({
+        write(chunk, _encoding, callback) {
+          stdout += chunk.toString();
+          callback();
+        },
+      }),
+    });
+
+    reporter.setupOperationFinished({
+      serviceName: "api",
+      stage: "runtime:prepare",
+      kind: "runtime-prepare",
+      summary: "runtime prepare",
+      status: "failed",
+      durationMs: 1_200,
+      error: "Command failed with exit code 1: node scripts/fail-prepare.mjs",
+    });
+
+    expect(stdout).toContain("FAIL SETUP api runtime:prepare");
+    expect(stdout).toContain("Command failed with exit code 1");
+  });
+});

package/lib/cli/tui/watch-app.mjs

@@ -1,15 +1,25 @@
+import fs from "fs";
+import path from "path";
 import React, { createElement, useEffect, useMemo, useState } from "react";
 import { Box, Text, useApp, useInput } from "ink";
 import { formatDuration } from "../../runner/formatting.mjs";
-import { formatFileDetail, loadLatestRunArtifact, resolveFileSubject } from "../viewer.mjs";
+import { formatFileDetail, loadCurrentRunArtifact } from "../viewer.mjs";
 
 export function WatchApp({ productDir, serviceFilter = null }) {
   const { exit } = useApp();
   const [artifact, setArtifact] = useState(() => safeLoadArtifact(productDir));
-  const [selectedIndex, setSelectedIndex] = useState(0);
+  const [view, setView] = useState("files");
+  const [selectedFileIndex, setSelectedFileIndex] = useState(0);
+  const [selectedSetupIndex, setSelectedSetupIndex] = useState(0);
 
   const files = useMemo(() => collectFiles(artifact, serviceFilter), [artifact, serviceFilter]);
-  const selected = files[Math.min(selectedIndex, Math.max(0, files.length - 1))] || null;
+  const setupOperations = useMemo(
+    () => collectSetupOperations(artifact, serviceFilter),
+    [artifact, serviceFilter]
+  );
+  const selectedFile = files[Math.min(selectedFileIndex, Math.max(0, files.length - 1))] || null;
+  const selectedSetup =
+    setupOperations[Math.min(selectedSetupIndex, Math.max(0, setupOperations.length - 1))] || null;
 
   useEffect(() => {
     const timer = setInterval(() => {
@@ -18,6 +28,14 @@ export function WatchApp({ productDir, serviceFilter = null }) {
     return () => clearInterval(timer);
   }, [productDir]);
 
+  useEffect(() => {
+    setSelectedFileIndex((current) => Math.min(current, Math.max(0, files.length - 1)));
+  }, [files.length]);
+
+  useEffect(() => {
+    setSelectedSetupIndex((current) => Math.min(current, Math.max(0, setupOperations.length - 1)));
+  }, [setupOperations.length]);
+
   useInput((input, key) => {
     if (input === "q") {
       exit();
@@ -27,12 +45,27 @@ export function WatchApp({ productDir, serviceFilter = null }) {
       setArtifact(safeLoadArtifact(productDir));
       return;
     }
+    if (key.tab || input === "s") {
+      setView((current) => {
+        if (current === "files" && setupOperations.length > 0) return "setup";
+        return "files";
+      });
+      return;
+    }
     if (key.downArrow) {
-      setSelectedIndex((current) => Math.min(current + 1, Math.max(0, files.length - 1)));
+      if (view === "setup") {
+        setSelectedSetupIndex((current) => Math.min(current + 1, Math.max(0, setupOperations.length - 1)));
+      } else {
+        setSelectedFileIndex((current) => Math.min(current + 1, Math.max(0, files.length - 1)));
+      }
       return;
     }
     if (key.upArrow) {
-      setSelectedIndex((current) => Math.max(0, current - 1));
+      if (view === "setup") {
+        setSelectedSetupIndex((current) => Math.max(0, current - 1));
+      } else {
+        setSelectedFileIndex((current) => Math.max(0, current - 1));
+      }
     }
   });
 
@@ -46,7 +79,7 @@ export function WatchApp({ productDir, serviceFilter = null }) {
     createElement(
       Text,
       null,
-      `testkit watch · q quit · r reload · ${artifact.run.status} · ${formatDuration(artifact.run.durationMs)}`
+      `testkit watch · q quit · r reload · tab toggle · ${artifact.run.status} · ${formatDuration(artifact.run.durationMs)}`
     ),
     createElement(
       Box,
@@ -54,22 +87,21 @@ export function WatchApp({ productDir, serviceFilter = null }) {
       createElement(
         Box,
         { width: "40%", flexDirection: "column", marginRight: 2 },
-        createElement(Text, null, "Files"),
-        ...files.map((entry, index) => {
-          const prefix = index === selectedIndex ? ">" : " ";
-          return createElement(
-            Text,
-            { key: `${entry.service.name}:${entry.file.path}` },
-            `${prefix} ${entry.file.status.toUpperCase().padEnd(7)} ${entry.file.path}`
-          );
-        })
+        createElement(Text, null, view === "setup" ? "Setup" : "Files"),
+        ...(view === "setup"
+          ? renderSetupEntries(setupOperations, selectedSetupIndex)
+          : renderFileEntries(files, selectedFileIndex))
       ),
       createElement(
         Box,
         { width: "60%", flexDirection: "column" },
         createElement(Text, null, "Details"),
-        ...(selected
-          ? formatFileDetail(productDir, artifact, selected, { logTail: 8 })
+        ...(view === "setup"
+          ? formatSetupDetail(productDir, selectedSetup)
+              .slice(0, 28)
+              .map((line, index) => createElement(Text, { key: `${index}:${line}` }, line))
+          : selectedFile
+          ? formatFileDetail(productDir, artifact, selectedFile, { logTail: 8 })
               .slice(0, 28)
               .map((line, index) => createElement(Text, { key: `${index}:${line}` }, line))
           : [createElement(Text, { key: "empty" }, "No file results")])
@@ -80,7 +112,7 @@ export function WatchApp({ productDir, serviceFilter = null }) {
 
 function safeLoadArtifact(productDir) {
   try {
-    return loadLatestRunArtifact(productDir);
+    return loadCurrentRunArtifact(productDir);
   } catch {
     return null;
   }
@@ -102,3 +134,87 @@ function collectFiles(runArtifact, serviceFilter) {
     left.file.path.localeCompare(right.file.path)
   );
 }
+
+function renderFileEntries(files, selectedIndex) {
+  return files.map((entry, index) => {
+    const prefix = index === selectedIndex ? ">" : " ";
+    return createElement(
+      Text,
+      { key: `${entry.service.name}:${entry.file.path}` },
+      `${prefix} ${entry.file.status.toUpperCase().padEnd(7)} ${entry.file.path}`
+    );
+  });
+}
+
+function collectSetupOperations(runArtifact, serviceFilter) {
+  if (!runArtifact) return [];
+  return [...(runArtifact.setup?.operations || [])]
+    .filter((entry) => !serviceFilter || entry.serviceName === serviceFilter)
+    .sort((left, right) => {
+      return (
+        setupStatusRank(left.status) - setupStatusRank(right.status) ||
+        String(left.serviceName || "").localeCompare(String(right.serviceName || "")) ||
+        String(left.startedAt || "").localeCompare(String(right.startedAt || "")) ||
+        String(left.stage || "").localeCompare(String(right.stage || ""))
+      );
+    });
+}
+
+function renderSetupEntries(operations, selectedIndex) {
+  return operations.map((entry, index) => {
+    const prefix = index === selectedIndex ? ">" : " ";
+    const duration = entry.durationMs == null ? "" : ` ${formatDuration(entry.durationMs)}`;
+    return createElement(
+      Text,
+      { key: entry.id },
+      `${prefix} ${String(entry.status || "").toUpperCase().padEnd(7)} ${entry.serviceName} ${entry.stage}${duration}`
+    );
+  });
+}
+
+function formatSetupDetail(productDir, operation) {
+  if (!operation) return ["No setup operations"];
+  const lines = [
+    `Service: ${operation.serviceName}`,
+    `Stage: ${operation.stage}`,
+    `Status: ${operation.status}`,
+  ];
+  if (operation.durationMs != null) {
+    lines.push(`Duration: ${formatDuration(operation.durationMs)}`);
+  }
+  if (operation.summary) {
+    lines.push(`Summary: ${operation.summary}`);
+  }
+  if (operation.error) {
+    lines.push(`Error: ${operation.error}`);
+  }
+  if (operation.logRef?.path) {
+    lines.push("");
+    lines.push("Log:");
+    lines.push(`  ${operation.logRef.path}`);
+    const absolutePath = path.join(productDir, operation.logRef.path);
+    for (const line of readTailSafe(absolutePath, 12)) {
+      lines.push(`  ${line}`);
+    }
+  }
+  return lines;
+}
+
+function readTailSafe(absolutePath, maxLines) {
+  try {
+    return fs.readFileSync(absolutePath, "utf8")
+      .split(/\r?\n/)
+      .filter(Boolean)
+      .slice(-maxLines);
+  } catch {
+    return [];
+  }
+}
+
+function setupStatusRank(status) {
+  if (status === "failed") return 1;
+  if (status === "running") return 2;
+  if (status === "passed") return 3;
+  if (status === "cached") return 4;
+  return 5;
+}