Handler hook (interno)

Il sottoprocesso che Claude Code chiama su ogni evento di strumento

failproofai --hook <EventType>

Questo è il comando registrato nel settings.json di Claude Code da failproofai policies --install. Normalmente non lo chiami direttamente.

Legge un payload JSON da stdin, valuta tutte le policy abilitate e esce con un codice che indica la decisione:

Codice di uscita	Decisione	Effetto
0	allow	Consenti l’azione
1	deny	Blocca l’azione - Claude vede il motivo del blocco
2	instruct	Inietta indicazioni nel contesto di Claude

​

Tipi di evento supportati

Categoria	Eventi
Esecuzione dello strumento	PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, PermissionDenied
Ciclo di vita della sessione	SessionStart, SessionEnd, Stop, StopFailure
Interazione utente	UserPromptSubmit, Notification, Elicitation, ElicitationResult
Subagenti e attività	SubagentStart, SubagentStop, TaskCreated, TaskCompleted, TeammateIdle
Configurazione	InstructionsLoaded, ConfigChange, CwdChanged
File system	FileChanged, WorktreeCreate, WorktreeRemove
Contesto	PreCompact, PostCompact