neon_sakura 0.1.4

data/lib/neon_sakura/configuration.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  class Configuration
+    attr_accessor :app_name, :show_version, :show_header, :nav_links, :enable_error_pages,
+                  :nav_position, :app_icon, :show_search, :default_theme, :available_themes,
+                  :enable_theme_persistence, :theme_api_endpoint, :enable_style_guide,
+                  :style_guide_navbar_position, :style_guide_pagy_examples, :sticky_navbar,
+                  :version_module
+
+    def initialize
+      @app_name = "My Application"
+      @show_version = true
+      @show_header = true
+      @enable_error_pages = true
+      @nav_position = :under_heading
+      @app_icon = nil
+      @show_search = false
+      @version_module = nil # Optional module that provides .commit_hash (e.g., YourApp::Version)
+      @nav_links = [
+        { name: "Home", path: "/" },
+        { name: "About", path: "/about" }
+      ]
+
+      # Theme configuration (v0.1.1+)
+      # By default, all 4 themes are available
+      @default_theme = { name: "purple", mode: "dark" }
+      @available_themes = [
+        { name: "green", mode: "light", label: "Green Light" },
+        { name: "green", mode: "dark", label: "Green Dark" },
+        { name: "purple", mode: "light", label: "Purple Light" },
+        { name: "purple", mode: "dark", label: "Purple Dark" }
+      ]
+      @enable_theme_persistence = true
+      @theme_api_endpoint = nil
+
+      # Style guide configuration (v0.1.3+)
+      @enable_style_guide = true
+      @style_guide_navbar_position = :end
+      @style_guide_pagy_examples = true # Auto-detect: show if Pagy available, skip if not
+
+      # Navbar configuration
+      @sticky_navbar = false # Off by default for backward compatibility
+    end
+
+    # Auto-inject style guide link into nav_links
+    # Called by engine initializer in development/test environments
+    def inject_style_guide_link!
+      return unless enable_style_guide
+      return unless Rails.env.development? || Rails.env.test?
+
+      # Don't inject twice
+      return if nav_links.any? { |link| link[:path] == "/style-guide" }
+
+      style_guide_link = {
+        type: "link",
+        name: "Style Guide",
+        path: "/style-guide",
+        icon: "palette",
+        condition: "Rails.env.development? || Rails.env.test?",
+        aria_label: "View style guide"
+      }
+
+      case style_guide_navbar_position
+      when :start
+        nav_links.unshift(style_guide_link)
+      when :before_logout
+        logout_index = nav_links.find_index { |link| link[:type] == "button" }
+        if logout_index
+          nav_links.insert(logout_index, style_guide_link)
+        else
+          nav_links << style_guide_link
+        end
+      when Integer
+        nav_links.insert(style_guide_navbar_position, style_guide_link)
+      else # :end or default
+        nav_links << style_guide_link
+      end
+    end
+  end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+  end
+
+  def self.config
+    configuration || Configuration.new
+  end
+end

data/lib/neon_sakura/engine.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "active_support"
+require "action_dispatch"
+require "rails/engine"
+require "propshaft"
+
+module NeonSakura
+  class Engine < ::Rails::Engine
+    # Initialize the engine
+    config.assets.enabled = true
+
+    # Ensure stylesheets are added to asset paths
+    initializer "neon_sakura.assets" do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << root.join("app", "assets", "stylesheets")
+      end
+    end
+
+    # Add engine views to application view paths
+    initializer "neon_sakura.view_paths" do |app|
+      ActiveSupport.on_load(:action_controller) do
+        append_view_path(NeonSakura::Engine.root.join("app", "views"))
+      end
+
+      ActiveSupport.on_load(:action_mailer) do
+        append_view_path(NeonSakura::Engine.root.join("app", "views"))
+      end
+    end
+
+    # Include helpers in ActionView
+    initializer "neon_sakura.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include NeonSakura::IconHelper
+        include NeonSakura::ThemeHelper
+        include NeonSakura::StylesheetHelper
+        include NeonSakura::ProfileHelper
+      end
+    end
+
+    # Auto-inject style guide link into navbar (development/test only)
+    initializer "neon_sakura.style_guide_navbar", after: :load_config_initializers do
+      if NeonSakura.configuration.enable_style_guide && (Rails.env.development? || Rails.env.test?)
+        NeonSakura.configuration.inject_style_guide_link!
+      end
+    end
+  end
+end

