stable-cli-rails 0.7.12 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f092ba86af858aef49a2de7704a7039e3f25accafaf9028254469e9621c754ea
-  data.tar.gz: 4ab71b60ae850c74508c790cf0fce5b14c2d12e0c8f2ec793a6b5e5234a95529
+  metadata.gz: ab8c647151029030baf0e96737f45f20cc6b067b952b032b98eac46e5e14e158
+  data.tar.gz: 5db558cabc869e1f6d6684d26b1d7b08178679194d09ebdbbd42aa67d828aee7
 SHA512:
-  metadata.gz: 830108d826c9a63cdbaabf2c539b083795d7cf2772e1d8cea0c91d39dcefcaf06e792e1865793d7c7ab1da428b810228a36bbba34038555bcf20aefe03d2c295
-  data.tar.gz: acdf43e4787cf9115eb29b4900f670cb9e2ce0a0fed29ba3f251cf40f00948897a3ed1c1edff3109053031c3ed6d238e4632d28f681fc591548635f9f03951ac
+  metadata.gz: fe68968ac73be6725262a224ceda502eaee576c2aa3a8822a2742577e9f5d6fc05f1c3092c6f7f1c0f011218aaa851949863e3473e8ea95de9e6fd91b94f31dc
+  data.tar.gz: e333ac1da62ceb50a7a77ec83d1c145900f90b8888249c4307102bc1dfb0e3661e0bf97c1efe5a33be27b1aa409e639278ca91643989c3c2c0954d763c665533

data/lib/stable/bootstrap.rb

@@ -3,6 +3,7 @@
 require 'fileutils'
 
 module Stable
+  # Bootstrap utilities for setting up Stable environment
   module Bootstrap
     def self.run!
       FileUtils.mkdir_p(Paths.root)

data/lib/stable/cli.rb

@@ -9,12 +9,12 @@ require_relative 'scanner'
 require_relative 'registry'
 
 module Stable
+  # Main CLI class for the Stable command-line interface
   class CLI < Thor
     def initialize(*)
       super
       Stable::Bootstrap.run!
       Services::SetupRunner.ensure_dependencies!
-      dedupe_registry!
     end
 
     def self.exit_on_failure?
@@ -158,9 +158,5 @@ module Stable
     def port_in_use?(port)
       system("lsof -i tcp:#{port} > /dev/null 2>&1")
     end
-
-    def dedupe_registry!
-      Services::AppRegistry.dedupe
-    end
   end
 end

data/lib/stable/commands/doctor.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Doctor command - checks system health and dependencies
     class Doctor
       def call
         puts 'Running Stable health checks...'

data/lib/stable/commands/list.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # List command - displays all registered applications
     class List
       def call
         apps = Services::AppRegistry.all
@@ -34,12 +35,12 @@ module Stable
           end
 
         format(
-          '%-18s %-26s %-8s %-10s %-10s',
-          app[:name],
-          app[:domain],
-          app[:port],
-          app[:ruby],
-          status
+          '%<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
     end

data/lib/stable/commands/new.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # New command - creates a new Rails application
     class New
       def initialize(name, options)
         @name = name

data/lib/stable/commands/remove.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Remove command - removes a Rails application
     class Remove
       def initialize(name)
         @name = name

data/lib/stable/commands/restart.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Restart command - restarts a Rails application
     class Restart
       def initialize(name)
         @name = name

data/lib/stable/commands/setup.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Setup command - initializes Stable environment
     class Setup
       def call
         Services::SetupRunner.new.call

data/lib/stable/commands/start.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Start command - starts a Rails application
     class Start
       def initialize(name)
         @name = name

data/lib/stable/commands/stop.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Commands
+    # Stop command - stops a Rails application
     class Stop
       def initialize(name)
         @name = name

data/lib/stable/db_manager.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Stable
+  # Database management utilities for Rails applications
   class DBManager
     attr_reader :name, :adapter
 
@@ -101,16 +102,30 @@ module Stable
       )) or abort('Failed to repair MySQL root authentication')
     end
 
-    # Detect MySQL socket on macOS / Linux
+    # Detect MySQL socket on macOS / Linux / Windows
     def mysql_socket
