feat: add GitHub Actions CI/CD and RubyGems publishing setup

- ci.yml: test on Ruby 3.1-3.4 matrix (3.1 allow-failures, EOL),
  runs rspec + rubocop + yard doc generation on every push/PR
- publish.yml: publishes to RubyGems.org on v* tag push,
  creates GitHub Release with auto-generated notes
- gemspec: add allowed_push_host: https://rubygems.org

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: elucidsoft

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version: ['3.2', '3.3', '3.4']
+        include:
+          # Ruby 3.1 reached EOL March 2025 — keep in matrix for compatibility
+          # reporting but allow failures so EOL-only issues don't block PRs
+          - ruby-version: '3.1'
+            continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+      - name: Run linter
+        run: bundle exec rubocop
+
+      - name: Generate YARD docs
+        run: bundle exec yard doc --no-stats 2>&1 | grep -v "^$" || true
+
+      - name: Upload coverage report
+        uses: actions/upload-artifact@v4
+        if: matrix.ruby-version == '3.3'
+        with:
+          name: coverage
+          path: coverage/
+          retention-days: 7

.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to RubyGems
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    # Packagist-style webhook not needed for RubyGems — publishing is explicit
+    # via gem push with GEM_HOST_API_KEY secret set in repo settings
+
+    permissions:
+      contents: write  # required to create GitHub Release
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+      - name: Run linter
+        run: bundle exec rubocop
+
+      - name: Build gem
+        run: gem build cloudlayerio.gemspec
+
+      - name: Publish to RubyGems.org
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.GEM_HOST_API_KEY }}
+        run: gem push cloudlayerio-*.gem
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: cloudlayerio-*.gem

cloudlayerio.gemspec

@@ -22,7 +22,8 @@ Gem::Specification.new do |spec|
     'changelog_uri' => 'https://github.com/cloudlayerio/cloudlayerio-ruby/blob/main/CHANGELOG.md',
     'documentation_uri' => 'https://cloudlayer.io/docs/sdk-ruby',
     'bug_tracker_uri' => 'https://github.com/cloudlayerio/cloudlayerio-ruby/issues',
-    'rubygems_mfa_required' => 'true'
+    'rubygems_mfa_required' => 'true',
+    'allowed_push_host' => 'https://rubygems.org'
   }
 
   spec.files = Dir['lib/**/*', 'LICENSE', 'README.md', 'CHANGELOG.md']