@vitest-agent/sdk 3.1.1 → 4.0.0

package/index.js

@@ -16,57 +16,10 @@ 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 { VitestAgentConfig } from "./schemas/Config.js";
-import { VitestAgentConfigFile } from "./services/Config.js";
-import { ConfigLive } from "./layers/ConfigLive.js";
-import { DataReader } from "./services/DataReader.js";
-import { HistoryTracker, historyKey } from "./services/HistoryTracker.js";
-import { DataReaderLive } from "./layers/DataReaderLive.js";
 import { ActorType, AgentId, ChatId, ConversationId, HostKind, ProjectKey, TddTaskId } from "./schemas/Identity.js";
 import { Agent, IdempotencyHit } from "./schemas/Agent.js";
-import { DataStore, INLINE_ATTACHMENT_BODY_CAP_BYTES } from "./services/DataStore.js";
-import { coerceErrorField, coerceErrorText } from "./utils/coerce-error-text.js";
-import { DataStoreLive } from "./layers/DataStoreLive.js";
-import { DetailResolver } from "./services/DetailResolver.js";
-import { DetailResolverLive } from "./layers/DetailResolverLive.js";
-import { DiscoveryRegistry } from "./services/DiscoveryRegistry.js";
-import { DiscoveryRegistryLive } from "./layers/DiscoveryRegistryLive.js";
-import { EnvironmentDetector } from "./services/EnvironmentDetector.js";
-import { EnvironmentDetectorLive } from "./layers/EnvironmentDetectorLive.js";
-import { EnvironmentDetectorTest } from "./layers/EnvironmentDetectorTest.js";
-import { ExecutorResolver } from "./services/ExecutorResolver.js";
-import { ExecutorResolverLive } from "./layers/ExecutorResolverLive.js";
-import { FormatSelector } from "./services/FormatSelector.js";
-import { FormatSelectorLive } from "./layers/FormatSelectorLive.js";
-import { classifyTest } from "./utils/classify-test.js";
-import { HistoryTrackerLive } from "./layers/HistoryTrackerLive.js";
-import { HistoryTrackerTest } from "./layers/HistoryTrackerTest.js";
-import { LoggerLive, resolveLogFile, resolveLogLevel } from "./layers/LoggerLive.js";
-import { OutputRenderer } from "./services/OutputRenderer.js";
-import { OutputRendererLive } from "./layers/OutputRendererLive.js";
-import { OutputPipelineLive } from "./layers/OutputPipelineLive.js";
-import { PathResolutionLive } from "./layers/PathResolutionLive.js";
-import { PerClientSessionMapReader, PerClientSessionMapWriter } from "./services/PerClientSessionMap.js";
-import { PerClientSessionMapReaderLive, PerClientSessionMapWriterLive } from "./layers/PerClientSessionMapLive.js";
-import { ProjectDiscovery } from "./services/ProjectDiscovery.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";
-import { ProjectDiscoveryLive } from "./layers/ProjectDiscoveryLive.js";
-import { ProjectDiscoveryTest } from "./layers/ProjectDiscoveryTest.js";
-import { canonicalizeGitUrl, gitUrlToProjectKey } from "./utils/canonicalize-git-url.js";
-import { normalizeWorkspaceKey } from "./utils/normalize-workspace-key.js";
-import { ProjectIdentity, resolveProjectIdentityFromCandidates } from "./services/ProjectIdentity.js";
-import { ProjectIdentityLive, ProjectIdentityTest } from "./layers/ProjectIdentityLive.js";
-import { AgentContext, RunContext, RunContext$, RunContextService } from "./services/RunContext.js";
-import { probeHostMetadataFromEnv } from "./utils/probe-host-metadata.js";
-import { RunContextLive, RunContextTest } from "./layers/RunContextLive.js";
-import { formatTriageEffect } from "./lib/format-triage.js";
-import { formatWrapupEffect } from "./lib/format-wrapup.js";
-import migration from "./migrations/0001_initial.js";
-import migration$1 from "./migrations/0002_test_artifacts.js";
-import { PROJECT_MIGRATIONS } from "./migrations/index.js";
-import migration$2 from "./migrations/registry_0001_initial.js";
-import migration$3 from "./migrations/session_map_0001_initial.js";
 import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
 import { ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests } from "./schemas/ConsoleLeaks.js";
 import { MetricThresholds, PatternMetricThresholds, PatternThresholds, PerFileThresholds, ResolvedThresholds } from "./schemas/Thresholds.js";
