vagrant-eryph 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9decd72160b533c3c04d1c06ab3e7d05e3c28b4415940c05af982ce66cbb2f8b
-  data.tar.gz: 914506e8dc13c6665743360f03c4b8ebcedd180bf73e0f2daed82b290c8d27f6
+  metadata.gz: 3d8510d9544d0730e1569249a684e99e925219f3e8c3076f9b3e1bb8535291ec
+  data.tar.gz: 2eb2c0b65b421828fd05c7341dee2c03f2c98bb9a9148992e09712b74288b22f
 SHA512:
-  metadata.gz: 02354e91939f344f23cef10df4d263fcb0612339288483e16579c160a3e4e9e11652ef26c13b5ff28dec8a39192cb185085294fb123539d5af52efa7954679c2
-  data.tar.gz: 17e138e16fd7b7eb09e750e41a98de186a6c8a39519c18c53b20e6bfef9283c5ebe8519a3a0be0be2eb8817af29dde47d287d0a764b6a1b611988a910023976e
+  metadata.gz: 29dac22ab524da0a07f269fd999ea9caaab10d0e6148b6550365ee24fccc512e07dc09398149c7788dd7a4f883208e89555f9bff59cc5225637f6ee4571eb97c
+  data.tar.gz: f359b334f4ec51030b57a875f1ee18c773928676f91bd6768aeb72accfbdf6685c7a8e6542342ad67791c915fc58c49a0edd563528791db6b9328ddc9ec48fa3

