@vitest-agent/sdk 3.1.2 → 4.0.0

package/testing.d.ts

@@ -1,1862 +0,0 @@
-import { Context, Effect, Layer, Option, Schema } from "effect";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
-//#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>;
-/**
- * Error raised when a SQLite operation fails at read, write, or migration time.
- * @public
- */
-export declare class DataStoreError extends DataStoreError_base<{
-  readonly operation: "read" | "write" | "migrate";
-  readonly table: string;
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly operation: "read" | "write" | "migrate";
-    readonly table: string;
-    readonly reason: string;
-  });
-}
-//#endregion
-//#region src/schemas/AgentReport.d.ts
-/**
- * Complete per-project test report written to disk as JSON.
- * @public
- */
-export declare const AgentReport: Schema.Struct<{
-  readonly timestamp: Schema.String;
-  readonly project: Schema.optional<Schema.String>;
-  readonly reason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
-  readonly summary: Schema.Struct<{
-    readonly total: Schema.Number;
-    readonly passed: Schema.Number;
-    readonly failed: Schema.Number;
-    readonly skipped: Schema.Number;
-    readonly duration: Schema.Number;
-    /**
-     * Count of every collected module, passing modules included.
-     * `AgentReport.failed` only carries failing modules, so a green run
-     * has no other way to know how many files actually ran — without
-     * this a fully-passing replay reads as "0 modules all-passed"
-     * (issue #204). Optional to keep existing fixtures/reports valid.
-     */
-    readonly modules: Schema.optional<Schema.Number>;
-  }>;
-  readonly failed: Schema.$Array<Schema.Struct<{
-    readonly file: Schema.String;
-    readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
-    readonly duration: Schema.optional<Schema.Number>;
-    readonly errors: Schema.optional<Schema.$Array<Schema.Struct<{
-      readonly message: Schema.String;
-      readonly stack: Schema.optional<Schema.String>;
-      readonly diff: Schema.optional<Schema.String>;
-      readonly expected: Schema.optional<Schema.String>;
-      readonly received: Schema.optional<Schema.String>;
-    }>>>;
-    readonly tests: Schema.$Array<Schema.Struct<{
-      readonly name: Schema.String;
-      readonly fullName: Schema.String;
-      readonly state: Schema.Literals<readonly ["passed", "failed", "skipped", "pending"]>;
-      readonly duration: Schema.optional<Schema.Number>;
-      readonly flaky: Schema.optional<Schema.Boolean>;
-      readonly slow: Schema.optional<Schema.Boolean>;
-      readonly errors: Schema.optional<Schema.$Array<Schema.Struct<{
-        readonly message: Schema.String;
-        readonly stack: Schema.optional<Schema.String>;
-        readonly diff: Schema.optional<Schema.String>;
-        readonly expected: Schema.optional<Schema.String>;
-        readonly received: Schema.optional<Schema.String>;
-      }>>>;
-      readonly classification: Schema.optional<Schema.Literals<readonly ["stable", "new-failure", "persistent", "flaky", "recovered"]>>;
-    }>>;
-  }>>;
-  readonly unhandledErrors: Schema.$Array<Schema.Struct<{
-    readonly message: Schema.String;
-    readonly stack: Schema.optional<Schema.String>;
-    readonly diff: Schema.optional<Schema.String>;
-    readonly expected: Schema.optional<Schema.String>;
-    readonly received: Schema.optional<Schema.String>;
-  }>>;
-  readonly failedFiles: Schema.$Array<Schema.String>;
-  readonly coverage: Schema.optional<Schema.Struct<{
-    readonly totals: Schema.Struct<{
-      readonly statements: Schema.Number;
-      readonly branches: Schema.Number;
-      readonly functions: Schema.Number;
-      readonly lines: Schema.Number;
-    }>;
-    readonly thresholds: Schema.Struct<{
-      readonly global: 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 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>;
-    }>;
-    readonly targets: Schema.optional<Schema.Struct<{
-      readonly global: 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 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>;
-    }>>;
-    readonly baselines: Schema.optional<Schema.Struct<{
-      readonly global: 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 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>;
-    }>>;
-    readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
-    readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
-    readonly totalFiles: Schema.optional<Schema.Number>;
-    readonly lowCoverage: Schema.$Array<Schema.Struct<{
-      readonly file: Schema.String;
-      readonly summary: Schema.Struct<{
-        readonly statements: Schema.Number;
-        readonly branches: Schema.Number;
-        readonly functions: Schema.Number;
-        readonly lines: Schema.Number;
-      }>;
-      readonly uncoveredLines: Schema.String;
-    }>>;
-    readonly lowCoverageFiles: Schema.$Array<Schema.String>;
-    readonly belowTarget: Schema.optional<Schema.$Array<Schema.Struct<{
-      readonly file: Schema.String;
-      readonly summary: Schema.Struct<{
-        readonly statements: Schema.Number;
-        readonly branches: Schema.Number;
-        readonly functions: Schema.Number;
-        readonly lines: Schema.Number;
-      }>;
-      readonly uncoveredLines: Schema.String;
-    }>>>;
-    readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
-  }>>;
-  readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
-    readonly passed: Schema.optional<Schema.Number>;
-    readonly failed: Schema.optional<Schema.Number>;
-    readonly skipped: Schema.optional<Schema.Number>;
-  }>>>;
-  readonly consoleLeaks: Schema.optional<Schema.Struct<{
-    readonly total: Schema.Number;
-    readonly byFile: Schema.$Array<Schema.Struct<{
-      readonly file: Schema.String;
-      readonly stdout: Schema.Number;
-      readonly stderr: Schema.Number;
-      readonly tests: Schema.optional<Schema.$Array<Schema.String>>;
-      readonly sample: Schema.optional<Schema.String>;
-    }>>;
-    readonly truncated: Schema.optional<Schema.Boolean>;
-    readonly fromFailingTests: Schema.optional<Schema.Struct<{
-      readonly total: Schema.Number;
-      readonly files: Schema.Number;
-    }>>;
-  }>>;
-}>;
-/** @public */
-export type AgentReport = typeof AgentReport.Type;
-//#endregion
-//#region src/schemas/Baselines.d.ts
-/**
- * Coverage baselines -- the auto-ratcheting high-water mark.
- * @public
- */
-export declare const CoverageBaselines: Schema.Struct<{
-  readonly updatedAt: Schema.String;
-  readonly global: 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 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 */
-export type CoverageBaselines = typeof CoverageBaselines.Type;
-//#endregion
-//#region src/schemas/CacheManifest.d.ts
-/**
- * Root manifest file that indexes all project reports.
- * @public
- */
-export declare const CacheManifest: Schema.Struct<{
-  readonly updatedAt: Schema.String;
-  readonly cacheDir: Schema.String;
-  readonly projects: Schema.$Array<Schema.Struct<{
-    readonly project: Schema.String;
-    readonly reportFile: Schema.String;
-    readonly historyFile: Schema.optional<Schema.String>;
-    readonly lastRun: Schema.NullOr<Schema.String>;
-    readonly lastResult: Schema.NullOr<Schema.Literals<readonly ["passed", "failed", "interrupted"]>>;
-  }>>;
-}>;
-/** @public */
-export type CacheManifest = typeof CacheManifest.Type;
-//#endregion
-//#region src/schemas/Coverage.d.ts
-/**
- * Per-file coverage data including uncovered line ranges.
- * @public
- */
-export declare const FileCoverageReport: Schema.Struct<{
-  readonly file: Schema.String;
-  readonly summary: Schema.Struct<{
-    readonly statements: Schema.Number;
-    readonly branches: Schema.Number;
-    readonly functions: Schema.Number;
-    readonly lines: Schema.Number;
-  }>;
-  readonly uncoveredLines: Schema.String;
-}>;
-/** @public */
-export type FileCoverageReport = typeof FileCoverageReport.Type;
-/**
- * Complete coverage report attached to an AgentReport.
- * @public
- */
-export declare const CoverageReport: Schema.Struct<{
-  readonly totals: Schema.Struct<{
-    readonly statements: Schema.Number;
-    readonly branches: Schema.Number;
-    readonly functions: Schema.Number;
-    readonly lines: Schema.Number;
-  }>;
-  readonly thresholds: Schema.Struct<{
-    readonly global: 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 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>;
-  }>;
-  readonly targets: Schema.optional<Schema.Struct<{
-    readonly global: 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 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>;
-  }>>;
-  readonly baselines: Schema.optional<Schema.Struct<{
-    readonly global: 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 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>;
-  }>>;
-  readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
-  readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
-  readonly totalFiles: Schema.optional<Schema.Number>;
-  readonly lowCoverage: Schema.$Array<Schema.Struct<{
-    readonly file: Schema.String;
-    readonly summary: Schema.Struct<{
-      readonly statements: Schema.Number;
-      readonly branches: Schema.Number;
-      readonly functions: Schema.Number;
-      readonly lines: Schema.Number;
-    }>;
-    readonly uncoveredLines: Schema.String;
-  }>>;
-  readonly lowCoverageFiles: Schema.$Array<Schema.String>;
-  readonly belowTarget: Schema.optional<Schema.$Array<Schema.Struct<{
-    readonly file: Schema.String;
-    readonly summary: Schema.Struct<{
-      readonly statements: Schema.Number;
-      readonly branches: Schema.Number;
-      readonly functions: Schema.Number;
-      readonly lines: Schema.Number;
-    }>;
-    readonly uncoveredLines: Schema.String;
-  }>>>;
-  readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
-}>;
-/** @public */
-export type CoverageReport = typeof CoverageReport.Type;
-//#endregion
-//#region src/schemas/History.d.ts
-/**
- * Per-project history record containing all tracked tests.
- * @public
- */
-export declare const HistoryRecord: Schema.Struct<{
-  readonly project: Schema.String;
-  readonly updatedAt: Schema.String;
-  readonly tests: Schema.$Array<Schema.Struct<{
-    readonly modulePath: Schema.String;
-    readonly fullName: Schema.String;
-    readonly runs: Schema.$Array<Schema.Struct<{
-      readonly timestamp: Schema.String;
-      readonly state: Schema.Literals<readonly ["passed", "failed"]>;
-    }>>;
-  }>>;
-}>;
-/** @public */
-export type HistoryRecord = typeof HistoryRecord.Type;
-//#endregion
-//#region src/schemas/Tdd.d.ts
-/** @public */
-export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-/** @public */
-export type GoalStatus = typeof GoalStatus.Type;
-/** @public */
-export declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-/** @public */
-export type BehaviorStatus = typeof BehaviorStatus.Type;
-/** @public */
-export declare const GoalRow: Schema.Struct<{
-  readonly id: Schema.Number;
-  readonly sessionId: Schema.Number;
-  readonly ordinal: Schema.Number;
-  readonly goal: Schema.String;
-  readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-  readonly createdAt: Schema.String;
-}>;
-/** @public */
-export type GoalRow = typeof GoalRow.Type;
-/** @public */
-export declare const BehaviorRow: Schema.Struct<{
-  readonly id: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly ordinal: Schema.Number;
-  readonly behavior: Schema.String;
-  readonly suggestedTestName: Schema.NullOr<Schema.String>;
-  readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-  readonly createdAt: Schema.String;
-}>;
-/** @public */
-export type BehaviorRow = typeof BehaviorRow.Type;
-/** @public */
-export declare const GoalDetail: Schema.Struct<{
-  readonly id: Schema.Number;
-  readonly sessionId: Schema.Number;
-  readonly ordinal: Schema.Number;
-  readonly goal: Schema.String;
-  readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-  readonly createdAt: Schema.String;
-  readonly behaviors: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly goalId: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly behavior: Schema.String;
-    readonly suggestedTestName: Schema.NullOr<Schema.String>;
-    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-    readonly createdAt: Schema.String;
-  }>>;
-}>;
-/** @public */
-export type GoalDetail = typeof GoalDetail.Type;
-/** @public */
-export declare const BehaviorDetail: Schema.Struct<{
-  readonly id: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly ordinal: Schema.Number;
-  readonly behavior: Schema.String;
-  readonly suggestedTestName: Schema.NullOr<Schema.String>;
-  readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-  readonly createdAt: Schema.String;
-  readonly parentGoal: Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly goal: Schema.String;
-    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-  }>;
-  readonly dependencies: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly goalId: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly behavior: Schema.String;
-    readonly suggestedTestName: Schema.NullOr<Schema.String>;
-    readonly status: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
-    readonly createdAt: Schema.String;
-  }>>;
-}>;
-/** @public */
-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
- */
-export declare const TrendEntry: Schema.Struct<{
-  readonly timestamp: Schema.String;
-  readonly coverage: Schema.Struct<{
-    readonly statements: Schema.Number;
-    readonly branches: Schema.Number;
-    readonly functions: Schema.Number;
-    readonly lines: Schema.Number;
-  }>;
-  readonly delta: Schema.Struct<{
-    readonly statements: Schema.Number;
-    readonly branches: Schema.Number;
-    readonly functions: Schema.Number;
-    readonly lines: Schema.Number;
-  }>;
-  readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
-  readonly targetsHash: Schema.optional<Schema.String>;
-}>;
-/** @public */
-export type TrendEntry = typeof TrendEntry.Type;
-/**
- * Per-project trend record with sliding window of entries.
- * @public
- */
-export declare const TrendRecord: Schema.Struct<{
-  readonly entries: Schema.$Array<Schema.Struct<{
-    readonly timestamp: Schema.String;
-    readonly coverage: Schema.Struct<{
-      readonly statements: Schema.Number;
-      readonly branches: Schema.Number;
-      readonly functions: Schema.Number;
-      readonly lines: Schema.Number;
-    }>;
-    readonly delta: Schema.Struct<{
-      readonly statements: Schema.Number;
-      readonly branches: Schema.Number;
-      readonly functions: Schema.Number;
-      readonly lines: Schema.Number;
-    }>;
-    readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
-    readonly targetsHash: Schema.optional<Schema.String>;
-  }>>;
-}>;
-/** @public */
-export type TrendRecord = typeof TrendRecord.Type;
-//#endregion
-//#region src/utils/validate-phase-transition.d.ts
-/** @public */
-type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
-/** @public */
-type ArtifactKind = "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "refactor" | "test_weakened";
-/**
- * Explicit test-runner marker on a `tdd_artifacts` row (issue #363). `vitest`
- * artifacts always carry a `test_case_id` when they anchor a specific test;
- * `bats` artifacts never do (there is no `test_cases` row for a bats test),
- * so the D2 binding-rule validator branches on this to accept a bats
- * run-level artifact without weakening the vitest guard.
- * @public
- */
-type ArtifactSuite = "vitest" | "bats";
-/** @public */
-interface CitedArtifact {
-  readonly id: number;
-  /**
-   * `tdd_phases.id` of the phase this artifact was actually recorded in — the
-   * artifact's own phase binding. This is the honest anchor for D2 binding
-   * rule 1's window check (issue #245): a test_case's first-ever creation
-   * turn can predate the current phase (e.g. authored during spike, then
-   * re-run inside red) without the evidence itself being stale, so the
-   * window check compares this against `PhaseTransitionContext.current_phase_id`
-   * rather than `test_case_created_turn_at`.
-   */
-  readonly phase_id: number;
-  readonly artifact_kind: ArtifactKind;
-  readonly test_case_id: number | null;
-  readonly test_case_created_turn_at: string | null;
-  readonly test_case_authored_in_session: boolean;
-  readonly test_run_id: number | null;
-  readonly test_first_failure_run_id: number | null;
-  readonly behavior_id: number | null;
-  /**
-   * Issue #363: explicit suite marker distinguishing vitest from bats runs.
-   * Optional on the pure type so hand-built contexts default to `vitest`;
-   * the DB row always carries the persisted value.
-   */
-  readonly suite?: ArtifactSuite;
-}
-//#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
- * agent's lifetime.
- * @public
- */
-export declare const AgentId: Schema.brand<Schema.String, "AgentId">;
-/** @public */
-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
- * have multiple chats across `--resume` invocations. Distinct from
- * `sessions.id` (the SQLite agent-run PK).
- * @public
- */
-export declare const ChatId: Schema.brand<Schema.String, "ChatId">;
-/** @public */
-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 & {
-  readonly _tag: "AgentNotFoundError";
-} & Readonly<A>;
-/**
- * `agent_id` does not exist for the given chat. Surface to the
- * caller; the typical resolution is to call `register_agent` for
- * this agent first.
- * @public
- */
-export declare class AgentNotFoundError extends AgentNotFoundError_base<{
-  readonly agentId: AgentId;
-  readonly chatId?: ChatId;
-}> {}
-declare const RegistrationConflictError_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: "RegistrationConflictError";
-} & Readonly<A>;
-/**
- * True conflict — e.g., the `parentAgentId` supplied to
- * `register_agent` refers to a different session than the one the
- * caller named. Distinct from `IdempotencyHit`, which is a success.
- * @public
- */
-export declare class RegistrationConflictError extends RegistrationConflictError_base<{
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly reason: 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>;
-/** @public */
-export declare class GoalNotFoundError extends GoalNotFoundError_base<{
-  readonly id: number;
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly id: number;
-    readonly reason: string;
-  });
-}
-declare const BehaviorNotFoundError_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: "BehaviorNotFoundError";
-} & Readonly<A>;
-/** @public */
-export declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
-  readonly id: number;
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly id: number;
-    readonly reason: string;
-  });
-}
-declare const TddTaskNotFoundError_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: "TddTaskNotFoundError";
-} & Readonly<A>;
-/** @public */
-export declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
-  readonly id: number;
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly id: number;
-    readonly reason: string;
-  });
-}
-/** @public */
-type TddTaskEndOutcome = "succeeded" | "blocked" | "abandoned";
-declare const TddTaskAlreadyEndedError_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: "TddTaskAlreadyEndedError";
-} & Readonly<A>;
-/** @public */
-export declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
-  readonly id: number;
-  readonly endedAt: string;
-  readonly outcome: TddTaskEndOutcome;
-}> {
-  constructor(args: {
-    readonly id: number;
-    readonly endedAt: string;
-    readonly outcome: TddTaskEndOutcome;
-  });
-}
-/** @public */
-type IllegalStatusTransitionEntity = "goal" | "behavior" | "task";
-declare const IllegalStatusTransitionError_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: "IllegalStatusTransitionError";
-} & Readonly<A>;
-/** @public */
-export declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
-  readonly entity: IllegalStatusTransitionEntity;
-  readonly id: number;
-  readonly from: string;
-  readonly to: string;
-  readonly reason: string;
-}> {
-  constructor(args: {
-    readonly entity: IllegalStatusTransitionEntity;
-    readonly id: number;
-    readonly from: string;
-    readonly to: string;
-    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;
-  readonly parentAgentId: Schema.NullOr<Schema.brand<Schema.String, "AgentId">>;
-  readonly conversationId: Schema.NullOr<Schema.brand<Schema.String, "ConversationId">>;
-  readonly agentType: Schema.String;
-  readonly startedAt: Schema.Number;
-  readonly endedAt: Schema.NullOr<Schema.Number>;
-  readonly startGitBranch: Schema.NullOr<Schema.String>;
-  readonly startGitCommitSha: Schema.NullOr<Schema.String>;
-  readonly startWorktreeDir: Schema.NullOr<Schema.String>;
-  readonly idempotencyKey: Schema.String;
-}>, {}>;
-/**
- * Successful registration row. The fields mirror the `agents` SQLite
- * table 1:1 in camelCase.
- *
- * `startGitBranch`, `startGitCommitSha`, `startWorktreeDir` capture
- * *what the agent inherited at registration time* — distinct from the
- * per-run git context recorded on `runs`. A divergence between the
- * two reveals a mid-session branch switch, which is itself signal.
- * @public
- */
-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;
-/**
- * Returned by `DataStore.registerAgent` when the
- * `(session_id, idempotency_key)` UNIQUE constraint already has a
- * row. Not an error — the caller treats it as a successful recovery
- * of the existing `agentId`.
- *
- * Modeled as a `Data.TaggedClass` so the success channel of
- * `registerAgent` is `Effect<Agent | IdempotencyHit, ...>` and
- * downstream code uses `Match.tag` to branch.
- * @public
- */
-export declare class IdempotencyHit extends IdempotencyHit_base<{
-  readonly existingAgentId: typeof AgentId.Type;
-}> {}
-//#endregion
-//#region src/schemas/Thresholds.d.ts
-/**
- * Fully resolved thresholds ready for evaluation.
- * @public
- */
-declare const ResolvedThresholds: Schema.Struct<{
-  readonly global: 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.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 */
-type ResolvedThresholds = typeof ResolvedThresholds.Type;
-//#endregion
-//#region src/services/DataStore.d.ts
-/** @public */
-interface CreateGoalInput {
-  readonly tddTaskId: number;
-  readonly goal: string;
-}
-/** @public */
-interface UpdateGoalInput {
-  readonly id: number;
-  readonly goal?: string;
-  readonly status?: GoalStatus;
-}
-/** @public */
-interface CreateBehaviorInput {
-  readonly goalId: number;
-  readonly behavior: string;
-  readonly suggestedTestName?: string;
-  readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
-}
-/** @public */
-interface UpdateBehaviorInput {
-  readonly id: number;
-  readonly behavior?: string;
-  readonly suggestedTestName?: string | null;
-  readonly status?: BehaviorStatus;
-  readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
-}
-/** @public */
-interface SettingsInput {
-  readonly vitestVersion: string;
-  readonly pool?: string;
-  readonly environment?: string;
-  readonly testTimeout?: number;
-  readonly hookTimeout?: number;
-  readonly slowTestThreshold?: number;
-  readonly maxConcurrency?: number;
-  readonly maxWorkers?: number;
-  readonly isolate?: boolean;
-  readonly bail?: number;
-  readonly globals?: boolean;
-  readonly fileParallelism?: boolean;
-  readonly sequenceSeed?: number;
-  readonly coverageProvider?: string;
-}
-/** @public */
-interface TestRunInput {
-  readonly invocationId: string;
-  readonly project: string;
-  readonly settingsHash: string;
-  readonly timestamp: string;
-  readonly commitSha: string | null;
-  readonly branch: string | null;
-  readonly reason: "passed" | "failed" | "interrupted";
-  readonly duration: number;
-  readonly total: number;
-  readonly passed: number;
-  readonly failed: number;
-  readonly skipped: number;
-  readonly scoped: boolean;
-  readonly snapshotAdded?: number;
-  readonly snapshotMatched?: number;
-  readonly snapshotUnmatched?: number;
-  readonly snapshotUpdated?: number;
-  readonly snapshotUnchecked?: number;
-  readonly snapshotTotal?: number;
-  readonly snapshotFailure?: boolean;
-  readonly snapshotDidUpdate?: boolean;
-  readonly snapshotFilesAdded?: number;
-  readonly snapshotFilesRemoved?: number;
-  readonly snapshotFilesUnmatched?: number;
-  readonly snapshotFilesUpdated?: number;
-  /**
-   * Attribution columns added by the agent-agnostic taxonomy work. The
-   * reporter walks env vars / session map to populate these; un-attributed
-   * runs default to actor_type='system' and NULL agent/conversation ids.
-   */
-  readonly actorType?: "agent" | "user" | "system";
-  readonly agentId?: string | null;
-  readonly conversationId?: string | null;
-  /**
-   * Git context the run executed against. NULL for non-git workspaces.
-   */
-  readonly gitBranch?: string | null;
-  readonly gitCommitSha?: string | null;
-  readonly gitDirty?: boolean | null;
-  readonly gitUpstream?: string | null;
-  readonly gitWorktreeDir?: string | null;
-  /**
-   * Host metadata probe result (terminal pane, CI runner). NULL when no
-   * probe in the priority chain matched.
-   * @public
-   */
-  readonly hostSource?: string | null;
-  readonly hostValue?: string | null;
-  readonly hostMetadata?: Record<string, unknown> | null;
-}
-/** @public */
-interface ModuleInput {
-  readonly fileId: number;
-  readonly relativeModuleId: string;
-  readonly state: string;
-  readonly duration?: number;
-  readonly environmentSetupDuration?: number;
-  readonly prepareDuration?: number;
-  readonly collectDuration?: number;
-  readonly setupDuration?: number;
-  readonly heap?: number;
-}
-/** @public */
-interface TestCaseInput {
-  readonly suiteId?: number;
-  readonly vitestId?: string;
-  readonly name: string;
-  readonly fullName: string;
-  readonly state: string;
-  readonly classification?: string;
-  readonly duration?: number;
-  readonly startTime?: number;
-  readonly flaky?: boolean;
-  readonly slow?: boolean;
-  readonly retryCount?: number;
-  readonly repeatCount?: number;
-  readonly heap?: number;
-  readonly mode?: string;
-  readonly each?: boolean;
-  readonly fails?: boolean;
-  readonly concurrent?: boolean;
-  readonly shuffle?: boolean;
-  readonly timeout?: number;
-  readonly skipNote?: string;
-  readonly locationLine?: number;
-  readonly locationColumn?: number;
-  readonly tags?: readonly string[];
-  /**
-   * FK to `turns(id)`. Set by the reporter when the test case row was
-   * authored within a recorded turn (D2 binding rule 1).
-   * @public
-   */
-  readonly createdTurnId?: number;
-}
-/** @public */
-interface StackFrameInput {
-  readonly ordinal: number;
-  readonly method: string | null;
-  readonly filePath: string;
-  readonly line: number;
-  readonly col: number;
-  readonly sourceMappedLine?: number;
-  readonly functionBoundaryLine?: number;
-}
-/** @public */
-interface TestErrorInput {
-  readonly testCaseId?: number;
-  readonly testSuiteId?: number;
-  readonly moduleId?: number;
-  readonly scope: "test" | "suite" | "module" | "unhandled";
-  readonly name?: string;
-  readonly message: string;
-  readonly diff?: string;
-  readonly actual?: string;
-  readonly expected?: string;
-  readonly stack?: string;
-  readonly causeErrorId?: number;
-  readonly signatureHash?: string;
-  readonly frames?: ReadonlyArray<StackFrameInput>;
-  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;
-  readonly branches: number;
-  readonly functions: number;
-  readonly lines: number;
-  readonly uncoveredLines?: string;
-  /**
-   * Coverage tier this row represents. `'below_threshold'` is the
-   * build-failing tier (file falls below the configured minimum
-   * coverage thresholds). `'below_target'` is the warning tier (file
-   * is above thresholds but below the aspirational target).
-   *
-   * Defaults to `'below_threshold'` when omitted, matching the only
-   * tier that existed before migration 0005.
-   * @public
-   */
-  readonly tier?: "below_threshold" | "below_target";
-}
-/** @public */
-interface SuiteInput {
-  readonly parentSuiteId?: number;
-  readonly name: string;
-  readonly fullName: string;
-  readonly state: "pending" | "passed" | "failed" | "skipped";
-  readonly mode?: "run" | "only" | "skip" | "todo";
-  readonly concurrent?: boolean;
-  readonly shuffle?: boolean;
-  readonly retry?: number;
-  readonly repeats?: number;
-  readonly locationLine?: number;
-  readonly locationColumn?: number;
-}
-/** @public */
-interface NoteInput {
-  readonly title: string;
-  readonly content: string;
-  readonly scope: "global" | "project" | "module" | "suite" | "test" | "note";
-  readonly project?: string;
-  readonly testFullName?: string;
-  readonly modulePath?: string;
-  readonly parentNoteId?: number;
-  readonly createdBy?: string;
-  readonly expiresAt?: string;
-  readonly pinned?: boolean;
-}
-/** @public */
-interface SessionInput {
-  readonly chatId: string;
-  readonly project: string;
-  readonly cwd: string;
-  readonly agentKind: "main" | "subagent";
-  readonly agentType?: string;
-  readonly parentSessionId?: number;
-  readonly triageWasNonEmpty?: boolean;
-  readonly startedAt: string;
-  /**
-   * Canonical conversation UUID this session belongs to (issue #144).
-   * Set once at INSERT time — `sessions.conversation_id` is immutable
-   * thereafter (see the `trg_sessions_conv_id_immutable` trigger), so
-   * omit it here rather than trying to backfill via an update.
-   */
-  readonly conversationId?: string;
-}
-/** @public */
-interface TurnInput {
-  readonly sessionId: number;
-  /** When omitted, writeTurn computes MAX(turnNo) + 1 for the session. */
-  readonly turnNo?: number;
-  readonly type: "user_prompt" | "tool_call" | "tool_result" | "file_edit" | "hook_fire" | "note" | "hypothesis";
-  readonly payload: string;
-  readonly occurredAt: string;
-}
-/** @public */
-interface FailureSignatureWriteInput {
-  readonly signatureHash: string;
-  readonly runId: number;
-  readonly seenAt: string;
-}
-/** @public */
-interface HypothesisInput {
-  readonly sessionId: number;
-  readonly content: string;
-  readonly createdTurnId?: number;
-  readonly citedTestErrorId?: number;
-  readonly citedStackFrameId?: number;
-}
-/** @public */
-interface ValidateHypothesisInput {
-  readonly id: number;
-  readonly outcome: "confirmed" | "refuted" | "abandoned";
-  readonly validatedTurnId?: number;
-  readonly validatedAt: string;
-}
-/** @public */
-interface IdempotentResponseInput {
-  readonly procedurePath: string;
-  readonly key: string;
-  readonly resultJson: string;
-  readonly createdAt: string;
-}
-/** @public */
-interface TddTaskInput {
-  readonly sessionId: number;
-  readonly goal: string;
-  readonly startedAt: string;
-  readonly parentTddTaskId?: number;
-  readonly runId?: string;
-}
-/** @public */
-interface EndTddTaskInput {
-  readonly id: number;
-  readonly endedAt: string;
-  readonly outcome: "succeeded" | "blocked" | "abandoned";
-  readonly summaryNoteId?: number;
-}
-/** @public */
-interface WriteTddPhaseInput {
-  readonly tddTaskId: number;
-  readonly behaviorId?: number;
-  readonly phase: Phase;
-  readonly startedAt: string;
-  readonly transitionReason?: string;
-  readonly parentPhaseId?: number;
-}
-/** @public */
-interface WriteTddPhaseOutput {
-  readonly id: number;
-  readonly previousPhaseId: number | null;
-}
-/** @public */
-interface WriteTddArtifactInput {
-  readonly phaseId: number;
-  readonly artifactKind: ArtifactKind;
-  readonly fileId?: number;
-  readonly testCaseId?: number;
-  readonly testRunId?: number;
-  readonly testFirstFailureRunId?: number;
-  readonly diffExcerpt?: string;
-  readonly recordedAt: string;
-  /** Issue #363: explicit suite marker. Defaults to `"vitest"` when omitted. */
-  readonly suite?: ArtifactSuite;
-}
-/** @public */
-interface WriteCommitInput {
-  readonly sha: string;
-  readonly parentSha?: string;
-  readonly message?: string;
-  readonly author?: string;
-  readonly committedAt?: string;
-  readonly branch?: string;
-}
-/** @public */
-type ChangeKind = "added" | "modified" | "deleted" | "renamed" | "untracked-modified";
-/** @public */
-interface RunChangedFile {
-  readonly filePath: string;
-  readonly changeKind: ChangeKind;
-  readonly commitSha?: string;
-}
-/** @public */
-interface WriteRunChangedFilesInput {
-  readonly runId: number;
-  readonly files: ReadonlyArray<RunChangedFile>;
-}
-/** @public */
-type RunInvocationMethod = "bash" | "mcp" | "cli";
-/**
- * Input to `DataStore.registerAgent`.
- *
- * `sessionId` is the FK to `sessions.id` (integer PK), NOT the host's
- * chat UUID string. Callers that hold only the chat UUID must resolve
- * it through `getSessionByChatId` first.
- *
- * `idempotencyKey` is pre-derived by the caller via
- * `deriveIdempotencyKey(...)` — both the sidecar CLI and the MCP
- * server compute it the same way so a hook retry collapses to the
- * same row.
- * @public
- */
-interface RegisterAgentInput {
-  readonly sessionId: number;
-  readonly agentType: string;
-  readonly parentAgentId: string | null;
-  readonly conversationId: string | null;
-  readonly startedAt: number;
-  readonly startGitBranch?: string;
-  readonly startGitCommitSha?: string;
-  readonly startWorktreeDir?: string;
-  readonly idempotencyKey: string;
-  /**
-   * Pre-allocated `agents.agent_id` UUID. The sidecar passes
-   * `PerClientSessionMapWriter.mapSession()`'s `main_agent_id` here so
-   * the per-project `agents` row and the per-client session_map row
-   * agree on a single canonical id — the same value the SessionStart
-   * hook exports as `VITEST_AGENT_MAIN_AGENT_ID` / `_AGENT_ID`. When
-   * omitted, the implementation generates a fresh UUID (used by tests
-   * and any caller without a session map).
-   */
-  readonly agentId?: string;
-}
-/** @public */
-interface AssociateRunSessionInput {
-  readonly chatId: string;
-  readonly invocationMethod: RunInvocationMethod;
-}
-declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/DataStore", {
-  readonly writeSettings: (hash: string, settings: SettingsInput, envVars: Record<string, string>) => Effect.Effect<void, DataStoreError>;
-  readonly writeRun: (input: TestRunInput) => Effect.Effect<number, DataStoreError>;
-  readonly writeModules: (runId: number, modules: ReadonlyArray<ModuleInput>) => Effect.Effect<ReadonlyArray<number>, DataStoreError>;
-  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>;
-  /**
-   * Persist the resolved (enforced) Vitest `coverage.thresholds` for the
-   * current run, distinct from the ratcheted `coverage_baselines` rows.
-   * Stored under `kind='threshold'`. See issue #237.
-   */
-  readonly writeThresholds: (thresholds: ResolvedThresholds) => Effect.Effect<void, DataStoreError>;
-  /**
-   * Persist the resolved aspirational `coverageTargets` for the current
-   * run, distinct from the ratcheted `coverage_baselines` rows. Stored
-   * under `kind='target'`. See issue #237.
-   */
-  readonly writeTargets: (targets: ResolvedThresholds) => Effect.Effect<void, DataStoreError>;
-  readonly writeTrends: (project: string, runId: number, entry: TrendEntry) => Effect.Effect<void, DataStoreError>;
-  readonly writeSourceMap: (sourceFilePath: string, testModuleId: number, mappingType: string) => Effect.Effect<void, DataStoreError>;
-  readonly ensureFile: (filePath: string) => Effect.Effect<number, DataStoreError>;
-  readonly writeNote: (note: NoteInput) => Effect.Effect<number, DataStoreError>;
-  readonly updateNote: (id: number, fields: Partial<NoteInput>) => Effect.Effect<void, DataStoreError>;
-  readonly deleteNote: (id: number) => Effect.Effect<void, DataStoreError>;
-  readonly writeSession: (input: SessionInput) => Effect.Effect<number, DataStoreError>;
-  /**
-   * Idempotent variant of `writeSession`: if a row with this
-   * `chat_id` already exists, return its id and leave the stored
-   * fields untouched; otherwise insert a new row. Used by
-   * hook-triggered recording paths (artifacts, turns) that fire
-   * for sessions whose original `SessionStart` may have missed —
-   * e.g. when Claude Code rotates `chat_id` mid-window after a
-   * continuation or compaction. Race-safe via
-   * `INSERT ... ON CONFLICT DO NOTHING`.
-   */
-  readonly upsertSession: (input: SessionInput) => Effect.Effect<number, DataStoreError>;
-  /**
-   * Backfill `sessions.conversation_id` for a row that was inserted
-   * before the canonical conversation id was known (issue #144) —
-   * `record session-start` always precedes `register-agent`, so the
-   * session row exists first. Race-safe and idempotent: the UPDATE's
-   * `WHERE conversation_id IS NULL` guard means a session that
-   * already carries a value is left untouched (zero rows affected),
-   * matching the trigger's null→value-only relaxation rather than
-   * risking an immutability-violation error on a redundant call.
-   */
-  readonly setSessionConversationIdIfNull: (input: {
-    readonly sessionId: number;
-    readonly conversationId: string;
-  }) => Effect.Effect<void, DataStoreError>;
-  readonly writeTurn: (input: TurnInput) => Effect.Effect<number, DataStoreError>;
-  readonly writeFailureSignature: (input: FailureSignatureWriteInput) => Effect.Effect<void, DataStoreError>;
-  readonly endSession: (chatId: string, endedAt: string, endReason: string | null) => Effect.Effect<void, DataStoreError>;
-  readonly writeHypothesis: (input: HypothesisInput) => Effect.Effect<number, DataStoreError>;
-  readonly validateHypothesis: (input: ValidateHypothesisInput) => Effect.Effect<void, DataStoreError>;
-  readonly writeTddTask: (input: TddTaskInput) => Effect.Effect<number, DataStoreError>;
-  readonly endTddTask: (input: EndTddTaskInput) => Effect.Effect<void, DataStoreError>;
-  readonly createGoal: (input: CreateGoalInput) => Effect.Effect<GoalRow, DataStoreError | TddTaskNotFoundError | TddTaskAlreadyEndedError>;
-  readonly getGoal: (id: number) => Effect.Effect<Option.Option<GoalRow>, DataStoreError>;
-  readonly updateGoal: (input: UpdateGoalInput) => Effect.Effect<GoalRow, DataStoreError | GoalNotFoundError | TddTaskAlreadyEndedError | IllegalStatusTransitionError>;
-  readonly deleteGoal: (id: number) => Effect.Effect<void, DataStoreError | GoalNotFoundError>;
-  readonly listGoalsByTddTask: (tddTaskId: number) => Effect.Effect<ReadonlyArray<GoalRow>, DataStoreError | TddTaskNotFoundError>;
-  readonly createBehavior: (input: CreateBehaviorInput) => Effect.Effect<BehaviorRow, DataStoreError | GoalNotFoundError | BehaviorNotFoundError | TddTaskAlreadyEndedError | IllegalStatusTransitionError>;
-  readonly getBehavior: (id: number) => Effect.Effect<Option.Option<BehaviorRow>, DataStoreError>;
-  readonly updateBehavior: (input: UpdateBehaviorInput) => Effect.Effect<BehaviorRow, DataStoreError | BehaviorNotFoundError | TddTaskAlreadyEndedError | IllegalStatusTransitionError>;
-  readonly deleteBehavior: (id: number) => Effect.Effect<void, DataStoreError | BehaviorNotFoundError>;
-  readonly listBehaviorsByGoal: (goalId: number) => Effect.Effect<ReadonlyArray<BehaviorRow>, DataStoreError | GoalNotFoundError>;
-  readonly listBehaviorsByTddTask: (tddTaskId: number) => Effect.Effect<ReadonlyArray<BehaviorRow>, DataStoreError | TddTaskNotFoundError>;
-  readonly writeTddPhase: (input: WriteTddPhaseInput) => Effect.Effect<WriteTddPhaseOutput, DataStoreError>;
-  readonly writeTddArtifact: (input: WriteTddArtifactInput) => Effect.Effect<number, DataStoreError>;
-  readonly writeCommit: (input: WriteCommitInput) => Effect.Effect<void, DataStoreError>;
-  readonly writeRunChangedFiles: (input: WriteRunChangedFilesInput) => Effect.Effect<void, DataStoreError>;
-  readonly recordIdempotentResponse: (input: IdempotentResponseInput) => Effect.Effect<void, DataStoreError>;
-  readonly pruneSessions: (keepRecent: number) => Effect.Effect<{
-    readonly affectedSessions: number;
-    readonly prunedTurns: number;
-  }, DataStoreError>;
-  readonly associateLatestRunWithSession: (input: AssociateRunSessionInput) => Effect.Effect<void, DataStoreError>;
-  readonly backfillTestCaseTurns: (chatId: string) => Effect.Effect<number, DataStoreError>;
-  /**
-   * Idempotently insert an `agents` row.
-   *
-   * Returns `Agent` on a fresh insert, or `IdempotencyHit` carrying
-   * the existing `agentId` when the `(session_id, idempotency_key)`
-   * UNIQUE constraint already has a row. The caller treats the latter
-   * as a successful recovery (same logical agent), not an error.
-   *
-   * Fails with `RegistrationConflictError` when the supplied
-   * `parentAgentId` references an agent in a different session, or
-   * when no such agent exists. Surface to the caller for true
-   * mis-configuration cases; idempotency hits never produce this.
-   */
-  readonly registerAgent: (input: RegisterAgentInput) => Effect.Effect<Agent | IdempotencyHit, RegistrationConflictError | DataStoreError>;
-  /**
-   * Mark an agent as ended. Sets `agents.ended_at` to the supplied
-   * timestamp. Fails with `AgentNotFoundError` when no row exists.
-   */
-  readonly endAgent: (agentId: string, endedAt: number) => Effect.Effect<void, AgentNotFoundError | DataStoreError>;
-}>;
-/** @public */
-export declare class DataStore extends DataStore_base {}
-//#endregion
-//#region src/services/DataReader.d.ts
-/** @public */
-interface ProjectRunSummary {
-  readonly project: string;
-  readonly lastRun: string | null;
-  readonly lastResult: "passed" | "failed" | "interrupted" | null;
-  readonly total: number;
-  readonly passed: number;
-  readonly failed: number;
-  readonly skipped: number;
-}
-/** @public */
-interface FlakyTest {
-  readonly fullName: string;
-  readonly modulePath: string;
-  readonly project: string;
-  readonly passCount: number;
-  readonly failCount: number;
-  readonly lastState: "passed" | "failed";
-  readonly lastTimestamp: string;
-}
-/** @public */
-interface PersistentFailure {
-  readonly fullName: string;
-  readonly modulePath: string;
-  readonly project: string;
-  readonly consecutiveFailures: number;
-  readonly firstFailedAt: string;
-  readonly lastFailedAt: string;
-  readonly lastErrorMessage: string | null;
-}
-/** @public */
-interface TestError {
-  /** `test_errors.id` — required by `hypothesis (action: record).citedTestErrorId`. */
-  readonly id: number;
-  /**
-   * `stack_frames.id` for the top frame of this error (ordinal 0), or
-   * `null` if no frames were captured. Required by
-   * `hypothesis (action: record).citedStackFrameId`.
-   */
-  readonly topStackFrameId: number | null;
-  readonly name: string | null;
-  readonly message: string;
-  readonly diff: string | null;
-  readonly actual: string | null;
-  readonly expected: string | null;
-  readonly stack: string | null;
-  readonly scope: "test" | "suite" | "module" | "unhandled";
-  readonly testFullName: string | null;
-  readonly moduleFile: string | null;
-}
-/** @public */
-interface NoteRow {
-  readonly id: number;
-  readonly title: string;
-  readonly content: string;
-  readonly scope: "global" | "project" | "module" | "suite" | "test" | "note";
-  readonly project: string | null;
-  readonly testFullName: string | null;
-  readonly modulePath: string | null;
-  readonly parentNoteId: number | null;
-  readonly createdBy: string | null;
-  readonly expiresAt: string | null;
-  readonly pinned: boolean;
-  readonly createdAt: string;
-  readonly updatedAt: string;
-}
-/** @public */
-interface SettingsRow {
-  readonly hash: string;
-  readonly reporters: string | null;
-  readonly coverageEnabled: boolean;
-  readonly coverageProvider: string | null;
-  readonly coverageThresholds: string | null;
-  readonly coverageTargets: string | null;
-  readonly pool: string | null;
-  readonly shard: string | null;
-  readonly project: string | null;
-  readonly environment: string | null;
-  readonly envVars: Record<string, string>;
-  readonly capturedAt: string;
-}
-/** @public */
-interface TestListEntry {
-  readonly id: number;
-  readonly fullName: string;
-  readonly state: string;
-  readonly duration: number | null;
-  readonly module: string;
-  readonly classification: string | null;
-}
-/** @public */
-interface ModuleListEntry {
-  readonly id: number;
-  readonly file: string;
-  readonly state: string;
-  readonly testCount: number;
-  readonly duration: number | null;
-}
-/** @public */
-interface SuiteListEntry {
-  readonly id: number;
-  readonly name: string;
-  readonly module: string;
-  readonly state: string;
-  readonly testCount: number;
-}
-/** @public */
-interface SettingsListEntry {
-  readonly hash: string;
-  readonly capturedAt: string;
-}
-/** @public */
-interface SessionDetail {
-  readonly id: number;
-  readonly chatId: string;
-  readonly project: string;
-  readonly cwd: string;
-  readonly agentKind: "main" | "subagent";
-  readonly agentType: string | null;
-  readonly parentSessionId: number | null;
-  readonly triageWasNonEmpty: boolean;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly endReason: string | null;
-  /** Canonical conversation UUID this session belongs to (issue #144), null when unset. */
-  readonly conversationId: string | null;
-}
-/** @public */
-interface TurnSummary {
-  readonly id: number;
-  readonly sessionId: number;
-  readonly turnNo: number;
-  readonly type: string;
-  readonly payload: string;
-  readonly occurredAt: string;
-}
-/** @public */
-interface HistoryQueryOptions {
-  /** Exact `full_name` match — narrows to a single test's history. */
-  readonly testName?: string;
-  /** Exact `module_path` match — narrows to tests in one file. */
-  readonly modulePath?: string;
-  /** Max runs kept per (module_path, full_name) pair, most-recent-first. Default 20. */
-  readonly limit?: number;
-}
-/**
- * Narrowing options shared by the classification reads
- * (`DataReader.getFlaky` / `getPersistentFailures`). Mirrors the
- * `testName` / `modulePath` half of {@link HistoryQueryOptions} so a
- * caller that scoped `getHistory` to one test can scope the derived
- * classifications to the same test instead of receiving the whole
- * project's rows.
- *
- * @public
- */
-interface ClassificationQueryOptions {
-  /** Exact `full_name` match — narrows to a single test's classification. */
-  readonly testName?: string;
-  /** Exact `module_path` match — narrows to tests in one file. */
-  readonly modulePath?: string;
-}
-/**
- * Narrowing options for `DataReader.getTestByFullName`. A
- * `full_name` is not file-qualified (Decision D20), so the same name can
- * exist in more than one module; `modulePath` disambiguates.
- *
- * @public
- */
-interface TestLookupOptions {
-  /** Exact `module_path` match — picks one variant of an ambiguous `full_name`. */
-  readonly modulePath?: string;
-}
-/** @public */
-interface TurnSearchOptions {
-  readonly sessionId?: number;
-  readonly type?: string;
-  readonly since?: string;
-  readonly limit?: number;
-}
-/** @public */
-interface AcceptanceMetrics {
-  readonly phaseEvidenceIntegrity: {
-    total: number;
-    compliant: number;
-    ratio: number;
-  };
-  readonly complianceHookResponsiveness: {
-    total: number;
-    withFollowup: number;
-    ratio: number;
-  };
-  readonly orientationUsefulness: {
-    total: number;
-    referencedCount: number;
-    ratio: number;
-  };
-  readonly antiPatternDetectionRate: {
-    total: number;
-    cleanSessions: number;
-    ratio: number;
-  };
-}
-/** @public */
-interface FailureSignatureDetail {
-  readonly signatureHash: string;
-  readonly firstSeenRunId: number | null;
-  readonly firstSeenAt: string;
-  readonly lastSeenAt: string | null;
-  readonly occurrenceCount: number;
-  readonly recentErrors: ReadonlyArray<{
-    readonly runId: number;
-    readonly message: string;
-    readonly errorName: string | null;
-  }>;
-}
-/** @public */
-interface TddPhaseDetail {
-  readonly id: number;
-  readonly behaviorId: number | null;
-  readonly phase: string;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly transitionReason: string | null;
-}
-/** @public */
-interface TddArtifactDetail {
-  readonly id: number;
-  readonly phaseId: number;
-  readonly artifactKind: string;
-  readonly testCaseId: number | null;
-  readonly testRunId: number | null;
-  readonly recordedAt: string;
-}
-/** @public */
-interface TddTaskDetail {
-  readonly id: number;
-  readonly sessionId: number;
-  readonly goal: string;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly outcome: string | null;
-  readonly runId: string | null;
-  readonly goals: ReadonlyArray<GoalDetail>;
-  readonly phases: ReadonlyArray<TddPhaseDetail>;
-  readonly artifacts: ReadonlyArray<TddArtifactDetail>;
-}
-/** @public */
-interface CurrentTddPhase {
-  readonly id: number;
-  readonly phase: Phase;
-  readonly startedAt: string;
-  readonly behaviorId: number | null;
-}
-/** @public */
-interface CitedArtifactRow extends CitedArtifact {
-  readonly phase_id: number;
-}
-/** @public */
-interface CommitChangesEntry {
-  readonly sha: string;
-  readonly parentSha: string | null;
-  readonly message: string | null;
-  readonly author: string | null;
-  readonly committedAt: string | null;
-  readonly branch: string | null;
-  readonly files: ReadonlyArray<{
-    readonly filePath: string;
-    readonly changeKind: ChangeKind;
-  }>;
-}
-/** @public */
-interface HypothesisDetail {
-  readonly id: number;
-  readonly sessionId: number;
-  readonly content: string;
-  readonly citedTestErrorId: number | null;
-  readonly citedStackFrameId: number | null;
-  readonly validationOutcome: "confirmed" | "refuted" | "abandoned" | null;
-  readonly validatedAt: string | null;
-}
-/** @public */
-interface TddTaskSummary {
-  readonly id: number;
-  readonly sessionId: number;
-  readonly goal: string;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly outcome: "succeeded" | "blocked" | "abandoned" | null;
-}
-/**
- * Row shape returned by `listTddArtifactsForTask`. Carries every
- * field an agent typically needs to cite an artifact in a subsequent
- * `tdd_phase_transition_request` call without further lookups.
- *
- * @public
- */
-interface TddArtifactRow {
-  readonly id: number;
-  readonly tddTaskId: number;
-  readonly phaseId: number;
-  readonly phaseName: Phase;
-  readonly artifactKind: ArtifactKind;
-  readonly behaviorId: number | null;
-  readonly testCaseId: number | null;
-  readonly testRunId: number | null;
-  readonly testFirstFailureRunId: number | null;
-  readonly recordedAt: string;
-  readonly suite: ArtifactSuite;
-}
-/** @public */
-interface TagInventoryRow {
-  /** The tag name (e.g. `"int"`, `"e2e"`, `"unit"`). */
-  readonly tag: string;
-  /** The Vitest project this tag was observed in. */
-  readonly project: string;
-  /**
-   * Number of distinct test modules in the project's latest run that contain
-   * at least one test case carrying this tag.
-   */
-  readonly moduleCount: number;
-  /**
-   * Number of test cases in the project's latest run that carry this tag.
-   */
-  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>;
-  readonly getHistory: (project: string, options?: HistoryQueryOptions) => Effect.Effect<HistoryRecord, DataStoreError>;
-  readonly getBaselines: (project: string) => Effect.Effect<Option.Option<CoverageBaselines>, DataStoreError>;
-  readonly getTrends: (project: string, limit?: number) => Effect.Effect<Option.Option<TrendRecord>, DataStoreError>;
-  readonly getFlaky: (project: string, options?: ClassificationQueryOptions) => Effect.Effect<ReadonlyArray<FlakyTest>, DataStoreError>;
-  readonly getPersistentFailures: (project: string, options?: ClassificationQueryOptions) => Effect.Effect<ReadonlyArray<PersistentFailure>, DataStoreError>;
-  readonly getFileCoverage: (runId: number) => Effect.Effect<ReadonlyArray<FileCoverageReport>, DataStoreError>;
-  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>;
-  readonly getManifest: () => Effect.Effect<Option.Option<CacheManifest>, DataStoreError>;
-  readonly getSettings: (hash: string) => Effect.Effect<Option.Option<SettingsRow>, DataStoreError>;
-  readonly getLatestSettings: () => Effect.Effect<Option.Option<SettingsRow>, DataStoreError>;
-  readonly getTestByFullName: (project: string, fullName: string, options?: TestLookupOptions) => Effect.Effect<Option.Option<TestListEntry>, DataStoreError>;
-  /**
-   * Every module path in the project's latest run that carries a test
-   * case with this exact `full_name`, ordered ascending. Length > 1
-   * means the name is ambiguous and callers must disambiguate with
-   * {@link TestLookupOptions.modulePath} rather than guess.
-   */
-  readonly getTestModulesByFullName: (project: string, fullName: string) => Effect.Effect<ReadonlyArray<string>, DataStoreError>;
-  readonly listTests: (project: string, options?: {
-    state?: string;
-    module?: string;
-    limit?: number;
-  }) => Effect.Effect<ReadonlyArray<TestListEntry>, DataStoreError>;
-  readonly listModules: (project: string) => Effect.Effect<ReadonlyArray<ModuleListEntry>, DataStoreError>;
-  readonly listSuites: (project: string, options?: {
-    module?: string;
-  }) => Effect.Effect<ReadonlyArray<SuiteListEntry>, DataStoreError>;
-  readonly listSettings: () => Effect.Effect<ReadonlyArray<SettingsListEntry>, DataStoreError>;
-  readonly getSessionById: (id: number) => Effect.Effect<Option.Option<SessionDetail>, DataStoreError>;
-  readonly getSessionByChatId: (chatId: string) => Effect.Effect<Option.Option<SessionDetail>, DataStoreError>;
-  /**
-   * Find every session row whose `chat_id` begins with `prefix`.
-   * Used to recover the synthetic subagent row created by the
-   * SubagentStart hook (`<parentChatId>-subagent-<ts>-<pid>`)
-   * when subsequent PostToolUse hooks fire under the bare
-   * parent chat_id. Returns most recent first.
-   */
-  readonly findSessionsByChatPrefix: (prefix: string) => Effect.Effect<ReadonlyArray<SessionDetail>, DataStoreError>;
-  /**
-   * Find the most-recently-started subagent session whose
-   * `parent_session_id` is `parentSessionId` and that has not ended
-   * (`ended_at IS NULL`). Used to attribute orchestrator (subagent)
-   * MCP writes — e.g. `hypothesis record` — to the running subagent's
-   * own session row instead of the parent main session, since the MCP
-   * server's recovered context only ever names the main agent.
-   */
-  readonly findActiveSubagentSession: (parentSessionId: number) => Effect.Effect<Option.Option<SessionDetail>, DataStoreError>;
-  /**
-   * Resolve the session a TDD task was opened under: the `sessions`
-   * row whose `id` equals `tdd_tasks.session_id` for `tddTaskId`.
-   * Returns `Option.none` when the task — or its session — does not
-   * exist. Lets `hypothesis (action: record)` bind a hypothesis
-   * deterministically from the orchestrator's unambiguous
-   * `tddTaskId` (returned by `tdd_task (action: start)`) instead of
-   * the fragile recovered host context or a caller-guessed
-   * `sessionId`.
-   */
-  readonly getSessionByTddTaskId: (tddTaskId: number) => Effect.Effect<Option.Option<SessionDetail>, DataStoreError>;
-  readonly listSessions: (options: {
-    readonly project?: string;
-    readonly agentKind?: "main" | "subagent";
-    readonly limit?: number;
-  }) => Effect.Effect<ReadonlyArray<SessionDetail>, DataStoreError>;
-  readonly searchTurns: (options: TurnSearchOptions) => Effect.Effect<ReadonlyArray<TurnSummary>, DataStoreError>;
-  readonly computeAcceptanceMetrics: () => Effect.Effect<AcceptanceMetrics, DataStoreError>;
-  readonly getFailureSignatureByHash: (hash: string) => Effect.Effect<Option.Option<FailureSignatureDetail>, DataStoreError>;
-  readonly getTddTaskById: (id: number) => Effect.Effect<Option.Option<TddTaskDetail>, DataStoreError>;
-  readonly getGoalById: (id: number) => Effect.Effect<Option.Option<GoalDetail>, DataStoreError>;
-  readonly getGoalsByTddTask: (tddTaskId: number) => Effect.Effect<ReadonlyArray<GoalDetail>, DataStoreError>;
-  readonly getBehaviorById: (id: number) => Effect.Effect<Option.Option<BehaviorDetail>, DataStoreError>;
-  readonly getBehaviorsByGoal: (goalId: number) => Effect.Effect<ReadonlyArray<BehaviorRow>, DataStoreError>;
-  readonly getBehaviorsByTddTask: (tddTaskId: number) => Effect.Effect<ReadonlyArray<BehaviorRow>, DataStoreError>;
-  readonly getBehaviorDependencies: (behaviorId: number) => Effect.Effect<ReadonlyArray<BehaviorRow>, DataStoreError>;
-  readonly resolveGoalIdForBehavior: (behaviorId: number) => Effect.Effect<Option.Option<number>, DataStoreError>;
-  readonly getCurrentTddPhase: (tddTaskId: number) => Effect.Effect<Option.Option<CurrentTddPhase>, DataStoreError>;
-  readonly getTddArtifactWithContext: (artifactId: number) => Effect.Effect<Option.Option<CitedArtifactRow>, DataStoreError>;
-  readonly getCommitChanges: (sha?: string) => Effect.Effect<ReadonlyArray<CommitChangesEntry>, DataStoreError>;
-  readonly listTddTasksForSession: (sessionId: number, options?: {
-    /**
-     * When true, also return tdd_tasks belonging to any
-     * ancestor of `sessionId` via `parent_session_id`. Used
-     * by hook-driven artifact recording where the
-     * orchestrator opened the tdd task under the parent
-     * main row but the subagent's own session row is the
-     * one carrying the calling chat_id. Default `false`
-     * preserves the prior single-session contract.
-     */
-    readonly walkParents?: boolean;
-    /**
-     * When true AND `sessionId`'s session has a non-null
-     * `conversation_id`, also return tdd_tasks belonging to
-     * any OTHER session sharing that `conversation_id` — the
-     * detached-session fallback (issue #144). A session with
-     * a null `conversation_id` never triggers this fallback.
-     * Rows are ordered so a task owned by an `agent_kind =
-     * 'main'` session sorts first, then by `started_at DESC`.
-     * Default `false` preserves the prior contract.
-     */
-    readonly walkConversation?: boolean;
-  }) => Effect.Effect<ReadonlyArray<TddTaskSummary>, DataStoreError>;
-  /**
-   * Diagnostic for the `missing_artifact_evidence` phase-transition
-   * denial (issue #144): counts `tdd_artifacts` rows recorded at or
-   * after `sinceIso` under sessions OTHER than the one that opened
-   * `tddTaskId`, but sharing that session's `conversation_id`. Used
-   * to tell an agent "your hooks may be attributing to a detached
-   * session" rather than a bare "no artifact found". Returns 0 when
-   * `tddTaskId` is unknown or its session's `conversation_id` is
-   * null — the diagnostic never fabricates a signal it cannot back.
-   */
-  readonly countRecentArtifactsInOtherSessionsOfConversation: (input: {
-    readonly tddTaskId: number;
-    readonly sinceIso: string;
-  }) => Effect.Effect<number, DataStoreError>;
-  /**
-   * List artifacts recorded for a TDD task, optionally filtered
-   * by `artifactKind`, `phaseId`, or `behaviorId`. Returns rows in
-   * recorded_at DESC order so the most recently captured artifact
-   * (the typical citation target for a phase transition) appears
-   * first. `limit` defaults to 50.
-   */
-  readonly listTddArtifactsForTask: (input: {
-    readonly tddTaskId: number;
-    readonly artifactKind?: ArtifactKind;
-    readonly phaseId?: number;
-    readonly behaviorId?: number;
-    readonly limit?: number;
-  }) => Effect.Effect<ReadonlyArray<TddArtifactRow>, DataStoreError>;
-  readonly listHypotheses: (options: {
-    readonly sessionId?: number;
-    readonly outcome?: "confirmed" | "refuted" | "abandoned" | "open";
-    readonly limit?: number;
-  }) => Effect.Effect<ReadonlyArray<HypothesisDetail>, DataStoreError>;
-  readonly findIdempotentResponse: (procedurePath: string, key: string) => Effect.Effect<Option.Option<string>, DataStoreError>;
-  readonly getLatestTestCaseForSession: (chatId: string) => Effect.Effect<Option.Option<number>, DataStoreError>;
-  /**
-   * Returns one `TagInventoryRow` per `(tag, project)` pair observed in
-   * each project's latest test run. When `project` is supplied, results
-   * are restricted to that project's latest run.
-   */
-  readonly listTagInventory: (options?: {
-    readonly project?: string;
-  }) => Effect.Effect<ReadonlyArray<TagInventoryRow>, DataStoreError>;
-  /**
-   * Returns every `TestListEntry` from the latest run of each project
-   * (or the specified project) whose test case carries `tag`.
-   */
-  readonly listTestsForTag: (tag: string, options?: {
-    readonly project?: string;
-  }) => Effect.Effect<ReadonlyArray<TestListEntry>, DataStoreError>;
-}>;
-/** @public */
-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 */
-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 */
-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 */
-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 */
-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 */
-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 */
-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 */
-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, 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