# alimousavisoft/sondra architecture

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

- Interactive diagram: https://gitdiagram.com/alimousavisoft/sondra
- Repository: https://github.com/alimousavisoft/sondra

## Overview

sondra is a Go recon and attack-surface monitoring CLI. Users choose a scan or monitor configuration (interactively or headlessly); the runner executes selected recon stages, writes artifacts, generates an HTML report, and can notify on results or changes. Separate command paths provide report/diff and Telegram/Discord bot control. The graph follows documented capabilities and sampled runner wiring; some module implementations and bot-to-runner calls were not excerpted, so those links are marked unverified where included.

Main entry points: [`internal/runner/runner.go`](https://github.com/alimousavisoft/sondra/blob/main/internal/runner/runner.go) (Pipeline runner), [`cmd/sondra/main.go`](https://github.com/alimousavisoft/sondra/blob/main/cmd/sondra/main.go) (CLI commands), [`internal/bot/handlers.go`](https://github.com/alimousavisoft/sondra/blob/main/internal/bot/handlers.go) (Control bot), [`internal/report/html.go`](https://github.com/alimousavisoft/sondra/blob/main/internal/report/html.go) (HTML report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command and configuration"]
  node_cli["CLI commands<br/>[main.go]"]
  node_config["Scan configuration<br/>[config.go]"]
  node_selector["Module selector<br/>[selector.go]"]
end

subgraph group_recon["Recon pipeline"]
  node_runner["Pipeline runner<br/>[runner.go]"]
  node_enumeration["Subdomain enumeration<br/>[enum.go]"]
  node_brute["Active brute force<br/>[brute.go]"]
  node_resolve["DNS resolution<br/>[resolve.go]"]
  node_probe["HTTP probing<br/>[probe.go]"]
  node_ports["Port scanning<br/>[vuln.go]"]
  node_collection["URL collection<br/>[vuln.go]"]
  node_jsanalysis["JavaScript analysis<br/>[jsanalysis.go]"]
  node_screenshots["Host screenshots<br/>[vuln.go]"]
  node_vulnscan["Vulnerability scanning<br/>[vuln.go]"]
end

subgraph group_results["Results and delivery"]
  node_artifacts["Run artifacts"]
  node_report["HTML report<br/>[html.go]"]
  node_diff["Run comparison<br/>[diff.go]"]
  node_runnernotify["Result notifications<br/>[notify.go]"]
  node_notify["Notification channels<br/>[notify.go]"]
end

subgraph group_control["Bot control"]
  node_bot["Control bot<br/>[handlers.go]"]
  node_telegram["Telegram transport<br/>[telegram.go]"]
  node_discord["Discord transport<br/>[discord.go]"]
  node_botstate[("Persisted monitors<br/>[store.go]")]
end

node_user(("Operator"))
node_botuser(("Bot user"))
node_tools{{"Recon tools"}}

node_user -->|"runs commands"| node_cli
node_cli -.->|"loads settings"| node_config
node_cli -->|"opens selector"| node_selector
node_cli -->|"starts scans"| node_runner
node_runner -->|"runs enumeration"| node_enumeration
node_runner -->|"runs brute force"| node_brute
node_runner -->|"runs resolution"| node_resolve
node_runner -->|"runs probing"| node_probe
node_runner -.->|"runs port scan"| node_ports
node_runner -.->|"runs URL collection"| node_collection
node_runner -.->|"runs JS analysis"| node_jsanalysis
node_runner -->|"runs screenshots"| node_screenshots
node_runner -.->|"runs vuln phase"| node_vulnscan
node_enumeration -->|"writes subdomains"| node_artifacts
node_runner -.->|"generates report"| node_report
node_report -->|"reads run data"| node_artifacts
node_cli -->|"runs diff"| node_diff
node_diff -.->|"compares runs"| node_artifacts
node_runner -.->|"dispatches alerts"| node_runnernotify
node_runnernotify -->|"sends messages"| node_notify
node_notify -.->|"uses configured channels"| node_tools
node_cli -->|"starts bot"| node_bot
node_botuser -->|"sends commands"| node_telegram
node_botuser -->|"sends commands"| node_discord
node_telegram -.->|"dispatches commands"| node_bot
node_discord -->|"dispatches commands"| node_bot
node_bot -.->|"starts scans"| node_runner
node_bot -->|"persists monitors"| node_botstate
node_bot -->|"requests report"| node_report
node_runner -->|"orchestrates recon tools"| node_tools

click node_cli "https://github.com/alimousavisoft/sondra/blob/main/cmd/sondra/main.go"
click node_config "https://github.com/alimousavisoft/sondra/blob/main/internal/config/config.go"
click node_selector "https://github.com/alimousavisoft/sondra/blob/main/internal/tui/selector.go"
click node_runner "https://github.com/alimousavisoft/sondra/blob/main/internal/runner/runner.go"
click node_enumeration "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/enum.go"
click node_brute "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/brute.go"
click node_resolve "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/resolve.go"
click node_probe "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/probe.go"
click node_ports "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go"
click node_collection "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go"
click node_jsanalysis "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/jsanalysis.go"
click node_screenshots "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go"
click node_vulnscan "https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go"
click node_report "https://github.com/alimousavisoft/sondra/blob/main/internal/report/html.go"
click node_diff "https://github.com/alimousavisoft/sondra/blob/main/internal/report/diff.go"
click node_runnernotify "https://github.com/alimousavisoft/sondra/blob/main/internal/runner/notify.go"
click node_notify "https://github.com/alimousavisoft/sondra/blob/main/internal/notify/notify.go"
click node_bot "https://github.com/alimousavisoft/sondra/blob/main/internal/bot/handlers.go"
click node_telegram "https://github.com/alimousavisoft/sondra/blob/main/internal/bot/telegram.go"
click node_discord "https://github.com/alimousavisoft/sondra/blob/main/internal/bot/discord.go"
click node_botstate "https://github.com/alimousavisoft/sondra/blob/main/internal/bot/store.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_config,node_selector,node_botuser toneBlue
class node_runner,node_enumeration,node_brute,node_resolve,node_probe,node_ports,node_collection,node_jsanalysis,node_screenshots,node_vulnscan toneAmber
class node_artifacts,node_report,node_diff,node_runnernotify,node_notify toneMint
class node_bot,node_telegram,node_discord,node_botstate toneRose
class node_user,node_tools toneIndigo
```

## Components

### Command and configuration

- [CLI commands](https://github.com/alimousavisoft/sondra/blob/main/cmd/sondra/main.go): `cmd/sondra/main.go`
- [Scan configuration](https://github.com/alimousavisoft/sondra/blob/main/internal/config/config.go): `internal/config/config.go`
- [Module selector](https://github.com/alimousavisoft/sondra/blob/main/internal/tui/selector.go): `internal/tui/selector.go`

### Recon pipeline

- [Pipeline runner](https://github.com/alimousavisoft/sondra/blob/main/internal/runner/runner.go): `internal/runner/runner.go`
- [Subdomain enumeration](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/enum.go): `internal/modules/enum.go`
- [Active brute force](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/brute.go): `internal/modules/brute.go`
- [DNS resolution](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/resolve.go): `internal/modules/resolve.go`
- [HTTP probing](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/probe.go): `internal/modules/probe.go`
- [Port scanning](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go): `internal/modules/vuln.go`
- [URL collection](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go): `internal/modules/vuln.go`
- [JavaScript analysis](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/jsanalysis.go): `internal/modules/jsanalysis.go`
- [Host screenshots](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go): `internal/modules/vuln.go`
- [Vulnerability scanning](https://github.com/alimousavisoft/sondra/blob/main/internal/modules/vuln.go): `internal/modules/vuln.go`

### Results and delivery

- **Run artifacts**
- [HTML report](https://github.com/alimousavisoft/sondra/blob/main/internal/report/html.go): `internal/report/html.go`
- [Run comparison](https://github.com/alimousavisoft/sondra/blob/main/internal/report/diff.go): `internal/report/diff.go`
- [Result notifications](https://github.com/alimousavisoft/sondra/blob/main/internal/runner/notify.go): `internal/runner/notify.go`
- [Notification channels](https://github.com/alimousavisoft/sondra/blob/main/internal/notify/notify.go): `internal/notify/notify.go`

### Bot control

- [Control bot](https://github.com/alimousavisoft/sondra/blob/main/internal/bot/handlers.go): `internal/bot/handlers.go`
- [Telegram transport](https://github.com/alimousavisoft/sondra/blob/main/internal/bot/telegram.go): `internal/bot/telegram.go`
- [Discord transport](https://github.com/alimousavisoft/sondra/blob/main/internal/bot/discord.go): `internal/bot/discord.go`
- [Persisted monitors](https://github.com/alimousavisoft/sondra/blob/main/internal/bot/store.go): `internal/bot/store.go`

### Other components

- **Operator**
- **Bot user**
- **Recon tools**

## Connections

- Operator → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → Scan configuration: loads settings
- CLI commands → Module selector: opens selector (evidence: `cmd/sondra/main.go`)
- CLI commands → Pipeline runner: starts scans (evidence: `cmd/sondra/main.go`)
- Pipeline runner → Subdomain enumeration: runs enumeration (evidence: `internal/runner/runner.go`)
- Pipeline runner → Active brute force: runs brute force (evidence: `internal/runner/runner.go`)
- Pipeline runner → DNS resolution: runs resolution (evidence: `internal/runner/runner.go`)
- Pipeline runner → HTTP probing: runs probing (evidence: `internal/runner/runner.go`)
- Pipeline runner → Port scanning: runs port scan
- Pipeline runner → URL collection: runs URL collection
- Pipeline runner → JavaScript analysis: runs JS analysis
- Pipeline runner → Host screenshots: runs screenshots (evidence: `internal/runner/runner.go`)
- Pipeline runner → Vulnerability scanning: runs vuln phase
- Subdomain enumeration → Run artifacts: writes subdomains (evidence: `internal/modules/enum.go`)
- Pipeline runner → HTML report: generates report
- HTML report → Run artifacts: reads run data (evidence: `internal/report/html.go`)
- CLI commands → Run comparison: runs diff (evidence: `cmd/sondra/main.go`)
- Run comparison → Run artifacts: compares runs
- Pipeline runner → Result notifications: dispatches alerts
- Result notifications → Notification channels: sends messages (evidence: `internal/runner/notify.go`)
- Notification channels → Recon tools: uses configured channels
- CLI commands → Control bot: starts bot (evidence: `cmd/sondra/main.go`)
- Bot user → Telegram transport: sends commands (evidence: `README.md`)
- Bot user → Discord transport: sends commands (evidence: `README.md`)
- Telegram transport → Control bot: dispatches commands
- Discord transport → Control bot: dispatches commands (evidence: `internal/bot/discord.go`)
- Control bot → Pipeline runner: starts scans
- Control bot → Persisted monitors: persists monitors (evidence: `internal/bot/handlers.go`)
- Control bot → HTML report: requests report (evidence: `internal/bot/handlers.go`)
- Pipeline runner → Recon tools: orchestrates recon tools (evidence: `README.md`)
