Troubleshooting Health.md
Start with one device, one day, one category, and one destination. Do not publish health data, routes, clinical documents, tokens, pairing codes, or private paths.
Empty data
Section titled “Empty data”Confirm the value in Apple Health or Health Connect, review permission, and export one category for one day. Distinguish complete_empty, missing permission, unsupported, skipped, partial, and failed. Missing is not zero.
Sleep is missing from Today
Section titled “Sleep is missing from Today”Sleep belongs to the day on which the night began. On Tuesday morning, export Yesterday, or Monday and Tuesday. See Sleep dates.
Files and schedules
Section titled “Files and schedules”Check the vault, folder access, subfolder, template, and profile. iOS background work and Android WorkManager use target times, not universal guarantees. Unlock the device and use pending recovery.
CLI timeout
Section titled “CLI timeout”A timeout does not cancel an accepted job:
healthmd status --job JOB_UUIDhealthmd resume JOB_UUID --timeout 300Before claiming completeness, inspect status, missing dates, coverage, next_cursor, version, and limitations. --allow-partial changes exit policy only.