claude_hooks 0.2.0 → 1.0.0

data/lib/claude_hooks/pre_tool_use.rb

@@ -47,42 +47,5 @@ module ClaudeHooks
         'permissionDecisionReason' => reason
       }
     end
-
-    # === MERGE HELPER ===
-
-    # Merge multiple PreToolUse hook results intelligently
-    def self.merge_outputs(*outputs_data)
-      merged = super(*outputs_data)
-
-      # For PreToolUse: deny > ask > allow (most restrictive wins)
-      permission_decision = 'allow'
-      permission_reasons = []
-
-      outputs_data.compact.each do |output|
-        if output.dig('hookSpecificOutput', 'permissionDecision')
-          current_decision = output['hookSpecificOutput']['permissionDecision']
-          case current_decision
-          when 'deny'
-            permission_decision = 'deny'
-          when 'ask'
-            permission_decision = 'ask' unless permission_decision == 'deny'
-          end
-
-          if output['hookSpecificOutput']['permissionDecisionReason']
-            permission_reasons << output['hookSpecificOutput']['permissionDecisionReason']
-          end
-        end
-      end
-
-      unless permission_reasons.empty?
-        merged['hookSpecificOutput'] = {
-          'hookEventName' => hook_type,
-          'permissionDecision' => permission_decision,
-          'permissionDecisionReason' => permission_reasons.join('; ')
-        }
-      end
-
-      merged
-    end
   end
 end

data/lib/claude_hooks/session_end.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class SessionEnd < Base
+    def self.hook_type
+      'SessionEnd'
+    end
+
+    def self.input_fields
+      %w[reason]
+    end
+
+    # === INPUT DATA ACCESS ===
+
+    def reason
+      @input_data['reason']
+    end
+
+    # === REASON HELPERS ===
+
+    # Check if session was cleared with /clear command
+    def cleared?
+      reason == 'clear'
+    end
+
+    # Check if user logged out
+    def logout?
+      reason == 'logout'
+    end
+
+    # Check if user exited while prompt input was visible
+    def prompt_input_exit?
+      reason == 'prompt_input_exit'
+    end
+
+    # Check if reason is unspecified or other
+    def other_reason?
+      !cleared? && !logout? && !prompt_input_exit?
+    end
+  end
+end

data/lib/claude_hooks/session_start.rb

@@ -31,28 +31,5 @@ module ClaudeHooks
     def empty_additional_context!
       @output_data['hookSpecificOutput'] = nil
     end
-
-    # === MERGE HELPER ===
-
-    # Merge multiple SessionStart hook results intelligently
-    def self.merge_outputs(*outputs_data)
-      merged = super(*outputs_data)
-      contexts = []
-
-      outputs_data.compact.each do |output|
-        if output.dig('hookSpecificOutput', 'additionalContext')
-          contexts << output['hookSpecificOutput']['additionalContext']
-        end
-      end
-
-      unless contexts.empty?
-        merged['hookSpecificOutput'] = {
-          'hookEventName' => hook_type,
-          'additionalContext' => contexts.join("\n\n")
-        }
-      end
-
-      merged
-    end
   end
 end

data/lib/claude_hooks/stop.rb

@@ -32,30 +32,5 @@ module ClaudeHooks
       @output_data.delete('decision')
       @output_data.delete('reason')
     end
-
-    # === MERGE HELPER ===
-
-    # Merge multiple Stop hook results intelligently
-    def self.merge_outputs(*outputs_data)
-      merged = super(*outputs_data)
-
-      # A blocking reason is actually a "continue instructions"
-      blocking_reasons = []
-
-      outputs_data.compact.each do |output|
-        # Handle decision - if any hook says 'block', respect that
-        if output['decision'] == 'block'
-          merged['decision'] = 'block'
-          blocking_reasons << output['reason'] if output['reason'] && !output['reason'].empty?
-        end
-      end
-
-      # Combine all blocking reasons / continue instructions
-      unless blocking_reasons.empty?
-        merged['reason'] = blocking_reasons.join('; ')
-      end
-
-      merged
-    end
   end
 end

data/lib/claude_hooks/user_prompt_submit.rb

@@ -43,31 +43,5 @@ module ClaudeHooks
       @output_data['decision'] = nil
       @output_data['reason'] = nil
     end
-
-    # === MERGE HELPER ===
-
-    # Merge multiple UserPromptSubmit hook results intelligently
-    def self.merge_outputs(*outputs_data)
-      merged = super(*outputs_data)
-      contexts = []
-
-      outputs_data.compact.each do |output|
-        merged['decision'] = 'block' if output['decision'] == 'block'
-        merged['reason'] = [merged['reason'], output['reason']].compact.reject(&:empty?).join('; ')
-
-        if output.dig('hookSpecificOutput', 'additionalContext')
-          contexts << output['hookSpecificOutput']['additionalContext']
-        end
-      end
-
-      unless contexts.empty?
-        merged['hookSpecificOutput'] = {
-          'hookEventName' => hook_type,
-          'additionalContext' => contexts.join("\n\n")
-        }
-      end
-
-      merged
-    end
   end
 end

data/lib/claude_hooks/version.rb

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

data/lib/claude_hooks.rb

@@ -5,6 +5,8 @@ require_relative "claude_hooks/configuration"
 require_relative "claude_hooks/logger"
 require_relative "claude_hooks/base"
 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/post_tool_use"
@@ -13,6 +15,19 @@ 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"
+
+# Output classes
+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/post_tool_use"
+require_relative "claude_hooks/output/notification"
+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"
 
 module ClaudeHooks
   class Error < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude_hooks
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Gabriel Dehan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-21 00:00:00.000000000 Z
+date: 2025-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -39,19 +39,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.0'
 description: A Ruby DSL framework for creating Claude Code hooks with composable hook
   scripts that enable teams to easily implement logging, security checks, and workflow
   automation.
@@ -63,10 +63,24 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - README.md
-- WHY.md
 - claude_hooks.gemspec
+- docs/API/COMMON.md
+- docs/API/NOTIFICATION.md
+- docs/API/POST_TOOL_USE.md
+- docs/API/PRE_COMPACT.md
+- docs/API/PRE_TOOL_USE.md
+- docs/API/SESSION_END.md
+- docs/API/SESSION_START.md
+- docs/API/STOP.md
+- docs/API/SUBAGENT_STOP.md
+- docs/API/USER_PROMPT_SUBMIT.md
+- docs/OUTPUT_MIGRATION_GUIDE.md
+- docs/WHY.md
 - example_dotclaude/commands/.gitkeep
+- example_dotclaude/hooks/entrypoints/session_end.rb
 - example_dotclaude/hooks/entrypoints/user_prompt_submit.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
 - example_dotclaude/hooks/handlers/user_prompt_submit/log_user_prompt.rb
 - example_dotclaude/settings.json
@@ -76,9 +90,20 @@ files:
 - lib/claude_hooks/configuration.rb
 - lib/claude_hooks/logger.rb
 - lib/claude_hooks/notification.rb
+- lib/claude_hooks/output/base.rb
+- lib/claude_hooks/output/notification.rb
+- lib/claude_hooks/output/post_tool_use.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/stop.rb
+- lib/claude_hooks/output/subagent_stop.rb
+- lib/claude_hooks/output/user_prompt_submit.rb
 - lib/claude_hooks/post_tool_use.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/stop.rb
 - lib/claude_hooks/subagent_stop.rb
@@ -100,14 +125,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Ruby DSL for creating Claude Code hooks