# qyvora/qyvora-anansi architecture

> Architecture diagram of the GitHub repository qyvora/qyvora-anansi, 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-anansi
- Repository: https://github.com/qyvora/qyvora-anansi

## Overview

ANANSI is a terminal attack-surface reconnaissance CLI: a user supplies a domain, the CLI orchestrates discovery and live-host checks, performs security and stack audits, correlates findings into exploit chains, and renders reports. The README documents ten phases; the graph preserves those stages and the separate active-exploitation command. Groups reflect the CLI, recon pipeline, assessment stages, and output/exploitation layers. Some phase wiring is explicit in the README or root excerpt; unsampled implementation details are not inferred beyond documented relationships.

Main entry points: [`cmd/root.go`](https://github.com/qyvora/qyvora-anansi/blob/main/cmd/root.go) (Scan commands), [`internal/httpclient/httpclient.go`](https://github.com/qyvora/qyvora-anansi/blob/main/internal/httpclient/httpclient.go) (HTTP transport), [`internal/discovery/discovery.go`](https://github.com/qyvora/qyvora-anansi/blob/main/internal/discovery/discovery.go) (Subdomain discovery), [`internal/exploit/engine.go`](https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/engine.go) (Exploit engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI orchestration"]
  node_main["Program entry<br/>[main.go]"]
  node_commands["Scan commands<br/>[root.go]"]
  node_exploitcmd["Exploit command<br/>[exploit.go]"]
  node_updatecmd["Update command<br/>[update.go]"]
end

subgraph group_recon["Host reconnaissance"]
  node_discovery["Subdomain discovery<br/>[discovery.go]"]
  node_probe["HTTP probing<br/>[probe.go]"]
  node_httpclient["HTTP transport<br/>[httpclient.go]"]
  node_dns[("DNS cache<br/>[dnscache.go]")]
end

subgraph group_assessment["Security assessment"]
  node_tls["TLS analysis<br/>[tls.go]"]
  node_headers["Header audit<br/>[headers.go]"]
  node_paths["Exposed paths<br/>[paths.go]"]
  node_techstack["Stack audit<br/>[techstack.go]"]
  node_takeover["Takeover checks<br/>[takeover.go]"]
  node_osint["OSINT collection<br/>[osint.go]"]
end

subgraph group_delivery["Findings and actions"]
  node_chain["Exploit chains<br/>[chain.go]"]
  node_engine["Exploit engine<br/>[engine.go]"]
  node_modules["Exploit modules<br/>[modules.go]"]
  node_registry["Module registry<br/>[registry.go]"]
  node_renderer["Report renderer<br/>[terminal.go]"]
  node_events["Event stream<br/>[events.go]"]
  node_updater["Self updater<br/>[selfupdate.go]"]
end

node_user(("Operator"))

node_user -->|"starts"| node_main
node_main -->|"delegates"| node_commands
node_commands -->|"runs phase"| node_discovery
node_commands -->|"runs phase"| node_probe
node_commands -->|"runs phase"| node_tls
node_commands -->|"runs phase"| node_headers
node_commands -->|"runs phase"| node_paths
node_commands -->|"runs phase"| node_techstack
node_commands -->|"runs phase"| node_takeover
node_commands -->|"runs phase"| node_osint
node_commands -->|"assembles findings"| node_chain
node_commands -->|"renders results"| node_renderer
node_commands -->|"emits events"| node_events
node_commands -.->|"offers command"| node_exploitcmd
node_exploitcmd -->|"runs engine"| node_engine
node_engine -.->|"dispatches modules"| node_modules
node_engine -.->|"uses registry"| node_registry
node_discovery -->|"resolves via"| node_dns
node_tls -->|"adds SAN hosts"| node_discovery
node_commands -->|"selects live hosts"| node_probe
node_commands -->|"checks candidates"| node_takeover
node_discovery -->|"reports progress"| node_renderer
node_probe -->|"creates client"| node_httpclient
node_paths -->|"uses transport"| node_httpclient
node_headers -->|"uses transport"| node_httpclient
node_techstack -->|"uses transport"| node_httpclient
node_takeover -->|"uses transport"| node_httpclient
node_osint -->|"uses transport"| node_httpclient
node_renderer -->|"prints report"| node_user
node_updatecmd -->|"invokes update"| node_updater

click node_main "https://github.com/qyvora/qyvora-anansi/blob/main/main.go"
click node_commands "https://github.com/qyvora/qyvora-anansi/blob/main/cmd/root.go"
click node_exploitcmd "https://github.com/qyvora/qyvora-anansi/blob/main/cmd/exploit.go"
click node_discovery "https://github.com/qyvora/qyvora-anansi/blob/main/internal/discovery/discovery.go"
click node_probe "https://github.com/qyvora/qyvora-anansi/blob/main/internal/probe/probe.go"
click node_tls "https://github.com/qyvora/qyvora-anansi/blob/main/internal/tls/tls.go"
click node_headers "https://github.com/qyvora/qyvora-anansi/blob/main/internal/headers/headers.go"
click node_paths "https://github.com/qyvora/qyvora-anansi/blob/main/internal/paths/paths.go"
click node_techstack "https://github.com/qyvora/qyvora-anansi/blob/main/internal/techstack/techstack.go"
click node_takeover "https://github.com/qyvora/qyvora-anansi/blob/main/internal/takeover/takeover.go"
click node_osint "https://github.com/qyvora/qyvora-anansi/blob/main/internal/osint/osint.go"
click node_chain "https://github.com/qyvora/qyvora-anansi/blob/main/internal/chain/chain.go"
click node_engine "https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/engine.go"
click node_modules "https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/modules.go"
click node_registry "https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/registry.go"
click node_renderer "https://github.com/qyvora/qyvora-anansi/blob/main/internal/output/terminal.go"
click node_events "https://github.com/qyvora/qyvora-anansi/blob/main/internal/events/events.go"
click node_httpclient "https://github.com/qyvora/qyvora-anansi/blob/main/internal/httpclient/httpclient.go"
click node_dns "https://github.com/qyvora/qyvora-anansi/blob/main/internal/dnscache/dnscache.go"
click node_updatecmd "https://github.com/qyvora/qyvora-anansi/blob/main/cmd/update.go"
click node_updater "https://github.com/qyvora/qyvora-anansi/blob/main/internal/selfupdate/selfupdate.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_main,node_commands,node_exploitcmd,node_updatecmd toneBlue
class node_discovery,node_probe,node_httpclient,node_dns toneAmber
class node_tls,node_headers,node_paths,node_techstack,node_takeover,node_osint toneMint
class node_chain,node_engine,node_modules,node_registry,node_renderer,node_events,node_updater toneRose
class node_user toneIndigo
```

## Components

### CLI orchestration

- [Program entry](https://github.com/qyvora/qyvora-anansi/blob/main/main.go): `main.go`
- [Scan commands](https://github.com/qyvora/qyvora-anansi/blob/main/cmd/root.go): `cmd/root.go`
- [Exploit command](https://github.com/qyvora/qyvora-anansi/blob/main/cmd/exploit.go): `cmd/exploit.go`
- [Update command](https://github.com/qyvora/qyvora-anansi/blob/main/cmd/update.go): `cmd/update.go`

### Host reconnaissance

- [Subdomain discovery](https://github.com/qyvora/qyvora-anansi/blob/main/internal/discovery/discovery.go): `internal/discovery/discovery.go`
- [HTTP probing](https://github.com/qyvora/qyvora-anansi/blob/main/internal/probe/probe.go): `internal/probe/probe.go`
- [HTTP transport](https://github.com/qyvora/qyvora-anansi/blob/main/internal/httpclient/httpclient.go): `internal/httpclient/httpclient.go`
- [DNS cache](https://github.com/qyvora/qyvora-anansi/blob/main/internal/dnscache/dnscache.go): `internal/dnscache/dnscache.go`

### Security assessment

- [TLS analysis](https://github.com/qyvora/qyvora-anansi/blob/main/internal/tls/tls.go): `internal/tls/tls.go`
- [Header audit](https://github.com/qyvora/qyvora-anansi/blob/main/internal/headers/headers.go): `internal/headers/headers.go`
- [Exposed paths](https://github.com/qyvora/qyvora-anansi/blob/main/internal/paths/paths.go): `internal/paths/paths.go`
- [Stack audit](https://github.com/qyvora/qyvora-anansi/blob/main/internal/techstack/techstack.go): `internal/techstack/techstack.go`
- [Takeover checks](https://github.com/qyvora/qyvora-anansi/blob/main/internal/takeover/takeover.go): `internal/takeover/takeover.go`
- [OSINT collection](https://github.com/qyvora/qyvora-anansi/blob/main/internal/osint/osint.go): `internal/osint/osint.go`

### Findings and actions

- [Exploit chains](https://github.com/qyvora/qyvora-anansi/blob/main/internal/chain/chain.go): `internal/chain/chain.go`
- [Exploit engine](https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/engine.go): `internal/exploit/engine.go`
- [Exploit modules](https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/modules.go): `internal/exploit/modules.go`
- [Module registry](https://github.com/qyvora/qyvora-anansi/blob/main/internal/exploit/registry.go): `internal/exploit/registry.go`
- [Report renderer](https://github.com/qyvora/qyvora-anansi/blob/main/internal/output/terminal.go): `internal/output/terminal.go`
- [Event stream](https://github.com/qyvora/qyvora-anansi/blob/main/internal/events/events.go): `internal/events/events.go`
- [Self updater](https://github.com/qyvora/qyvora-anansi/blob/main/internal/selfupdate/selfupdate.go): `internal/selfupdate/selfupdate.go`

### Other components

- **Operator**

## Connections

- Operator → Program entry: starts (evidence: `README.md`)
- Program entry → Scan commands: delegates (evidence: `main.go`)
- Scan commands → Subdomain discovery: runs phase (evidence: `cmd/root.go`)
- Scan commands → HTTP probing: runs phase (evidence: `README.md`)
- Scan commands → TLS analysis: runs phase (evidence: `cmd/root.go`)
- Scan commands → Header audit: runs phase (evidence: `README.md`)
- Scan commands → Exposed paths: runs phase (evidence: `README.md`)
- Scan commands → Stack audit: runs phase (evidence: `README.md`)
- Scan commands → Takeover checks: runs phase (evidence: `README.md`)
- Scan commands → OSINT collection: runs phase (evidence: `cmd/root.go`)
- Scan commands → Exploit chains: assembles findings (evidence: `cmd/root.go`)
- Scan commands → Report renderer: renders results (evidence: `cmd/root.go`)
- Scan commands → Event stream: emits events (evidence: `cmd/root.go`)
- Scan commands → Exploit command: offers command
- Exploit command → Exploit engine: runs engine (evidence: `cmd/exploit.go`)
- Exploit engine → Exploit modules: dispatches modules
- Exploit engine → Module registry: uses registry
- Subdomain discovery → DNS cache: resolves via (evidence: `internal/discovery/discovery.go`)
- TLS analysis → Subdomain discovery: adds SAN hosts (evidence: `README.md`)
- Scan commands → HTTP probing: selects live hosts (evidence: `cmd/root.go`)
- Scan commands → Takeover checks: checks candidates (evidence: `README.md`)
- Subdomain discovery → Report renderer: reports progress (evidence: `internal/discovery/discovery.go`)
- HTTP probing → HTTP transport: creates client (evidence: `internal/probe/probe.go`)
- Exposed paths → HTTP transport: uses transport (evidence: `internal/paths/paths.go`)
- Header audit → HTTP transport: uses transport (evidence: `internal/headers/headers.go`)
- Stack audit → HTTP transport: uses transport (evidence: `internal/techstack/techstack.go`)
- Takeover checks → HTTP transport: uses transport (evidence: `internal/takeover/takeover.go`)
- OSINT collection → HTTP transport: uses transport (evidence: `internal/osint/osint.go`)
- Report renderer → Operator: prints report (evidence: `README.md`)
- Update command → Self updater: invokes update (evidence: `cmd/update.go`)
