{"builder":"scripts/build-alert-lead-time-retrospective.py","description":"Honest retrospective on the early-warning value of Sentinel forecast-threshold alerts. For every alert in the last 90 days it measures whether a confirmed censorship incident followed, and how much lead time the alert gave. Reports the lead-time distribution, true-positive rate, and false-alarm rate.","endpoint":"/v1/sentinel/alert-lead-time","honest_caveats":["This is the accountability number — the false-alarm rate is reported prominently and is NOT smoothed away.","'Lead time' is alert-issued vs incident-DETECTION, not alert vs the real-world shutdown start. Incident detection itself lags, so a positive lead time is a LOWER BOUND on the true early-warning margin.","The matched incident is a TEMPORAL match (next confirmed incident within the horizon), not a causal one.","Lagging alerts (forecast reacting to a shutdown already underway) are reported separately and excluded from the median-lead-time headline.","Only confirmed censorship/mixed incidents count — IODA disruption rows are excluded.","Forecast-threshold alerts only; other Sentinel alert types are out of scope."],"per_country_endpoint":"/v1/sentinel/alert-lead-time/{cc}","query_params":{"country":"Optional (list endpoint). ISO 3166-1 alpha-2 — filter to one country.","include_alerts":"Optional (list endpoint). 'false' drops the per-alert list for a lean payload."},"refresh":"daily at 04:50 UTC via cron","sidecar_last_modified":"2026-05-22T04:50:01Z","sidecar_path":"/opt/voidly-ai/ml-deploy/alert_lead_time_v1.json","sidecar_size_bytes":68060,"_voidly_pay":{"claim_did":"https://voidly.ai/pay/claim","for_builders":"https://voidly.ai/pay/for-builders","marketplace":"https://api.voidly.ai/v1/pay/marketplace","live_demo":"https://huggingface.co/spaces/emperor-mew/voidly-pay","universal_proxy":{"url":"https://api.voidly.ai/v1/pay/proxy","example":"https://api.voidly.ai/v1/pay/proxy?u=<https-url>&to=did:voidly:<your-did>&price=0.01","page":"https://voidly.ai/pay/proxy","note":"Paywall any public HTTPS URL with one query param. No SDK install required."},"install":{"typescript":"npm install @voidly/pay","python":"pip install voidly-pay","langchain":"pip install voidly-pay-langchain","vercel_ai":"npm install @voidly/pay-vercel-ai","mcp":"npx @voidly/pay-mcp","cli":"npm install -g @voidly/pay-cli"},"note":"Voidly Pay is the open agent-to-agent payment rail. Claim a DID + 10 starter credits in 60s, or paywall any URL via the universal proxy with one query param."}}