@basaltbytes/odoo-agentic-dev 0.1.0-beta.1

package/dist/core/worktree-context.js

@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import { basename } from "node:path";
+import { Effect } from "effect";
+import { ConfigValidationError } from "../errors/errors.js";
+import { deriveDatabaseName } from "./database-name.js";
+import { derivePorts } from "./port-allocator.js";
+import { deriveComposeProjectName } from "./compose-project.js";
+/** Shell `[[ -n ]]` semantics: an empty-string env var counts as unset. */
+const envValue = (env, key) => {
+    const value = env[key];
+    return value === undefined || value === "" ? undefined : value;
+};
+const resolveEnvDatabase = (env) => {
+    const primary = envValue(env, "ODOO_DATABASE");
+    const alias = envValue(env, "E2E_ODOO_DB");
+    if (primary !== undefined && alias !== undefined && primary !== alias) {
+        return Effect.fail(new ConfigValidationError({
+            issues: [
+                `ODOO_DATABASE ("${primary}") and E2E_ODOO_DB ("${alias}") disagree; unset one of them`,
+            ],
+        }));
+    }
+    return Effect.succeed(primary ?? alias);
+};
+const fallbackWorktreeName = (rootDir) => `${basename(rootDir)}-${createHash("sha256").update(rootDir).digest("hex").slice(0, 8)}`;
+export const buildWorktreeContext = (options) => Effect.gen(function* () {
+    const { env, git, recipe, rootDir } = options;
+    const branch = git._tag === "Branch" ? git.branch : undefined;
+    const nameOverride = envValue(env, "ODOO_WORKTREE_NAME");
+    const worktreeName = nameOverride ?? branch ?? fallbackWorktreeName(rootDir);
+    // an explicit ODOO_WORKTREE_NAME also redefines what "branch" means for naming
+    const effectiveBranch = nameOverride ?? branch;
+    const envDatabase = yield* resolveEnvDatabase(env);
+    const databaseName = yield* deriveDatabaseName({
+        branch: effectiveBranch,
+        worktreeName,
+        dbPrefix: recipe.project.dbPrefix,
+        sharedDatabase: recipe.project.sharedDatabase,
+        sharedBranches: recipe.project.sharedBranches,
+        stripBranchPrefixes: recipe.project.stripBranchPrefixes,
+        envDatabase,
+    });
+    const { companionPorts, odooHttpPort } = yield* derivePorts({
+        databaseName,
+        ports: recipe.ports,
+        companionApps: recipe.companionApps,
+        envHttpPort: envValue(env, "ODOO_HTTP_PORT"),
+    });
+    const composeProjectName = yield* deriveComposeProjectName(recipe.project.id, databaseName);
+    const odooBaseUrl = `http://127.0.0.1:${odooHttpPort}`;
+    // env assembly order: canonical → companion vars → aliases
+    const assembled = {
+        ODOO_DATABASE: databaseName,
+        E2E_ODOO_DB: databaseName,
+        ODOO_BASE_URL: odooBaseUrl,
+        ODOO_HTTP_PORT: String(odooHttpPort),
+        ODOO_COMPOSE_PROJECT_NAME: composeProjectName,
+    };
+    for (const app of recipe.companionApps) {
+        const port = companionPorts.get(app.name);
+        if (port === undefined)
+            continue;
+        if (app.portEnv !== undefined)
+            assembled[app.portEnv] = String(port);
+        if (app.urlEnv !== undefined)
+            assembled[app.urlEnv] = `http://localhost:${port}`;
+    }
+    const aliased = {};
+    for (const [alias, target] of Object.entries(recipe.envAliases)) {
+        const value = assembled[target];
+        if (value === undefined) {
+            return yield* Effect.fail(new ConfigValidationError({
+                issues: [
+                    `envAliases: alias "${alias}" targets unknown env key "${target}"; available keys: ${Object.keys(assembled).join(", ")}`,
+                ],
+            }));
+        }
+        aliased[alias] = value;
+    }
+    return {
+        rootDir,
+        worktreeName,
+        branch: branch ?? null,
+        databaseName,
+        composeProjectName,
+        odooHttpPort,
+        odooBaseUrl,
+        companionPorts,
+        env: { ...assembled, ...aliased },
+    };
+});
+/** Replace $NAME tokens with values from `env`; unknown tokens are left intact. */
+export const substituteEnvTokens = (value, env) => value.replace(/\$([A-Z][A-Z0-9_]*)/g, (token, name) => env[name] ?? token);
+//# sourceMappingURL=worktree-context.js.map

