# earth-now.co
# Author:  Simon-Pierre Boucher
# Contact: contact@spboucher.ai
# File:    packages/registry/metrics/space.yaml
# Purpose: MVP space & physical-Earth metrics (catalog §13, 🥇) — Earth's orbital distance (deterministic) and Overshoot Day countdown

metrics:
  - id: earth_orbit_ytd
    name:
      fr: "Distance parcourue par la Terre autour du Soleil"
      en: "Distance Earth has travelled around the Sun"
    domain: space
    priority: mvp
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: m
    sources:
      - id: astro_calc
        name: "Éphémérides — calcul déterministe (JPL)"
        url: https://ssd.jpl.nasa.gov/
        license: "US Government public domain"
        cadence: deterministic
    refresh: never
    display:
      decimals: 0
      sigFigs: 7
      scale: 0.001
      unit: { fr: "km", en: "km" }
    constraints: { maxAbsRatePerSec: 31000, maxJumpOnRefit: 100000 }
    windows: [today, ytd, session]
    editorialNote:
      fr: "Astronomie pure : vitesse orbitale moyenne 29,78 km/s, plus rapide au périhélie (janvier) qu'à l'aphélie (juillet)."
      en: "Pure astronomy: mean orbital speed 29.78 km/s, faster at perihelion (January) than aphelion (July)."

  - id: overshoot_days
    name:
      fr: "Jours avant le prochain Earth Overshoot Day"
      en: "Days until the next Earth Overshoot Day"
    domain: space
    priority: mvp
    kind: stock
    level: 0
    model: linear-stock-v1
    unit: days
    sources:
      - id: gfn_overshoot
        name: "Global Footprint Network — Earth Overshoot Day"
        url: https://overshoot.footprintnetwork.org/
        license: "© Global Footprint Network — citation required"
        licenseNote: "verify reuse terms before launch"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 3
      unit: { fr: "jours", en: "days" }
    constraints: { maxAbsRatePerSec: 0.00002, maxJumpOnRefit: 10 }
    windows: [total]
    editorialNote:
      fr: "Date 2027 estimée à partir de la tendance GFN — mise à jour à l'annonce officielle."
      en: "2027 date estimated from the GFN trend — updated on official announcement."