docs/geographic-convergence.mdx
One of the most valuable intelligence signals is when multiple independent data streams converge on the same geographic area. This often precedes significant events.
The system maintains a real-time grid of geographic cells (1° x 1° resolution). Each cell tracks four event types:
| Event Type | Source | Detection Method |
|---|---|---|
| Protests | ACLED/GDELT | Direct geolocation |
| Military Flights | OpenSky | ADS-B position |
| Naval Vessels | AIS stream | Ship position |
| Earthquakes | USGS | Epicenter location |
When 3 or more different event types occur within the same cell during a 24-hour window, a convergence alert is generated.
type_score = event_types × 25 # Max 100 (4 types)
count_boost = min(25, total_events × 2)
convergence_score = min(100, type_score + count_boost)
The detector only emits convergence alerts after 3+ distinct event types are present in a cell. The Strategic Risk alert priority layer then classifies the alert using both type diversity and score:
| Types Converging | Score Range | Alert Priority |
|---|---|---|
| 4 types | 100 | Critical |
| 3 types with high event count | 90-100 | Critical |
| 3 types with lower event count | 81-89 | High |
The shared priority helper still has a defensive medium branch for scores
>=50, but current detector output does not reach it because emitted alerts
must already have at least 3 event types.
Taiwan Strait Buildup
25°N, 121°EMiddle East Flashpoint
32°N, 35°EIndividual data points are often noise. But when protests break out, military assets reposition, and seismic monitors detect anomalies in the same location simultaneously, it warrants attention, regardless of whether any single source is reporting a crisis.