moai-adk 0.10.1__py3-none-any.whl → 0.11.1__py3-none-any.whl

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

@@ -16,9 +16,10 @@ Risky Operations Detected:
 """
 
 import json
-import signal
 import sys
-from pathlib import Path
+from pathlib import
+from utils.timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
+ Path
 from typing import Any
 
 # Setup import path for shared modules
@@ -30,15 +31,9 @@ if str(SHARED_DIR) not in sys.path:
 from handlers import handle_pre_tool_use
 
 
-class HookTimeoutError(Exception):
-    """Hook execution timeout exception"""
     pass
 
 
-def _timeout_handler(signum, frame):
-    """Signal handler for 5-second timeout"""
-    raise HookTimeoutError("Hook execution exceeded 5-second timeout")
-
 
 def main() -> None:
     """Main entry point for PreToolUse hook
@@ -54,8 +49,8 @@ def main() -> None:
         1: Error (timeout, JSON parse failure, handler exception)
     """
     # Set 5-second timeout
-    signal.signal(signal.SIGALRM, _timeout_handler)
-    signal.alarm(5)
+    timeout = CrossPlatformTimeout(5)
+timeout.start()
 
     try:
         # Read JSON payload from stdin
@@ -69,11 +64,11 @@ def main() -> None:
         print(json.dumps(result.to_dict()))
         sys.exit(0)
 
-    except HookTimeoutError:
+    except PlatformTimeoutError:
         # Timeout - return minimal valid response (allow operation to continue)
         timeout_response: dict[str, Any] = {
             "continue": True,
-            "systemMessage": "⚠️ Checkpoint creation timeout - operation proceeding without checkpoint"
+            "systemMessage": "⚠️ Checkpoint creation timeout - operation proceeding without checkpoint",
         }
         print(json.dumps(timeout_response))
         print("PreToolUse hook timeout after 5 seconds", file=sys.stderr)
@@ -83,7 +78,7 @@ def main() -> None:
         # JSON parse error - allow operation to continue
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"JSON parse error: {e}"}
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"PreToolUse JSON parse error: {e}", file=sys.stderr)
@@ -93,7 +88,7 @@ def main() -> None:
         # Unexpected error - allow operation to continue
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"PreToolUse error: {e}"}
+            "hookSpecificOutput": {"error": f"PreToolUse error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"PreToolUse unexpected error: {e}", file=sys.stderr)
@@ -101,7 +96,7 @@ def main() -> None:
 
     finally:
         # Always cancel alarm
-        signal.alarm(0)
+        timeout.cancel()
 
 
 if __name__ == "__main__":

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

@@ -10,9 +10,10 @@ Output: Continue execution (currently a stub for future enhancements)
 """
 
 import json
-import signal
 import sys
-from pathlib import Path
+from pathlib import
+from utils.timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
+ Path
 from typing import Any
 
 # Setup import path for shared modules
@@ -24,15 +25,9 @@ if str(SHARED_DIR) not in sys.path:
 from handlers import handle_session_end
 
 
-class HookTimeoutError(Exception):
-    """Hook execution timeout exception"""
     pass
 
 
-def _timeout_handler(signum, frame):
-    """Signal handler for 5-second timeout"""
-    raise HookTimeoutError("Hook execution exceeded 5-second timeout")
-
 
 def main() -> None:
     """Main entry point for SessionEnd hook
@@ -48,8 +43,8 @@ def main() -> None:
         1: Error (timeout, JSON parse failure, handler exception)
     """
     # Set 5-second timeout
-    signal.signal(signal.SIGALRM, _timeout_handler)
-    signal.alarm(5)
+    timeout = CrossPlatformTimeout(5)
+timeout.start()
 
     try:
         # Read JSON payload from stdin
@@ -63,11 +58,11 @@ def main() -> None:
         print(json.dumps(result.to_dict()))
         sys.exit(0)
 
-    except HookTimeoutError:
+    except PlatformTimeoutError:
         # Timeout - return minimal valid response
         timeout_response: dict[str, Any] = {
             "continue": True,
-            "systemMessage": "⚠️ SessionEnd cleanup timeout - session ending anyway"
+            "systemMessage": "⚠️ SessionEnd cleanup timeout - session ending anyway",
         }
         print(json.dumps(timeout_response))
         print("SessionEnd hook timeout after 5 seconds", file=sys.stderr)
