@vitest-agent/mcp 1.0.1 → 1.1.0

package/index.js

@@ -7,13 +7,11 @@ import { startMcpServer } from "./server.js";
 /**
 * The version of this package, inlined at build time from
 * package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
-* Compared against CURRENT_SDK_VERSION at MCP bin init to surface
-* partially-upgraded installs as a single stderr warning. See the root
-* CLAUDE.md "Cross-package version drift" section.
+* Exported for version introspection by downstream tooling.
 *
 * @public
 */
-const CURRENT_MCP_VERSION = "1.0.1";
+const CURRENT_MCP_VERSION = "1.1.0";
 
 //#endregion
 export { CURRENT_MCP_VERSION, McpLive, appRouter, createCallerFactory, createCurrentSessionIdRef, createSessionContextRef, startMcpServer };

package/middleware/idempotency.js

@@ -125,4 +125,4 @@ const idempotent = middleware(async (opts) => {
 const idempotentProcedure = publicProcedure.use(idempotent);
 
 //#endregion
-export { idempotentProcedure };
+export { idempotencyKeys, idempotentProcedure };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/mcp",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"private": false,
 	"description": "Model Context Protocol server for vitest-agent. Exposes 53 tools for agent access to test data, TDD lifecycle, and session management.",
 	"keywords": [
@@ -45,7 +45,7 @@
 		"@effect/sql-sqlite-node": "^0.52.0",
 		"@modelcontextprotocol/sdk": "^1.29.0",
 		"@trpc/server": "^11.18.0",
-		"@vitest-agent/sdk": "1.0.1",
+		"@vitest-agent/sdk": "1.1.0",
 		"effect": "^3.21.4",
 		"zod": "^4.4.3"
 	},

package/{public/patterns → patterns}/_meta.json

@@ -57,7 +57,7 @@
 		{
 			"slug": "operating-vitest-agent-as-an-agent",
 			"title": "Operating vitest-agent as an Agent",
-			"summary": "Read first: the front-loaded facts an agent needs (no run_tests filter param, coverage-in-subset behavior, console output is config-driven not env-driven, attribution is auto-recovered) with links to the deeper patterns.",
+			"summary": "Read first: the front-loaded facts an agent needs (no run_tests filter param, coverage-in-subset behavior, consoleLeaks signal in run_tests output, VITEST_AGENT_CONSOLE CLI escape hatch, attribution is auto-recovered) with links to the deeper patterns.",
 			"annotations": {
 				"audience": ["assistant"],
 				"priority": 0.95

package/{public/patterns → patterns}/operating-vitest-agent-as-an-agent.md

@@ -19,11 +19,14 @@ trial-and-error, then points you at the deeper patterns.
    — global thresholds applied to partial coverage. There is no per-run
    coverage toggle in `run_tests`; it inherits your `vitest.config`. For
    isolated inspection use the CLI: `vitest run <file> --coverage.enabled=false`.
-4. **You cannot see stray `console.log` through `run_tests`** — it null-routes
-   Vitest's stdout. Console behavior is configured via the plugin's `console`
-   matrix (e.g. `console: { agent: "passthrough" }`), **not** environment
-   variables. To see intercepted output, run Vitest directly with
-   `--disableConsoleIntercept` (a native Vitest flag).
+4. **Stray `console.*` is surfaced by `run_tests` as a signal, not raw logs.**
+   The `ok` result's `report.consoleLeaks` field lists writes by file with
+   counts, optional per-test attribution, and a truncated sample. `run_tests`
+   still null-routes Vitest's stdout; the signal captures what was printed
+   without forwarding raw log lines into agent context. To see the raw output
+   for a flagged file, run Vitest on the CLI:
+   `VITEST_AGENT_CONSOLE=passthrough pnpm test`. Details at
+   `vitest-agent://patterns/running-tests-via-mcp`.
 5. **Session attribution is recovered for you.** The SessionStart hook writes
    the `VITEST_AGENT_*` identity into the environment and the SDK recovers it —
    you never set those vars by hand. The only behavioral knobs are
@@ -38,9 +41,15 @@ trial-and-error, then points you at the deeper patterns.
 You do not configure vitest-agent through environment variables. The
 `VITEST_AGENT_*` vars (chat id, conversation id, agent ids, project dir,
 sidecar bin) are attribution plumbing written by the Claude Code plugin's
-SessionStart hook and recovered automatically. The only vars you might set for
-diagnostics are `VITEST_REPORTER_LOG_LEVEL` / `VITEST_REPORTER_LOG_FILE` (a
-diagnostic log file, separate from the console reporter) and `NO_COLOR`.
+SessionStart hook and recovered automatically. The vars you might set:
+
+- `VITEST_REPORTER_LOG_LEVEL` / `VITEST_REPORTER_LOG_FILE` — diagnostic
+  logger (separate from the console reporter).
+- `NO_COLOR` — disables ANSI color in rendered output.
+- `VITEST_AGENT_CONSOLE=passthrough` — overrides the resolved console mode
+  for the active executor on a CLI `vitest` run. Useful when investigating
+  files flagged by `report.consoleLeaks`. Invalid-for-slot values warn to
+  stderr and are ignored.
 
 ## Where to go next
 

package/{public/patterns → patterns}/running-tests-via-mcp.md

@@ -51,6 +51,51 @@ This is expected: your global coverage thresholds are applied to a partial run,
 vitest run path/to/one.test.ts --coverage.enabled=false
 ```
 
+## Stray console output — `report.consoleLeaks`
+
+When the run produces stray `console.*` output, the `report` object on an
+`"ok"` result carries an optional `consoleLeaks` field. It is omitted
+entirely when the run produced no user console output.
+
+Shape:
+
+- `total` — total stray console writes across the run
+- `byFile` — one entry per file that produced writes:
+  - `file` — the test file path
+  - `stdout` — writes to stdout-class streams (`log`, `info`, `debug`)
+  - `stderr` — writes to stderr-class streams (`error`, `warn`)
+  - `tests` (optional) — test names where writes were attributed
+  - `sample` (optional) — truncated excerpt of the first write in this file
+- `truncated` (optional) — `true` when `byFile` was capped
+
+Use `byFile[].file` to locate which files to investigate and `sample` to
+find the call site, without dumping full log content into agent context.
+The markdown summary line also surfaces the leak count inline (e.g.
+`⚠ 3 stray console writes across 2 files (see consoleLeaks)`).
+
+### Console-output visibility by surface
+
+| Surface | Sees stray `console.*` | Per-test attribution |
+| --- | --- | --- |
+| `run_tests` (MCP) | yes — `consoleLeaks` signal (counts + sample) | per file, per test where resolvable |
+| Human at a TTY | yes — Vitest's own `stdout \|` / `stderr \|` lines | yes (TTY only) |
+| Piped shell (default) | no — agent-shaped summary suppresses it | n/a |
+| Piped shell + `VITEST_AGENT_CONSOLE=passthrough` | yes — raw passthrough | no (raw, unlabeled) |
+
+### `VITEST_AGENT_CONSOLE` — CLI escape hatch
+
+To see raw console output for a file that `consoleLeaks` flagged, run
+Vitest directly on the CLI with the override set:
+
+```bash
+VITEST_AGENT_CONSOLE=passthrough pnpm test
+```
+
+This overrides the plugin's resolved console mode to `passthrough` for
+the active executor — Vitest's own reporters emit console output
+unfiltered. An invalid value for the current executor slot warns to
+stderr and is ignored.
+
 ## See also
 
 - `vitest-agent://patterns/operating-vitest-agent-as-an-agent` — the orientation index

package/resources/index.js

@@ -163,4 +163,4 @@ function registerAllResources(server) {
 }
 
 //#endregion
-export { registerAllResources };
+export { registerAllResources, resolveContentRoots };

package/resources/manifest-schema.js

@@ -43,4 +43,4 @@ const PatternsManifest = Schema.Struct({ patterns: Schema.Array(PatternEntry) })
 const decodePatternsManifest = Schema.decodeUnknown(PatternsManifest);
 
 //#endregion
-export { decodePatternsManifest, decodeUpstreamManifest };
+export { ManifestPage, PatternEntry, PatternsManifest, ResourceAnnotations, UpstreamManifest, decodePatternsManifest, decodeUpstreamManifest };

package/tools/acceptance-metrics.js

@@ -72,4 +72,4 @@ const acceptanceMetrics = publicProcedure.input(Schema.standardSchemaV1(Schema.S
 })));
 
 //#endregion
-export { AcceptanceMetricsAsMarkdown, AcceptanceMetricsResult, acceptanceMetrics };
+export { AcceptanceMetricsAsMarkdown, AcceptanceMetricsResult, acceptanceMetrics, formatAcceptanceMetricsMarkdown };

package/tools/cache-health.js

@@ -80,4 +80,4 @@ const cacheHealth = publicProcedure.query(async ({ ctx }) => ctx.runtime.runProm
 })));
 
 //#endregion
