Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
"""
|
|
|
|
|
Modes component for SuperClaude behavioral modes
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
from typing import Dict, List, Tuple, Optional, Any
|
|
|
|
|
from pathlib import Path
|
|
|
|
|
|
2025-08-14 22:03:34 +02:00
|
|
|
from ..core.base import Component
|
|
|
|
|
from ..services.claude_md import CLAUDEMdService
|
Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
class ModesComponent(Component):
|
|
|
|
|
"""SuperClaude behavioral modes component"""
|
|
|
|
|
|
|
|
|
|
def __init__(self, install_dir: Optional[Path] = None):
|
|
|
|
|
"""Initialize modes component"""
|
2025-08-14 21:02:34 +02:00
|
|
|
super().__init__(install_dir, Path(""))
|
Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
|
|
|
|
|
def get_metadata(self) -> Dict[str, str]:
|
|
|
|
|
"""Get component metadata"""
|
|
|
|
|
return {
|
|
|
|
|
"name": "modes",
|
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>
2025-08-23 12:08:09 +02:00
|
|
|
"version": "4.0.6",
|
Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
"description": "SuperClaude behavioral modes (Brainstorming, Introspection, Task Management, Token Efficiency)",
|
|
|
|
|
"category": "modes"
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
def _install(self, config: Dict[str, Any]) -> bool:
|
|
|
|
|
"""Install modes component"""
|
|
|
|
|
self.logger.info("Installing SuperClaude behavioral modes...")
|
|
|
|
|
|
|
|
|
|
# Validate installation
|
|
|
|
|
success, errors = self.validate_prerequisites()
|
|
|
|
|
if not success:
|
|
|
|
|
for error in errors:
|
|
|
|
|
self.logger.error(error)
|
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
# Get files to install
|
|
|
|
|
files_to_install = self.get_files_to_install()
|
|
|
|
|
|
|
|
|
|
if not files_to_install:
|
|
|
|
|
self.logger.warning("No mode files found to install")
|
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
# Copy mode files
|
|
|
|
|
success_count = 0
|
|
|
|
|
for source, target in files_to_install:
|
|
|
|
|
self.logger.debug(f"Copying {source.name} to {target}")
|
|
|
|
|
|
|
|
|
|
if self.file_manager.copy_file(source, target):
|
|
|
|
|
success_count += 1
|
|
|
|
|
self.logger.debug(f"Successfully copied {source.name}")
|
|
|
|
|
else:
|
|
|
|
|
self.logger.error(f"Failed to copy {source.name}")
|
|
|
|
|
|
|
|
|
|
if success_count != len(files_to_install):
|
|
|
|
|
self.logger.error(f"Only {success_count}/{len(files_to_install)} mode files copied successfully")
|
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
self.logger.success(f"Modes component installed successfully ({success_count} mode files)")
|
|
|
|
|
|
|
|
|
|
return self._post_install()
|
|
|
|
|
|
|
|
|
|
def _post_install(self) -> bool:
|
|
|
|
|
"""Post-installation tasks"""
|
|
|
|
|
try:
|
|
|
|
|
# Update metadata
|
|
|
|
|
metadata_mods = {
|
|
|
|
|
"components": {
|
|
|
|
|
"modes": {
|
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>
2025-08-23 12:08:09 +02:00
|
|
|
"version": "4.0.6",
|
Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
"installed": True,
|
|
|
|
|
"files_count": len(self.component_files)
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
self.settings_manager.update_metadata(metadata_mods)
|
|
|
|
|
self.logger.info("Updated metadata with modes component registration")
|
|
|
|
|
|
2025-08-14 21:02:34 +02:00
|
|
|
# Update CLAUDE.md with mode imports
|
|
|
|
|
try:
|
2025-08-14 22:03:34 +02:00
|
|
|
manager = CLAUDEMdService(self.install_dir)
|
2025-08-14 21:02:34 +02:00
|
|
|
manager.add_imports(self.component_files, category="Behavioral Modes")
|
|
|
|
|
self.logger.info("Updated CLAUDE.md with mode imports")
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.warning(f"Failed to update CLAUDE.md with mode imports: {e}")
|
|
|
|
|
# Don't fail the whole installation for this
|
|
|
|
|
|
Implement two-stage installation with simplified MCP configuration
- Stage 1: MCP server selection (Context7, Sequential, Magic, Playwright, Serena, Morphllm)
- Stage 2: Framework components (Core, Modes, Commands, Agents, MCP Docs)
Major Changes:
- Created MCP config snippets in SuperClaude/MCP/configs/ for JSON-based configuration
- Simplified MCPComponent to modify .claude.json instead of npm/subprocess installation
- Added ModesComponent for behavioral modes (Brainstorming, Introspection, etc.)
- Added MCPDocsComponent for dynamic MCP documentation installation
- Completely removed Hooks component (deleted hooks.py, updated all references)
- Implemented two-stage interactive installation flow
- Updated profiles and configuration files
Benefits:
- Much simpler and more reliable MCP configuration
- Clear separation between server setup and documentation
- Auto-selection of MCP docs based on server choices
- User-friendly two-stage selection process
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 20:35:19 +02:00
|
|
|
return True
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.error(f"Failed to update metadata: {e}")
|
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
def uninstall(self) -> bool:
|
|
|
|
|
"""Uninstall modes component"""
|
|
|
|
|
try:
|
|
|
|
|
self.logger.info("Uninstalling SuperClaude modes component...")
|
|
|
|
|
|
|
|
|
|
# Remove mode files
|
|
|
|
|
removed_count = 0
|
|
|
|
|
for _, target in self.get_files_to_install():
|
|
|
|
|
if self.file_manager.remove_file(target):
|
|
|
|
|
removed_count += 1
|
|
|
|
|
self.logger.debug(f"Removed {target.name}")
|
|
|
|
|
|
|
|
|
|
# Remove modes directory if empty
|
|
|
|
|
try:
|
|
|
|
|
if self.install_component_subdir.exists():
|
|
|
|
|
remaining_files = list(self.install_component_subdir.iterdir())
|
|
|
|
|
if not remaining_files:
|
|
|
|
|
self.install_component_subdir.rmdir()
|
|
|
|
|
self.logger.debug("Removed empty modes directory")
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.warning(f"Could not remove modes directory: {e}")
|
|
|
|
|
|
|
|
|
|
# Update settings.json
|
|
|
|
|
try:
|
|
|
|
|
if self.settings_manager.is_component_installed("modes"):
|
|
|
|
|
self.settings_manager.remove_component_registration("modes")
|
|
|
|
|
self.logger.info("Removed modes component from settings.json")
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.warning(f"Could not update settings.json: {e}")
|
|
|
|
|
|
|
|
|
|
self.logger.success(f"Modes component uninstalled ({removed_count} files removed)")
|
|
|
|
|
return True
|
|
|
|
|
|
|
|
|
|
except Exception as e:
|
|
|
|
|
self.logger.exception(f"Unexpected error during modes uninstallation: {e}")
|
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
def get_dependencies(self) -> List[str]:
|
|
|
|
|
"""Get dependencies"""
|
|
|
|
|
return ["core"]
|
|
|
|
|
|
|
|
|
|
def _get_source_dir(self) -> Optional[Path]:
|
|
|
|
|
"""Get source directory for mode files"""
|
|
|
|
|
# Assume we're in SuperClaude/setup/components/modes.py
|
|
|
|
|
# and mode files are in SuperClaude/SuperClaude/Modes/
|
|
|
|
|
project_root = Path(__file__).parent.parent.parent
|
|
|
|
|
modes_dir = project_root / "SuperClaude" / "Modes"
|
|
|
|
|
|
|
|
|
|
# Return None if directory doesn't exist to prevent warning
|
|
|
|
|
if not modes_dir.exists():
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
return modes_dir
|
|
|
|
|
|
|
|
|
|
def get_size_estimate(self) -> int:
|
|
|
|
|
"""Get estimated installation size"""
|
|
|
|
|
source_dir = self._get_source_dir()
|
|
|
|
|
total_size = 0
|
|
|
|
|
|
|
|
|
|
if source_dir and source_dir.exists():
|
|
|
|
|
for filename in self.component_files:
|
|
|
|
|
file_path = source_dir / filename
|
|
|
|
|
if file_path.exists():
|
|
|
|
|
total_size += file_path.stat().st_size
|
|
|
|
|
|
|
|
|
|
# Minimum size estimate
|
|
|
|
|
total_size = max(total_size, 20480) # At least 20KB
|
|
|
|
|
|
|
|
|
|
return total_size
|