package/dist/core/worktree-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-context.js","sourceRoot":"","sources":["../../src/core/worktree-context.ts"],"names":[],"mappings":"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"}

package/dist/errors/errors.d.ts

@@ -0,0 +1,124 @@
+declare const ConfigLoadError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConfigLoadError";
+} & Readonly<A>;
+export declare class ConfigLoadError extends ConfigLoadError_base<{
+    readonly path: string;
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+declare const ConfigValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConfigValidationError";
+} & Readonly<A>;
+export declare class ConfigValidationError extends ConfigValidationError_base<{
+    readonly issues: ReadonlyArray<string>;
+}> {
+    get message(): string;
+}
+declare const GitError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitError";
+} & Readonly<A>;
+export declare class GitError extends GitError_base<{
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+declare const UnsafeDatabaseNameError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "UnsafeDatabaseNameError";
+} & Readonly<A>;
+export declare class UnsafeDatabaseNameError extends UnsafeDatabaseNameError_base<{
+    readonly name: string;
+}> {
+    get message(): string;
+}
+declare const SharedDatabaseProtectionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SharedDatabaseProtectionError";
+} & Readonly<A>;
+export declare class SharedDatabaseProtectionError extends SharedDatabaseProtectionError_base<{
+    readonly database: string;
+    /** the command the user attempted, e.g. "reset-db" */
+    readonly action: string;
+}> {
+    get message(): string;
+}
+declare const DockerUnavailableError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DockerUnavailableError";
+} & Readonly<A>;
+export declare class DockerUnavailableError extends DockerUnavailableError_base<{
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+declare const CommandFailedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CommandFailedError";
+} & Readonly<A>;
+export declare class CommandFailedError extends CommandFailedError_base<{
+    readonly command: string;
+    readonly args: ReadonlyArray<string>;
+    readonly cwd: string | undefined;
+    readonly exitCode: number;
+    readonly stderrTail: string;
+}> {
+    get message(): string;
+}
+declare const ComposeCommandError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ComposeCommandError";
+} & Readonly<A>;
+export declare class ComposeCommandError extends ComposeCommandError_base<{
+    readonly args: ReadonlyArray<string>;
+    readonly exitCode: number;
+    readonly stderrTail: string;
+}> {
+    get message(): string;
+}
+declare const OdooCommandError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "OdooCommandError";
+} & Readonly<A>;
+export declare class OdooCommandError extends OdooCommandError_base<{
+    readonly args: ReadonlyArray<string>;
+    readonly exitCode: number;
+    readonly stderrTail: string;
+}> {
+    get message(): string;
+}
+declare const CompanionProcessError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CompanionProcessError";
+} & Readonly<A>;
+export declare class CompanionProcessError extends CompanionProcessError_base<{
+    readonly name: string;
+    readonly exitCode: number;
+}> {
+    get message(): string;
+}
+declare const SourceResolverError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SourceResolverError";
+} & Readonly<A>;
+export declare class SourceResolverError extends SourceResolverError_base<{
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+declare const StateError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StateError";
+} & Readonly<A>;
+export declare class StateError extends StateError_base<{
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+declare const PortConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "PortConflictError";
+} & Readonly<A>;
+export declare class PortConflictError extends PortConflictError_base<{
+    readonly port: number;
+    /** compose project holding the port, when the state registry knows it */
+    readonly holder: string | null;
+}> {
+    get message(): string;
+}
+export type RuntimeError = ConfigLoadError | ConfigValidationError | GitError | UnsafeDatabaseNameError | SharedDatabaseProtectionError | DockerUnavailableError | CommandFailedError | ComposeCommandError | OdooCommandError | CompanionProcessError | SourceResolverError | StateError | PortConflictError;
+export declare const isRuntimeError: (u: unknown) => u is RuntimeError;
+export declare const renderError: (error: RuntimeError) => string;
+/** Keep only the last `maxLines` lines of process output for error messages. */
+export declare const tail: (text: string, maxLines?: number) => string;
+export {};

