moai-adk 0.32.8__py3-none-any.whl → 0.41.2__py3-none-any.whl

moai_adk/templates/.claude/hooks/moai/lib/unified_timeout_manager.py

@@ -26,6 +26,13 @@ from typing import Any, Callable, Dict, Optional, Set
 
 import yaml
 
+# Import base TimeoutError from timeout module for exception hierarchy
+try:
+    from .timeout import TimeoutError as BaseTimeoutError
+except ImportError:
+    # Fallback if timeout module not available
+    BaseTimeoutError = Exception  # type: ignore
+
 
 class TimeoutPolicy(Enum):
     """Timeout policy types for different hook categories"""
@@ -62,8 +69,13 @@ class TimeoutSession:
     cleanup_actions: list = field(default_factory=list)
 
 
-class HookTimeoutError(Exception):
-    """Enhanced timeout error with context"""
+class HookTimeoutError(BaseTimeoutError):
+    """Enhanced timeout error with context.
+
+    Inherits from timeout.TimeoutError for consistent exception handling
+    across the hooks system. Adds hook-specific context like hook_id,
+    execution time, and retry information.
+    """
 
     def __init__(
         self,

moai_adk/templates/.claude/hooks/moai/post_tool__ast_grep_scan.py

@@ -0,0 +1,256 @@
+#!/usr/bin/env python3
+"""PostToolUse Hook: Automatic AST-Grep Security Scan
+
+Automatically runs AST-Grep security scanning after Write/Edit operations
+to detect potential security vulnerabilities in real-time.
+
+Hook Protocol:
+- Input: JSON from stdin with tool_name, tool_input
+- Output: JSON to stdout with hookSpecificOutput
+- Exit codes: 0 = success, 2 = attention needed
+"""
+
+import json
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Optional
+
+# Supported extensions for AST-Grep scanning
+SUPPORTED_EXTENSIONS = {
+    ".py",
+    ".pyi",  # Python
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",  # JavaScript
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",  # TypeScript
+    ".go",  # Go
+    ".rs",  # Rust
+    ".java",  # Java
+    ".kt",
+    ".kts",  # Kotlin
+    ".c",
+    ".cpp",
+    ".cc",
+    ".h",
+    ".hpp",  # C/C++
+    ".rb",  # Ruby
+    ".php",  # PHP
+}
+
+# Environment variable to disable AST-Grep scanning
+DISABLE_ENV_VAR = "MOAI_DISABLE_AST_GREP_SCAN"
+
+
+def get_project_dir() -> Path:
+    """Get the project directory from environment or current working directory."""
+    project_dir = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+    return Path(project_dir)
+
+
+def get_rules_config_path() -> Optional[Path]:
+    """Find the AST-Grep rules configuration file."""
+    project_dir = get_project_dir()
+
+    # Check common locations for sgconfig.yml
+    possible_paths = [
+        project_dir / ".claude" / "skills" / "moai-tool-ast-grep" / "rules" / "sgconfig.yml",
+        project_dir / "sgconfig.yml",
+        project_dir / ".ast-grep" / "sgconfig.yml",
+    ]
+
+    for path in possible_paths:
+        if path.exists():
+            return path
+
+    return None
+
+
+def is_scannable_file(file_path: str) -> bool:
+    """Check if the file is supported for AST-Grep scanning."""
+    if not file_path:
+        return False
+
+    ext = Path(file_path).suffix.lower()
+    return ext in SUPPORTED_EXTENSIONS
+
+
+def run_ast_grep_scan(file_path: str, config_path: Optional[Path] = None) -> dict:
+    """Run AST-Grep scan on a file and return results."""
+    result = {
+        "scanned": False,
+        "issues_found": 0,
+        "error_count": 0,
+        "warning_count": 0,
+        "info_count": 0,
+        "details": [],
+        "error": None,
+    }
+
+    # Check if sg (ast-grep) is available
+    if not shutil.which("sg"):
+        result["error"] = "ast-grep (sg) not installed"
+        return result
+
+    try:
+        # Build command
+        cmd = ["sg", "scan", "--json"]
+
+        if config_path and config_path.exists():
+            cmd.extend(["--config", str(config_path)])
+
+        cmd.append(file_path)
+
+        # Run scan with timeout
+        proc = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=30,
+            cwd=str(get_project_dir()),
+        )
+
+        result["scanned"] = True
+
+        # Parse JSON output
+        if proc.stdout.strip():
+            try:
+                findings = json.loads(proc.stdout)
+                if isinstance(findings, list):
+                    for finding in findings:
+                        severity = finding.get("severity", "info").lower()
+                        if severity == "error":
+                            result["error_count"] += 1
+                        elif severity == "warning":
+                            result["warning_count"] += 1
+                        else:
+                            result["info_count"] += 1
+
+                        result["details"].append(
+                            {
+                                "rule": finding.get("ruleId", "unknown"),
+                                "severity": severity,
+                                "message": finding.get("message", ""),
+                                "line": finding.get("range", {}).get("start", {}).get("line", 0),
+                            }
+                        )
+
+                    result["issues_found"] = len(findings)
+            except json.JSONDecodeError:
+                # Non-JSON output (possibly no issues found)
+                pass
+
+    except subprocess.TimeoutExpired:
+        result["error"] = "AST-Grep scan timed out"
+    except FileNotFoundError:
+        result["error"] = "ast-grep (sg) command not found"
+    except Exception as e:
+        result["error"] = str(e)
+
+    return result
+
+
+def format_scan_result(result: dict, file_path: str) -> str:
+    """Format scan result for Claude's additional context."""
+    if result.get("error"):
+        return f"AST-Grep scan skipped: {result['error']}"
+
+    if not result.get("scanned"):
+        return "AST-Grep scan not performed"
+
+    if result["issues_found"] == 0:
+        return f"AST-Grep: No security issues found in {Path(file_path).name}"
+
+    # Build summary
+    parts = []
+
+    if result["error_count"] > 0:
+        parts.append(f"{result['error_count']} error(s)")
+    if result["warning_count"] > 0:
+        parts.append(f"{result['warning_count']} warning(s)")
+    if result["info_count"] > 0:
+        parts.append(f"{result['info_count']} info")
+
+    summary = f"AST-Grep found {', '.join(parts)} in {Path(file_path).name}"
+
+    # Add top 3 issues
+    if result["details"]:
+        issues = []
+        for detail in result["details"][:3]:
+            severity = detail["severity"].upper()
+            rule = detail["rule"]
+            message = detail["message"]
+            line_num = detail["line"]
+            issues.append(f"  - [{severity}] {rule}: {message} (line {line_num})")
+        summary += "\n" + "\n".join(issues)
+
+        if len(result["details"]) > 3:
+            summary += f"\n  ... and {len(result['details']) - 3} more"
+
+    return summary
+
+
+def main() -> None:
+    """Main hook entry point."""
+    # Check if scanning is disabled
+    if os.environ.get(DISABLE_ENV_VAR, "").lower() in ("1", "true", "yes"):
+        sys.exit(0)
+
+    # Read input from stdin
+    try:
+        input_data = json.load(sys.stdin)
+    except (json.JSONDecodeError, OSError):
+        sys.exit(0)
+
+    # Extract file path from tool input
+    tool_name = input_data.get("tool_name", "")
+    tool_input = input_data.get("tool_input", {})
+    file_path = tool_input.get("file_path", "")
+
+    # Only process Write and Edit tools
+    if tool_name not in ("Write", "Edit"):
+        sys.exit(0)
+
+    # Check if file is scannable
+    if not is_scannable_file(file_path):
+        sys.exit(0)
+
+    # Check if file exists
+    if not Path(file_path).exists():
+        sys.exit(0)
+
+    # Find rules configuration
+    config_path = get_rules_config_path()
+
+    # Run scan
+    result = run_ast_grep_scan(file_path, config_path)
+
+    # Format output
+    context = format_scan_result(result, file_path)
+
+    # Prepare hook output
+    output = {
+        "hookSpecificOutput": {
+            "hookEventName": "PostToolUse",
+            "additionalContext": context,
+        }
+    }
+
+    # Output JSON
+    print(json.dumps(output))
+
+    # Exit with attention code if errors found
+    if result.get("error_count", 0) > 0:
+        sys.exit(2)
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

