chore: bump version 0.2.0 → 0.2.1 - dependency updates + beta/stable CI pipeline

Version bump for routine dependency updates merged from PR #83-86:
- electron 43.0.0 → 43.1.0 (menu crash fix, Chromium 150, Node.js 24.18.0)
- vite 8.1.3 → 8.1.4 (build fixes, oxc minifier)
- uvicorn 0.49.0 → 0.51.0 (worker reload on SIGHUP, colorama removal)
- lucide-react 1.23.0 → 1.24.0 (icon updates)

CI: implement beta/stable release pipeline
- develop pushes build a prerelease tagged X.Y.Z-beta.N
- main pushes republish the matching beta assets as the stable release
- RPM maker uses a sanitized version (no dashes) per RPM Version field rules
- Added workflow concurrency group and Electron download caching

All tests passing: 47 passed, 1 skipped. Frontend and Electron builds verified.

Author: overwrite00

.github/workflows/build.yml

@@ -13,6 +13,10 @@ on:
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   # ─────────────────────────────────────────────────────────────────────────────
   # TEST BUILD (develop only) — Verify code compiles and tests pass
@@ -63,6 +67,8 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: read
+    env:
+      ELECTRON_CACHE: ${{ github.workspace }}/.electron-cache
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
@@ -97,35 +103,46 @@ jobs:
           cd frontend
           npm ci
           npm run build
+      - name: Cache Electron download
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.ELECTRON_CACHE }}
+          key: electron-${{ runner.os }}-${{ hashFiles('electron/package-lock.json') }}
       - name: Test electron setup
         run: |
           cd electron
           npm ci --include=dev
 
   # ─────────────────────────────────────────────────────────────────────────────
-  # RELEASE BUILD (main only) — Create and publish stable release
+  # BETA RELEASE (develop only) — Package and publish a prerelease build
   # ─────────────────────────────────────────────────────────────────────────────
-  get-version:
-    if: github.ref == 'refs/heads/main'
+  get-version-beta:
+    if: github.ref == 'refs/heads/develop'
+    needs: [test-python, test-frontend, test-electron]
     runs-on: ubuntu-latest
     permissions:
       contents: read
     outputs:
-      version: ${{ steps.ver.outputs.version }}
+      base_version: ${{ steps.ver.outputs.base_version }}
+      beta_version: ${{ steps.ver.outputs.beta_version }}
     steps:
       - uses: actions/checkout@v6
       - id: ver
         run: |
-          VERSION=$(grep -oP 'VERSION\s*=\s*"\K[^"]+' python/config.py)
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "Building MetaLens v$VERSION"
+          BASE=$(grep -oP 'VERSION\s*=\s*"\K[^"]+' python/config.py)
+          BETA="${BASE}-beta.${{ github.run_number }}"
+          echo "base_version=$BASE" >> "$GITHUB_OUTPUT"
+          echo "beta_version=$BETA" >> "$GITHUB_OUTPUT"
+          echo "Building MetaLens beta v$BETA"
 
-  build-windows:
-    if: github.ref == 'refs/heads/main'
-    needs: get-version
+  build-windows-beta:
+    if: github.ref == 'refs/heads/develop'
+    needs: get-version-beta
     runs-on: windows-latest
     permissions:
       contents: read
+    env:
+      ELECTRON_CACHE: ${{ github.workspace }}/.electron-cache
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
@@ -160,28 +177,35 @@ jobs:
           npm run build
       - name: Copy frontend dist into electron
         run: cp -r frontend/dist electron/frontend
-      - name: Sync electron version
+      - name: Sync electron version to beta
         run: |
           cd electron
-          npm version ${{ needs.get-version.outputs.version }} --no-git-tag-version --allow-same-version
+          npm version ${{ needs.get-version-beta.outputs.beta_version }} --no-git-tag-version --allow-same-version
+      - name: Cache Electron download
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.ELECTRON_CACHE }}
+          key: electron-${{ runner.os }}-${{ hashFiles('electron/package-lock.json') }}
       - name: Package with Electron Forge
         run: |
           cd electron
           npm ci --include=dev
           npx electron-forge make
-      - name: Upload Windows artifact
+      - name: Upload Windows beta artifact
         uses: actions/upload-artifact@v7
         with:
-          name: windows-installer
+          name: windows-installer-beta
           path: electron/out/make/**/*.exe
           if-no-files-found: error
 
