@elench/testkit 0.1.60 → 0.1.62

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

@@ -45,6 +45,19 @@ const context = {
           route: "/coverage",
           filePath: "app/coverage/page.tsx",
         },
+        {
+          id: "ui_surface:web:/coverage:coverage-refresh-button",
+          kind: "ui_surface",
+          service: "web",
+          label: "Refresh overlay",
+          route: "/coverage",
+          filePath: "app/coverage/page.tsx",
+          target: {
+            kind: "testId",
+            value: "coverage-refresh-button",
+            confidence: "high",
+          },
+        },
         {
           id: "api_route:web:GET:/api/coverage",
           kind: "api_route",
@@ -72,9 +85,16 @@ const context = {
       ],
       edges: [
         {
-          id: "requests:page_view:web:/coverage:api_route:web:GET:/api/coverage",
-          kind: "requests",
+          id: "contains:page_view:web:/coverage:ui_surface:web:/coverage:coverage-refresh-button",
+          kind: "contains",
           from: "page_view:web:/coverage",
+          to: "ui_surface:web:/coverage:coverage-refresh-button",
+          confidence: "high",
+        },
+        {
+          id: "requests:ui_surface:web:/coverage:coverage-refresh-button:api_route:web:GET:/api/coverage",
+          kind: "requests",
+          from: "ui_surface:web:/coverage:coverage-refresh-button",
           to: "api_route:web:GET:/api/coverage",
           confidence: "high",
         },
@@ -89,7 +109,10 @@ const context = {
           selectionType: "pw",
           framework: "playwright",
           testFilePath: "app/coverage/__testkit__/coverage.pw.testkit.ts",
-          coveredNodeIds: ["page_view:web:/coverage"],
+          coveredNodeIds: [
+            "page_view:web:/coverage",
+            "ui_surface:web:/coverage:coverage-refresh-button",
+          ],
           details: {
             route: "/coverage",
             targets: [{ kind: "testId", value: "coverage-refresh-button", confidence: "high" }],
@@ -156,10 +179,18 @@ describe("testkit bridge", () => {
         coverageState: "covered",
         relatedFailureCount: 1,
         relatedCoverageCount: 1,
+        coverageBreakdown: {
+          direct: 0,
+          indirect: 0,
+          mixed: 1,
+        },
       },
       failures: [
         {
-          label: "Coverage",
+          kind: "ui_surface",
+          label: "Refresh overlay",
+          importance: "high",
+          reason: "Refresh overlay is implicated by 1 failing test.",
           targets: [{ kind: "testId", value: "coverage-refresh-button", confidence: "high" }],
           failedTests: [
             {
@@ -171,7 +202,10 @@ describe("testkit bridge", () => {
       ],
       coverage: [
         {
-          label: "Coverage",
+          kind: "ui_surface",
+          label: "Refresh overlay",
+          importance: "high",
+          supportKind: "mixed",
           targets: [{ kind: "testId", value: "coverage-refresh-button", confidence: "high" }],
           supportingTests: [
             {

package/node_modules/@elench/testkit-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.60",
+  "version": "0.1.62",
   "description": "Shared browser protocol for testkit bridge and extension consumers",
   "type": "module",
   "main": "./src/index.mjs",

package/node_modules/@elench/testkit-protocol/src/index.d.ts

@@ -5,6 +5,8 @@ export type BrowserTargetKind = "testId" | "role" | "text" | "css" | "xpath" | "
 export type BrowserConfidence = "low" | "medium" | "high";
 export type BrowserFailureState = "failing" | "healthy" | "unavailable";
 export type BrowserCoverageState = "covered" | "missing" | "unavailable";
+export type BridgeSurfaceImportance = "critical" | "high" | "medium" | "low";
+export type BridgeCoverageSupportKind = "direct" | "indirect" | "mixed";
 
 export type CoverageNodeKind =
   | "page_view"
@@ -86,11 +88,22 @@ export interface CoverageEvidence {
   };
 }
 
+export type CoverageGraphDiagnosticLevel = "info" | "warn";
+
+export interface CoverageGraphDiagnostic {
+  level: CoverageGraphDiagnosticLevel;
+  code: string;
+  filePath: string;
+  service: string;
+  message: string;
+}
+
 export interface CoverageGraph {
   schemaVersion: number;
   nodes: CoverageGraphNode[];
   edges: CoverageGraphEdge[];
   evidence: CoverageEvidence[];
+  diagnostics: CoverageGraphDiagnostic[];
 }
 
 export interface BridgeProductRef {
@@ -149,6 +162,9 @@ export interface FailureOverlayEntry {
   targets: BrowserTarget[];
   failedTests: BridgeSupportingTestRef[];
   viaNodes: BridgeCoverageViaNodeRef[];
+  importance?: BridgeSurfaceImportance;
+  surfaceKind?: string | null;
+  reason?: string | null;
 }
 
 export interface CoverageOverlayEntry {
@@ -161,6 +177,10 @@ export interface CoverageOverlayEntry {
   supportingTests: BridgeSupportingTestRef[];
   viaNodes: BridgeCoverageViaNodeRef[];
   confidence: BrowserConfidence;
+  importance?: BridgeSurfaceImportance;
+  surfaceKind?: string | null;
+  supportKind?: BridgeCoverageSupportKind;
+  reason?: string | null;
 }
 
 export interface PageOverlayResponse {
@@ -177,6 +197,11 @@ export interface PageOverlayResponse {
     coverageState: BrowserCoverageState;
     relatedFailureCount: number;
     relatedCoverageCount: number;
+    coverageBreakdown?: {
+      direct: number;
+      indirect: number;
+      mixed: number;
+    };
   };
   failures: FailureOverlayEntry[];
   coverage: CoverageOverlayEntry[];
@@ -196,6 +221,7 @@ export declare function normalizeBrowserMetadataDocument(value: unknown): Browse
 export declare function normalizeCoverageGraphNode(value: unknown): CoverageGraphNode | null;
 export declare function normalizeCoverageGraphEdge(value: unknown): CoverageGraphEdge | null;
 export declare function normalizeCoverageEvidence(value: unknown): CoverageEvidence | null;
+export declare function normalizeCoverageGraphDiagnostic(value: unknown): CoverageGraphDiagnostic | null;
 export declare function normalizeCoverageGraph(value: unknown): CoverageGraph | null;
 export declare function normalizePageOverlayResponse(value: unknown): PageOverlayResponse | null;
 export declare function isPageOverlayResponse(value: unknown): value is PageOverlayResponse;

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.60",
+  "version": "0.1.62",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -59,15 +59,16 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@elench/testkit-bridge": "0.1.60",
-    "@elench/testkit-protocol": "0.1.60",
+    "@elench/testkit-bridge": "0.1.62",
+    "@elench/testkit-protocol": "0.1.62",
     "@babel/code-frame": "^7.29.0",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",
     "execa": "^9.5.0",
     "ink": "^7.0.1",
     "picocolors": "^1.1.1",
-    "react": "^19.2.5"
+    "react": "^19.2.5",
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">=18"