docs(06): complete Phase 06 — desktop wrapper + CI/CD pipeline verified

- 06-01: Tauri scaffold complete - 06-02: Native features (tray, window-state, autostart, version check, AppImage) - 06-03: Gitea CI/CD pipeline green (Run #89 — all 3 jobs pass) - Clean up handoff and continue-here files - Update STATE.md to 100% (all 6 phases complete) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-25 14:09:17 +02:00
parent c65ada0ba9
commit 95423497ad
5 changed files with 100 additions and 141 deletions
@@ -1,49 +0,0 @@
-# Continue Here — Phase 06: Desktop Client & CI/CD
-
-**Paused:** 2026-06-25T10:36Z
-**Resume:** `/gsd-execute-phase 6`
-
-## Current State
-
-### Plan 06-01: Tauri Desktop Wrapper ✅ COMPLETE
- Toolchain installed (rustc 1.96.0, WebKitGTK 2.52.3)
- apps/desktop scaffolded as @tessera/desktop, cargo check passes
- First-run setup.html with server URL persistence
- Commits: 48e3a69, d944aaa, f41e673
-
-### Plan 06-03: Gitea CI/CD ⏳ IN PROGRESS (Task 4/4)
- Gitea user `schalli` created, repo `schalli/tessera-ctl` (private)
- Remote: `origin` → `https://git.vicolab.de/schalli/tessera-ctl.git` (token in URL)
- act_runner: existing Docker container reused (gitea-docker-runner-1, v0.6.1)
- docker-compose.ci.yml + docs/ci-cd-setup.md created (c0e3293)
- .gitea/workflows/ci.yml created (756925b)
- **CI fixes pushed:** corepack statt pnpm/action-setup (e5d45e1), prisma generate postinstall (faff50b)
- **Pending:** Run #87 Ergebnis pruefen — type-check sollte jetzt passen
-
-### Plan 06-02: Native Desktop Features ❌ NOT STARTED (Wave 2)
- Depends on 06-01 (complete)
- Tray, close-to-tray, window-state, autostart, notifications, version check, icons, bundles
-
-## Human Actions Before Resume
-
-1. Check Pipeline Run #87: https://git.vicolab.de/schalli/tessera-ctl/actions
-2. If still failing, paste the error — likely needs another CI fix
-
-## Key Infrastructure
-
- **Gitea:** https://git.vicolab.de — User: schalli, Token in git remote URL
- **Runner Token:** SK5NCGjVMTxg6NYleLeOlc3qAuLrDxbvlENGIixJ
- **MCP Token:** cdfaa3668ec21439bc6acd2243abd6df701177e8 (updated in .claude.json, needs restart to take effect)
-
-## Uncommitted Files
-
- .planning/STATE.md (modified)
- apps/desktop/src-tauri/Cargo.lock (untracked, should be committed)
- apps/desktop/src-tauri/gen/ (untracked, Tauri generated)
-
-## Critical Anti-Patterns
-
-| Anti-Pattern | Severity | Detail |
-|-------------|----------|--------|
-| pnpm/action-setup incompatible with Gitea Actions | advisory | Use corepack instead — already fixed |
-| Prisma types missing in CI | advisory | postinstall added — verify Run #87 |
@@ -0,0 +1,87 @@
+---
+phase: 06-desktop-client-ci-cd
+plan: 02
+subsystem: desktop
+tags: [tauri, tray, autostart, window-state, notification, version-check, appimage]
+
+requires:
+  - phase: 06-desktop-client-ci-cd
+    plan: 01
+    provides: Tauri scaffold with server URL persistence
+provides:
+  - System tray with close-to-tray behavior
+  - Window state persistence (size/position)
+  - Autostart plugin registration
+  - Startup version check with native notification
+  - GET /health/version API endpoint
+  - AppImage production bundle
+affects: [desktop user experience, API health module]
+
+tech-stack:
+  added: [tauri-plugin-notification, tauri-plugin-autostart, tauri-plugin-window-state, reqwest]
+  patterns: [close-to-tray, prevent-exit, async-version-check]
+
+key-files:
+  modified:
+    - apps/desktop/src-tauri/src/lib.rs
+    - apps/desktop/src-tauri/Cargo.toml
+    - apps/desktop/src-tauri/capabilities/default.json
+    - apps/api/src/health/health.controller.ts
+  created:
+    - apps/desktop/src-tauri/icons/icon.png
+    - apps/desktop/src-tauri/icons/icon.ico
+    - apps/desktop/src-tauri/icons/128x128.png
+
+key-decisions:
+  - "Both prevent_close (CloseRequested) AND prevent_exit (ExitRequested) per Pitfall 2"
+  - "Async version check via reqwest — non-blocking, fire-and-forget"
+  - "German tray labels: Oeffnen / Beenden"
+  - "ImageMagick for icon generation (tauri icon not available headless)"
+  - "NSIS target configured but only AppImage built (no Windows cross-compile toolchain)"
+
+patterns-established:
+  - "Close-to-tray: on_window_event hide + prevent_close, RunEvent::ExitRequested prevent_exit, tray quit -> app.exit(0)"
+  - "Version check: spawn async task in setup, GET {server_url}/health/version, compare CARGO_PKG_VERSION"
+
+requirements-completed: [DESK-01, DESK-02]
+
+duration: 8min
+completed: 2026-06-25
+---
+
+# Phase 06 Plan 02: Native Desktop Features Summary
+
+**Tray, close-to-tray, window-state, autostart, version check, branded icons, AppImage bundle**
+
+## Performance
+
+- **Duration:** 8 min
+- **Commit:** c65ada0
+- **Tasks:** 4 completed (3 auto + 1 build verification)
+- **Files modified:** 4, icons generated: 3
+
+## Accomplishments
+
+- API GET /health/version endpoint (public, no auth)
+- Tray icon with context menu (Oeffnen/Beenden) and left-click show
+- Close-to-tray with both prevent_close and prevent_exit guards
+- Window state persistence via tauri-plugin-window-state
+- Autostart plugin registered with capability permissions
+- Async startup version check with native notification on mismatch
+- Tessera-branded icon (yellow T on dark bg, OKLCH palette)
+- AppImage built: Tessera_0.0.1_amd64.AppImage
+
+## Deviations from Plan
+
+- Icons generated with ImageMagick instead of `tauri icon` (headless environment)
+- NSIS bundle configured but not built (no Windows cross-compile toolchain on Linux host)
+
+## Self-Check: PASSED
+
+- cargo check passes with all 4 plugins
+- API type-check passes
+- AppImage produced at target/release/bundle/appimage/
+
+---
+*Phase: 06-desktop-client-ci-cd*
+*Completed: 2026-06-25*