-  build-linux:
-    if: github.ref == 'refs/heads/main'
-    needs: get-version
+  build-linux-beta:
+    if: github.ref == 'refs/heads/develop'
+    needs: get-version-beta
     runs-on: ubuntu-latest
     permissions:
       contents: read
+    env:
+      ELECTRON_CACHE: ${{ github.workspace }}/.electron-cache
     steps:
       - uses: actions/checkout@v6
       - name: Install system dependencies
@@ -217,20 +241,25 @@ jobs:
           npm run build
       - name: Copy frontend dist into electron
         run: cp -r frontend/dist electron/frontend
-      - name: Sync electron version
+      - name: Sync electron version to beta
         run: |
           cd electron
-          npm version ${{ needs.get-version.outputs.version }} --no-git-tag-version --allow-same-version
+          npm version ${{ needs.get-version-beta.outputs.beta_version }} --no-git-tag-version --allow-same-version
       - name: Configure RPM macros
         run: echo '%_build_id_links none' >> ~/.rpmmacros
+      - name: Cache Electron download
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.ELECTRON_CACHE }}
+          key: electron-${{ runner.os }}-${{ hashFiles('electron/package-lock.json') }}
       - name: Package with Electron Forge
         run: |
           cd electron
           npm ci --include=dev
           npx electron-forge make
       - name: Create Linux tar.gz
         run: |
-          VERSION=${{ needs.get-version.outputs.version }}
+          VERSION=${{ needs.get-version-beta.outputs.beta_version }}
           APP_DIR=$(find electron/out -maxdepth 1 -type d -name "MetaLens-linux-*" | head -1)
           if [ -n "$APP_DIR" ]; then
             tar -czf "electron/out/make/MetaLens-${VERSION}-Linux.tar.gz" \
@@ -239,19 +268,19 @@ jobs:
           else
             echo "Warning: no MetaLens-linux-* directory found, skipping tar.gz"
           fi
-      - name: Upload Linux artifacts
+      - name: Upload Linux beta artifacts
         uses: actions/upload-artifact@v7
         with:
-          name: linux-packages
+          name: linux-packages-beta
           path: |
             electron/out/make/**/*.deb
             electron/out/make/**/*.rpm
             electron/out/make/**/*.tar.gz
           if-no-files-found: error
 
-  release:
-    if: github.ref == 'refs/heads/main'
-    needs: [get-version, build-windows, build-linux]
+  release-beta:
+    if: github.ref == 'refs/heads/develop'
+    needs: [get-version-beta, build-windows-beta, build-linux-beta]
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -261,7 +290,86 @@ jobs:
           path: artifacts
       - name: List artifacts
         run: find artifacts -type f
