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

moai_adk/cli/commands/improve_user_experience.py

@@ -1,348 +0,0 @@
-"""
-User Experience Improvement CLI Command
-"""
-
-import argparse
-import asyncio
-from pathlib import Path
-
-from rich.console import Console
-from rich.panel import Panel
-from rich.progress import Progress, SpinnerColumn, TextColumn
-from rich.table import Table
-
-from moai_adk.utils.user_experience import (
-    UserExperienceAnalyzer,
-    generate_improvement_plan,
-)
-
-console = Console()
-
-
-def create_parser(subparsers) -> argparse.ArgumentParser:
-    """Create user experience improvement parser"""
-    parser = subparsers.add_parser(
-        "improve-ux",
-        help="Analyze user experience improvements",
-        description="Analyze user experience of online documentation portal and provide improvement plan",
-    )
-
-    parser.add_argument(
-        "--url",
-        "-u",
-        type=str,
-        default="https://adk.mo.ai.kr",
-        help="URL to analyze (default: https://adk.mo.ai.kr)",
-    )
-
-    parser.add_argument(
-        "--output", "-o", type=str, help="File path to save analysis results"
-    )
-
-    parser.add_argument(
-        "--format",
-        "-f",
-        type=str,
-        choices=["json", "markdown", "text"],
-        default="markdown",
-        help="Output format (default: markdown)",
-    )
-
-    parser.add_argument(
-        "--verbose", "-v", action="store_true", help="Display detailed progress"
-    )
-
-    parser.add_argument(
-        "--max-workers",
-        "-w",
-        type=int,
-        default=5,
-        help="Maximum number of concurrent tasks (default: 5)",
-    )
-
-    return parser
-
-
-def format_metrics_table(metrics: dict) -> Table:
-    """Format metrics table"""
-    table = Table(title="User Experience Metrics")
-    table.add_column("Category", style="cyan")
-    table.add_column("Score", style="magenta")
-    table.add_column("Status", style="green")
-
-    # Performance metrics
-    perf = metrics.get("performance")
-    table.add_row(
-        "Performance",
-        f"{perf.success_rate if perf else 0:.2f}",
-        "✅ Good" if (perf and perf.is_good) else "❌ Needs Improvement",
-    )
-
-    # Navigation metrics
-    nav = metrics.get("navigation")
-    table.add_row(
-        "Navigation",
-        f"{nav.structure_score if nav else 0:.2f}",
-        "✅ Good" if (nav and nav.is_good) else "❌ Needs Improvement",
-    )
-
-    # Content metrics
-    content = metrics.get("content")
-    table.add_row(
-        "Content",
-        f"{content.accuracy_score if content else 0:.2f}",
-        "✅ Good" if (content and content.is_good) else "❌ Needs Improvement",
-    )
-
-    # Accessibility metrics
-    acc = metrics.get("accessibility")
-    table.add_row(
-        "Accessibility",
-        f"{1.0 if (acc and acc.is_good) else 0.0:.2f}",
-        "✅ Good" if (acc and acc.is_good) else "❌ Needs Improvement",
-    )
-
-    return table
-
-
-def format_recommendations(recommendations: list) -> Table:
-    """Format recommendations table"""
-    table = Table(title="Improvement Recommendations")
-    table.add_column("Recommendation", style="yellow")
-    table.add_column("Priority", style="red")
-
-    for i, rec in enumerate(recommendations, 1):
-        priority = "Medium"  # Default
-        if (
-            "error" in rec.lower()
-            or "keyboard" in rec.lower()
-            or "accuracy" in rec.lower()
-        ):
-            priority = "High"
-        elif "performance" in rec.lower() or "structure" in rec.lower():
-            priority = "Medium"
-        else:
-            priority = "Low"
-
-        table.add_row(f"{i}. {rec}", priority)
-
-    return table
-
-
-def format_timeline(timeline: dict) -> Table:
-    """Format timeline table"""
-    table = Table(title="Implementation Plan")
-    table.add_column("Period", style="cyan")
-    table.add_column("Tasks", style="magenta")
-
-    for period, tasks in timeline.items():
-        if tasks:
-            table.add_row(
-                period.replace("_", " ").title(),
-                "\n".join(f"• {task}" for task in tasks),
-            )
-
-    return table
-
-
-async def analyze_user_experience(
-    url: str, max_workers: int = 5, verbose: bool = False
-) -> dict:
-    """Perform user experience analysis"""
-    if verbose:
-        console.print(f"[blue]Starting user experience analysis: {url}[/blue]")
-
-    analyzer = UserExperienceAnalyzer(url, max_workers=max_workers)
-
-    with Progress(
-        SpinnerColumn(),
-        TextColumn("[progress.description]{task.description}"),
-        console=console,
-        transient=True,
-    ) as progress:
-        # Create analysis task
-        analysis_task = progress.add_task("Analyzing user experience...", total=None)
-
-        # Execute analysis
-        analysis_report = await analyzer.generate_report()
-
-        progress.update(analysis_task, completed=True)
-
-    return analysis_report
-
-
-def generate_markdown_report(analysis_report: dict, improvement_plan: dict) -> str:
-    """Generate markdown report"""
-    report = []
-
-    # Header
-    report.append("# User Experience Improvement Report")
-    report.append("")
-    report.append(f"**Analysis Target**: {analysis_report.get('base_url', 'N/A')}")
-    report.append(f"**Analysis Time**: {analysis_report.get('generated_at', 'N/A')}")
-    report.append("")
-
-    # Overall score
-    overall_score = analysis_report.get("overall_score", 0)
-    report.append(f"## Overall Score: {overall_score:.2f}")
-    report.append("")
-
-    # Metrics details
-    report.append("### Metrics Details")
-    report.append("")
-
-    # Performance metrics
-    performance = analysis_report.get("performance")
-    report.append("#### Performance")
-    report.append(
-        f"- Success Rate: {performance.success_rate if performance else 0:.2f}"
-    )
-    report.append(
-        f"- Average Load Time: {performance.load_time if performance else 0:.2f}s"
-    )
-    report.append(
-        f"- Response Time: {performance.response_time if performance else 0:.2f}s"
-    )
-    report.append(f"- Error Rate: {performance.error_rate if performance else 0:.2f}")
-    report.append("")
-
-    # Navigation metrics
-    navigation = analysis_report.get("navigation")
-    report.append("#### Navigation")
-    report.append(
-        f"- Structure Score: {navigation.structure_score if navigation else 0:.2f}"
-    )
-    report.append(f"- Link Count: {navigation.link_count if navigation else 0}")
-    report.append(f"- Depth: {navigation.depth if navigation else 0}")
-    report.append(f"- Completeness: {navigation.completeness if navigation else 0:.2f}")
-    report.append("")
-
-    # Content metrics
-    content = analysis_report.get("content")
-    report.append("#### Content")
-    report.append(f"- Accuracy: {content.accuracy_score if content else 0:.2f}")
-    report.append(f"- Completeness: {content.completeness_score if content else 0:.2f}")
-    report.append(f"- Organization: {content.organization_score if content else 0:.2f}")
-    report.append(f"- Readability: {content.readability_score if content else 0:.2f}")
-    report.append("")
-
-    # Accessibility metrics
-    accessibility = analysis_report.get("accessibility")
-    report.append("#### Accessibility")
-    report.append(
-        f"- Keyboard Navigation: {'✅' if (accessibility and accessibility.keyboard_navigation) else '❌'}"
-    )
-    report.append(
-        f"- Screen Reader Support: {'✅' if (accessibility and accessibility.screen_reader_support) else '❌'}"
-    )
-    report.append(
-        f"- Color Contrast: {'✅' if (accessibility and accessibility.color_contrast) else '❌'}"
-    )
-    report.append(
-        f"- Responsive Design: {'✅' if (accessibility and accessibility.responsive_design) else '❌'}"
-    )
-    report.append(
-        f"- ARIA Labels: {'✅' if (accessibility and accessibility.aria_labels) else '❌'}"
-    )
-    report.append("")
-
-    # Recommendations
-    report.append("### Improvement Recommendations")
-    report.append("")
-    for rec in analysis_report.get("recommendations", []):
-        report.append(f"- {rec}")
-    report.append("")
-
-    # Implementation plan
-    report.append("### Implementation Plan")
-    report.append("")
-    report.append(
-        f"**Estimated Duration**: {improvement_plan.get('estimated_duration', 'N/A')}"
-    )
-    report.append("")
-
-    timeline = improvement_plan.get("timeline", {})
-    for period, tasks in timeline.items():
-        if tasks:
-            report.append(f"#### {period.replace('_', ' ').title()}")
-            for task in tasks:
-                report.append(f"- {task}")
-            report.append("")
-
-    return "\n".join(report)
-
-
-def run_command(args) -> int:
-    """Run user experience improvement command"""
-    try:
-        # Execute analysis
-        analysis_report = asyncio.run(
-            analyze_user_experience(args.url, args.max_workers, args.verbose)
-        )
-
-        # Generate improvement plan
-        improvement_plan = generate_improvement_plan(analysis_report)
-
-        # Display results
-        if args.verbose:
-            console.print(
-                Panel.fit(
-                    f"Overall Score: {analysis_report['overall_score']:.2f}",
-                    title="Analysis Results",
-                    style="blue",
-                )
-            )
-
-        # Display metrics table
-        metrics_table = format_metrics_table(analysis_report)
-        console.print(metrics_table)
-
-        # Display recommendations
-        if analysis_report.get("recommendations"):
-            recommendations_table = format_recommendations(
-                analysis_report["recommendations"]
-            )
-            console.print(recommendations_table)
-
-        # Display implementation plan
-        if improvement_plan.get("timeline"):
-            timeline_table = format_timeline(improvement_plan["timeline"])
-            console.print(timeline_table)
-
-        # Save results
-        if args.output:
-            if args.format == "json":
-                import json
-
-                result = {
-                    "analysis": analysis_report,
-                    "improvement_plan": improvement_plan,
-                }
-                output_content = json.dumps(result, indent=2, ensure_ascii=False)
-            else:
-                output_content = generate_markdown_report(
-                    analysis_report, improvement_plan
-                )
-
-            output_path = Path(args.output)
-            output_path.write_text(output_content, encoding="utf-8")
-            console.print(f"\n[green]Results saved:[/green] {output_path}")
-
-        # Return exit code
-        if analysis_report["overall_score"] >= 0.85:
-            console.print(
-                f"\n[green]✅ User experience is excellent (score: {analysis_report['overall_score']:.2f})[/green]"
-            )
-            return 0
-        else:
-            console.print(
-                f"\n[yellow]⚠️  User experience needs improvement (score: {analysis_report['overall_score']:.2f})[/yellow]"
-            )
-            return 1
-
-    except KeyboardInterrupt:
-        console.print("\n[yellow]Analysis interrupted by user.[/yellow]")
-        return 1
-    except Exception as e:
-        console.print(f"[red]Error occurred:[/red] {e}")
-        return 1

