@oorabona/release-it-preset 0.5.2 → 0.6.0

package/README.md

@@ -308,9 +308,9 @@ Retries npm/GitHub publishing for an existing tag without modifying git history;
 **CLI:**
 ```bash
 # Step 1: Run pre-flight checks (optional)
-node node_modules/@oorabona/release-it-preset/dist/scripts/retry-publish.js
-# or during local development (TypeScript sources):
-pnpm tsx scripts/retry-publish.ts
+pnpm release-it-preset retry-publish-preflight
+# Advanced (direct compiled call)
+# node node_modules/@oorabona/release-it-preset/dist/scripts/retry-publish.js
 
 # Step 2: Retry the publish
 pnpm release-it-preset retry-publish
@@ -428,6 +428,26 @@ pnpm release-it-preset check
 
 Useful for debugging release issues.
 
+#### `check-pr` - Pull Request Hygiene
+
+Evaluates PR readiness by analysing commits and changelog changes. Designed for CI usage but safe locally when the required environment variables are set (`PR_BASE_REF`, `PR_HEAD_REF`).
+
+```bash
+PR_BASE_REF=origin/main PR_HEAD_REF=HEAD pnpm release-it-preset check-pr
+```
+
+Outputs JSON summaries for workflows (base64 encoded) and prints a human-readable report.
+
+#### `retry-publish-preflight` - Retry Safety Checks
+
+Runs the retry publish pre-flight script with the same CLI convenience wrapper as other utilities. Verifies that the latest tag exists, matches `package.json`, and that there are no unexpected workspace changes before attempting a retry.
+
+```bash
+pnpm release-it-preset retry-publish-preflight
+```
+
+Use this before calling `pnpm release-it-preset retry-publish` when recovering from a failed publish.
+
 ### pnpm Script Shortcuts
 
 The root `package.json` defines helper scripts that wrap the CLI so you can run the most common flows with `pnpm run`:
@@ -439,6 +459,7 @@ The root `package.json` defines helper scripts that wrap the CLI so you can run
 - `pnpm run release:manual-changelog` → release with manually edited changelog (skip auto-generation)
 - `pnpm run release:hotfix` → execute the hotfix workflow
 - `pnpm run release:republish` → trigger the republish workflow (dangerous flow)
+- `pnpm run release:retry-preflight` → run retry publish safety checks
 - `pnpm run release:retry-publish` → retry npm/GitHub publishing for an existing tag
 - `pnpm run release:update` → populate the `[Unreleased]` section
 - `pnpm run release:validate` → run release validation checks
@@ -498,12 +519,10 @@ node node_modules/@oorabona/release-it-preset/dist/scripts/republish-changelog.j
 Performs pre-flight checks before retrying a failed publish.
 
 ```bash
-# Preferred
-pnpm run release:retry-publish
-# or
-pnpm release-it-preset retry-publish
+# Preferred (CLI)
+pnpm release-it-preset retry-publish-preflight
 
-# Advanced
+# Advanced (call compiled output directly)
 node node_modules/@oorabona/release-it-preset/dist/scripts/retry-publish.js
 ```
 

package/bin/cli.js

@@ -19,6 +19,8 @@
  *   release-it-preset update
  *   release-it-preset validate [--allow-dirty]
  *   release-it-preset check
+ *   release-it-preset check-pr
+ *   release-it-preset retry-publish-preflight
  */
 
 import { spawn } from 'node:child_process';
@@ -44,6 +46,8 @@ const UTILITY_COMMANDS = {
   update: 'populate-unreleased-changelog',
   validate: 'validate-release',
   check: 'check-config',
+  'check-pr': 'check-pr-status',
+  'retry-publish-preflight': 'retry-publish',
 };
 
 function showHelp() {
@@ -64,6 +68,8 @@ Utility Commands:
   update                 Update [Unreleased] section from commits
   validate [--allow-dirty]  Validate project is ready for release
   check                  Display configuration and project status
+  check-pr               Evaluate PR hygiene (branch diff, changelog status, conventions)
+  retry-publish-preflight  Run retry publish safety checks without executing release
 
 Examples:
   # Release commands
@@ -76,6 +82,8 @@ Examples:
   release-it-preset update
   release-it-preset validate
   release-it-preset check
+  release-it-preset check-pr
+  release-it-preset retry-publish-preflight
 
 For release-it options, see: https://github.com/release-it/release-it
 For environment variables, see: https://github.com/oorabona/release-it-preset#environment-variables

package/config/retry-publish.js

@@ -10,7 +10,7 @@
  * Usage:
  * First run the retry script to checkout the tag:
  * ```bash
- * node node_modules/@oorabona/release-it-preset/dist/scripts/retry-publish.js
+ * pnpm release-it-preset retry-publish-preflight
  * pnpm release-it --config node_modules/@oorabona/release-it-preset/config/retry-publish.js
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oorabona/release-it-preset",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Shared release-it configuration and scripts for the organisation",
   "type": "module",
   "keywords": [
@@ -55,6 +55,7 @@
     "release:manual-changelog": "node ./bin/cli.js manual-changelog",
     "release:hotfix": "node ./bin/cli.js hotfix",
     "release:republish": "node ./bin/cli.js republish",
+    "release:retry-preflight": "node ./bin/cli.js retry-publish-preflight",
     "release:retry-publish": "node ./bin/cli.js retry-publish",
     "release:update": "node ./bin/cli.js update",
     "release:validate": "node ./bin/cli.js validate",
@@ -78,7 +79,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.5",
-    "@types/node": "^22.10.5",
+    "@types/node": "^24.6.2",
     "@vitest/coverage-v8": "^3.2.4",
     "nano-staged": "^0.8.0",
     "rimraf": "^6.0.1",