@bensandee/tooling 0.27.1 → 0.28.0

package/dist/bin.mjs

@@ -113,6 +113,7 @@ const LEGACY_PATTERNS = {
 /** Detect existing project state in the target directory. */
 function detectProject(targetDir) {
 	const exists = (rel) => existsSync(path.join(targetDir, rel));
+	const rootPkg = readPackageJson(targetDir);
 	return {
 		hasPackageJson: exists("package.json"),
 		hasTsconfig: exists("tsconfig.json"),
@@ -127,7 +128,8 @@ function detectProject(targetDir) {
 		hasReleaseItConfig: exists(".release-it.json") || exists(".release-it.yaml") || exists(".release-it.toml"),
 		hasSimpleReleaseConfig: exists(".versionrc") || exists(".versionrc.json") || exists(".versionrc.js"),
 		hasChangesetsConfig: exists(".changeset/config.json"),
-		hasRepositoryField: !!readPackageJson(targetDir)?.repository,
+		hasRepositoryField: !!rootPkg?.repository,
+		hasCommitAndTagVersion: !!rootPkg?.devDependencies?.["commit-and-tag-version"],
 		legacyConfigs: detectLegacyConfigs(targetDir)
 	};
 }
@@ -801,7 +803,7 @@ function ensureWorkflowConcurrency(existing, concurrency) {
 	}
 }
 //#endregion
-//#region src/generators/deploy-ci.ts
+//#region src/generators/publish-ci.ts
 /** Build a GitHub Actions expression like `${{ expr }}` without triggering no-template-curly-in-string. */
 function actionsExpr$2(expr) {
 	return `\${{ ${expr} }}`;
@@ -810,14 +812,14 @@ function hasEnginesNode$2(ctx) {
 	return typeof ctx.packageJson?.["engines"]?.["node"] === "string";
 }
 function deployWorkflow(ci, nodeVersionYaml) {
-	return `${workflowSchemaComment(ci)}name: Deploy
+	return `${workflowSchemaComment(ci)}name: Publish
 on:
   push:
     tags:
       - "v[0-9]+.[0-9]+.[0-9]+"
 
 jobs:
-  deploy:
+  publish:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -911,16 +913,16 @@ async function generateDeployCi(ctx) {
 					return {
 						filePath: workflowPath,
 						action: "updated",
-						description: "Migrated tooling binary name in deploy workflow"
+						description: "Migrated tooling binary name in publish workflow"
 					};
 				}
 				return {
 					filePath: workflowPath,
 					action: "skipped",
-					description: "Deploy workflow already up to date"
+					description: "Publish workflow already up to date"
 				};
 			}
-			const merged = mergeWorkflowSteps(existing, "deploy", requiredDeploySteps());
+			const merged = mergeWorkflowSteps(existing, "publish", requiredDeploySteps());
 			const withComment = ensureSchemaComment(merged.content, ctx.config.ci);
 			if (!merged.changed) {
 				if (withComment !== raw) {
@@ -928,33 +930,33 @@ async function generateDeployCi(ctx) {
 					return {
 						filePath: workflowPath,
 						action: "updated",
-						description: existing !== raw ? "Migrated tooling binary name in deploy workflow" : "Added schema comment to deploy workflow"
+						description: existing !== raw ? "Migrated tooling binary name in publish workflow" : "Added schema comment to publish workflow"
 					};
 				}
 				return {
 					filePath: workflowPath,
 					action: "skipped",
-					description: "Existing deploy workflow preserved"
+					description: "Existing publish workflow preserved"
 				};
 			}
 			ctx.write(workflowPath, withComment);
 			return {
 				filePath: workflowPath,
 				action: "updated",
-				description: "Added missing steps to deploy workflow"
+				description: "Added missing steps to publish workflow"
 			};
 		}
 		return {
 			filePath: workflowPath,
 			action: "skipped",
-			description: "Deploy workflow already up to date"
+			description: "Publish workflow already up to date"
 		};
 	}
 	ctx.write(workflowPath, content);
 	return {
 		filePath: workflowPath,
 		action: "created",
-		description: `Generated ${isGitHub ? "GitHub" : "Forgejo"} Actions deploy workflow`
+		description: `Generated ${isGitHub ? "GitHub" : "Forgejo"} Actions publish workflow`
 	};
 }
 //#endregion
