@cat-factory/integrations 0.38.0 → 0.39.0

package/dist/index.d.ts

@@ -73,6 +73,10 @@ export { KubernetesApiClient, type KubernetesClientConfig, } from './modules/kub
 export { KubernetesEnvironmentProvider } from './modules/kubernetes/KubernetesEnvironmentProvider.js';
 export * as kubernetesLogic from './modules/kubernetes/kubernetes.logic.js';
 export * as kubernetesEnvironmentLogic from './modules/kubernetes/kubernetes-environment.logic.js';
+export { ComposeEnvironmentProvider, type ComposeEnvironmentProviderOptions, } from './modules/compose/ComposeEnvironmentProvider.js';
+export { composeEnvironmentBackend } from './modules/compose/compose-environment-backend.js';
+export { type ComposeRuntime, type ComposeExecResult, type ComposeEnvironmentConfig, } from './modules/compose/compose-environment.logic.js';
+export * as composeEnvironmentLogic from './modules/compose/compose-environment.logic.js';
 export { ProvisioningLogRecorder, ProvisioningLogService, PROVISIONING_LOG_MAX_LIMIT, type ProvisioningLogEvent, type ProvisioningLogRecorderDependencies, type ProvisioningLogServiceDependencies, } from './modules/provisioning-logs/ProvisioningLogService.js';
 export { LoggingRunnerTransport, type LoggingRunnerTransportOptions, } from './modules/provisioning-logs/LoggingRunnerTransport.js';
 export { redactSecrets } from './modules/provisioning-logs/redact.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -98,6 +98,16 @@ export { KubernetesApiClient, } from './modules/kubernetes/KubernetesApiClient.j
 export { KubernetesEnvironmentProvider } from './modules/kubernetes/KubernetesEnvironmentProvider.js';
 export * as kubernetesLogic from './modules/kubernetes/kubernetes.logic.js';
 export * as kubernetesEnvironmentLogic from './modules/kubernetes/kubernetes-environment.logic.js';
+// The Docker Compose environment backend: a host-daemon `EnvironmentProvider` (the Checkbox
+// compose-stack mechanic) registered BY REFERENCE from the LOCAL facade only — it drives the
+// host docker CLI on the Docker-family local runtimes, which is a local-mode construct (the
+// plain Node service has no per-run container runtime, and the Worker has no host daemon).
+// `composeEnvironmentBackend(runtime)` closes over the facade's docker CLI seam; the provider +
+// pure logic are exported for tests + facade wiring.
+export { ComposeEnvironmentProvider, } from './modules/compose/ComposeEnvironmentProvider.js';
+export { composeEnvironmentBackend } from './modules/compose/compose-environment-backend.js';
+export {} from './modules/compose/compose-environment.logic.js';
+export * as composeEnvironmentLogic from './modules/compose/compose-environment.logic.js';
 // Unified provisioning event log: the best-effort recorder every spin-up/down site
 // writes through, and the read service behind the "View logs" drawers + run details.
 export { ProvisioningLogRecorder, ProvisioningLogService, PROVISIONING_LOG_MAX_LIMIT, } from './modules/provisioning-logs/ProvisioningLogService.js';

package/dist/index.js.map

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

package/dist/modules/compose/ComposeEnvironmentProvider.d.ts

@@ -0,0 +1,38 @@
+import type { ConnectionTestResult, EnvironmentConnectionTestRequest, EnvironmentProvider, EnvironmentStatus, EnvironmentStatusRequest, EnvironmentTeardownRequest, ProviderConfigField, ProvisionEnvironmentRequest, ProvisionedEnvironment } from '@cat-factory/kernel';
+import { type ComposeRuntime } from './compose-environment.logic.js';
+export interface ComposeEnvironmentProviderOptions {
+    /** Reserved for future URL-policy-aware behaviour; unused today (the URL is always localhost). */
+    urlPolicy?: unknown;
+}
+export declare class ComposeEnvironmentProvider implements EnvironmentProvider {
+    private readonly runtime;
+    private readonly options;
+    constructor(runtime: ComposeRuntime, options?: ComposeEnvironmentProviderOptions);
+    provision(req: ProvisionEnvironmentRequest): Promise<ProvisionedEnvironment>;
+    status(req: EnvironmentStatusRequest): Promise<ProvisionedEnvironment>;
+    teardown(req: EnvironmentTeardownRequest): Promise<{
+        status: EnvironmentStatus;
+    }>;
+    testConnection(_req: EnvironmentConnectionTestRequest): Promise<ConnectionTestResult>;
+    describeConfig(): ProviderConfigField[];
+    describeManifestTemplate(): {
+        providerId: string;
+        label: string;
+        baseUrl: string;
+        auth: {
+            type: 'none';
+        };
+        provision: {
+            method: 'POST';
+            pathTemplate: string;
+        };
+        response: {};
+        providerConfig: {};
+    };
+    private failed;
+    /** `down -v` is idempotent (a missing project is a no-op); swallow its result. */
+    private safeDown;
+    /** Read the compose file from the configured source (co-located PR repo or a separate repo). */
+    private readComposeFile;
+}
+//# sourceMappingURL=ComposeEnvironmentProvider.d.ts.map

package/dist/modules/compose/ComposeEnvironmentProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposeEnvironmentProvider.d.ts","sourceRoot":"","sources":["../../../src/modules/compose/ComposeEnvironmentProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gCAAgC,EAChC,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EAEvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAEL,KAAK,cAAc,EAUpB,MAAM,gCAAgC,CAAA;AA0BvC,MAAM,WAAW,iCAAiC;IAChD,kGAAkG;IAClG,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,qBAAa,0BAA2B,YAAW,mBAAmB;IAElE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,YACmB,OAAO,EAAE,cAAc,EAEvB,OAAO,GAAE,iCAAsC,EAC9D;IAEE,SAAS,CAAC,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DjF;IAEK,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0B3E;IAEK,QAAQ,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE,CAAC,CAMtF;IAEK,cAAc,CAAC,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+B1F;IAED,cAAc,IAAI,mBAAmB,EAAE,CAmDtC;IAED,wBAAwB;QAEpB,UAAU;QACV,KAAK;QACL,OAAO;QACP,IAAI;YAAI,IAAI,EAAE,MAAM;;QACpB,SAAS;YAAI,MAAM,EAAE,MAAM;YAAW,YAAY;;QAClD,QAAQ;QACR,cAAc;MAEjB;IAID,OAAO,CAAC,MAAM;IAYd,kFAAkF;YACpE,QAAQ;IAUtB,gGAAgG;YAClF,eAAe;CA4B9B"}

