@vitest-agent/sdk 5.2.0 → 6.0.0

package/README.md

@@ -6,7 +6,7 @@
 
 > **Part of the [vitest-agent](https://vitest-agent.dev) ecosystem.** Most users want **[@vitest-agent/plugin](https://www.npmjs.com/package/@vitest-agent/plugin)**, which pulls this package in automatically. Install `@vitest-agent/sdk` directly only if you build tooling on the shared schemas or contract types.
 
-The platform-free core of the vitest-agent ecosystem. Carries the Effect Schemas, the public reporter and dispatcher contract types, the tagged errors, the pure formatters and utilities, the pure sidecar `dispatch` entry, and the published JSON Schemas. It has no workspace dependencies and never imports `node:*`, so it runs anywhere Effect does.
+The platform-free core of the vitest-agent ecosystem. Carries the Effect Schemas, the public reporter and dispatcher contract types, the tagged errors, the pure utilities, the pure sidecar `dispatch` entry, and the published JSON Schemas. It has no workspace dependencies and never imports `node:*`, so it runs anywhere Effect does.
 
 Everything that touches a filesystem, a process, or SQLite — the `DataStore` / `DataReader` services and their live layers, migrations, `ensureMigrated`, `PlatformLive`, `resolveDataPath`, and the test-layer helpers — lives in **[@vitest-agent/engine](https://www.npmjs.com/package/@vitest-agent/engine)**.
 
@@ -15,7 +15,7 @@ Everything that touches a filesystem, a process, or SQLite — the `DataStore` /
 - **Effect Schemas** — all domain types (`AgentReport`, `RunEvent`, `RenderState`, `CoverageTargets`, `TurnPayload`, identity types) defined with Effect Schema; runtime validation and TypeScript types from one source
 - **Reporter and dispatcher contracts** — `VitestAgentReporterFactory`, `ReporterKit`, `ResolvedReporterConfig`, `DispatchInputs` and the types consumed by every other package
 - **Tagged errors** — `Data.TaggedError` families for data-store, discovery, path-resolution, project-identity, run-context, TDD and agent failures
-- **Pure formatters and utilities** — terminal, markdown, GFM, JSON and CI-annotation formatters, plus `classifyTestPath`, `buildAgentReport`, `validatePhaseTransition` and the posix path helpers
+- **Pure utilities** — `classifyTestPath`, `buildAgentReport`, `validatePhaseTransition` and the posix path helpers
 - **Sidecar dispatch core** — `dispatch`, `injectEnv` and `exitCodeForTag` on the `@vitest-agent/sdk/dispatch` sub-path for a minimal SEA bundle
 - **JSON Schemas** — generated schemas on the `@vitest-agent/sdk/schemas/*.json` sub-path (for example the run-report file schema)
 

package/index.d.ts

@@ -552,6 +552,31 @@ export interface CellOptions {
   readonly osc8: (url: string, label: string) => string;
 }
 //#endregion
+//#region src/formatters/types.d.ts
+/**
+ * One unit of rendered reporter output, tagged by where it goes.
+ *
+ * `stdout` writes to the process stdout stream, `github-summary`
+ * appends to the GitHub Actions step-summary file, and `file` is
+ * reserved for reporters that embed their own destination path.
+ *
+ * `report` writes `filename` into `.vitest/<scope>/` through Vitest 5's
+ * `createReport`. The plugin drops these when reporting is disabled,
+ * exactly as it drops `github-summary` outside GitHub Actions.
+ *
+ * @public
+ */
+export type RenderedOutput = {
+  readonly target: "stdout" | "file" | "github-summary";
+  readonly content: string;
+  readonly contentType: string;
+} | {
+  readonly target: "report";
+  readonly filename: string;
+  readonly content: string;
+  readonly contentType: string;
+};
+//#endregion
 //#region src/schemas/AgentReport.d.ts
 /**
  * Aggregate test run statistics.
@@ -940,61 +965,6 @@ export declare const ReportError: Schema.Struct<{
 /** @public */
 export type ReportError = typeof ReportError.Type;
 //#endregion
-//#region src/formatters/types.d.ts
-/**
- * One unit of rendered reporter output, tagged by where it goes.
- *
- * `stdout` writes to the process stdout stream, `github-summary`
- * appends to the GitHub Actions step-summary file, and `file` is
- * reserved for reporters that embed their own destination path.
- *
- * `report` writes `filename` into `.vitest/<scope>/` through Vitest 5's
- * `createReport`. The plugin drops these when reporting is disabled,
- * exactly as it drops `github-summary` outside GitHub Actions.
- *
- * @public
- */
-export type RenderedOutput = {
-  readonly target: "stdout" | "file" | "github-summary";
-  readonly content: string;
-  readonly contentType: string;
-} | {
-  readonly target: "report";
-  readonly filename: string;
-  readonly content: string;
-  readonly contentType: string;
-};
-/** @public */
-export interface FormatterContext {
-  readonly detail: DetailLevel;
-  /**
-   * Absolute project root the run executed from. Formatters strip it from
-   * absolute file paths for display and resolve relative paths back against
-   * it for `file://` hyperlinks — the core never reads `process.cwd()`.
-   */
-  readonly cwd: string;
-  readonly noColor: boolean;
-  readonly coverageConsoleLimit: number;
-  readonly trendSummary?: {
-    direction: "improving" | "regressing" | "stable";
-    runCount: number;
-    firstMetric?: {
-      name: string;
-      from: number;
-      to: number;
-      target?: number;
-    };
-  };
-  readonly runCommand?: string;
-  readonly githubSummaryFile?: string;
-  readonly mcp?: boolean;
-}
-/** @public */
-export interface Formatter {
-  readonly format: string;
-  readonly render: (reports: ReadonlyArray<AgentReport>, context: FormatterContext) => ReadonlyArray<RenderedOutput>;
-}
-//#endregion
 //#region src/schemas/RunEvent.d.ts
 /**
  * Coverage metric whose threshold can be violated independently.
@@ -1955,40 +1925,6 @@ export declare class IllegalStatusTransitionError extends IllegalStatusTransitio
   });
 }
 //#endregion
-//#region src/formatters/ci-annotations.d.ts
-/** @public */
-export declare const ciAnnotationsFormatter: Formatter;
-//#endregion
-//#region src/formatters/gfm.d.ts
-/** @public */
-export declare const GfmFormatter: Formatter;
-//#endregion
-//#region src/formatters/json.d.ts
-/** @public */
-export declare const JsonFormatter: Formatter;
-//#endregion
-//#region src/formatters/markdown.d.ts
-/**
- * Markdown formatter for surfaces that *render* markdown.
- *
- * Stdout output goes through {@link TerminalFormatter} (plain text +
- * ANSI), not this formatter — markdown syntax (e.g. heading prefixes,
- * backticks, list dashes) is visual noise in a terminal that doesn't
- * render it. This formatter remains for callers that explicitly request
- * `format: "markdown"`, e.g. when piping the rendered output into a
- * Markdown-aware sink.
- * @public
- */
-export declare const MarkdownFormatter: Formatter;
-//#endregion
-//#region src/formatters/silent.d.ts
-/** @public */
-export declare const SilentFormatter: Formatter;
-//#endregion
-//#region src/formatters/terminal.d.ts
-/** @public */
-export declare const TerminalFormatter: Formatter;
-//#endregion
 //#region src/schemas/Agent.d.ts
 declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
   readonly agentId: Schema.brand<Schema.String, "AgentId">;

package/index.js

@@ -5,19 +5,6 @@ import { PathResolutionError } from "./errors/PathResolutionError.js";
 import { ProjectIdentityNotResolvableError } from "./errors/ProjectIdentityError.js";
 import { GitCommandError, ProbeMissError } from "./errors/RunContextError.js";
 import { BehaviorNotFoundError, GoalNotFoundError, IllegalStatusTransitionError, TddTaskAlreadyEndedError, TddTaskNotFoundError } from "./errors/TddErrors.js";
-import { ciAnnotationsFormatter } from "./formatters/ci-annotations.js";
-import { formatGfm } from "./utils/format-gfm.js";
-import { GfmFormatter } from "./formatters/gfm.js";
-import { JsonFormatter } from "./formatters/json.js";
-import { ansi, stripAnsi } from "./utils/ansi.js";
-import { formatScopedCoverageNote } from "./utils/format-scoped-coverage-note.js";
-import { determineTier, formatConsoleMarkdown, getWorstMetric, relativePath } from "./utils/format-console.js";
-import { MarkdownFormatter } from "./formatters/markdown.js";
-import { SilentFormatter } from "./formatters/silent.js";
-import { compressLines } from "./utils/compress-lines.js";
-import { osc8 } from "./utils/hyperlink.js";
-import { basenamePosix, joinPosix, relativePosix, toPosix } from "./utils/posix-path.js";
-import { TerminalFormatter } from "./formatters/terminal.js";
 import { ActorType, AgentId, ChatId, ConversationId, HostKind, ProjectKey, TddTaskId } from "./schemas/Identity.js";
 import { Agent, IdempotencyHit } from "./schemas/Agent.js";
 import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
@@ -48,19 +35,26 @@ import { ToolCallPayload } from "./schemas/turns/ToolCallPayload.js";
 import { ToolResultPayload } from "./schemas/turns/ToolResultPayload.js";
 import { UserPromptPayload } from "./schemas/turns/UserPromptPayload.js";
 import { TurnPayload } from "./schemas/turns/index.js";
+import { ansi, stripAnsi } from "./utils/ansi.js";
 import { coerceErrorField, coerceErrorText } from "./utils/coerce-error-text.js";
 import { buildAgentReport, countSuiteFailures } from "./utils/build-report.js";
 import { canonicalizeGitUrl, gitUrlToProjectKey } from "./utils/canonicalize-git-url.js";
 import { classifyTest } from "./utils/classify-test.js";
+import { compressLines } from "./utils/compress-lines.js";
 import { computeTrend, getRecentDirection, hashTargets } from "./utils/compute-trend.js";
 import { buildConsoleLeaks, collectConsoleLeakEntries } from "./utils/console-leaks.js";
 import { detectNonDefaultDiscoverStrategy } from "./utils/detect-non-default-discover-strategy.js";
 import { detectPackageManager, getRunCommand } from "./utils/detect-pm.js";
 import { isTimeoutError } from "./utils/detect-timeout.js";
+import { formatScopedCoverageNote } from "./utils/format-scoped-coverage-note.js";
+import { determineTier, formatConsoleMarkdown, getWorstMetric, relativePath } from "./utils/format-console.js";
 import { formatFatalError } from "./utils/format-fatal-error.js";
+import { formatGfm } from "./utils/format-gfm.js";
 import { findFunctionBoundary } from "./utils/function-boundary.js";
+import { osc8 } from "./utils/hyperlink.js";
 import { buildEnvPrefix, detectVitestScripts, isVitestInvocation, rewriteBashCommand } from "./utils/match-vitest-command.js";
 import { normalizeWorkspaceKey } from "./utils/normalize-workspace-key.js";
+import { basenamePosix, joinPosix, relativePosix, toPosix } from "./utils/posix-path.js";
 import { probeHostMetadataFromEnv } from "./utils/probe-host-metadata.js";
 import { safeFilename } from "./utils/safe-filename.js";
 import { BATS_FILE_GLOB_SUFFIX, NON_DISCOVERABLE_DIRS, SRC_DIR, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, classifyTestPath, findOwningWorkspace, isTestFileName } from "./utils/test-location.js";
@@ -68,4 +62,4 @@ import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-
 import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "./utils/validate-phase-transition.js";
 import { CURRENT_SDK_VERSION } from "./version.js";
 
-export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, JsonFormatter, MarkdownFormatter, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SilentFormatter, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TerminalFormatter, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "5.2.0",
+	"version": "6.0.0",
 	"private": false,
-	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, formatters, and pure utilities.",
+	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, and pure utilities.",
 	"keywords": [
 		"vitest",
 		"agent",

package/version.js

@@ -11,7 +11,7 @@
 * survives into the published artifact.
 * @public
 */
-const CURRENT_SDK_VERSION = "5.2.0";
+const CURRENT_SDK_VERSION = "6.0.0";
 
 //#endregion
 export { CURRENT_SDK_VERSION };

package/formatters/ci-annotations.js

@@ -1,61 +0,0 @@
-//#region src/formatters/ci-annotations.ts
-const escapeData = (s) => s.replace(/%/g, "%25").replace(/\n/g, "%0A").replace(/\r/g, "%0D");
-const escapeProperty = (s) => s.replace(/%/g, "%25").replace(/\n/g, "%0A").replace(/\r/g, "%0D").replace(/:/g, "%3A").replace(/,/g, "%2C");
-const STACK_FILE_LINE = /\(([^():\s]+):(\d+):\d+\)/;
-function extractFileAndLine(error, fallbackFile) {
-	if (error.stack !== void 0) {
-		const m = STACK_FILE_LINE.exec(error.stack);
-		if (m) return {
-			file: m[1],
-			line: Number.parseInt(m[2], 10)
-		};
-	}
-	return {
-		file: fallbackFile,
-		line: 1
-	};
-}
-function annotateFailure(report) {
-	const lines = [];
-	for (const mod of report.failed) for (const test of mod.tests) {
-		if (test.state !== "failed") continue;
-		const errors = test.errors ?? [];
-		if (errors.length === 0) {
-			lines.push(`::error file=${escapeProperty(mod.file)},line=1,title=${escapeProperty(test.fullName)}::${escapeData(`${test.fullName} failed`)}`);
-			continue;
-		}
-		for (const err of errors) {
-			const { file, line } = extractFileAndLine(err, mod.file);
-			lines.push(`::error file=${escapeProperty(file)},line=${line},title=${escapeProperty(test.fullName)}::${escapeData(err.message)}`);
-		}
-	}
-	for (const err of report.unhandledErrors) lines.push(`::error title=Unhandled%20error::${escapeData(err.message)}`);
-	return lines;
-}
-/** @public */
-const ciAnnotationsFormatter = {
-	format: "ci-annotations",
-	render: (reports, _context) => {
-		const allLines = [];
-		let totalPassed = 0;
-		let totalFailed = 0;
-		let totalSkipped = 0;
-		let totalDuration = 0;
-		for (const r of reports) {
-			allLines.push(...annotateFailure(r));
-			totalPassed += r.summary.passed;
-			totalFailed += r.summary.failed;
-			totalSkipped += r.summary.skipped;
-			totalDuration += r.summary.duration;
-		}
-		if (allLines.length === 0) allLines.push(`::notice::${escapeData(`Vitest: ${totalPassed} passed, ${totalSkipped} skipped (${totalDuration}ms)`)}`);
-		return [{
-			target: "stdout",
-			content: `${allLines.join("\n")}\n`,
-			contentType: "text/plain"
-		}];
-	}
-};
-
-//#endregion
-export { ciAnnotationsFormatter };

package/formatters/gfm.js

@@ -1,20 +0,0 @@
-import { formatGfm } from "../utils/format-gfm.js";
-
-//#region src/formatters/gfm.ts
-/** @public */
-const GfmFormatter = {
-	format: "gfm",
-	render: (reports, _context) => {
-		const outputs = [];
-		const gfm = formatGfm([...reports]);
-		if (gfm) outputs.push({
-			target: "github-summary",
-			content: gfm,
-			contentType: "text/markdown"
-		});
-		return outputs;
-	}
-};
-
-//#endregion
-export { GfmFormatter };

package/formatters/json.js

@@ -1,18 +0,0 @@
-//#region src/formatters/json.ts
-/** @public */
-const JsonFormatter = {
-	format: "json",
-	render: (reports, _context) => {
-		const outputs = [];
-		const json = JSON.stringify(reports, null, 2);
-		outputs.push({
-			target: "stdout",
-			content: json,
-			contentType: "application/json"
-		});
-		return outputs;
-	}
-};
-
-//#endregion
-export { JsonFormatter };

package/formatters/markdown.js

@@ -1,40 +0,0 @@
-import { formatConsoleMarkdown } from "../utils/format-console.js";
-
-//#region src/formatters/markdown.ts
-/**
-* Markdown formatter for surfaces that *render* markdown.
-*
-* Stdout output goes through {@link TerminalFormatter} (plain text +
-* ANSI), not this formatter — markdown syntax (e.g. heading prefixes,
-* backticks, list dashes) is visual noise in a terminal that doesn't
-* render it. This formatter remains for callers that explicitly request
-* `format: "markdown"`, e.g. when piping the rendered output into a
-* Markdown-aware sink.
-* @public
-*/
-const MarkdownFormatter = {
-	format: "markdown",
-	render: (reports, context) => {
-		const outputs = [];
-		for (const report of reports) {
-			const md = formatConsoleMarkdown(report, {
-				consoleOutput: context.detail === "minimal" ? "failures" : "full",
-				coverageConsoleLimit: context.coverageConsoleLimit,
-				cwd: context.cwd,
-				noColor: context.noColor,
-				...context.trendSummary !== void 0 ? { trendSummary: context.trendSummary } : {},
-				...context.runCommand !== void 0 ? { runCommand: context.runCommand } : {},
-				...context.mcp !== void 0 ? { mcp: context.mcp } : {}
-			});
-			if (md) outputs.push({
-				target: "stdout",
-				content: md,
-				contentType: "text/markdown"
-			});
-		}
-		return outputs;
-	}
-};
-
-//#endregion
-export { MarkdownFormatter };

package/formatters/silent.js

@@ -1,9 +0,0 @@
-//#region src/formatters/silent.ts
-/** @public */
-const SilentFormatter = {
-	format: "silent",
-	render: () => []
-};
-
-//#endregion
-export { SilentFormatter };

package/formatters/terminal.js

@@ -1,58 +0,0 @@
-import { formatTerminal } from "../utils/format-terminal.js";
-import { osc8 } from "../utils/hyperlink.js";
-import { joinPosix } from "../utils/posix-path.js";
-
-//#region src/formatters/terminal.ts
-/**
-* Wrap test-file paths in failing-test rows with `file://` OSC-8
-* hyperlinks. Only fires when the target is stdout and noColor is
-* unset; MCP responses never reach this formatter so they cannot
-* accidentally pick up escape sequences.
-*
-* Failing-test rows are emitted by `renderFailedTest` in
-* `format-terminal.ts` as
-*
-*   `    ` + ANSI(red, ✗) + ` ` + path + ` > ` + fullName
-*
-* The ✗ is wrapped in ANSI color escapes whenever color is on (which
-* is always when this function runs — `wrapHyperlinks` is gated on
-* `!noColor`). The optional `(?:\x1b\[\d+m)?` groups around `✗` make
-* the pattern tolerant of those escapes; without them the regex
-* silently never matched and the hyperlink feature was a no-op.
-*
-* The captured path is project-relative (the failing-test row goes
-* through `relativePath()` in `format-terminal.ts`). RFC 8089
-* requires an absolute filesystem path inside a `file://` URL —
-* iTerm2 / WezTerm / Kitty / VSCode all silently fail to open
-* relative targets. Resolve the captured value back to absolute
-* against `ctx.cwd` before handing it to `osc8`. The display label
-* stays relative so the rendered output is unchanged.
-* @public
-*/
-const FAILED_TEST_ROW = /^( {4}(?:\x1b\[\d+m)?✗(?:\x1b\[\d+m)? )([^ ]+)( > )/gm;
-const wrapHyperlinks = (text, ctx) => text.replace(FAILED_TEST_ROW, (_match, prefix, captured, suffix) => {
-	const absolute = captured.startsWith("/") ? captured : joinPosix(ctx.cwd, captured);
-	return `${prefix}${osc8(`file://${absolute}`, captured, { enabled: !ctx.noColor })}${suffix}`;
-});
-/** @public */
-const TerminalFormatter = {
-	format: "terminal",
-	render: (reports, context) => {
-		const text = formatTerminal(reports, {
-			cwd: context.cwd,
-			noColor: context.noColor,
-			coverageConsoleLimit: context.coverageConsoleLimit,
-			...context.trendSummary !== void 0 ? { trendSummary: context.trendSummary } : {},
-			...context.mcp !== void 0 ? { mcp: context.mcp } : {}
-		});
-		if (text === "") return [];
-		return [{
-			target: "stdout",
-			content: context.noColor ? text : wrapHyperlinks(text, context),
-			contentType: "text/plain"
-		}];
-	}
-};
-
-//#endregion
-export { TerminalFormatter };

package/utils/format-terminal.js

@@ -1,493 +0,0 @@
-import { ansi } from "./ansi.js";
-import { formatScopedCoverageNote } from "./format-scoped-coverage-note.js";
-import { relativePath } from "./format-console.js";
-import { compressLines } from "./compress-lines.js";
-
-//#region src/utils/format-terminal.ts
-/**
-* Compress a comma-separated line list into ranges where consecutive
-* numbers run together. Defensive: callers may pass already-compressed
-* strings (e.g. "29-32, 34-38") or uncompressed (e.g. "29,30,31,32") —
-* both are handled. If parsing fails, the original string is returned
-* unchanged.
-*
-* @internal
-*/
-const compressUncov = (uncoveredLines) => {
-	if (uncoveredLines.length === 0) return "";
-	if (uncoveredLines.includes("-")) return uncoveredLines;
-	const numbers = [];
-	for (const piece of uncoveredLines.split(",")) {
-		const n = Number.parseInt(piece.trim(), 10);
-		if (Number.isNaN(n)) return uncoveredLines;
-		numbers.push(n);
-	}
-	return compressLines(numbers);
-};
-const METRICS = [
-	{
-		key: "lines",
-		label: "lines"
-	},
-	{
-		key: "branches",
-		label: "branches"
-	},
-	{
-		key: "functions",
-		label: "funcs"
-	},
-	{
-		key: "statements",
-		label: "stmts"
-	}
-];
-/**
-* Format a duration in milliseconds as a short human string.
-*
-* Sub-second durations stay in ms (`"328ms"`); 1s and longer switch to
-* seconds with one decimal (`"5.6s"`). Avoids the noise of "5577ms" in
-* summary rows where second-level precision is plenty.
-*
-* @internal
-*/
-const formatDuration = (ms) => {
-	if (ms < 1e3) return `${Math.round(ms)}ms`;
-	return `${(ms / 1e3).toFixed(1)}s`;
-};
-/**
-* Decide whether the project label should appear in the row.
-*
-* Single-project setups with no explicit `project.name` (Vitest's
-* default) have `project` set to `"default"`. In that case there's
-* nothing to disambiguate; suppress the label.
-*
-* @internal
-*/
-const showProjectLabel = (reports) => {
-	if (reports.length > 1) return true;
-	const single = reports[0];
-	if (!single?.project) return false;
-	if (single.project === "default") return false;
-	return true;
-};
-/**
-* Right-pad a column value to a fixed width with spaces. Plain ASCII
-* width — does not account for ANSI escapes (caller is responsible).
-*
-* @internal
-*/
-const pad = (s, width) => s.length >= width ? s : s + " ".repeat(width - s.length);
-/**
-* Build an inline tag-count summary suffix for a project row.
-* Only shown when two or more distinct tag kinds are present.
-*
-* @internal
-*/
-const buildTagSummary = (tagCounts) => {
-	if (!tagCounts) return "";
-	const keys = Object.keys(tagCounts).sort();
-	if (keys.length < 2) return "";
-	return "  " + keys.map((k) => {
-		const c = tagCounts[k];
-		return `${k}:${(c?.passed ?? 0) + (c?.failed ?? 0) + (c?.skipped ?? 0)}`;
-	}).join("  ");
-};
-/**
-* Render indented per-tag pass/fail breakdown rows for a project that has failures.
-* The `s` (skipped) column only appears when skipped \> 0 for that tag.
-*
-* @internal
-*/
-const renderTagFailureBreakdown = (tagCounts) => {
-	const lines = [];
-	const keys = Object.keys(tagCounts).sort();
-	if (keys.length === 0) return lines;
-	const tagWidth = Math.max(...keys.map((k) => k.length));
-	for (const k of keys) {
-		const c = tagCounts[k];
-		const p = c?.passed ?? 0;
-		const f = c?.failed ?? 0;
-		const s = c?.skipped ?? 0;
-		const skipPart = s > 0 ? `  ${s}s` : "";
-		lines.push(`      ${k.padEnd(tagWidth)}  ${p}p  ${f}f${skipPart}`);
-	}
-	return lines;
-};
-/**
-* Project row: `✓ name      103 passed (2.1s)` or
-* `✗ name      102 passed, 1 failed (2.1s)`.
-*
-* @internal
-*/
-const renderProjectRow = (report, ao, nameWidth) => {
-	const failed = report.summary.failed;
-	const passed = report.summary.passed;
-	const skipped = report.summary.skipped;
-	const duration = formatDuration(report.summary.duration);
-	const name = report.project ?? "default";
-	const tick = failed === 0 ? ansi("✓", "green", ao) : ansi("✗", "red", ao);
-	const counts = [];
-	if (failed > 0) counts.push(`${failed} failed`);
-	counts.push(`${passed} passed`);
-	if (skipped > 0) counts.push(`${skipped} skipped`);
-	return `${`  ${tick} ${pad(name, nameWidth)}  ${counts.join(", ")} (${duration})`}${buildTagSummary(report.tagCounts)}`;
-};
-/**
-* Format the global target spec compactly.
-*
-* If every metric has the same target (the common case), collapse to
-* `≥ 80% lines, branches, funcs, stmts`. If targets differ, list per
-* metric: `lines ≥ 80%, branches ≥ 75%, funcs ≥ 70%, stmts ≥ 80%`.
-*
-* @internal
-*/
-const formatTargetSpec = (targets) => {
-	const set = /* @__PURE__ */ new Set();
-	const present = [];
-	for (const m of METRICS) {
-		const v = targets[m.key];
-		if (v == null) continue;
-		set.add(v);
-		present.push({
-			label: m.label,
-			v
-		});
-	}
-	if (present.length === 0) return "";
-	if (set.size === 1) {
-		const v = [...set][0];
-		return `${present.map((p) => p.label).join(", ")} ≥ ${v}%`;
-	}
-	return present.map((p) => `${p.label} ≥ ${p.v}%`).join(", ");
-};
-/**
-* Header labels for the v8-style coverage table. The order is fixed
-* and matches the column order rendered by {@link renderBelowTargetTable}.
-*
-* @internal
-*/
-const TABLE_HEADERS = {
-	file: "File",
-	stmts: "% Stmts",
-	branches: "% Branch",
-	funcs: "% Funcs",
-	lines: "% Lines",
-	uncov: "Uncovered Line #s"
-};
-/**
-* Pad a cell with one space on each side of its content. Numeric
-* cells are right-aligned, string cells are left-aligned. The width
-* argument is the inner content width (without the padding spaces).
-*
-* @internal
-*/
-const cell = (s, width, align) => {
-	return ` ${align === "right" ? s.padStart(width) : s.padEnd(width)} `;
-};
-/**
-* Render a separator row matching the column geometry of the header.
-* Width per column = inner width + 2 (the padding spaces) so the row
-* lines up with the headers and data rows when joined by `|`.
-*
-* @internal
-*/
-const sepRow = (widths) => widths.map((w) => "-".repeat(w + 2)).join("|");
-/**
-* v8-style coverage table for files below aspirational targets.
-*
-* Columns: File, % Stmts, % Branch, % Funcs, % Lines, Uncovered
-* Line #s. Numeric columns are right-aligned and show the file's
-* actual coverage value (no `%` suffix — the header carries it).
-* Showing every metric per row, not just the below-target ones,
-* matches v8's reporter and gives an LLM agent a complete picture
-* of where the file stands relative to all four metrics.
-*
-* Returns header rows + data rows + a trailing separator. The caller
-* is responsible for the surrounding caption and any truncation
-* footer.
-*
-* @internal
-*/
-const renderBelowTargetTable = (files, cwd) => {
-	if (files.length === 0) return [];
-	const rows = files.map((f) => ({
-		file: relativePath(f.file, cwd),
-		stmts: String(Math.round(f.summary.statements)),
-		branches: String(Math.round(f.summary.branches)),
-		funcs: String(Math.round(f.summary.functions)),
-		lines: String(Math.round(f.summary.lines)),
-		uncov: compressUncov(f.uncoveredLines)
-	}));
-	const widths = [
-		Math.max(TABLE_HEADERS.file.length, ...rows.map((r) => r.file.length)),
-		Math.max(TABLE_HEADERS.stmts.length, ...rows.map((r) => r.stmts.length)),
-		Math.max(TABLE_HEADERS.branches.length, ...rows.map((r) => r.branches.length)),
-		Math.max(TABLE_HEADERS.funcs.length, ...rows.map((r) => r.funcs.length)),
-		Math.max(TABLE_HEADERS.lines.length, ...rows.map((r) => r.lines.length)),
-		Math.max(TABLE_HEADERS.uncov.length, ...rows.map((r) => r.uncov.length))
-	];
-	const out = [];
-	out.push(sepRow(widths));
-	out.push([
-		cell(TABLE_HEADERS.file, widths[0], "left"),
-		cell(TABLE_HEADERS.stmts, widths[1], "right"),
-		cell(TABLE_HEADERS.branches, widths[2], "right"),
-		cell(TABLE_HEADERS.funcs, widths[3], "right"),
-		cell(TABLE_HEADERS.lines, widths[4], "right"),
-		cell(TABLE_HEADERS.uncov, widths[5], "left")
-	].join("|"));
-	out.push(sepRow(widths));
-	for (const r of rows) out.push([
-		cell(r.file, widths[0], "left"),
-		cell(r.stmts, widths[1], "right"),
-		cell(r.branches, widths[2], "right"),
-		cell(r.funcs, widths[3], "right"),
-		cell(r.lines, widths[4], "right"),
-		cell(r.uncov, widths[5], "left")
-	].join("|"));
-	out.push(sepRow(widths));
-	return out;
-};
-/**
-* Aggregated coverage state across reports.
-*
-* @internal
-*/
-const aggregateCoverage = (reports) => {
-	let hasCoverage = false;
-	let thresholdsGlobal;
-	let targetsGlobal;
-	let scoped = false;
-	let scopedFileCount = 0;
-	let totalFiles;
-	const belowTargetByFile = /* @__PURE__ */ new Map();
-	const belowThresholdByFile = /* @__PURE__ */ new Map();
-	for (const r of reports) {
-		const cov = r.coverage;
-		if (!cov) continue;
-		hasCoverage = true;
-		thresholdsGlobal ??= cov.thresholds.global;
-		targetsGlobal ??= cov.targets?.global;
-		if (cov.scoped) {
-			scoped = true;
-			scopedFileCount = Math.max(scopedFileCount, cov.scopedFiles?.length ?? 0);
-			if (cov.totalFiles !== void 0) totalFiles = cov.totalFiles;
-		}
-		if (cov.lowCoverage) {
-			for (const f of cov.lowCoverage) if (!belowThresholdByFile.has(f.file)) belowThresholdByFile.set(f.file, f);
-		}
-		if (cov.belowTarget) {
-			for (const f of cov.belowTarget) if (!belowTargetByFile.has(f.file)) belowTargetByFile.set(f.file, f);
-		}
-	}
-	const belowTargetFiles = [...belowTargetByFile.values()];
-	const belowThresholdCount = belowThresholdByFile.size;
-	return {
-		hasCoverage,
-		thresholdsMet: belowThresholdCount === 0,
-		belowThresholdCount,
-		belowTargetFiles,
-		scoped,
-		scopedFileCount,
-		...thresholdsGlobal !== void 0 ? { thresholdsGlobal } : {},
-		...targetsGlobal !== void 0 ? { targetsGlobal } : {},
-		...totalFiles !== void 0 ? { totalFiles } : {}
-	};
-};
-/**
-* Coverage section: one or two summary lines plus per-file rows.
-*
-* @internal
-*/
-const renderCoverageSection = (reports, options, ao) => {
-	const agg = aggregateCoverage(reports);
-	if (!agg.hasCoverage) return [];
-	const lines = [];
-	const thresholdSpec = agg.thresholdsGlobal ? formatTargetSpec(agg.thresholdsGlobal) : "";
-	const targetSpec = agg.targetsGlobal ? formatTargetSpec(agg.targetsGlobal) : "";
-	if (agg.scoped) lines.push(formatScopedCoverageNote(agg.scopedFileCount, agg.totalFiles));
-	else if (!agg.thresholdsMet) {
-		const cross = ansi("✗", "red", ao);
-		const fileWord = agg.belowThresholdCount === 1 ? "file" : "files";
-		lines.push(`Coverage: ${cross} ${agg.belowThresholdCount} ${fileWord} below minimum thresholds${thresholdSpec ? ` (${thresholdSpec})` : ""}`);
-	} else if (agg.belowTargetFiles.length > 0) {
-		const tick = ansi("✓", "green", ao);
-		const warn = ansi("⚠", "yellow", ao);
-		const fileWord = agg.belowTargetFiles.length === 1 ? "file" : "files";
-		lines.push(`Coverage: ${tick} minimum thresholds met${thresholdSpec ? ` (${thresholdSpec})` : ""}`);
-		lines.push(`Coverage: ${warn} ${agg.belowTargetFiles.length} ${fileWord} below aspirational targets${targetSpec ? ` (${targetSpec})` : ""}`);
-	} else {
-		const tick = ansi("✓", "green", ao);
-		if (agg.targetsGlobal) lines.push(`Coverage: ${tick} minimum thresholds + aspirational targets met${targetSpec ? ` (${targetSpec})` : ""}`);
-		else lines.push(`Coverage: ${tick} minimum thresholds met${thresholdSpec ? ` (${thresholdSpec})` : ""}`);
-	}
-	if (options.trendSummary) {
-		const { direction, runCount } = options.trendSummary;
-		lines.push(`Trend: ${direction} (${runCount} runs)`);
-	}
-	if (agg.belowTargetFiles.length > 0 && agg.targetsGlobal) {
-		lines.push("");
-		lines.push("Files below aspirational target:");
-		const limit = options.coverageConsoleLimit;
-		const shown = agg.belowTargetFiles.slice(0, limit);
-		lines.push(...renderBelowTargetTable(shown, options.cwd));
-		if (agg.belowTargetFiles.length > limit) lines.push(`… ${agg.belowTargetFiles.length - limit} more (use the test_coverage MCP tool for the full list)`);
-	}
-	return lines;
-};
-/**
-* Failures block: grouped by project, one entry per failed test with
-* inline error message and stack hint.
-*
-* @internal
-*/
-const renderFailuresSection = (reports, cwd, ao) => {
-	const lines = [];
-	const reportsWithFailures = reports.filter((r) => r.summary.failed > 0 || r.unhandledErrors.length > 0);
-	if (reportsWithFailures.length === 0) return lines;
-	lines.push("Failures:");
-	for (const report of reportsWithFailures) {
-		const projectName = report.project ?? "default";
-		lines.push(`  ${projectName}`);
-		for (const mod of report.failed) {
-			const file = relativePath(mod.file, cwd);
-			const failedTests = mod.tests.filter((t) => t.state === "failed");
-			for (const test of failedTests) lines.push(...renderFailedTest(file, test, ao));
-			if (mod.errors && mod.errors.length > 0) for (const err of mod.errors) {
-				lines.push(`    ${ansi("✗", "red", ao)} ${file} (module-level error)`);
-				lines.push(`        ${ansi(err.message, "red", ao)}`);
-			}
-		}
-		for (const err of report.unhandledErrors) {
-			lines.push(`    ${ansi("✗", "red", ao)} unhandled error`);
-			lines.push(`        ${ansi(err.message, "red", ao)}`);
-		}
-	}
-	return lines;
-};
-const renderFailedTest = (file, test, ao) => {
-	const cross = ansi("✗", "red", ao);
-	const cls = test.classification ? ansi(`  [${test.classification}]`, "dim", ao) : "";
-	const lines = [`    ${cross} ${file} > ${test.fullName}${cls}`];
-	if (test.errors && test.errors.length > 0) for (const err of test.errors) lines.push(`        ${ansi(err.message, "dim", ao)}`);
-	return lines;
-};
-/**
-* Total line: aggregated pass/fail/skip counts + max-project duration.
-*
-* @internal
-*/
-const renderTotal = (reports, ao) => {
-	let passed = 0;
-	let failed = 0;
-	let skipped = 0;
-	let maxDuration = 0;
-	for (const r of reports) {
-		passed += r.summary.passed;
-		failed += r.summary.failed;
-		skipped += r.summary.skipped;
-		if (r.summary.duration > maxDuration) maxDuration = r.summary.duration;
-	}
-	const parts = [];
-	if (failed > 0) parts.push(ansi(`${failed} failed`, "red", ao));
-	parts.push(`${passed} passed`);
-	if (skipped > 0) parts.push(`${skipped} skipped`);
-	return `Total: ${parts.join(", ")} (${formatDuration(maxDuration)})`;
-};
-/**
-* Re-run hints when failures exist.
-*
-* @internal
-*/
-const renderNextSteps = (reports, options) => {
-	const lines = [];
-	const allFailedFiles = /* @__PURE__ */ new Set();
-	for (const r of reports) for (const f of r.failedFiles) allFailedFiles.add(relativePath(f, options.cwd));
-	if (allFailedFiles.size === 0) return lines;
-	lines.push("Next steps:");
-	for (const file of allFailedFiles) lines.push(`  Re-run: pnpm vitest run ${file}`);
-	if (options.mcp) {
-		lines.push("  Use the test_history MCP tool to check failure trends");
-		lines.push("  Use the test_errors MCP tool to search errors by type");
-	}
-	return lines;
-};
-/**
-* Header line for multi-project runs.
-*
-* @internal
-*/
-const renderHeader = (reports) => {
-	const lines = [];
-	if (showProjectLabel(reports) && reports.length > 1) lines.push(`Projects (${reports.length}):`);
-	else if (showProjectLabel(reports) && reports.length === 1) lines.push(`Project: ${reports[0]?.project ?? "default"}`);
-	return lines;
-};
-/**
-* Public entry point: render a collection of `AgentReport` rows as
-* a single plain-text block for stdout.
-*
-* @public
-*/
-const formatTerminal = (reports, options) => {
-	if (reports.length === 0) return "";
-	const ao = { noColor: options.noColor };
-	const out = [];
-	const header = renderHeader(reports);
-	if (header.length > 0) out.push(...header);
-	if (reports.length > 1) {
-		const widths = reports.map((r) => (r.project ?? "default").length);
-		const nameWidth = Math.max(0, ...widths);
-		for (const r of reports) {
-			out.push(renderProjectRow(r, ao, nameWidth));
-			if (r.summary.failed > 0 && r.tagCounts) out.push(...renderTagFailureBreakdown(r.tagCounts));
-		}
-		out.push("");
-	} else if (showProjectLabel(reports)) {
-		const r = reports[0];
-		if (r) {
-			const tick = r.summary.failed === 0 ? ansi("✓", "green", ao) : ansi("✗", "red", ao);
-			const counts = [];
-			if (r.summary.failed > 0) counts.push(`${r.summary.failed} failed`);
-			counts.push(`${r.summary.passed} passed`);
-			if (r.summary.skipped > 0) counts.push(`${r.summary.skipped} skipped`);
-			const baseRow = `${tick} ${counts.join(", ")} (${formatDuration(r.summary.duration)})`;
-			const tagSummary = buildTagSummary(r.tagCounts);
-			out.push(`${baseRow}${tagSummary}`);
-			if (r.summary.failed > 0 && r.tagCounts) out.push(...renderTagFailureBreakdown(r.tagCounts));
-			out.push("");
-		}
-	} else if (reports.length === 1) {
-		const r = reports[0];
-		if (r) {
-			const tick = r.summary.failed === 0 ? ansi("✓", "green", ao) : ansi("✗", "red", ao);
-			const counts = [];
-			if (r.summary.failed > 0) counts.push(`${r.summary.failed} failed`);
-			counts.push(`${r.summary.passed} passed`);
-			if (r.summary.skipped > 0) counts.push(`${r.summary.skipped} skipped`);
-			out.push(`${tick} ${counts.join(", ")} (${formatDuration(r.summary.duration)})`);
-			out.push("");
-		}
-	}
-	const failures = renderFailuresSection(reports, options.cwd, ao);
-	if (failures.length > 0) {
-		out.push(...failures);
-		out.push("");
-	}
-	const coverage = renderCoverageSection(reports, options, ao);
-	if (coverage.length > 0) {
-		out.push(...coverage);
-		out.push("");
-	}
-	out.push(renderTotal(reports, ao));
-	const nextSteps = renderNextSteps(reports, options);
-	if (nextSteps.length > 0) {
-		out.push("");
-		out.push(...nextSteps);
-	}
-	return out.join("\n");
-};
-
-//#endregion
-export { formatTerminal };