moai-adk 0.3.11__py3-none-any.whl → 0.3.12__py3-none-any.whl

moai_adk/__init__.py

@@ -4,5 +4,5 @@
 SPEC-First TDD Framework with Alfred SuperAgent
 """
 
-__version__ = "0.3.11"
+__version__ = "0.3.12"
 __all__ = ["__version__"]

moai_adk/cli/commands/doctor.py

@@ -1,4 +1,5 @@
 # @CODE:CLI-001 | SPEC: SPEC-CLI-001.md | TEST: tests/unit/test_doctor.py
+# @CODE:CLAUDE-COMMANDS-001:CLI | SPEC: SPEC-CLAUDE-COMMANDS-001.md | TEST: tests/unit/test_slash_commands.py
 """MoAI-ADK doctor command
 
 System diagnostics command:
@@ -6,6 +7,7 @@ System diagnostics command:
 - Verify Git installation
 - Validate project structure
 - Inspect language-specific tool chains
+- Diagnose slash command loading issues (--check-commands)
 """
 
 import json
@@ -27,7 +29,8 @@ 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")
-def doctor(verbose: bool, fix: bool, export: str | None, check: str | None) -> 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:
@@ -37,6 +40,11 @@ def doctor(verbose: bool, fix: bool, export: str | None, check: str | None) -> N
     - Language-specific tool chains (20+ languages)
     """
     try:
+        # Handle --check-commands option first
+        if check_commands:
+            _check_slash_commands()
+            return
+
         console.print("[cyan]Running system diagnostics...[/cyan]\n")
 
         # Run basic environment checks
@@ -182,3 +190,45 @@ def _export_diagnostics(export_path: str, data: dict) -> None:
         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]")
+
+
+def _check_slash_commands() -> None:
+    """Check slash command loading issues (helper)"""
+    from moai_adk.core.diagnostics.slash_commands import diagnose_slash_commands
+
+    console.print("[cyan]Running slash command diagnostics...[/cyan]\n")
+
+    result = diagnose_slash_commands()
+
+    # Handle error case
+    if "error" in result:
+        console.print(f"[red]✗ {result['error']}[/red]")
+        return
+
+    # Build results table
+    table = Table(show_header=True, header_style="bold magenta")
+    table.add_column("Command File", style="dim", width=40)
+    table.add_column("Status", justify="center", width=10)
+    table.add_column("Issues", style="yellow")
+
+    for detail in result["details"]:
+        icon = "✓" if detail["valid"] else "✗"
+        color = "green" if detail["valid"] else "red"
+        issues = ", ".join(detail["errors"]) if detail["errors"] else "-"
+
+        table.add_row(detail["file"], f"[{color}]{icon}[/{color}]", issues)
+
+    console.print(table)
+    console.print()
+
+    # Summary
+    total = result["total_files"]
+    valid = result["valid_commands"]
+
+    if valid == total and total > 0:
+        console.print(f"[green]✓ {valid}/{total} command files are valid[/green]")
+    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("[dim]Fix the issues above to enable slash commands[/dim]")

moai_adk/cli/prompts/init_prompts.py

@@ -123,9 +123,20 @@ def prompt_project_setup(
                     "Java",
                     "Go",
                     "Rust",
+                    "Ruby",
                     "Dart",
                     "Swift",
                     "Kotlin",
+                    "PHP",
+                    "C#",
+                    "C",
+                    "C++",
+                    "Elixir",
+                    "Scala",
+                    "Clojure",
+                    "Haskell",
+                    "Lua",
+                    "OCaml",
                     "Generic",
                 ],
             ).ask()

moai_adk/core/diagnostics/__init__.py

@@ -0,0 +1,19 @@
+"""Diagnostics module for MoAI-ADK
+
+Provides diagnostic tools for:
+- Slash command validation
+- System health checks
+- Environment verification
+"""
+
+from moai_adk.core.diagnostics.slash_commands import (
+    diagnose_slash_commands,
+    scan_command_files,
+    validate_command_file,
+)
+
+__all__ = [
+    "diagnose_slash_commands",
+    "scan_command_files",
+    "validate_command_file",
+]

moai_adk/core/diagnostics/slash_commands.py

