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

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

@@ -1,161 +0,0 @@
-#!/usr/bin/env python3
-"""Session event handlers
-
-SessionStart, SessionEnd event handling
-"""
-
-from core import HookPayload, HookResult
-from core.checkpoint import list_checkpoints
-from core.project import count_specs, detect_language, get_git_info, get_package_version_info
-
-
-def handle_session_start(payload: HookPayload) -> HookResult:
-    """SessionStart event handler with GRACEFUL DEGRADATION
-
-    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.
-    All optional operations are wrapped in try-except to ensure hook completes quickly even if
-    Git commands, file I/O, or other operations timeout or fail.
-
-    Args:
-        payload: Claude Code event payload (cwd key required)
-
-    Returns:
-        HookResult(system_message=project status summary message)
-
-    Message Format:
-        🚀 MoAI-ADK Session Started
-           Language: {language}
-           [Branch: {branch} ({commit hash})] - optional if git fails
-           [Changes: {Number of Changed Files}] - optional if git fails
-           [SPEC Progress: {Complete}/{Total} ({percent}%)] - optional if specs fail
-           [Checkpoints: {number} available] - optional if checkpoint list fails
-
-    Graceful Degradation Strategy:
-        - CRITICAL: Language detection (must succeed - no try-except)
-        - OPTIONAL: Git info (skip if timeout/failure)
-        - OPTIONAL: SPEC progress (skip if timeout/failure)
-        - OPTIONAL: Checkpoint list (skip if timeout/failure)
-        - Always display SOMETHING to user, never return empty message
-
-    Note:
-        - Claude Code processes SessionStart in several stages (clear → compact)
-        - Display message only at "compact" stage to prevent duplicate output
-        - "clear" step returns minimal result (empty hookSpecificOutput)
-        - CRITICAL: All optional operations must complete within 2-3 seconds total
-
-    TDD History:
-        - 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)
-        - UPDATE: Migrated to Claude Code standard Hook schema
-        - HOTFIX: Add graceful degradation for timeout scenarios (Issue #66)
-
-    @TAG:CHECKPOINT-EVENT-001
-    @TAG:HOOKS-TIMEOUT-001
-    """
-    # 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 minimal valid Hook result for clear phase
-        return HookResult(continue_execution=True)
-
-    cwd = payload.get("cwd", ".")
-
-    # CRITICAL: Language detection - MUST succeed (no try-except)
-    language = detect_language(cwd)
-
-    # OPTIONAL: Git info - skip if timeout/failure
-    git_info = {}
-    try:
-        git_info = get_git_info(cwd)
-    except Exception:
-        # Graceful degradation - continue without git info
-        pass
-
-    # OPTIONAL: SPEC progress - skip if timeout/failure
-    specs = {"completed": 0, "total": 0, "percentage": 0}
-    try:
-        specs = count_specs(cwd)
-    except Exception:
-        # Graceful degradation - continue without spec info
-        pass
-
-    # OPTIONAL: Checkpoint list - skip if timeout/failure
-    checkpoints = []
-    try:
-        checkpoints = list_checkpoints(cwd, max_count=10)
-    except Exception:
-        # Graceful degradation - continue without checkpoints
-        pass
-
-    # OPTIONAL: Package version info - skip if timeout/failure
-    version_info = {}
-    try:
-        version_info = get_package_version_info()
-    except Exception:
-        # Graceful degradation - continue without version info
-        pass
-
-    # Build message with available information
-    branch = git_info.get("branch", "N/A") if git_info else "N/A"
-    commit = git_info.get("commit", "N/A")[:7] if git_info else "N/A"
-    changes = git_info.get("changes", 0) if git_info else 0
-    spec_progress = f"{specs['completed']}/{specs['total']}" if specs["total"] > 0 else "0/0"
-
-    # system_message: displayed directly to the user
-    lines = [
-        "🚀 MoAI-ADK Session Started",
-        "",  # Blank line after title
-    ]
-
-    # Add version info first (at the top, right after title)
-    if version_info and version_info.get("current") != "unknown":
-        version_line = f"   🗿 MoAI-ADK Ver: {version_info['current']}"
-        if version_info.get("update_available"):
-            version_line += f" → {version_info['latest']} available ✨"
-        lines.append(version_line)
-
-        # Add upgrade recommendation if update is available
-        if version_info.get("update_available") and version_info.get("upgrade_command"):
-            lines.append(f"   ⬆️ Upgrade: {version_info['upgrade_command']}")
-
-    # Add language info
-    lines.append(f"   🐍 Language: {language}")
-
-    # Add Git info only if available (not degraded)
-    if git_info:
-        lines.append(f"   🌿 Branch: {branch} ({commit})")
-        lines.append(f"   📝 Changes: {changes}")
-
-        # Add last commit message if available
-        last_commit = git_info.get("last_commit", "")
-        if last_commit:
-            lines.append(f"   🔨 Last: {last_commit}")
-
-    # Add Checkpoint list (show only the latest 3 items)
-    if checkpoints:
-        lines.append(f"   🗂️  Checkpoints: {len(checkpoints)} available")
-        for cp in reversed(checkpoints[-3:]):  # Latest 3 items
-            branch_short = cp["branch"].replace("before-", "")
-            lines.append(f"      📌 {branch_short}")
-        lines.append("")  # Blank line before restore command
-        lines.append("   ↩️  Restore: /alfred:0-project restore")
-
-    # Add SPEC progress only if available (not degraded) - at the bottom
-    if specs["total"] > 0:
-        lines.append(f"   📋 SPEC Progress: {spec_progress} ({specs['percentage']}%)")
-
-    system_message = "\n".join(lines)
-
-    return HookResult(system_message=system_message)
-
-
-def handle_session_end(payload: HookPayload) -> HookResult:
-    """SessionEnd event handler (default implementation)"""
-    return HookResult()
-
-
-__all__ = ["handle_session_start", "handle_session_end"]

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

