Health endpoints

Method	Path	Auth	Description
GET	`/healthz`	none	Liveness. Returns `200 ok` if the process is up. Used by Cloud Run probes.
GET	`/readyz`	none	Readiness. `200` when the portal is reachable; `503` otherwise. Result is cached for ~30s on success / ~5s on failure.

Versioning

The portal exposes GET /api/v1/version (public, CDN-cached) which the desktop app polls on launch:

{
  "portalVersion": "1.0.0-beta.1",
  "latestDesktopVersion": "1.0.0-beta.1",
  "minDesktopVersion": "1.0.0-beta.1",
  "downloadUrls": {
    "win": "https://insightomate.lunamic.co/downloads/windows/insight-o-mate-1.0.0-beta.1-x64.exe",
    "mac": "https://insightomate.lunamic.co/downloads/mac/insight-o-mate-1.0.0-beta.1-arm64.dmg",
    "linuxAppImage": "https://insightomate.lunamic.co/downloads/linux/insight-o-mate-1.0.0-beta.1-x86_64.AppImage",
    "linuxDeb": "https://insightomate.lunamic.co/downloads/linux/insight-o-mate-1.0.0-beta.1-amd64.deb"
  },
  "releaseNotesUrl": "https://insightomate.lunamic.co/changelog/v1.0.0-beta.1"
}

minDesktopVersion is a soft contract — clients below it must show a hard-block update banner because future server-side changes may break them. The current /api/analyze itself does not yet enforce a minimum client version, but reserves the right to return 426 Upgrade Required in a future release.