@bensandee/tooling 0.13.0 → 0.14.1

package/dist/bin.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { t as isExecSyncError } from "./exec-CC49vrkM.mjs";
 import { defineCommand, runMain } from "citty";
 import * as p from "@clack/prompts";
 import { execSync } from "node:child_process";
@@ -106,7 +107,7 @@ function detectProject(targetDir) {
 		hasKnipConfig: exists("knip.json") || exists("knip.jsonc") || exists("knip.ts") || exists("knip.mts") || exists("knip.config.ts") || exists("knip.config.mts"),
 		hasRenovateConfig: exists("renovate.json") || exists("renovate.json5") || exists(".renovaterc") || exists(".renovaterc.json") || exists(".github/renovate.json") || exists(".github/renovate.json5"),
 		hasReleaseItConfig: exists(".release-it.json") || exists(".release-it.yaml") || exists(".release-it.toml"),
-		hasCommitAndTagVersionConfig: exists(".versionrc") || exists(".versionrc.json") || exists(".versionrc.js"),
+		hasSimpleReleaseConfig: exists(".versionrc") || exists(".versionrc.json") || exists(".versionrc.js"),
 		hasChangesetsConfig: exists(".changeset/config.json"),
 		legacyConfigs: detectLegacyConfigs(targetDir)
 	};
@@ -208,7 +209,7 @@ function getMonorepoPackages(targetDir) {
 function isCancelled(value) {
 	return p.isCancel(value);
 }
-async function runInitPrompts(targetDir) {
+async function runInitPrompts(targetDir, saved) {
 	p.intro("@bensandee/tooling repo:init");
 	const existingPkg = readPackageJson(targetDir);
 	const detected = detectProject(targetDir);
@@ -217,7 +218,7 @@ async function runInitPrompts(targetDir) {
 	const detectedMonorepo = detectMonorepo(targetDir);
 	const structure = await p.select({
 		message: "Project structure",
-		initialValue: detectedMonorepo ? "monorepo" : "single",
+		initialValue: saved?.structure ?? (detectedMonorepo ? "monorepo" : "single"),
 		options: [{
 			value: "single",
 			label: "Single repo"
@@ -232,7 +233,7 @@ async function runInitPrompts(targetDir) {
 	}
 	const useEslintPlugin = await p.confirm({
 		message: "Include @bensandee/eslint-plugin?",
-		initialValue: true
+		initialValue: saved?.useEslintPlugin ?? true
 	});
 	if (isCancelled(useEslintPlugin)) {
 		p.cancel("Cancelled.");
@@ -241,7 +242,7 @@ async function runInitPrompts(targetDir) {
 	const hasExistingPrettier = detected.legacyConfigs.some((l) => l.tool === "prettier");
 	const formatter = await p.select({
 		message: "Formatter",
-		initialValue: hasExistingPrettier ? "prettier" : "oxfmt",
+		initialValue: saved?.formatter ?? (hasExistingPrettier ? "prettier" : "oxfmt"),
 		options: [{
 			value: "oxfmt",
 			label: "oxfmt",
@@ -257,7 +258,7 @@ async function runInitPrompts(targetDir) {
 	}
 	const setupVitest = await p.confirm({
 		message: "Set up vitest with a starter test?",
-		initialValue: !isExisting
+		initialValue: saved?.setupVitest ?? !isExisting
 	});
 	if (isCancelled(setupVitest)) {
 		p.cancel("Cancelled.");
@@ -265,6 +266,7 @@ async function runInitPrompts(targetDir) {
 	}
 	const ci = await p.select({
 		message: "CI workflow",
+		initialValue: saved?.ci,
 		options: [
 			{
 				value: "forgejo",
@@ -288,7 +290,7 @@ async function runInitPrompts(targetDir) {
 	if (ci === "github") {
 		const renovateAnswer = await p.confirm({
 			message: "Set up Renovate for automated dependency updates?",
-			initialValue: true
+			initialValue: saved?.setupRenovate ?? true
 		});
 		if (isCancelled(renovateAnswer)) {
 			p.cancel("Cancelled.");
@@ -298,7 +300,7 @@ async function runInitPrompts(targetDir) {
 	}
 	const releaseStrategy = await p.select({
 		message: "Release management",
-		initialValue: "none",
+		initialValue: saved?.releaseStrategy ?? "none",
 		options: [
 			{
 				value: "none",
@@ -315,9 +317,9 @@ async function runInitPrompts(targetDir) {
 				hint: "PR-based versioning"
 			},
 			{
-				value: "commit-and-tag-version",
-				label: "commit-and-tag-version",
-				hint: "conventional commits, automatic CHANGELOG"
+				value: "simple",
+				label: "Simple",
+				hint: "uses commit-and-tag-version internally"
 			}
 		]
 	});
@@ -337,7 +339,7 @@ async function runInitPrompts(targetDir) {
 			p.note(detections.join("\n"), "Detected package types");
 			const applyDetected = await p.confirm({
 				message: "Apply detected tsconfig bases to packages?",
-				initialValue: true
+				initialValue: saved?.detectPackageTypes ?? true
 			});
 			if (isCancelled(applyDetected)) {
 				p.cancel("Cancelled.");
@@ -348,7 +350,7 @@ async function runInitPrompts(targetDir) {
 	} else {
 		const projectTypeAnswer = await p.select({
 			message: "Project type",
-			initialValue: "default",
+			initialValue: saved?.projectType ?? "default",
 			options: [
 				{
 					value: "default",
@@ -407,7 +409,7 @@ function buildDefaultConfig(targetDir, flags) {
 		setupVitest: !detected.hasVitestConfig,
 		ci: flags.noCi ? "none" : DEFAULT_CI,
 		setupRenovate: true,
-		releaseStrategy: detected.hasReleaseItConfig ? "release-it" : detected.hasCommitAndTagVersionConfig ? "commit-and-tag-version" : detected.hasChangesetsConfig ? "changesets" : "none",
+		releaseStrategy: detected.hasReleaseItConfig ? "release-it" : detected.hasSimpleReleaseConfig ? "simple" : detected.hasChangesetsConfig ? "changesets" : "none",
 		projectType: "default",
 		detectPackageTypes: true,
 		targetDir
@@ -581,7 +583,7 @@ function addReleaseDeps(deps, config) {
 			deps["release-it"] = "18.1.2";
 			if (config.structure === "monorepo") deps["@release-it/bumper"] = "7.0.2";
 			break;
-		case "commit-and-tag-version":
+		case "simple":
 			deps["commit-and-tag-version"] = "12.5.0";
 			break;
 		case "changesets":
@@ -593,8 +595,8 @@ function addReleaseDeps(deps, config) {
 function getAddedDevDepNames(config) {
 	const deps = { ...ROOT_DEV_DEPS };
 	if (config.structure !== "monorepo") Object.assign(deps, PER_PACKAGE_DEV_DEPS);
-	deps["@bensandee/config"] = "0.7.1";
-	deps["@bensandee/tooling"] = "0.13.0";
+	deps["@bensandee/config"] = "0.8.1";
+	deps["@bensandee/tooling"] = "0.14.1";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -614,9 +616,9 @@ async function generatePackageJson(ctx) {
 	if (ctx.config.releaseStrategy !== "none" && ctx.config.releaseStrategy !== "changesets") allScripts["trigger-release"] = "pnpm exec tooling release:trigger";
 	const devDeps = { ...ROOT_DEV_DEPS };
 	if (!isMonorepo) Object.assign(devDeps, PER_PACKAGE_DEV_DEPS);
-	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.7.1";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.13.0";
-	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.0";
+	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.8.1";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.14.1";
+	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";
 	addReleaseDeps(devDeps, ctx.config);
@@ -1964,25 +1966,13 @@ permissions:
       - name: Release
         env:
           GITHUB_TOKEN: \${{ github.token }}
-          NODE_AUTH_TOKEN: \${{ secrets.NPM_TOKEN }}
-        run: |
-          pnpm exec commit-and-tag-version
-          git push --follow-tags
-          TAG=$(git describe --tags --abbrev=0)
-          pnpm publish --no-git-checks
-          gh release create "$TAG" --generate-notes` : `
+        run: pnpm exec tooling release:simple` : `
       - name: Release
         env:
           FORGEJO_SERVER_URL: \${{ github.server_url }}
           FORGEJO_REPOSITORY: \${{ github.repository }}
           FORGEJO_TOKEN: \${{ secrets.FORGEJO_TOKEN }}
-          NODE_AUTH_TOKEN: \${{ secrets.NPM_TOKEN }}
-        run: |
-          pnpm exec commit-and-tag-version
-          git push --follow-tags
-          TAG=$(git describe --tags --abbrev=0)
-          pnpm publish --no-git-checks
-          pnpm exec tooling release:create-forgejo-release --tag "$TAG"`;
+        run: pnpm exec tooling release:simple`;
 	return `${workflowSchemaComment(ci)}name: Release
 on:
   workflow_dispatch:
@@ -2083,10 +2073,10 @@ function requiredReleaseSteps(strategy, nodeVersionYaml) {
 				step: { run: "pnpm release-it --ci" }
 			});
 			break;
-		case "commit-and-tag-version":
+		case "simple":
 			steps.push({
-				match: { run: "commit-and-tag-version" },
-				step: { run: "pnpm exec commit-and-tag-version" }
+				match: { run: "release:simple" },
+				step: { run: "pnpm exec tooling release:simple" }
 			});
 			break;
 		case "changesets":
@@ -2101,7 +2091,7 @@ function requiredReleaseSteps(strategy, nodeVersionYaml) {
 function buildWorkflow(strategy, ci, nodeVersionYaml) {
 	switch (strategy) {
 		case "release-it": return releaseItWorkflow(ci, nodeVersionYaml);
-		case "commit-and-tag-version": return commitAndTagVersionWorkflow(ci, nodeVersionYaml);
+		case "simple": return commitAndTagVersionWorkflow(ci, nodeVersionYaml);
 		case "changesets": return changesetsWorkflow(ci, nodeVersionYaml);
 		default: return null;
 	}
@@ -2444,7 +2434,7 @@ const ToolingConfigSchema = z.object({
 	setupRenovate: z.boolean().optional(),
 	releaseStrategy: z.enum([
 		"release-it",
-		"commit-and-tag-version",
+		"simple",
 		"changesets",
 		"none"
 	]).optional(),
@@ -2545,14 +2535,14 @@ const initCommand = defineCommand({
 	},
 	async run({ args }) {
 		const targetDir = path.resolve(args.dir ?? ".");
+		const saved = loadToolingConfig(targetDir);
 		await runInit(args.yes ? (() => {
-			const saved = loadToolingConfig(targetDir);
 			const detected = buildDefaultConfig(targetDir, {
 				eslintPlugin: args["eslint-plugin"] === true ? true : void 0,
 				noCi: args["no-ci"] === true ? true : void 0
 			});
 			return saved ? mergeWithSavedConfig(detected, saved) : detected;
-		})() : await runInitPrompts(targetDir), args["no-prompt"] === true ? { noPrompt: true } : {});
+		})() : await runInitPrompts(targetDir, saved), args["no-prompt"] === true ? { noPrompt: true } : {});
 	}
 });
 async function runInit(config, options = {}) {
@@ -2732,12 +2722,6 @@ function lineDiff(oldText, newText) {
 	return lines;
 }
 //#endregion
-//#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/release/executor.ts
 /** Create an executor that runs real commands, fetches, and reads the filesystem. */
 function createRealExecutor() {
@@ -3347,10 +3331,10 @@ function triggerGitHub(ref) {
 	p.log.info(`Triggered release workflow on GitHub (ref: ${ref})`);
 }
 //#endregion
-//#region src/commands/release-create-forgejo-release.ts
+//#region src/commands/forgejo-create-release.ts
 const createForgejoReleaseCommand = defineCommand({
 	meta: {
-		name: "release:create-forgejo-release",
+		name: "forgejo:create-release",
 		description: "Create a Forgejo release for a given tag"
 	},
 	args: { tag: {
@@ -3360,7 +3344,7 @@ const createForgejoReleaseCommand = defineCommand({
 	} },
 	async run({ args }) {
 		const resolved = resolveConnection(process.cwd());
-		if (resolved.type !== "forgejo") throw new FatalError("release:create-forgejo-release requires a Forgejo repository");
+		if (resolved.type !== "forgejo") throw new FatalError("forgejo:create-release requires a Forgejo repository");
 		const executor = createRealExecutor();
 		const conn = resolved.conn;
 		if (await findRelease(executor, conn, args.tag)) {
@@ -3372,11 +3356,11 @@ const createForgejoReleaseCommand = defineCommand({
 	}
 });
 //#endregion
-//#region src/commands/release-merge.ts
+//#region src/commands/changesets-merge.ts
 const HEAD_BRANCH = "changeset-release/main";
 const releaseMergeCommand = defineCommand({
 	meta: {
-		name: "release:merge",
+		name: "changesets:merge",
 		description: "Merge the open changesets version PR"
 	},
 	args: { "dry-run": {
@@ -3416,6 +3400,179 @@ function mergeGitHub(dryRun) {
 	p.log.info(`Merged changesets PR and deleted branch ${HEAD_BRANCH}`);
 }
 //#endregion
+//#region src/release/simple.ts
+/**
+* Compute sliding version tags from a semver version string.
+* For "1.2.3" returns ["v1", "v1.2"]. Strips prerelease suffixes.
+*/
+function computeSlidingTags(version) {
+	const parts = (version.split("-")[0] ?? version).split(".");
+	if (parts.length < 2 || !parts[0] || !parts[1]) throw new FatalError(`Invalid version format "${version}". Expected semver (X.Y.Z)`);
+	return [`v${parts[0]}`, `v${parts[0]}.${parts[1]}`];
+}
+/** Build the commit-and-tag-version command with appropriate flags. */
+function buildCommand(config) {
+	const args = ["pnpm exec commit-and-tag-version"];
+	if (config.dryRun) args.push("--dry-run");
+	if (config.firstRelease) args.push("--first-release");
+	if (config.releaseAs) args.push(`--release-as ${config.releaseAs}`);
+	if (config.prerelease) args.push(`--prerelease ${config.prerelease}`);
+	return args.join(" ");
+}
+/** Read the current version from package.json. */
+function readVersion(executor, cwd) {
+	const raw = executor.readFile(path.join(cwd, "package.json"));
+	if (!raw) throw new FatalError("Could not read package.json");
+	const pkg = parsePackageJson(raw);
+	if (!pkg?.version) throw new FatalError("No version field found in package.json");
+	return pkg.version;
+}
+/** Run the full commit-and-tag-version release flow. */
+async function runSimpleRelease(executor, config) {
+	const command = buildCommand(config);
+	p.log.info(`Running: ${command}`);
+	const versionResult = executor.exec(command, { cwd: config.cwd });
+	debugExec(config, "commit-and-tag-version", versionResult);
+	if (versionResult.exitCode !== 0) throw new FatalError(`commit-and-tag-version failed (exit code ${String(versionResult.exitCode)}):\n${versionResult.stderr || versionResult.stdout}`);
+	const version = readVersion(executor, config.cwd);
+	debug(config, `New version: ${version}`);
+	const tagResult = executor.exec("git describe --tags --abbrev=0", { cwd: config.cwd });
+	debugExec(config, "git describe", tagResult);
+	const tag = tagResult.stdout.trim();
+	if (!tag) throw new FatalError("Could not determine the new tag from git describe");
+	p.log.info(`Version ${version} tagged as ${tag}`);
+	if (config.dryRun) {
+		const slidingTags = config.noSlidingTags ? [] : computeSlidingTags(version);
+		p.log.info(`[dry-run] Would push to origin with --follow-tags`);
+		if (slidingTags.length > 0) p.log.info(`[dry-run] Would create sliding tags: ${slidingTags.join(", ")}`);
+		if (!config.noRelease && config.platform) p.log.info(`[dry-run] Would create ${config.platform.type} release for ${tag}`);
+		return {
+			version,
+			tag,
+			slidingTags,
+			pushed: false,
+			releaseCreated: false
+		};
+	}
+	let pushed = false;
+	if (!config.noPush) {
+		const branch = executor.exec("git rev-parse --abbrev-ref HEAD", { cwd: config.cwd }).stdout.trim() || "main";
+		debug(config, `Pushing to origin/${branch}`);
+		const pushResult = executor.exec(`git push --follow-tags origin ${branch}`, { cwd: config.cwd });
+		debugExec(config, "git push", pushResult);
+		if (pushResult.exitCode !== 0) throw new FatalError(`git push failed (exit code ${String(pushResult.exitCode)}):\n${pushResult.stderr || pushResult.stdout}`);
+		pushed = true;
+		p.log.info("Pushed to origin");
+	}
+	let slidingTags = [];
+	if (!config.noSlidingTags && pushed) {
+		slidingTags = computeSlidingTags(version);
+		for (const slidingTag of slidingTags) executor.exec(`git tag -f ${slidingTag}`, { cwd: config.cwd });
+		const forcePushResult = executor.exec(`git push origin ${slidingTags.join(" ")} --force`, { cwd: config.cwd });
+		debugExec(config, "force-push sliding tags", forcePushResult);
+		if (forcePushResult.exitCode !== 0) p.log.warn(`Warning: Failed to push sliding tags: ${forcePushResult.stderr || forcePushResult.stdout}`);
+		else p.log.info(`Created sliding tags: ${slidingTags.join(", ")}`);
+	}
+	let releaseCreated = false;
+	if (!config.noRelease && config.platform) releaseCreated = await createPlatformRelease(executor, config, tag);
+	return {
+		version,
+		tag,
+		slidingTags,
+		pushed,
+		releaseCreated
+	};
+}
+async function createPlatformRelease(executor, config, tag) {
+	if (!config.platform) return false;
+	if (config.platform.type === "forgejo") {
+		if (await findRelease(executor, config.platform.conn, tag)) {
+			debug(config, `Release for ${tag} already exists, skipping`);
+			return false;
+		}
+		await createRelease(executor, config.platform.conn, tag);
+		p.log.info(`Created Forgejo release for ${tag}`);
+		return true;
+	}
+	const ghResult = executor.exec(`gh release create ${tag} --generate-notes`, { cwd: config.cwd });
+	debugExec(config, "gh release create", ghResult);
+	if (ghResult.exitCode !== 0) {
+		p.log.warn(`Warning: Failed to create GitHub release: ${ghResult.stderr || ghResult.stdout}`);
+		return false;
+	}
+	p.log.info(`Created GitHub release for ${tag}`);
+	return true;
+}
+//#endregion
+//#region src/commands/release-simple.ts
+const releaseSimpleCommand = defineCommand({
+	meta: {
+		name: "release:simple",
+		description: "Run commit-and-tag-version, push, create sliding tags, and create a platform release"
+	},
+	args: {
+		"dry-run": {
+			type: "boolean",
+			description: "Pass --dry-run to commit-and-tag-version and skip all remote operations"
+		},
+		verbose: {
+			type: "boolean",
+			description: "Enable detailed debug logging (also enabled by RELEASE_DEBUG env var)"
+		},
+		"no-push": {
+			type: "boolean",
+			description: "Run commit-and-tag-version but skip push and remote operations"
+		},
+		"no-sliding-tags": {
+			type: "boolean",
+			description: "Skip creating sliding major/minor version tags (vX, vX.Y)"
+		},
+		"no-release": {
+			type: "boolean",
+			description: "Skip Forgejo/GitHub release creation"
+		},
+		"first-release": {
+			type: "boolean",
+			description: "Pass --first-release to commit-and-tag-version (skip version bump)"
+		},
+		"release-as": {
+			type: "string",
+			description: "Force a specific version (passed to commit-and-tag-version --release-as)"
+		},
+		prerelease: {
+			type: "string",
+			description: "Create a prerelease with the given tag (e.g., beta, alpha)"
+		}
+	},
+	async run({ args }) {
+		const cwd = process.cwd();
+		const verbose = args.verbose === true || process.env["RELEASE_DEBUG"] === "true";
+		const noRelease = args["no-release"] === true;
+		let platform;
+		if (!noRelease) {
+			const resolved = resolveConnection(cwd);
+			if (resolved.type === "forgejo") platform = {
+				type: "forgejo",
+				conn: resolved.conn
+			};
+			else platform = { type: "github" };
+		}
+		const config = {
+			cwd,
+			dryRun: args["dry-run"] === true,
+			verbose,
+			noPush: args["no-push"] === true,
+			noSlidingTags: args["no-sliding-tags"] === true,
+			noRelease,
+			firstRelease: args["first-release"] === true,
+			releaseAs: args["release-as"],
+			prerelease: args.prerelease,
+			platform
+		};
+		await runSimpleRelease(createRealExecutor(), config);
+	}
+});
+//#endregion
 //#region src/commands/repo-run-checks.ts
 const CHECKS = [
 	{ name: "build" },
@@ -3457,6 +3614,7 @@ function runRunChecks(targetDir, options = {}) {
 	const skip = options.skip ?? /* @__PURE__ */ new Set();
 	const add = options.add ?? [];
 	const isCI = Boolean(process.env["CI"]);
+	const failFast = options.failFast ?? !isCI;
 	const definedScripts = getScripts(targetDir);
 	const addedNames = new Set(add);
 	const allChecks = [...CHECKS, ...add.map((name) => ({ name }))];
@@ -3480,6 +3638,7 @@ function runRunChecks(targetDir, options = {}) {
 			if (isCI) ciLog(`::error::${check.name} failed`);
 			p.log.error(`${check.name} failed`);
 			failures.push(check.name);
+			if (failFast) return 1;
 		}
 	}
 	if (notDefined.length > 0) p.log.info(`Skipped (not defined): ${notDefined.join(", ")}`);
@@ -3510,12 +3669,18 @@ const runChecksCommand = defineCommand({
 			type: "string",
 			description: "Comma-separated list of additional check names to run (uses pnpm run <name>)",
 			required: false
+		},
+		"fail-fast": {
+			type: "boolean",
+			description: "Stop on first failure (default: true in dev, false in CI)",
+			required: false
 		}
 	},
 	run({ args }) {
 		const exitCode = runRunChecks(path.resolve(args.dir ?? "."), {
 			skip: args.skip ? new Set(args.skip.split(",").map((s) => s.trim())) : void 0,
-			add: args.add ? args.add.split(",").map((s) => s.trim()) : void 0
+			add: args.add ? args.add.split(",").map((s) => s.trim()) : void 0,
+			failFast: args["fail-fast"] === true ? true : args["fail-fast"] === false ? false : void 0
 		});
 		process.exitCode = exitCode;
 	}
@@ -3525,7 +3690,7 @@ const runChecksCommand = defineCommand({
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.13.0",
+		version: "0.14.1",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -3535,11 +3700,12 @@ const main = defineCommand({
 		"checks:run": runChecksCommand,
 		"release:changesets": releaseForgejoCommand,
 		"release:trigger": releaseTriggerCommand,
-		"release:create-forgejo-release": createForgejoReleaseCommand,
-		"release:merge": releaseMergeCommand
+		"forgejo:create-release": createForgejoReleaseCommand,
+		"changesets:merge": releaseMergeCommand,
+		"release:simple": releaseSimpleCommand
 	}
 });
-console.log(`@bensandee/tooling v0.13.0`);
+console.log(`@bensandee/tooling v0.14.1`);
 runMain(main);
 //#endregion
 export {};

package/dist/docker-verify/index.d.mts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+
+//#region src/release/types.d.ts
+/** Result of executing a shell command. */
+interface ExecResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+/** Options for executing a shell command. */
+interface ExecOptions {
+  cwd?: string;
+  env?: Record<string, string>;
+}
+//#endregion
+//#region src/docker-verify/types.d.ts
+/** Abstraction over side effects for testability. */
+interface DockerVerifyExecutor {
+  /** Run a shell command and return the result (stdout/stderr captured). */
+  exec(command: string, options?: ExecOptions): ExecResult;
+  /** Run a shell command, streaming stdout/stderr to the console. */
+  execInherit(command: string, options?: ExecOptions): void;
+  /** Perform an HTTP request. */
+  fetch(url: string, init?: RequestInit): Promise<Response>;
+  /** Get current time in ms (mockable clock). */
+  now(): number;
+  /** Sleep for the given duration (mockable delay). */
+  sleep(ms: number): Promise<void>;
+  /** Register a process signal handler. Returns a dispose function. */
+  onSignal(signal: NodeJS.Signals, handler: () => void): () => void;
+  /** Log a message to the console. */
+  log(message: string): void;
+  /** Log an error to the console. */
+  logError(message: string): void;
+}
+/** A single HTTP health check definition. */
+interface HttpHealthCheck {
+  /** Human-readable name for logging (e.g. "API", "Frontend"). */
+  name: string;
+  /** URL to fetch. */
+  url: string;
+  /** Validate the response. Return true if healthy. */
+  validate: (response: Response) => Promise<boolean>;
+}
+/** Docker compose configuration. */
+interface ComposeConfig {
+  /** Working directory for docker compose commands. */
+  cwd: string;
+  /** Compose files to use (e.g. ["docker-compose.yaml", "docker-compose.verify.yaml"]). */
+  composeFiles: string[];
+  /** Optional env file for compose. */
+  envFile?: string;
+  /** Service names to monitor for container-level health. */
+  services: string[];
+}
+/** Full verification configuration. */
+interface VerifyConfig {
+  /** Docker compose settings. */
+  compose: ComposeConfig;
+  /** Optional build command to run before starting compose (e.g. "pnpm image:build"). */
+  buildCommand?: string;
+  /** Working directory for the build command (defaults to compose.cwd). */
+  buildCwd?: string;
+  /** HTTP health checks to poll. All must pass for success. */
+  healthChecks: HttpHealthCheck[];
+  /** Maximum time to wait for all checks to pass, in ms. Default: 120000. */
+  timeoutMs?: number;
+  /** Interval between polling attempts, in ms. Default: 5000. */
+  pollIntervalMs?: number;
+}
+/** Result of the verification run. */
+type VerifyResult = {
+  success: true;
+  elapsedMs: number;
+} | {
+  success: false;
+  reason: "timeout" | "unhealthy-container" | "error";
+  message: string;
+  elapsedMs: number;
+};
+//#endregion
+//#region src/docker-verify/executor.d.ts
+/** Create an executor that runs real commands, fetches, and manages process signals. */
+declare function createRealExecutor(): DockerVerifyExecutor;
+//#endregion
+//#region src/docker-verify/verify.d.ts
+/** Run the full Docker image verification lifecycle. */
+declare function runVerification(executor: DockerVerifyExecutor, config: VerifyConfig): Promise<VerifyResult>;
+//#endregion
+//#region src/docker-verify/compose.d.ts
+/** Zod schema for a single container entry from `docker compose ps --format json`. */
+declare const ContainerInfoSchema: z.ZodObject<{
+  Service: z.ZodString;
+  Health: z.ZodString;
+}, z.core.$strip>;
+type ContainerInfo = z.infer<typeof ContainerInfoSchema>;
+/** Build the `docker compose` base command string from config. */
+declare function composeCommand(config: ComposeConfig): string;
+/** Start the compose stack in detached mode. */
+declare function composeUp(executor: DockerVerifyExecutor, config: ComposeConfig): void;
+/** Tear down the compose stack, removing volumes and orphans. Swallows errors. */
+declare function composeDown(executor: DockerVerifyExecutor, config: ComposeConfig): void;
+/** Show logs for a specific service (or all services if not specified). Swallows errors. */
+declare function composeLogs(executor: DockerVerifyExecutor, config: ComposeConfig, service?: string): void;
+/**
+ * Query container status via `docker compose ps --format json`.
+ * Handles both JSON array and newline-delimited JSON (varies by docker compose version).
+ */
+declare function composePs(executor: DockerVerifyExecutor, config: ComposeConfig): ContainerInfo[];
+//#endregion
+//#region src/docker-verify/health.d.ts
+/** Look up the health status of a specific service from container info. */
+declare function getContainerHealth(containers: ContainerInfo[], serviceName: string): string;
+/** Run a single HTTP health check, returning true if the validator passes. */
+declare function checkHttpHealth(executor: DockerVerifyExecutor, check: HttpHealthCheck): Promise<boolean>;
+//#endregion
+export { type ComposeConfig, type ContainerInfo, type DockerVerifyExecutor, type HttpHealthCheck, type VerifyConfig, type VerifyResult, checkHttpHealth, composeCommand, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runVerification };