@vitest-agent/engine 0.5.0 → 0.6.0

package/index.d.ts

@@ -8,7 +8,7 @@ import { AppDirs, AppDirsError, XdgEnvError } from "@effected/xdg";
 import { ChildProcessSpawner } from "effect/process";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { SqliteClient } from "@effect/sql-sqlite-node/SqliteClient";
-import { MigrationError } from "effect/sql/Migrator";
+import { StoreError, StoreMigrationError } from "@effected/store";
 import { SqlError } from "effect/sql/SqlError";
 import { PlatformError } from "effect/PlatformError";
 //#region src/services/Config.d.ts
@@ -1765,8 +1765,9 @@ declare const migration$1: Effect.Effect<void, import("effect/sql/SqlError").Sql
  *
  * This is the single source of truth for the project database's migration
  * set: `makeSqliteStack` (and through it `PlatformLive`, `ensureMigrated`,
- * the testing layers, `ReporterLive` and `SidecarLive`) defaults to it when
- * calling `SqliteMigrator.fromRecord`, so adding a migration file and
+ * the testing layers, `ReporterLive` and `SidecarLive`) defaults to it and
+ * runs it through `@effected/store` (keys parsed as effect/sql's
+ * `fromRecord` parses them, so 2.x ledgers adopt), so adding a migration file and
  * registering it here is enough to reach every process that opens a project
  * database.
  *
@@ -1801,13 +1802,16 @@ declare const migration$2: Effect.Effect<void, import("effect/sql/SqlError").Sql
 /** @internal */
 declare const migration$3: Effect.Effect<void, import("effect/sql/SqlError").SqlError, SqlClient>;
 //#endregion
-//#region src/platform.d.ts
+//#region src/stores.d.ts
 /**
- * A migration set in the shape `SqliteMigrator.fromRecord` accepts: migration
- * id → loader.
+ * A migration set in the effect/sql record shape: `"<id>_<name>"` →
+ * migration. The keys are the ones a 2.x `SqliteMigrator.fromRecord` recorded
+ * in `effect_sql_migrations`, which is what ledger adoption matches against.
  * @public
  */
-export type MigrationRecord = Record<string, Effect.Effect<void, unknown, SqlClient>>;
+type MigrationRecord = Record<string, Effect.Effect<void, SqlError, SqlClient>>;
+//#endregion
+//#region src/platform.d.ts
 /**
  * A SQLite connection plus the migrator that brings it to the head of a
  * migration set. Returned by {@link makeSqliteStack}.
@@ -1818,10 +1822,13 @@ export interface SqliteStack {
   readonly SqliteLayer: Layer.Layer<SqliteClient | SqlClient>;
   /**
    * `Layer.effectDiscard`-shaped: provides nothing, runs the migrations as a
-   * side effect of layer acquisition. Already fed its `SqlClient` and the
-   * Node platform services.
+   * side effect of layer acquisition. Already fed its `SqlClient`. Backed by
+   * `@effected/store`'s `Store.layer` with the engine's ledger options
+   * (adopt and mirror effect/sql's ledger), so a database a 2.x
+   * `SqliteMigrator` migrated keeps its history and a 2.x install can still
+   * open it.
    */
-  readonly MigratorLayer: Layer.Layer<never, MigrationError | SqlError>;
+  readonly MigratorLayer: Layer.Layer<never, PlatformLiveError>;
 }
 /**
  * The Node platform services every SQLite stack and every Live layer share.
@@ -1842,6 +1849,12 @@ export declare const NodePlatformLayer: Layer.Layer<NodeServices.NodeServices, n
  * @public
  */
 export declare const makeSqliteStack: (filename: string, migrations?: MigrationRecord) => SqliteStack;
+/**
+ * What building a SQLite stack, and so `PlatformLive`, can fail with:
+ * `@effected/store`'s setup / ledger-adoption failure or a failing migration.
+ * @public
+ */
+export type PlatformLiveError = StoreError | StoreMigrationError;
 /**
  * Options for {@link PlatformLive}.
  * @public
@@ -1883,7 +1896,7 @@ export type PlatformServices = DataReader | DataStore | ProjectDiscovery | Histo
  * @param options - database path, env map and optional logging overrides
  * @public
  */
