@vitest-agent/engine 2.1.0 → 3.0.1

package/index.d.ts

@@ -1,14 +1,14 @@
-import { AppDirs, AppDirs as AppDirs$1, AppDirsError, AppDirsError as AppDirsError$1, XdgEnvError } from "@effected/xdg";
+import { AppDirs, AppDirs as AppDirs$1, AppDirsError, AppDirsError as AppDirsError$1, AppDirsSegmentError, XdgEnvError } from "@effected/xdg";
 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, ProjectIdentityError, ProjectIdentityNotResolvableError, RegistrationConflictError, ResolvedThresholds, RunRetentionPolicy, StrayOutput, 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, ProjectIdentitySourceError, RegistrationConflictError, ResolvedThresholds, RunRetentionPolicy, StrayOutput, TddTaskAlreadyEndedError, TddTaskNotFoundError, TestClassification, TestRun, TrendEntry, TrendRecord, TurnPayload, VitestAgentConfig } from "@vitest-agent/sdk";
 import { SqlClient } from "effect/sql/SqlClient";
 import { CiName, RuntimeEnv } from "@effected/env";
 import { WorkspaceDiscovery, WorkspaceDiscoveryFailure, WorkspaceRootNotFoundError } from "@effected/workspaces";
 import { ChildProcessSpawner } from "effect/process";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { SqliteClient } from "@effect/sql-sqlite-node/SqliteClient";
-import { StoreError, StoreMigrationError } from "@effected/store";
+import { StoreError, StoreMigrationError, StoreShape } from "@effected/store";
 import { SqlError } from "effect/sql/SqlError";
 import { PlatformError } from "effect/PlatformError";
 /**
@@ -35,12 +35,19 @@ export declare class VitestAgentConfigFile extends VitestAgentConfigFile_base {}
  *
  * 1. The workspace root (when `projectDir` is inside a pnpm/npm/yarn workspace).
  * 2. The git repository root (when `projectDir` is inside a git repo).
- * 3. Walking upward from `projectDir`.
+ * 3. Walking upward from `projectDir`, stopping at the git repository root
+ *    (inclusive, compared physically) so a config file above the repository
+ *    is never picked up. Outside a repository the walk runs to the
+ *    filesystem root.
  *
  * The first found file wins (`MergeStrategy.firstMatch()`). If no file is
  * present, downstream callers use `loadOrDefault(new VitestAgentConfig({}))`
  * to get an empty config.
  *
+ * The repository root comes from `git rev-parse --show-toplevel` through
+ * `@effected/git`, using a `Git` or `ChildProcessSpawner` service if the
+ * context has one; neither is required (see `repoRootCeiling`).
+ *
  * @param projectDir - Absolute path inside the user's workspace. Resolvers
  *   anchor here rather than `process.cwd()` so the plugin-spawned MCP server
  *   sees the right config even when invoked from elsewhere.
@@ -1386,6 +1393,10 @@ export declare const LoggerLive: (level?: LogLevel.LogLevel, logFile?: string, e
  * Resolve log level from option or environment variable.
  * Priority: explicit option \> `VITEST_REPORTER_LOG_LEVEL` in `env` \> undefined.
  *
+ * Case-insensitive; `warning` is accepted for `Warn`. An unset or empty value,
+ * or one that names no level, resolves to `undefined` (no diagnostics) without
+ * a warning.
+ *
  * @param env - the environment map to consult (the front end passes `process.env`)
  * @param option - explicit override
  * @public
@@ -1632,12 +1643,13 @@ declare const ProjectIdentity_base: Context.ServiceClass<ProjectIdentity, "vites
  */
 export declare class ProjectIdentity extends ProjectIdentity_base {}
 /**
- * Effect environment type required by `collectCandidates` and the
- * `ProjectIdentityLive` layer. Exported only so the layer's
+ * Effect environment type required by the `ProjectIdentityLive` layer.
+ * Exported only so the layer's
  * `Layer.Layer<ProjectIdentity, never, CandidateContext>` signature
  * has a named referent — consumers should provide the four named
  * services (FileSystem, WorkspaceDiscovery, VitestAgentConfigFile,
- * CommandExecutor) rather than reference this type directly.
+ * ChildProcessSpawner, which feeds the layer's own `@effected/git` `Git`)
+ * rather than reference this type directly.
  *
  * @public
  */
