SuperClaude/setup/cli/base.py

"""
SuperClaude CLI Base Module

Base class for all CLI operations providing common functionality
"""

from pathlib import Path

# Read version from VERSION file
try:
    __version__ = (Path(__file__).parent.parent.parent / "VERSION").read_text().strip()
except Exception:
    __version__ = "4.1.5"  # Fallback


def get_command_info():
    """Get information about available commands"""
    return {
        "install": {
            "name": "install",
            "description": "Install SuperClaude framework components",
            "module": "setup.cli.commands.install",
        },
        "update": {
            "name": "update",
            "description": "Update existing SuperClaude installation",
            "module": "setup.cli.commands.update",
        },
        "uninstall": {
            "name": "uninstall",
            "description": "Remove SuperClaude framework installation",
            "module": "setup.cli.commands.uninstall",
        },
        "backup": {
            "name": "backup",
            "description": "Backup and restore SuperClaude installations",
            "module": "setup.cli.commands.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