- Added complete list of all SuperClaude commands
- Organized commands by category for better navigation
- Included descriptions and usage examples for each command
- Improved formatting and readability
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-authored-by: Claude <noreply@anthropic.com>
After an extensive investigation, the command handling logic could not be found within this repository. The initial implementation of a dynamic help command was not possible. The user then requested that the command list be hardcoded into the `help.md` file.
This commit includes the following changes:
- Overwrote `SuperClaude/Commands/help.md` with a static, manually generated list of all commands and their descriptions.
- Updated `README.md` to reflect the new command count.
- Updated `Docs/User-Guide/commands.md` with comprehensive documentation for the new command.
This approach ensures that the `/sc:help` command provides a complete list of all available commands, at the cost of requiring manual updates when commands are added or removed in the future.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
The new `/sc:help` command is designed to list all available `/sc` commands, improving discoverability of the framework's features.
The following changes are included:
- Created `SuperClaude/Commands/help.md` with a detailed description of the command.
- Updated `README.md` to reflect the new command count and mention the `/sc:help` command.
- Updated `Docs/User-Guide/commands.md` with comprehensive documentation for the new command.
This commit only adds the command definition and documentation, as per the user's instructions. The implementation logic is handled by an external system and is not part of this repository.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com
Refactor MCP server installation logic to use 'uvx' mode
- Updated the MCPComponent to replace the 'install_command' with 'run_command' for the 'serena' server configuration.
- Renamed the installation method from `_install_uv_mcp_server` to `_install_uvx_mcp_server` to reflect the new command structure.
- Enhanced error handling and logging for the installation and registration processes.
- Adjusted the installation logic to accommodate the new command format and improve clarity.
This change streamlines the installation process for MCP servers and ensures compatibility with the updated command structure.
* Fix: Install only selected MCP servers and ensure valid empty backups
This commit addresses two separate issues:
1. **MCP Installation:** The `install` command was installing all MCP servers instead of only the ones selected by the user. The `_install` method in `setup/components/mcp.py` was iterating through all available servers, not the user's selection. This has been fixed to respect the `selected_mcp_servers` configuration. A new test has been added to verify this fix.
2. **Backup Creation:** The `create_backup` method in `setup/core/installer.py` created an invalid `.tar.gz` file when the backup source was empty. This has been fixed to ensure that a valid, empty tar archive is always created. A test was added for this as well.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* Fix: Correct installer validation for MCP and MCP Docs components
This commit fixes a validation issue in the installer where it would incorrectly fail after a partial installation of MCP servers.
The `MCPComponent` validation logic was checking for all "required" servers, regardless of whether they were selected by the user. This has been corrected to only validate the servers that were actually installed, by checking against the list of installed servers stored in the metadata. The metadata storage has also been fixed to only record the installed servers.
The `MCPDocsComponent` was failing validation because it was not being registered in the metadata if no documentation files were installed. This has been fixed by ensuring the post-installation hook runs even when no files are copied.
New tests have been added for both components to verify the corrected logic.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* Fix: Allow re-installation of components and correct validation logic
This commit fixes a bug that prevented new MCP servers from being installed on subsequent runs of the installer. It also fixes the validation logic that was causing failures after a partial installation.
The key changes are:
1. A new `is_reinstallable` method has been added to the base `Component` class. This allows certain components (like the `mcp` component) to be re-run even if they are already marked as installed.
2. The installer logic has been updated to respect this new method.
3. The `MCPComponent` now correctly stores only the installed servers in the metadata.
4. The validation logic for `MCPComponent` and `MCPDocsComponent` has been corrected to prevent incorrect failures.
New tests have been added to verify all aspects of the new logic.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Display authors in UI header and update author info
This commit implements the user's request to display author names and emails in the UI header of the installer.
The key changes are:
1. The `__email__` field in `SuperClaude/__init__.py` has been updated to include both authors' emails.
2. The `display_header` function in `setup/utils/ui.py` has been modified to read the author and email information and display it.
3. A new test has been added to `tests/test_ui.py` to verify the new UI output.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Version bump to 4.1.0 and various fixes
This commit prepares the project for the v4.1.0 release. It includes a version bump across all relevant files and incorporates several bug fixes and feature enhancements from recent tasks.
Key changes in this release:
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 in all configuration files, documentation, and source code.
- **Installer Fixes**:
- Components can now be marked as `reinstallable`, allowing them to be re-run on subsequent installations. This fixes a bug where new MCP servers could not be added.
- The validation logic for `mcp` and `mcp_docs` components has been corrected to avoid incorrect failures.
- A bug in the backup creation process that created invalid empty archives has been fixed.
- **UI Enhancements**:
- Author names and emails are now displayed in the installer UI header.
- **Metadata Updates**:
- Mithun Gowda B has been added as an author.
- **New Tests**:
- Comprehensive tests have been added for the installer logic, MCP components, and UI changes to ensure correctness and prevent regressions.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* fix: Resolve dependencies for partial installs and other fixes
This commit addresses several issues, the main one being a dependency resolution failure during partial installations.
Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree when a user requests to install a subset of components. This fixes the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run on subsequent installs, enabling the addition of new servers.
- **Validation Logic**: The validation for `mcp` and `mcp_docs` has been corrected to avoid spurious failures.
- **UI and Metadata**: Author information has been added to the UI header and source files.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Tests**: New tests have been added to cover all the above changes.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* fix: Installer fixes and version bump to 4.1.0
This commit includes a collection of fixes for the installer logic, UI enhancements, and a version bump to 4.1.0.
Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree for partial installations, fixing the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run to add new servers.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts the user to select servers.
- **Validation Logic**: The post-installation validation logic has been corrected to only validate components from the current session and to use the correct list of installed servers.
- **UI & Metadata**: Author information has been added to the UI and source files.
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 across all files.
- **Tests**: New tests have been added to cover all the bug fixes.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
* feat: Add --authors flag and multiple installer fixes
This commit introduces the `--authors` flag to display author information and includes a collection of fixes for the installer logic.
Key changes:
- **New Feature**: Added an `--authors` flag that displays the names, emails, and GitHub usernames of the project authors.
- **Dependency Resolution**: Fixed a critical bug where partial installations would fail due to unresolved dependencies.
- **Component Re-installation**: Added a mechanism to allow components to be "reinstallable", fixing an issue that prevented adding new MCP servers on subsequent runs.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts for server selection.
- **Validation Logic**: Corrected the post-installation validation to prevent spurious errors.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Metadata**: Author and GitHub information has been added to the source files.
- **UI**: The installer header now displays author information.
- **Tests**: Added new tests for all new features and bug fixes.
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
---------
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
---
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
