@vitest-agent/sdk 8.0.0 → 9.0.0

package/index.d.ts

@@ -1118,6 +1118,85 @@ export declare const ReportError: Schema.Struct<{
 }>;
 /** @public */
 export type ReportError = typeof ReportError.Type;
+/**
+ * Which Vitest performance diagnostic a hint came from.
+ * @public
+ */
+export declare const PerformanceHintKind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+/** @public */
+export type PerformanceHintKind = typeof PerformanceHintKind.Type;
+/**
+ * One performance hint derived from Vitest's run diagnostics. `project` is
+ * omitted for a hint that applies to the whole run (for example `isolate`).
+ * @public
+ */
+export declare const PerformanceHint: Schema.Struct<{
+  readonly kind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+  readonly project: Schema.optionalKey<Schema.String>;
+  readonly message: Schema.String;
+  readonly remedy: Schema.String;
+  readonly detail: Schema.String;
+  readonly learnMoreUrl: Schema.String;
+  readonly estimatedSavingMs: Schema.optionalKey<Schema.Finite>;
+  readonly share: Schema.optionalKey<Schema.Finite>;
+}>;
+/** @public */
+export type PerformanceHint = typeof PerformanceHint.Type;
+/**
+ * Wall-clock timing of the plugin's post-run work, in milliseconds.
+ * @public
+ */
+export declare const PostRunTiming: Schema.Struct<{
+  readonly persistMs: Schema.Finite;
+  readonly coverageScanMs: Schema.Finite;
+  readonly totalMs: Schema.Finite;
+  readonly renderMs: Schema.optionalKey<Schema.Finite>;
+  readonly vitestDurationMs: Schema.optionalKey<Schema.Finite>;
+}>;
+/** @public */
+export type PostRunTiming = typeof PostRunTiming.Type;
+/**
+ * Whether the run's results were persisted to the database.
+ * @public
+ */
+export declare const PersistenceStatus: Schema.Struct<{
+  readonly ok: Schema.Boolean;
+  readonly reason: Schema.optionalKey<Schema.String>;
+  readonly migrationFailed: Schema.optionalKey<Schema.Boolean>;
+}>;
+/** @public */
+export type PersistenceStatus = typeof PersistenceStatus.Type;
+/**
+ * Run-level diagnostics: performance hints, post-run timing and persistence
+ * status (issue #544).
+ * @public
+ */
+export declare const RunDiagnostics: Schema.Struct<{
+  readonly performanceHints: Schema.$Array<Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+    readonly project: Schema.optionalKey<Schema.String>;
+    readonly message: Schema.String;
+    readonly remedy: Schema.String;
+    readonly detail: Schema.String;
+    readonly learnMoreUrl: Schema.String;
+    readonly estimatedSavingMs: Schema.optionalKey<Schema.Finite>;
+    readonly share: Schema.optionalKey<Schema.Finite>;
+  }>>;
+  readonly postRun: Schema.optionalKey<Schema.Struct<{
+    readonly persistMs: Schema.Finite;
+    readonly coverageScanMs: Schema.Finite;
+    readonly totalMs: Schema.Finite;
+    readonly renderMs: Schema.optionalKey<Schema.Finite>;
+    readonly vitestDurationMs: Schema.optionalKey<Schema.Finite>;
+  }>>;
+  readonly persistence: Schema.optionalKey<Schema.Struct<{
+    readonly ok: Schema.Boolean;
+    readonly reason: Schema.optionalKey<Schema.String>;
+    readonly migrationFailed: Schema.optionalKey<Schema.Boolean>;
+  }>>;
+}>;
+/** @public */
+export type RunDiagnostics = typeof RunDiagnostics.Type;
 /**
  * Coverage metric whose threshold can be violated independently.
  * @public
@@ -1687,6 +1766,8 @@ export interface ReporterRenderInput {
    * when the plugin has nothing to suggest (issue #544).
    */
   readonly suggestedActions?: ReadonlyArray<SuggestedActionRecord>;
+  /** Run-level diagnostics (performance hints, post-run timing, persistence status); absent when none were collected (issue #544). */
+  readonly runDiagnostics?: RunDiagnostics;
   readonly trendSummary?: {
     readonly direction: "improving" | "regressing" | "stable";
     readonly runCount: number;
@@ -3163,6 +3244,30 @@ export declare const RunReportFile: Schema.Struct<{
       }>>;
     }>>;
   }>>;
