2001105254-netizen/RacePulsePH / .agents/skills/racepulse-reliability-dr
racepulse-reliability-dr
VerifiedMaintain RacePulsePH race-day continuity across network partitions, local JSON persistence, monotonic clock skew protection, 7-digit BigInt tick precision and incident recovery. Use when editing timing calculations, server.ts storage, rfid-bridge, rfid-station or recovery scripts.
RacePulse race-day reliability and disaster recovery
Keep checkpoint timing, finisher rankings and engraving orders accurate when venue internet drops, processes restart or clocks drift. Covers src/lib/preciseTime.ts, src/lib/liveRankings.ts, src/lib/entrySequence.ts, server.ts, rfid-bridge/ and rfid-station/.
Load with: racepulse-data-integrity, racepulse-resilience-patterns. Rules upheld: C-2, C-4, C-5, R-02, R-35, R-36. Detail: partition survival, clock precision and recovery checklist.
Checklist
| Check | Reason | Evidence |
|---|---|---|
Persist LAN server state to disk (local_orders.json, local_chip_reads.json, local_rfid_events.json) inside user-writable RACEPULSE_DATA_DIR | Timing Station.exe runs under Program Files where normal writes fail unless redirected to a writable directory | Inspect DATA_DIRECTORY, saveDB, saveChipReadsDB and saveRfidEventsDB in server.ts lines 65 to 150 |
Survive venue internet partitions by combining src/lib/offlineScanQueue.ts (localStorage) with src/lib/dualSync.ts (LAN + Firestore merge) | Remote trail and road checkpoints frequently lose cellular connectivity during a race | Inspect useOfflineScanQueue (src/lib/offlineScanQueue.ts) and useDualSync (src/lib/dualSync.ts) |
Parse and rank timestamps with BigInt 100-nanosecond ticks (timestampTicks in src/lib/preciseTime.ts) and never pass raw epoch ticks through Number or Date | JavaScript Date truncates to 3 millisecond digits and Number loses sub-millisecond precision | Inspect timestampTicks, elapsedSeconds and formatElapsed in src/lib/preciseTime.ts and finishScanOrder in src/lib/liveRankings.ts |
Preserve sporting ties on equal elapsed times (1, 1, 3) and never break an official placing tie by bib number (docs/finish-precision.md) | Breaking an exact time tie by bib number fabricates a winner without timing evidence (C-5, R-36) | Inspect docs/finish-precision.md and run node --test tests/timing-sequence.test.cjs |
Retain monotonic clock diagnostics (monotonicTicks, monotonicFrequency, clockSource) and reject negative elapsed durations (b < a returns undefined) | Protects results against wall-clock NTP jumps on the Windows timing laptop | Inspect elapsedSeconds (`if (a === undefined |
Keep scan undo/re-entry and consecutive-entry recalculation (src/lib/entrySequence.ts) non-destructive | Operators must be able to correct an erroneous scan during a race incident without corrupting linked bibs | Inspect src/lib/entrySequence.ts and docs/live-rankings.md |
Stack mapping
- Network partitions map to venue cellular blackouts handled by
src/lib/offlineScanQueue.ts,src/lib/dualSync.tsandserver.ts. - Clock skew and precision map to
src/lib/preciseTime.ts,rfid-bridge/RfidBridgeService.csanddocs/finish-precision.md.
Not covered
- Cloud Functions rate limiting and PayMongo webhook retries belong to
racepulse-resilience-patterns.
Verify
- Run
node --test tests/timing-sequence.test.cjsandnpm run lint. - Output the PASS/FAIL report with test results, precision checks and a 1-line purpose log.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |