Add --status flag to bin/swap-deps (#52)

Adds a new --status flag that displays the current state of swapped
dependencies across all demos (or a specific demo if --demo is used).

The status output shows:
- Swapped gems in Gemfile (path-based or GitHub-based)
- Swapped npm packages in package.json (file: protocol)
- Backup file presence

This helps users quickly see what dependencies are currently swapped
without inspecting individual Gemfile and package.json files.

Author: justin808

lib/demo_scripts/gem_swapper.rb

@@ -133,6 +133,15 @@ def kill_watch_processes
     end
     # rubocop:enable Metrics/MethodLength
 
+    # CLI entry point: Display current swapped dependencies status
+    def show_status
+      puts '📊 Swapped dependencies status:'
+
+      each_demo do |demo_path|
+        show_demo_status(demo_path)
+      end
+    end
+
     # CLI entry point: Display cache information including location, size, and cached repositories
     def show_cache_info
       unless File.directory?(CACHE_DIR)
@@ -201,8 +210,106 @@ def load_config(config_file)
       raise Error, "Invalid YAML in #{config_file}: #{e.message}"
     end
 
+    # Regex patterns for detecting swapped gems in Gemfile
+    # These patterns match the format used by swap_gem_in_gemfile and swap_gem_to_github
+    GEM_PATH_PATTERN = ->(gem_name) { /^\s*gem\s+["']#{Regexp.escape(gem_name)}["'],\s*path:\s*["']([^"']+)["']/ }
+    GEM_GITHUB_PATTERN = lambda { |gem_name|
+      github_pattern = /^\s*gem\s+["']#{Regexp.escape(gem_name)}["'],\s*github:\s*["']([^"']+)["']/
+      github_ref_pattern = /(?:,\s*(?:branch|tag):\s*["']([^"']+)["'])?/
+      /#{github_pattern}#{github_ref_pattern}/
+    }
+
     private
 
+    def show_demo_status(demo_path)
+      puts "\n📦 #{demo_name(demo_path)}:"
+
+      gemfile_path = File.join(demo_path, 'Gemfile')
+      package_json_path = File.join(demo_path, 'package.json')
+
+      swapped_gems = detect_swapped_gems(gemfile_path)
+      swapped_packages = detect_swapped_packages(package_json_path)
+      backups = detect_backup_files(gemfile_path, package_json_path)
+
+      display_swapped_gems(swapped_gems) if swapped_gems.any?
+      display_swapped_packages(swapped_packages) if swapped_packages.any?
+
+      puts "  Backups: #{backups.join(', ')}" if backups.any?
+
+      return unless swapped_gems.empty? && swapped_packages.empty?
+
+      if backups.any?
+        puts '  ℹ️  No currently swapped dependencies (backups available)'
+      else
+        puts '  ℹ️  No swapped dependencies'
+      end
+    end
+
+    def detect_swapped_gems(gemfile_path)
+      return [] unless File.exist?(gemfile_path)
+
+      gemfile_content = File.read(gemfile_path)
+      swapped_gems = []
+
+      SUPPORTED_GEMS.each do |gem_name|
+        path_match = gemfile_content.match(GEM_PATH_PATTERN.call(gem_name))
+        github_match = gemfile_content.match(GEM_GITHUB_PATTERN.call(gem_name))
+
+        if path_match
+          swapped_gems << { name: gem_name, type: 'local', path: path_match[1] }
+        elsif github_match
+          ref = github_match[2] || 'main'
+          swapped_gems << { name: gem_name, type: 'github', path: "#{github_match[1]}@#{ref}" }
+        end
+      end
+
+      swapped_gems
+    end
+
+    def detect_swapped_packages(package_json_path)
+      return [] unless File.exist?(package_json_path)
+
+      package_data = JSON.parse(File.read(package_json_path))
+      swapped_packages = []
+      dependency_types = %w[dependencies devDependencies]
+
+      SUPPORTED_GEMS.each do |gem_name|
+        npm_name = gem_name.tr('_', '-')
+        dependency_types.each do |dep_type|
+          next unless package_data[dep_type]&.key?(npm_name)
+
+          version = package_data[dep_type][npm_name]
+          swapped_packages << { name: npm_name, path: version.sub('file:', '') } if version.start_with?('file:')
+        end
+      end
+
+      swapped_packages
+    rescue JSON::ParserError
+      puts '  ⚠️  Could not parse package.json'
+      []
+    end
+
+    def detect_backup_files(gemfile_path, package_json_path)
+      backups = []
+      backups << 'Gemfile' if File.exist?(gemfile_path + BACKUP_SUFFIX)
+      backups << 'package.json' if File.exist?(package_json_path + BACKUP_SUFFIX)
+      backups
+    end
+
+    def display_swapped_gems(swapped_gems)
+      puts '  Gemfile:'
+      swapped_gems.each do |gem|
+        puts "    ✓ #{gem[:name]} → #{gem[:path]}"
+      end
+    end
+
+    def display_swapped_packages(swapped_packages)
+      puts '  package.json:'
+      swapped_packages.each do |pkg|
+        puts "    ✓ #{pkg[:name]} → #{pkg[:path]}"
+      end
+    end
+
     def cache_repo_dirs
       return [] unless File.directory?(CACHE_DIR)
 

lib/demo_scripts/swap_deps_cli.rb

@@ -4,12 +4,13 @@
 
 module DemoScripts
   # CLI for swapping dependencies between production and local/GitHub versions
+  # rubocop:disable Metrics/ClassLength
   class SwapDepsCLI
     CONFIG_FILE = '.swap-deps.yml'
 
     attr_reader :gem_paths, :github_repos, :dry_run, :verbose, :restore, :apply_config,
                 :skip_build, :watch_mode, :demo_filter, :demos_dir, :list_watch, :kill_watch,
-                :show_cache, :clean_cache, :clean_cache_gem
+                :show_cache, :clean_cache, :clean_cache_gem, :show_status
 
     def initialize
       @gem_paths = {}
@@ -30,6 +31,7 @@ def initialize
       @show_cache = false
       @clean_cache = false
       @clean_cache_gem = nil
+      @show_status = false
     end
 
     # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
@@ -40,7 +42,9 @@ def run!
       # Require bundler/setup only when actually running commands (not for --help)
       require 'bundler/setup'
 
-      if @show_cache
+      if @show_status
+        show_status_info
+      elsif @show_cache
         show_cache_info
       elsif @clean_cache || @clean_cache_gem
         clean_cache_handler
@@ -184,7 +188,11 @@ def parse_options!
         end
 
         opts.separator ''
-        opts.separator 'Cache management:'
+        opts.separator 'Status and cache management:'
+
+        opts.on('--status', 'Show current swapped dependencies status') do
+          @show_status = true
+        end
 
         opts.on('--show-cache', 'Show cache location, size, and cached repositories') do
           @show_cache = true
@@ -258,6 +266,9 @@ def parse_options!
           puts '  # Stop all watch processes'
           puts '  bin/swap-deps --kill-watch'
           puts ''
+          puts '  # Show current swapped dependencies status'
+          puts '  bin/swap-deps --status'
+          puts ''
           puts '  # Show cache information'
           puts '  bin/swap-deps --show-cache'
           puts ''
@@ -308,6 +319,11 @@ def clean_cache_handler
       swapper.clean_cache(gem_name: @clean_cache_gem)
     end
 
+    def show_status_info
+      swapper = create_swapper
+      swapper.show_status
+    end
+
     def apply_from_config
       # Use root config if in demo directory, otherwise look for local config
       config_file = @root_config_file || CONFIG_FILE
@@ -381,4 +397,5 @@ def each_demo(&)
       demos.each(&)
     end
   end
+  # rubocop:enable Metrics/ClassLength
 end