+  readonly runDiagnostics: Schema.optionalKey<Schema.Struct<{
+    readonly performanceHints: Schema.$Array<Schema.Struct<{
+      readonly kind: Schema.Literals<readonly ["environment", "import", "transform", "isolate"]>;
+      readonly project: Schema.optionalKey<Schema.String>;
+      readonly message: Schema.String;
+      readonly remedy: Schema.String;
+      readonly detail: Schema.String;
+      readonly learnMoreUrl: Schema.String;
+      readonly estimatedSavingMs: Schema.optionalKey<Schema.Finite>;
+      readonly share: Schema.optionalKey<Schema.Finite>;
+    }>>;
+    readonly postRun: Schema.optionalKey<Schema.Struct<{
+      readonly persistMs: Schema.Finite;
+      readonly coverageScanMs: Schema.Finite;
+      readonly totalMs: Schema.Finite;
+      readonly renderMs: Schema.optionalKey<Schema.Finite>;
+      readonly vitestDurationMs: Schema.optionalKey<Schema.Finite>;
+    }>>;
+    readonly persistence: Schema.optionalKey<Schema.Struct<{
+      readonly ok: Schema.Boolean;
+      readonly reason: Schema.optionalKey<Schema.String>;
+      readonly migrationFailed: Schema.optionalKey<Schema.Boolean>;
+    }>>;
+  }>>;
 }>;
 /** @public */
 export type RunReportFile = typeof RunReportFile.Type;
@@ -3527,34 +3632,6 @@ export declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
 }>]>;
 /** @public */
 export type TurnPayload = typeof TurnPayload.Type;
-/**
- * Options for ANSI color output control.
- *
- * @internal
- */
-export interface AnsiOptions {
-  noColor?: boolean;
-}
-/**
- * Wrap text with an ANSI color/style escape code.
- *
- * No-ops when `options.noColor` is true, keeping output as valid plain
- * markdown when captured by agents or piped to files.
- *
- * @privateRemarks
- * Uses raw ANSI escape sequences (`\x1b[...m`) rather than a dependency
- * like `chalk` or `picocolors` to keep the package zero-dependency. The
- * `noColor` flag respects the `NO_COLOR` environment variable convention.
- *
- * @param text - Text to wrap
- * @param color - ANSI code name: `reset`, `bold`, `dim`, `red`, `green`, `yellow`, `cyan`
- * @param options - Control color output
- * @returns Text with ANSI escape codes, or plain text if noColor
- *
- * @see {@link https://no-color.org/ | NO_COLOR convention}
- * @internal
- */
-export declare function ansi(text: string, color: string, options?: AnsiOptions): string;
 /**
  * Strip all ANSI escape codes from a string.
  *
@@ -3816,33 +3893,6 @@ export declare const coerceErrorText: (value: unknown) => string | undefined;
  * @public
  */
 export declare const coerceErrorField: (source: unknown, key: string) => string | undefined;
-/**
- * Compress an array of line numbers into a compact range string.
- *
- * Consecutive line numbers are collapsed into `start-end` ranges,
- * separated by commas. Duplicate values are removed and the input
- * is sorted ascending before processing.
- *
- * @param lines - Array of line numbers to compress
- * @returns Compressed range string, or empty string for empty input
- *
- * @example
- * ```typescript
- * import { compressLines } from "@vitest-agent/sdk/utils";
- *
- * compressLines([1, 2, 3, 5, 10, 11, 12]);
- * // Returns: "1-3,5,10-12"
- *
- * compressLines([42]);
- * // Returns: "42"
- *
- * compressLines([]);
- * // Returns: ""
- * ```
- *
- * @public
- */
-export declare function compressLines(lines: number[]): string;
 /**
  * Hash resolved targets to detect configuration changes.
  *
@@ -3958,66 +4008,6 @@ export declare const formatConsoleLeaksNote: (leaks: ConsoleLeaks) => ReadonlyAr
  * @public
  */
 export declare function detectNonDefaultDiscoverStrategy(source: string): boolean;
