Complete hook event coverage

Author: igorcosta

docs/hooks.md

@@ -32,12 +32,40 @@ When running in RPC mode (VS Code, Zed, etc.), hook events are also emitted as J
 | `file-modified` | When a file is created, modified, or deleted | file path, change type |
 | `pre-prompt` | Before sending instruction to LLM | instruction, mentioned files |
 | `stop` | After agent finishes responding (turn complete) | tokens used, tool calls count, duration |
+| `post-response` | Alias for `stop` for backward compatibility | tokens used, tool calls count, duration |
 | `session-start` | When a session begins | session type (startup/resume/clear) |
 | `session-end` | When a session ends | reason (quit/clear/exit/error), duration |
+| `pre-clear` | Before memory extraction on `/clear` or `/new` | session id, cwd |
 | `session-error` | When an error occurs | error message, code, context |
 | `subagent-stop` | When a subagent finishes execution | subagent id, name, type, success, duration |
 | `permission-request` | Before showing permission dialog | tool, path, permission type |
 | `notification` | When a notification is sent to user | notification type, message |
+| `automode:start` | When auto-mode starts | auto-mode session id, prompt, max iterations |
+| `automode:iteration` | On each auto-mode iteration | iteration, actions, files created/modified, cost |
+| `automode:checkpoint` | When auto-mode creates a checkpoint | iteration, checkpoint commit |
+| `automode:pause` | When auto-mode pauses | auto-mode session id, iteration |
+| `automode:resume` | When auto-mode resumes | auto-mode session id, iteration |
+| `automode:cancel` | When auto-mode is cancelled | cancel reason, iteration, cost |
+| `automode:complete` | When auto-mode completes successfully | iterations, actions, files changed, cost |
+| `automode:error` | When auto-mode encounters an error | error message, iteration |
+| `pre-learn` | Before a learn operation begins | instruction, cwd |
+| `post-learn` | After a learn operation completes | instruction, duration, success |
+| `team-created` | When a team is created | team name, member count |
+| `teammate-spawned` | When a teammate process starts | team name, teammate name, agent name, pid |
+| `teammate-idle` | When a teammate becomes idle | team name, teammate name |
+| `task-assigned` | When a task is assigned to a teammate | task id, owner, teammate name |
+| `task-completed` | When a task is marked complete | task id, owner, result |
+| `team-shutdown` | When team cleanup completes | team name, completed task count, total task count |
+| `review:start` | When a code review begins | review path, scope, instructions |
+| `review:end` | When a code review session ends | review path, scope, duration |
+| `review:paused` | When a code review pauses | review path, scope |
+| `review:failed` | When a code review fails | review path, scope, review error |
+| `review:completed` | When a code review completes successfully | review path, scope, duration |
+| `mode-change` | When permission mode changes | permission mode |
+| `context:compact` | When context is compacted | context lifecycle details |
+| `context:overflow` | When context overflow is detected | context lifecycle details |
+| `context:warning` | When context usage crosses the warning threshold | context lifecycle details |
+| `context:critical` | When context usage crosses the critical threshold | context lifecycle details |
 
 > **Note**: `post-response` is an alias for `stop` for backward compatibility.
 
@@ -115,6 +143,11 @@ What the matcher matches against depends on the event type:
 | `session-start` | Session type (startup/resume/clear) |
 | `session-end` | End reason (quit/clear/exit/error) |
 | `subagent-stop` | Subagent type |
+| `automode:*` | Event-specific auto-mode prompt, iteration, or reason |
+| `review:*` | Event-specific review path, scope, instructions, or error |
+| `team-created`, `team-shutdown` | Team name |
+| `teammate-spawned`, `teammate-idle` | Team name, teammate name, or teammate agent name |
+| `task-assigned`, `task-completed` | Task id, task owner, or task result |
 
 ---
 
@@ -149,6 +182,7 @@ echo "Tool: $TOOL_NAME with args: $TOOL_ARGS"
   "instruction": null,
   "mentioned_files": null,
   "tokens_used": null,
+  "tokens_usage_status": null,
   "tool_calls_count": null,
   "turn_tool_calls": null,
   "turn_duration": null,
@@ -165,7 +199,32 @@ echo "Tool: $TOOL_NAME with args: $TOOL_ARGS"
   "subagent_duration": null,
   "permission_type": null,
   "notification_type": null,