@@ -75,6 +28,7 @@ import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } f
 import { CoverageBaselines } from "./schemas/Baselines.js";
 import { CacheManifest, CacheManifestEntry } from "./schemas/CacheManifest.js";
 import { BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorsReadyEvent, BlockedEvent, ChannelEvent, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalStartedEvent, GoalsReadyEvent, PhaseTransitionEvent, SessionCompleteEvent, SessionOutcome } from "./schemas/ChannelEvent.js";
+import { VitestAgentConfig } from "./schemas/Config.js";
 import { CoverageLevel, resolveCoverageInput, validateCoverageConfig } from "./schemas/CoverageLevel.js";
 import { CoverageTargets, CoverageTargetsMetrics } from "./schemas/CoverageTargets.js";
 import { HistoryRecord, TestHistory, TestRun } from "./schemas/History.js";
@@ -94,36 +48,24 @@ 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 { IDEMPOTENCY_ROOT_SENTINEL, deriveIdempotencyKey } from "./services/idempotency.js";
-import { assembleHistoryRecord, assembleManifest } from "./sql/assemblers.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 { 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 { _resetMigrationCacheForTesting, ensureMigrated } from "./utils/ensure-migrated.js";
-import { computeFailureSignature, normalizeAssertionShape } from "./utils/failure-signature.js";
 import { formatFatalError } from "./utils/format-fatal-error.js";
 import { findFunctionBoundary } from "./utils/function-boundary.js";
 import { buildEnvPrefix, detectVitestScripts, isVitestInvocation, rewriteBashCommand } from "./utils/match-vitest-command.js";
-import { resolveProjectKeyFromCwd } from "./utils/resolve-project-key-from-cwd.js";
-import { DATABASE_FILENAME, resolveDataPath } from "./utils/resolve-data-path.js";
-import { resolveWorkspaceKey } from "./utils/resolve-workspace-key.js";
+import { normalizeWorkspaceKey } from "./utils/normalize-workspace-key.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";
 import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-shape.js";
 import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "./utils/validate-phase-transition.js";
+import { CURRENT_SDK_VERSION } from "./version.js";
 
-//#region src/index.ts
-/**
-* The version of this package. Inlined at build time from
-* package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
-* Source-level reads (workspace `exports: "./src/index.ts"` during dev)
-* see the `"0.0.0"` fallback — a clear signal the build pipeline has not
-* substituted yet. Exported for version introspection by downstream tooling.
-* @public
-*/
-const CURRENT_SDK_VERSION = "3.1.1";
-
-//#endregion
-export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, 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, ConfigLive, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FileCoverageReport, FileEditPayload, FormatSelector, FormatSelectorLive, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, INLINE_ATTACHMENT_BODY_CAP_BYTES, IdempotencyHit, IllegalStatusTransitionError, JsonFormatter, LoggerLive, MarkdownFormatter, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PROJECT_MIGRATIONS, PackageManager, PathResolutionError, PathResolutionLive, PatternMetricThresholds, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentityTest, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, 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, VitestAgentConfigFile, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$2 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$3 as sessionMapMigration0001, stripAnsi, 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, 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 };

package/internal-inject-env.js

@@ -1,11 +1,9 @@
 import { detectVitestScripts, rewriteBashCommand } from "./utils/match-vitest-command.js";
-import { join } from "node:path";
-import { readFileSync } from "node:fs";
 
 //#region src/internal-inject-env.ts