data/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.2] - 2025-09-18
+
+### Fixed
+- Reload operation failures due to missing action methods (#6)
+- E2E test cleanup issues leaving behind test catlets
+- Improved test catlet cleanup with comprehensive after-suite cleanup
+
+
+## [0.1.1] - 2025-09-17
+
+### Fixed
+- New created project is not detected correctly (#3)
+- Operation logging now shows log messages instead of only some tasks (#4)
+- Error handling improvements for project creation
+- Build pipeline fixes
+- README formatting and link corrections
+
+### Added
+- Standalone project commands
+- Unit tests for Eryph client functionality
+- Enhanced operation progress logging
+- Better error messages and localization
+
+### Changed
+- Improved project creation workflow
+- Enhanced error handling with better user feedback
+- Updated README with clearer documentation and examples
+- Simplified project creation commands
+
+## [0.1.0] - Initial Release
+
+### Added
+- Initial Vagrant provider for Eryph
+- Support for Linux and Windows catlets
+- Automatic SSH key generation and injection
+- Cloud-init (fodder) configuration support
+- Project-based resource organization
+- Cross-platform compatibility (Linux/Windows hosts)
+- Auto-configuration for common scenarios

data/README.md

@@ -1,34 +1,153 @@
-# Vagrant Eryph Provider
+# vagrant eryph Provider
 
-A Vagrant provider plugin for [Eryph](https://www.eryph.io/) that allows you to manage catlets using Eryph's compute API.
+This is a vagrant provider plugin for [eryph](https://www.eryph.io) that allows you to manage virtual machines as catlets, which are VMs built from specification files (catlets are pure declarative VM configurations).  
 
-## Features
+Eryph brings cloud-native features to local/on-premises development environments, such as storage management, virtual networks, and secure remote access. It is built on top of Hyper-V, but hides most of it. 
 
-- Full catlet lifecycle management (create, start, stop, destroy)
-- Automatic Vagrant user setup via cloud-init
-- Cross-platform support (Linux and Windows catlets)
-- SSH and WinRM communication support
-- Local-scoped credential discovery
-- Configurable cloud-init fodder merging
+## Why choose the eryph provider?
+
+- **Standard VMs work instantly** - Use any gene/template from eryph's genepool (https://genepool.eryph.io), Vagrant configuration is automatically injected via cloud-init.
+- **Project isolation with SDN** - Full software-defined networking with isolated projects, virtual networks, and proper routing
+- **API-based remote access** - Develop from anywhere: WSL, Linux, macOS clients can all connect to Windows eryph hosts
+- **Non-admin access** - Unlike Hyper-V provider, you don't need local admin rights
+
+**What Cloud-Native Features You Get:**
+- **Storage management** - Automatic creation/removal of disks and VM files
+- **Software-Defined Networking** - Create complex network topologies per project, not just basic VM networking
+- **Multi-platform development** - Windows eryph hosts serve WSL/Linux/macOS developers via REST API
+- **Team collaboration** - Share infrastructure with project-based access control and resource limits
+- **Hyper-V compatibility** - Familiar vagrant settings (cpus, memory, etc.) just work
+- **Template inheritance** - Use eryph genes system to merge configuration instead of building it into each vagrantfile.
+
+## Requirements
+
+- **Vagrant** 2.0 or later
+- **Ruby** >= 3.1.0
+- **eryph** - either:
+  - [eryph-zero](https://www.eryph.io/downloads/eryph-zero) >= 0.4.1 installed locally or remotely
+  - For client management: [PowerShell module](https://www.powershellgallery.com/packages/Eryph.ClientRuntime.Configuration) (works on Windows/Linux/macOS)
+
+See the [eryph documentation](https://www.eryph.io/docs) for installation and setup instructions.
 
 ## Installation
 
+Install the plugin using Vagrant's plugin system:
+
+```bash
+vagrant plugin install vagrant-eryph
+```
+
+Or install from a local gem file:
+
 ```bash
-gem install vagrant-eryph
+vagrant plugin install ./vagrant-eryph-*.gem
 ```
 
 ## Usage
 
+### Basic Linux Example
+
 ```ruby
 Vagrant.configure("2") do |config|
   config.vm.provider :eryph do |eryph|
-    eryph.project = "my-project"
-    eryph.parent = "dbosoft/ubuntu-22.04/latest"
-    eryph.auto_config = true  # Enable automatic Vagrant user setup
+    eryph.parent = "dbosoft/ubuntu-22.04"
   end
 end
 ```
 
+Run with:
+```bash
+vagrant up --provider=eryph
+```
+
+### Windows Example
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.provider :eryph do |eryph|
+    eryph.parent = "dbosoft/winsrv2022-standard"
+    eryph.enable_winrm = true
+    eryph.vagrant_password = "SecureP@ss123"
+    eryph.cpus = 4
+    eryph.memory = 4096
+  end
+
+  # Configure Windows communication
+  # eryph requires https by default
+  config.vm.communicator = "winrm"
+  config.winrm.username = "vagrant"
+  config.winrm.password = "SecureP@ss123"
+  config.winrm.port = 5986
+  config.winrm.transport = :ssl
+  config.winrm.ssl_peer_verification = false
+  config.winrm.basic_auth_only = true
+  config.vm.guest = :windows
+end
+```
+
+Run with:
+```bash
+vagrant up --provider=eryph
+```
+
+### Advanced Configuration Example
+
+Combining individual helpers with direct configuration and complex setups. The individual property helpers are intentionally compatible with most used Hyper-V provider settings for easy migration:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.provider :eryph do |eryph|
+    eryph.project = "development"
+
+    # Option 1: Use individual property helpers (mapped to catlet hash)
+    eryph.parent = "dbosoft/ubuntu-22.04"
+    eryph.cpus = 4
+    eryph.memory = 4096
+    eryph.maxmemory = 8192  # Enables dynamic memory
+    eryph.enable_virtualization_extensions = true
+
+    # Option 2: Or use direct catlet hash for complex scenarios
+    # eryph.catlet = {
+    #   parent: "dbosoft/ubuntu-22.04",
+    #   cpu: { count: 4 },
+    #   memory: { startup: 4096, maximum: 8192 },
+    #   capabilities: [
+    #     { name: "nested_virtualization" },
+    #     { name: "dynamic_memory" }
+    #   ]
+    # }
+
+    # Add additional drives using helper method
+    eryph.add_drive("data", size: 100, type: :vhd)
+    eryph.add_drive("logs", size: 50, type: :vhd)
+
+    # Add gene-based fodder for common setup tasks
+    eryph.add_fodder_gene("dbosoft", "development-tools",
+                          fodder_name: "dev-setup")
+
+    # Add custom cloud-config
+    eryph.cloud_config("app-config") do |config|
+      config["packages"] = ["nginx", "nodejs", "git"]
+      config["runcmd"] = ["systemctl enable nginx"]
+    end
+
+    # Set variables for use in fodder
+    eryph.set_variable("environment", "development")
+    eryph.set_variable("app_version", "latest")
+  end
+end
+```
+
+### Setting Default Provider
+
+To avoid specifying `--provider=eryph` every time:
+
+```bash
+export VAGRANT_DEFAULT_PROVIDER=eryph
+# or on Windows:
+set VAGRANT_DEFAULT_PROVIDER=eryph
+```
+
 ## Configuration
 
 ### Basic Settings
@@ -42,38 +161,206 @@ end
 - `vagrant_password` - Password for Windows vagrant user (default: "vagrant")
 - `ssh_key_injection` - SSH key injection method (:direct or :variable)
 
-### Resources
-- `cpus` - Number of CPUs
-- `memory` - Memory in MB
-- `drives` - Custom drives configuration
-- `networks` - Custom networks configuration
+### Catlet Configuration
+
+**Individual property helpers** (automatically mapped to catlet hash):
+- `cpus` - Number of CPUs (maps to `catlet[:cpu][:count]`)
+- `memory` - Memory in MB (maps to `catlet[:memory][:startup]`)
+- `maxmemory` - Maximum memory in MB (enables dynamic memory capability)
+- `parent` - Parent gene (maps to `catlet[:parent]`)
+- `vmname` - VM name (maps to `catlet[:name]`)
+- `hostname` - Network hostname (maps to `catlet[:hostname]`)
+- `enable_virtualization_extensions` - Enable nested virtualization
+- `enable_secure_boot` - Enable secure boot capability
+
+**Direct configuration:**
+- `catlet` - Direct catlet configuration hash (alternative to individual settings)
+
+**Helper methods for complex configurations:**
+```ruby
+# Add drives with type mapping
+add_drive("data", size: 100, type: :vhd)
+add_drive("shared", type: :shared_vhd, source: "my-shared-disk")
+
+# Add gene-based fodder
+add_fodder_gene("dbosoft", "base-setup", fodder_name: "setup", variables: [...])
+
+# Add cloud-config fodder
+cloud_config("my-setup") do |config|
+  config["packages"] = ["nginx", "git"]
+end
 
-### Cloud-init
-- `fodder` - Custom cloud-init configuration (merged with auto-generated config)
+# Add shell script fodder
+shell_script("post-install", "#!/bin/bash\necho 'Done'")
+
+# Manage capabilities
+enable_capability("nested_virtualization")
+disable_capability("secure_boot")
+
+# Set variables for fodder
+set_variable("app_name", "myapp")
+```
+
+### Automatic Cloud-Init Integration
+
+The plugin automatically generates cloud-init configuration:
+- **Linux**: Creates vagrant user with sudo access, SSH keys, and password authentication
+- **Windows**: Creates vagrant user in Administrators group with password and SSH keys
+- **Merging**: Auto-generated fodder is intelligently merged with user-provided fodder
+- **Compatibility**: Converts Vagrant cloud-init configs to eryph fodder format
+
+**Fodder vs Cloud-Init relationship:**
+- eryph uses "fodder" (supports cloud-init, shell scripts, PowerShell, etc.)
+- Plugin auto-generates vagrant user setup as cloud-config fodder
+- User fodder configurations are merged with auto-generated ones
+- Duplicates are automatically handled using source/name keys
+
+For detailed catlet configuration options and specification format, see the [eryph Specification Files documentation](https://www.eryph.io/docs/refs/specification-files).
+
+### Client Configuration
+- `configuration_name` - eryph client configuration name (default: automatic discovery)
+- `client_id` - Specific client ID for authentication
+- `ssl_verify` - Enable/disable SSL certificate verification (default: false for localhost)
+- `ssl_ca_file` - Path to custom CA certificate file
+
+## Client Management
+
+The plugin uses eryph's client configuration system for authentication and connection management. Client configurations are managed through PowerShell commands and store connection details, credentials, and endpoints.
+
+### Configuration Discovery
+
+Eryph uses two main configuration types:
+1. **"zero" configuration** - For local eryph-zero instances (automatic endpoint discovery)
+2. **"default" configuration** - For remote eryph hosts (manually configured)
+
+The plugin automatically discovers configurations in this order:
+1. **Named configuration** (if `configuration_name` is specified)
+2. **"default" configuration** (for remote hosts)
+3. **"zero" configuration** (for local eryph-zero)
+4. **System client** (requires admin privileges)
+
+### Managing Client Configurations
+
+Use PowerShell commands to manage client configurations (works on Windows, Linux, and macOS):
+
+```powershell
+# Install the configuration module
+Install-Module Eryph.ClientRuntime.Configuration
+
+# List available configurations
+Get-EryphClientConfiguration
+
+# Create a client with compute permissions and add to default configuration
+New-EryphClient my-client `
+     -AllowedScopes compute:write `
+     -AddToConfiguration -AsDefault
+
+# For remote hosts, create default configuration manually
+New-EryphClientConfiguration -Name "default" -Endpoint "https://eryph.company.com"
+
+# Remove a configuration
+Remove-EryphClientConfiguration -Name "old-config"
+```
+
+### Vagrantfile Examples
+
+```ruby
+# Use automatic discovery (recommended for local development)
+config.vm.provider :eryph do |eryph|
+  eryph.parent = "dbosoft/ubuntu-22.04"
+  # No client config needed - uses automatic discovery
+end
+
+# Use specific named configuration
+config.vm.provider :eryph do |eryph|
+  eryph.parent = "dbosoft/ubuntu-22.04"
+  eryph.configuration_name = "default"
+end
+
+# Use specific client ID with custom SSL settings
+config.vm.provider :eryph do |eryph|
+  eryph.parent = "dbosoft/ubuntu-22.04"
+  eryph.configuration_name = "default"
+  eryph.client_id = "my-automation-client"
+  eryph.ssl_verify = true
+  eryph.ssl_ca_file = "/path/to/ca.crt"
+end
+```
+
+### Troubleshooting Authentication
+
+If you encounter authentication issues:
+
+1. **Check available configurations**: `Get-EryphClientConfiguration`
+2. **Check credentials**: `Get-EryphClientCredential -Name "your-config"`
+3. **Verify permissions**: Ensure the client has appropriate compute scopes
+4. **Check logs**: Use `vagrant up --debug` for detailed connection information
+
+For detailed client configuration and authentication setup, see the [eryph PowerShell documentation](https://www.eryph.io/docs/using-powershell#client-configuration).
 
 ## Project Management
 
-The plugin includes commands to manage Eryph projects:
+The plugin includes commands to manage eryph projects:
 
 ```bash
 # List projects
 vagrant eryph project list
 
 # Create project
-vagrant eryph project create my-project --description "My development project"
+vagrant eryph project create my-project
 
 # Manage project networks
 vagrant eryph network get my-project
 vagrant eryph network set my-project --file networks.yml
 ```
 
+
 ## Development
 
+### Setup
+
 ```bash
 bundle install
-bundle exec vagrant --help
+```
+
+### Building and Testing
+
+```bash
+# Build gem
+rake build
+
+# Install locally for testing
+rake install
+
+# Reinstall after changes
+rake reinstall
+
+# Run unit tests (fast)
+rake unit
+
+# Run E2E tests (requires eryph)
+rake e2e
+
+# Run all tests
+rake spec
+
+# Get detailed test information
+rake test_info
+```
+
+### Manual Installation
+
+```bash
+# Build gem manually
+gem build vagrant-eryph.gemspec
+
+# Install locally
+vagrant plugin install ./vagrant-eryph-*.gem
+
+# Uninstall
+vagrant plugin uninstall vagrant-eryph
 ```
 
 ## License
 
-MIT
+MIT

data/lib/vagrant-eryph/actions/connect_eryph.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative '../helpers/eryph_client'
+require_relative '../errors'
 
 module VagrantPlugins
   module Eryph
@@ -23,16 +24,9 @@ module VagrantPlugins
 
           @app.call(env)
         rescue ::Eryph::ClientRuntime::CredentialsNotFoundError => e
-          env[:ui].error("Eryph credentials not found: #{e.message}")
-          env[:ui].error('Please set up your Eryph configuration or check your .eryph directory')
-          raise Vagrant::Errors::VagrantError, e.message
+          raise Errors::CredentialsError, e.message
         rescue ::Eryph::ClientRuntime::TokenRequestError => e
-          env[:ui].error("Eryph authentication failed: #{e.message}")
-          env[:ui].error('Check your client credentials and network connectivity')
-          raise Vagrant::Errors::VagrantError, e.message
-        rescue StandardError => e
-          env[:ui].error("Failed to connect to Eryph: #{e.message}")
-          raise Vagrant::Errors::VagrantError, e.message
+          raise Errors::APIConnectionError, e.message
         end
       end
     end

data/lib/vagrant-eryph/actions/create_catlet.rb

@@ -41,9 +41,6 @@ module VagrantPlugins
           Provider.instance_variable_set(:@eryph_catlets, nil)
 
           @app.call(env)
-        rescue StandardError => e
-          ui.error("Failed to create catlet: #{e.message}")
-          raise e
         end
 
         private

data/lib/vagrant-eryph/actions/destroy_catlet.rb

@@ -23,9 +23,6 @@ module VagrantPlugins
           ui.info('Catlet destroyed successfully')
 
           @app.call(env)
-        rescue StandardError => e
-          ui.error("Failed to destroy catlet: #{e.message}")
-          raise e
         end
       end
     end

data/lib/vagrant-eryph/actions/is_state.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module VagrantPlugins
+  module Eryph
+    module Actions
+      class IsState
+        def initialize(app, env, state)
+          @app = app
+          @state = state.to_s.downcase
+        end
+
+        def call(env)
+          # Check if the catlet is in the specified state
+          catlet = Provider.eryph_catlet(env[:machine])
+          env[:result] = catlet && catlet.status&.downcase == @state
+          @app.call(env)
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-eryph/actions/prepare_cloud_init.rb

@@ -42,9 +42,6 @@ module VagrantPlugins
           env[:catlet_fodder] = fodder
 
           @app.call(env)
-        rescue StandardError => e
-          ui.error("Failed to prepare cloud-init configuration: #{e.message}")
-          raise e
         end
       end
     end

data/lib/vagrant-eryph/actions/start_catlet.rb

@@ -30,9 +30,6 @@ module VagrantPlugins
           Provider.instance_variable_set(:@eryph_catlets, nil)
 
           @app.call(env)
-        rescue StandardError => e
-          ui.error("Failed to start catlet: #{e.message}")
-          raise e
         end
       end
     end

data/lib/vagrant-eryph/actions/stop_catlet.rb

@@ -30,9 +30,6 @@ module VagrantPlugins
           Provider.instance_variable_set(:@eryph_catlets, nil)
 
           @app.call(env)
-        rescue StandardError => e
-          ui.error("Failed to stop catlet: #{e.message}")
-          raise e
         end
       end
     end

data/lib/vagrant-eryph/actions.rb

@@ -178,11 +178,12 @@ module VagrantPlugins
             end
 
             b2.use action_halt
-            b2.use Call, WaitForState, :stopped, 120 do |env2, b3|
+            b2.use Call, IsStopped do |env2, b3|
               if env2[:result]
-                b3.use action_up
+                b3.use action_start
               else
-                # TODO: we couldn't reach :stopped, what now?
+                # Catlet not stopped, continue anyway
+                b3.use action_start
               end
             end
           end
@@ -193,6 +194,7 @@ module VagrantPlugins
       action_root = Pathname.new(File.expand_path('actions', __dir__))
       autoload :ConnectEryph, action_root.join('connect_eryph')
       autoload :IsCreated, action_root.join('is_created')
+      autoload :IsState, action_root.join('is_state')
       autoload :IsStopped, action_root.join('is_stopped')
       autoload :MessageAlreadyCreated, action_root.join('message_already_created')
       autoload :MessageNotCreated, action_root.join('message_not_created')
@@ -204,7 +206,6 @@ module VagrantPlugins
       autoload :PrepareCloudInit, action_root.join('prepare_cloud_init')
       autoload :ReadSSHInfo, action_root.join('read_ssh_info')
       autoload :ReadState, action_root.join('read_state')
-      autoload :WaitForOperation, action_root.join('wait_for_operation')
     end
   end
 end

data/lib/vagrant-eryph/command.rb

@@ -3,6 +3,9 @@
 require 'optparse'
 require 'yaml'
 require 'json'
+require_relative 'config'
+require_relative 'helpers/eryph_client'
+require_relative 'errors'
 
 module VagrantPlugins
   module Eryph
@@ -54,6 +57,18 @@ module VagrantPlugins
       def initialize(argv, env)
         super
         @options = {}
+
+        # Parse global options from full argv first
+        global_parser = OptionParser.new do |o|
+          o.on('--configuration-name NAME', String) { |name| @options[:configuration_name] = name }
+          o.on('--client-id ID', String) { |id| @options[:client_id] = id }
+          o.on('--[no-]ssl-verify') { |verify| @options[:ssl_verify] = verify }
+          o.on('--ssl-ca-file FILE', String) { |file| @options[:ssl_ca_file] = file }
+        end
+
+        # Parse and remove global options, leaving subcommand and its args
+        remaining_args = global_parser.parse(argv.dup)
+
         @parser = OptionParser.new do |o|
           o.banner = 'Usage: vagrant eryph project <subcommand> [options]'
           o.separator ''
@@ -63,19 +78,14 @@ module VagrantPlugins
           o.separator '     remove     Remove a project'
           o.separator ''
           o.separator 'Global Options:'
-          
-          o.on('--configuration-name NAME', String, 'Eryph configuration name (default: auto-detect)') do |name|
-            @options[:configuration_name] = name
-          end
-          
-          o.on('--client-id ID', String, 'Eryph client ID') do |id|
-            @options[:client_id] = id
-          end
-          
+          o.separator '     --configuration-name NAME    Eryph configuration name (default: auto-detect)'
+          o.separator '     --client-id ID               Eryph client ID'
+          o.separator '     --[no-]ssl-verify            Enable/disable SSL certificate verification'
+          o.separator '     --ssl-ca-file FILE           Path to custom CA certificate file'
           o.separator ''
         end
 
-        @main_args, @sub_command, @sub_args = split_main_and_subcommand(argv)
+        @main_args, @sub_command, @sub_args = split_main_and_subcommand(remaining_args)
       end
 
       def execute
@@ -136,15 +146,10 @@ module VagrantPlugins
         project_name = argv[0]
         client = get_eryph_client
 
-        begin
-          @env.ui.info("Creating project: #{project_name}")
-          project = client.create_project(project_name)
-          @env.ui.info("Project '#{project.name}' created successfully (ID: #{project.id})")
-          0
-        rescue StandardError => e
-          @env.ui.error("Failed to create project: #{e.message}")
-          1
-        end
+        @env.ui.info("Creating project: #{project_name}")
+        project = client.create_project(project_name)
+        @env.ui.info("Project '#{project.name}' created successfully (ID: #{project.id})")
+        0
       end
 
       def execute_remove
@@ -177,59 +182,29 @@ module VagrantPlugins
         project_name = argv[0]
         client = get_eryph_client
 
-        begin
-          project = client.get_project(project_name)
-          unless project
-            @env.ui.error("Project '#{project_name}' not found")
-            return 1
-          end
-
-          unless @options[:force]
-            response = @env.ui.ask("Project '#{project.name}' (ID: #{project.id}) and all catlets will be deleted! Continue? (y/N)")
-            return 0 unless response.downcase.start_with?('y')
-          end
+        project = client.get_project(project_name)
+        unless project
+          raise Errors::ProjectNotFoundError, { project_name: project_name }
+        end
 
-          @env.ui.info("Removing project: #{project.name}")
-          delete_project(client, project.id)
-          @env.ui.info("Project '#{project.name}' removed successfully")
-          0
-        rescue StandardError => e
-          @env.ui.error("Failed to remove project: #{e.message}")
-          1
+        unless @options[:force]
+          response = @env.ui.ask("Project '#{project.name}' (ID: #{project.id}) and all catlets will be deleted! Continue? (y/N)")
+          return 0 unless response.downcase.start_with?('y')
         end
+
+        @env.ui.info("Removing project: #{project.name}")
+        delete_project(client, project.id)
+        @env.ui.info("Project '#{project.name}' removed successfully")
+        0
       end
 
       def get_eryph_client
-        # Try to get client from existing machines
-        @env.machine_names.each do |name|
-          machine = @env.machine(name, :eryph)
-          if machine.provider_config.is_a?(VagrantPlugins::Eryph::Config)
-            client = Helpers::EryphClient.new(machine)
-            
-            # Override client configuration if command line options are provided
-            if @options[:configuration_name] || @options[:client_id]
-              override_client_config(client)
-            end
-            
-            return client
-          end
-        end
-
-        # If no machines found, create a temporary config with command line options
+        # Always use standalone client for project management commands
         create_standalone_client
       end
 
       private
 
-      def override_client_config(client)
-        # Update the client's configuration with command line options
-        config = client.instance_variable_get(:@config)
-        config.configuration_name = @options[:configuration_name] if @options[:configuration_name]
-        config.client_id = @options[:client_id] if @options[:client_id]
-        
-        # Force recreation of the client with new config
-        client.instance_variable_set(:@client, nil)
-      end
 
       def create_standalone_client
         # Create a minimal machine-like object for standalone client
@@ -238,6 +213,8 @@ module VagrantPlugins
         config = VagrantPlugins::Eryph::Config.new
         config.configuration_name = @options[:configuration_name] if @options[:configuration_name]
         config.client_id = @options[:client_id] if @options[:client_id]
+        config.ssl_verify = @options[:ssl_verify] unless @options[:ssl_verify].nil?
+        config.ssl_ca_file = @options[:ssl_ca_file] if @options[:ssl_ca_file]
         config.finalize!
         
         # Create a fake machine with just the provider config we need
@@ -248,7 +225,7 @@ module VagrantPlugins
         
         Helpers::EryphClient.new(fake_machine)
       rescue StandardError => e
-        raise "Failed to create Eryph client: #{e.message}. Please configure at least one machine with the Eryph provider or ensure your Eryph configuration is set up."
+        raise "Failed to create Eryph client: #{e.message}. Please ensure eryph is running and your client configuration is set up correctly."
       end
 
       def delete_project(client, project_id)
@@ -271,6 +248,18 @@ module VagrantPlugins
       def initialize(argv, env)
         super
         @options = {}
+
+        # Parse global options from full argv first
+        global_parser = OptionParser.new do |o|
+          o.on('--configuration-name NAME', String) { |name| @options[:configuration_name] = name }
+          o.on('--client-id ID', String) { |id| @options[:client_id] = id }
+          o.on('--[no-]ssl-verify') { |verify| @options[:ssl_verify] = verify }
+          o.on('--ssl-ca-file FILE', String) { |file| @options[:ssl_ca_file] = file }
+        end
+
+        # Parse and remove global options, leaving subcommand and its args
+        remaining_args = global_parser.parse(argv.dup)
+
         @parser = OptionParser.new do |o|
           o.banner = 'Usage: vagrant eryph network <subcommand> [options]'
           o.separator ''
@@ -279,19 +268,14 @@ module VagrantPlugins
           o.separator '     set        Set project network configuration from YAML'
           o.separator ''
           o.separator 'Global Options:'
-          
-          o.on('--configuration-name NAME', String, 'Eryph configuration name (default: auto-detect)') do |name|
-            @options[:configuration_name] = name
-          end
-          
-          o.on('--client-id ID', String, 'Eryph client ID') do |id|
-            @options[:client_id] = id
-          end
-          
+          o.separator '     --configuration-name NAME    Eryph configuration name (default: auto-detect)'
+          o.separator '     --client-id ID               Eryph client ID'
+          o.separator '     --[no-]ssl-verify            Enable/disable SSL certificate verification'
+          o.separator '     --ssl-ca-file FILE           Path to custom CA certificate file'
           o.separator ''
         end
 
-        @main_args, @sub_command, @sub_args = split_main_and_subcommand(argv)
+        @main_args, @sub_command, @sub_args = split_main_and_subcommand(remaining_args)
       end
 
       def execute
@@ -475,36 +459,12 @@ module VagrantPlugins
       end
 
       def get_eryph_client
-        # Try to get client from existing machines
-        @env.machine_names.each do |name|
-          machine = @env.machine(name, :eryph)
-          if machine.provider_config.is_a?(VagrantPlugins::Eryph::Config)
-            client = Helpers::EryphClient.new(machine)
-            
-            # Override client configuration if command line options are provided
-            if @options[:configuration_name] || @options[:client_id]
-              override_client_config(client)
-            end
-            
-            return client
-          end
-        end
-
-        # If no machines found, create a temporary config with command line options
+        # Always use standalone client for project management commands
         create_standalone_client
       end
 
       private
 
-      def override_client_config(client)
-        # Update the client's configuration with command line options
-        config = client.instance_variable_get(:@config)
-        config.configuration_name = @options[:configuration_name] if @options[:configuration_name]
-        config.client_id = @options[:client_id] if @options[:client_id]
-        
-        # Force recreation of the client with new config
-        client.instance_variable_set(:@client, nil)
-      end
 
       def create_standalone_client
         # Create a minimal machine-like object for standalone client
@@ -513,6 +473,8 @@ module VagrantPlugins
         config = VagrantPlugins::Eryph::Config.new
         config.configuration_name = @options[:configuration_name] if @options[:configuration_name]
         config.client_id = @options[:client_id] if @options[:client_id]
+        config.ssl_verify = @options[:ssl_verify] unless @options[:ssl_verify].nil?
+        config.ssl_ca_file = @options[:ssl_ca_file] if @options[:ssl_ca_file]
         config.finalize!
         
         # Create a fake machine with just the provider config we need
@@ -523,7 +485,7 @@ module VagrantPlugins
         
         Helpers::EryphClient.new(fake_machine)
       rescue StandardError => e
-        raise "Failed to create Eryph client: #{e.message}. Please configure at least one machine with the Eryph provider or ensure your Eryph configuration is set up."
+        raise "Failed to create Eryph client: #{e.message}. Please ensure eryph is running and your client configuration is set up correctly."
       end
 
       def parse_network_config(config_string)

data/lib/vagrant-eryph/errors.rb

@@ -26,6 +26,22 @@ module VagrantPlugins
         end
       end
 
+      class OperationFailedError < EryphError
+        error_key(:operation_failed)
+      end
+
+      class ProjectNotFoundError < EryphError
+        error_key(:project_not_found)
+      end
+
+      class ProjectCreationError < EryphError
+        error_key(:project_creation_failed)
+      end
+
+      class CatletCreationError < EryphError
+        error_key(:catlet_creation_failed)
+      end
+
       class APIConnectionError < EryphError
         error_key(:api_connection_failed)
       end
@@ -38,10 +54,6 @@ module VagrantPlugins
         error_key(:catlet_not_found)
       end
 
-      class OperationFailedError < EryphError
-        error_key(:operation_failed)
-      end
-
       class ConfigurationError < EryphError
         error_key(:configuration_error)
       end

data/lib/vagrant-eryph/helpers/eryph_client.rb

@@ -91,7 +91,10 @@ module VagrantPlugins
 
           else
             error_msg = result.status_message || 'Operation failed'
-            raise "Operation ID: #{operation.id} - Catlet creation failed: #{error_msg}"
+            raise Errors::CatletCreationError, {
+              catlet_name: catlet_config_hash[:name],
+              message: error_msg
+            }
           end
         end
 
@@ -174,15 +177,25 @@ module VagrantPlugins
           result = wait_for_operation(operation.id)
 
           if result.completed?
-            # Use OperationResult's project accessor
-            project = result.project
+            # Fetch the operation again with projects expanded
+            final_operation = client([SCOPES[:PROJECTS_READ]]).operations.operations_get(
+              result.id,
+              expand: 'projects'
+            )
+            final_result = ::Eryph::Compute::OperationResult.new(final_operation, client([SCOPES[:PROJECTS_READ]]))
+
+            # Now get the project from the properly expanded operation
+            project = final_result.project
             raise "Operation ID: #{operation.id} - Project creation completed but project not found" unless project
 
             @logger.info("Operation ID: #{operation.id} - created project with ID: #{project.id}")
             project  # Return the project, not the result
           else
             error_msg = result.status_message || 'Operation failed'
-            raise "Operation ID: #{operation.id} - Project creation failed: #{error_msg}"
+            raise Errors::ProjectCreationError, {
+              project_name: project_name,
+              message: error_msg
+            }
           end
         end
 
@@ -193,7 +206,7 @@ module VagrantPlugins
           return project if project
 
           unless @config.auto_create_project
-            raise "Project '#{project_name}' not found and auto_create_project is disabled"
+            raise Errors::ProjectNotFoundError, { project_name: project_name }
           end
 
           @ui.info("Project '#{project_name}' not found, creating automatically...")
@@ -295,10 +308,9 @@ module VagrantPlugins
         end
 
         def wait_for_operation(operation_id, timeout = 600)
-          start_time = Time.now
-          current_tasks = {}
-
           @logger.info("Waiting for operation #{operation_id}...")
+          primary_task_name = nil
+          operation_started = false
 
           result = client([SCOPES[:CATLETS_READ]]).wait_for_operation(operation_id, timeout: timeout) do |event_type, data|
             case event_type
@@ -308,47 +320,41 @@ module VagrantPlugins
               resource_id = data.resource_id || data.id || 'unknown'
               @logger.debug("Attached #{resource_type} '#{resource_id}' to operation")
 
-            when :task_new, :task_update
-              # Track current tasks by ID
-              if data.respond_to?(:id) && data.id
-                current_tasks[data.id] = {
-                  name: data.display_name || data.name,
-                  progress: data.respond_to?(:progress) ? data.progress : nil
-                }
-
-                @logger.debug("Task update #{current_tasks[data.id].inspect}")
-              end
-
-            when :status
-              # Report current task with progress if available
-              elapsed = Time.now - start_time
+            when :task_new
+              # Check if this is the primary task (ParentTaskId == operation_id)
+              if data.respond_to?(:parent_task_id) && data.parent_task_id == operation_id
+                primary_task_name = data.respond_to?(:display_name) && data.display_name ? data.display_name :
+                                   (data.respond_to?(:name) && data.name ? data.name : 'Operation')
 
-              # Find active tasks with progress
-              active_task = current_tasks.values.find do |task|
-                task[:progress]&.positive? && task[:progress] < 100
+                unless operation_started
+                  @ui.info("Waiting for operation #{primary_task_name} (#{operation_id})")
+                  operation_started = true
+                end
               end
 
-              if active_task
-                @ui.info("Working... - #{active_task[:name]} #{active_task[:progress]}% - #{elapsed.round}s total elapsed")
+            when :log_entry
+              # Display log messages like .NET client verbose output
+              if data.respond_to?(:message) && data.message
+                @ui.info(data.message)
               end
             end
           end
 
           # Show final result
           if result.completed?
+            @ui.info("Operation ID: #{operation_id} - Operation completed successfully")
             @logger.info("Operation #{operation_id} completed successfully")
           elsif result.failed?
             error_msg = result.status_message || 'Operation failed'
-            @ui.error("Operation failed: #{error_msg}")
-            raise "Operation #{operation_id} failed: #{error_msg}"
+            raise Errors::OperationFailedError, {
+              operation_id: operation_id,
+              message: error_msg
+            }
           else
             @ui.warn("Operation finished with status: #{result.status}")
           end
 
           result
-        rescue StandardError => e
-          @ui.error("Error waiting for operation: #{e.message}")
-          raise e
         end
 
         private

data/lib/vagrant-eryph/plugin.rb

@@ -1,5 +1,17 @@
 # frozen_string_literal: true
 
+begin
+  require 'vagrant'
+rescue LoadError
+  raise 'The Vagrant Eryph plugin must be run within Vagrant.'
+end
+
+# This is a sanity check to make sure no one is attempting to install
+# this into an early Vagrant version.
+if Vagrant::VERSION < '2.0.0'
+  raise 'The Vagrant Eryph plugin is only compatible with Vagrant 2.0+'
+end
+
 module VagrantPlugins
   module Eryph
     class Plugin < Vagrant.plugin('2')
@@ -23,6 +35,17 @@ module VagrantPlugins
         require_relative 'command'
         Command
       end
+
+      def self.setup_i18n
+        # Get the gem root directory (two levels up from lib/vagrant-eryph/)
+        gem_root = File.expand_path('../../..', __FILE__)
+        locale_file = File.join(gem_root, 'locales', 'en.yml')
+        I18n.load_path << locale_file if File.exist?(locale_file)
+        I18n.reload!
+      end
     end
   end
 end
+
+# Setup i18n
+VagrantPlugins::Eryph::Plugin.setup_i18n

data/lib/vagrant-eryph/version.rb

@@ -2,6 +2,6 @@
 
 module VagrantPlugins
   module Eryph
-    VERSION = '0.1.0'
+    VERSION = '0.1.2'
   end
 end

data/locales/en.yml

@@ -0,0 +1,18 @@
+en:
+  vagrant_eryph:
+    errors:
+      api_connection_failed: |-
+        Failed to connect to eryph. Please check your network connection
+        and Eryph service status.
+      credentials_not_found: |-
+        Eryph credentials not found. Please configure your credentials using
+        the Eryph CLI or set up configuration files in your .eryph directory.
+      catlet_not_found: |-
+        The catlet could not be found in Eryph. It may have been deleted
+        outside of Vagrant.
+      operation_failed: "Operation %{operation_id} failed: %{message}"
+      project_not_found: "Project '%{project_name}' not found"
+      project_creation_failed: "Failed to create project '%{project_name}': %{message}"
+      catlet_creation_failed: "Failed to create catlet '%{catlet_name}': %{message}"
+      configuration_error: |-
+        Invalid configuration. Please check your Vagrantfile settings.

data/vagrant-eryph.gemspec

@@ -6,17 +6,17 @@ Gem::Specification.new do |spec|
   spec.authors       = ['dbosoft and eryph contributors']
   spec.email         = ['package-maintainers@eryph.io']
   
-  spec.summary       = 'Vagrant provider for Eryph'
+  spec.summary       = 'Vagrant provider for eryph'
   spec.description   = 'A Vagrant provider plugin that allows you to manage catlets using Eryph\'s compute API'
   spec.homepage      = 'https://github.com/eryph-org/vagrant-eryph'
   spec.license       = 'MIT'
   
   spec.required_ruby_version = '>= 3.1.0'
   
-  spec.files = Dir.glob('lib/**/*') + %w[README.md LICENSE vagrant-eryph.gemspec]
+  spec.files = Dir.glob('lib/**/*') + Dir.glob('locales/**/*') + %w[README.md CHANGELOG.md LICENSE vagrant-eryph.gemspec]
   spec.require_paths = ['lib']
   
-  spec.add_dependency 'eryph-compute', '~> 0.1.1'
+  spec.add_dependency 'eryph-compute', '~> 0.1'
   spec.add_dependency 'eryph-clientruntime', '~> 0.1'
   spec.add_dependency 'log4r', '~> 1.1'
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vagrant-eryph
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - dbosoft and eryph contributors
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: eryph-clientruntime
   requirement: !ruby/object:Gem::Requirement
@@ -115,6 +115,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/vagrant-eryph.rb
@@ -123,6 +124,7 @@ files:
 - lib/vagrant-eryph/actions/create_catlet.rb
 - lib/vagrant-eryph/actions/destroy_catlet.rb
 - lib/vagrant-eryph/actions/is_created.rb
+- lib/vagrant-eryph/actions/is_state.rb
 - lib/vagrant-eryph/actions/is_stopped.rb
 - lib/vagrant-eryph/actions/message_already_created.rb
 - lib/vagrant-eryph/actions/message_not_created.rb
@@ -140,6 +142,7 @@ files:
 - lib/vagrant-eryph/plugin.rb
 - lib/vagrant-eryph/provider.rb
 - lib/vagrant-eryph/version.rb
+- locales/en.yml
 - vagrant-eryph.gemspec
 homepage: https://github.com/eryph-org/vagrant-eryph
 licenses:
@@ -159,7 +162,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.7
 specification_version: 4
-summary: Vagrant provider for Eryph
+summary: Vagrant provider for eryph
 test_files: []