data/lib/neon_sakura/icon_helper.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  module IconHelper
+    # Renders an icon partial with the given options
+    # @param name [String] The icon name (without underscore prefix)
+    # @param options [Hash] Options for the icon
+    # @option options [String] :css_class CSS class for the icon
+    # @option options [Boolean] :aria_hidden Whether the icon is aria-hidden
+    # @option options [String] :aria_label Label for accessibility
+    # All other options are passed through to the icon partial as local_assigns
+    # @return [String] Rendered icon partial
+    def render_icon(name, options = {})
+      # Set default CSS class if not provided
+      options[:css_class] ||= "w-4 h-4"
+
+      # Pass all options to the partial as local_assigns
+      render "shared/icons/#{name}", options
+    end
+
+    # Get a list of all available icons
+    # @return [Array<String>] Array of icon names
+    def available_icons
+      # Use gem's icon directory when running within the gem, otherwise use app's directory
+      root_path = defined?(NeonSakura::Engine) ? NeonSakura::Engine.root : Rails.root
+      icon_files = Dir.glob(File.join(root_path, "app", "views", "shared", "icons", "_*.html.erb"))
+      icon_files.map do |file|
+        File.basename(file, ".html.erb").gsub(/^_/, "")
+      end.sort
+    end
+
+    # Check if an icon exists
+    # @param name [String] The icon name to check
+    # @return [Boolean] Whether the icon exists
+    def icon_exists?(name)
+      # Use gem's icon directory when running within the gem, otherwise use app's directory
+      root_path = defined?(NeonSakura::Engine) ? NeonSakura::Engine.root : Rails.root
+      File.exist?(File.join(root_path, "app", "views", "shared", "icons", "_#{name}.html.erb"))
+    end
+
+    # Renders a list of icons with consistent styling
+    # @param icon_names [Array<String>] Array of icon names
+    # @param options [Hash] Options for rendering
+    # @return [String] HTML string with rendered icons
+    def render_icon_list(icon_names, options = {})
+      css_class = options[:css_class] || "flex items-center gap-2"
+      icons_html = icon_names.map do |icon_name|
+        render_icon(icon_name, options.merge(css_class: options[:icon_css_class]))
+      end.join("\n")
+
+      "<div class=\"#{css_class}\">#{icons_html}</div>".html_safe
+    end
+  end
+end

data/lib/neon_sakura/profile_helper.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  module ProfileHelper
+    # Generate Gravatar URL for email address
+    #
+    # @param email [String] Email address to generate Gravatar for
+    # @param size [Integer] Image size in pixels (default: 80)
+    # @return [String] Gravatar URL
+    #
+    # @example
+    #   gravatar_url("user@example.com") # => "https://www.gravatar.com/avatar/..."
+    #   gravatar_url("user@example.com", size: 120) # => "https://www.gravatar.com/avatar/...?s=120"
+    #
+    # Note: MD5 is used for Gravatar GUID generation (public identifier, not sensitive data)
+    def gravatar_url(email, size: 80)
+      return "" if email.blank?
+
+      require "digest/md5"
+      hash = Digest::MD5.hexdigest(email.downcase.strip) # nosemgrep: weak-hashes-md5
+      "https://www.gravatar.com/avatar/#{hash}?s=#{size}&d=identicon"
+    end
+  end
+end

