@vitest-agent/sdk 3.1.1 → 4.0.0

package/index.d.ts

@@ -1,9 +1,4 @@
-import { Context, Effect, FileSystem, Layer, LogLevel, Option, Path, PubSub, Schema } from "effect";
-import { ConfigFileShape } from "@effected/config-file";
-import { SqlClient } from "effect/unstable/sql/SqlClient";
-import { WorkspaceDiscovery, WorkspaceDiscoveryFailure, WorkspaceRootNotFoundError } from "@effected/workspaces";
-import { AppDirs } from "@effected/xdg";
-import { ChildProcessSpawner } from "effect/unstable/process";
+import { PubSub, Schema } from "effect";
 //#region src/schemas/Coverage.d.ts
 /**
  * Aggregate coverage percentages across four istanbul metrics.
@@ -972,6 +967,12 @@ export type RenderedOutput = {
 /** @public */
 export interface FormatterContext {
   readonly detail: DetailLevel;
+  /**
+   * Absolute project root the run executed from. Formatters strip it from
+   * absolute file paths for display and resolve relative paths back against
+   * it for `file://` hyperlinks — the core never reads `process.cwd()`.
+   */
+  readonly cwd: string;
   readonly noColor: boolean;
   readonly coverageConsoleLimit: number;
   readonly trendSummary?: {
@@ -1978,70 +1979,63 @@ export declare const SilentFormatter: Formatter;
 /** @public */
 export declare const TerminalFormatter: Formatter;
 //#endregion
-//#region src/schemas/Config.d.ts
-declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Struct<{
-  readonly cacheDir: Schema.optional<Schema.String>;
-  readonly projectKey: Schema.optional<Schema.String>;
+//#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;
 }>, {}>;
 /**
- * Schema for the optional `vitest-agent.config.toml` file.
- *
- * Both fields are optional. When the file is absent or these fields are
- * unset, `resolveDataPath` falls back to deriving the path from the
- * workspace's `package.json` `name` under the XDG data directory.
+ * Successful registration row. The fields mirror the `agents` SQLite
+ * table 1:1 in camelCase.
  *
- * Fields:
- * - `cacheDir` — absolute path overriding the entire data directory. Highest
- *   precedence after the programmatic option. Use this to relocate the SQLite
- *   database (e.g. project-local `.vitest-agent/`) instead of the
- *   default XDG location.
- * - `projectKey` — overrides the workspace key segment under the XDG data
- *   directory. Use this when two unrelated projects on the same machine
- *   share a `package.json` `name` (the collision case for workspace-name
- *   keying), or when you want a stable key independent of `name` changes.
+ * `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 VitestAgentConfig extends VitestAgentConfig_base {}
-//#endregion
-//#region src/services/Config.d.ts
+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;
 /**
- * Service shape that `ConfigLive(projectDir)` provides to downstream
- * consumers. Re-exported so callers can spell out the concrete service
- * type without referencing the `ConfigFileShape<A>` generic directly.
+ * 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 type VitestAgentConfigFileService = ConfigFileShape<VitestAgentConfig>;
-declare const VitestAgentConfigFile_base: import("effect/Context").ServiceClass<VitestAgentConfigFile, "vitest-agent/Config", ConfigFileShape<VitestAgentConfig>>;
+export declare class IdempotencyHit extends IdempotencyHit_base<{
+  readonly existingAgentId: typeof AgentId.Type;
+}> {}
 /**
- * Typed service class (Context tag) for the vitest-agent config file service.
- *
- * Both runtime packages (reporter, MCP) yield this tag to access the loaded
- * `VitestAgentConfig`. The live layer is built per `projectDir` via
- * `ConfigLive(projectDir)`.
+ * Sum type of the two possible outcomes of `registerAgent`.
  * @public
  */
-export declare class VitestAgentConfigFile extends VitestAgentConfigFile_base {}
-//#endregion
-//#region src/layers/ConfigLive.d.ts
+export type RegisterAgentResult = Agent | IdempotencyHit;
 /**
- * Build the live `ConfigFile` layer for a given project directory.
- *
- * Resolves the optional `vitest-agent.config.toml` from (in order):
- *
- * 1. The workspace root (when `projectDir` is inside a pnpm/npm/yarn workspace).
- * 2. The git repository root (when `projectDir` is inside a git repo).
- * 3. Walking upward from `projectDir`.
- *
- * The first found file wins (`MergeStrategy.firstMatch()`). If no file is
- * present, downstream callers use `loadOrDefault(new VitestAgentConfig({}))`
- * to get an empty config.
- *
- * @param projectDir - Absolute path inside the user's workspace. Resolvers
- *   anchor here rather than `process.cwd()` so the plugin-spawned MCP server
- *   sees the right config even when invoked from elsewhere.
+ * Agent tree — root agent with all descendants nested under
+ * `children`. Returned by `DataStore.getAgentTree` for forensics and
+ * the `vitest-agent agent list` CLI subcommand.
  * @public
  */
-export declare const ConfigLive: (projectDir: string) => Layer.Layer<VitestAgentConfigFile, never, FileSystem.FileSystem | Path.Path>;
+export interface AgentTreeNode {
+  readonly agent: Agent;
+  readonly children: ReadonlyArray<AgentTreeNode>;
+}
 //#endregion
 //#region src/schemas/Baselines.d.ts
 /**
@@ -2104,2107 +2098,87 @@ export declare const CacheManifest: Schema.Struct<{
 /** @public */
 export type CacheManifest = typeof CacheManifest.Type;
 //#endregion
-//#region src/schemas/History.d.ts
-/**
- * A single test run outcome (pass or fail only).
- * @public
- */
-export declare const TestRun: Schema.Struct<{
-  readonly timestamp: Schema.String;
-  readonly state: Schema.Literals<readonly ["passed", "failed"]>;
-}>;
+//#region src/schemas/ChannelEvent.d.ts
 /** @public */
-export type TestRun = typeof TestRun.Type;
-/**
- * History for a single test across multiple runs.
- * @public
- */
-export declare const TestHistory: 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"]>;
-  }>>;
-}>;
+export declare const SessionOutcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
 /** @public */
-export type TestHistory = typeof TestHistory.Type;
-/**
- * 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"]>;
-    }>>;
+export type SessionOutcome = typeof SessionOutcome.Type;
+/** @public */
+export declare const GoalsReadyEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"goals_ready">;
+  readonly sessionId: Schema.Number;
+  readonly goals: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
   }>>;
 }>;
 /** @public */
-export type HistoryRecord = typeof HistoryRecord.Type;
-//#endregion
-//#region src/schemas/Tdd.d.ts
+export type GoalsReadyEvent = typeof GoalsReadyEvent.Type;
 /** @public */
-export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const GoalAddedEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"goal_added">;
+  readonly sessionId: Schema.Number;
+  readonly goal: Schema.Struct<{
+    readonly id: Schema.Number;
+    readonly ordinal: Schema.Number;
+    readonly goal: Schema.String;
+  }>;
+}>;
 /** @public */
-export type GoalStatus = typeof GoalStatus.Type;
+export type GoalAddedEvent = typeof GoalAddedEvent.Type;
 /** @public */
-export declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const GoalStartedEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"goal_started">;
+  readonly sessionId: Schema.Number;
+  readonly goalId: Schema.Number;
+}>;
 /** @public */
-export type BehaviorStatus = typeof BehaviorStatus.Type;
+export type GoalStartedEvent = typeof GoalStartedEvent.Type;
 /** @public */
-export declare const GoalRow: Schema.Struct<{
-  readonly id: Schema.Number;
+export declare const GoalCompletedEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"goal_completed">;
   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 goalId: Schema.Number;
+  readonly behaviorIds: Schema.$Array<Schema.Number>;
 }>;
 /** @public */
-export type GoalRow = typeof GoalRow.Type;
+export type GoalCompletedEvent = typeof GoalCompletedEvent.Type;
 /** @public */
-export declare const BehaviorRow: Schema.Struct<{
-  readonly id: Schema.Number;
+export declare const GoalAbandonedEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"goal_abandoned">;
+  readonly sessionId: 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 reason: Schema.String;
 }>;
 /** @public */
-export type BehaviorRow = typeof BehaviorRow.Type;
+export type GoalAbandonedEvent = typeof GoalAbandonedEvent.Type;
 /** @public */
