@vitest-agent/plugin 5.5.0 → 5.6.0

package/index.d.ts

@@ -1,6 +1,6 @@
 import "@effected/env";
 import { EnvironmentDetector, PlatformLiveError, PlatformOptions, PlatformServices, SettingsInput, StackFrameInput } from "@vitest-agent/engine";
-import { AgentPluginOptions, AgentReporterOptions, ConsoleMode, CoverageBaselines, CoverageInput, CoverageLevel, CoverageLevelName, CoverageLevelName as CoverageLevelName$1, CoverageReport, ResolvedReporterConfig, ResolvedThresholds, RunEvent, RunRetentionPolicy, Transport, VitestAgentReporterFactory, resolveCoverageInput, validateCoverageConfig } from "@vitest-agent/sdk";
+import { AgentPluginOptions, AgentReporterOptions, ConsoleMode, CoverageBaselines, CoverageInput, CoverageLevel, CoverageLevelName, CoverageLevelName as CoverageLevelName$1, CoverageReport, ResolvedReporterConfig, ResolvedThresholds, RunEvent, RunRetentionPolicy, SuggestedActionRecord, Transport, VitestAgentReporterFactory, resolveCoverageInput, validateCoverageConfig } from "@vitest-agent/sdk";
 import { Context, Effect, Layer, Option } from "effect";
 import { TestProjectInlineConfiguration, TestTagDefinition } from "vitest/config";
 import { ResolvedConfig, VitestPluginContext } from "vitest/node";
