@vitest-agent/sdk 2.5.0 → 3.0.0

package/services/DataStore.js

@@ -1,8 +1,15 @@
 import { Context } from "effect";
 
 //#region src/services/DataStore.ts
+/**
+* Ceiling on an inline attachment body. Vitest has already copied file
+* attachments into `.vitest/attachments/`, so a large body is referenced
+* by `path` rather than duplicated into `data.db`.
+* @public
+*/
+const INLINE_ATTACHMENT_BODY_CAP_BYTES = 65536;
 /** @public */
 var DataStore = class extends Context.Service()("vitest-agent/DataStore") {};
 
 //#endregion
-export { DataStore };
+export { DataStore, INLINE_ATTACHMENT_BODY_CAP_BYTES };

package/testing/layers.js

@@ -1,6 +1,6 @@
 import { DataReaderLive } from "../layers/DataReaderLive.js";
 import { DataStoreLive } from "../layers/DataStoreLive.js";
-import migration from "../migrations/0001_initial.js";
+import { PROJECT_MIGRATIONS } from "../migrations/index.js";
 import { Layer } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { layer } from "@effect/sql-sqlite-node/SqliteClient";
@@ -11,7 +11,7 @@ import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
 function makeTestLayer(filename) {
 	const SqliteLayer = layer({ filename });
 	const PlatformLayer = NodeServices.layer;
-	const MigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord({ "0001_initial": migration }) }).pipe(Layer.provide(Layer.merge(SqliteLayer, PlatformLayer)));
+	const MigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord(PROJECT_MIGRATIONS) }).pipe(Layer.provide(Layer.merge(SqliteLayer, PlatformLayer)));
 	return Layer.mergeAll(DataStoreLive.pipe(Layer.provide(SqliteLayer)), DataReaderLive.pipe(Layer.provide(SqliteLayer)), MigratorLayer, SqliteLayer, PlatformLayer);
 }
 /** @public */

package/testing.d.ts

