@vitest-agent/sdk 3.1.2 → 4.0.0

package/layers/ProjectIdentityLive.js

@@ -1,96 +0,0 @@
-import { ProjectIdentityNotResolvableError } from "../errors/ProjectIdentityError.js";
-import { VitestAgentConfig } from "../schemas/Config.js";
-import { VitestAgentConfigFile } from "../services/Config.js";
-import { ProjectIdentity, resolveProjectIdentityFromCandidates } from "../services/ProjectIdentity.js";
-import { Effect, FileSystem, Layer, Option } from "effect";
-import { WorkspaceDiscovery } from "@effected/workspaces";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-
-//#region src/layers/ProjectIdentityLive.ts
-const readGitRemote = (cwd) => Effect.gen(function* () {
-	const trimmed = (yield* (yield* ChildProcessSpawner.ChildProcessSpawner).string(ChildProcess.make("git", [
-		"config",
-		"--get",
-		"remote.origin.url"
-	]).pipe(ChildProcess.setCwd(cwd)))).trim();
-	return trimmed.length > 0 ? Option.some(trimmed) : Option.none();
-}).pipe(Effect.catch(() => Effect.succeed(Option.none())));
-const readPackageRepoUrl = (packageJsonPath) => Effect.gen(function* () {
-	const raw = yield* (yield* FileSystem.FileSystem).readFileString(packageJsonPath).pipe(Effect.catch(() => Effect.succeed("")));
-	if (raw.length === 0) return Option.none();
-	try {
-		const repo = JSON.parse(raw).repository;
-		if (typeof repo === "string" && repo.trim().length > 0) return Option.some(repo.trim());
-		if (repo !== null && typeof repo === "object" && "url" in repo && typeof repo.url === "string") {
-			const url = repo.url.trim();
-			return url.length > 0 ? Option.some(url) : Option.none();
-		}
-	} catch {}
-	return Option.none();
-});
-const collectCandidates = (workspaceRoot, options) => Effect.gen(function* () {
-	const tomlConfig = yield* (yield* VitestAgentConfigFile).loadOrDefault(new VitestAgentConfig({})).pipe(Effect.catch(() => Effect.succeed(new VitestAgentConfig({}))));
-	const gitRemote = yield* readGitRemote(workspaceRoot);
-	const root = (yield* (yield* WorkspaceDiscovery).listPackagesIn(workspaceRoot).pipe(Effect.catch(() => Effect.succeed([])))).find((pkg) => pkg.isRootWorkspace);
-	const packageJsonRepoUrl = root ? yield* readPackageRepoUrl(root.packageJsonPath) : Option.none();
-	const candidates = {};
-	if (options.projectId !== void 0) candidates.explicit = options.projectId;
-	if (tomlConfig.projectKey !== void 0) candidates.toml = tomlConfig.projectKey;
-	const remoteValue = Option.getOrUndefined(gitRemote);
-	if (remoteValue !== void 0) candidates.gitRemote = remoteValue;
-	const repoUrlValue = Option.getOrUndefined(packageJsonRepoUrl);
-	if (repoUrlValue !== void 0) candidates.packageJsonRepoUrl = repoUrlValue;
-	if (root?.name !== void 0) candidates.packageJsonName = root.name;
-	return candidates;
-});
-const candidatesToTriedList = (candidates) => [
-	{
-		source: "explicit",
-		reason: candidates.explicit ? "value rejected by normalizer" : "not provided in plugin options"
-	},
-	{
-		source: "toml",
-		reason: candidates.toml ? "value rejected by normalizer" : "not configured in vitest-agent.config.toml"
-	},
-	{
-		source: "git-remote",
-		reason: candidates.gitRemote ? "URL not canonicalizable" : "git command produced no remote.origin.url"
-	},
-	{
-		source: "package-repository",
-		reason: candidates.packageJsonRepoUrl ? "URL not canonicalizable" : "no repository.url in root package.json"
-	},
-	{
-		source: "package-name",
-		reason: candidates.packageJsonName ? "value rejected by normalizer" : "no name in root package.json"
-	}
-];
-/**
-* Live layer that wires the resolver into real I/O. Requires
-* `FileSystem`, `CommandExecutor`, `WorkspaceDiscovery`, and
-* `VitestAgentConfigFile`. The platform context comes from
-* `NodeServices.layer` at the entry point.
-* @public
-*/
-const ProjectIdentityLive = Layer.effect(ProjectIdentity, Effect.gen(function* () {
-	const fs = yield* FileSystem.FileSystem;
-	const discovery = yield* WorkspaceDiscovery;
-	const configFile = yield* VitestAgentConfigFile;
-	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-	return { resolve: (workspaceRoot, options = {}) => collectCandidates(workspaceRoot, options).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(WorkspaceDiscovery, discovery), Effect.provideService(VitestAgentConfigFile, configFile), Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner), Effect.flatMap((candidates) => {
-		const result = resolveProjectIdentityFromCandidates(candidates);
-		if (result === null) return Effect.fail(new ProjectIdentityNotResolvableError({ tried: candidatesToTriedList(candidates) }));
-		return Effect.succeed(result);
-	})) };
-}));
-/**
-* Build a Test layer that returns a fixed `ResolvedIdentity` (or
-* fails with `ProjectIdentityNotResolvableError`). Use in unit tests
-* that depend on `ProjectIdentity` but don't want to wire upstream
-* services.
-* @public
-*/
-const ProjectIdentityTest = (result) => Layer.succeed(ProjectIdentity, { resolve: () => result instanceof ProjectIdentityNotResolvableError ? Effect.fail(result) : Effect.succeed(result) });
-
-//#endregion
-export { ProjectIdentityLive, ProjectIdentityTest };