-export { CacheHealthAsMarkdown, CacheHealthResult, cacheHealth };
+export { CacheHealthAsMarkdown, CacheHealthResult, cacheHealth, formatCacheHealthMarkdown };

package/tools/commit-changes.js

@@ -61,4 +61,4 @@ const commitChanges = publicProcedure.input(Schema.standardSchemaV1(Schema.Struc
 })));
 
 //#endregion
-export { CommitChangesAsMarkdown, CommitChangesResult, commitChanges };
+export { CommitChangesAsMarkdown, CommitChangesResult, commitChanges, formatCommitChangesMarkdown };

package/tools/configure.js

@@ -104,4 +104,4 @@ const configure = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 })));
 
 //#endregion
-export { ConfigureAsMarkdown, ConfigureResult, configure };
+export { ConfigureAsMarkdown, ConfigureResult, configure, formatConfigureMarkdown };

package/tools/coverage.js

@@ -73,4 +73,4 @@ const testCoverage = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct
 })));
 
 //#endregion
-export { TestCoverageAsMarkdown, TestCoverageResult, testCoverage };
+export { TestCoverageAsMarkdown, TestCoverageResult, formatTestCoverageMarkdown, testCoverage };

package/tools/errors.js

@@ -148,4 +148,4 @@ const testErrors = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 })));
 
 //#endregion
