moai-adk 0.8.0__py3-none-any.whl → 0.15.0__py3-none-any.whl

moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py

@@ -1,174 +0,0 @@
-#!/usr/bin/env python3
-# @CODE:HOOKS-REFACTOR-001 | SPEC: SPEC-HOOKS-REFACTOR-001.md
-"""Alfred Hooks - Main entry point for MoAI-ADK Claude Code Hooks
-
-A main entry point that routes Claude Code events to the appropriate handlers.
-
-🏗️ Architecture:
-┌─────────────────────────────────────────────────────────────┐
-│ alfred_hooks.py (Router)                                    │
-├─────────────────────────────────────────────────────────────┤
-│ - CLI argument parsing                                      │
-│ - JSON I/O (stdin/stdout)                                   │
-│ - Event routing to handlers                                 │
-└─────────────────────────────────────────────────────────────┘
-                         ▼
-┌─────────────────────────────────────────────────────────────┐
-│ handlers/ (Event Handlers)                                  │
-├─────────────────────────────────────────────────────────────┤
-│ - session.py: SessionStart, SessionEnd                      │
-│ - user.py: UserPromptSubmit                                 │
-│ - tool.py: PreToolUse, PostToolUse                          │
-│ - notification.py: Notification, Stop, SubagentStop         │
-└─────────────────────────────────────────────────────────────┘
-                         ▼
-┌─────────────────────────────────────────────────────────────┐
-│ core/ (Business Logic)                                      │
-├─────────────────────────────────────────────────────────────┤
-│ - project.py: Language detection, Git info, SPEC progress   │
-│ - context.py: JIT Retrieval, workflow context               │
-│ - checkpoint.py: Event-Driven Checkpoint system             │
-│ - tags.py: TAG search/verification, library version cache   │
-└─────────────────────────────────────────────────────────────┘
-
-🛠️ Usage:
-    python alfred_hooks.py <event_name> < payload.json
-
-📣 Supported Events:
-    - SessionStart: Start Session (display project status)
-    - UserPromptSubmit: Prompt submission (JIT document loading)
-    - PreToolUse: Before using the tool (automatically creates checkpoint)
-    - SessionEnd, PostToolUse, Notification, Stop, SubagentStop
-
-🚦 Exit Codes:
-    - 0: Success
-    - 1: Error (no arguments, JSON parsing failure, exception thrown)
-
-🧪 TDD History:
-    - RED: Module separation design, event routing test
-    - GREEN: 1233 LOC → 9 items Module separation implementation (SRP compliance)
-    - REFACTOR: Import optimization, enhanced error handling
-
-Setup sys.path for package imports
-"""
-
-import json
-import sys
-from pathlib import Path
-from typing import Any
-
-from core import HookResult
-from handlers import (
-    handle_notification,
-    handle_post_tool_use,
-    handle_pre_tool_use,
-    handle_session_end,
-    handle_session_start,
-    handle_stop,
-    handle_subagent_stop,
-    handle_user_prompt_submit,
-)
-
-# Add the hooks directory to sys.path to enable package imports
-HOOKS_DIR = Path(__file__).parent
-if str(HOOKS_DIR) not in sys.path:
-    sys.path.insert(0, str(HOOKS_DIR))
-
-
-def main() -> None:
-    """Main entry point - Claude Code Hook script
-
-    Receives the event name as a CLI argument and reads the JSON payload through stdin.
-    Calls the handler appropriate for the event and outputs the results to stdout as JSON.
-
-    🛠️ Usage:
-        python alfred_hooks.py <event_name> < payload.json
-
-    📣 Supported Events:
-        - SessionStart: Start Session (display project status)
-        - UserPromptSubmit: Prompt submission (JIT document loading)
-        - SessionEnd, PreToolUse, PostToolUse, Notification, Stop, SubagentStop
-
-    🚦 Exit Codes:
-        - 0: Success
-        - 1: Error (no arguments, JSON parsing failure, exception thrown)
-
-    📝 Examples:
-        $ echo '{"cwd": "."}' | python alfred_hooks.py SessionStart
-        {"message": "🚀 MoAI-ADK Session Started\\n...", ...}
-
-    🗒️ Notes:
-        - Claude Code is automatically called (no need for direct user execution)
-        - JSON I/O processing through stdin/stdout
-        - Print error message to stderr
-        - UserPromptSubmit uses a special output schema (hookEventName + additionalContext)
-
-    🧪 TDD History:
-        - RED: Event routing, JSON I/O, error handling testing
-        - GREEN: Handler map-based routing implementation
-        - REFACTOR: Error message clarification, exit code standardization, UserPromptSubmit schema separation
-    """
-    # Check for event argument
-    if len(sys.argv) < 2:
-        print("Usage: alfred_hooks.py <event>", file=sys.stderr)
-        sys.exit(1)
-
-    event_name = sys.argv[1]
-
-    try:
-        # Read JSON from stdin
-        input_data = sys.stdin.read()
-        # Handle empty stdin gracefully (return empty dict)
-        if not input_data or not input_data.strip():
-            data = {}
-        else:
-            data = json.loads(input_data)
-
-        cwd = data.get("cwd", ".")
-
-        # Route to appropriate handler
-        handlers = {
-            "SessionStart": handle_session_start,
-            "UserPromptSubmit": handle_user_prompt_submit,
-            "SessionEnd": handle_session_end,
-            "PreToolUse": handle_pre_tool_use,
-            "PostToolUse": handle_post_tool_use,
-            "Notification": handle_notification,
-            "Stop": handle_stop,
-            "SubagentStop": handle_subagent_stop,
-        }
-
-        handler = handlers.get(event_name)
-        result = handler({"cwd": cwd, **data}) if handler else HookResult()
-
-        # Output Hook result as JSON
-        # Note: UserPromptSubmit uses to_user_prompt_submit_dict() for special schema
-        if event_name == "UserPromptSubmit":
-            print(json.dumps(result.to_user_prompt_submit_dict()))
-        else:
-            print(json.dumps(result.to_dict()))
-
-        sys.exit(0)
-
-    except json.JSONDecodeError as e:
-        # Return valid Hook response even on JSON parse error
-        error_response: dict[str, Any] = {
-            "continue": True,
-            "hookSpecificOutput": {"error": f"JSON parse error: {e}"}
-        }
-        print(json.dumps(error_response))
-        print(f"JSON parse error: {e}", file=sys.stderr)
-        sys.exit(1)
-    except Exception as e:
-        # Return valid Hook response even on unexpected error
-        error_response: dict[str, Any] = {
-            "continue": True,
-            "hookSpecificOutput": {"error": f"Hook error: {e}"}
-        }
-        print(json.dumps(error_response))
-        print(f"Unexpected error: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,25 +0,0 @@
-#!/usr/bin/env python3
-"""Notification and control handlers
-
-Notification, Stop, SubagentStop event handling
-"""
-
-from core import HookPayload, HookResult
-
-
-def handle_notification(payload: HookPayload) -> HookResult:
-    """Notification event handler (default implementation)"""
-    return HookResult()
-
-
-def handle_stop(payload: HookPayload) -> HookResult:
-    """Stop event handler (default implementation)"""
-    return HookResult()
-
-
-def handle_subagent_stop(payload: HookPayload) -> HookResult:
-    """SubagentStop event handler (default implementation)"""
-    return HookResult()
-
-
-__all__ = ["handle_notification", "handle_stop", "handle_subagent_stop"]

moai_adk/templates/.claude/hooks/alfred/test_hook_output.py

@@ -1,175 +0,0 @@
-#!/usr/bin/env -S uv run --script
-# /// script
-# requires-python = ">=3.11"
-# ///
-"""Test Hook Output Validation
-
-자동 테스트: Claude Code Hook JSON 스키마 검증
-
-- SessionStart Hook JSON 출력 검증
-- UserPromptSubmit Hook 특수 스키마 검증
-- 모든 Hook 이벤트 스키마 일관성 검증
-
-실행:
-    uv run test_hook_output.py
-"""
-
-import json
-import sys
-from pathlib import Path
-
-# Add hooks directory to sys.path
-HOOKS_DIR = Path(__file__).parent
-if str(HOOKS_DIR) not in sys.path:
-    sys.path.insert(0, str(HOOKS_DIR))
-
-from core import HookResult  # noqa: E402
-
-
-def test_basic_output():
-    """Test 1: Basic output with only continue flag"""
-    result = HookResult(continue_execution=True)
-    output = result.to_dict()
-
-    assert output == {"continue": True}, f"Expected {{'continue': True}}, got {output}"
-    print("✅ Test 1: Basic output - PASSED")
-
-
-def test_system_message_top_level():
-    """Test 2: systemMessage at TOP-LEVEL (not in hookSpecificOutput)"""
-    result = HookResult(system_message="Test message")
-    output = result.to_dict()
-
-    assert "systemMessage" in output, "systemMessage not found in output"
-    assert output["systemMessage"] == "Test message"
-    assert "hookSpecificOutput" not in output, "hookSpecificOutput should not be in to_dict() output"
-    print("✅ Test 2: systemMessage (top-level) - PASSED")
-
-
-def test_decision_with_reason():
-    """Test 3: decision + reason (block pattern)"""
-    result = HookResult(decision="block", reason="Dangerous operation")
-    output = result.to_dict()
-
-    assert output.get("decision") == "block"
-    assert output.get("reason") == "Dangerous operation"
-    assert "continue" not in output, "continue should not appear when decision is set"
-    print("✅ Test 3: decision + reason - PASSED")
-
-
-def test_user_prompt_submit_schema():
-    """Test 4: UserPromptSubmit special schema"""
-    result = HookResult(context_files=["tests/", "docs/"])
-    output = result.to_user_prompt_submit_dict()
-
-    assert "hookSpecificOutput" in output
-    assert output["hookSpecificOutput"]["hookEventName"] == "UserPromptSubmit"
-    assert "additionalContext" in output["hookSpecificOutput"]
-    assert "📎 Context: tests/" in output["hookSpecificOutput"]["additionalContext"]
-    print("✅ Test 4: UserPromptSubmit schema - PASSED")
-
-
-def test_permission_decision():
-    """Test 5: permissionDecision field"""
-    result = HookResult(permission_decision="deny")
-    output = result.to_dict()
-
-    assert output.get("permissionDecision") == "deny"
-    assert "continue" in output  # continue should still be present
-    print("✅ Test 5: permissionDecision - PASSED")
-
-
-def test_session_start_typical_output():
-    """Test 6: Typical SessionStart output"""
-    result = HookResult(
-        continue_execution=True,
-        system_message="🚀 MoAI-ADK Session Started\n   Language: python\n   Branch: develop"
-    )
-    output = result.to_dict()
-
-    # Validate schema
-    assert "continue" in output or "decision" in output, "Missing continue or decision"
-    assert output.get("systemMessage", "").startswith("🚀 MoAI-ADK")
-
-    # Ensure internal fields are NOT in output
-    assert "context_files" not in output, "Internal field context_files leaked to output"
-    assert "suggestions" not in output, "Internal field suggestions leaked to output"
-    assert "exit_code" not in output, "Internal field exit_code leaked to output"
-
-    print("✅ Test 6: SessionStart typical output - PASSED")
-
-
-def test_json_serializable():
-    """Test 7: Output is JSON serializable"""
-    result = HookResult(
-        system_message="Test",
-        decision="approve",
-        reason="Valid operation"
-    )
-    output = result.to_dict()
-
-    try:
-        json_str = json.dumps(output)
-        parsed = json.loads(json_str)
-        assert parsed == output
-        print("✅ Test 7: JSON serializable - PASSED")
-    except Exception as e:
-        print(f"❌ Test 7: JSON serialization FAILED: {e}")
-        sys.exit(1)
-
-
-def test_user_prompt_submit_with_system_message():
-    """Test 8: UserPromptSubmit with both context and system message"""
-    result = HookResult(
-        context_files=["src/"],
-        system_message="Loading context..."
-    )
-    output = result.to_user_prompt_submit_dict()
-
-    assert "hookSpecificOutput" in output
-    assert "Loading context..." in output["hookSpecificOutput"]["additionalContext"]
-    assert "📎 Context: src/" in output["hookSpecificOutput"]["additionalContext"]
-    print("✅ Test 8: UserPromptSubmit with system_message - PASSED")
-
-
-def main():
-    """Run all tests"""
-    print("\n" + "="*60)
-    print("🧪 Claude Code Hook Output Validation Tests")
-    print("="*60 + "\n")
-
-    tests = [
-        test_basic_output,
-        test_system_message_top_level,
-        test_decision_with_reason,
-        test_user_prompt_submit_schema,
-        test_permission_decision,
-        test_session_start_typical_output,
-        test_json_serializable,
-        test_user_prompt_submit_with_system_message,
-    ]
-
-    failed = 0
-    for test in tests:
-        try:
-            test()
-        except AssertionError as e:
-            print(f"❌ {test.__name__}: FAILED - {e}")
-            failed += 1
-        except Exception as e:
-            print(f"❌ {test.__name__}: ERROR - {e}")
-            failed += 1
-
-    print("\n" + "="*60)
-    if failed == 0:
-        print(f"✅ ALL {len(tests)} TESTS PASSED")
-        print("="*60 + "\n")
-        sys.exit(0)
-    else:
-        print(f"❌ {failed}/{len(tests)} TESTS FAILED")
-        print("="*60 + "\n")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()