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

moai_adk/__init__.py

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

moai_adk/core/project/detector.py

@@ -1,4 +1,5 @@
 # @CODE:CORE-PROJECT-001 | SPEC: SPEC-CORE-PROJECT-001.md | TEST: tests/unit/test_language_detector.py
+# @CODE:LANG-DETECT-001 | SPEC: SPEC-LANG-DETECT-001.md | TEST: tests/unit/test_detector.py
 """Language detector module.
 
 Automatically detects 20 programming languages.
@@ -8,9 +9,21 @@ from pathlib import Path
 
 
 class LanguageDetector:
-    """Automatically detect up to 20 programming languages."""
+    """Automatically detect up to 20 programming languages.
+
+    Prioritizes framework-specific files (e.g., Laravel, Django) over
+    generic language files to improve accuracy in mixed-language projects.
+    """
 
     LANGUAGE_PATTERNS = {
+        # PHP moved to top for priority (Laravel detection)
+        "php": [
+            "*.php",
+            "composer.json",
+            "artisan",                # Laravel: CLI tool (unique identifier)
+            "app/",                   # Laravel: application directory
+            "bootstrap/laravel.php"   # Laravel: bootstrap file
+        ],
         "python": ["*.py", "pyproject.toml", "requirements.txt", "setup.py"],
         "typescript": ["*.ts", "tsconfig.json"],
         "javascript": ["*.js", "package.json"],
@@ -21,7 +34,6 @@ class LanguageDetector:
         "swift": ["*.swift", "Package.swift"],
         "kotlin": ["*.kt", "build.gradle.kts"],
         "csharp": ["*.cs", "*.csproj"],
-        "php": ["*.php", "composer.json"],
         "ruby": ["*.rb", "Gemfile"],
         "elixir": ["*.ex", "mix.exs"],
         "scala": ["*.scala", "build.sbt"],

moai_adk/templates/.claude/hooks/alfred/handlers/session.py

@@ -4,6 +4,10 @@
 SessionStart, SessionEnd 이벤트 처리
 """
 
+import os
+import time
+from pathlib import Path
+
 from core import HookPayload, HookResult
 from core.checkpoint import list_checkpoints
 from core.project import count_specs, detect_language, get_git_info
@@ -29,14 +33,43 @@ def handle_session_start(payload: HookPayload) -> HookResult:
            SPEC Progress: {완료}/{전체} ({퍼센트}%)
            Checkpoints: {개수} available (최신 3개 표시)
 
+    Note:
+        - Claude Code는 SessionStart를 여러 번 호출할 수 있음
+        - 상태 파일 기반 중복 방지 메커니즘 사용
+        - 5초 이내 재호출은 무시 (같은 세션으로 간주)
+
     TDD History:
         - RED: 세션 시작 메시지 형식 테스트
         - GREEN: helper 함수 조합하여 상태 메시지 생성
         - REFACTOR: 메시지 포맷 개선, 가독성 향상, checkpoint 목록 추가
+        - FIX: 상태 파일 기반 중복 출력 방지 메커니즘 도입
 
     @TAG:CHECKPOINT-EVENT-001
     """
+    # 상태 파일 기반 중복 방지
     cwd = payload.get("cwd", ".")
+    # cwd가 "."인 경우 절대 경로로 변환하여 프로젝트명 추출
+    project_dir = Path(cwd).resolve()
+    session_file = Path("/tmp") / f"moai-session-{project_dir.name}.lock"
+
+    # 기존 세션 파일이 있고 5초 이내면 중복 실행으로 간주
+    if session_file.exists():
+        file_age = time.time() - session_file.stat().st_mtime
+        if file_age < 5.0:
+            return HookResult()  # 중복 실행 방지
+
+    # 세션 파일 생성/갱신
+    session_file.touch()
+
+    # 1시간 이상 된 세션 파일 자동 정리
+    if session_file.parent.exists():
+        for old_file in session_file.parent.glob("moai-session-*.lock"):
+            try:
+                if time.time() - old_file.stat().st_mtime > 3600:
+                    old_file.unlink()
+            except Exception:
+                pass  # 정리 실패는 무시
+
     language = detect_language(cwd)
     git_info = get_git_info(cwd)
     specs = count_specs(cwd)

moai_adk/utils/banner.py

@@ -9,12 +9,12 @@ from rich.console import Console
 console = Console()
 
 MOAI_BANNER = """
