mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
refactor: PM Agent complete independence from external MCP servers (#439)
* refactor: PM Agent complete independence from external MCP servers ## Summary Implement graceful degradation to ensure PM Agent operates fully without any MCP server dependencies. MCP servers now serve as optional enhancements rather than required components. ## Changes ### Responsibility Separation (NEW) - **PM Agent**: Development workflow orchestration (PDCA cycle, task management) - **mindbase**: Memory management (long-term, freshness, error learning) - **Built-in memory**: Session-internal context (volatile) ### 3-Layer Memory Architecture with Fallbacks 1. **Built-in Memory** [OPTIONAL]: Session context via MCP memory server 2. **mindbase** [OPTIONAL]: Long-term semantic search via airis-mcp-gateway 3. **Local Files** [ALWAYS]: Core functionality in docs/memory/ ### Graceful Degradation Implementation - All MCP operations marked with [ALWAYS] or [OPTIONAL] - Explicit IF/ELSE fallback logic for every MCP call - Dual storage: Always write to local files + optionally to mindbase - Smart lookup: Semantic search (if available) → Text search (always works) ### Key Fallback Strategies **Session Start**: - mindbase available: search_conversations() for semantic context - mindbase unavailable: Grep docs/memory/*.jsonl for text-based lookup **Error Detection**: - mindbase available: Semantic search for similar past errors - mindbase unavailable: Grep docs/mistakes/ + solutions_learned.jsonl **Knowledge Capture**: - Always: echo >> docs/memory/patterns_learned.jsonl (persistent) - Optional: mindbase.store() for semantic search enhancement ## Benefits - ✅ Zero external dependencies (100% functionality without MCP) - ✅ Enhanced capabilities when MCPs available (semantic search, freshness) - ✅ No functionality loss, only reduced search intelligence - ✅ Transparent degradation (no error messages, automatic fallback) ## Related Research - Serena MCP investigation: Exposes tools (not resources), memory = markdown files - mindbase superiority: PostgreSQL + pgvector > Serena memory features - Best practices alignment: /Users/kazuki/github/airis-mcp-gateway/docs/mcp-best-practices.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * chore: add PR template and pre-commit config - Add structured PR template with Git workflow checklist - Add pre-commit hooks for secret detection and Conventional Commits - Enforce code quality gates (YAML/JSON/Markdown lint, shellcheck) NOTE: Execute pre-commit inside Docker container to avoid host pollution: docker compose exec workspace uv tool install pre-commit docker compose exec workspace pre-commit run --all-files 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: update PM Agent context with token efficiency architecture - Add Layer 0 Bootstrap (150 tokens, 95% reduction) - Document Intent Classification System (5 complexity levels) - Add Progressive Loading strategy (5-layer) - Document mindbase integration incentive (38% savings) - Update with 2025-10-17 redesign details * refactor: PM Agent command with progressive loading - Replace auto-loading with User Request First philosophy - Add 5-layer progressive context loading - Implement intent classification system - Add workflow metrics collection (.jsonl) - Document graceful degradation strategy * fix: installer improvements Update installer logic for better reliability * docs: add comprehensive development documentation - Add architecture overview - Add PM Agent improvements analysis - Add parallel execution architecture - Add CLI install improvements - Add code style guide - Add project overview - Add install process analysis * docs: add research documentation Add LLM agent token efficiency research and analysis * docs: add suggested commands reference * docs: add session logs and testing documentation - Add session analysis logs - Add testing documentation * feat: migrate CLI to typer + rich for modern UX ## What Changed ### New CLI Architecture (typer + rich) - Created `superclaude/cli/` module with modern typer-based CLI - Replaced custom UI utilities with rich native features - Added type-safe command structure with automatic validation ### Commands Implemented - **install**: Interactive installation with rich UI (progress, panels) - **doctor**: System diagnostics with rich table output - **config**: API key management with format validation ### Technical Improvements - Dependencies: Added typer>=0.9.0, rich>=13.0.0, click>=8.0.0 - Entry Point: Updated pyproject.toml to use `superclaude.cli.app:cli_main` - Tests: Added comprehensive smoke tests (11 passed) ### User Experience Enhancements - Rich formatted help messages with panels and tables - Automatic input validation with retry loops - Clear error messages with actionable suggestions - Non-interactive mode support for CI/CD ## Testing ```bash uv run superclaude --help # ✓ Works uv run superclaude doctor # ✓ Rich table output uv run superclaude config show # ✓ API key management pytest tests/test_cli_smoke.py # ✓ 11 passed, 1 skipped ``` ## Migration Path - ✅ P0: Foundation complete (typer + rich + smoke tests) - 🔜 P1: Pydantic validation models (next sprint) - 🔜 P2: Enhanced error messages (next sprint) - 🔜 P3: API key retry loops (next sprint) ## Performance Impact - **Code Reduction**: Prepared for -300 lines (custom UI → rich) - **Type Safety**: Automatic validation from type hints - **Maintainability**: Framework primitives vs custom code 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: consolidate documentation directories Merged claudedocs/ into docs/research/ for consistent documentation structure. Changes: - Moved all claudedocs/*.md files to docs/research/ - Updated all path references in documentation (EN/KR) - Updated RULES.md and research.md command templates - Removed claudedocs/ directory - Removed ClaudeDocs/ from .gitignore Benefits: - Single source of truth for all research reports - PEP8-compliant lowercase directory naming - Clearer documentation organization - Prevents future claudedocs/ directory creation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * perf: reduce /sc:pm command output from 1652 to 15 lines - Remove 1637 lines of documentation from command file - Keep only minimal bootstrap message - 99% token reduction on command execution - Detailed specs remain in superclaude/agents/pm-agent.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * perf: split PM Agent into execution workflows and guide - Reduce pm-agent.md from 735 to 429 lines (42% reduction) - Move philosophy/examples to docs/agents/pm-agent-guide.md - Execution workflows (PDCA, file ops) stay in pm-agent.md - Guide (examples, quality standards) read once when needed Token savings: - Agent loading: ~6K → ~3.5K tokens (42% reduction) - Total with pm.md: 71% overall reduction 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * 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> * refactor: simplify MCP installer to unified gateway with legacy mode ## Changes ### MCP Component (setup/components/mcp.py) - Simplified to single airis-mcp-gateway by default - Added legacy mode for individual official servers (sequential-thinking, context7, magic, playwright) - Dynamic prerequisites based on mode: - Default: uv + claude CLI only - Legacy: node (18+) + npm + claude CLI - Removed redundant server definitions ### CLI Integration - Added --legacy flag to setup/cli/commands/install.py - Added --legacy flag to superclaude/cli/commands/install.py - Config passes legacy_mode to component installer ## Benefits - ✅ Simpler: 1 gateway vs 9+ individual servers - ✅ Lighter: No Node.js/npm required (default mode) - ✅ Unified: All tools in one gateway (sequential-thinking, context7, magic, playwright, serena, morphllm, tavily, chrome-devtools, git, puppeteer) - ✅ Flexible: --legacy flag for official servers if needed ## Usage ```bash superclaude install # Default: airis-mcp-gateway (推奨) superclaude install --legacy # Legacy: individual official servers ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: rename CoreComponent to FrameworkDocsComponent and add PM token tracking ## Changes ### Component Renaming (setup/components/) - Renamed CoreComponent → FrameworkDocsComponent for clarity - Updated all imports in __init__.py, agents.py, commands.py, mcp_docs.py, modes.py - Better reflects the actual purpose (framework documentation files) ### PM Agent Enhancement (superclaude/commands/pm.md) - Added token usage tracking instructions - PM Agent now reports: 1. Current token usage from system warnings 2. Percentage used (e.g., "27% used" for 54K/200K) 3. Status zone: 🟢 <75% | 🟡 75-85% | 🔴 >85% - Helps prevent token exhaustion during long sessions ### UI Utilities (setup/utils/ui.py) - Added new UI utility module for installer - Provides consistent user interface components ## Benefits - ✅ Clearer component naming (FrameworkDocs vs Core) - ✅ PM Agent token awareness for efficiency - ✅ Better visual feedback with status zones 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor(pm-agent): minimize output verbosity (471→284 lines, 40% reduction) **Problem**: PM Agent generated excessive output with redundant explanations - "System Status Report" with decorative formatting - Repeated "Common Tasks" lists user already knows - Verbose session start/end protocols - Duplicate file operations documentation **Solution**: Compress without losing functionality - Session Start: Reduced to symbol-only status (🟢 branch | nM nD | token%) - Session End: Compressed to essential actions only - File Operations: Consolidated from 2 sections to 1 line reference - Self-Improvement: 5 phases → 1 unified workflow - Output Rules: Explicit constraints to prevent Claude over-explanation **Quality Preservation**: - ✅ All core functions retained (PDCA, memory, patterns, mistakes) - ✅ PARALLEL Read/Write preserved (performance critical) - ✅ Workflow unchanged (session lifecycle intact) - ✅ Added output constraints (prevents verbose generation) **Reduction Method**: - Deleted: Explanatory text, examples, redundant sections - Retained: Action definitions, file paths, core workflows - Added: Explicit output constraints to enforce minimalism **Token Impact**: 40% reduction in agent documentation size **Before**: Verbose multi-section report with task lists **After**: Single line status: 🟢 integration | 15M 17D | 36% 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: consolidate MCP integration to unified gateway **Changes**: - Remove individual MCP server docs (superclaude/mcp/*.md) - Remove MCP server configs (superclaude/mcp/configs/*.json) - Delete MCP docs component (setup/components/mcp_docs.py) - Simplify installer (setup/core/installer.py) - Update components for unified gateway approach **Rationale**: - Unified gateway (airis-mcp-gateway) provides all MCP servers - Individual docs/configs no longer needed (managed centrally) - Reduces maintenance burden and file count - Simplifies installation process **Files Removed**: 17 MCP files (docs + configs) **Installer Changes**: Removed legacy MCP installation logic 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * chore: update version and component metadata - Bump version (pyproject.toml, setup/__init__.py) - Update CLAUDE.md import service references - Reflect component structure changes 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local> Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
kazuki nakai
@@ -1,7 +1,10 @@
|
||||
"""Utility modules for SuperClaude installation system"""
|
||||
"""Utility modules for SuperClaude installation system
|
||||
|
||||
Note: UI utilities (ProgressBar, Menu, confirm, Colors) have been removed.
|
||||
The new CLI uses typer + rich natively via superclaude/cli/
|
||||
"""
|
||||
|
||||
from .ui import ProgressBar, Menu, confirm, Colors
|
||||
from .logger import Logger
|
||||
from .security import SecurityValidator
|
||||
|
||||
__all__ = ["ProgressBar", "Menu", "confirm", "Colors", "Logger", "SecurityValidator"]
|
||||
__all__ = ["Logger", "SecurityValidator"]
|
||||
|
||||
@@ -9,10 +9,13 @@ from pathlib import Path
|
||||
from typing import Optional, Dict, Any
|
||||
from enum import Enum
|
||||
|
||||
from .ui import Colors
|
||||
from rich.console import Console
|
||||
from .symbols import symbols
|
||||
from .paths import get_home_directory
|
||||
|
||||
# Rich console for colored output
|
||||
console = Console()
|
||||
|
||||
|
||||
class LogLevel(Enum):
|
||||
"""Log levels"""
|
||||
@@ -69,37 +72,23 @@ class Logger:
|
||||
}
|
||||
|
||||
def _setup_console_handler(self) -> None:
|
||||
"""Setup colorized console handler"""
|
||||
handler = logging.StreamHandler(sys.stdout)
|
||||
"""Setup colorized console handler using rich"""
|
||||
from rich.logging import RichHandler
|
||||
|
||||
handler = RichHandler(
|
||||
console=console,
|
||||
show_time=False,
|
||||
show_path=False,
|
||||
markup=True,
|
||||
rich_tracebacks=True,
|
||||
tracebacks_show_locals=False,
|
||||
)
|
||||
handler.setLevel(self.console_level.value)
|
||||
|
||||
# Custom formatter with colors
|
||||
class ColorFormatter(logging.Formatter):
|
||||
def format(self, record):
|
||||
# Color mapping
|
||||
colors = {
|
||||
"DEBUG": Colors.WHITE,
|
||||
"INFO": Colors.BLUE,
|
||||
"WARNING": Colors.YELLOW,
|
||||
"ERROR": Colors.RED,
|
||||
"CRITICAL": Colors.RED + Colors.BRIGHT,
|
||||
}
|
||||
# Simple formatter (rich handles coloring)
|
||||
formatter = logging.Formatter("%(message)s")
|
||||
handler.setFormatter(formatter)
|
||||
|
||||
# Prefix mapping
|
||||
prefixes = {
|
||||
"DEBUG": "[DEBUG]",
|
||||
"INFO": "[INFO]",
|
||||
"WARNING": "[!]",
|
||||
"ERROR": f"[{symbols.crossmark}]",
|
||||
"CRITICAL": "[CRITICAL]",
|
||||
}
|
||||
|
||||
color = colors.get(record.levelname, Colors.WHITE)
|
||||
prefix = prefixes.get(record.levelname, "[LOG]")
|
||||
|
||||
return f"{color}{prefix} {record.getMessage()}{Colors.RESET}"
|
||||
|
||||
handler.setFormatter(ColorFormatter())
|
||||
self.logger.addHandler(handler)
|
||||
|
||||
def _setup_file_handler(self) -> None:
|
||||
@@ -130,7 +119,7 @@ class Logger:
|
||||
|
||||
except Exception as e:
|
||||
# If file logging fails, continue with console only
|
||||
print(f"{Colors.YELLOW}[!] Could not setup file logging: {e}{Colors.RESET}")
|
||||
console.print(f"[yellow][!] Could not setup file logging: {e}[/yellow]")
|
||||
self.log_file = None
|
||||
|
||||
def _cleanup_old_logs(self, keep_count: int = 10) -> None:
|
||||
@@ -179,23 +168,9 @@ class Logger:
|
||||
|
||||
def success(self, message: str, **kwargs) -> None:
|
||||
"""Log success message (info level with special formatting)"""
|
||||
# Use a custom success formatter for console
|
||||
if self.logger.handlers:
|
||||
console_handler = self.logger.handlers[0]
|
||||
if hasattr(console_handler, "formatter"):
|
||||
original_format = console_handler.formatter.format
|
||||
|
||||
def success_format(record):
|
||||
return f"{Colors.GREEN}[{symbols.checkmark}] {record.getMessage()}{Colors.RESET}"
|
||||
|
||||
console_handler.formatter.format = success_format
|
||||
self.logger.info(message, **kwargs)
|
||||
console_handler.formatter.format = original_format
|
||||
else:
|
||||
self.logger.info(f"SUCCESS: {message}", **kwargs)
|
||||
else:
|
||||
self.logger.info(f"SUCCESS: {message}", **kwargs)
|
||||
|
||||
# Use rich markup for success messages
|
||||
success_msg = f"[green]{symbols.checkmark} {message}[/green]"
|
||||
self.logger.info(success_msg, **kwargs)
|
||||
self.log_counts["info"] += 1
|
||||
|
||||
def step(self, step: int, total: int, message: str, **kwargs) -> None:
|
||||
|
||||
@@ -1,552 +1,203 @@
|
||||
"""
|
||||
User interface utilities for SuperClaude installation system
|
||||
Cross-platform console UI with colors and progress indication
|
||||
Minimal backward-compatible UI utilities
|
||||
Stub implementation for legacy installer code
|
||||
"""
|
||||
|
||||
import sys
|
||||
import time
|
||||
import shutil
|
||||
import getpass
|
||||
from typing import List, Optional, Any, Dict, Union
|
||||
from enum import Enum
|
||||
from .symbols import symbols, safe_print, format_with_symbols
|
||||
|
||||
# Try to import colorama for cross-platform color support
|
||||
try:
|
||||
import colorama
|
||||
from colorama import Fore, Back, Style
|
||||
|
||||
colorama.init(autoreset=True)
|
||||
COLORAMA_AVAILABLE = True
|
||||
except ImportError:
|
||||
COLORAMA_AVAILABLE = False
|
||||
|
||||
# Fallback color codes for Unix-like systems
|
||||
class MockFore:
|
||||
RED = "\033[91m" if sys.platform != "win32" else ""
|
||||
GREEN = "\033[92m" if sys.platform != "win32" else ""
|
||||
YELLOW = "\033[93m" if sys.platform != "win32" else ""
|
||||
BLUE = "\033[94m" if sys.platform != "win32" else ""
|
||||
MAGENTA = "\033[95m" if sys.platform != "win32" else ""
|
||||
CYAN = "\033[96m" if sys.platform != "win32" else ""
|
||||
WHITE = "\033[97m" if sys.platform != "win32" else ""
|
||||
|
||||
class MockStyle:
|
||||
RESET_ALL = "\033[0m" if sys.platform != "win32" else ""
|
||||
BRIGHT = "\033[1m" if sys.platform != "win32" else ""
|
||||
|
||||
Fore = MockFore()
|
||||
Style = MockStyle()
|
||||
|
||||
|
||||
class Colors:
|
||||
"""Color constants for console output"""
|
||||
"""ANSI color codes for terminal output"""
|
||||
|
||||
RED = Fore.RED
|
||||
GREEN = Fore.GREEN
|
||||
YELLOW = Fore.YELLOW
|
||||
BLUE = Fore.BLUE
|
||||
MAGENTA = Fore.MAGENTA
|
||||
CYAN = Fore.CYAN
|
||||
WHITE = Fore.WHITE
|
||||
RESET = Style.RESET_ALL
|
||||
BRIGHT = Style.BRIGHT
|
||||
RESET = "\033[0m"
|
||||
BRIGHT = "\033[1m"
|
||||
DIM = "\033[2m"
|
||||
|
||||
BLACK = "\033[30m"
|
||||
RED = "\033[31m"
|
||||
GREEN = "\033[32m"
|
||||
YELLOW = "\033[33m"
|
||||
BLUE = "\033[34m"
|
||||
MAGENTA = "\033[35m"
|
||||
CYAN = "\033[36m"
|
||||
WHITE = "\033[37m"
|
||||
|
||||
BG_BLACK = "\033[40m"
|
||||
BG_RED = "\033[41m"
|
||||
BG_GREEN = "\033[42m"
|
||||
BG_YELLOW = "\033[43m"
|
||||
BG_BLUE = "\033[44m"
|
||||
BG_MAGENTA = "\033[45m"
|
||||
BG_CYAN = "\033[46m"
|
||||
BG_WHITE = "\033[47m"
|
||||
|
||||
|
||||
class ProgressBar:
|
||||
"""Cross-platform progress bar with customizable display"""
|
||||
|
||||
def __init__(self, total: int, width: int = 50, prefix: str = "", suffix: str = ""):
|
||||
"""
|
||||
Initialize progress bar
|
||||
|
||||
Args:
|
||||
total: Total number of items to process
|
||||
width: Width of progress bar in characters
|
||||
prefix: Text to display before progress bar
|
||||
suffix: Text to display after progress bar
|
||||
"""
|
||||
self.total = total
|
||||
self.width = width
|
||||
self.prefix = prefix
|
||||
self.suffix = suffix
|
||||
self.current = 0
|
||||
self.start_time = time.time()
|
||||
|
||||
# Get terminal width for responsive display
|
||||
try:
|
||||
self.terminal_width = shutil.get_terminal_size().columns
|
||||
except OSError:
|
||||
self.terminal_width = 80
|
||||
|
||||
def update(self, current: int, message: str = "") -> None:
|
||||
"""
|
||||
Update progress bar
|
||||
|
||||
Args:
|
||||
current: Current progress value
|
||||
message: Optional message to display
|
||||
"""
|
||||
self.current = current
|
||||
percent = min(100, (current / self.total) * 100) if self.total > 0 else 100
|
||||
|
||||
# Calculate filled and empty portions
|
||||
filled_width = (
|
||||
int(self.width * current / self.total) if self.total > 0 else self.width
|
||||
)
|
||||
filled = symbols.block_filled * filled_width
|
||||
empty = symbols.block_empty * (self.width - filled_width)
|
||||
|
||||
# Calculate elapsed time and ETA
|
||||
elapsed = time.time() - self.start_time
|
||||
if current > 0:
|
||||
eta = (elapsed / current) * (self.total - current)
|
||||
eta_str = f" ETA: {self._format_time(eta)}"
|
||||
else:
|
||||
eta_str = ""
|
||||
|
||||
# Format progress line
|
||||
if message:
|
||||
status = f" {message}"
|
||||
else:
|
||||
status = ""
|
||||
|
||||
progress_line = (
|
||||
f"\r{self.prefix}[{Colors.GREEN}{filled}{Colors.WHITE}{empty}{Colors.RESET}] "
|
||||
f"{percent:5.1f}%{status}{eta_str}"
|
||||
)
|
||||
|
||||
# Truncate if too long for terminal
|
||||
max_length = self.terminal_width - 5
|
||||
if len(progress_line) > max_length:
|
||||
# Remove color codes for length calculation
|
||||
plain_line = (
|
||||
progress_line.replace(Colors.GREEN, "")
|
||||
.replace(Colors.WHITE, "")
|
||||
.replace(Colors.RESET, "")
|
||||
)
|
||||
if len(plain_line) > max_length:
|
||||
progress_line = progress_line[:max_length] + "..."
|
||||
|
||||
safe_print(progress_line, end="", flush=True)
|
||||
|
||||
def increment(self, message: str = "") -> None:
|
||||
"""
|
||||
Increment progress by 1
|
||||
|
||||
Args:
|
||||
message: Optional message to display
|
||||
"""
|
||||
self.update(self.current + 1, message)
|
||||
|
||||
def finish(self, message: str = "Complete") -> None:
|
||||
"""
|
||||
Complete progress bar
|
||||
|
||||
Args:
|
||||
message: Completion message
|
||||
"""
|
||||
self.update(self.total, message)
|
||||
print() # New line after completion
|
||||
|
||||
def _format_time(self, seconds: float) -> str:
|
||||
"""Format time duration as human-readable string"""
|
||||
if seconds < 60:
|
||||
return f"{seconds:.0f}s"
|
||||
elif seconds < 3600:
|
||||
return f"{seconds/60:.0f}m {seconds%60:.0f}s"
|
||||
else:
|
||||
hours = seconds // 3600
|
||||
minutes = (seconds % 3600) // 60
|
||||
return f"{hours:.0f}h {minutes:.0f}m"
|
||||
def display_header(title: str, subtitle: str = "") -> None:
|
||||
"""Display a formatted header"""
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{title}{Colors.RESET}")
|
||||
if subtitle:
|
||||
print(f"{Colors.DIM}{subtitle}{Colors.RESET}")
|
||||
print()
|
||||
|
||||
|
||||
class Menu:
|
||||
"""Interactive menu system with keyboard navigation"""
|
||||
|
||||
def __init__(self, title: str, options: List[str], multi_select: bool = False):
|
||||
"""
|
||||
Initialize menu
|
||||
|
||||
Args:
|
||||
title: Menu title
|
||||
options: List of menu options
|
||||
multi_select: Allow multiple selections
|
||||
"""
|
||||
self.title = title
|
||||
self.options = options
|
||||
self.multi_select = multi_select
|
||||
self.selected = set() if multi_select else None
|
||||
|
||||
def display(self) -> Union[int, List[int]]:
|
||||
"""
|
||||
Display menu and get user selection
|
||||
|
||||
Returns:
|
||||
Selected option index (single) or list of indices (multi-select)
|
||||
"""
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{self.title}{Colors.RESET}")
|
||||
print("=" * len(self.title))
|
||||
|
||||
for i, option in enumerate(self.options, 1):
|
||||
if self.multi_select:
|
||||
marker = "[x]" if i - 1 in (self.selected or set()) else "[ ]"
|
||||
print(f"{Colors.YELLOW}{i:2d}.{Colors.RESET} {marker} {option}")
|
||||
else:
|
||||
print(f"{Colors.YELLOW}{i:2d}.{Colors.RESET} {option}")
|
||||
|
||||
if self.multi_select:
|
||||
print(
|
||||
f"\n{Colors.BLUE}Enter numbers separated by commas (e.g., 1,3,5) or 'all' for all options:{Colors.RESET}"
|
||||
)
|
||||
else:
|
||||
print(
|
||||
f"\n{Colors.BLUE}Enter your choice (1-{len(self.options)}):{Colors.RESET}"
|
||||
)
|
||||
|
||||
while True:
|
||||
try:
|
||||
user_input = input("> ").strip().lower()
|
||||
|
||||
if self.multi_select:
|
||||
if user_input == "all":
|
||||
return list(range(len(self.options)))
|
||||
elif user_input == "":
|
||||
return []
|
||||
else:
|
||||
# Parse comma-separated numbers
|
||||
selections = []
|
||||
for part in user_input.split(","):
|
||||
part = part.strip()
|
||||
if part.isdigit():
|
||||
idx = int(part) - 1
|
||||
if 0 <= idx < len(self.options):
|
||||
selections.append(idx)
|
||||
else:
|
||||
raise ValueError(f"Invalid option: {part}")
|
||||
else:
|
||||
raise ValueError(f"Invalid input: {part}")
|
||||
return list(set(selections)) # Remove duplicates
|
||||
else:
|
||||
if user_input.isdigit():
|
||||
choice = int(user_input) - 1
|
||||
if 0 <= choice < len(self.options):
|
||||
return choice
|
||||
else:
|
||||
print(
|
||||
f"{Colors.RED}Invalid choice. Please enter a number between 1 and {len(self.options)}.{Colors.RESET}"
|
||||
)
|
||||
else:
|
||||
print(f"{Colors.RED}Please enter a valid number.{Colors.RESET}")
|
||||
|
||||
except (ValueError, KeyboardInterrupt) as e:
|
||||
if isinstance(e, KeyboardInterrupt):
|
||||
print(f"\n{Colors.YELLOW}Operation cancelled.{Colors.RESET}")
|
||||
return [] if self.multi_select else -1
|
||||
else:
|
||||
print(f"{Colors.RED}Invalid input: {e}{Colors.RESET}")
|
||||
def display_success(message: str) -> None:
|
||||
"""Display a success message"""
|
||||
print(f"{Colors.GREEN}✓ {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def confirm(message: str, default: bool = True) -> bool:
|
||||
def display_error(message: str) -> None:
|
||||
"""Display an error message"""
|
||||
print(f"{Colors.RED}✗ {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_warning(message: str) -> None:
|
||||
"""Display a warning message"""
|
||||
print(f"{Colors.YELLOW}⚠ {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_info(message: str) -> None:
|
||||
"""Display an info message"""
|
||||
print(f"{Colors.CYAN}ℹ {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def confirm(prompt: str, default: bool = True) -> bool:
|
||||
"""
|
||||
Ask for user confirmation
|
||||
Simple confirmation prompt
|
||||
|
||||
Args:
|
||||
message: Confirmation message
|
||||
prompt: The prompt message
|
||||
default: Default response if user just presses Enter
|
||||
|
||||
Returns:
|
||||
True if confirmed, False otherwise
|
||||
"""
|
||||
suffix = "[Y/n]" if default else "[y/N]"
|
||||
print(f"{Colors.BLUE}{message} {suffix}{Colors.RESET}")
|
||||
default_str = "Y/n" if default else "y/N"
|
||||
response = input(f"{prompt} [{default_str}]: ").strip().lower()
|
||||
|
||||
while True:
|
||||
try:
|
||||
response = input("> ").strip().lower()
|
||||
if not response:
|
||||
return default
|
||||
|
||||
if response == "":
|
||||
return default
|
||||
elif response in ["y", "yes", "true", "1"]:
|
||||
return True
|
||||
elif response in ["n", "no", "false", "0"]:
|
||||
return False
|
||||
else:
|
||||
print(
|
||||
f"{Colors.RED}Please enter 'y' or 'n' (or press Enter for default).{Colors.RESET}"
|
||||
)
|
||||
|
||||
except KeyboardInterrupt:
|
||||
print(f"\n{Colors.YELLOW}Operation cancelled.{Colors.RESET}")
|
||||
return False
|
||||
return response in ("y", "yes")
|
||||
|
||||
|
||||
def display_header(title: str, subtitle: str = "") -> None:
|
||||
"""
|
||||
Display formatted header
|
||||
class Menu:
|
||||
"""Minimal menu implementation"""
|
||||
|
||||
Args:
|
||||
title: Main title
|
||||
subtitle: Optional subtitle
|
||||
"""
|
||||
from superclaude import __author__, __email__
|
||||
def __init__(self, title: str, options: list, multi_select: bool = False):
|
||||
self.title = title
|
||||
self.options = options
|
||||
self.multi_select = multi_select
|
||||
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{'='*60}{Colors.RESET}")
|
||||
print(f"{Colors.CYAN}{Colors.BRIGHT}{title:^60}{Colors.RESET}")
|
||||
if subtitle:
|
||||
print(f"{Colors.WHITE}{subtitle:^60}{Colors.RESET}")
|
||||
def display(self):
|
||||
"""Display menu and get selection"""
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{self.title}{Colors.RESET}\n")
|
||||
|
||||
# Display authors
|
||||
authors = [a.strip() for a in __author__.split(",")]
|
||||
emails = [e.strip() for e in __email__.split(",")]
|
||||
for i, option in enumerate(self.options, 1):
|
||||
print(f"{i}. {option}")
|
||||
|
||||
author_lines = []
|
||||
for i in range(len(authors)):
|
||||
name = authors[i]
|
||||
email = emails[i] if i < len(emails) else ""
|
||||
author_lines.append(f"{name} <{email}>")
|
||||
if self.multi_select:
|
||||
print(f"\n{Colors.DIM}Enter comma-separated numbers (e.g., 1,3,5) or 'all' for all options{Colors.RESET}")
|
||||
while True:
|
||||
try:
|
||||
choice = input(f"Select [1-{len(self.options)}]: ").strip().lower()
|
||||
|
||||
authors_str = " | ".join(author_lines)
|
||||
print(f"{Colors.BLUE}{authors_str:^60}{Colors.RESET}")
|
||||
if choice == "all":
|
||||
return list(range(len(self.options)))
|
||||
|
||||
print(f"{Colors.CYAN}{Colors.BRIGHT}{'='*60}{Colors.RESET}\n")
|
||||
if not choice:
|
||||
return []
|
||||
|
||||
selections = [int(x.strip()) - 1 for x in choice.split(",")]
|
||||
if all(0 <= s < len(self.options) for s in selections):
|
||||
return selections
|
||||
print(f"{Colors.RED}Invalid selection{Colors.RESET}")
|
||||
except (ValueError, KeyboardInterrupt):
|
||||
print(f"\n{Colors.RED}Invalid input{Colors.RESET}")
|
||||
else:
|
||||
while True:
|
||||
try:
|
||||
choice = input(f"\nSelect [1-{len(self.options)}]: ").strip()
|
||||
choice_num = int(choice)
|
||||
if 1 <= choice_num <= len(self.options):
|
||||
return choice_num - 1
|
||||
print(f"{Colors.RED}Invalid selection{Colors.RESET}")
|
||||
except (ValueError, KeyboardInterrupt):
|
||||
print(f"\n{Colors.RED}Invalid input{Colors.RESET}")
|
||||
|
||||
|
||||
def display_authors() -> None:
|
||||
"""Display author information"""
|
||||
from superclaude import __author__, __email__, __github__
|
||||
class ProgressBar:
|
||||
"""Minimal progress bar implementation"""
|
||||
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{'='*60}{Colors.RESET}")
|
||||
print(f"{Colors.CYAN}{Colors.BRIGHT}{'superclaude Authors':^60}{Colors.RESET}")
|
||||
print(f"{Colors.CYAN}{Colors.BRIGHT}{'='*60}{Colors.RESET}\n")
|
||||
|
||||
authors = [a.strip() for a in __author__.split(",")]
|
||||
emails = [e.strip() for e in __email__.split(",")]
|
||||
github_users = [g.strip() for g in __github__.split(",")]
|
||||
|
||||
for i in range(len(authors)):
|
||||
name = authors[i]
|
||||
email = emails[i] if i < len(emails) else "N/A"
|
||||
github = github_users[i] if i < len(github_users) else "N/A"
|
||||
|
||||
print(f" {Colors.BRIGHT}{name}{Colors.RESET}")
|
||||
print(f" Email: {Colors.YELLOW}{email}{Colors.RESET}")
|
||||
print(f" GitHub: {Colors.YELLOW}https://github.com/{github}{Colors.RESET}")
|
||||
print()
|
||||
|
||||
print(f"{Colors.CYAN}{'='*60}{Colors.RESET}\n")
|
||||
|
||||
|
||||
def display_info(message: str) -> None:
|
||||
"""Display info message"""
|
||||
print(f"{Colors.BLUE}[INFO] {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_success(message: str) -> None:
|
||||
"""Display success message"""
|
||||
safe_print(f"{Colors.GREEN}[{symbols.checkmark}] {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_warning(message: str) -> None:
|
||||
"""Display warning message"""
|
||||
print(f"{Colors.YELLOW}[!] {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_error(message: str) -> None:
|
||||
"""Display error message"""
|
||||
safe_print(f"{Colors.RED}[{symbols.crossmark}] {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_step(step: int, total: int, message: str) -> None:
|
||||
"""Display step progress"""
|
||||
print(f"{Colors.CYAN}[{step}/{total}] {message}{Colors.RESET}")
|
||||
|
||||
|
||||
def display_table(headers: List[str], rows: List[List[str]], title: str = "") -> None:
|
||||
"""
|
||||
Display data in table format
|
||||
|
||||
Args:
|
||||
headers: Column headers
|
||||
rows: Data rows
|
||||
title: Optional table title
|
||||
"""
|
||||
if not rows:
|
||||
return
|
||||
|
||||
# Calculate column widths
|
||||
col_widths = [len(header) for header in headers]
|
||||
for row in rows:
|
||||
for i, cell in enumerate(row):
|
||||
if i < len(col_widths):
|
||||
col_widths[i] = max(col_widths[i], len(str(cell)))
|
||||
|
||||
# Display title
|
||||
if title:
|
||||
print(f"\n{Colors.CYAN}{Colors.BRIGHT}{title}{Colors.RESET}")
|
||||
print()
|
||||
|
||||
# Display headers
|
||||
header_line = " | ".join(
|
||||
f"{header:<{col_widths[i]}}" for i, header in enumerate(headers)
|
||||
)
|
||||
print(f"{Colors.YELLOW}{header_line}{Colors.RESET}")
|
||||
print("-" * len(header_line))
|
||||
|
||||
# Display rows
|
||||
for row in rows:
|
||||
row_line = " | ".join(
|
||||
f"{str(cell):<{col_widths[i]}}" for i, cell in enumerate(row)
|
||||
)
|
||||
print(row_line)
|
||||
|
||||
print()
|
||||
|
||||
|
||||
def prompt_api_key(service_name: str, env_var_name: str) -> Optional[str]:
|
||||
"""
|
||||
Prompt for API key with security and UX best practices
|
||||
|
||||
Args:
|
||||
service_name: Human-readable service name (e.g., "Magic", "Morphllm")
|
||||
env_var_name: Environment variable name (e.g., "TWENTYFIRST_API_KEY")
|
||||
|
||||
Returns:
|
||||
API key string if provided, None if skipped
|
||||
"""
|
||||
print(
|
||||
f"{Colors.BLUE}[API KEY] {service_name} requires: {Colors.BRIGHT}{env_var_name}{Colors.RESET}"
|
||||
)
|
||||
print(
|
||||
f"{Colors.WHITE}Visit the service documentation to obtain your API key{Colors.RESET}"
|
||||
)
|
||||
print(
|
||||
f"{Colors.YELLOW}Press Enter to skip (you can set this manually later){Colors.RESET}"
|
||||
)
|
||||
|
||||
try:
|
||||
# Use getpass for hidden input
|
||||
api_key = getpass.getpass(f"Enter {env_var_name}: ").strip()
|
||||
|
||||
if not api_key:
|
||||
print(
|
||||
f"{Colors.YELLOW}[SKIPPED] {env_var_name} - set manually later{Colors.RESET}"
|
||||
)
|
||||
return None
|
||||
|
||||
# Basic validation (non-empty, reasonable length)
|
||||
if len(api_key) < 10:
|
||||
print(
|
||||
f"{Colors.RED}[WARNING] API key seems too short. Continue anyway? (y/N){Colors.RESET}"
|
||||
)
|
||||
if not confirm("", default=False):
|
||||
return None
|
||||
|
||||
safe_print(
|
||||
f"{Colors.GREEN}[{symbols.checkmark}] {env_var_name} configured{Colors.RESET}"
|
||||
)
|
||||
return api_key
|
||||
|
||||
except KeyboardInterrupt:
|
||||
safe_print(f"\n{Colors.YELLOW}[SKIPPED] {env_var_name}{Colors.RESET}")
|
||||
return None
|
||||
|
||||
|
||||
def wait_for_key(message: str = "Press Enter to continue...") -> None:
|
||||
"""Wait for user to press a key"""
|
||||
try:
|
||||
input(f"{Colors.BLUE}{message}{Colors.RESET}")
|
||||
except KeyboardInterrupt:
|
||||
print(f"\n{Colors.YELLOW}Operation cancelled.{Colors.RESET}")
|
||||
|
||||
|
||||
def clear_screen() -> None:
|
||||
"""Clear terminal screen"""
|
||||
import os
|
||||
|
||||
os.system("cls" if os.name == "nt" else "clear")
|
||||
|
||||
|
||||
class StatusSpinner:
|
||||
"""Simple status spinner for long operations"""
|
||||
|
||||
def __init__(self, message: str = "Working..."):
|
||||
"""
|
||||
Initialize spinner
|
||||
|
||||
Args:
|
||||
message: Message to display with spinner
|
||||
"""
|
||||
self.message = message
|
||||
self.spinning = False
|
||||
self.chars = symbols.spinner_chars
|
||||
def __init__(self, total: int, prefix: str = "", suffix: str = ""):
|
||||
self.total = total
|
||||
self.prefix = prefix
|
||||
self.suffix = suffix
|
||||
self.current = 0
|
||||
|
||||
def start(self) -> None:
|
||||
"""Start spinner in background thread"""
|
||||
import threading
|
||||
def update(self, current: int = None, message: str = None) -> None:
|
||||
"""Update progress"""
|
||||
if current is not None:
|
||||
self.current = current
|
||||
else:
|
||||
self.current += 1
|
||||
|
||||
def spin():
|
||||
while self.spinning:
|
||||
char = self.chars[self.current % len(self.chars)]
|
||||
safe_print(
|
||||
f"\r{Colors.BLUE}{char} {self.message}{Colors.RESET}",
|
||||
end="",
|
||||
flush=True,
|
||||
)
|
||||
self.current += 1
|
||||
time.sleep(0.1)
|
||||
percent = int((self.current / self.total) * 100) if self.total > 0 else 100
|
||||
display_msg = message or f"{self.prefix}{self.current}/{self.total} {self.suffix}"
|
||||
print(f"\r{display_msg} {percent}%", end="", flush=True)
|
||||
|
||||
self.spinning = True
|
||||
self.thread = threading.Thread(target=spin, daemon=True)
|
||||
self.thread.start()
|
||||
if self.current >= self.total:
|
||||
print() # New line when complete
|
||||
|
||||
def stop(self, final_message: str = "") -> None:
|
||||
"""
|
||||
Stop spinner
|
||||
def finish(self, message: str = "Complete") -> None:
|
||||
"""Finish progress bar"""
|
||||
self.current = self.total
|
||||
print(f"\r{message} 100%")
|
||||
|
||||
Args:
|
||||
final_message: Final message to display
|
||||
"""
|
||||
self.spinning = False
|
||||
if hasattr(self, "thread"):
|
||||
self.thread.join(timeout=0.2)
|
||||
|
||||
# Clear spinner line
|
||||
safe_print(f"\r{' ' * (len(self.message) + 5)}\r", end="")
|
||||
|
||||
if final_message:
|
||||
safe_print(final_message)
|
||||
def close(self) -> None:
|
||||
"""Close progress bar"""
|
||||
if self.current < self.total:
|
||||
print()
|
||||
|
||||
|
||||
def format_size(size_bytes: int) -> str:
|
||||
"""Format file size in human-readable format"""
|
||||
for unit in ["B", "KB", "MB", "GB", "TB"]:
|
||||
if size_bytes < 1024.0:
|
||||
return f"{size_bytes:.1f} {unit}"
|
||||
size_bytes /= 1024.0
|
||||
return f"{size_bytes:.1f} PB"
|
||||
def format_size(size: int) -> str:
|
||||
"""
|
||||
Format size in bytes to human-readable string
|
||||
|
||||
Args:
|
||||
size: Size in bytes
|
||||
|
||||
def format_duration(seconds: float) -> str:
|
||||
"""Format duration in human-readable format"""
|
||||
if seconds < 1:
|
||||
return f"{seconds*1000:.0f}ms"
|
||||
elif seconds < 60:
|
||||
return f"{seconds:.1f}s"
|
||||
elif seconds < 3600:
|
||||
minutes = seconds // 60
|
||||
secs = seconds % 60
|
||||
return f"{minutes:.0f}m {secs:.0f}s"
|
||||
Returns:
|
||||
Formatted size string (e.g., "1.5 MB", "256 KB")
|
||||
"""
|
||||
if size < 1024:
|
||||
return f"{size} B"
|
||||
elif size < 1024 * 1024:
|
||||
return f"{size / 1024:.1f} KB"
|
||||
elif size < 1024 * 1024 * 1024:
|
||||
return f"{size / (1024 * 1024):.1f} MB"
|
||||
else:
|
||||
hours = seconds // 3600
|
||||
minutes = (seconds % 3600) // 60
|
||||
return f"{hours:.0f}h {minutes:.0f}m"
|
||||
return f"{size / (1024 * 1024 * 1024):.1f} GB"
|
||||
|
||||
|
||||
def truncate_text(text: str, max_length: int, suffix: str = "...") -> str:
|
||||
"""Truncate text to maximum length with optional suffix"""
|
||||
if len(text) <= max_length:
|
||||
return text
|
||||
def prompt_api_key(service_name: str, env_var_name: str) -> str:
|
||||
"""
|
||||
Prompt user for API key
|
||||
|
||||
return text[: max_length - len(suffix)] + suffix
|
||||
Args:
|
||||
service_name: Name of the service requiring the key
|
||||
env_var_name: Environment variable name for the key
|
||||
|
||||
Returns:
|
||||
API key string (empty if user skips)
|
||||
"""
|
||||
print(f"\n{Colors.CYAN}{service_name} API Key{Colors.RESET}")
|
||||
print(f"{Colors.DIM}Environment variable: {env_var_name}{Colors.RESET}")
|
||||
print(f"{Colors.YELLOW}Press Enter to skip{Colors.RESET}")
|
||||
|
||||
try:
|
||||
# Use getpass for password-like input (hidden)
|
||||
import getpass
|
||||
|
||||
key = getpass.getpass("Enter API key: ").strip()
|
||||
return key
|
||||
except (EOFError, KeyboardInterrupt):
|
||||
print(f"\n{Colors.YELLOW}Skipped{Colors.RESET}")
|
||||
return ""
|
||||
|
||||
Reference in New Issue
Block a user