package/dist/errors/errors.js

@@ -0,0 +1,129 @@
+import { Data } from "effect";
+export class ConfigLoadError extends Data.TaggedError("ConfigLoadError") {
+    get message() {
+        return this.reason;
+    }
+}
+export class ConfigValidationError extends Data.TaggedError("ConfigValidationError") {
+    // v4 beta TaggedError leaves Error#message empty; expose the issues there so
+    // standard tooling (and assertions on the thrown message) see the details.
+    get message() {
+        return this.issues.join("; ");
+    }
+}
+export class GitError extends Data.TaggedError("GitError") {
+    get message() {
+        return this.reason;
+    }
+}
+export class UnsafeDatabaseNameError extends Data.TaggedError("UnsafeDatabaseNameError") {
+    get message() {
+        return `unsafe database name: "${this.name}"`;
+    }
+}
+export class SharedDatabaseProtectionError extends Data.TaggedError("SharedDatabaseProtectionError") {
+    get message() {
+        return `refusing to touch shared database "${this.database}" (re-run ${this.action} with --allow-shared)`;
+    }
+}
+export class DockerUnavailableError extends Data.TaggedError("DockerUnavailableError") {
+    get message() {
+        return this.reason;
+    }
+}
+export class CommandFailedError extends Data.TaggedError("CommandFailedError") {
+    get message() {
+        return `${this.command} ${this.args.join(" ")} exited ${this.exitCode}: ${this.stderrTail}`;
+    }
+}
+export class ComposeCommandError extends Data.TaggedError("ComposeCommandError") {
+    get message() {
+        return `docker ${this.args.join(" ")} exited ${this.exitCode}: ${this.stderrTail}`;
+    }
+}
+export class OdooCommandError extends Data.TaggedError("OdooCommandError") {
+    get message() {
+        return `docker ${this.args.join(" ")} exited ${this.exitCode}: ${this.stderrTail}`;
+    }
+}
+export class CompanionProcessError extends Data.TaggedError("CompanionProcessError") {
+    get message() {
+        return `companion "${this.name}" exited ${this.exitCode}`;
+    }
+}
+export class SourceResolverError extends Data.TaggedError("SourceResolverError") {
+    get message() {
+        return this.reason;
+    }
+}
+export class StateError extends Data.TaggedError("StateError") {
+    get message() {
+        return this.reason;
+    }
+}
+export class PortConflictError extends Data.TaggedError("PortConflictError") {
+    get message() {
+        return this.holder === null
+            ? `port ${this.port} is already in use`
+            : `port ${this.port} is already in use by "${this.holder}"`;
+    }
+}
+const RUNTIME_ERROR_TAGS = new Set([
+    "ConfigLoadError",
+    "ConfigValidationError",
+    "GitError",
+    "UnsafeDatabaseNameError",
+    "SharedDatabaseProtectionError",
+    "DockerUnavailableError",
+    "CommandFailedError",
+    "ComposeCommandError",
+    "OdooCommandError",
+    "CompanionProcessError",
+    "SourceResolverError",
+    "StateError",
+    "PortConflictError",
+]);
+export const isRuntimeError = (u) => typeof u === "object" &&
+    u !== null &&
+    "_tag" in u &&
+    RUNTIME_ERROR_TAGS.has(u._tag);
+const lines = (...xs) => xs.join("\n");
+export const renderError = (error) => {
+    switch (error._tag) {
+        case "ConfigLoadError":
+            return lines(`Could not load config: ${error.path}`, `Reason: ${error.reason}`, `Next: check the file exists and its default export is defineConfig({...}).`);
+        case "ConfigValidationError":
+            return lines("Invalid odoo-agentic-dev config:", ...error.issues.map((issue) => `  - ${issue}`), "Next: fix the config file and re-run.");
+        case "GitError":
+            return lines(`Git inspection failed: ${error.reason}`, "Next: run the command inside the project worktree.");
+        case "UnsafeDatabaseNameError":
+            return lines(`Refusing unsafe database name: "${error.name}"`, "Database names must match ^[a-z][a-z0-9_]*$ and be at most 63 characters.", "Next: rename the branch or set ODOO_DATABASE to a safe name.");
+        case "SharedDatabaseProtectionError":
+            return lines(`Refusing to touch the shared database "${error.database}".`, `Next: re-run \`odoo-agentic-dev ${error.action} --allow-shared\` if you really mean it.`);
+        case "DockerUnavailableError":
+            return lines(`Docker is not available: ${error.reason}`, "Next: start Docker Desktop / the docker daemon and retry.");
+        case "CommandFailedError":
+            return lines(`Command failed (exit ${error.exitCode}): ${[error.command, ...error.args].join(" ")}`, `Working directory: ${error.cwd ?? process.cwd()}`, error.stderrTail.length > 0 ? `stderr (tail):\n${error.stderrTail}` : "stderr: (empty)", "Next: re-run the command above manually to investigate.");
+        case "ComposeCommandError":
+            return lines(`docker compose failed (exit ${error.exitCode}): docker ${error.args.join(" ")}`, error.stderrTail.length > 0 ? `stderr (tail):\n${error.stderrTail}` : "stderr: (empty)", "Next: check container logs with `odoo-agentic-dev up --logs`.");
+        case "OdooCommandError":
+            return lines(`Odoo command failed (exit ${error.exitCode}): docker ${error.args.join(" ")}`, error.stderrTail.length > 0 ? `output (tail):\n${error.stderrTail}` : "output: (empty)", "Next: inspect the Odoo log output above.");
+        case "CompanionProcessError":
+            return lines(`Companion app "${error.name}" exited with code ${error.exitCode}.`, "Next: check its logs above; other processes were stopped.");
+        case "SourceResolverError":
+            return lines(`Could not resolve Odoo source: ${error.reason}`, "Next: pass --target <path> or set odoo.source in the config.");
+        case "StateError":
+            return lines(`State registry error: ${error.reason}`, "Next: check the state database file (default ~/.local/share/odoo-agentic-dev/state.db,", "overridable via ODOO_AGENTIC_DEV_STATE_DB) and retry.");
+        case "PortConflictError":
+            return lines(error.holder === null
+                ? `Port ${error.port} is already in use by another process.`
+                : `Port ${error.port} is already in use by the "${error.holder}" stack.`, "Next: set ODOO_HTTP_PORT to a free port, or run `odoo-agentic-dev prune` to", "clean up environments you no longer need.");
+    }
+};
+/** Keep only the last `maxLines` lines of process output for error messages. */
+export const tail = (text, maxLines = 20) => text
+    .split(/\r?\n/)
+    .filter((l) => l.length > 0)
+    .slice(-maxLines)
+    .join("\n");
+//# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { CANONICAL_ENV_VARS, defineConfig } from "./core/project-recipe.js";
+export type { CanonicalEnvVar, CompanionAppConfig, OdooAddonMount, OdooAgenticDevConfig, OdooAgenticDevConfigInput, OdooDatabaseConfig, OdooProjectConfig, OdooRuntimeConfig, PackageManagerStep, PostInitHook, } from "./core/project-recipe.js";
+export type { PortHashAlgorithm } from "./core/port-allocator.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CANONICAL_ENV_VARS, defineConfig } from "./core/project-recipe.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/platform/command-runner.d.ts

