moai-adk 0.25.4__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/__init__.py

@@ -3,11 +3,8 @@
 SPEC-First TDD Framework with Alfred SuperAgent
 """
 
-from importlib.metadata import PackageNotFoundError, version
+from moai_adk.version import MOAI_VERSION
 
-try:
-    __version__ = version("moai-adk")
-except PackageNotFoundError:
-    __version__ = "0.23.0-dev"
+__version__ = MOAI_VERSION
 
 __all__ = ["__version__"]

moai_adk/__main__.py

@@ -2,32 +2,43 @@
 """MoAI-ADK CLI Entry Point
 
 Implements the CLI entry point:
-- Click-based CLI framework
+- Click-based CLI framework with lazy command loading
 - Rich console terminal output
-- ASCII logo rendering
+- ASCII logo rendering (lazy-loaded)
 - --version and --help options
-- Five core commands: init, doctor, status, backup, update
+- Five core commands: init, doctor, status, update (lazy-loaded)
+
+Performance optimization: Commands and heavy libraries are lazy-loaded
+to reduce CLI startup time by 75% (~400ms → ~100ms).
 """
 
 import sys
 
 import click
-import pyfiglet
-from rich.console import Console
 
 from moai_adk import __version__
-from moai_adk.cli.commands.backup import backup
-from moai_adk.cli.commands.doctor import doctor
-from moai_adk.cli.commands.init import init
-from moai_adk.cli.commands.migrate import migrate
-from moai_adk.cli.commands.status import status
-from moai_adk.cli.commands.update import update
 
-console = Console()
+# Lazy-loaded console (created when needed)
+_console = None
+
+
+def get_console():
+    """Get or create Rich Console instance (lazy loading)"""
+    global _console
+    if _console is None:
+        from rich.console import Console
+
+        _console = Console()
+    return _console
 
 
 def show_logo() -> None:
-    """Render the MoAI-ADK ASCII logo with Pyfiglet"""
+    """Render the MoAI-ADK ASCII logo with Pyfiglet (lazy-loaded)"""
+    # Lazy load pyfiglet only when displaying logo
+    import pyfiglet
+
+    console = get_console()
+
     # Generate the "MoAI-ADK" banner using the ansi_shadow font
     logo = pyfiglet.figlet_format("MoAI-ADK", font="ansi_shadow")
 
@@ -59,89 +70,108 @@ def cli(ctx: click.Context) -> None:
         show_logo()
 
 
-cli.add_command(init)
-cli.add_command(doctor)
-cli.add_command(status)
-cli.add_command(backup)
-cli.add_command(migrate)
-cli.add_command(update)
-
-
-# 링크 검증 명령
-@click.command(name="validate-links")
+# Lazy-loaded commands (imported only when invoked)
+@cli.command()
+@click.argument("path", type=click.Path(), default=".")
 @click.option(
-    "--file",
-    "-f",
-    default="README.ko.md",
-    help="검증할 파일 경로 (기본값: README.ko.md)",
+    "--non-interactive",
+    "-y",
+    is_flag=True,
+    help="Non-interactive mode (use defaults)",
 )
 @click.option(
-    "--max-concurrent",
-    "-c",
-    type=int,
-    default=3,
-    help="동시에 검증할 최대 링크 수 (기본값: 3)",
+    "--mode",
+    type=click.Choice(["personal", "team"]),
+    default="personal",
+    help="Project mode",
 )
 @click.option(
-    "--timeout", "-t", type=int, default=8, help="요청 타임아웃 (초) (기본값: 8)"
+    "--locale",
+    type=click.Choice(["ko", "en", "ja", "zh"]),
+    default=None,
+    help="Preferred language (ko/en/ja/zh, default: en)",
 )
-@click.option("--output", "-o", help="결과를 저장할 파일 경로")
-@click.option("--verbose", "-v", is_flag=True, help="상세한 진행 상황 표시")
-def validate_links(file, max_concurrent, timeout, output, verbose):
-    """온라인 문서 링크 검증"""
-    from moai_adk.cli.commands.validate_links import run_command as validate_links_run
-
-    # CLI 명령 실행
-    sys.exit(validate_links_run(locals()))
-
-
-# 사용자 경험 개선 명령
-@click.command(name="improve-ux")
 @click.option(
-    "--url",
-    "-u",
-    default="https://adk.mo.ai.kr",
-    help="분석할 URL (기본값: https://adk.mo.ai.kr)",
+    "--language",
+    type=str,
+    default=None,
+    help="Programming language (auto-detect if not specified)",
 )
-@click.option("--output", "-o", help="분석 결과를 저장할 파일 경로")
 @click.option(
-    "--format",
-    "-f",
-    type=click.Choice(["json", "markdown", "text"]),
-    default="markdown",
-    help="출력 형식 (기본값: markdown)",
+    "--force",
+    is_flag=True,
+    help="Force reinitialize without confirmation",
 )
-@click.option("--verbose", "-v", is_flag=True, help="상세한 진행 상황 표시")
-@click.option(
-    "--max-workers",
-    "-w",
-    type=int,
-    default=5,
-    help="동시에 처리할 최대 작업 수 (기본값: 5)",
-)
-def improve_ux(url, output, format, verbose, max_workers):
-    """사용자 경험 개선 분석"""
+@click.pass_context
+def init(
+    ctx: click.Context,
+    path: str,
+    non_interactive: bool,
+    mode: str,
+    locale: str,
+    language: str | None,
+    force: bool,
+) -> None:
+    """Initialize a new MoAI-ADK project"""
+    from moai_adk.cli.commands.init import init as _init
+
+    ctx.invoke(
+        _init,
+        path=path,
+        non_interactive=non_interactive,
+        mode=mode,
+        locale=locale,
+        language=language,
+        force=force,
+    )
 
-    # 임시 args 객체 생성
-    class Args:
-        def __init__(self, **kwargs):
-            for key, value in kwargs.items():
-                setattr(self, key, value)
 
-    args = Args(
-        url=url, output=output, format=format, verbose=verbose, max_workers=max_workers
-    )
+@cli.command()
+@click.pass_context
+def doctor(ctx: click.Context, **kwargs) -> None:
+    """Run system diagnostics"""
+    from moai_adk.cli.commands.doctor import doctor as _doctor
 
-    # CLI 명령 실행
-    from moai_adk.cli.commands.improve_user_experience import (
-        run_command as improve_ux_run,
-    )
+    ctx.invoke(_doctor, **kwargs)
+
+
+@cli.command()
+@click.pass_context
+def status(ctx: click.Context, **kwargs) -> None:
+    """Show project status"""
+    from moai_adk.cli.commands.status import status as _status
+
+    ctx.invoke(_status, **kwargs)
 
-    sys.exit(improve_ux_run(args))
 
+@cli.command()
+@click.pass_context
+def update(ctx: click.Context, **kwargs) -> None:
+    """Update MoAI-ADK to latest version"""
+    from moai_adk.cli.commands.update import update as _update
+
+    ctx.invoke(_update, **kwargs)
+
+
+# statusline command (for Claude Code statusline rendering)
+@cli.command(name="statusline")
+def statusline() -> None:
+    """Render Claude Code statusline (internal use only)"""
+    import json
+
+    # Lazy load statusline module
+    from moai_adk.statusline.main import build_statusline_data
+
+    try:
+        # Read JSON context from stdin
+        input_data = sys.stdin.read() if not sys.stdin.isatty() else "{}"
+        context = json.loads(input_data) if input_data else {}
+    except (json.JSONDecodeError, EOFError, ValueError):
+        context = {}
 
-cli.add_command(validate_links)
-cli.add_command(improve_ux)
+    # Render statusline
+    output = build_statusline_data(context, mode="extended")
+    print(output, end="")
 
 
 def main() -> int:
@@ -156,11 +186,13 @@ def main() -> int:
         e.show()
         return e.exit_code
     except Exception as e:
+        console = get_console()
         console.print(f"[red]Error:[/red] {e}")
         return 1
     finally:
-        # Flush the output buffer explicitly
-        console.file.flush()
+        # Flush the output buffer explicitly if console was created
+        if _console is not None:
+            _console.file.flush()
 
 
 if __name__ == "__main__":

moai_adk/cli/__init__.py

@@ -1 +1,6 @@
-"""CLI module: Click-based command-line interface"""
+"""MoAI-ADK CLI Tools
+
+Command-line interface utilities for MoAI-ADK project management.
+"""
+
+__all__ = ["spec_status"]

moai_adk/cli/commands/__init__.py

@@ -5,15 +5,13 @@ Core commands:
 - doctor: run system diagnostics
 - status: show project status
 - update: update templates to latest version
-- backup: create project backups
 
 Note: restore functionality is handled by checkpoint system in core.git.checkpoint
 """
 
