ai-rulez 4.19.0 → 4.20.1

package/README.md

@@ -241,6 +241,13 @@ command = "npx"
 args = ["-y", "ai-rulez@latest", "mcp"]
 ```
 
+Or let `generate` add it for you. With `[mcp] self_server = true` the entry is merged into the project `.mcp.json`, pinned to the running ai-rulez version, without touching hand-authored servers or `.claude/settings.json`:
+
+```toml
+[mcp]
+self_server = true
+```
+
 ## Installation
 
 No install needed — `npx ai-rulez@latest <command>` works out of the box. Pick a permanent option below:
@@ -309,7 +316,7 @@ Add to `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/Goldziher/ai-rulez
-    rev: v4.19.0
+    rev: v4.20.1
     hooks:
       - id: ai-rulez-recursive # generate outputs across the repo
       - id: ai-rulez-validate # dry-run validation
@@ -330,7 +337,7 @@ repository needs. This requires AI-Rulez 4.9.0+ and Poly 0.14.0+:
 [[hooks.sources]]
 id = "ai-rulez"
 git = "https://github.com/Goldziher/ai-rulez.git"
-revision = "v4.19.0"
+revision = "v4.20.1"
 hooks = ["ai-rulez-recursive", "ai-rulez-plugin-verify"]
 ```
 
@@ -364,6 +371,9 @@ pre-commit:
       run: ai-rulez generate --recursive
 ```
 
+In a monorepo, `ai-rulez generate --recursive` and `ai-rulez validate --recursive` (`-r`) process every nested
+`.ai-rulez/` root, report all failures, and exit non-zero if any root failed.
+
 Or run `ai-rulez init --setup-hooks` while initializing a repo to wire hooks in automatically.
 </details>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-rulez",
-  "version": "4.19.0",
+  "version": "4.20.1",
   "description": "Complete AI development workflow for 14 AI coding tools. Ships with builtin rules, agents, and conventions. Generate native configs for Claude, Cursor, Copilot, Windsurf, Gemini, Codex and more from a single source.",
   "keywords": [
     "agents",