@@ -0,0 +1,30 @@
+import { Context, Effect, Layer } from "effect";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { CommandFailedError } from "../errors/errors.js";
+export type ExecSpec = {
+    readonly command: string;
+    readonly args: ReadonlyArray<string>;
+    readonly cwd?: string | undefined;
+    /** merged over the parent process env */
+    readonly env?: Record<string, string> | undefined;
+    readonly stdin?: string | undefined;
+    /** line prefix for runInherited streaming, e.g. "[pwa] " */
+    readonly prefix?: string | undefined;
+};
+export type ExecResult = {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export interface CommandRunnerApi {
+    /** Run to completion capturing output. Non-zero exits RESOLVE (callers decide). Spawn failures FAIL. */
+    readonly run: (spec: ExecSpec) => Effect.Effect<ExecResult, CommandFailedError>;
+    /** Run streaming output lines to this process's stdout (with optional prefix). Resolves with exit code. */
+    readonly runInherited: (spec: ExecSpec) => Effect.Effect<number, CommandFailedError>;
+    /** Full stdio inheritance (TTY passthrough) for interactive children. Resolves with exit code. */
+    readonly runInteractive: (spec: ExecSpec) => Effect.Effect<number, CommandFailedError>;
+}
+export declare const CommandRunner: Context.Service<CommandRunnerApi, CommandRunnerApi>;
+/** runInherited, but a non-zero exit becomes a typed CommandFailedError. */
+export declare const runInheritedOrFail: (runner: CommandRunnerApi, spec: ExecSpec) => Effect.Effect<void, CommandFailedError>;
+export declare const CommandRunnerLive: Layer.Layer<CommandRunnerApi, never, ChildProcessSpawner.ChildProcessSpawner>;

package/dist/platform/command-runner.js

@@ -0,0 +1,65 @@
+import { Context, Effect, Layer, Stream } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { CommandFailedError, tail } from "../errors/errors.js";
+export const CommandRunner = Context.Service("odoo-agentic-dev/CommandRunner");
+/** runInherited, but a non-zero exit becomes a typed CommandFailedError. */
+export const runInheritedOrFail = (runner, spec) => runner.runInherited(spec).pipe(Effect.flatMap((exitCode) => exitCode === 0
+    ? Effect.void
+    : Effect.fail(new CommandFailedError({
+        command: spec.command,
+        args: spec.args,
+        cwd: spec.cwd,
+        exitCode,
+        stderrTail: "",
+    }))));
+const collectText = (stream) => stream.pipe(Stream.decodeText(), Stream.mkString);
+export const CommandRunnerLive = Layer.effect(CommandRunner, Effect.gen(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const spawn = (spec) => ChildProcess.make(spec.command, [...spec.args], {
+        cwd: spec.cwd,
+        env: spec.env,
+        extendEnv: true,
+        // the spawner pipes a stdin Stream into the child and closes stdin when done
+        stdin: spec.stdin === undefined
+            ? "ignore"
+            : Stream.succeed(new TextEncoder().encode(spec.stdin)),
+    });
+    const toFailure = (spec) => (cause) => new CommandFailedError({
+        command: spec.command,
+        args: spec.args,
+        cwd: spec.cwd,
+        exitCode: -1,
+        stderrTail: tail(String(cause)),
+    });
+    const run = (spec) => Effect.scoped(Effect.gen(function* () {
+        const handle = yield* spawn(spec);
+        const [stdout, stderr, exitCode] = yield* Effect.all([collectText(handle.stdout), collectText(handle.stderr), handle.exitCode], { concurrency: "unbounded" });
+        return { exitCode: Number(exitCode), stdout, stderr };
+    })).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner), Effect.catch((cause) => Effect.fail(toFailure(spec)(cause))));
+    const runInherited = (spec) => Effect.scoped(Effect.gen(function* () {
+        const handle = yield* spawn(spec);
+        const prefix = spec.prefix ?? "";
+        const echo = handle.all.pipe(Stream.decodeText(), Stream.splitLines, Stream.runForEach((line) => Effect.sync(() => {
+            process.stdout.write(`${prefix}${line}\n`);
+        })));
+        const [, exitCode] = yield* Effect.all([echo, handle.exitCode], {
+            concurrency: "unbounded",
+        });
+        return Number(exitCode);
+    })).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner), Effect.catch((cause) => Effect.fail(toFailure(spec)(cause))));
+    // verified v4 beta fact: ChildProcess CommandOptions accept "inherit" for
+    // stdin/stdout/stderr, so interactive passthrough needs no spawn fallback
+    const runInteractive = (spec) => Effect.scoped(Effect.gen(function* () {
+        const handle = yield* ChildProcess.make(spec.command, [...spec.args], {
+            cwd: spec.cwd,
+            env: spec.env,
+            extendEnv: true,
+            stdin: "inherit",
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+        return Number(yield* handle.exitCode);
+    })).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner), Effect.catch((cause) => Effect.fail(toFailure(spec)(cause))));
+    return { run, runInherited, runInteractive };
+}));
+//# sourceMappingURL=command-runner.js.map

