85 lines
3.0 KiB
Python
Raw Normal View History

"""
SuperClaude Operations Module
This module contains all SuperClaude management operations that can be
executed through the unified CLI hub (SuperClaude.py).
Each operation module should implement:
- register_parser(subparsers): Register CLI arguments for the operation
- run(args): Execute the operation with parsed arguments
Available operations:
- install: Install SuperClaude framework components
- update: Update existing SuperClaude installation
- uninstall: Remove SuperClaude framework installation
- backup: Backup and restore SuperClaude installations
"""
__version__ = "3.0.0"
__all__ = ["install", "update", "uninstall", "backup"]
def get_operation_info():
"""Get information about available operations"""
return {
"install": {
"name": "install",
"description": "Install SuperClaude framework components",
"module": "setup.operations.install"
},
"update": {
"name": "update",
"description": "Update existing SuperClaude installation",
"module": "setup.operations.update"
},
"uninstall": {
"name": "uninstall",
"description": "Remove SuperClaude framework installation",
"module": "setup.operations.uninstall"
},
"backup": {
"name": "backup",
"description": "Backup and restore SuperClaude installations",
"module": "setup.operations.backup"
}
}
class OperationBase:
"""Base class for all operations providing common functionality"""
def __init__(self, operation_name: str):
self.operation_name = operation_name
self.logger = None
def setup_operation_logging(self, args):
"""Setup operation-specific logging"""
from ..utils.logger import get_logger
self.logger = get_logger()
self.logger.info(f"Starting {self.operation_name} operation")
def validate_global_args(self, args):
"""Validate global arguments common to all operations"""
errors = []
# Validate install directory
if hasattr(args, 'install_dir') and args.install_dir:
from ..utils.security import SecurityValidator
is_safe, validation_errors = SecurityValidator.validate_installation_target(args.install_dir)
if not is_safe:
errors.extend(validation_errors)
# Check for conflicting flags
if hasattr(args, 'verbose') and hasattr(args, 'quiet'):
if args.verbose and args.quiet:
errors.append("Cannot specify both --verbose and --quiet")
return len(errors) == 0, errors
def handle_operation_error(self, operation: str, error: Exception):
"""Standard error handling for operations"""
if self.logger:
self.logger.exception(f"Error in {operation} operation: {error}")
else:
print(f"Error in {operation} operation: {error}")
return 1