-      paths = [
-        '/opt/homebrew/var/mysql/mysql.sock', # Homebrew macOS
-        '/tmp/mysql.sock',                    # Default
-        '/var/run/mysqld/mysqld.sock' # Linux default
-      ]
+      platform = RUBY_PLATFORM
+
+      paths = case platform
+              when /darwin/ # macOS
+                [
+                  '/opt/homebrew/var/mysql/mysql.sock', # Homebrew macOS
+                  '/tmp/mysql.sock'                     # Fallback
+                ]
+              when /linux/
+                [
+                  '/var/run/mysqld/mysqld.sock', # Linux default
+                  '/tmp/mysql.sock' # Fallback
+                ]
+              when /mingw|mswin|win32/ # Windows
+                # Windows typically uses TCP connections, not sockets
+                return nil
+              else
+                ['/tmp/mysql.sock'] # Generic fallback
+              end
 
       paths.each { |p| return p if File.exist?(p) }
-      abort 'MySQL socket not found. Is MySQL running?'
+      abort 'MySQL socket not found. Is MySQL running? (On Windows, ensure MySQL is configured for TCP connections)'
     end
 
     # Default Rails DB user

data/lib/stable/paths.rb

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
 module Stable
+  # Path utilities for Stable configuration and data directories
   module Paths
     def self.root
-      File.expand_path('~/StableCaddy')
+      ENV['STABLE_TEST_ROOT'] || File.expand_path('~/StableCaddy')
     end
 
     def self.caddy_dir
@@ -21,5 +22,13 @@ module Stable
     def self.apps_file
       File.join(root, 'apps.yml')
     end
+
+    def self.projects_dir
+      File.join(root, 'projects')
+    end
+
+    def self.app_config_file(app_name)
+      File.join(projects_dir, app_name, "#{app_name}.yml")
+    end
   end
 end

data/lib/stable/registry.rb

@@ -4,17 +4,39 @@ require 'yaml'
 require 'fileutils'
 
 module Stable
+  # Application registry for managing Rails app configurations
   class Registry
-    def self.file_path
-      Stable::Paths.apps_file
-    end
+    def self.apps
+      apps = []
+
+      # Read legacy apps.yml file for backward compatibility
+      legacy_file = Stable::Paths.apps_file
+      if File.exist?(legacy_file)
+        legacy_apps = load_legacy_apps(legacy_file)
+        apps.concat(legacy_apps)
+      end
+
+      # Read individual app config files from projects directory
+      projects_dir = Stable::Paths.projects_dir
+      if Dir.exist?(projects_dir)
+        Dir.glob(File.join(projects_dir, '*/')).each do |app_dir|
+          app_name = File.basename(app_dir)
+          config_file = Stable::Paths.app_config_file(app_name)
+
+          next unless File.exist?(config_file)
 
-    def self.save(apps)
-      FileUtils.mkdir_p(Stable.root)
-      File.write(file_path, apps.to_yaml)
+          # Skip if we already have this app from legacy file
+          next if apps.any? { |app| app[:name] == app_name }
+
+          app_config = load_app_config(app_name)
+          apps << app_config if app_config
+        end
+      end
+
+      apps
     end
 
-    def self.apps
+    def self.load_legacy_apps(file_path)
       return [] unless File.exist?(file_path)
 
       data = YAML.load_file(file_path) || []
@@ -27,5 +49,33 @@ module Stable
         end
       end
     end
+
+    def self.save_app_config(app_name, config)
+      config_file = Stable::Paths.app_config_file(app_name)
+      FileUtils.mkdir_p(File.dirname(config_file))
+      File.write(config_file, config.to_yaml)
+    end
+
+    def self.load_app_config(app_name)
+      config_file = Stable::Paths.app_config_file(app_name)
+      return nil unless File.exist?(config_file)
+
+      parse_config_file(config_file)
+    end
+
+    def self.remove_app_config(app_name)
+      config_file = Stable::Paths.app_config_file(app_name)
+      FileUtils.rm_f(config_file)
+    end
+
+    def self.parse_config_file(config_file)
+      data = YAML.load_file(config_file)
+      return nil unless data.is_a?(Hash)
+
+      data.each_with_object({}) do |(k, v), memo|
+        key = k.is_a?(String) ? k.to_sym : k
+        memo[key] = v
+      end
+    end
   end
 end