package/layers/RunContextLive.js

@@ -1,81 +0,0 @@
-import { AgentContext, RunContext, RunContextService } from "../services/RunContext.js";
-import { probeHostMetadataFromEnv } from "../utils/probe-host-metadata.js";
-import { Effect, Layer, Option } from "effect";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-
-//#region src/layers/RunContextLive.ts
-const runGit = (spawner, cwd, args) => spawner.string(ChildProcess.make("git", args).pipe(ChildProcess.setCwd(cwd))).pipe(Effect.map((output) => {
-	const trimmed = output.trim();
-	return trimmed.length > 0 ? Option.some(trimmed) : Option.none();
-}), Effect.catch(() => Effect.succeed(Option.none())));
-const captureRunContextEffect = (cwd, spawner, env) => Effect.gen(function* () {
-	const branch = yield* runGit(spawner, cwd, [
-		"rev-parse",
-		"--abbrev-ref",
-		"HEAD"
-	]);
-	const sha = yield* runGit(spawner, cwd, ["rev-parse", "HEAD"]);
-	const dirtyOut = yield* runGit(spawner, cwd, ["status", "--porcelain"]);
-	const upstream = yield* runGit(spawner, cwd, [
-		"rev-parse",
-		"--abbrev-ref",
-		"@{upstream}"
-	]);
-	const worktree = yield* runGit(spawner, cwd, ["rev-parse", "--show-toplevel"]);
-	const dirtyValue = Option.match(dirtyOut, {
-		onNone: () => null,
-		onSome: (out) => out.length > 0
-	});
-	const host = probeHostMetadataFromEnv(env);
-	return new RunContext({
-		gitBranch: Option.getOrNull(branch),
-		gitCommitSha: Option.getOrNull(sha),
-		gitDirty: dirtyValue,
-		gitUpstream: Option.getOrNull(upstream),
-		gitWorktreeDir: Option.getOrNull(worktree),
-		hostSource: host.source,
-		hostValue: host.value,
-		hostMetadata: host.metadata
-	});
-});
-const captureAgentContextEffect = (cwd, spawner) => Effect.gen(function* () {
-	const branch = yield* runGit(spawner, cwd, [
-		"rev-parse",
-		"--abbrev-ref",
-		"HEAD"
-	]);
-	const sha = yield* runGit(spawner, cwd, ["rev-parse", "HEAD"]);
-	const worktree = yield* runGit(spawner, cwd, ["rev-parse", "--show-toplevel"]);
-	return new AgentContext({
-		startGitBranch: Option.getOrNull(branch),
-		startGitCommitSha: Option.getOrNull(sha),
-		startWorktreeDir: Option.getOrNull(worktree)
-	});
-});
-/**
-* Live layer. Requires `ChildProcessSpawner` (provided by
-* `NodeServices.layer` at the entry point). Reads `process.env`
-* directly for host-metadata probes — the env walk is pure but the
-* env source is process-global, captured once when the layer
-* constructs.
-* @public
-*/
-const RunContextLive = Layer.effect(RunContextService, Effect.gen(function* () {
-	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-	return {
-		captureRunContext: (cwd) => captureRunContextEffect(cwd, spawner, process.env),
-		captureAgentContext: (cwd) => captureAgentContextEffect(cwd, spawner)
-	};
-}));
-/**
-* Build a Test layer that returns fixed `RunContext` and
-* `AgentContext` values regardless of `cwd`.
-* @public
-*/
-const RunContextTest = (fixture) => Layer.succeed(RunContextService, {
-	captureRunContext: () => Effect.succeed(fixture.runContext),
-	captureAgentContext: () => Effect.succeed(fixture.agentContext)
-});
-
-//#endregion
-export { RunContextLive, RunContextTest };

