moai-adk 0.3.0__tar.gz

moai_adk-0.3.0/.gitignore

@@ -0,0 +1,60 @@
+# Build artifacts
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Cache
+__pycache__/
+.pytest_cache/
+*.pyc
+*.pyo
+node_modules/
+*.tsbuildinfo
+.tscache/
+
+# Backups
+.moai-backups/
+*.backup
+*.bak
+
+# Test coverage
+.coverage
+.coverage.*
+coverage.json
+htmlcov/
+.pytest_cache/
+
+# Documentation builds
+site/
+docs/_build/
+
+# Reports (keep .gitkeep)
+.moai/reports/*.md
+.moai/reports/*.json
+.moai/reports/*.html
+
+# Virtual environment
+venv/
+.venv/
+env/
+.env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp

moai_adk-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MoAI-ADK Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

moai_adk-0.3.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: moai-adk
+Version: 0.3.0
+Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.45
+Requires-Dist: pyfiglet>=1.0.2
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.7.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
+Requires-Dist: pytest>=8.4.2; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: security
+Requires-Dist: bandit>=1.8.0; extra == 'security'
+Requires-Dist: pip-audit>=2.7.0; extra == 'security'

moai_adk-0.3.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "moai-adk"
+version = "0.3.0"
+description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent"
+requires-python = ">=3.13"
+dependencies = [
+    "click>=8.1.0",
+    "rich>=13.0.0",
+    "pyfiglet>=1.0.2",
+    "questionary>=2.0.0",
+    "gitpython>=3.1.45"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
+    "pytest-xdist>=3.8.0",
+    "ruff>=0.1.0",
+    "mypy>=1.7.0"
+]
+security = [
+    "pip-audit>=2.7.0",
+    "bandit>=1.8.0"
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+addopts = "-v --cov=src/moai_adk --cov-report=html --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src/moai_adk"]
+omit = ["tests/*", "*/__pycache__/*"]
+parallel = true
+concurrency = ["multiprocessing"]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+skip_covered = false
+fail_under = 85
+
+[tool.ruff]
+line-length = 120
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N"]
+ignore = []
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+# Include Python packages and templates
+packages = ["src/moai_adk"]
+
+# Ensure template files are included in both wheel and editable installs
+[tool.hatch.build]
+include = [
+    "src/moai_adk/**/*.py",
+    "src/moai_adk/templates/**/*",
+    "src/moai_adk/templates/.claude/**/*",
+    "src/moai_adk/templates/.moai/**/*",
+    "src/moai_adk/templates/.github/**/*"
+]
+
+[project.scripts]
+moai-adk = "moai_adk.__main__:main"

moai_adk-0.3.0/src/moai_adk/__init__.py