data/lib/stable/scanner.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Stable
+  # Scanner utility for application discovery and management
   class Scanner
     def self.run
       Registry.save([])

data/lib/stable/services/app_creator.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for creating new Rails applications
     class AppCreator
       def initialize(name, options)
         @name = name
@@ -11,17 +12,19 @@ module Stable
       def call
         ruby = @options[:ruby] || RUBY_VERSION
         port = @options[:port] || next_free_port
-        app_path = File.expand_path(@name)
+        app_path = File.join(Stable::Paths.projects_dir, @name)
         domain = "#{@name}.test"
 
+        # --- Check if app already exists ---
+        config_file = Stable::Paths.app_config_file(@name)
+        abort "App '#{@name}' already exists" if File.exist?(config_file)
+
         # --- Register app in registry ---
         Services::AppRegistry.add(
           name: @name, path: app_path, domain: domain, port: port,
           ruby: ruby, started_at: nil, pid: nil
         )
 
-        abort "Folder already exists: #{app_path}" if File.exist?(app_path)
-
         # --- Ensure Ruby version & RVM ---
         Ruby.ensure_version(ruby)
         Ruby.ensure_rvm!
@@ -45,11 +48,9 @@ module Stable
 
         # --- Create Rails app ---
         puts "Creating Rails app #{@name} (Ruby #{ruby})..."
-        System::Shell.run("bash -lc '#{rvm_cmd} rails new #{app_path} \
-                              --skip-importmap  \
-                              --skip-hotwire  \
-                              --skip-javascript  \
-                              --skip-solid'")
+        rails_cmd = "#{rvm_cmd} rails new #{app_path} " \
+                    '--skip-importmap --skip-hotwire --skip-javascript --skip-solid'
+        System::Shell.run("bash -lc '#{rails_cmd}'")
 
         # --- Write ruby version/gemset ---
         Dir.chdir(app_path) do
@@ -82,7 +83,8 @@ module Stable
         System::Shell.run(rvm_run('bundle install --jobs=4 --retry=3', chdir: app_path))
         System::Shell.run(rvm_run('bundle exec rails db:prepare', chdir: app_path))
 
-        rails_version = `bash -lc 'cd #{app_path} && #{rvm_cmd} bundle exec rails runner "puts Rails.version"'`.strip.to_f
+        rails_check = "cd #{app_path} && #{rvm_cmd} bundle exec rails runner \"puts Rails.version\""
+        rails_version = `bash -lc '#{rails_check}'`.strip.to_f
 
         begin
           rails_ver = Gem::Version.new(rails_version)

data/lib/stable/services/app_registry.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Application registry management service
     class AppRegistry
       class << self
         def all
@@ -42,32 +43,19 @@ module Stable
         end
 
         def add(app)
-          apps = Stable::Registry.apps
-          apps.reject! { |a| a[:name] == app[:name] }
-          apps << app
-          Stable::Registry.save(apps)
-        end
-
-        # Remove duplicate app entries (by name) and persist the canonical list
-        def dedupe
-          apps = Stable::Registry.apps
-          apps.uniq! { |a| a[:name] }
-          Stable::Registry.save(apps)
-          apps
+          Stable::Registry.save_app_config(app[:name], app)
         end
 
         def remove(name)
-          apps = Stable::Registry.apps.reject { |a| a[:name] == name }
-          Stable::Registry.save(apps)
+          Stable::Registry.remove_app_config(name)
         end
 
         def update(name, attrs)
-          apps = Stable::Registry.apps
-          idx = apps.index { |a| a[:name] == name }
-          return unless idx
+          app = find(name)
+          return unless app
 
-          apps[idx] = apps[idx].merge(attrs)
-          Stable::Registry.save(apps)
+          updated_app = app.merge(attrs)
+          Stable::Registry.save_app_config(name, updated_app)
         end
 
         def mark_stopped(name)

data/lib/stable/services/app_remover.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for removing Rails applications
     class AppRemover
       def initialize(name)
         @name = name

data/lib/stable/services/app_restarter.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for restarting Rails applications
     class AppRestarter
       def initialize(name)
         @name = name

