Add planet environment-extra materials to capex calcs; buildcost.py tool

Every building needs a planet-hazard material bundle on top of its normal
BuildingCosts (SEA for low pressure, HSE for high pressure, MGC for low
gravity, BL for high gravity, INS for cold, TSH for heat - area-scaled
where applicable), confirmed against live in-game build panels on Nike.
FIO's own BuildRequirements field is an unreliable superset across hazard
types, not a direct per-building list - don't use it directly.

- puga/planet.py::environment_extras(): the real threshold table.
- tools/buildcost.py: full construction material list for one building,
  optionally on a given planet.
- Wired into whatif.py/buy.py (via simulate(planet=...)) and scan.py's
  own bcost(), so their capex numbers stop silently omitting this.
- docs/mechanics.md: the rule, plus a separate forum-sourced note on the
  CX order-cancellation penalty.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

tools/buy.py

@@ -20,14 +20,16 @@ from pathlib import Path
 import yaml
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
 from puga import config, fio, market, prunplanner as pp
+from puga import planet as planet_mod
 from puga.simulate import simulate
 
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 import plan_push
 
 
-def construction_items(plan: dict, buildings: list, built: dict) -> dict:
-    """Materials needed for the plan's buildings/infra beyond what `built` (ticker -> count) already has."""
+def construction_items(plan: dict, buildings: list, built: dict, planet: dict | None = None) -> dict:
+    """Materials needed for the plan's buildings/infra beyond what `built` (ticker -> count) already has.
+    planet: optional, adds environment-extra materials (SEA/HSE/MGC/BL/INS/TSH) via planet.environment_extras()."""
     bl = {b["building_ticker"]: b for b in buildings}
     d = plan["plan_data"]
     need: dict[str, float] = {}
@@ -39,6 +41,9 @@ def construction_items(plan: dict, buildings: list, built: dict) -> dict:
         for c in info["costs"]:
             need[c["material_ticker"]] = need.get(c["material_ticker"], 0) + c["material_amount"] * gap
         need["MCG"] = need.get("MCG", 0) + 4 * info["area_cost"] * gap
+        if planet is not None:
+            for etk, qty in planet_mod.environment_extras(planet, info["area_cost"]).items():
+                need[etk] = need.get(etk, 0) + qty * gap
     return need
 
 
@@ -101,9 +106,9 @@ def main():
     perm = (st.get("permits", {}).get("used", 1), st.get("permits", {}).get("total", 2))
     planet = pp._g(f"/data/planet/{plan['planet_natural_id']}/", 3600)
     price_ask = lambda t, side="buy": (lambda q: q.ask if q else None)(market.snapshot().get((t, a.cx)))
-    r = simulate(plan, recipes, blds, planet["resources"], planet["fertility"], price_ask, faction, perm)
+    r = simulate(plan, recipes, blds, planet["resources"], planet["fertility"], price_ask, faction, perm, planet=planet)
 
-    con = net_of_on_hand(construction_items(plan, blds, built), on_hand)
+    con = net_of_on_hand(construction_items(plan, blds, built, planet), on_hand)
     stk = net_of_on_hand(stock_items(r["flows"], a.days), on_hand)
     con_rows, con_total, con_w, con_v = price(con, a.cx)
     stk_rows, stk_total, stk_w, stk_v = price(stk, a.cx)