@vitest-agent/engine 1.2.0 → 2.0.0

package/index.d.ts

@@ -1,8 +1,8 @@
 import { Context, Effect, FileSystem, Layer, LogLevel, Option, Path, Schema } from "effect";
 import { ConfigFileShape } from "@effected/config-file";
-import { Agent, AgentNotFoundError, AgentReport, ArtifactKind, ArtifactKind as ArtifactKind$1, ArtifactSuite, ArtifactSuite as ArtifactSuite$1, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, CitedArtifact, CoverageBaselines, CoverageReport, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FileCoverageReport, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, HistoryRecord, IdempotencyHit, IllegalStatusTransitionError, Phase, ProjectIdentityNotResolvableError, RegistrationConflictError, ResolvedThresholds, RunRetentionPolicy, TddTaskAlreadyEndedError, TddTaskNotFoundError, TestClassification, TestRun, TrendEntry, TrendRecord, TurnPayload, VitestAgentConfig } from "@vitest-agent/sdk";
+import { Agent, AgentNotFoundError, AgentReport, ArtifactKind, ArtifactKind as ArtifactKind$1, ArtifactSuite, ArtifactSuite as ArtifactSuite$1, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, CitedArtifact, CoverageBaselines, CoverageReport, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FileCoverageReport, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, HistoryRecord, IdempotencyHit, IllegalStatusTransitionError, Phase, ProjectIdentityError, ProjectIdentityNotResolvableError, RegistrationConflictError, ResolvedThresholds, RunRetentionPolicy, StrayOutput, TddTaskAlreadyEndedError, TddTaskNotFoundError, TestClassification, TestRun, TrendEntry, TrendRecord, TurnPayload, VitestAgentConfig } from "@vitest-agent/sdk";
 import { SqlClient } from "effect/sql/SqlClient";
-import { RuntimeEnv } from "@effected/env";
+import { CiName, RuntimeEnv } from "@effected/env";
 import { WorkspaceDiscovery, WorkspaceDiscoveryFailure, WorkspaceRootNotFoundError } from "@effected/workspaces";
 import { AppDirs, AppDirsError, XdgEnvError } from "@effected/xdg";
 import { ChildProcessSpawner } from "effect/process";
