mirror of
https://github.com/zvx-echo6/meshai.git
synced 2026-06-11 01:14:45 +02:00
373 lines
14 KiB
Python
373 lines
14 KiB
Python
"""v0.7-fire-tracker-2 tests.
|
|
|
|
Coverage map (vs user-provided scope item 8 + an integration probe):
|
|
- 2-pass attribution with pass2 1.0 mi N of pass1 -> fire_passes row,
|
|
drift_mi=1.0, drift_direction='N', drift_mi_per_hour computed,
|
|
wildfire_growth wire returned with correct movement vector.
|
|
- last_pass_at 14h ago + no new pixels -> halt detector fires once,
|
|
halt_broadcast_at stamped.
|
|
- Re-run halt detector with no state change -> NO second broadcast.
|
|
- Drift below threshold (0.3 mi) -> NO wildfire_growth broadcast.
|
|
|
|
Plus:
|
|
- Bearing/direction helper sanity.
|
|
- Pass-aggregate fields (centroid/count/total_frp/started/ended) match.
|
|
- Halt re-eligibility after a halted fire receives a new pixel.
|
|
- categories + adapter_config seed verification.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import time
|
|
import uuid
|
|
|
|
import pytest
|
|
|
|
|
|
@pytest.fixture(autouse=True)
|
|
def _isolate_db(tmp_path, monkeypatch):
|
|
db_path = str(tmp_path / f"meshai-{uuid.uuid4().hex}.sqlite")
|
|
monkeypatch.setenv("MESHAI_DB_PATH", db_path)
|
|
from meshai.persistence import db as pdb
|
|
pdb.close_thread_connection()
|
|
pdb._initialised.discard(db_path)
|
|
from meshai.persistence import init_db
|
|
init_db(db_path)
|
|
yield db_path
|
|
pdb.close_thread_connection()
|
|
pdb._initialised.discard(db_path)
|
|
|
|
|
|
def _seed_fire(*, irwin_id, lat, lon, name="Stub Fire"):
|
|
from meshai.persistence import get_db
|
|
conn = get_db()
|
|
conn.execute(
|
|
"INSERT INTO fires(irwin_id, incident_name, lat, lon, last_event_at) "
|
|
"VALUES (?,?,?,?,?)",
|
|
(irwin_id, name, lat, lon, int(time.time())),
|
|
)
|
|
|
|
|
|
def _envelope(*, lat, lon, acq_date="2026-06-06", acq_time="1200",
|
|
frp=20.0, satellite="N20"):
|
|
return {
|
|
"data": {
|
|
"adapter": "firms",
|
|
"category": "wildfire_hotspot",
|
|
"severity": "routine",
|
|
"data": {
|
|
"latitude": lat, "longitude": lon, "frp": frp,
|
|
"bright_ti4": 320.0, "satellite": satellite,
|
|
"instrument": "VIIRS", "confidence": "high",
|
|
"acq_date": acq_date, "acq_time": acq_time,
|
|
"daynight": "D", "version": "2.0NRT",
|
|
},
|
|
}
|
|
}
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# (a) 2-pass growth broadcast.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def test_two_pass_drift_emits_growth_with_direction_and_speed():
|
|
"""Pass 1 (N20 bucket A), pass 2 (N20 bucket B, ~6h later, centroid
|
|
1.0 mi N of pass 1). Drift should be ~1.0 mi N, broadcast must fire."""
|
|
from meshai.central.firms_handler import handle_firms
|
|
from meshai.persistence import get_db
|
|
|
|
_seed_fire(irwin_id="ID-GROWTH-001",
|
|
lat=42.000, lon=-114.000,
|
|
name="Pine Gulch")
|
|
|
|
# Pass A epoch: 2026-06-06 12:00 UTC = 1780747200
|
|
# Pass B epoch: 2026-06-06 18:00 UTC = 1780768800 (6h later)
|
|
pass_a_lat = 42.000
|
|
pass_b_lat = pass_a_lat + (1.0 / 69.0) # 1.0 mi N: 1 deg ~ 69 mi
|
|
|
|
# Pass A pixels (5 pixels tightly clustered around (42.000, -114.000)).
|
|
for i in range(5):
|
|
env = _envelope(
|
|
lat=pass_a_lat + 0.0001 * i,
|
|
lon=-114.000 + 0.0001 * (i - 2),
|
|
acq_date="2026-06-06", acq_time=f"{12:02d}{0 + i:02d}",
|
|
frp=20.0 + i, satellite="N20",
|
|
)
|
|
handle_firms(env, subject="central.fire.hotspot.N20.high.us.id",
|
|
data={}, now=1780747200 + i)
|
|
|
|
# First pixel of pass B fires the growth broadcast.
|
|
env_b_first = _envelope(
|
|
lat=pass_b_lat, lon=-114.000,
|
|
acq_date="2026-06-06", acq_time="1800",
|
|
frp=22.0, satellite="N20",
|
|
)
|
|
data_b = {}
|
|
wire = handle_firms(
|
|
env_b_first, subject="central.fire.hotspot.N20.high.us.id",
|
|
data=data_b, now=1780768800,
|
|
)
|
|
assert wire is not None, "pass-B boundary should fire growth broadcast"
|
|
assert "Moving N" in wire, f"expected N direction, got: {wire}"
|
|
assert data_b.get("category") == "wildfire_growth"
|
|
assert data_b.get("_severity_override") == "immediate"
|
|
assert wire.startswith("🔥 Pine Gulch")
|
|
|
|
conn = get_db()
|
|
passes = conn.execute(
|
|
"SELECT * FROM fire_passes WHERE irwin_id=? ORDER BY pass_ended_at",
|
|
("ID-GROWTH-001",),
|
|
).fetchall()
|
|
assert len(passes) == 2
|
|
# Pass B has drift filled in.
|
|
pass_b = passes[1]
|
|
assert pass_b["drift_mi_from_prev"] == pytest.approx(1.0, rel=0.05)
|
|
assert pass_b["drift_direction"] == "N"
|
|
# Speed = 1 mi / 6 hours = 0.166... mph
|
|
assert pass_b["drift_mi_per_hour"] == pytest.approx(1.0 / 6.0, rel=0.05)
|
|
# The fire's last_pass_id updated to pass B's bucket.
|
|
fires_row = conn.execute(
|
|
"SELECT last_pass_id, current_centroid_lat, current_centroid_lon "
|
|
"FROM fires WHERE irwin_id=?", ("ID-GROWTH-001",),
|
|
).fetchone()
|
|
assert fires_row["last_pass_id"] == pass_b["pass_id"]
|
|
# current_centroid_* now reflects pass B (overrides Phase 1 24h median).
|
|
assert fires_row["current_centroid_lat"] == pytest.approx(pass_b_lat,
|
|
rel=1e-4)
|
|
|
|
|
|
def test_drift_below_threshold_does_not_emit_growth():
|
|
"""0.3 mi drift between consecutive passes -- below the 0.5 mi
|
|
default -- must NOT broadcast wildfire_growth."""
|
|
from meshai.central.firms_handler import handle_firms
|
|
from meshai.persistence import get_db
|
|
|
|
_seed_fire(irwin_id="ID-DRIFT-001",
|
|
lat=43.000, lon=-115.000,
|
|
name="Quiet Fire")
|
|
|
|
# Pass A: 3 pixels.
|
|
for i in range(3):
|
|
env = _envelope(lat=43.000 + 0.0001 * i, lon=-115.000,
|
|
acq_time=f"{12:02d}{i:02d}",
|
|
frp=15.0, satellite="N20")
|
|
handle_firms(env, subject="central.fire.hotspot.N20.high.us.id",
|
|
data={}, now=1780747200 + i)
|
|
|
|
# Pass B: 0.3 mi N (below threshold).
|
|
pass_b_lat = 43.000 + (0.3 / 69.0)
|
|
env_b = _envelope(lat=pass_b_lat, lon=-115.000,
|
|
acq_time="1800", frp=15.0, satellite="N20")
|
|
data_b = {}
|
|
wire = handle_firms(env_b, subject="central.fire.hotspot.N20.high.us.id",
|
|
data=data_b, now=1780768800)
|
|
assert wire is None, f"sub-threshold drift should NOT broadcast: {wire}"
|
|
assert data_b.get("category") != "wildfire_growth"
|
|
# The pass row still exists with the (sub-threshold) drift recorded.
|
|
pass_b = get_db().execute(
|
|
"SELECT drift_mi_from_prev, drift_direction FROM fire_passes "
|
|
"WHERE irwin_id=? ORDER BY pass_ended_at DESC LIMIT 1",
|
|
("ID-DRIFT-001",),
|
|
).fetchone()
|
|
assert pass_b["drift_mi_from_prev"] == pytest.approx(0.3, rel=0.1)
|
|
assert pass_b["drift_direction"] == "N"
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# (b) Halt detection.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def test_halt_detector_fires_once_after_12h_idle():
|
|
"""Fire with last_pass_at 14h ago + no new pixels in that fire
|
|
triggers halt on the next FIRMS pixel arrival (for any fire)."""
|
|
from meshai.central.firms_handler import handle_firms, _maybe_emit_halt
|
|
from meshai.persistence import get_db
|
|
|
|
now_epoch = 1780768800 # 2026-06-06 18:00 UTC
|
|
fourteen_h_ago = now_epoch - (14 * 3600)
|
|
conn = get_db()
|
|
# Stale fire.
|
|
conn.execute(
|
|
"INSERT INTO fires(irwin_id, incident_name, lat, lon, "
|
|
"last_event_at, last_pass_id, last_pass_at) "
|
|
"VALUES (?,?,?,?,?,?,?)",
|
|
("ID-HALT-001", "Cold Fire", 42.500, -114.500,
|
|
int(fourteen_h_ago), "N20-329627", float(fourteen_h_ago)),
|
|
)
|
|
|
|
data = {}
|
|
wire = _maybe_emit_halt(conn, data=data, now=now_epoch)
|
|
assert wire is not None
|
|
assert "Cold Fire" in wire
|
|
assert "no growth in 14h" in wire
|
|
assert data.get("category") == "wildfire_halted"
|
|
assert data.get("severity") == "routine"
|
|
|
|
# halt_broadcast_at stamped.
|
|
halt_at = conn.execute(
|
|
"SELECT halt_broadcast_at FROM fires WHERE irwin_id=?",
|
|
("ID-HALT-001",),
|
|
).fetchone()[0]
|
|
assert halt_at == float(now_epoch)
|
|
|
|
|
|
def test_halt_detector_no_second_broadcast_for_same_fire():
|
|
"""Once halt_broadcast_at is stamped, the detector skips that fire."""
|
|
from meshai.central.firms_handler import _maybe_emit_halt
|
|
from meshai.persistence import get_db
|
|
|
|
now_epoch = 1780768800
|
|
fourteen_h_ago = now_epoch - (14 * 3600)
|
|
conn = get_db()
|
|
conn.execute(
|
|
"INSERT INTO fires(irwin_id, incident_name, lat, lon, "
|
|
"last_event_at, last_pass_id, last_pass_at, halt_broadcast_at) "
|
|
"VALUES (?,?,?,?,?,?,?,?)",
|
|
("ID-HALT-002", "Already Halted", 42.500, -114.500,
|
|
int(fourteen_h_ago), "N20-329627", float(fourteen_h_ago),
|
|
float(now_epoch - 600)), # halt fired 10 min ago
|
|
)
|
|
|
|
data = {}
|
|
wire = _maybe_emit_halt(conn, data=data, now=now_epoch)
|
|
assert wire is None, f"halt latched fire should NOT re-fire: {wire}"
|
|
|
|
|
|
def test_halt_eligibility_returns_after_new_pass_arrives():
|
|
"""A previously halted fire that receives a new pixel becomes eligible
|
|
for halt again if it goes idle a second time. The detector filter is
|
|
halt_broadcast_at IS NULL OR halt_broadcast_at < last_pass_at."""
|
|
from meshai.central.firms_handler import _maybe_emit_halt
|
|
from meshai.persistence import get_db
|
|
|
|
now_epoch = 1780768800
|
|
conn = get_db()
|
|
# Fire was halted yesterday, then last_pass_at advanced 14h ago.
|
|
conn.execute(
|
|
"INSERT INTO fires(irwin_id, incident_name, lat, lon, "
|
|
"last_event_at, last_pass_id, last_pass_at, halt_broadcast_at) "
|
|
"VALUES (?,?,?,?,?,?,?,?)",
|
|
("ID-HALT-003", "Resurrected", 42.500, -114.500,
|
|
int(now_epoch), "N20-329640",
|
|
float(now_epoch - 14 * 3600), # last pass 14h ago
|
|
float(now_epoch - 24 * 3600)), # halt stamped 24h ago
|
|
)
|
|
# halt_broadcast_at (24h ago) < last_pass_at (14h ago) -> eligible.
|
|
data = {}
|
|
wire = _maybe_emit_halt(conn, data=data, now=now_epoch)
|
|
assert wire is not None
|
|
assert "Resurrected" in wire
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# (c) Helper sanity.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def test_bearing_and_direction_round_trip():
|
|
"""Bearing helper + 8-way mapping cover all cardinals/intercardinals."""
|
|
from meshai.central.firms_handler import _bearing, _direction_8
|
|
# Source point.
|
|
s_lat, s_lon = 42.0, -114.0
|
|
# Each cardinal/intercardinal direction we test by walking ~1 mi.
|
|
delta_deg = 1.0 / 69.0 # ~1 mi in latitude degrees
|
|
cases = [
|
|
("N", s_lat + delta_deg, s_lon),
|
|
("NE", s_lat + delta_deg, s_lon + delta_deg),
|
|
("E", s_lat, s_lon + delta_deg),
|
|
("SE", s_lat - delta_deg, s_lon + delta_deg),
|
|
("S", s_lat - delta_deg, s_lon),
|
|
("SW", s_lat - delta_deg, s_lon - delta_deg),
|
|
("W", s_lat, s_lon - delta_deg),
|
|
("NW", s_lat + delta_deg, s_lon - delta_deg),
|
|
]
|
|
for expected, t_lat, t_lon in cases:
|
|
b = _bearing(s_lat, s_lon, t_lat, t_lon)
|
|
d = _direction_8(b)
|
|
assert d == expected, f"expected {expected} from bearing {b:.1f}, got {d}"
|
|
|
|
|
|
def test_direction_8_boundary_cases():
|
|
from meshai.central.firms_handler import _direction_8
|
|
# Bearings on the boundary -- check the +22.5 offset rounds correctly.
|
|
assert _direction_8(0.0) == "N"
|
|
assert _direction_8(22.4) == "N"
|
|
assert _direction_8(22.6) == "NE"
|
|
assert _direction_8(67.4) == "NE"
|
|
assert _direction_8(67.6) == "E"
|
|
assert _direction_8(359.9) == "N"
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# (d) Adapter_config + categories.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def test_adapter_config_seeds_phase2_keys():
|
|
from meshai.persistence import get_db
|
|
conn = get_db()
|
|
rows = {
|
|
(r["adapter"], r["key"]): r["default_json"]
|
|
for r in conn.execute(
|
|
"SELECT adapter, key, default_json FROM adapter_config "
|
|
"WHERE (adapter, key) IN ( "
|
|
" ('fires','growth_drift_threshold_mi'), "
|
|
" ('fires','halt_passes_threshold'), "
|
|
" ('fires','halt_minimum_seconds') )"
|
|
)
|
|
}
|
|
assert rows[("fires", "growth_drift_threshold_mi")] == "0.5"
|
|
assert rows[("fires", "halt_passes_threshold")] == "2"
|
|
assert rows[("fires", "halt_minimum_seconds")] == "43200"
|
|
|
|
|
|
def test_phase2_categories_registered():
|
|
from meshai.notifications.categories import ALERT_CATEGORIES
|
|
assert ALERT_CATEGORIES["wildfire_growth"]["default_severity"] == "priority"
|
|
assert ALERT_CATEGORIES["wildfire_halted"]["default_severity"] == "routine"
|
|
for cat in ("wildfire_growth", "wildfire_halted"):
|
|
assert ALERT_CATEGORIES[cat]["toggle"] == "fire"
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# (e) Pass aggregate correctness.
|
|
# ---------------------------------------------------------------------------
|
|
|
|
|
|
def test_pass_row_aggregates_match_member_pixels():
|
|
"""5 pixels attributed in the same pass yield ONE fire_passes row
|
|
with pixel_count=5, total_frp = sum, pass_started_at = min(acq),
|
|
pass_ended_at = max(acq), centroid = median."""
|
|
from meshai.central.firms_handler import handle_firms
|
|
from meshai.persistence import get_db
|
|
|
|
_seed_fire(irwin_id="ID-AGG-001",
|
|
lat=42.000, lon=-114.000,
|
|
name="Aggregator")
|
|
|
|
pixels = [
|
|
(42.000, -114.000, "1200", 10.0),
|
|
(42.001, -114.001, "1205", 20.0),
|
|
(42.002, -114.002, "1210", 30.0),
|
|
(42.003, -114.003, "1215", 40.0),
|
|
(42.004, -114.004, "1220", 50.0),
|
|
]
|
|
for la, lo, t, frp in pixels:
|
|
env = _envelope(lat=la, lon=lo, acq_time=t, frp=frp,
|
|
satellite="N20")
|
|
handle_firms(env, subject="central.fire.hotspot.N20.high.us.id",
|
|
data={}, now=1780747200)
|
|
|
|
row = get_db().execute(
|
|
"SELECT pixel_count, total_frp, pass_centroid_lat, "
|
|
"pass_centroid_lon, pass_started_at, pass_ended_at "
|
|
"FROM fire_passes WHERE irwin_id=?", ("ID-AGG-001",),
|
|
).fetchone()
|
|
assert row["pixel_count"] == 5
|
|
assert row["total_frp"] == pytest.approx(150.0)
|
|
# Median of 5 sorted lats = middle = 42.002.
|
|
assert row["pass_centroid_lat"] == pytest.approx(42.002, abs=1e-6)
|
|
# pass_started_at corresponds to acq 1200 = 2026-06-06 12:00 = 1780747200
|
|
assert row["pass_started_at"] == 1780747200.0
|
|
assert row["pass_ended_at"] == 1780747200.0 + 20 * 60 # +20 minutes
|