-export { TestErrorsAsMarkdown, TestErrorsResult, testErrors };
+export { TestErrorRow, TestErrorsAsMarkdown, TestErrorsResult, formatTestErrorsMarkdown, testErrors };

package/tools/failure-signature-get.js

@@ -70,4 +70,4 @@ const failureSignatureGet = publicProcedure.input(Schema.standardSchemaV1(Schema
 })));
 
 //#endregion
-export { FailureSignatureGetAsMarkdown, FailureSignatureGetResult, failureSignatureGet };
+export { FailureSignatureGetAsMarkdown, FailureSignatureGetResult, failureSignatureGet, formatFailureSignatureMarkdown };

package/tools/file-coverage.js

@@ -103,4 +103,4 @@ const fileCoverage = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct
 })));
 
 //#endregion
-export { FileCoverageAsMarkdown, FileCoverageResult, fileCoverage };
+export { FileCoverageAsMarkdown, FileCoverageResult, fileCoverage, formatFileCoverageMarkdown };

package/tools/history.js

@@ -118,4 +118,4 @@ const testHistory = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct(
 })));
 
 //#endregion
-export { TestHistoryAsMarkdown, TestHistoryResult, testHistory };
+export { TestHistoryAsMarkdown, TestHistoryResult, formatTestHistoryMarkdown, testHistory };

package/tools/inventory.js

@@ -374,4 +374,4 @@ const inventory = publicProcedure.input(Schema.standardSchemaV1(InventoryInput))
 });
 
 //#endregion
-export { InventoryAsMarkdown, InventoryResult, inventory };
+export { InventoryAsMarkdown, InventoryResult, formatInventoryMarkdown, inventory };

package/tools/overview.js

@@ -89,4 +89,4 @@ const testOverview = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct
 })));
 
 //#endregion
-export { TestOverviewAsMarkdown, TestOverviewResult, testOverview };
+export { TestOverviewAsMarkdown, TestOverviewResult, formatTestOverviewMarkdown, testOverview };

package/tools/run-tests.js

@@ -1,5 +1,5 @@
 import { publicProcedure } from "../context.js";
-import { AgentReport, DataReader, DataStore, buildAgentReport } from "@vitest-agent/sdk";
+import { AgentReport, DataReader, DataStore, buildAgentReport, buildConsoleLeaks, collectConsoleLeakEntries } from "@vitest-agent/sdk";
 import { Effect, ParseResult, Schema } from "effect";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Writable } from "node:stream";