moai_adk/templates/.claude/hooks/moai/post_tool__code_formatter.py

@@ -0,0 +1,253 @@
+#!/usr/bin/env python3
+"""PostToolUse Hook: Automatic Code Formatting
+
+Claude Code Event: PostToolUse
+Matcher: Write|Edit
+Purpose: Automatically format code after Claude writes or edits files
+
+Supports 16+ languages with automatic tool detection:
+- Python: ruff format, black, isort
+- JavaScript/TypeScript: biome, prettier, eslint
+- Go: gofmt, goimports
+- Rust: rustfmt
+- And many more...
+
+Exit Codes:
+- 0: Success (formatting applied or skipped gracefully)
+- 2: Error (stderr shown to Claude for context)
+
+Output:
+- JSON with additionalContext for Claude feedback
+- suppressOutput: true when nothing to report
+"""
+
+import json
+import sys
+from pathlib import Path
+from typing import Any, Dict
+
+# Setup import path for shared modules
+HOOKS_DIR = Path(__file__).parent
+LIB_DIR = HOOKS_DIR / "lib"
+if str(LIB_DIR) not in sys.path:
+    sys.path.insert(0, str(LIB_DIR))
+
+try:
+    from lib.tool_registry import ToolResult, ToolType, get_tool_registry
+except ImportError:
+    # Fallback if module not available
+    def get_tool_registry():
+        return None
+
+    class ToolType:
+        FORMATTER = "formatter"
+
+    class ToolResult:
+        def __init__(self, **kwargs):
+            for k, v in kwargs.items():
+                setattr(self, k, v)
+
+
+# File extensions that should skip formatting
+SKIP_EXTENSIONS = {
+    ".json",  # JSON formatting can break configs
+    ".lock",  # Lock files should not be modified
+    ".min.js",  # Minified files
+    ".min.css",
+    ".map",  # Source maps
+    ".svg",  # SVG files
+    ".png",
+    ".jpg",
+    ".gif",  # Binary files
+    ".ico",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot",
+}
+
+# Directories to skip
+SKIP_DIRECTORIES = {
+    "node_modules",
+    ".git",
+    ".venv",
+    "venv",
+    "__pycache__",
+    ".cache",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    "target",  # Rust/Java
+    "vendor",  # PHP/Go
+}
+
+
+def should_skip_file(file_path: str) -> tuple[bool, str]:
+    """Check if file should be skipped for formatting.
+
+    Args:
+        file_path: Path to the file
+
+    Returns:
+        Tuple of (should_skip, reason)
+    """
+    path = Path(file_path)
+
+    # Check extension
+    if path.suffix.lower() in SKIP_EXTENSIONS:
+        return True, f"Skipped: {path.suffix} files are not formatted"
+
+    # Check for minified files
+    if ".min." in path.name:
+        return True, "Skipped: minified file"
+
+    # Check if in skip directory
+    for parent in path.parents:
+        if parent.name in SKIP_DIRECTORIES:
+            return True, f"Skipped: file in {parent.name}/ directory"
+
+    # Check if file exists
+    if not path.exists():
+        return True, "Skipped: file does not exist"
+
+    # Check if file is binary
+    try:
+        with open(path, "rb") as f:
+            chunk = f.read(8192)
+            if b"\x00" in chunk:  # Binary file indicator
+                return True, "Skipped: binary file"
+    except (OSError, PermissionError):
+        return True, "Skipped: cannot read file"
+
+    return False, ""
+
+
+def format_file(file_path: str) -> Dict[str, Any]:
+    """Format a single file using the appropriate formatter.
+
+    Args:
+        file_path: Path to the file to format
+
+    Returns:
+        Dictionary with formatting results
+    """
+    results: Dict[str, Any] = {
+        "file": file_path,
+        "formatted": False,
+        "tools_run": [],
+        "errors": [],
+    }
+
+    # Check if we should skip
+    should_skip, skip_reason = should_skip_file(file_path)
+    if should_skip:
+        results["skipped"] = True
+        results["skip_reason"] = skip_reason
+        return results
+
+    # Get tool registry
+    registry = get_tool_registry()
+    if not registry:
+        results["errors"].append("Tool registry not available")
+        return results
+
+    # Get formatters for this file
+    formatters = registry.get_tools_for_file(file_path, ToolType.FORMATTER)
+    if not formatters:
+        language = registry.get_language_for_file(file_path)
+        if language:
+            results["skipped"] = True
+            results["skip_reason"] = f"No formatter available for {language}"
+        else:
+            results["skipped"] = True
+            results["skip_reason"] = "Unknown file type"
+        return results
+
+    # Run formatters (use first available)
+    for formatter in formatters[:1]:  # Only run the highest priority formatter
+        result = registry.run_tool(formatter, file_path)
+        results["tools_run"].append(
+            {
+                "name": result.tool_name,
+                "success": result.success,
+                "modified": result.file_modified,
+            }
+        )
+
+        if result.success:
+            results["formatted"] = result.file_modified
+            if result.file_modified:
+                results["message"] = f"Formatted with {result.tool_name}"
+            break
+        else:
+            results["errors"].append(f"{result.tool_name}: {result.error}")
+
+    return results
+
+
+def main() -> None:
+    """Main entry point for PostToolUse formatter hook.
+
+    Reads JSON input from stdin, formats the file if applicable,
+    and outputs JSON result for Claude.
+    """
+    try:
+        # Read JSON input from stdin
+        input_data = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        # Invalid JSON input - exit silently
+        sys.exit(0)
+
+    # Extract tool information
+    tool_name = input_data.get("tool_name", "")
+    tool_input = input_data.get("tool_input", {})
+    input_data.get("tool_response", {})
+
+    # Only process Write and Edit tools
+    if tool_name not in ("Write", "Edit"):
+        sys.exit(0)
+
+    # Get file path from tool input
+    file_path = tool_input.get("file_path", "")
+    if not file_path:
+        sys.exit(0)
+
+    # Format the file
+    result = format_file(file_path)
+
+    # Build output
+    output: Dict[str, Any] = {}
+
+    if result.get("formatted"):
+        # File was formatted - provide context to Claude
+        output = {
+            "hookSpecificOutput": {
+                "hookEventName": "PostToolUse",
+                "additionalContext": f"Auto-formatted: {result.get('message', 'File formatted')}",
+            }
+        }
+        print(json.dumps(output))
+        sys.exit(0)
+
+    elif result.get("errors"):
+        # Formatting failed - let Claude know
+        error_msg = "; ".join(result["errors"])
+        output = {
+            "hookSpecificOutput": {
+                "hookEventName": "PostToolUse",
+                "additionalContext": f"Format warning: {error_msg}",
+            }
+        }
+        print(json.dumps(output))
+        sys.exit(0)
+
+    else:
+        # Nothing to report (skipped or no change)
+        output = {"suppressOutput": True}
+        print(json.dumps(output))
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()