@bensandee/tooling 0.17.0 → 0.18.0

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as isExecSyncError } from "./exec-CC49vrkM.mjs";
+import { l as createRealExecutor$1, t as runVerification, u as isExecSyncError } from "./verify-BaWlzdPh.mjs";
 import { defineCommand, runMain } from "citty";
 import * as p from "@clack/prompts";
 import path from "node:path";
@@ -7,7 +7,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync
 import JSON5 from "json5";
 import { parse } from "jsonc-parser";
 import { z } from "zod";
-import { isMap, isSeq, parseDocument } from "yaml";
+import { isMap, isSeq, parse as parse$1, parseDocument } from "yaml";
 import { execSync } from "node:child_process";
 import { FatalError, TransientError, UnexpectedError } from "@bensandee/common";
 //#region src/types.ts
@@ -656,7 +656,7 @@ function getAddedDevDepNames(config) {
 	const deps = { ...ROOT_DEV_DEPS };
 	if (config.structure !== "monorepo") Object.assign(deps, PER_PACKAGE_DEV_DEPS);
 	deps["@bensandee/config"] = "0.8.2";
-	deps["@bensandee/tooling"] = "0.17.0";
+	deps["@bensandee/tooling"] = "0.18.0";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -677,7 +677,7 @@ async function generatePackageJson(ctx) {
 	const devDeps = { ...ROOT_DEV_DEPS };
 	if (!isMonorepo) Object.assign(devDeps, PER_PACKAGE_DEV_DEPS);
 	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.8.2";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.17.0";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.18.0";
 	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.2";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = "0.35.0";
 	if (ctx.config.formatter === "prettier") devDeps["prettier"] = "3.8.1";
@@ -4257,11 +4257,159 @@ const dockerBuildCommand = defineCommand({
 	}
 });
 //#endregion
+//#region src/docker-verify/detect.ts
+/** Compose file names to scan, in priority order. */
+const COMPOSE_FILE_CANDIDATES = [
+	"docker-compose.yaml",
+	"docker-compose.yml",
+	"compose.yaml",
+	"compose.yml"
+];
+/** Zod schema for the subset of compose YAML we care about. */
+const ComposePortSchema = z.union([z.string(), z.object({
+	published: z.union([z.string(), z.number()]),
+	target: z.union([z.string(), z.number()]).optional()
+}).passthrough()]);
+const ComposeServiceSchema = z.object({
+	ports: z.array(ComposePortSchema).optional(),
+	healthcheck: z.unknown().optional()
+}).passthrough();
+const ComposeFileSchema = z.object({ services: z.record(z.string(), ComposeServiceSchema).optional() }).passthrough();
+/** Detect which compose files exist at conventional paths. */
+function detectComposeFiles(cwd) {
+	return COMPOSE_FILE_CANDIDATES.filter((name) => existsSync(path.join(cwd, name)));
+}
+/** Parse a single port mapping string and extract the host port. */
+function parsePortString(port) {
+	const withoutProtocol = port.split("/")[0];
+	if (!withoutProtocol) return void 0;
+	const parts = withoutProtocol.split(":");
+	if (parts.length === 2) {
+		const host = parts[0];
+		if (!host) return void 0;
+		const parsed = Number.parseInt(host, 10);
+		return Number.isNaN(parsed) ? void 0 : parsed;
+	}
+	if (parts.length === 3) {
+		const host = parts[1];
+		if (!host) return void 0;
+		const parsed = Number.parseInt(host, 10);
+		return Number.isNaN(parsed) ? void 0 : parsed;
+	}
+}
+/** Extract the host port from a compose port definition. */
+function extractHostPort(port) {
+	if (typeof port === "string") return parsePortString(port);
+	const published = port.published;
+	if (typeof published === "number") return published;
+	if (typeof published === "string") {
+		const parsed = Number.parseInt(published, 10);
+		return Number.isNaN(parsed) ? void 0 : parsed;
+	}
+}
+/** Parse compose files and return service info (names, ports, healthcheck presence). */
+function parseComposeServices(cwd, composeFiles) {
+	const serviceMap = /* @__PURE__ */ new Map();
+	for (const file of composeFiles) {
+		let parsed;
+		try {
+			const content = readFileSync(path.join(cwd, file), "utf-8");
+			parsed = ComposeFileSchema.safeParse(parse$1(content));
+		} catch (_error) {
+			continue;
+		}
+		if (!parsed.success || !parsed.data.services) continue;
+		for (const [name, service] of Object.entries(parsed.data.services)) {
+			const existing = serviceMap.get(name);
+			let hostPort = existing?.hostPort;
+			if (hostPort === void 0 && service.ports) for (const port of service.ports) {
+				const extracted = extractHostPort(port);
+				if (extracted !== void 0) {
+					hostPort = extracted;
+					break;
+				}
+			}
+			serviceMap.set(name, {
+				name,
+				hostPort,
+				hasHealthcheck: existing?.hasHealthcheck ?? service.healthcheck !== void 0
+			});
+		}
+	}
+	return [...serviceMap.values()];
+}
+/** Generate health checks from parsed services: services with exposed ports get HTTP checks, unless they define a compose-level healthcheck. */
+function deriveHealthChecks(services) {
+	return services.filter((s) => s.hostPort !== void 0 && !s.hasHealthcheck).map((s) => ({
+		name: s.name,
+		url: `http://localhost:${String(s.hostPort)}/`
+	}));
+}
+/** Auto-detect compose config from conventional file locations. */
+function computeVerifyDefaults(cwd) {
+	const composeFiles = detectComposeFiles(cwd);
+	if (composeFiles.length === 0) return {};
+	const services = parseComposeServices(cwd, composeFiles);
+	const healthChecks = deriveHealthChecks(services);
+	return {
+		composeFiles,
+		services: services.map((s) => s.name),
+		healthChecks: healthChecks.length > 0 ? healthChecks : void 0
+	};
+}
+//#endregion
+//#region src/commands/docker-verify.ts
+/** Convert declarative health checks to functional ones. */
+function toHttpHealthChecks(checks) {
+	return checks.map((check) => ({
+		name: check.name,
+		url: check.url,
+		validate: async (res) => check.status ? res.status === check.status : res.ok
+	}));
+}
+const dockerVerifyCommand = defineCommand({
+	meta: {
+		name: "docker:verify",
+		description: "Verify Docker Compose stack health by auto-detecting services from compose files"
+	},
+	args: {
+		timeout: {
+			type: "string",
+			description: "Maximum time to wait for health checks, in ms (default: 120000)"
+		},
+		"poll-interval": {
+			type: "string",
+			description: "Interval between polling attempts, in ms (default: 5000)"
+		}
+	},
+	async run({ args }) {
+		const cwd = process.cwd();
+		const defaults = computeVerifyDefaults(cwd);
+		if (!defaults.composeFiles || defaults.composeFiles.length === 0) throw new FatalError("No compose files found. Expected docker-compose.yaml or compose.yaml.");
+		if (!defaults.services || defaults.services.length === 0) throw new FatalError("No services found in compose files.");
+		const config = {
+			compose: {
+				cwd,
+				composeFiles: defaults.composeFiles,
+				envFile: defaults.envFile,
+				services: defaults.services
+			},
+			buildCommand: defaults.buildCommand,
+			buildCwd: defaults.buildCwd,
+			healthChecks: defaults.healthChecks ? toHttpHealthChecks(defaults.healthChecks) : [],
+			timeoutMs: args.timeout ? Number.parseInt(args.timeout, 10) : defaults.timeoutMs,
+			pollIntervalMs: args["poll-interval"] ? Number.parseInt(args["poll-interval"], 10) : defaults.pollIntervalMs
+		};
+		const result = await runVerification(createRealExecutor$1(), config);
+		if (!result.success) throw new FatalError(`Verification failed (${result.reason}): ${result.message}`);
+	}
+});
+//#endregion
 //#region src/bin.ts
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.17.0",
+		version: "0.18.0",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -4273,10 +4421,11 @@ const main = defineCommand({
 		"changesets:merge": releaseMergeCommand,
 		"release:simple": releaseSimpleCommand,
 		"docker:publish": publishDockerCommand,
-		"docker:build": dockerBuildCommand
+		"docker:build": dockerBuildCommand,
+		"docker:verify": dockerVerifyCommand
 	}
 });
