@bensandee/tooling 0.50.2 → 0.51.1

package/README.md

@@ -126,10 +126,11 @@ The generated release workflow exposes these as optional `workflow_dispatch` inp
 
 ### Docker
 
-| Command                  | Description                                         |
-| ------------------------ | --------------------------------------------------- |
-| `tooling docker:build`   | Build Docker images for discovered Docker packages. |
-| `tooling docker:publish` | Build, tag, and push Docker images to a registry.   |
+| Command                  | Description                                                         |
+| ------------------------ | ------------------------------------------------------------------- |
+| `tooling docker:build`   | Build Docker images for discovered Docker packages.                 |
+| `tooling docker:publish` | Build, tag, and push Docker images to a registry.                   |
+| `tooling docker:check`   | Start a Compose stack, run health checks, run smoketest, tear down. |
 
 Docker packages are discovered automatically. Any package with a `Dockerfile` or `docker/Dockerfile` is a Docker package. Image names are derived as `{root-package-name}-{package-name}`, build context defaults to `.` (project root). For single-package repos, `Dockerfile` or `docker/Dockerfile` at the project root is checked.
 
@@ -255,9 +256,32 @@ import type {
 
 ## Docker check
 
-The `@bensandee/tooling/docker-check` export provides utilities for checking Docker Compose stacks via health checks.
+`docker:check` verifies that a Docker Compose stack starts correctly, passes health checks, and (optionally) survives a smoketest command. The lifecycle is: build images, compose up, poll health checks, run smoketest, compose down.
 
-### Quick start
+### Smoketests
+
+A smoketest is a command that runs against the live Docker stack after all containers are healthy and HTTP health checks pass. This is useful for running integration tests, API contract checks, or any validation that requires the full stack to be running.
+
+**Auto-detection:** If the root `package.json` has a `"test:smoke"` script, it is automatically used as the smoketest command — no configuration needed.
+
+**Manual configuration:** For non-conventional command names, configure via `.tooling.json`:
+
+```json
+{
+  "dockerCheck": {
+    "smoketest": ["pnpm", "test:integration"],
+    "smoketestCwd": "."
+  }
+}
+```
+
+If the smoketest command exits non-zero, `docker:check` dumps container logs and fails with reason `"smoketest-failed"`.
+
+### Library API
+
+The `@bensandee/tooling/docker-check` export provides utilities for checking Docker Compose stacks programmatically.
+
+#### Quick start
 
 ```ts
 import { createRealExecutor, runDockerCheck } from "@bensandee/tooling/docker-check";
@@ -269,7 +293,7 @@ const config: CheckConfig = {
     composeFiles: ["docker-compose.yaml"],
     services: ["api", "db"],
   },
-  buildCommand: "pnpm image:build",
+  buildCommand: ["pnpm", "image:build"],
   healthChecks: [
     {
       name: "API",
@@ -277,6 +301,7 @@ const config: CheckConfig = {
       validate: async (res) => res.ok,
     },
   ],
+  smoketest: ["pnpm", "test:smoke"],
   timeoutMs: 120_000,
   pollIntervalMs: 5_000,
 };
@@ -287,24 +312,24 @@ if (!result.success) {
 }
 ```
 
-### Exports
+#### Exports
 
-| Export                                 | Description                                                       |
-| -------------------------------------- | ----------------------------------------------------------------- |
-| `runDockerCheck(executor, config)`     | Full lifecycle: build, compose up, health check polling, teardown |
-| `createRealExecutor()`                 | Production executor (real shell, fetch, timers)                   |
-| `composeUp(executor, config)`          | Start compose services                                            |
-| `composeDown(executor, config)`        | Stop and remove compose services                                  |
-| `composeLogs(executor, config)`        | Stream compose logs                                               |
-| `composePs(executor, config)`          | List running containers                                           |
-| `checkHttpHealth(executor, check)`     | Run a single HTTP health check                                    |
-| `getContainerHealth(executor, config)` | Check container-level health status                               |
+| Export                                 | Description                                                                  |
+| -------------------------------------- | ---------------------------------------------------------------------------- |
+| `runDockerCheck(executor, config)`     | Full lifecycle: build, compose up, health check polling, smoketest, teardown |
+| `createRealExecutor()`                 | Production executor (real shell, fetch, timers)                              |
+| `composeUp(executor, config)`          | Start compose services                                                       |
+| `composeDown(executor, config)`        | Stop and remove compose services                                             |
+| `composeLogs(executor, config)`        | Stream compose logs                                                          |
+| `composePs(executor, config)`          | List running containers                                                      |
+| `checkHttpHealth(executor, check)`     | Run a single HTTP health check                                               |
+| `getContainerHealth(executor, config)` | Check container-level health status                                          |
 
-### Types
+#### Types
 
 | Type                  | Description                                                                                |
 | --------------------- | ------------------------------------------------------------------------------------------ |
-| `CheckConfig`         | Full check config (compose settings, build command, health checks, timeouts)               |
+| `CheckConfig`         | Full check config (compose settings, build command, health checks, smoketest, timeouts)    |
 | `ComposeConfig`       | Docker Compose settings (cwd, compose files, env file, services)                           |
 | `HttpHealthCheck`     | Health check definition (name, URL, validate function)                                     |
 | `CheckResult`         | Result: `{ success: true, elapsedMs }` or `{ success: false, reason, message, elapsedMs }` |

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as debug, f as debugExec, g as note, h as log, l as createRealExecutor$1, m as redact, p as isEnvVerbose, t as runDockerCheck, u as isExecSyncError } from "./check-hutCTIXe.mjs";
+import { d as debug, f as debugExec, g as note, h as log, l as createRealExecutor$1, m as redact, p as isEnvVerbose, t as runDockerCheck, u as isExecSyncError } from "./check-COzp4S_Q.mjs";
 import { defineCommand, runMain } from "citty";
 import * as p from "@clack/prompts";
 import { isCancel, select } from "@clack/prompts";
