@elench/testkit 0.1.61 → 0.1.63

package/node_modules/@elench/testkit-protocol/src/index.mjs

@@ -158,6 +158,20 @@ export function normalizeCoverageEvidence(value) {
   };
 }
 
+const DIAGNOSTIC_LEVELS = new Set(["info", "warn"]);
+
+export function normalizeCoverageGraphDiagnostic(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const level = normalizeOptionalString(value.level);
+  const code = normalizeOptionalString(value.code);
+  const filePath = normalizeOptionalString(value.filePath);
+  const service = normalizeOptionalString(value.service);
+  const message = normalizeOptionalString(value.message);
+  if (!level || !code || !filePath || !service || !message) return null;
+  if (!DIAGNOSTIC_LEVELS.has(level)) return null;
+  return { level, code, filePath, service, message };
+}
+
 export function normalizeCoverageGraph(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
   const schemaVersion =
@@ -169,12 +183,16 @@ export function normalizeCoverageGraph(value) {
   const evidence = Array.isArray(value.evidence)
     ? value.evidence.map(normalizeCoverageEvidence).filter(Boolean)
     : [];
+  const diagnostics = Array.isArray(value.diagnostics)
+    ? value.diagnostics.map(normalizeCoverageGraphDiagnostic).filter(Boolean)
+    : [];
   if (nodes.length === 0) return null;
   return {
     schemaVersion,
     nodes,
     edges,
     evidence,
+    diagnostics,
   };
 }
 

package/node_modules/@elench/testkit-protocol/src/index.test.mjs

@@ -6,6 +6,7 @@ import {
   normalizeBrowserTarget,
   normalizeCoverageEvidence,
   normalizeCoverageGraph,
+  normalizeCoverageGraphDiagnostic,
   normalizeCoverageGraphEdge,
   normalizeCoverageGraphNode,
 } from "./index.mjs";
@@ -107,7 +108,79 @@ describe("testkit browser protocol", () => {
     });
   });
 
-  it("normalizes graph payloads", () => {
+  it("normalizes coverage graph diagnostics", () => {
+    expect(
+      normalizeCoverageGraphDiagnostic({
+        level: "warn",
+        code: "no-service-context",
+        filePath: "tests/example.int.testkit.ts",
+        service: "web",
+        message: 'No coverage context available for service "web".',
+      })
+    ).toEqual({
+      level: "warn",
+      code: "no-service-context",
+      filePath: "tests/example.int.testkit.ts",
+      service: "web",
+      message: 'No coverage context available for service "web".',
+    });
+
+    expect(normalizeCoverageGraphDiagnostic({ level: "error", code: "x", filePath: "f", service: "s", message: "m" })).toBeNull();
+    expect(normalizeCoverageGraphDiagnostic({ level: "warn", code: "", filePath: "f", service: "s", message: "m" })).toBeNull();
+    expect(normalizeCoverageGraphDiagnostic(null)).toBeNull();
+  });
+
+  it("normalizes graph payloads with diagnostics", () => {
+    expect(
+      normalizeCoverageGraph({
+        schemaVersion: TESTKIT_COVERAGE_GRAPH_VERSION,
+        nodes: [
+          {
+            id: "page_view:web:/coverage",
+            kind: "page_view",
+            service: "web",
+            label: "Coverage",
+            route: "/coverage",
+          },
+        ],
+        edges: [],
+        evidence: [],
+        diagnostics: [
+          {
+            level: "info",
+            code: "zero-coverage-inferred",
+            filePath: "tests/example.pw.testkit.ts",
+            service: "web",
+            message: "No routes matched.",
+          },
+        ],
+      })
+    ).toEqual({
+      schemaVersion: TESTKIT_COVERAGE_GRAPH_VERSION,
+      nodes: [
+        {
+          id: "page_view:web:/coverage",
+          kind: "page_view",
+          service: "web",
+          label: "Coverage",
+          route: "/coverage",
+        },
+      ],
+      edges: [],
+      evidence: [],
+      diagnostics: [
+        {
+          level: "info",
+          code: "zero-coverage-inferred",
+          filePath: "tests/example.pw.testkit.ts",
+          service: "web",
+          message: "No routes matched.",
+        },
+      ],
+    });
+  });
+
+  it("normalizes graph payloads without diagnostics field", () => {
     expect(
       normalizeCoverageGraph({
         schemaVersion: TESTKIT_COVERAGE_GRAPH_VERSION,
@@ -136,6 +209,7 @@ describe("testkit browser protocol", () => {
       ],
       edges: [],
       evidence: [],
+      diagnostics: [],
     });
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -59,8 +59,8 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@elench/testkit-bridge": "0.1.61",
-    "@elench/testkit-protocol": "0.1.61",
+    "@elench/testkit-bridge": "0.1.63",
+    "@elench/testkit-protocol": "0.1.63",
     "@babel/code-frame": "^7.29.0",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",