@@ -0,0 +1,160 @@
+# @CODE:CLAUDE-COMMANDS-001:DIAGNOSTIC | SPEC: SPEC-CLAUDE-COMMANDS-001.md | TEST: tests/unit/test_slash_commands.py
+"""Slash command diagnostics
+
+Diagnose and validate Claude Code slash command loading issues.
+
+Functions:
+- validate_command_file: Validate YAML front matter and required fields
+- scan_command_files: Recursively scan for .md files
+- diagnose_slash_commands: Comprehensive diagnostic report
+"""
+
+from pathlib import Path
+
+import yaml
+
+
+def validate_command_file(file_path: Path) -> dict:
+    """Validate slash command file format
+
+    Checks:
+    1. File exists and readable
+    2. YAML front matter present (starts with ---)
+    3. Valid YAML syntax
+    4. Required fields: name, description
+
+    Args:
+        file_path: Path to command file (.md)
+
+    Returns:
+        dict with 'valid' (bool) and optional 'errors' (list[str])
+
+    Example:
+        >>> result = validate_command_file(Path("cmd.md"))
+        >>> if result["valid"]:
+        ...     print("Valid command file")
+        ... else:
+        ...     print(f"Errors: {result['errors']}")
+    """
+    try:
+        # Check file exists
+        if not file_path.exists():
+            return {"valid": False, "errors": ["File not found"]}
+
+        # Read file content
+        content = file_path.read_text(encoding="utf-8")
+
+        # Check front matter delimiter
+        if not content.startswith("---"):
+            return {
+                "valid": False,
+                "errors": ["Missing YAML front matter (must start with ---)"],
+            }
+
+        # Split by --- delimiter
+        parts = content.split("---", 2)
+        if len(parts) < 3:
+            return {
+                "valid": False,
+                "errors": ["Invalid front matter format (missing closing ---)"],
+            }
+
+        # Parse YAML
+        try:
+            metadata = yaml.safe_load(parts[1])
+        except yaml.YAMLError as e:
+            return {"valid": False, "errors": [f"YAML parsing error: {e}"]}
+
+        # Check required fields
+        required_fields = ["name", "description"]
+        missing_fields = [field for field in required_fields if field not in metadata]
+
+        if missing_fields:
+            return {
+                "valid": False,
+                "errors": [f"Missing required field: {', '.join(missing_fields)}"],
+            }
+
+        return {"valid": True}
+
+    except Exception as e:
+        return {"valid": False, "errors": [str(e)]}
+
+
+def scan_command_files(commands_dir: Path) -> list[Path]:
+    """Scan directory for all .md files
+
+    Recursively searches for .md files in the given directory.
+
+    Args:
+        commands_dir: Directory to scan (e.g., .claude/commands)
+
+    Returns:
+        List of Path objects for found .md files
+
+    Example:
+        >>> files = scan_command_files(Path(".claude/commands"))
+        >>> print(f"Found {len(files)} command files")
+    """
+    if not commands_dir.exists():
+        return []
+
+    try:
+        return list(commands_dir.glob("**/*.md"))
+    except Exception:
+        return []
+
+
+def diagnose_slash_commands() -> dict:
+    """Diagnose slash command loading issues
+
+    Comprehensive diagnostic that:
+    1. Checks if .claude/commands directory exists
+    2. Scans for all .md files
+    3. Validates each file's format
+    4. Returns detailed report
+
+    Returns:
+        dict with diagnostic results:
+        - total_files: Number of .md files found
+        - valid_commands: Number of valid command files
+        - details: List of per-file validation results
+        OR
+        - error: Error message if directory not found
+
+    Example:
+        >>> result = diagnose_slash_commands()
+        >>> if "error" in result:
+        ...     print(f"Error: {result['error']}")
+        ... else:
+        ...     print(f"{result['valid_commands']}/{result['total_files']} valid")
+    """
+    commands_dir = Path(".claude/commands")
+
+    # Check if directory exists
+    if not commands_dir.exists():
+        return {"error": "Commands directory not found"}
+
+    # Scan for .md files
+    md_files = scan_command_files(commands_dir)
+
+    # Validate each file
+    details = []
+    for file_path in md_files:
+        validation = validate_command_file(file_path)
+        details.append(
+            {
+                "file": str(file_path.relative_to(commands_dir)),
+                "valid": validation["valid"],
+                "errors": validation.get("errors", []),
+            }
+        )
+
+    # Count valid commands
+    valid_count = sum(1 for detail in details if detail["valid"])
+
+    return {
+        "total_files": len(md_files),
+        "valid_commands": valid_count,
+        "details": details,
+    }

