@softspark/ai-toolkit 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -7,6 +7,14 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v2.3.1 — Release Quality Gate (2026-04-14)
+
+### Fixed
+- **README "What's New" section** — was stuck at v2.1.3, now auto-validated by `validate.py --strict`
+- **Release SOP** — added mandatory "Update README What's New" step to Phase 3 checklist
+
+---
+
 ## v2.3.0 — Jira MCP Template & Cross-Editor Sync (2026-04-14)
 
 ### Added

package/README.md

@@ -10,12 +10,13 @@
 
 ---
 
-## What's New in v2.1.3
+## What's New in v2.3.1
 
-- **Idempotent update** — `ai-toolkit update` no longer dirties git with extra blank lines in generated files
-- **Custom rules in generators** — `generate:all` preserves registered rules from other repos across all platforms
-- **README restructured** — 951 → 292 lines with TOC, links to KB docs
-- **3 new KB docs** — CLI Reference, Unique Features, Ecosystem Comparison
+- **URL rule registration** — `ai-toolkit add-rule https://...` with auto-refresh on every update
+- **Jira MCP template** — `ai-toolkit mcp add jira` with `postInstall` setup hints
+- **MCP template tracking** — globally installed templates saved in `state.json`, auto-synced on `update`
+- **Race condition fix** — parallel project updates no longer drop registry entries (fcntl.flock + atomic writes)
+- **Claude MCP paths fixed** — now uses `~/.claude.json` (global) and `.mcp.json` (project) per official docs
 
 See [CHANGELOG.md](CHANGELOG.md) for full history.
 

package/app/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-toolkit",
   "description": "Professional-grade Claude Code toolkit with persona presets, skill security auditor, expanded lifecycle hooks, experimental opt-in plugin packs, benchmark harvesting, and multi-tool support.",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "author": {
     "name": "SoftSpark",
     "url": "https://github.com/softspark"

package/kb/procedures/release-preparation-sop.md

@@ -157,6 +157,18 @@ Add entry at the top of `CHANGELOG.md` (after the header, before previous releas
 - Date format: `YYYY-MM-DD`
 - Title: short, descriptive, no version number repetition
 
+### Update README "What's New" section
+
+**MANDATORY on every release.** Update the `## What's New in vX.Y.Z` section in `README.md`:
+
+1. Change the heading version: `## What's New in vX.Y.Z`
+2. Replace bullet points with 3-5 highlights from this release
+3. Keep the `See [CHANGELOG.md](CHANGELOG.md) for full history.` link
+
+> **Warning:** This section is the first thing users see after the badges.
+> A stale version here (e.g., "What's New in v2.1.3" when shipping v2.3.0)
+> signals an unmaintained project. Do NOT skip this step.
+
 ---
 
 ## Phase 4: Regenerate Artifacts

package/llms-full.txt

@@ -3669,6 +3669,18 @@ Add entry at the top of `CHANGELOG.md` (after the header, before previous releas
 - Date format: `YYYY-MM-DD`
 - Title: short, descriptive, no version number repetition
 
+### Update README "What's New" section
+
+**MANDATORY on every release.** Update the `## What's New in vX.Y.Z` section in `README.md`:
+
+1. Change the heading version: `## What's New in vX.Y.Z`
+2. Replace bullet points with 3-5 highlights from this release
+3. Keep the `See [CHANGELOG.md](CHANGELOG.md) for full history.` link
+
+> **Warning:** This section is the first thing users see after the badges.
+> A stale version here (e.g., "What's New in v2.1.3" when shipping v2.3.0)
+> signals an unmaintained project. Do NOT skip this step.
+
 ---
 
 ## Phase 4: Regenerate Artifacts

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.3.0",
+  "version": "2.3.1",
   "components": {
     "agents": {
       "description": "44 specialized agents (orchestrator, backend, frontend, security, devops, etc.)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/ai-toolkit",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Professional-grade AI coding toolkit: 92 skills, 44 agents, multi-platform support (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Google Antigravity, Codex CLI), machine-enforced safety constitution, persona presets, skill security auditor, expanded lifecycle hooks, 11 plugin packs, and benchmark tooling.",
   "keywords": [
     "claude",

package/scripts/validate.py

@@ -646,6 +646,23 @@ def _validate_version_sync(tk_dir: Path, vr: ValidationResult) -> None:
         detail = ", ".join(f"{k}={v}" for k, v in versions.items())
         vr.error(f"Version mismatch across files: {detail}")
 
+    # Check README "What's New" section matches current version
+    pkg_version = versions.get("package.json", "")
+    if pkg_version:
+        readme = tk_dir / "README.md"
+        if readme.is_file():
+            content = readme.read_text(encoding="utf-8")
+            m = re.search(r"## What's New in v([\d.]+)", content)
+            if m:
+                whats_new_ver = m.group(1)
+                if whats_new_ver == pkg_version:
+                    print(f"  OK: README \"What's New\" (v{whats_new_ver})")
+                else:
+                    vr.error(
+                        f"README \"What's New in v{whats_new_ver}\" "
+                        f"is stale (package.json is v{pkg_version})"
+                    )
+
 
 def validate_content_quality(tk_dir: Path, vr: ValidationResult) -> None:
     """Check content quality: name matches directory, non-empty body."""