@vitest-agent/sdk 7.0.4 → 7.1.0

package/index.js

@@ -16,7 +16,7 @@ import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } f
 import { CoverageBaselines } from "./schemas/Baselines.js";
 import { CacheManifest, CacheManifestEntry } from "./schemas/CacheManifest.js";
 import { BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorsReadyEvent, BlockedEvent, ChannelEvent, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalStartedEvent, GoalsReadyEvent, PhaseTransitionEvent, SessionCompleteEvent, SessionOutcome } from "./schemas/ChannelEvent.js";
-import { VitestAgentConfig } from "./schemas/Config.js";
+import { RetentionConfig, RunRetentionPolicy, VitestAgentConfig } from "./schemas/Config.js";
 import { CoverageLevel, resolveCoverageInput, validateCoverageConfig } from "./schemas/CoverageLevel.js";
 import { CoverageTargets, CoverageTargetsMetrics } from "./schemas/CoverageTargets.js";
 import { HistoryRecord, TestHistory, TestRun } from "./schemas/History.js";
@@ -64,4 +64,4 @@ import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-
 import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "./utils/validate-phase-transition.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, 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, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, 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, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, normalizeWorkspaceKey, osc8, 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, 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, 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, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, formatStrayOutputNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isEscapeOnly, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, makeStrayOutputRecorder, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, readStrayOutput, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/internal-inject-env.js

@@ -1,6 +1,6 @@
 import { detectVitestScripts, rewriteBashCommand } from "./utils/match-vitest-command.js";
 
-//#region src/internal-inject-env.ts
+// src/internal-inject-env.ts
 const readPackageScripts = (cwd, readFile) => {
 	try {
 		const raw = readFile(`${cwd}/package.json`);
@@ -37,5 +37,4 @@ const injectEnv = (input) => {
 	});
 };
 
-//#endregion
 export { injectEnv };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "7.0.4",