data/lib/stable/services/app_starter.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for starting Rails applications
     class AppStarter
       def initialize(name)
         @name = name

data/lib/stable/services/app_stopper.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for stopping Rails applications
     class AppStopper
       def initialize(name)
         @app = AppRegistry.fetch(name)

data/lib/stable/services/caddy_manager.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for managing Caddy web server configuration
     class CaddyManager
       class << self
         def caddyfile

data/lib/stable/services/database/base.rb

@@ -3,6 +3,7 @@
 module Stable
   module Services
     module Database
+      # Base class for database management services
       class Base
         def initialize(app_name:, app_path:, ruby:)
           @app_name = app_name

data/lib/stable/services/database/mysql.rb

@@ -3,6 +3,7 @@
 module Stable
   module Services
     module Database
+      # MySQL database management service
       class MySQL < Base
         def setup
           creds = Stable::Utils::Prompts.mysql_root_credentials

data/lib/stable/services/database/postgres.rb

@@ -3,6 +3,7 @@
 module Stable
   module Services
     module Database
+      # PostgreSQL database management service
       class Postgres < Base
         def setup
           System::Shell.run("createdb #{@database_name}")

data/lib/stable/services/dependency_checker.rb

@@ -1,23 +1,33 @@
 # frozen_string_literal: true
 
+require_relative '../utils/package_manager'
+
 module Stable
   module Services
+    # Service for checking system dependencies and health
     class DependencyChecker
       def run
