@vitest-agent/sdk 7.0.4 → 7.1.0

package/index.d.ts

@@ -1,5 +1,4 @@
-import { PubSub, Schema } from "effect";
-//#region src/schemas/Coverage.d.ts
+import { Option, PubSub, Schema } from "effect";
 /**
  * Aggregate coverage percentages across four istanbul metrics.
  * @public
@@ -174,8 +173,6 @@ export declare const CoverageReport: Schema.Struct<{
 }>;
 /** @public */
 export type CoverageReport = typeof CoverageReport.Type;
-//#endregion
-//#region src/schemas/RenderState.d.ts
 /**
  * Per-test record accumulated as `TestStarted` / `TestFinished` events arrive.
  * @public
@@ -520,8 +517,6 @@ export type RenderState = typeof RenderState.Type;
  * @public
  */
 export declare const initialRenderState: RenderState;
-//#endregion
-//#region src/contracts/dispatcher.d.ts
 /**
  * The four run shapes the dispatcher distinguishes.
  *
@@ -643,8 +638,6 @@ export interface CellOptions {
    */
   readonly osc8: (url: string, label: string) => string;
 }
-//#endregion
-//#region src/formatters/types.d.ts
 /**
  * One unit of rendered reporter output, tagged by where it goes.
  *
@@ -668,8 +661,6 @@ export type RenderedOutput = {
   readonly content: string;
   readonly contentType: string;
 };
-//#endregion
-//#region src/schemas/AgentReport.d.ts
 /**
  * Aggregate test run statistics.
  * @public
@@ -958,8 +949,6 @@ export declare const AgentReport: Schema.Struct<{
 }>;
 /** @public */
 export type AgentReport = typeof AgentReport.Type;
-//#endregion
-//#region src/schemas/Common.d.ts
 /**
  * Possible states for an individual test case.
  * @public
@@ -1074,8 +1063,6 @@ export declare const ReportError: Schema.Struct<{
 }>;
 /** @public */
 export type ReportError = typeof ReportError.Type;
-//#endregion
-//#region src/schemas/RunEvent.d.ts
 /**
  * Coverage metric whose threshold can be violated independently.
  * @public
@@ -1366,8 +1353,6 @@ export type RunEvent = typeof RunEvent.Type;
  * @public
  */
 export type RunEventByTag = { [E in RunEvent as E["_tag"]]: E; };
-//#endregion
-//#region src/schemas/Thresholds.d.ts
 /**
  * Per-metric threshold values. All optional -- only set metrics are enforced.
  * @public
@@ -1467,8 +1452,6 @@ export declare const ResolvedThresholds: Schema.Struct<{
 }>;
 /** @public */
 export type ResolvedThresholds = typeof ResolvedThresholds.Type;
-//#endregion
-//#region src/schemas/Transport.d.ts
 /**
  * Transport binding for the persistence layer.
  *
@@ -1483,8 +1466,6 @@ export declare const Transport: Schema.Union<readonly [Schema.Struct<{
 }>]>;
 /** @public */
 export type Transport = typeof Transport.Type;
-//#endregion
-//#region src/contracts/reporter.d.ts
 /**
  * Config the plugin computes from its own options + Vitest's resolved config,
  * then hands to the reporter factory inside {@link ReporterKit}.
@@ -1536,6 +1517,21 @@ export interface ResolvedReporterConfig {
    * @internal
    */
   readonly coverageMode: "full" | "ui-only";
+  /**
+   * Whether this run is recorded in the SQLite `data.db` (issue #625).
+   * `false` when the user passed `AgentPlugin({ persist: false })` or
+   * the `VITEST_AGENT_PERSIST` operator override turned persistence
+   * off: the run still renders, but classifications are empty and
+   * coverage carries no baseline delta or trend, because there is no
+   * history to read. Independent of `coverageMode` — a UI-only run
+   * (`coverage.enabled: false`) skips persistence too, with this field
+   * still reporting what the user asked for.
+   *
+   * The plugin always populates it; it is optional only because a
+   * consumer constructing `ResolvedReporterConfig` by hand may omit it,
+   * in which case treat it as `true`.
+   */
+  readonly persist?: boolean;
   readonly detail: DetailLevel;
   readonly noColor: boolean;
   readonly runCommand?: string;