-export declare const PlatformLive: (options: PlatformOptions) => Layer.Layer<PlatformServices, MigrationError | SqlError>;
+export declare const PlatformLive: (options: PlatformOptions) => Layer.Layer<PlatformServices, PlatformLiveError>;
 //#endregion
 //#region src/programs/end-agent.d.ts
 /**
@@ -1930,6 +1943,20 @@ export declare const SESSIONS_DB_FILENAME = "sessions.db";
  * @public
  */
 export declare const REGISTRY_DB_FILENAME = "registry.db";
+/**
+ * The global discovery registry's store options: `registry.db` at the app's
+ * XDG data root. `resolveHookPaths` resolves `registryDbPath` from them with
+ * `AppStore.location`; `SidecarPlatformLive` opens that path with their
+ * migrations.
+ *
+ * @internal
+ */
+export declare const REGISTRY_STORE_OPTIONS: {
+  readonly adoptMigratorLedger: true;
+  readonly filename: "registry.db";
+  readonly directory: "data";
+  readonly migrations: readonly import("@effected/store").StoreMigration[];
+};
 /**
  * The environment map every hook-path resolver reads from. The front end
  * passes `process.env`; the engine never reads `process` itself.
@@ -2011,17 +2038,17 @@ export interface SidecarPaths {
 /**
  * Build the sidecar Live layer for the supplied SQLite paths.
  *
- * Each store gets its own `SqlClient` connection (separate scopes,
- * independent migrators, all built through the engine's shared
- * `makeSqliteStack`) so concurrent operations on the three stores
- * don't share lock state.
+ * Each store gets its own `SqlClient` connection and its own migration
+ * ledger (`makeSqliteStack` for `data.db`, `Store.layerSqliteAs` for the
+ * session map and the registry), so concurrent operations on the three
+ * stores don't share lock state. Every path in `paths` is opened as given.
  *
  * @param paths - the three SQLite database paths to open
  * @param env - the environment map `RunContextLive` probes for host
  *   metadata (the bin passes `process.env`)
  * @public
  */
-export declare const SidecarPlatformLive: (paths: SidecarPaths, env: Record<string, string | undefined>) => Layer.Layer<DataReader | DataStore | DiscoveryRegistry | PerClientSessionMapReader | PerClientSessionMapWriter | RunContext$ | import("@effect/platform-node/NodeServices").NodeServices, import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare const SidecarPlatformLive: (paths: SidecarPaths, env: Record<string, string | undefined>) => Layer.Layer<DataReader | DataStore | DiscoveryRegistry | PerClientSessionMapReader | PerClientSessionMapWriter | RunContext$ | import("@effect/platform-node/NodeServices").NodeServices, PlatformLiveError, never>;
 //#endregion
 //#region src/programs/record-session.d.ts
 /**
@@ -2756,5 +2783,5 @@ export declare const resolveWorkspaceKey: (projectDir: string) => Effect.Effect<
 /** Build-time injected package version (see architecture.md D36). @public */
 export declare const CURRENT_ENGINE_VERSION: string;
 //#endregion
-export { type ArtifactKind, type ArtifactSuite, type FormatTriageOptions, type FormatWrapupOptions, type Phase, type WrapupKind, migration as migration0001, migration$1 as migration0002, migration$2 as registryMigration0001, migration$3 as sessionMapMigration0001 };
+export { 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 };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -39,7 +39,7 @@ import migration$2 from "./migrations/registry_0001_initial.js";
 import migration$3 from "./migrations/session_map_0001_initial.js";
 import { NodePlatformLayer, PlatformLive, makeSqliteStack } from "./platform.js";
 import { endAgentEffect } from "./programs/end-agent.js";
-import { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, SESSIONS_DB_FILENAME, resolveHookPaths, resolveSessionMapPath } from "./programs/hook-paths.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 { recordSessionEnd, recordSessionStart } from "./programs/record-session.js";
 import { resolveSessionForRecording } from "./programs/resolve-session-for-recording.js";