-  "notification_message": null
+  "notification_message": null,
+  "automode_session_id": null,
+  "automode_prompt": null,
+  "automode_iteration": null,
+  "automode_max_iterations": null,
+  "automode_actions": null,
+  "automode_files_created": null,
+  "automode_files_modified": null,
+  "automode_cancel_reason": null,
+  "automode_checkpoint_commit": null,
+  "automode_total_cost": null,
+  "review_path": null,
+  "review_scope": null,
+  "review_instructions": null,
+  "review_error": null,
+  "team_name": null,
+  "teammate_name": null,
+  "teammate_agent_name": null,
+  "teammate_pid": null,
+  "team_task_id": null,
+  "team_task_owner": null,
+  "team_task_result": null,
+  "team_member_count": null,
+  "team_tasks_completed": null,
+  "team_tasks_total": null,
+  "additional_workspaces": null
 }
 ```
 
@@ -295,6 +354,31 @@ When your hook command executes, these environment variables are available:
 | `HOOK_PERMISSION_TYPE` | Permission type being requested | permission-request |
 | `HOOK_NOTIFICATION_TYPE` | Type of notification | notification |
 | `HOOK_NOTIFICATION_MSG` | Notification message | notification |
+| `HOOK_AUTOMODE_SESSION_ID` | Auto-mode session ID | automode:* |
+| `HOOK_AUTOMODE_PROMPT` | Auto-mode prompt/task | automode:start, automode:iteration |
+| `HOOK_AUTOMODE_ITERATION` | Current auto-mode iteration | automode:* |
+| `HOOK_AUTOMODE_MAX_ITERATIONS` | Maximum auto-mode iterations | automode:start, automode:iteration |
+| `HOOK_AUTOMODE_ACTIONS` | JSON array of actions | automode:iteration, automode:complete |
+| `HOOK_AUTOMODE_FILES_CREATED` | Number of files created | automode:* |
+| `HOOK_AUTOMODE_FILES_MODIFIED` | Number of files modified | automode:* |
+| `HOOK_AUTOMODE_CANCEL_REASON` | Cancellation reason | automode:cancel |
+| `HOOK_AUTOMODE_CHECKPOINT` | Checkpoint commit hash | automode:checkpoint |
+| `HOOK_AUTOMODE_COST` | Total auto-mode cost | automode:* |
+| `HOOK_REVIEW_PATH` | Review target path | review:* |
+| `HOOK_REVIEW_SCOPE` | Review scope | review:* |
+| `HOOK_REVIEW_ERROR` | Review error message | review:failed |
+| `HOOK_REVIEW_INSTRUCTIONS` | Review instructions/focus | review:* |
+| `HOOK_TEAM_NAME` | Team name | team-created, teammate-spawned, teammate-idle, task-assigned, task-completed, team-shutdown |
+| `HOOK_TEAMMATE_NAME` | Teammate name | teammate-spawned, teammate-idle, task-assigned, task-completed |
+| `HOOK_TEAMMATE_AGENT` | Teammate agent definition | teammate-spawned |
+| `HOOK_TEAMMATE_PID` | Teammate process ID | teammate-spawned |
+| `HOOK_TEAM_TASK_ID` | Team task ID | task-assigned, task-completed |
+| `HOOK_TEAM_TASK_OWNER` | Team task owner | task-assigned, task-completed |
+| `HOOK_TEAM_TASK_RESULT` | Team task result | task-completed |
+| `HOOK_TEAM_MEMBER_COUNT` | Number of team members | team-created, teammate-spawned, teammate-idle, team-shutdown |
+| `HOOK_TEAM_TASKS_COMPLETED` | Completed task count | team-shutdown |
+| `HOOK_TEAM_TASKS_TOTAL` | Total task count | team-shutdown |
+| `HOOK_ADDITIONAL_WORKSPACES` | JSON array of additional workspaces | All events when configured |
 
 ---
 

src/commands/hooks.ts

@@ -23,6 +23,7 @@ export const HOOK_EVENTS: HookEvent[] = [
   'post-tool',
   'file-modified',
   'stop',
+  'post-response',
   'subagent-stop',
   'permission-request',
   'notification',
@@ -54,6 +55,11 @@ export const HOOK_EVENTS: HookEvent[] = [
   'review:completed',
   // Mode events
   'mode-change',
+  // Context lifecycle events
+  'context:compact',
+  'context:overflow',
+  'context:warning',
+  'context:critical',
 ];
 
 // Event descriptions for better UX

src/core/HookManager.ts

@@ -452,6 +452,49 @@ export class HookManager {
       case 'subagent-stop':
         value = context.subagentType ?? '';
         break;
+      case 'automode:start':
+      case 'automode:iteration':
+      case 'automode:checkpoint':
+      case 'automode:pause':
+      case 'automode:resume':
+      case 'automode:cancel':
+      case 'automode:complete':
+      case 'automode:error':
+        value = [
+          context.automodePrompt,
+          context.automodeCancelReason,
+          context.automodeCheckpointCommit,
+          context.automodeIteration,
+        ].filter((part) => part !== undefined && part !== null).join(' ');
+        break;
+      case 'review:start':
+      case 'review:end':
+      case 'review:paused':
+      case 'review:failed':
+      case 'review:completed':
+        value = [
+          context.reviewPath,
+          context.reviewScope,
+          context.reviewInstructions,
+          context.reviewError,
+        ].filter((part) => part !== undefined && part !== null).join(' ');
+        break;
+      case 'team-created':
+      case 'team-shutdown':
+        value = context.teamName ?? '';
+        break;
+      case 'teammate-spawned':
+      case 'teammate-idle':
+        value = [context.teamName, context.teammateName, context.teammateAgentName]
+          .filter((part) => part !== undefined && part !== null)
+          .join(' ');
+        break;
+      case 'task-assigned':
+      case 'task-completed':
+        value = [context.teamTaskId, context.teamTaskOwner, context.teamTaskResult]
+          .filter((part) => part !== undefined && part !== null)
+          .join(' ');
+        break;
       default:
         return true; // No matcher for other events
     }
@@ -539,6 +582,18 @@ export class HookManager {
       if (context.reviewInstructions) env.HOOK_REVIEW_INSTRUCTIONS = context.reviewInstructions;
     }
 
+    // Team hooks
+    if (context.teamName) env.HOOK_TEAM_NAME = context.teamName;
+    if (context.teammateName) env.HOOK_TEAMMATE_NAME = context.teammateName;
+    if (context.teammateAgentName) env.HOOK_TEAMMATE_AGENT = context.teammateAgentName;
+    if (context.teammatePid !== undefined) env.HOOK_TEAMMATE_PID = String(context.teammatePid);
+    if (context.teamTaskId) env.HOOK_TEAM_TASK_ID = context.teamTaskId;
+    if (context.teamTaskOwner) env.HOOK_TEAM_TASK_OWNER = context.teamTaskOwner;
+    if (context.teamTaskResult) env.HOOK_TEAM_TASK_RESULT = context.teamTaskResult;
+    if (context.teamMemberCount !== undefined) env.HOOK_TEAM_MEMBER_COUNT = String(context.teamMemberCount);
+    if (context.teamTasksCompleted !== undefined) env.HOOK_TEAM_TASKS_COMPLETED = String(context.teamTasksCompleted);
+    if (context.teamTasksTotal !== undefined) env.HOOK_TEAM_TASKS_TOTAL = String(context.teamTasksTotal);
+
     // Multi-directory support
     if (context.additionalWorkspaces && context.additionalWorkspaces.length > 0) {
       env.HOOK_ADDITIONAL_WORKSPACES = JSON.stringify(context.additionalWorkspaces);
@@ -608,6 +663,17 @@ export class HookManager {
       review_scope: context.reviewScope,
       review_instructions: context.reviewInstructions,
       review_error: context.reviewError,
+      // Team context
+      team_name: context.teamName,
+      teammate_name: context.teammateName,
+      teammate_agent_name: context.teammateAgentName,
+      teammate_pid: context.teammatePid,
+      team_task_id: context.teamTaskId,
+      team_task_owner: context.teamTaskOwner,
+      team_task_result: context.teamTaskResult,
+      team_member_count: context.teamMemberCount,
+      team_tasks_completed: context.teamTasksCompleted,
+      team_tasks_total: context.teamTasksTotal,
       // Multi-directory support
       additional_workspaces: context.additionalWorkspaces,
     });
@@ -844,6 +910,9 @@ export class HookManager {
       'automode:cancel',
       'automode:complete',
       'automode:error',
+      // Learn events
+      'pre-learn',
+      'post-learn',
       // Review events
       'review:start',
       'review:end',
@@ -857,6 +926,13 @@ export class HookManager {
       'task-assigned',
       'task-completed',
       'team-shutdown',
+      // Mode events
+      'mode-change',
+      // Context lifecycle events
+      'context:compact',
+      'context:overflow',
+      'context:warning',
+      'context:critical',
     ];
     const summary: Record<HookEvent, { total: number; enabled: number }> = {} as Record<HookEvent, { total: number; enabled: number }>;
 

src/core/agent/AgentDependencyComposer.ts

@@ -266,6 +266,9 @@ export function initializeAgentDependencies(
           host.emitOutput({ type: 'message', content: `${prefix} ${text}` });
         }
       },
+      onHookEvent: async (event, context) => {
+        await host.hookManager.executeHooks(event, context);
+      },
     });
 
     host.actionExecutor = new ActionExecutor({