@vitest-agent/cli 2.2.19 → 3.0.1

package/bin/vitest-agent.js

@@ -1,34 +1,14 @@
 #!/usr/bin/env node
-import { CliLive } from "../layers/CliLive.js";
-import { agentCommand } from "../commands/agent.js";
-import { dbCommand } from "../commands/db.js";
-import { doctorCommand } from "../commands/doctor.js";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { PathResolutionLive, formatFatalError, resolveDataPath, resolveLogFile, resolveLogLevel } from "@vitest-agent/sdk";
-import { Cause, Console, Effect } from "effect";
-import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
-import { Command } from "effect/unstable/cli";
+import { main } from "../main.js";
 
 //#region src/bin.ts
 /**
-* CLI entry point for vitest-agent.
+* CLI entry point for vitest-agent. Thin shim over `main.ts` — the
+* assembled program that owns the process.
 *
 * @packageDocumentation
 */
-const rootCommand = Command.make("vitest-agent").pipe(Command.withSubcommands([
-	dbCommand,
-	doctorCommand,
-	agentCommand
-]));
-const cli = Command.run(rootCommand, { version: "0.0.0" });
-const logLevel = resolveLogLevel();
-const logFile = resolveLogFile();
-const projectDir = process.env.VITEST_AGENT_PROJECT_DIR ?? process.cwd();
-const main = resolveDataPath(projectDir).pipe(Effect.flatMap((dbPath) => cli.pipe(Effect.provide(CliLive(dbPath, logLevel, logFile)))), Effect.provide(PathResolutionLive(projectDir)), Effect.provide(NodeServices.layer), Effect.catchCause((cause) => {
-	if (cause.reasons.filter(Cause.isDieReason).length > 0) return Console.error(`vitest-agent: ${formatFatalError(cause)}`).pipe(Effect.andThen(Effect.failCause(cause)));
-	return Effect.failCause(cause);
-}));
-NodeRuntime.runMain(main);
+main();
 
 //#endregion
 export {  };

package/commands/agent.js

@@ -1,16 +1,13 @@
-import { SidecarLive } from "../layers/SidecarLive.js";
-import { registerAgentEffect } from "../lib/internal-register-agent.js";
-import { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, resolveProjectDataDir, resolveRegistryDir, resolveSessionMapPath } from "../lib/sidecar-paths.js";
-import { endAgentEffect } from "../lib/internal-end-agent.js";
 import { recordCommand } from "./record.js";
 import { triageCommand } from "./triage.js";
 import { wrapupCommand } from "./wrapup.js";
 import * as NodeServices from "@effect/platform-node/NodeServices";
-import { classifyTestPath, detectNonDefaultDiscoverStrategy, findOwningWorkspace, resolveProjectKeyFromCwd } from "@vitest-agent/sdk";
+import { SidecarPlatformLive, endAgentEffect, registerAgentEffect, resolveHookPaths, resolveProjectKeyFromCwd } from "@vitest-agent/engine";
+import { classifyTestPath, detectNonDefaultDiscoverStrategy, findOwningWorkspace } from "@vitest-agent/sdk";
 import { Cause, Effect, Option } from "effect";
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 import { findWorkspaceRootSync, getWorkspacePackagesSync } from "@effected/workspaces";
 import { nodeSyncOps } from "@effected/workspaces/node-sync";
 import { exitCodeForTag, injectEnv } from "@vitest-agent/sdk/dispatch";
