claude_hooks 1.0.2 → 1.1.0

data/lib/claude_hooks/base.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
   # Base class for Claude Code hook scripts
   class Base
     # Common input fields for all hook types
-    COMMON_INPUT_FIELDS = %w[session_id transcript_path cwd hook_event_name].freeze
+    COMMON_INPUT_FIELDS = %w[session_id transcript_path cwd hook_event_name permission_mode].freeze
 
     # Override in subclasses to specify hook type
     def self.hook_type
@@ -71,6 +71,10 @@ module ClaudeHooks
       @input_data['hook_event_name'] || @input_data['hookEventName'] || hook_type
     end
 
+    def permission_mode
+      @input_data['permission_mode'] || @input_data['permissionMode'] || 'default'
+    end
+
     def read_transcript
       unless transcript_path && File.exist?(transcript_path)
         log "Transcript file not found at #{transcript_path}", level: :warn

data/lib/claude_hooks/notification.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
     end
 
     def self.input_fields
-      %w[message]
+      %w[message notification_type]
     end
 
     # === INPUT DATA ACCESS ===
@@ -18,5 +18,9 @@ module ClaudeHooks
       @input_data['message']
     end
     alias_method :notification_message, :message
+
+    def notification_type
+      @input_data['notification_type'] || @input_data['notificationType']
+    end
   end
 end

data/lib/claude_hooks/output/base.rb

@@ -119,6 +119,8 @@ module ClaudeHooks
           UserPromptSubmit.new(data)
         when 'PreToolUse'
           PreToolUse.new(data)
+        when 'PermissionRequest'
+          PermissionRequest.new(data)
         when 'PostToolUse'
           PostToolUse.new(data)
         when 'Stop'

data/lib/claude_hooks/output/permission_request.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  module Output
+    class PermissionRequest < Base
+      # === PERMISSION DECISION ACCESSORS ===
+
+      def permission_decision
+        hook_specific_output['permissionDecision']
+      end
+
+      def permission_reason
+        hook_specific_output['permissionDecisionReason'] || ''
+      end
+
+      def updated_input
+        hook_specific_output['updatedInput']
+      end
+
+      # === SEMANTIC HELPERS ===
+
+      def allowed?
+        permission_decision == 'allow'
+      end
+
+      def denied?
+        permission_decision == 'deny'
+      end
+
+      def input_updated?
+        !updated_input.nil?
+      end
+
+      # === EXIT CODE LOGIC ===
+      #
+      # PermissionRequest hooks use the advanced JSON API with exit code 0.
+      # Following the same pattern as PreToolUse (permission-based hooks).
+      def exit_code
+        0
+      end
+
+      # === OUTPUT STREAM LOGIC ===
+      #
+      # PermissionRequest hooks always output to stdout when using the JSON API.
+      def output_stream
+        :stdout
+      end
+
+      # === MERGE HELPER ===
+
+      def self.merge(*outputs)
+        compacted_outputs = outputs.compact
+        return compacted_outputs.first if compacted_outputs.length == 1
+        return super(*outputs) if compacted_outputs.empty?
+
+        merged = super(*outputs)
+        merged_data = merged.data
+
+        # PermissionRequest specific merge: deny > allow (most restrictive wins)
+        permission_decision = 'allow'
+        permission_reasons = []
+        updated_inputs = []
+
+        compacted_outputs.each do |output|
+          output_data = output.respond_to?(:data) ? output.data : output
+
+          next unless output_data.dig('hookSpecificOutput', 'permissionDecision')
+
+          current_decision = output_data['hookSpecificOutput']['permissionDecision']
+          permission_decision = 'deny' if current_decision == 'deny'
+
+          reason = output_data.dig('hookSpecificOutput', 'permissionDecisionReason')
+          permission_reasons << reason if reason && !reason.empty?
+
+          updated = output_data.dig('hookSpecificOutput', 'updatedInput')
+          updated_inputs << updated if updated
+        end
+
+        merged_data['hookSpecificOutput'] ||= { 'hookEventName' => 'PermissionRequest' }
+        merged_data['hookSpecificOutput']['permissionDecision'] = permission_decision
+        merged_data['hookSpecificOutput']['permissionDecisionReason'] = if permission_reasons.any?
+                                                                          permission_reasons.join('; ')
+                                                                        else
+                                                                          ''
+                                                                        end
+        # Last updated input wins
+        merged_data['hookSpecificOutput']['updatedInput'] = updated_inputs.last if updated_inputs.any?
+
+        new(merged_data)
+      end
+    end
+  end
+end

data/lib/claude_hooks/output/pre_tool_use.rb

@@ -15,6 +15,10 @@ module ClaudeHooks
         hook_specific_output['permissionDecisionReason'] || ''
       end
 
