@bensandee/tooling 0.8.0 → 0.9.0

package/dist/bin.mjs

@@ -8,7 +8,6 @@ import JSON5 from "json5";
 import { parse } from "jsonc-parser";
 import { z } from "zod";
 import { FatalError, TransientError, UnexpectedError } from "@bensandee/common";
-
 //#region src/types.ts
 /** Default CI platform when not explicitly chosen. */
 const DEFAULT_CI = "forgejo";
@@ -19,7 +18,6 @@ const LEGACY_TOOLS = [
 	"webpack",
 	"rollup"
 ];
-
 //#endregion
 //#region src/utils/json.ts
 const StringRecord = z.record(z.string(), z.string());
@@ -83,7 +81,6 @@ function parsePackageJson(raw) {
 		return;
 	}
 }
-
 //#endregion
 //#region src/utils/detect.ts
 const LEGACY_PATTERNS = {
@@ -205,7 +202,6 @@ function getMonorepoPackages(targetDir) {
 	} catch (_error) {}
 	return results;
 }
-
 //#endregion
 //#region src/prompts/init-prompts.ts
 function isCancelled(value) {
@@ -416,7 +412,6 @@ function buildDefaultConfig(targetDir, flags) {
 		targetDir
 	};
 }
-
 //#endregion
 //#region src/utils/fs.ts
 /** Check whether a file exists at the given path. */
