HookExecutor class

Central hook execution engine.

Manages hook registration, chain execution, history tracking, and statistics. All hook execution flows through this class.

Usage:

final executor = HookExecutor();

// Register a hook
executor.register(HookRegistration(
  id: 'my-hook',
  type: HookType.preToolExecution,
  name: 'My Hook',
  handler: (ctx) => const HookContinue(),
));

// Execute hooks for a type
final result = await executor.executeAsync(
  HookType.preToolExecution,
  ToolHookContext(
    hookType: HookType.preToolExecution,
    timestamp: DateTime.now(),
    toolName: 'bash',
    toolInput: {'command': 'ls'},
  ),
);