extension-hooks--eventslisted

# Extension: Hooks & Events Hooks are event handlers that fire on system lifecycle events. They enable plugins to react to sessions, tool executions, agent activity, and user interactions. --- ## 1. Hook Events | Event | Trigger | Use Cases | |-------|---------|-----------| | `tracking_session_start` | User session begins | Initialize tracking | | `tracking_session_end` | User session ends | Finalize analytics | | `tracking_post_tool_use` | Tool executed successfully | Log tool usage | | `tracking_post_tool_use_failure` | Tool execution failed | Alert on failures | | `tracking_subagent_start` | Sub-agent spawned | Track agent lifecycle | | `tracking_subagent_stop` | Sub-agent stopped | Cleanup | | `tracking_stop` | Application shutdown | Graceful cleanup | | `tracking_user_prompt_submit` | User submits prompt | Input validation | --- ## 2. Hook Catalog The hook catalog (`hook_catalog` table) stores hook definitions. ### Schema ```sql CREATE TABLE IF NOT EXISTS hook_catalog ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), name TEXT NOT NULL UNIQUE, description TEXT, version TEXT NOT NULL DEFAULT '1.0.0', event TEXT NOT NULL, matcher TEXT, command TEXT NOT NULL, is_async BOOLEAN NOT NULL DEFAULT true, category TEXT, tags TEXT[], enabled BOOLEAN NOT NULL DEFAULT true, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); ``` --- ## 3. Hook Directory Structure ``` services/ho