NomenAK e0917f33ab 🔧 Fix critical setup process issues and improve reliability
Major fixes for installation system robustness and version consistency:

**Critical Version Synchronization:**
- Update VERSION file from 4.0.0b1 to 4.0.0 for stable release
- Fix setup/__init__.py to read version from VERSION file dynamically
- Synchronize SuperClaude/__main__.py version reference to 4.0.0
- Establish single source of truth for version management

**NPM Package Naming Resolution:**
- Rename npm package from 'superclaude' to '@superclaude-org/superclaude'
- Resolve naming collision with unrelated GitHub workflow package
- Update package description for clarity and accurate branding
- Enable proper npm organization scoping

**Setup Process Reliability:**
- Fix backup system double extension bug in installer.py
- Improve component discovery error handling with structured logging
- Replace deprecated pkg_resources with modern importlib.resources
- Add comprehensive error handling to installation workflows
- Convert print statements to proper logging throughout codebase

**Error Handling & Logging:**
- Add logger integration to ComponentRegistry and Installer classes
- Enhance exception handling for component instantiation failures
- Improve backup creation error handling with rollback capability
- Standardize error reporting across installation system

**Import System Modernization:**
- Replace deprecated pkg_resources with importlib.resources (Python 3.9+)
- Add robust fallback chain for Python 3.8+ compatibility
- Improve module discovery reliability across different environments

These changes significantly improve installation success rates and eliminate
major pain points preventing successful SuperClaude deployment.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-17 00:30:02 +02:00
2025-08-16 16:20:25 +02:00
2025-08-16 10:01:54 +05:30
2025-08-16 08:07:04 +05:30

SuperClaude v4.0.0 🚀

Website Preview License: MIT PyPI version Version GitHub issues PRs Welcome Contributors Website

SuperClaude is a meta-programming configuration framework that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It enhances Claude Code with 21 slash commands, 13 specialized agents, 6 behavioral modes, and 6 MCP server integrations for systematic workflow automation.

Quick Start

# Via Python (recommended)
pip install SuperClaude && SuperClaude install

# Via NPM (cross-platform)
npm install -g superclaude && superclaude install

Support SuperClaude Development 💎

SuperClaude Framework development requires ongoing support to maintain MCP server integrations, expand the command system, and provide comprehensive documentation. Your support enables continuous improvement and new capabilities.

GitHub Sponsors

Documentation

Getting Started

User Guides

Developer Resources

Reference

Contributing

Current Priorities:

  • 📝 Documentation improvements and examples
  • 🔧 MCP server integrations and configurations
  • 🎯 Command workflow examples and patterns
  • 🧪 Testing and validation procedures
  • 🌐 Translation and internationalization

See CONTRIBUTING.md for detailed contribution guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributors: View all contributors

Description
A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.
Readme MIT 17 MiB
Languages
Python 75.2%
TypeScript 13.7%
Shell 9%
Makefile 2.1%