Error Handling & Monitoring — Integration Document

Status: ✅ Complete
Last Updated: 2026-03-14

---

​

Overview

PF-07 provides platform-wide error handling, structured logging, and performance monitoring infrastructure. All cores consume these services through the @/platform/monitoring barrel.

---

​

Exported APIs

Import path: @/platform/monitoring

---

​

Integration Points

​

All Cores → PF-07

Every core uses:

• logger for structured logging (module prefix identifies the core)
• ErrorBoundary for crash isolation
• sanitizeErrorMessage() (from @/shared/lib/error-utils) for user-facing errors

​

PF-07 → Sentry

• Errors, traces, replays, and structured logs are sent to Sentry
• PHI is scrubbed in beforeSend before events leave the browser
• Source maps are uploaded via @sentry/vite-plugin during CI/CD

​

PF-07 → pf_health_metrics

• performanceMonitor flushes page load, custom mark, and API metrics to pf_health_metrics in Supabase

---

​

Cross-Core Dependencies

---

​

Related Documents

• MONITORING_RUNBOOK.md — Operational procedures
• Developer Guide: monitoring.md — Developer usage guide
• PF-07 Spec — Expansion spec