@@ -77,7 +72,7 @@ def main() -> None:
         # JSON parse error
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"JSON parse error: {e}"}
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"SessionEnd JSON parse error: {e}", file=sys.stderr)
@@ -87,7 +82,7 @@ def main() -> None:
         # Unexpected error
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"SessionEnd error: {e}"}
+            "hookSpecificOutput": {"error": f"SessionEnd error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"SessionEnd unexpected error: {e}", file=sys.stderr)
@@ -95,7 +90,7 @@ def main() -> None:
 
     finally:
         # Always cancel alarm
-        signal.alarm(0)
+        timeout.cancel()
 
 
 if __name__ == "__main__":

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

@@ -10,9 +10,10 @@ Output: System message with formatted project summary
 """
 
 import json
-import signal
 import sys
-from pathlib import Path
+from pathlib import
+from utils.timeout import CrossPlatformTimeout, TimeoutError as PlatformTimeoutError
+ Path
 from typing import Any
 
 # Setup import path for shared modules
@@ -24,15 +25,9 @@ if str(SHARED_DIR) not in sys.path:
 from handlers import handle_session_start
 
 
-class HookTimeoutError(Exception):
-    """Hook execution timeout exception"""
     pass
 
 
-def _timeout_handler(signum, frame):
-    """Signal handler for 5-second timeout"""
-    raise HookTimeoutError("Hook execution exceeded 5-second timeout")
-
 
 def main() -> None:
     """Main entry point for SessionStart hook
@@ -48,8 +43,8 @@ def main() -> None:
         1: Error (timeout, JSON parse failure, handler exception)
     """
     # Set 5-second timeout
-    signal.signal(signal.SIGALRM, _timeout_handler)
-    signal.alarm(5)
+    timeout = CrossPlatformTimeout(5)
+timeout.start()
 
     try:
         # Read JSON payload from stdin
@@ -63,11 +58,11 @@ def main() -> None:
         print(json.dumps(result.to_dict()))
         sys.exit(0)
 
-    except HookTimeoutError:
+    except PlatformTimeoutError:
         # Timeout - return minimal valid response
         timeout_response: dict[str, Any] = {
             "continue": True,
-            "systemMessage": "⚠️ Session start timeout - continuing without project info"
+            "systemMessage": "⚠️ Session start timeout - continuing without project info",
         }
         print(json.dumps(timeout_response))
         print("SessionStart hook timeout after 5 seconds", file=sys.stderr)
@@ -77,7 +72,7 @@ def main() -> None:
         # JSON parse error
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"JSON parse error: {e}"}
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"SessionStart JSON parse error: {e}", file=sys.stderr)
@@ -87,7 +82,7 @@ def main() -> None:
         # Unexpected error
         error_response: dict[str, Any] = {
             "continue": True,
-            "hookSpecificOutput": {"error": f"SessionStart error: {e}"}
+            "hookSpecificOutput": {"error": f"SessionStart error: {e}"},
         }
         print(json.dumps(error_response))
         print(f"SessionStart unexpected error: {e}", file=sys.stderr)
@@ -95,7 +90,7 @@ def main() -> None:
 
     finally:
         # Always cancel alarm
-        signal.alarm(0)
+        timeout.cancel()
 
 
 if __name__ == "__main__":

moai_adk/templates/.claude/hooks/alfred/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/shared/core/project.py

@@ -70,6 +70,7 @@ def find_project_root(start_path: str | Path = ".") -> Path:
 
 class TimeoutError(Exception):
     """Signal-based timeout exception"""
+
     pass
 
 
@@ -86,6 +87,7 @@ def timeout_handler(seconds: int):
     Raises:
         TimeoutError: If operation exceeds timeout
     """
+
     def _handle_timeout(signum, frame):
         raise TimeoutError(f"Operation timed out after {seconds} seconds")
 
@@ -427,19 +429,10 @@ def get_version_check_config(cwd: str) -> dict[str, Any]:
         - REFACTOR: Add validation and error handling
     """
     # TTL mapping by frequency
-    TTL_BY_FREQUENCY = {
-        "always": 0,
-        "daily": 24,
-        "weekly": 168,
-        "never": float('inf')
-    }
+    ttl_by_frequency = {"always": 0, "daily": 24, "weekly": 168, "never": float("inf")}
 
     # Default configuration
-    defaults = {
-        "enabled": True,
-        "frequency": "daily",
-        "cache_ttl_hours": 24
-    }
+    defaults = {"enabled": True, "frequency": "daily", "cache_ttl_hours": 24}
 
     # Find project root to ensure we read config from correct location
     project_root = find_project_root(cwd)
@@ -461,21 +454,17 @@ def get_version_check_config(cwd: str) -> dict[str, Any]:
         frequency = moai_config.get("update_check_frequency", defaults["frequency"])
 
         # Validate frequency
-        if frequency not in TTL_BY_FREQUENCY:
+        if frequency not in ttl_by_frequency:
             frequency = defaults["frequency"]
 
         # Calculate TTL from frequency
-        cache_ttl_hours = TTL_BY_FREQUENCY[frequency]
+        cache_ttl_hours = ttl_by_frequency[frequency]
 
         # Allow explicit cache_ttl_hours override
         if "cache_ttl_hours" in version_check_config:
             cache_ttl_hours = version_check_config["cache_ttl_hours"]
 
-        return {
-            "enabled": enabled,
-            "frequency": frequency,
-            "cache_ttl_hours": cache_ttl_hours
-        }
+        return {"enabled": enabled, "frequency": frequency, "cache_ttl_hours": cache_ttl_hours}
 
     except (OSError, json.JSONDecodeError, KeyError):
         # Config read or parse error - return defaults
@@ -619,13 +608,13 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
         if spec and spec.loader:
             version_cache_module = importlib.util.module_from_spec(spec)
             spec.loader.exec_module(version_cache_module)
-            VersionCache = version_cache_module.VersionCache
+            version_cache_class = version_cache_module.VersionCache
         else:
             # Skip caching if module can't be loaded
-            VersionCache = None
+            version_cache_class = None
     except (ImportError, OSError):
         # Graceful degradation: skip caching on import errors
-        VersionCache = None
+        version_cache_class = None
 
     # 1. Find project root (ensure cache is always in correct location)
     # This prevents creating .moai/cache in wrong locations when hooks run
@@ -634,7 +623,7 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
 
     # 2. Initialize cache (skip if VersionCache couldn't be imported)
     cache_dir = project_root / CACHE_DIR_NAME
-    version_cache = VersionCache(cache_dir) if VersionCache else None
+    version_cache = version_cache_class(cache_dir) if version_cache_class else None
 
     # 2. Get current installed version first (needed for cache validation)
     current_version = "unknown"
@@ -647,7 +636,7 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
             "current": "dev",
             "latest": "unknown",
             "update_available": False,
-            "upgrade_command": ""
+            "upgrade_command": "",
         }
 
     # 3. Try to load from cache (fast path with version validation)
@@ -670,7 +659,7 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
         "current": current_version,
         "latest": "unknown",
         "update_available": False,
-        "upgrade_command": ""
+        "upgrade_command": "",
     }
 
     # 5. Check if version check is enabled in config
@@ -701,7 +690,9 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
                     release_url = project_urls.get("Changelog", "")
                     if not release_url:
                         # Fallback to GitHub releases URL pattern
-                        release_url = f"https://github.com/modu-ai/moai-adk/releases/tag/v{result['latest']}"
+                        release_url = (
+                            f"https://github.com/modu-ai/moai-adk/releases/tag/v{result['latest']}"
+                        )
                     result["release_notes_url"] = release_url
                 except (KeyError, AttributeError, TypeError):
                     result["release_notes_url"] = None
@@ -728,7 +719,9 @@ def get_package_version_info(cwd: str = ".") -> dict[str, Any]:
                 result["upgrade_command"] = f"uv pip install --upgrade moai-adk>={result['latest']}"
 
                 # Detect major version change
-                result["is_major_update"] = is_major_version_change(result["current"], result["latest"])
+                result["is_major_update"] = is_major_version_change(
+                    result["current"], result["latest"]
+                )
             else:
                 result["is_major_update"] = False
         except (ValueError, AttributeError):

moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py

@@ -38,9 +38,22 @@ from pathlib import Path
 from typing import Iterable, List, Optional
 
 DEFAULT_CODE_EXTS = (
-    ".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs",
-    ".java", ".kt", ".rb", ".php", ".c", ".cpp", ".cs",
-    ".swift", ".scala"
+    ".py",
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".go",
+    ".rs",
+    ".java",
+    ".kt",
+    ".rb",
+    ".php",
+    ".c",
+    ".cpp",
+    ".cs",
+    ".swift",
+    ".scala",
 )
 
 
@@ -88,35 +101,49 @@ def _load_rules(cwd: str) -> List[Rule]:
 
     # Defaults (ordered)
     return [
-        Rule(
-            include=[".moai/specs/**", "**/SPEC-*/spec.md"],
-            expect="@SPEC:",
-            exclude=[]
-        ),
+        Rule(include=[".moai/specs/**", "**/SPEC-*/spec.md"], expect="@SPEC:", exclude=[]),
         Rule(
             include=[
-                "**/*_test.py", "**/test_*.py", "**/*.test.ts",
-                "**/*.test.tsx", "**/*.test.js", "**/*.test.jsx",
-                "**/*.test.go", "**/*.test.rs", "**/*.spec.ts",
-                "**/*.spec.tsx", "tests/**"
+                "**/*_test.py",
+                "**/test_*.py",
+                "**/*.test.ts",
+                "**/*.test.tsx",
+                "**/*.test.js",
+                "**/*.test.jsx",
+                "**/*.test.go",
+                "**/*.test.rs",
+                "**/*.spec.ts",
+                "**/*.spec.tsx",
+                "tests/**",
             ],
             expect="@TEST:",
-            exclude=[".claude/**"]
+            exclude=[".claude/**"],
         ),
         Rule(
             include=["docs/**/*.md", "**/README.md", "**/*.api.md"],
             expect="@DOC:",
-            exclude=[".claude/**"]
+            exclude=[".claude/**"],
         ),
         Rule(
             include=["**/*"],
             expect="@CODE:",
             exclude=[
-                "tests/**", "docs/**", ".moai/**", ".claude/**",
-                "**/*.md", "**/*.json", "**/*.yml", "**/*.yaml",
-                "**/*.toml", "**/*.lock", "**/*.svg", "**/*.png",
-                "**/*.jpg", "**/*.jpeg", "**/*.gif"
-            ]
+                "tests/**",
+                "docs/**",
+                ".moai/**",
+                ".claude/**",
+                "**/*.md",
+                "**/*.json",
+                "**/*.yml",
+                "**/*.yaml",
+                "**/*.toml",
+                "**/*.lock",
+                "**/*.svg",
+                "**/*.png",
+                "**/*.jpg",
+                "**/*.jpeg",
+                "**/*.gif",
+            ],
         ),
     ]
 
@@ -147,17 +174,22 @@ def _iter_recent_changes(cwd: str) -> Iterable[Path]:
         # Staged files
         r1 = subprocess.run(
             ["git", "diff", "--name-only", "--cached"],
-            cwd=cwd, capture_output=True, text=True, timeout=1
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+            timeout=1,
         )
         # Modified (unstaged) tracked files
         r2 = subprocess.run(
-            ["git", "ls-files", "-m"],
-            cwd=cwd, capture_output=True, text=True, timeout=1
+            ["git", "ls-files", "-m"], cwd=cwd, capture_output=True, text=True, timeout=1
         )
         # Untracked (other) files respecting .gitignore
         r3 = subprocess.run(
             ["git", "ls-files", "-o", "--exclude-standard"],
-            cwd=cwd, capture_output=True, text=True, timeout=1
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+            timeout=1,
         )
         names = set()
         if r1.returncode == 0:

moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py

@@ -86,7 +86,7 @@ class VersionCache:
             return False
 
         try:
-            with open(self.cache_file, 'r') as f:
+            with open(self.cache_file, "r") as f:
                 data = json.load(f)
 
             age_hours = self._calculate_age_hours(data["last_check"])
@@ -112,7 +112,7 @@ class VersionCache:
             return None
 
         try:
-            with open(self.cache_file, 'r') as f:
+            with open(self.cache_file, "r") as f:
                 return json.load(f)
         except (json.JSONDecodeError, OSError):
             # Graceful degradation on read errors
@@ -144,7 +144,7 @@ class VersionCache:
                 version_info["last_check"] = datetime.now(timezone.utc).isoformat()
 
             # Write to cache file
-            with open(self.cache_file, 'w') as f:
+            with open(self.cache_file, "w") as f:
                 json.dump(version_info, f, indent=2)
 
             return True
@@ -186,7 +186,7 @@ class VersionCache:
             return 0.0
 
         try:
-            with open(self.cache_file, 'r') as f:
+            with open(self.cache_file, "r") as f:
                 data = json.load(f)
 
             return self._calculate_age_hours(data["last_check"])