@vitest-agent/sdk 8.0.0 → 9.0.0

package/utils/format-fatal-error.js

@@ -1,46 +0,0 @@
-import { Cause } from "effect";
-
-// src/utils/format-fatal-error.ts
-const ISSUE_URL = "https://github.com/spencerbeggs/vitest-agent/issues";
-const FIBER_FAILURE_CAUSE_KEY = Symbol.for("effect/Runtime/FiberFailure/Cause");
-/**
-* Format an unknown error into a human-readable string with issue URL.
-*
-* Extraction order:
-* 1. Effect Cause — use `Cause.pretty()` for full formatting
-* 2. Effect FiberFailure — extract Cause and use `Cause.pretty()`
-* 3. Plain Error — extract `.message` and `.stack`
-* 4. Unknown — `String(err)`
-*
-* @public
-*/
-function formatFatalError(err) {
-	let detail;
-	if (Cause.isCause(err)) detail = Cause.pretty(err);
-	else if (err != null && typeof err === "object" && FIBER_FAILURE_CAUSE_KEY in err) {
-		const cause = err[FIBER_FAILURE_CAUSE_KEY];
-		if (Cause.isCause(cause)) detail = Cause.pretty(cause);
-		else detail = String(err);
-	} else if (err instanceof Error) try {
-		detail = err.stack ?? err.message;
-	} catch {
-		let ctorName = "Error";
-		try {
-			ctorName = err.constructor?.name ?? "Error";
-		} catch {}
-		detail = `<unserializable ${ctorName}>`;
-	}
-	else if (err !== null && typeof err === "object") try {
-		detail = JSON.stringify(err, null, 2);
-	} catch {
-		try {
-			detail = String(err);
-		} catch {
-			detail = "<unserializable error>";
-		}
-	}
-	else detail = String(err);
-	return `${detail}\nPlease report at ${ISSUE_URL}`;
-}
-
-export { formatFatalError };

package/utils/format-gfm.js

