@vitest-agent/sdk 6.0.0 → 6.1.0

package/index.d.ts

@@ -28,6 +28,35 @@ export declare const FileCoverageReport: Schema.Struct<{
 }>;
 /** @public */
 export type FileCoverageReport = typeof FileCoverageReport.Type;
+/**
+ * A threshold glob whose AGGREGATE coverage (summed covered/total across
+ * every file the glob matches, the same way Vitest evaluates a glob
+ * threshold) is below at least one of the glob's metric numbers.
+ *
+ * This is independent of the per-file lists: with an object `perFile` every
+ * matched file can pass while the glob as a whole still fails.
+ * @public
+ */
+export declare const GlobShortfall: Schema.Struct<{
+  /** The threshold glob pattern as configured. */
+  readonly pattern: Schema.String;
+  /** Aggregate coverage percentages over the files the glob matches. */
+  readonly summary: Schema.Struct<{
+    readonly statements: Schema.Number;
+    readonly branches: Schema.Number;
+    readonly functions: Schema.Number;
+    readonly lines: Schema.Number;
+  }>;
+  /** The glob's own metric numbers that were set (`perFile` excluded). */
+  readonly thresholds: Schema.Struct<{
+    readonly lines: Schema.optional<Schema.Number>;
+    readonly functions: Schema.optional<Schema.Number>;
+    readonly branches: Schema.optional<Schema.Number>;
+    readonly statements: Schema.optional<Schema.Number>;
+  }>;
+}>;
+/** @public */
+export type GlobShortfall = typeof GlobShortfall.Type;
 /**
  * Complete coverage report attached to an AgentReport.
  * @public
@@ -124,6 +153,24 @@ export declare const CoverageReport: Schema.Struct<{
     readonly uncoveredLines: Schema.String;
   }>>>;
   readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    /** The threshold glob pattern as configured. */
+    readonly pattern: Schema.String;
+    /** Aggregate coverage percentages over the files the glob matches. */
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    /** The glob's own metric numbers that were set (`perFile` excluded). */
+    readonly thresholds: Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>;
+  }>>>;
 }>;
 /** @public */
 export type CoverageReport = typeof CoverageReport.Type;
@@ -249,6 +296,21 @@ export declare const CoverageRenderState: Schema.Struct<{
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>;
+  }>>>;
 }>;
 /** @public */
 export type CoverageRenderState = typeof CoverageRenderState.Type;
@@ -370,6 +432,21 @@ export declare const RenderState: Schema.Struct<{
     readonly scoped: Schema.optional<Schema.Boolean>;
     readonly scopedFiles: Schema.optional<Schema.Number>;
     readonly totalFiles: Schema.optional<Schema.Number>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>;
+    }>>>;
   }>>;
   readonly trend: Schema.NullOr<Schema.Struct<{
     readonly direction: Schema.Literals<readonly ["improving", "regressing", "stable"]>;
@@ -817,6 +894,21 @@ export declare const AgentReport: Schema.Struct<{
       readonly uncoveredLines: Schema.String;
     }>>>;
     readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly pattern: Schema.String;
+      readonly summary: Schema.Struct<{
+        readonly statements: Schema.Number;
+        readonly branches: Schema.Number;
+        readonly functions: Schema.Number;
+        readonly lines: Schema.Number;
+      }>;
+      readonly thresholds: Schema.Struct<{
+        readonly lines: Schema.optional<Schema.Number>;
+        readonly functions: Schema.optional<Schema.Number>;
+        readonly branches: Schema.optional<Schema.Number>;
+        readonly statements: Schema.optional<Schema.Number>;
+      }>;
+    }>>>;
   }>>;
   readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
     readonly passed: Schema.optional<Schema.Number>;
