@vitest-agent/ui 4.0.1 → 5.0.0

package/README.md

@@ -11,8 +11,8 @@ Pure rendering primitives for vitest-agent. Owns the `RunEvent` reducer, the sha
 ## Features
 
 - **Reducer** — pure `(state, event) => state` fold over the `RunEvent` discriminated union; `reduceRenderStateAll` for one-shot replay
-- **Dispatcher matrix** — `dispatch` and `dispatchInk` route a `DispatchInputs` to the matching `(RunShape, RunOutcome)` cell; `classifyRunShape` and `classifyOutcome` derive the coordinates
-- **Ink components** — `StreamApp` and the supporting primitives (`ModuleHeader`, `TestRow`, `CoverageBlock`, `TrendLine`, `FailureSection`, etc.) for live `stream`-mode frames
+- **Dispatcher matrix** — `dispatch` routes a `DispatchInputs` to the matching `(RunShape, RunOutcome)` cell; `classifyRunShape` and `classifyOutcome` derive the coordinates
+- **Ink components** (`@vitest-agent/ui/ink`) — `StreamApp` and the supporting primitives (`ModuleHeader`, `TestRow`, `CoverageBlock`, `TrendLine`, `FailureSection`, etc.) for live `stream`-mode frames, plus `dispatchInk` / `inkDispatcherTable`, the Ink half of the matrix. The package root never loads React or Ink; only this subpath does
 - **Synthesizers** — `synthesizeRunEvents` from live Vitest modules; `synthesizeFromAgentReport` from a stored `AgentReport`
 - **Footer builder** — `buildFooter` assembles the L1 MCP-tool-pointer footer; `dominantClassification` picks the most actionable failure class
 
@@ -24,7 +24,7 @@ npm install @vitest-agent/ui
 pnpm add @vitest-agent/ui
 ```
 
-React and Ink are required peers:
+React and Ink are optional peers, needed only for the `@vitest-agent/ui/ink` subpath:
 
 ```bash
 npm install react ink

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

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatFailure, soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-file-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -20,10 +19,7 @@ const renderAgent = (inputs) => {
 	}
 	return `${sections.join("\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleFileFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFileFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFileFail };

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

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-file-pass.ts
@@ -11,10 +10,7 @@ const renderAgent = (inputs) => {
 	const { passCount, durationMs } = inputs.state.totals;
 	return `${modulePath}: ${Fmt.plural(passCount, "test")} passed (${formatDisplayDuration(durationMs)})\n${buildFooter(inputs)}`;
 };
-const renderSingleFilePass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFilePass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFilePass };

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

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
-import { formatCoverageJudgmentLine, soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
+import { formatCoverageSummaryLines, soleModulePath } from "../helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-file-threshold.ts
@@ -10,14 +9,10 @@ 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 = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFileThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFileThreshold };

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

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatFailure, formatTotals } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-project-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -25,10 +24,7 @@ const renderAgent = (inputs) => {
 	if (moduleLines.length > 1) sections.push(moduleLines);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectFail };

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

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatTotals } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-project-pass.ts
@@ -10,10 +9,7 @@ const renderAgent = (inputs) => {
 	const collected = inputs.state.collectedModules ?? inputs.state.moduleOrder.length;
 	return `${(collected === 0 ? [formatTotals(inputs.state)] : [formatTotals(inputs.state), `${Fmt.plural(collected, "module")} all-passed.`]).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectPass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectPass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectPass };

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

@@ -1,25 +1,21 @@
 import { buildFooter } from "../footer.js";
-import { formatBelowTargetTable, formatCoverageJudgmentLine, formatTotals, formatTrendLine } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
+import { formatBelowTargetTable, formatCoverageSummaryLines, formatTotals, formatTrendLine } from "../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);
 	if (below.length > 0) sections.push([...below]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectThreshold = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectThreshold };

package/dispatcher/cells/single-test-fail.js

@@ -2,7 +2,6 @@ import { buildFooter } from "../footer.js";
 import { statusGlyph } from "../../theme.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatFailure, formatTestName, soleTest } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-test-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -14,10 +13,7 @@ const renderAgent = (inputs) => {
 	const failure = inputs.state.failures[0];
 	return `${failure === void 0 ? `${header}\n` : `${header}\n${formatFailure(failure, DEFAULT_WIDTH).join("\n")}\n`}${buildFooter(inputs)}`;
 };
-const renderSingleTestFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleTestFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleTestFail };

package/dispatcher/cells/single-test-pass.js