@@ -1,160 +0,0 @@
-// src/utils/format-gfm.ts
-/**
-* Format a number as a percentage string.
-*
-* @internal
-*/
-function pct(n) {
-	return `${n}%`;
-}
-/**
-* Find the worst (lowest) coverage metric for a file.
-*
-* @internal
-*/
-function worstCoverage(f) {
-	return [
-		{
-			label: "Stmts",
-			pct: f.summary.statements
-		},
-		{
-			label: "Branch",
-			pct: f.summary.branches
-		},
-		{
-			label: "Funcs",
-			pct: f.summary.functions
-		},
-		{
-			label: "Lines",
-			pct: f.summary.lines
-		}
-	].reduce((worst, m) => m.pct < worst.pct ? m : worst);
-}
-/**
-* Format the body of a single project's GFM output.
-*
-* @internal
-*/
-function formatProjectBody(report) {
-	const lines = [];
-	if (report.failed.length > 0) {
-		lines.push("## Failed Tests");
-		lines.push("");
-		for (const mod of report.failed) {
-			lines.push(`### \`${mod.file}\``);
-			lines.push("");
-			if (mod.errors && mod.errors.length > 0) for (const err of mod.errors) {
-				lines.push(`> ${err.message}`);
-				if (err.diff) {
-					lines.push("");
-					lines.push("```diff");
-					lines.push(err.diff);
-					lines.push("```");
-				}
-				lines.push("");
-			}
-			const failedTests = mod.tests.filter((t) => t.state === "failed");
-			for (const test of failedTests) {
-				lines.push(`**${test.fullName}**`);
-				lines.push("");
-				if (test.errors && test.errors.length > 0) for (const err of test.errors) {
-					lines.push(`> ${err.message}`);
-					if (err.diff) {
-						lines.push("");
-						lines.push("```diff");
-						lines.push(err.diff);
-						lines.push("```");
-					}
-				}
-				lines.push("");
-			}
-		}
-	}
-	if (report.coverage) {
-		const cov = report.coverage;
-		lines.push("## Coverage");
-		lines.push("");
-		lines.push("| Metric | Coverage |");
-		lines.push("| --- | --- |");
-		lines.push(`| Statements | ${pct(cov.totals.statements)} |`);
-		lines.push(`| Branches | ${pct(cov.totals.branches)} |`);
-		lines.push(`| Functions | ${pct(cov.totals.functions)} |`);
-		lines.push(`| Lines | ${pct(cov.totals.lines)} |`);
-		lines.push("");
-		if (cov.lowCoverage.length > 0) {
-			const thresholdParts = [];
-			const g = cov.thresholds.global;
-			if (g.lines !== void 0) thresholdParts.push(`lines: ${g.lines}%`);
-			if (g.functions !== void 0) thresholdParts.push(`functions: ${g.functions}%`);
-			if (g.branches !== void 0) thresholdParts.push(`branches: ${g.branches}%`);
-			if (g.statements !== void 0) thresholdParts.push(`statements: ${g.statements}%`);
-			const thresholdDisplay = thresholdParts.length > 0 ? thresholdParts.join(", ") : "configured thresholds";
-			lines.push("> [!WARNING]");
-			lines.push(`> ${cov.lowCoverage.length} file(s) below coverage threshold (${thresholdDisplay}):`);
-			lines.push(">");
-			for (const f of cov.lowCoverage) {
-				const worst = worstCoverage(f);
-				lines.push(`> - \`${f.file}\` — ${worst.label} ${pct(worst.pct)}`);
-			}
-			lines.push("");
-		}
-	}
-	return lines;
-}
-/**
-* Format one or more {@link (AgentReport:variable) | AgentReports} as a GitHub-Flavored
-* Markdown string for writing to `GITHUB_STEP_SUMMARY`.
-*
-* @remarks
-* GFM-specific features used in the output:
-*
-* - **Summary table** with pass/fail counts across all projects
-* - **Collapsible `<details>` blocks** for per-project results in monorepo setups
-* - **Tables** for coverage metrics
-* - **Diff-fenced code blocks** for expected/received comparison output
-* - **GitHub Alert callouts** (`[!WARNING]`) for coverage threshold violations
-*
-* For a single report, the project body is rendered directly without
-* a `<details>` wrapper. For multiple reports (monorepo), each project
-* gets its own collapsible section with a status icon in the summary line.
-*
-* @param reports - One or more agent reports to format
-* @returns GFM-formatted string ready for appending to `GITHUB_STEP_SUMMARY`
-*
-* @public
-*/
-function formatGfm(reports) {
-	const lines = [];
-	const headerIcon = reports.some((r) => r.summary.failed > 0) ? "❌" : "✅";
-	lines.push(`# ${headerIcon} Vitest Results`);
-	lines.push("");
-	const totalPassed = reports.reduce((acc, r) => acc + r.summary.passed, 0);
-	const totalFailed = reports.reduce((acc, r) => acc + r.summary.failed, 0);
-	const totalTests = reports.reduce((acc, r) => acc + r.summary.total, 0);
-	lines.push("| | Count |");
-	lines.push("| --- | --- |");
-	lines.push(`| Passed | **${totalPassed}** |`);
-	lines.push(`| Failed | **${totalFailed}** |`);
-	lines.push(`| Total | **${totalTests}** |`);
-	lines.push("");
-	if (reports.length > 1) for (const report of reports) {
-		const projectLabel = report.project ?? "default";
-		const statusIcon = report.summary.failed > 0 ? "❌" : "✅";
-		lines.push(`<details>`);
-		lines.push(`<summary>${statusIcon} ${projectLabel}</summary>`);
-		lines.push("");
-		const bodyLines = formatProjectBody(report);
-		lines.push(...bodyLines);
-		lines.push("</details>");
-		lines.push("");
-	}
-	else if (reports.length === 1) {
-		const bodyLines = formatProjectBody(reports[0]);
-		lines.push(...bodyLines);
-	}
-	return lines.join("\n");
-}
-
-export { formatGfm };

package/utils/normalize-workspace-key.js

@@ -1,33 +0,0 @@
-// src/utils/normalize-workspace-key.ts
-/**
-* Normalize a workspace name into a filesystem-safe directory segment.
-*
-* The workspace key drives the per-project subdirectory under the XDG data
-* directory (e.g. `$XDG_DATA_HOME/vitest-agent/<key>/data.db`). The
-* key must be deterministic for a given input and safe to use as a single
-* path segment on macOS, Linux, and Windows.
-*
-* Rules (applied in order):
-*
-* 1. Replace `/` with `__` so scoped names like `@org/pkg` collapse to
-*    `@org__pkg` rather than introducing a subdirectory boundary. Scoped
-*    npm names contain at most one `/` (between scope and name), and
-*    leading-`@` requires the scope/name form, so `@org__pkg` is not a
-*    valid unscoped npm name -- the `__` token is unambiguous in
-*    practice.
-* 2. Replace any character outside `[A-Za-z0-9._@-]` with `_`. This catches
-*    Windows-reserved characters (`\`, `:`, `*`, `?`, `"`, `<`, `>`, `|`),
-*    control characters, whitespace, and anything else that varies in
-*    interpretation across filesystems.
-* 3. Collapse runs of underscores produced by the substitution above into a
-*    single `_` so the output stays compact.
-*
-* @param name - The raw `name` field from a workspace's `package.json`.
-* @returns A filesystem-safe single path segment.
-* @public
-*/
-function normalizeWorkspaceKey(name) {
-	return name.replaceAll("/", "__").replace(/[^A-Za-z0-9._@-]/g, "_").replace(/_{3,}/g, "__");
-}
-
-export { normalizeWorkspaceKey };

package/utils/probe-host-metadata.js

