Eigener Herzschlag: der Bot kann jetzt auch ueber sich selbst Auskunft geben

Der Waechter prueft alles ausser sich selbst — ist der Bot weg, prueft
niemand mehr, und hinterher sieht der Verlauf aus, als waere nie etwas
gewesen. Im Dashboard stand deshalb nur "seit 12d 4h", also wie lange es
diesmal gutgegangen ist. Was davor war, wusste niemand.

Jetzt schreibt der Bot alle zwei Minuten eine Zeile: laeuft der Prozess, und
steht die Verbindung zu Discord? Ein Bot, der laeuft aber nicht verbunden
ist, ist fuer alle draussen genauso weg — deshalb zaehlt beides.

Der Takt ist absichtlich nicht einstellbar. Ein spaeter geaenderter Abstand
wuerde den alten Verlauf falsch aussehen lassen: wie viele Proben eine
Stunde haette haben muessen, liesse sich rueckwirkend nicht mehr sagen.

Ausgewertet wird vor allem die Abwesenheit. Fuer einen fremden Dienst heisst
eine fehlende Stunde "niemand hat gemessen" und wird grau; beim Bot selbst
ist genau das die Aussage — fehlende Stunden werden rot. Grau bleibt nur,
was vor der allerersten Aufzeichnung liegt. Die angebrochene erste und die
laufende letzte Stunde rechnen anteilig, sonst waeren sie dauerhaft gelb.

Nebenbei mitgenommen:

- Statusseite und die frei angelegten Seiten stehen jetzt in der Fusszeile
  beider Seiten — dort sucht man Rechtliches. Die Navigationsleiste zeigt
  weiterhin nur, was "im Menü" gesetzt hat; wer die Nutzungsbedingungen dort
  raus nimmt, hat sie trotzdem noch in der Fusszeile.
- Die Config-Spalte hatte keine Obergrenze. min-width:0 allein reicht nicht,
  wenn ein Kind eine grosse Mindestbreite mitbringt — mit dem Balken wuchs
  sie auf 724 statt 335 px, und weil der Body waagerecht abschneidet, war
  der Ueberstand nicht scrollbar, sondern weg.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/bot/client.js

@@ -10,6 +10,7 @@ import { registerCommunityListeners } from './community.js';
 import { registerModTools } from './mod-tools.js';
 import { registerAntiRaid } from './anti-raid.js';
 import { registerAutoMod } from './automod.js';
+import { startHeartbeat } from './heartbeat.js';
 import { registerMetadata, startLinkedRoles } from './linked-roles.js';
 import { registerLevels } from './levels.js';
 import { registerPresence } from './presence.js';
@@ -104,6 +105,10 @@ export async function startBot() {
             }
         }
         startLinkedRoles(client);
+        // Ab hier zaehlt jede Minute: der Herzschlag laeuft immer,
+        // unabhaengig von Modulen — er ist die Grundlage dafuer, dass
+        // spaeter ueberhaupt jemand sagen kann, ob der Bot lief.
+        startHeartbeat(client);
     });
 
     // Live-Archivierung: neue Devlogs (Webhook-Posts im Devlog-Kanal) sofort sichern

src/bot/heartbeat.js

