# description
AI Energy Disclosure Standard 2.0.0 - a single disclosure record for an AI subject's modeled energy consumption and carbon footprint. AIEDS scope is device, usage, inference, or training. It is a per-subject disclosure and is NOT a planetary or Earth-system health score, which is a different kind of claim with different inputs.

# properties.$schema.description
Optional JSON Schema URI - may be included for editor tooling.

# properties.id.description
Stable unique identifier for this disclosure record. UUID or URI recommended (e.g. 'aieds:my-model:inference:2026-06-29:001').

# properties.subject.properties.kind.description
model = a foundation/fine-tuned model; agent = an orchestrated AI agent; app = an AI-powered application.

# properties.subject.properties.version.description
Optional semver or other version string.

# properties.scope.description
Measurement boundary. 'device' = client device energy (CPU/GPU/display) running an AI app; 'usage' = device + server-side inference combined; 'inference' = server-side inference only; 'training' = model training run. AIEDS v1 is optimised for device/usage/inference (agent-native). Training disclosures are supported but factor tables are inference-focused.

# properties.window.description
ISO 8601 duration this disclosure covers (e.g. 'P30D' = 30 days, 'PT15M' = 15 minutes, 'PT1H' = 1 hour).

# properties.compute.description
Optional compute metrics used to derive energyKWh. Provide at least one of tokens, gpuSeconds, or flops for provenance; omit if energy was measured directly.

# properties.compute.properties.tokens.description
Total tokens processed (input + output).

# properties.compute.properties.gpuSeconds.description
Wall-clock GPU-seconds consumed across all accelerators.

# properties.compute.properties.hardware.description
Accelerator identifier (e.g. 'NVIDIA H100 SXM', 'Google TPU v4'). Used with gpuSeconds to derive energy.

# properties.energyKWh.description
Total energy consumed in kilowatt-hours for the declared scope and window.

# properties.gCO2e.description
Total greenhouse gas emissions in grams of CO2-equivalent. Must be derived as energyKWh x gridIntensity.gCO2ePerKWh (within rounding tolerance).

# properties.gridIntensity.description
Grid carbon intensity applied to convert energy to CO2e.

# properties.gridIntensity.properties.gCO2ePerKWh.description
Carbon intensity in grams of CO2-equivalent per kilowatt-hour.

# properties.gridIntensity.properties.region.description
Grid region or country code used (e.g. 'US', 'EU27', 'France', 'global_average').

# properties.confidence.description
Confidence in the energyKWh figure. String enum or fractional 0 to 1. 'high' = direct hardware power measurement; 'med' = GPU-seconds x TDP factor; 'low' = token or FLOP proxy.

# properties.provenance.description
Optional. Where the emission or energy factor came from, on the section 5.1 ladder: measured, vendor-published, class-estimated, or unknown. This is a DIFFERENT ladder from `confidence`, which grades how the energy figure itself was arrived at. A record may carry both; neither implies the other. Never upgrade either because an estimate looks plausible.

# properties.methodologyVersion.description
AIEDS methodology version, semver. Must be a 2.x version: the standard states that 1.x is superseded and must not be used for new disclosures, so a 1.x record is not conformant under this schema.

# properties.source.description
URI or name of the tool or process that generated this disclosure (e.g. 'aieds-mcp v1.0.0', 'my-energy-meter v2').

# properties.generatedAt.description
ISO 8601 datetime when this disclosure was generated.