feat: migrate from release-please to semantic-release (#748)

* feat: migrate from release-please to semantic-release

- Add semantic-release configuration and workflow
- Support for release candidates via rc branch
- Remove old release-please configuration files
- Add Node.js dependencies to .gitignore
- Update version management script

🤖 Generated with [Claude Code](https://claude.ai/code)

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

* chore: rename semantic-release workflow to release

- Update workflow name from "Semantic Release" to "Release"
- Update documentation to reflect new workflow filename

🤖 Generated with [Claude Code](https://claude.ai/code)

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

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: grdsdev

.github/workflows/release.yml

@@ -1,19 +1,34 @@
+name: Release
+
 on:
   push:
     branches:
       - main
-      - release/*
-
-permissions:
-  contents: write
-  pull-requests: write
-
-name: release-please
+      - rc
+  workflow_dispatch:
 
 jobs:
-  release-please:
+  release:
     runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, 'skip ci')"
+    
     steps:
-      - uses: googleapis/release-please-action@v4
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
-          target-branch: ${{ github.ref_name }}
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release

.gitignore

@@ -102,4 +102,10 @@ Secrets.swift
 lcov.info
 temp_coverage
 
-.cursor
+.cursor
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

.releaserc.json

@@ -0,0 +1,37 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "rc",
+      "prerelease": true
+    }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    [
+      "@semantic-release/exec",
+      {
+        "prepareCmd": "scripts/update-version.sh ${nextRelease.version}"
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md", "Sources/Helpers/Version.swift"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    [
+      "@semantic-release/github",
+      {
+        "assets": []
+      }
+    ]
+  ]
+}

RELEASE.md

@@ -0,0 +1,84 @@
+# Semantic Release Setup
+
+This project uses [semantic-release](https://semantic-release.gitbook.io/) to automate version management and package publishing.
+
+## How it works
+
+1. **Commit messages** follow the [Conventional Commits](https://www.conventionalcommits.org/) specification
+2. **Semantic-release** analyzes commits and determines the next version number
+3. **GitHub Actions** automatically creates releases when changes are pushed to `main`
+
+## Commit Message Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+- `feat`: A new feature (triggers minor version bump)
+- `fix`: A bug fix (triggers patch version bump)
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to the build process or auxiliary tools
+
+### Breaking Changes
+
+Add `BREAKING CHANGE:` in the footer or use `!` after the type to trigger a major version bump:
+
+```
+feat!: remove deprecated API
+```
+
+or
+
+```
+feat: add new feature
+
+BREAKING CHANGE: This removes the old API
+```
+
+## Release Process
+
+### Regular Releases (main branch)
+
+1. Push commits to `main` branch
+2. GitHub Actions runs semantic-release
+3. If there are releasable changes:
+   - Version is updated in `Sources/Helpers/Version.swift`
+   - `CHANGELOG.md` is updated
+   - Git tag is created
+   - GitHub release is published
+
+### Release Candidates (rc branch)
+
+1. Push commits to `rc` branch
+2. GitHub Actions runs semantic-release
+3. If there are releasable changes:
+   - Prerelease version is created (e.g., `2.31.0-rc.1`)
+   - Version is updated in `Sources/Helpers/Version.swift`
+   - `CHANGELOG.md` is updated
+   - Git tag is created
+   - GitHub prerelease is published
+
+## Manual Release
+
+To manually trigger a release:
+
+1. Go to Actions tab in GitHub
+2. Select "Semantic Release" workflow
+3. Click "Run workflow"
+
+## Configuration Files
+
+- `.releaserc.json`: Semantic-release configuration
+- `package.json`: Node.js dependencies
+- `.github/workflows/release.yml`: GitHub Actions workflow
+- `scripts/update-version.sh`: Version update script

Sources/Helpers/Version.swift

@@ -1,7 +1,7 @@
 import Foundation
 import XCTestDynamicOverlay
 
-private let _version = "2.30.2"  // {x-release-please-version}
+private let _version = "2.30.2"
 
 #if DEBUG
   package let version = isTesting ? "0.0.0" : _version