Fix component validation and bump version to 4.0.6 (#292)

* ✨ Enhance documentation with advanced markdown formatting

Major improvements to documentation presentation and usability:

README.md:
- Added centered hero section with framework statistics dashboard
- Created visual support section with donation cards
- Enhanced What's New section with feature grid layout
- Reorganized documentation links into categorized table
- Added professional badges and visual separators

installation.md:
- Centered title with platform badges and quick navigation
- Consolidated 4 installation methods into unified table
- Created visual requirement cards (Required vs Optional)
- Added collapsible troubleshooting sections
- Removed 3 duplicate "What's Next" sections
- Enhanced learning journey with progression tables

quick-start.md:
- Added visual framework architecture flow diagram
- Created component statistics dashboard (21|14|6|6)
- Built comparison table for SuperClaude vs Standard Claude
- Added 4-week learning timeline with milestones
- Enhanced workflow patterns with step-by-step tables
- Created key insights cards explaining framework philosophy

All documents now feature consistent styling with centered titles,
organized tables, emojis for visual scanning, and improved navigation.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* 🔥 Remove outdated publishing and release instruction files

Cleaned up repository by removing:
- PUBLISHING.md: Outdated publishing guidelines
- RELEASE_INSTRUCTIONS.md: Old release process documentation

These files are no longer needed as the project has evolved
and the processes have been streamlined or moved elsewhere.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* 🐛 Fix component validation to check metadata file instead of settings.json

Resolves #291 - Validation errors after V4 upgrade

## Changes
- Fixed validation logic to check .superclaude-metadata.json instead of settings.json
- Standardized all component versions to 4.0.4 across the framework
- Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
- Cleaned up metadata file structure for consistency

## Technical Details
The issue was caused by components registering in .superclaude-metadata.json but
validation checking settings.json for component registration. This mismatch caused
false validation errors even though components were properly installed.

## Testing
All components now validate successfully with the corrected logic.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* 🔖 Bump version to 4.0.6 across entire project

## Summary
Comprehensive version update from 4.0.4 to 4.0.6 with validation fixes

## Changes
- Updated VERSION file, pyproject.toml, and package.json
- Updated all Python __version__ declarations (8 occurrences)
- Updated all component metadata versions (6 components, 25+ occurrences)
- Updated documentation and README version badges (11 files)
- Fixed package.json inconsistency (was 4.0.5)
- Updated legacy backup.py version reference (was 3.0.0)
- Added CHANGELOG entry for version 4.0.6

## Files Modified (26 total)
- Core: VERSION, pyproject.toml, package.json
- Python: SuperClaude/__init__.py, __main__.py, setup/__init__.py, cli/base.py
- Components: core.py, commands.py, agents.py, mcp.py, mcp_docs.py, modes.py
- Docs: README.md, CONTRIBUTING.md, SECURITY.md, installation.md, quick-start.md
- Config: features.json, backup.py, update.py
- User: ~/.claude/.superclaude-metadata.json

## Verification
All version references now consistently show 4.0.6
Historical references in CHANGELOG preserved as intended

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* 📝 Update README.md installation instructions

---------

Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>

Docs/Getting-Started/installation.md

@@ -5,7 +5,7 @@
 ### **Transform Claude Code with 21 Commands, 14 Agents & 6 MCP Servers**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.0.4-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/version-4.0.6-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Python-3.8+-green?style=for-the-badge" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Linux%20|%20macOS%20|%20Windows-orange?style=for-the-badge" alt="Platform">
 </p>
@@ -266,7 +266,7 @@ SuperClaude install --dry-run
 ```bash
 # Verify SuperClaude version
 python3 -m SuperClaude --version
-# Expected: SuperClaude 4.0.4
+# Expected: SuperClaude 4.0.6
 
 # List installed components
 SuperClaude install --list-components

Docs/Getting-Started/quick-start.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/Framework-Context_Engineering-purple?style=for-the-badge" alt="Framework">
-  <img src="https://img.shields.io/badge/Version-4.0.4-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/Version-4.0.6-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Time_to_Start-5_Minutes-green?style=for-the-badge" alt="Quick Start">
 </p>
 
@@ -486,7 +486,7 @@ Create custom workflows
 </p>
 
 <p align="center">
-  <sub>SuperClaude v4.0.4 - Context Engineering for Claude Code</sub>
+  <sub>SuperClaude v4.0.6 - Context Engineering for Claude Code</sub>
 </p>
 
 </div>

Docs/Reference/common-issues.md

@@ -13,7 +13,7 @@ Test: /sc:brainstorm "test" should ask questions
 
 ### 2. Installation Verification
 ```bash
-python3 -m SuperClaude --version    # Should show 4.0.4
+python3 -m SuperClaude --version    # Should show 4.0.6
 
 # If not working:
 # For pipx users
@@ -71,7 +71,7 @@ pip3 install SuperClaude
 ```
 
 ## Verification Checklist
-- [ ] `python3 -m SuperClaude --version` returns 4.0.4
+- [ ] `python3 -m SuperClaude --version` returns 4.0.6
 - [ ] `/sc:brainstorm "test"` works in Claude Code
 - [ ] `SuperClaude install --list-components` shows components
 

Docs/Reference/troubleshooting.md

@@ -6,7 +6,7 @@ Quick fixes to advanced diagnostics for SuperClaude Framework issues.
 
 **Installation Verification:**
 ```bash
-python3 -m SuperClaude --version    # Should show 4.0.4
+python3 -m SuperClaude --version    # Should show 4.0.6
 SuperClaude install --list-components
 ```
 
@@ -19,7 +19,7 @@ SuperClaude install --list-components
 ```
 
 **Resolution Checklist:**
-- [ ] Version commands work and show 4.0.4
+- [ ] Version commands work and show 4.0.6
 - [ ] `/sc:` commands respond in Claude Code  
 - [ ] MCP servers listed: `SuperClaude install --list-components | grep mcp`
 

Docs/User-Guide/commands.md

@@ -67,7 +67,7 @@ SuperClaude provides behavioral context files that Claude Code reads to adopt sp
 ```bash
 # Verify SuperClaude is working (primary method)
 python3 -m SuperClaude --version
-# Example output: SuperClaude 4.0.4
+# Example output: SuperClaude 4.0.6
 
 # Claude Code CLI version check
 claude --version