@vitest-agent/sdk 3.1.2 → 5.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.2";
-
-//#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.2",
+	"version": "5.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.115",
-		"@effect/sql-sqlite-node": "4.0.0-rc.115",
-		"@effected/config-file": "^0.8.0",
-		"@effected/jsonc": "^0.11.0",
-		"@effected/toml": "^0.7.0",
-		"@effected/walker": "^0.8.0",
-		"@effected/workspaces": "^0.21.0",
-		"@effected/xdg": "^0.5.0",
-		"@effected/yaml": "^0.15.0",
 		"acorn": "^8.18.0",
 		"acorn-typescript": "^1.4.13",
-		"ajv": "^8.20.0",
-		"effect": "4.0.0-rc.115",
-		"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 → 5.0/run.json}

@@ -1,6 +1,6 @@
 {
 	"$schema": "http://json-schema.org/draft-07/schema#",
-	"$id": "https://vitest-agent.dev/schemas/run-report-file-1.0.0.json",
+	"$id": "https://raw.githubusercontent.com/spencerbeggs/vitest-agent/main/schemas/5.0/run.json",
 	"$ref": "#/$defs/RunReportFile",
 	"$defs": {
 		"IsoInstant": {

package/schemas/RunReportFile.js

@@ -11,14 +11,18 @@ import { Schema } from "effect";
 * `AgentReport` per Vitest project in the run.
 */
 /**
-* Canonical `$schema` URL for `RunReportFile` version 1.
+* Canonical `$schema` URL for `RunReportFile` — the `schemas/5.0/run.json`
+* document GitHub serves raw from this repository.
 *
 * Written as the first key of `run.json` so an editor or a JSON Schema
 * validator can resolve the contract without knowing about vitest-agent.
+* The same value is derived in `lib/configs/run-report-schema.ts` from
+* `HostedSchema.github` (this module cannot import `@effected/*`); the drift
+* test pins the two together.
 *
 * @public
 */
-const RUN_REPORT_FILE_SCHEMA_URL = "https://vitest-agent.dev/schemas/run-report-file-1.0.0.json";
+const RUN_REPORT_FILE_SCHEMA_URL = "https://raw.githubusercontent.com/spencerbeggs/vitest-agent/main/schemas/5.0/run.json";
 /**
 * ISO-8601 instant, the shape `Date.prototype.toISOString` produces.
 * `Date.parse` alone is too permissive — it accepts `"Sep 7 2026"` and

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 = "5.0.0";
+
+//#endregion
+export { CURRENT_SDK_VERSION };

package/layers/ConfigLive.js

@@ -1,46 +0,0 @@
-import { VitestAgentConfig } from "../schemas/Config.js";
-import { VitestAgentConfigFile } from "../services/Config.js";
-import { ConfigFile, ConfigResolver, MergeStrategy, TomlCodec } from "@effected/config-file";
-
-//#region src/layers/ConfigLive.ts
-const CONFIG_FILENAME = "vitest-agent.config.toml";
-/**
-* Build the live `ConfigFile` layer for a given project directory.
-*
-* Resolves the optional `vitest-agent.config.toml` from (in order):
-*
-* 1. The workspace root (when `projectDir` is inside a pnpm/npm/yarn workspace).
-* 2. The git repository root (when `projectDir` is inside a git repo).
-* 3. Walking upward from `projectDir`.
-*
-* The first found file wins (`MergeStrategy.firstMatch()`). If no file is
-* present, downstream callers use `loadOrDefault(new VitestAgentConfig({}))`
-* to get an empty config.
-*
-* @param projectDir - Absolute path inside the user's workspace. Resolvers
-*   anchor here rather than `process.cwd()` so the plugin-spawned MCP server
-*   sees the right config even when invoked from elsewhere.
-* @public
-*/
-const ConfigLive = (projectDir) => ConfigFile.layer(VitestAgentConfigFile, {
-	schema: VitestAgentConfig,
-	codec: TomlCodec,
-	strategy: MergeStrategy.firstMatch(),
-	resolvers: [
-		ConfigResolver.workspaceRoot({
-			filename: CONFIG_FILENAME,
-			cwd: projectDir
-		}),
-		ConfigResolver.gitRoot({
-			filename: CONFIG_FILENAME,
-			cwd: projectDir
-		}),
-		ConfigResolver.upwardWalk({
-			filename: CONFIG_FILENAME,
-			cwd: projectDir
-		})
-	]
-});
-
-//#endregion
-export { ConfigLive };