@helyx/module-health
v1.0.1
Published
Run bounded Discord server health scans and review private reports.
Maintainers
Readme
Server Health
Server Health runs read-only, server-scoped checks and stores private reports in
the Helyx dashboard. Start a preset with /server-health scan or from the Scan tab,
then review the completed report in Results. A failed or cancelled scan never
publishes partial findings.
The module needs View Channels for its baseline checks. Member scans additionally
need the Discord GUILD_MEMBERS privileged intent. Invite, integration, webhook
and AutoMod checks may show Unavailable when Helyx lacks the relevant Discord
permission; that does not fail the rest of the report.
Reports retain only findings, not a row for every passing member. Scoring uses every detected finding, while each report stores at most the 100 highest-priority findings. Reports are kept for 30 days and bounded to the latest 100 per Discord server. Interrupted scans are removed shortly after their 30-minute timeout. Public user flags are advisory signals only and never trigger automatic moderation.
Scan limits are 2 starts in a rolling hour and 10 in a rolling 24-hour period,
per server. SCAN_LIMITS_DISABLED_FOR_TESTING must remain false in anything
that is packed or released.
Release status: Live.
