@howells/husky 0.2.0 → 0.2.1

package/README.md

@@ -33,7 +33,7 @@ Runs `pnpm lint-staged` — formats staged files with the configured Howells for
 
 ### Pre-push
 
-Runs `pnpm typecheck` and `pnpm lint`. Both must pass before code reaches the remote.
+Runs the project's `pnpm prepush` script when one exists, so each repository can define the narrowest appropriate gate for its own architecture. Projects without that script retain the backward-compatible `pnpm typecheck` followed by `pnpm lint` fallback. The selected gate must pass before code reaches the remote.
 
 Both run against the **working directory**, so their result only describes what is being pushed when the working directory is what is being pushed. Git names the refs on stdin, so the hook can tell:
 
@@ -58,8 +58,9 @@ What changed is that it is no longer silent. If an install replaces a hook whose
 
 Your `package.json` must have:
 
-- `"typecheck"` script (e.g. `tsc --noEmit` or `turbo run typecheck`)
-- `"lint"` script (e.g. `howells-lint` or `turbo run lint`)
+- a `"prepush"` script appropriate to the repository, or both:
+  - a `"typecheck"` script (e.g. `tsc --noEmit` or `turbo run typecheck`)
+  - a `"lint"` script (e.g. `howells-lint` or `turbo run lint`)
 - `"lint-staged"` config using `howells-fix` (`howells-ox-fix` and `howells-format` still accepted, legacy)
 
 ## Why a package?

package/bin/howells-husky.mjs

@@ -38,7 +38,11 @@ const packageRoot = path.resolve(scriptDir, "..");
 const projectRoot = process.cwd();
 
 // Skip in CI environments — hooks aren't needed there
-if (process.env.CI === "true" || process.env.VERCEL === "1") {
+if (
+  process.env.HUSKY === "0" ||
+  process.env.CI === "true" ||
+  process.env.VERCEL === "1"
+) {
   process.exit(0);
 }
 
@@ -138,16 +142,17 @@ if (existsSync(packageJsonPath)) {
     }
   }
 
-  // Check that typecheck and lint scripts exist
+  // Projects can own an appropriately scoped pre-push gate. Older projects
+  // retain the package's typecheck + lint fallback until they add one.
   const scripts = packageJson.scripts || {};
-  if (!scripts.typecheck) {
+  if (!scripts.prepush && !scripts.typecheck) {
     console.warn(
-      '[@howells/husky] Warning: no "typecheck" script found. Pre-push hook requires it.'
+      '[@howells/husky] Warning: no "prepush" or "typecheck" script found. Pre-push hook requires one.'
     );
   }
-  if (!scripts.lint) {
+  if (!scripts.prepush && !scripts.lint) {
     console.warn(
-      '[@howells/husky] Warning: no "lint" script found. Pre-push hook requires it.'
+      '[@howells/husky] Warning: no "prepush" or "lint" script found. Pre-push hook requires one.'
     );
   }
 }

package/hooks/pre-push

@@ -54,5 +54,9 @@ if [ "$saw_ref" = "0" ]; then
   echo "[@howells/husky] No refs on stdin; checking the working directory."
 fi
 
-pnpm typecheck || exit 1
-pnpm lint || exit 1
+if node -e 'const scripts = require("./package.json").scripts; process.exit(typeof scripts?.prepush === "string" ? 0 : 1)'; then
+  pnpm prepush
+else
+  pnpm typecheck || exit 1
+  pnpm lint || exit 1
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/husky",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Standardised git hooks for Howells projects. Immutable pre-commit and pre-push configuration.",
   "license": "MIT",
   "repository": {
@@ -21,12 +21,6 @@
   "exports": {
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "lint": "howells-check --config=oxlint.config.ts package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
-    "lint:fix": "howells-fix --config=oxlint.config.ts package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
-    "format": "howells-oxfmt --write package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
-    "test": "node --test bin/detect.test.mjs bin/pre-push.test.mjs"
-  },
   "dependencies": {
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0"
@@ -37,5 +31,10 @@
   "engines": {
     "node": ">=24.15.0"
   },
-  "packageManager": "pnpm@11.11.0"
-}
+  "scripts": {
+    "lint": "howells-check --config=oxlint.config.ts package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
+    "lint:fix": "howells-fix --config=oxlint.config.ts package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
+    "format": "howells-oxfmt --write package.json bin hooks README.md oxlint.config.ts oxfmt.config.ts",
+    "test": "node --test bin/detect.test.mjs bin/pre-push.test.mjs"
+  }
+}