Tiers & Capabilities

The engine uses Tier for trust/social/spam signals and Capability for builder/creator. Never use string comparison (>=) on these values directly; always use the comparison helpers.

Tiers (Ordered)

Used for trust, socialTrust, spamRisk.

type Tier = "VERY_LOW" | "LOW" | "NEUTRAL" | "HIGH" | "VERY_HIGH";

const TIER_ORDER: Record<Tier, number> = {
  VERY_LOW: 0,
  LOW: 1,
  NEUTRAL: 2,
  HIGH: 3,
  VERY_HIGH: 4,
};

function tierGte(a: Tier, b: Tier): boolean {
  return TIER_ORDER[a] >= TIER_ORDER[b];
}

Capabilities (Ordered)

Used for builder, creator.

type Capability = "EXPLORER" | "BUILDER" | "EXPERT" | "ELITE";

const CAPABILITY_ORDER: Record<Capability, number> = {
  EXPLORER: 0,
  BUILDER: 1,
  EXPERT: 2,
  ELITE: 3,
};

function capabilityGte(a: Capability, b: Capability): boolean {
  return CAPABILITY_ORDER[a] >= CAPABILITY_ORDER[b];
}

Comparison Helpers

function tierLt(a: Tier, b: Tier): boolean {
  return TIER_ORDER[a] < TIER_ORDER[b];
}

function tierGte(a: Tier, b: Tier): boolean {
  return TIER_ORDER[a] >= TIER_ORDER[b];
}

function capabilityGte(a: Capability, b: Capability): boolean {
  return CAPABILITY_ORDER[a] >= CAPABILITY_ORDER[b];
}