@@ -1719,9 +1731,10 @@ export declare const RunContextService: typeof RunContext$;
 export type RunContextService = RunContext$;
 /**
  * Live layer. Requires `ChildProcessSpawner` (provided by
- * `NodeServices.layer` at the entry point). Host-metadata probes read
- * the injected `env` map — the env walk is pure and the map is captured
- * once when the layer is built.
+ * `NodeServices.layer` at the entry point), which feeds `@effected/git`'s
+ * `Git` for branch / sha / dirty / upstream / toplevel. Every git failure is
+ * recorded as `null`. Host metadata comes from `probeHostMetadataFromEnv`
+ * over the injected `env` map, captured once when the layer is built.
  *
  * @param env - the environment map to probe (the front end passes `process.env`)
  * @public
@@ -1820,6 +1833,18 @@ declare const migration$3: Effect.Effect<void, import("effect/sql/SqlError").Sql
  * @public
  */
 type MigrationRecord = Record<string, Effect.Effect<void, SqlError, SqlClient>>;
+declare const RegistryStore_base: Context.ServiceClass<RegistryStore, "vitest-agent/RegistryStore", StoreShape>;
+/**
+ * The global discovery registry (`<XDG data>/vitest-agent/registry.db`).
+ * @internal
+ */
+export declare class RegistryStore extends RegistryStore_base {}
+declare const SessionMapStore_base: Context.ServiceClass<SessionMapStore, "vitest-agent/SessionMapStore", StoreShape>;
+/**
+ * The per-client session map (`sessions.db`, under the host's plugin data dir).
+ * @internal
+ */
+export declare class SessionMapStore extends SessionMapStore_base {}
 /**
  * A SQLite connection plus the migrator that brings it to the head of a
  * migration set. Returned by {@link makeSqliteStack}.
@@ -2001,7 +2026,9 @@ export type HookPathsError = XdgEnvError | AppDirsError$1 | PlatformError | Proj
  *
  * Precedence: the `CLAUDE_PLUGIN_DATA` env var, then
  * `VITEST_AGENT_SESSION_MAP_DIR`, then `~/.vitest-agent/` (`HOME`, then
- * `USERPROFILE`). The chosen directory is created. Fails with
+ * `USERPROFILE`). The two variables are read through `@effected/engine`'s
+ * `LaunchContext.resolve`: a value is trimmed, and a blank or unsubstituted
+ * `${...}` placeholder value counts as unset. The chosen directory is created. Fails with
  * `ProjectIdentityNotResolvableError` when no home directory is resolvable.
  *
  * @param env - the environment map to consult (the front end passes `process.env`)
@@ -2038,6 +2065,20 @@ export interface SidecarPaths {
   /** Absolute path to the global `registry.db`. */
   readonly registryDbPath: string;
 }
+/**
+ * The per-client session map store (`sessions.db`) at `filename`, migrated,
+ * with the shared per-connection settings applied on open.
+ *
+ * @internal
+ */
+export declare const SessionMapStoreLive: (filename: string) => Layer.Layer<SessionMapStore, import("@effected/store").StoreError | import("@effected/store").StoreMigrationError, never>;
+/**
+ * The global discovery registry store (`registry.db`) at `filename`, migrated,
+ * with the shared per-connection settings applied on open.
+ *
+ * @internal
+ */
+export declare const RegistryStoreLive: (filename: string) => Layer.Layer<RegistryStore, import("@effected/store").StoreError | import("@effected/store").StoreMigrationError, never>;
 /**
  * Build the sidecar Live layer for the supplied SQLite paths.
  *
@@ -2463,15 +2504,6 @@ export interface SessionContext {
   readonly conversationId: string;
   readonly mainAgentId: string;
 }
-/**
- * Parse `export KEY=value` lines from a session-env hook file into a
- * plain record. Non-export lines are ignored.
- *
- * @param content - the raw text of a session-env hook file
- * @returns a record of export names to unquoted values
- * @public
- */
-export declare const parseSessionEnvExports: (content: string) => Record<string, string>;
 /**
  * The synchronous filesystem reads {@link recoverSessionContextFromSessionEnv}
  * performs. Each member throws on a missing or unreadable path, exactly as
@@ -2482,8 +2514,12 @@ export declare const parseSessionEnvExports: (content: string) => Record<string,
 export interface SessionEnvFileSystem {
   /** Entry names directly under `path` (`readdirSync`). */
   readonly readDirectory: (path: string) => ReadonlyArray<string>;
