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('=>|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