fix: lower Perl version requirement from v5.40 to v5.38 for CI compatibility

- Update all Perl modules and scripts to use v5.38 instead of v5.40
- Fixes GitHub Actions test failures due to Ubuntu 24.04 only having Perl v5.38.2
- Add comprehensive documentation in README explaining Perl version choice:
  * Modern features (strict/warnings enabled by default)
  * GitHub Actions compatibility with Ubuntu 24.04 LTS
  * Avoids slow Perl installation in CI pipelines
  * Provides all necessary modern Perl features
- Add perlbrew to project dictionary for spell checking
- All tests and linting continue to pass with v5.38

Files updated:
- lib/TorrustDeploy/App.pm
- lib/TorrustDeploy/App/Command/Provision.pm
- lib/TorrustDeploy/Provision/OpenTofu.pm
- bin/torrust-deploy
- t/e2e/provision.t
- README.md
- project-words.txt

Author: josecelano

README.md

@@ -5,6 +5,26 @@
 A modern Perl console application for deploying Torrust Tracker to Hetzner Cloud using Packer,
 Terraform, and Ansible.
 
+## Perl Version Requirement
+
+This project requires **Perl v5.38** or higher. We chose v5.38 specifically because:
+
+- **Modern Perl features**: Enables `strict` and `warnings` by default without explicit `use` statements
+- **GitHub Actions compatibility**: v5.38 is the default Perl version in Ubuntu 24.04 LTS  
+  (GitHub Actions runners)
+- **No additional CI setup**: Avoids the overhead of installing newer Perl versions in CI, which  
+  can be slow
+- **Modern enough**: Provides all the modern Perl features we need for this application
+
+You can check your Perl version with:
+
+```bash
+perl -v
+```
+
+If you need to install a newer Perl version, consider using [perlbrew](https://perlbrew.pl/) for  
+local development.
+
 ## Installation
 
 Install cpanminus:

bin/torrust-deploy

@@ -1,7 +1,7 @@
 #!/usr/bin/env perl
 
 # Set up Perl environment with modern features (includes strict and warnings)
-use v5.40;
+use v5.38;
 
 # Configure module loading
 use FindBin qw($Bin);        # Import FindBin module and get $Bin variable containing this script's directory

lib/TorrustDeploy/App.pm

@@ -1,6 +1,6 @@
 package TorrustDeploy::App;
 
-use v5.40;
+use v5.38;
 
 # App::Cmd framework setup - automatically discovers commands in TorrustDeploy::App::Command::*
 # Commands are found by convention: each .pm file in lib/TorrustDeploy/App/Command/ 

lib/TorrustDeploy/App/Command/Provision.pm

@@ -1,6 +1,6 @@
 package TorrustDeploy::App::Command::Provision;
 
-use v5.40;
+use v5.38;
 
 use TorrustDeploy::App -command;
 use TorrustDeploy::Provision::OpenTofu;

lib/TorrustDeploy/Provision/OpenTofu.pm

@@ -1,6 +1,6 @@
 package TorrustDeploy::Provision::OpenTofu;
 
-use v5.40;
+use v5.38;
 
 use JSON;
 

project-words.txt

@@ -21,6 +21,7 @@ Mlocal
 netdev
 NOPASSWD
 opentofu
+perlbrew
 perlstyle
 plugdev
 pwauth

t/e2e/provision.t

@@ -1,4 +1,4 @@
-use v5.40;
+use v5.38;
 use Test::More;
 use Test::Exception;
 use Capture::Tiny qw(capture);