stable-cli-rails 0.8.1 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55fbeca00cb3d5ac0cf360dd86a8022081e3bf8b00af321c8ac8dec7482e7e5b
-  data.tar.gz: a1d3fa2c7d8ffb2ae339e75d4ebdd1aa67e4b1e7b88ef0377ce8d06dc170c94d
+  metadata.gz: adfc3784b0a153d9a5368139267d77c0cfa8a32b71d72e8da43ae5a454220f6a
+  data.tar.gz: 861823110de96d0e4d1c8297f13ff2f9630a25649d201f921aaa64f43849888c
 SHA512:
-  metadata.gz: 3e90d7e10d507ea30367e375dc99576f0b9902d77f9d7d2facf45e16fe116fff5eaac586eacec099b664b31f05f25dc33ec83db2d5b89926b0bb1fcf196588c8
-  data.tar.gz: 81a7739540c1b55e429867f7c7efd22af8a96559b239710fb290179c67d8ca67e1c6e5fc4448d3f6380cedf61b62fae4c1b737c5f98d532848c63652f2c05dcf
+  metadata.gz: 9651b1cd3c7127223a5587f31e70175fdf2be8e9ccd8c3e17347b73a1364b9404eda928d7e314513bf5a416b8acf90c31a14eb2d6e7ec719d6f7576887dd933d
+  data.tar.gz: 9ab4288661598a9349301e1fa1f96007b0eafdc78eb66886e26f9b555ecf871d55f07fdb9b2ce529d59aff25ee287e655e68a3a5bce001d38c6621eae6c73736

data/lib/stable/cli.rb

@@ -13,6 +13,8 @@ module Stable
   class CLI < Thor
     def initialize(*)
       super
+      return if ENV['STABLE_TEST_MODE']
+
       Stable::Bootstrap.run!
       Services::SetupRunner.ensure_dependencies!
     end
@@ -75,6 +77,11 @@ module Stable
       Commands::Remove.new(name).call
     end
 
+    desc 'destroy NAME', 'Permanently delete a Rails app and all its files'
+    def destroy(name)
+      Commands::Destroy.new(name).call
+    end
+
     desc 'start NAME', 'Start a Rails app with its correct Ruby version'
     def start(name)
       Commands::Start.new(name).call
@@ -123,27 +130,9 @@ module Stable
       Commands::Doctor.new.call
     end
 
-    desc 'upgrade-ruby NAME VERSION', 'Upgrade Ruby for an app'
+    desc 'upgrade-ruby NAME VERSION', 'Change Ruby version for an app (upgrade, downgrade, or switch)'
     def upgrade_ruby(name, version)
-      app = Services::AppRegistry.find(name)
-      unless app
-        puts "No app named #{name}"
-        return
-      end
-
-      if Stable::Services::Ruby.rvm_available?
-        system("bash -lc 'rvm install #{version}'")
-      elsif Stable::Services::Ruby.rbenv_available?
-        system("rbenv install #{version}")
-      else
-        puts 'No Ruby version manager found'
-        return
-      end
-
-      File.write(File.join(app[:path], '.ruby-version'), version)
-      Services::AppRegistry.update(name, ruby: version)
-
-      puts "#{name} now uses Ruby #{version}"
+      Commands::UpgradeRuby.new(name, version).call
     end
 
     private