moai_adk/templates/.claude/commands/alfred/2-build.md

@@ -1,6 +1,6 @@
 ---
 name: alfred:2-build
-description: 구현할 SPEC ID (예: SPEC-001) 또는 all로 모든 SPEC 구현: 언어별 최적화된 TDD 구현 (Red-Green-Refactor) with SQLite3 tags.db
+description: "구현할 SPEC ID (예: SPEC-001) 또는 all로 모든 SPEC 구현 - 언어별 최적화된 TDD 구현 (Red-Green-Refactor) with SQLite3 tags.db"
 argument-hint: "SPEC-ID - 구현할 SPEC ID (예: SPEC-001) 또는 all로 모든 SPEC 구현"
 allowed-tools:
   - Read

moai_adk/templates/.claude/settings.json

@@ -6,17 +6,6 @@
     "PYTHON_ENV": "{{PROJECT_MODE}}"
   },
   "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "command": "uv run .claude/hooks/alfred/alfred_hooks.py SessionStart",
-            "type": "command"
-          }
-        ],
-        "matcher": "*"
-      }
-    ],
     "PreToolUse": [
       {
         "hooks": [

moai_adk/templates/.moai/memory/development-guide.md

@@ -106,6 +106,7 @@ MoAI-ADK는 Anthropic의 "Effective Context Engineering for AI Agents" 원칙을
 - **Java**: JUnit + SPEC 어노테이션 (행동 주도 테스트)
 - **Go**: go test + SPEC 테이블 주도 테스트 (인터페이스 준수)
 - **Rust**: cargo test + SPEC 문서 테스트 (trait 검증)
+- **Ruby**: RSpec + SPEC 기반 BDD 테스트 (행동 명세 우선)
 
 각 테스트는 @TEST:ID → @CODE:ID 참조를 통해 특정 SPEC 요구사항과 연결한다.
 
@@ -125,6 +126,7 @@ MoAI-ADK는 Anthropic의 "Effective Context Engineering for AI Agents" 원칙을
 - **Java**: SPEC 구성요소 구현 클래스 + 강한 타이핑
 - **Go**: SPEC 요구사항 충족 인터페이스 + gofmt
 - **Rust**: SPEC 안전 요구사항을 구현하는 타입 + rustfmt
+- **Ruby**: SPEC 행동을 반영하는 duck typing + RuboCop 검증
 
 모든 코드 요소는 @TAG 주석을 통해 SPEC까지 추적 가능하다.
 
@@ -320,6 +322,7 @@ rg "### v[0-9]" .moai/specs/SPEC-AUTH-001.md | head -3
 - **Java**: JUnit (테스트), Maven/Gradle (빌드)
 - **Go**: go test (테스트), gofmt (포맷)
 - **Rust**: cargo test (테스트), rustfmt (포맷)
+- **Ruby**: RSpec (테스트), RuboCop (린터+포맷), Bundler (패키지 관리)
 
 ## 변수 역할 참고
 

moai_adk/templates/CLAUDE.md

@@ -461,7 +461,7 @@ def handle_pre_tool_use(payload):
 - **SPEC-First**: 명세 없이는 코드 없음
 - **TDD-First**: 테스트 없이는 구현 없음
 - **GitFlow 지원**: Git 작업 자동화, Living Document 동기화, @TAG 추적성
-- **다중 언어 지원**: Python, TypeScript, Java, Go, Rust, Dart, Swift, Kotlin 등 모든 주요 언어
+- **다중 언어 지원**: Python, TypeScript, Java, Go, Rust, Ruby, Dart, Swift, Kotlin 등 20개 주요 언어
 - **모바일 지원**: Flutter, React Native, iOS (Swift), Android (Kotlin)
 - **CODE-FIRST @TAG**: 코드 직접 스캔 방식 (중간 캐시 없음)
 

{moai_adk-0.3.11.dist-info → moai_adk-0.3.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.3.11
+Version: 0.3.12
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk

{moai_adk-0.3.11.dist-info → moai_adk-0.3.12.dist-info}/RECORD

@@ -1,16 +1,18 @@
-moai_adk/__init__.py,sha256=xGKbfTvpKMGcmSZOUJtX8_WsZAAp04nKprHyddnHS3o,217
+moai_adk/__init__.py,sha256=zd7dqRoH0TwcrNnPYup0gctShF4cKVtbdpprX5vyo2g,217
 moai_adk/__main__.py,sha256=Wok19np6X4pxX4ybsGWS6McDZwoAN6iAvyLqFD9G5No,2419
 moai_adk/cli/__init__.py,sha256=tidIaJnd4Pje_5QYRq7OvRRst4T3kaPlkw5QcPQ3l1Y,135
 moai_adk/cli/main.py,sha256=mHACHi27AP2N7fg7zhzOo1tlF1Jrlw1_AcbxMfpGLVE,306
 moai_adk/cli/commands/__init__.py,sha256=AXHW3xozTShXENtrAINFK6brSEEGmaFCi0q71xsE9FQ,675
 moai_adk/cli/commands/backup.py,sha256=Hzf3zc7NhfChAJu2OTN_0xARtUbNaB32fmPczchbrC4,1652
-moai_adk/cli/commands/doctor.py,sha256=R4Cf9Jqwww1ng36u2SHTh6x0VdmnvaT7G9KVKJRX7N4,6623
+moai_adk/cli/commands/doctor.py,sha256=XGZd3FDsGw8mIwmRouGR-SopKOrU_VeReUaZB4I-rGE,8553
 moai_adk/cli/commands/init.py,sha256=B9xWjjpIU9YgXBwfguLrzopVZMYg8GaqPa481EiHHGo,10377
 moai_adk/cli/commands/status.py,sha256=YJhh7RoKnumxY0_ho7FWTWm5Nxh2jTnH9aSsapdLhyo,2277
 moai_adk/cli/commands/update.py,sha256=aoYSR6Nz70sI-KNnkeD_9nZg4CHo5DJkmstnVfoTbrk,5979
 moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
-moai_adk/cli/prompts/init_prompts.py,sha256=LDuszslENM-xpNk1e-XIHnFu5J1168rKAnyPsMGXYBU,4944
+moai_adk/cli/prompts/init_prompts.py,sha256=MG7QSSLAkPnff4rYtj8Uv9-r3MCzNdawtzzUivhGp8M,5254
 moai_adk/core/__init__.py,sha256=Nq5zaonDTRGFFfr0yH4Wcsjm5u_xCG1zg0nIAIdRqKc,124
+moai_adk/core/diagnostics/__init__.py,sha256=aF-qC2CW0wxZDpxnlh-TILYs3kqwOIj2EjXYEXY-2j8,387
+moai_adk/core/diagnostics/slash_commands.py,sha256=HCdaO0BgL6u-buvpmLQ0PRZru_2DkzLU97lQpGOj6Z0,4650
 moai_adk/core/git/__init__.py,sha256=Kpq2yU5X5bBBUV8ySYIB1_vMPvfdFS6hTYx2Ue-CoeQ,697
 moai_adk/core/git/branch.py,sha256=QHYWwLcAhEaqWfrGViV1kUOzHJHpd2E1U-IikCZaIRU,612
 moai_adk/core/git/branch_manager.py,sha256=K6SyO3vtVv111D2dudbSgyKBLlDX2aWTPj1qJV4PSMg,4143
@@ -36,9 +38,9 @@ moai_adk/core/template/languages.py,sha256=waeyA_MFy217bV9IiILc2gofG9RM9JhD-kdVG
 moai_adk/core/template/merger.py,sha256=dvKobOW4vXz-7GWKJpZFYxCMtR-LszcJZYbYFTL3XY0,4049
 moai_adk/core/template/processor.py,sha256=gmYK3d0dwlf0ES2RZb59ihBVctYcknB3WX0Gsp1pwBg,15175
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
-moai_adk/templates/CLAUDE.md,sha256=xANecTF739Bh2aJX7nExWQcS2Yc_G8jk2HEVZKlmJOo,27286
+moai_adk/templates/CLAUDE.md,sha256=TSUD5r6vgr8eA4AtIYfCb7haA_WmnbmdWlwjqydOYdM,27291
 moai_adk/templates/__init__.py,sha256=9YY0tDkKbDFCdUB7rJFtGq0CZbF2ftVSKF573iw0KJc,99
-moai_adk/templates/.claude/settings.json,sha256=-wa_uzvkUc2nE91VJhCAMv5Xrw-gwEW4-f61yhC-olk,2518
+moai_adk/templates/.claude/settings.json,sha256=5y0IO9Q7-_vHp2Mkw6zeIQY-k-tdBB8CZ2H5NT1PVcY,2283
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=xP3V7QAI-08ga6hhF3J4fXbgiHUM08bJbT2nfE52Bq4,13883
 moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=1Sxz6tBHa-oCoTmwjEZ8ix2OMbjTsOpWUOekQKftlF8,5249
 moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=kLwLvI-5oRjEG6fSlq8CwwsH3TbqrAY-OWZDcS_3IMo,6223
@@ -52,7 +54,7 @@ moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=oeJimFgfRuJqB
 moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=eIwFumcJfr66jWdAuWJ5LITHfzzsRBaITGD7iz8EYH4,11647
 moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=6a19UVvi6BV6mX0312WbQJyN4nsKB7pggTlLgtxwcFM,17831
 moai_adk/templates/.claude/commands/alfred/1-spec.md,sha256=dpaOJWxK2zjU2wI7uvVfY16SDyGzN-HsUcIepPO8sCM,20365
-moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=cEvXk9gadL2twrkDf3p2w8lzrCt3JkMUx-T0MtnLN7U,17429
+moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=jnNuUlFndD8hyYFUpVyt7Mvqlvaob_Z69SLpv4ajg7U,17432
 moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=5rYopDYzJHKEG400CuHoSWP5xBppcZNTFCu2GlFNVs0,19610
 moai_adk/templates/.claude/hooks/alfred/README.md,sha256=1E_nUaFj_50UTXIfFnkNLTy4qZHCs_R3gzhBoekf4Pk,6823
 moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=vffNW0u2RXZ_jG3EzIggxEv23fDuh2qtU7oF7PZIW6A,6943
@@ -72,7 +74,7 @@ moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=Cbkc2YZzM1wiGC5XI0cbg
 moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=aD36D-wKSvjWHGGfy5lRvriMHVWSjtRojn6qzBdztu0,8701
 moai_adk/templates/.moai/config.json,sha256=pMmmcQgyZQJtbvsrpzjYiYZRwmLrSH9FBaMKTVNcj2w,2152
 moai_adk/templates/.moai/hooks/pre-push.sample,sha256=zpQOWHxpV_XjTAnyp1dTrM39Iz1MBe_JaNdc_sRfrxw,3728
-moai_adk/templates/.moai/memory/development-guide.md,sha256=YMepw_MT0-YDK6rQlKvWOULAMGtPDH-WJA6wIYiSMwU,14717
+moai_adk/templates/.moai/memory/development-guide.md,sha256=LtW7LpwpKmaajQZYoQPAmfKjZh8cfjniatngiCV6Sn4,14938
 moai_adk/templates/.moai/memory/gitflow-protection-policy.md,sha256=xmRXA9erdH4EgpRdd0inKGat6HEZ8HP-4BQthjLyoZ4,6529
 moai_adk/templates/.moai/memory/spec-metadata.md,sha256=EZ_GMCG-yRwvvCotD6oSGR350hg090fodQkxPuWNYso,7350
 moai_adk/templates/.moai/project/product.md,sha256=ClDlG1q7P8aX4cjroXLUZIQGd2wBZt6xD-w9RXMOYfk,5731
@@ -81,8 +83,8 @@ moai_adk/templates/.moai/project/tech.md,sha256=1BgkApeFqQCq6TPriGiev02G9niVx23c
 moai_adk/utils/__init__.py,sha256=fv-UwHv8r4-eedwRnDA9hFjo5QSZYXjctKDyE7XF10g,220
 moai_adk/utils/banner.py,sha256=TmZyJKXOnJpdbdn6NZDJC6a4hm051QudEvOfiKQhvI8,1873
 moai_adk/utils/logger.py,sha256=jYCWKvcN-tX17hZ-e2IPuHATwkQBFc_I1dd5fUTWxmY,5059
-moai_adk-0.3.11.dist-info/METADATA,sha256=GvaHiumDTnHbFtuELOGZfSy8lO30yJAo3CLooR0IgGE,49933
-moai_adk-0.3.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.3.11.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.3.11.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.3.11.dist-info/RECORD,,
+moai_adk-0.3.12.dist-info/METADATA,sha256=j3QfFKZALqlfKz1yIPS0f1QhHVqlqmnqvqvHKbv5SS8,49933
+moai_adk-0.3.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.3.12.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.3.12.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.3.12.dist-info/RECORD,,