@vitest-agent/mcp 2.4.13 → 2.4.14

package/bin/vitest-agent-mcp.js

@@ -5,9 +5,9 @@ import { startMcpServer } from "../server.js";
 import { recoverSessionContextFromSessionEnv } from "../session-env.js";
 import { shouldExitOnUncaughtException } from "../utils/crash-guards.js";
 import { safeFormatFatalError } from "../utils/safe-format-fatal-error.js";
+import { Effect, ManagedRuntime } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { PathResolutionLive, resolveDataPath, resolveLogFile, resolveLogLevel } from "@vitest-agent/sdk";
-import { Effect, ManagedRuntime } from "effect";
 
 //#region src/bin.ts
 /**
@@ -83,7 +83,7 @@ function scheduleTestCrashInjection() {
 * Precedence (most explicit wins):
 *
 * 1. `VITEST_AGENT_REPORTER_PROJECT_DIR` — set by the Claude Code plugin
-*    loader (`plugin/bin/mcp-server.mjs`) to the resolved project root.
+*    loader (`plugins/claude-code/bin/mcp-server.mjs`) to the resolved project root.
 *    The loader controls this end-to-end so the value is reliable when
 *    set.
 * 2. `CLAUDE_PROJECT_DIR` — exported by Claude Code for hook scripts and
@@ -99,7 +99,7 @@ function resolveProjectDir() {
 * Optional first positional argument: an initial Claude Code chat UUID
 * (the host's `chatId`) to seed the MCP server's session association.
 *
-* The plugin manifest (`plugin/.claude-plugin/plugin.json`) can pass this
+* The plugin manifest (`plugins/claude-code/.claude-plugin/plugin.json`) can pass this
 * via Claude Code variable substitution if such a variable exists for
 * sessions (the documented substitutions are `${CLAUDE_PLUGIN_ROOT}` and
 * `${CLAUDE_PLUGIN_DATA}`; testing whether `${CLAUDE_SESSION_ID}` or a

package/context.js

@@ -1,4 +1,5 @@
 import { initTRPC } from "@trpc/server";
+import { MutableRef } from "effect";
 
 //#region src/context.ts
 /**
@@ -9,11 +10,11 @@ import { initTRPC } from "@trpc/server";
 * @public
 */
 const createCurrentSessionIdRef = (initial = null) => {
-	let value = initial;
+	const ref = MutableRef.make(initial);
 	return {
-		get: () => value,
+		get: () => MutableRef.get(ref),
 		set: (id) => {
-			value = id;
+			MutableRef.set(ref, id);
 		}
 	};
 };

package/index.d.ts

