@elench/testkit 0.1.22 → 0.1.23

package/README.md

@@ -1,11 +1,10 @@
 # @elench/testkit
 
-CLI that reads `testkit.config.json` from a product repo, discovers `*.testkit.ts` files by convention, starts the required local services, provisions local Postgres isolation, and runs suites across `k6` and Playwright.
+CLI that reads `testkit.config.json` from a product repo, discovers `*.testkit.ts` files by convention, starts the required local services, provisions local Postgres isolation, and runs HTTP, DAL, and Playwright suites.
 
 ## Prerequisites
 
-`@elench/testkit` ships its own `k6` binary and uses it for both HTTP and DAL suites by default.
-If you need to force a different binary, set `TESTKIT_K6_BIN` to an absolute or relative path.
+`@elench/testkit` ships its own execution engine for HTTP and DAL suites. Consumers do not need to install or invoke any separate load-testing binary.
 
 Database isolation uses Docker-managed local Postgres containers. `testkit` creates and reuses template databases automatically, then clones per-worker databases from those templates for fast reruns. The default image is `pgvector/pgvector:pg16`.
 
@@ -24,7 +23,7 @@ npx @elench/testkit e2e
 
 # Filter by framework
 npx @elench/testkit --framework playwright
-npx @elench/testkit --framework k6
+npx @elench/testkit --framework default
 
 # Parallelize with isolated worker stacks
 npx @elench/testkit --jobs 3
@@ -48,9 +47,9 @@ npx @elench/testkit status
 npx @elench/testkit destroy
 ```
 
-## K6 Authoring
+## Authoring
 
-Consumer k6 tests can import the shared authoring API directly from the package:
+Consumer tests can import the shared authoring API directly from the package:
 
 ```js
 import { defineHttpSuite } from "@elench/testkit";
@@ -76,15 +75,15 @@ const suite = defineHttpSuite({ auth: clerkSessionAuth }, ({ req, setupData }) =
 });
 ```
 
-`testkit` bundles these imports before invoking k6, so tests do not need
-generated `_testkit` files or direct package-manager path imports.
+Low-level runtime primitives are also available without exposing the underlying engine:
 
-If you need to override the packaged `k6` binary for local environment reasons:
-
-```bash
-TESTKIT_K6_BIN=/path/to/k6 npx @elench/testkit int
+```js
+import { check, group, http } from "@elench/testkit/runtime";
 ```
 
+`testkit` bundles these imports before execution, so tests do not need
+generated `_testkit` files, direct package-manager path imports, or any separate engine installation.
+
 Legacy compatibility:
 
 - `testkit runtime install`
@@ -109,7 +108,7 @@ npx @elench/testkit --dir my-product api int -s health
 3. **Database** — provisions Docker-managed local Postgres when a service declares one
 4. **Seed** — runs optional product seed commands against the provisioned database
 5. **Runtime** — starts required local services, waits for readiness, and injects test env
-6. **Execution** — schedules file-level execution tasks across a global worker pool, reuses warm dependency graphs when possible, bundles `k6` files before execution so package imports resolve cleanly, and batches Playwright files per worker
+6. **Execution** — schedules file-level execution tasks across a global worker pool, reuses warm dependency graphs when possible, bundles test files before execution so package imports resolve cleanly, and batches Playwright files per worker
 7. **Cleanup** — stops local processes and preserves `.testkit/` state for inspection or later destroy
 
 Each run ends with a compact summary that shows per-service pass/fail status, suite totals, failed suites, and total duration.

package/lib/bundler/index.mjs

@@ -7,8 +7,7 @@ import { fileURLToPath } from "url";
 
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
 const ROOT_ENTRY = path.join(PACKAGE_ROOT, "lib", "index.mjs");
