---
Description
Fix missing toml dependency in PyPI release workflow that was causing
version releases to be skipped. This addresses the documented
v4.0.8/v4.0.9 version
confusion where v4.0.8 was prepared but never actually released due to
workflow failure.
Root Cause: The publish-pypi.yml workflow imports toml for version
verification but doesn't install the package, causing
ModuleNotFoundError and release
failures.
Solution: Added toml to build dependencies installation step.
Type of Change
- Bug fix in context files
- New feature (agent, command, mode)
- Documentation improvement
- Installation system enhancement
Testing
- Manual testing with Claude Code
- Context file validation passes
- Examples validated in Claude Code conversations
Validation Results:
- ✅ Verified toml is imported and used in version verification script
(line 62)
- ✅ Confirmed toml is standard Python package available via pip
- ✅ Change is minimal (1 line) and follows existing patterns
- ✅ No breaking changes to workflow functionality
- ✅ Workflow will now have all required dependencies before execution
Checklist
- Files follow SuperClaude conventions
- Self-review completed
- Documentation updated
- No breaking changes to existing context
Additional Context
Problem Impact:
- Release workflow fails with ModuleNotFoundError: No module named
'toml'
- Causes versions to be skipped (v4.0.8 was never released)
- Creates confusion in version sequencing and changelogs
Files Changed:
- .github/workflows/publish-pypi.yml (1 insertion, 1 deletion)
Change Details:
- python -m pip install build twine
+ python -m pip install build twine toml
Benefits:
- Ensures reliable PyPI release workflow execution
- Prevents future version skipping issues
- Improves dependency management explicitness
- Zero breaking changes - purely additive fix
This fix ensures the SuperClaude Framework release process is reliable
and consistent, preventing the workflow failures that caused version
confusion.
---
- Add toml package to build dependencies in publish-pypi.yml
- Prevents ModuleNotFoundError during version verification
- Fixes root cause of v4.0.8 version skipping issue
- Ensures reliable PyPI release workflow execution
This change fixes several issues with the `update` command and the
installer:
- Corrects the `update` command logic in `setup/cli/commands/update.py`.
- Fixes the `update` logic in `setup/core/installer.py` to correctly
handle re-installation of components.
- Corrects the installation of MCP servers in `setup/components/mcp.py`.
This change fixes several issues with the `update` command and the installer:
- Corrects the `update` command logic in `setup/cli/commands/update.py`.
- Fixes the `update` logic in `setup/core/installer.py` to correctly handle re-installation of components.
- Corrects the installation of MCP servers in `setup/components/mcp.py`.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: jules <jules@users.noreply.github.com>
This change fixes several issues with the MCP component installation
process:
- Corrects the import path for the Component base class in
`setup/components/mcp.py`.
- Updates the hardcoded version number in the MCP component to use the
global `__version__`.
- Corrects the npm package name for the `morphllm-fast-apply` server.
- Implements a custom `uv`-based installation method for the `serena`
server.
- Increases timeouts for MCP server checks to prevent intermittent
failures.
This change fixes several issues with the MCP component installation process:
- Corrects the import path for the Component base class in `setup/components/mcp.py`.
- Updates the hardcoded version number in the MCP component to use the global `__version__`.
- Corrects the npm package name for the `morphllm-fast-apply` server.
- Implements a custom `uv`-based installation method for the `serena` server.
- Increases timeouts for MCP server checks to prevent intermittent failures.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: jules <jules@users.noreply.github.com>
* feat: Add comprehensive business panel analysis system
Implements /sc:business-panel command with 9 expert personas (Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont), three-phase adaptive methodology (Discussion/Debate/Socratic), intelligent mode selection, and cross-framework synthesis with business-specific symbol system.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
* docs: Update README and commands guide for business panel feature
- Update command count from 21 to 22 across all documentation
- Add Business Panel to behavioral modes (5 → 6 modes)
- Add /sc:business-panel to commands guide with full documentation
- Include expert panel details and usage examples
- Update command index and complexity classification
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: sarosh.quraishi@gmail.com
- Add README-zh.md with full Chinese translation
- Add README-ja.md with full Japanese translation
- Update README.md with professional language selector
- Add GitHub Actions workflow for README quality checks
- 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>
