claude_hooks 1.1.0 → 1.2.1

data/lib/claude_hooks/pre_tool_use.rb

@@ -58,9 +58,27 @@ module ClaudeHooks
         'permissionDecision' => 'allow'
       }
       @output_data['hookSpecificOutput']['updatedInput'] = updated_input
-
-      # Ensure permission decision is 'allow' when updating input
       @output_data['hookSpecificOutput']['permissionDecision'] = 'allow'
     end
+
+    def defer_permission!
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'defer'
+      }
+    end
+
+    def update_input!(updated_input)
+      @output_data['hookSpecificOutput'] ||= {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow'
+      }
+      @output_data['hookSpecificOutput']['updatedInput'] = updated_input
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
   end
 end

data/lib/claude_hooks/session_start.rb

@@ -18,6 +18,14 @@ module ClaudeHooks
       @input_data['source']
     end
 
+    def model
+      @input_data['model']
+    end
+
+    def session_title
+      @input_data['session_title'] || @input_data['sessionTitle']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def add_additional_context!(context)
@@ -31,5 +39,25 @@ module ClaudeHooks
     def empty_additional_context!
       @output_data['hookSpecificOutput'] = nil
     end
+
+    def session_title!(title)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['sessionTitle'] = title
+    end
+
+    def initial_user_message!(message)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['initialUserMessage'] = message
+    end
+
+    def watch_paths!(paths)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['watchPaths'] = Array(paths)
+    end
+
+    def reload_skills!(value = true)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['reloadSkills'] = value
+    end
   end
 end

data/lib/claude_hooks/setup.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class Setup < Base
+    def self.hook_type
+      'Setup'
+    end
+
+    def self.input_fields
+      %w[source]
+    end
+
+    def source
+      @input_data['source']
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+    alias_method :add_context!, :add_additional_context!
+  end
+end

data/lib/claude_hooks/stop.rb

@@ -26,6 +26,18 @@ module ClaudeHooks
       @input_data['stop_hook_active']
     end
 
+    def last_assistant_message
+      @input_data['last_assistant_message'] || @input_data['lastAssistantMessage']
+    end
+
+    def background_tasks
+      @input_data['background_tasks'] || @input_data['backgroundTasks'] || []
+    end
+
+    def session_crons
+      @input_data['session_crons'] || @input_data['sessionCrons'] || []
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     # Block Claude from stopping (force it to continue)
@@ -40,5 +52,10 @@ module ClaudeHooks
       @output_data.delete('decision')
       @output_data.delete('reason')
     end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
   end
 end

data/lib/claude_hooks/stop_failure.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class StopFailure < Base
+    def self.hook_type
+      'StopFailure'
+    end
+
+    def self.input_fields
+      %w[error]
+    end
+
+    def error
+      @input_data['error']
+    end
+
+    def error_details
+      @input_data['error_details'] || @input_data['errorDetails']
+    end
+
+    def last_assistant_message
+      @input_data['last_assistant_message'] || @input_data['lastAssistantMessage']
+    end
+  end
+end

data/lib/claude_hooks/subagent_start.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class SubagentStart < Base
+    def self.hook_type
+      'SubagentStart'
+    end
+
+    def self.input_fields
+      %w[agent_id agent_type]
+    end
+
+    # agent_id and agent_type readers come from Base (Part A)
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+    alias_method :add_context!, :add_additional_context!
+  end
+end

data/lib/claude_hooks/subagent_stop.rb

@@ -7,5 +7,9 @@ module ClaudeHooks
     def self.hook_type
       'SubagentStop'
     end
+
+    def agent_transcript_path
+      @input_data['agent_transcript_path'] || @input_data['agentTranscriptPath']
+    end
   end
-end
+end

