@vitest-agent/sdk 2.2.1 → 2.3.1

package/index.d.ts

@@ -2812,6 +2812,42 @@ interface TurnSummary {
   readonly occurredAt: string;
 }
 /** @public */
+interface HistoryQueryOptions {
+  /** Exact `full_name` match — narrows to a single test's history. */
+  readonly testName?: string;
+  /** Exact `module_path` match — narrows to tests in one file. */
+  readonly modulePath?: string;
+  /** Max runs kept per (module_path, full_name) pair, most-recent-first. Default 20. */
+  readonly limit?: number;
+}
+/**
+ * Narrowing options shared by the classification reads
+ * ({@link DataReader.getFlaky} / `getPersistentFailures`). Mirrors the
+ * `testName` / `modulePath` half of {@link HistoryQueryOptions} so a
+ * caller that scoped `getHistory` to one test can scope the derived
+ * classifications to the same test instead of receiving the whole
+ * project's rows.
+ *
+ * @public
+ */
+interface ClassificationQueryOptions {
+  /** Exact `full_name` match — narrows to a single test's classification. */
+  readonly testName?: string;
+  /** Exact `module_path` match — narrows to tests in one file. */
+  readonly modulePath?: string;
+}
+/**
+ * Narrowing options for {@link DataReader.getTestByFullName}. A
+ * `full_name` is not file-qualified (Decision D20), so the same name can
+ * exist in more than one module; `modulePath` disambiguates.
+ *
+ * @public
+ */
+interface TestLookupOptions {
+  /** Exact `module_path` match — picks one variant of an ambiguous `full_name`. */
+  readonly modulePath?: string;
+}
+/** @public */
 interface TurnSearchOptions {
   readonly sessionId?: number;
   readonly type?: string;
@@ -2966,11 +3002,11 @@ interface TagInventoryRow {
 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) => Effect.Effect<HistoryRecord, 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) => Effect.Effect<ReadonlyArray<FlakyTest>, DataStoreError>;
-  readonly getPersistentFailures: (project: string) => Effect.Effect<ReadonlyArray<PersistentFailure>, 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>;
@@ -2981,7 +3017,14 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   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) => Effect.Effect<Option.Option<TestListEntry>, 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;
@@ -5363,5 +5406,5 @@ declare function validateCoverageTargetsShape(input: unknown): CoverageTargetsSh
  */
 declare const CURRENT_SDK_VERSION: string;
 //#endregion
