Ports: auch die Messwerkzeuge leiten ihre Nummer ab

GEMESSEN, BEVOR ICH ETWAS ANGEFASST HABE:

  204 pruef-Dateien, abgeleitete Ports 5000-5409 (dicht belegt)
  24 mess-Dateien, Nummern von Hand: 4471 bis 5493
  davon IM Pruefbereich: 5387, 5397, 5397, 5399, 5399, 5401, 5403, 5405
  untereinander doppelt: 5397, 5399, 5461, 5483, 5491

Aufgefallen ist es, weil mess-buehne und mess-reaktion beide auf 5483
lagen und ein haengengebliebener Lauf gestern einen ganzen Messlauf
gekostet hat.

Beim Umbau kam das Groessere heraus: EINUNDZWANZIG der 24 Messdateien
hatten nicht nur eine Nummer von Hand, sondern ueberhaupt keinen
Waechter -- schlicht `const PORT = 5397;`. Liegt dort schon ein
Server, startet der eigene still nicht, und gemessen wird ab da ein
fremder Stand. Genau der Fehler, gegen den helfer-port.mjs gebaut
wurde; die Messdateien standen die ganze Zeit ausserhalb.

WAS JETZT GILT

Zwei Sorten, zwei Bereiche, beide abgeleitet aus der Stelle im
Alphabet -- jede Sorte unter ihresgleichen, sonst verschoebe eine
neue Pruefung die Nummern aller Messungen. Pruefungen ab 5000,
Messungen ab MESS_BASIS = 5900.

5900 und nicht 5500: dazwischen bleibt Platz fuer 245 weitere
Pruefdateien (bei 5500 waeren es 45). Nach oben 5948 + AUSWEICHEN
4000 = 9948, also unter 10080, der naechsten gesperrten Nummer.
Nachgerechnet, nicht geschaetzt -- eine geschaetzte 4500 hatte bei
BASIS schon einmal danebengelegen.

Eine Wache dazu: Waechst der Pruefbereich bis an MESS_BASIS heran,
bricht die Ableitung ab und sagt, was zu tun ist. Eine stille
Ueberschneidung waere genau der Fehler, den das hier beseitigt.

Die zweite Nummer kommt ueber nr=1, nie ueber `PORT + 1`:
portNummer ueberspringt gesperrte Nummern, deshalb kann die naechste
Zahl die Nummer der naechsten DATEI sein, sobald einmal eine Sperre
dazwischenliegt. Heute liegt dort keine -- das ist Glueck, kein
Entwurf.

NEBENBEI GEFUNDEN UND MIT REPARIERT

Sechs bild-*.mjs riefen den Waechter und warfen seine Antwort weg:

    await portMussFreiSein(4315, "das Bildwerkzeug");
    process.env.PORT = "4315";
    const BASIS = "http://127.0.0.1:4315";

Er lief, meldete nichts und wirkte nicht. Gibt das System den Port
dauerhaft nicht her, weicht er auf Port + 4000 aus und GIBT DIE NEUE
NUMMER ZURUECK -- diese Werkzeuge hoerten danach trotzdem auf der
alten und stuerzten mit `listen EACCES` ab, also mit genau dem
Fehler, gegen den er gebaut wurde. Dazu stand die Zahl dreimal je
Datei. Jetzt einmal, und die Antwort wird benutzt.

tiktok-videos.mjs hatte den Waechter ABGESCHRIEBEN -- eine kurze
eigene Fassung ohne den dritten Ausgang: Bei EACCES meldete sie
"belegt" und brach ab, statt auszuweichen. Auf diesem Rechner ist
genau das am 23.09. eingetreten (Port 5040, Windows-Dienst).
mess-fokus und mess-notizblock hatten dieselbe Abschrift. Eine
abgeschriebene Sicherung ist dieselbe Falle wie eine abgeschriebene
Liste.

