Skip to content
KnearMe Developer Docs

KnearMe Portfolio Operations Runbook

Health checks

Section titled “Health checks”
  • Production: https://knearme.co/api/health
  • Staging: https://staging.knearme.co/api/health

Incident triage sequence

Section titled “Incident triage sequence”
  1. Confirm current deploy SHA in Vercel.
  2. Check API health endpoint status.
  3. Inspect recent changes in portfolio and edge worker routes.
  4. Determine whether issue is app runtime, edge route ownership, or external provider outage.

Edge-coupled incident handling

Section titled “Edge-coupled incident handling”

If failure affects edge-owned API routes:

  1. Check apps/knearme-edge deployment and route ownership.
  2. Temporarily disable affected Cloudflare route ownership to return traffic to origin.
  3. Re-validate /api/health and impacted write paths.

Rollback strategy

Section titled “Rollback strategy”
  • Vercel rollback to last known good deployment for app issues.
  • Route-level rollback in Cloudflare for edge interception issues.

Escalation references

Section titled “Escalation references”
  • apps/knearme-edge/docs/PRODUCTION_CUTOVER_RUNBOOK.md
  • docs/engineering/exec-plans/staging-production-environments-execplan.md