@@ -141,6 +141,13 @@ export interface TestRunInput {
   readonly hostSource?: string | null;
   readonly hostValue?: string | null;
   readonly hostMetadata?: Record<string, unknown> | null;
+  /**
+   * Output the run wrote straight to the terminal past Vitest's console
+   * capture (issue 578). A run-level signal: every project row of one
+   * invocation carries the same value. Omitted or `null` when the run
+   * recorded nothing, which the row stores as NULL in every `stray_*` column.
+   */
+  readonly strayOutput?: StrayOutput | null;
 }
 /** @public */
 export interface ModuleInput {
@@ -615,6 +622,32 @@ export interface ProjectRunSummary {
   readonly passed: number;
   readonly failed: number;
   readonly skipped: number;
+  /** The latest run's stray output (issue 578); `null` when it recorded none. */
+  readonly strayOutput: StrayOutput | null;
+}
+/**
+ * Options for `DataReader.getStrayOutputHistory`.
+ * @public
+ */
+export interface StrayOutputHistoryOptions {
+  /** Only runs of this project; every project otherwise. */
+  readonly project?: string;
+  /** How many of the most recent runs to consider. Default 10. */
+  readonly limit?: number;
+}
+/**
+ * How often recent runs wrote stray output (issue 578). A "run" is one
+ * reporter invocation: stray output is a run-level signal that every project
+ * row of an invocation repeats, so rows are counted once per `invocation_id`.
+ * @public
+ */
+export interface StrayOutputHistory {
+  /** Runs considered: the most recent ones, up to the requested limit. */
+  readonly runs: number;
+  /** How many of them recorded any stray output. */
+  readonly runsWithStrayOutput: number;
+  /** The most recent run's stray output, when that run recorded any. */
+  readonly latest: StrayOutput | null;
 }
 /** @public */
 export interface FlakyTest {
@@ -973,6 +1006,8 @@ export interface TestArtifactRow {
 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>;
+  /** How often the most recent runs wrote stray output; see {@link StrayOutputHistory}. */
+  readonly getStrayOutputHistory: (options?: StrayOutputHistoryOptions) => Effect.Effect<StrayOutputHistory, 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>;
@@ -1205,8 +1240,21 @@ declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector
   readonly detect: () => Effect.Effect<Environment>;
   readonly isAgent: Effect.Effect<boolean>;
   readonly agentName: Effect.Effect<string | undefined>;
+  readonly ci: Effect.Effect<Option.Option<CiName>>;
 }>;
-/** @public */
+/**
+ * Who is running the program and where.
+ *
+ * @remarks
+ * `detect` is the console audience: an agent marker wins over CI, so an
+ * agent inside GitHub Actions reads `agent-shell`. `ci` is the CI vendor
+ * independently of that precedence, so a caller can keep GitHub-only
+ * extras (the step summary, annotations, the `github-actions` reporter)
+ * on for the humans reviewing the job even when the console audience is
+ * the agent (issue #624).
+ *
+ * @public
+ */
 export declare class EnvironmentDetector extends EnvironmentDetector_base {}
 /**
  * Pure classification behind {@link EnvironmentDetectorLive}: an agent shell
@@ -1235,9 +1283,21 @@ export declare const classifyEnvironment: (runtime: RuntimeEnv) => Environment;
  * @public
  */
 export declare const EnvironmentDetectorLive: (env: Record<string, string | undefined>) => Layer.Layer<EnvironmentDetector>;
-/** @public */
+/**
+ * A fixed `EnvironmentDetector` for tests.
+ *
+ * @remarks
+ * `ci` defaults to the vendor the environment implies (`ci-github` is
+ * GitHub Actions, `ci-generic` another CI, the rest none). Pass
+ * `options.ci` to decouple the two, as the live detector does for an agent
+ * running inside GitHub Actions: `layer("agent-shell", { ci: "github-actions" })`.
+ *
+ * @public
+ */
 export declare const EnvironmentDetectorTest: {
-  layer: (env?: Environment) => Layer.Layer<EnvironmentDetector, never, never>;
+  layer: (env?: Environment, options?: {
+    readonly ci?: CiName;
+  }) => Layer.Layer<EnvironmentDetector, never, never>;
 };
 declare const ExecutorResolver_base: Context.ServiceClass<ExecutorResolver, "vitest-agent/ExecutorResolver", {
   readonly resolve: (env: Environment) => Effect.Effect<Executor>;
@@ -1556,12 +1616,18 @@ export interface ResolveProjectIdentityOptions {
  */
 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>;
+  readonly resolve: (workspaceRoot: string, options?: ResolveProjectIdentityOptions) => Effect.Effect<ResolvedIdentity, ProjectIdentityError>;
 }>;
 /**
  * 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`.
+ *
+ * `resolve` fails with `ProjectIdentityNotResolvableError` when every
+ * source is absent or empty, and with `ProjectIdentitySourceError` when a
+ * source is present but unusable (a malformed `vitest-agent.config.toml`,
+ * an unreadable root `package.json`): a broken config is reported, never
+ * silently replaced by the default identity (issue 321).
  * @public
  */
 export declare class ProjectIdentity extends ProjectIdentity_base {}
@@ -1581,17 +1647,21 @@ export type CandidateContext = FileSystem.FileSystem | WorkspaceDiscovery | Vite
  * `FileSystem`, `CommandExecutor`, `WorkspaceDiscovery`, and
  * `VitestAgentConfigFile`. The platform context comes from
  * `NodeServices.layer` at the entry point.
+ *
+ * Absent sources fall through (no config file, no workspace root, no
+ * `repository` field, no git remote); a present source that cannot be read
+ * or decoded fails with `ProjectIdentitySourceError`.
  * @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
+ * fails with the given `ProjectIdentityError`). 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>;
+export declare const ProjectIdentityTest: (result: ResolvedIdentity | ProjectIdentityError) => Layer.Layer<ProjectIdentity, never, never>;
 declare const RunContext_base: Schema.Class<RunContext, Schema.Struct<{
   readonly gitBranch: Schema.NullOr<Schema.String>;
   readonly gitCommitSha: Schema.NullOr<Schema.String>;
@@ -1671,6 +1741,13 @@ interface FormatTriageOptions {
   readonly project?: string;
   readonly maxLines?: number;
 }
+/**
+ * The "stray output" line of the Recent Test Runs section, or `undefined`
+ * when none of the recent runs wrote past Vitest's console capture (issue
+ * 578). Pure, so the wording is testable without a database.
+ * @public
+ */
+export declare const formatStrayOutputLine: (history: StrayOutputHistory) => string | undefined;
 /**
  * Generates an orientation triage markdown string for LLM agents.
  * Summarises recent test runs, active sessions, acceptance metrics,
@@ -1717,6 +1794,7 @@ export declare const PROJECT_MIGRATIONS: {
   readonly "0001_initial": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
   readonly "0002_test_artifacts": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
   readonly "0003_run_retention": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
+  readonly "0004_stray_output": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
 };
 /**
  * Migration for the global discovery registry SQLite at

package/index.js

@@ -29,7 +29,7 @@ import { ProjectIdentity, resolveProjectIdentityFromCandidates } from "./service
 import { ProjectIdentityLive, ProjectIdentityTest } from "./layers/ProjectIdentityLive.js";
 import { AgentContext, RunContext, RunContext$, RunContextService } from "./services/RunContext.js";
 import { RunContextLive, RunContextTest } from "./layers/RunContextLive.js";
-import { formatTriageEffect } from "./lib/format-triage.js";
+import { formatStrayOutputLine, formatTriageEffect } from "./lib/format-triage.js";
 import { formatWrapupEffect } from "./lib/format-wrapup.js";
 import migration from "./migrations/0001_initial.js";
 import migration$1 from "./migrations/0002_test_artifacts.js";
@@ -57,4 +57,4 @@ import { DATABASE_FILENAME, resolveDataPath } from "./utils/resolve-data-path.js
 import { resolveWorkspaceKey } from "./utils/resolve-workspace-key.js";
 import { CURRENT_ENGINE_VERSION } from "./version.js";
 
-export { APP_NAMESPACE, AgentContext, CURRENT_ENGINE_VERSION, ConfigLive, DATABASE_FILENAME, DATA_DB_FILENAME, DATA_FALLBACK_DIR, DataReader, DataReaderLive, DataStore, DataStoreLive, DetailResolver, DetailResolverLive, DiscoveryRegistry, DiscoveryRegistryLive, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, ExecutorResolver, ExecutorResolverLive, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, IDEMPOTENCY_ROOT_SENTINEL, INLINE_ATTACHMENT_BODY_CAP_BYTES, LoggerLive, NodePlatformLayer, OutputPipelineLive, PROJECT_MIGRATIONS, PathResolutionLive, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PlatformLive, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityTest, REGISTRY_DB_FILENAME, REGISTRY_STORE_OPTIONS, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, SESSIONS_DB_FILENAME, SidecarPlatformLive, VitestAgentConfigFile, _resetMigrationCacheForTesting, assembleHistoryRecord, assembleManifest, classifyEnvironment, computeFailureSignature, deriveIdempotencyKey, dispatchRecordTddArtifactEffect, endAgentEffect, ensureMigrated, formatTriageEffect, formatWrapupEffect, historyKey, makeSqliteStack, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, parseAndValidateTurnPayload, parseSessionEnvExports, recordRunWorkspaceChangesEffect, recordSessionEnd, recordSessionStart, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect, recordTurnEffect, recoverSessionContextFromSessionEnv, registerAgentEffect, migration$2 as registryMigration0001, resolveDataPath, resolveHookPaths, resolveLogFile, resolveLogLevel, resolveProjectDir, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveProjectKeyFromCwdEffect, resolveSessionForRecording, resolveSessionMapPath, resolveWorkspaceKey, migration$3 as sessionMapMigration0001, withPersistSavepoint, withPersistTransaction };
+export { APP_NAMESPACE, AgentContext, CURRENT_ENGINE_VERSION, ConfigLive, DATABASE_FILENAME, DATA_DB_FILENAME, DATA_FALLBACK_DIR, DataReader, DataReaderLive, DataStore, DataStoreLive, DetailResolver, DetailResolverLive, DiscoveryRegistry, DiscoveryRegistryLive, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, ExecutorResolver, ExecutorResolverLive, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, IDEMPOTENCY_ROOT_SENTINEL, INLINE_ATTACHMENT_BODY_CAP_BYTES, LoggerLive, NodePlatformLayer, OutputPipelineLive, PROJECT_MIGRATIONS, PathResolutionLive, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PlatformLive, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityTest, REGISTRY_DB_FILENAME, REGISTRY_STORE_OPTIONS, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, SESSIONS_DB_FILENAME, SidecarPlatformLive, VitestAgentConfigFile, _resetMigrationCacheForTesting, assembleHistoryRecord, assembleManifest, classifyEnvironment, computeFailureSignature, deriveIdempotencyKey, dispatchRecordTddArtifactEffect, endAgentEffect, ensureMigrated, formatStrayOutputLine, formatTriageEffect, formatWrapupEffect, historyKey, makeSqliteStack, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, parseAndValidateTurnPayload, parseSessionEnvExports, recordRunWorkspaceChangesEffect, recordSessionEnd, recordSessionStart, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect, recordTurnEffect, recoverSessionContextFromSessionEnv, registerAgentEffect, migration$2 as registryMigration0001, resolveDataPath, resolveHookPaths, resolveLogFile, resolveLogLevel, resolveProjectDir, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveProjectKeyFromCwdEffect, resolveSessionForRecording, resolveSessionMapPath, resolveWorkspaceKey, migration$3 as sessionMapMigration0001, withPersistSavepoint, withPersistTransaction };

package/layers/DataReaderLive.js

@@ -1,10 +1,25 @@
 import { DataReader } from "../services/DataReader.js";
 import { historyKey } from "../services/HistoryTracker.js";
-import { DataStoreError, extractSqlReason } from "@vitest-agent/sdk";
-import { Effect, Layer, Option } from "effect";
+import { DataStoreError, StrayOutputSample, extractSqlReason } from "@vitest-agent/sdk";
+import { Effect, Layer, Option, Schema } from "effect";
 import { SqlClient } from "effect/sql/SqlClient";
 
 // src/layers/DataReaderLive.ts
+const decodeStraySamples = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Array(StrayOutputSample)));
+/**
+* The run's stray output from its `test_runs` row, or `null` when the row
+* recorded none (every `stray_*` column NULL: a run that wrote nothing, a
+* passthrough-mode run, or a row older than migration 0004). Pure; the
+* inverse is `DataStoreLive`'s `strayOutputColumns`. A samples column that
+* does not decode reads as no samples rather than failing the row.
+*/
+const strayOutputFromRow = (row) => row.stray_total === null ? null : {
+	total: row.stray_total,
+	stdout: row.stray_stdout ?? 0,
+	stderr: row.stray_stderr ?? 0,
+	bytes: row.stray_bytes ?? 0,
+	samples: Option.getOrElse(decodeStraySamples(row.stray_samples ?? "[]"), () => [])
+};
 /** @public */
 const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 	const sql = yield* SqlClient;
@@ -32,7 +47,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 	});
 	const getLatestRun = (project) => Effect.gen(function* () {
 		yield* Effect.logDebug("getLatestRun").pipe(Effect.annotateLogs({ project }));
-		const runs = yield* sql`SELECT id, timestamp, reason, duration, total, passed, failed, skipped, project
+		const runs = yield* sql`SELECT id, timestamp, reason, duration, total, passed, failed, skipped, project, stray_total, stray_stdout, stray_stderr, stray_bytes, stray_samples
 					FROM test_runs
 					WHERE project = ${project}
 					ORDER BY timestamp DESC LIMIT 1`;
@@ -102,6 +117,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 					WHERE run_id = ${run.id} AND scope = 'unhandled'`;
 		const failedFiles = failedModules.map((m) => m.file_path);
 		const projectName = run.project;
+		const strayOutput = strayOutputFromRow(run);
 		const coverageRunId = yield* resolveCoverageRunId(run.id);
 		const fileCovRows = yield* sql`SELECT f.path AS file_path, fc.statements, fc.branches, fc.functions, fc.lines,
 					   fc.uncovered_lines, fc.tier
@@ -179,7 +195,8 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 				...e.diff != null ? { diff: e.diff } : {}
 			})),
 			failedFiles,
-			...coverage ? { coverage } : {}
+			...coverage ? { coverage } : {},
+			...strayOutput !== null ? { strayOutput } : {}
 		};
 		return Option.some(report);
 	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
@@ -196,7 +213,12 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 						t1.total,
 						t1.passed,
 						t1.failed,
-						t1.skipped
+						t1.skipped,
+						t1.stray_total,
+						t1.stray_stdout,
+						t1.stray_stderr,
+						t1.stray_bytes,
+						t1.stray_samples
 					FROM test_runs t1
 					INNER JOIN (
 						SELECT project, MAX(timestamp) as max_ts
@@ -210,13 +232,43 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 			total: r.total,
 			passed: r.passed,
 			failed: r.failed,
-			skipped: r.skipped
+			skipped: r.skipped,
+			strayOutput: strayOutputFromRow(r)
 		}));
 	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
 		operation: "read",
 		table: "test_runs",
 		reason: extractSqlReason(e)
 	})));
+	const getStrayOutputHistory = (options = {}) => Effect.gen(function* () {
+		const limit = options.limit ?? 10;
+		yield* Effect.logDebug("getStrayOutputHistory").pipe(Effect.annotateLogs({
+			project: options.project ?? "*",
+			limit
+		}));
+		const rows = yield* sql`SELECT
+						MAX(timestamp) AS timestamp,
+						MAX(stray_total) AS stray_total,
+						MAX(stray_stdout) AS stray_stdout,
+						MAX(stray_stderr) AS stray_stderr,
+						MAX(stray_bytes) AS stray_bytes,
+						MAX(stray_samples) AS stray_samples
+					FROM test_runs
+					${options.project !== void 0 ? sql`WHERE project = ${options.project}` : sql``}
+					GROUP BY invocation_id
+					ORDER BY timestamp DESC
+					LIMIT ${limit}`;
+		const recorded = rows.map(strayOutputFromRow);
+		return {
+			runs: rows.length,
+			runsWithStrayOutput: recorded.filter((s) => s !== null).length,
+			latest: recorded[0] ?? null
+		};
+	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
+		operation: "read",
+		table: "test_runs",
+		reason: extractSqlReason(e)
+	})));
 	const getHistory = (project, options) => Effect.gen(function* () {
 		yield* Effect.logDebug("getHistory").pipe(Effect.annotateLogs({
 			project,
@@ -1878,6 +1930,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 	return {
 		getLatestRun,
 		getRunsByProject,
+		getStrayOutputHistory,
 		getHistory,
 		getBaselines,
 		getTrends,

package/layers/DataStoreLive.js

@@ -7,6 +7,24 @@ import { Buffer } from "node:buffer";
 import { randomUUID } from "node:crypto";
 
 // src/layers/DataStoreLive.ts
+/**
+* The five `test_runs.stray_*` column values for a run's stray output: all
+* NULL when the run recorded nothing, so a reader cannot mistake "nothing
+* recorded" for "zero lines" (pure; the inverse lives in `DataReaderLive`).
+*/
+const strayOutputColumns = (stray) => stray == null ? {
+	total: null,
+	stdout: null,
+	stderr: null,
+	bytes: null,
+	samples: null
+} : {
+	total: stray.total,
+	stdout: stray.stdout,
+	stderr: stray.stderr,
+	bytes: stray.bytes,
+	samples: JSON.stringify(stray.samples)
+};
 const isLegalLifecycleTransition = (from, to) => {
 	if (from === to) return true;
 	if (from === "done" || from === "abandoned") return false;
@@ -70,7 +88,8 @@ const DataStoreLive = Layer.effect(DataStore, Effect.gen(function* () {
 		const conversationId = input.conversationId ?? null;
 		const gitDirtyInt = input.gitDirty === void 0 || input.gitDirty === null ? null : input.gitDirty ? 1 : 0;
 		const hostMetadataJson = input.hostMetadata == null ? null : JSON.stringify(input.hostMetadata);
-		yield* sql`INSERT INTO test_runs (invocation_id, project, settings_hash, timestamp, commit_sha, branch, reason, duration, total, passed, failed, skipped, scoped, snapshot_added, snapshot_matched, snapshot_unmatched, snapshot_updated, snapshot_unchecked, snapshot_total, snapshot_failure, snapshot_did_update, snapshot_files_added, snapshot_files_removed, snapshot_files_unmatched, snapshot_files_updated, actor_type, agent_id, conversation_id, git_branch, git_commit_sha, git_dirty, git_upstream, git_worktree_dir, host_source, host_value, host_metadata) VALUES (${input.invocationId}, ${input.project}, ${input.settingsHash}, ${input.timestamp}, ${input.commitSha ?? null}, ${input.branch ?? null}, ${input.reason}, ${input.duration}, ${input.total}, ${input.passed}, ${input.failed}, ${input.skipped}, ${input.scoped ? 1 : 0}, ${input.snapshotAdded ?? 0}, ${input.snapshotMatched ?? 0}, ${input.snapshotUnmatched ?? 0}, ${input.snapshotUpdated ?? 0}, ${input.snapshotUnchecked ?? 0}, ${input.snapshotTotal ?? 0}, ${boolToInt(input.snapshotFailure) ?? 0}, ${boolToInt(input.snapshotDidUpdate) ?? 0}, ${input.snapshotFilesAdded ?? 0}, ${input.snapshotFilesRemoved ?? 0}, ${input.snapshotFilesUnmatched ?? 0}, ${input.snapshotFilesUpdated ?? 0}, ${actorType}, ${agentId}, ${conversationId}, ${input.gitBranch ?? null}, ${input.gitCommitSha ?? null}, ${gitDirtyInt}, ${input.gitUpstream ?? null}, ${input.gitWorktreeDir ?? null}, ${input.hostSource ?? null}, ${input.hostValue ?? null}, ${hostMetadataJson})`;
+		const stray = strayOutputColumns(input.strayOutput);
+		yield* sql`INSERT INTO test_runs (invocation_id, project, settings_hash, timestamp, commit_sha, branch, reason, duration, total, passed, failed, skipped, scoped, snapshot_added, snapshot_matched, snapshot_unmatched, snapshot_updated, snapshot_unchecked, snapshot_total, snapshot_failure, snapshot_did_update, snapshot_files_added, snapshot_files_removed, snapshot_files_unmatched, snapshot_files_updated, actor_type, agent_id, conversation_id, git_branch, git_commit_sha, git_dirty, git_upstream, git_worktree_dir, host_source, host_value, host_metadata, stray_total, stray_stdout, stray_stderr, stray_bytes, stray_samples) VALUES (${input.invocationId}, ${input.project}, ${input.settingsHash}, ${input.timestamp}, ${input.commitSha ?? null}, ${input.branch ?? null}, ${input.reason}, ${input.duration}, ${input.total}, ${input.passed}, ${input.failed}, ${input.skipped}, ${input.scoped ? 1 : 0}, ${input.snapshotAdded ?? 0}, ${input.snapshotMatched ?? 0}, ${input.snapshotUnmatched ?? 0}, ${input.snapshotUpdated ?? 0}, ${input.snapshotUnchecked ?? 0}, ${input.snapshotTotal ?? 0}, ${boolToInt(input.snapshotFailure) ?? 0}, ${boolToInt(input.snapshotDidUpdate) ?? 0}, ${input.snapshotFilesAdded ?? 0}, ${input.snapshotFilesRemoved ?? 0}, ${input.snapshotFilesUnmatched ?? 0}, ${input.snapshotFilesUpdated ?? 0}, ${actorType}, ${agentId}, ${conversationId}, ${input.gitBranch ?? null}, ${input.gitCommitSha ?? null}, ${gitDirtyInt}, ${input.gitUpstream ?? null}, ${input.gitWorktreeDir ?? null}, ${input.hostSource ?? null}, ${input.hostValue ?? null}, ${hostMetadataJson}, ${stray.total}, ${stray.stdout}, ${stray.stderr}, ${stray.bytes}, ${stray.samples})`;
 		return (yield* sql`SELECT last_insert_rowid() as id`)[0].id;
 	}).pipe(Effect.annotateLogs("service", "DataStore"), Effect.mapError((e) => new DataStoreError({
 		operation: "write",

package/layers/EnvironmentDetectorLive.js

@@ -48,7 +48,8 @@ const EnvironmentDetectorLive = (env) => Layer.effect(EnvironmentDetector, Effec
 	return {
 		detect: () => Effect.succeed(environment),
 		isAgent: Effect.succeed(Option.isSome(runtime.agent)),
-		agentName: Effect.succeed(Option.getOrUndefined(runtime.agent))
+		agentName: Effect.succeed(Option.getOrUndefined(runtime.agent)),
+		ci: Effect.succeed(runtime.ci)
 	};
 })).pipe(Layer.provide(CurrentRuntimeEnv.layerFrom(env)));
 

package/layers/EnvironmentDetectorTest.js

@@ -1,12 +1,30 @@
 import { EnvironmentDetector } from "../services/EnvironmentDetector.js";
-import { Effect, Layer } from "effect";
+import { Effect, Layer, Option } from "effect";
 
 // src/layers/EnvironmentDetectorTest.ts
-/** @public */
-const EnvironmentDetectorTest = { layer: (env = "terminal") => Layer.succeed(EnvironmentDetector, {
+/** The CI vendor each environment implies when a test does not say otherwise. */
+const CI_FOR_ENVIRONMENT = {
+	"ci-github": Option.some("github-actions"),
+	"ci-generic": Option.some("generic"),
+	"agent-shell": Option.none(),
+	terminal: Option.none()
+};
+/**
+* A fixed `EnvironmentDetector` for tests.
+*
+* @remarks
+* `ci` defaults to the vendor the environment implies (`ci-github` is
+* GitHub Actions, `ci-generic` another CI, the rest none). Pass
+* `options.ci` to decouple the two, as the live detector does for an agent
+* running inside GitHub Actions: `layer("agent-shell", { ci: "github-actions" })`.
+*
+* @public
+*/
+const EnvironmentDetectorTest = { layer: (env = "terminal", options = {}) => Layer.succeed(EnvironmentDetector, {
 	detect: () => Effect.succeed(env),
 	isAgent: Effect.succeed(env === "agent-shell"),
-	agentName: Effect.succeed(env === "agent-shell" ? "test-agent" : void 0)
+	agentName: Effect.succeed(env === "agent-shell" ? "test-agent" : void 0),
+	ci: Effect.succeed(options.ci !== void 0 ? Option.some(options.ci) : CI_FOR_ENVIRONMENT[env])
 }) };
 
 export { EnvironmentDetectorTest };

package/layers/ProjectIdentityLive.js

@@ -1,11 +1,21 @@
 import { VitestAgentConfigFile } from "../services/Config.js";
 import { ProjectIdentity, resolveProjectIdentityFromCandidates } from "../services/ProjectIdentity.js";
-import { ProjectIdentityNotResolvableError, VitestAgentConfig } from "@vitest-agent/sdk";
+import { ProjectIdentityNotResolvableError, ProjectIdentitySourceError, VitestAgentConfig } from "@vitest-agent/sdk";
 import { Effect, FileSystem, Layer, Option } from "effect";
 import { WorkspaceDiscovery } from "@effected/workspaces";
 import { ChildProcess, ChildProcessSpawner } from "effect/process";
 
 // src/layers/ProjectIdentityLive.ts
+/** The one-line text of a kit failure, for `ProjectIdentitySourceError.detail`. */
+const detailOf = (cause) => cause instanceof Error && cause.message.length > 0 ? cause.message : String(cause);
+/**
+* The git remote is an OPTIONAL source: a repository with no
+* `remote.origin.url`, a directory that is not a git checkout, or a machine
+* with no `git` on `PATH` are all "no remote" rather than failures. `git
+* config --get` exits non-zero for an unset key, so every spawner failure
+* folds to `Option.none()` on purpose — this is the one catch in this module
+* that stays broad, and it is a policy, not an accident.
+*/
 const readGitRemote = (cwd) => Effect.gen(function* () {
 	const trimmed = (yield* (yield* ChildProcessSpawner.ChildProcessSpawner).string(ChildProcess.make("git", [
 		"config",
@@ -14,23 +24,55 @@ const readGitRemote = (cwd) => Effect.gen(function* () {
 	]).pipe(ChildProcess.setCwd(cwd)))).trim();
 	return trimmed.length > 0 ? Option.some(trimmed) : Option.none();
 }).pipe(Effect.catch(() => Effect.succeed(Option.none())));
+/**
+* The `repository` URL of the root `package.json` discovery named.
+*
+* A file that is not there (`NotFound`) is an absent source. Any other
+* filesystem failure (permission denied, an I/O error) and a body that is not
+* JSON are `ProjectIdentitySourceError`s: the file exists and says
+* something, and silently reading it as "no repository" would hand the
+* operator the wrong identity.
+*/
 const readPackageRepoUrl = (packageJsonPath) => Effect.gen(function* () {
-	const raw = yield* (yield* FileSystem.FileSystem).readFileString(packageJsonPath).pipe(Effect.catch(() => Effect.succeed("")));
-	if (raw.length === 0) return Option.none();
-	try {
-		const repo = JSON.parse(raw).repository;
-		if (typeof repo === "string" && repo.trim().length > 0) return Option.some(repo.trim());
-		if (repo !== null && typeof repo === "object" && "url" in repo && typeof repo.url === "string") {
-			const url = repo.url.trim();
-			return url.length > 0 ? Option.some(url) : Option.none();
-		}
-	} catch {}
+	const raw = yield* (yield* FileSystem.FileSystem).readFileString(packageJsonPath).pipe(Effect.map(Option.some), Effect.catchTag("PlatformError", (error) => error.reason._tag === "NotFound" ? Effect.succeed(Option.none()) : Effect.fail(new ProjectIdentitySourceError({
+		source: "package-json",
+		path: packageJsonPath,
+		detail: detailOf(error),
+		cause: error
+	}))));
+	if (Option.isNone(raw)) return Option.none();
+	const parsed = yield* Effect.try({
+		try: () => JSON.parse(raw.value),
+		catch: (cause) => new ProjectIdentitySourceError({
+			source: "package-json",
+			path: packageJsonPath,
+			detail: detailOf(cause),
+			cause
+		})
+	});
+	if (parsed === null || typeof parsed !== "object") return Option.none();
+	const repo = parsed.repository;
+	if (typeof repo === "string" && repo.trim().length > 0) return Option.some(repo.trim());
+	if (repo !== null && typeof repo === "object" && "url" in repo && typeof repo.url === "string") {
+		const url = repo.url.trim();
+		return url.length > 0 ? Option.some(url) : Option.none();
+	}
 	return Option.none();
 });
 const collectCandidates = (workspaceRoot, options) => Effect.gen(function* () {
-	const tomlConfig = yield* (yield* VitestAgentConfigFile).loadOrDefault(new VitestAgentConfig({})).pipe(Effect.catch(() => Effect.succeed(new VitestAgentConfig({}))));
+	const tomlConfig = yield* (yield* VitestAgentConfigFile).loadOrDefault(new VitestAgentConfig({})).pipe(Effect.mapError((cause) => new ProjectIdentitySourceError({
+		source: "toml",
+		path: cause._tag === "ConfigValidationError" ? Option.getOrElse(cause.path, () => workspaceRoot) : cause.path ?? workspaceRoot,
+		detail: detailOf(cause),
+		cause
+	})));
 	const gitRemote = yield* readGitRemote(workspaceRoot);
-	const root = (yield* (yield* WorkspaceDiscovery).listPackagesIn(workspaceRoot).pipe(Effect.catch(() => Effect.succeed([])))).find((pkg) => pkg.isRootWorkspace);
+	const root = (yield* (yield* WorkspaceDiscovery).listPackagesIn(workspaceRoot).pipe(Effect.catchTag("WorkspaceRootNotFoundError", () => Effect.succeed([])), Effect.mapError((cause) => new ProjectIdentitySourceError({
+		source: "workspace",
+		path: cause._tag === "WorkspacePatternError" ? cause.root : cause.path,
+		detail: detailOf(cause),
+		cause
+	})))).find((pkg) => pkg.isRootWorkspace);
 	const packageJsonRepoUrl = root ? yield* readPackageRepoUrl(root.packageJsonPath) : Option.none();
 	const candidates = {};
 	if (options.projectId !== void 0) candidates.explicit = options.projectId;
@@ -69,6 +111,10 @@ const candidatesToTriedList = (candidates) => [
 * `FileSystem`, `CommandExecutor`, `WorkspaceDiscovery`, and
 * `VitestAgentConfigFile`. The platform context comes from
 * `NodeServices.layer` at the entry point.
+*
+* Absent sources fall through (no config file, no workspace root, no
+* `repository` field, no git remote); a present source that cannot be read
+* or decoded fails with `ProjectIdentitySourceError`.
 * @public
 */
 const ProjectIdentityLive = Layer.effect(ProjectIdentity, Effect.gen(function* () {
@@ -84,11 +130,11 @@ const ProjectIdentityLive = Layer.effect(ProjectIdentity, Effect.gen(function* (
 }));
 /**
 * Build a Test layer that returns a fixed `ResolvedIdentity` (or
-* fails with `ProjectIdentityNotResolvableError`). Use in unit tests
+* fails with the given `ProjectIdentityError`). Use in unit tests
 * that depend on `ProjectIdentity` but don't want to wire upstream
 * services.
 * @public
 */
-const ProjectIdentityTest = (result) => Layer.succeed(ProjectIdentity, { resolve: () => result instanceof ProjectIdentityNotResolvableError ? Effect.fail(result) : Effect.succeed(result) });
+const ProjectIdentityTest = (result) => Layer.succeed(ProjectIdentity, { resolve: () => result instanceof ProjectIdentityNotResolvableError || result instanceof ProjectIdentitySourceError ? Effect.fail(result) : Effect.succeed(result) });
 
 export { ProjectIdentityLive, ProjectIdentityTest };

package/lib/format-triage.js

@@ -2,6 +2,19 @@ import { DataReader } from "../services/DataReader.js";
 import { Effect, Option } from "effect";
 
 // src/lib/format-triage.ts
+const STRAY_OUTPUT_WINDOW = 10;
+const describeStrayOutput = (stray) => {
+	const lines = `${stray.total} line${stray.total === 1 ? "" : "s"}`;
+	const sample = stray.samples[0];
+	return sample === void 0 ? `${lines}, ${stray.bytes} bytes` : `${lines}, ${stray.bytes} bytes; first: \`${sample.text}\``;
+};
+/**
+* The "stray output" line of the Recent Test Runs section, or `undefined`
+* when none of the recent runs wrote past Vitest's console capture (issue
+* 578). Pure, so the wording is testable without a database.
+* @public
+*/
+const formatStrayOutputLine = (history) => history.runsWithStrayOutput === 0 ? void 0 : `- Stray output in ${history.runsWithStrayOutput} of the last ${history.runs} run${history.runs === 1 ? "" : "s"}${history.latest === null ? "" : ` (latest: ${describeStrayOutput(history.latest)})`} — tests or child processes writing straight to the terminal`;
 /**
 * Generates an orientation triage markdown string for LLM agents.
 * Summarises recent test runs, active sessions, acceptance metrics,
@@ -16,6 +29,14 @@ const formatTriageEffect = (options = {}) => Effect.gen(function* () {
 	const allProjects = yield* reader.getRunsByProject().pipe(Effect.orElseSucceed(() => []));
 	const projects = options.project ? allProjects.filter((p) => p.project === options.project) : allProjects;
 	const sessions = yield* reader.listSessions({}).pipe(Effect.orElseSucceed(() => []));
+	const strayHistory = yield* reader.getStrayOutputHistory({
+		...options.project !== void 0 && { project: options.project },
+		limit: STRAY_OUTPUT_WINDOW
+	}).pipe(Effect.orElseSucceed(() => ({
+		runs: 0,
+		runsWithStrayOutput: 0,
+		latest: null
+	})));
 	const fallbackMetrics = {
 		phaseEvidenceIntegrity: {
 			total: 0,
@@ -59,6 +80,8 @@ const formatTriageEffect = (options = {}) => Effect.gen(function* () {
 			const counts = `${p.passed} passed, ${p.failed} failed`;
 			lines.push(`- **${p.project}** — ${status} (${counts})`);
 		}
+		const strayLine = formatStrayOutputLine(strayHistory);
+		if (strayLine !== void 0) lines.push(strayLine);
 		lines.push("");
 	} else {
 		lines.push("### Recent Test Runs");
@@ -99,4 +122,4 @@ const formatTriageEffect = (options = {}) => Effect.gen(function* () {
 	return out;
 });
 
-export { formatTriageEffect };
+export { formatStrayOutputLine, formatTriageEffect };

package/migrations/0004_stray_output.js

@@ -0,0 +1,15 @@
+import { Effect } from "effect";
+import { SqlClient } from "effect/sql/SqlClient";
+
+// src/migrations/0004_stray_output.ts
+/** @internal */
+const migration = Effect.gen(function* () {
+	const sql = yield* SqlClient;
+	yield* sql`ALTER TABLE test_runs ADD COLUMN stray_total INTEGER`;
+	yield* sql`ALTER TABLE test_runs ADD COLUMN stray_stdout INTEGER`;
+	yield* sql`ALTER TABLE test_runs ADD COLUMN stray_stderr INTEGER`;
+	yield* sql`ALTER TABLE test_runs ADD COLUMN stray_bytes INTEGER`;
+	yield* sql`ALTER TABLE test_runs ADD COLUMN stray_samples TEXT`;
+});
+
+export { migration as default };

package/migrations/index.js

@@ -1,6 +1,7 @@
 import migration from "./0001_initial.js";
 import migration$1 from "./0002_test_artifacts.js";
 import migration$2 from "./0003_run_retention.js";
+import migration$3 from "./0004_stray_output.js";
 
 // src/migrations/index.ts
 /**
@@ -23,7 +24,8 @@ import migration$2 from "./0003_run_retention.js";
 const PROJECT_MIGRATIONS = {
 	"0001_initial": migration,
 	"0002_test_artifacts": migration$1,
-	"0003_run_retention": migration$2
+	"0003_run_retention": migration$2,
+	"0004_stray_output": migration$3
 };
 
 export { PROJECT_MIGRATIONS };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/engine",
-	"version": "1.2.0",
+	"version": "2.0.0",
 	"private": false,
 	"description": "Shared services, layers, SQLite data layer, migrations and platform resolution for the vitest-agent CLI and MCP server.",
 	"keywords": [
@@ -55,7 +55,7 @@
 		"@effected/workspaces": "^0.38.0",
 		"@effected/xdg": "^0.14.1",
 		"@effected/yaml": "^0.25.0",
-		"@vitest-agent/sdk": "7.1.0",
+		"@vitest-agent/sdk": "8.0.0",
 		"effect": "^4.0.6"
 	},
 	"engines": {

package/services/EnvironmentDetector.js

@@ -1,7 +1,19 @@
 import { Context } from "effect";
 
 // src/services/EnvironmentDetector.ts
-/** @public */
+/**
+* Who is running the program and where.
+*
+* @remarks
+* `detect` is the console audience: an agent marker wins over CI, so an
+* agent inside GitHub Actions reads `agent-shell`. `ci` is the CI vendor
+* independently of that precedence, so a caller can keep GitHub-only
+* extras (the step summary, annotations, the `github-actions` reporter)
+* on for the humans reviewing the job even when the console audience is
+* the agent (issue #624).
+*
+* @public
+*/
 var EnvironmentDetector = class extends Context.Service()("vitest-agent/EnvironmentDetector") {};
 
 export { EnvironmentDetector };

package/services/ProjectIdentity.js

@@ -54,6 +54,12 @@ const resolveProjectIdentityFromCandidates = (candidates) => {
 * 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`.
+*
+* `resolve` fails with `ProjectIdentityNotResolvableError` when every
+* source is absent or empty, and with `ProjectIdentitySourceError` when a
+* source is present but unusable (a malformed `vitest-agent.config.toml`,
+* an unreadable root `package.json`): a broken config is reported, never
+* silently replaced by the default identity (issue 321).
 * @public
 */
 var ProjectIdentity = class extends Context.Service()("vitest-agent/ProjectIdentity") {};

package/testing.d.ts

@@ -1,10 +1,11 @@
-import { Agent, Agent as Agent$1, AgentId, AgentNotFoundError, AgentNotFoundError as AgentNotFoundError$1, AgentReport, AgentReport as AgentReport$1, ArtifactKind, ArtifactKind as ArtifactKind$1, ArtifactKind as ArtifactKind$2, ArtifactSuite, ArtifactSuite as ArtifactSuite$1, ArtifactSuite as ArtifactSuite$2, BehaviorDetail, BehaviorDetail as BehaviorDetail$1, BehaviorNotFoundError, BehaviorNotFoundError as BehaviorNotFoundError$1, BehaviorRow, BehaviorRow as BehaviorRow$1, BehaviorStatus, BehaviorStatus as BehaviorStatus$1, CacheManifest, CacheManifest as CacheManifest$1, ChatId, CitedArtifact, CitedArtifact as CitedArtifact$1, CoverageBaselines, CoverageBaselines as CoverageBaselines$1, CoverageReport, CoverageReport as CoverageReport$1, DataStoreError, DataStoreError as DataStoreError$1, FileCoverageReport, FileCoverageReport as FileCoverageReport$1, GoalDetail, GoalDetail as GoalDetail$1, GoalNotFoundError, GoalNotFoundError as GoalNotFoundError$1, GoalRow, GoalRow as GoalRow$1, GoalStatus, GoalStatus as GoalStatus$1, HistoryRecord, HistoryRecord as HistoryRecord$1, IdempotencyHit, IdempotencyHit as IdempotencyHit$1, IllegalStatusTransitionEntity, IllegalStatusTransitionError, IllegalStatusTransitionError as IllegalStatusTransitionError$1, Phase, Phase as Phase$1, RegistrationConflictError, RegistrationConflictError as RegistrationConflictError$1, ResolvedThresholds, ResolvedThresholds as ResolvedThresholds$1, RunRetentionPolicy, RunRetentionPolicy as RunRetentionPolicy$1, TddTaskAlreadyEndedError, TddTaskAlreadyEndedError as TddTaskAlreadyEndedError$1, TddTaskEndOutcome, TddTaskNotFoundError, TddTaskNotFoundError as TddTaskNotFoundError$1, TrendEntry, TrendEntry as TrendEntry$1, TrendRecord, TrendRecord as TrendRecord$1 } from "@vitest-agent/sdk";
+import { Agent, Agent as Agent$1, AgentId, AgentNotFoundError, AgentNotFoundError as AgentNotFoundError$1, AgentReport, AgentReport as AgentReport$1, ArtifactKind, ArtifactKind as ArtifactKind$1, ArtifactKind as ArtifactKind$2, ArtifactSuite, ArtifactSuite as ArtifactSuite$1, ArtifactSuite as ArtifactSuite$2, BehaviorDetail, BehaviorDetail as BehaviorDetail$1, BehaviorNotFoundError, BehaviorNotFoundError as BehaviorNotFoundError$1, BehaviorRow, BehaviorRow as BehaviorRow$1, BehaviorStatus, BehaviorStatus as BehaviorStatus$1, CacheManifest, CacheManifest as CacheManifest$1, ChatId, CitedArtifact, CitedArtifact as CitedArtifact$1, CoverageBaselines, CoverageBaselines as CoverageBaselines$1, CoverageReport, CoverageReport as CoverageReport$1, DataStoreError, DataStoreError as DataStoreError$1, FileCoverageReport, FileCoverageReport as FileCoverageReport$1, GoalDetail, GoalDetail as GoalDetail$1, GoalNotFoundError, GoalNotFoundError as GoalNotFoundError$1, GoalRow, GoalRow as GoalRow$1, GoalStatus, GoalStatus as GoalStatus$1, HistoryRecord, HistoryRecord as HistoryRecord$1, IdempotencyHit, IdempotencyHit as IdempotencyHit$1, IllegalStatusTransitionEntity, IllegalStatusTransitionError, IllegalStatusTransitionError as IllegalStatusTransitionError$1, Phase, Phase as Phase$1, RegistrationConflictError, RegistrationConflictError as RegistrationConflictError$1, ResolvedThresholds, ResolvedThresholds as ResolvedThresholds$1, RunRetentionPolicy, RunRetentionPolicy as RunRetentionPolicy$1, StrayOutput, TddTaskAlreadyEndedError, TddTaskAlreadyEndedError as TddTaskAlreadyEndedError$1, TddTaskEndOutcome, TddTaskNotFoundError, TddTaskNotFoundError as TddTaskNotFoundError$1, TrendEntry, TrendEntry as TrendEntry$1, TrendRecord, TrendRecord as TrendRecord$1 } from "@vitest-agent/sdk";
 import { Context, Effect, Layer, Option } from "effect";
 import "@effect/platform-node/NodeServices";
 import "@effect/sql-sqlite-node/SqliteClient";
 import { StoreError, StoreMigrationError } from "@effected/store";
 import "effect/sql/SqlClient";
 import { SqlError } from "effect/sql/SqlError";
+import "@effected/env";
 /** @public */
 interface CreateGoalInput {
   readonly tddTaskId: number;
@@ -99,6 +100,13 @@ interface TestRunInput {
   readonly hostSource?: string | null;
   readonly hostValue?: string | null;
   readonly hostMetadata?: Record<string, unknown> | null;
+  /**
+   * Output the run wrote straight to the terminal past Vitest's console
+   * capture (issue 578). A run-level signal: every project row of one
+   * invocation carries the same value. Omitted or `null` when the run
+   * recorded nothing, which the row stores as NULL in every `stray_*` column.
+   */
+  readonly strayOutput?: StrayOutput | null;
 }
 /** @public */
 interface ModuleInput {
@@ -566,6 +574,32 @@ interface ProjectRunSummary {
   readonly passed: number;
   readonly failed: number;
   readonly skipped: number;
+  /** The latest run's stray output (issue 578); `null` when it recorded none. */
+  readonly strayOutput: StrayOutput | null;
+}
+/**
+ * Options for `DataReader.getStrayOutputHistory`.
+ * @public
+ */
+interface StrayOutputHistoryOptions {
+  /** Only runs of this project; every project otherwise. */
+  readonly project?: string;
+  /** How many of the most recent runs to consider. Default 10. */
+  readonly limit?: number;
+}
+/**
+ * How often recent runs wrote stray output (issue 578). A "run" is one
+ * reporter invocation: stray output is a run-level signal that every project
+ * row of an invocation repeats, so rows are counted once per `invocation_id`.
+ * @public
+ */
+interface StrayOutputHistory {
+  /** Runs considered: the most recent ones, up to the requested limit. */
+  readonly runs: number;
+  /** How many of them recorded any stray output. */
+  readonly runsWithStrayOutput: number;
+  /** The most recent run's stray output, when that run recorded any. */
+  readonly latest: StrayOutput | null;
 }
 /** @public */
 interface FlakyTest {
@@ -924,6 +958,8 @@ interface TestArtifactRow {
 declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/DataReader", {
   readonly getLatestRun: (project: string) => Effect.Effect<Option.Option<AgentReport$1>, DataStoreError$1>;
   readonly getRunsByProject: () => Effect.Effect<ReadonlyArray<ProjectRunSummary>, DataStoreError$1>;
+  /** How often the most recent runs wrote stray output; see {@link StrayOutputHistory}. */
+  readonly getStrayOutputHistory: (options?: StrayOutputHistoryOptions) => Effect.Effect<StrayOutputHistory, DataStoreError$1>;
   readonly getHistory: (project: string, options?: HistoryQueryOptions) => Effect.Effect<HistoryRecord$1, DataStoreError$1>;
   readonly getBaselines: (project: string) => Effect.Effect<Option.Option<CoverageBaselines$1>, DataStoreError$1>;
   readonly getTrends: (project: string, limit?: number) => Effect.Effect<Option.Option<TrendRecord$1>, DataStoreError$1>;
@@ -1114,6 +1150,7 @@ export declare const PROJECT_MIGRATIONS: {
   readonly "0001_initial": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
   readonly "0002_test_artifacts": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
   readonly "0003_run_retention": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
+  readonly "0004_stray_output": import("effect/Effect").Effect<void, import("effect/sql/SqlError").SqlError, import("effect/sql/SqlClient").SqlClient>;
 };
 /** @public */
 export declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, PlatformLiveError, never>;
@@ -1129,5 +1166,5 @@ export declare function withFailures(filename: string): Layer.Layer<DataReader |
 export declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | PlatformLiveError, never>;
 /** @public */
 export declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").BehaviorNotFoundError | import("@vitest-agent/sdk").DataStoreError | import("@vitest-agent/sdk").GoalNotFoundError | import("@vitest-agent/sdk").IllegalStatusTransitionError | import("@vitest-agent/sdk").TddTaskAlreadyEndedError | import("@vitest-agent/sdk").TddTaskNotFoundError | PlatformLiveError, never>;
-export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type ArtifactSuite, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataStoreError, 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 PersistedAttachment, type PersistentFailure, type Phase, type PlatformLiveError, type ProjectRunSummary, type PruneRunsResult, type RegisterAgentInput, RegistrationConflictError, type ResolvedThresholds, type RunChangedFile, type RunInvocationMethod, RunRetentionPolicy, 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 TestAnnotationInput, type TestAnnotationRow, type TestArtifactInput, type TestArtifactQueryOptions, type TestArtifactRow, type TestAttachmentInput, 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 };
+export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type ArtifactSuite, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataStoreError, 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 PersistedAttachment, type PersistentFailure, type Phase, type PlatformLiveError, type ProjectRunSummary, type PruneRunsResult, type RegisterAgentInput, RegistrationConflictError, type ResolvedThresholds, type RunChangedFile, type RunInvocationMethod, RunRetentionPolicy, type SessionDetail, type SessionInput, type SettingsInput, type SettingsListEntry, type SettingsRow, type StackFrameInput, type StrayOutputHistory, type StrayOutputHistoryOptions, type SuiteInput, type SuiteListEntry, type TagInventoryRow, type TddArtifactDetail, type TddArtifactRow, type TddPhaseDetail, TddTaskAlreadyEndedError, type TddTaskDetail, type TddTaskEndOutcome, type TddTaskInput, TddTaskNotFoundError, type TddTaskSummary, type TestAnnotationInput, type TestAnnotationRow, type TestArtifactInput, type TestArtifactQueryOptions, type TestArtifactRow, type TestAttachmentInput, 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 };
 //# sourceMappingURL=testing.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
 /** Build-time injected package version (see architecture.md D36). @public */
-const CURRENT_ENGINE_VERSION = "1.2.0";
+const CURRENT_ENGINE_VERSION = "2.0.0";
 
 export { CURRENT_ENGINE_VERSION };