AEON GP Measurement v1

Convention identifier: aeon.gp.measurement.v1

Status

Draft interoperability convention

1. Purpose

aeon.gp.measurement.v1 defines a lightweight measurement-label convention built on AEON core syntax.

It standardizes a small set of descriptive labels for:

• measurement units
• measurement systems or standards
• representational or measurement precision
• currency denominations

This convention does not extend AEON core semantics. It relies on existing AEON constructs:

• attributes (@{})
• ordinary scalar values

2. Design Goals

The measurement convention aims to be:

• minimal
• predictable
• non-computational
• cross-domain
• easy to validate downstream

It provides measurement interoperability without turning AEON into a unit-conversion language.

3. Non-Goals

aeon.gp.measurement.v1 does not require AEON core to:

• convert units
• normalize numeric values
• infer measurement systems
• compute derived values
• perform exchange-rate logic

Examples:

These statements only label the data.

Any computation or interpretation belongs to:

• schemas
• profiles
• processors
• application logic

4. Core Principle

A measurement convention defines interpretation agreements, not language semantics.

AEON core preserves:

• bindings
• attributes
• scalar values

The convention defines how these preserved patterns are commonly understood by cooperating consumers.

5. Reserved Measurement Keys

The following lowercase attribute keys have defined meaning under aeon.gp.measurement.v1.

Attribute keys defined by this convention must be lowercase ASCII identifiers.

Unknown keys remain allowed and are treated as opaque unless defined elsewhere.

5.1 unit

Declares a measurement unit label associated with a value.

Meaning:

• identifies the unit of measurement
• purely descriptive
• does not imply conversion or calculation

5.2 system

Declares the system or standard context in which a unit or label should be interpreted.

Meaning:

• disambiguates unit systems
• provides contextual classification
• does not imply conversion behavior

5.3 precision

Declares the intended representational or measurement resolution of a value.

Meaning:

• indicates expected granularity or accuracy
• does not require rounding or formatting

5.4 currency

Declares a currency denomination associated with a numeric value.

Meaning:

• identifies monetary denomination
• does not imply exchange-rate logic or accounting rules

6. Unknown Keys

The measurement convention permits extension.

Rule:

• known reserved keys have stable meaning
• unknown keys may appear
• unknown keys should be treated as opaque unless a schema, profile, or another convention defines them

This enables forward compatibility.

7. Validation Posture

aeon.gp.measurement.v1 itself is descriptive.

Validation belongs to downstream layers.

Examples:

A schema might require:

• currency to match ISO codes
• unit to match an allowed list
• precision to match allowed increments

These checks are not AEON core responsibilities.

8. Example Document

9. Interpretation Summary

10. Definition

aeon.gp.measurement.v1 is a versioned interoperability convention that standardizes common measurement labels using AEON core constructs, without extending AEON core semantics.