# UptimeWing

UptimeWing is a high-performance, edge-first website uptime monitoring and autonomous remediation platform. It is built to ensure digital services stay online through global consensus validation and automated recovery loops.

## Core Services & Capabilities

### 1. Global Edge Consensus (Outage Verification)
UptimeWing runs multi-region consensus auditing to eliminate false alerts caused by transient network congestion or localized routing issues.
* **Mechanism**: When a primary edge node detects a failure (e.g. 503 Service Unavailable), the Sentinel engine dispatches validation intents to neighboring nodes (e.g. LHR, IAD, SIN, FRA). 
* **Consensus Rules**: An outage alert is triggered only if multiple independent edge nodes ($N \ge 2$) confirm the downtime. If consensus fails, the event is marked as a transient regional anomaly.

### 2. Autonomous Remediation (Auto-Restart Webhooks)
Rather than just alerting teams of downtime, UptimeWing can execute automated self-healing workflows.
* **Mechanism**: Upon consensus outage confirmation, the system dispatches secure POST webhook payloads to designated cloud provider endpoints (Vercel, Render, Railway, or custom servers).
* **Usage**: Triggers automated deployment restarts, container reboots, or server spin-ups without manual intervention.

### 3. L4 Connectivity Forensics & RTT Analysis
UptimeWing measures latencies across the connection lifetime:
* **DNS Resolution**: Time elapsed resolving hostnames to IP addresses at the edge.
* **TCP Connection RTT**: Raw network transit latency for TCP handshake (SYN/ACK).
* **TTFB (Time to First Byte)**: Application-level latency introduced before server starts streaming data.

### 4. TLS/SSL Chain Intelligence
UptimeWing continuously monitors SSL/TLS security health:
* **Leaf & Chain Tracking**: Checks both leaf certificates and the full intermediate trust path.
* **Alerting**: Proactively flags revoked intermediates, cipher mismatch vulnerabilities, OCSP stapling issues, and upcoming leaf certificate expirations.

### 5. Heartbeat Protocol (Cron & Backend Auditing)
For monitoring private cron jobs, internal microservices, or background scripts unreachable via public HTTP:
* **Passive Pings**: Services ping UptimeWing's pulse endpoint. If the pulse stops within the configured window, alerts are triggered.
* **Endpoint**: `POST https://pulse.uptimewing.com/v1/heartbeat/{TOKEN}`

---

## Quota & Subscription Tiers

### Free Tier ($0/mo)
* **Monitors**: 3 active monitors
* **Check Interval**: 60-second resolution
* **Alerting**: Discord, Slack, and Telegram notifications
* **Remediation**: SSL & DNS monitoring, auto-restart triggers
* **History**: 7-day failure diagnostics history

### Founder Tier ($5/mo - $4/mo Launch Offer)
* **Monitors**: 100 active monitors
* **Check Interval**: 60-second resolution
* **Alerting**: Priority channels with customized SMTP relays
* **Remediation**: Full auto-restart stack integration, priority edge scheduling
* **Status Pages**: Custom status page domains, CNAME routing, white-label branding, saved layouts (Brutalist, Minimal, Classic, Grid)
* **Advanced Engine Controls**: Consensus region sensitivity adjustments (1-3 regions), retry blip protection (1-5 attempts), maintenance window scheduling
* **History**: 90-day comprehensive incident analytics

---

## Key Integrations

* **Discord**: Standard webhook integration for alert channels.
* **Telegram**: Direct bot alert configuration.
* **Slack**: Notification channels.
* **GitHub & Vercel**: Deployment lifecycle hook integrations.