Hook handler (interno)

failproofai --hook <EventType>

Este é o comando registrado no settings.json do Claude Code pelo failproofai policies --install. Normalmente você não o chama diretamente. Lê um payload JSON do stdin, avalia todas as políticas habilitadas e encerra com um código indicando a decisão:

Código de saída	Decisão	Efeito
`0`	`allow`	Permite a ação
`1`	`deny`	Bloqueia a ação — Claude vê o motivo da negação
`2`	`instruct`	Injeta orientações no contexto do Claude

Tipos de evento suportados

Categoria	Eventos
Execução de ferramentas	`PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied`
Ciclo de vida da sessão	`SessionStart`, `SessionEnd`, `Stop`, `StopFailure`
Interação com o usuário	`UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult`
Subagentes e tarefas	`SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle`
Configuração	`InstructionsLoaded`, `ConfigChange`, `CwdChanged`
Sistema de arquivos	`FileChanged`, `WorktreeCreate`, `WorktreeRemove`
Contexto	`PreCompact`, `PostCompact`

Começando

Conceitos principais

CLI

Ferramentas

Avançado

Hook handler (interno)

Tipos de evento suportados

​Tipos de evento suportados

Tipos de evento suportados