@@ -58,4 +58,4 @@ import { DATABASE_FILENAME, resolveDataPath } from "./utils/resolve-data-path.js
 import { resolveWorkspaceKey } from "./utils/resolve-workspace-key.js";
 import { CURRENT_ENGINE_VERSION } from "./version.js";
 
-export { APP_NAMESPACE, AgentContext, CURRENT_ENGINE_VERSION, ConfigLive, DATABASE_FILENAME, DATA_DB_FILENAME, DATA_FALLBACK_DIR, DataReader, DataReaderLive, DataStore, DataStoreLive, DetailResolver, DetailResolverLive, DiscoveryRegistry, DiscoveryRegistryLive, EnvironmentDetector, EnvironmentDetectorLive, EnvironmentDetectorTest, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, 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, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, SESSIONS_DB_FILENAME, SidecarPlatformLive, VitestAgentConfigFile, _resetMigrationCacheForTesting, assembleHistoryRecord, assembleManifest, classifyEnvironment, computeFailureSignature, deriveIdempotencyKey, dispatchRecordTddArtifactEffect, endAgentEffect, ensureMigrated, formatTriageEffect, formatWrapupEffect, historyKey, makeSqliteStack, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, parseAndValidateTurnPayload, parseSessionEnvExports, recordRunWorkspaceChangesEffect, recordSessionEnd, recordSessionStart, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect, recordTurnEffect, recoverSessionContextFromSessionEnv, registerAgentEffect, migration$2 as registryMigration0001, resolveDataPath, resolveHookPaths, resolveLogFile, resolveLogLevel, resolveProjectDir, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveProjectKeyFromCwdEffect, resolveSessionForRecording, resolveSessionMapPath, resolveWorkspaceKey, migration$3 as sessionMapMigration0001 };
+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, FormatSelector, FormatSelectorLive, HistoryTracker, HistoryTrackerLive, HistoryTrackerTest, IDEMPOTENCY_ROOT_SENTINEL, INLINE_ATTACHMENT_BODY_CAP_BYTES, LoggerLive, NodePlatformLayer, OutputPipelineLive, PROJECT_MIGRATIONS, PathResolutionLive, PerClientSessionMapReader, PerClientSessionMapReaderLive, PerClientSessionMapWriter, PerClientSessionMapWriterLive, PlatformLive, ProjectDiscovery, ProjectDiscoveryLive, ProjectDiscoveryTest, ProjectIdentity, ProjectIdentityLive, ProjectIdentityTest, REGISTRY_DB_FILENAME, REGISTRY_STORE_OPTIONS, RunContext, RunContext$, RunContextLive, RunContextService, RunContextTest, SESSIONS_DB_FILENAME, SidecarPlatformLive, VitestAgentConfigFile, _resetMigrationCacheForTesting, assembleHistoryRecord, assembleManifest, classifyEnvironment, computeFailureSignature, deriveIdempotencyKey, dispatchRecordTddArtifactEffect, endAgentEffect, ensureMigrated, formatTriageEffect, formatWrapupEffect, historyKey, makeSqliteStack, migration as migration0001, migration$1 as migration0002, normalizeAssertionShape, parseAndValidateTurnPayload, parseSessionEnvExports, recordRunWorkspaceChangesEffect, recordSessionEnd, recordSessionStart, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect, recordTurnEffect, recoverSessionContextFromSessionEnv, registerAgentEffect, migration$2 as registryMigration0001, resolveDataPath, resolveHookPaths, resolveLogFile, resolveLogLevel, resolveProjectDir, resolveProjectIdentityFromCandidates, resolveProjectKeyFromCwd, resolveProjectKeyFromCwdEffect, resolveSessionForRecording, resolveSessionMapPath, resolveWorkspaceKey, migration$3 as sessionMapMigration0001 };

package/migrations/index.js

