# Architecture

This document outlines the system architecture, core components, and internal data flow.

## High-Level Overview

AAPP-MART consists of three major subsystems:

1. **AAPP (AI-Autonomous Attack Path Prediction)**  
   Builds attack graphs, predicts likely attack paths, and prioritizes risks.

2. **MART (Multi-Agent Red Team Simulation Engine)**  
   Simulates attacker behavior using autonomous agents.

3. **CORE (Simulation Brain)**  
   Orchestrates AAPP + MART, manages global state, and controls execution.

All components communicate through a shared **Knowledge Graph**.

## Repository Structure

```
aapp-mart/
│   .coveragerc
│   .dockerignore
│   .editorconfig
│   .env.example
│   .flake8
│   .gitattributes
│   .gitignore
│   .pre-commit-config.yaml
│   ACKNOWLEDGEMENTS.md
│   bandit.yaml
│   CHANGELOG.md
│   CITATION.cff
│   CODE_OF_CONDUCT.md
│   CONTRIBUTING.md
│   dev-requirements.txt
│   DISCLAIMER.md
│   Dockerfile
│   GOVERNANCE.md
│   LICENSE
│   LICENSE‑3RD‑PARTY.md
│   MAINTAINERS
│   Makefile
│   MANIFEST.in
│   mypy.ini
│   NOTICE
│   noxfile.py
│   pyproject.toml
│   pytest.ini
│   README.md
│   requirements.txt
│   ROADMAP.md
│   SBOM.md
│   SECURITY.md
│   SUPPORT.md
│   trivyignore
│   
├───.github/
│   │   
│   ├───ISSUE_TEMPLATE/
│   │       
│   └───workflows/
│           
├───assets
│   └───images/
│           
├───configs/
│       
├───dashboard
│   ├───backend/
│   │       
│   └───visualizations/
│           
├───data
│   └───sample_targets/
│           
├───demo/
│       
├───docs/
│   │   
│   ├───ai/
│   │       
│   ├───architecture/
│   │       
│   ├───concepts/
│   │       
│   ├───contributing/
│   │       
│   ├───executive/
│   │       
│   ├───guides/
│   │       
│   ├───legal/
│   │       
│   ├───product/
│   │       
│   ├───reference/
│   │       
│   └───research/
│           
├───examples/
│   │   
│   ├───scripts/
│   │       
│   └───tutorials/
│           
├───helm
│   └───aapp-mart/
│       │   
│       └───templates/
│               
├───observability
│   ├───grafana_dashboards/
│   │       
│   ├───logging/
│   │       
│   └───metrics/
│           
├───scripts
│   ├───ci/
│   │       
│   ├───dev/
│   │       
│   └───ops/
│           
├───src
│   └───aapp_mart
│       │   
│       ├───api/
│       │   │   
│       │   ├───docs/
│       │   │       
│       │   ├───endpoints/
│       │   │       
│       │   └───schemas/
│       │           
│       ├───attack_graph/
│       │       
│       ├───cli/
│       │   │   
│       │   ├───commands/
│       │   │       
│       │   ├───data/
│       │   │   │   
│       │   │   └───sample_targets/
│       │   │           
│       │   └───examples/
│       │           
│       ├───common/
│       │       
│       ├───cve/
│       │       
│       ├───domain
│       │   ├───agents/
│       │   │   │   
│       │   │   └───custom/
│       │   │           
│       │   ├───predictors/
│       │   │       
│       │   ├───reports/
│       │   │   │   
│       │   │   ├───exporters/
│       │   │   │       
│       │   │   └───templates/
│       │   │       │   
│       │   │       └───attack/
│       │   │               
│       │   └───risk/
│       │           
│       ├───integrations/
│       │   └───siem/
│       │           
│       ├───mart/
│       │   │   
│       │   └───offensive/
│       │           
│       ├───modules/
│       │   ├───automation/
│       │   │       
│       │   ├───memory/
│       │   │       
│       │   ├───network/
│       │   │       
│       │   ├───offensive/
│       │   │       
│       │   └───system/
│       │           
│       ├───network/
│       │       
│       ├───offline/
│       │       
│       ├───rl/
│       │       
│       └───utils/
│               
├───start-here/
│       
└───tests/
    │   
    └───api/
```

## Component Breakdown

### AAPP (AI-Autonomous Attack Path Prediction)

Responsible for:

- Parsing target data  
- Building attack graphs  
- Predicting attack paths  
- Scoring risks  

### MART (Multi-Agent Red Team Simulation Engine)

Simulates attacker behavior using specialized agents:

- Reconnaissance  
- Exploitation  
- Privilege escalation  
- Lateral movement  
- Persistence  
- Reporting

### CORE (Simulation Brain)

Coordinates the entire system:

- Runs AAPP  
- Initializes MART agents  
- Executes simulation loops  
- Maintains global state  
- Generates final reports
