@vitest-agent/sdk 2.4.13 → 2.5.1

package/testing.d.ts

@@ -9,7 +9,7 @@ declare const DataStoreError_base: new <A extends Record<string, any> = {}>(args
  * Error raised when a SQLite operation fails at read, write, or migration time.
  * @public
  */
-declare class DataStoreError extends DataStoreError_base<{
+export declare class DataStoreError extends DataStoreError_base<{
   readonly operation: "read" | "write" | "migrate";
   readonly table: string;
   readonly reason: string;
@@ -26,7 +26,7 @@ declare class DataStoreError extends DataStoreError_base<{
  * Complete per-project test report written to disk as JSON.
  * @public
  */
-declare const AgentReport: Schema.Struct<{
+export declare const AgentReport: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly project: Schema.optional<Schema.String>;
   readonly reason: Schema.Literals<readonly ["passed", "failed", "interrupted"]>;
@@ -132,6 +132,7 @@ declare const AgentReport: Schema.Struct<{
     }>>;
     readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
     readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly totalFiles: Schema.optional<Schema.Number>;
     readonly lowCoverage: Schema.$Array<Schema.Struct<{
       readonly file: Schema.String;
       readonly summary: Schema.Struct<{
@@ -170,17 +171,21 @@ declare const AgentReport: Schema.Struct<{
       readonly sample: Schema.optional<Schema.String>;
     }>>;
     readonly truncated: Schema.optional<Schema.Boolean>;
+    readonly fromFailingTests: Schema.optional<Schema.Struct<{
+      readonly total: Schema.Number;
+      readonly files: Schema.Number;
+    }>>;
   }>>;
 }>;
 /** @public */
-type AgentReport = typeof AgentReport.Type;
+export type AgentReport = typeof AgentReport.Type;
 //#endregion
 //#region src/schemas/Baselines.d.ts
 /**
  * Coverage baselines -- the auto-ratcheting high-water mark.
  * @public
  */
-declare const CoverageBaselines: Schema.Struct<{
+export declare const CoverageBaselines: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly global: Schema.Struct<{
     readonly lines: Schema.optional<Schema.Number>;
@@ -196,14 +201,14 @@ declare const CoverageBaselines: Schema.Struct<{
   }>]>>, never>;
 }>;
 /** @public */
-type CoverageBaselines = typeof CoverageBaselines.Type;
+export type CoverageBaselines = typeof CoverageBaselines.Type;
 //#endregion
 //#region src/schemas/CacheManifest.d.ts
 /**
  * Root manifest file that indexes all project reports.
  * @public
  */
-declare const CacheManifest: Schema.Struct<{
+export declare const CacheManifest: Schema.Struct<{
   readonly updatedAt: Schema.String;
   readonly cacheDir: Schema.String;
   readonly projects: Schema.$Array<Schema.Struct<{
@@ -215,14 +220,14 @@ declare const CacheManifest: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type CacheManifest = typeof CacheManifest.Type;
+export type CacheManifest = typeof CacheManifest.Type;
 //#endregion
 //#region src/schemas/Coverage.d.ts
 /**
  * Per-file coverage data including uncovered line ranges.
  * @public
  */
-declare const FileCoverageReport: Schema.Struct<{
+export declare const FileCoverageReport: Schema.Struct<{
   readonly file: Schema.String;
   readonly summary: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -233,12 +238,12 @@ declare const FileCoverageReport: Schema.Struct<{
   readonly uncoveredLines: Schema.String;
 }>;
 /** @public */
-type FileCoverageReport = typeof FileCoverageReport.Type;
+export type FileCoverageReport = typeof FileCoverageReport.Type;
 /**
  * Complete coverage report attached to an AgentReport.
  * @public
  */
-declare const CoverageReport: Schema.Struct<{
+export declare const CoverageReport: Schema.Struct<{
   readonly totals: Schema.Struct<{
     readonly statements: Schema.Number;
     readonly branches: Schema.Number;
@@ -289,6 +294,7 @@ declare const CoverageReport: Schema.Struct<{
   }>>;
   readonly scoped: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
   readonly scopedFiles: Schema.optional<Schema.$Array<Schema.String>>;
+  readonly totalFiles: Schema.optional<Schema.Number>;
   readonly lowCoverage: Schema.$Array<Schema.Struct<{
     readonly file: Schema.String;
     readonly summary: Schema.Struct<{
@@ -313,14 +319,14 @@ declare const CoverageReport: Schema.Struct<{
   readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
 }>;
 /** @public */
-type CoverageReport = typeof CoverageReport.Type;
+export type CoverageReport = typeof CoverageReport.Type;
 //#endregion
 //#region src/schemas/History.d.ts
 /**
  * Per-project history record containing all tracked tests.
  * @public
  */
-declare const HistoryRecord: Schema.Struct<{
+export declare const HistoryRecord: Schema.Struct<{
   readonly project: Schema.String;
   readonly updatedAt: Schema.String;
   readonly tests: Schema.$Array<Schema.Struct<{
@@ -333,19 +339,19 @@ declare const HistoryRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type HistoryRecord = typeof HistoryRecord.Type;
+export type HistoryRecord = typeof HistoryRecord.Type;
 //#endregion
 //#region src/schemas/Tdd.d.ts
 /** @public */
-declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const GoalStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type GoalStatus = typeof GoalStatus.Type;
+export type GoalStatus = typeof GoalStatus.Type;
 /** @public */
-declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
+export declare const BehaviorStatus: Schema.Literals<readonly ["pending", "in_progress", "done", "abandoned"]>;
 /** @public */
-type BehaviorStatus = typeof BehaviorStatus.Type;
+export type BehaviorStatus = typeof BehaviorStatus.Type;
 /** @public */
-declare const GoalRow: Schema.Struct<{
+export declare const GoalRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -354,9 +360,9 @@ declare const GoalRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type GoalRow = typeof GoalRow.Type;
+export type GoalRow = typeof GoalRow.Type;
 /** @public */
-declare const BehaviorRow: Schema.Struct<{
+export declare const BehaviorRow: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -366,9 +372,9 @@ declare const BehaviorRow: Schema.Struct<{
   readonly createdAt: Schema.String;
 }>;
 /** @public */
-type BehaviorRow = typeof BehaviorRow.Type;
+export type BehaviorRow = typeof BehaviorRow.Type;
 /** @public */
-declare const GoalDetail: Schema.Struct<{
+export declare const GoalDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly sessionId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -386,9 +392,9 @@ declare const GoalDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type GoalDetail = typeof GoalDetail.Type;
+export type GoalDetail = typeof GoalDetail.Type;
 /** @public */
-declare const BehaviorDetail: Schema.Struct<{
+export declare const BehaviorDetail: Schema.Struct<{
   readonly id: Schema.Number;
   readonly goalId: Schema.Number;
   readonly ordinal: Schema.Number;
@@ -412,14 +418,14 @@ declare const BehaviorDetail: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type BehaviorDetail = typeof BehaviorDetail.Type;
+export type BehaviorDetail = typeof BehaviorDetail.Type;
 //#endregion
 //#region src/schemas/Trends.d.ts
 /**
  * A single coverage trend data point recorded on a full test run.
  * @public
  */
-declare const TrendEntry: Schema.Struct<{
+export declare const TrendEntry: Schema.Struct<{
   readonly timestamp: Schema.String;
   readonly coverage: Schema.Struct<{
     readonly statements: Schema.Number;
@@ -437,12 +443,12 @@ declare const TrendEntry: Schema.Struct<{
   readonly targetsHash: Schema.optional<Schema.String>;
 }>;
 /** @public */
-type TrendEntry = typeof TrendEntry.Type;
+export type TrendEntry = typeof TrendEntry.Type;
 /**
  * Per-project trend record with sliding window of entries.
  * @public
  */
-declare const TrendRecord: Schema.Struct<{
+export declare const TrendRecord: Schema.Struct<{
   readonly entries: Schema.$Array<Schema.Struct<{
     readonly timestamp: Schema.String;
     readonly coverage: Schema.Struct<{
@@ -462,16 +468,35 @@ declare const TrendRecord: Schema.Struct<{
   }>>;
 }>;
 /** @public */
-type TrendRecord = typeof TrendRecord.Type;
+export type TrendRecord = typeof TrendRecord.Type;
 //#endregion
 //#region src/utils/validate-phase-transition.d.ts
 /** @public */
 type Phase = "spike" | "red" | "red.triangulate" | "green" | "green.fake-it" | "refactor" | "extended-red" | "green-without-red";
 /** @public */
 type ArtifactKind = "test_written" | "test_failed_run" | "code_written" | "test_passed_run" | "refactor" | "test_weakened";
+/**
+ * Explicit test-runner marker on a `tdd_artifacts` row (issue #363). `vitest`
+ * artifacts always carry a `test_case_id` when they anchor a specific test;
+ * `bats` artifacts never do (there is no `test_cases` row for a bats test),
+ * so the D2 binding-rule validator branches on this to accept a bats
+ * run-level artifact without weakening the vitest guard.
+ * @public
+ */
+type ArtifactSuite = "vitest" | "bats";
 /** @public */
 interface CitedArtifact {
   readonly id: number;
+  /**
+   * `tdd_phases.id` of the phase this artifact was actually recorded in — the
+   * artifact's own phase binding. This is the honest anchor for D2 binding
+   * rule 1's window check (issue #245): a test_case's first-ever creation
+   * turn can predate the current phase (e.g. authored during spike, then
+   * re-run inside red) without the evidence itself being stale, so the
+   * window check compares this against `PhaseTransitionContext.current_phase_id`
+   * rather than `test_case_created_turn_at`.
+   */
+  readonly phase_id: number;
   readonly artifact_kind: ArtifactKind;
   readonly test_case_id: number | null;
   readonly test_case_created_turn_at: string | null;
@@ -479,6 +504,12 @@ interface CitedArtifact {
   readonly test_run_id: number | null;
   readonly test_first_failure_run_id: number | null;
   readonly behavior_id: number | null;
+  /**
+   * Issue #363: explicit suite marker distinguishing vitest from bats runs.
+   * Optional on the pure type so hand-built contexts default to `vitest`;
+   * the DB row always carries the persisted value.
+   */
+  readonly suite?: ArtifactSuite;
 }
 //#endregion
 //#region src/schemas/Identity.d.ts
@@ -488,9 +519,9 @@ interface CitedArtifact {
  * agent's lifetime.
  * @public
  */
-declare const AgentId: Schema.brand<Schema.String, "AgentId">;
+export declare const AgentId: Schema.brand<Schema.String, "AgentId">;
 /** @public */
-type AgentId = Schema.Schema.Type<typeof AgentId>;
+export type AgentId = Schema.Schema.Type<typeof AgentId>;
 /**
  * The agent host process's chat id (Claude Code's per-process chat
  * UUID, etc.). Shorter-lived than a conversation; one conversation can
@@ -498,9 +529,9 @@ type AgentId = Schema.Schema.Type<typeof AgentId>;
  * `sessions.id` (the SQLite agent-run PK).
  * @public
  */
-declare const ChatId: Schema.brand<Schema.String, "ChatId">;
+export declare const ChatId: Schema.brand<Schema.String, "ChatId">;
 /** @public */
-type ChatId = Schema.Schema.Type<typeof ChatId>;
+export type ChatId = Schema.Schema.Type<typeof ChatId>;
 //#endregion
 //#region src/errors/AgentErrors.d.ts
 declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -512,7 +543,7 @@ declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(
  * this agent first.
  * @public
  */
-declare class AgentNotFoundError extends AgentNotFoundError_base<{
+export declare class AgentNotFoundError extends AgentNotFoundError_base<{
   readonly agentId: AgentId;
   readonly chatId?: ChatId;
 }> {}
@@ -525,7 +556,7 @@ declare const RegistrationConflictError_base: new <A extends Record<string, any>
  * caller named. Distinct from `IdempotencyHit`, which is a success.
  * @public
  */
-declare class RegistrationConflictError extends RegistrationConflictError_base<{
+export declare class RegistrationConflictError extends RegistrationConflictError_base<{
   readonly reason: string;
 }> {
   constructor(args: {
@@ -538,7 +569,7 @@ declare const GoalNotFoundError_base: new <A extends Record<string, any> = {}>(a
   readonly _tag: "GoalNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class GoalNotFoundError extends GoalNotFoundError_base<{
+export declare class GoalNotFoundError extends GoalNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -551,7 +582,7 @@ declare const BehaviorNotFoundError_base: new <A extends Record<string, any> = {
   readonly _tag: "BehaviorNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
+export declare class BehaviorNotFoundError extends BehaviorNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -564,7 +595,7 @@ declare const TddTaskNotFoundError_base: new <A extends Record<string, any> = {}
   readonly _tag: "TddTaskNotFoundError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
+export declare class TddTaskNotFoundError extends TddTaskNotFoundError_base<{
   readonly id: number;
   readonly reason: string;
 }> {
@@ -579,7 +610,7 @@ declare const TddTaskAlreadyEndedError_base: new <A extends Record<string, any>
   readonly _tag: "TddTaskAlreadyEndedError";
 } & Readonly<A>;
 /** @public */
-declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
+export declare class TddTaskAlreadyEndedError extends TddTaskAlreadyEndedError_base<{
   readonly id: number;
   readonly endedAt: string;
   readonly outcome: TddTaskEndOutcome;
@@ -596,7 +627,7 @@ declare const IllegalStatusTransitionError_base: new <A extends Record<string, a
   readonly _tag: "IllegalStatusTransitionError";
 } & Readonly<A>;
 /** @public */
-declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
+export declare class IllegalStatusTransitionError extends IllegalStatusTransitionError_base<{
   readonly entity: IllegalStatusTransitionEntity;
   readonly id: number;
   readonly from: string;
@@ -636,7 +667,7 @@ declare const Agent_base: Schema.Class<Agent, Schema.TaggedStruct<"Agent", {
  * two reveals a mid-session branch switch, which is itself signal.
  * @public
  */
-declare class Agent extends Agent_base {}
+export declare class Agent extends Agent_base {}
 declare const IdempotencyHit_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
   readonly _tag: "IdempotencyHit";
 } & import("effect/Pipeable").Pipeable;
@@ -651,10 +682,33 @@ declare const IdempotencyHit_base: new <A extends Record<string, any> = {}>(args
  * downstream code uses `Match.tag` to branch.
  * @public
  */
-declare class IdempotencyHit extends IdempotencyHit_base<{
+export declare class IdempotencyHit extends IdempotencyHit_base<{
   readonly existingAgentId: typeof AgentId.Type;
 }> {}
 //#endregion
+//#region src/schemas/Thresholds.d.ts
+/**
+ * Fully resolved thresholds ready for evaluation.
+ * @public
+ */
+declare const ResolvedThresholds: Schema.Struct<{
+  readonly global: Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>;
+  readonly perFile: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
+  readonly patterns: Schema.withDecodingDefaultKey<Schema.$Array<Schema.Tuple<readonly [Schema.String, Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>]>>, never>;
+}>;
+/** @public */
+type ResolvedThresholds = typeof ResolvedThresholds.Type;
+//#endregion
 //#region src/services/DataStore.d.ts
 /** @public */
 interface CreateGoalInput {
@@ -879,6 +933,13 @@ interface SessionInput {
   readonly parentSessionId?: number;
   readonly triageWasNonEmpty?: boolean;
   readonly startedAt: string;
+  /**
+   * Canonical conversation UUID this session belongs to (issue #144).
+   * Set once at INSERT time — `sessions.conversation_id` is immutable
+   * thereafter (see the `trg_sessions_conv_id_immutable` trigger), so
+   * omit it here rather than trying to backfill via an update.
+   */
+  readonly conversationId?: string;
 }
 /** @public */
 interface TurnInput {
@@ -956,6 +1017,8 @@ interface WriteTddArtifactInput {
   readonly testFirstFailureRunId?: number;
   readonly diffExcerpt?: string;
   readonly recordedAt: string;
+  /** Issue #363: explicit suite marker. Defaults to `"vitest"` when omitted. */
+  readonly suite?: ArtifactSuite;
 }
 /** @public */
 interface WriteCommitInput {
@@ -1030,6 +1093,18 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   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>;
@@ -1048,6 +1123,20 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
    * `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>;
@@ -1098,7 +1187,7 @@ declare const DataStore_base: Context.ServiceClass<DataStore, "vitest-agent/Data
   readonly endAgent: (agentId: string, endedAt: number) => Effect.Effect<void, AgentNotFoundError | DataStoreError>;
 }>;
 /** @public */
-declare class DataStore extends DataStore_base {}
+export declare class DataStore extends DataStore_base {}
 //#endregion
 //#region src/services/DataReader.d.ts
 /** @public */
@@ -1225,6 +1314,8 @@ interface SessionDetail {
   readonly startedAt: string;
   readonly endedAt: string | null;
   readonly endReason: string | null;
+  /** Canonical conversation UUID this session belongs to (issue #144), null when unset. */
+  readonly conversationId: string | null;
 }
 /** @public */
 interface TurnSummary {
@@ -1406,6 +1497,7 @@ interface TddArtifactRow {
   readonly testRunId: number | null;
   readonly testFirstFailureRunId: number | null;
   readonly recordedAt: string;
+  readonly suite: ArtifactSuite;
 }
 /** @public */
 interface TagInventoryRow {
@@ -1519,7 +1611,32 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
      * 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
@@ -1558,25 +1675,25 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   }) => Effect.Effect<ReadonlyArray<TestListEntry>, DataStoreError>;
 }>;
 /** @public */
-declare class DataReader extends DataReader_base {}
+export declare class DataReader extends DataReader_base {}
 //#endregion
 //#region src/testing/layers.d.ts
 /** @public */
-declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 //#endregion
 //#region src/testing/index.d.ts
 /** @public */
-declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
+export declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, DataStoreError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
 /** @public */
-declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, BehaviorNotFoundError | DataStoreError | GoalNotFoundError | IllegalStatusTransitionError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError | TddTaskAlreadyEndedError | TddTaskNotFoundError, never>;
+export declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, BehaviorNotFoundError | DataStoreError | GoalNotFoundError | IllegalStatusTransitionError | import("@effect/sql-sqlite-node/SqliteMigrator").MigrationError | import("effect/unstable/sql/SqlError").SqlError | TddTaskAlreadyEndedError | TddTaskNotFoundError, never>;
 //#endregion
-export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataReader, DataStore, DataStoreError, DataStoreTestLayer, type EndTddTaskInput, type FailureSignatureDetail, type FailureSignatureWriteInput, type FileCoverageInput, FileCoverageReport, type FlakyTest, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, type HistoryQueryOptions, HistoryRecord, type HypothesisDetail, type HypothesisInput, IdempotencyHit, type IdempotentResponseInput, type IllegalStatusTransitionEntity, IllegalStatusTransitionError, type ModuleInput, type ModuleListEntry, type NoteInput, type NoteRow, type PersistentFailure, type Phase, type ProjectRunSummary, type RegisterAgentInput, RegistrationConflictError, type RunChangedFile, type RunInvocationMethod, type SessionDetail, type SessionInput, type SettingsInput, type SettingsListEntry, type SettingsRow, type StackFrameInput, type SuiteInput, type SuiteListEntry, type TagInventoryRow, type TddArtifactDetail, type TddArtifactRow, type TddPhaseDetail, TddTaskAlreadyEndedError, type TddTaskDetail, type TddTaskEndOutcome, type TddTaskInput, TddTaskNotFoundError, type TddTaskSummary, type TestCaseInput, type TestError, type TestErrorInput, type TestListEntry, type TestLookupOptions, type TestRunInput, TrendEntry, TrendRecord, type TurnInput, type TurnSearchOptions, type TurnSummary, type UpdateBehaviorInput, type UpdateGoalInput, type ValidateHypothesisInput, type WriteCommitInput, type WriteRunChangedFilesInput, type WriteTddArtifactInput, type WriteTddPhaseInput, type WriteTddPhaseOutput, empty, flaky, makeTestLayer, singlePassingRun, withFailures, withTddTask };
+export type { AcceptanceMetrics, ArtifactKind, ArtifactSuite, AssociateRunSessionInput, ChangeKind, CitedArtifact, CitedArtifactRow, ClassificationQueryOptions, CommitChangesEntry, CreateBehaviorInput, CreateGoalInput, CurrentTddPhase, EndTddTaskInput, FailureSignatureDetail, FailureSignatureWriteInput, FileCoverageInput, FlakyTest, HistoryQueryOptions, HypothesisDetail, HypothesisInput, IdempotentResponseInput, IllegalStatusTransitionEntity, ModuleInput, ModuleListEntry, NoteInput, NoteRow, PersistentFailure, Phase, ProjectRunSummary, RegisterAgentInput, ResolvedThresholds, RunChangedFile, RunInvocationMethod, SessionDetail, SessionInput, SettingsInput, SettingsListEntry, SettingsRow, StackFrameInput, SuiteInput, SuiteListEntry, TagInventoryRow, TddArtifactDetail, TddArtifactRow, TddPhaseDetail, TddTaskDetail, TddTaskEndOutcome, TddTaskInput, TddTaskSummary, TestCaseInput, TestError, TestErrorInput, TestListEntry, TestLookupOptions, TestRunInput, TurnInput, TurnSearchOptions, TurnSummary, UpdateBehaviorInput, UpdateGoalInput, ValidateHypothesisInput, WriteCommitInput, WriteRunChangedFilesInput, WriteTddArtifactInput, WriteTddPhaseInput, WriteTddPhaseOutput };
 //# sourceMappingURL=testing.d.ts.map

package/utils/console-leaks.js

@@ -10,14 +10,28 @@ function truncateSample(content) {
 * Aggregate raw console-leak entries into a ConsoleLeaks signal:
 * bucket by file, split stdout/stderr, collect attributable test names,
 * capture one truncated sample per file, sort by total writes descending,
-* and cap the file list. Returns `undefined` when there are no entries so a
-* clean run attaches nothing.
+* and cap the file list. Entries logged inside a failing test (with
+* `failed` set) are excluded from `total`/`byFile` — the actionable leak signal —
+* and summarized instead in `fromFailingTests` (issue #263: a logger-backed
+* assertion failure otherwise makes every red run look like a leak). Returns
+* `undefined` only when there is no output at all, non-failing or failing.
 * @public
 */
 function buildConsoleLeaks(entries) {
 	if (entries.length === 0) return void 0;
+	const nonFailing = entries.filter((e) => e.failed !== true);
+	const failing = entries.filter((e) => e.failed === true);
+	const fromFailingTests = failing.length > 0 ? {
+		total: failing.length,
+		files: new Set(failing.map((e) => e.file)).size
+	} : void 0;
+	if (nonFailing.length === 0) return {
+		total: 0,
+		byFile: [],
+		...fromFailingTests !== void 0 ? { fromFailingTests } : {}
+	};
 	const byFile = /* @__PURE__ */ new Map();
-	for (const e of entries) {
+	for (const e of nonFailing) {
 		let acc = byFile.get(e.file);
 		if (acc === void 0) {
 			acc = {
@@ -46,30 +60,43 @@ function buildConsoleLeaks(entries) {
 	files.sort((a, b) => b.stdout + b.stderr - (a.stdout + a.stderr));
 	const truncated = files.length > MAX_FILES;
 	return {
-		total: entries.length,
+		total: nonFailing.length,
 		byFile: truncated ? files.slice(0, MAX_FILES) : files,
-		...truncated ? { truncated: true } : {}
+		...truncated ? { truncated: true } : {},
+		...fromFailingTests !== void 0 ? { fromFailingTests } : {}
 	};
 }
 /**
 * Walk a Vitest `File[]` task tree (from `vitest.state.getFiles()`) into flat
 * {@link ConsoleLeakEntry} values. Each task `log` becomes one entry attributed
 * to its enclosing file and, when the log sits on a test task, that test's name.
+* An entry is marked `failed: true` when it was logged inside a test whose own
+* `result.state` is `"fail"`, or — for output with no owning test — when the
+* enclosing file itself failed (e.g. a collection/load error).
 * @public
 */
 function collectConsoleLeakEntries(files) {
 	const entries = [];
-	const visit = (task, file, test) => {
-		const currentTest = task.type === "test" ? task.fullTestName ?? task.name ?? test : test;
-		for (const log of task.logs ?? []) entries.push({
-			file,
-			...currentTest !== void 0 ? { test: currentTest } : {},
-			type: log.type,
-			content: log.content
-		});
-		for (const child of task.tasks ?? []) visit(child, file, currentTest);
+	const visit = (task, file, test, testFailed, fileFailed) => {
+		const isTest = task.type === "test";
+		const currentTest = isTest ? task.fullTestName ?? task.name ?? test : test;
+		const currentTestFailed = isTest ? task.result?.state === "fail" : testFailed;
+		for (const log of task.logs ?? []) {
+			const failed = currentTest !== void 0 ? currentTestFailed : fileFailed;
+			entries.push({
+				file,
+				...currentTest !== void 0 ? { test: currentTest } : {},
+				type: log.type,
+				content: log.content,
+				...failed ? { failed: true } : {}
+			});
+		}
+		for (const child of task.tasks ?? []) visit(child, file, currentTest, currentTestFailed, fileFailed);
 	};
-	for (const file of files) visit(file, file.name ?? "(unknown)", void 0);
+	for (const file of files) {
+		const fileFailed = file.result?.state === "fail";
+		visit(file, file.name ?? "(unknown)", void 0, false, fileFailed);
+	}
 	return entries;
 }