data/lib/stable/commands/destroy.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require 'io/console'
+
+module Stable
+  module Commands
+    # Destroy command - permanently deletes a Rails application with confirmation
+    class Destroy
+      def initialize(name)
+        @name = name
+      end
+
+      def call
+        app = Services::AppRegistry.find(@name)
+        abort 'App not found' unless app
+
+        display_warning(app)
+        return unless confirm_destruction
+
+        puts "\n🗑️  Destroying #{@name}..."
+        perform_destruction(app)
+        puts "✅ Successfully destroyed #{@name}"
+      end
+
+      private
+
+      def display_warning(app)
+        puts "⚠️  WARNING: This will permanently delete the application '#{@name}'"
+        puts "   Path: #{app[:path]}"
+        puts "   Domain: #{app[:domain]}"
+        puts '   This action CANNOT be undone!'
+        puts ''
+      end
+
+      def confirm_destruction
+        print "Type '#{@name}' to confirm destruction: "
+        confirmation = $stdin.gets&.strip
+        puts ''
+
+        if confirmation == @name
+          true
+        else
+          puts "❌ Destruction cancelled - confirmation didn't match"
+          false
+        end
+      end
+
+      def perform_destruction(app)
+        # Stop the app if running
+        Services::ProcessManager.stop(app)
+
+        # Remove from infrastructure
+        Services::HostsManager.remove(app[:domain])
+        Services::CaddyManager.remove(app[:domain])
+        Services::AppRegistry.remove(@name)
+
+        # Clean up RVM gemset
+        cleanup_rvm_gemset(app)
+
+        # Delete the project directory
+        delete_project_directory(app[:path])
+
+        # Reload Caddy
+        Services::CaddyManager.reload
+      end
+
+      def cleanup_rvm_gemset(app)
+        # Skip RVM operations in test mode
+        return if ENV['STABLE_TEST_MODE']
+
+        # Only clean up RVM gemsets on Unix-like systems (macOS/Linux)
+        # Windows uses different Ruby version managers
+        return unless Stable::Utils::Platform.unix?
+
+        ruby_version = app[:ruby]
+        # Handle different ruby version formats (e.g., "3.4.7", "ruby-3.4.7")
+        clean_ruby_version = ruby_version.to_s.sub(/^ruby-/, '')
+        gemset_name = "#{clean_ruby_version}@#{@name}"
+
+        puts "   Cleaning up RVM gemset #{gemset_name}..."
+        begin
+          # Use system to run RVM command to delete the gemset
+          system("bash -lc 'source ~/.rvm/scripts/rvm && rvm gemset delete #{gemset_name} --force' 2>/dev/null || true")
+          puts "   ✅ RVM gemset #{gemset_name} cleaned up"
+        rescue StandardError => e
+          puts "   ⚠️  Could not clean up RVM gemset #{gemset_name}: #{e.message}"
+        end
+      end
+
+      def delete_project_directory(path)
+        if ENV['STABLE_TEST_MODE']
+          puts '   Deleting project directory...'
+          return
+        end
+
+        if File.exist?(path)
+          puts '   Deleting project directory...'
+          FileUtils.rm_rf(path)
+        else
+          puts '   Project directory not found (already deleted?)'
+        end
+      end
+    end
+  end
+end

data/lib/stable/commands/list.rb

@@ -6,47 +6,47 @@ module Stable
   module Commands
     # List command - displays all registered applications
     class List
-    def call
-      apps = Services::AppRegistry.all
+      def call
+        apps = Services::AppRegistry.all
 
-      if apps.empty?
-        puts 'No apps registered.'
-        return
-      end
+        if apps.empty?
+          puts 'No apps registered.'
+          return
+        end
 
-      print_header
+        print_header
 
-      apps.each do |app|
-        # Determine status based on whether the app is actually running (port check)
-        status = app_running?(app) ? 'running' : 'stopped'
-        puts format_row(app, status)
+        apps.each do |app|
+          # Determine status based on whether the app is actually running (port check)
+          status = app_running?(app) ? 'running' : 'stopped'
+          puts format_row(app, status)
+        end
       end
-    end
 
-    private
+      private
 
-    def app_running?(app)
-      return false unless app && app[:port]
+      def app_running?(app)
+        return false unless app && app[:port]
 
-      # Check if something is listening on the app's port (cross-platform)
-      Stable::Utils::Platform.port_in_use?(app[:port])
-    end
+        # Check if something is listening on the app's port (cross-platform)
+        Stable::Utils::Platform.port_in_use?(app[:port])
+      end
 
-    def format_row(app, status)
-      format(
-        '%<name>-18s %<domain>-26s %<port>-8s %<ruby>-10s %<status>-10s',
-        name: app[:name],
-        domain: app[:domain],
-        port: app[:port],
-        ruby: app[:ruby],
-        status: status
-      )
-    end
+      def format_row(app, status)
+        format(
+          '%<name>-18s %<domain>-26s %<port>-8s %<ruby>-10s %<status>-10s',
+          name: app[:name],
+          domain: app[:domain],
+          port: app[:port],
+          ruby: app[:ruby],
+          status: status
+        )
+      end
 
-    def print_header
-      puts 'APP                DOMAIN                     PORT     RUBY       STATUS    '
-      puts '-' * 78
-    end
+      def print_header
+        puts 'APP                DOMAIN                     PORT     RUBY       STATUS    '
+        puts '-' * 78
+      end
     end
   end
 end