-  /** The UTF-8 text of the file at `path` (`readFileSync(path, "utf8")`). */
-  readonly readFile: (path: string) => string;
+  /**
+   * The raw bytes of the file at `path` (`readFileSync(path)`). Bytes, not
+   * text: bash 3.2's `%q` mixes raw UTF-8 bytes with octal escapes inside
+   * one `$'…'`, which only a byte-level parse reads back as bash does.
+   */
+  readonly readFile: (path: string) => Uint8Array;
   /** Modification time of the file at `path`, in epoch milliseconds (`statSync(path).mtimeMs`). */
   readonly mtimeMs: (path: string) => number;
 }
@@ -2616,10 +2652,21 @@ export declare function assembleManifest(rows: ManifestRow[], dbPath: string): C
  */
 export declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHistoryRecord;
 /**
- * Ensure the SQLite database at `dbPath` is migrated. Runs migrations at
- * most once per dbPath in the current process; concurrent calls share the
- * same in-flight promise. Subsequent calls (after the first resolves) are
- * no-ops.
+ * Ensure the SQLite database at `dbPath` is migrated to the head of the
+ * project migration set.
+ *
+ * Runs through `@effected/store`'s `Store.migrateOnce`: at most one
+ * successful migration run per database per process, shared by every
+ * concurrent caller (and by every copy of the kit loaded in the process).
+ * The run is keyed on the real path of the file's directory, so a relative,
+ * an absolute and a symlinked spelling of one database share it. A failed
+ * run (for example `SQLITE_BUSY`) is not remembered: the next call tries
+ * again. The connection opens with the same per-connection settings as
+ * `makeSqliteStack` (`busy_timeout`, `synchronous = NORMAL`,
+ * `foreign_keys = ON`).
+ *
+ * The parent directory must exist; `dbPath` must name a file (`":memory:"`
+ * is a wiring defect).
  *
  * @param dbPath - the SQLite file to migrate
  * @param logLevel - the diagnostics level for the migrator's records; see `LoggerLive`
@@ -2629,12 +2676,6 @@ export declare function assembleHistoryRecord(rows: HistoryRow[]): AssembledHist
  * @public
  */
 export declare function ensureMigrated(dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string, env?: Readonly<Record<string, string | undefined>>): Promise<void>;