@@ -1696,8 +1692,6 @@ export interface VitestAgentReporter {
  * @public
  */
 export type VitestAgentReporterFactory = (kit: ReporterKit) => VitestAgentReporter | ReadonlyArray<VitestAgentReporter>;
-//#endregion
-//#region src/schemas/Identity.d.ts
 /**
  * Canonical UUID for an LLM agent invocation. Generated server-side at
  * `register_agent` time. Stable across transport reconnects within an
@@ -1770,8 +1764,6 @@ export type ActorType = typeof ActorType.Type;
 export declare const HostKind: Schema.Literals<readonly ["claude-code", "claude-desktop", "cursor", "goose", "chatgpt", "mcp-inspector", "unknown"]>;
 /** @public */
 export type HostKind = typeof HostKind.Type;
-//#endregion
-//#region src/errors/AgentErrors.d.ts
 declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "AgentNotFoundError";
 } & Readonly<A>;
@@ -1853,8 +1845,6 @@ export declare class SidecarTimeoutError extends SidecarTimeoutError_base<{
     readonly timeoutMs: number;
   });
 }
-//#endregion
-//#region src/errors/DataStoreError.d.ts
 declare const DataStoreError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "DataStoreError";
 } & Readonly<A>;
@@ -1886,8 +1876,6 @@ export declare class DataStoreError extends DataStoreError_base<{
  * @public
  */
 export declare const extractSqlReason: (e: unknown) => string;
-//#endregion
-//#region src/errors/DiscoveryError.d.ts
 declare const DiscoveryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "DiscoveryError";
 } & Readonly<A>;
@@ -1906,8 +1894,6 @@ export declare class DiscoveryError extends DiscoveryError_base<{
     readonly reason: string;
   });
 }
-//#endregion
-//#region src/errors/PathResolutionError.d.ts
 declare const PathResolutionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "PathResolutionError";
 } & Readonly<A>;
@@ -1928,8 +1914,6 @@ export declare class PathResolutionError extends PathResolutionError_base<{
     readonly reason: string;
   });
 }
-//#endregion
-//#region src/errors/ProjectIdentityError.d.ts
 /**
  * One source the resolver tried while looking for project identity.
  *
@@ -1965,8 +1949,6 @@ export declare class ProjectIdentityNotResolvableError extends ProjectIdentityNo
     readonly tried: ReadonlyArray<ProjectIdentityCandidate>;
   });
 }
-//#endregion
-//#region src/errors/RunContextError.d.ts
 declare const GitCommandError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "GitCommandError";
 } & Readonly<A>;
@@ -2002,8 +1984,6 @@ declare const ProbeMissError_base: new <A extends Record<string, any> = {}>(args
 export declare class ProbeMissError extends ProbeMissError_base<{
   readonly probe: string;
 }> {}
-//#endregion
-//#region src/errors/TddErrors.d.ts
 declare const GoalNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "GoalNotFoundError";
 } & Readonly<A>;
@@ -2081,8 +2061,6 @@ export declare class IllegalStatusTransitionError extends IllegalStatusTransitio
     readonly reason: string;
   });
 }
-//#endregion
-//#region src/schemas/Agent.d.ts
 declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
   readonly agentId: Schema.brand<Schema.String, "AgentId">;
   readonly sessionId: Schema.Number;
@@ -2139,8 +2117,6 @@ export interface AgentTreeNode {
   readonly agent: Agent;
   readonly children: ReadonlyArray<AgentTreeNode>;
 }
-//#endregion
-//#region src/schemas/Baselines.d.ts
 /**
  * Coverage baselines -- the auto-ratcheting high-water mark.
  * @public
@@ -2168,8 +2144,6 @@ export declare const CoverageBaselines: Schema.Struct<{
 }>;
 /** @public */
 export type CoverageBaselines = typeof CoverageBaselines.Type;
