@bensandee/tooling 0.6.2 → 0.7.1

package/dist/bin.mjs

@@ -7,6 +7,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync
 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. */
@@ -63,6 +64,16 @@ function parseRenovateJson(raw) {
 		return {};
 	}
 }
+const ChangesetConfigSchema = z.object({ commit: z.union([z.boolean(), z.string()]).optional() }).loose();
+/** Parse a JSON string as a .changeset/config.json. Returns `undefined` on failure. */
+function parseChangesetConfig(raw) {
+	try {
+		const result = ChangesetConfigSchema.safeParse(JSON.parse(raw));
+		return result.success ? result.data : void 0;
+	} catch {
+		return;
+	}
+}
 /** Parse a JSON string as a package.json. Returns `undefined` on failure. */
 function parsePackageJson(raw) {
 	try {
@@ -431,6 +442,32 @@ function createContext(config, confirmOverwrite) {
 		archivedFiles
 	};
 }
+/**
+* Create a read-only GeneratorContext for dry-run checks.
+* Reads from the real filesystem but captures writes instead of applying them.
+* confirmOverwrite always returns "overwrite" to surface all potential changes.
+*/
+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"
+		},
+		pendingWrites
+	};
+}
 
 //#endregion
 //#region src/generators/package-json.ts
@@ -492,7 +529,6 @@ function addReleaseDeps(deps, config) {
 		case "release-it":
 			deps["release-it"] = "18.1.2";
 			if (config.structure === "monorepo") deps["@release-it/bumper"] = "7.0.2";
-			if (config.ci === "forgejo") deps["@bensandee/release-it-forgejo"] = "0.1.1";
 			break;
 		case "commit-and-tag-version":
 			deps["commit-and-tag-version"] = "12.5.0";
@@ -555,6 +591,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`);
 		}
 		pkg.devDependencies = existingDevDeps;
 		if (!pkg["engines"]) {
@@ -766,42 +805,81 @@ async function generateTsconfig(ctx) {
 	const existing = ctx.read(filePath);
 	if (ctx.config.structure === "monorepo") return [generateMonorepoRootTsconfig(ctx, existing), ...ctx.config.detectPackageTypes ? generateMonorepoPackageTsconfigs(ctx) : []];
 	const extendsValue = `@bensandee/config/tsconfig/${ctx.config.projectType}`;
-	const config = {
-		extends: extendsValue,
-		include: ["src"],
-		exclude: ["node_modules", "dist"]
-	};
-	if (existing) {
-		const parsed = parseTsconfig(existing);
-		const changes = [];
-		if (!parsed.extends) {
-			parsed.extends = extendsValue;
-			changes.push(`added extends: ${extendsValue}`);
-		}
-		const existingInclude = parsed.include ?? [];
-		for (const entry of config.include) if (!existingInclude.includes(entry)) {
-			existingInclude.push(entry);
-			changes.push(`added "${entry}" to include`);
-		}
-		parsed.include = existingInclude;
-		if (changes.length === 0) return [{
-			filePath,
-			action: "skipped",
-			description: "Already up to spec"
-		}];
-		ctx.write(filePath, JSON.stringify(parsed, null, 2) + "\n");
+	if (!existing) {
+		const config = {
+			extends: extendsValue,
+			include: ["src"],
+			exclude: ["node_modules", "dist"]
+		};
+		ctx.write(filePath, JSON.stringify(config, null, 2) + "\n");
 		return [{
 			filePath,
-			action: "updated",
-			description: changes.join(", ")
+			action: "created",
+			description: `Generated tsconfig.json with ${extendsValue}`
 		}];
 	}
-	ctx.write(filePath, JSON.stringify(config, null, 2) + "\n");
-	return [{
+	if (existing.includes("// @bensandee/tooling:ignore")) return [{
 		filePath,
-		action: "created",
-		description: `Generated tsconfig.json with @bensandee/config/tsconfig/${ctx.config.projectType}`
+		action: "skipped",
+		description: "Ignored via tooling:ignore comment"
 	}];
+	const parsed = parseTsconfig(existing);
+	if (isSolutionStyle(parsed)) {
+		const results = [{
+			filePath,
+			action: "skipped",
+			description: "Solution-style tsconfig — traversing references"
+		}];
+		for (const ref of parsed.references ?? []) {
+			const refPath = resolveReferencePath(ref.path);
+			results.push(mergeSingleTsconfig(ctx, refPath, extendsValue));
+		}
+		return results;
+	}
+	return [mergeSingleTsconfig(ctx, filePath, extendsValue)];
+}
+function isSolutionStyle(parsed) {
+	return Array.isArray(parsed.references) && parsed.references.length > 0 && Array.isArray(parsed.files) && parsed.files.length === 0;
+}
+function resolveReferencePath(refPath) {
+	const resolved = refPath.endsWith(".json") ? refPath : path.join(refPath, "tsconfig.json");
+	return path.normalize(resolved);
+}
+function mergeSingleTsconfig(ctx, filePath, extendsValue) {
+	const existing = ctx.read(filePath);
+	if (!existing) return {
+		filePath,
+		action: "skipped",
+		description: "File not found"
+	};
+	if (existing.includes("// @bensandee/tooling:ignore")) return {
+		filePath,
+		action: "skipped",
+		description: "Ignored via tooling:ignore comment"
+	};
+	const parsed = parseTsconfig(existing);
+	const changes = [];
+	if (!parsed.extends) {
+		parsed.extends = extendsValue;
+		changes.push(`added extends: ${extendsValue}`);
+	}
+	const existingInclude = parsed.include ?? [];
+	if (!existingInclude.includes("src")) {
+		existingInclude.push("src");
+		changes.push("added \"src\" to include");
+	}
+	parsed.include = existingInclude;
+	if (changes.length === 0) return {
+		filePath,
+		action: "skipped",
+		description: "Already up to spec"
+	};
+	ctx.write(filePath, JSON.stringify(parsed, null, 2) + "\n");
+	return {
+		filePath,
+		action: "updated",
+		description: changes.join(", ")
+	};
 }
 function generateMonorepoRootTsconfig(ctx, existing) {
 	const filePath = "tsconfig.json";
@@ -843,6 +921,14 @@ function generateMonorepoPackageTsconfigs(ctx) {
 		const projectType = detectProjectType(pkg.dir);
 		const extendsValue = `@bensandee/config/tsconfig/${projectType}`;
 		if (existing) {
+			if (existing.includes("// @bensandee/tooling:ignore")) {
+				results.push({
+					filePath,
+					action: "skipped",
+					description: "Ignored via tooling:ignore comment"
+				});
+				continue;
+			}
 			const parsed = parseTsconfig(existing);
 			const changes = [];
 			if (parsed.extends !== extendsValue) {
@@ -918,7 +1004,12 @@ async function generateVitest(ctx) {
 		description: "Monorepo: vitest config belongs in individual packages"
 	}];
 	const configPath = "vitest.config.ts";
-	if (ctx.exists(configPath)) if (await ctx.confirmOverwrite(configPath) === "skip") results.push({
+	if (ctx.exists(configPath)) if (ctx.read(configPath) === VITEST_CONFIG) results.push({
+		filePath: configPath,
+		action: "skipped",
+		description: "Config already up to date"
+	});
+	else if (await ctx.confirmOverwrite(configPath) === "skip") results.push({
 		filePath: configPath,
 		action: "skipped",
 		description: "Existing config preserved"
@@ -972,7 +1063,7 @@ async function generateOxlint(ctx) {
 	const content = ctx.config.useEslintPlugin ? CONFIG_WITH_LINT_RULES : CONFIG_PRESET_ONLY;
 	const existing = ctx.read(filePath);
 	if (existing) {
-		if (existing === content) return {
+		if (existing === content || existing.includes("@bensandee/config/oxlint")) return {
 			filePath,
 			action: "skipped",
 			description: "Already configured"
@@ -1008,8 +1099,13 @@ async function generateFormatter(ctx) {
 }
 async function generateOxfmt(ctx) {
 	const filePath = ".oxfmtrc.json";
-	const existed = ctx.exists(filePath);
-	if (existed) {
+	const existing = ctx.read(filePath);
+	if (existing) {
+		if (existing === OXFMT_CONFIG) return {
+			filePath,
+			action: "skipped",
+			description: "Already configured"
+		};
 		if (await ctx.confirmOverwrite(filePath) === "skip") return {
 			filePath,
 			action: "skipped",
@@ -1019,7 +1115,7 @@ async function generateOxfmt(ctx) {
 	ctx.write(filePath, OXFMT_CONFIG);
 	return {
 		filePath,
-		action: existed ? "updated" : "created",
+		action: existing ? "updated" : "created",
 		description: "Generated .oxfmtrc.json"
 	};
 }
@@ -1053,7 +1149,13 @@ async function generateTsdown(ctx) {
 		action: "skipped",
 		description: "Monorepo: tsdown config belongs in individual packages"
 	};
-	if (ctx.exists(filePath)) {
+	const existing = ctx.read(filePath);
+	if (existing) {
+		if (existing === TSDOWN_CONFIG) return {
+			filePath,
+			action: "skipped",
+			description: "Already configured"
+		};
 		if (await ctx.confirmOverwrite(filePath) === "skip") return {
 			filePath,
 			action: "skipped",
@@ -1063,23 +1165,25 @@ async function generateTsdown(ctx) {
 	ctx.write(filePath, TSDOWN_CONFIG);
 	return {
 		filePath,
-		action: "created",
+		action: existing ? "updated" : "created",
 		description: "Generated tsdown.config.ts"
 	};
 }
 
 //#endregion
 //#region src/generators/gitignore.ts
-const STANDARD_ENTRIES = [
+/** Entries that every project should have — repo:check flags these as missing. */
+const REQUIRED_ENTRIES = [
 	"node_modules/",
 	"dist/",
 	"*.tsbuildinfo",
 	".env",
 	".env.*",
-	"!.env.example",
-	".tooling-migrate.md",
-	".tooling-archived/"
+	"!.env.example"
 ];
+/** Tooling-specific entries added during init/update but not required for repo:check. */
+const OPTIONAL_ENTRIES = [".tooling-migrate.md", ".tooling-archived/"];
+const ALL_ENTRIES = [...REQUIRED_ENTRIES, ...OPTIONAL_ENTRIES];
 /** Normalize a gitignore entry for comparison: strip leading `/` and trailing `/`. */
 function normalizeEntry(entry) {
 	let s = entry.trim();
@@ -1092,21 +1196,27 @@ async function generateGitignore(ctx) {
 	const existing = ctx.read(filePath);
 	if (existing) {
 		const existingNormalized = new Set(existing.split("\n").map(normalizeEntry).filter((line) => line.length > 0));
-		const missing = STANDARD_ENTRIES.filter((entry) => !existingNormalized.has(normalizeEntry(entry)));
+		const missing = ALL_ENTRIES.filter((entry) => !existingNormalized.has(normalizeEntry(entry)));
 		if (missing.length === 0) return {
 			filePath,
 			action: "skipped",
 			description: "Already has all standard entries"
 		};
+		const missingRequired = REQUIRED_ENTRIES.filter((entry) => !existingNormalized.has(normalizeEntry(entry)));
 		const updated = existing.trimEnd() + "\n\n# Added by @bensandee/tooling\n" + missing.join("\n") + "\n";
 		ctx.write(filePath, updated);
+		if (missingRequired.length === 0) return {
+			filePath,
+			action: "skipped",
+			description: "Only optional entries missing"
+		};
 		return {
 			filePath,
 			action: "updated",
 			description: `Appended ${String(missing.length)} missing entries`
 		};
 	}
-	ctx.write(filePath, STANDARD_ENTRIES.join("\n") + "\n");
+	ctx.write(filePath, ALL_ENTRIES.join("\n") + "\n");
 	return {
 		filePath,
 		action: "created",
@@ -1117,7 +1227,9 @@ async function generateGitignore(ctx) {
 //#endregion
 //#region src/generators/ci.ts
 function hasEnginesNode$1(ctx) {
-	return typeof ctx.packageJson?.["engines"]?.["node"] === "string";
+	const raw = ctx.read("package.json");
+	if (!raw) return false;
+	return typeof parsePackageJson(raw)?.engines?.["node"] === "string";
 }
 function ciWorkflow(isMonorepo, nodeVersionYaml) {
 	return `name: CI
@@ -1144,6 +1256,7 @@ jobs:
       - run: ${isMonorepo ? "pnpm -r test" : "pnpm test"}
       - run: pnpm format --check
       - run: pnpm knip
+      - run: pnpm exec tooling repo:check
 `;
 }
 async function generateCi(ctx) {
@@ -1158,10 +1271,20 @@ async function generateCi(ctx) {
 	const filePath = isGitHub ? ".github/workflows/check.yml" : ".forgejo/workflows/check.yml";
 	const content = ciWorkflow(isMonorepo, nodeVersionYaml);
 	if (ctx.exists(filePath)) {
-		if (await ctx.confirmOverwrite(filePath) === "skip") return {
+		const existing = ctx.read(filePath);
+		if (existing && !existing.includes("repo:check")) {
+			const patched = existing.trimEnd() + "\n      - run: pnpm exec tooling repo:check\n";
+			ctx.write(filePath, patched);
+			return {
+				filePath,
+				action: "updated",
+				description: "Added `pnpm exec tooling repo:check` step to CI workflow"
+			};
+		}
+		return {
 			filePath,
 			action: "skipped",
-			description: "Existing CI workflow preserved"
+			description: "CI workflow already up to date"
 		};
 	}
 	ctx.write(filePath, content);
@@ -1465,7 +1588,6 @@ function buildConfig$2(ci, isMonorepo) {
 	};
 	if (ci === "github") config["github"] = { release: true };
 	const plugins = {};
-	if (ci === "forgejo") plugins["@bensandee/release-it-forgejo"] = { release: true };
 	if (isMonorepo) {
 		config["npm"] = {
 			publish: true,
@@ -1529,18 +1651,11 @@ async function generateChangesets(ctx) {
 	};
 	const content = JSON.stringify(buildConfig$1(), null, 2) + "\n";
 	const existing = ctx.read(filePath);
-	if (existing) {
-		if (existing === content) return {
-			filePath,
-			action: "skipped",
-			description: "Already configured"
-		};
-		if (await ctx.confirmOverwrite(filePath) === "skip") return {
-			filePath,
-			action: "skipped",
-			description: "Existing changesets config preserved"
-		};
-	}
+	if (existing) return {
+		filePath,
+		action: "skipped",
+		description: "Existing changesets config preserved"
+	};
 	ctx.write(filePath, content);
 	return {
 		filePath,
@@ -1706,13 +1821,11 @@ async function generateReleaseCi(ctx) {
 		action: "skipped",
 		description: "Release CI workflow not applicable"
 	};
-	if (ctx.exists(workflowPath)) {
-		if (await ctx.confirmOverwrite(workflowPath) === "skip") return {
-			filePath: workflowPath,
-			action: "skipped",
-			description: "Existing release workflow preserved"
-		};
-	}
+	if (ctx.exists(workflowPath)) return {
+		filePath: workflowPath,
+		action: "skipped",
+		description: "Existing release workflow preserved"
+	};
 	ctx.write(workflowPath, content);
 	return {
 		filePath: workflowPath,
@@ -1833,43 +1946,127 @@ async function generateLefthook(ctx) {
 	archiveLintStagedConfigs(ctx, results);
 	cleanPackageJson(ctx, results);
 	const existingPath = LEFTHOOK_CONFIG_PATHS.find((p) => ctx.exists(p));
-	if (existingPath === filePath) {
-		const existing = ctx.read(filePath);
-		if (existing) {
-			if (existing === content) {
-				results.push({
-					filePath,
-					action: "skipped",
-					description: "Already configured"
-				});
-				return results;
-			}
-			if (await ctx.confirmOverwrite(filePath) === "skip") {
-				results.push({
-					filePath,
-					action: "skipped",
-					description: "Existing lefthook config preserved"
-				});
-				return results;
-			}
-		}
-	} else if (existingPath) {
+	if (existingPath) {
 		results.push({
 			filePath: existingPath,
 			action: "skipped",
-			description: `Existing config found at ${existingPath}`
+			description: "Existing lefthook config preserved"
 		});
 		return results;
 	}
 	ctx.write(filePath, content);
 	results.push({
 		filePath,
-		action: existingPath === filePath ? "updated" : "created",
+		action: "created",
 		description: "Generated lefthook pre-commit config"
 	});
 	return results;
 }
 
+//#endregion
+//#region src/generators/pipeline.ts
+/** Run all generators sequentially and return their results. */
+async function runGenerators(ctx) {
+	const results = [];
+	results.push(await generatePackageJson(ctx));
+	results.push(await generatePnpmWorkspace(ctx));
+	results.push(...await generateTsconfig(ctx));
+	results.push(await generateTsdown(ctx));
+	results.push(await generateOxlint(ctx));
+	results.push(await generateFormatter(ctx));
+	results.push(...await generateLefthook(ctx));
+	results.push(await generateGitignore(ctx));
+	results.push(await generateKnip(ctx));
+	results.push(await generateRenovate(ctx));
+	results.push(await generateCi(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));
+	return results;
+}
+
+//#endregion
+//#region src/utils/tooling-config.ts
+const CONFIG_FILE = ".tooling.json";
+const ToolingConfigSchema = z.object({
+	structure: z.enum(["single", "monorepo"]).optional(),
+	useEslintPlugin: z.boolean().optional(),
+	formatter: z.enum(["oxfmt", "prettier"]).optional(),
+	setupVitest: z.boolean().optional(),
+	ci: z.enum([
+		"github",
+		"forgejo",
+		"none"
+	]).optional(),
+	setupRenovate: z.boolean().optional(),
+	releaseStrategy: z.enum([
+		"release-it",
+		"commit-and-tag-version",
+		"changesets",
+		"none"
+	]).optional(),
+	projectType: z.enum([
+		"default",
+		"node",
+		"react",
+		"library"
+	]).optional(),
+	detectPackageTypes: z.boolean().optional()
+});
+/** Load saved tooling config from the target directory. Returns undefined if missing or 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;
+	}
+}
+/** Save the user's config choices to .tooling.json via the generator context. */
+function saveToolingConfig(ctx, config) {
+	const saved = {
+		structure: config.structure,
+		useEslintPlugin: config.useEslintPlugin,
+		formatter: config.formatter,
+		setupVitest: config.setupVitest,
+		ci: config.ci,
+		setupRenovate: config.setupRenovate,
+		releaseStrategy: config.releaseStrategy,
+		projectType: config.projectType,
+		detectPackageTypes: config.detectPackageTypes
+	};
+	const content = JSON.stringify(saved, null, 2) + "\n";
+	const existed = ctx.exists(CONFIG_FILE);
+	ctx.write(CONFIG_FILE, content);
+	return {
+		filePath: CONFIG_FILE,
+		action: existed ? "updated" : "created",
+		description: "Saved tooling configuration"
+	};
+}
+/** Merge saved config over detected defaults. Saved values win when present. */
+function mergeWithSavedConfig(detected, saved) {
+	return {
+		name: detected.name,
+		isNew: detected.isNew,
+		targetDir: detected.targetDir,
+		structure: saved.structure ?? detected.structure,
+		useEslintPlugin: saved.useEslintPlugin ?? detected.useEslintPlugin,
+		formatter: saved.formatter ?? detected.formatter,
+		setupVitest: saved.setupVitest ?? detected.setupVitest,
+		ci: saved.ci ?? detected.ci,
+		setupRenovate: saved.setupRenovate ?? detected.setupRenovate,
+		releaseStrategy: saved.releaseStrategy ?? detected.releaseStrategy,
+		projectType: saved.projectType ?? detected.projectType,
+		detectPackageTypes: saved.detectPackageTypes ?? detected.detectPackageTypes
+	};
+}
+
 //#endregion
 //#region src/commands/repo-init.ts
 const initCommand = defineCommand({
@@ -1903,10 +2100,14 @@ const initCommand = defineCommand({
 	},
 	async run({ args }) {
 		const targetDir = path.resolve(args.dir ?? ".");
-		await runInit(args.yes ? buildDefaultConfig(targetDir, {
-			eslintPlugin: args["eslint-plugin"] === true ? true : void 0,
-			noCi: args["no-ci"] === true ? true : void 0
-		}) : await runInitPrompts(targetDir), args["no-prompt"] === true ? { noPrompt: true } : {});
+		await runInit(args.yes ? (() => {
+			const saved = loadToolingConfig(targetDir);
+			const detected = buildDefaultConfig(targetDir, {
+				eslintPlugin: args["eslint-plugin"] === true ? true : void 0,
+				noCi: args["no-ci"] === true ? true : void 0
+			});
+			return saved ? mergeWithSavedConfig(detected, saved) : detected;
+		})() : await runInitPrompts(targetDir), args["no-prompt"] === true ? { noPrompt: true } : {});
 	}
 });
 async function runInit(config, options = {}) {
@@ -1928,25 +2129,9 @@ async function runInit(config, options = {}) {
 		if (p.isCancel(result)) return "skip";
 		return result;
 	}));
-	const results = [];
 	s.start("Generating configuration files...");
-	results.push(await generatePackageJson(ctx));
-	results.push(await generatePnpmWorkspace(ctx));
-	results.push(...await generateTsconfig(ctx));
-	results.push(await generateTsdown(ctx));
-	results.push(await generateOxlint(ctx));
-	results.push(await generateFormatter(ctx));
-	results.push(...await generateLefthook(ctx));
-	results.push(await generateGitignore(ctx));
-	results.push(await generateKnip(ctx));
-	results.push(await generateRenovate(ctx));
-	results.push(await generateCi(ctx));
-	results.push(await generateClaudeSettings(ctx));
-	results.push(await generateReleaseIt(ctx));
-	results.push(await generateChangesets(ctx));
-	results.push(await generateReleaseCi(ctx));
-	const vitestResults = await generateVitest(ctx);
-	results.push(...vitestResults);
+	const results = await runGenerators(ctx);
+	results.push(saveToolingConfig(ctx, config));
 	const alreadyArchived = new Set(results.filter((r) => r.action === "archived").map((r) => r.filePath));
 	for (const rel of archivedFiles) if (!alreadyArchived.has(rel)) results.push({
 		filePath: rel,
@@ -1977,14 +2162,26 @@ async function runInit(config, options = {}) {
 		p.log.info(`Migration prompt written to ${promptPath}`);
 		p.log.info("Paste its contents into Claude Code to finish the migration.");
 	}
-	const updateCmd = `pnpm update --latest ${getAddedDevDepNames(config).join(" ")}`;
+	const bensandeeDeps = getAddedDevDepNames(config).filter((name) => name.startsWith("@bensandee/"));
+	const hasLockfile = ctx.exists("pnpm-lock.yaml");
+	if (bensandeeDeps.length > 0 && hasLockfile) {
+		s.start("Updating @bensandee/* packages...");
+		try {
+			execSync(`pnpm update --latest ${bensandeeDeps.join(" ")}`, {
+				cwd: config.targetDir,
+				stdio: "ignore"
+			});
+			s.stop("Updated @bensandee/* packages");
+		} catch (_error) {
+			s.stop("Could not update @bensandee/* packages — run pnpm install first");
+		}
+	}
 	p.note([
 		"1. Run: pnpm install",
-		`2. Run: ${updateCmd}`,
-		"3. Run: pnpm typecheck",
-		"4. Run: pnpm build",
-		"5. Run: pnpm test",
-		...options.noPrompt ? [] : ["6. Paste .tooling-migrate.md into Claude Code for cleanup"]
+		"2. Run: pnpm typecheck",
+		"3. Run: pnpm build",
+		"4. Run: pnpm test",
+		...options.noPrompt ? [] : ["5. Paste .tooling-migrate.md into Claude Code for cleanup"]
 	].join("\n"), "Next steps");
 	return results;
 }
@@ -1994,7 +2191,7 @@ async function runInit(config, options = {}) {
 const updateCommand = defineCommand({
 	meta: {
 		name: "repo:update",
-		description: "Add missing config (never overwrites)"
+		description: "Update managed config and add missing files"
 	},
 	args: { dir: {
 		type: "positional",
@@ -2006,26 +2203,73 @@ const updateCommand = defineCommand({
 	}
 });
 async function runUpdate(targetDir) {
-	return runInit(buildDefaultConfig(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, {
 		noPrompt: true,
-		confirmOverwrite: async () => "skip"
+		confirmOverwrite: async () => "overwrite"
 	});
 }
 
 //#endregion
-//#region src/utils/errors.ts
-/** An error caused by an external transient condition (network, API rate limit, etc). */
-var TransientError = class extends Error {
-	name = "TransientError";
-};
-/** An error indicating a fatal misconfiguration or invariant violation. */
-var FatalError = class extends Error {
-	name = "FatalError";
-};
-/** An error for conditions that should be unreachable. */
-var UnexpectedError = class extends Error {
-	name = "UnexpectedError";
-};
+//#region src/commands/repo-check.ts
+const checkCommand = defineCommand({
+	meta: {
+		name: "repo:check",
+		description: "Check repo for tooling drift (dry-run, CI-friendly)"
+	},
+	args: { dir: {
+		type: "positional",
+		description: "Target directory (default: current directory)",
+		required: false
+	} },
+	async run({ args }) {
+		const exitCode = await runCheck(path.resolve(args.dir ?? "."));
+		process.exitCode = exitCode;
+	}
+});
+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);
+	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.");
+		return 0;
+	}
+	p.log.warn(`${actionable.length} file(s) would be changed by repo:update`);
+	for (const r of actionable) {
+		p.log.info(`  ${r.action}: ${r.filePath} — ${r.description}`);
+		const newContent = pendingWrites.get(r.filePath);
+		if (!newContent) continue;
+		const existingPath = path.join(targetDir, r.filePath);
+		const existing = existsSync(existingPath) ? readFileSync(existingPath, "utf-8") : void 0;
+		if (!existing) {
+			const lineCount = newContent.split("\n").length - 1;
+			p.log.info(`    + ${lineCount} new lines`);
+		} else {
+			const diff = lineDiff(existing, newContent);
+			if (diff.length > 0) for (const line of diff) p.log.info(`    ${line}`);
+		}
+	}
+	return 1;
+}
+const normalize = (line) => line.trimEnd();
+/** Produce a compact line-level diff summary, ignoring whitespace-only differences. */
+function lineDiff(oldText, newText) {
+	const oldLines = oldText.split("\n").map(normalize);
+	const newLines = newText.split("\n").map(normalize);
+	const oldSet = new Set(oldLines);
+	const newSet = new Set(newLines);
+	const removed = oldLines.filter((l) => l.trim() !== "" && !newSet.has(l));
+	const added = newLines.filter((l) => l.trim() !== "" && !oldSet.has(l));
+	const lines = [];
+	for (const l of removed) lines.push(`- ${l.trim()}`);
+	for (const l of added) lines.push(`+ ${l.trim()}`);
+	return lines;
+}
 
 //#endregion
 //#region src/utils/exec.ts
@@ -2104,6 +2348,10 @@ function createRealExecutor() {
 			} catch {
 				return null;
 			}
+		},
+		writeFile(filePath, content) {
+			mkdirSync(path.dirname(filePath), { recursive: true });
+			writeFileSync(filePath, content);
 		}
 	};
 }
@@ -2319,8 +2567,22 @@ async function runVersionMode(executor, config) {
 	p.log.info("Changesets detected — versioning packages");
 	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");
+	const originalConfig = executor.readFile(changesetConfigPath);
+	if (originalConfig) {
+		const parsed = parseChangesetConfig(originalConfig);
+		if (parsed?.commit) {
+			const patched = {
+				...parsed,
+				commit: false
+			};
+			executor.writeFile(changesetConfigPath, JSON.stringify(patched, null, 2) + "\n");
+			debug(config, "Temporarily disabled changeset commit:true");
+		}
+	}
 	const versionResult = executor.exec("pnpm changeset version", { cwd: config.cwd });
 	debugExec(config, "pnpm changeset version", versionResult);
+	if (originalConfig) executor.writeFile(changesetConfigPath, originalConfig);
 	if (versionResult.exitCode !== 0) throw new FatalError(`pnpm changeset version failed (exit code ${String(versionResult.exitCode)}):\n${versionResult.stderr}`);
 	debugExec(config, "pnpm install --no-frozen-lockfile", executor.exec("pnpm install --no-frozen-lockfile", { cwd: config.cwd }));
 	const { title, body } = buildPrContent(executor, config.cwd, packagesBefore);
@@ -2701,19 +2963,20 @@ function mergeGitHub(dryRun) {
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.6.2",
+		version: "0.7.1",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
 		"repo:init": initCommand,
 		"repo:update": updateCommand,
+		"repo:check": checkCommand,
 		"release:changesets": releaseForgejoCommand,
 		"release:trigger": releaseTriggerCommand,
 		"release:create-forgejo-release": createForgejoReleaseCommand,
 		"release:merge": releaseMergeCommand
 	}
 });
-console.log(`@bensandee/tooling v0.6.2`);
+console.log(`@bensandee/tooling v0.7.1`);
 runMain(main);
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"
@@ -25,14 +25,15 @@
     "citty": "^0.2.1",
     "json5": "^2.2.3",
     "jsonc-parser": "^3.3.1",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@bensandee/common": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "24.10.11",
     "tsdown": "0.20.3",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
-    "@bensandee/config": "0.6.1"
+    "@bensandee/config": "0.6.3"
   },
   "scripts": {
     "build": "tsdown",