2001105254-netizen/RacePulsePH / .agents/skills/racepulse-observability
racepulse-observability
VerifiedImplement and verify RacePulsePH health checks, LAN/bridge liveness status, structured credential-safe logging, operational diagnostics and error-rate alerts. Use when adding logging, health endpoints, bridge diagnostics or monitoring checks.
RacePulse observability, logging and health probes
Make failures in Cloud Functions, SMTP delivery, PayMongo webhooks, the LAN server (server.ts) and the RFID bridge (rfid-bridge/) immediately diagnosable without leaking secrets or runner PII.
Load with: racepulse-access. Rules upheld: C-2, C-4, C-5, R-02, R-27, R-35, R-36. Detail: health probes, logging and SLI checklist.
Checklist
| Check | Reason | Evidence |
|---|---|---|
Surface real-time LAN connectivity (lanConnected in src/lib/dualSync.ts) and pending offline scan counts (pendingCount, queueError in src/lib/offlineScanQueue.ts) in operator screens | Timing operators on course need immediate visual notice when the LAN server or cloud sync drops (R-27) | Inspect useDualSync in src/lib/dualSync.ts and useOfflineScanQueue in src/lib/offlineScanQueue.ts |
Emit structured diagnostic context (paymentId, route, category) in Cloud Functions logs while stripping tokens, codes, passwords, request bodies and raw SMTP errors | Raw SMTP or auth errors can leak credentials or 6-digit verification codes into Cloud Logging | Inspect console.error in functions/auth-api.js line 58, functions/account-security.js line 74 and functions/index.js lines 237 and 310 |
Preserve RFID bridge diagnostic fields (bridgeEventId, readerSequence, monotonicTicks, monotonicFrequency, clockSource, antenna, receivedAt) through server.ts | Gives operators verifiable evidence to audit burst reads, dropped sequence numbers or reader reconnects (docs/finish-precision.md) | Inspect ChipRead and RfidBridgeEvent interfaces in server.ts lines 23 to 58 |
Provide deterministic CLI diagnostic scripts (scripts/check-account-email.cjs, scripts/preview-account-emails.cjs, scripts/smoke-access.cjs) for pre-race readiness checks | Lets operators verify SMTP configuration and access endpoints before race morning | Inspect scripts/check-account-email.cjs and scripts/smoke-access.cjs |
| Define SLIs and SLO targets only from owner-approved requirements and never fabricate uptime or accuracy claims in UI copy | Invented SLA percentages or accuracy claims violate R-36 and C-5 | Grep src/ and docs/ for uptime or accuracy claims and confirm compliance with docs/finish-precision.md |
Stack mapping
- Liveness and readiness probes map to
lanConnectedinsrc/lib/dualSync.ts,accessApi/sessionchecks inserver.tsandsrc/lib/offlineScanQueue.ts, andscripts/smoke-access.cjs. - Distributed correlation across the RFID reader, LAN server and Firestore uses
bridgeEventId,readerSequenceandpaymentId.
Not covered
- Backup schedules and offline recovery procedures belong to
racepulse-reliability-dr.
Verify
- Run
npm run lintand inspect everyconsole.log,console.warnandconsole.errorinfunctions/andserver.tsfor secret or PII leakage. - Output the PASS/FAIL report with log-safety evidence 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 |