@@ -85,14 +82,11 @@ const registerAgentSubcommand = Command.make("register-agent", {
 	projectKeyOverride: projectKeyOverrideOpt
 }, (opts) => Effect.gen(function* () {
 	const projectKey = Option.isSome(opts.projectKeyOverride) ? opts.projectKeyOverride.value : resolveProjectKeyFromCwd(opts.cwd);
-	const perProjectDbPath = join(resolveProjectDataDir(projectKey), DATA_DB_FILENAME);
-	const registryDbPath = join(resolveRegistryDir(), REGISTRY_DB_FILENAME);
-	const sessionMapDbPath = yield* resolveSessionMapPath().pipe(Effect.catchCause(mapDefectToExit));
-	const sidecar = SidecarLive({
-		perProjectDbPath,
-		sessionMapDbPath,
-		registryDbPath
-	});
+	const paths = yield* resolveHookPaths({
+		env: process.env,
+		projectKey
+	}).pipe(Effect.catchCause(mapDefectToExit));
+	const sidecar = SidecarPlatformLive(paths, process.env);
 	const result = yield* registerAgentEffect({
 		hostSessionId: opts.hostSessionId,
 		transcriptPath: opts.transcriptPath,
@@ -124,14 +118,11 @@ const endAgentSubcommand = Command.make("end-agent", {
 	projectKeyOverride: endProjectKeyOverrideOpt
 }, (opts) => Effect.gen(function* () {
 	const projectKey = Option.isSome(opts.projectKeyOverride) ? opts.projectKeyOverride.value : resolveProjectKeyFromCwd(opts.cwd);
-	const perProjectDbPath = join(resolveProjectDataDir(projectKey), DATA_DB_FILENAME);
-	const registryDbPath = join(resolveRegistryDir(), REGISTRY_DB_FILENAME);
-	const sessionMapDbPath = yield* resolveSessionMapPath().pipe(Effect.catchCause(mapDefectToExit));
-	const sidecar = SidecarLive({
-		perProjectDbPath,
-		sessionMapDbPath,
-		registryDbPath
-	});
+	const paths = yield* resolveHookPaths({
+		env: process.env,
+		projectKey
+	}).pipe(Effect.catchCause(mapDefectToExit));
+	const sidecar = SidecarPlatformLive(paths, process.env);
 	const endedAt = Option.isSome(opts.endedAt) ? opts.endedAt.value : Math.floor(Date.now() / 1e3);
 	yield* endAgentEffect({
 		agentId: opts.agentId,
@@ -148,7 +139,8 @@ const injectEnvSubcommand = Command.make("inject-env", {
 	const out = injectEnv({
 		command: opts.command,
 		cwd: opts.cwd,
-		env: process.env
+		env: process.env,
+		readFile: (path) => readFileSync(path, "utf-8")
 	});
 	process.stdout.write(`${out}\n`);
 })).pipe(Command.withDescription("Rewrite a Bash command to prepend VITEST_AGENT_* env vars when it invokes Vitest"));

package/commands/db.js

@@ -1,11 +1,11 @@
 import { formatDbQuery } from "../lib/format-db-query.js";
 import * as NodeServices from "@effect/platform-node/NodeServices";
-import { layer } from "@effect/sql-sqlite-node/SqliteClient";
-import { DataStore, resolveDataPath } from "@vitest-agent/sdk";
+import { DataStore, resolveDataPath } from "@vitest-agent/engine";
 import { Effect, FileSystem } from "effect";
 import { Argument, Command, Flag } from "effect/unstable/cli";
-import { SqlClient } from "effect/unstable/sql/SqlClient";
 import * as readline from "node:readline";
+import { layer } from "@effect/sql-sqlite-node/SqliteClient";
+import { SqlClient } from "effect/unstable/sql/SqlClient";
 
 //#region src/commands/db.ts
 /**

package/commands/doctor.js

@@ -1,5 +1,5 @@
 import { formatDoctor } from "../lib/format-doctor.js";
-import { DataReader, resolveDataPath } from "@vitest-agent/sdk";
+import { DataReader, resolveDataPath } from "@vitest-agent/engine";
 import { Effect, Option } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 

package/commands/record.js

@@ -1,8 +1,4 @@
-import { recordSessionEnd, recordSessionStart } from "../lib/record-session.js";
-import { dispatchRecordTddArtifactEffect } from "../lib/record-tdd-artifact.js";
-import { recordTurnEffect } from "../lib/record-turn.js";
-import { recordRunWorkspaceChangesEffect } from "../lib/record-workspace-changes.js";
-import { DataReader, DataStore } from "@vitest-agent/sdk";
+import { DataReader, DataStore, dispatchRecordTddArtifactEffect, recordRunWorkspaceChangesEffect, recordSessionEnd, recordSessionStart, recordTurnEffect } from "@vitest-agent/engine";
 import { Effect, Option } from "effect";
 import { Argument, Command, Flag } from "effect/unstable/cli";
 
@@ -25,7 +21,7 @@ const turnSubcommand = Command.make("turn", {
 	payloadJson: payload,
 	occurredAt,
 	...project._tag === "Some" && { project: project.value },
-	...cwd._tag === "Some" && { cwd: cwd.value }
+	cwd: cwd._tag === "Some" ? cwd.value : process.cwd()
 }).pipe(Effect.flatMap((result) => Effect.sync(() => process.stdout.write(`${JSON.stringify(result)}\n`))), Effect.catch((err) => Effect.sync(() => {
 	process.stderr.write(`record turn: ${err instanceof Error ? err.message : String(err)}\n`);
 	process.exit(1);
@@ -108,7 +104,7 @@ const tddArtifactSubcommand = Command.make("tdd-artifact", {
 		...opts.chatId._tag === "Some" && { chatId: opts.chatId.value },
 		...opts.tddTaskId._tag === "Some" && { tddTaskId: opts.tddTaskId.value },
 		...opts.project._tag === "Some" && { project: opts.project.value },
-		...opts.cwd._tag === "Some" && { cwd: opts.cwd.value },
+		cwd: opts.cwd._tag === "Some" ? opts.cwd.value : process.cwd(),
 		artifactKind: opts.artifactKind,
 		...fileId !== void 0 && { fileId },
 		...opts.testCaseId._tag === "Some" && { testCaseId: opts.testCaseId.value },

package/commands/triage.js

@@ -1,4 +1,4 @@
-import { formatTriageEffect } from "@vitest-agent/sdk";
+import { formatTriageEffect } from "@vitest-agent/engine";
 import { Effect } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 

package/commands/wrapup.js

@@ -1,4 +1,4 @@
-import { formatWrapupEffect } from "@vitest-agent/sdk";
+import { formatWrapupEffect } from "@vitest-agent/engine";
 import { Effect } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 

package/index.d.ts

@@ -1,167 +1,12 @@
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as SqliteMigrator from "@effect/sql-sqlite-node/SqliteMigrator";
-import { Effect, Layer, LogLevel } from "effect";
-import { DataReader, DataStore, PerClientSessionMapWriter, ProjectIdentityNotResolvableError } from "@vitest-agent/sdk";
-//#region src/layers/CliLive.d.ts
-/**
- * Composition layer for the CLI runtime.
- *
- * Wires `DataReader`, `ProjectDiscovery`, `HistoryTracker`,
- * `OutputPipeline`, `SqliteClient`, the DB migrator, the Node platform
- * services, and `Logger` into a single layer the `vitest-agent`
- * bin provides to `Command.run`.
- *
- * @param dbPath - absolute path to the per-project `data.db`
- * @param logLevel - optional log level override; defaults to `Info`
- * @param logFile - optional path for structured log output
- * @public
- */
-export declare const CliLive: (dbPath: string, logLevel?: LogLevel.LogLevel, logFile?: string) => Layer.Layer<import("@vitest-agent/sdk").DataReader | import("@vitest-agent/sdk").DataStore | import("@vitest-agent/sdk").DetailResolver | import("@vitest-agent/sdk").EnvironmentDetector | import("@vitest-agent/sdk").ExecutorResolver | import("@vitest-agent/sdk").FormatSelector | import("@vitest-agent/sdk").HistoryTracker | import("@vitest-agent/sdk").OutputRenderer | import("@vitest-agent/sdk").ProjectDiscovery | import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-node/SqliteClient").SqliteClient | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
-//#endregion
-//#region src/layers/SidecarLive.d.ts
-/**
- * SQLite database paths consumed by {@link SidecarLive}.
- *
- * @public
- */
-interface SidecarPaths {
-  /** Absolute path to the per-project `data.db`. */
-  readonly perProjectDbPath: string;
-  /** Absolute path to the per-client `sessions.db`. */
-  readonly sessionMapDbPath: string;
-  /** Absolute path to the global `registry.db`. */
-  readonly registryDbPath: string;
-}
-/**
- * Build the sidecar Live layer for the supplied SQLite paths.
- *
- * Each store gets its own `SqlClient` connection (separate scopes,
- * independent migrators) so concurrent operations on the three
- * stores don't share lock state.
- *
- * @param paths - the three SQLite database paths to open
- * @public
- */
-export declare const SidecarLive: (paths: SidecarPaths) => Layer.Layer<import("@vitest-agent/sdk").DataReader | import("@vitest-agent/sdk").DataStore | import("@vitest-agent/sdk").DiscoveryRegistry | import("@vitest-agent/sdk").PerClientSessionMapReader | import("@vitest-agent/sdk").PerClientSessionMapWriter | import("@vitest-agent/sdk").RunContext$ | NodeServices.NodeServices, SqliteMigrator.MigrationError | import("effect/unstable/sql/SqlError").SqlError, never>;
-//#endregion
-//#region src/lib/internal-register-agent.d.ts
-/**
- * Input for the end-to-end agent registration effect.
- *
- * @public
- */
-interface RegisterAgentInput {
-  /** The host's native session identifier (e.g. Claude's `session_id`). */
-  readonly hostSessionId: string;
-  /** Absolute path to the host's conversation transcript file. */
-  readonly transcriptPath: string;
-  /** Working directory of the agent process. */
-  readonly cwd: string;
-  /** Host kind string (e.g. `"claude-code"`). */
-  readonly hostKind: string;
-  /** Agent type label (e.g. `"main"` or `"subagent"`). */
-  readonly agentType: string;
-  /** Normalized project key derived from the workspace root `package.json#name`. */
-  readonly projectKey: string;
-  /** Agent ID of the parent when registering a subagent. */
-  readonly parentAgentId?: string;
-  /** Optional idempotency nonce; derived from `hostSessionId + agentType + parentAgentId` when omitted. */
-  readonly clientNonce?: string;
-}
-/**
- * Output of the end-to-end agent registration effect.
- *
- * @public
- */
-interface RegisterAgentOutput {
-  /** Canonical UUID assigned to this agent in the per-project store. */
-  readonly agentId: string;
-  /** UUID of the conversation this agent belongs to. */
-  readonly conversationId: string;
-  /** Idempotency key used for the `registerAgent` upsert. */
-  readonly idempotencyKey: string;
-  /** `true` when an existing agent row was recovered rather than inserted. */
-  readonly idempotencyHit: boolean;
-}
-/**
- * End-to-end agent registration.
- *
- * Returns the canonical `agentId` + the conversation it belongs to +
- * the resolved `idempotencyKey`. The `idempotencyHit` flag is `true`
- * when the per-project store recovered an existing agent row instead
- * of inserting a new one.
- *
- * @param input - registration inputs including host identifiers and agent metadata
- * @returns an Effect resolving to `RegisterAgentOutput`
- * @public
- */
-export declare const registerAgentEffect: (input: RegisterAgentInput) => Effect.Effect<{
-  agentId: string;
-  conversationId: string;
-  mainAgentId: string;
-  idempotencyKey: string;
-  idempotencyHit: boolean;
-}, import("@vitest-agent/sdk").DataStoreError | import("@vitest-agent/sdk").RegistrationConflictError, DataReader | DataStore | PerClientSessionMapWriter | import("@vitest-agent/sdk").RunContext$>;
-//#endregion
-//#region src/lib/sidecar-paths.d.ts
-/**
- * Filename of the per-project test-data SQLite database.
- *
- * @public
- */
-export declare const DATA_DB_FILENAME = "data.db";
-/**
- * Filename of the per-client session-map SQLite database.
- *
- * @public
- */
-export declare const SESSIONS_DB_FILENAME = "sessions.db";
-/**
- * Filename of the global discovery-registry SQLite database.
- *
- * @public
- */
-export declare const REGISTRY_DB_FILENAME = "registry.db";
-/**
- * Resolve (and create) the per-project data directory for the supplied
- * normalized `projectKey`. Returns the directory; callers join
- * {@link DATA_DB_FILENAME} onto it for the `data.db` path.
- *
- * @param projectKey - normalized project key (e.g. `@org__pkg`)
- * @returns absolute path to the resolved (and created) data directory
- * @public
- */
-export declare const resolveProjectDataDir: (projectKey: string) => string;
-/**
- * Resolve (and create) the directory holding the global `registry.db`.
- * Callers join {@link REGISTRY_DB_FILENAME} onto it.
- *
- * @returns absolute path to the resolved (and created) registry directory
- * @public
- */
-export declare const resolveRegistryDir: () => string;
-/**
- * Resolve the per-client `sessions.db` path.
- *
- * Precedence: the `CLAUDE_PLUGIN_DATA` env var, then
- * `VITEST_AGENT_SESSION_MAP_DIR`, then `~/.vitest-agent/`. Fails
- * with `ProjectIdentityNotResolvableError` when no home directory
- * is resolvable.
- *
- * @returns an Effect resolving to the absolute `sessions.db` path
- * @public
- */
-export declare const resolveSessionMapPath: () => Effect.Effect<string, ProjectIdentityNotResolvableError>;
-//#endregion
-//#region src/index.d.ts
+//#region src/version.d.ts
 /**
  * The version of this package, inlined at build time from
  * `package.json#version` via rslib-builder's `__PACKAGE_VERSION__` substitution.
- * Exported for version introspection by downstream tooling.
+ * Exported for version introspection by downstream tooling, and consumed by
+ * `main.ts` to back `Command.run`'s `version` option.
  *
  * @public
  */
 export declare const CURRENT_CLI_VERSION: string;
 //#endregion
-export type { RegisterAgentInput, RegisterAgentOutput, SidecarPaths };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,17 +1,3 @@
-import { CliLive } from "./layers/CliLive.js";
-import { SidecarLive } from "./layers/SidecarLive.js";
-import { registerAgentEffect } from "./lib/internal-register-agent.js";
-import { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, SESSIONS_DB_FILENAME, resolveProjectDataDir, resolveRegistryDir, resolveSessionMapPath } from "./lib/sidecar-paths.js";
+import { CURRENT_CLI_VERSION } from "./version.js";
 
-//#region src/index.ts
-/**
-* The version of this package, inlined at build time from
-* `package.json#version` via rslib-builder's `__PACKAGE_VERSION__` substitution.
-* Exported for version introspection by downstream tooling.
-*
-* @public
-*/
-const CURRENT_CLI_VERSION = "2.2.19";
-
-//#endregion
-export { CURRENT_CLI_VERSION, CliLive, DATA_DB_FILENAME, REGISTRY_DB_FILENAME, SESSIONS_DB_FILENAME, SidecarLive, registerAgentEffect, resolveProjectDataDir, resolveRegistryDir, resolveSessionMapPath };
+export { CURRENT_CLI_VERSION };

package/main.d.ts

@@ -0,0 +1,22 @@
+//#region src/main.d.ts
+/**
+ * Assembled CLI program. Owns the process: resolves the data path, wires the
+ * engine's platform layers, and runs the root command via
+ * `NodeRuntime.runMain`.
+ *
+ * `bin.ts` is the published bin shim (`#!/usr/bin/env node` +
+ * `main()`); this module is also published as the `./main` subpath so a
+ * consumer can invoke the assembled program without going through the shim.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Assembles and runs the CLI program, taking over the process. Not
+ * re-exported from `index.ts` — a library consumer's import graph must not
+ * pull in the process-owning module.
+ *
+ * @public
+ */
+export declare const main: () => void;
+//#endregion
+//# sourceMappingURL=main.d.ts.map

package/main.js

@@ -0,0 +1,58 @@
+import { CURRENT_CLI_VERSION } from "./version.js";
+import { agentCommand } from "./commands/agent.js";
+import { dbCommand } from "./commands/db.js";
+import { doctorCommand } from "./commands/doctor.js";
+import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { PathResolutionLive, PlatformLive, resolveDataPath, resolveLogFile, resolveLogLevel, resolveProjectDir } from "@vitest-agent/engine";
+import { formatFatalError } from "@vitest-agent/sdk";
+import { Cause, Console, Effect } from "effect";
+import { Command } from "effect/unstable/cli";
+
+//#region src/main.ts
+/**
+* Assembled CLI program. Owns the process: resolves the data path, wires the
+* engine's platform layers, and runs the root command via
+* `NodeRuntime.runMain`.
+*
+* `bin.ts` is the published bin shim (`#!/usr/bin/env node` +
+* `main()`); this module is also published as the `./main` subpath so a
+* consumer can invoke the assembled program without going through the shim.
+*
+* @packageDocumentation
+*/
+const rootCommand = Command.make("vitest-agent").pipe(Command.withSubcommands([
+	dbCommand,
+	doctorCommand,
+	agentCommand
+]));
+/**
+* Assembles and runs the CLI program, taking over the process. Not
+* re-exported from `index.ts` — a library consumer's import graph must not
+* pull in the process-owning module.
+*
+* @public
+*/
+const main = () => {
+	const env = process.env;
+	const logLevel = resolveLogLevel(env);
+	const logFile = resolveLogFile(env);
+	const projectDir = resolveProjectDir({
+		env,
+		cwd: process.cwd()
+	});
+	const cli = Command.run(rootCommand, { version: CURRENT_CLI_VERSION });
+	const program = resolveDataPath(projectDir).pipe(Effect.flatMap((dbPath) => cli.pipe(Effect.provide(PlatformLive({
+		dbPath,
+		env,
+		logLevel,
+		logFile
+	})))), Effect.provide(PathResolutionLive(projectDir)), Effect.provide(NodeServices.layer), Effect.catchCause((cause) => {
+		if (cause.reasons.filter(Cause.isDieReason).length > 0) return Console.error(`vitest-agent: ${formatFatalError(cause)}`).pipe(Effect.andThen(Effect.failCause(cause)));
+		return Effect.failCause(cause);
+	}));
+	NodeRuntime.runMain(program);
+};
+
+//#endregion
+export { main };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vitest-agent/cli",
-	"version": "2.2.19",
+	"version": "3.0.1",
 	"private": false,
 	"description": "On-demand CLI for vitest-agent. Reads cached test data and reports status, overview, coverage, history, trends, and cache health.",
 	"keywords": [
@@ -32,6 +32,11 @@
 			"import": "./index.js",
 			"default": "./index.js"
 		},
+		"./main": {
+			"types": "./main.d.ts",
+			"import": "./main.js",
+			"default": "./main.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"bin": {
@@ -40,9 +45,10 @@
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-rc.115",
 		"@effect/sql-sqlite-node": "4.0.0-rc.115",
-		"@effected/workspaces": "^0.21.0",
-		"@vitest-agent/sdk": "3.1.2",
-		"@vitest-agent/sidecar": "2.1.19",
+		"@effected/workspaces": "^0.22.0",
+		"@vitest-agent/engine": "0.1.1",
+		"@vitest-agent/sdk": "4.0.0",
+		"@vitest-agent/sidecar": "2.1.20",
 		"effect": "4.0.0-rc.115"
 	},
 	"engines": {

package/version.js

@@ -0,0 +1,13 @@
+//#region src/version.ts
+/**
+* The version of this package, inlined at build time from
+* `package.json#version` via rslib-builder's `__PACKAGE_VERSION__` substitution.
+* Exported for version introspection by downstream tooling, and consumed by
+* `main.ts` to back `Command.run`'s `version` option.
+*
+* @public
+*/
+const CURRENT_CLI_VERSION = "3.0.1";
+
+//#endregion
+export { CURRENT_CLI_VERSION };

package/layers/CliLive.js

@@ -1,29 +0,0 @@
-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 { DataReaderLive, DataStoreLive, HistoryTrackerLive, LoggerLive, OutputPipelineLive, PROJECT_MIGRATIONS, ProjectDiscoveryLive } from "@vitest-agent/sdk";
-import { Layer } from "effect";
-
-//#region src/layers/CliLive.ts
-/**
-* Composition layer for the CLI runtime.
-*
-* Wires `DataReader`, `ProjectDiscovery`, `HistoryTracker`,
-* `OutputPipeline`, `SqliteClient`, the DB migrator, the Node platform
-* services, and `Logger` into a single layer the `vitest-agent`
-* bin provides to `Command.run`.
-*
-* @param dbPath - absolute path to the per-project `data.db`
-* @param logLevel - optional log level override; defaults to `Info`
-* @param logFile - optional path for structured log output
-* @public
-*/
-const CliLive = (dbPath, logLevel, logFile) => {
-	const SqliteLayer = layer({ filename: dbPath });
-	const PlatformLayer = NodeServices.layer;
-	const MigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord(PROJECT_MIGRATIONS) }).pipe(Layer.provide(Layer.merge(SqliteLayer, PlatformLayer)));
-	return Layer.mergeAll(ProjectDiscoveryLive, HistoryTrackerLive, OutputPipelineLive).pipe(Layer.provideMerge(DataReaderLive), Layer.provideMerge(DataStoreLive), Layer.provideMerge(MigratorLayer), Layer.provideMerge(SqliteLayer), Layer.provideMerge(PlatformLayer), Layer.provideMerge(LoggerLive(logLevel, logFile)));
-};
-
-//#endregion
-export { CliLive };

package/layers/SidecarLive.js

@@ -1,33 +0,0 @@
-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 { DataReaderLive, DataStoreLive, DiscoveryRegistryLive, LoggerLive, PROJECT_MIGRATIONS, PerClientSessionMapWriterLive, RunContextLive, registryMigration0001, sessionMapMigration0001 } from "@vitest-agent/sdk";
-import { Layer } from "effect";
-
-//#region src/layers/SidecarLive.ts
-/**
-* Build the sidecar Live layer for the supplied SQLite paths.
-*
-* Each store gets its own `SqlClient` connection (separate scopes,
-* independent migrators) so concurrent operations on the three
-* stores don't share lock state.
-*
-* @param paths - the three SQLite database paths to open
-* @public
-*/
-const SidecarLive = (paths) => {
-	const PlatformLayer = NodeServices.layer;
-	const ProjectSqliteLayer = layer({ filename: paths.perProjectDbPath });
-	const ProjectMigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord(PROJECT_MIGRATIONS) }).pipe(Layer.provide(Layer.merge(ProjectSqliteLayer, PlatformLayer)));
-	const ProjectStoreLayer = Layer.mergeAll(DataStoreLive.pipe(Layer.provide(ProjectSqliteLayer)), DataReaderLive.pipe(Layer.provide(ProjectSqliteLayer)), ProjectMigratorLayer);
-	const SessionMapSqliteLayer = layer({ filename: paths.sessionMapDbPath });
-	const SessionMapMigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord({ "0001_initial": sessionMapMigration0001 }) }).pipe(Layer.provide(Layer.merge(SessionMapSqliteLayer, PlatformLayer)));
-	const SessionMapLayer = Layer.mergeAll(PerClientSessionMapWriterLive.pipe(Layer.provide(SessionMapSqliteLayer)), SessionMapMigratorLayer);
-	const RegistrySqliteLayer = layer({ filename: paths.registryDbPath });
-	const RegistryMigratorLayer = SqliteMigrator.layer({ loader: SqliteMigrator.fromRecord({ "0001_initial": registryMigration0001 }) }).pipe(Layer.provide(Layer.merge(RegistrySqliteLayer, PlatformLayer)));
-	const RegistryLayer = Layer.mergeAll(DiscoveryRegistryLive.pipe(Layer.provide(RegistrySqliteLayer)), RegistryMigratorLayer);
-	return Layer.mergeAll(ProjectStoreLayer, SessionMapLayer, RegistryLayer, RunContextLive).pipe(Layer.provideMerge(PlatformLayer), Layer.provideMerge(LoggerLive()));
-};
-
-//#endregion
-export { SidecarLive };

package/lib/internal-end-agent.js

@@ -1,27 +0,0 @@
-import { DataStore, PerClientSessionMapWriter } from "@vitest-agent/sdk";
-import { Effect } from "effect";
-
-//#region src/lib/internal-end-agent.ts
-/**
-* Sidecar `_internal end-agent` implementation.
-*
-* Sets `agents.ended_at` on the per-project store. For main-agent
-* stops (SessionEnd), the caller also passes `--host-session-id` so
-* the per-client session map's `ended_at` is updated and
-* `lookupByProjectDir` no longer returns the row as the active
-* session. For subagent stops (SubagentStop), the host session stays
-* open — only the subagent's `agents` row is closed.
-*
-* @packageDocumentation
-*/
-/**
-* End an agent. Closes the `agents` row, optionally also closes the
-* `session_map` row.
-*/
-const endAgentEffect = (input) => Effect.gen(function* () {
-	yield* (yield* DataStore).endAgent(input.agentId, input.endedAt);
-	if (input.hostSessionId !== void 0) yield* (yield* PerClientSessionMapWriter).endSession(input.hostSessionId, input.endedAt);
-});
-
-//#endregion
-export { endAgentEffect };

package/lib/internal-register-agent.js

@@ -1,81 +0,0 @@
-import { DataReader, DataStore, PerClientSessionMapWriter, RunContextService, deriveIdempotencyKey } from "@vitest-agent/sdk";
-import { Effect, Option } from "effect";
-
-//#region src/lib/internal-register-agent.ts
-const deriveDefaultClientNonce = (input) => {
-	const parent = input.parentAgentId ?? "__ROOT__";
-	return `${input.hostSessionId}|${input.agentType}|${parent}`;
-};
-/**
-* End-to-end agent registration.
-*
-* Returns the canonical `agentId` + the conversation it belongs to +
-* the resolved `idempotencyKey`. The `idempotencyHit` flag is `true`
-* when the per-project store recovered an existing agent row instead
-* of inserting a new one.
-*
-* @param input - registration inputs including host identifiers and agent metadata
-* @returns an Effect resolving to `RegisterAgentOutput`
-* @public
-*/
-const registerAgentEffect = (input) => Effect.gen(function* () {
-	const sessionMap = yield* PerClientSessionMapWriter;
-	const reader = yield* DataReader;
-	const store = yield* DataStore;
-	const ctx = yield* RunContextService;
-	const conversationId = yield* sessionMap.mapConversation(input.transcriptPath);
-	const sessionMapping = yield* sessionMap.mapSession({
-		hostSessionId: input.hostSessionId,
-		conversationId,
-		projectKey: input.projectKey,
-		projectDir: input.cwd
-	});
-	const existingSession = yield* reader.getSessionByChatId(input.hostSessionId);
-	const sessionRowId = yield* Option.match(existingSession, {
-		onNone: () => store.writeSession({
-			chatId: input.hostSessionId,
-			project: input.projectKey,
-			cwd: input.cwd,
-			agentKind: input.parentAgentId === void 0 ? "main" : "subagent",
-			agentType: input.agentType,
-			triageWasNonEmpty: false,
-			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-			conversationId
-		}),
-		onSome: (s) => Effect.succeed(s.id)
-	});
-	yield* store.setSessionConversationIdIfNull({
-		sessionId: sessionRowId,
-		conversationId
-	});
-	const agentContext = yield* ctx.captureAgentContext(input.cwd);
-	const clientNonce = input.clientNonce ?? deriveDefaultClientNonce(input);
-	const idempotencyKey = deriveIdempotencyKey({
-		agentType: input.agentType,
-		parentAgentId: input.parentAgentId ?? null,
-		clientNonce
-	});
-	const result = yield* store.registerAgent({
-		sessionId: sessionRowId,
-		agentType: input.agentType,
-		parentAgentId: input.parentAgentId ?? null,
-		conversationId,
-		startedAt: Math.floor(Date.now() / 1e3),
-		...agentContext.startGitBranch !== null && { startGitBranch: agentContext.startGitBranch },
-		...agentContext.startGitCommitSha !== null && { startGitCommitSha: agentContext.startGitCommitSha },
-		...agentContext.startWorktreeDir !== null && { startWorktreeDir: agentContext.startWorktreeDir },
-		idempotencyKey,
-		agentId: sessionMapping.mainAgentId
-	});
-	const isHit = result._tag === "IdempotencyHit";
-	return {
-		agentId: isHit ? result.existingAgentId : result.agentId,
-		conversationId,
-		mainAgentId: sessionMapping.mainAgentId,
-		idempotencyKey,
-		idempotencyHit: isHit
-	};
-});
-
-//#endregion
-export { registerAgentEffect };

package/lib/record-session.js

@@ -1,33 +0,0 @@
-import { DataReader, DataStore } from "@vitest-agent/sdk";
-import { Effect } from "effect";
-
-//#region src/lib/record-session.ts
-const recordSessionStart = (input) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const store = yield* DataStore;
-	let parentSessionId;
-	if (input.parentChatId !== void 0) {
-		const parent = yield* reader.getSessionByChatId(input.parentChatId);
-		if (parent._tag === "Some") parentSessionId = parent.value.id;
-	}
-	return { sessionId: yield* store.upsertSession({
-		chatId: input.chatId,
-		project: input.project,
-		cwd: input.cwd,
-		agentKind: input.agentKind,
-		...input.agentType !== void 0 && { agentType: input.agentType },
-		...parentSessionId !== void 0 && { parentSessionId },
-		triageWasNonEmpty: input.triageWasNonEmpty,
-		startedAt: input.startedAt
-	}) };
-});
-const recordSessionEnd = (input) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const store = yield* DataStore;
-	if ((yield* reader.getSessionByChatId(input.chatId))._tag === "None") return yield* Effect.fail(/* @__PURE__ */ new Error(`Unknown chatId: ${input.chatId}`));
-	yield* store.endSession(input.chatId, input.endedAt, input.endReason);
-	return { ok: true };
-});
-
-//#endregion
-export { recordSessionEnd, recordSessionStart };