@@ -1173,6 +1265,21 @@ export declare const RunEvent: Schema.Union<readonly [Schema.TaggedStruct<"RunSt
   readonly scoped: Schema.optional<Schema.Boolean>;
   readonly scopedFiles: Schema.optional<Schema.Number>;
   readonly totalFiles: Schema.optional<Schema.Number>;
+  readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly pattern: Schema.String;
+    readonly summary: Schema.Struct<{
+      readonly statements: Schema.Number;
+      readonly branches: Schema.Number;
+      readonly functions: Schema.Number;
+      readonly lines: Schema.Number;
+    }>;
+    readonly thresholds: Schema.Struct<{
+      readonly lines: Schema.optional<Schema.Number>;
+      readonly functions: Schema.optional<Schema.Number>;
+      readonly branches: Schema.optional<Schema.Number>;
+      readonly statements: Schema.optional<Schema.Number>;
+    }>;
+  }>>>;
 }>, Schema.TaggedStruct<"ThresholdViolation", {
   readonly metric: Schema.Literals<readonly ["lines", "branches", "functions", "statements"]>;
   readonly expected: Schema.Number;
@@ -2789,6 +2896,21 @@ export declare const RunReportFile: Schema.Struct<{
         readonly uncoveredLines: Schema.String;
       }>>>;
       readonly belowTargetFiles: Schema.optional<Schema.$Array<Schema.String>>;
+      readonly globShortfalls: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly pattern: Schema.String;
+        readonly summary: Schema.Struct<{
+          readonly statements: Schema.Number;
+          readonly branches: Schema.Number;
+          readonly functions: Schema.Number;
+          readonly lines: Schema.Number;
+        }>;
+        readonly thresholds: Schema.Struct<{
+          readonly lines: Schema.optional<Schema.Number>;
+          readonly functions: Schema.optional<Schema.Number>;
+          readonly branches: Schema.optional<Schema.Number>;
+          readonly statements: Schema.optional<Schema.Number>;
+        }>;
+      }>>>;
     }>>;
     readonly tagCounts: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
       readonly passed: Schema.optional<Schema.Number>;

package/index.js

@@ -10,7 +10,7 @@ import { Agent, IdempotencyHit } from "./schemas/Agent.js";
 import { AgentConsoleMode, CiConsoleMode, ConsoleMode, ConsoleOutputMode, DetailLevel, Environment, Executor, HumanConsoleMode, OutputFormat, PackageManager, ReportError, TestClassification, TestRunReason, TestState } from "./schemas/Common.js";
 import { ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests } from "./schemas/ConsoleLeaks.js";
 import { MetricThresholds, PatternMetricThresholds, PatternThresholds, PerFileThresholds, ResolvedThresholds } from "./schemas/Thresholds.js";
-import { CoverageReport, CoverageTotals, FileCoverageReport } from "./schemas/Coverage.js";
+import { CoverageReport, CoverageTotals, FileCoverageReport, GlobShortfall } from "./schemas/Coverage.js";
 import { AgentReport, ModuleReport, ReportSummary, TagCountEntry, TestReport } from "./schemas/AgentReport.js";
 import { CoverageBaselines } from "./schemas/Baselines.js";
 import { CacheManifest, CacheManifestEntry } from "./schemas/CacheManifest.js";
@@ -62,4 +62,4 @@ import { validateCoverageTargetsShape } from "./utils/validate-coverage-targets-
 import { requiredArtifactForTransition, transitionEnforcesBehaviorMatch, validatePhaseTransition } from "./utils/validate-phase-transition.js";
 import { CURRENT_SDK_VERSION } from "./version.js";
 