+      def updated_input
+        hook_specific_output['updatedInput']
+      end
+
       # === SEMANTIC HELPERS ===
 
       def allowed?
@@ -30,6 +34,10 @@ module ClaudeHooks
         permission_decision == 'ask'
       end
 
+      def input_updated?
+        !updated_input.nil?
+      end
+
       # === EXIT CODE LOGIC ===
       #
       # PreToolUse hooks use the advanced JSON API with exit code 0.
@@ -87,6 +95,16 @@ module ClaudeHooks
                                                                           ''
                                                                         end
 
+        # If any output has updatedInput, use the last one (most recent wins)
+        updated_inputs = []
+        compacted_outputs.each do |output|
+          output_data = output.respond_to?(:data) ? output.data : output
+          updated = output_data.dig('hookSpecificOutput', 'updatedInput')
+          updated_inputs << updated if updated
+        end
+
+        merged_data['hookSpecificOutput']['updatedInput'] = updated_inputs.last if updated_inputs.any?
+
         new(merged_data)
       end
     end

data/lib/claude_hooks/permission_request.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PermissionRequest < Base
+    def self.hook_type
+      'PermissionRequest'
+    end
+
+    def self.input_fields
+      %w[tool_name tool_input tool_use_id]
+    end
+
+    # === INPUT DATA ACCESS ===
+
+    def tool_name
+      @input_data['tool_name']
+    end
+
+    def tool_input
+      @input_data['tool_input']
+    end
+
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
+    # === OUTPUT DATA HELPERS ===
+
+    def allow_permission!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow',
+        'permissionDecisionReason' => reason
+      }
+    end
+
+    def deny_permission!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'deny',
+        'permissionDecisionReason' => reason
+      }
+    end
+
+    def update_input_and_allow!(updated_input, reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow',
+        'permissionDecisionReason' => reason,
+        'updatedInput' => updated_input
+      }
+    end
+  end
+end

data/lib/claude_hooks/post_tool_use.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
     end
 
     def self.input_fields
-      %w[tool_name tool_input tool_response]
+      %w[tool_name tool_input tool_response tool_use_id]
     end
 
     # === INPUT DATA ACCESS ===
@@ -26,6 +26,10 @@ module ClaudeHooks
       @input_data['tool_response']
     end
 
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def block_tool!(reason = '')

data/lib/claude_hooks/pre_tool_use.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
     end
 
     def self.input_fields
-      %w[tool_name tool_input]
+      %w[tool_name tool_input tool_use_id]
     end
 
     # === INPUT DATA ACCESS ===
@@ -22,6 +22,10 @@ module ClaudeHooks
       @input_data['tool_input']
     end
 
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def approve_tool!(reason = '')
@@ -47,5 +51,16 @@ module ClaudeHooks
         'permissionDecisionReason' => reason
       }
     end
+
+    def update_tool_input!(updated_input)
+      @output_data['hookSpecificOutput'] ||= {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow'
+      }
+      @output_data['hookSpecificOutput']['updatedInput'] = updated_input
+
+      # Ensure permission decision is 'allow' when updating input
+      @output_data['hookSpecificOutput']['permissionDecision'] = 'allow'
+    end
   end
 end

data/lib/claude_hooks/version.rb

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

data/lib/claude_hooks.rb

@@ -9,6 +9,7 @@ require_relative "claude_hooks/cli"
 # Hook classes
 require_relative "claude_hooks/user_prompt_submit"
 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/stop"
@@ -21,6 +22,7 @@ require_relative "claude_hooks/session_end"
 require_relative "claude_hooks/output/base"
 require_relative "claude_hooks/output/user_prompt_submit"
 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/stop"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_hooks
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Gabriel Dehan
@@ -61,12 +61,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/auto-fix.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/NOTIFICATION.md
+- docs/API/PERMISSION_REQUEST.md
 - docs/API/POST_TOOL_USE.md
 - docs/API/PRE_COMPACT.md
 - docs/API/PRE_TOOL_USE.md
@@ -96,6 +99,7 @@ files:
 - lib/claude_hooks/notification.rb
 - lib/claude_hooks/output/base.rb
 - lib/claude_hooks/output/notification.rb
+- lib/claude_hooks/output/permission_request.rb
 - lib/claude_hooks/output/post_tool_use.rb
 - lib/claude_hooks/output/pre_compact.rb
 - lib/claude_hooks/output/pre_tool_use.rb
@@ -104,6 +108,7 @@ files:
 - lib/claude_hooks/output/stop.rb
 - lib/claude_hooks/output/subagent_stop.rb
 - lib/claude_hooks/output/user_prompt_submit.rb
+- lib/claude_hooks/permission_request.rb
 - lib/claude_hooks/post_tool_use.rb
 - lib/claude_hooks/pre_compact.rb
 - lib/claude_hooks/pre_tool_use.rb