GEPRUEFT

  pruef-portnummern  15 -> 41 Pruefungen, 0 Fehler
  pruef-ports         8 -> 10 Pruefungen, 456 statt 408 Ports geprobt
  node --check auf allen 33 geaenderten Dateien

Gegenproben, die wirklich rot werden:
  - eine Messdatei auf eine feste Nummer zurueckgesetzt -> 2 FEHL,
    danach wieder 41/0
  - die Wache: in einem Wegwerf-Ordner mit 452 pruef-Dateien bricht
    eigenerPort ab statt still zu ueberlappen; eine Datei knapp
    darunter bekommt weiter ihre Nummer (5846)
  - die Erkennungen fuer feste Nummern, PORT + 1 und weggeworfene
    Waechterantworten je gegen einen gebauten Rueckschritt

Am echten Verhalten gemessen:
  - mess-chat-liste und mess-alle-einzelsicht (beide vorher 5397)
    GLEICHZEITIG gestartet: 5906 und 5900, beide exit=0. Vorher war
    das unmoeglich.
  - die 48 neuen Nummern 5900-5947 auf diesem Rechner durchprobiert:
    keine belegt, keine vom System gesperrt
  - bild-chat.mjs durchgelaufen, drei Bilder, exit=0

Kein Eingriff am laufenden Dienst: helfer-port.mjs wird von index.js
und workspace.js nicht geladen (nachgesehen), nur von Pruef- und
Messwerkzeugen. Beide Haeuser unberuehrt -- es wird keine Zeile
angefasst, die eine Seite ausliefert.

Co-Authored-By: Claude Opus 5 <[email protected]>

server/helfer-port.mjs

@@ -180,6 +180,33 @@ import { basename, dirname } from "node:path";
  *  werden: "irgendwo ueber 4400" haette plausibel geklungen. */
 const BASIS = 5000;
 const PRO_DATEI = 2;
+
+/** Ab hier die MESSDATEIEN (01.10.2026).
+ *
+ *  Sie hatten ihre Nummern von Hand. Nachgemessen lagen ACHT davon
+ *  IM abgeleiteten Bereich der Pruefungen: Der ist bei 204 Dateien
+ *  dicht von 5000 bis 5409 belegt, und 5387/5397/5399/5401/5403/5405
+ *  liegen mittendrin. Zwei Laeufe konnten also denselben Port
+ *  bekommen, ohne dass es jemand merkt. Untereinander war fuenfmal
+ *  dieselbe Nummer doppelt vergeben (5397, 5399, 5461, 5483, 5491).
+ *
+ *  Aufgefallen ist es, weil mess-reaktion und mess-buehne beide auf
+ *  5483 lagen und ein haengengebliebener Lauf einen ganzen Messlauf
+ *  gekostet hat.
+ *
+ *  5900 UND NICHT 5500: Zwischen dem Ende der Pruefungen (5409) und
+ *  hier bleibt Platz fuer 245 weitere Pruefdateien -- bei 5500 waeren
+ *  es nur 45, und die waeren in einem Jahr aufgebraucht. Nach oben:
+ *  5900 + 24 Dateien * 2 = 5948; plus AUSWEICHEN (4000) sind das
+ *  9948, also unter 10080, der naechsten gesperrten Nummer. Beides
+ *  nachgerechnet, nicht geschaetzt -- dieselbe Ueberlegung wie bei
+ *  BASIS, wo eine geschaetzte 4500 danebengelegen haette.
+ *
+ *  AUSGELEITET aus demselben Grund wie AUSWEICHEN und GESPERRT:
+ *  pruef-portnummern.mjs weist nach, dass die beiden Bereiche sich
+ *  nicht beruehren -- und muss dafuer DIESE Zahl ansehen, nicht eine
+ *  Abschrift, die beim naechsten Verschieben stehen bleibt. */
+export const MESS_BASIS = 5900;
 /** Um wie viel ausgewichen wird, wenn das System einen Port nicht
  *  hergibt. 4000 liegt sicher oberhalb des ganzen abgeleiteten
  *  Bereichs (BASIS bis BASIS+5000 in Schritten von 2, bei derzeit
@@ -244,8 +271,8 @@ export const GESPERRT = new Set([
  *  Ausnahmen musste dafuer niemand pflegen: Uebersprungen wird nach
  *  der Regel, nicht nach einer Tabelle von Sonderfaellen.
  */