package/lib/record-tdd-artifact.js

@@ -1,104 +0,0 @@
-import { resolveSessionForRecording } from "./resolve-session-for-recording.js";
-import { DataReader, DataStore } from "@vitest-agent/sdk";
-import { Effect, Option } from "effect";
-
-//#region src/lib/record-tdd-artifact.ts
-/**
-* Resolve (auto-opening a `spike` phase if needed) the current open
-* phase for `tddTaskId`, then write the artifact under it. Shared by
-* both `recordTddArtifactEffect` (chat-id → session → task resolution)
-* and `recordTddArtifactByTaskIdEffect` (explicit task-id escape hatch).
-*/
-const writeArtifactUnderOpenPhase = (tddTaskId, input) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const store = yield* DataStore;
-	const phaseOpt = yield* reader.getCurrentTddPhase(tddTaskId);
-	const phaseId = Option.isSome(phaseOpt) ? phaseOpt.value.id : (yield* store.writeTddPhase({
-		tddTaskId,
-		phase: "spike",
-		startedAt: input.recordedAt,
-		transitionReason: "auto-opened by record tdd-artifact (no prior phase)"
-	})).id;
-	return {
-		id: yield* store.writeTddArtifact({
-			phaseId,
-			artifactKind: input.artifactKind,
-			...input.fileId !== void 0 && { fileId: input.fileId },
-			...input.testCaseId !== void 0 && { testCaseId: input.testCaseId },
-			...input.testRunId !== void 0 && { testRunId: input.testRunId },
-			...input.testFirstFailureRunId !== void 0 && { testFirstFailureRunId: input.testFirstFailureRunId },
-			...input.diffExcerpt !== void 0 && { diffExcerpt: input.diffExcerpt },
-			...input.suite !== void 0 && { suite: input.suite },
-			recordedAt: input.recordedAt
-		}),
-		phaseId
-	};
-});
-const recordTddArtifactEffect = (input) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const session = yield* resolveSessionForRecording({
-		chatId: input.chatId,
-		recordedAt: input.recordedAt,
-		...input.project !== void 0 && { project: input.project },
-		...input.cwd !== void 0 && { cwd: input.cwd }
-	});
-	const openTdd = (yield* reader.listTddTasksForSession(session.id, {
-		walkParents: true,
-		walkConversation: true
-	})).find((t) => t.endedAt === null);
-	if (openTdd === void 0) return yield* Effect.fail(/* @__PURE__ */ new Error(`No open TDD task under chat_id ${input.chatId}. Call tdd_task start first.`));
-	return yield* writeArtifactUnderOpenPhase(openTdd.id, input);
-});
-/**
-* Explicit task-id escape hatch (issue #144). Bypasses `chat_id` →
-* session → task resolution entirely — the caller already knows which
-* TDD task the artifact belongs to (e.g. a hook seeded with
-* `VITEST_AGENT_TDD_TASK_ID` in a detached-session environment where
-* neither the parent walk nor the conversation-id fallback resolves
-* the right task). Fails loudly when the task does not exist or has
-* already ended — writing to a closed task's phase would silently
-* corrupt the evidence trail.
-*/
-const recordTddArtifactByTaskIdEffect = (input) => Effect.gen(function* () {
-	const taskOpt = yield* (yield* DataReader).getTddTaskById(input.tddTaskId);
-	if (Option.isNone(taskOpt)) return yield* Effect.fail(/* @__PURE__ */ new Error(`No TDD task found for id ${input.tddTaskId}.`));
-	if (taskOpt.value.endedAt !== null) return yield* Effect.fail(/* @__PURE__ */ new Error(`TDD task ${input.tddTaskId} has already ended (endedAt=${taskOpt.value.endedAt}).`));
-	return yield* writeArtifactUnderOpenPhase(input.tddTaskId, input);
-});
-/**
-* CLI-command-facing dispatcher (issue #144). Keeps `commands/record.ts`
-* a thin flag-parsing wrapper per this package's convention. `tddTaskId`
-* takes priority when both are supplied — it is the explicit escape
-* hatch and should never silently fall back to (weaker) session
-* resolution.
-*/
-const dispatchRecordTddArtifactEffect = (input) => {
-	if (input.tddTaskId !== void 0) return recordTddArtifactByTaskIdEffect({
-		tddTaskId: input.tddTaskId,
-		artifactKind: input.artifactKind,
-		...input.fileId !== void 0 && { fileId: input.fileId },
-		...input.testCaseId !== void 0 && { testCaseId: input.testCaseId },
-		...input.testRunId !== void 0 && { testRunId: input.testRunId },
-		...input.testFirstFailureRunId !== void 0 && { testFirstFailureRunId: input.testFirstFailureRunId },
-		...input.diffExcerpt !== void 0 && { diffExcerpt: input.diffExcerpt },
-		...input.suite !== void 0 && { suite: input.suite },
-		recordedAt: input.recordedAt
-	});
-	if (input.chatId !== void 0) return recordTddArtifactEffect({
-		chatId: input.chatId,
-		artifactKind: input.artifactKind,
-		...input.fileId !== void 0 && { fileId: input.fileId },
-		...input.testCaseId !== void 0 && { testCaseId: input.testCaseId },
-		...input.testRunId !== void 0 && { testRunId: input.testRunId },
-		...input.testFirstFailureRunId !== void 0 && { testFirstFailureRunId: input.testFirstFailureRunId },
-		...input.diffExcerpt !== void 0 && { diffExcerpt: input.diffExcerpt },
-		...input.suite !== void 0 && { suite: input.suite },
-		recordedAt: input.recordedAt,
-		...input.cwd !== void 0 && { cwd: input.cwd },
-		...input.project !== void 0 && { project: input.project }
-	});
-	return Effect.fail(/* @__PURE__ */ new Error("record tdd-artifact requires either --chat-id or --tdd-task-id."));
-};
-
-//#endregion
-export { dispatchRecordTddArtifactEffect, recordTddArtifactByTaskIdEffect, recordTddArtifactEffect };

