stylelint-plugin-rhythmguard 1.5.0 → 1.6.1

package/CHANGELOG.md

@@ -6,6 +6,22 @@ The format follows Keep a Changelog principles and semantic versioning.
 
 ## [Unreleased]
 
+## [1.6.1] - 2026-05-23
+
+### Fixed
+
+- Added `rhythmguard audit --ignore` for pruning root-relative paths before scanning large repositories.
+- Scoped audit traversal to scan-relevant CSS and template files instead of collecting every file under the audit root first.
+- Added default audit skips for common generated directories such as `.svelte-kit`, `.turbo`, and `.vercel`.
+
+## [1.6.0] - 2026-05-19
+
+### Added
+
+- `rhythmguard audit` now reports design-system drift across CSS declarations and Tailwind arbitrary spacing class strings.
+- Added `--format markdown` / `--markdown` audit output for PR-ready design-system health reports.
+- Audit JSON now includes format version, CSS findings, Tailwind class-string findings, scan counts, top affected files, and summary totals while preserving existing top-level count fields.
+
 ## [1.4.2] - 2026-02-21
 
 ### Changed

package/README.md

@@ -77,6 +77,35 @@ This gives you spacing governance in both CSS files and JSX/TSX templates.
 
 I built Rhythmguard after 20 years of watching teams ignore spacing scales and ship arbitrary pixel values everywhere.
 
+## Try It in Your Browser
+
+**[petrilahdelma.github.io/stylelint-plugin-rhythmguard](https://petrilahdelma.github.io/stylelint-plugin-rhythmguard/)** — paste CSS, see violations and token opportunities live. No install, no config.
+
+## Audit Before You Enforce
+
+Use the audit CLI to create a design-system drift report before turning rules into hard CI gates:
+
+```bash
+npx rhythmguard audit ./src
+npx rhythmguard audit ./src --format markdown
+npx rhythmguard audit ./src --json
+npx rhythmguard audit . --ignore "apps/legacy/**" --ignore "vendor/**"
+```
+
+The report covers authored CSS declarations and Tailwind arbitrary spacing values in common template/source files. Scan paths are scoped to the directory argument, and `--ignore` accepts repeatable, root-relative glob patterns for large generated or legacy subtrees. Markdown output is PR-ready for UX developers, UX designers, and design-system owners:
+
+```md
+# Rhythmguard Design-System Audit
+
+| Metric | Value |
+| --- | ---: |
+| CSS files scanned | 47 |
+| Template files scanned | 83 |
+| Files with issues | 12 |
+| Total findings | 52 |
+| Scale cleanliness | 91% |
+```
+
 ## Installation
 
 ```bash
@@ -180,6 +209,7 @@ Framework-specific setup for Vue, Lit, Astro, and SvelteKit: [`docs/FRAMEWORKS.m
 ## Comparison and Migration Recipes
 
 - Side-by-side tool fit guide with migration snippets: [`docs/COMPARISON.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/COMPARISON.md)
+- Audit 2.0 validation and roadmap: [`docs/AUDIT_2_VALIDATION.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/AUDIT_2_VALIDATION.md)
 - Real-world before/after excerpts from public repos: [`docs/ADOPTION_DIFFS.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/ADOPTION_DIFFS.md)
 - Distribution submissions to Stylelint discovery surfaces: [`docs/DISTRIBUTION.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/DISTRIBUTION.md)
 
@@ -502,13 +532,13 @@ The `tailwind` config preset automatically extracts spacing tokens from Tailwind
 
 See [`docs/TAILWIND.md`](https://github.com/PetriLahdelma/stylelint-plugin-rhythmguard/blob/main/docs/TAILWIND.md) for full setup.
 
-### What Rhythmguard does not cover
+### What the Stylelint layer does not cover
 
 - Tailwind class strings in templates/JSX/TSX, for example:
   - `class="p-4 gap-2"`
   - `class="p-[13px] translate-y-[18px]"`
 
-Those are not Stylelint declaration nodes, so they are outside Stylelint rule scope.
+Those are not Stylelint declaration nodes, so they are outside Stylelint rule scope. Use the ESLint companion rule below for scale-aware class-string enforcement.
 
 ### Companion ESLint layer for class strings
 
@@ -562,7 +592,7 @@ Suggested setup:
 Then pair with:
 
 - `stylelint-plugin-rhythmguard/eslint` for arbitrary spacing class-string scale enforcement.
-- `eslint-plugin-tailwindcss` for broader class-string linting and conventions.
+- `eslint-plugin-tailwindcss` for broader class-string linting and conventions. If your policy is to ban every arbitrary value, enable its `tailwindcss/no-arbitrary-value` rule; use Rhythmguard when you want spacing-specific scale checks and nearest-value fixes.
 - `prettier-plugin-tailwindcss` for deterministic class ordering.
 
 Detailed setup reference: [`docs/TAILWIND.md`](https://github.com/PetriLahdelma/stylelint-plugin-rhythmguard/blob/main/docs/TAILWIND.md).
@@ -658,8 +688,6 @@ Detailed methodology and custom args are documented in [`docs/BENCHMARKING.md`](
 ## Article
 
 - Dev.to: [Enforcing your spacing standards with Rhythmguard](https://dev.to/petrilahdelma/enforcing-your-spacing-standards-with-rhythmguard-a-custom-stylelint-plugin-1ojj)
-- Original article update note (Feb 21, 2026): [`docs/DEVTO_ORIGINAL_UPDATE_NOTE_2026-02-21.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/DEVTO_ORIGINAL_UPDATE_NOTE_2026-02-21.md)
-- Continuation draft (ready to publish): [`docs/DEVTO_CONTINUATION_2026-02-21.md`](https://github.com/petrilahdelma/stylelint-plugin-rhythmguard/blob/main/docs/DEVTO_CONTINUATION_2026-02-21.md)
 
 ## Used by and Community Examples
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "stylelint-plugin-rhythmguard",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Token governance for CSS and Tailwind — enforce spacing scales, require design tokens, catch arbitrary values",
   "bin": {
-    "rhythmguard": "./src/cli/index.js"
+    "rhythmguard": "src/cli/index.js"
   },
   "keywords": [
     "stylelint",
@@ -99,7 +99,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/petrilahdelma/stylelint-plugin-rhythmguard.git"
+    "url": "https://github.com/PetriLahdelma/stylelint-plugin-rhythmguard"
   },
   "homepage": "https://github.com/petrilahdelma/stylelint-plugin-rhythmguard#readme",
   "bugs": {