@casomoltd/tooling 0.20.4 → 0.21.0

package/README.md

@@ -29,16 +29,22 @@ Shared linting, formatting, commit config, and CLI tools for Casomo Ltd's repos.
 
 ## Install
 
-Consumed as a **git dependency** — it's shared config + CLI scripts,
-not a registry package. Add it to a consumer's `devDependencies`:
+Published to the public npm registry. Add it to a consumer's
+`devDependencies`:
+
+```
+npm i -D @casomoltd/tooling
+```
 
 ```json
-"@casomoltd/tooling": "github:casomoltd/tooling#semver:^0.10.0"
+"@casomoltd/tooling": "^0.20.0"
 ```
 
-The repo is public, so installs need no token. The `files` allowlist
-plus the `verify-pack` leak-gate keep the installed surface to
-configs/CLI only.
+The package is public, so installs need no token or `.npmrc`. The `files`
+allowlist plus the `verify-pack` leak-gate keep the published surface to
+configs/CLI only. `puppeteer` (used by the `screenshot` bin) is an
+**optional peer dependency** — add it yourself (`npm i -D puppeteer`) in
+repos that run `screenshot`.
 
 ## Husky hooks
 
@@ -201,6 +207,7 @@ decision table) that keeps these units composing without overlap.
 | `/casomoltd:screenshot` | Capture and analyse a dev server page |
 | `/casomoltd:design-pass` | Map → review → refactor a package (drives `design-xray` + `code-review`) |
 | `/casomoltd:draft-design-spec` | Author a browser-reviewable HTML design spec from a brief and iterate on it before writing code (drives `design-xray`) |
+| `/casomoltd:page-design` | Structure a content/explainer page for trust — above-the-fold answer, disclosure, palette-only colour (rubric a page-design reviewer preloads) |
 
 Enable the plugin by adding this repo as a marketplace and installing it:
 
@@ -275,7 +282,11 @@ only and on explicit request; the agents never do it.
 
 ## Package distribution
 
-The product libraries (`@casomoltd/paye-calc`, `@casomoltd/nhs-pay`)
-publish to the public npm registry via OIDC trusted publishing — install
-with no auth or `.npmrc`. `@casomoltd/tooling` is **not** published; it's
-consumed as a git dependency from this (public) repo.
+`@casomoltd/tooling`, alongside the product libraries
+(`@casomoltd/paye-calc`, `@casomoltd/nhs-pay`), publishes to the public
+npm registry via OIDC trusted publishing — install with no auth or
+`.npmrc`. A version-tag push (`npm version patch` → `git push
+--follow-tags`) triggers `publish.yml`. That workflow currently pins
+`npm@11.9.0`: npm 12.0.0 shipped regressions (disabled git-protocol deps,
+a broken provenance/sigstore path, and a stricter `npm ci`) — revert to
+`npm@latest` once a 12.x fixes them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@casomoltd/tooling",
-  "version": "0.20.4",
+  "version": "0.21.0",
   "description": "Casomo's shared dev config: ESLint, Prettier, commitlint, knip & jscpd presets and dev CLIs (git hooks, readability, screenshots)",
   "license": "MIT",
   "repository": {