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

moai_adk/__init__.py

@@ -1,4 +1,3 @@
-# @CODE:PY314-001 | SPEC: SPEC-PY314-001.md | TEST: tests/unit/test_foundation.py
 """MoAI Agentic Development Kit
 
 SPEC-First TDD Framework with Alfred SuperAgent
@@ -9,6 +8,6 @@ from importlib.metadata import PackageNotFoundError, version
 try:
     __version__ = version("moai-adk")
 except PackageNotFoundError:
-    __version__ = "0.5.6-dev"
+    __version__ = "0.23.0-dev"
 
 __all__ = ["__version__"]

moai_adk/__main__.py

@@ -1,4 +1,4 @@
-# @CODE:CLI-001 | SPEC: SPEC-CLI-001/spec.md | TEST: tests/unit/test_cli_commands.py
+# type: ignore
 """MoAI-ADK CLI Entry Point
 
 Implements the CLI entry point:
@@ -19,6 +19,7 @@ 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
 
@@ -32,7 +33,10 @@ def show_logo() -> None:
 
     # Print with Rich styling
     console.print(logo, style="cyan bold", highlight=False)
-    console.print("  Modu-AI's Agentic Development Kit w/ SuperAgent 🎩 Alfred", style="yellow bold")
+    console.print(
+        "  Modu-AI's Agentic Development Kit w/ SuperAgent 🎩 Alfred",
+        style="yellow bold",
+    )
     console.print()
     console.print("  Version: ", style="green", end="")
     console.print(__version__, style="cyan bold")
@@ -54,13 +58,92 @@ def cli(ctx: click.Context) -> None:
     if ctx.invoked_subcommand is 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")
+@click.option(
+    "--file",
+    "-f",
+    default="README.ko.md",
+    help="검증할 파일 경로 (기본값: README.ko.md)",
+)
+@click.option(
+    "--max-concurrent",
+    "-c",
+    type=int,
+    default=3,
+    help="동시에 검증할 최대 링크 수 (기본값: 3)",
+)
+@click.option(
+    "--timeout", "-t", type=int, default=8, help="요청 타임아웃 (초) (기본값: 8)"
+)
+@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)",
+)
+@click.option("--output", "-o", help="분석 결과를 저장할 파일 경로")
+@click.option(
+    "--format",
+    "-f",
+    type=click.Choice(["json", "markdown", "text"]),
+    default="markdown",
+    help="출력 형식 (기본값: markdown)",
+)
+@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):
+    """사용자 경험 개선 분석"""
+
+    # 임시 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 명령 실행
+    from moai_adk.cli.commands.improve_user_experience import (
+        run_command as improve_ux_run,
+    )
+
+    sys.exit(improve_ux_run(args))
+
+
+cli.add_command(validate_links)
+cli.add_command(improve_ux)
+
+
 def main() -> int:
     """CLI entry point"""
     try:

moai_adk/cli/__init__.py

@@ -1,2 +1 @@
-# @CODE:PY314-001 | SPEC: SPEC-PY314-001.md | TEST: tests/unit/test_foundation.py
 """CLI module: Click-based command-line interface"""

moai_adk/cli/commands/__init__.py

