Welcome to Jaffa Ai
..cake or Biscuit 🍊
AI-powered gaming incident intelligence. Report a bug — get a fix. jaffaAi searches the web, scores player stress, and feeds intelligence straight into Grip Protocol.
⚡ How jaffaAi Works
Report
Player reports a bug via the API — game, platform, and description
Analyse
PSI scoring calculates player stress index (0-100) and severity
Search
Web search across Reddit, Steam, GitHub, wikis, and official patches
Correlate
Fix correlation engine scores matches by keywords, platform, and source reliability
Respond
Returns ranked fix steps with confidence scores and sources
Bridge
Pushes signals + resolutions to Grip Protocol for live hotspot tracking
🧩 Features
🧠 PSI Scoring
Player Stress Index quantifies frustration from 0–100. High PSI triggers auto-escalation. Used across both jaffaAi and Grip Protocol.
🌐 Web Fix Search
Searches Reddit, Steam forums, GitHub issues, game wikis, and official patch notes for real fixes from real players.
🔗 Grip Protocol Bridge
Every incident and resolution flows into Grip Protocol's live hotspot feed. Two platforms, one intelligence layer.
📊 Analytics Dashboard
Incident counts, cache stats, queue health, per-endpoint latency, and bridge status — all via the API.
🔔 Webhooks
Register endpoints to receive HMAC-signed notifications when incidents are created, fixes found, or escalations triggered.
⚡ Rate Limited & Authed
API key authentication with configurable rate limits. Keys generated via Grip Protocol developer portal.
📖 API Endpoints
Base URL: https://jaffaai.cc
· Auth: X-API-Key: your-key
POST /Jaffa/report
Full sync pipeline — ingest incident, search for fixes, return correlated solution.
{
"playerId": "player_123",
"gameTitle": "Elden Ring",
"platform": "steam",
"issueDescription": "Game crashes opening inventory"
}
POST /Jaffa/report/async
Fire-and-forget — queues the incident for background processing.
GET /Jaffa/incidents
List incidents with optional filters: ?gameTitle=&status=&limit=
GET /Jaffa/incident/:id
Get full incident details by ID — status, PSI score, severity, timestamps.
GET /Jaffa/fix/:incidentId
Get correlated fixes for an incident — ranked by confidence with step-by-step instructions.
POST /Jaffa/search
Manual web search — specify game, platform, and query text.
GET /Jaffa/hotspots
Aggregated issue patterns by game — emerging, active, and contained.
GET /Jaffa/analytics/dashboard
Full dashboard — incident counts, cache stats, queue health, Grip bridge status.
POST /Jaffa/webhooks/register
Register a webhook endpoint for events: incident.created, fix.found, escalation
GET /Jaffa/grip/health
Check the Grip Protocol bridge connection status.
GET /health
Service health check — no auth required. Returns version, uptime, timestamp.
GET /Jaffa/queue/stats
Background job queue — pending, processing, completed, failed counts.
🧪 Try It Live
🔗 Grip Protocol Bridge
jaffaAi and Grip Protocol are connected. Every incident processed by jaffaAi automatically flows into Grip Protocol's intelligence feed — powering the live hotspot dashboard across 55+ games.
jaffaAi
Incident Agent
jaffaai.cc
Loading bridge status...
📤 What jaffaAi sends
Incident Signals — game, platform, friction type, PSI score, severity, summary, keywords
Resolution Reports — fix found/not found, confidence score, escalation status
📥 What Grip Protocol does
Aggregates signals into live hotspots with trend detection
Displays real-time friction data on the public dashboard at api.gamegrip.cloud
🔌 Grip Protocol Endpoints
jaffaAi pushes to:
POST /v1/events/ingest — Signals
GET /health — Bridge health