moai-adk 0.4.5__py3-none-any.whl → 0.20.1__py3-none-any.whl

moai_adk/cli/commands/init.py

@@ -1,4 +1,4 @@
-# @CODE:CLI-001 | @CODE:INIT-003:CLI
+# @CODE:CLI-003 | @CODE:INIT-005:CLI
 # SPEC: SPEC-CLI-001.md, SPEC-INIT-003.md
 # TEST: tests/unit/test_cli_commands.py, tests/unit/test_init_reinit.py
 """MoAI-ADK init command
@@ -6,6 +6,25 @@
 Project initialization command (interactive/non-interactive):
 - Interactive Mode: Ask user for project settings
 - Non-Interactive Mode: Use defaults or CLI options
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-langs**: For language detection and stack configuration
+  - Trigger: When language parameter is not specified (auto-detection)
+  - Invocation: Called implicitly during project initialization for language matrix detection
+
+### When to Invoke Skills in Related Workflows
+1. **After project initialization**:
+   - Run `Skill("moai-foundation-trust")` to verify project structure and toolchain
+   - Run `Skill("moai-foundation-langs")` to validate detected language stack
+
+2. **Before first SPEC creation**:
+   - Use `Skill("moai-alfred-language-detection")` to confirm language selection
+
+3. **Project reinitialization** (`--force`):
+   - Skills automatically adapt to new project structure
+   - No manual intervention required
 """
 
 import json
@@ -18,6 +37,7 @@ from rich.progress import BarColumn, Progress, SpinnerColumn, TaskID, TextColumn
 
 from moai_adk import __version__
 from moai_adk.cli.prompts import prompt_project_setup
+from moai_adk.core.mcp.setup import MCPSetupManager
 from moai_adk.core.project.initializer import ProjectInitializer
 from moai_adk.utils.banner import print_banner, print_welcome_message
 
@@ -76,6 +96,17 @@ def create_progress_callback(progress: Progress, task_ids: Sequence[TaskID]):
     default=None,
     help="Programming language (auto-detect if not specified)",
 )
