dogfather-universe/server/pruef-portnummern.mjs

/* =====================================================================
   pruef-portnummern.mjs — Zwei Pruefungen, eine Nummer

   WAS HIER SCHIEFGING (20.09.2026 gemessen):
   164 Pruefdateien, 129 verschiedene Nummern -- NEUNZEHN waren doppelt
   vergeben, 4186 und 4188 und 4196 und 4198 sogar dreifach. Niemand
   hatte das gewollt; jede neue Pruefung wurde von einer vorhandenen
   abgeschrieben, und die Nummer kam mit.

   WAS DAS ANRICHTET: Der Waechter bricht ab, statt gegen einen fremden
   Server zu messen -- so weit, so richtig. Aber zwei Pruefungen mit
   derselben Nummer koennen nie gleichzeitig laufen, und ein
   liegengebliebener Prozess der einen laesst die andere mit einer
   Meldung abbrechen, die wie ein Befund aussieht. Genau das ist am
   20.09. zweimal passiert, beide Male mit Fehlersuche an der falschen
   Stelle.

   WAS DIESE PRUEFUNG SICHERT: Dass die Nummer ABGELEITET bleibt. Eine
   von Hand eingetragene Zahl ist der Anfang der naechsten Doppelung --
   sie faellt nur niemandem auf, bis zwei Laeufe kollidieren.
   ===================================================================== */

import { readdirSync, readFileSync } from "node:fs";
import { eigenerPort } from "./helfer-port.mjs";

let ok_ = 0, fehl = 0;
const ok = (b, text) => { if (b) { ok_++; console.log("  ok   " + text); }
  else { fehl++; console.log("  FEHL " + text); } };

const ORDNER = new URL(".", import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, "$1");
const dateien = readdirSync(ORDNER)
  .filter((f) => f.startsWith("pruef-") && f.endsWith(".mjs")).sort();

console.log("\n=== 1. Niemand traegt eine Nummer von Hand ein ===");
const vonHand = [];
const ohneWaechter = [];
for (const f of dateien) {
  const s = readFileSync(ORDNER + "/" + f, "utf8");
  /* Kommentare zaehlen nicht: In helfer-port.mjs und hier stehen alte
     Nummern als Beleg, und ein Beleg ist kein Eintrag. */
  const code = s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
  if (/portMussFreiSein\(\s*\d/.test(code)) vonHand.push(f);
  const startetServer = /listen\(|process\.env\.PORT\s*=/.test(code);
  if (startetServer && !/eigenerPort\(\s*import\.meta/.test(code)) ohneWaechter.push(f);
}
ok(dateien.length > 100, `${dateien.length} Pruefdateien angesehen`);
ok(vonHand.length === 0,
  `keine traegt eine feste Nummer im Waechter (${vonHand.slice(0, 4).join(", ") || "—"})`);
ok(ohneWaechter.length === 0,
  `jede, die einen Server startet, leitet ihre Nummer ab (${ohneWaechter.slice(0, 4).join(", ") || "—"})`);

console.log("\n=== 2. Die abgeleiteten Nummern sind eindeutig ===");
const belegt = new Map();
let doppelt = 0;
dateien.forEach((f, i) => {
  for (let n = 0; n < 2; n++) {
    const p = 5000 + i * 2 + n;
    if (belegt.has(p)) { doppelt++; console.log(`       ${p}: ${belegt.get(p)} und ${f}`); }
    belegt.set(p, f);
  }
});
ok(belegt.size === dateien.length * 2 && doppelt === 0,
  `${belegt.size} Nummern fuer ${dateien.length} Dateien, ${doppelt} doppelt`);

console.log("\n=== 3. Die Ableitung stimmt wirklich (gemessen, nicht gerechnet) ===");
/* NICHT die Formel gegen sich selbst pruefen -- das waere eine
   Bestaetigung ohne Aussage. Gefragt wird die Funktion, die die
   Pruefungen auch benutzen, und verglichen wird mit der Stelle im
   Alphabet. */
const ersteDatei = dateien[0];
const meine = dateien.indexOf("pruef-portnummern.mjs");
const p0 = await eigenerPort(import.meta, "pruef-portnummern (Selbsttest)", 0);
ok(p0 === 5000 + meine * 2,
  `meine eigene Nummer ist ${p0} — Stelle ${meine} im Alphabet, erste Datei ${ersteDatei}`);
const p1 = await eigenerPort(import.meta, "pruef-portnummern (Selbsttest)", 1);
ok(p1 === p0 + 1, `und die zweite ist ${p1}, also genau eine daneben`);

console.log("\n=== 4. Gegenprobe: kann sie auch NICHT IN ORDNUNG sagen? ===");
/* Eine Pruefung, die immer bestaetigt, bestaetigt nichts. */
let drittesAusgangGriff = false;
try {
  /* Eine Datei, die es nicht gibt -- die Ableitung darf dann NICHT
     raten, sondern muss abbrechen. */
  await eigenerPort({ url: new URL("./gibt-es-nicht.mjs", import.meta.url).href }, "Gegenprobe");
} catch (f) {
  drittesAusgangGriff = /steht nicht in der Liste/.test(f?.message || "");
}
ok(drittesAusgangGriff, "eine unbekannte Datei bekommt keine geratene Nummer, sondern einen Abbruch");

let zuHoheNummer = false;
try { await eigenerPort(import.meta, "Gegenprobe", 7); }
catch (f) { zuHoheNummer = /Nummern je Datei/.test(f?.message || ""); }
ok(zuHoheNummer, "und eine dritte Nummer je Datei gibt es nicht");

console.log(`\n${ok_} Pruefungen, ${fehl} Fehler`);
console.log(fehl ? "NICHT IN ORDNUNG\n" : "ALLES IN ORDNUNG\n");
process.exit(fehl ? 1 : 0);