moai_adk/cli/commands/migrate.py

@@ -1,158 +0,0 @@
-"""
-Migration CLI command for MoAI-ADK
-
-Provides command-line interface for project version migrations.
-"""
-
-import logging
-import sys
-from pathlib import Path
-
-import click
-
-from moai_adk.core.migration import VersionMigrator
-
-logger = logging.getLogger(__name__)
-
-
-@click.command()
-@click.option(
-    "--check",
-    is_flag=True,
-    help="Check if migration is needed without executing",
-)
-@click.option(
-    "--dry-run",
-    is_flag=True,
-    help="Show migration plan without making changes",
-)
-@click.option(
-    "--no-cleanup",
-    is_flag=True,
-    help="Keep old files after migration",
-)
-@click.option(
-    "--rollback",
-    is_flag=True,
-    help="Rollback to the latest backup",
-)
-@click.option(
-    "--list-backups",
-    is_flag=True,
-    help="List available backups",
-)
-def migrate(check, dry_run, no_cleanup, rollback, list_backups):
-    """
-    Migrate MoAI-ADK project to the latest version
-
-    This command automatically migrates your project structure to match
-    the latest MoAI-ADK version. It creates backups before migration
-    and can rollback if issues occur.
-
-    Examples:
-
-        # Check if migration is needed
-        moai-adk migrate --check
-
-        # Preview migration plan
-        moai-adk migrate --dry-run
-
-        # Execute migration
-        moai-adk migrate
-
-        # Migrate without cleaning up old files
-        moai-adk migrate --no-cleanup
-
-        # Rollback to latest backup
-        moai-adk migrate --rollback
-
-        # List available backups
-        moai-adk migrate --list-backups
-    """
-    try:
-        project_root = Path.cwd()
-        migrator = VersionMigrator(project_root)
-
-        # List backups
-        if list_backups:
-            backups = migrator.backup_manager.list_backups()
-            if not backups:
-                click.echo("📦 No backups found")
-                return
-
-            click.echo("📦 Available backups:\n")
-            for i, backup in enumerate(backups, 1):
-                click.echo(f"{i}. {backup['description']} ({backup['timestamp']})")
-                click.echo(f"   Path: {backup['path']}")
-                click.echo(f"   Files: {backup['files']}")
-                click.echo()
-            return
-
-        # Rollback
-        if rollback:
-            click.echo("🔙 Rolling back to latest backup...")
-            if migrator.rollback_to_latest_backup():
-                click.echo("✅ Rollback completed successfully")
-                sys.exit(0)
-            else:
-                click.echo("❌ Rollback failed", err=True)
-                sys.exit(1)
-
-        # Check status
-        if check:
-            status = migrator.check_status()
-            version_info = status["version"]
-            migration_info = status["migration"]
-
-            click.echo("📊 Migration Status:\n")
-            click.echo(f"Current Version: {version_info['detected_version']}")
-            click.echo(
-                f"Needs Migration: {'Yes' if version_info['needs_migration'] else 'No'}"
-            )
-
-            if version_info["needs_migration"]:
-                click.echo(f"Target Version: {migration_info['target_version']}")
-                click.echo(f"Files to migrate: {migration_info['file_count']}")
-                click.echo("\n💡 Run 'moai-adk migrate' to execute migration")
-            else:
-                click.echo("\n✅ Project is up to date")
-
-            return
-
-        # Dry run
-        if dry_run:
-            if migrator.needs_migration():
-                migrator.migrate_to_v024(dry_run=True)
-            else:
-                click.echo("✅ Project is already up to date")
-            return
-
-        # Execute migration
-        if not migrator.needs_migration():
-            click.echo("✅ Project is already up to date")
-            return
-
-        click.echo("🚀 MoAI-ADK Project Migration\n")
-        click.echo("This will migrate your project to v0.24.0")
-        click.echo("A backup will be created automatically\n")
-
-        # Confirm with user
-        if not click.confirm("Do you want to proceed?"):
-            click.echo("❌ Migration cancelled")
-            return
-
-        # Execute migration
-        success = migrator.migrate_to_v024(dry_run=False, cleanup=not no_cleanup)
-
-        if success:
-            click.echo("\n🎉 Migration completed successfully!")
-            sys.exit(0)
-        else:
-            click.echo("\n❌ Migration failed", err=True)
-            click.echo("💡 Use 'moai-adk migrate --rollback' to restore from backup")
-            sys.exit(1)
-
-    except Exception as e:
-        logger.error(f"Migration command failed: {e}", exc_info=True)
-        click.echo(f"❌ Error: {e}", err=True)
-        sys.exit(1)

