@elench/testkit 0.1.108 → 0.1.109

package/lib/cli/renderers/status/text.mjs

@@ -1,7 +1,107 @@
 export function renderStatusResult(result) {
-  return normalizeLines(result?.lines);
+  if (Array.isArray(result?.lines)) return normalizeLines(result.lines);
+  if (!result) return [];
+
+  const lines = [
+    `Testkit Status: ${result.name || result.product?.selectedService || "service"}`,
+    "",
+    "Product",
+    `  dir: ${result.product?.dir || "unknown"}`,
+    `  config: ${result.product?.configFile || "none"}`,
+    `  services: ${formatList(result.product?.services)}`,
+    `  dependencies: ${formatList(result.product?.dependencies)}`,
+    "",
+    "Runs",
+    `  active: ${result.runs?.active || 0}`,
+    `  stale: ${result.runs?.stale || 0}`,
+  ];
+
+  for (const run of (result.runs?.runs || []).slice(0, 5)) {
+    const ports = run.ports?.length ? ` ports=${run.ports.join(",")}` : "";
+    lines.push(`  ${run.runId}: ${run.status} pid=${run.pid}${ports}`);
+  }
+  if ((result.runs?.runs || []).length > 5) {
+    lines.push(`  ... ${(result.runs.runs.length - 5)} more run${result.runs.runs.length - 5 === 1 ? "" : "s"}`);
+  }
+
+  lines.push("", "Runtime Graphs");
+  if ((result.runtimeGraphs || []).length === 0) {
+    lines.push("  none");
+  } else {
+    for (const graph of result.runtimeGraphs || []) {
+      const marker = graph.orphan ? " orphan" : "";
+      lines.push(`  ${graph.name}${marker}`);
+      lines.push(`    desired instances: ${graph.desired?.instanceCount ?? "none"}`);
+      lines.push(`    runtime dirs: ${graph.runtimeDirCount || 0}`);
+      lines.push(`    current: ${formatRuntimeRange(graph.currentRuntimeDirs?.map((runtime) => runtime.id))}`);
+      lines.push(`    stale: ${formatRuntimeRange(graph.staleRuntimeDirs?.map((runtime) => runtime.id))}`);
+      lines.push(`    runtime services: ${formatList(graph.desired?.runtimeServices || graph.actual?.runtimeServices)}`);
+      lines.push(`    target services: ${formatList(graph.desired?.targetServices || graph.actual?.targetServices)}`);
+    }
+  }
+
+  lines.push(
+    "",
+    "Caches",
+    "  bundles",
+    `    size: ${formatBytes(result.caches?.bundles?.sizeBytes || 0)}`,
+    `    files: ${result.caches?.bundles?.fileCount || 0}`,
+    `    source files: ${result.caches?.bundles?.sourceFileCount || 0}`,
+    `    duplicated sources: ${result.caches?.bundles?.duplicatedSourceCount || 0}`,
+    `    inline sourcemaps: ${formatSourcemaps(result.caches?.bundles)}`,
+    `    manifest entries: ${result.caches?.bundles?.manifest?.entryCount || 0}`,
+    `    unmanaged files: ${result.caches?.bundles?.unmanagedFileCount || 0}`,
+    "  assistant command results",
+    `    size: ${formatBytes(result.caches?.assistant?.sizeBytes || 0)}`,
+    `    files: ${result.caches?.assistant?.fileCount || 0}`,
+    `    large files: ${result.caches?.assistant?.largeFileCount || 0}`
+  );
+
+  if (result.warnings?.length) {
+    lines.push("", "Warnings");
+    for (const warning of result.warnings) lines.push(`  - ${warning}`);
+  }
+
+  if (!result.hasState) {
+    lines.push("", "No state — run tests first.");
+  }
+
+  return lines;
 }
 
 function normalizeLines(lines) {
   return Array.isArray(lines) ? lines : [];
 }