@@ -28,7 +28,7 @@ interface CurrentSessionIdRef {
  * @returns a mutable ref holding the current session id
  * @public
  */
-declare const createCurrentSessionIdRef: (initial?: string | null) => CurrentSessionIdRef;
+export declare const createCurrentSessionIdRef: (initial?: string | null) => CurrentSessionIdRef;
 /**
  * Recovered session attribution context — the canonical UUIDs the
  * SessionStart hook wrote to `${CLAUDE_ENV_FILE}` so they auto-source
@@ -73,7 +73,7 @@ interface SessionContextRef {
  * @returns a mutable ref holding the current session context
  * @public
  */
-declare const createSessionContextRef: (initial?: SessionContext | null, recover?: () => SessionContext | null) => SessionContextRef;
+export declare const createSessionContextRef: (initial?: SessionContext | null, recover?: () => SessionContext | null) => SessionContextRef;
 /**
  * tRPC context carrying a ManagedRuntime for Effect service access.
  *
@@ -97,7 +97,7 @@ interface McpContext {
  *
  * @public
  */
-declare const createCallerFactory: import("@trpc/server").TRPCRouterCallerFactory<{
+export declare const createCallerFactory: import("@trpc/server").TRPCRouterCallerFactory<{
   ctx: McpContext;
   meta: object;
   errorShape: import("@trpc/server").TRPCDefaultErrorShape;
@@ -118,7 +118,7 @@ declare const createCallerFactory: import("@trpc/server").TRPCRouterCallerFactor
  * @returns an Effect Layer providing all MCP runtime services
  * @public
  */
-declare const McpLive: (dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<import("@vitest-agent/sdk").DataReader | import("@vitest-agent/sdk").DataStore | import("@vitest-agent/sdk").DetailResolver | import("@vitest-agent/sdk").EnvironmentDetector | import("@vitest-agent/sdk").ExecutorResolver | import("@vitest-agent/sdk").FormatSelector | import("@vitest-agent/sdk").OutputRenderer | import("@vitest-agent/sdk").ProjectDiscovery | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare const McpLive: (dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<import("@vitest-agent/sdk").DataReader | import("@vitest-agent/sdk").DataStore | import("@vitest-agent/sdk").DetailResolver | import("@vitest-agent/sdk").EnvironmentDetector | import("@vitest-agent/sdk").ExecutorResolver | import("@vitest-agent/sdk").FormatSelector | import("@vitest-agent/sdk").OutputRenderer | import("@vitest-agent/sdk").ProjectDiscovery | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 //#endregion
 //#region src/router.d.ts
 /**
@@ -129,7 +129,7 @@ declare const McpLive: (dbPath: string, logLevel?: LogLevel.LogLevel, logFile?:
  *
  * @public
  */
-declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
+export declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
   ctx: McpContext;
   meta: object;
   errorShape: import("@trpc/server").TRPCDefaultErrorShape;
@@ -1584,7 +1584,7 @@ declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
  * @param ctx - the MCP context carrying the shared ManagedRuntime and session refs
  * @public
  */
-declare function buildMcpServer(ctx: McpContext): McpServer;
+export declare function buildMcpServer(ctx: McpContext): McpServer;
 /**
  * Starts the MCP server over stdio, registering all tools and prompts.
  *
@@ -1594,7 +1594,7 @@ declare function buildMcpServer(ctx: McpContext): McpServer;
  * @param ctx - the MCP context carrying the shared ManagedRuntime and session refs
  * @public
  */
-declare function startMcpServer(ctx: McpContext): Promise<void>;
+export declare function startMcpServer(ctx: McpContext): Promise<void>;
 //#endregion
 //#region src/session-env.d.ts
 /**
@@ -1605,7 +1605,7 @@ declare function startMcpServer(ctx: McpContext): Promise<void>;
  * @returns a record of export names to unquoted values
  * @public
  */
-declare const parseSessionEnvExports: (content: string) => Record<string, string>;
+export declare const parseSessionEnvExports: (content: string) => Record<string, string>;
 /**
  * Recover a {@link SessionContext} from the newest session-env hook file
  * whose `VITEST_AGENT_PROJECT_DIR` matches `projectDir`.
@@ -1618,7 +1618,7 @@ declare const parseSessionEnvExports: (content: string) => Record<string, string
  *   the default `~/.claude/session-env` (tests)
  * @public
  */
-declare const recoverSessionContextFromSessionEnv: (opts: {
+export declare const recoverSessionContextFromSessionEnv: (opts: {
   readonly projectDir: string;
   readonly sessionEnvRoot?: string;
 }) => SessionContext | null;
@@ -1663,7 +1663,7 @@ interface TddErrorEnvelope {
  *
  * @public
  */
-declare const CURRENT_MCP_VERSION: string;
+export declare const CURRENT_MCP_VERSION: string;
 //#endregion
-export { CURRENT_MCP_VERSION, type CurrentSessionIdRef, type McpContext, McpLive, type Remediation, type SessionContext, type SessionContextRef, type TddErrorEnvelope, appRouter, buildMcpServer, createCallerFactory, createCurrentSessionIdRef, createSessionContextRef, parseSessionEnvExports, recoverSessionContextFromSessionEnv, startMcpServer };
+export type { CurrentSessionIdRef, McpContext, Remediation, SessionContext, SessionContextRef, TddErrorEnvelope };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -12,7 +12,7 @@ import { parseSessionEnvExports, recoverSessionContextFromSessionEnv } from "./s
 *
 * @public
 */
-const CURRENT_MCP_VERSION = "2.4.13";
+const CURRENT_MCP_VERSION = "2.4.14";
 
 //#endregion
 export { CURRENT_MCP_VERSION, McpLive, appRouter, buildMcpServer, createCallerFactory, createCurrentSessionIdRef, createSessionContextRef, parseSessionEnvExports, recoverSessionContextFromSessionEnv, startMcpServer };

package/layers/McpLive.js

@@ -1,8 +1,8 @@
+import { Layer } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { layer } from "@effect/sql-sqlite-node/SqliteClient";
 import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
 import { DataReaderLive, DataStoreLive, LoggerLive, OutputPipelineLive, ProjectDiscoveryLive, migration0001 } from "@vitest-agent/sdk";
-import { Layer } from "effect";
 
 //#region src/layers/McpLive.ts
 /**

package/middleware/idempotency.js

@@ -1,6 +1,6 @@
 import { middleware, publicProcedure } from "../context.js";
-import { DataReader, DataStore } from "@vitest-agent/sdk";
 import { Effect, Option } from "effect";
+import { DataReader, DataStore } from "@vitest-agent/sdk";
 
 //#region src/middleware/idempotency.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/mcp",
-	"version": "2.4.13",
+	"version": "2.4.14",
 	"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": [

package/server.js

@@ -32,8 +32,8 @@ import { appRouter } from "./router.js";
 import { registerAllPrompts } from "./prompts/index.js";
 import { effectToZodSchema } from "./utils/effect-to-zod.js";
 import { buildUnexpectedToolErrorEnvelope } from "./utils/tool-error-envelope.js";
-import { ChannelEvent, DataReader } from "@vitest-agent/sdk";
 import { Effect, Exit, Option, Schema } from "effect";
+import { ChannelEvent, DataReader } from "@vitest-agent/sdk";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";

package/tools/_tdd-error-envelope.js

@@ -1,5 +1,5 @@
-import { BehaviorNotFoundError, GoalNotFoundError, IllegalStatusTransitionError, TddTaskAlreadyEndedError, TddTaskNotFoundError } from "@vitest-agent/sdk";
 import { Effect } from "effect";
+import { BehaviorNotFoundError, GoalNotFoundError, IllegalStatusTransitionError, TddTaskAlreadyEndedError, TddTaskNotFoundError } from "@vitest-agent/sdk";
 
 //#region src/tools/_tdd-error-envelope.ts
 /**

package/tools/acceptance-metrics.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/acceptance-metrics.ts
 /**

package/tools/cache-health.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { CacheManifest, DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { CacheManifest, DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/cache-health.ts
 /**

package/tools/commit-changes.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/commit-changes.ts
 /**

package/tools/configure.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/configure.ts
 /**

package/tools/coverage.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { CoverageReport, DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { CoverageReport, DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/coverage.ts
 const CoverageAvailable = Schema.Struct({

package/tools/errors.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/errors.ts
 /**

package/tools/failure-signature-get.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/failure-signature-get.ts
 /**

package/tools/file-coverage.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { CoverageTotals, DataReader, FileCoverageReport } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { CoverageTotals, DataReader, FileCoverageReport } from "@vitest-agent/sdk";
 
 //#region src/tools/file-coverage.ts
 /**

package/tools/history.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader, HistoryRecord } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader, HistoryRecord } from "@vitest-agent/sdk";
 
 //#region src/tools/history.ts
 /**

package/tools/hypothesis.js

@@ -1,6 +1,6 @@
 import { idempotentProcedure } from "../middleware/idempotency.js";
-import { DataReader, DataStore, DataStoreError } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema } from "effect";
+import { DataReader, DataStore, DataStoreError } from "@vitest-agent/sdk";
 
 //#region src/tools/hypothesis.ts
 /**

package/tools/inventory.js

@@ -1,7 +1,7 @@
 import { publicProcedure } from "../context.js";
 import { collectProjectRows, resolveProjectTargets } from "./_project-groups.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/inventory.ts
 /**

package/tools/note.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader, DataStore } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema } from "effect";
+import { DataReader, DataStore } from "@vitest-agent/sdk";
 
 //#region src/tools/note.ts
 const NoteScope = Schema.Literals([

package/tools/overview.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/overview.ts
 /**

package/tools/register-agent.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader, DataStore, deriveIdempotencyKey } from "@vitest-agent/sdk";
 import { Effect, Option, Schema } from "effect";
+import { DataReader, DataStore, deriveIdempotencyKey } from "@vitest-agent/sdk";
 
 //#region src/tools/register-agent.ts
 /**

package/tools/run-tests.js

@@ -1,7 +1,7 @@
 import { publicProcedure } from "../context.js";
 import { createRequire } from "node:module";
-import { AgentReport, DataReader, DataStore, buildAgentReport, buildConsoleLeaks, coerceErrorField, collectConsoleLeakEntries, formatScopedCoverageNote } from "@vitest-agent/sdk";
 import { Data, Effect, Schema, SchemaGetter, Semaphore } from "effect";
+import { AgentReport, DataReader, DataStore, buildAgentReport, buildConsoleLeaks, coerceErrorField, collectConsoleLeakEntries, formatScopedCoverageNote } from "@vitest-agent/sdk";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { execFile } from "node:child_process";
 import { existsSync, mkdtempSync, rmSync } from "node:fs";

package/tools/settings-list.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/settings-list.ts
 /**

package/tools/status.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { CacheManifestEntry, DataReader } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { CacheManifestEntry, DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/status.ts
 /**

package/tools/tdd-artifact.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/tdd-artifact.ts
 /**

package/tools/tdd-behavior.js

@@ -1,7 +1,7 @@
 import { idempotentProcedure } from "../middleware/idempotency.js";
 import { catchTddErrorsAsEnvelope } from "./_tdd-error-envelope.js";
-import { BehaviorDetail, BehaviorRow, DataReader, DataStore } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema } from "effect";
+import { BehaviorDetail, BehaviorRow, DataReader, DataStore } from "@vitest-agent/sdk";
 
 //#region src/tools/tdd-behavior.ts
 /**

package/tools/tdd-goal.js

@@ -1,7 +1,7 @@
 import { idempotentProcedure } from "../middleware/idempotency.js";
 import { catchTddErrorsAsEnvelope } from "./_tdd-error-envelope.js";
-import { DataReader, DataStore, GoalDetail, GoalRow } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema } from "effect";
+import { DataReader, DataStore, GoalDetail, GoalRow } from "@vitest-agent/sdk";
 
 //#region src/tools/tdd-goal.ts
 /**

package/tools/tdd-phase-transition-request.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader, DataStore, requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "@vitest-agent/sdk";
 import { Effect, Option, Schema } from "effect";
+import { DataReader, DataStore, requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "@vitest-agent/sdk";
 
 //#region src/tools/tdd-phase-transition-request.ts
 /**

package/tools/tdd-task.js

@@ -1,6 +1,6 @@
 import { idempotentProcedure } from "../middleware/idempotency.js";
-import { DataReader, DataStore, GoalDetail } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema, SchemaGetter } from "effect";
+import { DataReader, DataStore, GoalDetail } from "@vitest-agent/sdk";
 
 //#region src/tools/tdd-task.ts
 /**

package/tools/test.js

@@ -1,7 +1,7 @@
 import { publicProcedure } from "../context.js";
 import { collectProjectRows, resolveProjectTargets } from "./_project-groups.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Match, Option, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/test.ts
 /**

package/tools/trends.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader, TrendRecord } from "@vitest-agent/sdk";
 import { Effect, Option, Schema, SchemaGetter } from "effect";
+import { DataReader, TrendRecord } from "@vitest-agent/sdk";
 
 //#region src/tools/trends.ts
 /**

package/tools/triage-brief.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { formatTriageEffect } from "@vitest-agent/sdk";
 import { Effect, Schema } from "effect";
+import { formatTriageEffect } from "@vitest-agent/sdk";
 
 //#region src/tools/triage-brief.ts
 /**

package/tools/turn-search.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { DataReader } from "@vitest-agent/sdk";
 import { Effect, Schema, SchemaGetter } from "effect";
+import { DataReader } from "@vitest-agent/sdk";
 
 //#region src/tools/turn-search.ts
 /**

package/tools/wrapup-prompt.js

@@ -1,6 +1,6 @@
 import { publicProcedure } from "../context.js";
-import { formatWrapupEffect } from "@vitest-agent/sdk";
 import { Effect, Schema } from "effect";
+import { formatWrapupEffect } from "@vitest-agent/sdk";
 
 //#region src/tools/wrapup-prompt.ts
 /**