eVa — Elastic Vector Addressing System

// Canonical URI Components:
<DOMAIN>          ::= Namespace/scope identifier
<X>,<Y>,<Z>       ::= Three spatial degrees of freedom (frame-agnostic)
<T>               ::= Timestamp (ISO 8601)
@<TimeAuthority>  ::= Clock source binding (required for authoritative time)
<PLANE>           ::= Semantic coordinate (what kind of reality)
@<PlaneAuthority> ::= Data provenance within plane (optional)
:<PlaneDimension> ::= Layer/version within plane (optional)
<V>               ::= Value/attribute at this address

// Full Example:
eva://CORE/33.457756,-111.987290,0,2026-04-12T14:32:10Z@UTC_GNSS,LOGICAL@MAP_OSM:ROADGRAPH_2026Q1,speed_limit

interface XYZFrameRegistry {
  frameId: string;                    // Unique identifier (immutable)
  frameType: 'Cartesian' | 'Geodetic' | 'Inertial' | 'Relative' | 'Logical';
  origin: {
    definition: string;               // Origin point description
    axisOrientation: string;          // Axis alignment (ENU, NED, etc.)
  };
  temporalDependency: boolean;        // Does frame change over time?
  epoch?: string;                     // Reference epoch if time-dependent
  units: {
    linear: 'meters' | 'feet' | 'degrees';
    angular?: 'radians' | 'degrees';
  };
  precision: number;                  // Decimal places of precision
  uncertaintyModel?: string;          // How uncertainty is characterized
}

interface TimeAuthorityRegistry {
  timeAuthorityId: string;            // Unique clock/time source identifier
  clockType: 'Atomic' | 'GNSS-disciplined' | 'MET' | 'System Oscillator' | 'Simulated' | 'Human-Reported';
  epoch: string;                      // Reference point (Unix, J2000, mission start)
  driftSpec: {
    rate: number;                     // Expected drift rate
    uncertainty: number;              // Drift uncertainty bounds
  };
  leapSecondHandling: 'UTC' | 'TAI' | 'GPS' | 'none';
  authoritativenessLevel: 'ground_truth' | 'derived' | 'estimated';
  validDomains: string[];             // Where this authority is meaningful
  validPlanes: string[];              // Planes where authority applies
}

Location Authority defines who asserted the XYZ position and with what confidence. This enables tracking provenance and uncertainty through the data pipeline.

interface LocationAuthorityRegistry {
  locationAuthorityId: string;        // Unique assertion source identifier
  assertionSource: 'GNSS' | 'SLAM' | 'Sensor_Fusion' | 'Human_Input' | 'Simulation_Truth';
  uncertaintyModel: {
    type: 'gaussian' | 'uniform' | 'custom';
    horizontalCEP: number;            // Circular error probable (meters)
    verticalError: number;            // Vertical uncertainty (meters)
  };
  confidenceBounds: number;           // Statistical confidence (0.0 - 1.0)
  trustScore: number;                 // Reliability rating (0.0 - 1.0)
  calibrationStatus: {
    lastCalibrated: string;           // ISO timestamp
    method: string;                   // Calibration procedure
  };
  failureModes: string[];             // Known failure conditions
}

# eVa Resolution Policy Schema
policy:
  id: string              # Unique policy identifier
  name: string            # Human-readable name
  version: string         # Semantic version
  mode: enum              # ALL | BEST | TOP-K | CONSENSUS | AUTHORITATIVE | TRACE

  # Source preferences (optional)
  sources:
    preferred:            # Ordered list of preferred authorities
      - authority_id: string
        weight: number    # 0.0 - 1.0
    excluded: string[]    # Authorities to exclude

  # Fusion rules (optional)
  fusion:
    enabled: boolean
    output_plane: string  # Target plane for fused result
    output_authority: string
    algorithm: string     # Fusion algorithm ID

  # Constraints (optional)
  constraints:
    max_age_seconds: number
    min_confidence: number
    require_trace: boolean