umutkeltek/healthsave-observatory v1.1.0

HealthSave Observatory v1.1.0

on GitHub

The first tagged release since 1.0.0. It contains everything built since May,
including the ingest fixes that came from HealthSave iOS users' reports.

Upgrade

git fetch --tags
git checkout v1.1.0
docker compose up -d --build

The migrate service applies migrations 001 to 027 before the API starts.
Every migration is additive: no table is renamed or dropped, and existing rows
are kept. Read the R1 and R2 notes in UPGRADING.md before
upgrading an install that started on 1.0.0.

Fixed

• Concurrent uploads that revise the same sample, under a new uuid or with a
  changed device or source attribution, no longer reject their batch.
• Database deadlocks and serialization failures are answered as retryable
  server errors instead of 422, so the app retries the batch instead of
  giving up on it.
• A sample that HealthKit revises under a new uuid at the same timestamp no
  longer rejects its batch.
• A workouts or sleep batch from two devices reaches the v1 tables again.
• GET /api/apple/coverage answers per wire metric, in the shape the app
  decodes.
• Current Apple unit strings are accepted; mixed-source device attribution is
  kept; revised HealthKit daily totals replace the old value safely; duplicate
  conflict keys inside one batch are merged before the upsert.
• A deterministic bad payload is answered 422, never 500. Clients retry
  5xx indefinitely, so a deterministic 500 blocked a metric for good.
• Request bodies, batches and exports have size limits.

Added

• POST /api/v2/apple/batch (HealthSave iOS 1.7.2 and later): each sample
  carries its HealthKit uuid, interval bounds and unit; deletions travel with
  the batch; iOS 1.8.0 and later declare whether a value is one sample or a
  day total.
• A canonical observation store with a source, device and stream registry,
  read through /api/v2/*: metrics, series, receipts, changes, insights,
  readiness, privacy, experiments, moments and settings.
• The HealthSave Observatory web app (apps/web).
• Sync accounting: delivery receipts, sync run summaries
  (/api/v2/sync/runs/*) and GET /api/apple/coverage for the app's recovery
  lane.
• Medication dose events and heartbeat series (the beat-to-beat data behind
  an HRV reading, sent by iOS 1.8.5 and later when switched on).
• Statistical findings and a weekly Body Brief. Narration is optional; cloud
  providers are opt-in and receive derived findings only, never raw rows.
• A Home Assistant MQTT bridge with its own namespace and a liveness watchdog.
• Authorization helpers for Whoop, Polar, Google Health and Amazfit, and
  importers for Garmin and Samsung exports (scripts/).
• Release discipline: this changelog, RELEASING.md and a
  release gate that refuses a tag whose version disagrees with the code.

Docs

• uuid is required on every anchored sample, medication dose events
  included (#45).

Compatibility

• The routes the App Store app depends on are unchanged: POST /api/apple/batch,
  GET /api/apple/status and GET /api/health.
• Every HealthSave iOS release can still sync over v1. iOS 1.7.2 and later use
  the v2 batch route when the server offers it. Use the current App Store
  release; its sync repairs work together with the server fixes above.