From 32b44d170686d2b08df64cfef8484973930295cf Mon Sep 17 00:00:00 2001 From: Jer Miller Date: Mon, 13 Jul 2026 07:26:49 -0600 Subject: [PATCH] Clarify health card stream registration docs Update the Import Streams section after the health card registry change. It now distinguishes registry/exclusion from writer implementation: Oura's import.oura stream is registered and already excluded from sense/think/entities, but still lacks a writer. Also state that code resolves stream names from health_schema.HEALTH_CARD_STREAM_BY_FAMILY rather than hardcoding them, while the prose remains descriptive of current registry values. --- docs/health_imports.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/health_imports.md b/docs/health_imports.md index d65893682..8c0f711e4 100644 --- a/docs/health_imports.md +++ b/docs/health_imports.md @@ -48,15 +48,17 @@ Apple Health records are assigned to the local calendar day encoded in each reco ## Import Streams -The declaring registry is `health_schema.HEALTH_CARD_STREAM_BY_FAMILY`. - -The Apple Health summary stream name is `import.apple_health`. - -Later source-specific streams can be added only after privacy preflight and save-mode tests exist: - -- `import.oura` -- `import.dexcom_clarity` -- `import.health_auto_export` +`health_schema.HEALTH_CARD_STREAM_BY_FAMILY` is the single declaring registry +for health card streams; code resolves stream names from it rather than +hardcoding them. Registering a family's card stream there excludes it from +sense/think/entities before any writer exists, protecting derived summaries +ahead of the code that writes them. + +Today `apple_health` declares `import.apple_health` (writer shipped), `oura_api` +declares `import.oura` (registered and excluded; no writer yet), and +`dexcom_clarity` declares no card stream. A new health source that writes a day +card needs exactly one registry edit; privacy preflight and save-mode tests still +gate shipping the writer. ## Dedupe Boundary -- 2.51.2