Initial commit: astrape-oracle split out of the combined Astrape tree

The forecasting runtime gibil pilots: weather ingest (Open-Meteo
forecasts and the Ecowitt station), the oracle and weather stores, the
snapshot daemon, the forecast evaluator, and the TCN training
scheduler.

classes/datasets.py holds the shapes the stores return for display.
They sit beside the stores deliberately: a store's return type belongs
to the store, and keeping them with the renderers would mean this repo
importing the dashboard, which is backwards.

Extracted from a single repository where the forecasting engine, the
database plumbing, the hardware client, the ingest daemons and the web
UI all imported each other freely. Verified that every module imports
with gibil resolved from its own installed checkout.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

astrape_oracle/scripts/debug/debug_duplicates.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+"""Debug script to find duplicate target times in forecast data."""
+
+from astrape_ems.classes.env import EnvLoader
+from astrape_oracle.classes.weather.store import WeatherStore
+from collections import defaultdict
+
+EnvLoader().load()
+
+store = WeatherStore.from_env()
+dataset = store.load_display_dataset()
+
+# Group by (target_at, horizon_hours) to find duplicates
+by_key = defaultdict(list)
+for point in dataset.forecast_points:
+    key = (point.target_at, point.horizon_hours)
+    by_key[key].append(point)
+
+# Find duplicates
+duplicates = {k: v for k, v in by_key.items() if len(v) > 1}
+
+print(f"\nTotal forecast points: {len(dataset.forecast_points)}")
+print(f"Unique (target_at, horizon) pairs: {len(by_key)}")
+print(f"Duplicate (target_at, horizon) pairs: {len(duplicates)}")
+
+if duplicates:
+    print("\nFirst 3 duplicates:")
+    for (target_at, horizon), points in list(duplicates.items())[:3]:
+        print(f"\n  target_at={target_at}, horizon={horizon}h ({len(points)} points):")
+        for i, p in enumerate(points):
+            print(f"    [{i}] issued_at={p.issued_at}, temp={p.temperature_c}, source={p.source}")

astrape_oracle/scripts/debug/debug_energy_forecast.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""Debug baseline energy forecast curves."""
+
+from __future__ import annotations
+
+import argparse
+from datetime import timezone
+
+from gibil.classes.oracle_builder import EnergyForecastBuilder
+from gibil.classes.forecast_config import EnergyForecastConfig
+from astrape_ems.classes.env import EnvLoader
+from astrape_ems.classes.store import SigenStore
+from astrape_oracle.classes.weather.store import WeatherStore
+from gibil.classes.models import PowerForecastPoint
+
+
+def main() -> None:
+    EnvLoader().load()
+    args = parse_args()
+    solar_run, load_run, net_run = EnergyForecastBuilder(
+        weather_history=WeatherStore.from_env(),
+        plant_history=SigenStore.from_env(),
+        config=EnergyForecastConfig.from_env(),
+    ).build()
+
+    print(
+        f"issued_at={net_run.issued_at.astimezone(timezone.utc).isoformat(timespec='seconds')}"
+    )
+    print(
+        f"solar_model={solar_run.model_version} "
+        f"load_model={load_run.model_version} points={len(net_run.points)}"
+    )
+    print(
+        "target_at                 solar_p10 solar_p50 solar_p90 "
+        "load_p10 load_p50 load_p90 net_p10 net_p50 net_p90"
+    )
+    solar_by_target = _by_target(solar_run.points)
+    load_by_target = _by_target(load_run.points)
+    for point in net_run.points[: args.limit]:
+        solar_point = solar_by_target[point.target_at]
+        load_point = load_by_target[point.target_at]
+        print(
+            f"{point.target_at.astimezone(timezone.utc).isoformat(timespec='minutes'):25} "
+            f"{solar_point.p10_power_w:9.0f} "
+            f"{solar_point.p50_power_w:9.0f} "
+            f"{solar_point.p90_power_w:9.0f} "
+            f"{load_point.p10_power_w:8.0f} "
+            f"{load_point.p50_power_w:8.0f} "
+            f"{load_point.p90_power_w:8.0f} "
+            f"{point.p10_net_power_w:7.0f} "
+            f"{point.p50_net_power_w:7.0f} "
+            f"{point.p90_net_power_w:7.0f}"
+        )
+
+
+def _by_target(points: list[PowerForecastPoint]) -> dict[object, PowerForecastPoint]:
+    return {point.target_at: point for point in points}
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="Print baseline solar/load/net forecast curves."
+    )
+    parser.add_argument(
+        "--limit",
+        type=int,
+        default=24,
+        help="Number of forecast points to show. Defaults to 24.",
+    )
+    return parser.parse_args()
+
+
+if __name__ == "__main__":
+    main()

astrape_oracle/scripts/debug/debug_oracle_evaluations.py

@@ -0,0 +1,5 @@
+from astrape_oracle.scripts.evaluator import main
+
+
+if __name__ == "__main__":
+    main()