@bensandee/tooling 0.79.0 → 0.80.0

package/dist/bin.mjs

@@ -397,7 +397,7 @@ function loadEnvFileForBin(rawArgs, io = processIo) {
 		if (resolveJsonMode(rawArgs)) {
 			const document = buildErrorDocument({
 				command: resolveCommandName(rawArgs),
-				version: "0.79.0",
+				version: "0.80.0",
 				kind: "usage",
 				message
 			});
@@ -764,6 +764,11 @@ const AsciiConfigSchema = z.strictObject({
 	treatAsProse: z.array(z.string()).optional().meta({ description: "Path globs (matched the same way as exclude) whose files --fix classifies as prose wholesale regardless of extension, flattening rather than flagging. The opt-back-in for an extension with no dedicated lexical-context classifier where blind flattening is known safe. No built-in defaults." })
 });
 const LintConfigSchema = z.strictObject({ strictTypeAware: z.boolean().optional().meta({ description: "Make `bst lint:types` (the type-aware oxlint gate, backed by oxlint-tsgolint) exit non-zero on any finding while the tooling is still in its report phase (default false; the enforce phase, a later tooling release, exits non-zero unconditionally). A missing oxlint-tsgolint binary is also a hard failure rather than a notice while this is set: arming the gate is what turns a platform gap into a build break, deliberately, because the repo that armed it is the one that asked for it." }) });
+const ChecksConfigSchema = z.strictObject({
+	add: z.array(z.string()).optional().meta({ description: "Extra package.json scripts to run as first-class check steps, appended to the built-in list (e.g. ['lint:php']). An added step with no matching script is a hard failure." }),
+	skip: z.array(z.string()).optional().meta({ description: "Check steps to skip, unioned with the built-in CI defaults (never replacing them). Supports glob patterns." }),
+	runOnVersionPr: z.boolean().optional().meta({ description: "Run the CI check job on the changesets version PR (changeset-release/main). Default false: the generated check job is skipped there, because that branch is regenerated on every push to main and main's own run gates the release. Has no effect unless releaseStrategy is changesets." })
+});
 const CoverageConfigSchema = z.strictObject({
 	history: z.enum(["orphan-branch", "none"]).optional().meta({ description: "How coverage history is persisted. 'orphan-branch' (default) appends to a dedicated branch; 'none' disables CI history but keeps the local ratchet." }),
 	historyBranch: z.string().optional().meta({ description: "Orphan branch name for coverage history (default: 'bst/coverage-metrics')" }),
@@ -1892,10 +1897,6 @@ const BranchPruneConfigSchema = z.strictObject({
 	exclude: z.array(z.string()).optional().meta({ description: "Branch-name globs added to bst branch:prune's built-in never-touch list (main, changeset-release/*, renovate/*, bst/coverage-metrics, bst/health-metrics, bst/egress-metrics, anything with an open PR or protected). Additive only -- there is no key that removes a built-in entry." })
 });
 const IssuesConfigSchema = z.strictObject({ assignees: z.array(z.string().min(1)).optional().meta({ description: "The repo's default reviewer(s) for issues opened by `bst issue:create` -- assigned when the invocation names no --assignee and no --repo. An explicit --assignee replaces this default rather than adding to it; --no-assignee opens an issue deliberately unassigned." }) });
-const ChecksConfigSchema = z.strictObject({
-	add: z.array(z.string()).optional().meta({ description: "Extra package.json scripts to run as first-class check steps, appended to the built-in list (e.g. ['lint:php']). An added step with no matching script is a hard failure." }),
-	skip: z.array(z.string()).optional().meta({ description: "Check steps to skip, unioned with the built-in CI defaults (never replacing them). Supports glob patterns." })
-});
 /** One label definition inside a `labelSets` entry -- the same shape `bst forgejo:labels sync`
 * writes to the forge (`AgentLabelSpec` in `@bensandee/forgejo/label-provisioning`), expressed as a
 * zod schema so a malformed entry in `.tooling.json` fails at load time rather than at the first API
@@ -5225,6 +5226,7 @@ function buildWorkflowYaml(options) {
 	if (options.permissions) doc["permissions"] = options.permissions;
 	if (options.concurrency) doc["concurrency"] = options.concurrency;
 	const jobs = { [options.jobName]: {
+		...options.jobIf && { if: options.jobIf },
 		"runs-on": options.runsOn ?? "ubuntu-latest",
 		...options.jobEnv && { env: options.jobEnv },
 		...options.jobOutputs && { outputs: options.jobOutputs },
@@ -6712,7 +6714,7 @@ function buildManagedDevDeps(ctx) {
 	const devDeps = { ...rootDevDeps(ctx.config) };
 	if (!isMonorepo) Object.assign(devDeps, perPackageDevDeps(ctx.config));
 	if (ctx.config.stack !== "none" || ctx.config.ci === "forgejo") devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.14.5";
-	if (!isWorkspacePackage(ctx, "@bensandee/tooling")) devDeps["@bensandee/tooling"] = "0.79.0";
+	if (!isWorkspacePackage(ctx, "@bensandee/tooling")) devDeps["@bensandee/tooling"] = "0.80.0";
 	if (ctx.config.useEslintPlugin && ctx.config.stack !== "none") devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.15.2";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = {
 		"@changesets/cli": "3.0.3",
@@ -9182,6 +9184,16 @@ async function generateReleaseCi(ctx) {
 	};
 }
 //#endregion
+//#region src/release/version-branch.ts
+/**
+* The branch the changesets release flow writes its version commit to, and so the head branch of
+* the version PR. `bst release:changesets` force-pushes it on Forgejo; on GitHub it is
+* `changesets/action@v1`'s default, `changeset-release/<base>`. Not configurable. The CI generator
+* reads it too, to skip the check job on that PR, which is why it lives at `release/`'s root
+* rather than in `publish/`.
+*/
+const VERSION_PR_BRANCH = "changeset-release/main";
+//#endregion
 //#region src/generators/ci.ts
 function coverageHistorySteps() {
 	return [
@@ -9381,6 +9393,8 @@ async function generateCi(ctx) {
 		...emitCoverageSteps || emitHealthHistory ? IS_MAIN_JOB_ENV : {},
 		...npmAuth.jobEnv
 	};
+	const checksSlice = parseToolingConfigSlice(ctx.read(".tooling.json"), z.object({ checks: ChecksConfigSchema.optional() }), { block: "checks" });
+	const skipOnVersionPr = isChangesets && checksSlice?.checks?.runOnVersionPr !== true;
 	const content = buildWorkflowYaml({
 		ci: ctx.config.ci,
 		name: "CI",
@@ -9395,6 +9409,7 @@ async function generateCi(ctx) {
 		enableEmailNotifications: isForgejo,
 		...isChangesets && { concurrency: ciConcurrency(ctx.config.ci) },
 		jobName: "check",
+		...skipOnVersionPr && { jobIf: `github.head_ref != 'changeset-release/main'` },
 		...Object.keys(checkJobEnv).length > 0 && { jobEnv: checkJobEnv },
 		...jobOutputs && { jobOutputs },
 		steps,
@@ -10660,7 +10675,11 @@ const GIT_GUIDE_BODY = [
 	"",
 	"## Commit subjects",
 	"",
-	"Follow Conventional Commits: `<type>(<scope>): <summary>`. The type is one of `feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `perf`, `build`, `ci`; the scope is optional and names the package or area touched; the summary is an imperative, plain-language sentence. This binds a commit message you suggest to the user too. Nothing checks it, so do not copy the style of recent `git log` if it has drifted."
+	"Follow Conventional Commits: `<type>(<scope>): <summary>`. The type is one of `feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `perf`, `build`, `ci`; the scope is optional and names the package or area touched; the summary is an imperative, plain-language sentence. This binds a commit message you suggest to the user too. Nothing checks it, so do not copy the style of recent `git log` if it has drifted.",
+	"",
+	"## Pull request titles",
+	"",
+	"Start a pull request's title with the stage it carries: `Spec:` for a spec, `Plan:` for a plan, and no stem once it carries the implementation. A draft keeps its `WIP:` marker in front (`WIP: Plan: Add retry to uploads`). When a pull request moves on to the next stage, move the stem with it. This is informational -- nothing checks it and nothing fails without it -- but it tells a reviewer at a glance what they are reading."
 ].join("\n");
 /**
 * The plan lifecycle. `bst docs:check` owns the mechanics; this states the one rule it cannot
@@ -11324,7 +11343,7 @@ function reportFailures(failed, command) {
 function generateMigratePrompt(results, config, detected) {
 	const sections = [];
 	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.79.0 repo:sync\` on ${timestamp}_\n`);
+	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.80.0 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) => {
@@ -12350,6 +12369,32 @@ function execStep(cmd, cwd, sink = process.stdout) {
 	});
 }
 //#endregion
+//#region src/checks/skip-report.ts
+function matches(name, patterns) {
+	return patterns.size > 0 && picomatch.isMatch(name, [...patterns]);
+}
+/**
+* Which steps each skip source removed, for reporting. Only a step with a defined script is
+* named: one without a script was never going to run, so a repo with no Docker is never told
+* `docker:build` was skipped. A step matched by both sources is credited to `--skip`, the one
+* the caller typed.
+*/
+function groupSkippedSteps(steps, defined, flagSkip, configSkip) {
+	const bySource = {
+		"--skip": [],
+		"checks.skip": []
+	};
+	for (const name of steps) {
+		if (!defined.has(name)) continue;
+		if (matches(name, flagSkip)) bySource["--skip"].push(name);
+		else if (matches(name, configSkip)) bySource["checks.skip"].push(name);
+	}
+	return ["--skip", "checks.skip"].filter((source) => bySource[source].length > 0).map((source) => ({
+		source,
+		steps: bySource[source]
+	}));
+}
+//#endregion
 //#region src/utils/branch.ts
 const BRANCH_REF_PREFIX = "refs/heads/";
 function defaultGitRunner(args, cwd) {
@@ -12601,8 +12646,20 @@ function defaultGetScripts(targetDir) {
 	}
 }
 const rawLog$2 = (msg) => console.log(msg);
-function advisorySummary(warned) {
-	return `All checks passed (${String(warned.length)} advisory: ${warned.map((w) => w.name).join(", ")})`;
+/**
+* The skipped names on a failing run, as a line of their own. Never folded into the
+* `Failed checks: <names>` line: the agent's verify backstop (`parseFailingStep`) reads
+* everything after it as step names and discards the lot on anything else.
+*/
+function failedRunSkippedLine(skipped) {
+	return skipped.length === 0 ? null : `Skipped: ${skipped.join(", ")}`;
+}
+function passedSummary(warned, skipped) {
+	const parts = [...warned.length > 0 ? [`${String(warned.length)} advisory: ${warned.map((w) => w.name).join(", ")}`] : [], ...skipped.length > 0 ? [`skipped: ${skipped.join(", ")}`] : []];
+	return parts.length === 0 ? "All checks passed" : `All checks passed (${parts.join("; ")})`;
+}
+function skippedLine(group) {
+	return `Skipped (${group.source}): ${group.steps.join(", ")}`;
 }
 const ciReporter = {
 	groupStart: (name) => rawLog$2(`::group::${name}`),
@@ -12617,9 +12674,16 @@ const ciReporter = {
 		rawLog$2(`::error::${name} failed`);
 	},
 	undefinedCheck: (name) => rawLog$2(`::error::${name} not defined in package.json`),
+	skipped: (groups) => {
+		for (const group of groups) rawLog$2(skippedLine(group));
+	},
 	skippedNotDefined: (names) => rawLog$2(`Skipped (not defined): ${names.join(", ")}`),
-	allPassed: (warned) => rawLog$2(warned.length === 0 ? "[ok] All checks passed" : `[ok] ${advisorySummary(warned)}`),
-	anyFailed: (names) => rawLog$2(`::error::Failed checks: ${names.join(", ")}`)
+	allPassed: (warned, skipped) => rawLog$2(`[ok] ${passedSummary(warned, skipped)}`),
+	anyFailed: (names, skipped) => {
+		const skippedNames = failedRunSkippedLine(skipped);
+		if (skippedNames !== null) rawLog$2(skippedNames);
+		rawLog$2(`::error::Failed checks: ${names.join(", ")}`);
+	}
 };
 const localReporter = {
 	groupStart: (_name) => {},
@@ -12628,16 +12692,35 @@ const localReporter = {
 	warned: (name, _elapsedS, count) => log$1.warn(`${name}: ${String(count)} advisory finding(s)`),
 	failed: (name) => log$1.error(`${name} failed`),
 	undefinedCheck: (name) => log$1.error(`${name} not defined in package.json`),
+	skipped: (groups) => {
+		for (const group of groups) log$1.info(skippedLine(group));
+	},
 	skippedNotDefined: (names) => log$1.info(`Skipped (not defined): ${names.join(", ")}`),
-	allPassed: (warned) => warned.length === 0 ? log$1.success("All checks passed") : log$1.success(advisorySummary(warned)),
-	anyFailed: (names) => log$1.error(`Failed checks: ${names.join(", ")}`)
+	allPassed: (warned, skipped) => log$1.success(passedSummary(warned, skipped)),
+	anyFailed: (names, skipped) => {
+		const skippedNames = failedRunSkippedLine(skipped);
+		if (skippedNames !== null) log$1.info(skippedNames);
+		log$1.error(`Failed checks: ${names.join(", ")}`);
+	}
 };
+/**
+* Name every skipped step before the first one runs, and return the names for the summary: a
+* step that silently vanishes from the run reads as a bug in the pipeline rather than a skip
+* someone asked for.
+*/
+function reportSkipped(reporter, names, defined, flagSkip, configSkip) {
+	const groups = groupSkippedSteps(names, defined, flagSkip, configSkip);
+	reporter.skipped(groups);
+	return groups.flatMap((group) => group.steps);
+}
 async function runRunChecks(targetDir, options = {}) {
 	const exec = options.execCommand ?? execStep;
 	const getScripts = options.getScripts ?? defaultGetScripts;
 	const toolingConfig = options.toolingConfig ?? loadToolingConfig(targetDir);
 	const configChecks = toolingConfig?.checks;
-	const skip = /* @__PURE__ */ new Set([...options.skip ?? [], ...configChecks?.skip ?? []]);
+	const flagSkip = new Set(options.skip ?? []);
+	const configSkip = new Set(configChecks?.skip ?? []);
+	const skip = /* @__PURE__ */ new Set([...flagSkip, ...configSkip]);
 	const add = [.../* @__PURE__ */ new Set([...options.add ?? [], ...configChecks?.add ?? []])];
 	const isCI = Boolean(process.env["CI"]);
 	const failFast = options.failFast ?? !isCI;
@@ -12656,6 +12739,7 @@ async function runRunChecks(targetDir, options = {}) {
 	if (coverage.enabled && !useCoverageScript && coverage.source === "flag") log$1.warn("--with-coverage requested but test:coverage script is not defined; falling back to test");
 	if (coverage.enabled && !useCoverageScript && coverage.source === "config") log$1.warn("coverage.gateOnPullRequests is set but test:coverage script is not defined; falling back to test");
 	debug(vc, `Coverage: ${options.coverage ?? "auto"} (source: ${coverage.source}) -> ${useCoverageScript ? "test:coverage" : "test"}`);
+	const skippedSteps = reportSkipped(reporter, allChecks.map((check) => check.name), definedScripts, flagSkip, configSkip);
 	for (const check of allChecks) {
 		if (shouldSkip(check.name, skip)) continue;
 		if (!definedScripts.has(check.name)) {
@@ -12694,10 +12778,10 @@ async function runRunChecks(targetDir, options = {}) {
 	}
 	if (notDefined.length > 0) reporter.skippedNotDefined(notDefined);
 	if (failures.length > 0) {
-		reporter.anyFailed(failures);
+		reporter.anyFailed(failures, skippedSteps);
 		return 1;
 	}
-	reporter.allPassed(warnedSteps);
+	reporter.allPassed(warnedSteps, skippedSteps);
 	return 0;
 }
 /**
@@ -13733,9 +13817,8 @@ function childOutput(result) {
 }
 //#endregion
 //#region src/release/publish/version.ts
-const BRANCH = "changeset-release/main";
 const MAIN_REF = "refs/heads/main";
-const BRANCH_REF = `refs/heads/${BRANCH}`;
+const BRANCH_REF = `refs/heads/${VERSION_PR_BRANCH}`;
 /**
 * Read one remote ref's SHA, without mutating the local repository or its remote-tracking refs.
 *
@@ -13788,7 +13871,7 @@ function isSuperseded(executor, config, auth, baseSha) {
 		return false;
 	}
 	if (remoteMain === baseSha) return false;
-	log$1.warn(`Superseded release run: this job versioned ${baseSha}, but main has advanced to ${remoteMain}. A newer run is versioning a superset of these changesets -- skipping to avoid overwriting its version commit on ${BRANCH}.`);
+	log$1.warn(`Superseded release run: this job versioned ${baseSha}, but main has advanced to ${remoteMain}. A newer run is versioning a superset of these changesets -- skipping to avoid overwriting its version commit on ${VERSION_PR_BRANCH}.`);
 	return true;
 }
 /** Pattern matching a dateless version heading like `## 1.2.3` or `## 1.2.3-beta.0`. */
@@ -13895,9 +13978,9 @@ async function runVersionMode(executor, config) {
 	const baseShaResult = executor.exec("git", ["rev-parse", "HEAD"], { cwd: config.cwd });
 	const baseSha = baseShaResult.exitCode === 0 ? baseShaResult.stdout.trim() : "";
 	const leaseTip = config.dryRun ? null : readRemoteRef(executor, config, auth, BRANCH_REF);
-	if (leaseTip === null && !config.dryRun) throw new FatalError(`Could not read the current tip of ${BRANCH} from the remote, so this run cannot take a push lease. Refusing to force-push without one -- an unleased push is what allows a concurrent run's version commit to be silently discarded.`);
+	if (leaseTip === null && !config.dryRun) throw new FatalError(`Could not read the current tip of ${VERSION_PR_BRANCH} from the remote, so this run cannot take a push lease. Refusing to force-push without one -- an unleased push is what allows a concurrent run's version commit to be silently discarded.`);
 	debug(config, `Base commit: ${baseSha || "(unknown)"}`);
-	debug(config, `Lease tip for ${BRANCH}: ${leaseTip === null ? "(dry-run)" : leaseTip || "(absent)"}`);
+	debug(config, `Lease tip for ${VERSION_PR_BRANCH}: ${leaseTip === null ? "(dry-run)" : leaseTip || "(absent)"}`);
 	const packagesBefore = executor.listWorkspacePackages(config.cwd);
 	debug(config, `Packages before versioning: ${packagesBefore.map((pkg) => `${pkg.name}@${pkg.version}`).join(", ") || "(none)"}`);
 	const changesetConfigPath = path.join(config.cwd, ".changeset", "config.json");
@@ -13959,7 +14042,7 @@ async function runVersionMode(executor, config) {
 		pr: "none"
 	};
 	if (leaseTip === null) throw new UnexpectedError("Push lease was never observed on a non-dry-run release");
-	debug(config, `Force-pushing version commit to ${BRANCH} (lease: ${leaseTip || "(absent)"})`);
+	debug(config, `Force-pushing version commit to ${VERSION_PR_BRANCH} (lease: ${leaseTip || "(absent)"})`);
 	const pushResult = executor.exec("git", [
 		...auth.args,
 		"push",
@@ -13968,18 +14051,18 @@ async function runVersionMode(executor, config) {
 		`--force-with-lease=${BRANCH_REF}:${leaseTip}`
 	], { cwd: config.cwd });
 	debugExec(config, "git push", pushResult);
-	if (pushResult.exitCode !== 0) throw new FatalError(`git push to ${BRANCH} failed (exit code ${String(pushResult.exitCode)}). If the lease was rejected, the branch moved after this run started (expected ${leaseTip || "the branch to be absent"}) -- another run pushed a version commit, and overwriting it would discard that release. This job fails rather than clobber it.\n${pushResult.stderr || pushResult.stdout}`);
+	if (pushResult.exitCode !== 0) throw new FatalError(`git push to ${VERSION_PR_BRANCH} failed (exit code ${String(pushResult.exitCode)}). If the lease was rejected, the branch moved after this run started (expected ${leaseTip || "the branch to be absent"}) -- another run pushed a version commit, and overwriting it would discard that release. This job fails rather than clobber it.\n${pushResult.stderr || pushResult.stdout}`);
 	const conn = {
 		serverUrl: config.serverUrl,
 		repository: config.repository,
 		token: config.token
 	};
-	const existingPr = await findOpenPr(executor, conn, BRANCH);
-	debug(config, `Existing open PR for ${BRANCH}: ${existingPr === null ? "(none)" : `#${String(existingPr)}`}`);
+	const existingPr = await findOpenPr(executor, conn, VERSION_PR_BRANCH);
+	debug(config, `Existing open PR for ${VERSION_PR_BRANCH}: ${existingPr === null ? "(none)" : `#${String(existingPr)}`}`);
 	if (existingPr === null) try {
 		await createPr(executor, conn, {
 			title,
-			head: BRANCH,
+			head: VERSION_PR_BRANCH,
 			base: "main",
 			body
 		});
@@ -13990,7 +14073,7 @@ async function runVersionMode(executor, config) {
 		};
 	} catch (error) {
 		debug(config, `createPr failed, retrying as update: ${describeError(error)}`);
-		const racePr = await findOpenPr(executor, conn, BRANCH);
+		const racePr = await findOpenPr(executor, conn, VERSION_PR_BRANCH);
 		if (racePr === null) throw error;
 		await updatePr(executor, conn, racePr, {
 			title,
@@ -14667,8 +14750,6 @@ z.object({
 });
 //#endregion
 //#region src/release/publish/version-merge.ts
-/** The changesets version-PR branch this command merges. Not configurable. */
-const HEAD_BRANCH = "changeset-release/main";
 /**
 * Emptiness outranks mergeability: an empty version PR must be reported as content-free, not as a
 * blocked merge -- that is the clobbered state this gate exists to catch. `unconfirmed` exists
@@ -14786,8 +14867,8 @@ function evaluateConfirmingRead(second, first, delayMs) {
 	};
 }
 async function mergeVersionPrForgejo(executor, conn, options) {
-	const prNumber = await findOpenPr(executor, conn, HEAD_BRANCH);
-	if (prNumber === null) throw new FatalError(`No open PR found for branch ${HEAD_BRANCH}`);
+	const prNumber = await findOpenPr(executor, conn, VERSION_PR_BRANCH);
+	if (prNumber === null) throw new FatalError(`No open PR found for branch ${VERSION_PR_BRANCH}`);
 	const sleep$1 = options.sleep ?? sleep;
 	const recheckDelayMs = envMsOverride(process.env["BST_TEST_VERSION_MERGE_RECHECK_MS"], RECHECK_DELAY_MS);
 	const firstGate = await readMergeGate(executor, conn, prNumber);
@@ -14803,7 +14884,7 @@ async function mergeVersionPrForgejo(executor, conn, options) {
 	}
 	const headSha = headShaOrThrow(verdict);
 	if (options.dryRun) {
-		log$1.info(`[dry-run] Would merge PR #${String(prNumber)} at ${headSha} and delete branch ${HEAD_BRANCH}`);
+		log$1.info(`[dry-run] Would merge PR #${String(prNumber)} at ${headSha} and delete branch ${VERSION_PR_BRANCH}`);
 		return;
 	}
 	await mergePr(executor, conn, prNumber, {
@@ -14811,7 +14892,7 @@ async function mergeVersionPrForgejo(executor, conn, options) {
 		deleteBranch: true,
 		expectedHeadSha: headSha
 	});
-	log$1.info(`Merged PR #${String(prNumber)} and deleted branch ${HEAD_BRANCH}`);
+	log$1.info(`Merged PR #${String(prNumber)} and deleted branch ${VERSION_PR_BRANCH}`);
 }
 const GitHubVersionPrSchema = z.object({
 	number: z.number(),
@@ -14825,13 +14906,13 @@ function mergeVersionPrGitHub(executor, options) {
 	const view = executor.exec("gh", [
 		"pr",
 		"view",
-		HEAD_BRANCH,
+		VERSION_PR_BRANCH,
 		"--json",
 		"number,state,isDraft,mergeable,headRefOid,changedFiles"
 	], { cwd: process.cwd() });
-	if (view.exitCode !== 0) throw new FatalError(`Failed to read PR for branch ${HEAD_BRANCH}: ${view.stderr || view.stdout || "unknown error"}`);
+	if (view.exitCode !== 0) throw new FatalError(`Failed to read PR for branch ${VERSION_PR_BRANCH}: ${view.stderr || view.stdout || "unknown error"}`);
 	const parsed = GitHubVersionPrSchema.safeParse(JSON.parse(view.stdout));
-	if (!parsed.success) throw new FatalError(`Unexpected 'gh pr view' response for branch ${HEAD_BRANCH}: ${parsed.error.message}`);
+	if (!parsed.success) throw new FatalError(`Unexpected 'gh pr view' response for branch ${VERSION_PR_BRANCH}: ${parsed.error.message}`);
 	const data = parsed.data;
 	const emptiness = data.changedFiles === 0 ? "empty" : "non-empty";
 	const mergeable = data.mergeable === "CONFLICTING" ? "conflicted" : "mergeable";
@@ -14845,20 +14926,20 @@ function mergeVersionPrGitHub(executor, options) {
 		emptiness
 	}));
 	if (options.dryRun) {
-		log$1.info(`[dry-run] Would merge PR #${String(data.number)} at ${headSha} and delete branch ${HEAD_BRANCH}`);
+		log$1.info(`[dry-run] Would merge PR #${String(data.number)} at ${headSha} and delete branch ${VERSION_PR_BRANCH}`);
 		return;
 	}
 	const result = executor.exec("gh", [
 		"pr",
 		"merge",
-		HEAD_BRANCH,
+		VERSION_PR_BRANCH,
 		"--merge",
 		"--delete-branch",
 		"--match-head-commit",
 		headSha
 	], { cwd: process.cwd() });
 	if (result.exitCode !== 0) throw new FatalError(`Failed to merge PR: ${result.stderr || result.stdout || "unknown error"}`);
-	log$1.info(`Merged changesets PR and deleted branch ${HEAD_BRANCH}`);
+	log$1.info(`Merged changesets PR and deleted branch ${VERSION_PR_BRANCH}`);
 }
 //#endregion
 //#region src/commands/changesets-merge.ts
@@ -30445,7 +30526,7 @@ setForgejoLogger(log$1);
 * `local <sha>[-dirty]` otherwise -- so an artifact built from the working tree
 * can't pass itself off as the published release whose version it carries.
 */
-const displayVersion = "0.79.0";
+const displayVersion = "0.80.0";
 /**
 * Wait until a stream's internally-buffered data has been flushed to the OS.
 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "license": "MIT",
   "repository": {

package/tooling.schema.json

@@ -577,6 +577,10 @@
           "items": {
             "type": "string"
           }
+        },
+        "runOnVersionPr": {
+          "description": "Run the CI check job on the changesets version PR (changeset-release/main). Default false: the generated check job is skipped there, because that branch is regenerated on every push to main and main's own run gates the release. Has no effect unless releaseStrategy is changesets.",
+          "type": "boolean"
         }
       },
       "additionalProperties": false