mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
refactor: consolidate PM Agent optimization and pending changes
PM Agent optimization (already committed separately): - superclaude/commands/pm.md: 1652→14 lines - superclaude/agents/pm-agent.md: 735→429 lines - docs/agents/pm-agent-guide.md: new guide file Other pending changes: - setup: framework_docs, mcp, logger, remove ui.py - superclaude: __main__, cli/app, cli/commands/install - tests: test_ui updates - scripts: workflow metrics analysis tools - docs/memory: session state updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kazuki
@@ -1,340 +1,13 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
SuperClaude Framework Management Hub
|
||||
Unified entry point for all SuperClaude operations
|
||||
Entry point when running as: python -m superclaude
|
||||
|
||||
Usage:
|
||||
SuperClaude install [options]
|
||||
SuperClaude update [options]
|
||||
SuperClaude uninstall [options]
|
||||
SuperClaude backup [options]
|
||||
SuperClaude --help
|
||||
This module delegates to the modern typer-based CLI.
|
||||
"""
|
||||
|
||||
import sys
|
||||
import argparse
|
||||
import subprocess
|
||||
import difflib
|
||||
from pathlib import Path
|
||||
from typing import Dict, Callable
|
||||
from superclaude.cli.app import cli_main
|
||||
|
||||
# Add the local 'setup' directory to the Python import path
|
||||
current_dir = Path(__file__).parent
|
||||
project_root = current_dir.parent
|
||||
setup_dir = project_root / "setup"
|
||||
|
||||
# Insert the setup directory at the beginning of sys.path
|
||||
if setup_dir.exists():
|
||||
sys.path.insert(0, str(setup_dir.parent))
|
||||
else:
|
||||
print(f"Warning: Setup directory not found at {setup_dir}")
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
# Try to import utilities from the setup package
|
||||
try:
|
||||
from setup.utils.ui import (
|
||||
display_header,
|
||||
display_info,
|
||||
display_success,
|
||||
display_error,
|
||||
display_warning,
|
||||
Colors,
|
||||
display_authors,
|
||||
)
|
||||
from setup.utils.logger import setup_logging, get_logger, LogLevel
|
||||
from setup import DEFAULT_INSTALL_DIR
|
||||
except ImportError:
|
||||
# Provide minimal fallback functions and constants if imports fail
|
||||
class Colors:
|
||||
RED = YELLOW = GREEN = CYAN = RESET = ""
|
||||
|
||||
def display_error(msg):
|
||||
print(f"[ERROR] {msg}")
|
||||
|
||||
def display_warning(msg):
|
||||
print(f"[WARN] {msg}")
|
||||
|
||||
def display_success(msg):
|
||||
print(f"[OK] {msg}")
|
||||
|
||||
def display_info(msg):
|
||||
print(f"[INFO] {msg}")
|
||||
|
||||
def display_header(title, subtitle):
|
||||
print(f"{title} - {subtitle}")
|
||||
|
||||
def get_logger():
|
||||
return None
|
||||
|
||||
def setup_logging(*args, **kwargs):
|
||||
pass
|
||||
|
||||
class LogLevel:
|
||||
ERROR = 40
|
||||
INFO = 20
|
||||
DEBUG = 10
|
||||
|
||||
|
||||
def create_global_parser() -> argparse.ArgumentParser:
|
||||
"""Create shared parser for global flags used by all commands"""
|
||||
global_parser = argparse.ArgumentParser(add_help=False)
|
||||
|
||||
global_parser.add_argument(
|
||||
"--verbose", "-v", action="store_true", help="Enable verbose logging"
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--quiet", "-q", action="store_true", help="Suppress all output except errors"
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--install-dir",
|
||||
type=Path,
|
||||
default=DEFAULT_INSTALL_DIR,
|
||||
help=f"Target installation directory (default: {DEFAULT_INSTALL_DIR})",
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--dry-run",
|
||||
action="store_true",
|
||||
help="Simulate operation without making changes",
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--force", action="store_true", help="Force execution, skipping checks"
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--yes",
|
||||
"-y",
|
||||
action="store_true",
|
||||
help="Automatically answer yes to all prompts",
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--no-update-check", action="store_true", help="Skip checking for updates"
|
||||
)
|
||||
global_parser.add_argument(
|
||||
"--auto-update",
|
||||
action="store_true",
|
||||
help="Automatically install updates without prompting",
|
||||
)
|
||||
|
||||
return global_parser
|
||||
|
||||
|
||||
def create_parser():
|
||||
"""Create the main CLI parser and attach subcommand parsers"""
|
||||
global_parser = create_global_parser()
|
||||
|
||||
parser = argparse.ArgumentParser(
|
||||
prog="SuperClaude",
|
||||
description="SuperClaude Framework Management Hub - Unified CLI",
|
||||
epilog="""
|
||||
Examples:
|
||||
SuperClaude install --dry-run
|
||||
SuperClaude update --verbose
|
||||
SuperClaude backup --create
|
||||
""",
|
||||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||||
parents=[global_parser],
|
||||
)
|
||||
|
||||
from superclaude import __version__
|
||||
|
||||
parser.add_argument(
|
||||
"--version", action="version", version=f"SuperClaude {__version__}"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--authors", action="store_true", help="Show author information and exit"
|
||||
)
|
||||
|
||||
subparsers = parser.add_subparsers(
|
||||
dest="operation",
|
||||
title="Operations",
|
||||
description="Framework operations to perform",
|
||||
)
|
||||
|
||||
return parser, subparsers, global_parser
|
||||
|
||||
|
||||
def setup_global_environment(args: argparse.Namespace):
|
||||
"""Set up logging and shared runtime environment based on args"""
|
||||
# Determine log level
|
||||
if args.quiet:
|
||||
level = LogLevel.ERROR
|
||||
elif args.verbose:
|
||||
level = LogLevel.DEBUG
|
||||
else:
|
||||
level = LogLevel.INFO
|
||||
|
||||
# Define log directory unless it's a dry run
|
||||
log_dir = args.install_dir / "logs" if not args.dry_run else None
|
||||
setup_logging("superclaude_hub", log_dir=log_dir, console_level=level)
|
||||
|
||||
# Log startup context
|
||||
logger = get_logger()
|
||||
if logger:
|
||||
logger.debug(
|
||||
f"SuperClaude called with operation: {getattr(args, 'operation', 'None')}"
|
||||
)
|
||||
logger.debug(f"Arguments: {vars(args)}")
|
||||
|
||||
|
||||
def get_operation_modules() -> Dict[str, str]:
|
||||
"""Return supported operations and their descriptions"""
|
||||
return {
|
||||
"install": "Install SuperClaude framework components",
|
||||
"update": "Update existing SuperClaude installation",
|
||||
"uninstall": "Remove SuperClaude installation",
|
||||
"backup": "Backup and restore operations",
|
||||
}
|
||||
|
||||
|
||||
def load_operation_module(name: str):
|
||||
"""Try to dynamically import an operation module"""
|
||||
try:
|
||||
return __import__(f"setup.cli.commands.{name}", fromlist=[name])
|
||||
except ImportError as e:
|
||||
logger = get_logger()
|
||||
if logger:
|
||||
logger.error(f"Module '{name}' failed to load: {e}")
|
||||
return None
|
||||
|
||||
|
||||
def register_operation_parsers(subparsers, global_parser) -> Dict[str, Callable]:
|
||||
"""Register subcommand parsers and map operation names to their run functions"""
|
||||
operations = {}
|
||||
for name, desc in get_operation_modules().items():
|
||||
module = load_operation_module(name)
|
||||
if module and hasattr(module, "register_parser") and hasattr(module, "run"):
|
||||
module.register_parser(subparsers, global_parser)
|
||||
operations[name] = module.run
|
||||
else:
|
||||
# If module doesn't exist, register a stub parser and fallback to legacy
|
||||
parser = subparsers.add_parser(
|
||||
name, help=f"{desc} (legacy fallback)", parents=[global_parser]
|
||||
)
|
||||
parser.add_argument(
|
||||
"--legacy", action="store_true", help="Use legacy script"
|
||||
)
|
||||
operations[name] = None
|
||||
return operations
|
||||
|
||||
|
||||
def handle_legacy_fallback(op: str, args: argparse.Namespace) -> int:
|
||||
"""Run a legacy operation script if module is unavailable"""
|
||||
script_path = Path(__file__).parent / f"{op}.py"
|
||||
|
||||
if not script_path.exists():
|
||||
display_error(f"No module or legacy script found for operation '{op}'")
|
||||
return 1
|
||||
|
||||
display_warning(f"Falling back to legacy script for '{op}'...")
|
||||
|
||||
cmd = [sys.executable, str(script_path)]
|
||||
|
||||
# Convert args into CLI flags
|
||||
for k, v in vars(args).items():
|
||||
if k in ["operation", "install_dir"] or v in [None, False]:
|
||||
continue
|
||||
flag = f"--{k.replace('_', '-')}"
|
||||
if v is True:
|
||||
cmd.append(flag)
|
||||
else:
|
||||
cmd.extend([flag, str(v)])
|
||||
|
||||
try:
|
||||
return subprocess.call(cmd)
|
||||
except Exception as e:
|
||||
display_error(f"Legacy execution failed: {e}")
|
||||
return 1
|
||||
|
||||
|
||||
def main() -> int:
|
||||
"""Main entry point"""
|
||||
try:
|
||||
parser, subparsers, global_parser = create_parser()
|
||||
operations = register_operation_parsers(subparsers, global_parser)
|
||||
args = parser.parse_args()
|
||||
|
||||
# Handle --authors flag
|
||||
if args.authors:
|
||||
display_authors()
|
||||
return 0
|
||||
|
||||
# Check for updates unless disabled
|
||||
if not args.quiet and not getattr(args, "no_update_check", False):
|
||||
try:
|
||||
from setup.utils.updater import check_for_updates
|
||||
|
||||
# Check for updates in the background
|
||||
from superclaude import __version__
|
||||
|
||||
updated = check_for_updates(
|
||||
current_version=__version__,
|
||||
auto_update=getattr(args, "auto_update", False),
|
||||
)
|
||||
# If updated, suggest restart
|
||||
if updated:
|
||||
print(
|
||||
"\n🔄 SuperClaude was updated. Please restart to use the new version."
|
||||
)
|
||||
return 0
|
||||
except ImportError:
|
||||
# Updater module not available, skip silently
|
||||
pass
|
||||
except Exception:
|
||||
# Any other error, skip silently
|
||||
pass
|
||||
|
||||
# No operation provided? Show help manually unless in quiet mode
|
||||
if not args.operation:
|
||||
if not args.quiet:
|
||||
from superclaude import __version__
|
||||
|
||||
display_header(
|
||||
f"SuperClaude Framework v{__version__}",
|
||||
"Unified CLI for all operations",
|
||||
)
|
||||
print(f"{Colors.CYAN}Available operations:{Colors.RESET}")
|
||||
for op, desc in get_operation_modules().items():
|
||||
print(f" {op:<12} {desc}")
|
||||
return 0
|
||||
|
||||
# Handle unknown operations and suggest corrections
|
||||
if args.operation not in operations:
|
||||
close = difflib.get_close_matches(args.operation, operations.keys(), n=1)
|
||||
suggestion = f"Did you mean: {close[0]}?" if close else ""
|
||||
display_error(f"Unknown operation: '{args.operation}'. {suggestion}")
|
||||
return 1
|
||||
|
||||
# Setup global context (logging, install path, etc.)
|
||||
setup_global_environment(args)
|
||||
logger = get_logger()
|
||||
|
||||
# Execute operation
|
||||
run_func = operations.get(args.operation)
|
||||
if run_func:
|
||||
if logger:
|
||||
logger.info(f"Executing operation: {args.operation}")
|
||||
return run_func(args)
|
||||
else:
|
||||
# Fallback to legacy script
|
||||
if logger:
|
||||
logger.warning(
|
||||
f"Module for '{args.operation}' missing, using legacy fallback"
|
||||
)
|
||||
return handle_legacy_fallback(args.operation, args)
|
||||
|
||||
except KeyboardInterrupt:
|
||||
print(f"\n{Colors.YELLOW}Operation cancelled by user{Colors.RESET}")
|
||||
return 130
|
||||
except Exception as e:
|
||||
try:
|
||||
logger = get_logger()
|
||||
if logger:
|
||||
logger.exception(f"Unhandled error: {e}")
|
||||
except:
|
||||
print(f"{Colors.RED}[ERROR] {e}{Colors.RESET}")
|
||||
return 1
|
||||
|
||||
|
||||
# Entrypoint guard
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
sys.exit(cli_main())
|
||||
|
||||
@@ -27,7 +27,7 @@ app.add_typer(config.app, name="config", help="Manage configuration")
|
||||
def version_callback(value: bool):
|
||||
"""Show version and exit"""
|
||||
if value:
|
||||
from setup.cli.base import __version__
|
||||
from superclaude import __version__
|
||||
console.print(f"[bold cyan]SuperClaude[/bold cyan] version [green]{__version__}[/green]")
|
||||
raise typer.Exit()
|
||||
|
||||
|
||||
@@ -11,7 +11,61 @@ from rich.progress import Progress, SpinnerColumn, TextColumn
|
||||
from superclaude.cli._console import console
|
||||
|
||||
# Create install command group
|
||||
app = typer.Typer(name="install", help="Install SuperClaude framework components")
|
||||
app = typer.Typer(
|
||||
name="install",
|
||||
help="Install SuperClaude framework components",
|
||||
no_args_is_help=False, # Allow running without subcommand
|
||||
)
|
||||
|
||||
|
||||
@app.callback(invoke_without_command=True)
|
||||
def install_callback(
|
||||
ctx: typer.Context,
|
||||
non_interactive: bool = typer.Option(
|
||||
False,
|
||||
"--non-interactive",
|
||||
"-y",
|
||||
help="Non-interactive installation with default configuration",
|
||||
),
|
||||
profile: Optional[str] = typer.Option(
|
||||
None,
|
||||
"--profile",
|
||||
help="Installation profile: api (with API keys), noapi (without), or custom",
|
||||
),
|
||||
install_dir: Path = typer.Option(
|
||||
Path.home() / ".claude",
|
||||
"--install-dir",
|
||||
help="Installation directory",
|
||||
),
|
||||
force: bool = typer.Option(
|
||||
False,
|
||||
"--force",
|
||||
help="Force reinstallation of existing components",
|
||||
),
|
||||
dry_run: bool = typer.Option(
|
||||
False,
|
||||
"--dry-run",
|
||||
help="Simulate installation without making changes",
|
||||
),
|
||||
verbose: bool = typer.Option(
|
||||
False,
|
||||
"--verbose",
|
||||
"-v",
|
||||
help="Verbose output with detailed logging",
|
||||
),
|
||||
):
|
||||
"""
|
||||
Install SuperClaude with all recommended components (default behavior)
|
||||
|
||||
Running `superclaude install` without a subcommand installs all components.
|
||||
Use `superclaude install components` for selective installation.
|
||||
"""
|
||||
# If a subcommand was invoked, don't run this
|
||||
if ctx.invoked_subcommand is not None:
|
||||
return
|
||||
|
||||
# Otherwise, run the full installation
|
||||
_run_installation(non_interactive, profile, install_dir, force, dry_run, verbose)
|
||||
|
||||
|
||||
@app.command("all")
|
||||
@@ -50,7 +104,7 @@ def install_all(
|
||||
),
|
||||
):
|
||||
"""
|
||||
Install SuperClaude with all recommended components
|
||||
Install SuperClaude with all recommended components (explicit command)
|
||||
|
||||
This command installs the complete SuperClaude framework including:
|
||||
- Core framework files and documentation
|
||||
@@ -59,6 +113,18 @@ def install_all(
|
||||
- Specialized agents (17 agents)
|
||||
- MCP server integrations (optional)
|
||||
"""
|
||||
_run_installation(non_interactive, profile, install_dir, force, dry_run, verbose)
|
||||
|
||||
|
||||
def _run_installation(
|
||||
non_interactive: bool,
|
||||
profile: Optional[str],
|
||||
install_dir: Path,
|
||||
force: bool,
|
||||
dry_run: bool,
|
||||
verbose: bool,
|
||||
):
|
||||
"""Shared installation logic"""
|
||||
# Display installation header
|
||||
console.print(
|
||||
Panel.fit(
|
||||
|
||||
Reference in New Issue
Block a user