data/lib/claude_hooks/task_completed.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TaskCompleted < Base
+    def self.hook_type
+      'TaskCompleted'
+    end
+
+    def self.input_fields
+      %w[task_id task_subject]
+    end
+
+    def task_id
+      @input_data['task_id'] || @input_data['taskId']
+    end
+
+    def task_subject
+      @input_data['task_subject'] || @input_data['taskSubject']
+    end
+
+    def task_description
+      @input_data['task_description'] || @input_data['taskDescription']
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/task_created.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TaskCreated < Base
+    def self.hook_type
+      'TaskCreated'
+    end
+
+    def self.input_fields
+      %w[task_id task_subject]
+    end
+
+    def task_id
+      @input_data['task_id'] || @input_data['taskId']
+    end
+
+    def task_subject
+      @input_data['task_subject'] || @input_data['taskSubject']
+    end
+
+    def task_description
+      @input_data['task_description'] || @input_data['taskDescription']
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/teammate_idle.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TeammateIdle < Base
+    def self.hook_type
+      'TeammateIdle'
+    end
+
+    def self.input_fields
+      %w[teammate_name team_name]
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/user_prompt_expansion.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class UserPromptExpansion < Base
+    def self.hook_type
+      'UserPromptExpansion'
+    end
+
+    def self.input_fields
+      %w[expansion_type command_name command_args command_source prompt]
+    end
+
+    def expansion_type
+      @input_data['expansion_type'] || @input_data['expansionType']
+    end
+
+    def command_name
+      @input_data['command_name'] || @input_data['commandName']
+    end
+
+    def command_args
+      @input_data['command_args'] || @input_data['commandArgs']
+    end
+
+    def command_source
+      @input_data['command_source'] || @input_data['commandSource']
+    end
+
+    def prompt
+      @input_data['prompt']
+    end
+
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+  end
+end

data/lib/claude_hooks/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeHooks
-  VERSION = "1.1.0"
+  VERSION = "1.2.1"
 end

data/lib/claude_hooks/worktree_create.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class WorktreeCreate < Base
+    def self.hook_type
+      'WorktreeCreate'
+    end
+
+    def self.input_fields
+      %w[name]
+    end
+
+    def name
+      @input_data['name']
+    end
+
+    # Emit the worktree path as bare stdout (last non-empty line).
+    # Also sets hookSpecificOutput.worktreePath for programmatic access.
+    def worktree_path!(path)
+      @output_data['_worktree_path'] = path
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['worktreePath'] = path
+    end
+  end
+end

data/lib/claude_hooks/worktree_remove.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class WorktreeRemove < Base
+    def self.hook_type
+      'WorktreeRemove'
+    end
+
+    def self.input_fields
+      %w[worktree_path]
+    end
+
+    def worktree_path
+      @input_data['worktree_path'] || @input_data['worktreePath']
+    end
+  end
+end

data/lib/claude_hooks.rb

@@ -12,11 +12,31 @@ require_relative "claude_hooks/pre_tool_use"
 require_relative "claude_hooks/permission_request"
 require_relative "claude_hooks/post_tool_use"
 require_relative "claude_hooks/notification"
+require_relative "claude_hooks/message_display"
 require_relative "claude_hooks/stop"
 require_relative "claude_hooks/subagent_stop"
 require_relative "claude_hooks/pre_compact"
 require_relative "claude_hooks/session_start"
 require_relative "claude_hooks/session_end"
+require_relative "claude_hooks/setup"
+require_relative "claude_hooks/subagent_start"
+require_relative "claude_hooks/user_prompt_expansion"
+require_relative "claude_hooks/post_tool_batch"
+require_relative "claude_hooks/config_change"
+require_relative "claude_hooks/task_created"
+require_relative "claude_hooks/task_completed"
+require_relative "claude_hooks/teammate_idle"
+require_relative "claude_hooks/post_tool_use_failure"
+require_relative "claude_hooks/stop_failure"
+require_relative "claude_hooks/post_compact"
+require_relative "claude_hooks/cwd_changed"
+require_relative "claude_hooks/file_changed"
+require_relative "claude_hooks/instructions_loaded"
+require_relative "claude_hooks/worktree_remove"
+require_relative "claude_hooks/permission_denied"
+require_relative "claude_hooks/elicitation"
+require_relative "claude_hooks/elicitation_result"
+require_relative "claude_hooks/worktree_create"
 
 # Output classes
 require_relative "claude_hooks/output/base"
@@ -25,11 +45,31 @@ require_relative "claude_hooks/output/pre_tool_use"
 require_relative "claude_hooks/output/permission_request"
 require_relative "claude_hooks/output/post_tool_use"
 require_relative "claude_hooks/output/notification"
+require_relative "claude_hooks/output/message_display"
 require_relative "claude_hooks/output/stop"
 require_relative "claude_hooks/output/subagent_stop"
 require_relative "claude_hooks/output/pre_compact"
 require_relative "claude_hooks/output/session_start"
 require_relative "claude_hooks/output/session_end"