-███╗   ███╗ ██████╗  █████╗ ██╗       █████╗ ██████╗ ██╗  ██╗
-████╗ ████║██╔═══██╗██╔══██╗██║      ██╔══██╗██╔══██╗██║ ██╔╝
-██╔████╔██║██║   ██║███████║██║█████╗███████║██║  ██║█████╔╝
-██║╚██╔╝██║██║   ██║██╔══██║██║╚════╝██╔══██║██║  ██║██╔═██╗
-██║ ╚═╝ ██║╚██████╔╝██║  ██║██║      ██║  ██║██████╔╝██║  ██╗
-╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝      ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝
+███╗   ███╗          █████╗ ██╗       █████╗ ██████╗ ██╗  ██╗
+████╗ ████║  █████╗ ██╔══██╗██║      ██╔══██╗██╔══██╗██║ ██╔╝
+██╔████╔██║ ██╔══██╗███████║██║█████╗███████║██║  ██║█████╔╝
+██║╚██╔╝██║ ██║  ██║██╔══██║██║╚════╝██╔══██║██║  ██║██╔═██╗
+██║ ╚═╝ ██║ ╚█████╔╝██║  ██║██║      ██║  ██║██████╔╝██║  ██╗
+╚═╝     ╚═╝  ╚════╝ ╚═╝  ╚═╝╚═╝      ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝
 """
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.3.12
+Version: 0.3.13
 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
@@ -395,6 +395,10 @@ uv --version
 #### 2. moai-adk 설치 (10초)
 
 ```bash
+# 권장: uv tool 모드 (샌드박스 격리, 전역 접근)
+uv tool install moai-adk
+
+# 대안: 현재 가상 환경에 설치
 uv pip install moai-adk
 
 # 설치 확인
@@ -1283,7 +1287,10 @@ Alfred가 모든 코드에 자동으로 적용하는 품질 기준입니다.
 ```bash
 moai-adk update
 
-# 또는
+# 또는 (tool 모드 - 권장)
+uv tool upgrade moai-adk
+
+# 또는 (pip 모드 - 레거시)
 uv pip install --upgrade moai-adk
 ```
 
@@ -1437,7 +1444,11 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 # Windows:
 powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
 
-# moai-adk 재설치
+# moai-adk 재설치 (tool 모드 - 권장)
+uv tool uninstall moai-adk
+uv tool install moai-adk
+
+# 또는 (pip 모드 - 레거시)
 uv pip install moai-adk --force-reinstall
 ```
 

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

@@ -1,4 +1,4 @@
-moai_adk/__init__.py,sha256=zd7dqRoH0TwcrNnPYup0gctShF4cKVtbdpprX5vyo2g,217
+moai_adk/__init__.py,sha256=fV6DuZDRF4C6PozXGMHTSE9EguZMEeYjEn27omz8zLI,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
@@ -23,7 +23,7 @@ moai_adk/core/git/manager.py,sha256=lHFUQn8DGIvuhxC41cD5G3S6OgCpw9WkEOPVET97FJU,
 moai_adk/core/project/__init__.py,sha256=w_VdJ6lJDkTMdYYEwj0Io6Ay3ekqsLO3qXInSfXX7Vs,134
 moai_adk/core/project/backup_utils.py,sha256=SOdqgyWjFObcj1RuGAXn6wopamhITVi3wNmh56ZMMbk,2108
 moai_adk/core/project/checker.py,sha256=tN1A2OWsTafDCEWcafDJ4JXM217FUUdLYdnLtWpdDgs,9533
-moai_adk/core/project/detector.py,sha256=-Rhh8Bka224PuzARKQeaZQ8FJdZxVXP3FM3cXqMUaGs,3182
+moai_adk/core/project/detector.py,sha256=ON2t0KYyaop3lxBcbEq5HIJGmnBLluA8k6GErmr4IM8,3733
 moai_adk/core/project/initializer.py,sha256=iFTb7d5537WL_zumY4kqV7UPSvUd1ZJQClvycJXF40E,6073
 moai_adk/core/project/phase_executor.py,sha256=m6FG3D1qPanbK-lifosGox-93SBxbGCkqMZSIajCaHY,10443
 moai_adk/core/project/validator.py,sha256=8LmfdfENv--Os05duarKfJTnO2NRHJIbXU5V0LsZ0Ds,5738
@@ -64,7 +64,7 @@ moai_adk/templates/.claude/hooks/alfred/core/context.py,sha256=-PHNNktkULYL9jpIj
 moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=h7s2D0e5zn0BKu3GReMVH93ojKOTkF6yyLWNnoJI6-0,9103
 moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py,sha256=mk1FQFj5V3rxyV1BQbd8bZE9R-IK4nanj61oO7jhbdw,577
 moai_adk/templates/.claude/hooks/alfred/handlers/notification.py,sha256=MjwaCRSbK4f-YvRC9CG4Rg8dhQir1gzPqF02x9O_4Gc,655
-moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=6zz0uJ3cYtnY8gXtoP0cRf6LmmQUfggLWIJduokd-Jw,2783
+moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=hQv5KH77Mb_q9Lq1OLGLnB5Wkqoe-0VpFJPblUuPW6k,4040
 moai_adk/templates/.claude/hooks/alfred/handlers/tool.py,sha256=bR7QpIYxuypQseWbAPmLYClS2wZUGbFflFj-IiiE26w,2224
 moai_adk/templates/.claude/hooks/alfred/handlers/user.py,sha256=iD0X_Aas8pwfFvPj30PaCPNs_Xo-9yVynxT27m-2O7k,1300
 moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md,sha256=-Y0V-fRRZbAUH1f4kZX0y8i0Lo7GRjJddBMeZ0WV6gA,17906
@@ -81,10 +81,10 @@ moai_adk/templates/.moai/project/product.md,sha256=ClDlG1q7P8aX4cjroXLUZIQGd2wBZ
 moai_adk/templates/.moai/project/structure.md,sha256=jesU7Om-fZANmj0NdgiU_oY0aT7102QWwuYy7Q-drKA,5180
 moai_adk/templates/.moai/project/tech.md,sha256=1BgkApeFqQCq6TPriGiev02G9niVx23cEA2RH-28dtw,6049
 moai_adk/utils/__init__.py,sha256=fv-UwHv8r4-eedwRnDA9hFjo5QSZYXjctKDyE7XF10g,220
-moai_adk/utils/banner.py,sha256=TmZyJKXOnJpdbdn6NZDJC6a4hm051QudEvOfiKQhvI8,1873
+moai_adk/utils/banner.py,sha256=Cf7f3G7mB58MRQhOH4eYmywKYv8U_qS9yExWssSroC0,1853
 moai_adk/utils/logger.py,sha256=jYCWKvcN-tX17hZ-e2IPuHATwkQBFc_I1dd5fUTWxmY,5059
-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,,
+moai_adk-0.3.13.dist-info/METADATA,sha256=YzDWvOVCLEcVQCCcadWWQi_VwXYg0SGU2ocwiqc7hiw,50255
+moai_adk-0.3.13.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.3.13.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.3.13.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.3.13.dist-info/RECORD,,