Hooks 가이드

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"\\(.tool_input.command) - \\(.tool_input.description // \"No description\")\"' >> ~/.claude/bash-command-log.txt"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.ts$'; then npx prettier --write \"$file_path\"; fi; }"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/markdown_formatter.py"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""
Markdown formatter for Claude Code output.
Fixes missing language tags and spacing issues while preserving code content.
"""
import json
import sys
import re
import os
 
def detect_language(code):
    """Best-effort language detection from code content."""
    s = code.strip()
 
    # JSON detection
    if re.search(r'^\\s*[{\\[]', s):
        try:
            json.loads(s)
            return 'json'
        except:
            pass
 
    # Python detection
    if re.search(r'^\\s*def\\s+\\w+\\s*\\(', s, re.M) or \
       re.search(r'^\\s*(import|from)\\s+\\w+', s, re.M):
        return 'python'
 
    # JavaScript detection
    if re.search(r'\\b(function\\s+\\w+\\s*\\(|const\\s+\\w+\\s*=)', s) or \
       re.search(r'=>|console\\.(log|error)', s):
        return 'javascript'
 
    # Bash detection
    if re.search(r'^#!.*\\b(bash|sh)\\b', s, re.M) or \
       re.search(r'\\b(if|then|fi|for|in|do|done)\\b', s):
        return 'bash'
 
    return 'text'
 
def format_markdown(content):
    """Format markdown content with language detection."""
    # Fix unlabeled code fences
    def add_lang_to_fence(match):
        indent, info, body, closing = match.groups()
        if not info.strip():
            lang = detect_language(body)
            return f"{indent}```{lang}\\n{body}{closing}\\n"
        return match.group(0)
 
    fence_pattern = r'(?ms)^([ \\t]{0,3})```([^\\n]*)\\n(.*?)(\\n\\1```)\\s*$'
    content = re.sub(fence_pattern, add_lang_to_fence, content)
 
    # Fix excessive blank lines
    content = re.sub(r'\\n{3,}', '\\n\\n', content)
 
    return content.rstrip() + '\\n'
 
# Main execution
try:
    input_data = json.load(sys.stdin)
    file_path = input_data.get('tool_input', {}).get('file_path', '')
 
    if not file_path.endswith(('.md', '.mdx')):
        sys.exit(0)  # Not a markdown file
 
    if os.path.exists(file_path):
        with open(file_path, 'r', encoding='utf-8') as f:
            content = f.read()
 
        formatted = format_markdown(content)
 
        if formatted != content:
            with open(file_path, 'w', encoding='utf-8') as f:
                f.write(formatted)
            print(f"✓ Fixed markdown formatting in {file_path}")
 
except Exception as e:
    print(f"Error formatting markdown: {e}", file=sys.stderr)
    sys.exit(1)

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Awaiting your input'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 -c \"import json, sys; data=json.load(sys.stdin); path=data.get('tool_input',{}).get('file_path',''); sys.exit(2 if any(p in path for p in ['.env', 'package-lock.json', '.git/']) else 0)\""
          }
        ]
      }
    ]
  }
}

ralph:
  enabled: true
  hooks:
    post_tool_lsp:
      enabled: true
      severity_threshold: error  # error | warning | info

ralph:
  enabled: true
  loop:
    max_iterations: 10
    auto_fix: false
    completion:
      zero_errors: true
      zero_warnings: false
      tests_pass: true
      coverage_threshold: 85

constitution:
  quality_gate:
    max_errors: 0
    max_warnings: 10
    enabled: true

{
  "lsp_errors": 0,
  "lsp_warnings": 2,
  "type_errors": 0,
  "lint_errors": 0,
  "passed": true,
  "reason": "Quality gate passed: LSP diagnostics clean"
}

.claude/hooks/moai/lib/
├── __init__.py
├── atomic_write.py           # 원자적 쓰기 연산
├── checkpoint.py             # 체크포인트 관리
├── common.py                 # 공통 유틸리티
├── config.py                 # 설정 관리
├── config_manager.py         # 설정 관리자 (고급)
├── config_validator.py       # 설정 유효성 검사
├── context_manager.py        # 컨텍스트 관리 (스냅샷, 아카이브)
├── enhanced_output_style_detector.py  # 출력 스타일 감지
├── file_utils.py             # 파일 유틸리티
├── git_collector.py          # Git 데이터 수집
├── git_operations_manager.py # Git 연산 관리자 (최적화됨)
├── language_detector.py      # 언어 감지
├── language_validator.py     # 언어 유효성 검사
├── main.py                   # 메인 진입점
├── memory_collector.py       # 메모리 수집
├── metrics_tracker.py        # 메트릭 추적
├── models.py                 # 데이터 모델
├── path_utils.py             # 경로 유틸리티
├── project.py                # 프로젝트 관련
├── renderer.py               # 렌더러
├── timeout.py                # 타임아웃 처리
├── tool_registry.py          # 도구 레지스트리 (포맷터, 린터)
├── unified_timeout_manager.py # 통합 타임아웃 관리자
├── update_checker.py         # 업데이트 확인
├── version_reader.py         # 버전 읽기
├── alfred_detector.py        # Alfred 감지
└── shared/utils/
    └── announcement_translator.py  # 공지사항 번역

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_start__show_project_info.py\"'"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/pre_tool__security_guard.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__code_formatter.py\"'",
            "timeout": 30000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__linter.py\"'",
            "timeout": 60000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__ast_grep_scan.py\"'",
            "timeout": 30000
          },
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/post_tool__lsp_diagnostic.py\"'"
          }
        ]
      }
    ],
    "PreCompact": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/pre_compact__save_context.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/session_end__auto_cleanup.py\"'",
            "timeout": 5000
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${SHELL:-/bin/bash} -l -c 'uv run \"$CLAUDE_PROJECT_DIR/.claude/hooks/moai/stop__loop_controller.py\"'"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env python3
"""커스텀 PostToolUse Hook: 파일 수정 후 특정 검사 수행"""
 
import json
import sys
 
 
def main():
    # stdin에서 Hook 입력 데이터 읽기
    input_data = json.loads(sys.stdin.read())
 
    tool_name = input_data.get("tool_name", "")
    tool_input = input_data.get("tool_input", {})
    file_path = tool_input.get("file_path", "")
 
    # 검사 로직
    if file_path.endswith(".py"):
        # Python 파일에 대한 커스텀 검사
        result = check_python_file(file_path)
 
        if result["has_issues"]:
            # Claude Code에 피드백 전달
            output = {
                "hookSpecificOutput": {
                    "hookEventName": "PostToolUse",
                    "additionalContext": result["message"]
                }
            }
            print(json.dumps(output))
            return
 
    # 문제 없으면 출력 억제
    output = {"suppressOutput": True}
    print(json.dumps(output))
 
 
def check_python_file(file_path: str) -> dict:
    """Python 파일 커스텀 검사"""
    # 검사 로직 구현
    return {"has_issues": False, "message": ""}
 
 
if __name__ == "__main__":
    main()

{
  "tool_name": "Write",
  "tool_input": {
    "file_path": "/path/to/file.py",
    "content": "파일 내용..."
  },
  "tool_output": "파일 출력 결과 (PostToolUse에서만)"
}

.claude/hooks/moai/
├── __init__.py                        # 패키지 초기화
├── session_start__show_project_info.py # 세션 시작
├── pre_tool__security_guard.py         # 보안 가드
├── post_tool__code_formatter.py        # 코드 포맷터
├── post_tool__linter.py                # 린터
├── post_tool__ast_grep_scan.py         # AST-grep 스캔
├── post_tool__lsp_diagnostic.py        # LSP 진단
├── pre_compact__save_context.py        # 컨텍스트 저장
├── session_end__auto_cleanup.py        # 자동 정리

├── stop__loop_controller.py            # 루프 제어기
├── quality_gate_with_lsp.py            # 품질 게이트
└── lib/                                # 공유 라이브러리
    ├── atomic_write.py                 # 원자적 쓰기
    ├── checkpoint.py                   # 체크포인트
    ├── common.py                       # 공통 유틸리티
    ├── config.py                       # 설정
    ├── config_manager.py               # 설정 관리자
    ├── config_validator.py             # 설정 유효성 검사
    ├── context_manager.py              # 컨텍스트 관리
    ├── git_operations_manager.py       # Git 연산 관리
    ├── tool_registry.py                # 도구 레지스트리
    ├── unified_timeout_manager.py      # 타임아웃 관리
    └── ...                             # 기타 모듈

export MOAI_DISABLE_AST_GREP_SCAN=1