@bensandee/tooling 0.22.0 → 0.23.0

package/dist/bin.mjs

@@ -7,9 +7,9 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, unlinkSync, w
 import JSON5 from "json5";
 import { parse } from "jsonc-parser";
 import { z } from "zod";
+import { FatalError, TransientError, UnexpectedError } from "@bensandee/common";
 import { isMap, isScalar, isSeq, parse as parse$1, parseDocument, stringify } from "yaml";
 import { execSync } from "node:child_process";
-import { FatalError, TransientError, UnexpectedError } from "@bensandee/common";
 import { tmpdir } from "node:os";
 //#region src/types.ts
 const LEGACY_TOOLS = [
@@ -201,7 +201,7 @@ function computeDefaults(targetDir) {
 		setupVitest: !isMonorepo && !detected.hasVitestConfig,
 		ci: detectCiPlatform(targetDir),
 		setupRenovate: true,
-		releaseStrategy: isMonorepo ? "changesets" : "simple",
+		releaseStrategy: "none",
 		projectType: isMonorepo ? "default" : detectProjectType(targetDir),
 		detectPackageTypes: true
 	};
@@ -493,7 +493,8 @@ const DockerCheckConfigSchema = z.object({
 	timeoutMs: z.number().int().positive().optional(),
 	pollIntervalMs: z.number().int().positive().optional()
 });
-const ToolingConfigSchema = z.object({
+const ToolingConfigSchema = z.strictObject({
+	$schema: z.string().optional(),
 	structure: z.enum(["single", "monorepo"]).optional(),
 	useEslintPlugin: z.boolean().optional(),
 	formatter: z.enum(["oxfmt", "prettier"]).optional(),
@@ -524,17 +525,14 @@ const ToolingConfigSchema = z.object({
 	})).optional(),
 	dockerCheck: z.union([z.literal(false), DockerCheckConfigSchema]).optional()
 });
-/** Load saved tooling config from the target directory. Returns undefined if missing or invalid. */
+/** Load saved tooling config from the target directory. Returns undefined if missing, throws on invalid. */
 function loadToolingConfig(targetDir) {
 	const fullPath = path.join(targetDir, CONFIG_FILE);
 	if (!existsSync(fullPath)) return void 0;
-	try {
-		const raw = readFileSync(fullPath, "utf-8");
-		const result = ToolingConfigSchema.safeParse(JSON.parse(raw));
-		return result.success ? result.data : void 0;
-	} catch {
-		return;
-	}
+	const raw = readFileSync(fullPath, "utf-8");
+	const result = ToolingConfigSchema.safeParse(JSON.parse(raw));
+	if (!result.success) throw new FatalError(`Invalid .tooling.json:\n${result.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n")}`);
+	return result.data;
 }
 /** Config fields that can be overridden in .tooling.json. */
 const OVERRIDE_KEYS = [
@@ -558,7 +556,7 @@ const MONOREPO_IGNORED_KEYS = new Set(["setupVitest", "projectType"]);
 function saveToolingConfig(ctx, config) {
 	const defaults = computeDefaults(config.targetDir);
 	const isMonorepo = config.structure === "monorepo";
-	const overrides = {};
+	const overrides = { $schema: "node_modules/@bensandee/tooling/tooling.schema.json" };
 	for (const key of OVERRIDE_KEYS) {
 		if (isMonorepo && MONOREPO_IGNORED_KEYS.has(key)) continue;
 		if (config[key] !== defaults[key]) overrides[key] = config[key];
@@ -983,7 +981,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.22.0";
+	deps["@bensandee/tooling"] = "0.23.0";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -1008,7 +1006,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.22.0";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.23.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";
@@ -1494,25 +1492,26 @@ function actionsExpr$1(expr) {
 }
 const CI_CONCURRENCY = {
 	group: `ci-${actionsExpr$1("github.ref")}`,
-	"cancel-in-progress": true
+	"cancel-in-progress": actionsExpr$1("github.ref != 'refs/heads/main'")
 };
 function hasEnginesNode$1(ctx) {
 	const raw = ctx.read("package.json");
 	if (!raw) return false;
 	return typeof parsePackageJson(raw)?.engines?.["node"] === "string";
 }
-function ciWorkflow(nodeVersionYaml, isForgejo) {
+function ciWorkflow(nodeVersionYaml, isForgejo, isChangesets) {
 	const emailNotifications = isForgejo ? "\nenable-email-notifications: true\n" : "";
+	const concurrencyBlock = isChangesets ? `
+concurrency:
+  group: ci-${actionsExpr$1("github.ref")}
+  cancel-in-progress: ${actionsExpr$1("github.ref != 'refs/heads/main'")}
+` : "";
 	return `${workflowSchemaComment(isForgejo ? "forgejo" : "github")}name: CI
 ${emailNotifications}on:
   push:
     branches: [main]
   pull_request:
-
-concurrency:
-  group: ci-${actionsExpr$1("github.ref")}
-  cancel-in-progress: true
-
+${concurrencyBlock}
 jobs:
   check:
     runs-on: ubuntu-latest
@@ -1561,6 +1560,10 @@ function requiredCheckSteps(nodeVersionYaml) {
 		}
 	];
 }
+/** Resolve the CI workflow filename based on release strategy. */
+function ciWorkflowPath(ci, releaseStrategy) {
+	return `${ci === "github" ? ".github/workflows" : ".forgejo/workflows"}/${releaseStrategy === "changesets" ? "ci.yml" : "check.yml"}`;
+}
 async function generateCi(ctx) {
 	if (ctx.config.ci === "none") return {
 		filePath: "ci",
@@ -1568,16 +1571,23 @@ async function generateCi(ctx) {
 		description: "CI workflow not requested"
 	};
 	const isGitHub = ctx.config.ci === "github";
+	const isChangesets = ctx.config.releaseStrategy === "changesets";
 	const nodeVersionYaml = hasEnginesNode$1(ctx) ? "node-version-file: package.json" : "node-version: \"24\"";
-	const filePath = isGitHub ? ".github/workflows/ci.yml" : ".forgejo/workflows/ci.yml";
-	const content = ciWorkflow(nodeVersionYaml, !isGitHub);
+	const filePath = ciWorkflowPath(ctx.config.ci, ctx.config.releaseStrategy);
+	const content = ciWorkflow(nodeVersionYaml, !isGitHub, isChangesets);
 	if (ctx.exists(filePath)) {
 		const existing = ctx.read(filePath);
 		if (existing) {
-			const merged = mergeWorkflowSteps(existing, "check", requiredCheckSteps(nodeVersionYaml));
-			const withConcurrency = ensureWorkflowConcurrency(merged.content, CI_CONCURRENCY);
-			const withComment = ensureSchemaComment(withConcurrency.content, isGitHub ? "github" : "forgejo");
-			if (merged.changed || withConcurrency.changed || withComment !== withConcurrency.content) {
+			let result = mergeWorkflowSteps(existing, "check", requiredCheckSteps(nodeVersionYaml));
+			if (isChangesets) {
+				const withConcurrency = ensureWorkflowConcurrency(result.content, CI_CONCURRENCY);
+				result = {
+					content: withConcurrency.content,
+					changed: result.changed || withConcurrency.changed
+				};
+			}
+			const withComment = ensureSchemaComment(result.content, isGitHub ? "github" : "forgejo");
+			if (result.changed || withComment !== result.content) {
 				ctx.write(filePath, withComment);
 				return {
 					filePath,
@@ -2215,7 +2225,7 @@ function buildWorkflow(strategy, ci, nodeVersionYaml, publishesNpm) {
 	}
 }
 function generateChangesetsReleaseCi(ctx, publishesNpm) {
-	const ciPath = ctx.config.ci === "github" ? ".github/workflows/ci.yml" : ".forgejo/workflows/ci.yml";
+	const ciPath = ciWorkflowPath(ctx.config.ci, ctx.config.releaseStrategy);
 	const existing = ctx.read(ciPath);
 	if (!existing) return {
 		filePath: ciPath,
@@ -4577,7 +4587,7 @@ const dockerCheckCommand = defineCommand({
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.22.0",
+		version: "0.23.0",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -4593,7 +4603,7 @@ const main = defineCommand({
 		"docker:check": dockerCheckCommand
 	}
 });
-console.log(`@bensandee/tooling v0.22.0`);
+console.log(`@bensandee/tooling v0.23.0`);
 runMain(main);
 //#endregion
 export {};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "tooling.schema.json"
   ],
   "type": "module",
   "imports": {
@@ -22,7 +23,8 @@
       "types": "./dist/docker-check/index.d.mts",
       "default": "./dist/docker-check/index.mjs"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./tooling.schema.json": "./tooling.schema.json"
   },
   "publishConfig": {
     "access": "public"

package/tooling.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "@bensandee/tooling configuration",
+  "description": "Override convention-detected defaults for repo:sync. Only fields that differ from detected defaults need to be specified.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference (ignored by tooling)"
+    },
+    "structure": {
+      "type": "string",
+      "enum": ["single", "monorepo"],
+      "description": "Project structure"
+    },
+    "useEslintPlugin": {
+      "type": "boolean",
+      "description": "Include @bensandee/eslint-plugin oxlint plugin"
+    },
+    "formatter": {
+      "type": "string",
+      "enum": ["oxfmt", "prettier"],
+      "description": "Formatter choice"
+    },
+    "setupVitest": {
+      "type": "boolean",
+      "description": "Generate vitest config and example test"
+    },
+    "ci": {
+      "type": "string",
+      "enum": ["github", "forgejo", "none"],
+      "description": "CI platform"
+    },
+    "setupRenovate": {
+      "type": "boolean",
+      "description": "Generate Renovate config"
+    },
+    "releaseStrategy": {
+      "type": "string",
+      "enum": ["release-it", "simple", "changesets", "none"],
+      "description": "Release management strategy"
+    },
+    "projectType": {
+      "type": "string",
+      "enum": ["default", "node", "react", "library"],
+      "description": "Project type (determines tsconfig base)"
+    },
+    "detectPackageTypes": {
+      "type": "boolean",
+      "description": "Auto-detect project types for monorepo packages"
+    },
+    "setupDocker": {
+      "type": "boolean",
+      "description": "Generate Docker build/check scripts"
+    },
+    "docker": {
+      "type": "object",
+      "description": "Docker package overrides (package name → config)",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["dockerfile"],
+        "properties": {
+          "dockerfile": {
+            "type": "string",
+            "description": "Path to Dockerfile relative to package"
+          },
+          "context": {
+            "type": "string",
+            "default": ".",
+            "description": "Docker build context relative to package"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "dockerCheck": {
+      "oneOf": [
+        {
+          "const": false,
+          "description": "Disable Docker health checks"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "composeFiles": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Compose files to use"
+            },
+            "envFile": {
+              "type": "string",
+              "description": "Environment file for compose"
+            },
+            "services": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Services to check (default: all)"
+            },
+            "healthChecks": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "url"],
+                "additionalProperties": false,
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Service name"
+                  },
+                  "url": {
+                    "type": "string",
+                    "description": "Health check URL"
+                  },
+                  "status": {
+                    "type": "integer",
+                    "description": "Expected HTTP status code"
+                  }
+                }
+              },
+              "description": "Health check definitions"
+            },
+            "buildCommand": {
+              "type": "string",
+              "description": "Command to build images before checking"
+            },
+            "buildCwd": {
+              "type": "string",
+              "description": "Working directory for build command"
+            },
+            "timeoutMs": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Overall timeout in milliseconds"
+            },
+            "pollIntervalMs": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Poll interval in milliseconds"
+            }
+          }
+        }
+      ],
+      "description": "Docker health check configuration or false to disable"
+    }
+  }
+}