-/**
- * Filesystem abstraction for package manager detection.
- *
- * @remarks
- * This interface allows dependency injection for testability. In production,
- * pass an adapter backed by `node:fs/promises`. In tests, provide a mock
- * implementation.
- *
- * @example
- * ```typescript
- * import type { FileSystemAdapter } from "@vitest-agent/sdk/detect-pm";
- * import { readFile, access } from "node:fs/promises";
- *
- * const fsAdapter: FileSystemAdapter = {
- *   readFile: (path: string) => readFile(path, "utf-8"),
- *   exists: async (path: string) => {
- *     try {
- *       await access(path);
- *       return true;
- *     } catch {
- *       return false;
- *     }
- *   },
- * };
- * ```
- *
- * @internal
- */
-export interface FileSystemAdapter {
-  readFile(path: string): Promise<string>;
-  exists(path: string): Promise<boolean>;
-}
-/**
- * Detect the package manager used in a project by inspecting the root directory.
- *
- * @remarks
- * Detection order:
- * 1. The `packageManager` field in `package.json` (e.g., `"pnpm\@10.32.1"`)
- * 2. Lockfile presence: `pnpm-lock.yaml`, `package-lock.json`, `yarn.lock`, `bun.lock`
- *
- * Returns `null` when no package manager can be determined.
- *
- * @param root - Absolute path to the project root directory
- * @param fs - Filesystem adapter for reading files and checking existence
- * @returns The detected package manager, or `null`
- *
- * @internal
- */
-export declare function detectPackageManager(root: string, fs: FileSystemAdapter): Promise<PackageManager | null>;
-/**
- * Return the vitest run command for the given package manager.
- *
- * Falls back to `"npx vitest run"` when `pm` is `null`.
- *
- * @param pm - Detected package manager, or `null` for unknown
- * @returns Shell command string for running vitest
- *
- * @internal
- */
-export declare function getRunCommand(pm: PackageManager | null): string;
 /**
  * True when the error looks like a Vitest test or hook timeout. Either
  * the message matches "timed out in Nms" or the error name contains
@@ -4028,132 +4018,6 @@ export declare const isTimeoutError: (error: {
   message?: string;
   name?: string;
 }) => boolean;
-/**
- * Options controlling console markdown output formatting.
- *
- * @internal
- */
-export interface ConsoleFormatOptions {
-  /** Absolute project root; stripped from file paths for display. */
-  cwd: string;
-  /** Output verbosity: `"failures"` (default), `"full"`, or `"silent"`. */
-  consoleOutput: "failures" | "full" | "silent";
-  /** Maximum number of low-coverage files to show in console output. */
-  coverageConsoleLimit: number;
-  /** When `true`, suppress ANSI color codes for valid plain markdown. */
-  noColor: boolean;
-  /** Optional trend summary for tiered coverage output. */
-  trendSummary?: {
-    direction: "improving" | "regressing" | "stable";
-    runCount: number;
-    firstMetric?: {
-      name: string;
-      from: number;
-      to: number;
-      target?: number;
-    };
-  };
-  /** CLI run command prefix for coverage/trends hints (e.g., `"pnpm vitest-agent"`). */
-  runCommand?: string;
-  /** When true, suggest MCP tools instead of CLI commands in Next Steps. */
-  mcp?: boolean;
-}
-/**
- * Return the metric with the lowest percentage from a `FileCoverageReport`.
- *
- * @remarks
- * Used to surface the single worst coverage metric per file in console output,
- * keeping the display compact. Labels are abbreviated: `"Stmts"`, `"Branch"`,
- * `"Funcs"`, `"Lines"`.
- *
- * @param f - File coverage report to analyze
- * @returns Object with `label` and `pct` of the worst metric
- *
- * @internal
- */
-export declare function getWorstMetric(f: FileCoverageReport): {
-  label: string;
-  pct: number;
-};
-/**
- * Strip the working directory prefix from a file path to produce a
- * project-relative path for display.
- *
- * @param filePath - Absolute or relative file path
- * @param cwd - Working directory to strip
- * @returns Project-relative path string
- *
- * @internal
- */
-export declare function relativePath(filePath: string, cwd: string): string;
-/**
- * Determine the output tier based on test results and coverage state.
- *
- * - `"red"` -- failures, unhandled errors, or files below threshold
- * - `"yellow"` -- all tests pass but coverage targets exist (room to improve)
- * - `"green"` -- all tests pass, all coverage targets met
- *
- * @internal
- */
-export declare function determineTier(report: AgentReport): "green" | "yellow" | "red";
-/**
- * Format an {@link (AgentReport:variable)} as compact, actionable console markdown.
- *
- * @remarks
- * The output is structured for LLM agent consumption with four sections:
- *
- * 1. **Compact header** with pass/fail counts and duration
- * 2. **Failed test details** with error messages and diffs (the core value)
- * 3. **Coverage gaps** showing only files below threshold, worst metric first
- * 4. **Next steps** with re-run commands and cache file pointer
- *
- * When all tests pass, the output collapses to a single success line
- * with an optional cache file reference.
- *
- * Returns an empty string when `consoleOutput` is `"silent"`.
- *
- * @param report - The report to format
- * @param options - Formatting options controlling verbosity and color
- * @returns Formatted markdown string, or empty string for silent mode
- *
- * @internal
- */
-export declare function formatConsoleMarkdown(report: AgentReport, options: ConsoleFormatOptions): string;
-/**
- * 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
- */
-export declare function formatFatalError(err: unknown): string;
-/**
- * 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
- */
-export declare function formatGfm(reports: AgentReport[]): string;
 /**
  * Format the informational note shown when coverage thresholds were
  * skipped because a run only exercised a subset of the project's test
@@ -4234,34 +4098,6 @@ export declare const rewriteBashCommand: (input: {
  * @public
  */
 export declare const detectVitestScripts: (scripts: Record<string, string>) => Set<string>;
