omgkit 2.21.0 → 2.21.2

package/README.md

@@ -681,9 +681,41 @@ omgkit help         # Show help
 
 ---
 
+## Documentation Sync Automation
+
+OMGKIT uses a **self-healing documentation system** that ensures docs are always synchronized with code:
+
+### How It Works
+
+1. **Code is Single Source of Truth**: All component metadata lives in plugin files
+2. **Auto-Discovery**: Categories and counts are discovered dynamically, not hardcoded
+3. **Auto-Generation**: mint.json navigation is generated from docs structure
+4. **Validation Tests**: 23 tests verify docs-plugin sync before every release
+
+### Documentation Commands
+
+```bash
+npm run docs:generate   # Generate docs from plugin source
+npm run docs:mint       # Generate mint.json navigation
+npm run docs:validate   # Run docs sync validation tests
+npm run docs:sync       # Generate + validate (recommended)
+```
+
+### Pre-Release Protection
+
+The `preversion` hook automatically runs `docs:sync` before version bumps:
+
+```bash
+npm version patch       # Runs docs:sync automatically
+```
+
+If any sync issue is detected (missing pages, wrong counts, broken links), the version bump fails.
+
+---
+
 ## Validation & Testing
 
-OMGKIT has 5600+ automated tests ensuring system integrity.
+OMGKIT has 5700+ automated tests ensuring system integrity.
 
 ### Run Tests
 
@@ -691,6 +723,7 @@ OMGKIT has 5600+ automated tests ensuring system integrity.
 npm test                           # All tests
 npm test -- tests/validation/      # Validation tests only
 npm test -- tests/unit/            # Unit tests only
+npm run test:docs                  # Documentation sync tests
 ```
 
 ### Test Categories
@@ -700,6 +733,7 @@ npm test -- tests/unit/            # Unit tests only
 | Registry Sync | ~200 | Verify registry matches files |
 | Alignment | ~400 | Component hierarchy validation |
 | Documentation | ~500 | Quality and format checks |
+| Docs Sync | 23 | Plugin-to-docs mapping validation |
 | Format | ~300 | Naming convention compliance |
 | Dependency Graph | ~600 | Reference integrity |
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "omgkit",
-  "version": "2.21.0",
-  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 33 agents, 113 commands, 128 skills, 49 workflows.",
+  "version": "2.21.2",
+  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 41 agents, 144 commands, 145 skills, 61 workflows.",
   "keywords": [
     "claude-code",
     "ai",
@@ -43,10 +43,17 @@
     "test:unit": "vitest run tests/unit",
     "test:validation": "vitest run tests/validation",
     "test:integration": "vitest run tests/integration",
+    "test:docs": "vitest run tests/validation/docs-sync.test.js",
     "lint": "eslint .",
     "docs:generate": "node scripts/generate-docs.js",
+    "docs:mint": "node scripts/generate-mint-json.js",
+    "docs:validate": "npm run test:docs",
+    "docs:sync": "npm run docs:generate && npm run docs:validate",
     "docs:dev": "cd docs && mintlify dev",
-    "docs:build": "npm run docs:generate"
+    "docs:build": "npm run docs:generate",
+    "preversion": "npm run docs:sync && npm test",
+    "version": "node -e \"const fs=require('fs');const r=require('./plugin/registry.yaml','utf8');\" || true",
+    "postversion": "echo 'Version bumped. Run: git push && npm publish'"
   },
   "engines": {
     "node": ">=18.0.0"

package/plugin/registry.yaml

@@ -3,7 +3,7 @@
 # Version: 2.21.0
 # Updated: 2026-01-02
 
-version: "2.21.0"
+version: "2.21.1"
 
 # =============================================================================
 # OPTIMIZED ALIGNMENT PRINCIPLE (OAP)