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

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

@@ -1,75 +1,54 @@
 #!/usr/bin/env python3
 """Session event handlers
 
-SessionStart, SessionEnd 이벤트 처리
+SessionStart, SessionEnd event handling
 """
 
-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
 
 
 def handle_session_start(payload: HookPayload) -> HookResult:
-    """SessionStart 이벤트 핸들러 (Checkpoint 목록 포함)
+    """SessionStart event handler (with Checkpoint list)
 
-    Claude Code 세션 시작 시 프로젝트 상태를 요약하여 표시합니다.
-    언어, Git 상태, SPEC 진행도, Checkpoint 목록을 한눈에 확인할 수 있습니다.
+    When Claude Code Session starts, it displays a summary of project status.
+    You can check the language, Git status, SPEC progress, and checkpoint list at a glance.
 
     Args:
-        payload: Claude Code 이벤트 페이로드 (cwd 키 필수)
+        payload: Claude Code event payload (cwd key required)
 
     Returns:
-        HookResult(message=프로젝트 상태 요약 메시지, systemMessage=사용자 표시용)
+        HookResult(message=project status summary message, systemMessage=for user display)
 
     Message Format:
         🚀 MoAI-ADK Session Started
-           Language: {언어}
-           Branch: {브랜치} ({커밋 해시})
-           Changes: {변경 파일 수}
-           SPEC Progress: {완료}/{전체} ({퍼센트}%)
-           Checkpoints: {개수} available (최신 3개 표시)
+           Language: {language}
+           Branch: {branch} ({commit hash})
+           Changes: {Number of Changed Files}
+           SPEC Progress: {Complete}/{Total} ({percent}%)
+           Checkpoints: {number} available (showing the latest 3 items)
 
     Note:
-        - Claude Code는 SessionStart를 여러 번 호출할 수 있음
-        - 상태 파일 기반 중복 방지 메커니즘 사용
-        - 5초 이내 재호출은 무시 (같은 세션으로 간주)
+        - Claude Code processes SessionStart in several stages (clear → compact)
+        - Display message only at “compact” stage to prevent duplicate output
+        - "clear" step returns empty result (invisible to user)
 
     TDD History:
-        - RED: 세션 시작 메시지 형식 테스트
-        - GREEN: helper 함수 조합하여 상태 메시지 생성
-        - REFACTOR: 메시지 포맷 개선, 가독성 향상, checkpoint 목록 추가
-        - FIX: 상태 파일 기반 중복 출력 방지 메커니즘 도입
+        - RED: Session startup message format test
+        - GREEN: Generate status message by combining helper functions
+        - REFACTOR: Improved message format, improved readability, added checkpoint list
+        - FIX: Prevent duplicate output of clear step (only compact step is displayed)
 
     @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  # 정리 실패는 무시
+    # Claude Code SessionStart runs in several stages (clear, compact, etc.)
+    # Ignore the "clear" stage and output messages only at the "compact" stage
+    event_phase = payload.get("phase", "")
+    if event_phase == "clear":
+        return HookResult() # returns an empty result (prevents duplicate output)
 
+    cwd = payload.get("cwd", ".")
     language = detect_language(cwd)
     git_info = get_git_info(cwd)
     specs = count_specs(cwd)
@@ -80,7 +59,7 @@ def handle_session_start(payload: HookPayload) -> HookResult:
     changes = git_info.get("changes", 0)
     spec_progress = f"{specs['completed']}/{specs['total']}"
 
-    # systemMessage: 사용자에게 직접 표시
+    # systemMessage: displayed directly to the user
     lines = [
         "🚀 MoAI-ADK Session Started",
         f"   Language: {language}",
@@ -89,10 +68,10 @@ def handle_session_start(payload: HookPayload) -> HookResult:
         f"   SPEC Progress: {spec_progress} ({specs['percentage']}%)",
     ]
 
-    # Checkpoint 목록 추가 (최신 3개만 표시)
+    # Add Checkpoint list (show only the latest 3 items)
     if checkpoints:
         lines.append(f"   Checkpoints: {len(checkpoints)} available")
-        for cp in reversed(checkpoints[-3:]):  # 최신 3개
+        for cp in reversed(checkpoints[-3:]):  # Latest 3 items
             branch_short = cp["branch"].replace("before-", "")
             lines.append(f"      - {branch_short}")
         lines.append("   Restore: /alfred:0-project restore")
@@ -100,13 +79,13 @@ def handle_session_start(payload: HookPayload) -> HookResult:
     system_message = "\n".join(lines)
 
     return HookResult(
-        message=system_message,  # Claude 컨텍스트용
-        systemMessage=system_message,  # 사용자 표시용
+        message=system_message, # for Claude context
+        systemMessage=system_message, # For user display
     )
 
 
 def handle_session_end(payload: HookPayload) -> HookResult:
-    """SessionEnd 이벤트 핸들러 (기본 구현)"""
+    """SessionEnd event handler (default implementation)"""
     return HookResult()
 
 

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Tool usage handlers
 