@@ -1,98 +0,0 @@
-// src/utils/probe-host-metadata.ts
-const isUseful = (value) => value !== void 0 && value.length > 0;
-/**
-* Walk the priority chain of env-var probes. Returns the first match
-* along with any decorating metadata (`term_program`, `ci_provider`,
-* etc.) for that source. When no probe matches, `source`/`value`/
-* `metadata` are all `null`.
-*
-* The probe order matches the plan's table exactly:
-*
-* 1. `TMUX_PANE` (tmux reattach-stable)
-* 2. `WT_SESSION` (Windows Terminal pane)
-* 3. `WEZTERM_PANE` (WezTerm pane)
-* 4. `KITTY_WINDOW_ID` (kitty window)
-* 5. `TERM_SESSION_ID` (iTerm2, Terminal.app)
-* 6. `VSCODE_INJECTION` + `process.ppid` (handled by the Live layer
-*    since it needs `process.ppid`, not env)
-* 7. `GITHUB_RUN_ID` + `GITHUB_RUN_ATTEMPT`
-* 8. `BUILDKITE_JOB_ID` / `CIRCLE_BUILD_NUM` / `GITLAB_CI_JOB_ID`
-* 9. `process.ppid` walk (handled by the Live layer)
-* @public
-*/
-const probeHostMetadataFromEnv = (env) => {
-	const decoration = (extra) => {
-		const baseDecoration = {};
-		if (isUseful(env.TERM_PROGRAM)) baseDecoration.term_program = env.TERM_PROGRAM;
-		if (isUseful(env.TERM_PROGRAM_VERSION)) baseDecoration.term_program_version = env.TERM_PROGRAM_VERSION;
-		return {
-			...baseDecoration,
-			...extra
-		};
-	};
-	if (isUseful(env.TMUX_PANE)) return {
-		source: "TMUX_PANE",
-		value: env.TMUX_PANE,
-		metadata: decoration(isUseful(env.TMUX) ? { tmux_socket: env.TMUX } : {})
-	};
-	if (isUseful(env.WT_SESSION)) return {
-		source: "WT_SESSION",
-		value: env.WT_SESSION,
-		metadata: decoration({})
-	};
-	if (isUseful(env.WEZTERM_PANE)) return {
-		source: "WEZTERM_PANE",
-		value: env.WEZTERM_PANE,
-		metadata: decoration({})
-	};
-	if (isUseful(env.KITTY_WINDOW_ID)) return {
-		source: "KITTY_WINDOW_ID",
-		value: env.KITTY_WINDOW_ID,
-		metadata: decoration({})
-	};
-	if (isUseful(env.TERM_SESSION_ID)) return {
-		source: "TERM_SESSION_ID",
-		value: env.TERM_SESSION_ID,
-		metadata: decoration({})
-	};
-	if (isUseful(env.GITHUB_RUN_ID)) return {
-		source: "GITHUB_RUN_ID",
-		value: env.GITHUB_RUN_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "github",
-			...isUseful(env.GITHUB_RUN_ATTEMPT) ? { github_run_attempt: env.GITHUB_RUN_ATTEMPT } : {}
-		})
-	};
-	if (isUseful(env.BUILDKITE_JOB_ID)) return {
-		source: "BUILDKITE_JOB_ID",
-		value: env.BUILDKITE_JOB_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "buildkite"
-		})
-	};
-	if (isUseful(env.CIRCLE_BUILD_NUM)) return {
-		source: "CIRCLE_BUILD_NUM",
-		value: env.CIRCLE_BUILD_NUM,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "circle"
-		})
-	};
-	if (isUseful(env.GITLAB_CI_JOB_ID)) return {
-		source: "GITLAB_CI_JOB_ID",
-		value: env.GITLAB_CI_JOB_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "gitlab"
-		})
-	};
-	return {
-		source: null,
-		value: null,
-		metadata: null
-	};
-};
-
-export { probeHostMetadataFromEnv };

package/utils/safe-filename.js

@@ -1,33 +0,0 @@
-// src/utils/safe-filename.ts
-/**
-* Convert a project name to a filesystem-safe filename.
-*
-* Replaces `/` and `:` characters with `__` (double underscore).
-* Returns `"default"` for empty strings, which is used as the
-* fallback project name for single-repo configurations.
-*
-* @param name - Project name to sanitize
-* @returns Filesystem-safe filename string
-*
-* @example
-* ```typescript
-* import { safeFilename } from "@vitest-agent/sdk/utils";
-*
-* safeFilename("\@savvy-web/my-lib:unit");
-* // Returns: "\@savvy-web__my-lib__unit"
-*
-* safeFilename("core");
-* // Returns: "core"
-*
-* safeFilename("");
-* // Returns: "default"
-* ```
-*
-* @public
-*/
-function safeFilename(name) {
-	if (!name) return "default";
-	return name.replace(/[/:]/g, "__");
-}
-
-export { safeFilename };