data/lib/neon_sakura/stylesheet_helper.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  module StylesheetHelper
+    # Load all neon_sakura stylesheets in the correct cascade order
+    # This helper is needed because Propshaft doesn't process @import statements
+    # like Sprockets did. Each CSS file must be loaded individually.
+    #
+    # Usage in your layout:
+    #   <%= neon_sakura_stylesheets %>
+    def neon_sakura_stylesheets
+      files = [
+        # Themes first - defines CSS variables
+        "theme-default",
+        "theme-purple",
+        "theme-green",
+        "theme-red",
+        # Utilities - uses CSS variables
+        "utility-reset",
+        "utility-layout",
+        "utility-sizing",
+        "utility-spacing",
+        "utility-colors",
+        "utility-borders",
+        "utility-typography",
+        "utility-gradients",
+        "utility-effects",
+        "utility-responsive",
+        # Loading indicators
+        "loading",
+        # Components and forms - uses both
+        "components",
+        "forms",
+        "pagy-tailwind"
+      ]
+
+      safe_join(files.map { |file| stylesheet_link_tag(file, "data-turbo-track": "reload") })
+    end
+  end
+end

data/lib/neon_sakura/theme_helper.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  module ThemeHelper
+    # Returns the current theme as a hash with :name and :mode keys
+    # Priority: session/cookies (from JS localStorage) -> default_theme from config
+    def current_theme
+      # Try to get theme from session (set by JavaScript via cookie)
+      theme_name = cookies[:theme_name] || session[:theme_name]
+      theme_mode = cookies[:theme_mode] || session[:theme_mode]
+
+      if theme_name && theme_mode
+        { name: theme_name.to_s, mode: theme_mode.to_s }
+      else
+        # Fall back to default theme from configuration
+        NeonSakura.config.default_theme
+      end
+    end
+
+    # Returns HTML data attributes for the current theme
+    # Usage: <html <%= theme_data_attributes %>>
+    def theme_data_attributes
+      theme = current_theme
+      "data-theme-name='#{theme[:name]}' data-theme-mode='#{theme[:mode]}'".html_safe
+    end
+
+    # Returns available themes as JSON for JavaScript
+    def available_themes_json
+      NeonSakura.config.available_themes.to_json.html_safe
+    end
+
+    # Returns the number of available themes
+    def theme_count
+      NeonSakura.config.available_themes.length
+    end
+
+    # Helper to determine theme switcher mode
+    # Returns: :disabled (1 theme), :toggle (2 themes), :dropdown (3+ themes)
+    def theme_switcher_mode
+      case theme_count
+      when 0, 1
+        :disabled
+      when 2
+        :toggle
+      else
+        :dropdown
+      end
+    end
+
+    # Renders an icon partial for the current theme
+    # @param name [String] The icon name (without underscore prefix)
+    # @param options [Hash] Options for the icon
+    # All options are passed through to the icon partial as local_assigns
+    # @return [String] Rendered icon partial
+    def render_theme_icon(name, options = {})
+      # Set default CSS class if not provided
+      options[:css_class] ||= "w-4 h-4"
+
+      # Pass all options to the partial as local_assigns
+      render "shared/icons/#{name}", options
+    end
+  end
+end

