dogfather-universe/tools/nachtlauf-notiz.mjs

/* =====================================================================
   DIE NOTIZ FÜR DEN PRÜFSTAND (ausgelagert am 25.09.2026)

   Stand vorher mitten in `nachtlauf.mjs`. Ausgelagert, damit sie
   PRÜFBAR wird: `nachtlauf.mjs` startet beim Import sofort einen
   Lauf über alle Prüfdateien -- wer die Notiz messen wollte, hätte
   dafür eine halbe Stunde Rechenzeit ausgelöst und nebenbei das
   echte Ergebnis auf Filipes Startseite überschrieben.

   Hier drin steht nur Textbau, kein Nebeneffekt. Importieren ist
   folgenlos. Geprüft von `server/pruef-nachtlauf.mjs`.
   ===================================================================== */
import { readFileSync } from "node:fs";

const zweiZiffern = (n) => String(n).padStart(2, "0");
function zeitWort(d = new Date()) {
  return `${zweiZiffern(d.getDate())}.${zweiZiffern(d.getMonth() + 1)}.${d.getFullYear()}`
    + ` um ${zweiZiffern(d.getHours())}:${zweiZiffern(d.getMinutes())}`;
}

export { zeitWort };

/* =====================================================================
   EIN STÜCK DER NOTIZ GEHÖRT DEM MENSCHEN (25.09.2026)

   Bis heute stand oben in der Notiz: "von Hand ändern bringt nichts,
   beim nächsten Lauf ist es wieder überschrieben." Das war ehrlich
   und trotzdem falsch herum gedacht.

   Denn das Wertvollste an diesem Prüfstand ist gerade NICHT die
   Zahl, sondern der Satz daneben: "Diese Prüfung ist rot, weil sie
   den Umbau vom 24.09. nicht mitbekommen hat" oder "die hier ist
   echt, Finger weg". Wer das aufschreiben will, schreibt es genau
   hierhin -- und fand es am nächsten Morgen gelöscht.

   Deshalb gibt es jetzt einen Bereich zwischen zwei Marken, den der
   Lauf beim Schreiben WIEDER EINSETZT statt ihn zu überschreiben.
   Fehlt er (neue Notiz, jemand hat ihn gelöscht), wird er leer neu
   angelegt -- mit der Erklärung drin, wozu er da ist.
   ===================================================================== */
export const MARKE_AUF  = "<!-- VON HAND — dieser Teil bleibt stehen -->";
export const MARKE_ZU   = "<!-- ENDE VON HAND -->";

export function handNotizLesen(NOTIZ) {
  let alt = "";
  try { alt = readFileSync(NOTIZ, "utf8"); } catch { return null; }
  const a = alt.indexOf(MARKE_AUF);
  const b = alt.indexOf(MARKE_ZU, a + 1);
  if (a < 0 || b < 0) return null;
  const drin = alt.slice(a + MARKE_AUF.length, b).trim();
  return drin.length ? drin : null;
}