@@ -9,7 +9,7 @@ declare const DataStoreError_base: new <A extends Record<string, any> = {}>(args
  * Error raised when a SQLite operation fails at read, write, or migration time.
  * @public
  */
-declare class DataStoreError extends DataStoreError_base<{
+export declare class DataStoreError extends DataStoreError_base<{
   readonly operation: "read" | "write" | "migrate";
   readonly table: string;
   readonly reason: string;
@@ -26,7 +26,7 @@ declare class DataStoreError extends DataStoreError_base<{
  * Complete per-project test report written to disk as JSON.
  * @public
  */
-declare const AgentReport: Schema.Struct<{
+export declare const AgentReport: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly project: Schema.optional<Schema.String>;
   readonly reason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
@@ -100,6 +100,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>;
     readonly targets: Schema.optional<Schema.Struct<{
@@ -114,6 +120,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>>;
     readonly baselines: Schema.optional<Schema.Struct<{
@@ -128,6 +140,12 @@ declare const AgentReport: Schema.Struct<{
         readonly functions: Schema.optional<Schema.Number>;
         readonly branches: Schema.optional<Schema.Number>;
         readonly statements: Schema.optional<Schema.Number>;
+        readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>]>>;
       }>]>>, never>;
     }>>;
     readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -178,14 +196,14 @@ declare const AgentReport: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type AgentReport = typeof AgentReport.Type;
+export type AgentReport = typeof AgentReport.Type;
 //#endregion
 //#region src/schemas/Baselines.d.ts
 /**
  * Coverage baselines -- the auto-ratcheting high-water mark.
  * @public
  */
-declare const CoverageBaselines: Schema.Struct<{
+export declare const CoverageBaselines: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly global: Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
@@ -198,17 +216,23 @@ declare const CoverageBaselines: Schema.Struct<{
     readonly functions: Schema.optional<Schema.Number>;
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
+    readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>]>>;
   }>]>>, never>;
 }>;
 /** @public */
-type CoverageBaselines = typeof CoverageBaselines.Type;
+export type CoverageBaselines = typeof CoverageBaselines.Type;
 //#endregion
 //#region src/schemas/CacheManifest.d.ts
 /**
  * Root manifest file that indexes all project reports.
  * @public
  */
-declare const CacheManifest: Schema.Struct<{
+export declare const CacheManifest: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly cacheDir: Schema.String;
   readonly projects: Schema.$Array<Schema.Struct<{
@@ -220,14 +244,14 @@ declare const CacheManifest: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type CacheManifest = typeof CacheManifest.Type;
+export type CacheManifest = typeof CacheManifest.Type;
 //#endregion
 //#region src/schemas/Coverage.d.ts
 /**
  * Per-file coverage data including uncovered line ranges.
  * @public
  */
-declare const FileCoverageReport: Schema.Struct<{
+export declare const FileCoverageReport: Schema.Struct<{
   readonly file: Schema.String;
   readonly summary: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -238,12 +262,12 @@ declare const FileCoverageReport: Schema.Struct<{
   readonly uncoveredLines: Schema.String;
 }>;
 /** @public */
-type FileCoverageReport = typeof FileCoverageReport.Type;
+export type FileCoverageReport = typeof FileCoverageReport.Type;
 /**
  * Complete coverage report attached to an AgentReport.
  * @public
  */
-declare const CoverageReport: Schema.Struct<{
+export declare const CoverageReport: Schema.Struct<{
   readonly totals: Schema.Struct<{
     readonly statements: Schema.Number;
     readonly branches: Schema.Number;
@@ -262,6 +286,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>;
   readonly targets: Schema.optional<Schema.Struct<{
@@ -276,6 +306,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>>;
   readonly baselines: Schema.optional<Schema.Struct<{
@@ -290,6 +326,12 @@ declare const CoverageReport: Schema.Struct<{
       readonly functions: Schema.optional<Schema.Number>;
       readonly branches: Schema.optional<Schema.Number>;
       readonly statements: Schema.optional<Schema.Number>;
+      readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>]>>;
     }>]>>, never>;
   }>>;
   readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
@@ -319,14 +361,14 @@ declare const CoverageReport: Schema.Struct<{
   readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
 }>;
 /** @public */
-type CoverageReport = typeof CoverageReport.Type;
+export type CoverageReport = typeof CoverageReport.Type;
 //#endregion
 //#region src/schemas/History.d.ts
 /**
  * Per-project history record containing all tracked tests.
  * @public
  */
-declare const HistoryRecord: Schema.Struct<{
+export declare const HistoryRecord: Schema.Struct<{
   readonly project: Schema.String;
   readonly updatedAt: Schema.String;
   readonly tests: Schema.$Array<Schema.Struct<{
@@ -339,19 +381,19 @@ declare const HistoryRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type HistoryRecord = typeof HistoryRecord.Type;
+export type HistoryRecord = typeof HistoryRecord.Type;
 //#endregion
 //#region src/schemas/Tdd.d.ts
 /** @public */
-declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type GoalStatus = typeof GoalStatus.Type;
+export type GoalStatus = typeof GoalStatus.Type;
 /** @public */
-declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type BehaviorStatus = typeof BehaviorStatus.Type;
+export type BehaviorStatus = typeof BehaviorStatus.Type;
 /** @public */
-declare const GoalRow: Schema.Struct<{
+export declare const GoalRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -360,9 +402,9 @@ declare const GoalRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type GoalRow = typeof GoalRow.Type;
+export type GoalRow = typeof GoalRow.Type;
 /** @public */
-declare const BehaviorRow: Schema.Struct<{
+export declare const BehaviorRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -372,9 +414,9 @@ declare const BehaviorRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type BehaviorRow = typeof BehaviorRow.Type;
+export type BehaviorRow = typeof BehaviorRow.Type;
 /** @public */
-declare const GoalDetail: Schema.Struct<{
+export declare const GoalDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -392,9 +434,9 @@ declare const GoalDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type GoalDetail = typeof GoalDetail.Type;
+export type GoalDetail = typeof GoalDetail.Type;
 /** @public */
-declare const BehaviorDetail: Schema.Struct<{
+export declare const BehaviorDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -418,14 +460,14 @@ declare const BehaviorDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type BehaviorDetail = typeof BehaviorDetail.Type;
+export type BehaviorDetail = typeof BehaviorDetail.Type;
 //#endregion
 //#region src/schemas/Trends.d.ts
 /**
  * A single coverage trend data point recorded on a full test run.
  * @public
  */
-declare const TrendEntry: Schema.Struct<{
+export declare const TrendEntry: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly coverage: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -443,12 +485,12 @@ declare const TrendEntry: Schema.Struct<{
   readonly targetsHash: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type TrendEntry = typeof TrendEntry.Type;
+export type TrendEntry = typeof TrendEntry.Type;
 /**
  * Per-project trend record with sliding window of entries.
  * @public
  */
-declare const TrendRecord: Schema.Struct<{
+export declare const TrendRecord: Schema.Struct<{
   readonly entries: Schema.$Array<Schema.Struct<{
     readonly timestamp: Schema.String;
     readonly coverage: Schema.Struct<{
@@ -468,7 +510,7 @@ declare const TrendRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type TrendRecord = typeof TrendRecord.Type;
+export type TrendRecord = typeof TrendRecord.Type;
 //#endregion
 //#region src/utils/validate-phase-transition.d.ts
 /** @public */
@@ -519,9 +561,9 @@ interface CitedArtifact {
  * agent's lifetime.
  * @public
  */
-declare const AgentId: Schema.brand<Schema.String, "AgentId">;
+export declare const AgentId: Schema.brand<Schema.String, "AgentId">;
 /** @public */
-type AgentId = Schema.Schema.Type<typeof AgentId>;
+export type AgentId = Schema.Schema.Type<typeof AgentId>;
 /**
  * The agent host process's chat id (Claude Code's per-process chat
  * UUID, etc.). Shorter-lived than a conversation; one conversation can
@@ -529,9 +571,9 @@ type AgentId = Schema.Schema.Type<typeof AgentId>;
  * `sessions.id` (the SQLite agent-run PK).
  * @public
  */
-declare const ChatId: Schema.brand<Schema.String, "ChatId">;
+export declare const ChatId: Schema.brand<Schema.String, "ChatId">;
 /** @public */
-type ChatId = Schema.Schema.Type<typeof ChatId>;
+export type ChatId = Schema.Schema.Type<typeof ChatId>;
 //#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 & {
@@ -543,7 +585,7 @@ declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(
  * this agent first.
  * @public
  */
-declare class AgentNotFoundError extends AgentNotFoundError_base<{
+export declare class AgentNotFoundError extends AgentNotFoundError_base<{
   readonly agentId: AgentId;
   readonly chatId?: ChatId;
 }> {}
@@ -556,7 +598,7 @@ declare const RegistrationConflictError_base: new <A extends Record<string, any>
  * caller named. Distinct from `IdempotencyHit`, which is a success.
  * @public
  */
-declare class RegistrationConflictError extends RegistrationConflictError_base<{
+export declare class RegistrationConflictError extends RegistrationConflictError_base<{
   readonly reason: string;
 }> {
   constructor(args: {
@@ -569,7 +611,7 @@ declare const GoalNotFoundError_base: new <A extends Record<string, any> = {}>(a
   readonly _tag: "GoalNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class GoalNotFoundError extends GoalNotFoundError_base<{
+export declare class GoalNotFoundError extends GoalNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -582,7 +624,7 @@ declare const BehaviorNotFoundError_base: new <A extends Record<string, any> = {
   readonly _tag: "BehaviorNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
+export declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -595,7 +637,7 @@ declare const TddTaskNotFoundError_base: new <A extends Record<string, any> = {}
   readonly _tag: "TddTaskNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
+export declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -610,7 +652,7 @@ declare const TddTaskAlreadyEndedError_base: new <A extends Record<string, any>
   readonly _tag: "TddTaskAlreadyEndedError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
+export declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
   readonly id: number;
   readonly endedAt: string;
   readonly outcome: TddTaskEndOutcome;
@@ -627,7 +669,7 @@ declare const IllegalStatusTransitionError_base: new <A extends Record<string, a
   readonly _tag: "IllegalStatusTransitionError";
 } & Readonly<A>;
 /** @public */
-declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
+export declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
   readonly entity: IllegalStatusTransitionEntity;
   readonly id: number;
   readonly from: string;
@@ -667,7 +709,7 @@ declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
  * two reveals a mid-session branch switch, which is itself signal.
  * @public
  */
-declare class Agent extends Agent_base {}
+export declare class Agent extends Agent_base {}
 declare const IdempotencyHit_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]; }>) => Readonly<A> & {
   readonly _tag: "IdempotencyHit";
 } & import("effect/Pipeable").Pipeable;
@@ -682,7 +724,7 @@ declare const IdempotencyHit_base: new <A extends Record<string, any> = {}>(args
  * downstream code uses `Match.tag` to branch.
  * @public
  */
-declare class IdempotencyHit extends IdempotencyHit_base<{
+export declare class IdempotencyHit extends IdempotencyHit_base<{
   readonly existingAgentId: typeof AgentId.Type;
 }> {}
 //#endregion
@@ -698,12 +740,23 @@ declare const ResolvedThresholds: Schema.Struct<{
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
   }>;
-  readonly perFile: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+  readonly perFile: Schema.withDecodingDefaultKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>, never>;
   readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
     readonly functions: Schema.optional<Schema.Number>;
     readonly branches: Schema.optional<Schema.Number>;
     readonly statements: Schema.optional<Schema.Number>;
+    readonly perFile: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>]>>;
   }>]>>, never>;
 }>;
 /** @public */
@@ -877,6 +930,41 @@ interface TestErrorInput {
   readonly ordinal?: number;
 }
 /** @public */
+interface TestAttachmentInput {
+  readonly contentType?: string;
+  /** Post-resolution path under `.vitest/attachments/`, or an http(s) URL. */
+  readonly path?: string;
+  /** Inline body; persisted only when `byteSize` is under the 64 KiB cap. */
+  readonly body?: string;
+  /** How to read `body`. Vitest treats a string body as base64 unless `"utf-8"`. */
+  readonly bodyEncoding?: "base64" | "utf-8";
+  readonly byteSize: number;
+}
+/** @public */
+interface TestAnnotationInput {
+  readonly testCaseId: number;
+  /** Arbitrary Vitest annotation type -- not an enum. */
+  readonly type: string;
+  readonly message: string;
+  readonly locationFile?: string;
+  readonly locationLine?: number;
+  readonly locationColumn?: number;
+  readonly attachments?: ReadonlyArray<TestAttachmentInput>;
+}
+/** @public */
+interface TestArtifactInput {
+  readonly testCaseId: number;
+  /** `pkg:name`; `internal:` types are Vitest's own and are never written. */
+  readonly type: string;
+  readonly message?: string;
+  /** JSON of the artifact's custom fields, minus attachments and location. */
+  readonly data?: string;
+  readonly locationFile?: string;
+  readonly locationLine?: number;
+  readonly locationColumn?: number;
+  readonly attachments?: ReadonlyArray<TestAttachmentInput>;
+}
+/** @public */
 interface FileCoverageInput {
   readonly fileId: number;
   readonly statements: number;
@@ -1090,6 +1178,17 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   readonly writeSuites: (moduleId: number, suites: ReadonlyArray<SuiteInput>) => Effect.Effect<ReadonlyArray<number>, DataStoreError>;
   readonly writeTestCases: (moduleId: number, tests: ReadonlyArray<TestCaseInput>) => Effect.Effect<ReadonlyArray<number>, DataStoreError>;
   readonly writeErrors: (runId: number, errors: ReadonlyArray<TestErrorInput>) => Effect.Effect<void, DataStoreError>;
+  /**
+   * Persist `context.annotate` notes and their attachment descriptors.
+   * `runId` is carried for log correlation only -- `test_annotations`
+   * rows are reachable through `test_cases`.
+   */
+  readonly writeAnnotations: (runId: number, annotations: ReadonlyArray<TestAnnotationInput>) => Effect.Effect<void, DataStoreError>;
+  /**
+   * Persist `recordArtifact` payloads and their attachment
+   * descriptors. `runId` is carried for log correlation only.
+   */
+  readonly writeArtifacts: (runId: number, artifacts: ReadonlyArray<TestArtifactInput>) => Effect.Effect<void, DataStoreError>;
   readonly writeCoverage: (runId: number, coverage: ReadonlyArray<FileCoverageInput>) => Effect.Effect<void, DataStoreError>;
   readonly writeHistory: (project: string, fullName: string, modulePath: string, runId: number, timestamp: string, state: string, duration: number | null, flaky: boolean, retryCount: number, errorMessage: string | null) => Effect.Effect<void, DataStoreError>;
   readonly writeBaselines: (baselines: CoverageBaselines) => Effect.Effect<void, DataStoreError>;
@@ -1187,7 +1286,7 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   readonly endAgent: (agentId: string, endedAt: number) => Effect.Effect<void, AgentNotFoundError | DataStoreError>;
 }>;
 /** @public */
-declare class DataStore extends DataStore_base {}
+export declare class DataStore extends DataStore_base {}
 //#endregion
 //#region src/services/DataReader.d.ts
 /** @public */
@@ -1515,6 +1614,45 @@ interface TagInventoryRow {
    */
   readonly testCount: number;
 }
+/** @public */
+interface TestArtifactQueryOptions {
+  /** Disambiguates a fullName that exists in more than one module. */
+  readonly modulePath?: string;
+}
+/** @public */
+interface PersistedAttachment {
+  readonly contentType?: string;
+  readonly path?: string;
+  readonly body?: string;
+  /** How to read `body`. Absent when nothing was stored inline. */
+  readonly bodyEncoding?: "base64" | "utf-8";
+  readonly byteSize: number | null;
+}
+/** @public */
+interface TestAnnotationRow {
+  readonly id: number;
+  readonly type: string;
+  readonly message: string;
+  readonly location?: {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+  };
+  readonly attachments: ReadonlyArray<PersistedAttachment>;
+}
+/** @public */
+interface TestArtifactRow {
+  readonly id: number;
+  readonly type: string;
+  readonly message: string | null;
+  readonly data: string | null;
+  readonly location?: {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+  };
+  readonly attachments: ReadonlyArray<PersistedAttachment>;
+}
 declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/DataReader", {
   readonly getLatestRun: (project: string) => Effect.Effect<Option.Option<AgentReport>, DataStoreError>;
   readonly getRunsByProject: () => Effect.Effect<ReadonlyArray<ProjectRunSummary>, DataStoreError>;
@@ -1527,6 +1665,10 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   readonly getCoverage: (project: string) => Effect.Effect<Option.Option<CoverageReport>, DataStoreError>;
   readonly getTestsForFile: (filePath: string) => Effect.Effect<ReadonlyArray<string>, DataStoreError>;
   readonly getErrors: (project: string, errorName?: string) => Effect.Effect<ReadonlyArray<TestError>, DataStoreError>;
+  /** Annotations recorded for a test in the project's latest run. */
+  readonly getAnnotationsForTest: (project: string, fullName: string, options?: TestArtifactQueryOptions) => Effect.Effect<ReadonlyArray<TestAnnotationRow>, DataStoreError>;
+  /** Artifacts recorded for a test in the project's latest run. */
+  readonly getArtifactsForTest: (project: string, fullName: string, options?: TestArtifactQueryOptions) => Effect.Effect<ReadonlyArray<TestArtifactRow>, DataStoreError>;
   readonly getNotes: (scope?: string, project?: string, testFullName?: string) => Effect.Effect<ReadonlyArray<NoteRow>, DataStoreError>;
   readonly getNoteById: (id: number) => Effect.Effect<Option.Option<NoteRow>, DataStoreError>;
   readonly searchNotes: (query: string) => Effect.Effect<ReadonlyArray<NoteRow>, DataStoreError>;
@@ -1675,25 +1817,46 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   }) => Effect.Effect<ReadonlyArray<TestListEntry>, DataStoreError>;
 }>;
 /** @public */
-declare class DataReader extends DataReader_base {}
+export declare class DataReader extends DataReader_base {}
+//#endregion
+//#region src/migrations/index.d.ts
+/**
+ * Every migration that must run against a per-project `data.db`, keyed by
+ * migration id in application order.
+ *
+ * This is the single source of truth for the project database's migration
+ * set: `ensureMigrated`, the sdk testing layer, `ReporterLive`, `McpLive`,
+ * `CliLive` and `SidecarLive` all pass it straight to
+ * `SqliteMigrator.fromRecord`, so adding a migration file and registering it
+ * here is enough to reach every process that opens a project database.
+ *
+ * The session-map and discovery-registry databases are separate schemas with
+ * their own migrations and are deliberately not listed here.
+ *
+ * @public
+ */
+export declare const PROJECT_MIGRATIONS: {
+  readonly "0001_initial": import("effect/Effect").Effect<void, import("effect/unstable/sql/SqlError").SqlError, import("effect/unstable/sql/SqlClient").SqlClient>;
+  readonly "0002_test_artifacts": import("effect/Effect").Effect<void, import("effect/unstable/sql/SqlError").SqlError, import("effect/unstable/sql/SqlClient").SqlClient>;
+};
 //#endregion
 //#region src/testing/layers.d.ts
 /** @public */
-declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 //#endregion
 //#region src/testing/index.d.ts
 /** @public */
-declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, BehaviorNotFoundError | DataStoreError | GoalNotFoundError | IllegalStatusTransitionError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError | TddTaskAlreadyEndedError | TddTaskNotFoundError, never>;
+export declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, BehaviorNotFoundError | DataStoreError | GoalNotFoundError | IllegalStatusTransitionError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError | TddTaskAlreadyEndedError | TddTaskNotFoundError, never>;
 //#endregion
-export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type ArtifactSuite, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataReader, DataStore, DataStoreError, DataStoreTestLayer, type EndTddTaskInput, type FailureSignatureDetail, type FailureSignatureWriteInput, type FileCoverageInput, FileCoverageReport, type FlakyTest, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, type HistoryQueryOptions, HistoryRecord, type HypothesisDetail, type HypothesisInput, IdempotencyHit, type IdempotentResponseInput, type IllegalStatusTransitionEntity, IllegalStatusTransitionError, type ModuleInput, type ModuleListEntry, type NoteInput, type NoteRow, type PersistentFailure, type Phase, type ProjectRunSummary, type RegisterAgentInput, RegistrationConflictError, type ResolvedThresholds, type RunChangedFile, type RunInvocationMethod, type SessionDetail, type SessionInput, type SettingsInput, type SettingsListEntry, type SettingsRow, type StackFrameInput, type SuiteInput, type SuiteListEntry, type TagInventoryRow, type TddArtifactDetail, type TddArtifactRow, type TddPhaseDetail, TddTaskAlreadyEndedError, type TddTaskDetail, type TddTaskEndOutcome, type TddTaskInput, TddTaskNotFoundError, type TddTaskSummary, type TestCaseInput, type TestError, type TestErrorInput, type TestListEntry, type TestLookupOptions, type TestRunInput, TrendEntry, TrendRecord, type TurnInput, type TurnSearchOptions, type TurnSummary, type UpdateBehaviorInput, type UpdateGoalInput, type ValidateHypothesisInput, type WriteCommitInput, type WriteRunChangedFilesInput, type WriteTddArtifactInput, type WriteTddPhaseInput, type WriteTddPhaseOutput, empty, flaky, makeTestLayer, singlePassingRun, withFailures, withTddTask };
+export type { AcceptanceMetrics, ArtifactKind, ArtifactSuite, AssociateRunSessionInput, ChangeKind, CitedArtifact, CitedArtifactRow, ClassificationQueryOptions, CommitChangesEntry, CreateBehaviorInput, CreateGoalInput, CurrentTddPhase, EndTddTaskInput, FailureSignatureDetail, FailureSignatureWriteInput, FileCoverageInput, FlakyTest, HistoryQueryOptions, HypothesisDetail, HypothesisInput, IdempotentResponseInput, IllegalStatusTransitionEntity, ModuleInput, ModuleListEntry, NoteInput, NoteRow, PersistedAttachment, PersistentFailure, Phase, ProjectRunSummary, RegisterAgentInput, ResolvedThresholds, RunChangedFile, RunInvocationMethod, SessionDetail, SessionInput, SettingsInput, SettingsListEntry, SettingsRow, StackFrameInput, SuiteInput, SuiteListEntry, TagInventoryRow, TddArtifactDetail, TddArtifactRow, TddPhaseDetail, TddTaskDetail, TddTaskEndOutcome, TddTaskInput, TddTaskSummary, TestAnnotationInput, TestAnnotationRow, TestArtifactInput, TestArtifactQueryOptions, TestArtifactRow, TestAttachmentInput, TestCaseInput, TestError, TestErrorInput, TestListEntry, TestLookupOptions, TestRunInput, TurnInput, TurnSearchOptions, TurnSummary, UpdateBehaviorInput, UpdateGoalInput, ValidateHypothesisInput, WriteCommitInput, WriteRunChangedFilesInput, WriteTddArtifactInput, WriteTddPhaseInput, WriteTddPhaseOutput };
 //# sourceMappingURL=testing.d.ts.map