-export function portNummer(nte) {
-  let p = BASIS;
+export function portNummer(nte, basis = BASIS) {
+  let p = basis;
   let uebrig = nte;
   while (true) {
     if (!GESPERRT.has(p)) {
@@ -253,8 +280,8 @@ export function portNummer(nte) {
       uebrig -= 1;
     }
     p += 1;
-    if (p > BASIS + 5000) {
-      throw new Error("[Port] Kein freier Nummernbereich mehr oberhalb von " + BASIS + ".");
+    if (p > basis + 5000) {
+      throw new Error("[Port] Kein freier Nummernbereich mehr oberhalb von " + basis + ".");
     }
   }
 }
@@ -263,18 +290,40 @@ export async function eigenerPort(meta, wer = null, nr = 0) {
   const pfad = fileURLToPath(meta.url);
   const mein = basename(pfad);
   const ordner = dirname(pfad);
+  /* ZWEI SORTEN, ZWEI BEREICHE (01.10.2026). Eine Messdatei zaehlt
+     unter ihresgleichen, eine Pruefdatei unter ihresgleichen -- sonst
+     verschoebe eine neue Pruefung die Nummern aller Messungen und
+     umgekehrt. Welche Sorte es ist, sagt der Dateiname. */
+  const istMess = mein.startsWith("mess-");
+  const vorsilbe = istMess ? "mess-" : "pruef-";
   const alle = readdirSync(ordner)
-    .filter((f) => f.startsWith("pruef-") && f.endsWith(".mjs"))
+    .filter((f) => f.startsWith(vorsilbe) && f.endsWith(".mjs"))
     .sort();
   const stelle = alle.indexOf(mein);
   if (stelle < 0) {
     throw new Error(
-      `[Port] ${mein} steht nicht in der Liste der Pruefdateien in ${ordner}.\n`
+      `[Port] ${mein} steht nicht in der Liste der ${vorsilbe}Dateien in ${ordner}.\n`
       + "  Die Nummer wird aus der Stelle im Alphabet abgeleitet -- ohne\n"
       + "  Stelle gibt es keine Nummer, und geraten wird nicht.");
   }
   if (nr < 0 || nr >= PRO_DATEI) {
     throw new Error(`[Port] Es gibt ${PRO_DATEI} Nummern je Datei (0 und 1), nicht ${nr}.`);
   }
-  return portMussFreiSein(portNummer(stelle * PRO_DATEI + nr), wer || mein.replace(/\.mjs$/, ""));
+  const port = istMess
+    ? portNummer(stelle * PRO_DATEI + nr, MESS_BASIS)
+    : portNummer(stelle * PRO_DATEI + nr);
+
+  /* DIE WACHE GEGEN DAS ZUSAMMENWACHSEN. Kommen so viele
+     Pruefdateien dazu, dass ihr Bereich den der Messungen erreicht,
+     bekaemen zwei Laeufe still dieselbe Nummer -- genau der Fehler,
+     den diese Ableitung beseitigt. Dann lieber ein lauter Abbruch
+     mit Anleitung. */
+  if (!istMess && port >= MESS_BASIS) {
+    throw new Error(
+      `[Port] Der Bereich der Pruefungen ist bei ${port} angekommen und\n`
+      + `  stoesst an den der Messdateien (ab ${MESS_BASIS}).\n`
+      + "  MESS_BASIS in helfer-port.mjs hochsetzen -- und dabei nachsehen,\n"
+      + "  dass MESS_BASIS + 4000 (AUSWEICHEN) unter 10080 bleibt.");
+  }
+  return portMussFreiSein(port, wer || mein.replace(/\.mjs$/, ""));
 }