export function notizSchreiben({ lage, vorher, minuten, konnteNicht }, notizPfad) {
  const jetzt = new Date();
  const hand = handNotizLesen(notizPfad);
  const zeilen = [];
  zeilen.push("# Prüfstand Team Dogi");
  zeilen.push("");
  zeilen.push("*Diese Notiz schreibt `tools/nachtlauf.mjs`. Alles außerhalb des Blocks");
  zeilen.push("„VON HAND“ ist beim nächsten Lauf wieder überschrieben — was DRIN steht,");
  zeilen.push("bleibt stehen.*");
  zeilen.push("");
  zeilen.push(MARKE_AUF);
  if (hand) {
    zeilen.push(hand);
  } else {
    zeilen.push("## Von Hand");
    zeilen.push("");
    zeilen.push("*Hier hinein gehört, was die Zahlen nicht sagen können: welche rote");
    zeilen.push("Zeile schon untersucht ist, welche echt ist, woran gerade gearbeitet");
    zeilen.push("wird. Dieser Block überlebt jeden Lauf — der Rest der Notiz nicht.*");
  }
  zeilen.push(MARKE_ZU);
  zeilen.push("");

  if (konnteNicht) {
    zeilen.push("## ⚠ Konnte nicht nachsehen");
    zeilen.push("");
    zeilen.push(konnteNicht);
    zeilen.push("");
    if (vorher?.wann) {
      const tage = Math.floor((Date.now() - vorher.zeit) / 86400000);
      zeilen.push(`Zuletzt wirklich gemessen: **${vorher.wann}**`
        + (tage >= 1 ? ` — das ist **${tage} Tag${tage === 1 ? "" : "e"} her**.` : "."));
    } else {
      zeilen.push("Es gibt noch kein früheres Ergebnis.");
    }
    return zeilen.join("\n") + "\n";
  }

  const rot = lage.rote.length;
  zeilen.push(rot
    ? `## ${rot} Prüfung${rot === 1 ? "" : "en"} ${rot === 1 ? "ist" : "sind"} rot`
    : "## Alles in Ordnung");
  zeilen.push("");
  zeilen.push(`Gemessen am **${zeitWort(jetzt)}**, Dauer ${minuten} Minuten.`);
  zeilen.push("");
  zeilen.push("| | jetzt | vorher |");
  zeilen.push("|---|---|---|");
  zeilen.push(`| Dateien in Ordnung | ${lage.dateienOk} von ${lage.dateien} | `
    + `${vorher ? `${vorher.dateienOk} von ${vorher.dateien}` : "—"} |`);
  zeilen.push(`| Einzelprüfungen bestanden | ${lage.punkteOk} von ${lage.punkte} | `
    + `${vorher ? `${vorher.punkteOk} von ${vorher.punkte}` : "—"} |`);
  zeilen.push("");

  /* EIN RÜCKGANG DER ANZAHL IST EIN BEFUND, AUCH WENN ALLES GRÜN IST.
     Am 28.08.2026 meldete ein Lauf 789 statt 804 Prüfungen und war
     dabei grün: Acht Prüfungen je Gerät waren stillschweigend
     weggefallen -- ausgerechnet die, die die wichtigste Funktion
     absichern. Wer nur "bestanden" liest, hätte sie ab da dauerhaft
     ungeprüft gelassen. */
  if (vorher && lage.punkte != null && vorher.punkte != null
      && lage.punkte < vorher.punkte) {
    zeilen.push(`> **Es werden ${vorher.punkte - lage.punkte} Prüfungen WENIGER gemacht als beim letzten Lauf.**`);
    zeilen.push("> Das ist auch dann ein Befund, wenn alles grün ist: Eine Prüfung, die");
    zeilen.push("> still nicht mehr läuft, beweist nichts — und niemandem fällt es auf.");
    zeilen.push("");
  }
  if (vorher && lage.dateien != null && vorher.dateien != null
      && lage.dateien < vorher.dateien) {
    zeilen.push(`> **Es gibt ${vorher.dateien - lage.dateien} Prüfdatei(en) weniger als beim letzten Lauf.**`);
    zeilen.push("");
  }

  if (rot) {
    zeilen.push("## Was rot ist");
    zeilen.push("");
    for (const r of lage.rote) {
      zeilen.push(`### \`${r.datei}\``);
      zeilen.push("");
      if (r.nullPunkte) {
        zeilen.push(`**Kein Befund – es wurde keine einzige Prüfung GEZÄHLT** `
          + `(Exitcode ${r.code}).` );
        zeilen.push("");
        zeilen.push("Das ist etwas anderes als „kaputt“: Die Datei ist "
          + "durchgelaufen. Der Zähler hat ihre Punkte nur nicht erkannt – "
          + "meist, weil sie ihre Ergebnisse anders schreibt als erwartet "
          + "(`  OK ` statt `  ok `, andere Einrückung, eigenes Format). "
          + "Nachsehen lohnt trotzdem: Eine Datei, deren Punkte niemand "
          + "zählt, kann still aufhören zu prüfen, ohne dass es auffällt. "
          + "Zuletzt stand da:");
        zeilen.push("");
      } else if (r.ohneGrund) {
        zeilen.push(`**Konnte nicht sagen, woran es lag** (Exitcode ${r.code}). `
          + "Das ist etwas anderes als ein Befund: Die Prüfung ist nicht "
          + "durchgelaufen, hat aber auch keine FEHL-Zeile hinterlassen. "
          + "Meist steckt dahinter eine Zeitüberschreitung oder ein Absturz "
          + "im Vorlauf, kein Fehler im Programm. Zuletzt stand da:");
        zeilen.push("");
      }
      zeilen.push(`\`\`\`\n${r.erste}\n\`\`\``);
      zeilen.push("");
      zeilen.push(`Einzeln nachsehen: \`node server/${r.datei}\``);
      zeilen.push("");
    }
    zeilen.push("**Rot heißt nicht automatisch kaputt.** Dreimal am 23.09.2026 war");
    zeilen.push("die Prüfung veraltet und das Programm richtig — einmal war es");
    zeilen.push("umgekehrt und ein Rollenname stand offen im Netz. Erst nachsehen,");
    zeilen.push("dann entscheiden, wer recht hat.");
  } else {
    zeilen.push("Keine Datei ist rot. Der nächste Lauf kommt in der nächsten Nacht.");
  }
  zeilen.push("");
  return zeilen.join("\n") + "\n";
}