@bensandee/tooling 0.5.0 → 0.6.0

package/dist/bin.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { defineCommand, runMain } from "citty";
 import * as p from "@clack/prompts";
+import { execSync } from "node:child_process";
 import path from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { parse } from "jsonc-parser";
 import { z } from "zod";
-import { execSync } from "node:child_process";
 
 //#region src/types.ts
 /** Default CI platform when not explicitly chosen. */
@@ -41,7 +41,7 @@ const TsconfigSchema = z.object({
 	include: z.array(z.string()).optional(),
 	exclude: z.array(z.string()).optional(),
 	files: z.array(z.string()).optional(),
-	references: z.array(z.object({ path: z.string() })).optional(),
+	references: z.array(z.object({ path: z.string() }).passthrough()).optional(),
 	compilerOptions: z.record(z.string(), z.unknown()).optional()
 }).loose();
 const RenovateSchema = z.object({
@@ -656,9 +656,16 @@ function generateMigratePrompt(results, config, detected) {
 		sections.push("");
 		for (const r of archived) sections.push(`- \`${r.filePath}\` → \`.tooling-archived/${r.filePath}\``);
 		sections.push("");
-		sections.push("1. Review the archived files for any custom configuration that should be preserved in the new files");
-		sections.push("2. If the project previously used `husky` and `lint-staged`, remove them from `devDependencies`");
-		sections.push("3. Delete the `.tooling-archived/` directory when migration is complete");
+		sections.push("For each archived file, **diff the old version against the new one** and look for features, categories, or modules that were enabled in the original but are missing from the replacement. Focus on broad capability gaps rather than individual rule strictness (in general, being stricter is fine). Examples of what to look for:");
+		sections.push("");
+		sections.push("- **Lint configs**: enabled plugin categories (e.g. `jsx-a11y`, `import`, `react`, `nextjs`), custom `plugins` or `overrides`, file-scoped rule blocks");
+		sections.push("- **TypeScript configs**: compiler features like `jsx`, `paths`, `baseUrl`, or `references` that affect build behavior");
+		sections.push("- **Other configs**: feature flags, custom presets, or integrations that go beyond the default template");
+		sections.push("");
+		sections.push("If the old config had capabilities the new one lacks, port them into the new file. Then:");
+		sections.push("");
+		sections.push("1. If the project previously used `husky` and `lint-staged`, remove them from `devDependencies`");
+		sections.push("2. Delete the `.tooling-archived/` directory when migration is complete");
 		sections.push("");
 	}
 	const oxlintWasSkipped = results.find((r) => r.filePath === "oxlint.config.ts")?.action === "skipped";
@@ -1731,6 +1738,15 @@ function buildConfig(formatter) {
 	].join("\n");
 }
 const ARCHIVE_DIR = ".tooling-archived";
+/** Common client-side git hooks that husky may have configured. */
+const HUSKY_HOOK_NAMES = [
+	"pre-commit",
+	"commit-msg",
+	"pre-push",
+	"post-merge",
+	"post-checkout",
+	"prepare-commit-msg"
+];
 /** All known lint-staged config file locations to archive. */
 const LINT_STAGED_CONFIG_PATHS = [
 	"lint-staged.config.mjs",
@@ -1745,21 +1761,28 @@ const LINT_STAGED_CONFIG_PATHS = [
 ];
 /** All known lefthook config file locations, in priority order. */
 const LEFTHOOK_CONFIG_PATHS = ["lefthook.yml", ".lefthook.yml"];
-async function generateLefthook(ctx) {
-	const filePath = "lefthook.yml";
-	const content = buildConfig(ctx.config.formatter);
-	const results = [];
-	const huskyPath = ".husky/pre-commit";
-	const existingHusky = ctx.read(huskyPath);
-	if (existingHusky !== void 0) {
-		ctx.write(`${ARCHIVE_DIR}/${huskyPath}`, existingHusky);
-		ctx.remove(huskyPath);
-		results.push({
-			filePath: huskyPath,
-			action: "archived",
-			description: `Moved to ${ARCHIVE_DIR}/${huskyPath}`
-		});
+/** Archive all husky hook files found in .husky/ */
+function archiveHuskyHooks(ctx, results) {
+	let found = false;
+	for (const hook of HUSKY_HOOK_NAMES) {
+		const huskyPath = `.husky/${hook}`;
+		const existing = ctx.read(huskyPath);
+		if (existing !== void 0) {
+			ctx.write(`${ARCHIVE_DIR}/${huskyPath}`, existing);
+			ctx.remove(huskyPath);
+			results.push({
+				filePath: huskyPath,
+				action: "archived",
+				description: `Moved to ${ARCHIVE_DIR}/${huskyPath}`
+			});
+			found = true;
+		}
 	}
+	return found;
+}
+/** Archive all lint-staged config files. */
+function archiveLintStagedConfigs(ctx, results) {
+	let found = false;
 	for (const lsPath of LINT_STAGED_CONFIG_PATHS) {
 		const existing = ctx.read(lsPath);
 		if (existing !== void 0) {
@@ -1770,8 +1793,47 @@ async function generateLefthook(ctx) {
 				action: "archived",
 				description: `Moved to ${ARCHIVE_DIR}/${lsPath}`
 			});
+			found = true;
+		}
+	}
+	return found;
+}
+/** Remove husky/lint-staged from package.json devDependencies and fix prepare script. */
+function cleanPackageJson(ctx, results) {
+	const raw = ctx.read("package.json");
+	if (!raw) return;
+	const pkg = parsePackageJson(raw);
+	if (!pkg) return;
+	const changes = [];
+	if (pkg.devDependencies) {
+		if ("husky" in pkg.devDependencies) {
+			delete pkg.devDependencies["husky"];
+			changes.push("removed devDependency: husky");
+		}
+		if ("lint-staged" in pkg.devDependencies) {
+			delete pkg.devDependencies["lint-staged"];
+			changes.push("removed devDependency: lint-staged");
 		}
 	}
+	if (pkg.scripts?.["prepare"] && /\bhusky\b/.test(pkg.scripts["prepare"])) {
+		pkg.scripts["prepare"] = "lefthook install";
+		changes.push("replaced prepare script: husky → lefthook install");
+	}
+	if (changes.length === 0) return;
+	ctx.write("package.json", JSON.stringify(pkg, null, 2) + "\n");
+	results.push({
+		filePath: "package.json",
+		action: "updated",
+		description: changes.join(", ")
+	});
+}
+async function generateLefthook(ctx) {
+	const filePath = "lefthook.yml";
+	const content = buildConfig(ctx.config.formatter);
+	const results = [];
+	archiveHuskyHooks(ctx, results);
+	archiveLintStagedConfigs(ctx, results);
+	cleanPackageJson(ctx, results);
 	const existingPath = LEFTHOOK_CONFIG_PATHS.find((p) => ctx.exists(p));
 	if (existingPath === filePath) {
 		const existing = ctx.read(filePath);
@@ -1892,6 +1954,12 @@ async function runInit(config, options = {}) {
 		description: `Original saved to .tooling-archived/${rel}`
 	});
 	s.stop("Done!");
+	if (results.some((r) => r.action === "archived" && r.filePath.startsWith(".husky/"))) try {
+		execSync("git config --unset core.hooksPath", {
+			cwd: config.targetDir,
+			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");
@@ -2630,10 +2698,10 @@ function mergeGitHub(dryRun) {
 
 //#endregion
 //#region src/bin.ts
-runMain(defineCommand({
+const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.1.0",
+		version: "0.6.0",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -2644,7 +2712,9 @@ runMain(defineCommand({
 		"release:create-forgejo-release": createForgejoReleaseCommand,
 		"release:merge": releaseMergeCommand
 	}
-}));
+});
+console.log(`@bensandee/tooling v0.6.0`);
+runMain(main);
 
 //#endregion
 export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"
@@ -31,7 +31,7 @@
     "tsdown": "0.20.3",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
-    "@bensandee/config": "0.5.0"
+    "@bensandee/config": "0.6.0"
   },
   "scripts": {
     "build": "tsdown",