# Educational scalar alarm model. MIT License; LCENJ, 2026.
import math, json, csv
from pathlib import Path

def update_alarm(was_on, temperature_c, valid, low=28.0, high=30.0):
    if not (math.isfinite(low) and math.isfinite(high) and low < high):
        raise ValueError("invalid thresholds")
    if not valid or not math.isfinite(temperature_c):
        return was_on, False
    if was_on:
        return temperature_c > low, True
    return temperature_c >= high, True

if __name__ == "__main__":
    values=[29.0,30.0,29.7,30.1,28.5,28.0,29.2]
    expected=[False,True,True,True,True,False,False]
    state=False;rows=[]
    for i,(v,e) in enumerate(zip(values,expected)):
        before=state;state,valid=update_alarm(state,v,True)
        assert (state,valid)==(e,True)
        rows.append([i,v,int(before),int(state),int(valid)])
    checks=1
    for before,v,want in [(False,30,True),(True,28,False),(False,29,False),(True,29,True)]:
        assert update_alarm(before,v,True)==(want,True);checks+=1
    assert update_alarm(True,0,False)==(True,False);checks+=1
    assert update_alarm(False,float('nan'),True)==(False,False);checks+=1
    assert update_alarm(True,float('inf'),True)==(True,False);checks+=1
    for low,high in [(30,28),(30,30),(float('nan'),30)]:
        try:update_alarm(False,29,True,low,high)
        except ValueError:checks+=1
        else:raise AssertionError('threshold validation')
    jitter=[29.9,30.1,29.8,30.2,29.7,30.1]
    a=b=False;changes_single=changes_hyst=0
    for v in jitter:
        na=v>=30;nb,_=update_alarm(b,v,True)
        changes_single+=na!=a;changes_hyst+=nb!=b;a,b=na,nb
    assert (changes_single,changes_hyst)==(5,1);checks+=1
    a=True;actual=[]
    for v in [29,28,29,30]:a,_=update_alarm(a,v,True);actual.append(a)
    assert actual==[True,False,False,True];checks+=1
    with Path(__file__).with_name('trace.csv').open('w',newline='',encoding='utf8')as f:
        w=csv.writer(f);w.writerow(['sample_index','temperature_c','previous_alarm','new_alarm','sample_valid']);w.writerows(rows)
    print(json.dumps({'passed':checks,'trace_states':[int(x)for x in expected],'single_changes':changes_single,'hysteresis_changes':changes_hyst,'hardware_test':False,'physical_simulation':False}))