-from moai_adk.cli.commands.backup import backup
 from moai_adk.cli.commands.doctor import doctor
 from moai_adk.cli.commands.init import init
 from moai_adk.cli.commands.status import status
 from moai_adk.cli.commands.update import update
 
-__all__ = ["init", "doctor", "status", "update", "backup"]
+__all__ = ["init", "doctor", "status", "update"]

moai_adk/cli/commands/analyze.py

@@ -5,7 +5,6 @@ Analyze command for MoAI-ADK
 Analyze Claude Code sessions and generate improvement suggestions.
 """
 
-
 from pathlib import Path
 from typing import Optional
 
@@ -22,9 +21,7 @@ console = Console()
 @click.option("--days", "-d", default=7, help="Number of days to analyze (default: 7)")
 @click.option("--output", "-o", type=click.Path(), help="Output file path")
 @click.option("--verbose", "-v", is_flag=True, help="Verbose output")
-@click.option(
-    "--report-only", "-r", is_flag=True, help="Generate report only (no console output)"
-)
+@click.option("--report-only", "-r", is_flag=True, help="Generate report only (no console output)")
 @click.option(
     "--project-path",
     "-p",
@@ -54,9 +51,7 @@ def analyze(
 
     # Validate project path
     if not (project_path / ".moai").exists():
-        console.print(
-            "[red]Error:[/red] Not a MoAI-ADK project (missing .moai directory)"
-        )
+        console.print("[red]Error:[/red] Not a MoAI-ADK project (missing .moai directory)")
         console.print(f"[blue]Current path:[/blue] {project_path}")
         return
 
@@ -70,9 +65,7 @@ def analyze(
     patterns = analyzer.parse_sessions()
 
     if not report_only:
-        console.print(
-            f"[green]✅ Analyzed {patterns['total_sessions']} sessions[/green]"
-        )
+        console.print(f"[green]✅ Analyzed {patterns['total_sessions']} sessions[/green]")
         console.print(f"[blue]   Total events: {patterns['total_events']}[/blue]")
 
         # Display summary table
@@ -90,9 +83,7 @@ def analyze(
         # Show top tools
         if patterns["tool_usage"]:
             console.print("\n[bold]🔧 Top Tools Used:[/bold]")
-            top_tools = sorted(
-                patterns["tool_usage"].items(), key=lambda x: x[1], reverse=True
-            )[:10]
+            top_tools = sorted(patterns["tool_usage"].items(), key=lambda x: x[1], reverse=True)[:10]
 
             tools_table = Table()
             tools_table.add_column("Tool", style="cyan")
@@ -119,9 +110,7 @@ def analyze(
             if suggestions_start != -1:
                 suggestions_section = report_content[suggestions_start:]
                 # Extract first few suggestions
-                lines = suggestions_section.split("\n")[
-                    2:
-                ]  # Skip header and empty line
+                lines = suggestions_section.split("\n")[2:]  # Skip header and empty line
                 for line in lines[:10]:  # Show first 10 lines
                     if line.strip() and not line.startswith("---"):
                         console.print(line)

moai_adk/cli/commands/doctor.py

@@ -56,9 +56,7 @@ console = Console()
 @click.option("--fix", is_flag=True, help="Suggest fixes for missing tools")
 @click.option("--export", type=click.Path(), help="Export diagnostics to JSON file")
 @click.option("--check", type=str, help="Check specific tool only")
-@click.option(
-    "--check-commands", is_flag=True, help="Diagnose slash command loading issues"
-)
+@click.option("--check-commands", is_flag=True, help="Diagnose slash command loading issues")
 def doctor(
     verbose: bool,
     fix: bool,
@@ -92,9 +90,7 @@ def doctor(
             diagnostics_data["detected_language"] = language
 
             if verbose:
-                console.print(
-                    f"[dim]Detected language: {language or 'Unknown'}[/dim]\n"
-                )
+                console.print(f"[dim]Detected language: {language or 'Unknown'}[/dim]\n")
 
             if language:
                 checker = SystemChecker()
@@ -138,22 +134,16 @@ def doctor(
             console.print("\n[green]✓ All checks passed[/green]")
         else:
             console.print("\n[yellow]⚠ Some checks failed[/yellow]")
-            console.print(
-                "[dim]Run [cyan]python -m moai_adk doctor --verbose[/cyan] for detailed diagnostics[/dim]"
-            )
+            console.print("[dim]Run [cyan]python -m moai_adk doctor --verbose[/cyan] for detailed diagnostics[/dim]")
 
     except Exception as e:
         console.print(f"[red]✗ Diagnostic failed: {e}[/red]")
         raise
 
 
-def _display_language_tools(
-    language: str, tools: dict[str, bool], checker: SystemChecker
-) -> None:
+def _display_language_tools(language: str, tools: dict[str, bool], checker: SystemChecker) -> None:
     """Display a table of language-specific tools (helper)"""
-    table = Table(
-        show_header=True, header_style="bold cyan", title=f"{language.title()} Tools"
-    )
+    table = Table(show_header=True, header_style="bold cyan", title=f"{language.title()} Tools")
     table.add_column("Tool", style="dim")
     table.add_column("Status", justify="center")
     table.add_column("Version", style="blue")
@@ -278,7 +268,5 @@ def _check_slash_commands() -> None:
     elif total == 0:
         console.print("[yellow]⚠ No command files found in .claude/commands/[/yellow]")
     else:
-        console.print(
-            f"[yellow]⚠ Only {valid}/{total} command files are valid[/yellow]"
-        )
+        console.print(f"[yellow]⚠ Only {valid}/{total} command files are valid[/yellow]")
         console.print("[dim]Fix the issues above to enable slash commands[/dim]")