@@ -1,90 +0,0 @@
-#!/usr/bin/env python3
-# @CODE:HOOK-TOOL-001 | SPEC: TBD | TEST: tests/hooks/test_handlers.py
-"""Tool usage handlers
-
-PreToolUse, PostToolUse event handling
-"""
-
-from core import HookPayload, HookResult
-from core.checkpoint import create_checkpoint, detect_risky_operation
-from core.tags import scan_recent_changes_for_missing_tags
-
-
-def handle_pre_tool_use(payload: HookPayload) -> HookResult:
-    """PreToolUse event handler (Event-Driven Checkpoint integration)
-
-    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 event payload
-                 (includes tool, arguments, cwd keys)
-
-    Returns:
-        HookResult(
-            system_message=checkpoint creation notification (when danger is detected);
-            continue_execution=True (always continue operation)
-        )
-
-    Checkpoint Triggers:
-        - Bash: rm -rf, git merge, git reset --hard
-        - Edit/Write: CLAUDE.md, config.json
-        - MultiEdit: ≥10 files
-
-    Examples:
-        Bash tool (rm -rf) detection:
-        → "🛡️ Checkpoint created: before-delete-20251015-143000"
-
-    Notes:
-        - Return continue_execution=True even after detection of danger (continue operation)
-        - Work continues even when checkpoint fails (ignores)
-        - Transparent background operation
-
-    @TAG:CHECKPOINT-EVENT-001
-    """
-    tool_name = payload.get("tool", "")
-    tool_args = payload.get("arguments", {})
-    cwd = payload.get("cwd", ".")
-
-    # Dangerous operation detection (best-effort)
-    try:
-        is_risky, operation_type = detect_risky_operation(tool_name, tool_args, cwd)
-        # Create checkpoint when danger is detected
-        if is_risky:
-            checkpoint_branch = create_checkpoint(cwd, operation_type)
-            if checkpoint_branch != "checkpoint-failed":
-                system_message = (
-                    f"🛡️ Checkpoint created: {checkpoint_branch}\n"
-                    f"   Operation: {operation_type}"
-                )
-                return HookResult(system_message=system_message, continue_execution=True)
-    except Exception:
-        # Do not fail the hook if risk detection errors out
-        pass
-
-    # TAG Guard (gentle): warn when recent changes miss @TAG
-    issues = scan_recent_changes_for_missing_tags(cwd)
-    if issues:
-        # Summarize first few issues for display
-        preview = "\n".join(
-            f" - {i.path} → 기대 태그: {i.expected}" for i in issues[:5]
-        )
-        more = "" if len(issues) <= 5 else f"\n (외 {len(issues)-5}건 더 존재)"
-        msg = (
-            "⚠️ TAG 누락 감지: 생성/수정한 파일 중 @TAG가 없는 항목이 있습니다.\n"
-            f"{preview}{more}\n"
-            "권장 조치:\n"
-            "  1) SPEC/TEST/CODE/DOC 유형에 맞는 @TAG를 파일 상단 주석이나 헤더에 추가\n"
-            "  2) rg로 확인: rg '@(SPEC|TEST|CODE|DOC):' -n <경로>\n"
-        )
-        return HookResult(system_message=msg, continue_execution=True)
-
-    return HookResult(continue_execution=True)
-
-
-def handle_post_tool_use(payload: HookPayload) -> HookResult:
-    """PostToolUse event handler (default implementation)"""
-    return HookResult()
-
-
-__all__ = ["handle_pre_tool_use", "handle_post_tool_use"]

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

@@ -1,42 +0,0 @@
-#!/usr/bin/env python3
-"""User interaction handlers
-
-Handling the UserPromptSubmit event
-"""
-
-from core import HookPayload, HookResult
-from core.context import get_jit_context
-
-
-def handle_user_prompt_submit(payload: HookPayload) -> HookResult:
-    """UserPromptSubmit event handler
-
-    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 event payload
-                 (includes userPrompt, cwd keys)
-
-    Returns:
-        HookResult(
-            system_message=Number of Files loaded (or None),
-            context_files=Recommended document path list
-        )
-
-    TDD History:
-        - RED: JIT document loading scenario testing
-        - GREEN: Recommend documents by calling get_jit_context()
-        - REFACTOR: Message conditional display (only when there is a file)
-        - UPDATE: Migrated to Claude Code standard Hook schema with snake_case fields
-    """
-    user_prompt = payload.get("userPrompt", "")
-    cwd = payload.get("cwd", ".")
-    context_files = get_jit_context(user_prompt, cwd)
-
-    system_message = f"📎 Loaded {len(context_files)} context file(s)" if context_files else None
-
-    return HookResult(system_message=system_message, context_files=context_files)
-
-
-__all__ = ["handle_user_prompt_submit"]

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()