-//#endregion
-//#region src/schemas/CacheManifest.d.ts
 /**
  * A single project entry in the cache manifest.
  * @public
@@ -2200,8 +2174,6 @@ export declare const CacheManifest: Schema.Struct<{
 }>;
 /** @public */
 export type CacheManifest = typeof CacheManifest.Type;
-//#endregion
-//#region src/schemas/ChannelEvent.d.ts
 /** @public */
 export declare const SessionOutcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
 /** @public */
@@ -2438,18 +2410,46 @@ export type ChannelEvent = typeof ChannelEvent.Type;
 export declare const BehaviorScopedEventTypes: readonly ["behavior_started", "phase_transition", "behavior_completed", "behavior_abandoned", "blocked"];
 /** @public */
 export type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
-//#endregion
-//#region src/schemas/Config.d.ts
+declare const RetentionConfig_base: Schema.Class<RetentionConfig, Schema.Struct<{
+  readonly enabled: Schema.optionalKey<Schema.Boolean>;
+  readonly keepRuns: Schema.optionalKey<Schema.Int>;
+  readonly maxAgeDays: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+/**
+ * The optional `[retention]` table of `vitest-agent.config.toml`: how many
+ * `test_runs` rows (and their cascaded modules, cases, errors, coverage
+ * rows) the per-project `data.db` keeps.
+ *
+ * Every field is optional. An absent table means the default policy
+ * (`RunRetentionPolicy.DEFAULT_KEEP_RUNS` newest runs per project, no age
+ * limit); `enabled = false` turns run pruning off entirely.
+ *
+ * Fields:
+ * - `enabled` — `false` disables run retention. Defaults to `true`.
+ * - `keepRuns` — the newest N runs per project to keep. A positive integer;
+ *   defaults to `RunRetentionPolicy.DEFAULT_KEEP_RUNS`.
+ * - `maxAgeDays` — additionally drop any run older than this many days,
+ *   even inside the newest N. A positive integer; no age limit by default.
+ *
+ * @remarks
+ * `keepRuns = 0` is rejected rather than read as "keep nothing": the run
+ * being written is always kept, and `enabled = false` is the explicit
+ * off switch, so a zero would have two readings.
+ * @public
+ */
+export declare class RetentionConfig extends RetentionConfig_base {}
 declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Struct<{
   readonly cacheDir: Schema.optional<Schema.String>;
   readonly projectKey: Schema.optional<Schema.String>;
+  readonly retention: Schema.optionalKey<typeof RetentionConfig>;
 }>, {}>;
 /**
  * Schema for the optional `vitest-agent.config.toml` file.
  *
- * Both fields are optional. When the file is absent or these fields are
+ * Every field is optional. When the file is absent or these fields are
  * unset, `resolveDataPath` falls back to deriving the path from the
- * workspace's `package.json` `name` under the XDG data directory.
+ * workspace's `package.json` `name` under the XDG data directory, and run
+ * retention uses the default policy.
  *
  * Fields:
  * - `cacheDir` — absolute path overriding the entire data directory. Highest
@@ -2460,11 +2460,39 @@ declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Str
  *   directory. Use this when two unrelated projects on the same machine
  *   share a `package.json` `name` (the collision case for workspace-name
  *   keying), or when you want a stable key independent of `name` changes.
+ * - `retention` — the `[retention]` table; see `RetentionConfig`.
  * @public
  */
 export declare class VitestAgentConfig extends VitestAgentConfig_base {}
-//#endregion
-//#region src/schemas/ConsoleLeaks.d.ts
+declare const RunRetentionPolicy_base: Schema.Class<RunRetentionPolicy, Schema.Struct<{
+  readonly keepRuns: Schema.Int;
+  readonly maxAgeDays: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+/**
+ * The resolved run-retention policy a `data.db` prune applies: keep the
+ * newest `keepRuns` runs of every project, and drop any run older than
+ * `maxAgeDays` days when set. The run being persisted is never pruned.
+ *
+ * @remarks
+ * The default of 200 runs per project is sized against what reads the
+ * data: failure classification reads the newest 10 `test_history` rows per
+ * test and coverage trends keep 50 entries, so 200 leaves both a wide
+ * margin while bounding a 7k-test suite (about 3 MB per run) to a few
+ * hundred megabytes instead of growing without bound (issue 623, where an
+ * unpruned database reached 880 MB over 4,484 runs). `maxAgeDays` is the
+ * lever for a project that runs rarely but wants a calendar bound.
+ * @public
+ */
+export declare class RunRetentionPolicy extends RunRetentionPolicy_base {
+  /** Newest runs per project kept when the config names no `keepRuns`. */
+  static readonly DEFAULT_KEEP_RUNS = 200;
+  /**
+   * Resolve the policy a loaded config asks for: `Option.none()` when
+   * `retention.enabled` is `false`, otherwise the configured values over
+   * the defaults.
+   */
+  static fromConfig(config: VitestAgentConfig): Option.Option<RunRetentionPolicy>;
+}
 /**
  * Per-file stray-console-output detail. Counts are of console writes
  * (one `console.*` call), not lines.
@@ -2519,8 +2547,6 @@ export declare const ConsoleLeaks: Schema.Struct<{
 }>;
 /** @public */
 export type ConsoleLeaks = typeof ConsoleLeaks.Type;
-//#endregion
-//#region src/schemas/CoverageLevel.d.ts
 declare const CoverageLevel_base: Schema.Class<CoverageLevel, Schema.Struct<{
   readonly lines: Schema.Number;
   readonly functions: Schema.Number;
@@ -2582,8 +2608,6 @@ export declare function resolveCoverageInput(input: CoverageInput | undefined, f
  * @public
  */
 export declare function validateCoverageConfig(thresholds: CoverageLevel, targets: CoverageLevel): void;
-//#endregion
-//#region src/schemas/CoverageTargets.d.ts
 /**
  * Per-metric leaf shape for coverageTargets entries. Allows optional
  * numeric targets per metric, the `100: true` shortcut, and — mirroring
@@ -2637,8 +2661,6 @@ export declare const CoverageTargets: Schema.$Record<Schema.String, Schema.Union
 }>]>>;
 /** @public */
 export type CoverageTargets = typeof CoverageTargets.Type;
-//#endregion
-//#region src/schemas/History.d.ts
 /**
  * A single test run outcome (pass or fail only).
  * @public
@@ -2681,8 +2703,6 @@ export declare const HistoryRecord: Schema.Struct<{
 }>;
 /** @public */
 export type HistoryRecord = typeof HistoryRecord.Type;
-//#endregion
-//#region src/schemas/Options.d.ts
 /**
  * Per-executor console-output matrix. Most users never set this — the
  * built-in defaults cover the common cases. Override per slot when you
@@ -2731,10 +2751,10 @@ export type ReportOption = typeof ReportOption.Type;
 /**
  * The 2.0 user-facing options for `AgentPlugin`.
  *
- * Six fields total. Two are function-typed (`reporter`, `onRunEvent`)
+ * Seven fields total. Two are function-typed (`reporter`, `onRunEvent`)
  * and live on the `AgentPluginConstructorOptions` companion interface in
  * `@vitest-agent/plugin` — Effect Schema cannot encode functions cleanly,
- * so the schema-decodable struct carries the four data-shaped fields.
+ * so the schema-decodable struct carries the five data-shaped fields.
  * @public
  */
 export declare const AgentPluginOptions: Schema.Struct<{
@@ -2762,6 +2782,34 @@ export declare const AgentPluginOptions: Schema.Struct<{
   readonly report: Schema.optional<Schema.Union<readonly [Schema.Literal<false>, Schema.Struct<{
     readonly scope: Schema.optional<Schema.String>;
   }>]>>;
+  /**
+   * Whether a run is recorded in the SQLite `data.db` (default `true`).
+   *
+   * `false` is the explicit opt-out for a runner where nothing reads the
+   * database back — a throwaway CI job, say. The run still renders every
+   * console and report-file output, still emits every `RunEvent`, and
+   * Vitest still enforces `coverage.thresholds` through its own
+   * mechanism; only the database writes are skipped: run rows, test
+   * cases, failure history, coverage rows and trends, and the baselines
+   * they feed. Consequences a renderer sees: failure classifications are
+   * empty (there is no history to classify against, so no test is
+   * labelled `stable`, `new-failure`, `persistent`, `flaky` or
+   * `recovered`), and coverage renders without a baseline delta or a
+   * trend line. The `data.db` file is never created or opened.
+   *
+   * The opt-out is never automatic: `CI=true` does not imply it, because
+   * some CI setups cache `data.db` between jobs and query it. The
+   * `VITEST_AGENT_PERSIST` environment variable (`0` / `false` / `off`
+   * to disable, `1` / `true` / `on` to enable) is the operator spelling
+   * for a runner whose config cannot be edited, and it wins over this
+   * option in either direction; any other value is ignored with one
+   * stderr line.
+   *
+   * `coverage.enabled: false` in Vitest's own config already skips
+   * persistence (UI-only mode, Decision 38) — this option is for a run
+   * that keeps coverage on and still wants no database.
+   */
+  readonly persist: Schema.optional<Schema.Boolean>;
 }>;
 /** @public */
 export type AgentPluginOptions = typeof AgentPluginOptions.Type;
@@ -2782,8 +2830,6 @@ export declare const AgentReporterOptions: Schema.Struct<{
 }>;
 /** @public */
 export type AgentReporterOptions = typeof AgentReporterOptions.Type;
-//#endregion
-//#region src/schemas/RunReportFile.d.ts
 /**
  * Canonical `$schema` URL for `RunReportFile` — the `schemas/5.0/run.json`
  * document GitHub serves raw from this repository.
@@ -2996,8 +3042,6 @@ export declare const RunReportFile: Schema.Struct<{
 }>;
 /** @public */
 export type RunReportFile = typeof RunReportFile.Type;
-//#endregion
-//#region src/schemas/StrayOutput.d.ts
 /**
  * One line of stray output, kept as a sample: the stream it was written to,
  * and its text with escapes stripped, cut to a sane length.
@@ -3037,8 +3081,6 @@ export declare const StrayOutput: Schema.Struct<{
 }>;
 /** @public */
 export type StrayOutput = typeof StrayOutput.Type;
-//#endregion
-//#region src/schemas/Tdd.d.ts
 /** @public */
 export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
@@ -3116,8 +3158,6 @@ export declare const BehaviorDetail: Schema.Struct<{
 }>;
 /** @public */
 export type BehaviorDetail = typeof BehaviorDetail.Type;
-//#endregion
-//#region src/schemas/TestArtifacts.d.ts
 /**
  * Source position a test annotation or test artifact points at.
  * @public
@@ -3207,8 +3247,6 @@ export declare const TestArtifact: Schema.Struct<{
 }>;
 /** @public */
 export type TestArtifact = typeof TestArtifact.Type;
-//#endregion
-//#region src/schemas/Trends.d.ts
 /**
  * A single coverage trend data point recorded on a full test run.
  * @public
@@ -3257,8 +3295,6 @@ export declare const TrendRecord: Schema.Struct<{
 }>;
 /** @public */
 export type TrendRecord = typeof TrendRecord.Type;
-//#endregion
-//#region src/schemas/turns/FileEditPayload.d.ts
 /** @public */
 export declare const FileEditPayload: Schema.Struct<{
   readonly type: Schema.Literal<"file_edit">;
@@ -3270,8 +3306,6 @@ export declare const FileEditPayload: Schema.Struct<{
 }>;
 /** @public */
 export type FileEditPayload = typeof FileEditPayload.Type;
-//#endregion
-//#region src/schemas/turns/HookFirePayload.d.ts
 /** @public */
 export declare const HookFirePayload: Schema.Struct<{
   readonly type: Schema.Literal<"hook_fire">;
@@ -3281,8 +3315,6 @@ export declare const HookFirePayload: Schema.Struct<{
 }>;
 /** @public */
 export type HookFirePayload = typeof HookFirePayload.Type;
-//#endregion
-//#region src/schemas/turns/HypothesisPayload.d.ts
 /** @public */
 export declare const HypothesisPayload: Schema.Struct<{
   readonly type: Schema.Literal<"hypothesis">;
@@ -3292,8 +3324,6 @@ export declare const HypothesisPayload: Schema.Struct<{
 }>;
 /** @public */
 export type HypothesisPayload = typeof HypothesisPayload.Type;
-//#endregion
-//#region src/schemas/turns/NotePayload.d.ts
 /** @public */
 export declare const NotePayload: Schema.Struct<{
   readonly type: Schema.Literal<"note">;
@@ -3303,8 +3333,6 @@ export declare const NotePayload: Schema.Struct<{
 }>;
 /** @public */
 export type NotePayload = typeof NotePayload.Type;
-//#endregion
-//#region src/schemas/turns/ToolCallPayload.d.ts
 /** @public */
 export declare const ToolCallPayload: Schema.Struct<{
   readonly type: Schema.Literal<"tool_call">;
@@ -3314,8 +3342,6 @@ export declare const ToolCallPayload: Schema.Struct<{
 }>;
 /** @public */
 export type ToolCallPayload = typeof ToolCallPayload.Type;
-//#endregion
-//#region src/schemas/turns/ToolResultPayload.d.ts
 /** @public */
 export declare const ToolResultPayload: Schema.Struct<{
   readonly type: Schema.Literal<"tool_result">;
@@ -3327,8 +3353,6 @@ export declare const ToolResultPayload: Schema.Struct<{
 }>;
 /** @public */
 export type ToolResultPayload = typeof ToolResultPayload.Type;
-//#endregion
-//#region src/schemas/turns/UserPromptPayload.d.ts
 /** @public */
 export declare const UserPromptPayload: Schema.Struct<{
   readonly type: Schema.Literal<"user_prompt">;
@@ -3337,8 +3361,6 @@ export declare const UserPromptPayload: Schema.Struct<{
 }>;
 /** @public */
 export type UserPromptPayload = typeof UserPromptPayload.Type;
-//#endregion
-//#region src/schemas/turns/index.d.ts
 /** @public */
 export declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"user_prompt">;
@@ -3381,8 +3403,6 @@ export declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
 }>]>;
 /** @public */
 export type TurnPayload = typeof TurnPayload.Type;
-//#endregion
-//#region src/utils/ansi.d.ts
 /**
  * Options for ANSI color output control.
  *
@@ -3420,8 +3440,6 @@ export declare function ansi(text: string, color: string, options?: AnsiOptions)
  * @internal
  */
 export declare function stripAnsi(text: string): string;
-//#endregion
-//#region src/utils/build-report.d.ts
 /**
  * Duck-typed Vitest parsed stack frame.
  *
@@ -3600,8 +3618,6 @@ export declare function buildAgentReport(testModules: ReadonlyArray<VitestTestMo
  * @public
  */
 export declare const countSuiteFailures: (report: Pick<AgentReport, "failed">) => number;
-//#endregion
-//#region src/utils/canonicalize-git-url.d.ts
 /**
  * Canonicalize a git remote URL.
  *
@@ -3631,8 +3647,6 @@ export declare const canonicalizeGitUrl: (raw: string) => string | null;
  * @public
  */
 export declare const gitUrlToProjectKey: (raw: string) => string | null;
-//#endregion
-//#region src/utils/classify-test.d.ts
 /**
  * Classify a test based on its current state and prior run history.
  *
@@ -3644,8 +3658,6 @@ export declare const gitUrlToProjectKey: (raw: string) => string | null;
 export declare function classifyTest(current: "passed" | "failed", priorRuns: ReadonlyArray<{
   state: string;
 }>): TestClassification;
-//#endregion
-//#region src/utils/coerce-error-text.d.ts
 /**
  * Coerce an unknown error-field value (message, name, diff, stack, ...) into a
  * string that is safe to bind to a SQLite TEXT column or render to a terminal.
@@ -3680,8 +3692,6 @@ export declare const coerceErrorText: (value: unknown) => string | undefined;
  * @public
  */
 export declare const coerceErrorField: (source: unknown, key: string) => string | undefined;
-//#endregion
-//#region src/utils/compress-lines.d.ts
 /**
  * Compress an array of line numbers into a compact range string.
  *
@@ -3709,8 +3719,6 @@ export declare const coerceErrorField: (source: unknown, key: string) => string
  * @public
  */
 export declare function compressLines(lines: number[]): string;
-//#endregion
-//#region src/utils/compute-trend.d.ts
 /**
  * Hash resolved targets to detect configuration changes.
  *
@@ -3736,8 +3744,6 @@ export declare function getRecentDirection(record: TrendRecord, count?: number):
   direction: "improving" | "regressing" | "stable";
   runCount: number;
 };
-//#endregion
-//#region src/utils/console-leaks.d.ts
 /**
  * A single captured stray console write, attributed to a file (and a test
  * when the write happened inside one). Fed to buildConsoleLeaks.
@@ -3804,8 +3810,6 @@ export interface ConsoleLeakTask {
  * @public
  */
 export declare function collectConsoleLeakEntries(files: ReadonlyArray<ConsoleLeakTask>): ConsoleLeakEntry[];
-//#endregion
-//#region src/utils/detect-non-default-discover-strategy.d.ts
 /**
  * Lexically detects whether a Vitest/Vite config source text appears to
  * configure a non-default `DiscoverStrategy` — a custom `discoverStrategy`
@@ -3821,8 +3825,6 @@ export declare function collectConsoleLeakEntries(files: ReadonlyArray<ConsoleLe
  * @public
  */
 export declare function detectNonDefaultDiscoverStrategy(source: string): boolean;
-//#endregion
-//#region src/utils/detect-pm.d.ts
 /**
  * Filesystem abstraction for package manager detection.
  *
@@ -3883,8 +3885,6 @@ export declare function detectPackageManager(root: string, fs: FileSystemAdapter
  * @internal
  */
 export declare function getRunCommand(pm: PackageManager | null): string;
-//#endregion
-//#region src/utils/detect-timeout.d.ts
 /**
  * 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
@@ -3895,8 +3895,6 @@ export declare const isTimeoutError: (error: {
   message?: string;
   name?: string;
 }) => boolean;
-//#endregion
-//#region src/utils/format-console.d.ts
 /**
  * Options controlling console markdown output formatting.
  *
@@ -3988,8 +3986,6 @@ export declare function determineTier(report: AgentReport): "green" | "yellow" |
  * @internal
  */
 export declare function formatConsoleMarkdown(report: AgentReport, options: ConsoleFormatOptions): string;
-//#endregion
-//#region src/utils/format-fatal-error.d.ts
 /**
  * Format an unknown error into a human-readable string with issue URL.
  *
@@ -4002,8 +3998,6 @@ export declare function formatConsoleMarkdown(report: AgentReport, options: Cons
  * @public
  */
 export declare function formatFatalError(err: unknown): string;
-//#endregion
-//#region src/utils/format-gfm.d.ts
 /**
  * Format one or more {@link (AgentReport:variable) | AgentReports} as a GitHub-Flavored
  * Markdown string for writing to `GITHUB_STEP_SUMMARY`.
@@ -4027,8 +4021,6 @@ export declare function formatFatalError(err: unknown): string;
  * @public
  */
 export declare function formatGfm(reports: AgentReport[]): string;
-//#endregion
-//#region src/utils/format-scoped-coverage-note.d.ts
 /**
  * Format the informational note shown when coverage thresholds were
  * skipped because a run only exercised a subset of the project's test
@@ -4048,8 +4040,6 @@ export declare function formatGfm(reports: AgentReport[]): string;
  * @public
  */
 export declare function formatScopedCoverageNote(testedFileCount: number, totalFileCount?: number): string;
-//#endregion
-//#region src/utils/function-boundary.d.ts
 /** @public */
 export interface FunctionBoundary {
   readonly line: number;
@@ -4065,16 +4055,12 @@ export interface FunctionBoundary {
  * @public
  */
 export declare const findFunctionBoundary: (source: string, line: number) => FunctionBoundary | null;
-//#endregion
-//#region src/utils/hyperlink.d.ts
 /** @public */
 export interface Osc8Options {
   readonly enabled: boolean;
 }
 /** @public */
 export declare const osc8: (url: string, label: string, options: Osc8Options) => string;
-//#endregion
-//#region src/utils/match-vitest-command.d.ts
 /**
  * Return `true` if the command invokes Vitest in any of the five
  * supported shapes. The `vitestScripts` set carries the names of
@@ -4121,8 +4107,6 @@ export declare const rewriteBashCommand: (input: {
  * @public
  */
 export declare const detectVitestScripts: (scripts: Record<string, string>) => Set<string>;
-//#endregion
-//#region src/utils/normalize-workspace-key.d.ts
 /**
  * Normalize a workspace name into a filesystem-safe directory segment.
  *
@@ -4151,8 +4135,6 @@ export declare const detectVitestScripts: (scripts: Record<string, string>) => S
  * @public
  */
 export declare function normalizeWorkspaceKey(name: string): string;
-//#endregion
-//#region src/utils/posix-path.d.ts
 /**
  * Pure POSIX path helpers for the platform-free core.
  *
@@ -4186,8 +4168,6 @@ export declare const joinPosix: (...parts: ReadonlyArray<string>) => string;
  * @public
  */
 export declare const relativePosix: (from: string, to: string) => string;
-//#endregion
-//#region src/utils/probe-host-metadata.d.ts
 /** @public */
 export interface HostMetadataResult {
   readonly source: string | null;
@@ -4215,8 +4195,6 @@ export interface HostMetadataResult {
  * @public
  */
 export declare const probeHostMetadataFromEnv: (env: Record<string, string | undefined>) => HostMetadataResult;
-//#endregion
-//#region src/utils/safe-filename.d.ts
 /**
  * Convert a project name to a filesystem-safe filename.
  *
@@ -4244,8 +4222,6 @@ export declare const probeHostMetadataFromEnv: (env: Record<string, string | und
  * @public
  */
 export declare function safeFilename(name: string): string;
-//#endregion
-//#region src/utils/stray-output.d.ts
 /**
  * A stream stray output was written to.
  * @public
@@ -4317,8 +4293,6 @@ export declare const readStrayOutput: (logger: unknown) => StrayOutput | undefin
  * @public
  */
 export declare const formatStrayOutputNote: (stray: StrayOutput) => ReadonlyArray<string>;
-//#endregion
-//#region src/utils/test-location.d.ts
 /** Directory holding source files whose tests may be co-located. @public */
 export declare const SRC_DIR = "src";
 /** Canonical test directory name. @public */
@@ -4409,8 +4383,6 @@ export declare function findOwningWorkspace(workspaces: ReadonlyArray<WorkspaceL
  * @public
  */
 export declare function classifyTestPath(workspaces: ReadonlyArray<WorkspaceLike>, filePath: string): TestPathClassification | null;
-//#endregion
-//#region src/utils/validate-coverage-targets-shape.d.ts
 /** @public */
 export interface CoverageTargetsShapeError {
   readonly code: string;
@@ -4453,8 +4425,6 @@ export interface CoverageTargetsShapeResult {
  * @public
  */
 export declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsShapeResult;
-//#endregion
-//#region src/utils/validate-phase-transition.d.ts
 /** @public */
 export type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
 /** @public */
@@ -4561,8 +4531,6 @@ 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;
-//#endregion
-//#region src/version.d.ts
 /**
  * The version of this package. Inlined at build time from
  * package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
@@ -4576,6 +4544,5 @@ export declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => P
  * @public
  */
 export declare const CURRENT_SDK_VERSION: string;
-//#endregion
 export { FileCoverageReport as CoverageFile };
 //# sourceMappingURL=index.d.ts.map