+
+function formatList(values) {
+  const list = Array.isArray(values) ? values.filter(Boolean) : [];
+  return list.length > 0 ? list.join(", ") : "none";
+}
+
+function formatRuntimeRange(ids) {
+  const values = Array.isArray(ids) ? ids : [];
+  if (values.length === 0) return "none";
+  if (values.length === 1) return values[0];
+  return `${values[0]}..${values.at(-1)}`;
+}
+
+function formatBytes(value) {
+  const bytes = Number(value || 0);
+  if (bytes < 1024) return `${bytes}B`;
+  const units = ["KB", "MB", "GB", "TB"];
+  let amount = bytes / 1024;
+  let unitIndex = 0;
+  while (amount >= 1024 && unitIndex < units.length - 1) {
+    amount /= 1024;
+    unitIndex += 1;
+  }
+  return `${amount >= 10 ? amount.toFixed(0) : amount.toFixed(1)}${units[unitIndex]}`;
+}
+
+function formatSourcemaps(bundles = {}) {
+  if (bundles.sourcemapFileCount == null) return bundles.sourcemapStatus || "unknown";
+  if (bundles.sourcemapStatus && bundles.sourcemapStatus !== "present" && bundles.sourcemapStatus !== "none") {
+    return `${bundles.sourcemapFileCount} (${bundles.sourcemapStatus})`;
+  }
+  return String(bundles.sourcemapFileCount || 0);
+}

package/lib/config/discovery.mjs

