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

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

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+# @CODE:HOOKS-CLARITY-CLEAN | SPEC: Individual hook files for better UX
+"""SessionEnd Hook: Session Cleanup and Finalization
+
+Claude Code Event: SessionEnd
+Purpose: Clean up resources and finalize session when Claude Code exits
+Execution: Triggered when Claude Code session ends
+
+Output: Continue execution (currently a stub for future enhancements)
+"""
+
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+from utils.timeout import CrossPlatformTimeout
+from utils.timeout import TimeoutError as PlatformTimeoutError
+
+# Setup import path for shared modules
+HOOKS_DIR = Path(__file__).parent
+SHARED_DIR = HOOKS_DIR / "shared"
+if str(SHARED_DIR) not in sys.path:
+    sys.path.insert(0, str(SHARED_DIR))
+
+from handlers import handle_session_end
+
+
+def main() -> None:
+    """Main entry point for SessionEnd hook
+
+    Currently a stub for future functionality:
+    - Clear temporary caches
+    - Save session metrics
+    - Upload analytics (if enabled)
+    - Cleanup background processes
+
+    Exit Codes:
+        0: Success
+        1: Error (timeout, JSON parse failure, handler exception)
+    """
+    # Set 5-second timeout
+    timeout = CrossPlatformTimeout(5)
+    timeout.start()
+
+    try:
+        # Read JSON payload from stdin
+        input_data = sys.stdin.read()
+        data = json.loads(input_data) if input_data.strip() else {}
+
+        # Call handler
+        result = handle_session_end(data)
+
+        # Output result as JSON
+        print(json.dumps(result.to_dict()))
+        sys.exit(0)
+
+    except PlatformTimeoutError:
+        # Timeout - return minimal valid response
+        timeout_response: dict[str, Any] = {
+            "continue": True,
+            "systemMessage": "⚠️ SessionEnd cleanup timeout - session ending anyway",
+        }
+        print(json.dumps(timeout_response))
+        print("SessionEnd hook timeout after 5 seconds", file=sys.stderr)
+        sys.exit(1)
+
+    except json.JSONDecodeError as e:
+        # JSON parse error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"},
+        }
+        print(json.dumps(error_response))
+        print(f"SessionEnd JSON parse error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    except Exception as e:
+        # Unexpected error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"SessionEnd error: {e}"},
+        }
+        print(json.dumps(error_response))
+        print(f"SessionEnd unexpected error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    finally:
+        # Always cancel alarm
+        timeout.cancel()
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+# @CODE:HOOKS-CLARITY-001 | SPEC: Individual hook files for better UX
+"""SessionStart Hook: Show Project Information
+
+Claude Code Event: SessionStart
+Purpose: Display project status, language, Git info, and SPEC progress when session starts
+Execution: Triggered automatically when Claude Code session begins
+
+Output: System message with formatted project summary
+"""
+
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+from utils.timeout import CrossPlatformTimeout
+from utils.timeout import TimeoutError as PlatformTimeoutError
+
+# Setup import path for shared modules
+HOOKS_DIR = Path(__file__).parent
+SHARED_DIR = HOOKS_DIR / "shared"
+if str(SHARED_DIR) not in sys.path:
+    sys.path.insert(0, str(SHARED_DIR))
+
+from handlers import handle_session_start
+
+
+def main() -> None:
+    """Main entry point for SessionStart hook
+
+    Displays project information including:
+    - Programming language
+    - Git branch and status
+    - SPEC progress (completed/total)
+    - Recent checkpoints
+
+    Exit Codes:
+        0: Success
+        1: Error (timeout, JSON parse failure, handler exception)
+    """
+    # Set 5-second timeout
+    timeout = CrossPlatformTimeout(5)
+    timeout.start()
+
+    try:
+        # Read JSON payload from stdin
+        input_data = sys.stdin.read()
+        data = json.loads(input_data) if input_data.strip() else {}
+
+        # Call handler
+        result = handle_session_start(data)
+
+        # Output result as JSON
+        print(json.dumps(result.to_dict()))
+        sys.exit(0)
+
+    except PlatformTimeoutError:
+        # Timeout - return minimal valid response
+        timeout_response: dict[str, Any] = {
+            "continue": True,
+            "systemMessage": "⚠️ Session start timeout - continuing without project info",
+        }
+        print(json.dumps(timeout_response))
+        print("SessionStart hook timeout after 5 seconds", file=sys.stderr)
+        sys.exit(1)
+
+    except json.JSONDecodeError as e:
+        # JSON parse error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"},
+        }
+        print(json.dumps(error_response))
+        print(f"SessionStart JSON parse error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    except Exception as e:
+        # Unexpected error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"SessionStart error: {e}"},
+        }
+        print(json.dumps(error_response))
+        print(f"SessionStart unexpected error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    finally:
+        # Always cancel alarm
+        timeout.cancel()
+
+
+if __name__ == "__main__":
+    main()

moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/__init__.py

@@ -156,8 +156,8 @@ class HookResult:
             "continue": self.continue_execution,
             "hookSpecificOutput": {
                 "hookEventName": "UserPromptSubmit",
-                "additionalContext": context_str
-            }
+                "additionalContext": context_str,
+            },
         }
 
 

moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/checkpoint.py

@@ -56,7 +56,7 @@ def detect_risky_operation(tool_name: str, tool_args: dict[str, Any], cwd: str)
 
     Risky Operations:
         - Bash tool: rm -rf, git merge, git reset --hard, git rebase, script execution
-        - Edit/Write tool: CLAUDE.md, config.json, .moai/memory/*.md
+        - Edit/Write tool: CLAUDE.md, config.json, .claude/skills/*.md
         - MultiEdit tool: Edit ≥10 items File simultaneously
         - Script execution: Python, Node, Java, Go, Rust, Dart, Swift, Kotlin, Shell scripts
 
@@ -98,8 +98,8 @@ def detect_risky_operation(tool_name: str, tool_args: dict[str, Any], cwd: str)
         critical_files = [
             "CLAUDE.md",
             "config.json",
-            ".moai/memory/development-guide.md",
-            ".moai/memory/spec-metadata.md",
+            ".claude/skills/moai-alfred-dev-guide/reference.md",
+            ".claude/skills/moai-alfred-spec-metadata-extended/reference.md",
             ".moai/config.json",
         ]
 

moai_adk/templates/.claude/hooks/alfred/{core → shared/core}/context.py

@@ -22,13 +22,13 @@ def get_jit_context(prompt: str, cwd: str) -> list[str]:
         If there is no matching pattern or file, an empty list []
 
     Patterns:
-        - "/alfred:1-plan" → .moai/memory/spec-metadata.md
-        - "/alfred:2-run" → .moai/memory/development-guide.md
+        - "/alfred:1-plan" → .claude/skills/moai-alfred-spec-metadata-extended/reference.md
+        - "/alfred:2-run" → .claude/skills/moai-alfred-dev-guide/reference.md
         - "test" → tests/ (if directory exists)
 
     Examples:
         >>> get_jit_context("/alfred:1-plan", "/project")
-        ['.moai/memory/spec-metadata.md']
+        ['.claude/skills/moai-alfred-spec-metadata-extended/reference.md']
         >>> get_jit_context("implement test", "/project")
         ['tests/']
         >>> get_jit_context("unknown", "/project")
@@ -49,8 +49,8 @@ def get_jit_context(prompt: str, cwd: str) -> list[str]:
 
     # Pattern matching
     patterns = {
-        "/alfred:1-plan": [".moai/memory/spec-metadata.md"],
-        "/alfred:2-run": [".moai/memory/development-guide.md"],
+        "/alfred:1-plan": [".claude/skills/moai-alfred-spec-metadata-extended/reference.md"],
+        "/alfred:2-run": [".claude/skills/moai-alfred-dev-guide/reference.md"],
         "test": ["tests/"],
     }