Skip to content

Modules

Kris Armstrong edited this page May 19, 2026 · 1 revision

Modules

The Seed organizes diagnostics into five domains. Each one is a colour-coded module in the UI; you can think of them as different "lenses" on the same plug-in event.

Roots — path analysis

Colour: Amber #b45309

Hop-by-hop path from this host outward. Combines ICMP traceroute, TCP traceroute (for ICMP-blocked paths), per-hop RTT, gateway behaviour, and IP reachability scoring. Tells you where the network breaks, not just that it does.

Canopy — Wi-Fi planning

Colour: Green #2d7a3e

Wi-Fi survey + planning. Reads the host's radio (where the platform supports it), scans nearby SSIDs/BSSIDs, characterises channel utilisation, and supports floor-plan-overlay placements for site surveys. AirMapper imports supported.

Shell — security posture

Colour: Orange #ea580c

Security audit of the local segment. Open-port discovery, weak-cipher detection on common TLS endpoints, OS / firmware fingerprint correlation, and a CVE check against the NVD feed. Output is a posture report you can hand to a customer.

Sap — live telemetry

Colour: Cyan #0891b2

Real-time event stream. SNMP polling of nearby gear, name resolution (DNS, NetBIOS, mDNS), bandwidth indicators, link state changes. The "live" tab — see traffic happen.

Harvest — reporting

Colour: Gold #d4a017

Snapshot + export. Capture a state at a point in time across all the other modules, store it locally, render PDF/CSV, schedule recurring snapshots. The "share-with-your-customer" surface.

How modules combine

Modules don't exclude each other — Sap streaming while you run a Roots traceroute and have a Shell scan queued is the normal case. They share interface selection (one global "current interface") but operate independently on it.

See internal/modules/ in the source for the engine implementations.

Clone this wiki locally