@callback config() :: Claude.Hooks.Hook.t()

Returns the hook configuration as a %Claude.Hook{} struct.

This configuration will be automatically encoded to JSON and written to the settings.json file during installation.

@callback description() :: String.t()

Returns a human-readable description of what this hook does.

@callback run(event_type :: String.t(), file_path :: String.t()) :: :ok | {:error, term()}

Executes the hook logic.

Parameters

• event_type - The type of event that triggered this hook (e.g., "Write", "Edit")
• file_path - The path to the file being processed

Return values

• :ok - Hook executed successfully
• {:error, reason} - Hook execution failed