-PreToolUse, PostToolUse 이벤트 처리
+PreToolUse, PostToolUse event handling
 """
 
 from core import HookPayload, HookResult
@@ -9,19 +9,19 @@ from core.checkpoint import create_checkpoint, detect_risky_operation
 
 
 def handle_pre_tool_use(payload: HookPayload) -> HookResult:
-    """PreToolUse 이벤트 핸들러 (Event-Driven Checkpoint 통합)
+    """PreToolUse event handler (Event-Driven Checkpoint integration)
 
-    위험한 작업 전 자동으로 checkpoint를 생성합니다.
-    Claude Code tool 사용 전에 호출되며, 위험 감지 시 사용자에게 알립니다.
+    Automatically creates checkpoints before dangerous operations.
+    Called before using the Claude Code tool, it notifies the user when danger is detected.
 
     Args:
-        payload: Claude Code 이벤트 페이로드
-                 (tool, arguments, cwd 키 포함)
+        payload: Claude Code event payload
+                 (includes tool, arguments, cwd keys)
 
     Returns:
         HookResult(
-            message=checkpoint 생성 알림 (위험 감지 시),
-            blocked=False (항상 작업 계속 진행)
+            message=checkpoint creation notification (when danger is detected);
+            blocked=False (always continue operation)
         )
 
     Checkpoint Triggers:
@@ -30,13 +30,13 @@ def handle_pre_tool_use(payload: HookPayload) -> HookResult:
         - MultiEdit: ≥10 files
 
     Examples:
-        Bash tool (rm -rf) 감지:
+        Bash tool (rm -rf) detection:
         → "🛡️ Checkpoint created: before-delete-20251015-143000"
 
     Notes:
-        - 위험 감지 후에도 blocked=False 반환 (작업 계속)
-        - Checkpoint 실패 시에도 작업 진행 (무시)
-        - 투명한 백그라운드 동작
+        - Return blocked=False even after detection of danger (continue operation)
+        - Work continues even when checkpoint fails (ignores)
+        - Transparent background operation
 
     @TAG:CHECKPOINT-EVENT-001
     """
@@ -44,18 +44,17 @@ def handle_pre_tool_use(payload: HookPayload) -> HookResult:
     tool_args = payload.get("arguments", {})
     cwd = payload.get("cwd", ".")
 
-    # 위험한 작업 감지
+    # Dangerous operation detection
     is_risky, operation_type = detect_risky_operation(tool_name, tool_args, cwd)
 
-    # 위험 감지 시 checkpoint 생성
+    # Create checkpoint when danger is detected
     if is_risky:
         checkpoint_branch = create_checkpoint(cwd, operation_type)
 
         if checkpoint_branch != "checkpoint-failed":
             message = (
                 f"🛡️ Checkpoint created: {checkpoint_branch}\n"
-                f"   Operation: {operation_type}\n"
-                f"   Restore: /alfred:0-project restore"
+                f"   Operation: {operation_type}"
             )
 
             return HookResult(message=message, blocked=False)
@@ -64,7 +63,7 @@ def handle_pre_tool_use(payload: HookPayload) -> HookResult:
 
 
 def handle_post_tool_use(payload: HookPayload) -> HookResult:
-    """PostToolUse 이벤트 핸들러 (기본 구현)"""
+    """PostToolUse event handler (default implementation)"""
     return HookResult()
 
 

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """User interaction handlers
 
-UserPromptSubmit 이벤트 처리
+Handling the UserPromptSubmit event
 """
 
 from core import HookPayload, HookResult
@@ -9,25 +9,25 @@ from core.context import get_jit_context
 
 
 def handle_user_prompt_submit(payload: HookPayload) -> HookResult:
-    """UserPromptSubmit 이벤트 핸들러
+    """UserPromptSubmit event handler
 
-    사용자 프롬프트를 분석하여 관련 문서를 자동으로 컨텍스트에 추가합니다.
-    JIT (Just-in-Time) Retrieval 원칙에 따라 필요한 문서만 로드합니다.
+    Analyze user prompts and automatically add relevant documents into context.
+    Follow the just-in-time (JIT) retrieval principle to load only the documents you need.
 
     Args:
-        payload: Claude Code 이벤트 페이로드
-                 (userPrompt, cwd 키 포함)
+        payload: Claude Code event payload
+                 (includes userPrompt, cwd keys)
 
     Returns:
         HookResult(
-            message=로드된 파일 수 (또는 None),
-            contextFiles=추천 문서 경로 리스트
+            message=Number of Files loaded (or None),
+            contextFiles=Recommended document path list
         )
 
     TDD History:
-        - RED: JIT 문서 로딩 시나리오 테스트
-        - GREEN: get_jit_context() 호출하여 문서 추천
-        - REFACTOR: 메시지 조건부 표시 (파일 있을 때만)
+        - RED: JIT document loading scenario testing
+        - GREEN: Recommend documents by calling get_jit_context()
+        - REFACTOR: Message conditional display (only when there is a file)
     """
     user_prompt = payload.get("userPrompt", "")
     cwd = payload.get("cwd", ".")