@howells/lint 0.1.3 → 0.1.4

package/README.md

@@ -6,6 +6,7 @@ The goal is not to invent a second lint philosophy. The goal is to:
 
 - pin a single `@biomejs/biome` version
 - pin a single `ultracite` version
+- pin a single `@manypkg/cli` version for monorepo consistency checks
 - give every consumer the same small preset matrix
 - discourage repo-local overrides unless the project has a genuinely unique constraint
 
@@ -60,12 +61,14 @@ Next.js app:
 
 ## Binaries
 
-Installers only need `@howells/lint` as a direct dependency. Use the package binaries instead of adding `@biomejs/biome` or `ultracite` separately:
+Installers only need `@howells/lint` as a direct dependency. Use the package binaries instead of adding `@biomejs/biome`, `ultracite`, or `@manypkg/cli` separately:
 
 - `howells-biome` proxies to the pinned Biome binary
 - `howells-ultracite` proxies to the pinned Ultracite binary
 - `howells-lint` defaults to `biome check .`
 - `howells-format` defaults to `biome check . --write`
+- `howells-workspace-check` defaults to `manypkg check`
+- `howells-workspace-fix` defaults to `manypkg fix`
 
 Example scripts:
 
@@ -78,6 +81,19 @@ Example scripts:
 }
 ```
 
+Monorepo root scripts should compose package linting with workspace validation:
+
+```json
+{
+  "scripts": {
+    "lint": "turbo run lint && howells-workspace-check",
+    "lint:fix": "turbo run lint:fix && howells-workspace-fix"
+  }
+}
+```
+
+CI should call `pnpm lint` or `pnpm check` so the workspace check is not bypassed by a direct `turbo lint` command.
+
 Prefer explicit script targets over config churn when the only difference is scope:
 
 ```json
@@ -97,6 +113,38 @@ Prefer explicit script targets over config churn when the only difference is sco
 - If a repo needs framework-specific linting, choose the matching preset instead of layering rules manually.
 - Prefer inline `biome-ignore` comments for truly isolated exceptions over broad config overrides.
 
+## Claude Code Hooks
+
+Add this to `.claude/settings.json` so files are formatted on edit and linted on session end:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -r '.tool_input.file_path' | { read file_path; case \"$file_path\" in *.js|*.ts|*.jsx|*.tsx|*.json|*.jsonc|*.css|*.graphql) howells-format \"$file_path\" 2>/dev/null || true ;; esac; }"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "git diff --name-only --diff-filter=d HEAD | grep -E '\\.(js|ts|jsx|tsx|json|jsonc|css|graphql)$' | xargs howells-format 2>/dev/null || true"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
 ## Upstream
 
 This package wraps:

package/bin/howells-workspace-check.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import { runManypkgCommand } from "./run-manypkg-command.mjs";
+
+const args = process.argv.slice(2);
+runManypkgCommand("check", args);

package/bin/howells-workspace-fix.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import { runManypkgCommand } from "./run-manypkg-command.mjs";
+
+const args = process.argv.slice(2);
+runManypkgCommand("fix", args);

package/bin/run-manypkg-command.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { createRequire } from "node:module";
+import { runPackageBin } from "./run-package-bin.mjs";
+
+const require = createRequire(import.meta.url);
+const helpOptions = new Set(["--help", "-h"]);
+const versionOptions = new Set(["--version", "-V"]);
+
+function printHelp(command) {
+	console.log(`Usage: howells-workspace-${command} [options]\n`);
+	console.log(`Runs: manypkg ${command} [options]`);
+}
+
+function printVersion() {
+	const { version } = require("@manypkg/cli/package.json");
+	console.log(version);
+}
+
+export function runManypkgCommand(command, args) {
+	if (helpOptions.has(args[0])) {
+		printHelp(command);
+		process.exit(0);
+	}
+
+	if (versionOptions.has(args[0])) {
+		printVersion();
+		process.exit(0);
+	}
+
+	runPackageBin("@manypkg/cli", "manypkg", [command, ...args]);
+}

package/package.json

@@ -1,28 +1,34 @@
 {
-  "name": "@howells/lint",
-  "version": "0.1.3",
-  "description": "Pinned Biome and Ultracite presets for Howells projects.",
-  "license": "MIT",
-  "files": [
-    "biome/*.json",
-    "bin/*.mjs",
-    "README.md",
-    "MIGRATIONS.md"
-  ],
-  "bin": {
-    "howells-biome": "bin/howells-biome.mjs",
-    "howells-lint": "bin/howells-lint.mjs",
-    "howells-format": "bin/howells-format.mjs",
-    "howells-ultracite": "bin/howells-ultracite.mjs"
-  },
-  "dependencies": {
-    "@biomejs/biome": "2.4.12",
-    "ultracite": "7.6.0"
-  },
-  "exports": {
-    "./package.json": "./package.json",
-    "./biome/core": "./biome/core.json",
-    "./biome/react": "./biome/react.json",
-    "./biome/next": "./biome/next.json"
-  }
+	"name": "@howells/lint",
+	"version": "0.1.4",
+	"description": "Pinned Biome and Ultracite presets for Howells projects.",
+	"license": "MIT",
+	"engines": {
+		"node": ">=20.19"
+	},
+	"files": [
+		"biome/*.json",
+		"bin/*.mjs",
+		"README.md",
+		"MIGRATIONS.md"
+	],
+	"bin": {
+		"howells-biome": "bin/howells-biome.mjs",
+		"howells-lint": "bin/howells-lint.mjs",
+		"howells-format": "bin/howells-format.mjs",
+		"howells-ultracite": "bin/howells-ultracite.mjs",
+		"howells-workspace-check": "bin/howells-workspace-check.mjs",
+		"howells-workspace-fix": "bin/howells-workspace-fix.mjs"
+	},
+	"dependencies": {
+		"@biomejs/biome": "2.4.12",
+		"@manypkg/cli": "^0.25.1",
+		"ultracite": "7.6.0"
+	},
+	"exports": {
+		"./package.json": "./package.json",
+		"./biome/core": "./biome/core.json",
+		"./biome/react": "./biome/react.json",
+		"./biome/next": "./biome/next.json"
+	}
 }