moai_adk/cli/commands/validate_links.py

@@ -1,118 +0,0 @@
-"""
-Link Validation CLI Command
-
-Validate online documentation links
-"""
-
-import argparse
-import asyncio
-from pathlib import Path
-
-from moai_adk.utils.link_validator import LinkValidator
-
-
-def create_parser(subparsers) -> argparse.ArgumentParser:
-    """Create link validation parser"""
-    parser = subparsers.add_parser(
-        "validate-links",
-        help="Validate online documentation links",
-        description="Automatically validate all online documentation links in README.ko.md",
-    )
-
-    parser.add_argument(
-        "--file",
-        "-f",
-        type=str,
-        default="README.ko.md",
-        help="File path to validate (default: README.ko.md)",
-    )
-
-    parser.add_argument(
-        "--max-concurrent",
-        "-c",
-        type=int,
-        default=3,
-        help="Maximum number of links to validate concurrently (default: 3)",
-    )
-
-    parser.add_argument(
-        "--timeout",
-        "-t",
-        type=int,
-        default=8,
-        help="Request timeout in seconds (default: 8)",
-    )
-
-    parser.add_argument("--output", "-o", type=str, help="File path to save results")
-
-    parser.add_argument(
-        "--verbose",
-        "-v",
-        action="store_true",
-        help="Display detailed progress information",
-    )
-
-    return parser
-
-
-def run_command(args) -> int:
-    """Execute link validation command"""
-    try:
-        # Configure file path
-        file_path = Path(args.file)
-        if not file_path.exists():
-            print(f"Error: File does not exist: {file_path}")
-            return 1
-
-        # Create validator
-        validator = LinkValidator(
-            max_concurrent=args.max_concurrent, timeout=args.timeout
-        )
-
-        if args.verbose:
-            print(f"Extracting links from file: {file_path}")
-
-        # Extract links
-        links = validator.extract_links_from_file(file_path)
-
-        if not links:
-            print("No links to validate.")
-            return 0
-
-        if args.verbose:
-            print(f"Validating a total of {len(links)} links...")
-
-        # Execute async validation
-        async def validate_links():
-            async with validator:
-                result = await validator.validate_all_links(links)
-                return result
-
-        result = asyncio.run(validate_links())
-
-        # Generate report
-        report = validator.generate_report(result)
-
-        # Output
-        print(report)
-
-        # Save to file
-        if args.output:
-            output_path = Path(args.output)
-            output_path.write_text(report, encoding="utf-8")
-            print(f"\nResults saved to: {output_path}")
-
-        # Return exit code
-        if result.invalid_links > 0:
-            print(f"\n⚠️  {result.invalid_links} link(s) failed validation.")
-            return 1
-        else:
-            print("\n✅ All links validated successfully.")
-            return 0
-
-    except KeyboardInterrupt:
-        print("\nValidation cancelled by user.")
-        return 1
-    except Exception as e:
-        print(f"Error occurred: {e}")
-        return 1