-const readPackageScripts = (cwd) => {
+const readPackageScripts = (cwd, readFile) => {
 	try {
-		const raw = readFileSync(join(cwd, "package.json"), "utf-8");
+		const raw = readFile(`${cwd}/package.json`);
 		return JSON.parse(raw).scripts ?? {};
 	} catch {
 		return {};
@@ -19,15 +17,15 @@ const readPackageScripts = (cwd) => {
 *   - `VITEST_AGENT_CONVERSATION_ID` or `VITEST_AGENT_AGENT_ID` is
 *     missing from env (no agent context to attribute to)
 *
-* Always synchronous — the package.json read is the only I/O and is
-* fast enough not to need Effect wrapping.
+* Always synchronous — the package.json read is the only I/O, goes through
+* the injected `readFile`, and is fast enough not to need Effect wrapping.
 * @public
 */
 const injectEnv = (input) => {
 	const conversationId = input.env.VITEST_AGENT_CONVERSATION_ID;
 	const agentId = input.env.VITEST_AGENT_AGENT_ID;
 	if (conversationId === void 0 || agentId === void 0) return input.command;
-	const scripts = readPackageScripts(input.cwd);
+	const scripts = readPackageScripts(input.cwd, input.readFile);
 	const vitestScripts = detectVitestScripts(scripts);
 	const parentAgentId = input.env.VITEST_AGENT_PARENT_AGENT_ID;
 	return rewriteBashCommand({

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "3.1.1",
+	"version": "4.0.0",
 	"private": false,
-	"description": "Shared Effect Schema, SQLite migrations, data layer, services, formatters, and utilities for vitest-agent packages.",
+	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, formatters, and pure utilities.",
 	"keywords": [
 		"vitest",
 		"agent",
@@ -37,29 +37,13 @@
 			"import": "./dispatch.js",
 			"default": "./dispatch.js"
 		},
-		"./testing": {
-			"types": "./testing.d.ts",
-			"import": "./testing.js",
-			"default": "./testing.js"
-		},
 		"./schemas/*.json": "./schemas/*.json",
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@effect/platform-node": "4.0.0-rc.112",
-		"@effect/sql-sqlite-node": "4.0.0-rc.112",
-		"@effected/config-file": "^0.7.0",
-		"@effected/jsonc": "^0.9.0",
-		"@effected/toml": "^0.6.0",
-		"@effected/walker": "^0.7.0",
-		"@effected/workspaces": "^0.20.3",
-		"@effected/xdg": "^0.4.1",
-		"@effected/yaml": "^0.14.0",
 		"acorn": "^8.18.0",
 		"acorn-typescript": "^1.4.13",
-		"ajv": "^8.20.0",
-		"effect": "4.0.0-rc.112",
-		"std-env": "^4.2.0"
+		"effect": "4.0.0-rc.115"
 	},
 	"engines": {
 		"node": ">=24.11.0"

package/schemas/run-report-file-1.0.0.json

@@ -90,7 +90,7 @@
 				}
 			},
 			"required": ["total", "passed", "failed", "skipped", "duration"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"TestState": {
 			"type": "string",
@@ -144,7 +144,7 @@
 				}
 			},
 			"required": ["message"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"TestClassification": {
 			"type": "string",
@@ -225,7 +225,7 @@
 				}
 			},
 			"required": ["name", "fullName", "state"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"ModuleReport": {
 			"type": "object",
@@ -275,7 +275,7 @@
 				}
 			},
 			"required": ["file", "state", "tests"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"CoverageTotals": {
 			"type": "object",
@@ -326,7 +326,7 @@
 				}
 			},
 			"required": ["statements", "branches", "functions", "lines"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"MetricThresholds": {
 			"type": "object",
@@ -404,7 +404,7 @@
 					]
 				}
 			},
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"PerFileThresholds": {
 			"anyOf": [
@@ -495,7 +495,7 @@
 					"$ref": "#/$defs/PerFileThresholds"
 				}
 			},
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"PatternThresholds": {
 			"type": "array",
@@ -524,7 +524,7 @@
 				}
 			},
 			"required": ["file", "summary", "uncoveredLines"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"CoverageReport": {
 			"type": "object",
@@ -546,7 +546,7 @@
 						}
 					},
 					"required": ["global"],
-					"additionalProperties": false
+					"additionalProperties": true
 				},
 				"targets": {
 					"anyOf": [
@@ -564,7 +564,7 @@
 								}
 							},
 							"required": ["global"],
-							"additionalProperties": false
+							"additionalProperties": true
 						},
 						{
 							"type": "null"
@@ -587,7 +587,7 @@
 								}
 							},
 							"required": ["global"],
-							"additionalProperties": false
+							"additionalProperties": true
 						},
 						{
 							"type": "null"
@@ -668,7 +668,7 @@
 				}
 			},
 			"required": ["totals", "thresholds", "lowCoverage", "lowCoverageFiles"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"TagCountEntry": {
 			"type": "object",
@@ -728,7 +728,7 @@
 					]
 				}
 			},
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"ConsoleLeakFile": {
 			"type": "object",
@@ -783,7 +783,7 @@
 				}
 			},
 			"required": ["file", "stdout", "stderr"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"ConsoleLeaksFromFailingTests": {
 			"type": "object",
@@ -812,7 +812,7 @@
 				}
 			},
 			"required": ["total", "files"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"ConsoleLeaks": {
 			"type": "object",
@@ -856,7 +856,7 @@
 				}
 			},
 			"required": ["total", "byFile"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"AgentReport": {
 			"type": "object",
@@ -933,7 +933,7 @@
 				}
 			},
 			"required": ["timestamp", "reason", "summary", "failed", "unhandledErrors", "failedFiles"],
