@howells/husky 0.2.0 → 0.2.2

package/README.md

@@ -23,6 +23,8 @@ In `package.json`:
 }
 ```
 
+Standard external lint-staged configuration files are supported as an alternative to the inline `package.json` entry. Use one when path-aware or computed commands are needed.
+
 That's it. On `pnpm install`, the hooks are installed automatically.
 
 ## What it does
@@ -33,7 +35,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,9 +60,10 @@ 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`)
-- `"lint-staged"` config using `howells-fix` (`howells-ox-fix` and `howells-format` still accepted, legacy)
+- 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`)
+- inline or standard external lint-staged configuration; static inline commands use `howells-fix` (`howells-ox-fix` and `howells-format` remain accepted for projects mid-migration)
 
 ## Why a package?
 

package/bin/detect.mjs

@@ -16,6 +16,27 @@ export const lintStagedFormatterCommands = [
 
 export const recommendedLintStagedCommand = "howells-fix";
 
+// Standard configuration names supported by lint-staged. Package-level files
+// in a monorepo are discovered by lint-staged itself; the installer only needs
+// to recognise the root configuration it is responsible for validating.
+export const lintStagedConfigFileNames = [
+  ".lintstagedrc",
+  ".lintstagedrc.json",
+  ".lintstagedrc.yaml",
+  ".lintstagedrc.yml",
+  ".lintstagedrc.js",
+  ".lintstagedrc.mjs",
+  ".lintstagedrc.cjs",
+  "lint-staged.config.js",
+  "lint-staged.config.mjs",
+  "lint-staged.config.cjs",
+  "lint-staged.config.ts",
+];
+
+export function findLintStagedConfigFile(exists) {
+  return lintStagedConfigFileNames.find((file) => exists(file));
+}
+
 /**
  * Flatten a lint-staged config object into the list of command strings it runs.
  * Values may be a single command string or an array of them.

package/bin/howells-husky.mjs

@@ -27,6 +27,7 @@ import path from "node:path";
 
 import {
   fallbackFailed,
+  findLintStagedConfigFile,
   lintStagedCommandValues,
   recommendedLintStagedCommand,
   shouldUseNpxFallback,
@@ -38,7 +39,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);
 }
 
@@ -113,17 +118,21 @@ for (const hook of hooks) {
 const packageJsonPath = path.join(projectRoot, "package.json");
 if (existsSync(packageJsonPath)) {
   const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+  const externalLintStagedConfig = findLintStagedConfigFile((file) =>
+    existsSync(path.join(projectRoot, file))
+  );
 
-  if (!packageJson["lint-staged"]) {
+  if (!packageJson["lint-staged"] && !externalLintStagedConfig) {
     console.warn(
-      '[@howells/husky] Warning: no "lint-staged" config found in package.json.'
+      "[@howells/husky] Warning: no inline or external lint-staged config found."
     );
     console.warn(
       `  Add: "lint-staged": { "*.{js,ts,jsx,tsx,json,jsonc,css}": "${recommendedLintStagedCommand}" }`
     );
   }
 
-  // Check that the lint-staged command uses a supported Howells formatter.
+  // Inline static configs can be checked directly. External JavaScript configs
+  // may compute commands dynamically, so lint-staged owns their validation.
   const lsConfig = packageJson["lint-staged"];
   if (lsConfig) {
     const commands = lintStagedCommandValues(lsConfig);
@@ -138,16 +147,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.2",
   "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"
+  }
+}