File size: 7,593 Bytes
e9ce6e9 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | // Returns a plain-English interpretation of a raw observation value
export interface ValueContext {
label: string;
meaning: string;
advice: string;
color: string;
}
export function getValueContext(key: string, value: number): ValueContext {
switch (key) {
case "kafka_lag":
if (value > 4000) return { label: "CRASH ZONE", color: "#ef4444", meaning: `${Math.round(value).toLocaleString()} messages backlogged — past the crash threshold.`, advice: "Apply CircuitBreaker routing immediately. Cascade phase active." };
if (value > 3000) return { label: "WARNING", color: "#f97316", meaning: `${Math.round(value).toLocaleString()} messages — latency is compounding.`, advice: "Switch to Throttle or CircuitBreaker routing now." };
if (value > 1500) return { label: "BUILDING", color: "#f59e0b", meaning: `${Math.round(value).toLocaleString()} messages — backlog is growing.`, advice: "Monitor. Throttle routing will slow growth." };
return { label: "HEALTHY", color: "#22c55e", meaning: `${Math.round(value).toLocaleString()} messages — system is keeping up.`, advice: "Normal routing is fine." };
case "risk_score":
if (value > 80) return { label: "CRITICAL FRAUD", color: "#ef4444", meaning: `${Math.round(value)}/100 — very high fraud probability.`, advice: "Reject + FullVerify. Approving here costs -0.3 reward." };
if (value > 60) return { label: "HIGH RISK", color: "#f97316", meaning: `${Math.round(value)}/100 — elevated fraud signal.`, advice: "Challenge or Reject. FullVerify strongly recommended." };
if (value > 30) return { label: "MODERATE", color: "#f59e0b", meaning: `${Math.round(value)}/100 — some risk, review carefully.`, advice: "Challenge is safe. SkipVerify not recommended." };
return { label: "LOW RISK", color: "#22c55e", meaning: `${Math.round(value)}/100 — transaction looks clean.`, advice: "Approve + SkipVerify is acceptable here." };
case "adversary_threat_level":
if (value > 8) return { label: "MAX ESCALATION", color: "#ef4444", meaning: `${value.toFixed(1)}/10 — adversary at peak aggression.`, advice: "Curriculum level may promote soon. Expect volatile signals." };
if (value > 5) return { label: "ESCALATING", color: "#f97316", meaning: `${value.toFixed(1)}/10 — adversary actively challenging.`, advice: "Increased risk score volatility. Stay alert to sudden spikes." };
if (value > 3) return { label: "PROBING", color: "#f59e0b", meaning: `${value.toFixed(1)}/10 — adversary testing the agent.`, advice: "Normal play but watch for quick risk_score jumps." };
return { label: "DORMANT", color: "#22c55e", meaning: `${value.toFixed(1)}/10 — adversary not yet engaged.`, advice: "Easy conditions. Focus on matching risk decisions." };
case "system_entropy":
if (value > 70) return { label: "SPIKE INCOMING", color: "#ef4444", meaning: `${Math.round(value)}% — latency spike fires next step.`, advice: "Switch to Throttle routing to bleed entropy quickly." };
if (value > 50) return { label: "UNSTABLE", color: "#f97316", meaning: `${Math.round(value)}% — system stress building.`, advice: "Throttle routing helps. Avoid adding more load." };
if (value > 30) return { label: "MILD STRESS", color: "#f59e0b", meaning: `${Math.round(value)}% — some background instability.`, advice: "No immediate action needed. Monitor trend." };
return { label: "STABLE", color: "#22c55e", meaning: `${Math.round(value)}% — system is calm.`, advice: "No action needed on entropy." };
case "rolling_p99":
if (value > 800) return { label: "SLA BREACHED", color: "#ef4444", meaning: `${Math.round(value)}ms — -1.0 reward penalty every step until this drops below 800ms.`, advice: "Reduce API latency: lower entropy, reduce kafka lag, avoid SkipVerify." };
if (value > 700) return { label: "CRITICAL", color: "#f97316", meaning: `${Math.round(value)}ms — 100ms from SLA breach.`, advice: "Act now. One more latency spike will breach the SLA." };
if (value > 500) return { label: "CAUTION", color: "#f59e0b", meaning: `${Math.round(value)}ms — warming toward SLA limit.`, advice: "Throttle routing. Avoid SkipVerify." };
return { label: "HEALTHY", color: "#22c55e", meaning: `${Math.round(value)}ms — well within SLA.`, advice: "No action needed on latency." };
case "api_latency":
if (value > 800) return { label: "VERY SLOW", color: "#ef4444", meaning: `${Math.round(value)}ms — this spike is feeding into P99.`, advice: "Reduce entropy to stop latency spikes." };
if (value > 500) return { label: "SLOW", color: "#f59e0b", meaning: `${Math.round(value)}ms — elevated latency this step.`, advice: "Monitor P99. Multiple spikes will breach SLA." };
return { label: "NORMAL", color: "#22c55e", meaning: `${Math.round(value)}ms — latency is fine.`, advice: "No action needed." };
case "db_connection_pool":
if (value > 80) return { label: "SATURATED", color: "#ef4444", meaning: `${Math.round(value)}% — retry overhead is now active.`, advice: "Use FailFast policy to avoid the -0.10 ExpBackoff penalty." };
if (value > 65) return { label: "BUSY", color: "#f97316", meaning: `${Math.round(value)}% — approaching saturation.`, advice: "Prefer FailFast. Watch for it crossing 80%." };
if (value > 50) return { label: "MODERATE", color: "#f59e0b", meaning: `${Math.round(value)}% — pool in use but manageable.`, advice: "No action needed yet." };
return { label: "HEALTHY", color: "#22c55e", meaning: `${Math.round(value)}% — plenty of connections available.`, advice: "DB is fine. No retry overhead." };
case "bank_api_status": {
const s = Math.round(value);
if (s === 1) return { label: "DEGRADED (sim)", color: "#f59e0b", meaning: "Bank sim path is degraded.", advice: "Switch to DeferredAsync settlement for +0.05 bonus." };
if (s === 2) return { label: "UNKNOWN (sim)", color: "#94a3b8", meaning: "Bank sim state is unknown.", advice: "DeferredAsync is safer in unknown state." };
return { label: "HEALTHY (sim)", color: "#22c55e", meaning: "Bank sim path is healthy.", advice: "StandardSync settlement is optimal." };
}
case "merchant_tier": {
const isEnterprise = value >= 0.5;
return isEnterprise
? { label: "ENTERPRISE", color: "#3b82f6", meaning: "Large enterprise merchant.", advice: "Set App Priority to UPI for +0.02/step bonus." }
: { label: "SMALL", color: "#94a3b8", meaning: "Small merchant.", advice: "Set App Priority to Balanced for +0.02/step bonus." };
}
case "channel": {
const labels = ["P2P", "P2M", "AutoPay"];
const meanings = ["Person-to-person transfer.", "Payment to a merchant.", "Automated recurring payment."];
const idx = Math.round(value);
return { label: labels[idx] ?? "?", color: "#94a3b8", meaning: meanings[idx] ?? "", advice: "Channel is informational — affects which routing earns best reward." };
}
default:
return { label: String(value), color: "#94a3b8", meaning: "", advice: "" };
}
}
|