data/lib/neon_sakura/theme_importer.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  # ThemeImporter provides utilities to import themes from other CSS frameworks
+  # like Bootstrap, Material UI, etc. and convert them to neon_sakura's theme structure
+  class ThemeImporter
+    # Import a Bootstrap theme
+    # @param bootstrap_vars [Hash] Bootstrap color variables
+    # @return [Hash] neon_sakura theme structure
+    def self.from_bootstrap(bootstrap_vars)
+      {
+        name: bootstrap_vars[:name] || "bootstrap",
+        mode: bootstrap_vars[:mode] || detect_mode(bootstrap_vars),
+        label: bootstrap_vars[:label] || "Bootstrap Theme",
+        colors: {
+          accent: bootstrap_vars[:primary] || "#0d6efd",
+          background: bootstrap_vars[:"body-bg"] || "#ffffff",
+          surface: bootstrap_vars[:light] || "#f8f9fa",
+          text_primary: bootstrap_vars[:"body-color"] || "#212529",
+          text_secondary: bootstrap_vars[:secondary] || "#6c757d",
+          notification: bootstrap_vars[:success] || "#198754",
+          alert: bootstrap_vars[:danger] || "#dc3545",
+          border: bootstrap_vars[:border] || "#dee2e6"
+        }
+      }
+    end
+
+    # Import a Material UI theme
+    # @param material_vars [Hash] Material UI palette variables
+    # @return [Hash] neon_sakura theme structure
+    def self.from_material_ui(material_vars)
+      palette = material_vars[:palette] || {}
+
+      {
+        name: material_vars[:name] || "material",
+        mode: material_vars[:mode] || (palette[:mode] == "dark" ? "dark" : "light"),
+        label: material_vars[:label] || "Material Theme",
+        colors: {
+          accent: palette.dig(:primary, :main) || "#1976d2",
+          background: palette.dig(:background, :default) || "#ffffff",
+          surface: palette.dig(:background, :paper) || "#ffffff",
+          text_primary: palette.dig(:text, :primary) || "rgba(0, 0, 0, 0.87)",
+          text_secondary: palette.dig(:text, :secondary) || "rgba(0, 0, 0, 0.6)",
+          notification: palette.dig(:success, :main) || "#2e7d32",
+          alert: palette.dig(:error, :main) || "#d32f2f",
+          border: palette.dig(:divider) || "rgba(0, 0, 0, 0.12)"
+        }
+      }
+    end
+
+    # Import from a generic hash of color variables
+    # @param theme_hash [Hash] Arbitrary theme hash
+    # @return [Hash] neon_sakura theme structure
+    def self.from_hash(theme_hash)
+      {
+        name: theme_hash[:name] || "custom",
+        mode: theme_hash[:mode] || detect_mode(theme_hash),
+        label: theme_hash[:label] || "Custom Theme",
+        colors: {
+          accent: theme_hash[:accent] || theme_hash[:primary] || "#3b82f6",
+          background: theme_hash[:background] || theme_hash[:bg] || "#ffffff",
+          surface: theme_hash[:surface] || theme_hash[:card] || "#f9fafb",
+          text_primary: theme_hash[:text_primary] || theme_hash[:text] || "#111827",
+          text_secondary: theme_hash[:text_secondary] || "#6b7280",
+          notification: theme_hash[:notification] || theme_hash[:success] || "#10b981",
+          alert: theme_hash[:alert] || theme_hash[:error] || theme_hash[:danger] || "#ef4444",
+          border: theme_hash[:border] || "#e5e7eb"
+        }
+      }
+    end
+
+    # Generate CSS custom properties for a theme
+    # @param theme [Hash] Theme structure from import methods
+    # @return [String] CSS custom properties
+    def self.to_css_variables(theme)
+      colors = theme[:colors]
+      css = ":root[data-theme-name=\"#{theme[:name]}\"][data-theme-mode=\"#{theme[:mode]}\"] {\n"
+
+      colors.each do |key, value|
+        css_var_name = key.to_s.gsub("_", "-")
+        css += "  --color-#{css_var_name}: #{value};\n"
+      end
+
+      css += "}\n"
+      css
+    end
+
+    private
+
+    # Detect light/dark mode based on background color brightness
+    # @param theme_vars [Hash] Theme color variables
+    # @return [String] "light" or "dark"
+    def self.detect_mode(theme_vars)
+      bg = theme_vars[:background] || theme_vars[:"body-bg"] || "#ffffff"
+
+      # Convert hex to RGB and calculate brightness
+      if bg.start_with?("#")
+        hex = bg.delete("#")
+        r = hex[0..1].to_i(16)
+        g = hex[2..3].to_i(16)
+        b = hex[4..5].to_i(16)
+
+        # Calculate perceived brightness (0-255)
+        brightness = (r * 0.299 + g * 0.587 + b * 0.114)
+
+        brightness > 127 ? "light" : "dark"
+      else
+        "light" # Default to light if we can't parse the color
+      end
+    end
+  end
+end

data/lib/neon_sakura/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NeonSakura
+  VERSION = "0.1.4"
+end