-/**
- * Reset the migration cache. Test-only.
- *
- * @internal
- */
-export declare function _resetMigrationCacheForTesting(): void;
 /** @public */
 export interface FailureSignatureInput {
   readonly error_name: string;
@@ -2647,6 +2688,64 @@ export interface FailureSignatureInput {
 export declare const normalizeAssertionShape: (message: string) => string | null;
 /** @public */
 export declare const computeFailureSignature: (input: FailureSignatureInput) => string;
+/**
+ * Format an unexpected failure for stderr, with the issue URL appended.
+ *
+ * @remarks
+ * Under Effect v4, `Effect.runPromise` / `Effect.runSync` reject with
+ * `Cause.squash` of the failure: the error value itself, with no
+ * FiberFailure wrapper and no `Cause` attached. So a `Cause` is used as it
+ * is (one from `Effect.runPromiseExit` keeps every reason and the span
+ * trail), and anything else is rendered as a defect, `Cause.die(err)`: an
+ * unexpected throw is a bug to report, and a defect is the shape whose
+ * document carries the stack. `@effected/cli`'s `CliFailure.toDoc` keeps
+ * the program's own frames, hides `node_modules` and runtime frames,
+ * follows an `Error.cause` chain, and renders a non-`Error` value as its
+ * text.
+ *
+ * Total: `CliFailure.toDoc` guards the `stack`, `message`, `cause` and
+ * `issue` reads itself, but wrapping a `Proxy` whose traps throw can still
+ * throw, so any throw while formatting falls back to a fixed marker naming
+ * the value's constructor.
+ *
+ * @param err - the thrown value, rejection reason, or `Cause`
+ * @returns the formatted failure followed by the issue-report line
+ * @public
+ */
+export declare const formatFatalError: (err: unknown) => string;
+/**
+ * The host identity a test run records: `host_source` / `host_value` /
+ * `host_metadata` on `test_runs`.
+ *
+ * @public
+ */
+export interface HostMetadataResult {
+  readonly source: string | null;
+  readonly value: string | null;
+  readonly metadata: Record<string, unknown> | null;
+}
+/**
+ * The host identity of an environment record, from `@effected/env`'s
+ * `RuntimeEnv` snapshot (`session`, `ci` / `ciRun`, `termProgram`).
+ *
+ * Priority: the terminal session (`TMUX_PANE`, `WT_SESSION`, `WEZTERM_PANE`,
+ * `KITTY_WINDOW_ID`, `TERM_SESSION_ID`), then the CI job (GitHub Actions run,
+ * Buildkite, CircleCI, GitLab job). The first match is the source; when
+ * nothing matches, all three fields are `null`. Every metadata object
+ * carries `term_program` / `term_program_version` when they are set, then
+ * the source's own keys (`tmux_socket` for a tmux pane, `ci`, `ci_provider`
+ * and `github_run_attempt` for CI), in that key order.
+ *
+ * GNU screen (`STY`) is not a source: the snapshot is taken with `STY`
+ * removed, so a screen session falls through to the next source exactly as
+ * it did before the kit, and no `STY` row is ever written. The
+ * `VSCODE_INJECTION` + parent-pid sources need `process.ppid` and are the
+ * caller's.
+ *
+ * @param env - the environment record to read (the front end passes `process.env`)
+ * @public
+ */
+export declare const probeHostMetadataFromEnv: (env: Readonly<Record<string, string | undefined>>) => HostMetadataResult;
 /**
  * Run `effect` as a nested transaction that keeps the
  * {@link withPersistTransaction} caches honest.
@@ -2733,7 +2832,10 @@ export interface ResolveDataPathOptions {
  *
  * 1. `options.cacheDir` — programmatic override.
  * 2. `cacheDir` from `vitest-agent.config.toml`.
- * 3. `<XDG data>/<normalized projectKey from config>/data.db`.
+ * 3. `<XDG data>/<normalized projectKey from config>/data.db`. A
+ *    `projectKey` that normalizes to `.` or `..` fails with
+ *    `ProjectIdentitySourceError` (source `toml`) rather than writing
+ *    outside the data root.
  * 4. `<XDG data>/<projectKey resolved from cwd's package.json>/data.db`.
  *    Source 4 prefers `repository.url` (canonicalized to `host__path`),
  *    falling back to the normalized `name`. This matches the sidecar
@@ -2752,7 +2854,7 @@ export interface ResolveDataPathOptions {
  * @param options - Optional programmatic overrides.
  * @public
  */
-export declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOptions) => Effect.Effect<string, import("@effected/xdg").AppDirsError | import("effect/PlatformError").PlatformError | import("@effected/config-file").ConfigReadError<import("@effected/config-file").ConfigCodecError>, AppDirs$1 | FileSystem.FileSystem | VitestAgentConfigFile>;
+export declare const resolveDataPath: (projectDir: string, options?: ResolveDataPathOptions) => Effect.Effect<string, import("@effected/xdg").AppDirsError | import("effect/PlatformError").PlatformError | ProjectIdentitySourceError | import("@effected/config-file").ConfigReadError<import("@effected/config-file").ConfigCodecError>, AppDirs$1 | FileSystem.FileSystem | VitestAgentConfigFile>;
 /**
  * Compute the project key for a workspace by reading `package.json`
  * fields directly. Returns the canonical `host__path` form when a git
@@ -2771,7 +2873,8 @@ export declare const resolveProjectKeyFromCwd: (cwd: string) => string;
 /**
  * {@link resolveProjectKeyFromCwd} read through the ambient
  * `FileSystem` service instead of `node:fs` — same upward walk to the
- * nearest `package.json`, same precedence, same basename fallback.
+ * nearest `package.json` (`@effected/walker`'s `Walker.ascend` +
+ * `Walker.findUpward`), same precedence, same basename fallback.
  *
  * Never fails: a filesystem error while probing or reading is treated like
  * a missing or malformed `package.json`, exactly as the synchronous form
@@ -2786,7 +2889,8 @@ export declare const resolveProjectKeyFromCwdEffect: (cwd: string) => Effect.Eff
  * `projectDir`.
  *
  * The key is the root `package.json`'s `name`, normalized via
- * `normalizeWorkspaceKey`. This becomes the directory segment under
+ * `@effected/xdg`'s `AppDirs.segment` (a name that maps to `.` or `..` fails
+ * with `AppDirsSegmentError`). This becomes the directory segment under
  * `$XDG_DATA_HOME/vitest-agent/` where the SQLite database lives.
  *
  * Fails with `WorkspaceRootNotFoundError` when no root workspace is
@@ -2806,7 +2910,7 @@ export declare const resolveProjectKeyFromCwdEffect: (cwd: string) => Effect.Eff
  *   reporter's resolved `projectDir` (CLAUDE_PROJECT_DIR or process.cwd()).
  * @public
  */
-export declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string, WorkspaceRootNotFoundError | WorkspaceDiscoveryFailure, WorkspaceDiscovery>;
+export declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<string, WorkspaceRootNotFoundError | WorkspaceDiscoveryFailure | AppDirsSegmentError, WorkspaceDiscovery>;
 /** Build-time injected package version (see architecture.md D36). @public */
 export declare const CURRENT_ENGINE_VERSION: string;
 export { type AppDirs, type AppDirsError, type ArtifactKind, type ArtifactSuite, type FormatTriageOptions, type FormatWrapupOptions, type MigrationRecord, type Phase, type WrapupKind, migration as migration0001, migration$1 as migration0002, migration$2 as registryMigration0001, migration$3 as sessionMapMigration0001 };

package/index.js

@@ -28,6 +28,7 @@ import { ProjectDiscoveryTest } from "./layers/ProjectDiscoveryTest.js";
 import { ProjectIdentity, resolveProjectIdentityFromCandidates } from "./services/ProjectIdentity.js";
 import { ProjectIdentityLive, ProjectIdentityTest } from "./layers/ProjectIdentityLive.js";
 import { AgentContext, RunContext, RunContext$, RunContextService } from "./services/RunContext.js";
+import { probeHostMetadataFromEnv } from "./utils/host-metadata.js";
 import { RunContextLive, RunContextTest } from "./layers/RunContextLive.js";
 import { formatStrayOutputLine, formatTriageEffect } from "./lib/format-triage.js";
 import { formatWrapupEffect } from "./lib/format-wrapup.js";
@@ -36,10 +37,11 @@ import migration$1 from "./migrations/0002_test_artifacts.js";
 import { PROJECT_MIGRATIONS } from "./migrations/index.js";
 import migration$2 from "./migrations/registry_0001_initial.js";
 import migration$3 from "./migrations/session_map_0001_initial.js";
+import { RegistryStore, SessionMapStore } from "./stores.js";
 import { NodePlatformLayer, PlatformLive, makeSqliteStack } from "./platform.js";
 import { endAgentEffect } from "./programs/end-agent.js";
 import { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, REGISTRY_STORE_OPTIONS, SESSIONS_DB_FILENAME, resolveHookPaths, resolveSessionMapPath } from "./programs/hook-paths.js";
-import { SidecarPlatformLive } from "./programs/platform-sidecar.js";
+import { RegistryStoreLive, SessionMapStoreLive, SidecarPlatformLive } from "./programs/platform-sidecar.js";
 import { recordSessionEnd, recordSessionStart } from "./programs/record-session.js";
 import { resolveSessionForRecording } from "./programs/resolve-session-for-recording.js";
 import { dispatchRecordTddArtifactEffect, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect } from "./programs/record-tdd-artifact.js";
@@ -47,14 +49,15 @@ import { parseAndValidateTurnPayload, recordTurnEffect } from "./programs/record
 import { recordRunWorkspaceChangesEffect } from "./programs/record-workspace-changes.js";
 import { IDEMPOTENCY_ROOT_SENTINEL, deriveIdempotencyKey } from "./services/idempotency.js";
 import { registerAgentEffect } from "./programs/register-agent.js";
-import { parseSessionEnvExports, recoverSessionContextFromSessionEnv } from "./programs/session-env.js";
+import { recoverSessionContextFromSessionEnv } from "./programs/session-env.js";
 import { resolveProjectDir } from "./project-dir.js";
 import { assembleHistoryRecord, assembleManifest } from "./sql/assemblers.js";
-import { _resetMigrationCacheForTesting, ensureMigrated } from "./utils/ensure-migrated.js";
+import { ensureMigrated } from "./utils/ensure-migrated.js";
 import { computeFailureSignature, normalizeAssertionShape } from "./utils/failure-signature.js";
+import { formatFatalError } from "./utils/format-fatal-error.js";
 import { resolveProjectKeyFromCwd, resolveProjectKeyFromCwdEffect } from "./utils/resolve-project-key-from-cwd.js";
 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, 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 };
