# qyvora/qyvora-toha3ee architecture

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

- Interactive diagram: https://gitdiagram.com/qyvora/qyvora-toha3ee
- Repository: https://github.com/qyvora/qyvora-toha3ee

## Overview

TOHA3EE is an interactive and scripted local/network security-assessment framework. Operators enter through the CLI, then use a session to run registered modules; results and events accumulate in shared state and can be reported. Its documented capabilities span discovery, enumeration, OSINT, authentication, web and wireless assessment, MITM, switch-layer, espionage and post-exploitation. The graph shows the documented module lifecycle and sampled session dependencies; category-level module paths reflect the tree, not inspection of every implementation.

Main entry points: [`internal/session/session.go`](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/session.go) (Session controller), [`internal/store/store.go`](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/store/store.go) (Shared inventory), [`internal/events/bus.go`](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/events/bus.go) (Event bus), [`internal/netx/dns/server.go`](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/netx/dns/server.go) (DNS service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Operator workflow"]
  node_cli["CLI modes<br/>[main.go]"]
  node_session["Session controller<br/>[session.go]"]
  node_repl["Interactive REPL<br/>[repl.go]"]
  node_wizard["Guided wizard<br/>[wizard.go]"]
  node_script["Script engine<br/>[engine.go]"]
end

subgraph group_assessment["Assessment modules"]
  node_recon["Recon"]
  node_enumeration["Enumeration"]
  node_osint["OSINT"]
  node_auth["Credential auditing<br/>[auth.go]"]
  node_web["Web assessment"]
  node_wireless["Wireless assessment<br/>[wlan.go]"]
  node_switch["Switch-layer<br/>[switch.go]"]
  node_post["Post-exploitation"]
end

subgraph group_interception["Traffic and capture"]
  node_mitm["MITM modules"]
  node_espionage["Espionage modules<br/>[espionage.go]"]
  node_dns["DNS service<br/>[server.go]"]
  node_phishing["Phishing server<br/>[server.go]"]
end

subgraph group_core["Session services"]
  node_store[("Shared inventory<br/>[store.go]")]
  node_events["Event bus<br/>[bus.go]"]
  node_safety["Safety lifecycle<br/>[manager.go]"]
  node_vectors["Vector suggestions<br/>[engine.go]"]
  node_reports["Report generation<br/>[report.go]"]
end

node_operator(("Operator"))

node_operator -->|"invokes"| node_cli
node_cli -->|"starts"| node_session
node_session -->|"drives"| node_repl
node_session -->|"offers"| node_wizard
node_session -->|"runs scripts"| node_script
node_session -->|"runs modules"| node_recon
node_session -->|"runs modules"| node_enumeration
node_session -->|"runs modules"| node_osint
node_session -->|"runs modules"| node_auth
node_session -->|"runs modules"| node_web
node_session -->|"runs modules"| node_wireless
node_session -->|"runs modules"| node_switch
node_session -->|"runs modules"| node_post
node_session -->|"runs modules"| node_mitm
node_session -->|"runs modules"| node_espionage
node_session -->|"uses"| node_store
node_session -->|"creates"| node_events
node_session -->|"creates"| node_safety
node_session -->|"uses"| node_vectors
node_session -->|"generates"| node_reports
node_dns -->|"records"| node_store
node_dns -->|"emits"| node_events
node_phishing -->|"records credentials"| node_store
node_phishing -->|"publishes events"| node_events

click node_cli "https://github.com/qyvora/qyvora-toha3ee/blob/main/cmd/toha3ee/main.go"
click node_session "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/session.go"
click node_repl "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/repl.go"
click node_wizard "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/wizard.go"
click node_script "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/script/engine.go"
click node_recon "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/recon"
click node_enumeration "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/enum"
click node_osint "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/osint"
click node_auth "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/auth/auth.go"
click node_web "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/web"
click node_wireless "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/wlan/wlan.go"
click node_switch "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/switch/switch.go"
click node_post "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/post"
click node_mitm "https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/mitm"
click node_espionage "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/espionage/espionage.go"
click node_dns "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/netx/dns/server.go"
click node_phishing "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/phish/server.go"
click node_store "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/store/store.go"
click node_events "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/events/bus.go"
click node_safety "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/safety/manager.go"
click node_vectors "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/vectors/engine.go"
click node_reports "https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/report.go"

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_cli,node_session,node_repl,node_wizard,node_script toneBlue
class node_recon,node_enumeration,node_osint,node_auth,node_web,node_wireless,node_switch,node_post toneAmber
class node_mitm,node_espionage,node_dns,node_phishing toneMint
class node_store,node_events,node_safety,node_vectors,node_reports toneRose
class node_operator toneIndigo
```

## Components

### Operator workflow

- [CLI modes](https://github.com/qyvora/qyvora-toha3ee/blob/main/cmd/toha3ee/main.go): `cmd/toha3ee/main.go`
- [Session controller](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/session.go): `internal/session/session.go`
- [Interactive REPL](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/repl.go): `internal/session/repl.go`
- [Guided wizard](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/wizard.go): `internal/session/wizard.go`
- [Script engine](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/script/engine.go): `internal/script/engine.go`

### Assessment modules

- [Recon](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/recon): `internal/attacks/recon`
- [Enumeration](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/enum): `internal/attacks/enum`
- [OSINT](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/osint): `internal/attacks/osint`
- [Credential auditing](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/auth/auth.go): `internal/attacks/auth/auth.go`
- [Web assessment](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/web): `internal/attacks/web`
- [Wireless assessment](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/wlan/wlan.go): `internal/attacks/wlan/wlan.go`
- [Switch-layer](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/switch/switch.go): `internal/attacks/switch/switch.go`
- [Post-exploitation](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/post): `internal/attacks/post`

### Traffic and capture

- [MITM modules](https://github.com/qyvora/qyvora-toha3ee/tree/main/internal/attacks/mitm): `internal/attacks/mitm`
- [Espionage modules](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/attacks/espionage/espionage.go): `internal/attacks/espionage/espionage.go`
- [DNS service](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/netx/dns/server.go): `internal/netx/dns/server.go`
- [Phishing server](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/phish/server.go): `internal/phish/server.go`

### Session services

- [Shared inventory](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/store/store.go): `internal/store/store.go`
- [Event bus](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/events/bus.go): `internal/events/bus.go`
- [Safety lifecycle](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/safety/manager.go): `internal/safety/manager.go`
- [Vector suggestions](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/vectors/engine.go): `internal/vectors/engine.go`
- [Report generation](https://github.com/qyvora/qyvora-toha3ee/blob/main/internal/session/report.go): `internal/session/report.go`

### Other components

- **Operator**

## Connections

- Operator → CLI modes: invokes (evidence: `README.md`)
- CLI modes → Session controller: starts (evidence: `cmd/toha3ee/main.go`)
- Session controller → Interactive REPL: drives (evidence: `README.md`)
- Session controller → Guided wizard: offers (evidence: `README.md`)
- Session controller → Script engine: runs scripts (evidence: `README.md`)
- Session controller → Recon: runs modules (evidence: `README.md`)
- Session controller → Enumeration: runs modules (evidence: `README.md`)
- Session controller → OSINT: runs modules (evidence: `README.md`)
- Session controller → Credential auditing: runs modules (evidence: `README.md`)
- Session controller → Web assessment: runs modules (evidence: `README.md`)
- Session controller → Wireless assessment: runs modules (evidence: `README.md`)
- Session controller → Switch-layer: runs modules (evidence: `README.md`)
- Session controller → Post-exploitation: runs modules (evidence: `README.md`)
- Session controller → MITM modules: runs modules (evidence: `README.md`)
- Session controller → Espionage modules: runs modules (evidence: `README.md`)
- Session controller → Shared inventory: uses (evidence: `internal/session/session.go`)
- Session controller → Event bus: creates (evidence: `internal/session/session.go`)
- Session controller → Safety lifecycle: creates (evidence: `internal/session/session.go`)
- Session controller → Vector suggestions: uses
- Session controller → Report generation: generates (evidence: `README.md`)
- DNS service → Shared inventory: records (evidence: `internal/netx/dns/server.go`)
- DNS service → Event bus: emits (evidence: `internal/netx/dns/server.go`)
- Phishing server → Shared inventory: records credentials (evidence: `internal/phish/server.go`)
- Phishing server → Event bus: publishes events (evidence: `internal/phish/server.go`)