@@ -1,4 +1,3 @@
-# @CODE:CLI-001 | SPEC: SPEC-CLI-001/spec.md | TEST: tests/unit/test_cli_commands.py
 """CLI command module
 
 Core commands:

moai_adk/cli/commands/analyze.py

@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""
+Analyze command for MoAI-ADK
+
+Analyze Claude Code sessions and generate improvement suggestions.
+"""
+
+
+from pathlib import Path
+from typing import Optional
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from moai_adk.core.analysis.session_analyzer import SessionAnalyzer
+
+console = Console()
+
+
+@click.command()
+@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(
+    "--project-path",
+    "-p",
+    type=click.Path(),
+    help="Project root path (default: current directory)",
+)
+def analyze(
+    days: int,
+    output: Optional[Path],
+    verbose: bool,
+    report_only: bool,
+    project_path: Optional[Path],
+):
+    """
+    Analyze Claude Code sessions from the last N days
+
+    Analyzes Claude Code session logs to identify usage patterns,
+    error frequencies, and generate improvement suggestions.
+
+    Examples:
+        moai-adk analyze session
+        moai-adk analyze session --days 14 --verbose
+        moai-adk analyze session --output /path/to/report.md
+    """
+    if project_path is None:
+        project_path = Path.cwd()
+
+    # Validate project path
+    if not (project_path / ".moai").exists():
+        console.print(
+            "[red]Error:[/red] Not a MoAI-ADK project (missing .moai directory)"
+        )
+        console.print(f"[blue]Current path:[/blue] {project_path}")
+        return
+
+    # Initialize analyzer
+    analyzer = SessionAnalyzer(days_back=days, verbose=verbose)
+
+    if not report_only:
+        console.print(f"[blue]📊 Analyzing sessions from last {days} days...[/blue]")
+
+    # Parse sessions
+    patterns = analyzer.parse_sessions()
+
+    if not report_only:
+        console.print(
+            f"[green]✅ Analyzed {patterns['total_sessions']} sessions[/green]"
+        )
+        console.print(f"[blue]   Total events: {patterns['total_events']}[/blue]")
+
+        # Display summary table
+        table = Table(title="Session Summary")
+        table.add_column("Metric", style="cyan")
+        table.add_column("Value", style="green")
+
+        table.add_row("Total Sessions", str(patterns["total_sessions"]))
+        table.add_row("Total Events", str(patterns["total_events"]))
+        table.add_row("Failed Sessions", str(patterns["failed_sessions"]))
+        table.add_row("Success Rate", f"{patterns.get('success_rate', 0):.1f}%")
+
+        console.print(table)
+
+        # 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]
+
+            tools_table = Table()
+            tools_table.add_column("Tool", style="cyan")
+            tools_table.add_column("Usage", style="green")
+
+            for tool, count in top_tools:
+                tools_table.add_row(f"`{tool}`", str(count))
+
+            console.print(tools_table)
+
+    # Save report
+    output_path_obj = Path(output) if output else None
+    report_path = analyzer.save_report(output_path_obj, project_path)
+
+    if not report_only:
+        console.print(f"\n[green]📄 Report saved: {report_path}[/green]")
+
+        # Show key suggestions
+        report_content = analyzer.generate_report()
+        if "💡 Improvement Suggestions" in report_content:
+            console.print("\n[bold yellow]💡 Key Suggestions:[/bold yellow]")
+            # Extract suggestions section
+            suggestions_start = report_content.find("💡 Improvement Suggestions")
+            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
+                for line in lines[:10]:  # Show first 10 lines
+                    if line.strip() and not line.startswith("---"):
+                        console.print(line)

moai_adk/cli/commands/backup.py

@@ -20,9 +20,9 @@ Backup location: .moai-backups/YYYYMMDD-HHMMSS/
    - Tag backup with feature branch name for easier recovery
 
 2. **After restoration from backup**:
-   - Verify with `Skill("moai-foundation-tags")` that TAGs are intact
    - Run `Skill("moai-foundation-trust")` to validate toolchain
 """
+
 from pathlib import Path
 
 import click
@@ -38,7 +38,7 @@ console = Console()
     "--path",
     type=click.Path(exists=True),
     default=".",
-    help="Project path (default: current directory)"
+    help="Project path (default: current directory)",
 )
 def backup(path: str) -> None:
     """Create a backup of the current project.
@@ -64,7 +64,9 @@ def backup(path: str) -> None:
         backup_path = processor.create_backup()
 
         # Success message
-        console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}[/green]")
+        console.print(
+            f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}[/green]"
+        )
 
         # Show backup contents
         backup_items = list(backup_path.iterdir())

moai_adk/cli/commands/doctor.py

@@ -1,5 +1,3 @@
-# @CODE:CLI-001 | SPEC: SPEC-CLI-001/spec.md | TEST: tests/unit/test_doctor.py
-# @CODE:CLAUDE-COMMANDS-001:CLI | SPEC: SPEC-CLAUDE-COMMANDS-001/spec.md | TEST: tests/unit/test_slash_commands.py
 """MoAI-ADK doctor command
 
 System diagnostics command:
@@ -49,12 +47,25 @@ console = Console()
 
 
 @click.command()
-@click.option("--verbose", "-v", is_flag=True, help="Show detailed tool versions and language detection")
+@click.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Show detailed tool versions and language detection",
+)
 @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")
-def doctor(verbose: bool, fix: bool, export: str | None, check: str | None, check_commands: bool) -> None:
+@click.option(
+    "--check-commands", is_flag=True, help="Diagnose slash command loading issues"
+)
+def doctor(
+    verbose: bool,
+    fix: bool,
+    export: str | None,
+    check: str | None,
+    check_commands: bool,
+) -> None:
     """Check system requirements and project health
 
     Verifies:
@@ -81,7 +92,9 @@ def doctor(verbose: bool, fix: bool, export: str | None, check: str | None, chec
             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()
@@ -110,7 +123,10 @@ def doctor(verbose: bool, fix: bool, export: str | None, check: str | None, chec
 
         # In fix mode, suggest installation commands for missing tools
         if fix and "language_tools" in diagnostics_data:
-            _suggest_fixes(diagnostics_data["language_tools"], diagnostics_data.get("detected_language"))
+            _suggest_fixes(
+                diagnostics_data["language_tools"],
+                diagnostics_data.get("detected_language"),
+            )
 
         # When exporting, write diagnostics to JSON
         if export:
@@ -122,16 +138,22 @@ def doctor(verbose: bool, fix: bool, export: str | None, check: str | None, chec
             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")
@@ -256,5 +278,7 @@ 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]")