┌─────────────────────────────────────────────────────────────┐
│                    TEST GATE FAILS                          │
│         "Project.TDM.Logic.ApplyKillLogic FAILED"           │
└─────────────────────────────────────┬───────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────┐
│              BUG PATTERN DETECTION                          │
│    Analyze failure signature → Match known bug patterns     │
│    Result: "score_not_updated" detected                     │
└─────────────────────────────────────┬───────────────────────┘
                                      │
                    ┌─────────────────┴─────────────────┐
                    ▼                                   ▼
        ┌───────────────────┐               ┌───────────────────┐
        │   PATCH CACHE     │               │   LLM REPAIR      │
        │ (Trusted Fixes)   │               │ (Generate New)    │
        │                   │               │                   │
        │ 3+ successful     │               │ Claude analyzes   │
        │ uses = promoted   │               │ code, generates   │
        │ to "trusted"      │               │ fix, adds to      │
        │                   │               │ cache             │
        └─────────┬─────────┘               └─────────┬─────────┘
                  │                                   │
                  └─────────────────┬─────────────────┘
                                    ▼
┌─────────────────────────────────────────────────────────────┐
│                 APPLY PATCH TO C++                          │
│                                                             │
│  TeamDeathmatchLogic.cpp:                                   │
│  - // BUG: GameState->AddTeamScore(KillerPS->GetTeam(), 1); │
│  + GameState->AddTeamScore(KillerPS->GetTeam(), 1);         │
│                                                             │
│  path.write_text(new_content, encoding='utf-8')             │
└─────────────────────────────────────┬───────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────┐
│              REBUILD VIA UBT                                │
│         Build.bat testEditor Win64 Development              │
└─────────────────────────────────────┬───────────────────────┘
                                      │
                                      ▼
┌─────────────────────────────────────────────────────────────┐
│              RE-RUN TEST GATE                               │
│         All tests pass → Patch promoted to "trusted"        │
│         Tests still fail → Revert, try different strategy   │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    NPC COGNITIVE BRAIN                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │ World Model │  │   Goals     │  │  Learning Systems   │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   RIFTBORN AI (320K lines)                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │ HTTP Bridge │──│ Tool System │──│ Design Systems (16) │  │
│  │ (228K C++)  │  │ (702 tools) │  │  GAS/AI/VFX/UI/etc  │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
│                         │                                   │
│  ┌──────────────────────┴───────────────────────────────┐   │
│  │              NPC Brain (10K lines Python)            │   │
│  │  ┌─────────┐ ┌───────────┐ ┌─────────┐ ┌─────────┐  │   │
│  │  │  World  │ │   Self    │ │  Goal   │ │  Drive  │  │   │
│  │  │  Model  │ │   Model   │ │ Hierarch│ │  System │  │   │
│  │  └─────────┘ └───────────┘ └─────────┘ └─────────┘  │   │
│  │  12 Cognitive Systems - See, Hear, Think, Speak     │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    UNREAL ENGINE 5.7                        │
│         Blueprints · Actors · Materials · Levels            │
└─────────────────────────────────────────────────────────────┘

# Join the waitlist at:
https://riftborn-ai.vercel.app

# Early access members receive direct download links

YourProject/
├── Content/
├── Config/
├── Plugins/
│   └── RiftbornAI/           ← Copy here
│       ├── RiftbornAI.uplugin
│       ├── Source/
│       │   └── RiftbornAI/
│       │       ├── Private/
│       │       │   ├── DebugBridgeServer.cpp  (214K lines)
│       │       │   ├── ClaudeToolUse.cpp
│       │       │   └── Providers/
│       │       └── Public/
│       ├── Bridge/
│       └── Content/
└── YourProject.uproject

# Set your Claude API key
set ANTHROPIC_API_KEY=sk-ant-your-key-here

# Or add to system environment variables for persistence

# Start the Ollama server
ollama serve

