- Convert all hardcoded versions to dynamic loading from VERSION file
- Reduce version update locations from 50+ to just 3 files
- Add proper fallback handling for version reading
- Update all CLI commands to use dynamic __version__
- Streamline future version management process
This change makes version bumping much simpler - only need to update:
1. VERSION file
2. package.json
3. pyproject.toml
- Check for updates on startup (once per 24h)
- Show update banner when new version available
- Support --no-update-check and --auto-update flags
- Add SUPERCLAUDE_AUTO_UPDATE environment variable
- Implement for both Python (PyPI) and Node.js (NPM)
* ✨ 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>
- Added required YAML frontmatter with name, description, category, and tools
- Updated header from "Socratic Mentor Agent" to "Socratic Mentor" for consistency
- Ensures compliance with agent template standards in contributing guidelines
* ✨ 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>
---------
Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
- Highlight complete documentation rework with real examples
- Emphasize practical workflows and better navigation
- Encourage community feedback on documentation quality
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Updated all documentation references
- Updated all Python module versions
- Updated configuration and metadata files
- Synchronized version across entire codebase
- Added automatic detection of PEP 668 environments
- Implemented pipx as preferred installation method for Linux/macOS
- Added fallback to pip --user for externally managed environments
- Improved error messages with clear installation alternatives
- Added --break-system-packages as last resort option
- Updated NPM wrapper to handle all installation scenarios
- Enhanced update mechanism to detect and use correct tool
- Updated all documentation to use @bifrost_inc/superclaude
- Fixed installation commands in README and docs
- Updated release instructions with correct NPM package name
- Cleaned up temporary package files
- Update all remaining version references to 4.0.3
- Fix documentation files (SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md)
- Update PUBLISHING.md version references and examples
- Fix all component metadata versions (mcp, modes, mcp_docs)
- Update setup/data/features.json versions
- Fix SuperClaude __main__.py version strings
- Update all documentation command examples
- Standardize version across 15+ files
All components now consistently at v4.0.3 for dual PyPI/NPM release.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Update PyPI version from 4.0.0 to 4.0.3
- Align all version references (Python, NPM, documentation)
- Update VERSION file, pyproject.toml, and all __init__.py files
- Update CHANGELOG and README version badges
- Fix all version references in RELEASE_INSTRUCTIONS.md
This ensures consistency between PyPI and NPM packages.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix version consistency (PyPI: 4.0.0, NPM: 4.0.3)
- Update license format to PEP 639 compliance
- Restore NPM package components (bin/ and package.json)
- Fix NPM package name to @superclaude-org/superclaude
- Add comprehensive RELEASE_INSTRUCTIONS.md
- Update .gitignore to include NPM files
- Ready for production release on both PyPI and NPM
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix directory structure in technical-architecture.md to match actual ~/.claude/ structure
- Correct session management documentation to show true persistent memory via Serena MCP
- Add comprehensive flags documentation with 40+ missing command-specific flags
- Remove verification status sections across all documentation
- Fix component counts: 14 agents, 5 modes, 21 commands
- Update gitignore to exclude CRUSH.md and TODO.txt personal files
- Standardize documentation structure and remove fictional content
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Standardize documentation structure across all sections
- Fix CLI confusion and streamline user guidance
- Remove fictional content and align with actual functionality
- Improve technical architecture documentation
- Update installation and quick-start guides
- Enhance reference materials and examples
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Critical Framework Accuracy Fixes
### Remove Non-Existent Error Codes
- **Deleted E001-E008 error code table** from commands.md
- These error codes never existed in SuperClaude Framework
- SuperClaude is instruction-based, not code-based, so cannot generate error codes
### Fix Non-Existent Commands
- **Fixed `SuperClaude status --mcp`** references in commands.md
- This command doesn't exist - replaced with actual working commands
- Updated validation steps to use real installation verification
### Correct Error Handling Documentation
- **Reframed fictional error classes** in technical-architecture.md
- Replaced `ComponentInstallationError`, `AgentCoordinationError` with conceptual issues
- Clarified that SuperClaude operates through instruction files, not runtime exceptions
- Converted exception examples to conceptual issue categories
## Why This Matters
SuperClaude Framework enhances Claude Code through behavioral instruction files (.md files).
Since it doesn't execute code (except Python installation), it cannot generate runtime
errors or error codes. This fix ensures documentation accurately reflects the framework's
instruction-based nature.
## Files Updated
- `User-Guide/commands.md`: Removed error code table and fixed command references
- `Developer-Guide/technical-architecture.md`: Converted fictional error handling to conceptual issues
## Result
Documentation now accurately represents SuperClaude as a behavioral enhancement framework
rather than incorrectly presenting it as a traditional error-generating application.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Major Platform-Specific Improvements
### Windows Path Standardization
- **Fixed forward slash issues**: All Windows paths now use proper backslashes
- **Standardized path variables**: Consistent use of %USERPROFILE% instead of mixed %USERNAME%
- **Proper error path examples**: Fixed error messages to show correct Windows paths
### Shell Command Organization
- **Clear platform separation**: Added distinct Linux/macOS vs Windows sections
- **Proper language tags**: bash for Unix, cmd for Windows Command Prompt, powershell for PowerShell
- **Platform headers**: Clear "Linux/macOS" and "Windows" labels for all command blocks
### Cross-Platform Command Coverage
- **Diagnostic commands**: Both platforms now have equivalent diagnostic procedures
- **Recovery procedures**: Platform-specific backup/restore operations
- **Installation fixes**: Proper installation commands for both environments
## Files Updated
- `Reference/common-issues.md`: Platform-specific quick fixes with proper shell tags
- `Reference/troubleshooting.md`: Comprehensive cross-platform diagnostic procedures
## Technical Details
- Windows commands use proper path syntax (backslashes, %USERPROFILE%)
- Unix commands maintained with proper forward slash paths
- All code blocks properly tagged with language identifiers
- Platform-specific alternatives provided for all major operations
This resolves platform-specific issues identified in documentation review and ensures
consistent user experience across Windows, Linux, and macOS environments.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