+	"version": "7.1.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": [
@@ -43,7 +43,7 @@
 	"dependencies": {
 		"acorn": "^8.19.0",
 		"acorn-typescript": "^1.4.13",
-		"effect": "^4.0.5"
+		"effect": "^4.0.6"
 	},
 	"engines": {
 		"node": ">=24.11.0"

package/schemas/5.0/run.json

@@ -73,15 +73,11 @@
 				"modules": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -165,15 +161,11 @@
 				"duration": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -239,15 +231,11 @@
 				"duration": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -334,15 +322,11 @@
 				"lines": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -352,15 +336,11 @@
 				"functions": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -370,15 +350,11 @@
 				"branches": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -388,15 +364,11 @@
 				"statements": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -422,15 +394,11 @@
 				"lines": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -440,15 +408,11 @@
 				"functions": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -458,15 +422,11 @@
 				"branches": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -476,15 +436,11 @@
 				"statements": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -629,15 +585,11 @@
 				"totalFiles": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -705,15 +657,11 @@
 				"passed": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -723,15 +671,11 @@
 				"failed": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"
@@ -741,15 +685,11 @@
 				"skipped": {
 					"anyOf": [
 						{
-							"anyOf": [
-								{
-									"type": "number"
-								},
-								{
-									"type": "string",
-									"enum": ["Infinity", "-Infinity", "NaN"]
-								}
-							]
+							"type": "number"
+						},
+						{
+							"type": "string",
+							"enum": ["Infinity", "-Infinity", "NaN"]
 						},
 						{
 							"type": "null"

package/schemas/Agent.js

@@ -1,7 +1,7 @@
 import { AgentId, ConversationId } from "./Identity.js";
 import { Data, Schema } from "effect";
 
-//#region src/schemas/Agent.ts
+// src/schemas/Agent.ts
 /**
 * Successful registration row. The fields mirror the `agents` SQLite
 * table 1:1 in camelCase.
@@ -38,5 +38,4 @@ var Agent = class extends Schema.TaggedClass()("Agent", {
 */
 var IdempotencyHit = class extends Data.TaggedClass("IdempotencyHit") {};
 
-//#endregion
 export { Agent, IdempotencyHit };

package/schemas/AgentReport.js

@@ -4,7 +4,7 @@ import { CoverageReport } from "./Coverage.js";
 import { StrayOutput } from "./StrayOutput.js";
 import { Schema } from "effect";
 
-//#region src/schemas/AgentReport.ts
+// src/schemas/AgentReport.ts
 /**
 * Aggregate test run statistics.
 * @public
@@ -76,5 +76,4 @@ const AgentReport = Schema.Struct({
 	strayOutput: Schema.optional(StrayOutput)
 }).annotate({ identifier: "AgentReport" });
 
-//#endregion
 export { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport };

package/schemas/Baselines.js

@@ -1,7 +1,7 @@
 import { MetricThresholds, PatternThresholds } from "./Thresholds.js";
 import { Effect, Schema } from "effect";
 
-//#region src/schemas/Baselines.ts
+// src/schemas/Baselines.ts
 /**
 * Coverage baselines -- the auto-ratcheting high-water mark.
 * @public
@@ -12,5 +12,4 @@ const CoverageBaselines = Schema.Struct({
 	patterns: Schema.Array(PatternThresholds).pipe(Schema.withDecodingDefaultKey(Effect.succeed([])))
 }).annotate({ identifier: "CoverageBaselines" });
 
-//#endregion
 export { CoverageBaselines };

package/schemas/CacheManifest.js

@@ -1,7 +1,7 @@
 import { TestRunReason } from "./Common.js";
 import { Schema } from "effect";
 
-//#region src/schemas/CacheManifest.ts
+// src/schemas/CacheManifest.ts
 /**
 * A single project entry in the cache manifest.
 * @public
@@ -23,5 +23,4 @@ const CacheManifest = Schema.Struct({
 	projects: Schema.Array(CacheManifestEntry)
 }).annotate({ identifier: "CacheManifest" });
 
-//#endregion
 export { CacheManifest, CacheManifestEntry };

package/schemas/ChannelEvent.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/ChannelEvent.ts
+// src/schemas/ChannelEvent.ts
 /** @public */
 const SessionOutcome = Schema.Literals([
 	"succeeded",
@@ -151,5 +151,4 @@ const BehaviorScopedEventTypes = [
 	"blocked"
 ];
 
-//#endregion
 export { BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorsReadyEvent, BlockedEvent, ChannelEvent, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalStartedEvent, GoalsReadyEvent, PhaseTransitionEvent, SessionCompleteEvent, SessionOutcome };

package/schemas/Common.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/Common.ts
+// src/schemas/Common.ts
 /**
 * Possible states for an individual test case.
 * @public
@@ -145,5 +145,4 @@ const ReportError = Schema.Struct({
 	received: Schema.optional(Schema.String)
 }).annotate({ identifier: "ReportError" });
 
-//#endregion
 export { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, PackageManager, ReportError, TestClassification, TestRunReason, TestState };

package/schemas/Config.js

@@ -1,12 +1,42 @@
-import { Schema } from "effect";
+import { Option, Schema } from "effect";
 
-//#region src/schemas/Config.ts
+// src/schemas/Config.ts
+/** A whole number of runs or days, at least one. */
+const PositiveInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+/**
+* 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
+*/
+var RetentionConfig = class extends Schema.Class("RetentionConfig")({
+	enabled: Schema.optionalKey(Schema.Boolean),
+	keepRuns: Schema.optionalKey(PositiveInt),
+	maxAgeDays: Schema.optionalKey(PositiveInt)
+}) {};
 /**
 * 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
@@ -17,12 +47,48 @@ import { Schema } from "effect";
 *   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
 */
 var VitestAgentConfig = class extends Schema.Class("VitestAgentConfig")({
 	cacheDir: Schema.optional(Schema.String),
-	projectKey: Schema.optional(Schema.String)
+	projectKey: Schema.optional(Schema.String),
+	retention: Schema.optionalKey(RetentionConfig)
 }) {};
+/**
+* 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
+*/
+var RunRetentionPolicy = class RunRetentionPolicy extends Schema.Class("RunRetentionPolicy")({
+	keepRuns: PositiveInt,
+	maxAgeDays: Schema.optionalKey(PositiveInt)
+}) {
+	/** Newest runs per project kept when the config names no `keepRuns`. */
+	static 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) {
+		const retention = config.retention;
+		if (retention?.enabled === false) return Option.none();
+		return Option.some(RunRetentionPolicy.make({
+			keepRuns: retention?.keepRuns ?? RunRetentionPolicy.DEFAULT_KEEP_RUNS,
+			...retention?.maxAgeDays !== void 0 && { maxAgeDays: retention.maxAgeDays }
+		}));
+	}
+};
 
-//#endregion
-export { VitestAgentConfig };
+export { RetentionConfig, RunRetentionPolicy, VitestAgentConfig };

package/schemas/ConsoleLeaks.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/ConsoleLeaks.ts
+// src/schemas/ConsoleLeaks.ts
 /**
 * Per-file stray-console-output detail. Counts are of console writes
 * (one `console.*` call), not lines.
@@ -41,5 +41,4 @@ const ConsoleLeaks = Schema.Struct({
 	fromFailingTests: Schema.optional(ConsoleLeaksFromFailingTests)
 }).annotate({ identifier: "ConsoleLeaks" });
 
-//#endregion
 export { ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests };

package/schemas/Coverage.js

@@ -1,7 +1,7 @@
 import { MetricThresholds, PatternThresholds } from "./Thresholds.js";
 import { Effect, Schema } from "effect";
 
-//#region src/schemas/Coverage.ts
+// src/schemas/Coverage.ts
 /**
 * Aggregate coverage percentages across four istanbul metrics.
 * @public
@@ -66,5 +66,4 @@ const CoverageReport = Schema.Struct({
 	globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 }).annotate({ identifier: "CoverageReport" });
 
-//#endregion
 export { CoverageReport, CoverageTotals, FileCoverageReport, GlobShortfall };

package/schemas/CoverageLevel.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/CoverageLevel.ts
+// src/schemas/CoverageLevel.ts
 /**
 * A coverage level configuration with per-metric thresholds and an optional
 * perFile flag. Extend this class to define custom named presets.
@@ -113,5 +113,4 @@ function validateCoverageConfig(thresholds, targets) {
 	if (targets.perFile === true && thresholds.perFile !== true) throw new Error("[vitest-agent] coverageTargets sets perFile: true but coverageThresholds does not. Both must agree on perFile.");
 }
 
-//#endregion
 export { CoverageLevel, resolveCoverageInput, validateCoverageConfig };

package/schemas/CoverageTargets.js

@@ -1,7 +1,7 @@
 import { PerFileThresholds } from "./Thresholds.js";
 import { Schema } from "effect";
 
-//#region src/schemas/CoverageTargets.ts
+// src/schemas/CoverageTargets.ts
 /**
 * A strictly-positive coverage percentage. Negatives and zeros are rejected
 * at decode time.
@@ -46,5 +46,4 @@ const CoverageTargets = Schema.Record(Schema.String, Schema.Union([
 	for (const [key, value] of Object.entries(targets)) if (value === true && key !== "100") return `coverageTargets.${key} cannot be true. The "true" shorthand is only valid at key "100" (meaning 100% across all metrics).`;
 })).annotate({ identifier: "CoverageTargets" });
 
-//#endregion
 export { CoverageTargets, CoverageTargetsMetrics };

package/schemas/History.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/History.ts
+// src/schemas/History.ts
 /**
 * A single test run outcome (pass or fail only).
 * @public
@@ -28,5 +28,4 @@ const HistoryRecord = Schema.Struct({
 	tests: Schema.Array(TestHistory)
 }).annotate({ identifier: "HistoryRecord" });
 
-//#endregion
 export { HistoryRecord, TestHistory, TestRun };

package/schemas/Identity.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/schemas/Identity.ts
+// src/schemas/Identity.ts
 /**
 * Canonical UUID for an LLM agent invocation. Generated server-side at
 * `register_agent` time. Stable across transport reconnects within an
@@ -72,5 +72,4 @@ const HostKind = Schema.Literals([
 	"unknown"
 ]).annotate({ identifier: "HostKind" });
 
-//#endregion
 export { ActorType, AgentId, ChatId, ConversationId, HostKind, ProjectKey, TddTaskId };