data/lib/neon_sakura.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "neon_sakura/version"
+require_relative "neon_sakura/configuration"
+require_relative "neon_sakura/icon_helper"
+require_relative "neon_sakura/theme_helper"
+require_relative "neon_sakura/stylesheet_helper"
+require_relative "neon_sakura/profile_helper"
+require_relative "neon_sakura/engine"
+
+module NeonSakura
+  class Error < StandardError; end
+end

data/neon_sakura.gemspec

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'neon_sakura/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'neon_sakura'
+  spec.version       = NeonSakura::VERSION
+  spec.authors       = [ 'trex22' ]
+  spec.email         = [ 'contact@jasonchalom.com' ]
+
+  spec.summary       = 'Shared styling and theming components for Rails applications'
+  spec.description   = 'A gem that extracts the styling and theming components from my Rails applications for reuse across multiple projects'
+  spec.homepage      = 'https://github.com/trex22/neon_sakura'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.4.7')
+
+  spec.metadata['source_code_uri'] = 'https://github.com/trex22/neon_sakura'
+  spec.metadata['changelog_uri'] = 'https://github.com/trex22/neon_sakura/blob/main/CHANGELOG.md'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/trex22/neon_sakura/issues'
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = [ 'lib' ]
+
+  # Dependencies
+  spec.add_dependency 'rails', '>= 8.0.0'
+  spec.add_dependency 'propshaft', '>= 1.3.1'
+
+  # Development dependencies
+  spec.add_development_dependency 'brakeman', '~> 7.1.1'
+  spec.add_development_dependency 'bundler', '~> 2.7.2'
+  spec.add_development_dependency 'bundler-audit', '~> 0.9.3'
+  spec.add_development_dependency 'minitest', '~> 6.0.1'
+  spec.add_development_dependency 'minitest-focus', '~> 1.4.0'
+  spec.add_development_dependency 'minitest-reporters', '~> 1.7.1'
+  spec.add_development_dependency 'mocha', '~> 3.0.1'
+  spec.add_development_dependency 'pry', '~> 0.16.0'
+  spec.add_development_dependency 'rake', '~> 13.3.1'
+  spec.add_development_dependency 'rubocop-rails-omakase', '~> 1.1.0'
+  spec.add_development_dependency 'simplecov', '~> 0.22.0'
+  spec.add_development_dependency 'timecop', '~> 0.9.10'
+  spec.add_development_dependency 'webmock', '~> 3.26.1'
+end

data/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "neon_sakura",
+  "version": "0.1.2",
+  "description": "A Rails engine for reusable styling and theming components",
+  "private": true,
+  "scripts": {
+    "lint:css": "stylelint 'app/assets/stylesheets/**/*.css'",
+    "lint:css:fix": "stylelint 'app/assets/stylesheets/**/*.css' --fix"
+  },
+  "devDependencies": {
+    "stylelint": "^16.12.0",
+    "stylelint-config-standard": "^36.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "yarn": ">=1.22.0"
+  }
+}

data/scripts/git-hooks/post-merge

