Portnummern werden abgeleitet, nicht mehr vergeben

Gemessen: 165 Pruefdateien, 129 verschiedene Nummern -- NEUNZEHN
doppelt, vier davon dreifach. Niemand hatte das gewollt; jede neue
Pruefung wurde von einer vorhandenen abgeschrieben, und die Nummer kam
mit. Meine eigene Notiz sagte "sieben" -- auch eine Bestandsliste
altert.

Der Waechter faengt den Schaden ab, aber er kann nur melden, was schon
passiert ist: Zwei Pruefungen mit derselben Nummer koennen nie
gleichzeitig laufen, und ein liegengebliebener Prozess der einen laesst
die andere abbrechen mit einer Meldung, die wie ein Befund aussieht.
Genau das ist mir am 20.09. zweimal passiert.

Jetzt leitet jede Datei ihre Nummer aus ihrer STELLE IM ALPHABET ab
(eigenerPort in helfer-port.mjs), zwei je Datei. Nicht ueber eine
Pruefsumme: Bei 165 Namen in 4900 Nummern waeren nach dem
Geburtstagsproblem rund DREI Zusammenstoesse zu erwarten -- ein Hash
tauscht eine sichtbare Doppelung gegen eine unsichtbare. Die Stelle im
Alphabet ist eindeutig von der Bauart her.

--- ZWEI FEHLER AUF DEM WEG, BEIDE LEHRREICH -------------------------

1. DER ERSTE VERSUCH WAR GRUEN UND KAPUTT. Ersetzt wurde mit einem
   Muster: "([^"]*4231[^"]*)". Das hielt

     { host: "127.0.0.1", port: 4231, path: "/404.html" }

   fuer eine Zeichenkette -- ein Muster kann eine oeffnende nicht von
   einer schliessenden Anfuehrung unterscheiden. Heraus kam

     { host: "127.0.0.1`, port: ${PORT}, path: `/404.html" }

   also GUELTIGER Code ohne port-Feld. `node --check` sagte gruen fuer
   alle 164 Dateien. Aufgefallen ist es erst, weil ich vier Vertreter
   gegen eine vorher gemessene Grundlinie laufen liess: pruef-schranke
   39/0 vorher, 38/1 nachher.

   Alles zurueckgenommen und mit einem Zerleger neu gemacht, der weiss,
   ob eine Stelle Code, Zeichenkette, Vorlage, Kommentar oder
   regulaerer Ausdruck ist. In pruef-ics stand die Nummer in einem
   regulaeren Ausdruck -- der wird jetzt gebaut statt hingeschrieben.

2. EIN MODUL, DAS BEIM IMPORTIEREN ARBEITET, IST EINE FALLE. Der
   zweite Durchgang importierte den ersten, um seine Mechanik zu
   benutzen -- und fuehrte dessen Hauptlauf gleich mit aus. Die
   zweiten Nummern wurden dadurch als erste behandelt, zwei Aufrufe
   bekamen dieselbe Nummer, und in pruef-content stand `const PORT`
   zweimal.

--- WAS DAS DAUERHAFT HAELT -----------------------------------------

pruef-portnummern.mjs (neu, 8 Pruefungen) fragt nicht "welche Nummern
sind doppelt", sondern "wer traegt ueberhaupt noch eine von Hand ein"
und "wer startet einen Server, ohne seine Nummer abzuleiten". Die
zweite Frage hat sofort etwas gefunden, das in KEINER Doppelungsliste
stand: pruef-push-weg belegte 4341 und 4342, rief den Waechter aber
gar nicht auf -- dieselbe Nummer wie pruef-agentur. Eine Liste zeigt
nur, was auf ihr steht.

Mit Gegenprobe: Eine unbekannte Datei bekommt keine geratene Nummer,
sondern einen Abbruch, und eine dritte Nummer je Datei gibt es nicht.

--- NACHGEMESSEN ----------------------------------------------------

Sechzehn Pruefungen gegen ihre vorher gemessene Grundlinie, je eine
Vertreterin jeder umgestellten Bauweise (eine Nummer, zwei Nummern,
Nummer in einer Zeichenkette, in einer Vorlage, in einem regulaeren
Ausdruck, dynamische Einfuhr, Nachtlauf mit zwei Laeufen):

  crew-adresse 132/0 · schranke 39/0 · content 45/0 · entwicklung 46/0
  anruf 127/0 · ics 37/0 · push-weg 20/0 · arten 28/0 · video 67/0
  kanalzeile 14/0 · agentur 62/0 · spicy 83/0 · creator-anlegen 50/0
  push-ziel 10/0 · portnummern 8/0

Alle exakt wie vorher. Zwei waren schon vorher rot und sind es
unveraendert geblieben (crew-wand-bild 41/4, teilen 14/3) -- per
`git stash` belegt, nicht angenommen.

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

server/helfer-port.mjs

@@ -56,3 +56,100 @@ export async function portMussFreiSein(port, wer = "diese Pruefung") {
   }
   return port;
 }