@@ -2,7 +2,6 @@ import { buildFooter } from "../footer.js";
 import { statusGlyph } from "../../theme.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatTestName, soleTest } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-test-pass.ts
 const renderAgent = (inputs) => {
@@ -11,10 +10,7 @@ const renderAgent = (inputs) => {
 	const duration = test.durationMs ?? 0;
 	return `${statusGlyph("success")} ${formatTestName(test)} (${formatDisplayDuration(duration)})\n${buildFooter(inputs)}`;
 };
-const renderSingleTestPass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleTestPass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleTestPass };

package/dispatcher/cells/workspace-fail.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatFailure, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -18,10 +17,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspaceFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspaceFail = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspaceFail };

package/dispatcher/cells/workspace-pass.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatCoverageJudgmentLine, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-pass.ts
 const renderAgent = (inputs) => {
@@ -16,10 +15,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspacePass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspacePass = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspacePass };

package/dispatcher/cells/workspace-threshold.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
-import { formatBelowTargetTable, formatCoverageJudgmentLine, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
+import { formatBelowTargetTable, formatCoverageSummaryLines, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
 
 //#region src/dispatcher/cells/workspace-threshold.ts
 const BELOW_TARGET_LIMIT = 10;
@@ -9,8 +8,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);
@@ -19,10 +18,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspaceThreshold = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspaceThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspaceThreshold };

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/dispatch.js

@@ -10,9 +10,7 @@ import { renderSingleTestThreshold } from "./cells/single-test-threshold.js";
 import { renderWorkspaceFail } from "./cells/workspace-fail.js";
 import { renderWorkspacePass } from "./cells/workspace-pass.js";
 import { renderWorkspaceThreshold } from "./cells/workspace-threshold.js";
-import { formatScopedCoverageNote } from "@vitest-agent/sdk";
-import { Box, Text } from "ink";
-import { createElement } from "react";
+import { formatScopedCoverageNote, formatStrayOutputNote } from "@vitest-agent/sdk";
 
 //#region src/dispatcher/dispatch.ts
 /**
@@ -56,11 +54,27 @@ const dispatcherTable = {
 const dispatch = (inputs, opts) => {
 	const body = dispatcherTable[inputs.shape][inputs.outcome].agent(inputs, opts);
 	const note = scopedCoverageNoteFor(inputs);
-	return note !== null ? `${body}\n${note}` : body;
+	const withNote = note !== null ? `${body}\n${note}` : body;
+	const stray = strayOutputNoteFor(inputs);
+	return stray !== null ? `${withNote}\n${stray}\n` : withNote;
+};
+/**
+* The stray-output note for a run that wrote past Vitest's console capture,
+* or `null` when it wrote nothing stray. `dispatch` and `dispatchInk` append
+* it after the cell's output (and the scoped-coverage note); cells never emit
+* it themselves.
+*
+* @param inputs - the classified dispatch inputs
+* @returns the note's lines joined, or `null`
+* @internal
+*/
+const strayOutputNoteFor = (inputs) => {
+	const stray = inputs.state.strayOutput;
+	return stray === void 0 ? null : formatStrayOutputNote(stray).join("\n");
 };
 /**
 * Build the scoped-coverage note for this run, or `null` on a full
-* (non-scoped) run. Shared by {@link dispatch} and {@link dispatchInk} so
+* (non-scoped) run. Shared by {@link dispatch} and the Ink entry's `dispatchInk` so
 * both render paths surface the same information (issue #160 gap 1) —
 * Vitest's coverage thresholds are meaningless against a subset of the
 * project's test files, so every cell's own threshold-flavored coverage
@@ -73,25 +87,6 @@ const scopedCoverageNoteFor = (inputs) => {
 	if (cov === null || cov.scoped !== true) return null;
 	return formatScopedCoverageNote(cov.scopedFiles ?? 0, cov.totalFiles);
 };
-/**
-* Dispatch to the cell that matches `(inputs.shape, inputs.outcome)`
-* and return its Ink-half React tree. Returns `null` when the matched
-* cell does not expose an `ink` half — callers should fall back to
-* the agent string in that case.
-*
-* @param inputs - the classified dispatch inputs
-* @param opts - cell rendering options
-* @returns the Ink React element, or `null` when the cell has no Ink half
-* @public
-*/
-const dispatchInk = (inputs, opts) => {
-	const cell = dispatcherTable[inputs.shape][inputs.outcome];
-	if (cell.ink === void 0) return null;
-	const element = cell.ink(inputs, opts);
-	const note = scopedCoverageNoteFor(inputs);
-	if (note === null) return element;
-	return createElement(Box, { flexDirection: "column" }, element, createElement(Text, null, note));
-};
 
 //#endregion
-export { dispatch, dispatchInk, dispatcherTable };
+export { dispatch, dispatcherTable, scopedCoverageNoteFor, strayOutputNoteFor };

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 };