How cmu-sei/ghosts works
GHOSTS is an NPC orchestration framework for cyber training and simulation. Its main workflow is to configure scenarios and timelines, manage machines and NPCs, deliver activity to installed clients, and monitor execution through the management UI and supporting services. The graph also preserves persona generation, scenario authoring, content generation, and workflow automation. Relationships are limited to those stated in the README or visible in excerpts; unsampled subsystem connections are omitted where their caller is not established.
Main entry points: Program.cs GHOSTS API · Services Execution orchestration · ScenarioAuthoringService.cs Scenario authoring · app.routes.ts Management UI
Components 18
Management
- Management UI
src/Ghosts.Frontend/src/app/app.routes.ts - GHOSTS API
src/Ghosts.Api/Program.cs - PostgreSQL store
src/Ghosts.Api/Infrastructure/Data/ApplicationDbContext.cs
Scenario lifecycle
- Scenario authoring
src/Ghosts.Api/Infrastructure/Services/ScenarioAuthoringService.cs - Scenario model
src/Ghosts.Api/Infrastructure/Models/Scenarios.cs - Document validation
src/Ghosts.Api/Infrastructure/ScenarioDocuments/ScenarioDocumentValidator.cs - Validation findings
src/Ghosts.Api/Infrastructure/ScenarioDocuments/ScenarioFinding.cs
Orchestration
- Timeline definitions
src/Ghosts.Domain/Messages/Timeline.cs - Execution orchestration
src/Ghosts.Api/Infrastructure/Services
Client agents
- Windows client
src/Ghosts.Client.Windows/Program.cs - Universal client
src/Ghosts.Client.Universal/Program.cs - Lite client
src/Ghosts.Client.Lite/src/Program.cs
Supporting services
- NPC persona engine
src/Ghosts.Animator/Models/NpcProfile.cs - Content generation
src/Ghosts.Pandora/src/Controllers/PandoraController.cs - Workflow automation
- Activity dashboards
Other components
- Exercise operator
- Simulated machine
Connections 17
- Exercise operator → Management UI: manages exercises
README.md - Management UI → GHOSTS API: uses management API
README.md - GHOSTS API → PostgreSQL store: persists state
README.md - GHOSTS API → Scenario authoring: supports authoring
- Scenario authoring → Scenario model: creates scenarios
src/Ghosts.Api/Infrastructure/Services/ScenarioAuthoringService.cs - Scenario authoring → Document validation: validates documents
src/Ghosts.Api/Infrastructure/Services/ScenarioAuthoringService.cs - Document validation → Validation findings: produces findings
src/Ghosts.Api/Infrastructure/ScenarioDocuments/ScenarioFinding.cs - GHOSTS API → Execution orchestration: orchestrates activity
- Execution orchestration → Timeline definitions: dispatches timelines
src/Ghosts.Api/Infrastructure/Services/ScenarioService.cs - Execution orchestration → Windows client: deploys activity
- Execution orchestration → Universal client: deploys activity
- Execution orchestration → Lite client: deploys activity
- Simulated machine → Windows client: runs agent
README.md - Simulated machine → Universal client: runs agent
README.md - Simulated machine → Lite client: runs agent
README.md - GHOSTS API → Workflow automation: schedules workflows
README.md - GHOSTS API → Activity dashboards: provides activity data