data/lib/stable/commands/upgrade_ruby.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+require 'shellwords'
+
+module Stable
+  module Commands
+    # Command for upgrading/downgrading Ruby versions for applications
+    class UpgradeRuby
+      def initialize(name, version)
+        @name = name
+        @version = version
+      end
+
+      def call
+        app = Services::AppRegistry.find(@name)
+        unless app
+          puts "No app named #{@name}"
+          return
+        end
+
+        current_version = app[:ruby] || RUBY_VERSION
+
+        puts "#{action(current_version, @version)} #{@name} from Ruby #{current_version} to #{@version}..."
+        puts ''
+
+        # Install the target Ruby version if needed
+        platform = Stable::Utils::Platform.current
+
+        if platform == :windows
+          puts '⚠️  Windows detected - Ruby version managers work differently on Windows'
+          puts "   Please manually install Ruby #{@version} using RubyInstaller or your preferred method"
+          puts '   Recommended: https://rubyinstaller.org/'
+          puts '   Then update your PATH to use the new Ruby version'
+          puts ''
+          puts "After installing Ruby #{@version}, update the app configuration manually:"
+          puts "   - Edit .ruby-version file to contain: #{@version}"
+          puts '   - Run: bundle install (in the app directory)'
+          return
+        end
+
+        if Stable::Services::Ruby.rvm_available?
+          puts "Ensuring Ruby #{@version} is available..."
+          system("bash -lc 'rvm install #{@version}'") unless ENV['STABLE_TEST_MODE']
+        elsif Stable::Services::Ruby.rbenv_available?
+          puts "Ensuring Ruby #{@version} is available..."
+          system("rbenv install #{@version}") unless ENV['STABLE_TEST_MODE']
+        else
+          puts '❌ No supported Ruby version manager found'
+          puts '   On macOS/Linux, install RVM (https://rvm.io/) or rbenv (https://github.com/rbenv/rbenv)'
+          puts '   On Windows, use RubyInstaller (https://rubyinstaller.org/)'
+          return
+        end
+
+        # Clean, simple approach: Remove current Ruby environment and install new one fresh
+        puts "🔄 Upgrading #{@name} from Ruby #{current_version} to #{@version}..."
+
+        # 1. Remove current Ruby version/gemset (like destroy command)
+        cleanup_rvm_gemset(app)
+
+        # 2. Install new Ruby version fresh (like app creator)
+        setup_new_ruby_version(app, @version)
+
+        puts ''
+        puts "✅ #{@name} #{past_tense_action(action(current_version, @version))} to Ruby #{@version}!"
+        puts "   Old gemset cleared, fresh #{@version}@#{@name} gemset created with gems"
+        puts ''
+        puts "Start with: stable start #{@name}"
+      end
+
+      private
+
+      def cleanup_rvm_gemset(app)
+        # Skip RVM operations in test mode
+        return if ENV['STABLE_TEST_MODE']
+
+        # Only clean up RVM gemsets on Unix-like systems (macOS/Linux)
+        # Windows uses different Ruby version managers
+        return unless Stable::Utils::Platform.unix?
+
+        ruby_version = app[:ruby]
+        # Handle different ruby version formats (e.g., "3.4.7", "ruby-3.4.7")
+        clean_ruby_version = ruby_version.to_s.sub(/^ruby-/, '')
+        gemset_name = "#{clean_ruby_version}@#{@name}"
+
+        puts "   Cleaning up RVM gemset #{gemset_name}..."
+        begin
+          # Use system to run RVM command to delete the gemset
+          system("bash -lc 'source ~/.rvm/scripts/rvm && rvm gemset delete #{gemset_name} --force' 2>/dev/null || true")
+          puts "   ✅ RVM gemset #{gemset_name} cleaned up"
+        rescue StandardError => e
+          puts "   ⚠️  Could not clean up RVM gemset #{gemset_name}: #{e.message}"
+        end
+      end
+
+      def setup_new_ruby_version(app, new_version)
+        # Follow app_creator.rb pattern exactly
+        unless ENV['STABLE_TEST_MODE']
+          # Ensure Ruby version & RVM (like app_creator.rb)
+          Stable::Services::Ruby.ensure_version(new_version)
+          Stable::Services::Ruby.ensure_rvm!
+
+          # Create gemset (like app_creator.rb)
+          Stable::System::Shell.run("bash -lc 'source #{Stable::Services::Ruby.rvm_script} && rvm #{new_version} do rvm gemset create #{@name} || true'")
+
+          rvm_cmd = Stable::Services::Ruby.rvm_prefix(new_version, @name)
+
+          # Install Bundler (like app_creator.rb)
+          Stable::System::Shell.run("bash -lc '#{rvm_cmd} gem install bundler --no-document'")
+
+          # Run bundle install (like app_creator.rb)
+          Stable::System::Shell.run(rvm_run('bundle install --jobs=4 --retry=3', chdir: app[:path]))
+        end
+
+        # Update app configuration (like app_creator.rb)
+        unless ENV['STABLE_TEST_MODE']
+          Dir.chdir(app[:path]) do
+            File.write('.ruby-version', "#{new_version}\n")
+            File.write('.ruby-gemset', "#{@name}\n")
+          end
+        end
+
+        # Update registry
+        Services::AppRegistry.update(@name, ruby: new_version)
+        puts "   ✅ New Ruby #{new_version} environment set up with gems"
+      end
+
+      def rvm_run(cmd, chdir: nil)
+        cd = chdir ? "cd #{chdir} && " : ''
+        "bash -lc '#{cd}source #{Dir.home}/.rvm/scripts/rvm && rvm #{@version}@#{@name} do #{cmd}'"
+      end
+
+      def action(current_version, new_version)
+        current_parts = current_version.split('.').map(&:to_i)
+        new_parts = new_version.split('.').map(&:to_i)
+
+        if new_parts[0] > current_parts[0] ||
+           (new_parts[0] == current_parts[0] && new_parts[1] > current_parts[1]) ||
+           (new_parts[0] == current_parts[0] && new_parts[1] == current_parts[1] && new_parts[2] > current_parts[2])
+          'Upgrading'
+        elsif new_parts[0] < current_parts[0] ||
+              (new_parts[0] == current_parts[0] && new_parts[1] < current_parts[1]) ||
+              (new_parts[0] == current_parts[0] && new_parts[1] == current_parts[1] && new_parts[2] < current_parts[2])
+          'Downgrading'
+        else
+          'Switching'
+        end
+      end
+
+      def past_tense_action(action)
+        case action
+        when 'Upgrading'
+          'upgraded'
+        when 'Downgrading'
+          'downgraded'
+        when 'Switching'
+          'switched'
+        else
+          'updated'
+        end
+      end
+    end
+  end
+end

