feat: Automate GitHub Release creation in CI pipeline

Change release workflow to be triggered by pushing tags instead of
manually creating GitHub Releases. The CI pipeline now:

1. Triggered by: git push origin v0.1.0
2. Runs all tests and validations
3. Publishes to PyPI (after manual approval)
4. Automatically creates GitHub Release with packages attached

This simplifies the release process - just push a tag and the rest
is automated.

Author: florath

.github/workflows/ci.yml

@@ -593,7 +593,7 @@ jobs:
   publish:
     name: Publish to PyPI (Production)
     runs-on: ubuntu-latest
-    if: github.event_name == 'release' && github.event.action == 'published'
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
     needs: [lint-and-type-check, test, build, integration-tests, cross-platform-integration]
     environment: production
 
@@ -760,10 +760,19 @@ jobs:
         print('This may be normal - check manually at: https://pypi.org/project/aletheia-probe/')
         "
 
-    - name: Upload packages to GitHub Release
+    - name: Create GitHub Release and upload packages
       uses: softprops/action-gh-release@v1
       with:
         files: dist/*
+        generate_release_notes: true
+        body: |
+          ## Installation
+
+          ```bash
+          pip install aletheia-probe
+          ```
+
+          See [CHANGELOG](https://github.com/sustainet-guardian/aletheia-probe/blob/main/docs/CHANGELOG.md) for full release notes.
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 

docs/RELEASE.md

@@ -21,22 +21,27 @@ git commit -m "Update CHANGELOG for $(grep version pyproject.toml | cut -d'"' -f
 git push origin main
 ```
 
-### 2. Create GitHub Release (2 minutes)
+### 2. Create and Push Tag (1 minute)
 
 ```bash
-# After CI passes, create tag
+# After CI passes, create and push tag
 VERSION=$(grep 'version = ' pyproject.toml | cut -d'"' -f2)
 git tag -a v$VERSION -m "Release version $VERSION"
 git push origin v$VERSION
 ```
 
-Then create GitHub Release at: https://github.com/sustainet-guardian/aletheia-probe/releases/new
+This automatically triggers the release pipeline which will:
+- Run all tests and validations
+- Publish to PyPI (after manual approval)
+- Create GitHub Release with packages attached
 
-### 3. Approve & Verify (5 minutes)
+### 3. Approve & Verify (10 minutes)
 
 - Wait for CI checks (~10 min)
-- Approve deployment when notified
+- Approve deployment when notified (production environment)
+- CI automatically creates GitHub Release
 - Verify: `pip install aletheia-probe==$VERSION`
+- Check release: https://github.com/sustainet-guardian/aletheia-probe/releases
 
 ---