-export { AcceptanceMetrics, ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, AgentTreeNode, AnsiOptions, ArtifactKind, AssembledHistoryRecord, AssociateRunSessionInput, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventType, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, CandidateContext, CellOptions, ChangeKind, ChannelEvent, ChatId, CiConsoleMode, CitedArtifact, CitedArtifactRow, CommitChangesEntry, ConfigLive, ConsoleFormatOptions, ConsoleLeakEntry, ConsoleLeakFile, ConsoleLeakTask, ConsoleLeaks, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, FileCoverageReport, CoverageGap, CoverageInput, CoverageLevel, CoverageLevelName, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTargetsShapeError, CoverageTargetsShapeInfo, CoverageTargetsShapeResult, CoverageTargetsShapeWarning, CoverageTotals, CreateBehaviorInput, CreateGoalInput, CurrentTddPhase, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DenialReason, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, DispatchInputs, EndTddTaskInput, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FailureSignatureDetail, FailureSignatureInput, FailureSignatureWriteInput, FileCoverageInput, FileEditPayload, FileSystemAdapter, FlakyTest, FormatSelector, FormatSelectorLive, type FormatTriageOptions, type FormatWrapupOptions, Formatter, FormatterContext, FunctionBoundary, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HistoryRow, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HistoryTrackerTestState, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HostMetadataResult, HumanConsoleMode, HypothesisDetail, HypothesisInput, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, IdempotencyHit, IdempotencyInput, IdempotentResponseInput, IllegalStatusTransitionEntity, IllegalStatusTransitionError, JsonFormatter, KnownProject, KnownProjectInput, LoggerLive, ManifestRow, MapSessionInput, MapSessionOutput, MarkdownFormatter, MetricThresholds, ModuleInput, ModuleListEntry, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NoteInput, NotePayload, NoteRow, Osc8Options, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PackageManager, PathResolutionError, PathResolutionLive, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PersistentFailure, Phase, PhaseTransitionContext, PhaseTransitionEvent, PhaseTransitionResult, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityCandidate, ProjectIdentityCandidates, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentitySource, ProjectIdentityTest, ProjectKey, ProjectRunSummary, ProjectSummary, RegisterAgentInput, RegisterAgentResult, RegistrationConflictError, Remediation, RenderState, RenderTotals, RenderedOutput, ReportError, ReportSummary, ReporterKit, ReporterRenderInput, ResolveDataPathOptions, ResolveProjectIdentityOptions, ResolvedIdentity, ResolvedReporterConfig, ResolvedThresholds, RunChangedFile, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, RunEventByTag, RunHealth, RunInvocationMethod, RunOutcome, RunShape, SRC_DIR, SessionCompleteEvent, SessionContextRow, SessionDetail, SessionInput, SessionNotFoundError, SessionOutcome, SettingsInput, SettingsListEntry, SettingsRow, SidecarTimeoutError, SilentFormatter, StackFrameInput, SuggestedActionRecord, SuiteInput, SuiteListEntry, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TagInventoryRow, TddArtifactDetail, TddArtifactRow, TddPhaseDetail, TddTaskAlreadyEndedError, TddTaskDetail, TddTaskEndOutcome, TddTaskId, TddTaskInput, TddTaskNotFoundError, TddTaskSummary, TerminalFormatter, TestCaseInput, TestClassification, TestError, TestErrorInput, TestFileEntry, TestHistory, TestListEntry, TestOutcome, TestPathClassification, TestPathVerdict, TestRecord, TestReport, TestRun, TestRunInput, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TrendSummary, TurnInput, TurnPayload, TurnSearchOptions, TurnSummary, UpdateBehaviorInput, UpdateGoalInput, UserPromptPayload, ValidateHypothesisInput, VitestAgentConfig, VitestAgentConfigFile, VitestAgentConfigFileService, VitestAgentReporter, VitestAgentReporterFactory, VitestModuleDiagnostic, VitestModuleError, VitestParsedStack, VitestTestCase, VitestTestDiagnostic, VitestTestError, VitestTestModule, VitestTestResult, VitestTestSuite, WorkspaceLike, type WrapupKind, WriteCommitInput, WriteRunChangedFilesInput, WriteTddArtifactInput, WriteTddPhaseInput, WriteTddPhaseOutput, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$1 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$2 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { AcceptanceMetrics, ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, AgentTreeNode, AnsiOptions, ArtifactKind, AssembledHistoryRecord, AssociateRunSessionInput, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventType, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, CandidateContext, CellOptions, ChangeKind, ChannelEvent, ChatId, CiConsoleMode, CitedArtifact, CitedArtifactRow, ClassificationQueryOptions, CommitChangesEntry, ConfigLive, ConsoleFormatOptions, ConsoleLeakEntry, ConsoleLeakFile, ConsoleLeakTask, ConsoleLeaks, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, FileCoverageReport, CoverageGap, CoverageInput, CoverageLevel, CoverageLevelName, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTargetsShapeError, CoverageTargetsShapeInfo, CoverageTargetsShapeResult, CoverageTargetsShapeWarning, CoverageTotals, CreateBehaviorInput, CreateGoalInput, CurrentTddPhase, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DenialReason, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, DispatchInputs, EndTddTaskInput, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FailureSignatureDetail, FailureSignatureInput, FailureSignatureWriteInput, FileCoverageInput, FileEditPayload, FileSystemAdapter, FlakyTest, FormatSelector, FormatSelectorLive, type FormatTriageOptions, type FormatWrapupOptions, Formatter, FormatterContext, FunctionBoundary, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryQueryOptions, HistoryRecord, HistoryRow, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HistoryTrackerTestState, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HostMetadataResult, HumanConsoleMode, HypothesisDetail, HypothesisInput, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, IdempotencyHit, IdempotencyInput, IdempotentResponseInput, IllegalStatusTransitionEntity, IllegalStatusTransitionError, JsonFormatter, KnownProject, KnownProjectInput, LoggerLive, ManifestRow, MapSessionInput, MapSessionOutput, MarkdownFormatter, MetricThresholds, ModuleInput, ModuleListEntry, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NoteInput, NotePayload, NoteRow, Osc8Options, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PackageManager, PathResolutionError, PathResolutionLive, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PersistentFailure, Phase, PhaseTransitionContext, PhaseTransitionEvent, PhaseTransitionResult, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityCandidate, ProjectIdentityCandidates, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentitySource, ProjectIdentityTest, ProjectKey, ProjectRunSummary, ProjectSummary, RegisterAgentInput, RegisterAgentResult, RegistrationConflictError, Remediation, RenderState, RenderTotals, RenderedOutput, ReportError, ReportSummary, ReporterKit, ReporterRenderInput, ResolveDataPathOptions, ResolveProjectIdentityOptions, ResolvedIdentity, ResolvedReporterConfig, ResolvedThresholds, RunChangedFile, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, RunEventByTag, RunHealth, RunInvocationMethod, RunOutcome, RunShape, SRC_DIR, SessionCompleteEvent, SessionContextRow, SessionDetail, SessionInput, SessionNotFoundError, SessionOutcome, SettingsInput, SettingsListEntry, SettingsRow, SidecarTimeoutError, SilentFormatter, StackFrameInput, SuggestedActionRecord, SuiteInput, SuiteListEntry, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TagInventoryRow, TddArtifactDetail, TddArtifactRow, TddPhaseDetail, TddTaskAlreadyEndedError, TddTaskDetail, TddTaskEndOutcome, TddTaskId, TddTaskInput, TddTaskNotFoundError, TddTaskSummary, TerminalFormatter, TestCaseInput, TestClassification, TestError, TestErrorInput, TestFileEntry, TestHistory, TestListEntry, TestLookupOptions, TestOutcome, TestPathClassification, TestPathVerdict, TestRecord, TestReport, TestRun, TestRunInput, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TrendSummary, TurnInput, TurnPayload, TurnSearchOptions, TurnSummary, UpdateBehaviorInput, UpdateGoalInput, UserPromptPayload, ValidateHypothesisInput, VitestAgentConfig, VitestAgentConfigFile, VitestAgentConfigFileService, VitestAgentReporter, VitestAgentReporterFactory, VitestModuleDiagnostic, VitestModuleError, VitestParsedStack, VitestTestCase, VitestTestDiagnostic, VitestTestError, VitestTestModule, VitestTestResult, VitestTestSuite, WorkspaceLike, type WrapupKind, WriteCommitInput, WriteRunChangedFilesInput, WriteTddArtifactInput, WriteTddPhaseInput, WriteTddPhaseOutput, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$1 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$2 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -117,7 +117,7 @@ import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validat
 * substituted yet. Exported for version introspection by downstream tooling.
 * @public
 */
-const CURRENT_SDK_VERSION = "2.2.1";
+const CURRENT_SDK_VERSION = "2.3.1";
 
 //#endregion
 export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentContext, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConfigLive, ConsoleLeakFile, ConsoleLeaks, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DATABASE_FILENAME, DataReader, DataReaderLive, DataStore, DataStoreError, DataStoreLive, DetailLevel, DetailResolver, DetailResolverLive, DiscoveryError, DiscoveryRegistry, DiscoveryRegistryLive, Environment, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, Executor, ExecutorResolver, ExecutorResolverLive, FailureRecord, FileCoverageReport, FileEditPayload, FormatSelector, FormatSelectorLive, GfmFormatter, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IDEMPOTENCY_ROOT_SENTINEL, IdempotencyHit, IllegalStatusTransitionError, JsonFormatter, LoggerLive, MarkdownFormatter, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, OutputPipelineLive, OutputRenderer, OutputRendererLive, PackageManager, PathResolutionError, PathResolutionLive, PatternThresholds, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PhaseTransitionEvent, ProbeMissError, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityNotResolvableError, ProjectIdentityTest, ProjectKey, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportSummary, ResolvedThresholds, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, RunEvent, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SilentFormatter, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TerminalFormatter, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, VitestAgentConfigFile, _resetMigrationCacheForTesting, ansi, assembleHistoryRecord, assembleManifest, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, ciAnnotationsFormatter, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeFailureSignature, computeTrend, countSuiteFailures, deriveIdempotencyKey, detectPackageManager, detectVitestScripts, determineTier, ensureMigrated, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatTriageEffect, formatWrapupEffect, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, historyKey, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, migration as migration0001, normalizeAssertionShape, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, migration$1 as registryMigration0001, relativePath, requiredArtifactForTransition, resolveCoverageInput, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveWorkspaceKey, rewriteBashCommand, safeFilename, migration$2 as sessionMapMigration0001, stripAnsi, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/layers/DataReaderLive.js

@@ -194,11 +194,28 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "test_runs",
 		reason: extractSqlReason(e)
 	})));