@@ -590,6 +590,8 @@ const DockerCheckConfigSchema = z.object({
 	healthChecks: z.array(DeclarativeHealthCheckSchema).optional().meta({ description: "Health check definitions" }),
 	buildCommand: z.array(z.string()).optional().meta({ description: "Command to build images before checking (e.g. [\"pnpm\", \"image:build\"])" }),
 	buildCwd: z.string().optional().meta({ description: "Working directory for build command" }),
+	smoketest: z.array(z.string()).optional().meta({ description: "Command to run as a smoketest after health checks pass (e.g. [\"pnpm\", \"test:smoke\"])" }),
+	smoketestCwd: z.string().optional().meta({ description: "Working directory for smoketest command" }),
 	timeoutMs: z.number().int().positive().optional().meta({ description: "Overall timeout in milliseconds" }),
 	pollIntervalMs: z.number().int().positive().optional().meta({ description: "Poll interval in milliseconds" })
 });
@@ -1367,65 +1369,65 @@ const PER_PACKAGE_DEV_DEPS = {
 	"@types/node": {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["@types/node"],
 	tsdown: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["tsdown"],
 	typescript: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["typescript"],
 	vitest: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["vitest"]
 };
@@ -1434,49 +1436,49 @@ const ROOT_DEV_DEPS = {
 	knip: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["knip"],
 	lefthook: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["lefthook"],
 	oxlint: {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["oxlint"]
 };
@@ -1507,33 +1509,33 @@ function addReleaseDeps(deps, config) {
 			deps["release-it"] = {
 				"@changesets/cli": "2.30.0",
 				"@release-it/bumper": "7.0.5",
-				"@types/node": "24.12.0",
+				"@types/node": "24.12.2",
 				"commit-and-tag-version": "12.7.1",
-				"knip": "6.3.0",
-				"lefthook": "2.1.4",
-				"oxfmt": "0.43.0",
-				"oxlint": "1.58.0",
-				"prettier": "3.8.1",
+				"knip": "6.3.1",
+				"lefthook": "2.1.5",
+				"oxfmt": "0.44.0",
+				"oxlint": "1.59.0",
+				"prettier": "3.8.2",
 				"release-it": "19.2.4",
 				"tsdown": "0.21.7",
 				"typescript": "6.0.2",
-				"vitest": "4.1.2",
+				"vitest": "4.1.4",
 				"pnpm": "10.33.0"
 			}["release-it"];
 			if (config.structure === "monorepo") deps["@release-it/bumper"] = {
 				"@changesets/cli": "2.30.0",
 				"@release-it/bumper": "7.0.5",
-				"@types/node": "24.12.0",
+				"@types/node": "24.12.2",
 				"commit-and-tag-version": "12.7.1",
-				"knip": "6.3.0",
-				"lefthook": "2.1.4",
-				"oxfmt": "0.43.0",
-				"oxlint": "1.58.0",
-				"prettier": "3.8.1",
+				"knip": "6.3.1",
+				"lefthook": "2.1.5",
+				"oxfmt": "0.44.0",
+				"oxlint": "1.59.0",
+				"prettier": "3.8.2",
 				"release-it": "19.2.4",
 				"tsdown": "0.21.7",
 				"typescript": "6.0.2",
-				"vitest": "4.1.2",
+				"vitest": "4.1.4",
 				"pnpm": "10.33.0"
 			}["@release-it/bumper"];
 			break;
@@ -1541,17 +1543,17 @@ function addReleaseDeps(deps, config) {
 			deps["commit-and-tag-version"] = {
 				"@changesets/cli": "2.30.0",
 				"@release-it/bumper": "7.0.5",
-				"@types/node": "24.12.0",
+				"@types/node": "24.12.2",
 				"commit-and-tag-version": "12.7.1",
-				"knip": "6.3.0",
-				"lefthook": "2.1.4",
-				"oxfmt": "0.43.0",
-				"oxlint": "1.58.0",
-				"prettier": "3.8.1",
+				"knip": "6.3.1",
+				"lefthook": "2.1.5",
+				"oxfmt": "0.44.0",
+				"oxlint": "1.59.0",
+				"prettier": "3.8.2",
 				"release-it": "19.2.4",
 				"tsdown": "0.21.7",
 				"typescript": "6.0.2",
-				"vitest": "4.1.2",
+				"vitest": "4.1.4",
 				"pnpm": "10.33.0"
 			}["commit-and-tag-version"];
 			break;
@@ -1559,17 +1561,17 @@ function addReleaseDeps(deps, config) {
 			deps["@changesets/cli"] = {
 				"@changesets/cli": "2.30.0",
 				"@release-it/bumper": "7.0.5",
-				"@types/node": "24.12.0",
+				"@types/node": "24.12.2",
 				"commit-and-tag-version": "12.7.1",
-				"knip": "6.3.0",
-				"lefthook": "2.1.4",
-				"oxfmt": "0.43.0",
-				"oxlint": "1.58.0",
-				"prettier": "3.8.1",
+				"knip": "6.3.1",
+				"lefthook": "2.1.5",
+				"oxfmt": "0.44.0",
+				"oxlint": "1.59.0",
+				"prettier": "3.8.2",
 				"release-it": "19.2.4",
 				"tsdown": "0.21.7",
 				"typescript": "6.0.2",
-				"vitest": "4.1.2",
+				"vitest": "4.1.4",
 				"pnpm": "10.33.0"
 			}["@changesets/cli"];
 			break;
@@ -1594,38 +1596,38 @@ 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.10.2";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.50.2";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.51.1";
 	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.12.0";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["oxfmt"];
 	if (ctx.config.formatter === "prettier") devDeps["prettier"] = {
 		"@changesets/cli": "2.30.0",
 		"@release-it/bumper": "7.0.5",
-		"@types/node": "24.12.0",
+		"@types/node": "24.12.2",
 		"commit-and-tag-version": "12.7.1",
-		"knip": "6.3.0",
-		"lefthook": "2.1.4",
-		"oxfmt": "0.43.0",
-		"oxlint": "1.58.0",
-		"prettier": "3.8.1",
+		"knip": "6.3.1",
+		"lefthook": "2.1.5",
+		"oxfmt": "0.44.0",
+		"oxlint": "1.59.0",
+		"prettier": "3.8.2",
 		"release-it": "19.2.4",
 		"tsdown": "0.21.7",
 		"typescript": "6.0.2",
-		"vitest": "4.1.2",
+		"vitest": "4.1.4",
 		"pnpm": "10.33.0"
 	}["prettier"];
 	addReleaseDeps(devDeps, ctx.config);
@@ -1709,17 +1711,17 @@ async function generatePackageJson(ctx) {
 		packageManager: `pnpm@${{
 			"@changesets/cli": "2.30.0",
 			"@release-it/bumper": "7.0.5",
-			"@types/node": "24.12.0",
+			"@types/node": "24.12.2",
 			"commit-and-tag-version": "12.7.1",
-			"knip": "6.3.0",
-			"lefthook": "2.1.4",
-			"oxfmt": "0.43.0",
-			"oxlint": "1.58.0",
-			"prettier": "3.8.1",
+			"knip": "6.3.1",
+			"lefthook": "2.1.5",
+			"oxfmt": "0.44.0",
+			"oxlint": "1.59.0",
+			"prettier": "3.8.2",
 			"release-it": "19.2.4",
 			"tsdown": "0.21.7",
 			"typescript": "6.0.2",
-			"vitest": "4.1.2",
+			"vitest": "4.1.4",
 			"pnpm": "10.33.0"
 		}["pnpm"]}`
 	};
@@ -2168,7 +2170,7 @@ const REQUIRED_ENTRIES = [
 const OPTIONAL_ENTRIES = [
 	".tooling-migrate.md",
 	".tooling-archived/",
-	".claude/hooks/bst-hook.audit.local.jsonl"
+	".claude/hooks/bst-hook.audit.local.jsonl*"
 ];
 const ALL_ENTRIES = [...REQUIRED_ENTRIES, ...OPTIONAL_ENTRIES];
 /** Normalize a gitignore entry for comparison: strip leading `/` and trailing `/`. */
@@ -3368,7 +3370,7 @@ async function runGenerators(ctx) {
 function generateMigratePrompt(results, config, detected) {
 	const sections = [];
 	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.50.2 repo:sync\` on ${timestamp}_\n`);
+	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.51.1 repo:sync\` on ${timestamp}_\n`);
 	const changed = results.filter((r) => r.action === "created" || r.action === "updated" || r.action === "archived");
 	if (changed.length > 0) {
 		const items = changed.map((r) => {
@@ -5516,19 +5518,37 @@ const CHECK_HEALTHCHECK = {
 	start_interval: "5s"
 };
 /**
+* Whether a service image references a compose variable substitution (e.g. `${REGISTRY:-}…`).
+* Consumers use this pattern to parametrize the build-vs-registry split, so such services
+* are locally built rather than pulled from a registry — forcing `pull_policy: never` for
+* the check avoids failures when the base compose sets `pull_policy: always` for prod deploys.
+*/
+function isLocallyBuiltImage(image) {
+	return image !== void 0 && /\$\{[^}]*\}/.test(image);
+}
+/**
 * Generate a check overlay YAML string from parsed services.
-* Sets `restart: "no"` on all services, and overrides healthcheck intervals
-* for services that define a healthcheck in the base compose file.
+* Sets `restart: "no"` on all services, overrides healthcheck intervals
+* for services that define a healthcheck in the base compose file, and
+* forces `pull_policy: never` on services whose image uses a variable
+* substitution (locally-built images that aren't pushed to a registry).
 */
 function generateCheckOverlay(services) {
 	const serviceOverrides = {};
 	for (const service of services) {
 		const override = { restart: "no" };
 		if (service.hasHealthcheck) override["healthcheck"] = { ...CHECK_HEALTHCHECK };
+		if (isLocallyBuiltImage(service.image)) override["pull_policy"] = "never";
 		serviceOverrides[service.name] = override;
 	}
 	return stringify({ services: serviceOverrides });
 }
+/** Detect a smoketest command from a `test:smoke` script in the root package.json. */
+function detectSmoketest(cwd) {
+	try {
+		if (parsePackageJson(readFileSync(path.join(cwd, "package.json"), "utf-8"))?.scripts?.["test:smoke"]) return ["pnpm", "test:smoke"];
+	} catch (_error) {}
+}
 /** Auto-detect compose config from conventional file locations. */
 function computeCheckDefaults(cwd) {
 	const { dir, files } = detectComposeFiles(cwd);
@@ -5538,13 +5558,15 @@ function computeCheckDefaults(cwd) {
 	const envFile = detectCheckEnvFile(dir);
 	const services = parseComposeServices(dir, files);
 	const healthChecks = deriveHealthChecks(services);
+	const smoketest = detectSmoketest(cwd);
 	return {
 		composeCwd: dir !== cwd ? dir : void 0,
 		composeFiles: files,
 		checkOverlay,
 		envFile,
 		services: services.map((s) => s.name),
-		healthChecks: healthChecks.length > 0 ? healthChecks : void 0
+		healthChecks: healthChecks.length > 0 ? healthChecks : void 0,
+		smoketest
 	};
 }
 /** Create a DockerFileReader backed by the real filesystem. */
@@ -5605,11 +5627,15 @@ const dockerCheckCommand = defineCommand({
 	},
 	async run({ args }) {
 		const cwd = process.cwd();
-		if (loadToolingConfig(cwd)?.dockerCheck === false) {
+		const toolingConfig = loadToolingConfig(cwd);
+		if (toolingConfig?.dockerCheck === false) {
 			log.info("Docker check is disabled in .tooling.json");
 			return;
 		}
-		const defaults = computeCheckDefaults(cwd);
+		const defaults = {
+			...computeCheckDefaults(cwd),
+			...toolingConfig?.dockerCheck
+		};
 		if (!defaults.composeFiles || defaults.composeFiles.length === 0) throw new FatalError("No compose files found. Expected docker-compose.yaml or compose.yaml in ./ or docker/.");
 		if (!defaults.checkOverlay) {
 			const composeCwd = defaults.composeCwd ?? cwd;
@@ -5648,6 +5674,8 @@ const dockerCheckCommand = defineCommand({
 				buildCommand: defaults.buildCommand,
 				buildCwd: defaults.buildCwd,
 				healthChecks: defaults.healthChecks ? toHttpHealthChecks(defaults.healthChecks) : [],
+				smoketest: defaults.smoketest,
+				smoketestCwd: defaults.smoketestCwd,
 				timeoutMs: args.timeout ? Number.parseInt(args.timeout, 10) : defaults.timeoutMs,
 				pollIntervalMs: args["poll-interval"] ? Number.parseInt(args["poll-interval"], 10) : defaults.pollIntervalMs,
 				verbose: args.verbose === true || isEnvVerbose()
@@ -6459,7 +6487,7 @@ const webhookSendCommand = defineCommand({
 const main = defineCommand({
 	meta: {
 		name: "bst",
-		version: "0.50.2",
+		version: "0.51.1",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -6480,7 +6508,7 @@ const main = defineCommand({
 		"webhook:send": webhookSendCommand
 	}
 });
-console.log(`@bensandee/tooling v0.50.2`);
+console.log(`@bensandee/tooling v0.51.1`);
 async function run() {
 	await runMain(main);
 	process.exit(process.exitCode ?? 0);

package/dist/{check-hutCTIXe.mjs → check-COzp4S_Q.mjs}

@@ -128,6 +128,13 @@ function buildImages(executor, config) {
 	if (!file) return;
 	executor.execInherit(file, args, { cwd: config.buildCwd ?? config.compose.cwd });
 }
+/** Run the smoketest command against the running stack. */
+function runSmoketest(executor, config) {
+	if (!config.smoketest) return;
+	const [file, ...args] = config.smoketest;
+	if (!file) return;
+	executor.execInherit(file, args, { cwd: config.smoketestCwd ?? config.compose.cwd });
+}
 /** Start the compose stack in detached mode. */
 function composeUp(executor, config) {
 	executor.execInherit("docker", [
@@ -263,6 +270,24 @@ async function runDockerCheck(executor, config) {
 				}
 			}
 			if (allContainersHealthy && [...healthStatus.values()].every(Boolean)) {
+				if (config.smoketest) {
+					executor.log(`Running smoketest: ${config.smoketest.join(" ")}`);
+					try {
+						runSmoketest(executor, config);
+						executor.log("Smoketest passed!");
+					} catch (error) {
+						const message = error instanceof Error ? error.message : String(error);
+						executor.logError(`Smoketest failed: ${message}`);
+						for (const service of compose.services) composeLogs(executor, compose, service);
+						cleanup();
+						return {
+							success: false,
+							reason: "smoketest-failed",
+							message,
+							elapsedMs: executor.now() - startTime
+						};
+					}
+				}
 				executor.log("Check successful! All systems operational.");
 				cleanup();
 				return {

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

@@ -68,6 +68,10 @@ interface CheckConfig {
   buildCwd?: string;
   /** HTTP health checks to poll. All must pass for success. */
   healthChecks: HttpHealthCheck[];
+  /** Optional smoketest command to run after all health checks pass (e.g. ["pnpm", "test:smoke"]). */
+  smoketest?: string[];
+  /** Working directory for the smoketest command (defaults to compose.cwd). */
+  smoketestCwd?: string;
   /** Maximum time to wait for all checks to pass, in ms. Default: 120000. */
   timeoutMs?: number;
   /** Interval between polling attempts, in ms. Default: 5000. */
@@ -81,7 +85,7 @@ type CheckResult = {
   elapsedMs: number;
 } | {
   success: false;
-  reason: "timeout" | "unhealthy-container" | "error";
+  reason: "timeout" | "unhealthy-container" | "smoketest-failed" | "error";
   message: string;
   elapsedMs: number;
 };

package/dist/docker-check/index.mjs

@@ -1,2 +1,2 @@
-import { a as composeDown, c as composeUp, i as composeArgs, l as createRealExecutor, n as checkHttpHealth, o as composeLogs, r as getContainerHealth, s as composePs, t as runDockerCheck } from "../check-hutCTIXe.mjs";
+import { a as composeDown, c as composeUp, i as composeArgs, l as createRealExecutor, n as checkHttpHealth, o as composeLogs, r as getContainerHealth, s as composePs, t as runDockerCheck } from "../check-COzp4S_Q.mjs";
 export { checkHttpHealth, composeArgs, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runDockerCheck };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.50.2",
+  "version": "0.51.1",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "license": "MIT",
   "repository": {
@@ -48,14 +48,14 @@
   "devDependencies": {
     "@changesets/cli": "2.30.0",
     "@release-it/bumper": "7.0.5",
-    "@types/node": "24.12.0",
+    "@types/node": "24.12.2",
     "@types/picomatch": "4.0.3",
     "commit-and-tag-version": "12.7.1",
-    "prettier": "3.8.1",
+    "prettier": "3.8.2",
     "release-it": "19.2.4",
     "tsdown": "0.21.7",
-    "@bensandee/config": "0.10.2",
-    "@bensandee/claude-hooks": "0.7.0"
+    "@bensandee/claude-hooks": "0.7.0",
+    "@bensandee/config": "0.10.2"
   },
   "scripts": {
     "build": "tsdown",

package/tooling.schema.json

@@ -144,6 +144,17 @@
               "description": "Working directory for build command",
               "type": "string"
             },
+            "smoketest": {
+              "description": "Command to run as a smoketest after health checks pass (e.g. [\"pnpm\", \"test:smoke\"])",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "smoketestCwd": {
+              "description": "Working directory for smoketest command",
+              "type": "string"
+            },
             "timeoutMs": {
               "description": "Overall timeout in milliseconds",
               "type": "integer",