+require_relative "claude_hooks/output/setup"
+require_relative "claude_hooks/output/subagent_start"
+require_relative "claude_hooks/output/user_prompt_expansion"
+require_relative "claude_hooks/output/post_tool_batch"
+require_relative "claude_hooks/output/config_change"
+require_relative "claude_hooks/output/task_created"
+require_relative "claude_hooks/output/task_completed"
+require_relative "claude_hooks/output/teammate_idle"
+require_relative "claude_hooks/output/post_tool_use_failure"
+require_relative "claude_hooks/output/stop_failure"
+require_relative "claude_hooks/output/post_compact"
+require_relative "claude_hooks/output/cwd_changed"
+require_relative "claude_hooks/output/file_changed"
+require_relative "claude_hooks/output/instructions_loaded"
+require_relative "claude_hooks/output/worktree_remove"
+require_relative "claude_hooks/output/permission_denied"
+require_relative "claude_hooks/output/elicitation"
+require_relative "claude_hooks/output/elicitation_result"
+require_relative "claude_hooks/output/worktree_create"
 
 module ClaudeHooks
   class Error < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude_hooks
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Gabriel Dehan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-04 00:00:00.000000000 Z
+date: 2026-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -61,30 +61,57 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".agents/skills/ci-monitoring/SKILL.md"
+- ".agents/skills/run-tests/SKILL.md"
 - ".claude/auto-fix.md"
+- AGENTS.md
 - CHANGELOG.md
 - README.md
 - claude_hooks.gemspec
 - docs/1.0.0_MIGRATION_GUIDE.md
 - docs/1.1.0_UPGRADE_GUIDE.md
 - docs/API/COMMON.md
+- docs/API/CONFIG_CHANGE.md
+- docs/API/CWD_CHANGED.md
+- docs/API/ELICITATION.md
+- docs/API/ELICITATION_RESULT.md
+- docs/API/FILE_CHANGED.md
+- docs/API/INSTRUCTIONS_LOADED.md
+- docs/API/MESSAGE_DISPLAY.md
 - docs/API/NOTIFICATION.md
+- docs/API/PERMISSION_DENIED.md
 - docs/API/PERMISSION_REQUEST.md
+- docs/API/POST_COMPACT.md
+- docs/API/POST_TOOL_BATCH.md
 - docs/API/POST_TOOL_USE.md
+- docs/API/POST_TOOL_USE_FAILURE.md
 - docs/API/PRE_COMPACT.md
 - docs/API/PRE_TOOL_USE.md
 - docs/API/SESSION_END.md
 - docs/API/SESSION_START.md
+- docs/API/SETUP.md
 - docs/API/STOP.md
+- docs/API/STOP_FAILURE.md
+- docs/API/SUBAGENT_START.md
 - docs/API/SUBAGENT_STOP.md
+- docs/API/TASK_COMPLETED.md
+- docs/API/TASK_CREATED.md
+- docs/API/TEAMMATE_IDLE.md
+- docs/API/USER_PROMPT_EXPANSION.md
 - docs/API/USER_PROMPT_SUBMIT.md
+- docs/API/WORKTREE_CREATE.md
+- docs/API/WORKTREE_REMOVE.md
+- docs/PROMPT_BASED_HOOKS.md
 - docs/WHY.md
 - docs/external/claude-hooks-reference.md
+- docs/mitts/ideabox.md
+- docs/mitts/prd.md
+- docs/mitts/setup.md
+- docs/mitts/task.md
 - example_dotclaude/commands/.gitkeep
-- example_dotclaude/hooks/entrypoints/pre_tool_use.rb
 - example_dotclaude/hooks/entrypoints/session_end.rb
 - example_dotclaude/hooks/entrypoints/user_prompt_submit.rb
-- example_dotclaude/hooks/handlers/pre_tool_use/github_guard.rb
+- example_dotclaude/hooks/github_guard.rb
 - example_dotclaude/hooks/handlers/session_end/cleanup_handler.rb
 - example_dotclaude/hooks/handlers/session_end/log_session_stats.rb
 - example_dotclaude/hooks/handlers/user_prompt_submit/append_rules.rb
@@ -94,30 +121,70 @@ files:
 - lib/claude_hooks.rb
 - lib/claude_hooks/base.rb
 - lib/claude_hooks/cli.rb