-      - name: Create GitHub Release
+      - name: Create beta GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          tag_name: v${{ needs.get-version-beta.outputs.beta_version }}
+          name: MetaLens v${{ needs.get-version-beta.outputs.beta_version }} (beta)
+          draft: false
+          prerelease: true
+          generate_release_notes: true
+          make_latest: false
+          files: |
+            artifacts/windows-installer-beta/**
+            artifacts/linux-packages-beta/**
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # STABLE RELEASE (main only) — Promote the matching beta build, no rebuild
+  # ─────────────────────────────────────────────────────────────────────────────
+  get-version:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    outputs:
+      version: ${{ steps.ver.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - id: ver
+        run: |
+          VERSION=$(grep -oP 'VERSION\s*=\s*"\K[^"]+' python/config.py)
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Building MetaLens v$VERSION"
+
+  find-latest-beta:
+    if: github.ref == 'refs/heads/main'
+    needs: get-version
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    outputs:
+      beta_tag: ${{ steps.find.outputs.beta_tag }}
+    steps:
+      - id: find
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ needs.get-version.outputs.version }}
+        run: |
+          TAG=$(gh release list --repo "$GITHUB_REPOSITORY" --limit 200 --json tagName \
+            --jq '.[].tagName' \
+            | grep -E "^v${VERSION}-beta\.[0-9]+$" \
+            | sort -t. -k4 -n \
+            | tail -1)
+          if [ -z "$TAG" ]; then
+            echo "::error::Nessuna release beta trovata per v${VERSION}. Genera prima una beta da develop con la stessa VERSION in python/config.py."
+            exit 1
+          fi
+          echo "beta_tag=$TAG" >> "$GITHUB_OUTPUT"
+          echo "Promuovendo $TAG a stable v${VERSION}"
+
+  promote-stable:
+    if: github.ref == 'refs/heads/main'
+    needs: [get-version, find-latest-beta]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download beta release assets
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p promoted
+          gh release download "${{ needs.find-latest-beta.outputs.beta_tag }}" \
+            --repo "$GITHUB_REPOSITORY" --dir promoted
+      - name: Strip beta suffix from filenames
+        run: |
+          cd promoted
+          for f in *; do
+            new=$(echo "$f" | sed -E 's/-beta\.[0-9]+//')
+            if [ "$f" != "$new" ]; then mv -- "$f" "$new"; fi
+          done
+          ls -la
+      - name: Create stable GitHub Release
         uses: softprops/action-gh-release@v3
         with:
           tag_name: v${{ needs.get-version.outputs.version }}
@@ -270,6 +378,4 @@ jobs:
           prerelease: false
           generate_release_notes: true
           make_latest: true
-          files: |
-            artifacts/windows-installer/**
-            artifacts/linux-packages/**
+          files: promoted/*

CHANGELOG.md

@@ -15,6 +15,21 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) —
 
 ---
 
+## [0.2.1] — 2026-07-14
+
+### Dependencies
+- electron: 43.0.0 → 43.1.0 (fixed crash on replacing an open application menu, Chromium 150.0.7871.47, Node.js 24.18.0)
+- vite: 8.1.3 → 8.1.4 (oxc minifier preference for legacy builds, StackBlitz build workaround, SSR stacktrace alignment)
+- uvicorn: 0.49.0 → 0.51.0 (near-zero-downtime worker reload on SIGHUP, removed colorama from standard extra)
+- lucide-react: 1.23.0 → 1.24.0 (new icons, several upstream icon fixes)
+
+### Quality
+- All tests passing: 47 passed, 1 skipped
+- Frontend build and Electron startup verified with updated dependencies
+- No regressions
+
+---
+
 ## [0.2.0] — 2026-07-04
 
 ### Major Changes

README.md

@@ -81,7 +81,7 @@ File (image / audio / video / document / anything)
 
 ## 🔧 Version
 
-**v0.2.0** — Tailwind CSS v4 upgrade with the new Vite plugin, CSS-first `@theme` configuration, and dependency updates (Electron 43, FastAPI 0.139, Pillow 12.3). No changes to application behavior or the API.
+**v0.2.1** — Routine dependency updates (Electron 43.1, Vite 8.1.4, uvicorn 0.51, lucide-react 1.24). No changes to application behavior or the API.
 
 📖 **See full version history** → [CHANGELOG.md](./CHANGELOG.md)
 

docs/API.md

@@ -26,7 +26,7 @@ Health check + version, used by the About dialog and by Electron to know the sid
 
 **Response**
 ```json
-{ "status": "ok", "version": "0.2.0", "app": "MetaLens" }
+{ "status": "ok", "version": "0.2.1", "app": "MetaLens" }
 ```
 
 ---

electron/forge.config.js

@@ -8,6 +8,10 @@ const iconExists = ['.ico', '.icns', '.png'].some(ext => fs.existsSync(iconPath
 // Read version from package.json — synced by the CI workflow from python/config.py
 const { version } = require('./package.json')
 
+// RPM's Version field forbids "-" (used for beta tags like 0.2.1-beta.5),
+// so the rpm maker gets a sanitized copy while every other maker keeps the real semver.
+const rpmSafeVersion = version.replace(/-/g, '')
+
 module.exports = {
   packagerConfig: {
     name: 'MetaLens',
@@ -57,6 +61,7 @@ module.exports = {
           license:      'MIT',
           icon:         path.join(__dirname, '..', 'frontend', 'public', 'icon.png'),
           categories:   ['Utility', 'FileManager'],
+          version:      rpmSafeVersion,
         },
       },
     },

electron/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metalens",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Universal File Metadata Manager",
   "author": "Graziano Mariella",
   "license": "MIT",

frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metalens-frontend",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": true,
   "type": "module",
   "scripts": {

python/config.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 
 
-VERSION = "0.2.0"
+VERSION = "0.2.1"
 APP_NAME = "MetaLens"
 SIDECAR_HOST = "127.0.0.1"