-	const getHistory = (project) => Effect.gen(function* () {
-		yield* Effect.logDebug("getHistory").pipe(Effect.annotateLogs({ project }));
-		const rows = yield* sql`SELECT module_path, full_name, timestamp, state
-					FROM test_history
-					WHERE project = ${project}
+	const getHistory = (project, options) => Effect.gen(function* () {
+		yield* Effect.logDebug("getHistory").pipe(Effect.annotateLogs({
+			project,
+			...options
+		}));
+		const testName = options?.testName ?? null;
+		const modulePath = options?.modulePath ?? null;
+		const limit = options?.limit ?? 20;
+		const rows = yield* sql`WITH ranked AS (
+						SELECT module_path, full_name, timestamp, state,
+							ROW_NUMBER() OVER (
+								PARTITION BY module_path, full_name
+								ORDER BY timestamp DESC
+							) AS rn
+						FROM test_history
+						WHERE project = ${project}
+							AND (${testName} IS NULL OR full_name = ${testName})
+							AND (${modulePath} IS NULL OR module_path = ${modulePath})
+					)
+					SELECT module_path, full_name, timestamp, state
+					FROM ranked
+					WHERE rn <= ${limit}
 					ORDER BY module_path, full_name, timestamp DESC`;
 		const testsMap = /* @__PURE__ */ new Map();
 		for (const row of rows) {
@@ -310,8 +327,13 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "coverage_trends",
 		reason: extractSqlReason(e)
 	})));
-	const getFlaky = (project) => Effect.gen(function* () {
-		yield* Effect.logDebug("getFlaky").pipe(Effect.annotateLogs({ project }));
+	const getFlaky = (project, options) => Effect.gen(function* () {
+		yield* Effect.logDebug("getFlaky").pipe(Effect.annotateLogs({
+			project,
+			...options
+		}));
+		const testName = options?.testName ?? null;
+		const modulePath = options?.modulePath ?? null;
 		return (yield* sql`SELECT
 						th1.full_name,
 						th1.module_path,
@@ -326,6 +348,8 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 						MAX(th1.timestamp) as last_timestamp
 					FROM test_history th1
 					WHERE th1.project = ${project}
+						AND (${testName} IS NULL OR th1.full_name = ${testName})
+						AND (${modulePath} IS NULL OR th1.module_path = ${modulePath})
 					GROUP BY th1.full_name, th1.module_path, th1.project
 					-- Flaky means oscillation, not a clean recovery. A test with both
 						-- passes and fails is only flaky when at least one failure occurs at
@@ -350,8 +374,13 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "test_history",
 		reason: extractSqlReason(e)
 	})));