-export declare const GoalDetail: Schema.Struct<{
-  readonly id: Schema.Number;
+export declare const BehaviorsReadyEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"behaviors_ready">;
   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 goalId: Schema.Number;
   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;
+export type BehaviorsReadyEvent = typeof BehaviorsReadyEvent.Type;
 /** @public */
-export declare const BehaviorDetail: Schema.Struct<{
-  readonly id: Schema.Number;
+export declare const BehaviorAddedEvent: Schema.Struct<{
+  readonly type: Schema.Literal<"behavior_added">;
+  readonly sessionId: 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 behavior: 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 */
-export type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
-/** @public */
-export 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
- */
-export type ArtifactSuite = "vitest" | "bats";
-/** @public */
-export 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;
-}
-/** @public */
-export interface PhaseTransitionContext {
-  readonly tdd_task_id: number;
-  readonly current_phase: Phase;
-  /**
-   * `tdd_phases.id` of the currently open phase row, or `null` when no phase
-   * has been opened yet (the implicit "spike" default before the first
-   * `tdd_phases` row exists). Compared against `cited_artifact.phase_id` for
-   * D2 binding rule 1 (issue #245).
-   */
-  readonly current_phase_id: number | null;
-  readonly phase_started_at: string;
-  readonly now: string;
-  readonly requested_phase: Phase;
-  readonly cited_artifact: CitedArtifact;
-  readonly requested_behavior_id: number | null;
-}
-/** @public */
-export type DenialReason = "missing_artifact_evidence" | "wrong_artifact_kind" | "wrong_source_phase" | "unknown_tdd_task" | "tdd_task_already_ended" | "goal_not_started" | "goal_not_found" | "goal_not_in_progress" | "goal_not_in_tdd_task" | "behavior_not_found" | "behavior_not_in_goal" | "refactor_without_passing_run" | "evidence_not_in_phase_window" | "evidence_not_for_behavior" | "evidence_test_was_already_failing";
-/** @public */
-export interface Remediation {
-  readonly suggestedTool: string;
-  readonly suggestedArgs: Record<string, unknown>;
-  readonly humanHint: string;
-}
-/** @public */
-export type PhaseTransitionResult = {
-  readonly accepted: true;
-  readonly phase: Phase;
-} | {
-  readonly accepted: false;
-  readonly phase: Phase;
-  readonly denialReason: DenialReason;
-  readonly remediation: Remediation;
-};
-/**
- * Return the artifact kind a phase transition requires, plus a
- * human-readable hint for surfacing in remediations.
- *
- * Exported so the MCP `tdd_phase_transition_request` tool can pre-compute
- * the expected kind when the agent omits `citedArtifactId` (auto-resolve
- * to the most recent matching artifact). The transitions without a
- * required artifact (`spike→red`, `*→red`, etc.) return `null`.
- * @public
- */
-export declare const requiredArtifactForTransition: (from: Phase, to: Phase) => {
-  kind: ArtifactKind;
-  humanHint: string;
-} | null;
-/**
- * Whether D2 binding rule 2 (behavior-match) applies to a given transition.
- *
- * Only the transitions whose cited evidence must belong to the behavior being
- * transitioned enforce behavior-match: `red→green` (the failing test for this
- * behavior) and `green→refactor` (its passing test). It deliberately excludes
- * `red.triangulate→green` (the cited failing run belongs to an earlier batch
- * behavior) and `refactor→red` (the required `test_passed_run` is the
- * just-finished behavior's, never the new target). Exported so the MCP
- * `tdd_phase_transition_request` tool scopes artifact auto-resolution by
- * behavior on exactly the same transitions the validator will accept —
- * keeping the two in lockstep (issue #115).
- * @public
- */
-export declare const transitionEnforcesBehaviorMatch: (from: Phase, to: Phase) => boolean;
-/** @public */
-export declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => PhaseTransitionResult;
-//#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;
-}> {}
-/**
- * Sum type of the two possible outcomes of `registerAgent`.
- * @public
- */
-export type RegisterAgentResult = Agent | IdempotencyHit;
-/**
- * Agent tree — root agent with all descendants nested under
- * `children`. Returned by `DataStore.getAgentTree` for forensics and
- * the `vitest-agent agent list` CLI subcommand.
- * @public
- */
-export interface AgentTreeNode {
-  readonly agent: Agent;
-  readonly children: ReadonlyArray<AgentTreeNode>;
-}
-//#endregion
-//#region src/services/DataStore.d.ts
-/** @public */
-export interface CreateGoalInput {
-  readonly tddTaskId: number;
-  readonly goal: string;
-}
-/** @public */
-export interface UpdateGoalInput {
-  readonly id: number;
-  readonly goal?: string;
-  readonly status?: GoalStatus;
-}
-/** @public */
-export interface CreateBehaviorInput {
-  readonly goalId: number;
-  readonly behavior: string;
-  readonly suggestedTestName?: string;
-  readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
-}
-/** @public */
-export interface UpdateBehaviorInput {
-  readonly id: number;
-  readonly behavior?: string;
-  readonly suggestedTestName?: string | null;
-  readonly status?: BehaviorStatus;
-  readonly dependsOnBehaviorIds?: ReadonlyArray<number>;
-}
-/** @public */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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;
-}
-/**
- * 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
- */
-export declare const INLINE_ATTACHMENT_BODY_CAP_BYTES: number;
-/** @public */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export interface FailureSignatureWriteInput {
-  readonly signatureHash: string;
-  readonly runId: number;
-  readonly seenAt: string;
-}
-/** @public */
-export interface HypothesisInput {
-  readonly sessionId: number;
-  readonly content: string;
-  readonly createdTurnId?: number;
-  readonly citedTestErrorId?: number;
-  readonly citedStackFrameId?: number;
-}
-/** @public */
-export interface ValidateHypothesisInput {
-  readonly id: number;
-  readonly outcome: "confirmed" | "refuted" | "abandoned";
-  readonly validatedTurnId?: number;
-  readonly validatedAt: string;
-}
-/** @public */
-export interface IdempotentResponseInput {
-  readonly procedurePath: string;
-  readonly key: string;
-  readonly resultJson: string;
-  readonly createdAt: string;
-}
-/** @public */
-export interface TddTaskInput {
-  readonly sessionId: number;
-  readonly goal: string;
-  readonly startedAt: string;
-  readonly parentTddTaskId?: number;
-  readonly runId?: string;
-}
-/** @public */
-export interface EndTddTaskInput {
-  readonly id: number;
-  readonly endedAt: string;
-  readonly outcome: "succeeded" | "blocked" | "abandoned";
-  readonly summaryNoteId?: number;
-}
-/** @public */
-export interface WriteTddPhaseInput {
-  readonly tddTaskId: number;
-  readonly behaviorId?: number;
-  readonly phase: Phase;
-  readonly startedAt: string;
-  readonly transitionReason?: string;
-  readonly parentPhaseId?: number;
-}
-/** @public */
-export interface WriteTddPhaseOutput {
-  readonly id: number;
-  readonly previousPhaseId: number | null;
-}
-/** @public */
-export 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 */
-export interface WriteCommitInput {
-  readonly sha: string;
-  readonly parentSha?: string;
-  readonly message?: string;
-  readonly author?: string;
-  readonly committedAt?: string;
-  readonly branch?: string;
-}
-/** @public */
-export type ChangeKind = "added" | "modified" | "deleted" | "renamed" | "untracked-modified";
-/** @public */
-export interface RunChangedFile {
-  readonly filePath: string;
-  readonly changeKind: ChangeKind;
-  readonly commitSha?: string;
-}
-/** @public */
-export interface WriteRunChangedFilesInput {
-  readonly runId: number;
-  readonly files: ReadonlyArray<RunChangedFile>;
-}
-/** @public */
-export 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
- */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export 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 */
-export interface TestListEntry {
-  readonly id: number;
-  readonly fullName: string;
-  readonly state: string;
-  readonly duration: number | null;
-  readonly module: string;
-  readonly classification: string | null;
-}
-/** @public */
-export interface ModuleListEntry {
-  readonly id: number;
-  readonly file: string;
-  readonly state: string;
-  readonly testCount: number;
-  readonly duration: number | null;
-}
-/** @public */
-export interface SuiteListEntry {
-  readonly id: number;
-  readonly name: string;
-  readonly module: string;
-  readonly state: string;
-  readonly testCount: number;
-}
-/** @public */
-export interface SettingsListEntry {
-  readonly hash: string;
-  readonly capturedAt: string;
-}
-/** @public */
-export 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 */
-export interface TurnSummary {
-  readonly id: number;
-  readonly sessionId: number;
-  readonly turnNo: number;
-  readonly type: string;
-  readonly payload: string;
-  readonly occurredAt: string;
-}
-/** @public */
-export 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
- */
-export 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
- */
-export interface TestLookupOptions {
-  /** Exact `module_path` match — picks one variant of an ambiguous `full_name`. */
-  readonly modulePath?: string;
-}
-/** @public */
-export interface TurnSearchOptions {
-  readonly sessionId?: number;
-  readonly type?: string;
-  readonly since?: string;
-  readonly limit?: number;
-}
-/** @public */
-export 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 */
-export 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 */
-export interface TddPhaseDetail {
-  readonly id: number;
-  readonly behaviorId: number | null;
-  readonly phase: string;
-  readonly startedAt: string;
-  readonly endedAt: string | null;
-  readonly transitionReason: string | null;
-}
-/** @public */
-export interface TddArtifactDetail {
-  readonly id: number;
-  readonly phaseId: number;
-  readonly artifactKind: string;
-  readonly testCaseId: number | null;
-  readonly testRunId: number | null;
-  readonly recordedAt: string;
-}
-/** @public */
-export 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 */
-export interface CurrentTddPhase {
-  readonly id: number;
-  readonly phase: Phase;
-  readonly startedAt: string;
-  readonly behaviorId: number | null;
-}
-/** @public */
-export interface CitedArtifactRow extends CitedArtifact {
-  readonly phase_id: number;
-}
-/** @public */
-export 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 */
-export 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 */
-export 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
- */
-export 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 */
-export 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 */
-export interface TestArtifactQueryOptions {
-  /** Disambiguates a fullName that exists in more than one module. */
-  readonly modulePath?: string;
-}
-/** @public */
-export 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 */
-export 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 */
-export 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/layers/DataReaderLive.d.ts
-/** @public */
-export declare const DataReaderLive: Layer.Layer<DataReader, never, SqlClient>;
-//#endregion
-//#region src/layers/DataStoreLive.d.ts
-/** @public */
-export declare const DataStoreLive: Layer.Layer<DataStore, never, SqlClient>;
-//#endregion
-//#region src/services/DetailResolver.d.ts
-/** @public */
-export interface RunHealth {
-  readonly hasFailures: boolean;
-  readonly belowTargets: boolean;
-  readonly hasTargets?: boolean;
-}
-declare const DetailResolver_base: Context.ServiceClass<DetailResolver, "vitest-agent/DetailResolver", {
-  readonly resolve: (executor: Executor, health: RunHealth, explicit?: DetailLevel) => Effect.Effect<DetailLevel>;
-}>;
-/** @public */
-export declare class DetailResolver extends DetailResolver_base {}
-//#endregion
-//#region src/layers/DetailResolverLive.d.ts
-/** @public */
-export declare const DetailResolverLive: Layer.Layer<DetailResolver, never, never>;
-//#endregion
-//#region src/services/DiscoveryRegistry.d.ts
-/**
- * Input for upserting a known project into the global discovery registry.
- *
- * @public
- */
-export interface KnownProjectInput {
-  readonly projectKey: string;
-  readonly canonicalForm: string;
-  readonly dataDbPath: string;
-  readonly gitRemoteOrigin: string | null;
-  readonly workspaceRoot: string;
-}
-/**
- * A project record as stored in the global discovery registry.
- *
- * @public
- */
-export interface KnownProject {
-  readonly projectKey: string;
-  readonly canonicalForm: string;
-  readonly dataDbPath: string;
-  readonly gitRemoteOrigin: string | null;
-  readonly workspaceRoot: string;
-  readonly firstSeenAt: number;
-  readonly lastSeenAt: number;
-}
-declare const DiscoveryRegistry_base: Context.ServiceClass<DiscoveryRegistry, "vitest-agent/DiscoveryRegistry", {
-  /**
-   * Upsert this project into the registry. Sets `first_seen_at` on
-   * insert; updates `last_seen_at` plus all mutable fields on
-   * conflict. Returns nothing — the call is fire-and-observe.
-   */
-  readonly recordProject: (input: KnownProjectInput) => Effect.Effect<void, DataStoreError>;
-  /**
-   * List all projects ordered by most recent activity first. Used by
-   * cross-project discovery tooling.
-   */
-  readonly listProjects: () => Effect.Effect<ReadonlyArray<KnownProject>, DataStoreError>;
-  /**
-   * Drop registry rows whose `last_seen_at` is older than `maxAgeDays`
-   * days ago. The corresponding `data.db` files are NOT deleted; only
-   * the index entry is pruned. Returns the count of removed rows.
-   */
-  readonly prune: (maxAgeDays: number) => Effect.Effect<number, DataStoreError>;
-}>;
-/** @public */
-export declare class DiscoveryRegistry extends DiscoveryRegistry_base {}
-//#endregion
-//#region src/layers/DiscoveryRegistryLive.d.ts
-/** @public */
-export declare const DiscoveryRegistryLive: Layer.Layer<DiscoveryRegistry, never, SqlClient>;
-//#endregion
-//#region src/services/EnvironmentDetector.d.ts
-declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector, "vitest-agent/EnvironmentDetector", {
-  readonly detect: () => Effect.Effect<Environment>;
-  readonly isAgent: Effect.Effect<boolean>;
-  readonly agentName: Effect.Effect<string | undefined>;
-}>;
-/** @public */
-export declare class EnvironmentDetector extends EnvironmentDetector_base {}
-//#endregion
-//#region src/layers/EnvironmentDetectorLive.d.ts
-/** @public */
-export declare const EnvironmentDetectorLive: Layer.Layer<EnvironmentDetector>;
-//#endregion
-//#region src/layers/EnvironmentDetectorTest.d.ts
-/** @public */
-export declare const EnvironmentDetectorTest: {
-  layer: (env?: Environment) => Layer.Layer<EnvironmentDetector, never, never>;
-};
-//#endregion
-//#region src/services/ExecutorResolver.d.ts
-declare const ExecutorResolver_base: Context.ServiceClass<ExecutorResolver, "vitest-agent/ExecutorResolver", {
-  readonly resolve: (env: Environment) => Effect.Effect<Executor>;
-}>;
-/** @public */
-export declare class ExecutorResolver extends ExecutorResolver_base {}
-//#endregion
-//#region src/layers/ExecutorResolverLive.d.ts
-/** @public */
-export declare const ExecutorResolverLive: Layer.Layer<ExecutorResolver, never, never>;
-//#endregion
-//#region src/services/FormatSelector.d.ts
-declare const FormatSelector_base: Context.ServiceClass<FormatSelector, "vitest-agent/FormatSelector", {
-  readonly select: (executor: Executor, explicitFormat?: OutputFormat, environment?: Environment) => Effect.Effect<OutputFormat>;
-}>;
-/** @public */
-export declare class FormatSelector extends FormatSelector_base {}
-//#endregion
-//#region src/layers/FormatSelectorLive.d.ts
-/**
- * Default format dispatch:
- *
- * - GitHub Actions CI executor: `ci-annotations` (renders as `::error::`).
- * - Human executor: `silent` (Vitest's own reporters handle the user
- *   experience; we just write to the database).
- * - Anyone else (agent-shell, terminal-bound CI): `terminal` — plain
- *   text + ANSI color, no markdown syntax in the place that doesn't
- *   render it. Markdown stays available via explicit `format: "markdown"`
- *   for surfaces that *do* render it (MCP tools, GitHub step summary).
- * @public
- */
-export declare const FormatSelectorLive: Layer.Layer<FormatSelector, never, never>;
-//#endregion
-//#region src/services/HistoryTracker.d.ts
-/**
- * Lightweight test outcome for history classification.
- * @public
- */
-export interface TestOutcome {
-  readonly modulePath: string;
-  readonly fullName: string;
-  readonly state: "passed" | "failed";
-}
-/**
- * Builds the composite (modulePath, fullName) key used to key the internal
- * testMap and the returned classifications Map, so identically-named tests
- * in different files classify independently instead of colliding.
- *
- * Uses `JSON.stringify` for an injective encoding: a plain delimiter such as
- * a space is not collision-proof (e.g. `("a b", "c")` and `("a", "b c")` would
- * both yield `"a b c"`), which would reintroduce the very collision class this
- * key exists to prevent.
- * @public
- */
-export declare const historyKey: (modulePath: string, fullName: string) => string;
-declare const HistoryTracker_base: Context.ServiceClass<HistoryTracker, "vitest-agent/HistoryTracker", {
-  readonly classify: (project: string, testOutcomes: ReadonlyArray<TestOutcome>, timestamp: string) => Effect.Effect<{
-    history: HistoryRecord;
-    classifications: Map<string, TestClassification>;
-  }, DataStoreError>;
-}>;
-/** @public */
-export declare class HistoryTracker extends HistoryTracker_base {}
-//#endregion
-//#region src/layers/HistoryTrackerLive.d.ts
-/** @public */
-export declare const HistoryTrackerLive: Layer.Layer<HistoryTracker, never, DataReader>;
-//#endregion
-//#region src/layers/HistoryTrackerTest.d.ts
-/** @public */
-export interface HistoryTrackerTestState {
-  readonly classifyCalls: Array<{
-    project: string;
-    timestamp: string;
-  }>;
-}
-/** @public */
-export declare const HistoryTrackerTest: {
-  readonly empty: () => HistoryTrackerTestState;
-  readonly layer: (state: HistoryTrackerTestState, cannedResult?: {
-    history: HistoryRecord;
-    classifications: Map<string, TestClassification>;
-  }) => Layer.Layer<HistoryTracker>;
-};
-//#endregion
-//#region src/layers/LoggerLive.d.ts
-/**
- * Create a structured JSON (NDJSON) logger layer for stderr.
- *
- * When level is undefined or `"None"`, installs an empty logger set (silent).
- * When logFile is set, composes the stderr logger with a file logger.
- * Uses `Logger.formatJson` / `Logger.formatStructured` for machine-readable
- * output.
- * @public
- */
-export declare const LoggerLive: (level?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<never>;
-/** @public */
-export declare function resolveLogLevel(option?: string): LogLevel.LogLevel | undefined;
-/**
- * Resolve log file from option or environment variable.
- * @public
- */
-export declare function resolveLogFile(option?: string): string | undefined;
-//#endregion
-//#region src/layers/OutputPipelineLive.d.ts
-/** @public */
-export declare const OutputPipelineLive: Layer.Layer<DetailResolver | EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
-//#endregion
-//#region src/services/OutputRenderer.d.ts
-declare const OutputRenderer_base: Context.ServiceClass<OutputRenderer, "vitest-agent/OutputRenderer", {
-  readonly render: (reports: ReadonlyArray<AgentReport>, format: OutputFormat, context: FormatterContext) => Effect.Effect<ReadonlyArray<RenderedOutput>>;
-}>;
-/** @public */
-export declare class OutputRenderer extends OutputRenderer_base {}
-//#endregion
-//#region src/layers/OutputRendererLive.d.ts
-/** @public */
-export declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
-//#endregion
-//#region src/layers/PathResolutionLive.d.ts
-/**
- * Composite layer providing every service `resolveDataPath` requires:
- * `AppDirs` (XDG path resolution), `VitestAgentConfigFile` (TOML
- * config loader), and `WorkspaceDiscovery` / `WorkspaceRoot` (workspace name
- * lookup).
- *
- * Callers still need to provide `FileSystem` and `Path` from
- * `@effect/platform-node`'s `NodeServices.layer` (or the equivalent on Bun).
- *
- * `WorkspaceDiscovery` is pinned to `projectDir` as its `cwd`, which sets the
- * root for the layer-bound methods (`listPackages`, `info`, `refresh`). The
- * per-root methods (`listPackagesIn`, `infoIn`, `refreshIn`) take a directory
- * per call and ignore that pin — `resolveWorkspaceKey` and
- * `ProjectIdentityLive` use them, so a long-lived host built against one root
- * still answers correctly for a git worktree or an unrelated project.
- *
- * @param projectDir - Absolute path inside the user's workspace, used to
- *   anchor the config file resolvers and workspace discovery.
- * @public
- */
-export declare const PathResolutionLive: (projectDir: string) => Layer.Layer<AppDirs | VitestAgentConfigFile | WorkspaceDiscovery, import("@effected/xdg").XdgEnvError, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
-//#endregion
-//#region src/services/PerClientSessionMap.d.ts
-/** @public */
-export interface MapSessionInput {
-  readonly hostSessionId: string;
-  readonly conversationId: string;
-  readonly projectKey: string;
-  readonly projectDir: string;
-}
-/** @public */
-export interface MapSessionOutput {
-  readonly mainAgentId: string;
-  readonly conversationId: string;
-}
-/** @public */
-export interface SessionContextRow {
-  readonly hostSessionId: string;
-  readonly conversationId: string;
-  readonly projectKey: string;
-  readonly projectDir: string;
-  readonly mainAgentId: string;
-  readonly startedAt: number;
-  readonly endedAt: number | null;
-}
-declare const PerClientSessionMapReader_base: Context.ServiceClass<PerClientSessionMapReader, "vitest-agent/PerClientSessionMapReader", {
-  /**
-   * Look up an existing conversation_id for a given transcript
-   * path. Returns `Option.none()` when the transcript hasn't been
-   * seen before. Read-only — does not insert.
-   */
-  readonly lookupConversation: (transcriptPath: string) => Effect.Effect<Option.Option<string>, DataStoreError>;
-  /**
-   * Return the most recent open session for a project_dir
-   * (`ended_at IS NULL`). The MCP server uses this to recover
-   * `currentSessionContext` after `/reload-plugins`. The compound
-   * index `idx_session_map_active` covers the predicate.
-   */
-  readonly lookupByProjectDir: (projectDir: string) => Effect.Effect<Option.Option<SessionContextRow>, DataStoreError>;
-}>;
-/**
- * Read-only side of the session map.
- *
- * Provided by `PerClientSessionMapReaderLive` (opens SQLite with
- * `?mode=ro`). MCP server depends on this tag — calls to write
- * methods would be a type error.
- * @public
- */
-export declare class PerClientSessionMapReader extends PerClientSessionMapReader_base {}
-declare const PerClientSessionMapWriter_base: Context.ServiceClass<PerClientSessionMapWriter, "vitest-agent/PerClientSessionMapWriter", {
-  /**
-   * Upsert a conversation row. Returns the canonical conversation_id
-   * for the given transcript_path (existing if seen before, freshly
-   * generated otherwise).
-   */
-  readonly mapConversation: (transcriptPath: string) => Effect.Effect<string, DataStoreError>;
-  /**
-   * Upsert a session row. Returns the canonical main_agent_id and
-   * conversation_id (existing if `host_session_id` was seen before,
-   * freshly generated otherwise).
-   *
-   * The caller is responsible for having already mapped the
-   * conversation; this method only records the
-   * (host_session_id, conversation_id, project) tuple.
-   */
-  readonly mapSession: (input: MapSessionInput) => Effect.Effect<MapSessionOutput, DataStoreError>;
-  /**
-   * Mark a session as ended. Sets `ended_at` to the supplied
-   * timestamp. No-op if the session is unknown — endSession is
-   * best-effort cleanup.
-   */
-  readonly endSession: (hostSessionId: string, endedAt: number) => Effect.Effect<void, DataStoreError>;
-  /**
-   * Read methods so the Writer also satisfies the Reader tag's
-   * surface.
-   */
-  readonly lookupConversation: (transcriptPath: string) => Effect.Effect<Option.Option<string>, DataStoreError>;
-  readonly lookupByProjectDir: (projectDir: string) => Effect.Effect<Option.Option<SessionContextRow>, DataStoreError>;
-}>;
-/**
- * Read-write side of the session map. Sidecar provides this; the
- * Writer layer also satisfies the Reader tag so consumers of either
- * one resolve.
- * @public
- */
-export declare class PerClientSessionMapWriter extends PerClientSessionMapWriter_base {}
-//#endregion
-//#region src/layers/PerClientSessionMapLive.d.ts
-/**
- * Read-only layer. The entry point provides an `SqlClient` configured
- * with the `?mode=ro` URI parameter; this layer wraps the read
- * methods and never declares write methods.
- * @public
- */
-export declare const PerClientSessionMapReaderLive: Layer.Layer<PerClientSessionMapReader, never, SqlClient>;
-/**
- * Read-write layer. Provides both write methods and the Reader's read
- * methods so the same layer instance satisfies callers of either
- * tag.
- * @public
- */
-export declare const PerClientSessionMapWriterLive: Layer.Layer<PerClientSessionMapWriter | PerClientSessionMapReader, never, SqlClient>;
-//#endregion
-//#region src/services/ProjectDiscovery.d.ts
-/** @public */
-export interface TestFileEntry {
-  readonly testFile: string;
-  readonly sourceFiles: ReadonlyArray<string>;
-}
-declare const ProjectDiscovery_base: Context.ServiceClass<ProjectDiscovery, "vitest-agent/ProjectDiscovery", {
-  readonly discoverTestFiles: (rootDir: string) => Effect.Effect<ReadonlyArray<TestFileEntry>, DiscoveryError>;
-  readonly mapTestToSource: (testFile: string) => Effect.Effect<ReadonlyArray<string>, DiscoveryError>;
-}>;
-/** @public */
-export declare class ProjectDiscovery extends ProjectDiscovery_base {}
-//#endregion
-//#region src/layers/ProjectDiscoveryLive.d.ts
-/** @public */
-export declare const ProjectDiscoveryLive: Layer.Layer<ProjectDiscovery, never, FileSystem.FileSystem>;
-//#endregion
-//#region src/layers/ProjectDiscoveryTest.d.ts
-/** @public */
-export declare const ProjectDiscoveryTest: {
-  readonly layer: (entries: ReadonlyArray<TestFileEntry>) => Layer.Layer<ProjectDiscovery>;
-};
-//#endregion
-//#region src/services/ProjectIdentity.d.ts
-/**
- * Result of a successful identity resolution.
- *
- * - `projectKey` — filesystem-safe single segment for the per-project
- *   data store directory under `$XDG_DATA_HOME/vitest-agent/`.
- * - `canonicalForm` — human-readable form for display in the discovery
- *   registry. Equal to `projectKey` for non-git sources; for git
- *   sources, the original `host/path` shape (with slashes preserved).
- * - `source` — which source matched. Useful for diagnostics and the
- *   `vitest-agent doctor`-style commands.
- * @public
- */
-export interface ResolvedIdentity {
-  readonly projectKey: string;
-  readonly canonicalForm: string;
-  readonly source: ProjectIdentitySource;
-}
-/** @public */
-export type ProjectIdentitySource = "explicit" | "toml" | "git-remote" | "package-repository" | "package-name";
-/**
- * Per-source candidate values. Each is optional — an absent or empty
- * value causes the resolver to fall through to the next source.
- *
- * The Live layer collects these from real I/O (config file, git
- * subprocess, `package.json` read). Tests pass a literal object.
- * @public
- */
-export interface ProjectIdentityCandidates {
-  readonly explicit?: string;
-  readonly toml?: string;
-  readonly gitRemote?: string;
-  readonly packageJsonRepoUrl?: string;
-  readonly packageJsonName?: string;
-}
-/**
- * Options accepted by the `ProjectIdentity.resolve` service method.
- *
- * `projectId` is the priority-1 escape hatch — pass when the user has
- * configured `AgentPlugin({ projectId: "..." })` in `vitest.config.ts`.
- * @public
- */
-export interface ResolveProjectIdentityOptions {
-  readonly projectId?: string;
-}
-/**
- * Pure priority resolver. Returns `null` when no candidate produces a
- * usable value — the caller wraps `null` into a tagged error.
- *
- * For non-git sources the `canonicalForm` equals the original
- * (un-normalized) input so the discovery registry can display
- * `@spencerbeggs/vitest-agent` rather than the underscored form. For
- * git sources, `canonicalForm` is the slash-preserving `host/path`
- * shape from `canonicalizeGitUrl`.
- * @public
- */
-export declare const resolveProjectIdentityFromCandidates: (candidates: ProjectIdentityCandidates) => ResolvedIdentity | null;
-declare const ProjectIdentity_base: Context.ServiceClass<ProjectIdentity, "vitest-agent/ProjectIdentity", {
-  readonly resolve: (workspaceRoot: string, options?: ResolveProjectIdentityOptions) => Effect.Effect<ResolvedIdentity, ProjectIdentityNotResolvableError>;
-}>;
-/**
- * Service tag. The Live layer (in `layers/ProjectIdentityLive.ts`)
- * wires up the I/O sources; tests provide a stub that returns a
- * pre-built `ResolvedIdentity`.
- * @public
- */
-export declare class ProjectIdentity extends ProjectIdentity_base {}
-//#endregion
-//#region src/layers/ProjectIdentityLive.d.ts
-/**
- * Effect environment type required by `collectCandidates` and the
- * `ProjectIdentityLive` layer. Exported only so the layer's
- * `Layer.Layer<ProjectIdentity, never, CandidateContext>` signature
- * has a named referent — consumers should provide the four named
- * services (FileSystem, WorkspaceDiscovery, VitestAgentConfigFile,
- * CommandExecutor) rather than reference this type directly.
- *
- * @public
- */
-export type CandidateContext = FileSystem.FileSystem | WorkspaceDiscovery | VitestAgentConfigFile | ChildProcessSpawner.ChildProcessSpawner;
-/**
- * Live layer that wires the resolver into real I/O. Requires
- * `FileSystem`, `CommandExecutor`, `WorkspaceDiscovery`, and
- * `VitestAgentConfigFile`. The platform context comes from
- * `NodeServices.layer` at the entry point.
- * @public
- */
-export declare const ProjectIdentityLive: Layer.Layer<ProjectIdentity, never, CandidateContext>;
-/**
- * Build a Test layer that returns a fixed `ResolvedIdentity` (or
- * fails with `ProjectIdentityNotResolvableError`). Use in unit tests
- * that depend on `ProjectIdentity` but don't want to wire upstream
- * services.
- * @public
- */
-export declare const ProjectIdentityTest: (result: ResolvedIdentity | ProjectIdentityNotResolvableError) => Layer.Layer<ProjectIdentity, never, never>;
-//#endregion
-//#region src/services/RunContext.d.ts
-declare const RunContext_base: Schema.Class<RunContext, Schema.Struct<{
-  readonly gitBranch: Schema.NullOr<Schema.String>;
-  readonly gitCommitSha: Schema.NullOr<Schema.String>;
-  readonly gitDirty: Schema.NullOr<Schema.Boolean>;
-  readonly gitUpstream: Schema.NullOr<Schema.String>;
-  readonly gitWorktreeDir: Schema.NullOr<Schema.String>;
-  readonly hostSource: Schema.NullOr<Schema.String>;
-  readonly hostValue: Schema.NullOr<Schema.String>;
-  readonly hostMetadata: Schema.NullOr<Schema.Unknown>;
-}>, {}>;
-/**
- * Per-run snapshot of the workspace's git state and host context.
- * Every field is nullable: a non-git workspace has all-NULL git
- * fields, a CI run with no terminal probe match has all-NULL host
- * fields, and a worker that can't read upstream info has a NULL
- * `gitUpstream` while everything else is set.
- *
- * Declared as a `Schema.Class` so callers can `new RunContext({...})`
- * and `Schema.encode(...)` for the SQLite row mapping.
- * @public
- */
-export declare class RunContext extends RunContext_base {}
-declare const AgentContext_base: Schema.Class<AgentContext, Schema.Struct<{
-  readonly startGitBranch: Schema.NullOr<Schema.String>;
-  readonly startGitCommitSha: Schema.NullOr<Schema.String>;
-  readonly startWorktreeDir: Schema.NullOr<Schema.String>;
-}>, {}>;
-/**
- * Subset of {@link RunContext} captured at agent registration. Only
- * the inheritable git context — branch, sha, worktree path. Mid-run
- * dirty-tree state and upstream tracking are per-run concerns.
- * @public
- */
-export declare class AgentContext extends AgentContext_base {}
-declare const RunContext$_base: Context.ServiceClass<RunContext$, "vitest-agent/RunContextService", {
-  readonly captureRunContext: (cwd: string) => Effect.Effect<RunContext>;
-  readonly captureAgentContext: (cwd: string) => Effect.Effect<AgentContext>;
-}>;
-/**
- * Service tag. The Live layer captures real I/O; the Test layer
- * returns whatever the test fixture passes.
- * @public
- */
-export declare class RunContext$ extends RunContext$_base {}
-/**
- * Re-export the service tag under a less-collision-prone name. The
- * `RunContext` Schema.Class above shares its symbol-name with the
- * service tag concept; the `$` suffix on the Context.Tag class name
- * keeps both addressable from the same module.
- *
- * @public
- */
-export declare const RunContextService: typeof RunContext$;
-/** @public */
-export type RunContextService = RunContext$;
-//#endregion
-//#region src/layers/RunContextLive.d.ts
-/**
- * Live layer. Requires `ChildProcessSpawner` (provided by
- * `NodeServices.layer` at the entry point). Reads `process.env`
- * directly for host-metadata probes — the env walk is pure but the
- * env source is process-global, captured once when the layer
- * constructs.
- * @public
- */
-export declare const RunContextLive: Layer.Layer<RunContextService, never, ChildProcessSpawner.ChildProcessSpawner>;
-/**
- * Build a Test layer that returns fixed `RunContext` and
- * `AgentContext` values regardless of `cwd`.
- * @public
- */
-export declare const RunContextTest: (fixture: {
-  readonly runContext: RunContext;
-  readonly agentContext: AgentContext;
-}) => Layer.Layer<RunContextService, never, never>;
-//#endregion
-//#region src/lib/format-triage.d.ts
-/** @public */
-interface FormatTriageOptions {
-  readonly project?: string;
-  readonly maxLines?: number;
-}
-/**
- * Generates an orientation triage markdown string for LLM agents.
- * Summarises recent test runs, active sessions, acceptance metrics,
- * and (forward-compat) the most recent TDD session.
- *
- * Error channel is `never` — all DataReader errors are swallowed and
- * replaced with empty defaults so the caller is guaranteed a string.
- * @public
- */
-export declare const formatTriageEffect: (options?: FormatTriageOptions) => Effect.Effect<string, never, DataReader>;
-//#endregion
-//#region src/lib/format-wrapup.d.ts
-/** @public */
-type WrapupKind = "stop" | "session_end" | "pre_compact" | "tdd_handoff" | "user_prompt_nudge";
-/** @public */
-interface FormatWrapupOptions {
-  readonly sessionId?: number;
-  readonly chatId?: string;
-  readonly kind: WrapupKind;
-  readonly userPromptHint?: string;
-}
-/** @public */
-export declare const formatWrapupEffect: (options: FormatWrapupOptions) => Effect.Effect<string, never, DataReader>;
-//#endregion
-//#region src/migrations/0001_initial.d.ts
-/** @internal */
-declare const migration: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
-//#endregion
-//#region src/migrations/0002_test_artifacts.d.ts
-/** @internal */
-declare const migration$1: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
-//#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/migrations/registry_0001_initial.d.ts
-/**
- * Migration for the global discovery registry SQLite at
- * `$XDG_DATA_HOME/vitest-agent/registry.db`.
- *
- * Single table `known_projects` indexed by `project_key` (the
- * filesystem-safe form from {@link ProjectIdentity}). Tooling like
- * `mcp-app` queries this table to enumerate every vitest-agent
- * project the user has ever run on this machine.
- *
- * The registry never blocks anything — its writes are best-effort.
- * Concurrent writers from multiple Claude Code windows converge via
- * the `ON CONFLICT(project_key) DO UPDATE` upsert.
- * @public
- */
-declare const migration$2: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
-//#endregion
-//#region src/migrations/session_map_0001_initial.d.ts
-/** @internal */
-declare const migration$3: Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>;
-//#endregion
-//#region src/schemas/ChannelEvent.d.ts
-/** @public */
-export declare const SessionOutcome: Schema.Literals<readonly ["succeeded", "blocked", "abandoned"]>;
-/** @public */
-export type SessionOutcome = typeof SessionOutcome.Type;
-/** @public */
-export declare const GoalsReadyEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"goals_ready">;
-  readonly sessionId: Schema.Number;
-  readonly goals: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly goal: Schema.String;
-  }>>;
-}>;
-/** @public */
-export type GoalsReadyEvent = typeof GoalsReadyEvent.Type;
-/** @public */
-export declare const GoalAddedEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"goal_added">;
-  readonly sessionId: Schema.Number;
-  readonly goal: Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly goal: Schema.String;
-  }>;
-}>;
-/** @public */
-export type GoalAddedEvent = typeof GoalAddedEvent.Type;
-/** @public */
-export declare const GoalStartedEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"goal_started">;
-  readonly sessionId: Schema.Number;
-  readonly goalId: Schema.Number;
-}>;
-/** @public */
-export type GoalStartedEvent = typeof GoalStartedEvent.Type;
-/** @public */
-export declare const GoalCompletedEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"goal_completed">;
-  readonly sessionId: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly behaviorIds: Schema.$Array<Schema.Number>;
-}>;
-/** @public */
-export type GoalCompletedEvent = typeof GoalCompletedEvent.Type;
-/** @public */
-export declare const GoalAbandonedEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"goal_abandoned">;
-  readonly sessionId: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly reason: Schema.String;
-}>;
-/** @public */
-export type GoalAbandonedEvent = typeof GoalAbandonedEvent.Type;
-/** @public */
-export declare const BehaviorsReadyEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"behaviors_ready">;
-  readonly sessionId: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly behaviors: Schema.$Array<Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly behavior: Schema.String;
-  }>>;
-}>;
-/** @public */
-export type BehaviorsReadyEvent = typeof BehaviorsReadyEvent.Type;
-/** @public */
-export declare const BehaviorAddedEvent: Schema.Struct<{
-  readonly type: Schema.Literal<"behavior_added">;
-  readonly sessionId: Schema.Number;
-  readonly goalId: Schema.Number;
-  readonly behavior: Schema.Struct<{
-    readonly id: Schema.Number;
-    readonly ordinal: Schema.Number;
-    readonly behavior: Schema.String;
-  }>;
-}>;
-/** @public */
-export type BehaviorAddedEvent = typeof BehaviorAddedEvent.Type;
+export type BehaviorAddedEvent = typeof BehaviorAddedEvent.Type;
 /** @public */
 export declare const BehaviorStartedEvent: Schema.Struct<{
   readonly type: Schema.Literal<"behavior_started">;
@@ -4362,6 +2336,31 @@ export declare const BehaviorScopedEventTypes: readonly ["behavior_started", "ph
 /** @public */
 export type BehaviorScopedEventType = (typeof BehaviorScopedEventTypes)[number];
 //#endregion
+//#region src/schemas/Config.d.ts
+declare const VitestAgentConfig_base: Schema.Class<VitestAgentConfig, Schema.Struct<{
+  readonly cacheDir: Schema.optional<Schema.String>;
+  readonly projectKey: Schema.optional<Schema.String>;
+}>, {}>;
+/**
+ * Schema for the optional `vitest-agent.config.toml` file.
+ *
+ * Both fields are optional. When the file is absent or these fields are
+ * unset, `resolveDataPath` falls back to deriving the path from the
+ * workspace's `package.json` `name` under the XDG data directory.
+ *
+ * Fields:
+ * - `cacheDir` — absolute path overriding the entire data directory. Highest
+ *   precedence after the programmatic option. Use this to relocate the SQLite
+ *   database (e.g. project-local `.vitest-agent/`) instead of the
+ *   default XDG location.
+ * - `projectKey` — overrides the workspace key segment under the XDG data
+ *   directory. Use this when two unrelated projects on the same machine
+ *   share a `package.json` `name` (the collision case for workspace-name
+ *   keying), or when you want a stable key independent of `name` changes.
+ * @public
+ */
+export declare class VitestAgentConfig extends VitestAgentConfig_base {}
+//#endregion
 //#region src/schemas/ConsoleLeaks.d.ts
 /**
  * Per-file stray-console-output detail. Counts are of console writes
@@ -4536,6 +2535,50 @@ export declare const CoverageTargets: Schema.$Record<Schema.String, Schema.Union
 /** @public */
 export type CoverageTargets = typeof CoverageTargets.Type;
 //#endregion
+//#region src/schemas/History.d.ts
+/**
+ * A single test run outcome (pass or fail only).
+ * @public
+ */
+export declare const TestRun: Schema.Struct<{
+  readonly timestamp: Schema.String;
+  readonly state: Schema.Literals<readonly ["passed", "failed"]>;
+}>;
+/** @public */
+export type TestRun = typeof TestRun.Type;
+/**
+ * History for a single test across multiple runs.
+ * @public
+ */
+export declare const TestHistory: 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 TestHistory = typeof TestHistory.Type;
+/**
+ * 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/Options.d.ts
 /**
  * Per-executor console-output matrix. Most users never set this — the
@@ -4822,6 +2865,85 @@ export declare const RunReportFile: Schema.Struct<{
 /** @public */
 export type RunReportFile = typeof RunReportFile.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/TestArtifacts.d.ts
 /**
  * Source position a test annotation or test artifact points at.
@@ -4913,6 +3035,56 @@ export declare const TestArtifact: Schema.Struct<{
 /** @public */
 export type TestArtifact = typeof TestArtifact.Type;
 //#endregion
+//#region src/schemas/Trends.d.ts
+/**
+ * A single coverage trend data point recorded on a full test run.
+ * @public
+ */
+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/schemas/turns/FileEditPayload.d.ts
 /** @public */
 export declare const FileEditPayload: Schema.Struct<{
@@ -5037,97 +3209,6 @@ export declare const TurnPayload: Schema.Union<readonly [Schema.Struct<{
 /** @public */
 export type TurnPayload = typeof TurnPayload.Type;
 //#endregion
-//#region src/services/idempotency.d.ts
-/**
- * Sentinel substituted for `parentAgentId` when the value is `null`.
- * Avoids ambiguity around hashing the literal string "null" or empty
- * string, both of which could collide with caller-supplied values.
- * @public
- */
-export declare const IDEMPOTENCY_ROOT_SENTINEL = "__ROOT__";
-/** @public */
-export interface IdempotencyInput {
-  readonly agentType: string;
-  readonly parentAgentId: string | null;
-  readonly clientNonce: string;
-}
-/**
- * Derive the canonical idempotency key for an `agents` row.
- *
- * Algorithm:
- *   sha256(agentType + "|" + (parentAgentId ?? "__ROOT__") + "|" + clientNonce)
- *   then base32 (RFC 4648 alphabet, lowercased) truncated to 26 chars.
- *
- * 26 base32 chars = 130 bits, far beyond the birthday-bound for the
- * scoping (UNIQUE per session). The base32 alphabet is a-z2-7 — all
- * lowercase to keep the column lexicographically friendly and
- * case-insensitive on filesystems that we never hit but might in
- * future debugging.
- * @public
- */
-export declare const deriveIdempotencyKey: (input: IdempotencyInput) => string;
-//#endregion
-//#region src/sql/assemblers.d.ts
-/**
- * Minimal shape of a test_runs aggregation row used to build the manifest.
- * @public
- */
-export interface ManifestRow {
-  project: string;
-  sub_project: string | null;
-  timestamp: string;
-  reason: string;
-}
-/**
- * Minimal shape of a test_history row used to build a history record.
- * @public
- */
-export interface HistoryRow {
-  module_path: string;
-  full_name: string;
-  timestamp: string;
-  state: string;
-}
-/**
- * A `Record<compositeKey, { modulePath, fullName, runs: TestRun[] }>` keyed by
- * the injective `historyKey(modulePath, fullName)` string, so identically-named
- * tests in different files are tracked as distinct entries.
- *
- * This is the internal representation returned by `assembleHistoryRecord`.
- * Callers that need the Effect Schema `HistoryRecord` type should adapt this
- * into the `tests` array format.
- * @public
- */
-export interface AssembledHistoryRecord {
-  [compositeKey: string]: {
-    modulePath: string;
-    fullName: string;
-    runs: TestRun[];
-  };
-}
-/**
- * Builds a `CacheManifest` from an array of test_runs aggregation rows.
- *
- * Each row represents the latest run for a project/sub_project pair.
- * The `dbPath` is stored as `cacheDir` so CLI tools can locate the source.
- * @public
- */
-export declare function assembleManifest(rows: ManifestRow[], dbPath: string): CacheManifest;
-/**
- * Groups test_history rows by the composite (module_path, full_name) key
- * into a keyed record.
- *
- * Returns `Record<compositeKey, { modulePath, fullName, runs: TestRun[] }>`
- * where `runs` are the accumulated test runs for that test, in the order
- * they appear in `rows`. Two rows sharing `full_name` but differing
- * `module_path` are tracked as distinct entries rather than merged.
- *
- * Only rows with state `"passed"` or `"failed"` are included in runs
- * (matching the `TestRun` schema constraint).
- * @public
- */
-export declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHistoryRecord;
-//#endregion
 //#region src/utils/ansi.d.ts
 /**
  * Options for ANSI color output control.
@@ -5642,36 +3723,6 @@ export declare const isTimeoutError: (error: {
   name?: string;
 }) => boolean;
 //#endregion
-//#region src/utils/ensure-migrated.d.ts
-/**
- * Ensure the SQLite database at `dbPath` is migrated. Runs migrations at
- * most once per dbPath in the current process; concurrent calls share the
- * same in-flight promise. Subsequent calls (after the first resolves) are
- * no-ops.
- * @public
- */
-export declare function ensureMigrated(dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string): Promise<void>;
-/**
- * Reset the migration cache. Test-only.
- *
- * @internal
- */
-export declare function _resetMigrationCacheForTesting(): void;
-//#endregion
-//#region src/utils/failure-signature.d.ts
-/** @public */
-export interface FailureSignatureInput {
-  readonly error_name: string;
-  readonly assertion_message: string;
-  readonly top_frame_function_name: string;
-  readonly top_frame_function_boundary_line: number | null;
-  readonly top_frame_raw_line?: number;
-}
-/** @public */
-export declare const normalizeAssertionShape: (message: string) => string | null;
-/** @public */
-export declare const computeFailureSignature: (input: FailureSignatureInput) => string;
-//#endregion
 //#region src/utils/format-console.d.ts
 /**
  * Options controlling console markdown output formatting.
@@ -5679,6 +3730,8 @@ export declare const computeFailureSignature: (input: FailureSignatureInput) =>
  * @internal
  */
 export interface ConsoleFormatOptions {
+  /** Absolute project root; stripped from file paths for display. */
+  cwd: string;
   /** Output verbosity: `"failures"` (default), `"full"`, or `"silent"`. */
   consoleOutput: "failures" | "full" | "silent";
   /** Maximum number of low-coverage files to show in console output. */
@@ -5723,12 +3776,12 @@ export declare function getWorstMetric(f: FileCoverageReport): {
  * project-relative path for display.
  *
  * @param filePath - Absolute or relative file path
- * @param cwd - Working directory to strip; defaults to `process.cwd()`
+ * @param cwd - Working directory to strip
  * @returns Project-relative path string
  *
  * @internal
  */
-export declare function relativePath(filePath: string, cwd?: string): string;
+export declare function relativePath(filePath: string, cwd: string): string;
 /**
  * Determine the output tier based on test results and coverage state.
  *
@@ -5926,6 +3979,41 @@ export declare const detectVitestScripts: (scripts: Record<string, string>) => S
  */
 export declare function normalizeWorkspaceKey(name: string): string;
 //#endregion
+//#region src/utils/posix-path.d.ts
+/**
+ * Pure POSIX path helpers for the platform-free core.
+ *
+ * `@vitest-agent/sdk` must not import `node:path`, so the handful of path
+ * operations the core needs are implemented here over normalized
+ * forward-slash strings. Every helper accepts Windows-style input (a
+ * backslash separator) and normalizes it via {@link toPosix} at entry, so a
+ * caller never has to know which separator the platform used.
+ */
+/**
+ * Normalizes `p` to forward slashes: every backslash becomes `/`.
+ * @public
+ */
+export declare const toPosix: (p: string) => string;
+/**
+ * Last segment of `p` after normalization — `"b.ts"` for `"/a/b.ts"`.
+ * Trailing separators are ignored, so `"/a/b/"` yields `"b"`.
+ * @public
+ */
+export declare const basenamePosix: (p: string) => string;
+/**
+ * Joins `parts` with a single `/` between each, normalizing every part and
+ * collapsing duplicate separators at the seams. Empty parts are skipped.
+ * @public
+ */
+export declare const joinPosix: (...parts: ReadonlyArray<string>) => string;
+/**
+ * Path of `to` relative to `from`, both normalized. Returns `""` when they
+ * are the same path and `to` unchanged when it is not under `from` (no
+ * `../` climbing — the core has no notion of a filesystem to climb through).
+ * @public
+ */
+export declare const relativePosix: (from: string, to: string) => string;
+//#endregion
 //#region src/utils/probe-host-metadata.d.ts
 /** @public */
 export interface HostMetadataResult {
@@ -5955,99 +4043,6 @@ export interface HostMetadataResult {
  */
 export declare const probeHostMetadataFromEnv: (env: Record<string, string | undefined>) => HostMetadataResult;
 //#endregion
-//#region src/utils/resolve-data-path.d.ts
-/**
- * Filename of the SQLite database that stores all reporter data.
- * @public
- */
-export declare const DATABASE_FILENAME = "data.db";
-/**
- * Caller-supplied overrides for `resolveDataPath`.
- * @public
- */
-export interface ResolveDataPathOptions {
-  /**
-   * Programmatic override for the entire data directory. Highest precedence.
-   *
-   * Use this when the reporter or plugin user has explicitly set
-   * `reporter.cacheDir`. The returned path is `<cacheDir>/data.db`.
-   */
-  readonly cacheDir?: string;
-}
-/**
- * Resolve the absolute path to the SQLite database for `projectDir`.
- *
- * The directory containing the database is ensured to exist before the
- * function returns, so callers can open the database immediately without
- * needing to create parent directories. The SQLite driver creates the file
- * but not its parent.
- *
- * Precedence (highest first):
- *
- * 1. `options.cacheDir` — programmatic override.
- * 2. `cacheDir` from `vitest-agent.config.toml`.
- * 3. `<XDG data>/<normalized projectKey from config>/data.db`.
- * 4. `<XDG data>/<projectKey resolved from cwd's package.json>/data.db`.
- *    Source 4 prefers `repository.url` (canonicalized to `host__path`),
- *    falling back to the normalized `name`. This matches the sidecar
- *    CLI's `_internal register-agent` resolver so the reporter and
- *    sidecar always write to the same `data.db`.
- *
- * The XDG data directory is namespaced via `AppDirs` (typically
- * `$XDG_DATA_HOME/vitest-agent`, defaulting to
- * `~/.local/share/vitest-agent`).
- *
- * The path is a function of identity, not filesystem layout. When no
- * `package.json` is reachable from `projectDir`, the cwd basename is used
- * as the final fallback so the function never throws on identity lookup.
- *
- * @param projectDir - Absolute path inside the user's workspace.
- * @param options - Optional programmatic overrides.
- * @public
- */
-export declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOptions) => Effect.Effect<any, import("@effected/xdg").AppDirsError | import("effect/PlatformError").PlatformError | import("@effected/config-file").ConfigReadError, AppDirs | FileSystem.FileSystem | VitestAgentConfigFile>;
-//#endregion
-//#region src/utils/resolve-project-key-from-cwd.d.ts
-/**
- * Compute the project key for a workspace by reading `package.json`
- * fields directly. Returns the canonical `host__path` form when a git
- * remote URL is present, otherwise the normalized package name.
- *
- * Always returns a non-empty string — falls back to the cwd basename
- * (or `"anonymous-project"`) so callers don't have to handle the
- * empty case.
- * @public
- */
-export declare const resolveProjectKeyFromCwd: (cwd: string) => string;
-//#endregion
-//#region src/utils/resolve-workspace-key.d.ts
-/**
- * Resolve the normalized workspace key for the workspace containing
- * `projectDir`.
- *
- * The key is the root `package.json`'s `name`, normalized via
- * `normalizeWorkspaceKey`. This becomes the directory segment under
- * `$XDG_DATA_HOME/vitest-agent/` where the SQLite database lives.
- *
- * Fails with `WorkspaceRootNotFoundError` when no root workspace is
- * discoverable. `WorkspacePackage.name` is enforced non-empty by
- * `@effected/workspaces`'s schema, so a successful root lookup always yields a
- * usable name.
- *
- * Discovery is anchored at `projectDir` per call via `listPackagesIn`, not at
- * the `WorkspaceDiscovery` layer's `cwd`: patterns, member manifests and names
- * are read from beneath `projectDir`'s own root, so one long-lived layer
- * answers correctly for a git worktree, a nested repository, or an unrelated
- * project. Fails with the library's `WorkspaceRootNotFoundError` when
- * `projectDir` sits in no workspace at all; results are memoized per resolved
- * root, so many directories in one workspace share a single discovery.
- *
- * @param projectDir - Absolute path inside the workspace. Typically the
- *   reporter's resolved `projectDir` (CLAUDE_PROJECT_DIR or process.cwd()).
- * @public
- */
-export declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string, WorkspaceRootNotFoundError | WorkspaceDiscoveryFailure, WorkspaceDiscovery>;
-//#endregion
 //#region src/utils/safe-filename.d.ts
 /**
  * Convert a project name to a filesystem-safe filename.
@@ -6213,16 +4208,128 @@ export interface CoverageTargetsShapeResult {
  */
 export declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsShapeResult;
 //#endregion
-//#region src/index.d.ts
+//#region src/utils/validate-phase-transition.d.ts
+/** @public */
+export type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
+/** @public */
+export 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
+ */
+export type ArtifactSuite = "vitest" | "bats";
+/** @public */
+export 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;
+}
+/** @public */
+export interface PhaseTransitionContext {
+  readonly tdd_task_id: number;
+  readonly current_phase: Phase;
+  /**
+   * `tdd_phases.id` of the currently open phase row, or `null` when no phase
+   * has been opened yet (the implicit "spike" default before the first
+   * `tdd_phases` row exists). Compared against `cited_artifact.phase_id` for
+   * D2 binding rule 1 (issue #245).
+   */
+  readonly current_phase_id: number | null;
+  readonly phase_started_at: string;
+  readonly now: string;
+  readonly requested_phase: Phase;
+  readonly cited_artifact: CitedArtifact;
+  readonly requested_behavior_id: number | null;
+}
+/** @public */
+export type DenialReason = "missing_artifact_evidence" | "wrong_artifact_kind" | "wrong_source_phase" | "unknown_tdd_task" | "tdd_task_already_ended" | "goal_not_started" | "goal_not_found" | "goal_not_in_progress" | "goal_not_in_tdd_task" | "behavior_not_found" | "behavior_not_in_goal" | "refactor_without_passing_run" | "evidence_not_in_phase_window" | "evidence_not_for_behavior" | "evidence_test_was_already_failing";
+/** @public */
+export interface Remediation {
+  readonly suggestedTool: string;
+  readonly suggestedArgs: Record<string, unknown>;
+  readonly humanHint: string;
+}
+/** @public */
+export type PhaseTransitionResult = {
+  readonly accepted: true;
+  readonly phase: Phase;
+} | {
+  readonly accepted: false;
+  readonly phase: Phase;
+  readonly denialReason: DenialReason;
+  readonly remediation: Remediation;
+};
+/**
+ * Return the artifact kind a phase transition requires, plus a
+ * human-readable hint for surfacing in remediations.
+ *
+ * Exported so the MCP `tdd_phase_transition_request` tool can pre-compute
+ * the expected kind when the agent omits `citedArtifactId` (auto-resolve
+ * to the most recent matching artifact). The transitions without a
+ * required artifact (`spike→red`, `*→red`, etc.) return `null`.
+ * @public
+ */
+export declare const requiredArtifactForTransition: (from: Phase, to: Phase) => {
+  kind: ArtifactKind;
+  humanHint: string;
+} | null;
+/**
+ * Whether D2 binding rule 2 (behavior-match) applies to a given transition.
+ *
+ * Only the transitions whose cited evidence must belong to the behavior being
+ * transitioned enforce behavior-match: `red→green` (the failing test for this
+ * behavior) and `green→refactor` (its passing test). It deliberately excludes
+ * `red.triangulate→green` (the cited failing run belongs to an earlier batch
+ * behavior) and `refactor→red` (the required `test_passed_run` is the
+ * just-finished behavior's, never the new target). Exported so the MCP
+ * `tdd_phase_transition_request` tool scopes artifact auto-resolution by
+ * behavior on exactly the same transitions the validator will accept —
+ * keeping the two in lockstep (issue #115).
+ * @public
+ */
+export declare const transitionEnforcesBehaviorMatch: (from: Phase, to: Phase) => boolean;
+/** @public */
+export declare const validatePhaseTransition: (ctx: PhaseTransitionContext) => PhaseTransitionResult;
+//#endregion
+//#region src/version.d.ts
 /**
  * The version of this package. Inlined at build time from
  * package.json#version via rslib-builder's __PACKAGE_VERSION__ substitution.
  * Source-level reads (workspace `exports: "./src/index.ts"` during dev)
  * see the `"0.0.0"` fallback — a clear signal the build pipeline has not
  * substituted yet. Exported for version introspection by downstream tooling.
+ *
+ * This is the one sanctioned `process` read in the platform-free core: the
+ * bundler replaces the token at build time, so no runtime `process` access
+ * survives into the published artifact.
  * @public
  */
 export declare const CURRENT_SDK_VERSION: string;
 //#endregion
-export { FileCoverageReport as CoverageFile, type FormatTriageOptions, type FormatWrapupOptions, type WrapupKind, migration as migration0001, migration$1 as migration0002, migration$2 as registryMigration0001, migration$3 as sessionMapMigration0001 };
+export { FileCoverageReport as CoverageFile };
 //# sourceMappingURL=index.d.ts.map