+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, RegistryStore, RegistryStoreLive, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, SESSIONS_DB_FILENAME, SessionMapStore, SessionMapStoreLive, SidecarPlatformLive, VitestAgentConfigFile, assembleHistoryRecord, assembleManifest, classifyEnvironment, computeFailureSignature, deriveIdempotencyKey, dispatchRecordTddArtifactEffect, endAgentEffect, ensureMigrated, formatFatalError, formatStrayOutputLine, formatTriageEffect, formatWrapupEffect, historyKey, makeSqliteStack, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, parseAndValidateTurnPayload, probeHostMetadataFromEnv, 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/ConfigLive.js

@@ -1,29 +1,55 @@
 import { VitestAgentConfigFile } from "../services/Config.js";
 import { ConfigFile, ConfigResolver, MergeStrategy } from "@effected/config-file";
 import { TomlCodec } from "@effected/config-file/toml";
+import { Git } from "@effected/git";
 import { VitestAgentConfig } from "@vitest-agent/sdk";
+import { Effect, Layer, Option } from "effect";
+import { ChildProcessSpawner } from "effect/process";
 
 // src/layers/ConfigLive.ts
 const CONFIG_FILENAME = "vitest-agent.config.toml";
 /**
+* The repository root git answers for `projectDir`, used as the upward
+* walk's ceiling: the `Git` service when one is in context, else `Git.layer`
+* over a `ChildProcessSpawner` when one is (every front end provides
+* `NodeServices.layer`), else no answer. Neither is a requirement: outside
+* a repository, with no `git` on `PATH`, or with no spawner at all, the walk
+* runs to the filesystem root as it always did.
+*/
+const repoRootCeiling = (projectDir) => Effect.gen(function* () {
+	const ask = (git) => git.repoRoot(projectDir).pipe(Effect.orElseSucceed(() => void 0));
+	const git = yield* Effect.serviceOption(Git);
+	if (Option.isSome(git)) return yield* ask(git.value);
+	const spawner = yield* Effect.serviceOption(ChildProcessSpawner.ChildProcessSpawner);
+	if (Option.isNone(spawner)) return void 0;
+	return yield* Effect.flatMap(Git, ask).pipe(Effect.provide(Git.layer), Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner.value));
+});
+/**
 * Build the live `ConfigFile` layer for a given project directory.
 *
 * Resolves the optional `vitest-agent.config.toml` from (in order):
 *
 * 1. The workspace root (when `projectDir` is inside a pnpm/npm/yarn workspace).
 * 2. The git repository root (when `projectDir` is inside a git repo).
-* 3. Walking upward from `projectDir`.
+* 3. Walking upward from `projectDir`, stopping at the git repository root
+*    (inclusive, compared physically) so a config file above the repository
+*    is never picked up. Outside a repository the walk runs to the
+*    filesystem root.
 *
 * The first found file wins (`MergeStrategy.firstMatch()`). If no file is
 * present, downstream callers use `loadOrDefault(new VitestAgentConfig({}))`
 * to get an empty config.
 *
+* The repository root comes from `git rev-parse --show-toplevel` through
+* `@effected/git`, using a `Git` or `ChildProcessSpawner` service if the
+* context has one; neither is required (see `repoRootCeiling`).
+*
 * @param projectDir - Absolute path inside the user's workspace. Resolvers
 *   anchor here rather than `process.cwd()` so the plugin-spawned MCP server
 *   sees the right config even when invoked from elsewhere.
 * @public
 */
