@vitest-agent/mcp 2.0.13 → 2.1.0

package/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/mcp",
-	"version": "2.0.13",
+	"version": "2.1.0",
 	"private": false,
 	"description": "Model Context Protocol server for vitest-agent. Exposes 53 tools for agent access to test data, TDD lifecycle, and session management.",
 	"keywords": [
@@ -38,12 +38,12 @@
 		"vitest-agent-mcp": "bin/vitest-agent-mcp.js"
 	},
 	"dependencies": {
-		"@effect/platform-node": "4.0.0-beta.101",
-		"@effect/sql-sqlite-node": "4.0.0-beta.101",
+		"@effect/platform-node": "4.0.0-beta.107",
+		"@effect/sql-sqlite-node": "4.0.0-beta.107",
 		"@modelcontextprotocol/sdk": "^1.30.0",
 		"@trpc/server": "^11.18.0",
-		"@vitest-agent/sdk": "2.0.13",
-		"effect": "4.0.0-beta.101",
+		"@vitest-agent/sdk": "2.0.15",
+		"effect": "4.0.0-beta.107",
 		"zod": "^4.4.3"
 	},
 	"peerDependencies": {

package/tools/acceptance-metrics.js

@@ -17,33 +17,33 @@ const totalAnnotation = { description: "Sample size — number of observations t
 const ratioAnnotation = { description: "Compliance ratio in [0, 1]. Multiply by 100 for the percentage form rendered in the markdown view." };
 const AcceptanceMetricsResult = Schema.Struct({
 	phaseEvidenceIntegrity: Schema.Struct({
-		total: Schema.Number.annotate(totalAnnotation),
-		compliant: Schema.Number.annotate({ description: "Phase transitions that cited a valid artifact and passed binding-rule validation." }),
-		ratio: Schema.Number.annotate(ratioAnnotation)
+		total: Schema.Finite.annotate(totalAnnotation),
+		compliant: Schema.Finite.annotate({ description: "Phase transitions that cited a valid artifact and passed binding-rule validation." }),
+		ratio: Schema.Finite.annotate(ratioAnnotation)
 	}).annotate({
 		title: "Phase-evidence integrity",
 		description: "Fraction of accepted TDD phase transitions whose cited artifact satisfied the D2 binding rules. Spec target ≥80%."
 	}),
 	complianceHookResponsiveness: Schema.Struct({
-		total: Schema.Number.annotate(totalAnnotation),
-		withFollowup: Schema.Number.annotate({ description: "PreToolUse denials / `additionalContext` reminders the orchestrator acknowledged in the next turn." }),
-		ratio: Schema.Number.annotate(ratioAnnotation)
+		total: Schema.Finite.annotate(totalAnnotation),
+		withFollowup: Schema.Finite.annotate({ description: "PreToolUse denials / `additionalContext` reminders the orchestrator acknowledged in the next turn." }),
+		ratio: Schema.Finite.annotate(ratioAnnotation)
 	}).annotate({
 		title: "Compliance-hook responsiveness",
 		description: "Fraction of compliance signals from PreToolUse hooks the orchestrator acted on. Spec target ≥40%."
 	}),
 	orientationUsefulness: Schema.Struct({
-		total: Schema.Number.annotate(totalAnnotation),
-		referencedCount: Schema.Number.annotate({ description: "Sessions where `triage_brief` / `wrapup_prompt` content was referenced in subsequent decisions." }),
-		ratio: Schema.Number.annotate(ratioAnnotation)
+		total: Schema.Finite.annotate(totalAnnotation),
+		referencedCount: Schema.Finite.annotate({ description: "Sessions where `triage_brief` / `wrapup_prompt` content was referenced in subsequent decisions." }),
+		ratio: Schema.Finite.annotate(ratioAnnotation)
 	}).annotate({
 		title: "Orientation usefulness",
 		description: "Fraction of sessions where orientation prompts measurably steered orchestrator behaviour. Spec target ≥50%."
 	}),
 	antiPatternDetectionRate: Schema.Struct({
-		total: Schema.Number.annotate(totalAnnotation),
-		cleanSessions: Schema.Number.annotate({ description: "Sessions that produced no `tdd_artifacts(kind='test_weakened')` rows or DATABASE_BYPASS notes." }),
-		ratio: Schema.Number.annotate(ratioAnnotation)
+		total: Schema.Finite.annotate(totalAnnotation),
+		cleanSessions: Schema.Finite.annotate({ description: "Sessions that produced no `tdd_artifacts(kind='test_weakened')` rows or DATABASE_BYPASS notes." }),
+		ratio: Schema.Finite.annotate(ratioAnnotation)
 	}).annotate({
 		title: "Anti-pattern detection rate",
 		description: "Fraction of sessions free of weakening edits or sqlite3 bypass attempts. Spec target ≥95%."

package/tools/cache-health.js

@@ -18,7 +18,7 @@ import { Effect, Option, Schema, SchemaGetter } from "effect";
 const ManifestPresent = Schema.Struct({
 	manifestPresent: Schema.Literal(true).annotate({ description: "Discriminant — `true` when a cache manifest exists." }),
 	manifest: CacheManifest.annotate({ description: "Full cache manifest content as written by the reporter." }),
-	ageMs: Schema.Number.annotate({ description: "Milliseconds since the manifest was last updated. Computed at query time, not stored." }),
+	ageMs: Schema.Finite.annotate({ description: "Milliseconds since the manifest was last updated. Computed at query time, not stored." }),
 	stale: Schema.Boolean.annotate({ description: "Convenience flag — `true` when `ageMs` exceeds 24 hours, otherwise `false`." })
 }).annotate({
 	identifier: "CacheHealthPresent",

package/tools/commit-changes.js

@@ -29,7 +29,7 @@ const CommitRow = Schema.Struct({
 }).annotate({ identifier: "CommitRow" });
 const CommitChangesResult = Schema.Struct({
 	filterSha: Schema.optional(Schema.String).annotate({ description: "Echo of the optional `sha` filter the caller passed; absent when no filter was applied (recent commits returned)." }),
-	count: Schema.Number.annotate({ description: "Number of commit rows returned." }),
+	count: Schema.Finite.annotate({ description: "Number of commit rows returned." }),
 	commits: Schema.Array(CommitRow).annotate({ description: "Matching commits, newest first when `sha` was omitted; up to 20 rows." })
 }).annotate({
 	identifier: "CommitChangesResult",

package/tools/errors.js

@@ -22,7 +22,7 @@ import { Effect, Schema, SchemaGetter } from "effect";
 */
 /** One row in the structured `errors[]` array. */
 const TestErrorRow = Schema.Struct({
-	id: Schema.Number.annotate({
+	id: Schema.Finite.annotate({
 		title: "test_errors.id",
 		description: "Numeric primary key of this error row. Pass as `citedTestErrorId` when calling `hypothesis (action: record)`."
 	}),
@@ -57,7 +57,7 @@ const TestErrorsResult = Schema.Struct({
 		examples: ["playground", "@org/pkg"]
 	}),
 	errorName: Schema.optional(Schema.String).annotate({ description: "Echo of the optional `errorName` filter the caller passed; absent when no filter was applied." }),
-	count: Schema.Number.annotate({ description: "Total error rows in `errors`." }),
+	count: Schema.Finite.annotate({ description: "Total error rows in `errors`." }),
 	errors: Schema.Array(TestErrorRow).annotate({ description: "Errors from the most recent test run for this project, optionally filtered by `errorName`. Empty when no errors matched." })
 }).annotate({
 	identifier: "TestErrorsResult",

package/tools/failure-signature-get.js

@@ -22,7 +22,7 @@ const SignatureFound = Schema.Struct({
 	firstSeenRunId: Schema.NullOr(Schema.Number),
 	firstSeenAt: Schema.String,
 	lastSeenAt: Schema.NullOr(Schema.String),
-	occurrenceCount: Schema.Number.annotate({ description: "Total times this signature has been observed." }),
+	occurrenceCount: Schema.Finite.annotate({ description: "Total times this signature has been observed." }),
 	recentErrors: Schema.Array(RecentError)
 });
 const SignatureMissing = Schema.Struct({

package/tools/history.js

@@ -16,8 +16,8 @@ const FlakyTestRow = Schema.Struct({
 	fullName: Schema.String.annotate({ description: "Full hierarchical test name (`describe > it`)." }),
 	modulePath: Schema.String.annotate({ description: "Project-relative test module path -- disambiguates same-named tests across files." }),
 	project: Schema.String,
-	passCount: Schema.Number.annotate({ description: "Number of passing runs in the recent window." }),
-	failCount: Schema.Number.annotate({ description: "Number of failing runs in the recent window." }),
+	passCount: Schema.Finite.annotate({ description: "Number of passing runs in the recent window." }),
+	failCount: Schema.Finite.annotate({ description: "Number of failing runs in the recent window." }),
 	lastState: Schema.Literals(["passed", "failed"]).annotate({ description: "State of the most recent run." }),
 	lastTimestamp: Schema.String.annotate({ description: "ISO-8601 timestamp of the most recent run." })
 }).annotate({
@@ -28,7 +28,7 @@ const PersistentFailureRow = Schema.Struct({
 	fullName: Schema.String,
 	modulePath: Schema.String.annotate({ description: "Project-relative test module path -- disambiguates same-named tests across files." }),
 	project: Schema.String,
-	consecutiveFailures: Schema.Number.annotate({ description: "Length of the current uninterrupted failure streak." }),
+	consecutiveFailures: Schema.Finite.annotate({ description: "Length of the current uninterrupted failure streak." }),
 	firstFailedAt: Schema.String.annotate({ description: "ISO-8601 timestamp of the first failure in this streak." }),
 	lastFailedAt: Schema.String.annotate({ description: "ISO-8601 timestamp of the most recent failure." }),
 	lastErrorMessage: Schema.NullOr(Schema.String).annotate({ description: "Last error message reported by the failing test, when captured." })

package/tools/hypothesis.js

@@ -28,7 +28,7 @@ const HypothesisRowSchema = Schema.Struct({
 }).annotate({ identifier: "HypothesisRow" });
 const HypothesisRecordOk = Schema.Struct({
 	action: Schema.Literal("record"),
-	id: Schema.Number.annotate({ description: "Newly inserted hypothesis row primary key." })
+	id: Schema.Finite.annotate({ description: "Newly inserted hypothesis row primary key." })
 });
 const HypothesisValidateOk = Schema.Struct({ action: Schema.Literal("validate") });
 const HypothesisListOk = Schema.Struct({

package/tools/note.js

@@ -12,7 +12,7 @@ const NoteScope = Schema.Literals([
 	"note"
 ]);
 const NoteRowSchema = Schema.Struct({
-	id: Schema.Number.annotate({ description: "Note primary key." }),
+	id: Schema.Finite.annotate({ description: "Note primary key." }),
 	title: Schema.String,
 	content: Schema.String,
 	scope: NoteScope.annotate({ description: "`global` (project-agnostic), `project`, `module`, `suite`, `test` (scoped), or `note` (child note attached via `parentNoteId`)." }),
@@ -28,7 +28,7 @@ const NoteRowSchema = Schema.Struct({
 }).annotate({ identifier: "NoteRow" });
 const NoteCreateOk = Schema.Struct({
 	action: Schema.Literal("create"),
-	id: Schema.Number.annotate({ description: "Primary key of the newly inserted note." })
+	id: Schema.Finite.annotate({ description: "Primary key of the newly inserted note." })
 });
 const NoteListOk = Schema.Struct({
 	action: Schema.Literal("list"),

package/tools/tdd-artifact.js

@@ -24,7 +24,7 @@ const ArtifactKindSchema = Schema.Literals([
 	"test_weakened"
 ]);
 const TddArtifactRow = Schema.Struct({
-	id: Schema.Number.annotate({
+	id: Schema.Finite.annotate({
 		title: "tdd_artifacts.id",
 		description: "Pass as `citedArtifactId` to `tdd_phase_transition_request`."
 	}),

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

@@ -46,7 +46,7 @@ const RemediationSchema = Schema.Struct({
 const PhaseTransitionAccepted = Schema.Struct({
 	accepted: Schema.Literal(true).annotate({ description: "Discriminant — `true` when the transition was granted." }),
 	phase: phaseLiteral.annotate({ description: "Phase the session is now in (echo of `requestedPhase`)." }),
-	newPhaseId: Schema.Number.annotate({ description: "`tdd_phases.id` of the freshly opened row." }),
+	newPhaseId: Schema.Finite.annotate({ description: "`tdd_phases.id` of the freshly opened row." }),
 	previousPhaseId: Schema.NullOr(Schema.Number).annotate({ description: "`tdd_phases.id` of the phase that was closed (`null` for the first transition)." }),
 	citedArtifactId: Schema.optional(Schema.Number).annotate({ description: "Resolved `tdd_artifacts.id` actually used. Absent only for transitions that need no artifact (e.g. spike→red)." }),
 	citedArtifactSource: Schema.optional(Schema.Literals([

package/tools/turn-search.js

@@ -9,9 +9,9 @@ import { Effect, Schema, SchemaGetter } from "effect";
 * @packageDocumentation
 */
 const TurnRow = Schema.Struct({
-	id: Schema.Number.annotate({ description: "Numeric primary key of this turn row." }),
-	sessionId: Schema.Number.annotate({ description: "Owning `sessions.id` (integer FK)." }),
-	turnNo: Schema.Number.annotate({ description: "Turn ordinal within the session (1-based)." }),
+	id: Schema.Finite.annotate({ description: "Numeric primary key of this turn row." }),
+	sessionId: Schema.Finite.annotate({ description: "Owning `sessions.id` (integer FK)." }),
+	turnNo: Schema.Finite.annotate({ description: "Turn ordinal within the session (1-based)." }),
 	type: Schema.String.annotate({ description: "Turn category (`user_prompt`, `tool_call`, `tool_result`, `file_edit`, `hook_fire`, `note`, `hypothesis`)." }),
 	payload: Schema.String.annotate({ description: "Type-specific payload as a JSON-encoded string. Decode shape depends on `type`." }),
 	occurredAt: Schema.String.annotate({ description: "ISO-8601 timestamp the turn was recorded at." })
@@ -20,7 +20,7 @@ const TurnRow = Schema.Struct({
 	description: "One row from the turns log."
 });
 const TurnSearchResult = Schema.Struct({
-	count: Schema.Number.annotate({ description: "Number of matching turn rows returned." }),
+	count: Schema.Finite.annotate({ description: "Number of matching turn rows returned." }),
 	turns: Schema.Array(TurnRow).annotate({ description: "Matching turns ordered by `occurredAt` ascending." })
 }).annotate({
 	identifier: "TurnSearchResult",

package/utils/effect-to-zod.js

@@ -38,6 +38,17 @@ import { z } from "zod";
 * substitution, then drop `$defs`). The schemas don't use
 * `Schema.suspend`, so the substitution is acyclic.
 *
+* Annotation lifting: Effect lowers a checked numeric schema
+* (`Schema.Finite`, `Schema.Int`) to `{ type, allOf: [{ description }] }`
+* rather than putting the annotation on the node itself, and
+* `z.fromJSONSchema` preserves that nesting verbatim. A tool's
+* `outputSchema` would then advertise no description for the field. The
+* bridge therefore lifts annotation-only `allOf` members onto their
+* parent before handing the document to zod. Only the JSON Schema
+* annotation vocabulary is lifted -- a member carrying any constraint
+* keyword (`pattern`, `minimum`, ...) stays put so validation semantics
+* are never changed.
+*
 * MCP SDK constraint: `outputSchema` must normalise to a Zod object
 * schema (`normalizeObjectSchema` returns `undefined` for unions, then
 * `safeParseAsync(undefined, ...)` crashes with "Cannot read properties
@@ -67,6 +78,57 @@ const isObjectLike = (schema) => {
 };
 const REF_PREFIX = "#/$defs/";
 /**
+* The JSON Schema annotation vocabulary -- keywords that describe a
+* schema without constraining what it accepts. Only these are safe to
+* hoist out of an `allOf` member onto the parent node.
+*/
+const ANNOTATION_KEYWORDS = /* @__PURE__ */ new Set([
+	"title",
+	"description",
+	"examples",
+	"default",
+	"deprecated",
+	"readOnly",
+	"writeOnly",
+	"contentEncoding",
+	"contentMediaType"
+]);
+const isPlainObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+/**
+* Hoist the annotation keywords out of every `allOf` member onto
+* `node`, leaving each member's constraint keywords exactly where they
+* were. A member reduced to nothing is dropped, and `allOf` disappears
+* once every member has been consumed.
+*
+* Keys already present on the node win -- a nested annotation never
+* overwrites a more specific one -- and the first member to supply a
+* given key wins among siblings.
+*/
+const liftAnnotations = (node) => {
+	const members = node.allOf;
+	if (!Array.isArray(members)) return node;
+	const kept = [];
+	const lifted = {};
+	for (const member of members) {
+		if (!isPlainObject(member)) {
+			kept.push(member);
+			continue;
+		}
+		const constraints = {};
+		for (const [key, value] of Object.entries(member)) if (!ANNOTATION_KEYWORDS.has(key)) constraints[key] = value;
+		else if (!(key in node) && !(key in lifted)) lifted[key] = value;
+		if (Object.keys(constraints).length > 0) kept.push(constraints);
+	}
+	if (Object.keys(lifted).length === 0) return node;
+	const out = {
+		...node,
+		...lifted
+	};
+	if (kept.length > 0) out.allOf = kept;
+	else delete out.allOf;
+	return out;
+};
+/**
 * Walk a JSON Schema tree and replace every `$ref: "#/$defs/X"` node
 * with the contents of `$defs.X`, recursively. The `$defs` table is
 * dropped from the returned root.
@@ -87,7 +149,7 @@ const inlineAllRefs = (root) => {
 			if (k === "$defs") continue;
 			out[k] = visit(v);
 		}
-		return out;
+		return liftAnnotations(out);
 	};
 	return visit(root);
 };