-        [
-          check('Homebrew', 'brew'),
+        platform = Stable::Utils::Platform.current
+        package_manager_name = Stable::Utils::PackageManager.name
+
+        checks = [
+          check(package_manager_name, package_manager_command(platform)),
           check('Caddy', 'caddy'),
           check('mkcert', 'mkcert'),
-          check('RVM', 'rvm'),
+          check_ruby_manager,
           check_caddy_running,
           check_certs_dir,
           check_apps_registry
         ]
+
+        checks.compact
       end
 
       private
 
       def check(name, command)
+        return nil if command.nil? # Skip checks that don't apply to this platform
+
         ok = system("which #{command} > /dev/null 2>&1")
         {
           name: name,
@@ -26,8 +36,47 @@ module Stable
         }
       end
 
+      def package_manager_command(platform)
+        case platform
+        when :macos
+          'brew'
+        when :linux
+          case Stable::Utils::Platform.package_manager
+          when :apt
+            'apt'
+          when :yum
+            'yum'
+          when :pacman
+            'pacman'
+          end
+        when :windows
+          nil # No package manager check for Windows
+        end
+      end
+
+      def check_ruby_manager
+        managers = [%w[rvm RVM], %w[rbenv rbenv], %w[chruby chruby]]
+
+        manager = managers.find do |cmd, _name|
+          system("which #{cmd} > /dev/null 2>&1")
+        end
+
+        if manager
+          { name: manager[1], ok: true, message: nil }
+        else
+          { name: 'Ruby version manager', ok: false, message: 'No Ruby version manager found (RVM, rbenv, or chruby)' }
+        end
+      end
+
       def check_caddy_running
-        ok = system('pgrep caddy > /dev/null 2>&1')
+        platform = Stable::Utils::Platform.current
+        cmd = if platform == :windows
+                'tasklist /FI "IMAGENAME eq caddy.exe" 2>NUL | find /I "caddy.exe" >NUL'
+              else
+                'pgrep caddy > /dev/null 2>&1'
+              end
+
+        ok = system(cmd)
         {
           name: 'Caddy running',
           ok: ok,
@@ -36,7 +85,7 @@ module Stable
       end
 
       def check_certs_dir
-        path = File.expand_path('~/StableCaddy/certs')
+        path = Stable::Paths.certs_dir
         ok = Dir.exist?(path)
         {
           name: 'Certificates directory',
@@ -46,12 +95,12 @@ module Stable
       end
 
       def check_apps_registry
-        path = File.expand_path('~/StableCaddy/apps.yml')
-        ok = File.exist?(path)
+        path = Stable::Paths.projects_dir
+        ok = Dir.exist?(path)
         {
-          name: 'Apps registry',
+          name: 'Projects directory',
           ok: ok,
-          message: ok ? nil : 'Missing apps registry. Run `stable setup`'
+          message: ok ? nil : 'Missing projects directory. Run `stable setup`'
         }
       end
     end

data/lib/stable/services/hosts_manager.rb

@@ -1,29 +1,40 @@
 # frozen_string_literal: true
 
+require_relative '../utils/platform'
+
 module Stable
   module Services
+    # Service for managing hosts file entries
     class HostsManager
-      HOSTS_FILE = '/etc/hosts'
+      def self.hosts_file
+        Stable::Utils::Platform.hosts_file
+      end
 
       def self.remove(domain)
-        lines = File.read(HOSTS_FILE).lines
+        hosts_file = hosts_file()
+        lines = File.read(hosts_file).lines
         filtered = lines.reject { |l| l.include?(domain) }
 
         return if lines == filtered
 
-        File.write('/tmp/hosts', filtered.join)
-        system("sudo mv /tmp/hosts #{HOSTS_FILE}")
+        if Process.uid.zero?
+          File.write(hosts_file, filtered.join)
+        else
+          File.write('/tmp/hosts', filtered.join)
+          system("sudo mv /tmp/hosts #{hosts_file}")
+        end
       end
 
       def self.add(domain)
+        hosts_file = hosts_file()
         entry = "127.0.0.1\t#{domain}\n"
-        hosts = File.read(HOSTS_FILE)
+        hosts = File.read(hosts_file)
         return if hosts.include?(domain)
 
         if Process.uid.zero?
-          File.open(HOSTS_FILE, 'a') { |f| f.puts entry }
+          File.open(hosts_file, 'a') { |f| f.puts entry }
         else
-          system(%(echo "#{entry}" | sudo tee -a #{HOSTS_FILE} > /dev/null))
+          system(%(echo "#{entry}" | sudo tee -a #{hosts_file} > /dev/null))
         end
       end
     end

data/lib/stable/services/process_manager.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for managing application processes
     class ProcessManager
       def self.start(target)
         app = target.is_a?(String) ? AppRegistry.fetch(target) : target

data/lib/stable/services/ruby.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Ruby version management utilities
     module Ruby
       def self.ensure_version(version)
         return if version.nil? || version.to_s.strip.empty?

data/lib/stable/services/setup_runner.rb

@@ -1,7 +1,10 @@
 # frozen_string_literal: true
 
+require_relative '../utils/package_manager'
+
 module Stable
   module Services
+    # Service for setting up the Stable environment and dependencies
     class SetupRunner
       def call
         ensure_directories
@@ -25,8 +28,8 @@ module Stable
       end
 
       def ensure_apps_registry
-        path = Stable::Paths.apps_file
-        File.write(path, {}.to_yaml) unless File.exist?(path)
+        path = Stable::Paths.projects_dir
+        FileUtils.mkdir_p(path)
       end
 
       def ensure_caddyfile
@@ -41,42 +44,133 @@ module Stable
       end
 
       def ensure_dependencies!
-        unless system('which brew > /dev/null')
-          puts 'Homebrew is required. Install it first: https://brew.sh'
+        platform = Stable::Utils::Platform.current
+
+        unless Stable::Utils::PackageManager.available?
+          puts "#{Stable::Utils::PackageManager.name} package manager is required."
+          show_platform_installation_instructions(platform)
           exit 1
         end
 
         # --- Install Caddy ---
-        unless system('which caddy > /dev/null')
+        unless system('which caddy > /dev/null 2>&1')
           puts 'Installing Caddy...'
-          system('brew install caddy')
+          install_package('caddy')
         end
 
         # --- Install mkcert ---
-        unless system('which mkcert > /dev/null')
+        unless system('which mkcert > /dev/null 2>&1')
           puts 'Installing mkcert...'
-          system('brew install mkcert nss')
+          install_mkcert(platform)
         end
 
-        # Always ensure mkcert CA is installed
-        system('mkcert -install')
+        # Always ensure mkcert CA is installed (skip on Windows for now)
+        unless platform == :windows
+          begin
+            system('mkcert -install')
+          rescue StandardError
+            nil
+          end
+        end
 
         # --- Install PostgreSQL ---
-        unless system('which psql > /dev/null')
+        unless system('which psql > /dev/null 2>&1')
           puts 'Installing PostgreSQL...'
-          system('brew install postgresql')
-          system('brew services start postgresql')
+          install_postgres(platform)
         end
 
         # --- Install MySQL ---
-        unless system('which mysql > /dev/null')
+        unless system('which mysql > /dev/null 2>&1')
           puts 'Installing MySQL...'
-          system('brew install mysql')
-          system('brew services start mysql')
+          install_mysql(platform)
         end
 
         puts '✅ All dependencies are installed and running.'
       end
+
+      def install_package(package)
+        cmd = Stable::Utils::PackageManager.install_command(package)
+        system(cmd) or abort("Failed to install #{package}")
+      end
+
+      def install_mkcert(platform)
+        case platform
+        when :macos
+          install_package('mkcert nss')
+        when :linux
+          case Stable::Utils::Platform.package_manager
+          when :apt
+            system('sudo apt update && sudo apt install -y wget')
+            system('wget -O mkcert https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-linux-amd64')
+            system('chmod +x mkcert && sudo mv mkcert /usr/local/bin/')
+          when :yum
+            system('wget -O mkcert https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-linux-amd64')
+            system('chmod +x mkcert && sudo mv mkcert /usr/local/bin/')
+          end
+        when :windows
+          puts 'Please install mkcert manually on Windows: https://github.com/FiloSottile/mkcert'
+        end
+      end
+
+      def install_postgres(platform)
+        case platform
+        when :macos
+          install_package('postgresql')
+          begin
+            system('brew services start postgresql')
+          rescue StandardError
+            nil
+          end
+        when :linux
+          install_package('postgresql postgresql-contrib')
+          start_service('postgresql')
+        when :windows
+          puts 'Please install PostgreSQL manually on Windows from: https://www.postgresql.org/download/windows/'
+        end
+      end
+
+      def install_mysql(platform)
+        case platform
+        when :macos
+          install_package('mysql')
+          begin
+            system('brew services start mysql')
+          rescue StandardError
+            nil
+          end
+        when :linux
+          install_package('mysql-server')
+          start_service('mysql')
+        when :windows
+          puts 'Please install MySQL manually on Windows from: https://dev.mysql.com/downloads/mysql/'
+        end
+      end
+
+      def start_service(service)
+        cmd = Stable::Utils::PackageManager.service_start_command(service)
+        begin
+          system(cmd)
+        rescue StandardError
+          nil
+        end
+      end
+
+      def show_platform_installation_instructions(platform)
+        case platform
+        when :macos
+          puts 'Homebrew is required. Install it first: https://brew.sh'
+        when :linux
+          puts 'Please install a package manager:'
+          puts '  Ubuntu/Debian: sudo apt update && sudo apt install -y build-essential'
+          puts '  CentOS/RHEL: sudo yum install -y gcc gcc-c++ make'
+          puts '  Arch: sudo pacman -S base-devel'
+        when :windows
+          puts 'Please install dependencies manually on Windows.'
+          puts 'Required: Caddy, mkcert, PostgreSQL, MySQL'
+        else
+          puts 'Unsupported platform detected.'
+        end
+      end
     end
   end
 end

data/lib/stable/system/shell.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module System
+    # Shell command execution utilities
     class Shell
       def self.run(cmd)
         puts "→ #{cmd}"

data/lib/stable/utils/package_manager.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative 'platform'
+
+module Stable
+  module Utils
+    # Cross-platform package manager utilities
+    module PackageManager
+      class << self
+        def install_command(package)
+          case Platform.package_manager
+          when :brew
+            "brew install #{package}"
+          when :apt
+            "sudo apt update && sudo apt install -y #{package}"
+          when :yum
+            "sudo yum install -y #{package}"
+          when :pacman
+            "sudo pacman -S --noconfirm #{package}"
+          else
+            raise "Unsupported package manager on #{Platform.current} platform"
+          end
+        end
+
+        def service_start_command(service)
+          case Platform.current
+          when :macos
+            "brew services start #{service}"
+          when :linux
+            "sudo systemctl start #{service}" if systemctl_available?
+          else
+            raise "Service management not supported on #{Platform.current} platform"
+          end
+        end
+
+        def available?
+          pm = Platform.package_manager
+          if pm == :yum
+            system('which yum > /dev/null 2>&1') || system('which dnf > /dev/null 2>&1')
+          else
+            cmd = package_manager_commands.dig(pm, 0)
+            cmd ? system("#{cmd} > /dev/null 2>&1") : false
+          end
+        end
+
+        def name
+          pm = Platform.package_manager
+          package_manager_commands[pm]&.last || 'Unknown'
+        end
+
+        private
+
+        def package_manager_commands
+          {
+            brew: ['which brew', 'Homebrew'],
+            apt: ['which apt', 'APT'],
+            yum: ['which yum', 'YUM/DNF'],
+            pacman: ['which pacman', 'Pacman']
+          }
+        end
+
+        def systemctl_available?
+          system('which systemctl > /dev/null 2>&1')
+        end
+      end
+    end
+  end
+end

data/lib/stable/utils/platform.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Stable
+  module Utils
+    # Platform detection utilities for cross-platform compatibility
+    module Platform
+      class << self
+        def macos?
+          !!(RUBY_PLATFORM =~ /darwin/)
+        end
+
+        def linux?
+          !!(RUBY_PLATFORM =~ /linux/)
+        end
+
+        def windows?
+          !!(RUBY_PLATFORM =~ /mingw|mswin|win32/)
+        end
+
+        def unix?
+          !windows?
+        end
+
+        def current
+          return :macos if macos?
+          return :linux if linux?
+          return :windows if windows?
+
+          :unknown
+        end
+
+        def package_manager
+          return :brew if macos?
+          return detect_linux_package_manager if linux?
+
+          :unknown
+        end
+
+        def hosts_file
+          return '/etc/hosts' if unix?
+          return 'C:\Windows\System32\drivers\etc\hosts' if windows?
+
+          '/etc/hosts' # fallback
+        end
+
+        def home_directory
+          return ENV.fetch('USERPROFILE', nil) if windows?
+
+          Dir.home
+        end
+
+        private
+
+        def detect_linux_package_manager
+          return :apt if apt_available?
+          return :yum if yum_available?
+          return :pacman if pacman_available?
+
+          :unknown
+        end
+
+        def apt_available?
+          system('which apt > /dev/null 2>&1')
+        end
+
+        def yum_available?
+          system('which yum > /dev/null 2>&1') || system('which dnf > /dev/null 2>&1')
+        end
+
+        def pacman_available?
+          system('which pacman > /dev/null 2>&1')
+        end
+      end
+    end
+  end
+end

data/lib/stable/utils/prompts.rb

@@ -4,6 +4,7 @@ require 'io/console'
 
 module Stable
   module Utils
+    # User interaction utilities for prompting input
     class Prompts
       def self.mysql_root_credentials
         print 'Enter MySQL root username (default: root): '

data/lib/stable/validators/app_name.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Validators
+    # Validates and normalizes Rails application names
     class AppName
       VALID_PATTERN = /\A[a-z0-9]+(-[a-z0-9]+)*\z/
       MAX_LENGTH = 63

data/lib/stable.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# Main Stable CLI module - provides cross-platform Rails application management
 module Stable
   def self.root
     Paths.root

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stable-cli-rails
 version: !ruby/object:Gem::Version
-  version: 0.7.12
+  version: 0.8.0
 platform: ruby
 authors:
 - Danny Simfukwe
@@ -23,36 +23,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.2.2
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-description: 'Stable CLI: manage local Rails apps with automatic Caddy, HTTPS, and
-  simple start/stop commands.'
+description: Stable is a cross-platform CLI tool to manage local Rails applications
+  with automatic Caddy setup, local trusted HTTPS certificates, and easy start/stop
+  functionality. Supports macOS, Linux, and Windows.
 email:
 - dannysimfukwe@gmail.com
 executables:
@@ -93,6 +66,8 @@ files:
 - lib/stable/services/ruby.rb
 - lib/stable/services/setup_runner.rb
 - lib/stable/system/shell.rb
+- lib/stable/utils/package_manager.rb
+- lib/stable/utils/platform.rb
 - lib/stable/utils/prompts.rb
 - lib/stable/validators/app_name.rb
 homepage: https://github.com/dannysimfukwe/stable-rails