aeml-x402.zeabur.app

{
  "additionalProperties": true,
  "conditionalProperties": {
    "decision_points": {
      "description": "Swappable decision points for this entity, attached centrally: {count, points:[{tag,current,swappable,how}], note}. Present only when the entity has at least one swappable tag in the index, so bundles for entities without one omit it",
      "type": [
        "object",
        "null"
      ]
    },
    "last_fact": {
      "description": "Most recent qualifying fact for this line and entity, attached centrally (may be absent when the line has no qualifying fact yet)",
      "type": [
        "object",
        "null"
      ]
    },
    "leg_availability": {
      "description": "Per-leg degradation disclosure: which legs are present, which are degraded and why. Present only when at least one leg is degraded",
      "type": [
        "object",
        "null"
      ]
    },
    "record_hash_verifiable": {
      "description": "Whether this response can recompute its own record_hash offline. Present only when the payload carries a top-level record_hash; may be absent on list-shaped deliveries where verifiability is stated per row instead",
      "type": [
        "object",
        "null"
      ]
    }
  },
  "properties": {
    "_citation": {
      "description": "Offline-verifiable citation: {statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url} - the trust root for zero-trust self-verification",
      "type": [
        "object",
        "null"
      ]
    },
    "cross_line_narrative": {
      "description": "Cross-line comparison narrative (purely descriptive; no judgement, no prediction)",
      "type": "string"
    },
    "data_timespans": {
      "description": "Per-leg observation time and hours elapsed since",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "decision_points": {
      "description": "{count, points:[{tag,current,swappable,how}], note} - decision points you can re-run with a swapped tag (one swapped tag = one call); leave it alone and the original context is the default, at no extra charge",
      "type": [
        "object",
        "null"
      ]
    },
    "entity": {
      "description": "The object key of this bundle - the ?entity= you passed in",
      "type": "string"
    },
    "grade": {
      "description": "Honest data-grade disclosure (e.g. \"screening-level, not decision-grade\")",
      "type": [
        "string",
        "null"
      ]
    },
    "legs": {
      "description": "CORE DELIVERY: per-leg readings, keyed by leg name (e.g. drought/heat/crop-vhi); each value carries signal_id/current/observed_at/data_age_hours/record_hash",
      "type": "object"
    },
    "name": {
      "description": "Human-readable name of the object",
      "type": [
        "string",
        "null"
      ]
    },
    "nature": {
      "description": "Neutrality statement: GAUGE supplies observations and trend description only - no judgement, no prediction, no recommendation",
      "type": "string"
    },
    "note": {
      "description": "Conditional - endpoint-specific honest disclosure (limits, granularity, disclaimer); some endpoints omit it",
      "type": "string"
    },
    "provenance": {
      "description": "Data lineage: {served_from, data_as_of, oldest_leg_as_of, data_age_hours (frozen age, reference only), age_hours_now (age computed at request time - the real basis for freshness), freshness(fresh|recent|stale), freshness_basis (the cadence and threshold used for this row, as a string), dead_source (optional: upstream frozen or discontinued), data_lineage:[{signal,traceable_to,uncertainty,record_hash,...}], validation_status}. Freshness is cadence-aware, so monthly/quarterly/annual official lines are not misjudged against a 24h rule; the same basis is used by free /gauge/coverage. Buyers can trace back to the official source",
      "type": [
        "object",
        "null"
      ]
    },
    "scope": {
      "description": "Honest statement of scope and limits: monitoring is not forecasting, intelligence is not instruction, and the boundary of what is verifiable",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "nature",
    "legs"
  ],
  "type": "object"
}