@@ -8,8 +8,9 @@ import migration$1 from "./0002_test_artifacts.js";
 *
 * This is the single source of truth for the project database's migration
 * set: `makeSqliteStack` (and through it `PlatformLive`, `ensureMigrated`,
-* the testing layers, `ReporterLive` and `SidecarLive`) defaults to it when
-* calling `SqliteMigrator.fromRecord`, so adding a migration file and
+* the testing layers, `ReporterLive` and `SidecarLive`) defaults to it and
+* runs it through `@effected/store` (keys parsed as effect/sql's
+* `fromRecord` parses them, so 2.x ledgers adopt), so adding a migration file and
 * registering it here is enough to reach every process that opens a project
 * database.
 *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/engine",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"private": false,
 	"description": "Shared services, layers, SQLite data layer, migrations and platform resolution for the vitest-agent CLI and MCP server.",
 	"keywords": [
@@ -42,12 +42,14 @@
 	"dependencies": {
 		"@effect/platform-node": "^4.0.0",
 		"@effect/sql-sqlite-node": "^4.0.0",
-		"@effected/cli": "^0.11.0",
-		"@effected/config-file": "^0.14.0",
+		"@effected/app": "^0.21.1",
+		"@effected/cli": "^0.12.0",
+		"@effected/config-file": "^0.14.2",
 		"@effected/engine": "^0.3.0",
 		"@effected/env": "^0.1.0",
 		"@effected/glob": "^0.10.0",
 		"@effected/jsonc": "^0.15.0",
+		"@effected/store": "^0.13.0",
 		"@effected/toml": "^0.11.0",
 		"@effected/walker": "^0.15.0",
 		"@effected/workspaces": "^0.31.0",

package/platform.js

@@ -5,10 +5,11 @@ import { LoggerLive } from "./layers/LoggerLive.js";
 import { OutputPipelineLive } from "./layers/OutputPipelineLive.js";
 import { ProjectDiscoveryLive } from "./layers/ProjectDiscoveryLive.js";
 import { PROJECT_MIGRATIONS } from "./migrations/index.js";
-import { Layer } from "effect";
+import { LEDGER_OPTIONS, toStoreMigrations } from "./stores.js";
+import { Effect, Layer } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { layer } from "@effect/sql-sqlite-node/SqliteClient";
-import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
+import { Store } from "@effected/store";
 
 //#region src/platform.ts
 /**
@@ -33,7 +34,10 @@ const makeSqliteStack = (filename, migrations = PROJECT_MIGRATIONS) => {
 	const SqliteLayer = layer({ filename });
 	return {
 		SqliteLayer,
-		MigratorLayer: SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord(migrations) }).pipe(Layer.provide(Layer.merge(SqliteLayer, NodePlatformLayer)))
+		MigratorLayer: Layer.effectDiscard(Effect.void).pipe(Layer.provide(Store.layer({
+			migrations: toStoreMigrations(migrations),
+			...LEDGER_OPTIONS
+		}).pipe(Layer.provide(SqliteLayer))))
 	};
 };
 /**

package/programs/hook-paths.js

@@ -1,7 +1,10 @@
 import { APP_NAMESPACE, DATA_FALLBACK_DIR } from "../layers/PathResolutionLive.js";
+import migration from "../migrations/registry_0001_initial.js";
+import { LEDGER_OPTIONS, toStoreMigrations } from "../stores.js";
 import { ProjectIdentityNotResolvableError } from "@vitest-agent/sdk";
 import { ConfigProvider, Effect, FileSystem, Layer, Path } from "effect";
 import { AppDirs, Xdg } from "@effected/xdg";
+import { AppStore } from "@effected/app";
 
 //#region src/programs/hook-paths.ts
 /**
@@ -22,6 +25,20 @@ const SESSIONS_DB_FILENAME = "sessions.db";
 * @public
 */
 const REGISTRY_DB_FILENAME = "registry.db";
+/**
+* The global discovery registry's store options: `registry.db` at the app's
+* XDG data root. `resolveHookPaths` resolves `registryDbPath` from them with
+* `AppStore.location`; `SidecarPlatformLive` opens that path with their
+* migrations.
+*
+* @internal
+*/
+const REGISTRY_STORE_OPTIONS = {
+	filename: REGISTRY_DB_FILENAME,
+	directory: "data",
+	migrations: toStoreMigrations({ "0001_initial": migration }),
+	...LEDGER_OPTIONS
+};
 /** Directory under the home dir that holds the per-client `sessions.db` fallback. */
 const SESSION_MAP_HOME_DIR = `.${APP_NAMESPACE}`;
 const nonEmpty = (value) => value !== void 0 && value.length > 0 ? value : void 0;
@@ -32,6 +49,7 @@ const nonEmpty = (value) => value !== void 0 && value.length > 0 ? value : void
 * `ConfigProvider`, so the env map is installed as that provider — no
 * `process.env` read. `USERPROFILE` stands in for `HOME` when the latter is
 * unset (Windows), matching the session-map fallback order below.
+*
 */
 const hookAppDirs = (env) => {
 	const home = nonEmpty(env.HOME) ?? nonEmpty(env.USERPROFILE);
@@ -100,10 +118,10 @@ const resolveHookPaths = (input) => Effect.gen(function* () {
 		dataRoot,
 		projectDataDir,
 		perProjectDbPath: path.join(projectDataDir, DATA_DB_FILENAME),
-		registryDbPath: path.join(dataRoot, REGISTRY_DB_FILENAME),
+		registryDbPath: yield* AppStore.location(REGISTRY_STORE_OPTIONS),
 		sessionMapDbPath
 	};
 }).pipe(Effect.provide(hookAppDirs(input.env)));
 
 //#endregion
-export { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, SESSIONS_DB_FILENAME, resolveHookPaths, resolveSessionMapPath };
+export { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, REGISTRY_STORE_OPTIONS, SESSIONS_DB_FILENAME, resolveHookPaths, resolveSessionMapPath };

package/programs/platform-sidecar.js

@@ -4,19 +4,21 @@ import { DiscoveryRegistryLive } from "../layers/DiscoveryRegistryLive.js";
 import { LoggerLive } from "../layers/LoggerLive.js";
 import { PerClientSessionMapWriterLive } from "../layers/PerClientSessionMapLive.js";
 import { RunContextLive } from "../layers/RunContextLive.js";
-import migration from "../migrations/registry_0001_initial.js";
-import migration$1 from "../migrations/session_map_0001_initial.js";
+import migration from "../migrations/session_map_0001_initial.js";
+import { LEDGER_OPTIONS, RegistryStore, SessionMapStore, toStoreMigrations } from "../stores.js";
 import { NodePlatformLayer, makeSqliteStack } from "../platform.js";
+import { REGISTRY_STORE_OPTIONS } from "./hook-paths.js";
 import { Layer } from "effect";
+import { Store } from "@effected/store";
 
 //#region src/programs/platform-sidecar.ts
 /**
 * Build the sidecar Live layer for the supplied SQLite paths.
 *
-* Each store gets its own `SqlClient` connection (separate scopes,
-* independent migrators, all built through the engine's shared
-* `makeSqliteStack`) so concurrent operations on the three stores
-* don't share lock state.
+* Each store gets its own `SqlClient` connection and its own migration
+* ledger (`makeSqliteStack` for `data.db`, `Store.layerSqliteAs` for the
+* session map and the registry), so concurrent operations on the three
+* stores don't share lock state. Every path in `paths` is opened as given.
 *
 * @param paths - the three SQLite database paths to open
 * @param env - the environment map `RunContextLive` probes for host
@@ -26,10 +28,16 @@ import { Layer } from "effect";
 const SidecarPlatformLive = (paths, env) => {
 	const project = makeSqliteStack(paths.perProjectDbPath);
 	const ProjectStoreLayer = Layer.mergeAll(DataStoreLive.pipe(Layer.provide(project.SqliteLayer)), DataReaderLive.pipe(Layer.provide(project.SqliteLayer)), project.MigratorLayer);
-	const sessionMap = makeSqliteStack(paths.sessionMapDbPath, { "0001_initial": migration$1 });
-	const SessionMapLayer = Layer.mergeAll(PerClientSessionMapWriterLive.pipe(Layer.provide(sessionMap.SqliteLayer)), sessionMap.MigratorLayer);
-	const registry = makeSqliteStack(paths.registryDbPath, { "0001_initial": migration });
-	const RegistryLayer = Layer.mergeAll(DiscoveryRegistryLive.pipe(Layer.provide(registry.SqliteLayer)), registry.MigratorLayer);
+	const SessionMapLayer = PerClientSessionMapWriterLive.pipe(Layer.provide(Store.sqlClient(SessionMapStore)), Layer.provide(Store.layerSqliteAs(SessionMapStore, {
+		filename: paths.sessionMapDbPath,
+		migrations: toStoreMigrations({ "0001_initial": migration }),
+		...LEDGER_OPTIONS
+	})));
+	const RegistryLayer = DiscoveryRegistryLive.pipe(Layer.provide(Store.sqlClient(RegistryStore)), Layer.provide(Store.layerSqliteAs(RegistryStore, {
+		filename: paths.registryDbPath,
+		migrations: REGISTRY_STORE_OPTIONS.migrations,
+		...LEDGER_OPTIONS
+	})));
 	return Layer.mergeAll(ProjectStoreLayer, SessionMapLayer, RegistryLayer, RunContextLive(env)).pipe(Layer.provideMerge(NodePlatformLayer), Layer.provideMerge(LoggerLive()));
 };
 

package/stores.js

@@ -0,0 +1,43 @@
+import { Context, Effect } from "effect";
+import { SqlClient } from "effect/sql/SqlClient";
+
+//#region src/stores.ts
+/**
+* The ledger options every store opens with: adopt a 2.x effect/sql ledger
+* once, on the first open.
+*
+* @internal
+*/
+const LEDGER_OPTIONS = { adoptMigratorLedger: true };
+/**
+* Convert a {@link MigrationRecord} to the `StoreMigration` list `Store` runs,
+* parsing each key exactly as effect/sql's `Migrator.fromRecord` does
+* (`/^(\d+)_(.+)$/`: `"0001_initial"` → id `1`, name `"initial"`), so the ids
+* and names line up with an adopted `effect_sql_migrations` ledger. A key that
+* does not match is skipped, as effect/sql skips it.
+*
+* @internal
+*/
+const toStoreMigrations = (migrations) => Object.entries(migrations).flatMap(([key, migration]) => {
+	const match = key.match(/^(\d+)_(.+)$/);
+	if (match === null) return [];
+	const [, id, name] = match;
+	return [{
+		id: Number(id),
+		name,
+		up: (sql) => Effect.provideService(migration, SqlClient, sql)
+	}];
+}).sort((a, b) => a.id - b.id);
+/**
+* The global discovery registry (`<XDG data>/vitest-agent/registry.db`).
+* @internal
+*/
+var RegistryStore = class extends Context.Service()("vitest-agent/RegistryStore") {};
+/**
+* The per-client session map (`sessions.db`, under the host's plugin data dir).
+* @internal
+*/
+var SessionMapStore = class extends Context.Service()("vitest-agent/SessionMapStore") {};
+
+//#endregion
+export { LEDGER_OPTIONS, RegistryStore, SessionMapStore, toStoreMigrations };

package/testing.d.ts

@@ -1,5 +1,10 @@
 import { Agent, Agent as Agent$1, AgentId, AgentNotFoundError, AgentNotFoundError as AgentNotFoundError$1, AgentReport, AgentReport as AgentReport$1, ArtifactKind, ArtifactKind as ArtifactKind$1, ArtifactKind as ArtifactKind$2, ArtifactSuite, ArtifactSuite as ArtifactSuite$1, ArtifactSuite as ArtifactSuite$2, BehaviorDetail, BehaviorDetail as BehaviorDetail$1, BehaviorNotFoundError, BehaviorNotFoundError as BehaviorNotFoundError$1, BehaviorRow, BehaviorRow as BehaviorRow$1, BehaviorStatus, BehaviorStatus as BehaviorStatus$1, CacheManifest, CacheManifest as CacheManifest$1, ChatId, CitedArtifact, CitedArtifact as CitedArtifact$1, CoverageBaselines, CoverageBaselines as CoverageBaselines$1, CoverageReport, CoverageReport as CoverageReport$1, DataStoreError, DataStoreError as DataStoreError$1, FileCoverageReport, FileCoverageReport as FileCoverageReport$1, GoalDetail, GoalDetail as GoalDetail$1, GoalNotFoundError, GoalNotFoundError as GoalNotFoundError$1, GoalRow, GoalRow as GoalRow$1, GoalStatus, GoalStatus as GoalStatus$1, HistoryRecord, HistoryRecord as HistoryRecord$1, IdempotencyHit, IdempotencyHit as IdempotencyHit$1, IllegalStatusTransitionEntity, IllegalStatusTransitionError, IllegalStatusTransitionError as IllegalStatusTransitionError$1, Phase, Phase as Phase$1, RegistrationConflictError, RegistrationConflictError as RegistrationConflictError$1, ResolvedThresholds, ResolvedThresholds as ResolvedThresholds$1, TddTaskAlreadyEndedError, TddTaskAlreadyEndedError as TddTaskAlreadyEndedError$1, TddTaskEndOutcome, TddTaskNotFoundError, TddTaskNotFoundError as TddTaskNotFoundError$1, TrendEntry, TrendEntry as TrendEntry$1, TrendRecord, TrendRecord as TrendRecord$1 } from "@vitest-agent/sdk";
 import { Context, Effect, Layer, Option } from "effect";
+import "@effect/platform-node/NodeServices";
+import "@effect/sql-sqlite-node/SqliteClient";
+import { StoreError, StoreMigrationError } from "@effected/store";
+import "effect/sql/SqlClient";
+import "effect/sql/SqlError";
 //#region src/services/DataStore.d.ts
 /** @public */
 interface CreateGoalInput {
@@ -1057,6 +1062,14 @@ declare const DataReader_base: Context.ServiceClass<DataReader, "vitest-agent/Da
 /** @public */
 export declare class DataReader extends DataReader_base {}
 //#endregion
+//#region src/platform.d.ts
+/**
+ * What building a SQLite stack, and so `PlatformLive`, can fail with:
+ * `@effected/store`'s setup / ledger-adoption failure or a failing migration.
+ * @public
+ */
+type PlatformLiveError = StoreError | StoreMigrationError;
+//#endregion
 //#region src/migrations/index.d.ts
 /**
  * Every migration that must run against a per-project `data.db`, keyed by
@@ -1064,8 +1077,9 @@ export declare class DataReader extends DataReader_base {}
  *
  * This is the single source of truth for the project database's migration
  * set: `makeSqliteStack` (and through it `PlatformLive`, `ensureMigrated`,
- * the testing layers, `ReporterLive` and `SidecarLive`) defaults to it when
- * calling `SqliteMigrator.fromRecord`, so adding a migration file and
+ * the testing layers, `ReporterLive` and `SidecarLive`) defaults to it and
+ * runs it through `@effected/store` (keys parsed as effect/sql's
+ * `fromRecord` parses them, so 2.x ledgers adopt), so adding a migration file and
  * registering it here is enough to reach every process that opens a project
  * database.
  *
@@ -1081,21 +1095,21 @@ export declare const PROJECT_MIGRATIONS: {
 //#endregion
 //#region src/testing/layers.d.ts
 /** @public */
-export declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare function makeTestLayer(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, PlatformLiveError, never>;
 /** @public */
-export declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare const DataStoreTestLayer: Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, PlatformLiveError, never>;
 //#endregion
 //#region src/testing/index.d.ts
 /** @public */
-export declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare function empty(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, PlatformLiveError, never>;
 /** @public */
-export declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare function singlePassingRun(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | PlatformLiveError, never>;
 /** @public */
-export declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare function withFailures(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | PlatformLiveError, never>;
 /** @public */
-export declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError, never>;
+export declare function flaky(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").DataStoreError | PlatformLiveError, never>;
 /** @public */
-export declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").BehaviorNotFoundError | import("@vitest-agent/sdk").DataStoreError | import("@vitest-agent/sdk").GoalNotFoundError | import("@vitest-agent/sdk").IllegalStatusTransitionError | import("effect/sql/Migrator").MigrationError | import("effect/sql/SqlError").SqlError | import("@vitest-agent/sdk").TddTaskAlreadyEndedError | import("@vitest-agent/sdk").TddTaskNotFoundError, never>;
+export declare function withTddTask(filename: string): Layer.Layer<DataReader | DataStore | import("effect/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | import("@effect/platform-node/NodeServices").NodeServices, import("@vitest-agent/sdk").BehaviorNotFoundError | import("@vitest-agent/sdk").DataStoreError | import("@vitest-agent/sdk").GoalNotFoundError | import("@vitest-agent/sdk").IllegalStatusTransitionError | import("@vitest-agent/sdk").TddTaskAlreadyEndedError | import("@vitest-agent/sdk").TddTaskNotFoundError | PlatformLiveError, never>;
 //#endregion
-export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type ArtifactSuite, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataStoreError, type EndTddTaskInput, type FailureSignatureDetail, type FailureSignatureWriteInput, type FileCoverageInput, FileCoverageReport, type FlakyTest, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, type HistoryQueryOptions, HistoryRecord, type HypothesisDetail, type HypothesisInput, IdempotencyHit, type IdempotentResponseInput, type IllegalStatusTransitionEntity, IllegalStatusTransitionError, type ModuleInput, type ModuleListEntry, type NoteInput, type NoteRow, type PersistedAttachment, type PersistentFailure, type Phase, type ProjectRunSummary, type RegisterAgentInput, RegistrationConflictError, type ResolvedThresholds, 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 TestAnnotationInput, type TestAnnotationRow, type TestArtifactInput, type TestArtifactQueryOptions, type TestArtifactRow, type TestAttachmentInput, type TestCaseInput, type TestError, type TestErrorInput, type TestListEntry, type TestLookupOptions, type TestRunInput, TrendEntry, TrendRecord, type TurnInput, type TurnSearchOptions, type TurnSummary, type UpdateBehaviorInput, type UpdateGoalInput, type ValidateHypothesisInput, type WriteCommitInput, type WriteRunChangedFilesInput, type WriteTddArtifactInput, type WriteTddPhaseInput, type WriteTddPhaseOutput };
+export { type AcceptanceMetrics, Agent, AgentId, AgentNotFoundError, AgentReport, type ArtifactKind, type ArtifactSuite, type AssociateRunSessionInput, BehaviorDetail, BehaviorNotFoundError, BehaviorRow, BehaviorStatus, CacheManifest, type ChangeKind, ChatId, type CitedArtifact, type CitedArtifactRow, type ClassificationQueryOptions, type CommitChangesEntry, CoverageBaselines, CoverageReport, type CreateBehaviorInput, type CreateGoalInput, type CurrentTddPhase, DataStoreError, type EndTddTaskInput, type FailureSignatureDetail, type FailureSignatureWriteInput, type FileCoverageInput, FileCoverageReport, type FlakyTest, GoalDetail, GoalNotFoundError, GoalRow, GoalStatus, type HistoryQueryOptions, HistoryRecord, type HypothesisDetail, type HypothesisInput, IdempotencyHit, type IdempotentResponseInput, type IllegalStatusTransitionEntity, IllegalStatusTransitionError, type ModuleInput, type ModuleListEntry, type NoteInput, type NoteRow, type PersistedAttachment, type PersistentFailure, type Phase, type PlatformLiveError, type ProjectRunSummary, type RegisterAgentInput, RegistrationConflictError, type ResolvedThresholds, 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 TestAnnotationInput, type TestAnnotationRow, type TestArtifactInput, type TestArtifactQueryOptions, type TestArtifactRow, type TestAttachmentInput, type TestCaseInput, type TestError, type TestErrorInput, type TestListEntry, type TestLookupOptions, type TestRunInput, TrendEntry, TrendRecord, type TurnInput, type TurnSearchOptions, type TurnSummary, type UpdateBehaviorInput, type UpdateGoalInput, type ValidateHypothesisInput, type WriteCommitInput, type WriteRunChangedFilesInput, type WriteTddArtifactInput, type WriteTddPhaseInput, type WriteTddPhaseOutput };
 //# sourceMappingURL=testing.d.ts.map

package/version.js

@@ -1,6 +1,6 @@
 //#region src/version.ts
 /** Build-time injected package version (see architecture.md D36). @public */
-const CURRENT_ENGINE_VERSION = "0.5.0";
+const CURRENT_ENGINE_VERSION = "0.6.0";
 
 //#endregion
 export { CURRENT_ENGINE_VERSION };