-/**
- * 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
- */
-export declare function normalizeWorkspaceKey(name: string): string;
 /**
  * Pure POSIX path helpers for the platform-free core.
  *
@@ -4295,60 +4131,33 @@ export declare const joinPosix: (...parts: ReadonlyArray<string>) => string;
  * @public
  */
 export declare const relativePosix: (from: string, to: string) => string;
-/** @public */
-export interface HostMetadataResult {
-  readonly source: string | null;
-  readonly value: string | null;
-  readonly metadata: Record<string, unknown> | null;
-}
 /**
- * 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)
+ * Post-run work at or above this many milliseconds is always "slow".
  * @public
  */
-export declare const probeHostMetadataFromEnv: (env: Record<string, string | undefined>) => HostMetadataResult;
+export declare const POST_RUN_SLOW_MS = 5000;
 /**
- * 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"
- * ```
- *
+ * Post-run work at or above this share of Vitest's own duration is "slow"
+ * (once it also clears {@link POST_RUN_SLOW_MIN_MS}).
+ * @public
+ */
+export declare const POST_RUN_SLOW_SHARE = 0.1;
+/**
+ * Minimum post-run milliseconds before the share rule applies.
+ * @public
+ */
+export declare const POST_RUN_SLOW_MIN_MS = 1000;
+/**
+ * Whether the plugin's post-run work was slow enough to surface.
+ * @public
+ */
+export declare function isPostRunSlow(timing: PostRunTiming): boolean;
+/**
+ * Map run diagnostics onto suggested actions: persistence failure first, then
+ * slow post-run work, then performance hints in input order.
  * @public
  */
-export declare function safeFilename(name: string): string;
+export declare function suggestedActionsFromRunDiagnostics(d: RunDiagnostics): ReadonlyArray<SuggestedActionRecord>;
 /**
  * A stream stray output was written to.
  * @public
@@ -4658,6 +4467,20 @@ export declare const requiredArtifactForTransition: (from: Phase, to: Phase) =>
 export declare const transitionEnforcesBehaviorMatch: (from: Phase, to: Phase) => boolean;
 /** @public */
 export declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => PhaseTransitionResult;