@@ -209,6 +209,13 @@ function formatReportMarkdown(report, classifications) {
 	if (summary.skipped > 0) headlineParts.push(`${summary.skipped} skipped`);
 	lines.push(`## ${status} Vitest -- ${headlineParts.join(", ")} (${summary.duration}ms)`);
 	if (report.project) lines.push(`\nProject: ${report.project}`);
+	if (report.consoleLeaks !== void 0) {
+		const cl = report.consoleLeaks;
+		const writes = `${cl.total} stray console write${cl.total === 1 ? "" : "s"}`;
+		const plural = cl.byFile.length !== 1 || cl.truncated === true;
+		const files = `${cl.byFile.length}${cl.truncated === true ? "+" : ""} file${plural ? "s" : ""}`;
+		lines.push(`\n⚠ ${writes} across ${files} (see consoleLeaks)`);
+	}
 	for (const mod of report.failed) {
 		lines.push(`\n### \u274C \`${mod.file}\``);
 		if (mod.errors) for (const err of mod.errors) {
@@ -313,7 +320,12 @@ const runTests = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 				resolvedExpression
 			}
 		};
-		const report = buildAgentReport(testModules, unhandledErrors, unhandledErrors.length > 0 || result.testModules.some((m) => m.state() === "failed") ? "failed" : "passed", { omitPassingTests: true });
+		const baseReport = buildAgentReport(testModules, unhandledErrors, unhandledErrors.length > 0 || result.testModules.some((m) => m.state() === "failed") ? "failed" : "passed", { omitPassingTests: true });
+		const leaks = buildConsoleLeaks(collectConsoleLeakEntries(localVitest.state.getFiles()));
+		const report = leaks !== void 0 ? {
+			...baseReport,
+			consoleLeaks: leaks
+		} : baseReport;
 		let classifications;
 		try {
 			classifications = await ctx.runtime.runPromise(Effect.gen(function* () {
@@ -356,4 +368,4 @@ const runTests = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 }));
 
 //#endregion
-export { RunTestsAsMarkdown, RunTestsResult, runTests };
+export { RunTestsAsMarkdown, RunTestsResult, coerceErrors, composeTagExpression, formatNoMatchMarkdown, formatReportMarkdown, formatRunTestsMarkdown, runTests, sanitizeTestArgs, withStdioCaptured };

package/tools/settings-list.js

@@ -45,4 +45,4 @@ const settingsList = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct
 })));
 
 //#endregion
-export { SettingsListAsMarkdown, SettingsListResult, settingsList };
+export { SettingsListAsMarkdown, SettingsListResult, formatSettingsListMarkdown, settingsList };

package/tools/status.js

@@ -71,4 +71,4 @@ const testStatus = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 })));
 
 //#endregion
-export { TestStatusAsMarkdown, TestStatusResult, testStatus };
+export { TestStatusAsMarkdown, TestStatusResult, formatTestStatusMarkdown, testStatus };

package/tools/tdd-artifact.js

@@ -98,4 +98,4 @@ const tddArtifactList = publicProcedure.input(Schema.standardSchemaV1(TddArtifac
 })));
 
 //#endregion
-export { TddArtifactListAsMarkdown, TddArtifactListResult, tddArtifactList };
+export { TddArtifactListAsMarkdown, TddArtifactListResult, formatTddArtifactListMarkdown, tddArtifactList };

package/tools/tdd-task.js

@@ -275,4 +275,4 @@ const tddTask = idempotentProcedure.input(Schema.standardSchemaV1(TddTaskInput))
 });
 
 //#endregion
-export { TddTaskAsMarkdown, TddTaskResult, tddTask };
+export { TddTaskAsMarkdown, TddTaskResult, formatTddTaskMarkdown, tddTask };

package/tools/test.js

@@ -278,4 +278,4 @@ const test = publicProcedure.input(Schema.standardSchemaV1(TestInput)).query(asy
 });
 
 //#endregion
-export { TestAsMarkdown, TestResult, test };
+export { TestAsMarkdown, TestResult, formatTestMarkdown, test };

package/tools/trends.js

@@ -109,4 +109,4 @@ const testTrends = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 })));
 
 //#endregion
-export { TestTrendsAsMarkdown, TestTrendsResult, testTrends };
+export { TestTrendsAsMarkdown, TestTrendsResult, formatTestTrendsMarkdown, testTrends };

package/tools/turn-search.js

@@ -57,4 +57,4 @@ const turnSearch = publicProcedure.input(Schema.standardSchemaV1(Schema.Struct({
 })));
 
 //#endregion
-export { TurnSearchAsMarkdown, TurnSearchResult, turnSearch };
+export { TurnSearchAsMarkdown, TurnSearchResult, formatTurnSearchMarkdown, turnSearch };