-const ConfigLive = (projectDir) => ConfigFile.layer(VitestAgentConfigFile, {
+const ConfigLive = (projectDir) => Layer.unwrap(Effect.map(repoRootCeiling(projectDir), (ceiling) => ConfigFile.layer(VitestAgentConfigFile, {
 	schema: VitestAgentConfig,
 	codec: TomlCodec,
 	strategy: MergeStrategy.firstMatch(),
@@ -38,9 +64,10 @@ const ConfigLive = (projectDir) => ConfigFile.layer(VitestAgentConfigFile, {
 		}),
 		ConfigResolver.upwardWalk({
 			filename: CONFIG_FILENAME,
-			cwd: projectDir
+			cwd: projectDir,
+			...ceiling !== void 0 && { ceiling }
 		})
 	]
-});
+})));
 
 export { ConfigLive };

package/layers/DataStoreLive.js

@@ -72,7 +72,8 @@ const DataStoreLive = Layer.effect(DataStore, Effect.gen(function* () {
 	const writeSettings = (hash, settings, envVars) => Effect.gen(function* () {
 		yield* Effect.logDebug("writeSettings").pipe(Effect.annotateLogs({ hash }));
 		yield* sql`INSERT OR IGNORE INTO settings (hash, vitest_version, pool, environment, test_timeout, hook_timeout, slow_test_threshold, max_concurrency, max_workers, isolate, bail, globals, file_parallelism, sequence_seed, coverage_provider) VALUES (${hash}, ${settings.vitestVersion}, ${settings.pool ?? null}, ${settings.environment ?? null}, ${settings.testTimeout ?? null}, ${settings.hookTimeout ?? null}, ${settings.slowTestThreshold ?? null}, ${settings.maxConcurrency ?? null}, ${settings.maxWorkers ?? null}, ${boolToInt(settings.isolate)}, ${settings.bail ?? null}, ${boolToInt(settings.globals)}, ${boolToInt(settings.fileParallelism)}, ${settings.sequenceSeed ?? null}, ${settings.coverageProvider ?? null})`;
-		for (const [key, value] of Object.entries(envVars)) yield* sql`INSERT OR IGNORE INTO settings_env_vars (settings_hash, key, value) VALUES (${hash}, ${key}, ${value})`;
+		yield* sql`DELETE FROM settings_env_vars WHERE settings_hash = ${hash}`;
+		for (const [key, value] of Object.entries(envVars)) yield* sql`INSERT INTO settings_env_vars (settings_hash, key, value) VALUES (${hash}, ${key}, ${value})`;
 	}).pipe(Effect.annotateLogs("service", "DataStore"), Effect.mapError((e) => new DataStoreError({
 		operation: "write",
 		table: "settings",

package/layers/EnvironmentDetectorLive.js

@@ -3,11 +3,8 @@ import { Effect, Layer, Option } from "effect";
 import { Audience, CurrentRuntimeEnv } from "@effected/env";
 
 // src/layers/EnvironmentDetectorLive.ts
-/** The engine environment for each CI `@effected/env` names; exhaustive over `CiName`. */
-const CI_ENVIRONMENT = {
-	"github-actions": "ci-github",
-	generic: "ci-generic"
-};
+/** The engine environment for a CI `@effected/env` names: GitHub Actions gets its own, every other provider is generic. */
+const ciEnvironment = (ci) => ci === "github-actions" ? "ci-github" : "ci-generic";
 /**
 * Pure classification behind {@link EnvironmentDetectorLive}: an agent shell
 * wins, then GitHub Actions, then generic CI, else a terminal.
@@ -25,7 +22,7 @@ const classifyEnvironment = (runtime) => {
 		case "agent": return "agent-shell";
 		case "ci": return Option.match(runtime.ci, {
 			onNone: () => "ci-generic",
-			onSome: (ci) => CI_ENVIRONMENT[ci]
+			onSome: ciEnvironment
 		});
 		case "human": return "terminal";
 	}

package/layers/LoggerLive.js

@@ -1,4 +1,4 @@
-import { Layer, LogLevel, Logger } from "effect";
+import { Layer, Logger, Option } from "effect";
 import { CurrentRuntimeEnv } from "@effected/env";
 import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
 import * as NodePath from "@effect/platform-node/NodePath";
@@ -44,21 +44,14 @@ const LoggerLive = (level, logFile, env) => {
 	}).pipe(Layer.provide(Layer.merge(NodeFileSystem.layer, NodePath.layer)));
 	return env === void 0 ? sink : sink.pipe(Layer.provide(CurrentRuntimeEnv.layerFrom(env)));
 };
-const LEVEL_ALIASES = {
-	warn: "Warn",
-	warning: "Warn",
-	error: "Error",
-	info: "Info",
-	debug: "Debug",
-	trace: "Trace",
-	fatal: "Fatal",
-	all: "All",
-	none: "None"
-};
 /**
 * Resolve log level from option or environment variable.
 * Priority: explicit option \> `VITEST_REPORTER_LOG_LEVEL` in `env` \> undefined.
 *
+* Case-insensitive; `warning` is accepted for `Warn`. An unset or empty value,
+* or one that names no level, resolves to `undefined` (no diagnostics) without
+* a warning.
+*
 * @param env - the environment map to consult (the front end passes `process.env`)
 * @param option - explicit override
 * @public
@@ -66,8 +59,7 @@ const LEVEL_ALIASES = {
 function resolveLogLevel(env, option) {
 	const raw = option ?? env.VITEST_REPORTER_LOG_LEVEL;
 	if (!raw) return void 0;
-	const normalized = LEVEL_ALIASES[raw.toLowerCase()] ?? `${raw.charAt(0).toUpperCase()}${raw.slice(1).toLowerCase()}`;
-	return LogLevel.values.includes(normalized) ? normalized : void 0;
+	return Option.getOrUndefined(CliLog.parseLevel(raw));
 }
 /**
 * Resolve log file from option or environment variable

package/layers/ProjectDiscoveryLive.js

@@ -1,36 +1,38 @@
 import { ProjectDiscovery } from "../services/ProjectDiscovery.js";
 import { DiscoveryError, NON_DISCOVERABLE_DIRS } from "@vitest-agent/sdk";
-import { Effect, FileSystem, Layer } from "effect";
+import { Effect, FileSystem, Layer, Path } from "effect";
+import { GlobPattern, GlobPatternOptions } from "@effected/glob";
+import { descend } from "@effected/walker";
 
 // src/layers/ProjectDiscoveryLive.ts
-const TEST_FILE_PATTERN = /\.(test|spec)\.(ts|tsx)$/;
-const SKIP_DIRS = /* @__PURE__ */ new Set([
+const SKIP_DIRS = [
 	...NON_DISCOVERABLE_DIRS,
 	"coverage",
 	".turbo",
 	".vite"
-]);
-function isTestFile(filePath) {
-	return TEST_FILE_PATTERN.test(filePath);
-}
+];
+const TEST_FILE_GLOB = "**/*.{test,spec}.{ts,tsx}";
+const TEST_FILE_GLOB_OPTIONS = GlobPatternOptions.make({ dot: true });
 function testFileToSource(testFile) {
 	return testFile.replace(/\.(test|spec)\.(ts|tsx)$/, ".$2");
 }
-function walkDir(fs, dir) {
-	return Effect.gen(function* () {
-		const entries = yield* fs.readDirectory(dir);
-		const results = [];
-		for (const entry of entries) {
-			if (SKIP_DIRS.has(entry)) continue;
-			const fullPath = `${dir}/${entry}`;
-			if ((yield* fs.stat(fullPath)).type === "Directory") {
-				const subFiles = yield* walkDir(fs, fullPath);
-				results.push(...subFiles);
-			} else results.push(fullPath);
-		}
-		return results;
+/**
+* Every test file under `rootDir`, as `${rootDir}/<relative>` paths sorted by
+* relative path. `@effected/walker`'s `descend` follows directory symlinks
+* (as the former `fs.stat`-based walk did) under its ancestor-chain cycle
+* guard, so a link back to an ancestor is skipped instead of recursing until
+* the OS answers `ELOOP` and failing the whole discovery.
+*/
+const walkTestFiles = (rootDir) => Effect.gen(function* () {
+	const pattern = yield* GlobPattern.compile(TEST_FILE_GLOB, TEST_FILE_GLOB_OPTIONS);
+	const relative = yield* descend(pattern, {
+		cwd: rootDir,
+		prune: SKIP_DIRS,
+		followSymlinks: true
 	});
-}
+	const base = rootDir.endsWith("/") ? rootDir.slice(0, -1) : rootDir;
+	return relative.map((rel) => `${base}/${rel}`);
+}).pipe(Effect.provide(Path.layer));
 /** @public */
 const ProjectDiscoveryLive = Layer.effect(ProjectDiscovery, Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
@@ -44,11 +46,11 @@ const ProjectDiscoveryLive = Layer.effect(ProjectDiscovery, Effect.gen(function*
 	})));
 	return {
 		discoverTestFiles: (rootDir) => Effect.gen(function* () {
-			const testFiles = (yield* walkDir(fs, rootDir).pipe(Effect.mapError((error) => new DiscoveryError({
+			const testFiles = yield* walkTestFiles(rootDir).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.mapError((error) => new DiscoveryError({
 				operation: "glob",
 				path: rootDir,
 				reason: String(error)
-			})))).filter(isTestFile);
+			})));
 			const entries = [];
 			for (const testFile of testFiles) {
 				const sourceFiles = yield* mapTestToSource(testFile);