+- lib/claude_hooks/config_change.rb
 - lib/claude_hooks/configuration.rb
+- lib/claude_hooks/cwd_changed.rb
+- lib/claude_hooks/elicitation.rb
+- lib/claude_hooks/elicitation_result.rb
+- lib/claude_hooks/file_changed.rb
+- lib/claude_hooks/instructions_loaded.rb
 - lib/claude_hooks/logger.rb
+- lib/claude_hooks/message_display.rb
 - lib/claude_hooks/notification.rb
 - lib/claude_hooks/output/base.rb
+- lib/claude_hooks/output/config_change.rb
+- lib/claude_hooks/output/cwd_changed.rb
+- lib/claude_hooks/output/elicitation.rb
+- lib/claude_hooks/output/elicitation_result.rb
+- lib/claude_hooks/output/file_changed.rb
+- lib/claude_hooks/output/instructions_loaded.rb
+- lib/claude_hooks/output/message_display.rb
 - lib/claude_hooks/output/notification.rb
+- lib/claude_hooks/output/permission_denied.rb
 - lib/claude_hooks/output/permission_request.rb
+- lib/claude_hooks/output/post_compact.rb
+- lib/claude_hooks/output/post_tool_batch.rb
 - lib/claude_hooks/output/post_tool_use.rb
+- lib/claude_hooks/output/post_tool_use_failure.rb
 - lib/claude_hooks/output/pre_compact.rb
 - lib/claude_hooks/output/pre_tool_use.rb
 - lib/claude_hooks/output/session_end.rb
 - lib/claude_hooks/output/session_start.rb
+- lib/claude_hooks/output/setup.rb
 - lib/claude_hooks/output/stop.rb
+- lib/claude_hooks/output/stop_failure.rb
+- lib/claude_hooks/output/subagent_start.rb
 - lib/claude_hooks/output/subagent_stop.rb
+- lib/claude_hooks/output/task_completed.rb
+- lib/claude_hooks/output/task_created.rb
+- lib/claude_hooks/output/teammate_idle.rb
+- lib/claude_hooks/output/user_prompt_expansion.rb
 - lib/claude_hooks/output/user_prompt_submit.rb
+- lib/claude_hooks/output/worktree_create.rb
+- lib/claude_hooks/output/worktree_remove.rb
+- lib/claude_hooks/permission_denied.rb
 - lib/claude_hooks/permission_request.rb
+- lib/claude_hooks/post_compact.rb
+- lib/claude_hooks/post_tool_batch.rb
 - lib/claude_hooks/post_tool_use.rb
+- lib/claude_hooks/post_tool_use_failure.rb
 - lib/claude_hooks/pre_compact.rb
 - lib/claude_hooks/pre_tool_use.rb
 - lib/claude_hooks/session_end.rb
 - lib/claude_hooks/session_start.rb
+- lib/claude_hooks/setup.rb
 - lib/claude_hooks/stop.rb
+- lib/claude_hooks/stop_failure.rb
+- lib/claude_hooks/subagent_start.rb
 - lib/claude_hooks/subagent_stop.rb
+- lib/claude_hooks/task_completed.rb
+- lib/claude_hooks/task_created.rb
+- lib/claude_hooks/teammate_idle.rb
+- lib/claude_hooks/user_prompt_expansion.rb
 - lib/claude_hooks/user_prompt_submit.rb
 - lib/claude_hooks/version.rb
+- lib/claude_hooks/worktree_create.rb
+- lib/claude_hooks/worktree_remove.rb
 homepage: https://github.com/gabriel-dehan/claude_hooks
 licenses:
 - MIT

data/example_dotclaude/hooks/entrypoints/pre_tool_use.rb

@@ -1,25 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'claude_hooks'
-require_relative '../handlers/pre_tool_use/github_guard'
-
-begin
-  # Read Claude Code input from stdin
-  input_data = JSON.parse($stdin.read)
-
-  github_guard = GithubGuard.new(input_data)
-  github_guard.call
-
-  github_guard.output_and_exit
-rescue StandardError => e
-  puts JSON.generate(
-    {
-      continue: false,
-      stopReason: "Error in PreToolUse hook, #{e.message}, #{e.backtrace.join("\n")}",
-      suppressOutput: false,
-    },
-  )
-  # Allow anyway, to not block developers if there is an issue with the hook
-  exit 1
-end