+/**
+ * The config filenames Vitest 5 itself loads, in the order it prefers them:
+ * `vitest.config.*` before `vite.config.*`, each across
+ * `ts` / `mts` / `cts` / `js` / `mjs` / `cjs`. Mirrors `configFiles` in
+ * Vitest's own `constants.ts`. `vitest.workspace.*` is absent on purpose:
+ * Vitest no longer reads a workspace file (projects live in the config's
+ * `test.projects`).
+ *
+ * The single source both front ends derive their config lookups from, so the
+ * CLI's `check-test-path` and the MCP `run_tests` root walk cannot drift.
+ *
+ * @public
+ */
+export declare const VITEST_CONFIG_FILES: ReadonlyArray<string>;
 /**
  * The version of this package. Inlined at build time from
  * package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.

package/index.js

@@ -25,6 +25,7 @@ import { AgentPluginOptions, AgentReporterOptions, ConsoleOutputs, ReportOption,
 import { TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment } from "./schemas/TestArtifacts.js";
 import { ActionSeverity, ConsoleLogLevel, CoverageGap, CoverageMetric, HookStatus, HookType, RunEvent } from "./schemas/RunEvent.js";
 import { CoverageRenderState, FailureRecord, ModuleRecord, RenderState, RenderTotals, SuggestedActionRecord, TestRecord, initialRenderState } from "./schemas/RenderState.js";
+import { PerformanceHint, PerformanceHintKind, PersistenceStatus, PostRunTiming, RunDiagnostics } from "./schemas/RunDiagnostics.js";
 import { RUN_REPORT_FILE_SCHEMA_URL, RunReportFile } from "./schemas/RunReportFile.js";
 import { BehaviorDetail, BehaviorRow, BehaviorStatus, GoalDetail, GoalRow, GoalStatus } from "./schemas/Tdd.js";
 import { TrendEntry, TrendRecord } from "./schemas/Trends.js";
@@ -36,31 +37,25 @@ 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 { ansi, stripAnsi } from "./utils/ansi.js";
+import { stripAnsi } from "./utils/ansi.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 { compressLines } from "./utils/compress-lines.js";
 import { computeTrend, getRecentDirection, hashTargets } from "./utils/compute-trend.js";
 import { buildConsoleLeaks, collectConsoleLeakEntries, formatConsoleLeaksNote } 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 { formatScopedCoverageNote } from "./utils/format-scoped-coverage-note.js";
-import { determineTier, formatConsoleMarkdown, getWorstMetric, relativePath } from "./utils/format-console.js";
-import { formatFatalError } from "./utils/format-fatal-error.js";
-import { formatGfm } from "./utils/format-gfm.js";
 import { findFunctionBoundary } from "./utils/function-boundary.js";
 import { buildEnvPrefix, detectVitestScripts, isVitestInvocation, rewriteBashCommand } from "./utils/match-vitest-command.js";
-import { normalizeWorkspaceKey } from "./utils/normalize-workspace-key.js";
 import { basenamePosix, joinPosix, relativePosix, toPosix } from "./utils/posix-path.js";
-import { probeHostMetadataFromEnv } from "./utils/probe-host-metadata.js";
-import { safeFilename } from "./utils/safe-filename.js";
+import { POST_RUN_SLOW_MIN_MS, POST_RUN_SLOW_MS, POST_RUN_SLOW_SHARE, isPostRunSlow, suggestedActionsFromRunDiagnostics } from "./utils/run-diagnostics-actions.js";
 import { STRAY_OUTPUT_SOURCE, formatStrayOutputNote, isEscapeOnly, makeStrayOutputRecorder, readStrayOutput } from "./utils/stray-output.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 { VITEST_CONFIG_FILES } from "./utils/vitest-config-files.js";
 import { CURRENT_SDK_VERSION } from "./version.js";
 
-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, FiniteNumber, GitCommandError, GlobShortfall, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectIdentitySourceError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RetentionConfig, RunEvent, RunReportFile, RunRetentionPolicy, SRC_DIR, STRAY_OUTPUT_SOURCE, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, StrayOutput, StrayOutputSample, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, 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, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleLeaksNote, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, normalizeWorkspaceKey, probeHostMetadataFromEnv, readStrayOutput, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, 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, FiniteNumber, GitCommandError, GlobShortfall, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, POST_RUN_SLOW_MIN_MS, POST_RUN_SLOW_MS, POST_RUN_SLOW_SHARE, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PerformanceHint, PerformanceHintKind, PersistenceStatus, PhaseTransitionEvent, PostRunTiming, ProbeMissError, ProjectIdentityNotResolvableError, ProjectIdentitySourceError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RetentionConfig, RunDiagnostics, RunEvent, RunReportFile, RunRetentionPolicy, SRC_DIR, STRAY_OUTPUT_SOURCE, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, StrayOutput, StrayOutputSample, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VITEST_CONFIG_FILES, VitestAgentConfig, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectVitestScripts, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleLeaksNote, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isPostRunSlow, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, readStrayOutput, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, stripAnsi, suggestedActionsFromRunDiagnostics, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "8.0.0",
+	"version": "9.0.0",
 	"private": false,
 	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, and pure utilities.",
 	"keywords": [