@@ -442,29 +437,31 @@ function writeFile(targetDir, relativePath, content) {
 function createContext(config, confirmOverwrite) {
 	const archivedFiles = [];
 	const pkgRaw = readFile(config.targetDir, "package.json");
-	return {
-		ctx: {
-			config,
-			targetDir: config.targetDir,
-			packageJson: pkgRaw ? parsePackageJson(pkgRaw) : void 0,
-			exists: (rel) => fileExists(config.targetDir, rel),
-			read: (rel) => readFile(config.targetDir, rel),
-			write: (rel, content) => {
-				if (!rel.startsWith(".tooling-archived/")) {
-					const existing = readFile(config.targetDir, rel);
-					if (existing !== void 0 && existing !== content) {
-						writeFile(config.targetDir, `.tooling-archived/${rel}`, existing);
-						archivedFiles.push(rel);
-					}
+	const ctx = {
+		config,
+		targetDir: config.targetDir,
+		packageJson: pkgRaw ? parsePackageJson(pkgRaw) : void 0,
+		exists: (rel) => fileExists(config.targetDir, rel),
+		read: (rel) => readFile(config.targetDir, rel),
+		write: (rel, content) => {
+			if (!rel.startsWith(".tooling-archived/")) {
+				const existing = readFile(config.targetDir, rel);
+				if (existing !== void 0 && existing !== content) {
+					writeFile(config.targetDir, `.tooling-archived/${rel}`, existing);
+					archivedFiles.push(rel);
 				}
-				writeFile(config.targetDir, rel, content);
-			},
-			remove: (rel) => {
-				const fullPath = path.join(config.targetDir, rel);
-				if (existsSync(fullPath)) rmSync(fullPath);
-			},
-			confirmOverwrite
+			}
+			writeFile(config.targetDir, rel, content);
+			if (rel === "package.json") ctx.packageJson = parsePackageJson(content);
 		},
+		remove: (rel) => {
+			const fullPath = path.join(config.targetDir, rel);
+			if (existsSync(fullPath)) rmSync(fullPath);
+		},
+		confirmOverwrite
+	};
+	return {
+		ctx,
 		archivedFiles
 	};
 }
@@ -477,24 +474,25 @@ function createDryRunContext(config) {
 	const pkgRaw = readFile(config.targetDir, "package.json");
 	const pendingWrites = /* @__PURE__ */ new Map();
 	const shadow = /* @__PURE__ */ new Map();
-	return {
-		ctx: {
-			config,
-			targetDir: config.targetDir,
-			packageJson: pkgRaw ? parsePackageJson(pkgRaw) : void 0,
-			exists: (rel) => shadow.has(rel) || fileExists(config.targetDir, rel),
-			read: (rel) => shadow.get(rel) ?? readFile(config.targetDir, rel),
-			write: (rel, content) => {
-				pendingWrites.set(rel, content);
-				shadow.set(rel, content);
-			},
-			remove: () => {},
-			confirmOverwrite: async () => "overwrite"
+	const ctx = {
+		config,
+		targetDir: config.targetDir,
+		packageJson: pkgRaw ? parsePackageJson(pkgRaw) : void 0,
+		exists: (rel) => shadow.has(rel) || fileExists(config.targetDir, rel),
+		read: (rel) => shadow.get(rel) ?? readFile(config.targetDir, rel),
+		write: (rel, content) => {
+			pendingWrites.set(rel, content);
+			shadow.set(rel, content);
+			if (rel === "package.json") ctx.packageJson = parsePackageJson(content);
 		},
+		remove: () => {},
+		confirmOverwrite: async () => "overwrite"
+	};
+	return {
+		ctx,
 		pendingWrites
 	};
 }
-
 //#endregion
 //#region src/generators/package-json.ts
 const STANDARD_SCRIPTS_SINGLE = {
@@ -568,8 +566,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"] = "latest";
-	deps["@bensandee/tooling"] = "latest";
+	deps["@bensandee/config"] = "0.7.1";
+	deps["@bensandee/tooling"] = "0.9.0";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -589,9 +587,9 @@ async function generatePackageJson(ctx) {
 	if (ctx.config.releaseStrategy !== "none") 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:*" : "latest";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "latest";
-	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "latest";
+	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.7.1";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.9.0";
+	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.0";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = "0.35.0";
 	if (ctx.config.formatter === "prettier") devDeps["prettier"] = "3.8.1";
 	addReleaseDeps(devDeps, ctx.config);
@@ -617,9 +615,9 @@ async function generatePackageJson(ctx) {
 		for (const [key, value] of Object.entries(devDeps)) if (!(key in existingDevDeps)) {
 			existingDevDeps[key] = value;
 			changes.push(`added devDependency: ${key}`);
-		} else if (key.startsWith("@bensandee/") && value === "latest" && existingDevDeps[key] !== "latest" && existingDevDeps[key] !== "workspace:*") {
-			existingDevDeps[key] = "latest";
-			changes.push(`updated devDependency: ${key} to latest`);
+		} else if (key.startsWith("@bensandee/") && existingDevDeps[key] !== value && existingDevDeps[key] !== "workspace:*") {
+			existingDevDeps[key] = value;
+			changes.push(`updated devDependency: ${key} to ${value}`);
 		}
 		pkg.devDependencies = existingDevDeps;
 		if (!pkg["engines"]) {
@@ -655,7 +653,6 @@ async function generatePackageJson(ctx) {
 		description: "Generated package.json"
 	};
 }
-
 //#endregion
 //#region src/generators/migrate-prompt.ts
 /**
@@ -825,7 +822,6 @@ function generateMigratePrompt(results, config, detected) {
 	sections.push("");
 	return sections.join("\n");
 }
-
 //#endregion
 //#region src/generators/tsconfig.ts
 async function generateTsconfig(ctx) {
@@ -993,7 +989,6 @@ function generateMonorepoPackageTsconfigs(ctx) {
 	}
 	return results;
 }
-
 //#endregion
 //#region src/generators/vitest.ts
 const VITEST_CONFIG = `import { defineConfig } from "vitest/config";
@@ -1062,7 +1057,6 @@ async function generateVitest(ctx) {
 	}
 	return results;
 }
-
 //#endregion
 //#region src/generators/oxlint.ts
 const CONFIG_WITH_LINT_RULES = `import recommended from "@bensandee/config/oxlint/recommended";
@@ -1102,7 +1096,6 @@ async function generateOxlint(ctx) {
 		description: "Generated oxlint.config.ts"
 	};
 }
-
 //#endregion
 //#region src/generators/formatter.ts
 const OXFMT_CONFIG = `{}\n`;
@@ -1146,7 +1139,6 @@ async function generatePrettier(ctx) {
 		description: "Generated .prettierrc"
 	};
 }
-
 //#endregion
 //#region src/generators/tsdown.ts
 const TSDOWN_CONFIG = `import { defineConfig } from "tsdown";
@@ -1182,7 +1174,6 @@ async function generateTsdown(ctx) {
 		description: "Generated tsdown.config.ts"
 	};
 }
-
 //#endregion
 //#region src/generators/gitignore.ts
 /** Entries that every project should have — repo:check flags these as missing. */
@@ -1236,7 +1227,6 @@ async function generateGitignore(ctx) {
 		description: "Generated .gitignore"
 	};
 }
-
 //#endregion
 //#region src/generators/ci.ts
 function hasEnginesNode$1(ctx) {
@@ -1244,9 +1234,9 @@ function hasEnginesNode$1(ctx) {
 	if (!raw) return false;
 	return typeof parsePackageJson(raw)?.engines?.["node"] === "string";
 }
-function ciWorkflow(isMonorepo, nodeVersionYaml) {
+function ciWorkflow(isMonorepo, nodeVersionYaml, isForgejo) {
 	return `name: CI
-on:
+${isForgejo ? "\nenable-email-notifications: true\n" : ""}on:
   push:
     branches: [main]
   pull_request:
@@ -1300,7 +1290,7 @@ async function generateCi(ctx) {
 	const isGitHub = ctx.config.ci === "github";
 	const nodeVersionYaml = hasEnginesNode$1(ctx) ? "node-version-file: package.json" : "node-version: \"24\"";
 	const filePath = isGitHub ? ".github/workflows/check.yml" : ".forgejo/workflows/check.yml";
-	const content = ciWorkflow(isMonorepo, nodeVersionYaml);
+	const content = ciWorkflow(isMonorepo, nodeVersionYaml, !isGitHub);
 	if (ctx.exists(filePath)) {
 		const existing = ctx.read(filePath);
 		if (existing && !existing.includes("repo:check")) {
@@ -1327,7 +1317,6 @@ async function generateCi(ctx) {
 		description: `Generated ${isGitHub ? "GitHub" : "Forgejo"} Actions CI workflow`
 	};
 }
-
 //#endregion
 //#region src/generators/knip.ts
 const KNIP_CONFIG_SINGLE = `import type { KnipConfig } from "knip";
@@ -1380,7 +1369,6 @@ async function generateKnip(ctx) {
 		description: "Generated knip.config.ts for dead code analysis"
 	};
 }
-
 //#endregion
 //#region src/generators/renovate.ts
 const SHARED_PRESET = "local>bensandee/tooling";
@@ -1447,7 +1435,6 @@ async function generateRenovate(ctx) {
 		description: "Generated renovate.json extending shared config"
 	};
 }
-
 //#endregion
 //#region src/generators/pnpm-workspace.ts
 const WORKSPACE_YAML = `packages:
@@ -1472,7 +1459,6 @@ async function generatePnpmWorkspace(ctx) {
 		description: "Generated pnpm-workspace.yaml"
 	};
 }
-
 //#endregion
 //#region src/generators/claude-settings.ts
 const ClaudeSettingsSchema = z.object({
@@ -1557,12 +1543,8 @@ function buildSettings(ctx) {
 	if (ctx.config.structure === "monorepo") allow.push(`Bash(${pm} --filter *)`, `Bash(${pm} -r *)`);
 	const enabledPlugins = { "code-simplifier@claude-plugins-official": true };
 	const extraKnownMarketplaces = {};
-	if (ctx.config.structure === "monorepo" ? getMonorepoPackages(ctx.targetDir).some((p) => hasWebUIDeps(p.dir)) : ctx.packageJson ? packageHasWebUIDeps(ctx.packageJson) : false) {
-		enabledPlugins["example-skills@anthropic-agent-skills"] = true;
-		extraKnownMarketplaces["anthropic-agent-skills"] = { source: {
-			source: "github",
-			repo: "anthropics/skills"
-		} };
+	if (ctx.config.structure !== "monorepo") {
+		if (ctx.packageJson ? packageHasWebUIDeps(ctx.packageJson) : false) enabledPlugins["frontend-design@claude-plugins-official"] = true;
 	}
 	return {
 		permissions: {
@@ -1626,17 +1608,15 @@ function buildSettings(ctx) {
 	};
 }
 /** Remove enabledPlugins/extraKnownMarketplaces when empty to keep the file clean. */
-function serializeSettings(settings) {
+function serializeSettings$1(settings) {
 	const { enabledPlugins, extraKnownMarketplaces, ...rest } = settings;
 	const out = { ...rest };
 	if (Object.keys(enabledPlugins).length > 0) out["enabledPlugins"] = enabledPlugins;
 	if (Object.keys(extraKnownMarketplaces).length > 0) out["extraKnownMarketplaces"] = extraKnownMarketplaces;
 	return JSON.stringify(out, null, 2) + "\n";
 }
-async function generateClaudeSettings(ctx) {
-	const filePath = ".claude/settings.json";
+function writeOrMergeSettings(ctx, filePath, generated) {
 	const existing = ctx.read(filePath);
-	const generated = buildSettings(ctx);
 	if (existing) {
 		const parsed = parseClaudeSettings(existing);
 		if (!parsed) return {
@@ -1660,21 +1640,39 @@ async function generateClaudeSettings(ctx) {
 		parsed.instructions = [...parsed.instructions, ...missingInstructions];
 		for (const [key, value] of missingPlugins) parsed.enabledPlugins[key] = value;
 		for (const [key, value] of missingMarketplaces) parsed.extraKnownMarketplaces[key] = value;
-		ctx.write(filePath, serializeSettings(parsed));
+		ctx.write(filePath, serializeSettings$1(parsed));
 		return {
 			filePath,
 			action: "updated",
 			description: `Added ${String(added)} rules/instructions`
 		};
 	}
-	ctx.write(filePath, serializeSettings(generated));
+	ctx.write(filePath, serializeSettings$1(generated));
 	return {
 		filePath,
 		action: "created",
-		description: "Generated .claude/settings.json with safe operation permissions"
+		description: `Generated ${filePath}`
 	};
 }
-
+async function generateClaudeSettings(ctx) {
+	const results = [];
+	results.push(writeOrMergeSettings(ctx, ".claude/settings.json", buildSettings(ctx)));
+	if (ctx.config.structure === "monorepo") for (const pkg of getMonorepoPackages(ctx.targetDir)) {
+		if (!hasWebUIDeps(pkg.dir)) continue;
+		const pkgRelDir = path.relative(ctx.targetDir, pkg.dir);
+		const pkgSettingsPath = path.join(pkgRelDir, ".claude/settings.json");
+		results.push(writeOrMergeSettings(ctx, pkgSettingsPath, {
+			permissions: {
+				allow: [],
+				deny: []
+			},
+			instructions: [],
+			enabledPlugins: { "frontend-design@claude-plugins-official": true },
+			extraKnownMarketplaces: {}
+		}));
+	}
+	return results;
+}
 //#endregion
 //#region src/generators/release-it.ts
 function buildConfig$2(ci, isMonorepo) {
@@ -1726,7 +1724,6 @@ async function generateReleaseIt(ctx) {
 		description: "Generated .release-it.json"
 	};
 }
-
 //#endregion
 //#region src/generators/changesets.ts
 function buildConfig$1() {
@@ -1763,7 +1760,6 @@ async function generateChangesets(ctx) {
 		description: "Generated .changeset/config.json"
 	};
 }
-
 //#endregion
 //#region src/generators/release-ci.ts
 function hasEnginesNode(ctx) {
@@ -1933,7 +1929,6 @@ async function generateReleaseCi(ctx) {
 		description: `Generated ${isGitHub ? "GitHub" : "Forgejo"} Actions release workflow`
 	};
 }
-
 //#endregion
 //#region src/generators/lefthook.ts
 function buildConfig(formatter) {
@@ -2062,7 +2057,149 @@ async function generateLefthook(ctx) {
 	});
 	return results;
 }
-
+//#endregion
+//#region src/generators/vscode-settings.ts
+const SCHEMA_NPM_PATH = "@bensandee/config/schemas/forgejo-workflow.schema.json";
+const SCHEMA_LOCAL_PATH = ".vscode/forgejo-workflow.schema.json";
+const SETTINGS_PATH = ".vscode/settings.json";
+const SCHEMA_GLOB = ".forgejo/workflows/*.yml";
+const VscodeSettingsSchema = z.object({ "yaml.schemas": z.record(z.string(), z.unknown()).default({}) }).passthrough();
+const FullWorkspaceFileSchema = z.object({ settings: z.record(z.string(), z.unknown()).default({}) }).passthrough();
+function readSchemaFromNodeModules(targetDir) {
+	const candidate = path.join(targetDir, "node_modules", SCHEMA_NPM_PATH);
+	if (!existsSync(candidate)) return void 0;
+	return readFileSync(candidate, "utf-8");
+}
+/** Find a *.code-workspace file in the target directory. */
+function findWorkspaceFile(targetDir) {
+	try {
+		return readdirSync(targetDir).find((e) => e.endsWith(".code-workspace"));
+	} catch {
+		return;
+	}
+}
+function serializeSettings(settings) {
+	return JSON.stringify(settings, null, 2) + "\n";
+}
+const YamlSchemasSchema = z.record(z.string(), z.unknown());
+/** Merge yaml.schemas into a settings object. Returns the result and whether anything changed. */
+function mergeYamlSchemas(settings) {
+	const parsed = YamlSchemasSchema.safeParse(settings["yaml.schemas"]);
+	const yamlSchemas = parsed.success ? { ...parsed.data } : {};
+	if (SCHEMA_LOCAL_PATH in yamlSchemas) return {
+		merged: settings,
+		changed: false
+	};
+	yamlSchemas[SCHEMA_LOCAL_PATH] = SCHEMA_GLOB;
+	return {
+		merged: {
+			...settings,
+			"yaml.schemas": yamlSchemas
+		},
+		changed: true
+	};
+}
+function writeSchemaToWorkspaceFile(ctx, wsFileName) {
+	const raw = ctx.read(wsFileName);
+	if (!raw) return {
+		filePath: wsFileName,
+		action: "skipped",
+		description: "Could not read workspace file"
+	};
+	const fullParsed = FullWorkspaceFileSchema.safeParse(parse(raw));
+	if (!fullParsed.success) return {
+		filePath: wsFileName,
+		action: "skipped",
+		description: "Could not parse workspace file"
+	};
+	const { merged, changed } = mergeYamlSchemas(fullParsed.data.settings);
+	if (!changed) return {
+		filePath: wsFileName,
+		action: "skipped",
+		description: "Already has Forgejo schema mapping"
+	};
+	const updated = {
+		...fullParsed.data,
+		settings: merged
+	};
+	ctx.write(wsFileName, JSON.stringify(updated, null, 2) + "\n");
+	return {
+		filePath: wsFileName,
+		action: "updated",
+		description: "Added Forgejo workflow schema mapping to workspace settings"
+	};
+}
+function writeSchemaToSettings(ctx) {
+	if (ctx.exists(SETTINGS_PATH)) {
+		const raw = ctx.read(SETTINGS_PATH);
+		if (!raw) return {
+			filePath: SETTINGS_PATH,
+			action: "skipped",
+			description: "Could not read existing settings"
+		};
+		const parsed = VscodeSettingsSchema.safeParse(parse(raw));
+		if (!parsed.success) return {
+			filePath: SETTINGS_PATH,
+			action: "skipped",
+			description: "Could not parse existing settings"
+		};
+		const { merged, changed } = mergeYamlSchemas(parsed.data);
+		if (!changed) return {
+			filePath: SETTINGS_PATH,
+			action: "skipped",
+			description: "Already has Forgejo schema mapping"
+		};
+		ctx.write(SETTINGS_PATH, serializeSettings(merged));
+		return {
+			filePath: SETTINGS_PATH,
+			action: "updated",
+			description: "Added Forgejo workflow schema mapping"
+		};
+	}
+	ctx.write(SETTINGS_PATH, serializeSettings({ "yaml.schemas": { [SCHEMA_LOCAL_PATH]: SCHEMA_GLOB } }));
+	return {
+		filePath: SETTINGS_PATH,
+		action: "created",
+		description: "Generated .vscode/settings.json with Forgejo workflow schema"
+	};
+}
+async function generateVscodeSettings(ctx) {
+	const results = [];
+	if (ctx.config.ci !== "forgejo") {
+		results.push({
+			filePath: SETTINGS_PATH,
+			action: "skipped",
+			description: "Not a Forgejo project"
+		});
+		return results;
+	}
+	const schemaContent = readSchemaFromNodeModules(ctx.targetDir);
+	if (!schemaContent) {
+		results.push({
+			filePath: SCHEMA_LOCAL_PATH,
+			action: "skipped",
+			description: "Could not find @bensandee/config schema in node_modules"
+		});
+		return results;
+	}
+	const existingSchema = ctx.read(SCHEMA_LOCAL_PATH);
+	if (existingSchema === schemaContent) results.push({
+		filePath: SCHEMA_LOCAL_PATH,
+		action: "skipped",
+		description: "Schema already up to date"
+	});
+	else {
+		ctx.write(SCHEMA_LOCAL_PATH, schemaContent);
+		results.push({
+			filePath: SCHEMA_LOCAL_PATH,
+			action: existingSchema ? "updated" : "created",
+			description: "Copied Forgejo workflow schema from @bensandee/config"
+		});
+	}
+	const wsFile = findWorkspaceFile(ctx.targetDir);
+	results.push(wsFile ? writeSchemaToWorkspaceFile(ctx, wsFile) : writeSchemaToSettings(ctx));
+	return results;
+}
 //#endregion
 //#region src/generators/pipeline.ts
 /** Run all generators sequentially and return their results. */
@@ -2079,14 +2216,14 @@ async function runGenerators(ctx) {
 	results.push(await generateKnip(ctx));
 	results.push(await generateRenovate(ctx));
 	results.push(await generateCi(ctx));
-	results.push(await generateClaudeSettings(ctx));
+	results.push(...await generateClaudeSettings(ctx));
 	results.push(await generateReleaseIt(ctx));
 	results.push(await generateChangesets(ctx));
 	results.push(await generateReleaseCi(ctx));
 	results.push(...await generateVitest(ctx));
+	results.push(...await generateVscodeSettings(ctx));
 	return results;
 }
-
 //#endregion
 //#region src/utils/tooling-config.ts
 const CONFIG_FILE = ".tooling.json";
@@ -2141,11 +2278,16 @@ function saveToolingConfig(ctx, config) {
 		detectPackageTypes: config.detectPackageTypes
 	};
 	const content = JSON.stringify(saved, null, 2) + "\n";
-	const existed = ctx.exists(CONFIG_FILE);
+	const existing = ctx.exists(CONFIG_FILE) ? ctx.read(CONFIG_FILE) : void 0;
+	if (existing === content) return {
+		filePath: CONFIG_FILE,
+		action: "skipped",
+		description: "Already up to date"
+	};
 	ctx.write(CONFIG_FILE, content);
 	return {
 		filePath: CONFIG_FILE,
-		action: existed ? "updated" : "created",
+		action: existing ? "updated" : "created",
 		description: "Saved tooling configuration"
 	};
 }
@@ -2166,7 +2308,6 @@ function mergeWithSavedConfig(detected, saved) {
 		detectPackageTypes: saved.detectPackageTypes ?? detected.detectPackageTypes
 	};
 }
-
 //#endregion
 //#region src/commands/repo-init.ts
 const initCommand = defineCommand({
@@ -2238,6 +2379,14 @@ async function runInit(config, options = {}) {
 		action: "archived",
 		description: `Original saved to .tooling-archived/${rel}`
 	});
+	const created = results.filter((r) => r.action === "created");
+	const updated = results.filter((r) => r.action === "updated");
+	const skipped = results.filter((r) => r.action === "skipped");
+	const archived = results.filter((r) => r.action === "archived");
+	if (!(created.length > 0 || updated.length > 0 || archived.length > 0) && options.noPrompt) {
+		s.stop("Repository is up to date.");
+		return results;
+	}
 	s.stop("Done!");
 	if (results.some((r) => r.action === "archived" && r.filePath.startsWith(".husky/"))) try {
 		execSync("git config --unset core.hooksPath", {
@@ -2245,10 +2394,6 @@ async function runInit(config, options = {}) {
 			stdio: "ignore"
 		});
 	} catch (_error) {}
-	const created = results.filter((r) => r.action === "created");
-	const updated = results.filter((r) => r.action === "updated");
-	const skipped = results.filter((r) => r.action === "skipped");
-	const archived = results.filter((r) => r.action === "archived");
 	const summaryLines = [];
 	if (created.length > 0) summaryLines.push(`Created: ${created.map((r) => r.filePath).join(", ")}`);
 	if (updated.length > 0) summaryLines.push(`Updated: ${updated.map((r) => r.filePath).join(", ")}`);
@@ -2260,7 +2405,7 @@ async function runInit(config, options = {}) {
 		const promptPath = ".tooling-migrate.md";
 		ctx.write(promptPath, prompt);
 		p.log.info(`Migration prompt written to ${promptPath}`);
-		p.log.info("Paste its contents into Claude Code to finish the migration.");
+		p.log.info("In Claude Code, run: \"Execute the steps in .tooling-migrate.md\"");
 	}
 	const bensandeeDeps = getAddedDevDepNames(config).filter((name) => name.startsWith("@bensandee/"));
 	const hasLockfile = ctx.exists("pnpm-lock.yaml");
@@ -2281,11 +2426,10 @@ async function runInit(config, options = {}) {
 		"2. Run: pnpm typecheck",
 		"3. Run: pnpm build",
 		"4. Run: pnpm test",
-		...options.noPrompt ? [] : ["5. Paste .tooling-migrate.md into Claude Code for cleanup"]
+		...options.noPrompt ? [] : ["5. In Claude Code, run: \"Execute the steps in .tooling-migrate.md\""]
 	].join("\n"), "Next steps");
 	return results;
 }
-
 //#endregion
 //#region src/commands/repo-update.ts
 const updateCommand = defineCommand({
@@ -2304,14 +2448,16 @@ const updateCommand = defineCommand({
 });
 async function runUpdate(targetDir) {
 	const saved = loadToolingConfig(targetDir);
-	const detected = buildDefaultConfig(targetDir, {});
-	if (!saved) p.log.warn("No .tooling.json found — using detected defaults. Run `tooling repo:init` to save your preferences.");
-	return runInit(saved ? mergeWithSavedConfig(detected, saved) : detected, {
+	if (!saved) {
+		p.log.error("No .tooling.json found. Run `tooling repo:init` first to initialize the project.");
+		process.exitCode = 1;
+		return [];
+	}
+	return runInit(mergeWithSavedConfig(buildDefaultConfig(targetDir, {}), saved), {
 		noPrompt: true,
 		confirmOverwrite: async () => "overwrite"
 	});
 }
-
 //#endregion
 //#region src/commands/repo-check.ts
 const checkCommand = defineCommand({
@@ -2331,9 +2477,11 @@ const checkCommand = defineCommand({
 });
 async function runCheck(targetDir) {
 	const saved = loadToolingConfig(targetDir);
-	const detected = buildDefaultConfig(targetDir, {});
-	if (!saved) p.log.warn("No .tooling.json found — using detected defaults. Run `tooling repo:init` to save your preferences.");
-	const { ctx, pendingWrites } = createDryRunContext(saved ? mergeWithSavedConfig(detected, saved) : detected);
+	if (!saved) {
+		p.log.error("No .tooling.json found. Run `tooling repo:init` first to initialize the project.");
+		return 1;
+	}
+	const { ctx, pendingWrites } = createDryRunContext(mergeWithSavedConfig(buildDefaultConfig(targetDir, {}), saved));
 	const actionable = (await runGenerators(ctx)).filter((r) => r.action === "created" || r.action === "updated");
 	if (actionable.length === 0) {
 		p.log.success("Repository is up to date.");
@@ -2370,14 +2518,12 @@ function lineDiff(oldText, newText) {
 	for (const l of added) lines.push(`+ ${l.trim()}`);
 	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. */
@@ -2488,18 +2634,25 @@ function reconcileTags(expectedTags, remoteTags, stdoutTags) {
 	for (const tag of stdoutTags) result.add(tag);
 	return [...result];
 }
-
 //#endregion
 //#region src/release/forgejo.ts
-const PullRequestSchema = z.array(z.object({ number: z.number() }));
-/** Find an open PR with the given head branch. Returns the PR number or null. */
+const PullRequestSchema = z.array(z.object({
+	number: z.number(),
+	head: z.object({ ref: z.string() })
+}));
+/**
+* Find an open PR with the given head branch. Returns the PR number or null.
+*
+* Fetches all open PRs and filters client-side by head.ref rather than relying
+* on Forgejo's query parameter filtering, which behaves inconsistently.
+*/
 async function findOpenPr(executor, conn, head) {
-	const url = `${conn.serverUrl}/api/v1/repos/${conn.repository}/pulls?state=open&head=${head}`;
+	const url = `${conn.serverUrl}/api/v1/repos/${conn.repository}/pulls?state=open`;
 	const res = await executor.fetch(url, { headers: { Authorization: `token ${conn.token}` } });
 	if (!res.ok) throw new TransientError(`Failed to list PRs: ${res.status} ${res.statusText}`);
 	const parsed = PullRequestSchema.safeParse(await res.json());
 	if (!parsed.success) throw new UnexpectedError(`Unexpected PR list response: ${parsed.error.message}`);
-	return parsed.data[0]?.number ?? null;
+	return parsed.data.find((pr) => pr.head.ref === head)?.number ?? null;
 }
 /** Create a new pull request. */
 async function createPr(executor, conn, options) {
@@ -2578,7 +2731,6 @@ async function createRelease(executor, conn, tag) {
 	});
 	if (!res.ok) throw new TransientError(`Failed to create release for ${tag}: ${res.status} ${res.statusText}`);
 }
-
 //#endregion
 //#region src/release/log.ts
 /** Log a debug message when verbose mode is enabled. */
@@ -2593,7 +2745,6 @@ function debugExec(config, label, result) {
 	if (result.stderr.trim()) lines.push(`  stderr: ${result.stderr.trim()}`);
 	p.log.info(lines.join("\n"));
 }
-
 //#endregion
 //#region src/release/version.ts
 const BRANCH = "changeset-release/main";
@@ -2738,7 +2889,6 @@ async function runVersionMode(executor, config) {
 		pr: "updated"
 	};
 }
-
 //#endregion
 //#region src/release/publish.ts
 const RETRY_ATTEMPTS = 3;
@@ -2828,7 +2978,6 @@ async function runPublishMode(executor, config) {
 		tags: allTags
 	};
 }
-
 //#endregion
 //#region src/release/connection.ts
 const RepositorySchema = z.union([z.string(), z.object({ url: z.string() })]);
@@ -2902,7 +3051,6 @@ function parseGitUrl(urlStr) {
 		return null;
 	}
 }
-
 //#endregion
 //#region src/commands/release-changesets.ts
 const releaseForgejoCommand = defineCommand({
@@ -2949,7 +3097,6 @@ async function runRelease(config, executor) {
 	debug(config, "Entering publish mode");
 	return runPublishMode(executor, config);
 }
-
 //#endregion
 //#region src/commands/release-trigger.ts
 const releaseTriggerCommand = defineCommand({
@@ -2986,7 +3133,6 @@ function triggerGitHub(ref) {
 	createRealExecutor().exec(`gh workflow run release.yml --ref ${ref}`, { cwd: process.cwd() });
 	p.log.info(`Triggered release workflow on GitHub (ref: ${ref})`);
 }
-
 //#endregion
 //#region src/commands/release-create-forgejo-release.ts
 const createForgejoReleaseCommand = defineCommand({
@@ -3012,7 +3158,6 @@ const createForgejoReleaseCommand = defineCommand({
 		p.log.info(`Created Forgejo release for ${args.tag}`);
 	}
 });
-
 //#endregion
 //#region src/commands/release-merge.ts
 const HEAD_BRANCH = "changeset-release/main";
@@ -3057,13 +3202,12 @@ function mergeGitHub(dryRun) {
 	executor.exec(`gh pr merge ${HEAD_BRANCH} --merge --delete-branch`, { cwd: process.cwd() });
 	p.log.info(`Merged changesets PR and deleted branch ${HEAD_BRANCH}`);
 }
-
 //#endregion
 //#region src/bin.ts
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.8.0",
+		version: "0.9.0",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -3076,8 +3220,7 @@ const main = defineCommand({
 		"release:merge": releaseMergeCommand
 	}
 });
-console.log(`@bensandee/tooling v0.8.0`);
+console.log(`@bensandee/tooling v0.9.0`);
 runMain(main);
-
 //#endregion
-export {  };
+export {};

package/dist/index.mjs

@@ -1 +1 @@
-export {  };
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"
@@ -21,7 +21,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.1",
+    "@clack/prompts": "^1.1.0",
     "citty": "^0.2.1",
     "json5": "^2.2.3",
     "jsonc-parser": "^3.3.1",
@@ -29,11 +29,11 @@
     "@bensandee/common": "0.1.0"
   },
   "devDependencies": {
-    "@types/node": "24.10.11",
-    "tsdown": "0.20.3",
+    "@types/node": "24.12.0",
+    "tsdown": "0.21.0",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
-    "@bensandee/config": "0.6.5"
+    "@bensandee/config": "0.7.1"
   },
   "scripts": {
     "build": "tsdown",