@@ -1054,7 +1056,7 @@ function getAddedDevDepNames(config) {
 	const deps = { ...ROOT_DEV_DEPS };
 	if (config.structure !== "monorepo") Object.assign(deps, PER_PACKAGE_DEV_DEPS);
 	deps["@bensandee/config"] = "0.9.1";
-	deps["@bensandee/tooling"] = "0.27.1";
+	deps["@bensandee/tooling"] = "0.28.0";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -1079,7 +1081,7 @@ async function generatePackageJson(ctx) {
 	const devDeps = { ...ROOT_DEV_DEPS };
 	if (!isMonorepo) Object.assign(devDeps, PER_PACKAGE_DEV_DEPS);
 	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.9.1";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.27.1";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.28.0";
 	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.2";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = "0.35.0";
 	if (ctx.config.formatter === "prettier") devDeps["prettier"] = "3.8.1";
@@ -2162,7 +2164,7 @@ function actionsExpr(expr) {
 function hasEnginesNode(ctx) {
 	return typeof ctx.packageJson?.["engines"]?.["node"] === "string";
 }
-function commonSteps(nodeVersionYaml, publishesNpm) {
+function commonSteps(nodeVersionYaml, publishesNpm, { build = true } = {}) {
 	return `      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
@@ -2171,8 +2173,7 @@ function commonSteps(nodeVersionYaml, publishesNpm) {
         with:
           ${nodeVersionYaml}
           cache: pnpm${publishesNpm ? `\n          registry-url: "https://registry.npmjs.org"` : ""}
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm build`;
+      - run: pnpm install --frozen-lockfile${build ? `\n      - run: pnpm build` : ""}`;
 }
 function releaseItWorkflow(ci, nodeVersionYaml, publishesNpm) {
 	const isGitHub = ci === "github";
@@ -2226,7 +2227,7 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-${commonSteps(nodeVersionYaml, publishesNpm)}${gitConfigStep}${releaseStep}
+${commonSteps(nodeVersionYaml, publishesNpm, { build: false })}${gitConfigStep}${releaseStep}
 `;
 }
 /** Build the required release step for the check job (changesets). */
@@ -2290,10 +2291,10 @@ function requiredReleaseSteps(strategy, nodeVersionYaml, publishesNpm) {
 			match: { run: "pnpm install" },
 			step: { run: "pnpm install --frozen-lockfile" }
 		},
-		{
+		...strategy !== "simple" ? [{
 			match: { run: "build" },
 			step: { run: "pnpm build" }
-		}
+		}] : []
 	];
 	switch (strategy) {
 		case "release-it":
@@ -3003,8 +3004,11 @@ function runDockerPublish(executor, config) {
 */
 function generateMigratePrompt(results, config, detected) {
 	const sections = [];
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
 	sections.push("# Migration Prompt");
 	sections.push("");
+	sections.push(`_Generated by \`@bensandee/tooling@0.28.0 repo:sync\` on ${timestamp}_`);
+	sections.push("");
 	sections.push("The following prompt was generated by `@bensandee/tooling repo:sync`. Paste it into Claude Code or another AI assistant to finish migrating this repository.");
 	sections.push("");
 	sections.push("> **Tip:** Before starting, run `/init` in Claude Code to generate a `CLAUDE.md` that gives the AI a complete picture of your repository's structure, conventions, and build commands.");
@@ -3037,6 +3041,18 @@ function generateMigratePrompt(results, config, detected) {
 	}
 	sections.push("## Migration tasks");
 	sections.push("");
+	if (config.releaseStrategy === "simple" && !detected.hasCommitAndTagVersion) {
+		sections.push("### Add commit-and-tag-version to devDependencies");
+		sections.push("");
+		sections.push("The `simple` release strategy requires `commit-and-tag-version` as a root devDependency so that `pnpm exec commit-and-tag-version` resolves correctly.");
+		sections.push("");
+		sections.push("Run:");
+		sections.push("");
+		sections.push("```sh");
+		sections.push("pnpm add -D -w commit-and-tag-version");
+		sections.push("```");
+		sections.push("");
+	}
 	if (config.releaseStrategy !== "none" && !detected.hasRepositoryField) {
 		sections.push("### Add repository field to package.json");
 		sections.push("");
@@ -4804,7 +4820,7 @@ const dockerCheckCommand = defineCommand({
 const main = defineCommand({
 	meta: {
 		name: "bst",
-		version: "0.27.1",
+		version: "0.28.0",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -4820,7 +4836,7 @@ const main = defineCommand({
 		"docker:check": dockerCheckCommand
 	}
 });
-console.log(`@bensandee/tooling v0.27.1`);
+console.log(`@bensandee/tooling v0.28.0`);
 async function run() {
 	await runMain(main);
 	process.exit(process.exitCode ?? 0);

package/dist/index.d.mts

@@ -100,6 +100,8 @@ interface DetectedProjectState {
   hasChangesetsConfig: boolean;
   /** Whether package.json has a repository field (needed for release workflows) */
   hasRepositoryField: boolean;
+  /** Whether commit-and-tag-version is in root devDependencies (required for simple release strategy) */
+  hasCommitAndTagVersion: boolean;
   /** Legacy tooling configs found */
   legacyConfigs: LegacyConfig[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "bst": "./dist/bin.mjs"