-	const getPersistentFailures = (project) => Effect.gen(function* () {
-		yield* Effect.logDebug("getPersistentFailures").pipe(Effect.annotateLogs({ project }));
+	const getPersistentFailures = (project, options) => Effect.gen(function* () {
+		yield* Effect.logDebug("getPersistentFailures").pipe(Effect.annotateLogs({
+			project,
+			...options
+		}));
+		const testName = options?.testName ?? null;
+		const modulePath = options?.modulePath ?? null;
 		return (yield* sql`WITH ranked AS (
 					SELECT full_name, module_path, project, state, timestamp, error_message,
 						ROW_NUMBER() OVER (
@@ -360,6 +389,8 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 						) as rn
 					FROM test_history
 					WHERE project = ${project}
+						AND (${testName} IS NULL OR full_name = ${testName})
+						AND (${modulePath} IS NULL OR module_path = ${modulePath})
 				),
 				streak AS (
 					SELECT full_name, module_path, project, state, timestamp, error_message, rn,
@@ -509,7 +540,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 							f.path as module_file
 						FROM test_errors te
 						LEFT JOIN test_cases tc ON tc.id = te.test_case_id
-						LEFT JOIN test_modules tm ON tm.id = te.module_id
+						LEFT JOIN test_modules tm ON tm.id = COALESCE(te.module_id, tc.module_id)
 						LEFT JOIN files f ON f.id = tm.file_id
 						LEFT JOIN stack_frames sf ON sf.error_id = te.id AND sf.ordinal = 0
 						WHERE te.run_id = ${runId} AND te.name = ${errorName}` : sql`SELECT te.id, sf.id AS top_stack_frame_id,
@@ -518,7 +549,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 							f.path as module_file
 						FROM test_errors te
 						LEFT JOIN test_cases tc ON tc.id = te.test_case_id
-						LEFT JOIN test_modules tm ON tm.id = te.module_id
+						LEFT JOIN test_modules tm ON tm.id = COALESCE(te.module_id, tc.module_id)
 						LEFT JOIN files f ON f.id = tm.file_id
 						LEFT JOIN stack_frames sf ON sf.error_id = te.id AND sf.ordinal = 0
 						WHERE te.run_id = ${runId}`).map((r) => ({
@@ -679,21 +710,25 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "settings",
 		reason: extractSqlReason(e)
 	})));
-	const getTestByFullName = (project, fullName) => Effect.gen(function* () {
+	const getTestByFullName = (project, fullName, options) => Effect.gen(function* () {
 		yield* Effect.logDebug("getTestByFullName").pipe(Effect.annotateLogs({
 			project,
-			fullName
+			fullName,
+			...options
 		}));
 		const runs = yield* sql`SELECT id FROM test_runs
 					WHERE project = ${project}
 					ORDER BY timestamp DESC LIMIT 1`;
 		if (runs.length === 0) return Option.none();
 		const runId = runs[0].id;
+		const modulePath = options?.modulePath ?? null;
 		const rows = yield* sql`SELECT tc.id, tc.full_name, tc.state, tc.duration, f.path as relative_module_id, tc.classification
 					FROM test_cases tc
 					JOIN test_modules tm ON tm.id = tc.module_id
 					JOIN files f ON f.id = tm.file_id
 					WHERE tm.run_id = ${runId} AND tc.full_name = ${fullName}
+						AND (${modulePath} IS NULL OR f.path = ${modulePath})
+					ORDER BY f.path ASC, tc.id ASC
 					LIMIT 1`;
 		if (rows.length === 0) return Option.none();
 		const r = rows[0];
@@ -710,6 +745,27 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		table: "test_cases",
 		reason: extractSqlReason(e)
 	})));
+	const getTestModulesByFullName = (project, fullName) => Effect.gen(function* () {
+		yield* Effect.logDebug("getTestModulesByFullName").pipe(Effect.annotateLogs({
+			project,
+			fullName
+		}));
+		const runs = yield* sql`SELECT id FROM test_runs
+					WHERE project = ${project}
+					ORDER BY timestamp DESC LIMIT 1`;
+		if (runs.length === 0) return [];
+		const runId = runs[0].id;
+		return (yield* sql`SELECT DISTINCT f.path as relative_module_id
+					FROM test_cases tc
+					JOIN test_modules tm ON tm.id = tc.module_id
+					JOIN files f ON f.id = tm.file_id
+					WHERE tm.run_id = ${runId} AND tc.full_name = ${fullName}
+					ORDER BY f.path ASC`).map((r) => r.relative_module_id);
+	}).pipe(Effect.annotateLogs("service", "DataReader"), Effect.mapError((e) => new DataStoreError({
+		operation: "read",
+		table: "test_cases",
+		reason: extractSqlReason(e)
+	})));
 	const listTests = (project, options) => Effect.gen(function* () {
 		yield* Effect.logDebug("listTests").pipe(Effect.annotateLogs({ project }));
 		const runs = yield* sql`SELECT id FROM test_runs
@@ -1633,6 +1689,7 @@ const DataReaderLive = Layer.effect(DataReader, Effect.gen(function* () {
 		getSettings,
 		getLatestSettings,
 		getTestByFullName,
+		getTestModulesByFullName,
 		listTests,
 		listModules,
 		listSuites,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "2.2.1",
+	"version": "2.3.1",
 	"private": false,
 	"description": "Shared Effect Schema, SQLite migrations, data layer, services, formatters, and utilities for vitest-agent packages.",
 	"keywords": [
@@ -47,12 +47,12 @@
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-beta.107",
 		"@effect/sql-sqlite-node": "4.0.0-beta.107",
-		"@effected/config-file": "^0.3.1",
+		"@effected/config-file": "^0.4.1",
 		"@effected/jsonc": "^0.6.0",
 		"@effected/toml": "^0.4.0",
 		"@effected/walker": "^0.4.0",
-		"@effected/workspaces": "^0.11.2",
-		"@effected/xdg": "^0.2.0",
+		"@effected/workspaces": "^0.13.0",
+		"@effected/xdg": "^0.2.1",
 		"@effected/yaml": "^0.8.0",
 		"acorn": "^8.18.0",
 		"acorn-typescript": "^1.4.13",

package/testing.d.ts

@@ -1236,6 +1236,42 @@ interface TurnSummary {
   readonly occurredAt: string;
 }
 /** @public */
+interface HistoryQueryOptions {
+  /** Exact `full_name` match — narrows to a single test's history. */
+  readonly testName?: string;
+  /** Exact `module_path` match — narrows to tests in one file. */
+  readonly modulePath?: string;
+  /** Max runs kept per (module_path, full_name) pair, most-recent-first. Default 20. */
+  readonly limit?: number;
+}
+/**
+ * Narrowing options shared by the classification reads
+ * ({@link DataReader.getFlaky} / `getPersistentFailures`). Mirrors the
+ * `testName` / `modulePath` half of {@link HistoryQueryOptions} so a
+ * caller that scoped `getHistory` to one test can scope the derived
+ * classifications to the same test instead of receiving the whole
+ * project's rows.
+ *
+ * @public
+ */
+interface ClassificationQueryOptions {
+  /** Exact `full_name` match — narrows to a single test's classification. */
+  readonly testName?: string;
+  /** Exact `module_path` match — narrows to tests in one file. */
+  readonly modulePath?: string;
+}
+/**
+ * Narrowing options for {@link DataReader.getTestByFullName}. A
+ * `full_name` is not file-qualified (Decision D20), so the same name can
+ * exist in more than one module; `modulePath` disambiguates.
+ *
+ * @public
+ */
+interface TestLookupOptions {
+  /** Exact `module_path` match — picks one variant of an ambiguous `full_name`. */
+  readonly modulePath?: string;
+}
+/** @public */
 interface TurnSearchOptions {
   readonly sessionId?: number;
   readonly type?: string;
@@ -1390,11 +1426,11 @@ interface TagInventoryRow {
 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) => Effect.Effect<HistoryRecord, 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) => Effect.Effect<ReadonlyArray<FlakyTest>, DataStoreError>;
-  readonly getPersistentFailures: (project: string) => Effect.Effect<ReadonlyArray<PersistentFailure>, 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>;
@@ -1405,7 +1441,14 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
   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) => Effect.Effect<Option.Option<TestListEntry>, 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;
@@ -1535,5 +1578,5 @@ declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | i
 /** @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>;
 //#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 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, 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 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, 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 };
 //# sourceMappingURL=testing.d.ts.map