-export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GitCommandError, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };
+export { ActionSeverity, ActorType, Agent, AgentConsoleMode, AgentId, AgentNotFoundError, AgentPluginOptions, AgentReport, AgentReporterOptions, BATS_FILE_GLOB_SUFFIX, BehaviorAbandonedEvent, BehaviorAddedEvent, BehaviorCompletedEvent, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorScopedEventTypes, BehaviorStartedEvent, BehaviorStatus, BehaviorsReadyEvent, BlockedEvent, CURRENT_SDK_VERSION, CacheManifest, CacheManifestEntry, ChannelEvent, ChatId, CiConsoleMode, ConsoleLeakFile, ConsoleLeaks, ConsoleLeaksFromFailingTests, ConsoleLogLevel, ConsoleMode, ConsoleOutputMode, ConsoleOutputs, ConversationId, ConversationNotFoundError, CoverageBaselines, FileCoverageReport as CoverageFile, CoverageGap, CoverageLevel, CoverageMetric, CoverageRenderState, CoverageReport, CoverageTargets, CoverageTargetsMetrics, CoverageTotals, DataStoreError, DetailLevel, DiscoveryError, Environment, Executor, FailureRecord, FileCoverageReport, FileEditPayload, GitCommandError, GlobShortfall, GoalAbandonedEvent, GoalAddedEvent, GoalCompletedEvent, GoalDetail, GoalNotFoundError, GoalRow, GoalStartedEvent, GoalStatus, GoalsReadyEvent, HistoryRecord, HookFirePayload, HookStatus, HookType, HostKind, HostMetadataParseError, HumanConsoleMode, HypothesisPayload, IdempotencyHit, IllegalStatusTransitionError, MetricThresholds, ModuleRecord, ModuleReport, NON_DISCOVERABLE_DIRS, NotePayload, OutputFormat, PackageManager, PathResolutionError, PatternMetricThresholds, PatternThresholds, PerFileThresholds, PhaseTransitionEvent, ProbeMissError, ProjectIdentityNotResolvableError, ProjectKey, RUN_REPORT_FILE_SCHEMA_URL, RegistrationConflictError, RenderState, RenderTotals, ReportError, ReportOption, ReportSettings, ReportSummary, ResolvedThresholds, RunEvent, RunReportFile, SRC_DIR, SessionCompleteEvent, SessionNotFoundError, SessionOutcome, SidecarTimeoutError, SuggestedActionRecord, TEST_DIR, TEST_FILE_GLOB_SUFFIX, TEST_HELPER_DIRS, TagCountEntry, TddTaskAlreadyEndedError, TddTaskId, TddTaskNotFoundError, TestAnnotation, TestArtifact, TestArtifactLocation, TestAttachment, TestClassification, TestHistory, TestRecord, TestReport, TestRun, TestRunReason, TestState, ToolCallPayload, ToolResultPayload, Transport, TrendEntry, TrendRecord, TurnPayload, UserPromptPayload, VitestAgentConfig, ansi, basenamePosix, buildAgentReport, buildConsoleLeaks, buildEnvPrefix, canonicalizeGitUrl, classifyTest, classifyTestPath, coerceErrorField, coerceErrorText, collectConsoleLeakEntries, compressLines, computeTrend, countSuiteFailures, detectNonDefaultDiscoverStrategy, detectPackageManager, detectVitestScripts, determineTier, extractSqlReason, findFunctionBoundary, findOwningWorkspace, formatConsoleMarkdown, formatFatalError, formatGfm, formatScopedCoverageNote, getRecentDirection, getRunCommand, getWorstMetric, gitUrlToProjectKey, hashTargets, initialRenderState, isTestFileName, isTimeoutError, isVitestInvocation, joinPosix, normalizeWorkspaceKey, osc8, probeHostMetadataFromEnv, relativePath, relativePosix, requiredArtifactForTransition, resolveCoverageInput, rewriteBashCommand, safeFilename, stripAnsi, toPosix, transitionEnforcesBehaviorMatch, validateCoverageConfig, validateCoverageTargetsShape, validatePhaseTransition };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/sdk",
-	"version": "6.0.0",
+	"version": "6.1.0",
 	"private": false,
 	"description": "Platform-free core for the vitest-agent package family: Effect Schema definitions, reporter and dispatcher contracts, errors, and pure utilities.",
 	"keywords": [

package/schemas/5.0/run.json

@@ -526,6 +526,22 @@
 			"required": ["file", "summary", "uncoveredLines"],
 			"additionalProperties": true
 		},
+		"GlobShortfall": {
+			"type": "object",
+			"properties": {
+				"pattern": {
+					"type": "string"
+				},
+				"summary": {
+					"$ref": "#/$defs/CoverageTotals"
+				},
+				"thresholds": {
+					"$ref": "#/$defs/MetricThresholds"
+				}
+			},
+			"required": ["pattern", "summary", "thresholds"],
+			"additionalProperties": true
+		},
 		"CoverageReport": {
 			"type": "object",
 			"properties": {
@@ -665,6 +681,19 @@
 							"type": "null"
 						}
 					]
