| name | sync-health-config |
| description | Synchronize health analysis configuration between web and iOS platforms. Use when updating gait thresholds, fall risk parameters, or health scoring configs. Ensures web and iOS stay in sync. |
| argument-hint | Config type: gait, fall-risk, or all |
Sync Health Configuration
When to Use
- Update gait analysis thresholds or momentum calculations
- Change fall risk scoring parameters
- Sync configuration between web app and iOS app
- After modifying
gaitConfig.ts or fallRiskConfig.ts
Procedure
1. Review Current Config
Check the source-of-truth configs:
- Gait:
src/lib/gaitConfig.ts, src/lib/gaitMomentum.ts, src/lib/gaitTrends.ts
- Fall risk:
src/lib/fallRiskConfig.ts
2. Make Changes
Edit the TypeScript config files. All threshold values should have clear comments explaining clinical significance.
3. Run Sync Scripts
Sync gait configuration:
pnpm run gait:sync
Sync fall risk configuration:
pnpm run fallrisk:sync
Or sync both:
pnpm run analytics:sync
4. Verify iOS Side
Check that synced values propagated to iOS:
ios/HealthKitBridge/ — WebSocket message schemasios/Sources/VitalSenseCore/ — core config values
5. Test
- Run web tests:
pnpm test
- Run iOS tests via Xcode or
make test in ios/Andernet-Posture/
- Verify thresholds produce expected scoring in both platforms
Key Files
| File | Purpose |
|---|
src/lib/gaitConfig.ts | Gait thresholds and parameters |
src/lib/fallRiskConfig.ts | Fall detection thresholds |
scripts/analysis/gait/sync-gait-config.js | Gait sync script |
scripts/analysis/fall/sync-fall-risk-config.js | Fall risk sync script |