@@ -631,6 +631,17 @@ interface AgentReporterConstructorOptions extends AgentReporterOptions {
    * `run_tests` tool.
    */
   passWithNoTests?: boolean;
+  /**
+   * Run-level suggested actions the plugin resolved at config time — the
+   * `ConfigValidation` warnings and info entries, mapped onto
+   * `SuggestedActionRecord`s (issue #544). Forwarded verbatim onto
+   * `ReporterRenderInput.suggestedActions` for every render, so the
+   * `Actions:` trailer repeats them in watch mode. Absent when the config
+   * validated clean.
+   *
+   * @internal
+   */
+  suggestedActions?: ReadonlyArray<SuggestedActionRecord>;
   coverageThresholds?: ResolvedThresholds | Record<string, unknown>;
   coverageTargets?: ResolvedThresholds | Record<string, unknown>;
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/plugin",
-	"version": "5.5.0",
+	"version": "5.6.0",
 	"private": false,
 	"description": "Vitest plugin for the vitest-agent ecosystem: owns persistence, classification, baselines, trends, and dispatches rendering to a configurable reporter.",
 	"keywords": [
@@ -49,11 +49,11 @@
 		"@effected/glob": "^0.14.0",
 		"@effected/walker": "^0.19.0",
 		"@effected/workspaces": "^0.38.0",
-		"@vitest-agent/cli": "4.1.0",
-		"@vitest-agent/engine": "1.2.0",
-		"@vitest-agent/mcp": "5.2.10",
-		"@vitest-agent/reporter": "5.0.9",
-		"@vitest-agent/sdk": "7.1.0",
+		"@vitest-agent/cli": "4.1.1",
+		"@vitest-agent/engine": "2.0.0",
+		"@vitest-agent/mcp": "5.3.0",
+		"@vitest-agent/reporter": "6.0.0",
+		"@vitest-agent/sdk": "8.0.0",
 		"effect": "^4.0.6",
 		"magic-string": "^1.4.3"
 	},

package/plugin.js

@@ -6,6 +6,7 @@ import { assertFlatScope } from "./utils/report-writer.js";
 import { installStrayOutputCapture } from "./utils/stray-output-capture.js";
 import { AgentReporter } from "./reporter.js";
 import { buildModuleInfo } from "./utils/build-module-info.js";
+import { publishConfigSuggestedActions, suggestedActionsFromValidation } from "./utils/config-suggested-actions.js";
 import { DefaultDiscoverStrategy } from "./utils/discover-strategy.js";
 import { discoverProjects } from "./utils/discover-projects.js";
 import { ensureGithubActionsReporter } from "./utils/ensure-github-reporter.js";
@@ -216,11 +217,15 @@ function AgentPlugin(options = {}, _layer) {
 					ctx.defineCacheKeyGenerator(makeTagCacheKeyGenerator(classifyForCache));
 					log("registered fsModuleCache tag cache-key generator");
 				}
-				const { env, executor } = await Effect.runPromise(Effect.gen(function* () {
-					const env = yield* (yield* EnvironmentDetector).detect();
+				const { env, executor, inGithubActions } = await Effect.runPromise(Effect.gen(function* () {
+					const detector = yield* EnvironmentDetector;
+					const env = yield* detector.detect();
+					const executor = yield* (yield* ExecutorResolver).resolve(env);
+					const ci = yield* detector.ci;
 					return {
 						env,
-						executor: yield* (yield* ExecutorResolver).resolve(env)
+						executor,
+						inGithubActions: Option.contains(ci, "github-actions")
 					};
 				}).pipe(Effect.provide(Layer.merge(layer, ExecutorResolverLive))));
 				const reportOption = options.report;
@@ -254,17 +259,19 @@ function AgentPlugin(options = {}, _layer) {
 						stderr: process.stderr
 					});
 				}
-				if (env === "ci-github" && consoleMode !== "silent") {
+				const githubActions = inGithubActions && consoleMode !== "silent";
+				if (githubActions) {
 					log("normalizing the github-actions reporter entry");
 					const withGithubActions = ensureGithubActionsReporter(vitest.config.reporters);
 					vitest.config.reporters = withGithubActions;
 				}
-				const githubActions = env === "ci-github" && consoleMode !== "silent";
 				log("githubActions (auto):", githubActions);
 				const validation = await Effect.runPromise(Effect.provide(Effect.flatMap(ConfigValidation, (cv) => cv.validate({
 					vitestConfig: vitest.config,
 					pluginOptions: options
 				})), ConfigValidationLive));
+				const configSuggestedActions = suggestedActionsFromValidation(validation);
+				publishConfigSuggestedActions(vitest, configSuggestedActions);
 				for (const w of validation.warnings) reportOnce(`[vitest-agent:plugin] warning ${w.code}: ${w.message}` + (w.remediation ? `\n  ${w.remediation}` : "") + "\n");
 				for (const i of validation.info) reportOnce(`[vitest-agent:plugin] info ${i.code}: ${i.message}\n`);
 				if (validation.errors.length > 0) {
@@ -328,6 +335,7 @@ function AgentPlugin(options = {}, _layer) {
 					...reportScope !== void 0 && { reportScope },
 					transport,
 					...passWithNoTests !== void 0 ? { passWithNoTests } : {},
+					...configSuggestedActions.length > 0 ? { suggestedActions: configSuggestedActions } : {},
 					...options.reporter !== void 0 && { reporter: options.reporter },
 					...options.onRunEvent !== void 0 ? { onRunEvent: options.onRunEvent } : {}
 				});

package/reporter.js

@@ -495,7 +495,8 @@ var AgentReporter = class {
 			coverageMode: options.coverageMode ?? "full",
 			persist: options.persist ?? true,
 			transport: options.transport ?? { kind: "local" },
-			...options.passWithNoTests !== void 0 ? { passWithNoTests: options.passWithNoTests } : {}
+			...options.passWithNoTests !== void 0 ? { passWithNoTests: options.passWithNoTests } : {},
+			...options.suggestedActions !== void 0 && options.suggestedActions.length > 0 ? { suggestedActions: options.suggestedActions } : {}
 		};
 		this.options = resolvedTargets ? {
 			...base,
@@ -1343,7 +1344,8 @@ var AgentReporter = class {
 				const reporters = preBuiltReporters ?? normalizeReporters(opts.reporter(kit));
 				const renderInput = {
 					reports: withStrayOutput(reports, strayOutput),
-					classifications: /* @__PURE__ */ new Map()
+					classifications: /* @__PURE__ */ new Map(),
+					...opts.suggestedActions !== void 0 && { suggestedActions: opts.suggestedActions }
 				};
 				const allOutputs = reporters.flatMap((r) => r.render(renderInput, kit));
 				for (const output of allOutputs) routeRenderedOutput(output, {
@@ -1448,7 +1450,8 @@ var AgentReporter = class {
 						gitCommitSha: process.env.GITHUB_SHA ?? null,
 						hostSource: hostProbe.source,
 						hostValue: hostProbe.value,
-						hostMetadata: hostProbe.metadata
+						hostMetadata: hostProbe.metadata,
+						strayOutput: strayOutput ?? null
 					});
 					for (const mod of projectModules) {
 						const fileId = yield* store.ensureFile(mod.relativeModuleId);
@@ -1852,6 +1855,7 @@ var AgentReporter = class {
 			const renderInput = {
 				reports: withStrayOutput(reports, strayOutput),
 				classifications,
+				...opts.suggestedActions !== void 0 && { suggestedActions: opts.suggestedActions },
 				...trendSummary !== void 0 && { trendSummary }
 			};
 			const allOutputs = reporters.flatMap((r) => r.render(renderInput, kit));

package/utils/build-reporter-kit.js

@@ -1,38 +1,33 @@
-import { osc8 } from "@vitest-agent/sdk";
-
 // src/utils/build-reporter-kit.ts
 const buildReporterKit = (input) => {
 	const consoleOutput = input.consoleMode === "silent" ? "silent" : "failures";
 	const githubSummary = input.githubActions;
 	const githubSummaryFile = process.env.GITHUB_STEP_SUMMARY;
-	const config = {
-		executor: input.executor,
-		consoleMode: input.consoleMode,
-		mcp: input.mcp,
-		consoleOutput,
-		omitPassingTests: true,
-		coverageConsoleLimit: 10,
-		includeBareZero: false,
-		githubActions: input.githubActions,
-		githubSummary,
-		detail: input.detail,
-		noColor: input.noColor,
-		coverageMode: input.coverageMode,
-		persist: input.persist,
-		transport: input.transport,
-		...input.dbPath !== void 0 && { dbPath: input.dbPath },
-		...input.projectFilter !== void 0 && { projectFilter: input.projectFilter },
-		...githubSummaryFile !== void 0 && { githubSummaryFile },
-		...input.runCommand !== void 0 && { runCommand: input.runCommand },
-		...input.coverageThresholds !== void 0 && { coverageThresholds: input.coverageThresholds },
-		...input.coverageTargets !== void 0 && { coverageTargets: input.coverageTargets },
-		...input.passWithNoTests !== void 0 && { passWithNoTests: input.passWithNoTests }
-	};
-	const osc8Enabled = !input.noColor && (input.env === "terminal" || input.env === "agent-shell");
 	return {
-		config,
+		config: {
+			executor: input.executor,
+			consoleMode: input.consoleMode,
+			mcp: input.mcp,
+			consoleOutput,
+			omitPassingTests: true,
+			coverageConsoleLimit: 10,
+			includeBareZero: false,
+			githubActions: input.githubActions,
+			githubSummary,
+			detail: input.detail,
+			noColor: input.noColor,
+			coverageMode: input.coverageMode,
+			persist: input.persist,
+			transport: input.transport,
+			...input.dbPath !== void 0 && { dbPath: input.dbPath },
+			...input.projectFilter !== void 0 && { projectFilter: input.projectFilter },
+			...githubSummaryFile !== void 0 && { githubSummaryFile },
+			...input.runCommand !== void 0 && { runCommand: input.runCommand },
+			...input.coverageThresholds !== void 0 && { coverageThresholds: input.coverageThresholds },
+			...input.coverageTargets !== void 0 && { coverageTargets: input.coverageTargets },
+			...input.passWithNoTests !== void 0 && { passWithNoTests: input.passWithNoTests }
+		},
 		stdEnv: input.env,
-		stdOsc8: (url, label) => osc8(url, label, { enabled: osc8Enabled }),
 		...input.runEvents !== void 0 && { runEvents: input.runEvents }
 	};
 };

package/utils/config-suggested-actions.js

@@ -0,0 +1,42 @@
+// src/utils/config-suggested-actions.ts
+/**
+* The `Symbol.for` key under which `configureVitest` publishes the run's
+* config-derived suggested actions on the Vitest instance. `Symbol.for`
+* resolves to the identical symbol across module copies in one process, so
+* the MCP `run_tests` tool reads the same slot off the Vitest instance it
+* created (mirrors the discovery last-scan slot).
+*
+* @internal
+*/
+const CONFIG_SUGGESTED_ACTIONS_SYMBOL = Symbol.for("vitest-agent:config-suggested-actions");
+/**
+* Map a `ValidationResult`'s warnings and info entries onto suggested
+* actions, in the order the validator produced them. A warning becomes a
+* `warn` action and an info entry an `info` action; the title names the
+* rule code, the detail carries the message followed by the remediation
+* when the rule has one. No `targetTool` — there is no MCP tool that edits
+* the Vitest config.
+*
+* @internal
+*/
+const suggestedActionsFromValidation = (result) => [...result.warnings.map((w) => ({
+	severity: "warn",
+	title: `Coverage config: ${w.code}`,
+	detail: w.remediation !== void 0 ? `${w.message} ${w.remediation}` : w.message
+})), ...result.info.map((i) => ({
+	severity: "info",
+	title: `Coverage config: ${i.code}`,
+	detail: i.message
+}))];
+/**
+* Publish the run's config-derived suggested actions on the Vitest instance
+* for readers in the same process (the MCP `run_tests` tool). An empty list
+* clears the slot so a watch-mode rerun after a config fix reports nothing.
+*
+* @internal
+*/
+const publishConfigSuggestedActions = (vitest, actions) => {
+	vitest[CONFIG_SUGGESTED_ACTIONS_SYMBOL] = actions.length > 0 ? actions : void 0;
+};
+
+export { CONFIG_SUGGESTED_ACTIONS_SYMBOL, publishConfigSuggestedActions, suggestedActionsFromValidation };

package/version.js

@@ -8,6 +8,6 @@
 *
 * @public
 */
-const CURRENT_PLUGIN_VERSION = "5.5.0";
+const CURRENT_PLUGIN_VERSION = "5.6.0";
 
 export { CURRENT_PLUGIN_VERSION };