+@click.option(
+    "--with-mcp",
+    multiple=True,
+    type=click.Choice(["context7", "figma", "playwright", "sequential-thinking"]),
+    help="Install MCP servers automatically (can be used multiple times)",
+)
+@click.option(
+    "--mcp-auto",
+    is_flag=True,
+    help="Auto-install all recommended MCP servers",
+)
 @click.option(
     "--force",
     is_flag=True,
@@ -87,6 +118,8 @@ def init(
     mode: str,
     locale: str,
     language: str | None,
+    with_mcp: tuple,
+    mcp_auto: bool,
     force: bool,
 ) -> None:
     """Initialize a new MoAI-ADK project
@@ -97,6 +130,8 @@ def init(
         mode: Project mode (personal/team)
         locale: Preferred language (ko/en). When omitted, defaults to en.
         language: Programming language
+        with_mcp: Install specific MCP servers (can be used multiple times)
+        mcp_auto: Auto-install all recommended MCP servers
         force: Force reinitialize without confirmation
     """
     try:
@@ -115,10 +150,29 @@ def init(
             )
             project_name = project_path.name if is_current_dir else path
             locale = locale or "en"
+            # Language detection happens in /alfred:0-project, so default to None here
+            # This will become "generic" internally, but Summary will show more helpful message
+            if not language:
+                language = None
+
+            # Handle MCP options in non-interactive mode
+            if mcp_auto:
+                mcp_servers = ["context7", "playwright", "sequential-thinking"]
+                console.print("[cyan]🔧 MCP servers:[/cyan] Auto-installing all recommended servers")
+            elif with_mcp:
+                mcp_servers = list(with_mcp)
+                console.print(f"[cyan]🔧 MCP servers:[/cyan] {', '.join(mcp_servers)}")
+            else:
+                mcp_servers = []
         else:
             # Interactive Mode
             print_welcome_message()
 
+            # Check for MCP CLI options in interactive mode (warn user)
+            if mcp_auto or with_mcp:
+                console.print("[yellow]⚠️  MCP options ignored in interactive mode[/yellow]")
+                console.print("   Please use the interactive prompts instead.\n")
+
             # Interactive prompt
             answers = prompt_project_setup(
                 project_name=None if is_current_dir else path,
@@ -132,6 +186,7 @@ def init(
             locale = answers["locale"]
             language = answers["language"]
             project_name = answers["project_name"]
+            mcp_servers = answers.get("mcp_servers", [])
 
             console.print("\n[cyan]🚀 Starting installation...[/cyan]\n")
 
@@ -148,7 +203,7 @@ def init(
             else:
                 # Interactive mode: Simple notification
                 console.print("\n[cyan]🔄 Reinitializing project...[/cyan]")
-                console.print("   Backup will be created at .moai-backups/{timestamp}/\n")
+                console.print("   Backup will be created at .moai-backups/backup/\n")
 
         # 5. Initialize project (Progress Bar with 5 phases)
         # Always allow reinit (force mode by default)
@@ -156,6 +211,18 @@ def init(
 
         # Reinit mode: set config.json optimized to false (v0.3.1+)
         if is_reinit:
+            # Migration: Remove old hook files (Issue #163)
+            old_hook_files = [
+                ".claude/hooks/alfred/session_start__startup.py",  # v0.8.0 deprecated
+            ]
+            for old_file in old_hook_files:
+                old_path = project_path / old_file
+                if old_path.exists():
+                    try:
+                        old_path.unlink()  # Remove old file
+                    except Exception:
+                        pass  # Ignore removal failures
+
             config_path = project_path / ".moai" / "config.json"
             if config_path.exists():
                 try:
@@ -163,10 +230,12 @@ def init(
                         config_data = json.load(f)
 
                     # Update version and optimization flags
+                    if "moai" not in config_data:
+                        config_data["moai"] = {}
+                    config_data["moai"]["version"] = __version__
+
                     if "project" not in config_data:
                         config_data["project"] = {}
-
-                    config_data["project"]["moai_adk_version"] = __version__
                     config_data["project"]["optimized"] = False
 
                     with open(config_path, "w", encoding="utf-8") as f:
@@ -211,7 +280,13 @@ def init(
             console.print(separator)
             console.print("\n[cyan]📊 Summary:[/cyan]")
             console.print(f"  [dim]📁 Location:[/dim]  {result.project_path}")
-            console.print(f"  [dim]🌐 Language:[/dim]  {result.language}")
+            # Show language more clearly - "generic" means auto-detect
+            language_display = (
+                "Auto-detect (use /alfred:0-project)"
+                if result.language == "generic"
+                else result.language
+            )
+            console.print(f"  [dim]🌐 Language:[/dim]  {language_display}")
             console.print(f"  [dim]🔧 Mode:[/dim]      {result.mode}")
             console.print(
                 f"  [dim]🌍 Locale:[/dim]    {result.locale}"
@@ -221,6 +296,18 @@ def init(
             )
             console.print(f"  [dim]⏱️  Duration:[/dim]  {result.duration}ms")
 
+            # Show MCP setup info
+            if mcp_servers:
+                console.print(f"  [dim]🔧 MCP Servers:[/dim] {', '.join(mcp_servers)}")
+
+            # MCP Setup (if servers selected)
+            if mcp_servers:
+                console.print("\n[cyan]🔧 Setting up MCP servers...[/cyan]")
+                mcp_manager = MCPSetupManager(project_path)
+                mcp_success = mcp_manager.setup_mcp_servers(mcp_servers)
+                if not mcp_success:
+                    console.print("[yellow]⚠️  MCP setup completed with warnings[/yellow]")
+
             # Show backup info if reinitialized
             if is_reinit:
                 backup_dir = project_path / ".moai-backups"
@@ -234,7 +321,7 @@ def init(
             if is_reinit:
                 console.print("\n[yellow]⚠️  Configuration Notice:[/yellow]")
                 console.print("  All template files have been [bold]force overwritten[/bold]")
-                console.print("  Previous files are backed up in [cyan].moai-backups/{timestamp}/[/cyan]")
+                console.print("  Previous files are backed up in [cyan].moai-backups/backup/[/cyan]")
                 console.print("\n  [cyan]To merge your previous config:[/cyan]")
                 console.print("  Run [bold]/alfred:0-project[/bold] command in Claude Code")
                 console.print("  It will merge backup config when [dim]optimized=false[/dim]\n")
@@ -245,18 +332,32 @@ def init(
                     f"  [blue]1.[/blue] Run [bold]cd {project_name}[/bold] to enter the project"
                 )
                 console.print(
-                    "  [blue]2.[/blue] Check [bold].moai/config.json[/bold] for configuration"
+                    "  [blue]2.[/blue] Run [bold]/alfred:0-project[/bold] in Claude Code for full setup"
                 )
                 console.print(
-                    "  [blue]3.[/blue] Read [bold]CLAUDE.md[/bold] for development guide\n"
+                    "     (Configure: mode, language, report generation, etc.)"
                 )
             else:
                 console.print(
-                    "  [blue]1.[/blue] Check [bold].moai/config.json[/bold] for configuration"
+                    "  [blue]1.[/blue] Run [bold]/alfred:0-project[/bold] in Claude Code for full setup"
                 )
                 console.print(
-                    "  [blue]2.[/blue] Read [bold]CLAUDE.md[/bold] for development guide\n"
+                    "     (Configure: mode, language, report generation, etc.)"
                 )
+
+            # Figma token setup guidance
+            if mcp_servers and "figma" in mcp_servers:
+                console.print("\n[yellow]🔐 Figma Access Token Setup:[/yellow]")
+                console.print("  [dim]Figma MCP requires an access token to function:[/dim]")
+                console.print("  1. Visit: https://www.figma.com/developers/api#access-tokens")
+                console.print("  2. Create a new access token")
+                console.print("  3. Run [bold]/alfred:0-project[/bold] and follow the Figma setup prompts")
+                console.print("  4. The token will be securely stored in your environment\n")
+
+            if not is_current_dir:
+                console.print("  [blue]3.[/blue] Start developing with MoAI-ADK!\n")
+            else:
+                console.print("  [blue]2.[/blue] Start developing with MoAI-ADK!\n")
         else:
             console.print("\n[red bold]❌ Initialization Failed![/red bold]")
             if result.errors:

moai_adk/cli/commands/status.py

@@ -1,10 +1,38 @@
-# @CODE:CLI-001 | SPEC: SPEC-CLI-001/spec.md | TEST: tests/unit/test_cli_commands.py
+# @CODE:CLI-STATUS-001 | SPEC: SPEC-CLI-001/spec.md | TEST: tests/unit/test_cli_commands.py
 """MoAI-ADK status command
 
 Project status display:
 - Read project information from config.json
 - Show the number of SPEC documents
 - Summarize the Git status
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-tags**: For detailed TAG inventory and orphan detection
+  - Trigger: When you need to verify TAG chain integrity beyond what status shows
+  - Invocation: `Skill("moai-foundation-tags")` to scan full project for orphan TAGs
+
+- **moai-foundation-trust**: For comprehensive TRUST 5-principles verification
+  - Trigger: After status shows SPECs exist, to validate code quality
+  - Invocation: `Skill("moai-foundation-trust")` to verify all quality gates
+
+- **moai-foundation-git**: For detailed Git workflow information
+  - Trigger: When Git status shows "Modified" and you need workflow guidance
+  - Invocation: `Skill("moai-foundation-git")` for GitFlow automation details
+
+### When to Invoke Skills in Related Workflows
+1. **Before starting new SPEC creation**:
+   - Run `Skill("moai-foundation-tags")` to verify no orphan TAGs exist from previous work
+   - Check the SPEC count from status command
+
+2. **After modifications to code/docs**:
+   - If status shows "Modified", run `Skill("moai-foundation-git")` for commit strategy
+   - Follow up with `Skill("moai-foundation-trust")` to validate code quality
+
+3. **Periodic health checks**:
+   - Run status command regularly
+   - When SPEC count grows, verify with `Skill("moai-foundation-tags")` and `Skill("moai-foundation-trust")`
 """
 
 import json
@@ -48,8 +76,10 @@ def status() -> None:
         table.add_column("Key", style="cyan")
         table.add_column("Value", style="bold")
 
-        table.add_row("Mode", config.get("mode", "unknown"))
-        table.add_row("Locale", config.get("locale", "unknown"))
+        # Read from project section (with legacy fallback)
+        project = config.get("project", {})
+        table.add_row("Mode", project.get("mode") or config.get("mode", "unknown"))
+        table.add_row("Locale", project.get("locale") or config.get("locale", "unknown"))
         table.add_row("SPECs", str(spec_count))
 
         # Optionally include Git information