package/dist/modules/compose/ComposeEnvironmentProvider.js

@@ -0,0 +1,260 @@
+import { classifyComposePs, parseComposeEnvConfig, parseHostPort, prepareComposeProject, renderEnvMap, renderTemplate, resolveProjectName, tailOutput, templateVars, } from './compose-environment.logic.js';
+// Native Docker Compose ephemeral-environment provider. It brings the PR repo's OWN
+// `docker-compose.yml` up on a local Docker daemon under a per-PR project name, publishes the
+// configured web service's port to an ephemeral host port, and returns `http://localhost:<port>`
+// for the Tester to run against — the Checkbox compose-stack mechanic. Teardown is a single
+// project `down -v`. Daemon access is the injected `ComposeRuntime` (the local facade wires the
+// docker CLI), so this stays runtime-neutral; it is registered only where a daemon exists
+// (local/Node), never the Cloudflare Worker.
+//
+// The repo compose file is read checkout-free (no working tree) and rewritten into ONE
+// isolation-safe project file before `up` (`prepareComposeProject`): host ports forced ephemeral
+// so concurrent per-PR stacks never collide, the probed service guaranteed to publish its port,
+// and references that can't be honored (build contexts / host bind mounts / relative env_files /
+// privileged) refused up front instead of silently mis-mounting.
+//
+// Per-workspace config rides the stored manifest's `providerConfig` (parsed here); there are no
+// secrets. The provider is a stateless singleton — every call re-reads the config + project from
+// the request, so one instance serves every workspace.
+const WAIT_TIMEOUT_S = 300;
+// Bound for the plain compose calls (port / ps / down / version-probe) so a wedged daemon can't
+// hang a provision/status/teardown forever; `up` gets a longer bound that clears its own --wait.
+const SHORT_TIMEOUT_MS = 60_000;
+const UP_TIMEOUT_MS = (WAIT_TIMEOUT_S + 30) * 1000;
+export class ComposeEnvironmentProvider {
+    runtime;
+    options;
+    constructor(runtime, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    options = {}) {
+        this.runtime = runtime;
+        this.options = options;
+    }
+    async provision(req) {
+        const config = parseComposeEnvConfig(req.manifest);
+        const inputs = req.inputs;
+        const project = resolveProjectName(config, inputs);
+        const image = config.imageTemplate ? renderTemplate(config.imageTemplate, inputs) : undefined;
+        const vars = templateVars(inputs, project, image);
+        const composeText = renderTemplate(await this.readComposeFile(req, config), vars);
+        // Rewrite the repo compose into one isolation-safe project file (ephemeral host ports, the
+        // probed service guaranteed to publish, unsupported references rejected). A blocking issue
+        // surfaces as a deterministic failure BEFORE we touch the daemon.
+        const prepared = prepareComposeProject(composeText, config.service, config.port);
+        if (prepared.issues.length > 0) {
+            return this.failed(project, `This Docker Compose stack can't be provisioned as a preview env:\n- ${prepared.issues.join('\n- ')}`);
+        }
+        const basePath = await this.runtime.writeProjectFile(project, 'compose.yaml', prepared.content);
+        const files = ['-f', basePath];
+        const env = config.envTemplate ? renderEnvMap(config.envTemplate, vars) : undefined;
+        const up = await this.runtime.compose(['-p', project, ...files, 'up', '-d', '--wait', '--wait-timeout', String(WAIT_TIMEOUT_S)], { env, timeoutMs: UP_TIMEOUT_MS });
+        if (up.code !== 0) {
+            // Best-effort cleanup so a retry starts from a clean slate, then surface the verbatim
+            // compose error as a deterministic (non-throwing) failure → `step.environment.lastError`.
+            await this.safeDown(project);
+            return this.failed(project, tailOutput(up.stderr || up.stdout) || 'docker compose up failed');
+        }
+        const portRes = await this.runtime.compose(['-p', project, ...files, 'port', config.service, String(config.port)], { env, timeoutMs: SHORT_TIMEOUT_MS });
+        const hostPort = parseHostPort(portRes.stdout);
+        if (hostPort === null) {
+            await this.safeDown(project);
+            return this.failed(project, `Service '${config.service}' does not publish container port ${config.port}; cannot resolve a preview URL`);
+        }
+        const scheme = config.scheme ?? 'http';
+        const url = `${scheme}://localhost:${hostPort}`;
+        return {
+            externalId: project,
+            url,
+            status: 'ready',
+            // Auto-teardown TTL (the connect form's `ttlMinutes`, default 2h) so a forgotten preview
+            // env is swept off the host instead of leaking containers + volumes forever. Null ⇒ the
+            // operator chose "never expire" (teardown still runs on demand / at run end).
+            expiresAt: config.defaultTtlMs ? Date.now() + config.defaultTtlMs : null,
+            access: null,
+            // `status()`/`teardown()` re-derive everything from `project`; the URL is captured here so
+            // a later status poll returns it without re-running `compose port` (which needs the files).
+            fields: { project, url, hostPort: String(hostPort), scheme },
+        };
+    }
+    async status(req) {
+        const project = req.provisionFields.project ?? req.externalId;
+        if (!project) {
+            return {
+                externalId: null,
+                url: null,
+                status: 'failed',
+                expiresAt: null,
+                access: null,
+                fields: {},
+            };
+        }
+        // `-a` so a container that's briefly recreating (or a completed one-shot) is still visible —
+        // an empty default `ps` would otherwise flip a healthy env to `failed` mid-recreate.
+        const ps = await this.runtime.compose(['-p', project, 'ps', '-a', '--format', 'json'], {
+            timeoutMs: SHORT_TIMEOUT_MS,
+        });
+        const status = ps.code === 0 ? classifyComposePs(ps.stdout) : 'provisioning';
+        return {
+            externalId: project,
+            url: req.provisionFields.url ?? null,
+            status,
+            expiresAt: null,
+            access: null,
+            fields: req.provisionFields,
+        };
+    }
+    async teardown(req) {
+        const project = req.provisionFields.project ?? req.externalId;
+        if (!project)
+            return { status: 'torn_down' };
+        await this.safeDown(project);
+        await this.runtime.cleanupProject?.(project);
+        return { status: 'torn_down' };
+    }
+    async testConnection(_req) {
+        try {
+            const version = await this.runtime.compose(['version', '--short'], {
+                timeoutMs: SHORT_TIMEOUT_MS,
+            });
+            if (version.code !== 0) {
+                return {
+                    ok: false,
+                    message: tailOutput(version.stderr || version.stdout) || 'docker compose unavailable',
+                };
+            }
+            // `version --short` is a client-only call and succeeds even with the daemon stopped, so it
+            // can't confirm reachability on its own. `compose ls` actually contacts the daemon — only a
+            // success there means a real provision could run.
+            const ls = await this.runtime.compose(['ls', '--format', 'json'], {
+                timeoutMs: SHORT_TIMEOUT_MS,
+            });
+            if (ls.code !== 0) {
+                return {
+                    ok: false,
+                    message: tailOutput(ls.stderr || ls.stdout) || 'Docker daemon is not reachable',
+                };
+            }
+            const v = version.stdout.trim();
+            return {
+                ok: true,
+                message: v ? `Docker Compose ${v} reachable.` : 'Docker Compose reachable.',
+            };
+        }
+        catch (err) {
+            return { ok: false, message: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    describeConfig() {
+        // Flat, descriptor-driven connect form (the SPA overlays these onto the manifest's
+        // providerConfig). `service` + `port` are required, so the unconfigured banner stays lit
+        // until they're set (the local preset prefills them). No secret — Compose stacks need none.
+        return [
+            {
+                key: 'composePath',
+                label: 'Compose file path',
+                default: 'docker-compose.yml',
+                help: 'Path to the compose file in the PR repo (read at the PR head branch).',
+            },
+            {
+                key: 'composeRepo',
+                label: 'Separate repo (optional)',
+                placeholder: 'owner/repo',
+                help: 'Read the compose file from a different repo instead of the PR repo.',
+            },
+            { key: 'composeRef', label: 'Separate repo ref (optional)', placeholder: 'main' },
+            {
+                key: 'service',
+                label: 'Web service name',
+                required: true,
+                placeholder: 'web',
+                help: 'The compose service whose port becomes the preview URL.',
+            },
+            {
+                key: 'port',
+                label: 'Container port',
+                required: true,
+                placeholder: '8080',
+                help: 'The in-container port to publish to an ephemeral host port + probe. Image-based stacks only (v1) — a service that builds from source is not yet supported.',
+            },
+            { key: 'scheme', label: 'URL scheme', default: 'http' },
+            {
+                key: 'projectTemplate',
+                label: 'Project name template (optional)',
+                placeholder: 'cf-env-{{pullNumber}}',
+                help: 'Defaults to cf-env-<repo>-<pullNumber>. Drives COMPOSE_PROJECT_NAME (per-PR isolation).',
+            },
+            {
+                key: 'imageTemplate',
+                label: 'Image override (optional)',
+                help: 'Made available to the compose file as {{image}} (e.g. a CI-built tag).',
+            },
+            {
+                key: 'ttlMinutes',
+                label: 'Auto-teardown after (minutes)',
+                default: '120',
+                help: 'The stack is swept + torn down this many minutes after it comes up, so a forgotten preview env does not leak containers + volumes on the host. 0 = never expire (teardown still runs on demand / at run end).',
+            },
+        ];
+    }
+    describeManifestTemplate() {
+        return {
+            providerId: 'compose',
+            label: 'Docker Compose',
+            baseUrl: 'http://localhost',
+            auth: { type: 'none' },
+            provision: { method: 'POST', pathTemplate: '' },
+            response: {},
+            providerConfig: {},
+        };
+    }
+    // --- internals ----------------------------------------------------------
+    failed(project, error) {
+        return {
+            externalId: project,
+            url: null,
+            status: 'failed',
+            expiresAt: null,
+            access: null,
+            fields: { project },
+            error,
+        };
+    }
+    /** `down -v` is idempotent (a missing project is a no-op); swallow its result. */
+    async safeDown(project) {
+        try {
+            await this.runtime.compose(['-p', project, 'down', '-v', '--remove-orphans'], {
+                timeoutMs: SHORT_TIMEOUT_MS,
+            });
+        }
+        catch {
+            // teardown is best-effort; the registry tombstones the record regardless.
+        }
+    }
+    /** Read the compose file from the configured source (co-located PR repo or a separate repo). */
+    async readComposeFile(req, config) {
+        let ctx;
+        let ref;
+        if (!config.composeRepo) {
+            ctx = req.runRepo ?? null;
+            if (!ctx) {
+                throw new Error('A co-located docker-compose file requires the run repo (is the VCS connected?)');
+            }
+            ref = req.inputs.branch || ctx.baseBranch;
+        }
+        else {
+            const [owner, repo] = config.composeRepo.split('/');
+            ctx =
+                (await req.resolveRepoFiles?.({ owner: owner, repo: repo, ref: config.composeRef })) ??
+                    null;
+            if (!ctx) {
+                throw new Error(`Could not resolve the compose repo '${config.composeRepo}'`);
+            }
+            ref = config.composeRef || ctx.baseBranch;
+        }
+        const file = await ctx.repo.getFile(config.composePath, ref);
+        if (!file)
+            throw new Error(`No docker-compose file found at '${config.composePath}'`);
+        return file.content;
+    }
+}
+//# sourceMappingURL=ComposeEnvironmentProvider.js.map

package/dist/modules/compose/ComposeEnvironmentProvider.js.map

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

package/dist/modules/compose/compose-environment-backend.d.ts

@@ -0,0 +1,5 @@
+import { type ComposeRuntime } from './compose-environment.logic.js';
+import type { EnvironmentBackendProvider } from '../environments/environment-backends.js';
+/** Build the Compose environment backend over a host `ComposeRuntime` (the docker CLI seam). */
+export declare function composeEnvironmentBackend(runtime: ComposeRuntime): EnvironmentBackendProvider;
+//# sourceMappingURL=compose-environment-backend.d.ts.map

package/dist/modules/compose/compose-environment-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-environment-backend.d.ts","sourceRoot":"","sources":["../../../src/modules/compose/compose-environment-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,gCAAgC,CAAA;AAI3F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AAazF,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,0BAA0B,CA6B7F"}

package/dist/modules/compose/compose-environment-backend.js

@@ -0,0 +1,48 @@
+import { ValidationError } from '@cat-factory/kernel';
+import { ComposeEnvironmentProvider } from './ComposeEnvironmentProvider.js';
+import { parseComposeEnvConfig } from './compose-environment.logic.js';
+// The Docker Compose environment backend. Unlike the built-in `manifest`/`kubernetes` backends,
+// it is NOT in the default registry: it needs a host Docker daemon, so the LOCAL facade registers
+// it BY REFERENCE, closing over a `ComposeRuntime` that drives the docker CLI. The plain Node
+// service (no per-run container runtime) and the Cloudflare Worker (no daemon) never register it
+// — the documented runtime-bound asymmetry.
+//
+// It rides the contract's generic environment-backend manifest member (kind `compose` is not a
+// reserved built-in), so it needs no new config variant, no table, and no migration: the flat
+// config lives in the stored manifest's `providerConfig`, written by the descriptor-driven
+// connect form (`describeConfig`/`describeManifestTemplate`).
+/** Build the Compose environment backend over a host `ComposeRuntime` (the docker CLI seam). */
+export function composeEnvironmentBackend(runtime) {
+    return {
+        kind: 'compose',
+        displayLabel: 'Docker Compose',
+        // No secrets — a compose stack authenticates via the images themselves.
+        referencedSecretKeys: () => [],
+        connectionMeta: (config) => ({
+            providerId: 'compose',
+            label: 'manifest' in config ? config.manifest.label : 'Docker Compose',
+            baseUrl: 'manifest' in config ? config.manifest.baseUrl : 'http://localhost',
+        }),
+        assertConfigSafe: (config) => {
+            // The provider only ever returns a localhost URL and never fetches an operator-supplied
+            // URL, so there is no SSRF surface. Validate the load-bearing fields (service + port) up
+            // front so a bad config fails the connect form (422) instead of deep in a provision.
+            if (!('manifest' in config))
+                return;
+            try {
+                parseComposeEnvConfig(config.manifest);
+            }
+            catch (err) {
+                throw new ValidationError(err instanceof Error ? err.message : String(err));
+            }
+        },
+        toManifest: (config) => {
+            if (!('manifest' in config))
+                throw new Error('Expected a Docker Compose environment config');
+            return config.manifest;
+        },
+        fromManifest: (manifest) => ({ kind: 'compose', manifest }),
+        buildProvider: (ctx) => new ComposeEnvironmentProvider(runtime, { urlPolicy: ctx.urlPolicy }),
+    };
+}
+//# sourceMappingURL=compose-environment-backend.js.map

package/dist/modules/compose/compose-environment-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-environment-backend.js","sourceRoot":"","sources":["../../../src/modules/compose/compose-environment-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAuB,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAM3F,gGAAgG;AAChG,kGAAkG;AAClG,8FAA8F;AAC9F,iGAAiG;AACjG,4CAA4C;AAC5C,EAAE;AACF,+FAA+F;AAC/F,8FAA8F;AAC9F,2FAA2F;AAC3F,8DAA8D;AAE9D,gGAAgG;AAChG,MAAM,UAAU,yBAAyB,CAAC,OAAuB;IAC/D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,gBAAgB;QAC9B,wEAAwE;QACxE,oBAAoB,EAAE,GAAG,EAAE,CAAC,EAAE;QAC9B,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3B,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB;YACtE,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;SAC7E,CAAC;QACF,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC3B,wFAAwF;YACxF,yFAAyF;YACzF,qFAAqF;YACrF,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;gBAAE,OAAM;YACnC,IAAI,CAAC;gBACH,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7E,CAAC;QACH,CAAC;QACD,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACrB,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YAC5F,OAAO,MAAM,CAAC,QAAQ,CAAA;QACxB,CAAC;QACD,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAC3D,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,0BAA0B,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;KAC9F,CAAA;AACH,CAAC"}

package/dist/modules/compose/compose-environment.logic.d.ts

@@ -0,0 +1,155 @@
+import type { EnvironmentManifest, EnvironmentStatus } from '@cat-factory/kernel';
+/** A single `docker compose` invocation result (exit code + captured output). */
+export interface ComposeExecResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * The host seam the provider drives. A facade (local mode) implements it over the docker CLI
+ * + a host temp dir; the integrations package stays free of `node:*` so it remains
+ * runtime-neutral. `compose(args)` runs `docker compose <args>`; `writeProjectFile` persists a
+ * scratch file (the repo's compose file + the generated override) somewhere the daemon reads.
+ */
+export interface ComposeRuntime {
+    /**
+     * Run `docker compose <args>`; resolves with the exit code + captured stdout/stderr. `timeoutMs`
+     * bounds the invocation (a wedged daemon must not hang provision/status/teardown forever); the
+     * facade kills the child + surfaces a non-zero result when it elapses.
+     */
+    compose(args: string[], opts?: {
+        env?: Record<string, string>;
+        timeoutMs?: number;
+    }): Promise<ComposeExecResult>;
+    /** Write a per-project scratch file; returns its absolute host path. */
+    writeProjectFile(project: string, fileName: string, content: string): Promise<string>;
+    /** Best-effort removal of a project's scratch dir after teardown. Optional. */
+    cleanupProject?(project: string): Promise<void>;
+}
+/** The flat per-workspace config, read off `manifest.providerConfig`. */
+export interface ComposeEnvironmentConfig {
+    label: string;
+    /** Path to the compose file (co-located in the PR repo by default). */
+    composePath: string;
+    /** Read the compose file from a SEPARATE `owner/repo` instead of the PR repo. */
+    composeRepo?: string;
+    /** Ref to read the separate repo at; absent ⇒ that repo's default branch. */
+    composeRef?: string;
+    /** The compose service whose port is published + probed for the preview URL. */
+    service: string;
+    /** The in-container port to publish + probe. */
+    port: number;
+    /** URL scheme (default `http`). */
+    scheme?: 'http' | 'https';
+    /** Project-name template (default derived from repo + PR number / block id). */
+    projectTemplate?: string;
+    /** Optional image ref made available to the compose file as `{{image}}`. */
+    imageTemplate?: string;
+    /** Optional extra env passed to compose (templated), for `${VAR}` interpolation. */
+    envTemplate?: Record<string, string>;
+    /** Fallback TTL (ms) after which the env is swept + torn down. */
+    defaultTtlMs?: number;
+}
+/**
+ * Read the flat Compose config off the stored manifest's `providerConfig`. Validates the two
+ * load-bearing fields (service + port); throws a clear error otherwise. The connect form wrote
+ * these as strings (the generic descriptor overlay), so `port` is coerced from its string form.
+ */
+export declare function parseComposeEnvConfig(manifest: EnvironmentManifest): ComposeEnvironmentConfig;
+/** Build the stored manifest that carries a Compose env config in its `providerConfig`. */
+export declare function composeConfigToManifest(config: ComposeEnvironmentConfig): EnvironmentManifest;
+/** Replace `{{ key }}` placeholders from `vars`; an unknown key resolves to ''. */
+export declare function renderTemplate(template: string, vars: Record<string, string>): string;
+/** Render every value of an env map through {@link renderTemplate}. */
+export declare function renderEnvMap(env: Record<string, string>, vars: Record<string, string>): Record<string, string>;
+/**
+ * Sanitize an arbitrary string into a valid Docker Compose project name: lower-case, only
+ * `[a-z0-9_-]`, must start with `[a-z0-9]`, bounded length. Mirrors the k8s namespace
+ * sanitize so two stacks can't collide on a malformed name.
+ */
+export declare function sanitizeProjectName(name: string): string;
+/** A short, stable, filesystem-safe digest (djb2 → base36) used to disambiguate project names. */
+export declare function shortHash(input: string): string;
+/**
+ * Resolve the per-PR project name. An explicit `projectTemplate` is rendered + sanitized; else
+ * the default qualifies the PR number with the repo (a workspace can have many repos that each
+ * open a PR with the SAME number — a bare `cf-env-<pr>` would collide on one project and the
+ * second PR's `up`/`down` would hit the first's stack) AND, when known, a short digest of the
+ * globally-unique block id (so two DIFFERENT workspaces sharing a repo name + PR number on the
+ * same host can't collide either). It falls back to the block id, then a bare PR number, for a
+ * manual provision.
+ */
+export declare function resolveProjectName(config: ComposeEnvironmentConfig, inputs: Record<string, string>): string;
+/** The `{{var}}` substitution map available to the compose text + env templates. */
+export declare function templateVars(inputs: Record<string, string>, project: string, image: string | undefined): Record<string, string>;
+type ComposeDoc = Record<string, unknown>;
+/**
+ * Rewrite a single `ports` entry to its container-only (ephemeral host port) form, dropping any
+ * host ip / published host port. `"127.0.0.1:8080:8080"` / `"8080:8080"` / `{ published, target }`
+ * all collapse to `"8080"`; a protocol suffix is preserved. Returns null for an unparsable entry.
+ */
+export declare function toEphemeralPortEntry(entry: unknown): string | null;
+/**
+ * Force every service's published host ports to ephemeral. Compose MERGES (`-f` overlays) and
+ * a base compose file usually pins the web service's host port (`"8080:8080"`) — leaving that in
+ * place makes concurrent per-PR stacks collide on one host port, defeating the project-name
+ * isolation. So instead of an additive override we rewrite the file: each service's host port is
+ * stripped, leaving the container port published to an ephemeral host port. Mutates + returns the doc.
+ */
+export declare function neutralizeHostPorts(doc: ComposeDoc): ComposeDoc;
+/** Guarantee the probed service publishes `port`, so `docker compose port` can read the host binding back. */
+export declare function ensureServicePublishes(doc: ComposeDoc, service: string, port: number): ComposeDoc;
+/**
+ * Collect references this backend cannot honor or must refuse, so a provision fails fast with a
+ * clear reason instead of silently mis-mounting / over-privileging. The compose file is read
+ * checkout-free (no repo on disk), so anything resolved against the repo working tree is broken,
+ * and the stack runs on the operator's shared host daemon, so host access is a safety concern:
+ *  - `build:` — needs the source tree (image-based stacks only).
+ *  - host bind mounts — resolve against an empty scratch dir; also expose the host filesystem.
+ *  - relative `env_file` — points into the absent repo tree.
+ *  - `privileged: true` — refused on the shared host daemon.
+ */
+export declare function collectUnsupportedComposeRefs(doc: ComposeDoc): string[];
+/** The outcome of preparing a repo compose file into a single isolation-safe project file. */
+export interface PreparedCompose {
+    /** The rewritten compose file to hand to `docker compose -f` (valid even when `issues` is non-empty). */
+    content: string;
+    /** Blocking reasons the stack can't be provisioned as-is; non-empty ⇒ the provider fails the provision. */
+    issues: string[];
+}
+/**
+ * Turn the (already `{{var}}`-rendered) repo compose text into ONE isolation-safe project file:
+ * validate it parses + contains the probed service, surface any unsupported references, force all
+ * host ports ephemeral, and guarantee the probed service publishes its port. Returning a single
+ * rewritten file (rather than a second `-f` overlay) is what lets us STRIP the base's pinned host
+ * ports — an overlay can only add, not remove.
+ */
+export declare function prepareComposeProject(renderedText: string, service: string, port: number): PreparedCompose;
+/**
+ * Parse the host port out of `docker compose port <svc> <port>` output (e.g. `0.0.0.0:49153`
+ * or `[::]:49153`). Returns null when the service publishes no host port for that target.
+ */
+export declare function parseHostPort(output: string): number | null;
+interface ComposePsRow {
+    State?: string;
+    Health?: string;
+    ExitCode?: number;
+}
+/** Parse `docker compose ps --format json` (a JSON array OR newline-delimited objects). */
+export declare function parseComposePsRows(output: string): ComposePsRow[];
+/**
+ * Reduce a `docker compose ps -a` snapshot (the `-a` includes stopped containers) into one
+ * lifecycle verdict:
+ *  - empty ⇒ `failed` (the project is gone / never came up);
+ *  - any `unhealthy` service, or a container `exited`/`dead` with a non-zero code ⇒ `failed`;
+ *  - a transient state (`created`/`restarting`/`paused`/`removing`) or a `running` service still
+ *    `starting` its healthcheck ⇒ `provisioning` (so a brief recreate doesn't flip a healthy env
+ *    to `failed`);
+ *  - a clean one-shot that `exited (0)` is treated as complete (neither pending nor failing);
+ *  - otherwise ⇒ `ready`.
+ */
+export declare function classifyComposePs(output: string): EnvironmentStatus;
+/** A short tail of command output, for a deterministic-failure `lastError`. */
+export declare function tailOutput(output: string, lines?: number): string;
+export {};
+//# sourceMappingURL=compose-environment.logic.d.ts.map

package/dist/modules/compose/compose-environment.logic.d.ts.map

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

package/dist/modules/compose/compose-environment.logic.js

@@ -0,0 +1,376 @@
+import { parse, stringify } from 'yaml';
+const DEFAULT_COMPOSE_PATH = 'docker-compose.yml';
+function optionalString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Read the flat Compose config off the stored manifest's `providerConfig`. Validates the two
+ * load-bearing fields (service + port); throws a clear error otherwise. The connect form wrote
+ * these as strings (the generic descriptor overlay), so `port` is coerced from its string form.
+ */
+export function parseComposeEnvConfig(manifest) {
+    const raw = (manifest.providerConfig ?? {});
+    const service = optionalString(raw.service);
+    if (!service) {
+        throw new Error('Docker Compose environment is missing the web service name (service)');
+    }
+    const port = Number(raw.port);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Docker Compose environment has an invalid container port: ${String(raw.port)}`);
+    }
+    const scheme = raw.scheme === 'https' ? 'https' : 'http';
+    const envTemplate = raw.envTemplate && typeof raw.envTemplate === 'object'
+        ? Object.fromEntries(Object.entries(raw.envTemplate).map(([k, val]) => [
+            k,
+            String(val),
+        ]))
+        : undefined;
+    return {
+        label: manifest.label,
+        composePath: optionalString(raw.composePath) ?? DEFAULT_COMPOSE_PATH,
+        composeRepo: optionalString(raw.composeRepo),
+        composeRef: optionalString(raw.composeRef),
+        service,
+        port,
+        scheme,
+        projectTemplate: optionalString(raw.projectTemplate),
+        imageTemplate: optionalString(raw.imageTemplate),
+        envTemplate,
+        defaultTtlMs: resolveTtlMs(raw.ttlMinutes, manifest.defaultTtlMs),
+    };
+}
+/**
+ * Resolve the env's auto-teardown TTL (ms). The connect form collects it as `ttlMinutes` (a
+ * string) so a leaked compose project is swept off the host instead of running forever; a present
+ * `0`/blank/invalid value is an explicit "never expire" (undefined), and an absent field falls
+ * back to the manifest's own `defaultTtlMs`.
+ */
+function resolveTtlMs(rawTtlMinutes, manifestDefaultTtlMs) {
+    const ttlMinutes = optionalString(rawTtlMinutes);
+    if (ttlMinutes === undefined)
+        return manifestDefaultTtlMs;
+    const minutes = Number(ttlMinutes);
+    return Number.isFinite(minutes) && minutes > 0 ? Math.round(minutes * 60_000) : undefined;
+}
+/** Build the stored manifest that carries a Compose env config in its `providerConfig`. */
+export function composeConfigToManifest(config) {
+    return {
+        providerId: 'compose',
+        label: config.label,
+        // Inert: the provider always returns a localhost URL, so baseUrl is never fetched and is
+        // not SSRF-checked. A placeholder keeps the manifest schema (which requires a non-empty
+        // baseUrl + provision + response) satisfied.
+        baseUrl: 'http://localhost',
+        auth: { type: 'none' },
+        provision: { method: 'POST', pathTemplate: '' },
+        response: {},
+        ...(config.defaultTtlMs ? { defaultTtlMs: config.defaultTtlMs } : {}),
+        providerConfig: { ...config },
+    };
+}
+/** Replace `{{ key }}` placeholders from `vars`; an unknown key resolves to ''. */
+export function renderTemplate(template, vars) {
+    return template.replace(/\{\{\s*([a-zA-Z0-9_.]+)\s*\}\}/g, (_m, key) => vars[key] ?? '');
+}
+/** Render every value of an env map through {@link renderTemplate}. */
+export function renderEnvMap(env, vars) {
+    return Object.fromEntries(Object.entries(env).map(([k, val]) => [k, renderTemplate(val, vars)]));
+}
+/**
+ * Sanitize an arbitrary string into a valid Docker Compose project name: lower-case, only
+ * `[a-z0-9_-]`, must start with `[a-z0-9]`, bounded length. Mirrors the k8s namespace
+ * sanitize so two stacks can't collide on a malformed name.
+ */
+export function sanitizeProjectName(name) {
+    const cleaned = name
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/^[^a-z0-9]+/, '')
+        .replace(/-+$/g, '')
+        .slice(0, 63);
+    return cleaned.length > 0 ? cleaned : 'cf-env';
+}
+/** A short, stable, filesystem-safe digest (djb2 → base36) used to disambiguate project names. */
+export function shortHash(input) {
+    let h = 5381;
+    for (let i = 0; i < input.length; i++)
+        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;
+    return h.toString(36).slice(0, 6);
+}
+/**
+ * Resolve the per-PR project name. An explicit `projectTemplate` is rendered + sanitized; else
+ * the default qualifies the PR number with the repo (a workspace can have many repos that each
+ * open a PR with the SAME number — a bare `cf-env-<pr>` would collide on one project and the
+ * second PR's `up`/`down` would hit the first's stack) AND, when known, a short digest of the
+ * globally-unique block id (so two DIFFERENT workspaces sharing a repo name + PR number on the
+ * same host can't collide either). It falls back to the block id, then a bare PR number, for a
+ * manual provision.
+ */
+export function resolveProjectName(config, inputs) {
+    if (config.projectTemplate) {
+        return sanitizeProjectName(renderTemplate(config.projectTemplate, inputs));
+    }
+    if (inputs.repoName && inputs.pullNumber) {
+        const base = `cf-env-${inputs.repoName}-${inputs.pullNumber}`;
+        return sanitizeProjectName(inputs.blockId ? `${base}-${shortHash(inputs.blockId)}` : base);
+    }
+    return sanitizeProjectName(`cf-env-${inputs.blockId || inputs.pullNumber || 'env'}`);
+}
+/** The `{{var}}` substitution map available to the compose text + env templates. */
+export function templateVars(inputs, project, image) {
+    return { ...inputs, project, ...(image !== undefined ? { image } : {}) };
+}
+function servicesOf(doc) {
+    const services = doc.services;
+    if (!services || typeof services !== 'object')
+        return {};
+    return services;
+}
+function asArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value === undefined || value === null)
+        return [];
+    return [value];
+}
+/** The container-target of a normalized (host-stripped) short-form ports entry: `"8080/tcp"` → `8080`. */
+function portTarget(entry) {
+    return (entry.split('/')[0] ?? '').trim();
+}
+/**
+ * Rewrite a single `ports` entry to its container-only (ephemeral host port) form, dropping any
+ * host ip / published host port. `"127.0.0.1:8080:8080"` / `"8080:8080"` / `{ published, target }`
+ * all collapse to `"8080"`; a protocol suffix is preserved. Returns null for an unparsable entry.
+ */
+export function toEphemeralPortEntry(entry) {
+    if (typeof entry === 'number')
+        return String(entry);
+    if (typeof entry === 'string') {
+        const [mapping, proto] = entry.split('/');
+        const segments = (mapping ?? '').split(':');
+        const target = segments[segments.length - 1]?.trim();
+        if (!target)
+            return null;
+        return proto ? `${target}/${proto}` : target;
+    }
+    if (entry && typeof entry === 'object') {
+        const e = entry;
+        if (e.target === undefined || e.target === null)
+            return null;
+        const proto = typeof e.protocol === 'string' ? e.protocol : undefined;
+        return proto ? `${String(e.target)}/${proto}` : String(e.target);
+    }
+    return null;
+}
+/**
+ * Force every service's published host ports to ephemeral. Compose MERGES (`-f` overlays) and
+ * a base compose file usually pins the web service's host port (`"8080:8080"`) — leaving that in
+ * place makes concurrent per-PR stacks collide on one host port, defeating the project-name
+ * isolation. So instead of an additive override we rewrite the file: each service's host port is
+ * stripped, leaving the container port published to an ephemeral host port. Mutates + returns the doc.
+ */
+export function neutralizeHostPorts(doc) {
+    for (const service of Object.values(servicesOf(doc))) {
+        if (!service || typeof service !== 'object' || !Array.isArray(service.ports))
+            continue;
+        service.ports = service.ports.map(toEphemeralPortEntry).filter((p) => p !== null);
+    }
+    return doc;
+}
+/** Guarantee the probed service publishes `port`, so `docker compose port` can read the host binding back. */
+export function ensureServicePublishes(doc, service, port) {
+    const svc = servicesOf(doc)[service];
+    if (!svc || typeof svc !== 'object')
+        return doc;
+    const ports = Array.isArray(svc.ports) ? svc.ports.map(String) : [];
+    svc.ports = ports.some((p) => portTarget(p) === String(port)) ? ports : [...ports, String(port)];
+    return doc;
+}
+function isRelativePath(path) {
+    return !path.startsWith('/') && !/^[a-zA-Z]:[\\/]/.test(path);
+}
+function bindMountSource(volume) {
+    if (typeof volume === 'string') {
+        const segments = volume.split(':');
+        if (segments.length < 2)
+            return null; // anonymous volume (`/data`) — a container path, not a host bind
+        const source = segments[0] ?? '';
+        return source.startsWith('.') || source.startsWith('/') || source.startsWith('~')
+            ? source
+            : null;
+    }
+    if (volume && typeof volume === 'object') {
+        const v = volume;
+        if (v.type === 'bind')
+            return typeof v.source === 'string' ? v.source : 'bind';
+        if (v.type === undefined && typeof v.source === 'string') {
+            const s = v.source;
+            return s.startsWith('.') || s.startsWith('/') || s.startsWith('~') ? s : null;
+        }
+    }
+    return null;
+}
+/**
+ * Collect references this backend cannot honor or must refuse, so a provision fails fast with a
+ * clear reason instead of silently mis-mounting / over-privileging. The compose file is read
+ * checkout-free (no repo on disk), so anything resolved against the repo working tree is broken,
+ * and the stack runs on the operator's shared host daemon, so host access is a safety concern:
+ *  - `build:` — needs the source tree (image-based stacks only).
+ *  - host bind mounts — resolve against an empty scratch dir; also expose the host filesystem.
+ *  - relative `env_file` — points into the absent repo tree.
+ *  - `privileged: true` — refused on the shared host daemon.
+ */
+export function collectUnsupportedComposeRefs(doc) {
+    const issues = [];
+    for (const [name, service] of Object.entries(servicesOf(doc))) {
+        if (!service || typeof service !== 'object')
+            continue;
+        if (service.build !== undefined) {
+            issues.push(`service '${name}' uses build: — image-based stacks only (no repo is checked out)`);
+        }
+        if (service.privileged === true) {
+            issues.push(`service '${name}' requests privileged: true — refused on the shared host daemon`);
+        }
+        for (const volume of asArray(service.volumes)) {
+            const source = bindMountSource(volume);
+            if (source !== null) {
+                issues.push(`service '${name}' bind-mounts a host path ('${source}') — unsupported (no repo on disk; use a named volume)`);
+            }
+        }
+        for (const entry of asArray(service.env_file)) {
+            const path = typeof entry === 'string' ? entry : entry?.path;
+            if (typeof path === 'string' && isRelativePath(path)) {
+                issues.push(`service '${name}' reads a relative env_file ('${path}') — unsupported (no repo on disk)`);
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Turn the (already `{{var}}`-rendered) repo compose text into ONE isolation-safe project file:
+ * validate it parses + contains the probed service, surface any unsupported references, force all
+ * host ports ephemeral, and guarantee the probed service publishes its port. Returning a single
+ * rewritten file (rather than a second `-f` overlay) is what lets us STRIP the base's pinned host
+ * ports — an overlay can only add, not remove.
+ */
+export function prepareComposeProject(renderedText, service, port) {
+    let parsed;
+    try {
+        parsed = parse(renderedText);
+    }
+    catch (err) {
+        return {
+            content: renderedText,
+            issues: [
+                `compose file is not valid YAML: ${err instanceof Error ? err.message : String(err)}`,
+            ],
+        };
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return { content: renderedText, issues: ['compose file is empty or not a mapping'] };
+    }
+    const doc = parsed;
+    if (!servicesOf(doc)[service]) {
+        return { content: renderedText, issues: [`compose file has no service named '${service}'`] };
+    }
+    const issues = collectUnsupportedComposeRefs(doc);
+    neutralizeHostPorts(doc);
+    ensureServicePublishes(doc, service, port);
+    return { content: stringify(doc), issues };
+}
+/**
+ * Parse the host port out of `docker compose port <svc> <port>` output (e.g. `0.0.0.0:49153`
+ * or `[::]:49153`). Returns null when the service publishes no host port for that target.
+ */
+export function parseHostPort(output) {
+    const line = output
+        .split('\n')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .pop();
+    if (!line)
+        return null;
+    const match = line.match(/:(\d+)\s*$/);
+    if (!match)
+        return null;
+    const n = Number(match[1]);
+    return Number.isInteger(n) && n > 0 && n <= 65535 ? n : null;
+}
+/** Parse `docker compose ps --format json` (a JSON array OR newline-delimited objects). */
+export function parseComposePsRows(output) {
+    const trimmed = output.trim();
+    if (!trimmed)
+        return [];
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed))
+            return parsed;
+        return [parsed];
+    }
+    catch {
+        // Newline-delimited JSON objects (older compose).
+        const rows = [];
+        for (const line of trimmed.split('\n')) {
+            const s = line.trim();
+            if (!s)
+                continue;
+            try {
+                rows.push(JSON.parse(s));
+            }
+            catch {
+                // ignore an unparsable line
+            }
+        }
+        return rows;
+    }
+}
+/**
+ * Reduce a `docker compose ps -a` snapshot (the `-a` includes stopped containers) into one
+ * lifecycle verdict:
+ *  - empty ⇒ `failed` (the project is gone / never came up);
+ *  - any `unhealthy` service, or a container `exited`/`dead` with a non-zero code ⇒ `failed`;
+ *  - a transient state (`created`/`restarting`/`paused`/`removing`) or a `running` service still
+ *    `starting` its healthcheck ⇒ `provisioning` (so a brief recreate doesn't flip a healthy env
+ *    to `failed`);
+ *  - a clean one-shot that `exited (0)` is treated as complete (neither pending nor failing);
+ *  - otherwise ⇒ `ready`.
+ */
+export function classifyComposePs(output) {
+    const rows = parseComposePsRows(output);
+    if (rows.length === 0)
+        return 'failed'; // nothing left ⇒ the stack is gone/crashed
+    let anyPending = false;
+    for (const row of rows) {
+        const state = (row.State ?? '').toLowerCase();
+        const health = (row.Health ?? '').toLowerCase();
+        if (health === 'unhealthy')
+            return 'failed';
+        if (state.startsWith('running')) {
+            if (health === 'starting')
+                anyPending = true;
+        }
+        else if (state.startsWith('exited') || state.startsWith('dead')) {
+            if ((row.ExitCode ?? 0) !== 0)
+                return 'failed'; // a real crash
+            // exit 0 ⇒ a completed one-shot (migration/seed); not pending, not a failure
+        }
+        else {
+            // created / restarting / paused / removing / … ⇒ still settling
+            anyPending = true;
+        }
+    }
+    return anyPending ? 'provisioning' : 'ready';
+}
+/** A short tail of command output, for a deterministic-failure `lastError`. */
+export function tailOutput(output, lines = 12) {
+    return output
+        .split('\n')
+        .map((s) => s.trimEnd())
+        .filter(Boolean)
+        .slice(-lines)
+        .join('\n');
+}
+//# sourceMappingURL=compose-environment.logic.js.map

package/dist/modules/compose/compose-environment.logic.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/integrations",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "External-system integration domain logic for the Agent Architecture Board (GitHub, documents, tasks, environments, runners).",
   "repository": {
     "type": "git",
@@ -26,8 +26,8 @@
   "dependencies": {
     "ai": "^6.0.209",
     "yaml": "^2.7.0",
-    "@cat-factory/contracts": "0.57.0",
-    "@cat-factory/kernel": "0.56.0"
+    "@cat-factory/contracts": "0.58.0",
+    "@cat-factory/kernel": "0.56.1"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",