Method Fire

cli/hooks/manager.go:103–137

Fire dispatches an event to all matching hooks. For PreToolUse events, returns a HookResult — if Blocked is true, the action should be prevented. Other events are fire-and-forget (errors are logged but not returned).

(ctx context.Context, event HookEvent)

// For PreToolUse events, returns a HookResult — if Blocked is true, the action should be prevented.
// Other events are fire-and-forget (errors are logged but not returned).
func (m *Manager) Fire(ctx context.Context, event HookEvent) *HookResult {
	m.mu.RLock()
	hooks := make([]HookConfig, len(m.hooks))
	copy(hooks, m.hooks)
	m.mu.RUnlock()

	for _, hook := range hooks {
		if !hook.IsEnabled() {
			continue
		}
		if hook.Event != event.Type {
			continue
		}

		// Apply tool pattern filter for tool events
		if hook.ToolPattern != "" && event.ToolName != "" {
			if !matchToolPattern(hook.ToolPattern, event.ToolName) {
				continue
			}
		}

		result := m.executeHook(ctx, hook, event)

		// For PreToolUse, a blocking result (exit code 2) stops the action
		if event.Type == EventPreToolUse && result.Blocked {
			m.logger.Info("Hook blocked tool execution",
				zap.String("hook", hook.Name),
				zap.String("tool", event.ToolName),
				zap.String("reason", result.BlockReason))
			return result
		}
	}

	return nil // no blocking
}

// FireAsync dispatches an event asynchronously (non-blocking).
// Use for events where the result doesn't matter (PostToolUse, Notification, etc.).