-const K6_ENTRY = path.join(PACKAGE_ROOT, "lib", "k6", "index.mjs");
-const K6_DIR = path.join(PACKAGE_ROOT, "lib", "k6");
+const RUNTIME_ENTRY = path.join(PACKAGE_ROOT, "lib", "runtime", "index.mjs");
 const bundleCache = new Map();
 
 export async function bundleK6File({
@@ -82,14 +81,7 @@ function testkitPackageAliasPlugin() {
 function resolvePackageSubpath(specifier) {
   const subpath = specifier.slice("@elench/testkit".length);
   if (!subpath) return ROOT_ENTRY;
-  if (subpath === "/k6") return K6_ENTRY;
-  if (subpath.startsWith("/k6/")) {
-    const rel = subpath.slice("/k6/".length);
-    const candidate = path.join(K6_DIR, `${rel}.mjs`);
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-  }
+  if (subpath === "/runtime") return RUNTIME_ENTRY;
 
   throw new Error(`Unsupported @elench/testkit import "${specifier}" in ${os.platform()}`);
 }

package/lib/bundler/index.test.mjs

@@ -12,8 +12,8 @@ afterEach(() => {
   }
 });
 
-describe("k6 bundler", () => {
-  it("bundles root package imports for k6 execution", async () => {
+describe("runtime bundler", () => {
+  it("bundles root and runtime package imports for execution", async () => {
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
     cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
 
@@ -21,8 +21,8 @@ describe("k6 bundler", () => {
     fs.writeFileSync(
       sourceFile,
       [
-        'import { defineHttpSuite, json } from "@elench/testkit";',
-        'import { check } from "k6";',
+        'import { defineHttpSuite } from "@elench/testkit";',
+        'import { check, json } from "@elench/testkit/runtime";',
         "const suite = defineHttpSuite(({ rawReq }) => {",
         '  const res = rawReq("GET", "/health");',
         "  check(json(res), {",
@@ -44,10 +44,11 @@ describe("k6 bundler", () => {
 
     const bundled = fs.readFileSync(bundledFile, "utf8");
     expect(bundled).toContain("defineHttpSuite");
-    expect(bundled).toContain('import { check } from "k6"');
+    expect(bundled).toContain('import { check');
+    expect(bundled).toContain('from "k6"');
   });
 
-  it("bundles subpath package imports for DAL execution", async () => {
+  it("bundles DAL 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 }));
 
@@ -55,7 +56,7 @@ describe("k6 bundler", () => {
     fs.writeFileSync(
       sourceFile,
       [
-        'import { defineDalSuite } from "@elench/testkit/k6";',
+        'import { defineDalSuite } from "@elench/testkit";',
         "const suite = defineDalSuite(({ db }) => {",
         '  db.query("SELECT 1");',
         "});",

package/lib/cli/args.mjs

@@ -22,11 +22,12 @@ export function resolveCliSelection({ first, second, serviceNames }) {
 }
 
 export function validateFrameworkOption(value) {
-  if (!["all", "k6", "playwright"].includes(value)) {
+  if (!["all", "default", "playwright"].includes(value)) {
     throw new Error(
-      `Unknown framework "${value}". Expected one of: all, k6, playwright.`
+      `Unknown framework "${value}". Expected one of: all, default, playwright.`
     );
   }
+  return value === "default" ? "k6" : value;
 }
 
 export function parseJobsOption(value) {

package/lib/cli/args.test.mjs

@@ -44,7 +44,8 @@ describe("cli-args", () => {
   });
 
   it("validates framework names", () => {
-    expect(() => validateFrameworkOption("playwright")).not.toThrow();
+    expect(validateFrameworkOption("playwright")).toBe("playwright");
+    expect(validateFrameworkOption("default")).toBe("k6");
     expect(() => validateFrameworkOption("jest")).toThrow("Unknown framework");
   });
 

package/lib/cli/index.mjs

@@ -8,7 +8,6 @@ import {
   validateFrameworkOption,
 } from "./args.mjs";
 import * as runner from "../runner/index.mjs";
-import * as runtime from "../runtime/index.mjs";
 
 export function run() {
   const cli = cac("testkit");
@@ -18,11 +17,13 @@ export function run() {
     .option("--dir <path>", "Explicit product directory")
     .option("--path <path>", "Target runtime path relative to the product directory")
     .option("--strict", "Exit non-zero when runtime status is missing or drifted")
-    .action((action, options) => {
+    .action(async (action, options) => {
       if (!["install", "status", "update"].includes(action)) {
         throw new Error('Unknown runtime action. Expected one of: install, status, update.');
       }
 
+      const runtime = await import("../runtime-manager/index.mjs");
+
       if (action === "status") {
         const status = runtime.getRuntimeStatus(options);
         console.log(runtime.formatRuntimeStatus(status));
@@ -47,7 +48,7 @@ export function run() {
       default: "1",
     })
     .option("--shard <i/n>", "Run only shard i of n at suite granularity")
-    .option("--framework <name>", "Filter by framework (k6, playwright, all)", {
+    .option("--framework <name>", "Filter by framework (default, playwright, all)", {
       default: "all",
     })
     .option("--write-status", "Write a deterministic testkit.status.json snapshot")
@@ -91,7 +92,7 @@ export function run() {
         return;
       }
 
-      validateFrameworkOption(options.framework);
+      const framework = validateFrameworkOption(options.framework);
 
       const jobs = parseJobsOption(options.jobs);
       const shard = parseShardOption(options.shard);
@@ -105,6 +106,7 @@ export function run() {
         suiteNames,
         {
           ...options,
+          framework,
           fileNames,
           jobs,
           shard,

package/lib/index.mjs

@@ -1 +1,13 @@
-export * from "./k6/index.mjs";
+export {
+  defineDalSuite,
+} from "./runtime-src/k6/dal-suite.js";
+export {
+  defineHttpSuite,
+} from "./runtime-src/k6/suite.js";
+
+export function createAuthAdapter({ setup, headers } = {}) {
+  return {
+    setup,
+    headers,
+  };
+}

package/lib/runner/index.mjs

@@ -535,11 +535,11 @@ async function startLocalService(config) {
 async function runHttpK6Batch(targetConfig, batch) {
   const baseUrl = targetConfig.testkit.local?.baseUrl;
   if (!baseUrl) {
-    throw new Error(`Service "${targetConfig.name}" requires local.baseUrl for HTTP k6 suites`);
+    throw new Error(`Service "${targetConfig.name}" requires local.baseUrl for HTTP suites`);
   }
 
   console.log(
-    `\n── ${targetConfig.workerLabel} ${batch.type}:${batch.tasks[0].suiteName} (${batch.framework}, ${batch.tasks.length} file${batch.tasks.length === 1 ? "" : "s"}) ──`
+    `\n── ${targetConfig.workerLabel} ${batch.type}:${batch.tasks[0].suiteName}${formatBatchDescriptor(batch)} ──`
   );
 
   return Promise.all(
@@ -586,7 +586,7 @@ async function runDalBatch(targetConfig, batch) {
   }
 
   console.log(
-    `\n── ${targetConfig.workerLabel} ${batch.type}:${batch.tasks[0].suiteName} (${batch.framework}, ${batch.tasks.length} file${batch.tasks.length === 1 ? "" : "s"}) ──`
+    `\n── ${targetConfig.workerLabel} ${batch.type}:${batch.tasks[0].suiteName}${formatBatchDescriptor(batch)} ──`
   );
 
   return Promise.all(
@@ -866,7 +866,7 @@ function printRunSummary(results, durationMs) {
         const fileDetail =
           suite.failedFiles.length > 0 ? `  (${suite.failedFiles.join(", ")})` : "";
         console.log(
-          `  - ${suite.type}:${suite.name} [${suite.framework}]${fileDetail} · ${formatDuration(suite.durationMs)}`
+          `  - ${suite.type}:${suite.name}${formatSuiteFramework(suite.framework)}${fileDetail} · ${formatDuration(suite.durationMs)}`
         );
         if (suite.error) {
           console.log(`    ${suite.error}`);
@@ -911,6 +911,22 @@ function longestServiceName(results) {
   return longestServiceNameModel(results);
 }
 
+function formatBatchDescriptor(batch) {
+  const fileLabel = `${batch.tasks.length} file${batch.tasks.length === 1 ? "" : "s"}`;
+  const frameworkLabel = formatFrameworkLabel(batch.framework);
+  return frameworkLabel ? ` (${frameworkLabel}, ${fileLabel})` : ` (${fileLabel})`;
+}
+
+function formatFrameworkLabel(framework) {
+  if (!framework || framework === "k6") return "";
+  return framework;
+}
+
+function formatSuiteFramework(framework) {
+  const label = formatFrameworkLabel(framework);
+  return label ? ` [${label}]` : "";
+}
+
 function buildRunArtifact({
   productDir,
   results,

package/lib/runner/results.mjs

@@ -177,7 +177,7 @@ export function finalizeServiceResult(tracker, startedAt, finishedAt) {
     suites: suites.map((suite) => ({
       name: suite.name,
       type: suite.type,
-      framework: suite.framework,
+      framework: formatFrameworkForArtifact(suite.framework),
       failed: suite.failedFiles.length > 0,
       fileCount: suite.fileCount,
       failedFiles: suite.failedFiles,
@@ -212,7 +212,6 @@ export function buildStatusArtifact({
         tests.push({
           service: result.name,
           type: suite.type,
-          framework: suite.framework,
           path: file.path,
           status: file.status,
         });
@@ -301,7 +300,7 @@ export function buildRunArtifact({
       suiteType,
       suiteNames,
       fileNames,
-      framework,
+      framework: formatFrameworkForArtifact(framework),
       shard,
       serviceFilter,
       testkitVersion: metadata.testkitVersion,
@@ -360,8 +359,8 @@ export function formatServiceSummary(result) {
 }
 
 export function formatError(error) {
-  if (error instanceof Error) return error.message;
-  return String(error);
+  if (error instanceof Error) return sanitizeErrorMessage(error.message);
+  return sanitizeErrorMessage(String(error));
 }
 
 export function longestServiceName(results) {
@@ -371,3 +370,15 @@ export function longestServiceName(results) {
 function normalizePathSeparators(filePath) {
   return filePath.split(path.sep).join("/");
 }
+
+function formatFrameworkForArtifact(framework) {
+  if (framework === "k6") return "default";
+  return framework;
+}
+
+function sanitizeErrorMessage(message) {
+  return message
+    .replace(/Command failed with exit code (\d+): .*?[\\/]vendor[\\/]k6 run\b/g, "Default runtime failed with exit code $1:")
+    .replace(/Command failed with exit code (\d+): k6 run\b/g, "Default runtime failed with exit code $1:")
+    .replace(/[\\/]vendor[\\/]k6\b/g, "default-runtime");
+}

package/lib/runner/results.test.mjs

@@ -65,6 +65,7 @@ describe("runner-results", () => {
     expect(result.failed).toBe(true);
     expect(result.failedSuiteCount).toBe(1);
     expect(result.errors).toEqual(["worker failed", "graph failed"]);
+    expect(result.suites[0].framework).toBe("default");
     expect(result.suites[0].files).toEqual([
       {
         path: "tests/health.js",
@@ -169,7 +170,7 @@ describe("runner-results", () => {
       suiteType: "int",
       suiteNames: ["health"],
       fileNames: ["tests/api/integration/b.int.testkit.ts"],
-      framework: "k6",
+      framework: "default",
       shard: null,
       serviceFilter: "api",
       metadata: {
@@ -210,14 +211,12 @@ describe("runner-results", () => {
         {
           service: "api",
           type: "integration",
-          framework: "k6",
           path: "tests/api/integration/a.int.testkit.ts",
           status: "passed",
         },
         {
           service: "api",
           type: "integration",
-          framework: "k6",
           path: "tests/api/integration/b.int.testkit.ts",
           status: "failed",
         },

package/lib/runtime/index.mjs

@@ -1,190 +1,31 @@
-import crypto from "crypto";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const TESTKIT_CONFIG = "testkit.config.json";
-const DEFAULT_RUNTIME_DIR = path.join("tests", "_testkit");
-const METADATA_FILE = ".runtime-manifest.json";
-const RUNTIME_FORMAT = 1;
-
-export function installRuntime(options = {}) {
-  const productDir = resolveProductDir(process.cwd(), options.dir);
-  const runtimeDir = resolveRuntimeDir(productDir, options.path);
-  const sourceFiles = readBundledRuntimeFiles();
-
-  fs.mkdirSync(runtimeDir, { recursive: true });
-
-  for (const file of sourceFiles) {
-    const targetPath = path.join(runtimeDir, file.path);
-    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-    fs.writeFileSync(targetPath, file.content);
-  }
-
-  const metadata = {
-    format: RUNTIME_FORMAT,
-    package: "@elench/testkit",
-    version: readPackageVersion(),
-    files: sourceFiles.map((file) => ({
-      path: file.path,
-      sha256: hashContent(file.content),
-    })),
-  };
-  fs.writeFileSync(
-    path.join(runtimeDir, METADATA_FILE),
-    `${JSON.stringify(metadata, null, 2)}\n`
-  );
-
-  return {
-    productDir,
-    runtimeDir,
-    relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
-    files: metadata.files,
-  };
-}
-
-export function getRuntimeStatus(options = {}) {
-  const productDir = resolveProductDir(process.cwd(), options.dir);
-  const runtimeDir = resolveRuntimeDir(productDir, options.path);
-  const sourceFiles = readBundledRuntimeFiles();
-  const metadataPath = path.join(runtimeDir, METADATA_FILE);
-
-  if (!fs.existsSync(runtimeDir) || !fs.existsSync(metadataPath)) {
-    return {
-      status: "missing",
-      productDir,
-      runtimeDir,
-      relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
-      missingFiles: sourceFiles.map((file) => file.path),
-      driftedFiles: [],
-    };
-  }
-
-  const missingFiles = [];
-  const driftedFiles = [];
-
-  for (const file of sourceFiles) {
-    const targetPath = path.join(runtimeDir, file.path);
-    if (!fs.existsSync(targetPath)) {
-      missingFiles.push(file.path);
-      continue;
-    }
-
-    const installed = fs.readFileSync(targetPath, "utf8");
-    if (installed !== file.content) {
-      driftedFiles.push(file.path);
-    }
-  }
-
-  const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
-  const versionMatches = metadata.version === readPackageVersion();
-
-  return {
-    status:
-      missingFiles.length === 0 && driftedFiles.length === 0 && versionMatches
-        ? "installed"
-        : "drifted",
-    productDir,
-    runtimeDir,
-    relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
-    versionMatches,
-    missingFiles,
-    driftedFiles,
-  };
-}
-
-export function formatRuntimeStatus(result) {
-  if (result.status === "missing") {
-    return `Runtime not installed at ${result.relativeRuntimeDir}`;
-  }
-
-  if (result.status === "installed") {
-    return `Runtime at ${result.relativeRuntimeDir} is up to date`;
-  }
-
-  const problems = [];
-  if (result.missingFiles.length > 0) {
-    problems.push(`missing: ${result.missingFiles.join(", ")}`);
-  }
-  if (result.driftedFiles.length > 0) {
-    problems.push(`drifted: ${result.driftedFiles.join(", ")}`);
-  }
-  if (result.versionMatches === false) {
-    problems.push("version drift");
-  }
-
-  return `Runtime at ${result.relativeRuntimeDir} is drifted (${problems.join("; ")})`;
-}
-
-function resolveProductDir(cwd, explicitDir) {
-  const dir = explicitDir ? path.resolve(cwd, explicitDir) : cwd;
-  ensureProductFiles(dir);
-  return dir;
-}
-
-function ensureProductFiles(dir) {
-  const missing = [TESTKIT_CONFIG].filter(
-    (file) => !fs.existsSync(path.join(dir, file))
-  );
-
-  if (missing.length > 0) {
-    throw new Error(
-      `Expected ${missing.join(" and ")} in ${dir}. Either cd into a product directory or use --dir.`
-    );
-  }
-}
-
-function resolveRuntimeDir(productDir, explicitPath) {
-  return path.resolve(productDir, explicitPath || DEFAULT_RUNTIME_DIR);
-}
-
-function relativeToProduct(productDir, targetPath) {
-  return path.relative(productDir, targetPath) || ".";
-}
-
-function readBundledRuntimeFiles() {
-  const sourceDir = path.resolve(
-    path.dirname(fileURLToPath(import.meta.url)),
-    "..",
-    "runtime-src"
-  );
-
-  return walkRuntimeFiles(sourceDir);
-}
-
-function walkRuntimeFiles(rootDir, relativeDir = "") {
-  const entries = fs.readdirSync(path.join(rootDir, relativeDir), {
-    withFileTypes: true,
-  });
-  const files = [];
-
-  for (const entry of entries) {
-    const nextRelative = path.join(relativeDir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...walkRuntimeFiles(rootDir, nextRelative));
-      continue;
-    }
-
-    const absolute = path.join(rootDir, nextRelative);
-    files.push({
-      path: nextRelative.split(path.sep).join("/"),
-      content: fs.readFileSync(absolute, "utf8"),
-    });
-  }
-
-  return files.sort((left, right) => left.path.localeCompare(right.path));
-}
-
-function readPackageVersion() {
-  const packagePath = path.resolve(
-    path.dirname(fileURLToPath(import.meta.url)),
-    "..",
-    "..",
-    "package.json"
-  );
-  return JSON.parse(fs.readFileSync(packagePath, "utf8")).version;
-}
-
-function hashContent(content) {
-  return crypto.createHash("sha256").update(content).digest("hex");
-}
+import rawHttp from "k6/http";
+import { check, fail, group, sleep } from "k6";
+
+export { check, fail, group, sleep };
+export const http = rawHttp;
+
+export function file(data, filename, contentType) {
+  return rawHttp.file(data, filename, contentType);
+}
+
+export {
+  allMatch,
+  contains,
+  defaultOptions,
+  isSorted,
+  json,
+  singleIterationOptions,
+} from "../runtime-src/k6/checks.js";
+export {
+  createDalContext,
+  openDb,
+  truncate,
+} from "../runtime-src/k6/dal.js";
+export {
+  createHttpClient,
+  defaultOptions as httpDefaultOptions,
+  getEnv,
+  makeGetWithHeaders,
+  makeRawReq,
+  makeReq,
+} from "../runtime-src/k6/http.js";

package/lib/runtime-manager/index.mjs

@@ -0,0 +1,190 @@
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const TESTKIT_CONFIG = "testkit.config.json";
+const DEFAULT_RUNTIME_DIR = path.join("tests", "_testkit");
+const METADATA_FILE = ".runtime-manifest.json";
+const RUNTIME_FORMAT = 1;
+
+export function installRuntime(options = {}) {
+  const productDir = resolveProductDir(process.cwd(), options.dir);
+  const runtimeDir = resolveRuntimeDir(productDir, options.path);
+  const sourceFiles = readBundledRuntimeFiles();
+
+  fs.mkdirSync(runtimeDir, { recursive: true });
+
+  for (const file of sourceFiles) {
+    const targetPath = path.join(runtimeDir, file.path);
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, file.content);
+  }
+
+  const metadata = {
+    format: RUNTIME_FORMAT,
+    package: "@elench/testkit",
+    version: readPackageVersion(),
+    files: sourceFiles.map((file) => ({
+      path: file.path,
+      sha256: hashContent(file.content),
+    })),
+  };
+  fs.writeFileSync(
+    path.join(runtimeDir, METADATA_FILE),
+    `${JSON.stringify(metadata, null, 2)}\n`
+  );
+
+  return {
+    productDir,
+    runtimeDir,
+    relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
+    files: metadata.files,
+  };
+}
+
+export function getRuntimeStatus(options = {}) {
+  const productDir = resolveProductDir(process.cwd(), options.dir);
+  const runtimeDir = resolveRuntimeDir(productDir, options.path);
+  const sourceFiles = readBundledRuntimeFiles();
+  const metadataPath = path.join(runtimeDir, METADATA_FILE);
+
+  if (!fs.existsSync(runtimeDir) || !fs.existsSync(metadataPath)) {
+    return {
+      status: "missing",
+      productDir,
+      runtimeDir,
+      relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
+      missingFiles: sourceFiles.map((file) => file.path),
+      driftedFiles: [],
+    };
+  }
+
+  const missingFiles = [];
+  const driftedFiles = [];
+
+  for (const file of sourceFiles) {
+    const targetPath = path.join(runtimeDir, file.path);
+    if (!fs.existsSync(targetPath)) {
+      missingFiles.push(file.path);
+      continue;
+    }
+
+    const installed = fs.readFileSync(targetPath, "utf8");
+    if (installed !== file.content) {
+      driftedFiles.push(file.path);
+    }
+  }
+
+  const metadata = JSON.parse(fs.readFileSync(metadataPath, "utf8"));
+  const versionMatches = metadata.version === readPackageVersion();
+
+  return {
+    status:
+      missingFiles.length === 0 && driftedFiles.length === 0 && versionMatches
+        ? "installed"
+        : "drifted",
+    productDir,
+    runtimeDir,
+    relativeRuntimeDir: relativeToProduct(productDir, runtimeDir),
+    versionMatches,
+    missingFiles,
+    driftedFiles,
+  };
+}
+
+export function formatRuntimeStatus(result) {
+  if (result.status === "missing") {
+    return `Runtime not installed at ${result.relativeRuntimeDir}`;
+  }
+
+  if (result.status === "installed") {
+    return `Runtime at ${result.relativeRuntimeDir} is up to date`;
+  }
+
+  const problems = [];
+  if (result.missingFiles.length > 0) {
+    problems.push(`missing: ${result.missingFiles.join(", ")}`);
+  }
+  if (result.driftedFiles.length > 0) {
+    problems.push(`drifted: ${result.driftedFiles.join(", ")}`);
+  }
+  if (result.versionMatches === false) {
+    problems.push("version drift");
+  }
+
+  return `Runtime at ${result.relativeRuntimeDir} is drifted (${problems.join("; ")})`;
+}
+
+function resolveProductDir(cwd, explicitDir) {
+  const dir = explicitDir ? path.resolve(cwd, explicitDir) : cwd;
+  ensureProductFiles(dir);
+  return dir;
+}
+
+function ensureProductFiles(dir) {
+  const missing = [TESTKIT_CONFIG].filter(
+    (file) => !fs.existsSync(path.join(dir, file))
+  );
+
+  if (missing.length > 0) {
+    throw new Error(
+      `Expected ${missing.join(" and ")} in ${dir}. Either cd into a product directory or use --dir.`
+    );
+  }
+}
+
+function resolveRuntimeDir(productDir, explicitPath) {
+  return path.resolve(productDir, explicitPath || DEFAULT_RUNTIME_DIR);
+}
+
+function relativeToProduct(productDir, targetPath) {
+  return path.relative(productDir, targetPath) || ".";
+}
+
+function readBundledRuntimeFiles() {
+  const sourceDir = path.resolve(
+    path.dirname(fileURLToPath(import.meta.url)),
+    "..",
+    "runtime-src"
+  );
+
+  return walkRuntimeFiles(sourceDir);
+}
+
+function walkRuntimeFiles(rootDir, relativeDir = "") {
+  const entries = fs.readdirSync(path.join(rootDir, relativeDir), {
+    withFileTypes: true,
+  });
+  const files = [];
+
+  for (const entry of entries) {
+    const nextRelative = path.join(relativeDir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...walkRuntimeFiles(rootDir, nextRelative));
+      continue;
+    }
+
+    const absolute = path.join(rootDir, nextRelative);
+    files.push({
+      path: nextRelative.split(path.sep).join("/"),
+      content: fs.readFileSync(absolute, "utf8"),
+    });
+  }
+
+  return files.sort((left, right) => left.path.localeCompare(right.path));
+}
+
+function readPackageVersion() {
+  const packagePath = path.resolve(
+    path.dirname(fileURLToPath(import.meta.url)),
+    "..",
+    "..",
+    "package.json"
+  );
+  return JSON.parse(fs.readFileSync(packagePath, "utf8")).version;
+}
+
+function hashContent(content) {
+  return crypto.createHash("sha256").update(content).digest("hex");
+}

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.22",
-  "description": "CLI for discovering and running local test suites across k6 and Playwright",
+  "version": "0.1.23",
+  "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "exports": {
     ".": "./lib/index.mjs",
-    "./k6": "./lib/k6/index.mjs",
-    "./k6/*": "./lib/k6/*.mjs",
+    "./runtime": "./lib/runtime/index.mjs",
     "./package.json": "./package.json"
   },
   "bin": {

package/lib/k6/checks.mjs

@@ -1 +0,0 @@
-export * from "../runtime-src/k6/checks.js";

package/lib/k6/dal-suite.mjs

@@ -1 +0,0 @@
-export * from "../runtime-src/k6/dal-suite.js";

package/lib/k6/dal.mjs

@@ -1 +0,0 @@
-export * from "../runtime-src/k6/dal.js";

package/lib/k6/http.mjs

@@ -1 +0,0 @@
-export * from "../runtime-src/k6/http.js";

package/lib/k6/index.mjs

@@ -1,30 +0,0 @@
-export {
-  allMatch,
-  contains,
-  defaultOptions,
-  isSorted,
-  json,
-  singleIterationOptions,
-} from "../runtime-src/k6/checks.js";
-export {
-  createDalContext,
-  openDb,
-  truncate,
-} from "../runtime-src/k6/dal.js";
-export { defineDalSuite } from "../runtime-src/k6/dal-suite.js";
-export {
-  createHttpClient,
-  defaultOptions as httpDefaultOptions,
-  getEnv,
-  makeGetWithHeaders,
-  makeRawReq,
-  makeReq,
-} from "../runtime-src/k6/http.js";
-export { defineHttpSuite } from "../runtime-src/k6/suite.js";
-
-export function createAuthAdapter({ setup, headers } = {}) {
-  return {
-    setup,
-    headers,
-  };
-}

package/lib/k6/suite.mjs

@@ -1 +0,0 @@
-export * from "../runtime-src/k6/suite.js";