+
+/* =====================================================================
+   WELCHER PORT GEHOERT MIR? (20.09.2026)
+
+   ---------------------------------------------------------------------
+   WARUM ES DIESE FUNKTION GIBT
+
+   Gemessen am 20.09.2026: 164 Pruefdateien, 129 verschiedene Ports --
+   NEUNZEHN Nummern waren doppelt vergeben, eine sogar dreifach
+   (4186, 4188, 4196, 4198 ...). Niemand hatte das absichtlich getan;
+   jede neue Pruefung wurde von einer vorhandenen abgeschrieben, und
+   die Nummer kam mit.
+
+   Der Waechter darueber faengt den Schaden ab -- er bricht ab, statt
+   gegen einen fremden Server zu messen. Aber er kann nur melden, was
+   schon passiert ist: 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 mir heute zweimal passiert.
+
+   EINE GEPFLEGTE NUMMERNLISTE IST DIE FALSCHE LOESUNG. Dieses Haus ist
+   an abgeschriebenen Listen schon dreimal gescheitert (Spaltenliste
+   beim Datenumbau, Namensliste in pruef-anruf, Namensliste in
+   pruef-entwicklung). Eine Liste, die niemand pflegt, kann nicht
+   veralten -- also wird die Nummer ABGELEITET.
+
+   ---------------------------------------------------------------------
+   WIE ABGELEITET WIRD, UND WARUM NICHT MIT EINER PRUEFSUMME
+
+   Der naheliegende Weg waere ein Hash des Dateinamens. Nachgerechnet
+   ist er der schlechtere: Bei 164 Namen in 4900 moeglichen Ports sind
+   nach dem Geburtstagsproblem rund DREI Zusammenstoesse zu erwarten --
+   der Hash tauscht eine sichtbare Doppelung gegen eine unsichtbare.
+
+   Stattdessen: die Stelle im Alphabet. Alle `pruef-*.mjs` im selben
+   Ordner werden sortiert, und wer an Stelle n steht, bekommt Port
+   BASIS + n*2. Das ist NICHT ZUFAELLIG EINDEUTIG, sondern eindeutig
+   von der Bauart her -- zwei Dateien koennen nicht dieselbe Stelle im
+   Alphabet haben.
+
+   Jede Datei bekommt ZWEI Nummern (nr = 0 und 1). Fuenf Pruefungen
+   starten heute einen zweiten Server; der braucht dann keinen eigenen
+   Eintrag irgendwo.
+
+   Nebenwirkung, bewusst in Kauf genommen: Kommt eine neue Pruefung
+   dazu, verschieben sich die Nummern dahinter. Das ist harmlos -- es
+   sind Testports, kein Mensch merkt sie sich -- und der Waechter faengt
+   den einen Fall ab, in dem es zaehlt (ein Prozess von vorhin liegt
+   noch auf der Nummer).
+   ===================================================================== */
+
+import { readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { basename, dirname } from "node:path";
+
+/** Ab hier aufwaerts, zwei je Datei.
+ *
+ *  NICHT 4100: Der echte Dienst hoert dort, und eine Pruefung, die
+ *  versehentlich dorthin zielt, waere der eine Fehler, den der Waechter
+ *  NICHT erkennen kann -- sie bekaeme brav Antworten.
+ *
+ *  UND NICHT 4500, wie hier zuerst stand. Nachgemessen reichen die
+ *  bisher von Hand vergebenen Nummern von 4176 bis 4504 -- der Bereich
+ *  4500-4827 haette sich also mit dem obersten Rest ueberschnitten.
+ *  Das ist der Grund, warum solche Zahlen gemessen und nicht geschaetzt
+ *  werden: "irgendwo ueber 4400" haette plausibel geklungen. */
+const BASIS = 5000;
+const PRO_DATEI = 2;
+
+/** Der Port dieser Datei -- abgeleitet, nicht vergeben.
+ *
+ *  `meta` ist `import.meta` der aufrufenden Datei. Prueft danach
+ *  gleich, ob er frei ist, und bricht sonst ab (siehe oben).
+ *
+ *  DRITTER AUSGANG: Findet sich die eigene Datei nicht in der Liste --
+ *  etwa weil jemand die Funktion aus einem anderen Ordner aufruft --,
+ *  wird NICHT geraten. Eine geratene Nummer waere genau die Doppelung,
+ *  die hier abgeschafft wird. */
+export async function eigenerPort(meta, wer = null, nr = 0) {
+  const pfad = fileURLToPath(meta.url);
+  const mein = basename(pfad);
+  const ordner = dirname(pfad);
+  const alle = readdirSync(ordner)
+    .filter((f) => f.startsWith("pruef-") && 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`
+      + "  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(BASIS + stelle * PRO_DATEI + nr, wer || mein.replace(/\.mjs$/, ""));
+}