@spec access_vocabulary() :: [
  Crosswake.Commerce.Contracts.EntitlementSnapshot.AccessLane.decision()
]

@spec authority_vocabulary() :: [
  Crosswake.Commerce.Contracts.EntitlementSnapshot.AuthorityLane.state()
]

@spec canonical_reconciliation_evidence_source(term()) ::
  {:ok, Crosswake.Commerce.Contracts.ReconciliationEvidence.source()}
  | {:error, {:invalid_source, keyword()}}

@spec freshness_vocabulary() :: [
  Crosswake.Commerce.Contracts.EntitlementSnapshot.FreshnessLane.state()
]

@spec new_entitlement_snapshot(map() | keyword()) ::
  {:ok, Crosswake.Commerce.Contracts.EntitlementSnapshot.t()}
  | {:error, keyword()}

@spec reconciliation_evidence_source_vocabulary() :: [
  Crosswake.Commerce.Contracts.ReconciliationEvidence.source()
]

@spec reconciliation_vocabulary() :: [
  Crosswake.Commerce.Contracts.EntitlementSnapshot.ReconciliationLane.state()
]

@spec validate_entitlement_snapshot(
  Crosswake.Commerce.Contracts.EntitlementSnapshot.t()
) ::
  :ok | {:error, keyword()}