package/lib/format-triage.js

@@ -1,103 +0,0 @@
-import { DataReader } from "../services/DataReader.js";
-import { Effect, Option } from "effect";
-
-//#region src/lib/format-triage.ts
-/**
-* Generates an orientation triage markdown string for LLM agents.
-* Summarises recent test runs, active sessions, acceptance metrics,
-* and (forward-compat) the most recent TDD session.
-*
-* Error channel is `never` — all DataReader errors are swallowed and
-* replaced with empty defaults so the caller is guaranteed a string.
-* @public
-*/
-const formatTriageEffect = (options = {}) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const allProjects = yield* reader.getRunsByProject().pipe(Effect.orElseSucceed(() => []));
-	const projects = options.project ? allProjects.filter((p) => p.project === options.project) : allProjects;
-	const sessions = yield* reader.listSessions({}).pipe(Effect.orElseSucceed(() => []));
-	const fallbackMetrics = {
-		phaseEvidenceIntegrity: {
-			total: 0,
-			compliant: 0,
-			ratio: 0
-		},
-		complianceHookResponsiveness: {
-			total: 0,
-			withFollowup: 0,
-			ratio: 0
-		},
-		orientationUsefulness: {
-			total: 0,
-			referencedCount: 0,
-			ratio: 0
-		},
-		antiPatternDetectionRate: {
-			total: 0,
-			cleanSessions: 0,
-			ratio: 0
-		}
-	};
-	const metrics = yield* reader.computeAcceptanceMetrics().pipe(Effect.orElseSucceed(() => fallbackMetrics));
-	const openTddRaw = yield* reader.getTddTaskById(1).pipe(Effect.orElseSucceed(() => Option.none()));
-	const lines = [];
-	lines.push("## Vitest Agent Reporter — Orientation Triage");
-	lines.push("");
-	lines.push("### Available vitest-agent MCP tools (most useful)");
-	lines.push("");
-	lines.push("- `run_tests` — run Vitest programmatically; returns AgentReport + classifications");
-	lines.push("- `test_errors` — failure detail (after a failing run)");
-	lines.push("- `test_history` — failure classification series (after recurring failures)");
-	lines.push("- `file_coverage` — per-file coverage gaps (after coverage drops)");
-	lines.push("- `triage_brief` — orient on the current test landscape");
-	lines.push("");
-	if (projects.length > 0) {
-		lines.push("### Recent Test Runs");
-		lines.push("");
-		for (const p of projects) {
-			const status = p.lastResult ?? "unknown";
-			const counts = `${p.passed} passed, ${p.failed} failed`;
-			lines.push(`- **${p.project}** — ${status} (${counts})`);
-		}
-		lines.push("");
-	} else {
-		lines.push("### Recent Test Runs");
-		lines.push("");
-		lines.push("_No test runs recorded yet._");
-		lines.push("");
-	}
-	lines.push("### Session Log");
-	lines.push("");
-	if (sessions.length > 0) for (const s of sessions) {
-		const end = s.endedAt ? ` → ended ${s.endedAt}` : " → active";
-		lines.push(`- session \`${s.chatId}\` (${s.agentKind}) started ${s.startedAt}${end}`);
-	}
-	else lines.push("_No session data recorded yet._");
-	lines.push("");
-	lines.push("### Acceptance Metrics");
-	lines.push("");
-	const pct = (r) => `${(r * 100).toFixed(0)}%`;
-	lines.push(`- Phase evidence integrity: ${pct(metrics.phaseEvidenceIntegrity.ratio)} (${metrics.phaseEvidenceIntegrity.compliant}/${metrics.phaseEvidenceIntegrity.total})`);
-	lines.push(`- Compliance hook responsiveness: ${pct(metrics.complianceHookResponsiveness.ratio)} (${metrics.complianceHookResponsiveness.withFollowup}/${metrics.complianceHookResponsiveness.total})`);
-	lines.push(`- Orientation usefulness: ${pct(metrics.orientationUsefulness.ratio)} (${metrics.orientationUsefulness.referencedCount}/${metrics.orientationUsefulness.total})`);
-	lines.push(`- Anti-pattern detection: ${pct(metrics.antiPatternDetectionRate.ratio)} (${metrics.antiPatternDetectionRate.cleanSessions}/${metrics.antiPatternDetectionRate.total})`);
-	lines.push("");
-	if (Option.isSome(openTddRaw)) {
-		const tdd = openTddRaw.value;
-		lines.push("### Open TDD Session");
-		lines.push("");
-		lines.push(`- Goal: ${tdd.goal}`);
-		lines.push(`- Started: ${tdd.startedAt}`);
-		lines.push(`- Phases recorded: ${tdd.phases.length}`);
-		lines.push("");
-	}
-	const out = lines.join("\n");
-	if (options.maxLines !== void 0) {
-		const arr = out.split("\n");
-		if (arr.length > options.maxLines) return arr.slice(0, options.maxLines).join("\n");
-	}
-	return out;
-});
-
-//#endregion
-export { formatTriageEffect };