-console.log(`@bensandee/tooling v0.17.0`);
+console.log(`@bensandee/tooling v0.18.0`);
 runMain(main);
 //#endregion
 export {};

package/dist/docker-verify/index.mjs

@@ -1,218 +1,2 @@
-import { t as isExecSyncError } from "../exec-CC49vrkM.mjs";
-import { z } from "zod";
-import { execSync } from "node:child_process";
-//#region src/docker-verify/executor.ts
-/** Create an executor that runs real commands, fetches, and manages process signals. */
-function createRealExecutor() {
-	return {
-		exec(command, options) {
-			try {
-				return {
-					stdout: execSync(command, {
-						cwd: options?.cwd,
-						env: options?.env ? {
-							...process.env,
-							...options.env
-						} : void 0,
-						encoding: "utf-8",
-						stdio: [
-							"pipe",
-							"pipe",
-							"pipe"
-						]
-					}),
-					stderr: "",
-					exitCode: 0
-				};
-			} catch (err) {
-				if (isExecSyncError(err)) return {
-					stdout: err.stdout,
-					stderr: err.stderr,
-					exitCode: err.status
-				};
-				return {
-					stdout: "",
-					stderr: "",
-					exitCode: 1
-				};
-			}
-		},
-		execInherit(command, options) {
-			execSync(command, {
-				cwd: options?.cwd,
-				env: options?.env ? {
-					...process.env,
-					...options.env
-				} : void 0,
-				stdio: "inherit"
-			});
-		},
-		fetch: globalThis.fetch,
-		now: () => Date.now(),
-		sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-		onSignal(signal, handler) {
-			process.on(signal, handler);
-			return () => {
-				process.removeListener(signal, handler);
-			};
-		},
-		log: (msg) => console.log(msg),
-		logError: (msg) => console.error(msg)
-	};
-}
-//#endregion
-//#region src/docker-verify/compose.ts
-/** Zod schema for a single container entry from `docker compose ps --format json`. */
-const ContainerInfoSchema = z.object({
-	Service: z.string(),
-	Health: z.string()
-});
-/** Build the `docker compose` base command string from config. */
-function composeCommand(config) {
-	return `docker compose ${config.composeFiles.map((f) => `-f ${f}`).join(" ")}${config.envFile ? ` --env-file ${config.envFile}` : ""}`;
-}
-/** Run the build command if configured. */
-function buildImages(executor, config) {
-	if (!config.buildCommand) return;
-	executor.execInherit(config.buildCommand, { cwd: config.buildCwd ?? config.compose.cwd });
-}
-/** Start the compose stack in detached mode. */
-function composeUp(executor, config) {
-	executor.execInherit(`${composeCommand(config)} up -d`, { cwd: config.cwd });
-}
-/** Tear down the compose stack, removing volumes and orphans. Swallows errors. */
-function composeDown(executor, config) {
-	try {
-		executor.execInherit(`${composeCommand(config)} down -v --remove-orphans`, { cwd: config.cwd });
-	} catch (_error) {}
-}
-/** Show logs for a specific service (or all services if not specified). Swallows errors. */
-function composeLogs(executor, config, service) {
-	try {
-		const suffix = service ? ` ${service}` : "";
-		executor.execInherit(`${composeCommand(config)} logs${suffix}`, { cwd: config.cwd });
-	} catch (_error) {}
-}
-/**
-* Query container status via `docker compose ps --format json`.
-* Handles both JSON array and newline-delimited JSON (varies by docker compose version).
-*/
-function composePs(executor, config) {
-	const output = executor.exec(`${composeCommand(config)} ps --format json`, { cwd: config.cwd }).stdout.trim();
-	if (!output) return [];
-	const ArraySchema = z.array(ContainerInfoSchema);
-	try {
-		const direct = ArraySchema.safeParse(JSON.parse(output));
-		if (direct.success) return direct.data;
-		const single = ContainerInfoSchema.safeParse(JSON.parse(output));
-		if (single.success) return [single.data];
-	} catch (_error) {}
-	try {
-		const joined = `[${output.split("\n").join(",")}]`;
-		const delimited = ArraySchema.safeParse(JSON.parse(joined));
-		return delimited.success ? delimited.data : [];
-	} catch (_error) {
-		return [];
-	}
-}
-//#endregion
-//#region src/docker-verify/health.ts
-/** Look up the health status of a specific service from container info. */
-function getContainerHealth(containers, serviceName) {
-	return containers.find((c) => c.Service === serviceName)?.Health ?? "unknown";
-}
-/** Run a single HTTP health check, returning true if the validator passes. */
-async function checkHttpHealth(executor, check) {
-	try {
-		const response = await executor.fetch(check.url);
-		return await check.validate(response);
-	} catch (_error) {
-		return false;
-	}
-}
-//#endregion
-//#region src/docker-verify/verify.ts
-const DEFAULT_TIMEOUT_MS = 12e4;
-const DEFAULT_POLL_INTERVAL_MS = 5e3;
-/** Run the full Docker image verification lifecycle. */
-async function runVerification(executor, config) {
-	const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-	const pollIntervalMs = config.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-	const { compose } = config;
-	const cleanup = () => composeDown(executor, compose);
-	const disposeInt = executor.onSignal("SIGINT", () => {
-		cleanup();
-		process.exit(1);
-	});
-	const disposeTerm = executor.onSignal("SIGTERM", () => {
-		cleanup();
-		process.exit(1);
-	});
-	try {
-		if (config.buildCommand) {
-			executor.log("Building images...");
-			buildImages(executor, config);
-		}
-		executor.log("Starting compose stack...");
-		composeUp(executor, compose);
-		executor.log(`Waiting for stack to be healthy (max ${timeoutMs / 1e3}s)...`);
-		const startTime = executor.now();
-		const healthStatus = new Map(config.healthChecks.map((c) => [c.name, false]));
-		while (executor.now() - startTime < timeoutMs) {
-			const containers = composePs(executor, compose);
-			for (const service of compose.services) if (getContainerHealth(containers, service) === "unhealthy") {
-				executor.logError(`Container ${service} is unhealthy`);
-				composeLogs(executor, compose, service);
-				cleanup();
-				return {
-					success: false,
-					reason: "unhealthy-container",
-					message: service,
-					elapsedMs: executor.now() - startTime
-				};
-			}
-			for (const check of config.healthChecks) if (!healthStatus.get(check.name)) {
-				if (await checkHttpHealth(executor, check)) {
-					healthStatus.set(check.name, true);
-					executor.log(`${check.name} is healthy!`);
-				}
-			}
-			if ([...healthStatus.values()].every(Boolean)) {
-				executor.log("Verification successful! All systems operational.");
-				cleanup();
-				return {
-					success: true,
-					elapsedMs: executor.now() - startTime
-				};
-			}
-			const elapsed = Math.floor((executor.now() - startTime) / 1e3);
-			if (elapsed > 0 && elapsed % 5 === 0) {
-				const statuses = [...healthStatus.entries()].map(([name, ok]) => `${name}=${ok ? "OK" : "Pending"}`).join(", ");
-				executor.log(`Waiting... (${elapsed}s elapsed). ${statuses}`);
-			}
-			await executor.sleep(pollIntervalMs);
-		}
-		executor.logError("Timeout waiting for stack to become healthy");
-		for (const service of compose.services) composeLogs(executor, compose, service);
-		cleanup();
-		return {
-			success: false,
-			reason: "timeout",
-			message: "Exceeded timeout",
-			elapsedMs: executor.now() - startTime
-		};
-	} catch (error) {
-		cleanup();
-		return {
-			success: false,
-			reason: "error",
-			message: error instanceof Error ? error.message : String(error),
-			elapsedMs: 0
-		};
-	} finally {
-		disposeInt();
-		disposeTerm();
-	}
-}
-//#endregion
+import { a as composeDown, c as composeUp, i as composeCommand, l as createRealExecutor, n as checkHttpHealth, o as composeLogs, r as getContainerHealth, s as composePs, t as runVerification } from "../verify-BaWlzdPh.mjs";
 export { checkHttpHealth, composeCommand, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runVerification };