@@ -0,0 +1,104 @@
+// Eigener Herzschlag — damit der Bot auch über sich selbst Auskunft geben kann.
+//
+// Der Wächter prüft Adressen von innen heraus. Über den Bot selbst sagt das
+// nichts: ist er weg, prüft niemand mehr, und hinterher sieht der Verlauf aus,
+// als wäre nie etwas gewesen. Deshalb schreibt er im festen Takt eine Zeile.
+// Ausgewertet wird die Abwesenheit: wo kein Herzschlag steht, lief er nicht.
+//
+// Aufgezeichnet wird nicht nur „Prozess lebt", sondern ob die Verbindung zu
+// Discord stand. Ein Bot, der läuft aber nicht verbunden ist, ist für alle
+// draußen genauso weg.
+import { recordHeartbeat, pruneHeartbeat } from '../db.js';
+
+/** Abstand zweier Herzschläge. Fest, siehe Kommentar an der Tabelle in db.js. */
+export const TAKT_MS = 2 * 60 * 1000;
+
+const STUNDE_MS = 3600000;
+
+/** SQLite-Zeitstempel („2026-08-01 12:30:00", UTC) als Millisekunden */
+function alsZeit(wert) {
+    if (!wert) return null;
+    const s = String(wert).trim();
+    const hatZone = /[Zz]$|[+-]\d{2}:?\d{2}$/.test(s);
+    const ms = new Date(hatZone ? s : `${s.replace(' ', 'T')}Z`).getTime();
+    return Number.isNaN(ms) ? null : ms;
+}
+
+/**
+ * Aus den vorhandenen Stunden eine lückenlose Reihe machen.
+ *
+ * Der Balken liest fehlende Eimer als „keine Daten" und malt sie grau. Für
+ * einen Dienst stimmt das — niemand hat gemessen. Für den Bot selbst wäre es
+ * eine Beschönigung: dass nichts dasteht, *ist* die Aussage. Fehlende Stunden
+ * bekommen deshalb hier ihre erwartete Probenzahl und null Treffer, damit sie
+ * rot erscheinen statt grau.
+ *
+ * Grau bleibt nur, was vor der allerersten Aufzeichnung liegt.
+ *
+ * @param {Array<{stunde: string, proben: number, an: number, schnitt: number|null}>} rohe
+ * @param {string|null} ersteProbe — Zeitstempel der ersten Zeile überhaupt
+ * @param {number} jetzt
+ * @param {number} taktMs
+ * @param {number} stunden
+ */
+export function heartbeatSerie(rohe, ersteProbe, jetzt = Date.now(), taktMs = TAKT_MS, stunden = 168) {
+    const erste = alsZeit(ersteProbe);
+    if (erste == null) return [];
+
+    const proStunde = new Map((rohe ?? []).map((b) => [b.stunde, b]));
+    const stundeStart = Math.floor(jetzt / STUNDE_MS) * STUNDE_MS;
+    const raus = [];
+
+    for (let i = stunden - 1; i >= 0; i--) {
+        const von = stundeStart - i * STUNDE_MS;
+        // Nur der Teil der Stunde zählt, in dem überhaupt aufgezeichnet wurde:
+        // die angebrochene erste und die laufende letzte Stunde sind sonst
+        // dauerhaft „unvollständig" und damit gelb.
+        const anfang = Math.max(von, erste);
+        const ende = Math.min(von + STUNDE_MS, jetzt);
+        if (ende <= anfang) continue;
+
+        const key = new Date(von).toISOString().slice(0, 13);
+        const b = proStunde.get(key);
+        // Ein Splitter am Stundenanfang, in dem noch gar kein Schlag fällig
+        // war, würde sonst eine Sekunde nach voll rot aufleuchten
+        if (!b && ende - anfang < taktMs) continue;
+
+        const erwartet = Math.max(1, Math.round((ende - anfang) / taktMs));
+        raus.push({
+            stunde: key,
+            proben: erwartet,
+            // Mehr Schläge als erwartet (Neustart mitten in der Stunde: der
+            // erste Schlag kommt sofort) würden über 100 % ergeben
+            an: Math.min(b?.an ?? 0, erwartet),
+            schnitt: b?.schnitt ?? null,
+        });
+    }
+    return raus;
+}
+
+/** Herzschlag starten. Gibt eine Funktion zum Anhalten zurück. */
+export function startHeartbeat(client) {
+    // Einmal täglich aufräumen, gerechnet in Takten — ein zweiter Timer nur
+    // fürs Löschen wäre Aufwand ohne Gewinn.
+    const proTag = Math.round(86400000 / TAKT_MS);
+    let takte = 0;
+
+    const schlag = () => {
+        try {
+            const bereit = Boolean(client?.isReady?.());
+            // ping ist -1, solange keine Messung vorliegt
+            const ping = client?.ws?.ping;
+            recordHeartbeat(bereit, bereit && ping >= 0 ? ping : null);
+            if (++takte % proTag === 0) pruneHeartbeat();
+        } catch (error) {
+            console.error('[heartbeat]', error);
+        }
+    };
+
+    schlag();
+    const timer = setInterval(schlag, TAKT_MS);
+    // Ein Timer allein soll den Prozess nicht am Leben halten
+    timer.unref?.();
+    return () => clearInterval(timer);
+}