# cyber-arena-ai/cyber-arena architecture

> Architecture diagram of the GitHub repository cyber-arena-ai/cyber-arena, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyber-arena-ai/cyber-arena
- Repository: https://github.com/cyber-arena-ai/cyber-arena

## Overview

This repository is the CyberArena public website: a static-facing portal for a live, symmetric cybersecurity-agent benchmark. The documented benchmark workflow pairs model–harness entrants in multi-round matches, verifies captures and service health, and uses a latent-ability model to rank entrants; later matches are selected for information gain. The tree also shows dedicated pages and scripts for entrants, games, runs, match analysis, trajectories, and rankings. No source excerpts were provided, so internal page-to-script wiring and unsampled implementation details are not asserted; benchmark relationships below are documented in the README.

Main entry points: [`index.html`](https://github.com/cyber-arena-ai/cyber-arena/blob/main/index.html) (Home page), [`pages/leaderboard.html`](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/leaderboard.html) (Leaderboard page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Benchmark site"]
  node_home["Home page<br/>[index.html]"]
  node_entrants["Entrants page<br/>[entrants.html]"]
  node_games["Games page<br/>[games.html]"]
  node_entrant_data["Entrant data<br/>[list.js]"]
end

subgraph group_results["Match results"]
  node_leaderboard["Leaderboard page<br/>[leaderboard.html]"]
  node_runs["Runs page<br/>[runs.html]"]
  node_analysis["Match analysis<br/>[mc-analysis.js]"]
  node_trajectory["Trajectory page<br/>[trajectory.html]"]
  node_run_rows["Run rows<br/>[run-row.js]"]
end

subgraph group_editorial["Editorial content"]
  node_about["About page<br/>[about.html]"]
  node_blogs["Blog index<br/>[blogs.html]"]
  node_cyberarena_blog["CyberArena article<br/>[cyberarena.html]"]
end

subgraph group_ecosystem["Benchmark ecosystem"]
  node_entrants_pair["Model–harness entrants"]
  node_matches["Multi-round matches"]
  node_arena["Arena verification"]
  node_ability_model["Latent-ability model"]
  node_challenge_curation["Challenge curation"]
  node_challenge_warehouse["Challenge warehouse"]
end

node_visitor(("Site visitor"))

node_visitor -->|"visits"| node_home
node_entrants_pair -->|"compete in"| node_matches
node_matches -->|"submit captures"| node_arena
node_arena -->|"provides observations"| node_ability_model
node_ability_model -->|"ranks entrants"| node_leaderboard
node_ability_model -->|"selects later matches"| node_matches
node_challenge_curation -->|"admits challenges"| node_challenge_warehouse

click node_home "https://github.com/cyber-arena-ai/cyber-arena/blob/main/index.html"
click node_entrants "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/entrants.html"
click node_games "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/games.html"
click node_leaderboard "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/leaderboard.html"
click node_runs "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/runs.html"
click node_analysis "https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/js/mc-analysis.js"
click node_trajectory "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/trajectory.html"
click node_run_rows "https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/js/run-row.js"
click node_entrant_data "https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/data/list.js"
click node_about "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/about.html"
click node_blogs "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/blogs.html"
click node_cyberarena_blog "https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/blog/cyberarena.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_entrants,node_games,node_entrant_data toneBlue
class node_leaderboard,node_runs,node_analysis,node_trajectory,node_run_rows toneAmber
class node_about,node_blogs,node_cyberarena_blog toneMint
class node_entrants_pair,node_matches,node_arena,node_ability_model,node_challenge_curation,node_challenge_warehouse toneRose
class node_visitor toneIndigo
```

## Components

### Benchmark site

- [Home page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/index.html): `index.html`
- [Entrants page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/entrants.html): `pages/entrants.html`
- [Games page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/games.html): `pages/games.html`
- [Entrant data](https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/data/list.js): `assets/data/list.js`

### Match results

- [Leaderboard page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/leaderboard.html): `pages/leaderboard.html`
- [Runs page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/runs.html): `pages/runs.html`
- [Match analysis](https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/js/mc-analysis.js): `assets/js/mc-analysis.js`
- [Trajectory page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/trajectory.html): `pages/trajectory.html`
- [Run rows](https://github.com/cyber-arena-ai/cyber-arena/blob/main/assets/js/run-row.js): `assets/js/run-row.js`

### Editorial content

- [About page](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/about.html): `pages/about.html`
- [Blog index](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/blogs.html): `pages/blogs.html`
- [CyberArena article](https://github.com/cyber-arena-ai/cyber-arena/blob/main/pages/blog/cyberarena.html): `pages/blog/cyberarena.html`

### Benchmark ecosystem

- **Model–harness entrants**
- **Multi-round matches**
- **Arena verification**
- **Latent-ability model**
- **Challenge curation**
- **Challenge warehouse**

### Other components

- **Site visitor**

## Connections

- Site visitor → Home page: visits (evidence: `README.md`)
- Model–harness entrants → Multi-round matches: compete in (evidence: `README.md`)
- Multi-round matches → Arena verification: submit captures (evidence: `README.md`)
- Arena verification → Latent-ability model: provides observations (evidence: `README.md`)
- Latent-ability model → Leaderboard page: ranks entrants (evidence: `README.md`)
- Latent-ability model → Multi-round matches: selects later matches (evidence: `README.md`)
- Challenge curation → Challenge warehouse: admits challenges (evidence: `README.md`)