package/dist/platform/command-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-runner.js","sourceRoot":"","sources":["../../src/platform/command-runner.ts"],"names":[],"mappings":"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"}

package/dist/platform/docker-compose.d.ts

@@ -0,0 +1,69 @@
+import { Context, Effect, Layer } from "effect";
+import { ComposeCommandError, DockerUnavailableError } from "../errors/errors.js";
+import type { OdooAgenticDevConfig } from "../core/project-recipe.js";
+import type { WorktreeContext } from "../core/worktree-context.js";
+import type { ExecResult } from "./command-runner.js";
+export type ComposeRef = {
+    readonly projectName: string;
+    readonly composeFile: string;
+    readonly projectDir: string;
+    /**
+     * Context env handed to every compose subprocess (merged over the parent
+     * env): project-supplied compose files interpolate `${ODOO_DATABASE:?}` /
+     * `${ODOO_HTTP_PORT:?}` and would fail without it.
+     */
+    readonly env: Record<string, string>;
+};
+export declare const composeArgs: (ref: ComposeRef, rest: ReadonlyArray<string>) => Array<string>;
+export type ComposeProject = {
+    readonly name: string;
+    readonly running: boolean;
+};
+/** Identity labels read back from a container the generated compose stamped. */
+export type LabeledContainer = {
+    readonly composeProject: string;
+    readonly projectId: string | null;
+    readonly database: string | null;
+    readonly rootDir: string | null;
+    /** raw label value: "" means "no branch" (callers map it back to null) */
+    readonly branch: string | null;
+};
+export interface DockerComposeApi {
+    readonly ensureAvailable: () => Effect.Effect<void, DockerUnavailableError>;
+    /** All compose projects on this docker host (`docker compose ls -a`). */
+    readonly listProjects: () => Effect.Effect<ReadonlyArray<ComposeProject>, ComposeCommandError>;
+    /** All containers stamped with our oad labels, deduped per compose project. */
+    readonly listLabeledContainers: () => Effect.Effect<ReadonlyArray<LabeledContainer>, ComposeCommandError>;
+    /**
+     * Label-based teardown that works without the original compose file:
+     * `docker rm -f` every container of the project, then remove its volumes.
+     */
+    readonly removeByLabel: (composeProject: string) => Effect.Effect<void, ComposeCommandError>;
+    /** Write the generated compose file (or resolve the project-supplied one). */
+    readonly prepareComposeFile: (recipe: OdooAgenticDevConfig, ctx: WorktreeContext) => Effect.Effect<ComposeRef, ComposeCommandError>;
+    /** Captured run (optionally fed stdin); fails ComposeCommandError on non-zero exit. */
+    readonly run: (ref: ComposeRef, args: ReadonlyArray<string>, stdin?: string) => Effect.Effect<ExecResult, ComposeCommandError>;
+    /** Streamed to our stdout; fails ComposeCommandError on non-zero exit. */
+    readonly stream: (ref: ComposeRef, args: ReadonlyArray<string>) => Effect.Effect<void, ComposeCommandError>;
+    /** Captured run returning the result even on non-zero exit (for polling). */
+    readonly tryRun: (ref: ComposeRef, args: ReadonlyArray<string>) => Effect.Effect<ExecResult, ComposeCommandError>;
+    readonly waitForDb: (ref: ComposeRef, dbService: string, options?: {
+        readonly intervalMillis?: number;
+        readonly maxAttempts?: number;
+    }) => Effect.Effect<void, ComposeCommandError>;
+}
+export declare const DockerCompose: Context.Service<DockerComposeApi, DockerComposeApi>;
+/**
+ * Lenient parse of `docker compose ls -a --format json`: an array of
+ * `{ Name, Status, ConfigFiles }` where Status reads like "running(2)" or
+ * "exited(2)". Anything unrecognized is skipped rather than fatal.
+ */
+export declare const parseComposeLs: (stdout: string) => Array<ComposeProject>;
+/**
+ * Lenient parse of `docker ps --format json` output (NDJSON, one container per
+ * line; a top-level array is tolerated). `Labels` is a comma-joined `k=v`
+ * string, so label values containing commas are truncated — acceptable for the
+ * best-effort adoption this feeds. Unparseable lines are skipped.
+ */
+export declare const parseLabeledPs: (stdout: string) => Array<LabeledContainer>;
+export declare const DockerComposeLive: Layer.Layer<DockerComposeApi, never, import("./command-runner.js").CommandRunnerApi>;