@vitest-agent/mcp 5.2.9 → 5.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/mcp",
-	"version": "5.2.9",
+	"version": "5.3.0",
 	"private": false,
 	"description": "Model Context Protocol server for vitest-agent. Exposes 30 tools for agent access to test data, TDD lifecycle, and session management.",
 	"keywords": [
@@ -49,8 +49,8 @@
 		"@effected/git": "^0.25.0",
 		"@effected/mcp": "^0.9.0",
 		"@effected/walker": "^0.19.0",
-		"@vitest-agent/engine": "1.1.2",
-		"@vitest-agent/sdk": "7.0.5",
+		"@vitest-agent/engine": "2.0.0",
+		"@vitest-agent/sdk": "8.0.0",
 		"effect": "^4.0.6"
 	},
 	"peerDependencies": {

package/tools/help.js

@@ -36,11 +36,11 @@ const HELP_TEXT = `# vitest-agent MCP Tools
 
 | Tool | Parameters | Description |
 | ---- | ---------- | ----------- |
-| \`test_status\` | \`project?\` | Per-project test pass/fail state |
+| \`test_status\` | \`project?\` | Per-project test pass/fail state; an entry carries \`strayOutput\` when the latest run wrote straight to the terminal |
 | \`test_overview\` | \`project?\` | Test landscape with run metrics |
 | \`test_coverage\` | \`project?\` | Coverage gaps with uncovered lines |
 | \`file_coverage\` | \`filePath\`, \`project?\` | Per-file coverage with uncovered lines and related tests |
-| \`test_history\` | \`project\` | Flaky/persistent/recovered tests |
+| \`test_history\` | \`project\`, \`testName?\`, \`modulePath?\`, \`limit?\` | Flaky/persistent/recovered tests, plus \`strayOutput\`: how many of the last 10 runs wrote straight to the terminal |
 | \`test_trends\` | \`project\`, \`limit?\` | Coverage trajectory over time |
 | \`test_errors\` | \`project\`, \`errorName?\` | Errors with diffs, stacks, each row's \`annotations[]\` (the test annotations the author recorded), and the cite-able \`testErrorId\` / \`topStackFrameId\` values needed by \`hypothesis (action: record)\` |
 | \`test\` | \`action\` (\`list\`/\`get\`/\`for_file\`/\`for_tag\`/\`annotations\`/\`artifacts\`), plus per-action params | Consolidated test inspection: list/get/for_file/for_tag/annotations/artifacts |
@@ -73,7 +73,7 @@ const HELP_TEXT = `# vitest-agent MCP Tools
 
 | Tool | Parameters | Description |
 | ---- | ---------- | ----------- |
-| \`run_tests\` | \`files?\`, \`project?\`, \`tags?\`, \`passWithNoTests?\`, \`timeout?\`, \`format?\` | Run vitest with optional filters. \`tags\` is a structured \`{ all?, any?, none? }\` filter that intersects with \`project\` and \`files\` via AND. When the resolved filter set matches zero test cases the result discriminator is \`no-match\` (carrying the resolved filter context) rather than \`ok\`. \`passWithNoTests\` is a per-call override of Vitest's project-level \`test.passWithNoTests\` policy |
+| \`run_tests\` | \`files?\`, \`project?\`, \`tags?\`, \`passWithNoTests?\`, \`timeout?\`, \`projectRoot?\` | Run vitest with optional filters. \`tags\` is a structured \`{ all?, any?, none? }\` filter that intersects with \`project\` and \`files\` via AND. When the resolved filter set matches zero test cases the result discriminator is \`no-match\` (carrying the resolved filter context) rather than \`ok\`. \`passWithNoTests\` is a per-call override of Vitest's project-level \`test.passWithNoTests\` policy. A \`kind: "error"\` result with \`reason: "stale-install"\` means the vitest install was replaced under this long-lived server; restart the MCP server (\`/mcp\`) instead of retrying |
 | \`register_agent\` | \`sessionId\`, \`agentType\`, \`hostKind?\`, \`parentAgentId?\`, \`clientNonce?\`, \`startGitBranch?\`, \`startGitCommitSha?\`, \`startWorktreeDir?\` | Idempotent agent invocation registration |
 
 ## Diagnostics
@@ -85,7 +85,7 @@ const HELP_TEXT = `# vitest-agent MCP Tools
 | \`failure_signature_get\` | \`hash\` | Stable failure signature with recent example errors |
 | \`turn_search\` | \`sessionId?\`, \`since?\`, \`type?\`, \`limit?\` | Search turns (default limit 100) |
 | \`acceptance_metrics\` | _(none)_ | Four spec Annex A acceptance metrics |
-| \`triage_brief\` | \`project?\`, \`maxLines?\` | Orientation triage |
+| \`triage_brief\` | \`project?\`, \`maxLines?\` | Orientation triage (recent runs, stray output, sessions, metrics) |
 | \`wrapup_prompt\` | \`sessionId?\`, \`chatId?\`, \`kind?\`, \`userPromptHint?\` | Tailored wrap-up prompt |
 | \`commit_changes\` | \`sha?\` | Commit metadata + changed files |
 

package/tools/history.js

@@ -1,7 +1,7 @@
 import { Effect, Schema } from "effect";
 import { DataReader } from "@vitest-agent/engine";
 import { Tool } from "effect/ai";
-import { HistoryRecord } from "@vitest-agent/sdk";
+import { HistoryRecord, StrayOutput } from "@vitest-agent/sdk";
 
 // src/tools/history.ts
 const FlakyTestRow = Schema.Struct({
@@ -36,6 +36,14 @@ const RecoveredTestRow = Schema.Struct({
 	identifier: "RecoveredTestRow",
 	description: "A test whose latest run passed after the previous one failed."
 });
+const StrayOutputHistoryRow = Schema.Struct({
+	runs: Schema.Finite.annotate({ description: "Recent runs considered (the newest ones, up to 10)." }),
+	runsWithStrayOutput: Schema.Finite.annotate({ description: "How many of those runs wrote to the terminal past Vitest's console capture." }),
+	latest: Schema.NullOr(StrayOutput).annotate({ description: "The most recent run's stray output (line counts, bytes, first samples); `null` when it recorded none." })
+}).annotate({
+	identifier: "StrayOutputHistoryRow",
+	description: "How often recent runs of the project wrote straight to the terminal (a test or a child process with inherited stdio). A run-level signal: nothing attributes it to one test."
+});
 /**
 * The `test_history` tool's success payload.
 *
@@ -47,7 +55,8 @@ const TestHistoryResult = Schema.Struct({
 	history: HistoryRecord.annotate({ description: "Raw per-test history record (stored in `test_runs` joins)." }),
 	flaky: Schema.Array(FlakyTestRow).annotate({ description: "Tests with mixed pass/fail outcomes recently." }),
 	persistent: Schema.Array(PersistentFailureRow).annotate({ description: "Tests failing across consecutive runs." }),
-	recovered: Schema.Array(RecoveredTestRow).annotate({ description: "Tests that just transitioned from failing to passing in the last run." })
+	recovered: Schema.Array(RecoveredTestRow).annotate({ description: "Tests that just transitioned from failing to passing in the last run." }),
+	strayOutput: StrayOutputHistoryRow
 }).annotate({
 	identifier: "TestHistoryResult",
 	title: "test_history result",
@@ -79,10 +88,11 @@ const handleTestHistory = (input) => Effect.gen(function* () {
 		...scopeOptions,
 		...input.limit !== void 0 && { limit: input.limit }
 	};
-	const [history, flaky, persistent] = yield* Effect.all([
+	const [history, flaky, persistent, strayOutput] = yield* Effect.all([
 		reader.getHistory(input.project, historyOptions),
 		reader.getFlaky(input.project, scopeOptions),
-		reader.getPersistentFailures(input.project, scopeOptions)
+		reader.getPersistentFailures(input.project, scopeOptions),
+		reader.getStrayOutputHistory({ project: input.project })
 	], { concurrency: "unbounded" });
 	const recovered = history.tests.filter((t) => {
 		const runs = t.runs;
@@ -102,7 +112,8 @@ const handleTestHistory = (input) => Effect.gen(function* () {
 		history,
 		flaky,
 		persistent,
-		recovered
+		recovered,
+		strayOutput
 	};
 }).pipe(Effect.orDie);
 /**
@@ -111,7 +122,7 @@ const handleTestHistory = (input) => Effect.gen(function* () {
 * @public
 */
 const testHistoryTool = Tool.make("test_history", {
-	description: "Use when failures recur and you need flaky, persistent, and recovered test classifications. Returns a typed JSON object in structuredContent (project, hasData, history, flaky[], persistent[], recovered[]). Optional testName/modulePath narrow to a single test; limit caps runs kept per test (default 20) — omit all three only when you actually need the whole project's history.",
+	description: "Use when failures recur and you need flaky, persistent, and recovered test classifications. Returns a typed JSON object in structuredContent (project, hasData, history, flaky[], persistent[], recovered[], strayOutput: how many of the last 10 runs wrote straight to the terminal). Optional testName/modulePath narrow to a single test; limit caps runs kept per test (default 20) — omit all three only when you actually need the whole project's history.",
 	parameters: TestHistoryInput,
 	success: TestHistoryResult,
 	dependencies: [DataReader]

package/tools/run-tests.js

@@ -4,7 +4,7 @@ import { ToolOutputSchema } from "@effected/mcp";
 import { Data, Effect, Layer, Option, Path, Result, Schema, Semaphore } from "effect";
 import { DataReader, DataStore } from "@vitest-agent/engine";
 import { Tool } from "effect/ai";
-import { AgentReport, buildAgentReport, buildConsoleLeaks, coerceErrorField, collectConsoleLeakEntries, formatScopedCoverageNote, readStrayOutput } from "@vitest-agent/sdk";
+import { AgentReport, SuggestedActionRecord, buildAgentReport, buildConsoleLeaks, coerceErrorField, collectConsoleLeakEntries, formatScopedCoverageNote, readStrayOutput } from "@vitest-agent/sdk";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { existsSync, mkdtempSync, rmSync } from "node:fs";
 import { stat } from "node:fs/promises";
@@ -43,15 +43,26 @@ const RunTestsOk = Schema.Struct({
 	report: AgentReport.annotate({ description: "Full AgentReport including pass/fail counts and per-module errors." }),
 	classifications: Schema.Record(Schema.String, Schema.String).annotate({ description: "Per-test classification labels: stable, new-failure, persistent, flaky, recovered." }),
 	discoveryLastScannedAt: Schema.optional(Schema.NullOr(Schema.String)).annotate({ description: "ISO timestamp of the most recent real disk scan performed by discoverProjects() in this process (issue #100). `null`/absent means discovery has not scanned disk in this process yet (e.g. a config that doesn't call AgentPlugin.discover()). A stale-looking test count is self-explaining when compared against this value." }),
-	scopedNote: Schema.optional(Schema.NullOr(Schema.String)).annotate({ description: "Set (issue #160) when this call was scoped to a subset of the project's test files (files/project/tags filter supplied). Vitest enforces coverage.thresholds against the whole-project denominator regardless of how many files ran, so a scoped run's threshold check is unreliable; this note explains why no coverage verdict should be trusted for this call. `null`/absent means the run was unscoped." })
+	scopedNote: Schema.optional(Schema.NullOr(Schema.String)).annotate({ description: "Set (issue #160) when this call was scoped to a subset of the project's test files (files/project/tags filter supplied). Vitest enforces coverage.thresholds against the whole-project denominator regardless of how many files ran, so a scoped run's threshold check is unreliable; this note explains why no coverage verdict should be trusted for this call. `null`/absent means the run was unscoped." }),
+	suggestedActions: Schema.optionalKey(Schema.Array(SuggestedActionRecord)).annotate({ description: "Run-level suggested actions the plugin raised at config time (issue #544): one entry per coverage-config diagnostic the plugin's ConfigValidation reported, such as a coverageTargets metric with no matching coverage.thresholds floor (severity warn). The same entries print on the plugin's stderr for a human and in the rendered report's Actions trailer. Absent when the project's config validated clean or does not load the plugin." })
 }).annotate({ identifier: "RunTestsOk" });
 const RunTestsTimeout = Schema.Struct({
 	kind: Schema.Literal("timeout"),
 	timeoutSeconds: Schema.Number
 }).annotate({ identifier: "RunTestsTimeout" });
+/**
+* The machine-readable reasons a `run_tests` error result may carry. Only
+* failures an agent must act on in a specific way get one; the rest stay
+* message-only. `stale-install` (issue #461): the `vitest/node` entry this
+* long-lived server resolved for the project no longer exists on disk
+* because the dependency tree was reinstalled under it — the remedy is to
+* restart the MCP server (`/mcp` in Claude Code), not to retry the call.
+*/
+const RUN_TESTS_ERROR_REASONS = ["stale-install"];
 const RunTestsError = Schema.Struct({
 	kind: Schema.Literal("error"),
-	message: Schema.String
+	message: Schema.String,
+	reason: Schema.optionalKey(Schema.Literals(RUN_TESTS_ERROR_REASONS)).annotate({ description: "Set when the failure has a specific remedy. `stale-install`: the vitest/node entry this server resolved for the project vanished from disk (the dependency tree was reinstalled under the long-lived server); `message` names the missing path. Restart the MCP server (/mcp in Claude Code) — retrying the call cannot fix it. Absent for a message-only error." })
 }).annotate({ identifier: "RunTestsError" });
 const RunTestsNoMatch = Schema.Struct({
 	kind: Schema.Literal("no-match").annotate({ description: "Discriminant — the resolved filter set matched zero test cases. Tests did not run; this is independent of passWithNoTests policy." }),
@@ -115,6 +126,22 @@ function readDiscoveryLastScannedAt() {
 	const value = globalThis[DISCOVERY_LAST_SCAN_SYMBOL];
 	return typeof value === "string" ? value : void 0;
 }
+const CONFIG_SUGGESTED_ACTIONS_SYMBOL = Symbol.for("vitest-agent:config-suggested-actions");
+/**
+* Reads the config-derived suggested actions the plugin published on a
+* Vitest instance. `undefined` when none were published (the project does
+* not load the plugin, or its config validated clean). Each entry is
+* decoded against `SuggestedActionRecord` so a foreign shape can never
+* reach the wire.
+*
+* @internal
+*/
+function readConfigSuggestedActions(vitest) {
+	const value = vitest[CONFIG_SUGGESTED_ACTIONS_SYMBOL];
+	if (!Array.isArray(value) || value.length === 0) return void 0;
+	const decoded = Schema.decodeUnknownResult(Schema.Array(SuggestedActionRecord))(value);
+	return Result.isSuccess(decoded) ? decoded.success : void 0;
+}
 /**
 * Per-invocation coverage temp directory. Vitest's v8 provider `rm -rf`s the
 * shared `coverage/` reports directory at run start (`clean: true` default),
@@ -333,6 +360,12 @@ async function validateProjectRoot(projectRoot, ctxCwd) {
 * resolution throws (e.g. a project root with no local vitest install) so
 * that case keeps working exactly as it did before this fix.
 *
+* The property this buys — one module instance shared by the server and the
+* project's test files — is pinned by `vitest-node-module-identity.test.ts`
+* (issue #387), which asserts realpath AND `Object.is` identity against the
+* live repo layout, so a pnpm layout change that reintroduces two copies
+* fails there rather than as a snapshot failure in a consumer's run.
+*
 * @internal exported for tests
 */
 function resolveVitestNodeEntry(root) {
@@ -498,7 +531,8 @@ function toOkPayload(args) {
 		report: args.report,
 		classifications: args.classifications ? Object.fromEntries(args.classifications) : {},
 		discoveryLastScannedAt: args.discoveryLastScannedAt ?? null,
-		scopedNote: args.scopedNote
+		scopedNote: args.scopedNote,
+		...args.suggestedActions !== void 0 && args.suggestedActions.length > 0 ? { suggestedActions: args.suggestedActions } : {}
 	};
 }
 /**
@@ -544,6 +578,7 @@ const runTestsBody = async (input, ctx) => {
 	const staleMessage = staleInstallMessage(vitestEntry);
 	if (staleMessage !== null) return {
 		kind: "error",
+		reason: "stale-install",
 		message: staleMessage
 	};
 	const timeoutMs = (input.timeout ?? 120) * 1e3;
@@ -604,6 +639,7 @@ const runTestsBody = async (input, ctx) => {
 		const baseReport = buildAgentReport(testModules, unhandledErrors, preliminaryReason, { omitPassingTests: true });
 		const leaks = buildConsoleLeaks(collectConsoleLeakEntries(localVitest.state.getFiles()));
 		const strayOutput = readStrayOutput(localVitest.logger);
+		const configSuggestedActions = readConfigSuggestedActions(localVitest);
 		const report = {
 			...baseReport,
 			...leaks !== void 0 && { consoleLeaks: leaks },
@@ -644,7 +680,8 @@ const runTestsBody = async (input, ctx) => {
 			report,
 			classifications,
 			discoveryLastScannedAt: readDiscoveryLastScannedAt(),
-			scopedNote
+			scopedNote,
+			...configSuggestedActions !== void 0 && { suggestedActions: configSuggestedActions }
 		});
 	} catch (err) {
 		let message;
@@ -702,7 +739,7 @@ const handleRunTests = (input) => Effect.gen(function* () {
 * @public
 */
 const runTestsTool = Tool.make("run_tests", {
-	description: "Use to run Vitest tests, with optional file, project, and tag filters. structuredContent carries the typed AgentReport plus per-test classifications (discriminate on `kind`: ok, timeout, error, no-match). Unknown parameters are rejected — accepted keys are files, project, tags, passWithNoTests, timeout, projectRoot. When projectRoot is omitted, the server anchors the Vitest root at the directory of the vitest (or vite) config Vitest would load anyway, walking up from its boot dir and stopping at the git root — so a server booted inside a package subtree still resolves the root config's relative globalSetup/setupFiles correctly. projectRoot overrides that for this call and is used verbatim, but only after validation: it must be an existing directory belonging to the same git repository as ctx.cwd (checked via `git rev-parse --path-format=absolute --git-common-dir`, which needs git 2.31 or newer and is identical across a repo and all its worktrees, including a sibling worktree checked out from the same repo). A path in a different repository, or a non-existent path, is rejected with `{ kind: \"error\" }` naming both paths — never a silent fallback to ctx.cwd. The resolved root actually used is always echoed back on success. The legacy format=json arg is dropped — structuredContent supersedes it.",
+	description: "Use to run Vitest tests, with optional file, project, and tag filters. structuredContent carries the typed AgentReport plus per-test classifications (discriminate on `kind`: ok, timeout, error, no-match). Unknown parameters are rejected — accepted keys are files, project, tags, passWithNoTests, timeout, projectRoot. When projectRoot is omitted, the server anchors the Vitest root at the directory of the vitest (or vite) config Vitest would load anyway, walking up from its boot dir and stopping at the git root — so a server booted inside a package subtree still resolves the root config's relative globalSetup/setupFiles correctly. projectRoot overrides that for this call and is used verbatim, but only after validation: it must be an existing directory belonging to the same git repository as ctx.cwd (checked via `git rev-parse --path-format=absolute --git-common-dir`, which needs git 2.31 or newer and is identical across a repo and all its worktrees, including a sibling worktree checked out from the same repo). A path in a different repository, or a non-existent path, is rejected with `{ kind: \"error\" }` naming both paths — never a silent fallback to ctx.cwd. The resolved root actually used is always echoed back on success. An error result with `reason: \"stale-install\"` means the vitest install was replaced under this long-lived server (the lockfile was regenerated) and the resolved vitest/node entry is gone; restart the MCP server (/mcp in Claude Code) rather than retrying. The legacy format=json arg is dropped — structuredContent supersedes it.",
 	parameters: RunTestsInput,
 	success: RunTestsResult,
 	dependencies: [
@@ -712,4 +749,4 @@ const runTestsTool = Tool.make("run_tests", {
 	]
 }).annotate(Tool.Title, "Run tests").annotate(Tool.Readonly, false).annotate(Tool.Destructive, false).annotate(Tool.OpenWorld, false).annotate(Tool.Idempotent, false);
 
-export { RunTestsInput, RunTestsResult, coerceErrors, composeTagExpression, deriveRunScope, handleRunTests, isNoMatch, makeBestEffortFork, makeCoverageDirOverride, readDiscoveryLastScannedAt, resolveAnchoredConfigFile, resolveConfigAnchoredRoot, resolveVitestNodeEntry, runTestsSemaphore, runTestsTool, sanitizeTestArgs, staleInstallMessage, toNoMatch, toOkPayload, validateProjectRoot, vitestLoader, withStdioCaptured };
+export { RUN_TESTS_ERROR_REASONS, RunTestsInput, RunTestsResult, coerceErrors, composeTagExpression, deriveRunScope, handleRunTests, isNoMatch, makeBestEffortFork, makeCoverageDirOverride, readConfigSuggestedActions, readDiscoveryLastScannedAt, resolveAnchoredConfigFile, resolveConfigAnchoredRoot, resolveVitestNodeEntry, runTestsSemaphore, runTestsTool, sanitizeTestArgs, staleInstallMessage, toNoMatch, toOkPayload, validateProjectRoot, vitestLoader, withStdioCaptured };

package/tools/status.js

@@ -2,14 +2,23 @@ import { ToolOutputSchema } from "@effected/mcp";
 import { Effect, Option, Schema } from "effect";
 import { DataReader } from "@vitest-agent/engine";
 import { Tool } from "effect/ai";
-import { CacheManifestEntry } from "@vitest-agent/sdk";
+import { CacheManifestEntry, StrayOutput } from "@vitest-agent/sdk";
 
 // src/tools/status.ts
+/**
+* A manifest entry plus the project's latest-run stray output (issue 578),
+* present only when that run recorded any. Derived from the sdk entry's
+* fields so the two cannot drift.
+*/
+const StatusEntry = Schema.Struct({
+	...CacheManifestEntry.fields,
+	strayOutput: Schema.optionalKey(StrayOutput).annotate({ description: "Output the latest run wrote straight to the terminal past Vitest's console capture (a test or a child process with inherited stdio). Absent when it recorded none." })
+}).annotate({ identifier: "TestStatusEntry" });
 const StatusAvailable = Schema.Struct({
 	dataAvailable: Schema.Literal(true).annotate({ description: "Discriminant — `true` when at least one project entry exists in the manifest." }),
 	manifestUpdatedAt: Schema.String,
 	projectFilter: Schema.optional(Schema.String).annotate({ description: "Echo of the optional `project` filter." }),
-	entries: Schema.Array(CacheManifestEntry).annotate({ description: "Per-project last-run summary rows. Filtered by `projectFilter` when set." })
+	entries: Schema.Array(StatusEntry).annotate({ description: "Per-project last-run summary rows. Filtered by `projectFilter` when set." })
 }).annotate({ identifier: "TestStatusAvailable" });
 const StatusAbsent = Schema.Struct({
 	dataAvailable: Schema.Literal(false).annotate({ description: "Discriminant — `false` when no manifest exists or the project filter matched nothing." }),
@@ -39,14 +48,22 @@ const TestStatusInput = Schema.Struct({ project: Schema.optionalKey(Schema.Strin
 * @public
 */
 const handleTestStatus = (input) => Effect.gen(function* () {
-	const manifestOpt = yield* (yield* DataReader).getManifest();
+	const reader = yield* DataReader;
+	const manifestOpt = yield* reader.getManifest();
 	if (Option.isNone(manifestOpt)) return {
 		dataAvailable: false,
 		reason: "no_manifest",
 		...input.project !== void 0 && { projectFilter: input.project }
 	};
 	const manifest = manifestOpt.value;
-	const entries = input.project === void 0 ? manifest.projects : manifest.projects.filter((e) => e.project === input.project);
+	const strayByProject = new Map((yield* reader.getRunsByProject()).map((summary) => [summary.project, summary.strayOutput]));
+	const entries = (input.project === void 0 ? manifest.projects : manifest.projects.filter((e) => e.project === input.project)).map((entry) => {
+		const strayOutput = strayByProject.get(entry.project) ?? null;
+		return strayOutput === null ? entry : {
+			...entry,
+			strayOutput
+		};
+	});
 	if (entries.length === 0) return {
 		dataAvailable: false,
 		reason: "project_filter_empty",
@@ -65,7 +82,7 @@ const handleTestStatus = (input) => Effect.gen(function* () {
 * @public
 */
 const testStatusTool = Tool.make("test_status", {
-	description: "Use when you need each project's current pass/fail state from the most recent run. Returns a typed JSON object in structuredContent ({ dataAvailable, manifestUpdatedAt, projectFilter?, entries[] } or absent variant).",
+	description: "Use when you need each project's current pass/fail state from the most recent run. Returns a typed JSON object in structuredContent ({ dataAvailable, manifestUpdatedAt, projectFilter?, entries[] } or absent variant); an entry carries strayOutput when the project's latest run wrote straight to the terminal.",
 	parameters: TestStatusInput,
 	success: TestStatusResult,
 	dependencies: [DataReader]

package/tools/triage-brief.js

@@ -49,7 +49,7 @@ const handleTriageBrief = (input) => Effect.gen(function* () {
 * @public
 */
 const triageBriefTool = Tool.make("triage_brief", {
-	description: "Use when you need to orient on the current test landscape: failing tests, flaky tests, open TDD sessions, and suggested next actions. Returns a typed envelope in structuredContent ({ hasContent, markdown }).",
+	description: "Use when you need to orient on the current test landscape: failing tests, flaky tests, runs that wrote stray output past Vitest's console capture, open TDD sessions, and suggested next actions. Returns a typed envelope in structuredContent ({ hasContent, markdown }).",
 	parameters: TriageBriefInput,
 	success: TriageBriefResult,
 	dependencies: [DataReader]

package/version.js

@@ -7,6 +7,6 @@
 *
 * @public
 */
-const CURRENT_MCP_VERSION = "5.2.9";
+const CURRENT_MCP_VERSION = "5.3.0";
 
 export { CURRENT_MCP_VERSION };