data/lib/stable/registry.rb

@@ -66,6 +66,21 @@ module Stable
     def self.remove_app_config(app_name)
       config_file = Stable::Paths.app_config_file(app_name)
       FileUtils.rm_f(config_file)
+
+      # Also remove from legacy apps.yml file for backward compatibility
+      remove_from_legacy_file(app_name)
+    end
+
+    def self.remove_from_legacy_file(app_name)
+      legacy_file = Stable::Paths.apps_file
+      return unless File.exist?(legacy_file)
+
+      data = YAML.load_file(legacy_file) || []
+      filtered_data = data.reject { |entry| entry.is_a?(Hash) && entry['name'] == app_name }
+
+      return unless filtered_data != data
+
+      File.write(legacy_file, filtered_data.to_yaml)
     end
 
     def self.parse_config_file(config_file)

data/lib/stable/services/app_registry.rb

@@ -74,12 +74,12 @@ module Stable
           data = YAML.load_file(legacy_file) || []
           idx = data.find_index { |app| app['name'] == name || app[:name] == name }
 
-          if idx
-            # Convert symbols to strings for YAML compatibility
-            legacy_format = updated_app.transform_keys(&:to_s)
-            data[idx] = legacy_format
-            File.write(legacy_file, data.to_yaml)
-          end
+          return unless idx
+
+          # Convert symbols to strings for YAML compatibility
+          legacy_format = updated_app.transform_keys(&:to_s)
+          data[idx] = legacy_format
+          File.write(legacy_file, data.to_yaml)
         end
 
         def mark_stopped(name)

data/lib/stable/services/app_starter.rb

@@ -100,9 +100,7 @@ module Stable
         return false unless app
 
         # First check if we have PID info and if the process is alive
-        if app[:pid] && app[:started_at]
-          return ProcessManager.pid_alive?(app[:pid])
-        end
+        return ProcessManager.pid_alive?(app[:pid]) if app[:pid] && app[:started_at]
 
         # Fallback to port checking if no PID info available
         return false unless app[:port]

data/lib/stable/services/caddy_manager.rb