package/lib/record-turn.js

@@ -1,44 +0,0 @@
-import { resolveSessionForRecording } from "./resolve-session-for-recording.js";
-import { DataStore, TurnPayload } from "@vitest-agent/sdk";
-import { Effect, Schema } from "effect";
-
-//#region src/lib/record-turn.ts
-const parseAndValidateTurnPayload = (raw) => {
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch (e) {
-		return {
-			ok: false,
-			error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`
-		};
-	}
-	const decoded = Schema.decodeUnknownResult(TurnPayload)(parsed);
-	if (decoded._tag === "Failure") return {
-		ok: false,
-		error: `Invalid TurnPayload: ${decoded.failure.message}`
-	};
-	return {
-		ok: true,
-		payload: decoded.success
-	};
-};
-const recordTurnEffect = (input) => Effect.gen(function* () {
-	const parse = parseAndValidateTurnPayload(input.payloadJson);
-	if (!parse.ok) return yield* Effect.fail(new Error(parse.error));
-	const session = yield* resolveSessionForRecording({
-		chatId: input.chatId,
-		recordedAt: input.occurredAt,
-		...input.project !== void 0 && { project: input.project },
-		...input.cwd !== void 0 && { cwd: input.cwd }
-	});
-	return { turnId: yield* (yield* DataStore).writeTurn({
-		sessionId: session.id,
-		type: parse.payload.type,
-		payload: input.payloadJson,
-		occurredAt: input.occurredAt
-	}) };
-});
-
-//#endregion
-export { parseAndValidateTurnPayload, recordTurnEffect };

package/lib/record-workspace-changes.js

@@ -1,50 +0,0 @@
-import { DataStore } from "@vitest-agent/sdk";
-import { Effect } from "effect";
-import { SqlClient } from "effect/unstable/sql/SqlClient";
-
-//#region src/lib/record-workspace-changes.ts
-/**
-* `ProjectRunSummary` doesn't expose `lastRunId`, so we query it directly
-* via SqlClient. This is the run id of the most-recent test run for a
-* given project (or any project, when `project` is unspecified). Used
-* only as a best-effort association target for `run_changed_files`.
-*/
-const findLatestRunId = (project) => Effect.gen(function* () {
-	const sql = yield* SqlClient;
-	const rows = project !== void 0 ? yield* sql`
-						SELECT id FROM test_runs
-						WHERE project = ${project}
-						ORDER BY timestamp DESC LIMIT 1
-					` : yield* sql`
-						SELECT id FROM test_runs
-						ORDER BY timestamp DESC LIMIT 1
-					`;
-	return rows.length === 0 ? null : rows[0].id;
-}).pipe(Effect.orElseSucceed(() => null));
-const recordRunWorkspaceChangesEffect = (input) => Effect.gen(function* () {
-	const store = yield* DataStore;
-	yield* store.writeCommit({
-		sha: input.sha,
-		...input.parentSha !== void 0 && { parentSha: input.parentSha },
-		...input.message !== void 0 && { message: input.message },
-		...input.author !== void 0 && { author: input.author },
-		...input.committedAt !== void 0 && { committedAt: input.committedAt },
-		...input.branch !== void 0 && { branch: input.branch }
-	});
-	const runId = yield* findLatestRunId(input.project);
-	if (runId !== null && input.files.length > 0) yield* store.writeRunChangedFiles({
-		runId,
-		files: input.files.map((f) => ({
-			filePath: f.filePath,
-			changeKind: f.changeKind,
-			commitSha: input.sha
-		}))
-	});
-	return {
-		sha: input.sha,
-		fileRowsWritten: runId !== null ? input.files.length : 0
-	};
-});
-
-//#endregion
-export { recordRunWorkspaceChangesEffect };

package/lib/resolve-session-for-recording.js

@@ -1,71 +0,0 @@
-import { DataReader, DataStore } from "@vitest-agent/sdk";
-import { Effect, Option } from "effect";
-import { readFileSync } from "node:fs";
-
-//#region src/lib/resolve-session-for-recording.ts
-/**
-* Shared session-resolution helper for hook-driven recording paths.
-*
-* Background: Claude Code can rotate the chat id (host `session_id`)
-* mid-window — after a continuation, compaction, or `/mcp` reconnect —
-* without the `SessionStart` hook firing for the new id. PostToolUse
-* hooks then deliver tool calls under a `chat_id` that has no row in
-* `sessions`, and the strict `getSessionByChatId` lookup fails with
-* "Unknown chat_id". A second flavour of the same bug: the
-* SubagentStart hook mints a synthetic per-dispatch key
-* (`<parentChatId>-subagent-<ts>-<pid>`) for the subagent row, but
-* subsequent PostToolUse hooks under that subagent receive the bare
-* parent chat id. Exact-match lookup of the bare id misses the
-* synthetic suffix.
-*
-* This resolver applies a three-step fallback that recovers either
-* case without crashing the recording path:
-*
-*   1. Exact match by `chat_id`.
-*   2. Prefix match `<chatId>-subagent-` to recover the synthetic
-*      subagent row (most recent first).
-*   3. Idempotent bootstrap of a `main` session row keyed on the
-*      input `chat_id`, so future calls in this window resolve via
-*      step 1.
-*
-* Step 3 means recording paths can no longer fail with "Unknown
-* chat_id". Bootstrapped rows carry `agent_kind = "main"` and
-* `triage_was_non_empty = false` because the SessionStart triage
-* pipeline never ran for them; downstream metrics consumers should
-* treat triage-empty bootstrapped rows the same as any other
-* SessionStart-less row.
-*
-* @packageDocumentation
-*/
-const resolveSessionForRecording = (input) => Effect.gen(function* () {
-	const reader = yield* DataReader;
-	const store = yield* DataStore;
-	const exact = yield* reader.getSessionByChatId(input.chatId);
-	if (Option.isSome(exact)) return exact.value;
-	const synthetic = yield* reader.findSessionsByChatPrefix(`${input.chatId}-subagent-`);
-	if (synthetic.length > 0) return synthetic[0];
-	const cwd = input.cwd ?? process.cwd();
-	const project = input.project ?? readPackageName(cwd) ?? "unknown";
-	yield* store.upsertSession({
-		chatId: input.chatId,
-		project,
-		cwd,
-		agentKind: "main",
-		triageWasNonEmpty: false,
-		startedAt: input.recordedAt
-	});
-	const created = yield* reader.getSessionByChatId(input.chatId);
-	return Option.getOrThrowWith(created, () => /* @__PURE__ */ new Error(`upsertSession succeeded but row not found for ${input.chatId}`));
-});
-const readPackageName = (cwd) => {
-	try {
-		const raw = readFileSync(`${cwd}/package.json`, "utf8");
-		const parsed = JSON.parse(raw);
-		return typeof parsed.name === "string" ? parsed.name : void 0;
-	} catch {
-		return;
-	}
-};
-
-//#endregion
-export { resolveSessionForRecording };

package/lib/sidecar-paths.js

@@ -1,101 +0,0 @@
-import { ProjectIdentityNotResolvableError } from "@vitest-agent/sdk";
-import { Effect } from "effect";
-import { mkdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-//#region src/lib/sidecar-paths.ts
-const APP_NAMESPACE = "vitest-agent";
-/**
-* Filename of the per-project test-data SQLite database.
-*
-* @public
-*/
-const DATA_DB_FILENAME = "data.db";
-/**
-* Filename of the per-client session-map SQLite database.
-*
-* @public
-*/
-const SESSIONS_DB_FILENAME = "sessions.db";
-/**
-* Filename of the global discovery-registry SQLite database.
-*
-* @public
-*/
-const REGISTRY_DB_FILENAME = "registry.db";
-const resolveXdgDataHome = () => {
-	const xdg = process.env.XDG_DATA_HOME;
-	if (xdg !== void 0 && xdg.length > 0) return xdg;
-	return join(homedir(), ".local", "share");
-};
-/**
-* Resolve (and create) the per-project data directory for the supplied
-* normalized `projectKey`. Returns the directory; callers join
-* {@link DATA_DB_FILENAME} onto it for the `data.db` path.
-*
-* @param projectKey - normalized project key (e.g. `@org__pkg`)
-* @returns absolute path to the resolved (and created) data directory
-* @public
-*/
-const resolveProjectDataDir = (projectKey) => {
-	const dir = join(resolveXdgDataHome(), APP_NAMESPACE, projectKey);
-	mkdirSync(dir, { recursive: true });
-	return dir;
-};
-/**
-* Resolve (and create) the directory holding the global `registry.db`.
-* Callers join {@link REGISTRY_DB_FILENAME} onto it.
-*
-* @returns absolute path to the resolved (and created) registry directory
-* @public
-*/
-const resolveRegistryDir = () => {
-	const dir = join(resolveXdgDataHome(), APP_NAMESPACE);
-	mkdirSync(dir, { recursive: true });
-	return dir;
-};
-/**
-* Resolve the per-client `sessions.db` path.
-*
-* Precedence: the `CLAUDE_PLUGIN_DATA` env var, then
-* `VITEST_AGENT_SESSION_MAP_DIR`, then `~/.vitest-agent/`. Fails
-* with `ProjectIdentityNotResolvableError` when no home directory
-* is resolvable.
-*
-* @returns an Effect resolving to the absolute `sessions.db` path
-* @public
-*/
-const resolveSessionMapPath = () => Effect.sync(() => {
-	const claudePluginData = process.env.CLAUDE_PLUGIN_DATA;
-	if (claudePluginData !== void 0 && claudePluginData.length > 0) {
-		mkdirSync(claudePluginData, { recursive: true });
-		return join(claudePluginData, SESSIONS_DB_FILENAME);
-	}
-	const overrideDir = process.env.VITEST_AGENT_SESSION_MAP_DIR;
-	if (overrideDir !== void 0 && overrideDir.length > 0) {
-		mkdirSync(overrideDir, { recursive: true });
-		return join(overrideDir, SESSIONS_DB_FILENAME);
-	}
-	const home = process.env.HOME ?? process.env.USERPROFILE;
-	if (home === void 0 || home.length === 0) return null;
-	const fallbackDir = join(home, ".vitest-agent");
-	mkdirSync(fallbackDir, { recursive: true });
-	return join(fallbackDir, SESSIONS_DB_FILENAME);
-}).pipe(Effect.flatMap((path) => path !== null ? Effect.succeed(path) : Effect.fail(new ProjectIdentityNotResolvableError({ tried: [
-	{
-		source: "CLAUDE_PLUGIN_DATA",
-		reason: "env var not set"
-	},
-	{
-		source: "VITEST_AGENT_SESSION_MAP_DIR",
-		reason: "env var not set"
-	},
-	{
-		source: "HOME",
-		reason: "env var not set (USERPROFILE also unset)"
-	}
-] }))));
-
-//#endregion
-export { DATA_DB_FILENAME, REGISTRY_DB_FILENAME, SESSIONS_DB_FILENAME, resolveProjectDataDir, resolveRegistryDir, resolveSessionMapPath };