styleproof 2.5.0 → 3.0.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-06-27
+
+**Milestone: the committed-map gate is how StyleProof works now.** Capture runs
+**pre-push** (parallel, with auto-detected `@media` breakpoints), the lean computed-
+style map is committed and **pushed in a single `git push`**, and CI is a
+**browser-less diff** of two precomputed maps — measured ~5400× cheaper on the
+compare step, and it skips build + serve entirely. `styleproof-init` scaffolds **and
+activates** the whole gate in one command. Coverage stays **full and sound**: every
+surface is captured (parallelised) and what changed is determined by _measuring_ the
+map, never by guessing which pages a code change touched. **No breaking API changes**
+— existing specs and the classic capture-both-in-CI flow keep working unchanged; the
+major marks the new default paradigm.
+
+### Changed
+
+- **`styleproof-init` now activates the pre-push hook for you** (`git config
+core.hooksPath .githooks`), so a single `styleproof-init` is all it takes — no
+  follow-up command. It never clobbers a repo that already manages hooks: if
+  `core.hooksPath` is already set or a `.husky/` dir exists, it leaves them alone and
+  prints the one-liner instead.
+
 ## [2.5.0] - 2026-06-26
 
 ### Changed

package/bin/styleproof-init.mjs

@@ -20,6 +20,7 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import { discoverNextRoutes } from '../dist/index.js';
 
 const HELP = `styleproof-init — scaffold a styleproof capture spec
@@ -238,7 +239,8 @@ export default defineConfig({
 // always carries a base map and CI is a fast, browser-less diff of two precomputed
 // maps. The hook redirects capture into a committed `stylemaps/` dir and drops
 // screenshots via the STYLEPROOF_BASEDIR / STYLEPROOF_SCREENSHOTS env knobs.
-const HOOK_PATH = '.githooks/pre-push';
+const HOOK_DIR = '.githooks';
+const HOOK_PATH = `${HOOK_DIR}/pre-push`;
 const PREPUSH_HOOK = `#!/bin/sh
 # StyleProof pre-push hook (generated by styleproof-init).
 #
@@ -358,9 +360,33 @@ if (ci.wrote) {
   console.log(`${CI_PATH} already exists — left untouched`);
 }
 
+// Activate the hook so ONE `styleproof-init` is all it takes — but never clobber a
+// repo that already manages its hooks (husky, or an existing core.hooksPath); there
+// we leave it and print the one-liner instead.
+const git = (a) => spawnSync('git', a, { encoding: 'utf8' });
+const inGitRepo = git(['rev-parse', '--is-inside-work-tree']).status === 0;
+const existingHooksPath = inGitRepo ? git(['config', '--local', '--get', 'core.hooksPath']).stdout.trim() : '';
+const managesHooks = existingHooksPath !== '' || fs.existsSync('.husky');
+let hookActivated = false;
+if (inGitRepo && !managesHooks) {
+  if (git(['config', 'core.hooksPath', HOOK_DIR]).status === 0) {
+    hookActivated = true;
+    console.log(`activated the pre-push hook (core.hooksPath → ${HOOK_DIR})`);
+    wroteSomething = true;
+  }
+}
+
 console.log('\nHow the gate works — capture local, CI just diffs:');
-console.log('  1. Activate the pre-push hook (once per clone):');
-console.log('       git config core.hooksPath .githooks');
+if (hookActivated) {
+  console.log('  1. ✓ Pre-push hook is active — nothing to do.');
+} else if (managesHooks) {
+  console.log(`  1. Your repo already manages git hooks (${existingHooksPath || '.husky'}), so the hook`);
+  console.log(`     wasn't auto-activated. Point your hook runner at ${HOOK_DIR}/pre-push, or run:`);
+  console.log(`       git config core.hooksPath ${HOOK_DIR}`);
+} else {
+  console.log('  1. Activate the pre-push hook (once per clone):');
+  console.log(`       git config core.hooksPath ${HOOK_DIR}`);
+}
 console.log('  2. Push your branch. The hook captures the computed-style map against a');
 console.log('     PRODUCTION build, commits it (lean .json.gz under stylemaps/), and pushes it');
 console.log('     with your branch — one `git push`, never two.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "styleproof",
-  "version": "2.5.0",
+  "version": "3.0.0",
   "description": "Catch every CSS change before it ships — review PRs and certify refactors by the browser's computed styles, not pixels. Works with any styling system.",
   "keywords": [
     "playwright",