@@ -0,0 +1,132 @@
+#!/bin/bash
+
+# Neon Sakura post-merge hook
+# Auto-runs database migrations and asset precompilation after merges
+
+echo "🔄 Running post-merge tasks..."
+
+# Check if we're in a Rails app
+if [ ! -f "Gemfile" ]; then
+  echo "❌ Not a Rails application, skipping post-merge tasks"
+  exit 0
+fi
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Track if any tasks were performed
+tasks_performed=0
+
+# 1. Check for new migrations and run them
+check_and_run_migrations() {
+  echo -e "${BLUE}Checking for new migrations...${NC}"
+
+  # Check if there are pending migrations
+  pending_migrations=$(bundle exec rails db:migrate:status 2>/dev/null | grep "^\s*down" | wc -l)
+
+  if [ "$pending_migrations" -gt 0 ]; then
+    echo -e "${YELLOW}Found $pending_migrations pending migration(s)${NC}"
+    echo -e "${BLUE}Running migrations...${NC}"
+
+    if bundle exec rails db:migrate; then
+      echo -e "${GREEN}✅ Migrations completed successfully${NC}"
+      tasks_performed=$((tasks_performed + 1))
+    else
+      echo -e "${RED}❌ Migration failed${NC}"
+      echo -e "${RED}Please run 'bundle exec rails db:migrate' manually${NC}"
+      return 1
+    fi
+  else
+    echo -e "${GREEN}✅ No pending migrations${NC}"
+  fi
+
+  return 0
+}
+
+# 2. Check for Gemfile changes and run bundle install
+check_and_bundle_install() {
+  echo -e "${BLUE}Checking for Gemfile changes...${NC}"
+
+  # Check if Gemfile or Gemfile.lock changed in the merge
+  if git diff HEAD@{1} HEAD --name-only | grep -E "^Gemfile|^Gemfile\.lock$" > /dev/null; then
+    echo -e "${YELLOW}Gemfile changes detected${NC}"
+    echo -e "${BLUE}Running bundle install...${NC}"
+
+    if bundle install; then
+      echo -e "${GREEN}✅ Bundle install completed${NC}"
+      tasks_performed=$((tasks_performed + 1))
+    else
+      echo -e "${RED}❌ Bundle install failed${NC}"
+      echo -e "${RED}Please run 'bundle install' manually${NC}"
+      return 1
+    fi
+  else
+    echo -e "${GREEN}✅ No Gemfile changes detected${NC}"
+  fi
+
+  return 0
+}
+
+# 3. Check for asset changes and precompile if needed
+check_and_precompile_assets() {
+  echo -e "${BLUE}Checking for asset changes...${NC}"
+
+  # Check if asset files changed
+  asset_changes=$(git diff HEAD@{1} HEAD --name-only | grep -E "^app/assets/|^app/javascript/|^config/importmap\.rb|^config/routes\.rb" | wc -l)
+
+  if [ "$asset_changes" -gt 0 ] && [ -f "config/application.rb" ]; then
+    # Check if we're using asset pipeline
+    if grep -q "propshaft" Gemfile 2>/dev/null; then
+      echo -e "${YELLOW}Asset changes detected${NC}"
+      echo -e "${BLUE}Precompiling assets...${NC}"
+
+      # Only precompile in development if specifically configured
+      if bundle exec rails assets:precompile RAILS_ENV=development > /dev/null 2>&1; then
+        echo -e "${GREEN}✅ Assets precompiled successfully${NC}"
+        tasks_performed=$((tasks_performed + 1))
+      else
+        echo -e "${YELLOW}⚠️  Asset precompilation skipped (likely not needed in development)${NC}"
+      fi
+    else
+      echo -e "${GREEN}✅ No asset pipeline detected${NC}"
+    fi
+  else
+    echo -e "${GREEN}✅ No asset changes detected${NC}"
+  fi
+
+  return 0
+}
+
+# Run all checks
+failed_tasks=0
+
+if ! check_and_bundle_install; then
+  failed_tasks=$((failed_tasks + 1))
+fi
+
+if ! check_and_run_migrations; then
+  failed_tasks=$((failed_tasks + 1))
+fi
+
+if ! check_and_precompile_assets; then
+  failed_tasks=$((failed_tasks + 1))
+fi
+
+# Summary
+echo ""
+if [ $failed_tasks -gt 0 ]; then
+  echo -e "${RED}❌ $failed_tasks post-merge task(s) failed${NC}"
+  echo -e "${YELLOW}Please address the issues above manually${NC}"
+elif [ $tasks_performed -gt 0 ]; then
+  echo -e "${GREEN}🎉 $tasks_performed post-merge task(s) completed successfully!${NC}"
+else
+  echo -e "${GREEN}✅ No post-merge tasks needed${NC}"
+fi
+
+# Note: We don't exit with error code for post-merge hooks
+# as they shouldn't block the merge operation
+exit 0