@@ -15,7 +15,8 @@ const DISCOVERY_RULES = [
   { suffix: ".scenario.testkit.ts", type: "scenario", framework: "k6" },
   { suffix: ".dal.testkit.ts", type: "dal", framework: "k6" },
   { suffix: ".load.testkit.ts", type: "load", framework: "k6" },
-  { suffix: ".pw.testkit.ts", type: "e2e", framework: "playwright" },
+  { suffix: ".ui.testkit.ts", type: "ui", framework: "playwright" },
+  { suffix: ".pw.testkit.ts", type: "ui", framework: "playwright", legacySuffix: true },
 ];
 
 export function discoverProject(productDir, explicitServices = {}, options = {}) {
@@ -30,6 +31,14 @@ export function discoverProject(productDir, explicitServices = {}, options = {})
   for (const filePath of suiteFiles) {
     const rule = inferRule(filePath);
     if (!rule) continue;
+    if (rule.legacySuffix) {
+      diagnostics.push({
+        code: "legacy_ui_suffix",
+        severity: "warning",
+        message: `Legacy UI test suffix ".pw.testkit.ts" is deprecated. Rename to ".ui.testkit.ts": ${filePath}`,
+        path: filePath,
+      });
+    }
 
     const owners = inferOwners(filePath, explicitServices, repoDiscovery);
     if (owners === null) continue;

package/lib/config-api/index.mjs

@@ -225,9 +225,9 @@ function nextApp(options = {}) {
       readyTimeoutMs,
       env: mode === "start"
         ? {
-            NEXT_DIST_DIR: normalizedEnv.NEXT_DIST_DIR || ".next-testkit/{runtimeId}/dist",
+            NEXT_DIST_DIR: normalizedEnv.NEXT_DIST_DIR || "{productDir}/.next-testkit/{runtimeId}/dist",
             NEXT_TSCONFIG_PATH:
-              normalizedEnv.NEXT_TSCONFIG_PATH || ".next-testkit/{runtimeId}/tsconfig.json",
+              normalizedEnv.NEXT_TSCONFIG_PATH || "{productDir}/.next-testkit/{runtimeId}/tsconfig.json",
             ...normalizedEnv,
           }
         : normalizedEnv,

package/lib/config-api/next-runtime-tsconfig.mjs

@@ -3,12 +3,13 @@ import path from "path";
 
 export async function writeNextRuntimeTsconfig(context = {}) {
   const serviceDir = context.cwd || context.productDir;
+  const productDir = context.productDir || serviceDir;
   const runtimeId = context.runtimeId;
   if (!serviceDir || !runtimeId) {
     throw new Error("writeNextRuntimeTsconfig requires cwd and runtimeId");
   }
 
-  const runtimeRoot = path.join(serviceDir, ".next-testkit", String(runtimeId));
+  const runtimeRoot = path.join(productDir, ".next-testkit", String(runtimeId));
   const outputPath = path.join(runtimeRoot, "tsconfig.json");
   const outputDir = path.dirname(outputPath);
   const relative = (target) => path.relative(outputDir, target).replaceAll(path.sep, "/");

package/lib/coverage/graph-builder.mjs

@@ -70,8 +70,7 @@ export function buildCoverageGraph({ productDir, repoDiscovery = {}, services =
       confidence: "high",
       service: entry.serviceName,
       suiteName: entry.suiteName,
-      selectionType: toSelectionType(entry.type, entry.framework),
-      framework: entry.framework,
+      type: toSelectionType(entry.type, entry.framework),
       testFilePath: entry.filePath,
       coveredNodeIds,
       details: buildEvidenceDetails(coveredNodeIds, graph, entry, context),
@@ -173,8 +172,7 @@ function createFallbackEvidence(entry, testNodeId) {
     confidence: "medium",
     service: entry.serviceName,
     suiteName: entry.suiteName,
-    selectionType: toSelectionType(entry.type, entry.framework),
-    framework: entry.framework,
+    type: toSelectionType(entry.type, entry.framework),
     testFilePath: entry.filePath,
     coveredNodeIds: [testNodeId],
   };

package/lib/coverage/routing.mjs

@@ -53,7 +53,7 @@ export function apiRouteLookupKey(method, route) {
 }
 
 export function toSelectionType(type, framework) {
-  if (framework === "playwright") return "pw";
+  if (framework === "playwright" || type === "ui") return "ui";
   if (type === "integration") return "int";
   return type;
 }

package/lib/coverage/shared.mjs

@@ -67,7 +67,6 @@ export function createTestFileNode(graph, entry) {
       filePath: entry.filePath,
       metadata: {
         suiteName: entry.suiteName,
-        framework: entry.framework,
         type: toSelectionType(entry.type, entry.framework),
       },
     });
@@ -80,7 +79,7 @@ export function apiRouteLookupKey(method, route) {
 }
 
 export function toSelectionType(type, framework) {
-  if (framework === "playwright") return "pw";
+  if (framework === "playwright" || type === "ui") return "ui";
   if (type === "integration") return "int";
   return type;
 }

package/lib/discovery/index.d.ts

@@ -1,8 +1,7 @@
 import type { CoverageGraph } from "@elench/testkit-protocol";
 
-export type DiscoverySelectionType = "int" | "e2e" | "scenario" | "dal" | "load" | "pw";
-export type DiscoveryInternalType = "integration" | "e2e" | "scenario" | "dal" | "load";
-export type DiscoveryFramework = "k6" | "playwright";
+export type DiscoveryTestType = "ui" | "e2e" | "scenario" | "int" | "dal" | "load";
+export type DiscoveryInternalType = "ui" | "integration" | "e2e" | "scenario" | "dal" | "load";
 
 export interface DiscoveryDiagnostic {
   code: string;
@@ -28,9 +27,8 @@ export interface DiscoverySuite {
   service: string;
   name: string;
   displayName: string;
-  selectionType: DiscoverySelectionType;
+  type: DiscoveryTestType;
   internalType: DiscoveryInternalType;
-  framework: DiscoveryFramework;
   groupLabel: string;
   fileCount: number;
   activeFileCount: number;
@@ -59,9 +57,8 @@ export interface DiscoveryFile {
   service: string;
   suiteName: string;
   groupLabel: string;
-  selectionType: DiscoverySelectionType;
+  type: DiscoveryTestType;
   internalType: DiscoveryInternalType;
-  framework: DiscoveryFramework;
   skipped: boolean;
   skipReason: string | null;
   locks: string[];
@@ -79,7 +76,7 @@ export interface DiscoveryResult {
   configFile: string | null;
   filters: {
     service: string | null;
-    types: DiscoverySelectionType[] | ["all"];
+    types: DiscoveryTestType[] | ["all"];
     suiteSelectors: string[];
     fileNames: string[];
     runnableOnly: boolean;

package/lib/discovery/index.mjs

@@ -3,6 +3,7 @@ import { loadConfigContext, resolveProductDir } from "../config/index.mjs";
 import { discoverProject } from "../config/discovery.mjs";
 import { loadTestkitConfig } from "../config/config-loader.mjs";
 import { buildCoverageGraph } from "../coverage/index.mjs";
+import { formatPublicTestType } from "../domain/test-types.mjs";
 import { historyFilePath, loadHistory, summarizeHistoryForFiles } from "../history/index.mjs";
 import {
   matchesSelectedTypes,
@@ -124,12 +125,7 @@ export async function discoverTests(options = {}) {
 
 export function formatSelectionTypeLabel(type) {
   if (type === "int") return "Integration";
-  if (type === "e2e") return "E2E";
-  if (type === "scenario") return "Scenario";
-  if (type === "dal") return "DAL";
-  if (type === "load") return "Load";
-  if (type === "pw") return "Playwright";
-  return type;
+  return formatPublicTestType(type);
 }
 
 export function formatDisplayName(value) {
@@ -226,9 +222,8 @@ function buildResolvedSuiteEntries(config, suite, internalType, filters) {
       service: config.name,
       suiteName: suite.name,
       groupLabel: formatDisplayName(suite.name),
-      selectionType,
+      type: selectionType,
       internalType,
-      framework,
       skipped,
       skipReason,
       locks: [...new Set([...suiteLocks, ...fileLocks])].sort(),
@@ -239,13 +234,12 @@ function buildResolvedSuiteEntries(config, suite, internalType, filters) {
   if (visibleFiles.length === 0) return null;
   const skippedFileCount = visibleFiles.filter((entry) => entry.skipped).length;
   const suiteEntry = {
-    id: buildSuiteId(config.name, selectionType, suite.name, framework),
+    id: buildSuiteId(config.name, selectionType, suite.name),
     service: config.name,
     name: suite.name,
     displayName: formatDisplayName(suite.name),
-    selectionType,
+    type: selectionType,
     internalType,
-    framework,
     groupLabel: formatDisplayName(suite.name),
     fileCount: visibleFiles.length,
     activeFileCount: visibleFiles.length - skippedFileCount,
@@ -308,9 +302,8 @@ function buildRawDiscovery({ rawDiscovery, explicitServices, filters }) {
       service: entry.serviceName,
       suiteName: entry.suiteName,
       groupLabel: formatDisplayName(entry.suiteName),
-      selectionType,
+      type: selectionType,
       internalType: entry.type,
-      framework: entry.framework,
       skipped: false,
       skipReason: null,
       locks: [],
@@ -318,7 +311,7 @@ function buildRawDiscovery({ rawDiscovery, explicitServices, filters }) {
     };
     files.push(fileEntry);
 
-    const suiteId = buildSuiteId(entry.serviceName, selectionType, entry.suiteName, entry.framework);
+    const suiteId = buildSuiteId(entry.serviceName, selectionType, entry.suiteName);
     const existingSuite = suitesById.get(suiteId);
     if (existingSuite) {
       existingSuite.filePaths.push(entry.filePath);
@@ -330,9 +323,8 @@ function buildRawDiscovery({ rawDiscovery, explicitServices, filters }) {
         service: entry.serviceName,
         name: entry.suiteName,
         displayName: formatDisplayName(entry.suiteName),
-        selectionType,
+        type: selectionType,
         internalType: entry.type,
-        framework: entry.framework,
         groupLabel: formatDisplayName(entry.suiteName),
         fileCount: 1,
         activeFileCount: 1,
@@ -412,7 +404,7 @@ function buildSummary(services, suites, files, diagnostics) {
 
   for (const file of files) {
     byService[file.service] = (byService[file.service] || 0) + 1;
-    byType[file.selectionType] = (byType[file.selectionType] || 0) + 1;
+    byType[file.type] = (byType[file.type] || 0) + 1;
   }
 
   return {
@@ -497,12 +489,12 @@ function normalizePath(filePath) {
 export function fileDisplayName(filePath) {
   const base = path.posix
     .basename(filePath)
-    .replace(/(\.int|\.e2e|\.scenario|\.dal|\.load|\.pw)\.testkit\.ts$/, "");
+    .replace(/(\.int|\.e2e|\.scenario|\.dal|\.load|\.ui|\.pw)\.testkit\.ts$/, "");
   return formatDisplayName(base);
 }
 
-function buildSuiteId(serviceName, selectionType, suiteName, framework) {
-  return [serviceName, selectionType, framework, suiteName].join("|");
+function buildSuiteId(serviceName, selectionType, suiteName) {
+  return [serviceName, selectionType, suiteName].join("|");
 }
 
 function buildFileId(serviceName, selectionType, filePath) {
@@ -512,16 +504,15 @@ function buildFileId(serviceName, selectionType, filePath) {
 function compareSuiteEntries(left, right) {
   return (
     left.service.localeCompare(right.service) ||
-    left.selectionType.localeCompare(right.selectionType) ||
-    left.name.localeCompare(right.name) ||
-    left.framework.localeCompare(right.framework)
+    left.type.localeCompare(right.type) ||
+    left.name.localeCompare(right.name)
   );
 }
 
 function compareFileEntries(left, right) {
   return (
     left.service.localeCompare(right.service) ||
-    left.selectionType.localeCompare(right.selectionType) ||
+    left.type.localeCompare(right.type) ||
     left.suiteName.localeCompare(right.suiteName) ||
     left.path.localeCompare(right.path)
   );

package/lib/domain/test-types.mjs

@@ -0,0 +1,44 @@
+export const TEST_TYPE_ORDER = ["ui", "e2e", "scenario", "int", "dal", "load"];
+export const TEST_TYPES = new Set(TEST_TYPE_ORDER);
+export const RUN_TYPE_ORDER = [...TEST_TYPE_ORDER, "all"];
+export const RUN_TYPES = new Set(RUN_TYPE_ORDER);
+export const LEGACY_TEST_TYPE_ALIASES = new Map([
+  ["pw", "ui"],
+]);
+
+const TEST_TYPE_LABELS = {
+  ui: "UI",
+  e2e: "E2E",
+  scenario: "Scenario",
+  int: "INT",
+  dal: "DAL",
+  load: "Load",
+};
+
+export function normalizePublicTestType(value) {
+  const normalized = String(value || "").trim();
+  return LEGACY_TEST_TYPE_ALIASES.get(normalized) || normalized;
+}
+
+export function isPublicTestType(value) {
+  return TEST_TYPES.has(normalizePublicTestType(value));
+}
+
+export function isRunType(value) {
+  const normalized = normalizePublicTestType(value);
+  return normalized === "all" || TEST_TYPES.has(normalized);
+}
+
+export function formatPublicTestType(value) {
+  const normalized = normalizePublicTestType(value);
+  return TEST_TYPE_LABELS[normalized] || String(value || "");
+}
+
+export function publicTestTypeList({ includeAll = false, includeLegacy = false } = {}) {
+  const values = includeAll ? RUN_TYPE_ORDER : TEST_TYPE_ORDER;
+  return includeLegacy ? [...values, "pw"] : [...values];
+}
+
+export function publicTestTypeListText(options = {}) {
+  return publicTestTypeList(options).join(", ");
+}

package/lib/history/index.d.ts

@@ -15,8 +15,7 @@ export interface TestHistoryEntry extends TestHistorySummary {
   path: string;
   service: string;
   suiteName: string;
-  selectionType: string;
-  framework: string;
+  type: string;
   notRunCount: number;
   durationCount: number;
 }
@@ -37,10 +36,10 @@ export declare function updateHistoryFromRunArtifact(
 ): TestHistoryDocument;
 export declare function summarizeHistoryForFiles(
   history: TestHistoryDocument,
-  files?: Array<{ id: string; service: string; selectionType: string; path: string }>
+  files?: Array<{ id: string; service: string; type: string; path: string }>
 ): Map<string, TestHistorySummary>;
 export declare function buildHistoryTestId(
   serviceName: string,
-  selectionType: string,
+  type: string,
   filePath: string
 ): string;

package/lib/history/index.mjs

@@ -52,8 +52,7 @@ export function updateHistoryFromRunArtifact(history, runArtifact, recordedAt =
               path: file.path,
               service: service.name,
               suiteName: suite.name,
-              selectionType: suite.type,
-              framework: normalizeArtifactFramework(suite.framework),
+              type: suite.type,
               firstSeenAt: seenAt,
               lastSeenAt: seenAt,
               lastRunAt: seenAt,
@@ -70,8 +69,7 @@ export function updateHistoryFromRunArtifact(history, runArtifact, recordedAt =
         next.path = file.path;
         next.service = service.name;
         next.suiteName = suite.name;
-        next.selectionType = suite.type;
-        next.framework = normalizeArtifactFramework(suite.framework);
+        next.type = suite.type;
         next.lastSeenAt = seenAt;
         next.lastRunAt = seenAt;
         next.runCount += 1;
@@ -106,7 +104,7 @@ export function summarizeHistoryForFiles(history, files = []) {
   const normalized = normalizeHistory(history);
   const byId = new Map();
   for (const file of files) {
-    const entry = normalized.tests[file.id] || normalized.tests[buildHistoryTestId(file.service, file.selectionType, file.path)];
+    const entry = normalized.tests[file.id] || normalized.tests[buildHistoryTestId(file.service, file.type, file.path)];
     if (!entry) continue;
     byId.set(file.id, {
       firstSeenAt: entry.firstSeenAt || null,
@@ -123,8 +121,8 @@ export function summarizeHistoryForFiles(history, files = []) {
   return byId;
 }
 
-export function buildHistoryTestId(serviceName, selectionType, filePath) {
-  return [serviceName, selectionType, normalizePath(filePath)].join("|");
+export function buildHistoryTestId(serviceName, type, filePath) {
+  return [serviceName, type, normalizePath(filePath)].join("|");
 }
 
 function normalizeHistory(parsed) {
@@ -135,8 +133,7 @@ function normalizeHistory(parsed) {
       path: normalizePath(entry.path || ""),
       service: String(entry.service || ""),
       suiteName: String(entry.suiteName || ""),
-      selectionType: String(entry.selectionType || ""),
-      framework: normalizeArtifactFramework(entry.framework || "k6"),
+      type: String(entry.type || entry.selectionType || ""),
       firstSeenAt: entry.firstSeenAt || null,
       lastSeenAt: entry.lastSeenAt || null,
       lastRunAt: entry.lastRunAt || null,
@@ -156,11 +153,6 @@ function normalizeHistory(parsed) {
   };
 }
 
-function normalizeArtifactFramework(value) {
-  if (value === "default") return "k6";
-  return value || "k6";
-}
-
 function normalizePath(filePath) {
   return String(filePath).split(path.sep).join("/").replace(/^\.\/+/, "");
 }

package/lib/runner/formatting.mjs

@@ -40,8 +40,7 @@ export function longestServiceName(results) {
 }
 
 export function formatFrameworkLabel(framework) {
-  if (!framework || framework === "k6") return "";
-  return framework;
+  return "";
 }
 
 export function formatSuiteFramework(framework) {
@@ -175,7 +174,7 @@ export function buildDebugRunSummaryLines(results, durationMs, regressionReport
       const fileDetail =
         suite.failedFiles.length > 0 ? `  (${suite.failedFiles.join(", ")})` : "";
       lines.push(
-        `  - ${suite.type}:${suite.name}${formatSuiteFramework(suite.framework)}${fileDetail} · ${formatDuration(suite.durationMs)}`
+        `  - ${suite.type}:${suite.name}${fileDetail} · ${formatDuration(suite.durationMs)}`
       );
       if (suite.error) {
         lines.push(`    ${suite.error}`);