package/lib/format-wrapup.js

@@ -1,67 +0,0 @@
-import { DataReader } from "../services/DataReader.js";
-import { Effect, Option } from "effect";
-
-//#region src/lib/format-wrapup.ts
-const FAILURE_PROMPT_PATTERN = /\b(?:test fail|fix\b[^.]*\btest|why\b[^.]*\bfail(?:ing)?|broken test)\b/i;
-/** @public */
-const formatWrapupEffect = (options) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	if (options.kind === "user_prompt_nudge") {
-		const hint = options.userPromptHint ?? "";
-		if (!FAILURE_PROMPT_PATTERN.test(hint)) return "";
-		return [
-			"<vitest-agent-nudge>",
-			"Before fixing, consider checking with test_history (is this flaky?) and failure_signature_get (have we seen this failure before?).",
-			"</vitest-agent-nudge>"
-		].join("\n");
-	}
-	let sessionId = null;
-	let agentKind = "main";
-	if (options.sessionId !== void 0) {
-		sessionId = options.sessionId;
-		const opt = yield* reader.getSessionById(options.sessionId).pipe(Effect.orElseSucceed(() => Option.none()));
-		if (Option.isSome(opt)) agentKind = opt.value.agentKind;
-	} else if (options.chatId !== void 0) {
-		const opt = yield* reader.getSessionByChatId(options.chatId).pipe(Effect.orElseSucceed(() => Option.none()));
-		if (Option.isSome(opt)) {
-			sessionId = opt.value.id;
-			agentKind = opt.value.agentKind;
-		}
-	}
-	if (options.kind === "tdd_handoff") {
-		if (sessionId === null) return "";
-		const tddOpt = yield* reader.getTddTaskById(1).pipe(Effect.orElseSucceed(() => Option.none()));
-		if (Option.isNone(tddOpt) || tddOpt.value.sessionId !== sessionId) return "";
-		const tdd = tddOpt.value;
-		return [
-			`Subagent tdd-orchestrator (tddTaskId=${tdd.id}) finished.`,
-			`Outcome: ${tdd.outcome ?? "in progress"}. Goal: "${tdd.goal}".`,
-			`Phases: ${tdd.phases.length}. Artifacts: ${tdd.artifacts.length}.`,
-			`[Read full summary: tdd_task({ action: "get", tddTaskId: ${tdd.id} })]`,
-			`[Resume: /tdd resume:${tdd.id}]`
-		].join("\n");
-	}
-	if (sessionId === null) return "";
-	const fileEditCount = (yield* reader.searchTurns({
-		sessionId,
-		limit: 50
-	}).pipe(Effect.orElseSucceed(() => []))).filter((t) => t.type === "file_edit").length;
-	const openHypotheses = (yield* reader.listHypotheses({
-		sessionId,
-		limit: 50
-	}).pipe(Effect.orElseSucceed(() => []))).filter((h) => h.validationOutcome === null);
-	if (fileEditCount === 0 && openHypotheses.length === 0) return "";
-	const isSubagent = agentKind === "subagent";
-	const lines = [];
-	if (isSubagent) {
-		if (fileEditCount > 0 && openHypotheses.length === 0) lines.push(`- ${fileEditCount} recent file edit${fileEditCount === 1 ? "" : "s"} but no hypotheses recorded. Did your changes have a hypothesis? Use \`hypothesis({ action: "record" })\` to externalize the why before continuing.`);
-		if (openHypotheses.length > 0) lines.push(`- ${openHypotheses.length} open hypothesis(es). Use \`hypothesis({ action: "validate", id, outcome: "confirmed"|"refuted"|"abandoned" })\` to mark them.`);
-	}
-	if (options.kind === "session_end") lines.push("- Use `note({ action: \"create\" })` to record any insights worth carrying forward.");
-	if (options.kind === "pre_compact") lines.push("- What from this session matters next? Record it now via `note({ action: \"create\" })` before context compaction.");
-	if (lines.length === 0) return "";
-	return [options.kind === "stop" ? "## Before you finish" : "## Session wrap-up", ...lines].join("\n");
-});
-
-//#endregion
-export { formatWrapupEffect };