package/dist/verify-BaWlzdPh.mjs

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { execSync } from "node:child_process";
+//#region src/utils/exec.ts
+/** Type guard for `execSync` errors that carry stdout/stderr/status. */
+function isExecSyncError(err) {
+	return err instanceof Error && "stdout" in err && typeof err.stdout === "string" && "stderr" in err && typeof err.stderr === "string" && "status" in err && typeof err.status === "number";
+}
+//#endregion
+//#region src/docker-verify/executor.ts
+/** Create an executor that runs real commands, fetches, and manages process signals. */
+function createRealExecutor() {
+	return {
+		exec(command, options) {
+			try {
+				return {
+					stdout: execSync(command, {
+						cwd: options?.cwd,
+						env: options?.env ? {
+							...process.env,
+							...options.env
+						} : void 0,
+						encoding: "utf-8",
+						stdio: [
+							"pipe",
+							"pipe",
+							"pipe"
+						]
+					}),
+					stderr: "",
+					exitCode: 0
+				};
+			} catch (err) {
+				if (isExecSyncError(err)) return {
+					stdout: err.stdout,
+					stderr: err.stderr,
+					exitCode: err.status
+				};
+				return {
+					stdout: "",
+					stderr: "",
+					exitCode: 1
+				};
+			}
+		},
+		execInherit(command, options) {
+			execSync(command, {
+				cwd: options?.cwd,
+				env: options?.env ? {
+					...process.env,
+					...options.env
+				} : void 0,
+				stdio: "inherit"
+			});
+		},
+		fetch: globalThis.fetch,
+		now: () => Date.now(),
+		sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+		onSignal(signal, handler) {
+			process.on(signal, handler);
+			return () => {
+				process.removeListener(signal, handler);
+			};
+		},
+		log: (msg) => console.log(msg),
+		logError: (msg) => console.error(msg)
+	};
+}
+//#endregion
+//#region src/docker-verify/compose.ts
+/** Zod schema for a single container entry from `docker compose ps --format json`. */
+const ContainerInfoSchema = z.object({
+	Service: z.string(),
+	Health: z.string()
+});
+/** Build the `docker compose` base command string from config. */
+function composeCommand(config) {
+	return `docker compose ${config.composeFiles.map((f) => `-f ${f}`).join(" ")}${config.envFile ? ` --env-file ${config.envFile}` : ""}`;
+}
+/** Run the build command if configured. */
+function buildImages(executor, config) {
+	if (!config.buildCommand) return;
+	executor.execInherit(config.buildCommand, { cwd: config.buildCwd ?? config.compose.cwd });
+}
+/** Start the compose stack in detached mode. */
+function composeUp(executor, config) {
+	executor.execInherit(`${composeCommand(config)} up -d`, { cwd: config.cwd });
+}
+/** Tear down the compose stack, removing volumes and orphans. Swallows errors. */
+function composeDown(executor, config) {
+	try {
+		executor.execInherit(`${composeCommand(config)} down -v --remove-orphans`, { cwd: config.cwd });
+	} catch (_error) {}
+}
+/** Show logs for a specific service (or all services if not specified). Swallows errors. */
+function composeLogs(executor, config, service) {
+	try {
+		const suffix = service ? ` ${service}` : "";
+		executor.execInherit(`${composeCommand(config)} logs${suffix}`, { cwd: config.cwd });
+	} catch (_error) {}
+}
+/**
+* Query container status via `docker compose ps --format json`.
+* Handles both JSON array and newline-delimited JSON (varies by docker compose version).
+*/
+function composePs(executor, config) {
+	const output = executor.exec(`${composeCommand(config)} ps --format json`, { cwd: config.cwd }).stdout.trim();
+	if (!output) return [];
+	const ArraySchema = z.array(ContainerInfoSchema);
+	try {
+		const direct = ArraySchema.safeParse(JSON.parse(output));
+		if (direct.success) return direct.data;
+		const single = ContainerInfoSchema.safeParse(JSON.parse(output));
+		if (single.success) return [single.data];
+	} catch (_error) {}
+	try {
+		const joined = `[${output.split("\n").join(",")}]`;
+		const delimited = ArraySchema.safeParse(JSON.parse(joined));
+		return delimited.success ? delimited.data : [];
+	} catch (_error) {
+		return [];
+	}
+}
+//#endregion
+//#region src/docker-verify/health.ts
+/** Look up the health status of a specific service from container info. */
+function getContainerHealth(containers, serviceName) {
+	return containers.find((c) => c.Service === serviceName)?.Health ?? "unknown";
+}
+/** Run a single HTTP health check, returning true if the validator passes. */
+async function checkHttpHealth(executor, check) {
+	try {
+		const response = await executor.fetch(check.url);
+		return await check.validate(response);
+	} catch (_error) {
+		return false;
+	}
+}
+//#endregion
+//#region src/docker-verify/verify.ts
+const DEFAULT_TIMEOUT_MS = 12e4;
+const DEFAULT_POLL_INTERVAL_MS = 5e3;
+/** Run the full Docker image verification lifecycle. */
+async function runVerification(executor, config) {
+	const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const pollIntervalMs = config.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+	const { compose } = config;
+	const cleanup = () => composeDown(executor, compose);
+	const disposeInt = executor.onSignal("SIGINT", () => {
+		cleanup();
+		process.exit(1);
+	});
+	const disposeTerm = executor.onSignal("SIGTERM", () => {
+		cleanup();
+		process.exit(1);
+	});
+	try {
+		if (config.buildCommand) {
+			executor.log("Building images...");
+			buildImages(executor, config);
+		}
+		executor.log("Starting compose stack...");
+		composeUp(executor, compose);
+		executor.log(`Waiting for stack to be healthy (max ${timeoutMs / 1e3}s)...`);
+		const startTime = executor.now();
+		const healthStatus = new Map(config.healthChecks.map((c) => [c.name, false]));
+		while (executor.now() - startTime < timeoutMs) {
+			const containers = composePs(executor, compose);
+			for (const service of compose.services) if (getContainerHealth(containers, service) === "unhealthy") {
+				executor.logError(`Container ${service} is unhealthy`);
+				composeLogs(executor, compose, service);
+				cleanup();
+				return {
+					success: false,
+					reason: "unhealthy-container",
+					message: service,
+					elapsedMs: executor.now() - startTime
+				};
+			}
+			for (const check of config.healthChecks) if (!healthStatus.get(check.name)) {
+				if (await checkHttpHealth(executor, check)) {
+					healthStatus.set(check.name, true);
+					executor.log(`${check.name} is healthy!`);
+				}
+			}
+			if ([...healthStatus.values()].every(Boolean)) {
+				executor.log("Verification successful! All systems operational.");
+				cleanup();
+				return {
+					success: true,
+					elapsedMs: executor.now() - startTime
+				};
+			}
+			const elapsed = Math.floor((executor.now() - startTime) / 1e3);
+			if (elapsed > 0 && elapsed % 5 === 0) {
+				const statuses = [...healthStatus.entries()].map(([name, ok]) => `${name}=${ok ? "OK" : "Pending"}`).join(", ");
+				executor.log(`Waiting... (${elapsed}s elapsed). ${statuses}`);
+			}
+			await executor.sleep(pollIntervalMs);
+		}
+		executor.logError("Timeout waiting for stack to become healthy");
+		for (const service of compose.services) composeLogs(executor, compose, service);
+		cleanup();
+		return {
+			success: false,
+			reason: "timeout",
+			message: "Exceeded timeout",
+			elapsedMs: executor.now() - startTime
+		};
+	} catch (error) {
+		cleanup();
+		return {
+			success: false,
+			reason: "error",
+			message: error instanceof Error ? error.message : String(error),
+			elapsedMs: 0
+		};
+	} finally {
+		disposeInt();
+		disposeTerm();
+	}
+}
+//#endregion
+export { composeDown as a, composeUp as c, composeCommand as i, createRealExecutor as l, checkHttpHealth as n, composeLogs as o, getContainerHealth as r, composePs as s, runVerification as t, isExecSyncError as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"

package/dist/exec-CC49vrkM.mjs

@@ -1,7 +0,0 @@
-//#region src/utils/exec.ts
-/** Type guard for `execSync` errors that carry stdout/stderr/status. */
-function isExecSyncError(err) {
-	return err instanceof Error && "stdout" in err && typeof err.stdout === "string" && "stderr" in err && typeof err.stderr === "string" && "status" in err && typeof err.status === "number";
-}
-//#endregion
-export { isExecSyncError as t };