# earth-now.co
# Author:  Simon-Pierre Boucher
# Contact: contact@spboucher.ai
# File:    packages/registry/metrics/emissions.yaml
# Purpose: MVP emissions metrics (catalog §7, 🥇) — CO₂ emitted YTD (L2 vedette), today, and per-second rate

metrics:
  - id: co2_emissions_ytd
    name:
      fr: "CO₂ émis cette année (fossile + ciment)"
      en: "CO₂ emitted this year (fossil + cement)"
    domain: emissions
    priority: mvp
    kind: cumulative
    level: 2
    model: seasonal-ytd-v1
    unit: t_co2
    sources:
      - id: gcp_2025
        name: "Global Carbon Project — Global Carbon Budget (annual + nowcast)"
        url: https://www.globalcarbonproject.org/carbonbudget/
        license: "CC BY 4.0"
        cadence: "yearly + nowcast"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "t CO₂", en: "t CO₂" }
    constraints: { maxAbsRatePerSec: 2000, maxJumpOnRefit: 50000000 }
    windows: [ytd, today, session]

  - id: co2_emissions_today
    name: { fr: "CO₂ émis aujourd'hui", en: "CO₂ emitted today" }
    domain: emissions
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: t_co2
    sources:
      - id: gcp_2025
        name: "Global Carbon Project (derived)"
        url: https://www.globalcarbonproject.org/carbonbudget/
        license: "CC BY 4.0"
        cadence: "yearly + nowcast"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "t CO₂", en: "t CO₂" }
    windows: [today, session]
    derived:
      op: window
      window: today
      inputs: [{ id: co2_emissions_ytd, weight: 1 }]

  - id: co2_rate
    name: { fr: "CO₂ par seconde", en: "CO₂ per second" }
    domain: emissions
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: t_co2_per_s
    sources:
      - id: gcp_2025
        name: "Global Carbon Project (derived rate)"
        url: https://www.globalcarbonproject.org/carbonbudget/
        license: "CC BY 4.0"
        cadence: "yearly + nowcast"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "t CO₂/s", en: "t CO₂/s" }
    windows: [total]
    derived:
      op: rate-of
      inputs: [{ id: co2_emissions_ytd, weight: 1 }]