# Pull a recommended model
ollama pull qwen2.5-coder:7b

curl http://localhost:8766/riftborn/ping

# Response:
{"ok":true,"message":"RiftbornAI Debug Bridge active"}

curl -X POST http://localhost:8766/riftborn/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Spawn a point light at position 0, 0, 200"}'

{
  "ok": true,
  "message": "Spawn a point light at position 0, 0, 200",
  "duration_ms": 1247.5,
  "response": "I've spawned a PointLight actor at location (0, 0, 200).",
  "tool_calls": [
    {
      "name": "spawn_actor",
      "success": true,
      "result": "Spawned PointLight at (0, 0, 200)",
      "arguments": {
        "actor_class": "PointLight",
        "location": "{\"x\":0,\"y\":0,\"z\":200}"
      }
    }
  ]
}

[RiftbornAI.Security]
AuthEnabled=false
RateLimitEnabled=true
RBACEnabled=false
ToolTimeoutMs=30000
MaxRequestBodySize=10485760

[RiftbornAI.LLM]
Provider=claude  # Recommended: enables brain learning
# Provider=ollama  # Alternative: fully local
Model=qwen2.5-coder:7b
Temperature=0.7
MaxTokens=4096

http://localhost:8766

# Option 1: X-API-Key header
curl -H "X-API-Key: your_api_key_here" http://localhost:8766/riftborn/status

# Option 2: Bearer token
curl -H "Authorization: Bearer your_api_key_here" http://localhost:8766/riftborn/status

{"ok": true, "message": "RiftbornAI Debug Bridge active"}

{
  "status": "healthy",
  "ok": true,
  "service": "RiftbornAI",
  "timestamp": "2025-12-06T15:30:00Z",
  "components": {
    "http_server": "healthy",
    "tool_registry": "healthy",
    "rate_limiter": {"enabled": true, "remaining_requests": 95}
  }
}

riftborn_requests_total 1247
riftborn_requests_success_total 1198
riftborn_requests_failed_total 49
riftborn_uptime_seconds 3847.25
riftborn_tools_registered 415
riftborn_tool_executions_total{tool="spawn_actor"} 89

{
  "message": "Create a blueprint called BP_Enemy with a health component"
}

{
  "tool": "spawn_actor",
  "args": {
    "actor_class": "PointLight",
    "location": {"x": 0, "y": 0, "z": 100}
  }
}

"Create a fireball ability with 50 damage, 3 second cooldown, 
costs 20 mana, spawns a projectile with explosion VFX on impact"

"Create patrol behavior that chases player when spotted, 
returns to patrol after losing sight for 5 seconds"

"Blue magic explosion with lingering sparks"
"Fire trail that follows the player"
"Purple lightning arc between two points"
"Healing particles rising upward with glow"
"Shield bubble effect with hexagon pattern"

"Glowing lava material with animated flow"
"Ice shader with subsurface scattering"
"Hologram material with scan lines and flicker"
"Worn metal with rust and scratches"
"Glass with refraction and color tint"

"Add double jump to my character"
"Create a door that opens when player approaches"
"Add sprint with stamina drain"
"Create a pickup that restores 25 health"
"Add a dash ability with 2 second cooldown"

"Create a health bar with damage flash effect"
"Create a radial menu with 8 ability slots"
"Create an inventory grid 6x4"
"Create main menu with Play, Settings, Quit"
"Create dialogue box with character portrait"

/riftborn/chat    → 20 requests
/riftborn/tool    → 30 requests
/riftborn/ping    → 120 requests
/riftborn/status  → 60 requests
/riftborn/health  → 120 requests
/riftborn/audit   → 30 requests (admin only)

# Check if server is running
curl http://localhost:8766/riftborn/ping

# Get detailed status
curl http://localhost:8766/riftborn/health

# Check metrics
curl http://localhost:8766/riftborn/metrics

# View recent logs
curl http://localhost:8766/riftborn/logs