-			"additionalProperties": false
+			"additionalProperties": true
 		},
 		"RunReportFile": {
 			"type": "object",
@@ -956,7 +956,7 @@
 				}
 			},
 			"required": ["schemaVersion", "generatedAt", "reports"],
-			"additionalProperties": false,
+			"additionalProperties": true,
 			"description": "The vitest-agent run report file (.vitest/vitest-agent/run.json): one AgentReport per Vitest project from the most recent run. Read reports[].summary for pass/fail counts and reports[].failed for the failing modules and their tests. schemaVersion is the envelope contract version; generatedAt is when the run finished."
 		}
 	}

package/sidecar-dispatch.js

@@ -37,17 +37,18 @@ const messageFromError = (err) => {
 };
 /**
 * Dispatch one argv invocation. `argv` is the post-`node post-bin`
-* slice — i.e. `process.argv.slice(2)`. Never throws: every failure is
-* folded into the returned {@link DispatchResult}.
+* slice — i.e. `process.argv.slice(2)` — and `io` carries the process
+* facts (cwd, env, a file reader) the runner owns. Never throws: every
+* failure is folded into the returned {@link DispatchResult}.
 * @public
 */
-const dispatch = async (argv) => {
+const dispatch = async (argv, io) => {
 	const subcommand = argv[0];
 	const rest = argv.slice(1);
 	if (subcommand === "inject-env") {
 		const flags = parseFlags(rest);
 		const command = flags.command;
-		const cwd = flags.cwd ?? process.cwd();
+		const cwd = flags.cwd ?? io.cwd;
 		if (command === void 0) return {
 			stdout: "",
 			stderr: `${exitCodeForTag("Defect")} Defect: inject-env requires --command\n`,
@@ -58,7 +59,8 @@ const dispatch = async (argv) => {
 				stdout: `${injectEnv({
 					command,
 					cwd,
-					env: process.env
+					env: io.env,
+					readFile: io.readFile
 				})}\n`,
 				stderr: "",
 				code: 0

package/utils/format-console.js

@@ -40,15 +40,14 @@ function getWorstMetric(f) {
 * project-relative path for display.
 *
 * @param filePath - Absolute or relative file path
-* @param cwd - Working directory to strip; defaults to `process.cwd()`
+* @param cwd - Working directory to strip
 * @returns Project-relative path string
 *
 * @internal
 */
 function relativePath(filePath, cwd) {
-	const root = cwd ?? process.cwd();
-	if (filePath.startsWith(root)) {
-		const rel = filePath.slice(root.length);
+	if (filePath.startsWith(cwd)) {
+		const rel = filePath.slice(cwd.length);
 		return rel.startsWith("/") ? rel.slice(1) : rel;
 	}
 	return filePath;
@@ -93,7 +92,7 @@ function determineTier(report) {
 * @internal
 */
 function formatConsoleMarkdown(report, options) {
-	const { consoleOutput, coverageConsoleLimit, noColor } = options;
+	const { consoleOutput, coverageConsoleLimit, noColor, cwd } = options;
 	if (consoleOutput === "silent") return "";
 	const ao = { noColor };
 	const lines = [];
@@ -130,7 +129,7 @@ function formatConsoleMarkdown(report, options) {
 		}
 	}
 	if (hasFailures) for (const mod of report.failed) {
-		const file = relativePath(mod.file);
+		const file = relativePath(mod.file, cwd);
 		lines.push(`### ${ansi("✗", "red", ao)} \`${file}\``);
 		lines.push("");
 		if (mod.errors && mod.errors.length > 0) for (const err of mod.errors) {
@@ -171,7 +170,7 @@ function formatConsoleMarkdown(report, options) {
 			lines.push(`### Coverage gaps`);
 			lines.push("");
 			for (const f of filesToShow) {
-				const file = relativePath(f.file);
+				const file = relativePath(f.file, cwd);
 				const worst = getWorstMetric(f);
 				const thresholdValue = globalThresholds[worst.label === "Stmts" ? "statements" : worst.label === "Branch" ? "branches" : worst.label === "Funcs" ? "functions" : "lines"];
 				const thresholdSuffix = thresholdValue != null ? ` (threshold: ${thresholdValue}%)` : "";
@@ -183,7 +182,7 @@ function formatConsoleMarkdown(report, options) {
 			lines.push(`### Coverage improvements needed`);
 			lines.push("");
 			for (const f of cov.belowTarget.slice(0, coverageConsoleLimit)) {
-				const file = relativePath(f.file);
+				const file = relativePath(f.file, cwd);
 				const worst = getWorstMetric(f);
 				const metricKey = worst.label === "Stmts" ? "statements" : worst.label === "Branch" ? "branches" : worst.label === "Funcs" ? "functions" : "lines";
 				const targetValue = cov.targets.global[metricKey];
@@ -202,12 +201,12 @@ function formatConsoleMarkdown(report, options) {
 			const persistent = allFailedTests.filter((t) => t.classification === "persistent");
 			const flaky = allFailedTests.filter((t) => t.classification === "flaky");
 			if (newFailures.length > 0) {
-				const files = [...new Set(report.failed.filter((m) => m.tests.some((t) => t.classification === "new-failure")).map((m) => relativePath(m.file)))];
+				const files = [...new Set(report.failed.filter((m) => m.tests.some((t) => t.classification === "new-failure")).map((m) => relativePath(m.file, cwd)))];
 				lines.push(`- Fix ${newFailures.length} new failure${newFailures.length > 1 ? "s" : ""} in ${files.map((f) => `\`${f}\``).join(", ")} (likely caused by recent changes)`);
 			}
 			if (persistent.length > 0) lines.push(`- ${persistent.length} persistent failure${persistent.length > 1 ? "s" : ""} (pre-existing, may not be yours)`);
 			if (flaky.length > 0) lines.push(`- ${flaky.length} flaky test${flaky.length > 1 ? "s" : ""} (may pass on retry)`);
-			for (const file of report.failedFiles) lines.push(`- Re-run: \`vitest run ${relativePath(file)}\``);
+			for (const file of report.failedFiles) lines.push(`- Re-run: \`vitest run ${relativePath(file, cwd)}\``);
 			if (options.mcp) {
 				lines.push("- Use `test_history` for failure trends");
 				lines.push("- Use `test_errors` to search errors by type");

package/utils/format-terminal.js

@@ -209,10 +209,10 @@ const sepRow = (widths) => widths.map((w) => "-".repeat(w + 2)).join("|");
 *
 * @internal
 */
-const renderBelowTargetTable = (files) => {
+const renderBelowTargetTable = (files, cwd) => {
 	if (files.length === 0) return [];
 	const rows = files.map((f) => ({
-		file: relativePath(f.file),
+		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)),
@@ -331,7 +331,7 @@ const renderCoverageSection = (reports, options, ao) => {
 		lines.push("Files below aspirational target:");
 		const limit = options.coverageConsoleLimit;
 		const shown = agg.belowTargetFiles.slice(0, limit);
-		lines.push(...renderBelowTargetTable(shown));
+		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;
@@ -342,7 +342,7 @@ const renderCoverageSection = (reports, options, ao) => {
 *
 * @internal
 */
-const renderFailuresSection = (reports, ao) => {
+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;
@@ -351,7 +351,7 @@ const renderFailuresSection = (reports, ao) => {
 		const projectName = report.project ?? "default";
 		lines.push(`  ${projectName}`);
 		for (const mod of report.failed) {
-			const file = relativePath(mod.file);
+			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) {
@@ -403,7 +403,7 @@ const renderTotal = (reports, ao) => {
 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));
+	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}`);
@@ -470,7 +470,7 @@ const formatTerminal = (reports, options) => {
 			out.push("");
 		}
 	}
-	const failures = renderFailuresSection(reports, ao);
+	const failures = renderFailuresSection(reports, options.cwd, ao);
 	if (failures.length > 0) {
 		out.push(...failures);
 		out.push("");

package/utils/posix-path.js

@@ -0,0 +1,52 @@
+//#region src/utils/posix-path.ts
+/**
+* Pure POSIX path helpers for the platform-free core.
+*
+* `@vitest-agent/sdk` must not import `node:path`, so the handful of path
+* operations the core needs are implemented here over normalized
+* forward-slash strings. Every helper accepts Windows-style input (a
+* backslash separator) and normalizes it via {@link toPosix} at entry, so a
+* caller never has to know which separator the platform used.
+*/
+/**
+* Normalizes `p` to forward slashes: every backslash becomes `/`.
+* @public
+*/
+const toPosix = (p) => p.replaceAll("\\", "/");
+/**
+* Last segment of `p` after normalization — `"b.ts"` for `"/a/b.ts"`.
+* Trailing separators are ignored, so `"/a/b/"` yields `"b"`.
+* @public
+*/
+const basenamePosix = (p) => {
+	const normalized = toPosix(p).replace(/\/+$/, "");
+	const index = normalized.lastIndexOf("/");
+	return index === -1 ? normalized : normalized.slice(index + 1);
+};
+/**
+* Joins `parts` with a single `/` between each, normalizing every part and
+* collapsing duplicate separators at the seams. Empty parts are skipped.
+* @public
+*/
+const joinPosix = (...parts) => {
+	const normalized = parts.map(toPosix).filter((part) => part.length > 0);
+	if (normalized.length === 0) return "";
+	const [first, ...rest] = normalized;
+	return rest.reduce((acc, part) => `${acc.replace(/\/+$/, "")}/${part.replace(/^\/+/, "")}`, first);
+};
+/**
+* Path of `to` relative to `from`, both normalized. Returns `""` when they
+* are the same path and `to` unchanged when it is not under `from` (no
+* `../` climbing — the core has no notion of a filesystem to climb through).
+* @public
+*/
+const relativePosix = (from, to) => {
+	const base = toPosix(from).replace(/\/+$/, "");
+	const target = toPosix(to);
+	if (target === base) return "";
+	const prefix = `${base}/`;
+	return target.startsWith(prefix) ? target.slice(prefix.length) : target;
+};
+
+//#endregion
+export { basenamePosix, joinPosix, relativePosix, toPosix };

package/utils/test-location.js

@@ -1,4 +1,4 @@
-import { basename, join, relative, sep } from "node:path";
+import { basenamePosix, joinPosix, relativePosix, toPosix } from "./posix-path.js";
 
 //#region src/utils/test-location.ts
 /** Directory holding source files whose tests may be co-located. @public */
@@ -58,9 +58,15 @@ const TEST_FILE_SUFFIX_RE = /\.(?:test|spec)\.(?:ts|tsx|js|jsx)$/;
 function isTestFileName(filePathOrName) {
 	return TEST_FILE_SUFFIX_RE.test(filePathOrName);
 }
-/** True when `child` is `parent` or sits beneath it on a segment boundary. */
+/**
+* True when `child` is `parent` or sits beneath it on a segment boundary.
+* Both sides are normalized to forward slashes first, so a Windows path
+* compares the same way a POSIX one does.
+*/
 function contains(parent, child) {
-	return child === parent || child.startsWith(parent.endsWith(sep) ? parent : `${parent}${sep}`);
+	const parentPosix = toPosix(parent);
+	const childPosix = toPosix(child);
+	return childPosix === parentPosix || childPosix.startsWith(parentPosix.endsWith("/") ? parentPosix : `${parentPosix}/`);
 }
 /**
 * Returns the deepest supplied workspace containing `filePath`, or `null` when
@@ -100,7 +106,7 @@ function findOwningWorkspace(workspaces, filePath) {
 function classifyTestPath(workspaces, filePath) {
 	const owner = findOwningWorkspace(workspaces, filePath);
 	if (owner === null) return null;
-	const segments = relative(owner.path, filePath).split(sep);
+	const segments = relativePosix(owner.path, filePath).split("/");
 	if (segments.some((s) => NON_DISCOVERABLE_DIRS.has(s))) return null;
 	const [head] = segments;
 	if (head === "src") return {
@@ -119,7 +125,7 @@ function classifyTestPath(workspaces, filePath) {
 	return {
 		verdict: "invalid",
 		workspace: owner.name,
-		suggestedPath: join(owner.path, TEST_DIR, basename(filePath))
+		suggestedPath: joinPosix(owner.path, TEST_DIR, basenamePosix(filePath))
 	};
 }
 

package/version.js

@@ -0,0 +1,17 @@
+//#region src/version.ts
+/**
+* The version of this package. Inlined at build time from
+* package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
+* Source-level reads (workspace `exports: "./src/index.ts"` during dev)
+* see the `"0.0.0"` fallback — a clear signal the build pipeline has not
+* substituted yet. Exported for version introspection by downstream tooling.
+*
+* This is the one sanctioned `process` read in the platform-free core: the
+* bundler replaces the token at build time, so no runtime `process` access
+* survives into the published artifact.
+* @public
+*/
+const CURRENT_SDK_VERSION = "4.0.0";
+
+//#endregion
+export { CURRENT_SDK_VERSION };