@vitest-agent/ui 4.0.1 → 4.1.0

package/dispatcher/cells/single-file-threshold.js

@@ -1,6 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
-import { formatCoverageJudgmentLine, soleModulePath } from "../helpers.js";
+import { formatCoverageSummaryLines, soleModulePath } from "../helpers.js";
 import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
@@ -10,8 +10,7 @@ const renderAgent = (inputs) => {
 	if (modulePath === void 0) return "";
 	const { passCount, durationMs } = inputs.state.totals;
 	const lines = [`${modulePath}: ${Fmt.plural(passCount, "test")} passed (${formatDisplayDuration(durationMs)})`];
-	const coverage = formatCoverageJudgmentLine(inputs.state);
-	if (coverage !== null) lines.push(coverage);
+	lines.push(...formatCoverageSummaryLines(inputs.state));
 	return `${lines.join("\n")}\n${buildFooter(inputs)}`;
 };
 const renderSingleFileThreshold = {

package/dispatcher/cells/single-project-threshold.js

@@ -1,15 +1,15 @@
 import { buildFooter } from "../footer.js";
-import { formatBelowTargetTable, formatCoverageJudgmentLine, formatTotals, formatTrendLine } from "../helpers.js";
+import { formatBelowTargetTable, formatCoverageSummaryLines, formatTotals, formatTrendLine } from "../helpers.js";
 import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-project-threshold.ts
 const BELOW_TARGET_LIMIT = 5;
 const renderAgent = (inputs) => {
 	const sections = [[formatTotals(inputs.state)]];
-	const coverage = formatCoverageJudgmentLine(inputs.state);
+	const coverage = formatCoverageSummaryLines(inputs.state);
 	const trend = formatTrendLine(inputs.trend);
 	const summaryLines = [];
-	if (coverage !== null) summaryLines.push(coverage);
+	summaryLines.push(...coverage);
 	if (trend !== null) summaryLines.push(trend);
 	if (summaryLines.length > 0) sections.push(summaryLines);
 	const below = formatBelowTargetTable(inputs.belowTarget, BELOW_TARGET_LIMIT);

package/dispatcher/cells/workspace-threshold.js

@@ -1,5 +1,5 @@
 import { buildFooter } from "../footer.js";
-import { formatBelowTargetTable, formatCoverageJudgmentLine, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
+import { formatBelowTargetTable, formatCoverageSummaryLines, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
 import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-threshold.ts
@@ -9,8 +9,8 @@ const renderAgent = (inputs) => {
 	const projects = formatProjectsTable(inputs.projects);
 	if (projects.length > 0) sections.push([...projects]);
 	const summaryLines = [];
-	const coverage = formatCoverageJudgmentLine(inputs.state);
-	if (coverage !== null) summaryLines.push(coverage);
+	const coverage = formatCoverageSummaryLines(inputs.state);
+	summaryLines.push(...coverage);
 	const trend = formatTrendLine(inputs.trend);
 	if (trend !== null) summaryLines.push(trend);
 	if (summaryLines.length > 0) sections.push(summaryLines);

package/dispatcher/classify.js

@@ -7,6 +7,8 @@
 * UI rewrite spec §7 open question 1:
 *
 * 1. More than one project → `workspace`.
+* 1b. `collectedModules` greater than one → `single-project` (the reduced
+*    `modules` map may hold only the failing modules of a larger run).
 * 2. One module with exactly one test → `single-test`.
 * 3. One module with more than one test → `single-file`.
 * 4. Otherwise → `single-project`.
@@ -18,6 +20,7 @@
 */
 const classifyRunShape = (state, projects) => {
 	if (projects.length > 1) return "workspace";
+	if (state.collectedModules !== void 0 && state.collectedModules > 1) return "single-project";
 	const moduleEntries = Object.values(state.modules);
 	if (moduleEntries.length === 1) {
 		const sole = moduleEntries[0];
@@ -50,7 +53,9 @@ const classifyOutcome = (state) => {
 	if (state.totals.failCount > 0) return "some-fail";
 	if (state.unhandledErrors.length > 0) return "some-fail";
 	if (state.totals.timeoutCount > 0) return "some-fail";
-	if (state.coverage !== null && state.coverage.violations.length > 0) return "threshold-violation";
+	if (state.coverage !== null) {
+		if (state.coverage.violations.length > 0 || (state.coverage.globShortfalls?.length ?? 0) > 0) return "threshold-violation";
+	}
 	return "all-pass";
 };
 

package/dispatcher/helpers.js

@@ -5,6 +5,12 @@ import { Doc, Fmt, Render } from "@effected/cli";
 
 //#region src/dispatcher/helpers.ts
 /**
+* Format a coverage percentage given on istanbul's 0–100 scale. One
+* decimal place for non-integer values, none for integers, with a
+* trailing percent sign (`Fmt.percent` with `scale: 100`).
+*/
+const formatPercent = (n) => Fmt.percent(n, { scale: 100 });
+/**
 * Format the `Tests:` header line —
 * `<pass>/<total> passed[, <fail> failed][, <timeout> timed out][, <skip> skipped] (Xms)`.
 * `total` folds in `timeoutCount` — a timed-out test is a real collected
@@ -70,18 +76,61 @@ const formatFailure = (f, width) => {
 	})).split("\n");
 };
 /**
+* The `Glob aggregates below threshold:` block — one
+* `- <pattern>: lines 60% < 90%, branches 55% < 80%` line per shortfall,
+* listing only the metrics that miss their minimum. Returns an empty array
+* when there are no shortfalls. Shared by the dispatcher cells and
+* `renderAgent` so both agent surfaces use one line format.
+*/
+const formatGlobShortfallLines = (shortfalls) => {
+	if (shortfalls === void 0 || shortfalls.length === 0) return [];
+	const metricOrder = [
+		"lines",
+		"branches",
+		"functions",
+		"statements"
+	];
+	const lines = ["Glob aggregates below threshold:"];
+	for (const g of shortfalls) {
+		const parts = [];
+		for (const m of metricOrder) {
+			const min = g.thresholds[m];
+			const actual = g.summary[m];
+			if (min !== void 0 && actual < min) parts.push(`${m} ${formatPercent(actual)} < ${formatPercent(min)}`);
+		}
+		lines.push(`- ${g.pattern}: ${parts.join(", ")}`);
+	}
+	return lines;
+};
+/**
 * One coverage judgment line — `Coverage: ✓ all metrics meet thresholds`
 * for a clean run, `Coverage: ✗ <N> files below minimum thresholds (...)`
-* for a violation. Returns `null` when the run carries no coverage block.
+* for a per-file violation, `Coverage: ✗ <N> glob aggregates below
+* threshold` when only glob aggregate shortfalls exist. Returns `null`
+* when the run carries no coverage block.
 */
 const formatCoverageJudgmentLine = (state) => {
 	const cov = state.coverage;
 	if (cov === null) return null;
-	if (cov.violations.length === 0) return `Coverage: ${statusGlyph("success")} all metrics meet thresholds`;
+	const shortfallCount = cov.globShortfalls?.length ?? 0;
+	if (cov.violations.length === 0) {
+		if (shortfallCount > 0) return `Coverage: ${statusGlyph("failure")} ${Fmt.plural(shortfallCount, "glob aggregate")} below threshold`;
+		return `Coverage: ${statusGlyph("success")} all metrics meet thresholds`;
+	}
 	const metrics = cov.violations.map((v) => v.metric).join(", ");
 	const fileCount = countLowCoverageFiles(cov.gaps);
 	return `Coverage: ${statusGlyph("failure")} ${Fmt.plural(fileCount, "file")} below minimum thresholds (${metrics})`;
 };
+/**
+* The coverage judgment line followed by the glob aggregate shortfall
+* block, as the lines a threshold cell appends to its summary. Empty when
+* the run carries no coverage block.
+*/
+const formatCoverageSummaryLines = (state) => {
+	const judgment = formatCoverageJudgmentLine(state);
+	if (judgment === null) return [];
+	return [judgment, ...formatGlobShortfallLines(state.coverage?.globShortfalls)];
+};
 const countLowCoverageFiles = (gaps) => {
 	const seen = /* @__PURE__ */ new Set();
 	for (const g of gaps) seen.add(g.file);
@@ -191,4 +240,4 @@ const pctCell = (n) => {
 };
 
 //#endregion
-export { formatBelowTargetTable, formatCoverageJudgmentLine, formatDisplayDuration, formatFailure, formatProjectRow, formatProjectsTable, formatTestName, formatTotals, formatTrendLine, formatWorkspaceTotal, soleModulePath, soleTest };
+export { formatBelowTargetTable, formatCoverageJudgmentLine, formatCoverageSummaryLines, formatDisplayDuration, formatFailure, formatGlobShortfallLines, formatPercent, formatProjectRow, formatProjectsTable, formatTestName, formatTotals, formatTrendLine, formatWorkspaceTotal, soleModulePath, soleTest };

package/index.d.ts

@@ -31,6 +31,35 @@ declare const FileCoverageReport: Schema.Struct<{
 }>;
 /** @public */
 type FileCoverageReport = typeof FileCoverageReport.Type;
+/**
+ * A threshold glob whose AGGREGATE coverage (summed covered/total across
+ * every file the glob matches, the same way Vitest evaluates a glob
+ * threshold) is below at least one of the glob's metric numbers.
+ *
+ * This is independent of the per-file lists: with an object `perFile` every
+ * matched file can pass while the glob as a whole still fails.
+ * @public
+ */
+declare const GlobShortfall: Schema.Struct<{
+  /** The threshold glob pattern as configured. */
+  readonly pattern: Schema.String;
+  /** Aggregate coverage percentages over the files the glob matches. */
+  readonly summary: Schema.Struct<{
+    readonly statements: Schema.Number;
+    readonly branches: Schema.Number;
+    readonly functions: Schema.Number;
+    readonly lines: Schema.Number;
+  }>;
+  /** The glob's own metric numbers that were set (`perFile` excluded). */
+  readonly thresholds: Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>;
+}>;
+/** @public */
+type GlobShortfall = typeof GlobShortfall.Type;
 //#endregion
 //#region src/schemas/RenderState.d.ts
 /**
@@ -153,6 +182,21 @@ export declare const CoverageRenderState: Schema.Struct<{
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>;
+  }>>>;
 }>;
 /** @public */
 export type CoverageRenderState = typeof CoverageRenderState.Type;
@@ -274,6 +318,21 @@ export declare const RenderState: Schema.Struct<{
     readonly scoped: Schema.optional<Schema.Boolean>;
     readonly scopedFiles: Schema.optional<Schema.Number>;
     readonly totalFiles: Schema.optional<Schema.Number>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>;
+    }>>>;
   }>>;
   readonly trend: Schema.NullOr<Schema.Struct<{
     readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
@@ -606,6 +665,21 @@ declare const AgentReport: Schema.Struct<{
       readonly uncoveredLines: Schema.String;
     }>>>;
     readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>;
+    }>>>;
   }>>;
   readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
     readonly passed: Schema.optional<Schema.Number>;
@@ -825,6 +899,21 @@ export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunSt
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>;
+  }>>>;
 }>, Schema.TaggedStruct<"ThresholdViolation", {
   readonly metric: Schema.Literals<readonly ["lines", "branches", "functions", "statements"]>;
   readonly expected: Schema.Number;
@@ -1074,6 +1163,8 @@ interface Cell {
  * UI rewrite spec §7 open question 1:
  *
  * 1. More than one project → `workspace`.
+ * 1b. `collectedModules` greater than one → `single-project` (the reduced
+ *    `modules` map may hold only the failing modules of a larger run).
  * 2. One module with exactly one test → `single-test`.
  * 3. One module with more than one test → `single-file`.
  * 4. Otherwise → `single-project`.
@@ -1593,6 +1684,16 @@ export declare const TrendLine: FC<TrendLineProps>;
  * @public
  */
 export declare const SUITE_LOAD_FAILURE_LABEL = "test suite failed to load";
+/**
+ * Synthetic test name for a suite-level failure in a module that loaded
+ * and collected one or more test cases — a failing `beforeAll` or
+ * `afterAll` hook, for example. The file imported fine, so
+ * {@link SUITE_LOAD_FAILURE_LABEL} would mislead; this label is used
+ * instead when the module has collected tests.
+ *
+ * @public
+ */
+export declare const SUITE_FAILURE_LABEL = "test suite failed";
 /**
  * Optional metadata threaded through the synthesized event stream.
  *
@@ -1636,6 +1737,8 @@ interface SynthesizedCoverage {
   readonly scopedFiles?: number;
   /** Total test-file count for the project, when known. */
   readonly totalFiles?: number;
+  /** Threshold globs whose aggregate coverage is below their numbers (issue #391). */
+  readonly globShortfalls?: ReadonlyArray<GlobShortfall>;
 }
 /**
  * Project a fully-completed Vitest run into the canonical
@@ -1768,5 +1871,5 @@ export declare const statusInkStyle: (name: VitestAgentStatusName) => InkTextSty
  */
 export declare const CURRENT_UI_VERSION: string;
 //#endregion
-export { type AgentCellFn, type AgentReport, type Cell, type CellOptions, type CountColumnsProps, type CoverageBlockProps, FileCoverageReport as CoverageFile, type CoverageTotals, type DispatchInputs, type FailureSectionProps, type FailuresSectionProps, type InkCellFn, type InkTextStyle, type MetricThresholds, type ModuleHeaderProps, type ProjectRowProps, type ProjectSummary, type RenderAgentOptions, type RunEventByTag, type RunOutcome, type RunShape, type StatusIconKind, type StatusIconProps, type StreamAppProps, type SuggestedActionsProps, type SynthesizeFromAgentReportOptions, type SynthesizeOptions, type SynthesizedCoverage, type TagColumnsProps, type TestClassification, type TestRowProps, type TrendLineProps, type TrendSummary, type VitestAgentStatusName, type VitestModuleDiagnostic, type VitestModuleError, type VitestParsedStack, type VitestTestCase, type VitestTestDiagnostic, type VitestTestError, type VitestTestModule, type VitestTestResult, type VitestTestSuite };
+export { type AgentCellFn, type AgentReport, type Cell, type CellOptions, type CountColumnsProps, type CoverageBlockProps, FileCoverageReport as CoverageFile, type CoverageTotals, type DispatchInputs, type FailureSectionProps, type FailuresSectionProps, type GlobShortfall, type InkCellFn, type InkTextStyle, type MetricThresholds, type ModuleHeaderProps, type ProjectRowProps, type ProjectSummary, type RenderAgentOptions, type RunEventByTag, type RunOutcome, type RunShape, type StatusIconKind, type StatusIconProps, type StreamAppProps, type SuggestedActionsProps, type SynthesizeFromAgentReportOptions, type SynthesizeOptions, type SynthesizedCoverage, type TagColumnsProps, type TestClassification, type TestRowProps, type TrendLineProps, type TrendSummary, type VitestAgentStatusName, type VitestModuleDiagnostic, type VitestModuleError, type VitestParsedStack, type VitestTestCase, type VitestTestDiagnostic, type VitestTestError, type VitestTestModule, type VitestTestResult, type VitestTestSuite };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -19,7 +19,7 @@ import { TrendLine } from "./render-ink/TrendLine.js";
 import { StreamApp } from "./render-ink/StreamApp.js";
 import { SuggestedActions } from "./render-ink/SuggestedActions.js";
 import "./render-ink/index.js";
-import { SUITE_LOAD_FAILURE_LABEL, synthesizeFromAgentReport, synthesizeRunEvents } from "./synthesize.js";
+import { SUITE_FAILURE_LABEL, SUITE_LOAD_FAILURE_LABEL, synthesizeFromAgentReport, synthesizeRunEvents } from "./synthesize.js";
 import { ActionSeverity, CoverageFile, CoverageGap, CoverageMetric, CoverageRenderState, FailureRecord, ModuleRecord, RenderState, RenderTotals, RunEvent, SuggestedActionRecord, TestRecord, initialRenderState } from "@vitest-agent/sdk";
 
 //#region src/index.ts
@@ -30,7 +30,7 @@ import { ActionSeverity, CoverageFile, CoverageGap, CoverageMetric, CoverageRend
 *
 * @public
 */
-const CURRENT_UI_VERSION = "4.0.1";
+const CURRENT_UI_VERSION = "4.1.0";
 
 //#endregion
-export { ActionSeverity, CURRENT_UI_VERSION, CountColumns, CoverageBlock, CoverageFile, CoverageGap, CoverageMetric, CoverageRenderState, DURATION_CELL_WIDTH, FailureRecord, FailureSection, FailuresSection, ModuleHeader, ModuleRecord, ProjectRow, RenderState, RenderTotals, RunEvent, SPINNER_FRAMES, SPINNER_FRAME_MS, SUITE_LOAD_FAILURE_LABEL, StatusIcon, StreamApp, SuggestedActionRecord, SuggestedActions, TagColumns, TestRecord, TestRow, TrendLine, VitestAgentStatus, VitestAgentTokens, buildFooter, classifyOutcome, classifyRunShape, dispatch, dispatchInk, dispatcherTable, dominantClassification, formatDisplayDuration, initialRenderState, inkStyle, reduceRenderState, reduceRenderStateAll, renderAgent, spinnerFrame, statusGlyph, statusInkStyle, synthesizeFromAgentReport, synthesizeRunEvents, tagUnion };
+export { ActionSeverity, CURRENT_UI_VERSION, CountColumns, CoverageBlock, CoverageFile, CoverageGap, CoverageMetric, CoverageRenderState, DURATION_CELL_WIDTH, FailureRecord, FailureSection, FailuresSection, ModuleHeader, ModuleRecord, ProjectRow, RenderState, RenderTotals, RunEvent, SPINNER_FRAMES, SPINNER_FRAME_MS, SUITE_FAILURE_LABEL, SUITE_LOAD_FAILURE_LABEL, StatusIcon, StreamApp, SuggestedActionRecord, SuggestedActions, TagColumns, TestRecord, TestRow, TrendLine, VitestAgentStatus, VitestAgentTokens, buildFooter, classifyOutcome, classifyRunShape, dispatch, dispatchInk, dispatcherTable, dominantClassification, formatDisplayDuration, initialRenderState, inkStyle, reduceRenderState, reduceRenderStateAll, renderAgent, spinnerFrame, statusGlyph, statusInkStyle, synthesizeFromAgentReport, synthesizeRunEvents, tagUnion };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/ui",
-	"version": "4.0.1",
+	"version": "4.1.0",
 	"private": false,
 	"description": "Shared event-sourced renderer for vitest-agent. React Ink view for humans, plain-string view for agents, both fed by the same reducer over a RunEvent stream.",
 	"keywords": [
@@ -39,7 +39,7 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@vitest-agent/sdk": "6.0.0",
+		"@vitest-agent/sdk": "6.1.0",
 		"effect": "^4.0.0"
 	},
 	"peerDependencies": {

package/reducer.js

@@ -178,7 +178,8 @@ const reduceRenderState = (state, event) => {
 				violations: state.coverage?.violations ?? [],
 				...e.scoped !== void 0 ? { scoped: e.scoped } : {},
 				...e.scopedFiles !== void 0 ? { scopedFiles: e.scopedFiles } : {},
-				...e.totalFiles !== void 0 ? { totalFiles: e.totalFiles } : {}
+				...e.totalFiles !== void 0 ? { totalFiles: e.totalFiles } : {},
+				...e.globShortfalls !== void 0 ? { globShortfalls: e.globShortfalls } : {}
 			}
 		}),
 		ThresholdViolation: (e) => {

package/render-agent.js

@@ -1,5 +1,5 @@
 import { formatTotalsLine } from "./counts.js";
-import { formatFailure as formatFailure$1 } from "./dispatcher/helpers.js";
+import { formatFailure as formatFailure$1, formatGlobShortfallLines } from "./dispatcher/helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/render-agent.ts
@@ -91,6 +91,7 @@ const formatCoverageSection = (state, maxGaps) => {
 		lines.push("Violations:");
 		for (const v of cov.violations) lines.push(`- ${v.metric}: ${formatPercent(v.actual)} < ${formatPercent(v.expected)}`);
 	}
+	lines.push(...formatGlobShortfallLines(cov.globShortfalls));
 	if (maxGaps > 0 && cov.gaps.length > 0) {
 		const topN = [...cov.gaps].sort((a, b) => b.missing.lines - a.missing.lines).slice(0, maxGaps);
 		lines.push("Gaps:");

package/synthesize.js

@@ -10,6 +10,16 @@ import { isTimeoutError } from "@vitest-agent/sdk";
 * @public
 */
 const SUITE_LOAD_FAILURE_LABEL = "test suite failed to load";
+/**
+* Synthetic test name for a suite-level failure in a module that loaded
+* and collected one or more test cases — a failing `beforeAll` or
+* `afterAll` hook, for example. The file imported fine, so
+* {@link SUITE_LOAD_FAILURE_LABEL} would mislead; this label is used
+* instead when the module has collected tests.
+*
+* @public
+*/
+const SUITE_FAILURE_LABEL = "test suite failed";
 const ISO_ZERO = "1970-01-01T00:00:00.000Z";
 const normalizeTestState = (state) => {
 	if (state === "passed") return "passed";
@@ -150,7 +160,8 @@ const synthesizeRunEvents = (modules, options = {}) => {
 			gaps: cov.gaps,
 			...cov.scoped !== void 0 ? { scoped: cov.scoped } : {},
 			...cov.scopedFiles !== void 0 ? { scopedFiles: cov.scopedFiles } : {},
-			...cov.totalFiles !== void 0 ? { totalFiles: cov.totalFiles } : {}
+			...cov.totalFiles !== void 0 ? { totalFiles: cov.totalFiles } : {},
+			...cov.globShortfalls !== void 0 ? { globShortfalls: cov.globShortfalls } : {}
 		});
 		if (cov.violations !== void 0) for (const v of cov.violations) events.push({
 			_tag: "ThresholdViolation",
@@ -218,7 +229,8 @@ const coverageReportToBlock = (report) => {
 		violations,
 		...cov.scoped ? { scoped: cov.scoped } : {},
 		...cov.scopedFiles !== void 0 ? { scopedFiles: cov.scopedFiles.length } : {},
-		...cov.totalFiles !== void 0 ? { totalFiles: cov.totalFiles } : {}
+		...cov.totalFiles !== void 0 ? { totalFiles: cov.totalFiles } : {},
+		...cov.globShortfalls !== void 0 ? { globShortfalls: cov.globShortfalls } : {}
 	};
 };
 /**
@@ -300,16 +312,17 @@ const synthesizeFromAgentReport = (report, options = {}) => {
 			fail = 1;
 			suiteFailureCount++;
 			const moduleError = mod.errors?.[0];
+			const suiteLabel = mod.tests.length > 0 ? SUITE_FAILURE_LABEL : SUITE_LOAD_FAILURE_LABEL;
 			events.push({
 				_tag: "TestStarted",
 				modulePath: mod.file,
-				testName: SUITE_LOAD_FAILURE_LABEL,
+				testName: suiteLabel,
 				suitePath: []
 			});
 			events.push({
 				_tag: "TestFinished",
 				modulePath: mod.file,
-				testName: SUITE_LOAD_FAILURE_LABEL,
+				testName: suiteLabel,
 				suitePath: [],
 				status: "failed",
 				durationMs: 0,
@@ -340,7 +353,8 @@ const synthesizeFromAgentReport = (report, options = {}) => {
 			gaps: coverage.gaps,
 			...coverage.scoped !== void 0 ? { scoped: coverage.scoped } : {},
 			...coverage.scopedFiles !== void 0 ? { scopedFiles: coverage.scopedFiles } : {},
-			...coverage.totalFiles !== void 0 ? { totalFiles: coverage.totalFiles } : {}
+			...coverage.totalFiles !== void 0 ? { totalFiles: coverage.totalFiles } : {},
+			...coverage.globShortfalls !== void 0 ? { globShortfalls: coverage.globShortfalls } : {}
 		});
 		if (coverage.violations !== void 0) for (const v of coverage.violations) events.push({
 			_tag: "ThresholdViolation",
@@ -378,4 +392,4 @@ const synthesizeFromAgentReport = (report, options = {}) => {
 };
 
 //#endregion
-export { SUITE_LOAD_FAILURE_LABEL, synthesizeFromAgentReport, synthesizeRunEvents };
+export { SUITE_FAILURE_LABEL, SUITE_LOAD_FAILURE_LABEL, synthesizeFromAgentReport, synthesizeRunEvents };