+				},
+				"globShortfalls": {
+					"anyOf": [
+						{
+							"type": "array",
+							"items": {
+								"$ref": "#/$defs/GlobShortfall"
+							}
+						},
+						{
+							"type": "null"
+						}
+					]
 				}
 			},
 			"required": ["totals", "thresholds", "lowCoverage", "lowCoverageFiles"],

package/schemas/Coverage.js

@@ -22,6 +22,23 @@ const FileCoverageReport = Schema.Struct({
 	uncoveredLines: Schema.String
 }).annotate({ identifier: "FileCoverageReport" });
 /**
+* A threshold glob whose AGGREGATE coverage (summed covered/total across
+* every file the glob matches, the same way Vitest evaluates a glob
+* threshold) is below at least one of the glob's metric numbers.
+*
+* This is independent of the per-file lists: with an object `perFile` every
+* matched file can pass while the glob as a whole still fails.
+* @public
+*/
+const GlobShortfall = Schema.Struct({
+	/** The threshold glob pattern as configured. */
+	pattern: Schema.String,
+	/** Aggregate coverage percentages over the files the glob matches. */
+	summary: CoverageTotals,
+	/** The glob's own metric numbers that were set (`perFile` excluded). */
+	thresholds: MetricThresholds
+}).annotate({ identifier: "GlobShortfall" });
+/**
 * Complete coverage report attached to an AgentReport.
 * @public
 */
@@ -45,8 +62,9 @@ const CoverageReport = Schema.Struct({
 	lowCoverage: Schema.Array(FileCoverageReport),
 	lowCoverageFiles: Schema.Array(Schema.String),
 	belowTarget: Schema.optional(Schema.Array(FileCoverageReport)),
-	belowTargetFiles: Schema.optional(Schema.Array(Schema.String))
+	belowTargetFiles: Schema.optional(Schema.Array(Schema.String)),
+	globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 }).annotate({ identifier: "CoverageReport" });
 
 //#endregion
-export { CoverageReport, CoverageTotals, FileCoverageReport };
+export { CoverageReport, CoverageTotals, FileCoverageReport, GlobShortfall };

package/schemas/RenderState.js

@@ -1,6 +1,6 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
 import { MetricThresholds } from "./Thresholds.js";
-import { CoverageTotals } from "./Coverage.js";
+import { CoverageTotals, GlobShortfall } from "./Coverage.js";
 import { ActionSeverity, CoverageGap, CoverageMetric } from "./RunEvent.js";
 import { Schema } from "effect";
 
@@ -79,7 +79,8 @@ const CoverageRenderState = Schema.Struct({
 	})),
 	scoped: Schema.optional(Schema.Boolean),
 	scopedFiles: Schema.optional(Schema.Number),
-	totalFiles: Schema.optional(Schema.Number)
+	totalFiles: Schema.optional(Schema.Number),
+	globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 }).annotate({ identifier: "CoverageRenderState" });
 /**
 * A `SuggestedAction` event, denormalized into the queue the renderer reads.

package/schemas/RunEvent.js

@@ -1,6 +1,6 @@
 import { ReportError, TestClassification, TestState } from "./Common.js";
 import { MetricThresholds } from "./Thresholds.js";
-import { CoverageTotals, FileCoverageReport } from "./Coverage.js";
+import { CoverageTotals, FileCoverageReport, GlobShortfall } from "./Coverage.js";
 import { TestArtifactLocation, TestAttachment } from "./TestArtifacts.js";
 import { Schema } from "effect";
 
@@ -178,7 +178,8 @@ const RunEvent = Schema.Union([
 		gaps: Schema.Array(CoverageGap),
 		scoped: Schema.optional(Schema.Boolean),
 		scopedFiles: Schema.optional(Schema.Number),
-		totalFiles: Schema.optional(Schema.Number)
+		totalFiles: Schema.optional(Schema.Number),
+		globShortfalls: Schema.optional(Schema.Array(GlobShortfall))
 	}),
 	Schema.TaggedStruct("ThresholdViolation", {
 		metric: CoverageMetric,

package/version.js

@@ -11,7 +11,7 @@
 * survives into the published artifact.
 * @public
 */
-const CURRENT_SDK_VERSION = "6.0.0";
+const CURRENT_SDK_VERSION = "6.1.0";
 
 //#endregion
 export { CURRENT_SDK_VERSION };