Light1YT
f8daf50f5f
feat(site_finder): future-supply-pressure index (#950 Step 6)
Add backend/app/services/site_finder/future_supply.py — deterministic,
no-LLM §9.3 composite quantifying queued competing supply (hidden + future)
vs market absorption, computed on-the-fly (not stored).
- Reads VIEW v_supply_layers_latest (incl. non-derivable graddoc_stub/
insider_manual L3 rows), not a layer recompute.
- Reuses market_metrics.compute_market_metrics for monthly absorption
(available / months_of_supply == sold/mo; algebra verified).
- months_of_pressure = (hidden + future_by_horizon) / absorption/mo;
index = linear-clamp saturation at 18mo (1.5x EKB cycle); confidence=MIN
(thin L2/L3 honestly drags composite to low).
- L3 horizon-weighted (NULL expected_online_date -> neutral 0.5);
open excluded from numerator (only hidden+future compete with a new object).
- Graceful: empty/thin/no-absorption -> index None + low, div-by-zero guarded.
- 54 unit tests (pure-helper math + mocked db/market_metrics).