@@ -0,0 +1,8 @@
+# @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
+"""
+
+__version__ = "0.3.0"
+__all__ = ["__version__"]

moai_adk-0.3.0/src/moai_adk/__main__.py

@@ -0,0 +1,86 @@
+# @CODE:CLI-001 | SPEC: SPEC-CLI-001.md | TEST: tests/unit/test_cli_commands.py
+"""MoAI-ADK CLI Entry Point
+
+Implements the CLI entry point:
+- Click-based CLI framework
+- Rich console terminal output
+- ASCII logo rendering
+- --version and --help options
+- Six core commands: init, doctor, status, backup, restore, update
+"""
+
+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.restore import restore
+from moai_adk.cli.commands.status import status
+from moai_adk.cli.commands.update import update
+
+console = Console()
+
+
+def show_logo() -> None:
+    """Render the MoAI-ADK ASCII logo with Pyfiglet"""
+    # Generate the "MoAI-ADK" banner using the ansi_shadow font
+    logo = pyfiglet.figlet_format("MoAI-ADK", font="ansi_shadow")
+
+    # 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()
+    console.print("  Version: ", style="green", end="")
+    console.print(__version__, style="cyan bold")
+    console.print()
+    console.print("  Tip: Run ", style="yellow", end="")
+    console.print("python -m moai_adk --help", style="cyan", end="")
+    console.print(" to see available commands", style="yellow")
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(version=__version__, prog_name="MoAI-ADK")
+@click.pass_context
+def cli(ctx: click.Context) -> None:
+    """MoAI Agentic Development Kit
+
+    SPEC-First TDD Framework with Alfred SuperAgent
+    """
+    # Display the logo when no subcommand is invoked
+    if ctx.invoked_subcommand is None:
+        show_logo()
+
+cli.add_command(init)
+cli.add_command(doctor)
+cli.add_command(status)
+cli.add_command(restore)
+cli.add_command(backup)
+cli.add_command(update)
+
+
+def main() -> int:
+    """CLI entry point"""
+    try:
+        cli(standalone_mode=False)
+        return 0
+    except click.Abort:
+        # User cancelled with Ctrl+C
+        return 130
+    except click.ClickException as e:
+        e.show()
+        return e.exit_code
+    except Exception as e:
+        console.print(f"[red]Error:[/red] {e}")
+        return 1
+    finally:
+        # Flush the output buffer explicitly
+        console.file.flush()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

moai_adk-0.3.0/src/moai_adk/cli/__init__.py

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

moai_adk-0.3.0/src/moai_adk/cli/commands/__init__.py

@@ -0,0 +1,16 @@
+# @CODE:CLI-001 | SPEC: SPEC-CLI-001.md | TEST: tests/unit/test_cli_commands.py
+"""CLI command module
+
+Four core commands:
+- init: initialize the project
+- doctor: run system diagnostics
+- status: show project status
+- restore: restore backups
+"""
+
+from moai_adk.cli.commands.doctor import doctor
+from moai_adk.cli.commands.init import init
+from moai_adk.cli.commands.restore import restore
+from moai_adk.cli.commands.status import status
+
+__all__ = ["init", "doctor", "status", "restore"]

moai_adk-0.3.0/src/moai_adk/cli/commands/backup.py

@@ -0,0 +1,56 @@
+"""Backup command"""
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+from moai_adk.core.template.processor import TemplateProcessor
+
+console = Console()
+
+
+@click.command()
+@click.option(
+    "--path",
+    type=click.Path(exists=True),
+    default=".",
+    help="Project path (default: current directory)"
+)
+def backup(path: str) -> None:
+    """Create a backup of the current project.
+
+    Includes:
+    - .claude/ (entire directory)
+    - .moai/ (excluding specs and reports)
+    - CLAUDE.md
+
+    Backup location: .moai-backup/YYYYMMDD-HHMMSS/
+    """
+    try:
+        project_path = Path(path).resolve()
+
+        # Verify the project has been initialized
+        if not (project_path / ".moai").exists():
+            console.print("[yellow]⚠ Project not initialized[/yellow]")
+            raise click.Abort()
+
+        # Create the backup
+        console.print("[cyan]💾 Creating backup...[/cyan]")
+        processor = TemplateProcessor(project_path)
+        backup_path = processor.create_backup()
+
+        # Success message
+        console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}[/green]")
+
+        # Show backup contents
+        backup_items = list(backup_path.iterdir())
+        for item in backup_items:
+            if item.is_dir():
+                file_count = len(list(item.rglob("*")))
+                console.print(f"   ├─ {item.name}/ ({file_count} files)")
+            else:
+                console.print(f"   └─ {item.name}")
+
+    except Exception as e:
+        console.print(f"[red]✗ Backup failed: {e}[/red]")
+        raise click.ClickException(str(e)) from e

moai_adk-0.3.0/src/moai_adk/cli/commands/doctor.py

@@ -0,0 +1,184 @@
+# @CODE:CLI-001 | SPEC: SPEC-CLI-001.md | TEST: tests/unit/test_doctor.py
+"""MoAI-ADK doctor command
+
+System diagnostics command:
+- Check the Python version
+- Verify Git installation
+- Validate project structure
+- Inspect language-specific tool chains
+"""
+
+import json
+from pathlib import Path
+
+import click
+import questionary
+from rich.console import Console
+from rich.table import Table
+
+from moai_adk.core.project.checker import SystemChecker, check_environment
+from moai_adk.core.project.detector import detect_project_language
+
+console = Console()
+
+
+@click.command()
+@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")
+def doctor(verbose: bool, fix: bool, export: str | None, check: str | None) -> None:
+    """Check system requirements and project health
+
+    Verifies:
+    - Python version (>= 3.13)
+    - Git installation
+    - Project structure (.moai directory)
+    - Language-specific tool chains (20+ languages)
+    """
+    try:
+        console.print("[cyan]Running system diagnostics...[/cyan]\n")
+
+        # Run basic environment checks
+        results = check_environment()
+        diagnostics_data: dict = {"basic_checks": results}
+
+        # In verbose mode, verify language-specific toolchains
+        if verbose or fix:
+            language = detect_project_language()
+            diagnostics_data["detected_language"] = language
+
+            if verbose:
+                console.print(f"[dim]Detected language: {language or 'Unknown'}[/dim]\n")
+
+            if language:
+                checker = SystemChecker()
+                language_tools = checker.check_language_tools(language)
+                diagnostics_data["language_tools"] = language_tools
+
+                if verbose:
+                    _display_language_tools(language, language_tools, checker)
+
+        # Specific tool check
+        if check:
+            _check_specific_tool(check)
+            return
+
+        # Build the base results table
+        table = Table(show_header=True, header_style="bold magenta")
+        table.add_column("Check", style="dim", width=40)
+        table.add_column("Status", justify="center")
+
+        for check_name, status in results.items():
+            icon = "✓" if status else "✗"
+            color = "green" if status else "red"
+            table.add_row(check_name, f"[{color}]{icon}[/{color}]")
+
+        console.print(table)
+
+        # 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"))
+
+        # When exporting, write diagnostics to JSON
+        if export:
+            _export_diagnostics(export, diagnostics_data)
+
+        # Summarize the overall result
+        all_passed = all(results.values())
+        if all_passed:
+            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]")
+
+    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:
+    """Display a table of language-specific tools (helper)"""
+    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")
+
+    for tool, available in tools.items():
+        icon = "✓" if available else "✗"
+        color = "green" if available else "red"
+        version = checker.get_tool_version(tool) if available else "not installed"
+
+        table.add_row(tool, f"[{color}]{icon}[/{color}]", version or "")
+
+    console.print(table)
+    console.print()
+
+
+def _check_specific_tool(tool: str) -> None:
+    """Check only a specific tool (helper)"""
+    checker = SystemChecker()
+    available = checker._is_tool_available(tool)
+    version = checker.get_tool_version(tool) if available else None
+
+    if available:
+        console.print(f"[green]✓ {tool} is installed[/green]")
+        if version:
+            console.print(f"  Version: {version}")
+    else:
+        console.print(f"[red]✗ {tool} is not installed[/red]")
+
+
+def _suggest_fixes(tools: dict[str, bool], language: str | None) -> None:
+    """Suggest installation commands for missing tools (helper)"""
+    missing_tools = [tool for tool, available in tools.items() if not available]
+
+    if not missing_tools:
+        console.print("\n[green]✓ All tools are installed[/green]")
+        return
+
+    console.print(f"\n[yellow]⚠ Missing {len(missing_tools)} tool(s)[/yellow]")
+
+    try:
+        proceed = questionary.confirm(
+            "Would you like to see install suggestions for missing tools?",
+            default=True,
+        ).ask()
+    except Exception:
+        proceed = True
+
+    if not proceed:
+        console.print("[yellow]User skipped install suggestions[/yellow]")
+        return
+
+    for tool in missing_tools:
+        install_cmd = _get_install_command(tool, language)
+        console.print(f"  [red]✗[/red] {tool}")
+        if install_cmd:
+            console.print(f"    Install: [cyan]{install_cmd}[/cyan]")
+
+
+def _get_install_command(tool: str, language: str | None) -> str:
+    """Return the install command for a given tool (helper)"""
+    # Common tools
+    install_commands = {
+        "pytest": "pip install pytest",
+        "mypy": "pip install mypy",
+        "ruff": "pip install ruff",
+        "vitest": "npm install -D vitest",
+        "biome": "npm install -D @biomejs/biome",
+        "eslint": "npm install -D eslint",
+        "jest": "npm install -D jest",
+    }
+
+    return install_commands.get(tool, f"# Install {tool} for {language}")
+
+
+def _export_diagnostics(export_path: str, data: dict) -> None:
+    """Export diagnostic results to a JSON file (helper)"""
+    try:
+        output = Path(export_path)
+        output.write_text(json.dumps(data, indent=2))
+        console.print(f"\n[green]✓ Diagnostics exported to {export_path}[/green]")
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to export diagnostics: {e}[/red]")