v2.4.0: Dependencies, Settings Refactor, Accessibility & OEM Integration

.github/skills/testing.md

@@ -26,9 +26,7 @@ Expected: 277+ tests passing. 0 lint errors (warnings OK per issue #256).
 
 4. Build container from local source and start
 
-cd ../.. && docker compose -f docker-compose.yml -f docker-compose.dev.yml build --no-cache 
-
-&& docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
+cd ../.. && docker compose -f docker-compose.yml -f docker-compose.dev.yml build --no-cache && docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
 
 5. Health check
 

.github/workflows/auto-release.yml

@@ -59,13 +59,29 @@ jobs:
           echo "changelog<<$EOF" >> $GITHUB_OUTPUT
           echo "$CHANGELOG" >> $GITHUB_OUTPUT
           echo "$EOF" >> $GITHUB_OUTPUT
+
+      - name: Setup Bun for PWA build
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Build machine PWA artifact
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          cd apps/web
+          bun install --frozen-lockfile
+          VITE_MACHINE_MODE=direct bun run build
+          tar -czf ../../meticai-web.tar.gz -C dist .
+          echo "📦 Machine PWA: $(du -sh dist/ | cut -f1)"
 
       - name: Create Release
         if: steps.check_tag.outputs.exists == 'false'
         uses: softprops/action-gh-release@v2
         with:
           tag_name: v${{ steps.version.outputs.version }}
           name: MeticAI v${{ steps.version.outputs.version }}
+          files: meticai-web.tar.gz
           body: |
             ## MeticAI v${{ steps.version.outputs.version }}
 
@@ -86,6 +102,11 @@ jobs:
             docker pull ghcr.io/hessius/meticai:v${{ steps.version.outputs.version }}
             ```
 
+            **Machine-Hosted PWA:**
+            ```bash
+            curl -fsSL https://raw.githubusercontent.com/hessius/MeticAI/main/scripts/install-direct.sh | bash
+            ```
+
             **Upgrading from v1.x:**
             ```bash
             curl -fsSL https://raw.githubusercontent.com/hessius/MeticAI/main/scripts/migrate-to-unified.sh | bash

.github/workflows/build-ios.yml

@@ -0,0 +1,83 @@
+name: Build iOS App
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'apps/web/**'
+      - 'VERSION'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'apps/web/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-ios:
+    name: Build Capacitor iOS
+    runs-on: macos-15
+    defaults:
+      run:
+        working-directory: apps/web
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Bun (attempt 1)
+        id: setup_bun_1
+        continue-on-error: true
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Setup Bun (attempt 2)
+        id: setup_bun_2
+        if: steps.setup_bun_1.outcome == 'failure'
+        continue-on-error: true
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Setup Bun (attempt 3)
+        if: steps.setup_bun_2.outcome == 'failure'
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build web app for Capacitor
+        run: VITE_MACHINE_MODE=capacitor bun run build
+
+      - name: Sync Capacitor
+        run: npx cap sync ios
+
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode_16.3.app
+
+      - name: Build iOS (no code signing)
+        run: |
+          xcodebuild build \
+            -project ios/App/App.xcodeproj \
+            -scheme App \
+            -destination 'generic/platform=iOS Simulator' \
+            -configuration Release \
+            CODE_SIGNING_ALLOWED=NO \
+            CODE_SIGNING_REQUIRED=NO \
+            CODE_SIGN_IDENTITY="" \
+            | tail -20
+
+      - name: Report build result
+        if: always()
+        run: |
+          if [ -d ios/App/build ]; then
+            SIZE=$(du -sh ios/App/build/ | cut -f1)
+            echo "📱 iOS build: ${SIZE}"
+          else
+            echo "📱 iOS build completed (simulator target)"
+          fi

.github/workflows/build-machine-pwa.yml

@@ -0,0 +1,77 @@
+name: Build Machine PWA
+
+on:
+  push:
+    branches: [main, "feat/machine-hosted-pwa"]
+    paths:
+      - 'apps/web/**'
+      - 'VERSION'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'apps/web/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-machine-pwa:
+    name: Build Machine-Hosted PWA
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: apps/web
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Bun (attempt 1)
+        id: setup_bun_1
+        continue-on-error: true
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Setup Bun (attempt 2)
+        id: setup_bun_2
+        if: steps.setup_bun_1.outcome == 'failure'
+        continue-on-error: true
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Setup Bun (attempt 3)
+        if: steps.setup_bun_2.outcome == 'failure'
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.10
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run linter
+        run: bun run lint
+
+      - name: Run tests (direct mode)
+        run: VITE_MACHINE_MODE=direct bun run test:run
+
+      - name: Build for machine
+        run: bun run build:machine
+
+      - name: Report build size
+        run: |
+          SIZE=$(du -sh dist/ | cut -f1)
+          FILES=$(find dist/ -type f | wc -l)
+          echo "📦 Machine PWA build: ${SIZE}, ${FILES} files"
+
+      - name: Create release tarball
+        run: tar -czf meticai-web.tar.gz -C dist .
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: meticai-web
+          path: apps/web/meticai-web.tar.gz
+          retention-days: 90

.github/workflows/build-macos-installer.yml

@@ -8,7 +8,7 @@ on:
     branches:
       - main
       - develop
-      - version/2.0.0
+      - "version/*"
   pull_request:
     paths:
       - 'macos-installer/**'

.github/workflows/tests.yml

@@ -2,9 +2,9 @@ name: Test Suite
 
 on:
   push:
-    branches: [main, develop, version/2.0.0]
+    branches: [main, develop, "version/*", "feat/machine-hosted-pwa"]
   pull_request:
-    branches: [main, develop, version/2.0.0]
+    branches: [main, develop, "version/*"]
 
 jobs:
   # ============================================================================
@@ -48,7 +48,7 @@ jobs:
             --cov-report=xml --cov-report=term-missing
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           files: ./apps/server/coverage.xml
           flags: relay
@@ -107,11 +107,14 @@ jobs:
       - name: Run unit tests
         run: bun run test:run
 
+      - name: Run direct-mode tests
+        run: bun run test:direct
+
       - name: Generate coverage report
         run: bun run test:coverage
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           files: ./apps/web/coverage/coverage-final.json
           flags: web

.release-notes-beta.md

@@ -0,0 +1,72 @@
+## MeticAI v2.4.0-beta.1 — Machine-Hosted PWA & iOS Foundation
+
+### 🚀 New Features
+
+#### Espresso Compass (#261)
+Interactive 2D taste input (sour/bitter, weak/strong) with descriptor selection. After pulling a shot, tell MeticAI how it tasted and get AI-powered recommendations for your next attempt.
+
+#### Temporary Variable Adjustments (#281)
+Tweak profile variables (dose, temperature, pressure, flow targets) before running a shot — without saving changes to the profile. Run-without-saving support plus "Save as New" option for keepers.
+
+#### Profile Recommendations (#95)
+AI recommends profiles based on tag similarity scoring. "Find Similar" overlay in the profile catalogue helps you discover related profiles.
+
+#### Analysis-to-Edit Pipeline (#258)
+Shot analysis now generates structured, actionable recommendations. Select which suggestions to apply — edits are made directly to the profile.
+
+#### Profile Catalogue Edit Mode
+Export, rename, and delete buttons are now behind an Edit toggle — cleaner default view, full control when you need it. Bulk delete support included.
+
+#### Profile Image Improvements
+Download profile images, auto-scroll gallery, and improved prompt generation.
+
+### ♿ Accessibility (#186)
+- Landmarks, skip navigation, and live regions throughout the app
+- All icon-only buttons have descriptive aria-labels
+- Charts have role="img" with descriptive labels
+- prefers-reduced-motion support across all animations
+- 25+ accessibility i18n keys across all 6 locales
+
+### ⚡ Performance
+- **Code-splitting:** 13 views lazy-loaded (main bundle 1,807 KB → 516 KB, **71% reduction**)
+- Recharts and framer-motion in separate async chunks
+- Granular error boundaries on all lazy-loaded views
+
+### 🐛 Bug Fixes
+- Variable adjust panel: reliability improvements, correct grouping (base vs. custom), unused variable warnings, emoji info variables filtered out
+- Pour-over: dose and brew ratio now persist across sessions
+- Preheat: subtitle no longer shows when preheat is disabled; profile pre-selected during preheat phase
+- Live view: removed Power line from chart (not useful for espresso)
+- Recommendation dialog: improved mobile layout
+- Profile catalogue: image caching, thumbnail improvements
+- Scroll-to-top on all intra-component view transitions
+- 50+ hardcoded English error strings replaced with i18n t() calls
+
+### 📦 Dependencies
+- Vite 8.0.0 (Rolldown-based builds)
+- React 19.2.4, framer-motion 12.37.0, tailwindcss 4.2.1
+- 31 dependency bumps total (Python + NPM)
+
+### 📊 Stats
+- 105 files changed, 15,336 insertions, 3,743 deletions
+- 6 locales fully updated (en, de, es, fr, it, sv)
+- 0 lint errors, all tests passing
+
+---
+
+### Installation (Beta Channel)
+
+**Docker (beta tag):**
+```bash
+docker pull ghcr.io/hessius/meticai:beta
+```
+
+**Pin to this exact version:**
+```bash
+docker pull ghcr.io/hessius/meticai:2.4.0-beta.1
+```
+
+⚠️ This is a pre-release. The `latest` tag is unchanged — stable users are not affected.
+
+---
+Built from commit: 1a57c72bbb3b7745bdfc3931154e4e9cb39b4037

IOS_SHORTCUTS.md

@@ -43,3 +43,29 @@ Same as Photo workflow but use endpoint: `http://<SERVER_IP>:3550/api/analyze_co
 - **Connection fails** — Ensure your phone is on the same network. Test `http://<SERVER_IP>:3550/docs` in Safari.
 - **Invalid response** — Check field names are exactly `file` and/or `user_prefs` (case-sensitive).
 - **Photo won't upload** — Ensure the form field key is `file` and value comes from the Take Photo action.
+
+## Import Profile from Share Sheet
+
+Share a profile URL (`.json` or `.met`) from any app to import it directly into MeticAI.
+
+### Setup
+
+| # | Action | Configuration |
+|---|--------|---------------|
+| 1 | **Receive** | URLs from Share Sheet |
+| 2 | **URL Encode** | Encode Shortcut Input |
+| 3 | **URL** | `http://<SERVER_IP>:3550/?import=` appended with URL Encoded Text |
+| 4 | **Open URLs** | Open the URL from step 3 |
+
+### How It Works
+
+MeticAI supports a `?import=<url>` query parameter. When the app loads with this parameter, it automatically opens the import dialog and begins importing the profile from the given URL.
+
+### Alternative: Direct API Import
+
+| # | Action | Configuration |
+|---|--------|---------------|
+| 1 | **Receive** | URLs from Share Sheet |
+| 2 | **Get Contents of URL** | URL: `http://<SERVER_IP>:3550/api/import-from-url`, Method: POST, Body: JSON, `url` = Shortcut Input |
+| 3 | **Get Dictionary Value** | Key: `profile_name` |
+| 4 | **Show Notification** | Text: "Imported: " + Dictionary Value |