@@ -16,7 +16,7 @@ module Stable
           content = remove_domain_block(content, domain)
 
           atomic_write(caddyfile, content)
-          system("caddy fmt --overwrite #{caddyfile}")
+          system("caddy fmt --overwrite #{caddyfile}") unless ENV['STABLE_TEST_MODE']
 
           reload_if_running
         end
@@ -38,12 +38,14 @@ module Stable
           content << build_block(domain, port, skip_ssl: skip_ssl)
 
           atomic_write(caddyfile, content)
-          system("caddy fmt --overwrite #{caddyfile}")
+          system("caddy fmt --overwrite #{caddyfile}") unless ENV['STABLE_TEST_MODE']
 
           ensure_running!
         end
 
         def reload
+          return if ENV['STABLE_TEST_MODE']
+
           if system('which caddy > /dev/null')
             pid = Process.spawn("caddy reload --config #{caddyfile}")
             Process.detach(pid.to_i)
@@ -53,6 +55,8 @@ module Stable
         end
 
         def ensure_running!
+          return if ENV['STABLE_TEST_MODE']
+
           if running?
             reload
           else
@@ -81,6 +85,8 @@ module Stable
 
           return if valid_pem?(cert_path) && valid_pem?(key_path)
 
+          return if ENV['STABLE_TEST_MODE'] # Skip cert generation in tests
+
           raise 'mkcert not installed' unless system('which mkcert > /dev/null')
 
           System::Shell.run(

data/lib/stable/services/process_manager.rb

@@ -52,7 +52,11 @@ module Stable
         if pids.empty?
           puts "No app running on port #{app[:port]}"
         else
-          pids.each { |pid| Process.kill('TERM', pid.to_i) rescue nil }
+          pids.each do |pid|
+            Process.kill('TERM', pid.to_i)
+          rescue StandardError
+            nil
+          end
           puts "Stopped #{app[:name]} on port #{app[:port]}"
         end
 
@@ -89,9 +93,7 @@ module Stable
         apps.each do |app|
           next unless app[:started_at] && app[:pid]
 
-          unless pid_alive?(app[:pid])
-            AppRegistry.update(app[:name], started_at: nil, pid: nil)
-          end
+          AppRegistry.update(app[:name], started_at: nil, pid: nil) unless pid_alive?(app[:pid])
         end
       end
 

data/lib/stable/services/setup_runner.rb

@@ -11,6 +11,8 @@ module Stable
         ensure_apps_registry
         ensure_caddyfile
         # start or ensure caddy is running like original CLI
+        return if ENV['STABLE_TEST_MODE']
+
         Stable::Services::CaddyManager.ensure_running!
         puts "Caddy home initialized at #{Stable::Paths.root}"
         self.class.ensure_dependencies!
@@ -44,6 +46,8 @@ module Stable
       end
 
       def ensure_dependencies!
+        return if ENV['STABLE_TEST_MODE']
+
         platform = Stable::Utils::Platform.current
 
         unless Stable::Utils::PackageManager.available?

data/lib/stable/utils/platform.rb

@@ -68,6 +68,7 @@ module Stable
             # Use lsof to find PIDs listening on the port
             output = `lsof -i tcp:#{port} -sTCP:LISTEN -t 2>/dev/null`.strip
             return [] if output.empty?
+
             output.split("\n").map(&:to_i)
           when :windows
             # On Windows, this is more complex. For now, return empty array

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stable-cli-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.3
 platform: ruby
 authors:
 - Danny Simfukwe
@@ -37,6 +37,7 @@ files:
 - lib/stable.rb
 - lib/stable/bootstrap.rb
 - lib/stable/cli.rb
+- lib/stable/commands/destroy.rb
 - lib/stable/commands/doctor.rb
 - lib/stable/commands/list.rb
 - lib/stable/commands/new.rb
@@ -45,6 +46,7 @@ files:
 - lib/stable/commands/setup.rb
 - lib/stable/commands/start.rb
 - lib/stable/commands/stop.rb
+- lib/stable/commands/upgrade_ruby.rb
 - lib/stable/config/paths.rb
 - lib/stable/db_manager.rb
 - lib/stable/paths.rb
@@ -91,5 +93,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.7
 specification_version: 4
-summary: CLI tool to manage local Rails apps with automatic Caddy and HTTPS setup
+summary: Zero-config CLI tool to manage local Rails apps with automatic Caddy and
+  HTTPS setup
 test_files: []