Was der mzone​-publisher kann

Eine Wiki-Seite ist hier keine Datei, sondern eine Zeile in PostgreSQL mit einem Kontext-JSON und einer Vorlage. Beim Veröffentlichen liest der Server jede Verweisform aus dem Text und trägt sie in eine Kantentabelle ein. Daraus entsteht, was ein Ordner voller Markdown nie hat: Rückverweise. Die Frage „wer zeigt auf diese Seite“ ist eine Abfrage, kein Suchlauf.

mergePageContext aktualisiert einzelne Abschnitte über einen stabilen Schlüssel, statt die Seite zu überschreiben — bekannte Elemente werden gepflegt, neue angehängt, nicht genannte bleiben stehen. Etwas zu löschen verlangt darum eine ausdrückliche Ansage. Das ist unbequem und mit Absicht so: versehentliches Löschen ist der teurere Fehler.

Seiten mit dem Präfix priv- beantwortet der Ausliefer-Pfad mit 404, nicht mit 403. Ein 403 würde verraten, dass es sie gibt.

Verbindungen werden nicht von Hand geführt. Andockseite, senkrechtes Ansetzen, das Verteilen mehrerer Kanten auf derselben Boxkante und das Ausweichen um fremde Boxen rechnet der Server. Wer nur Knoten und Kanten schickt, bekommt bei zehn der 35 Typen auch die Anordnung geschenkt.

Die Budgets sind keine technische Grenze, sondern eine gestalterische: neun Knoten sind das, was ein Mensch auf einen Blick fasst. Wer mehr braucht, teilt in Übersicht und Detail — das erzwingt der Validator, nicht die Höflichkeit.

Publizierte Diagramme können mehr als angeschaut werden: Knotensuche, Fokus auf die Nachbarschaft, Reach-Trace stromauf und stromab, eine Routensonde zwischen zwei Knoten und geführte Kapitel, bei denen die Kamera mitfährt. Seit Kurzem läuft ein Kapitel auch als Walkthrough Schritt für Schritt eine Kantenfolge ab. Zwei Fassungen einer Seite lassen sich strukturell vergleichen — mit einer maschinenlesbaren Quittung, welche Knoten dazukamen, verschwanden oder nur umgeleitet wurden.

Nach jedem Publish lädt ein echter Browser die Seite und zählt nach, wie viele Formen wirklich sichtbar sind. Weicht das von der Bilanz des Renderers ab, steht es in der Antwort. Ein Diagramm, das leer gerendert wird, kommt hier gar nicht erst durch.

Ein Artefakt ist ein index.html mit beliebigen Begleitdateien — Skripte, Stile, Bilder, Schriften, WASM. Relative Pfade funktionieren, weil alles unter /published/{slug}/ mit richtigem MIME-Typ ausgeliefert wird. Diese Seite ist selbst so eines.

Vor dem Schreiben steht das Prüfen: validateArtifact nimmt das Bundle, prüft Größen, Dateitypen, abgeschnittenes HTML und Verweise ins Leere, lädt es in einem echten Browser und meldet Konsolenfehler zurück — und gibt eine Vorschau-URL, unter der man es ansehen kann, ohne dass etwas veröffentlicht wäre. Für Externe hält so ein Link bis zu sieben Tage.

Was der Server schon hat, muss nicht noch einmal übertragen werden: eine Datei darf statt eines Inhalts einen fremden Slug nennen. Und ein geprüftes Bundle wird per Token publiziert, ohne es ein zweites Mal zu senden.

Ein bestehender Slug wird nur mit ausdrücklicher Erlaubnis ersetzt; der alte Stand bleibt als Version erhalten und ist mit einem Aufruf zurückholbar. index.html läuft auf no-store, Begleitdateien auf no-cache mit frischem ETag — ein Republish ist sofort sichtbar, Dateinamen zu versionieren wäre vergebliche Mühe. Bibliotheken unter /lib dagegen tragen die Version im Pfad und werden immutable ausgeliefert.

Der Dienst ist zugleich ein MCP-Server. Ein Agent muss die Werkzeuge nicht raten: ein Werkzeugkatalog entsteht per Reflection aus dem Quelltext, und getCapabilityFor liefert genau das angefragte Stück davon — ein Diagrammtyp mit seinem Budget, die gepinnten Bibliotheken, die erlaubten CSS-Klassen — statt die ganze Landkarte.

Zwei Seiten entstehen beim Deploy neu und richten sich ausdrücklich an Maschinen: llms.txt ist ein Index aller gültigen Seiten mit Titel, Einzeiler und URL, gruppiert nach Präfix. mzp-api ist die vollständige Werkzeugreferenz mit Parametertabelle je Werkzeug. Die Zahl oben stammt aus dieser Seite, live gezählt.

Seit Kurzem fragt das Veröffentlichen zurück: Kann der verbundene Client Rückfragen, bekommt er die Vorschau-URL angeboten und muss zustimmen, bevor geschrieben wird. Kann er es nicht, läuft alles wie zuvor — die Rückfrage ist ein Zusatz, kein Tor.

Vier Prüfungen im Testlauf bewachen nicht die Qualität, sondern die Richtung: Sie brechen den Bau, wenn etwas schlechter wird, und lassen in Ruhe, was schon schlecht ist. Jede darf verletzt werden — aber nur mit einem Registereintrag, und der trägt seine Begründung in derselben Zeile. Ohne Begründung scheitert schon der Parser.

Auch Schrumpfen bricht die Prüfung: wird eine Datei kleiner als ihr Registerwert, wird der Wert nachgezogen. Das ist unbequem und der einzige Grund, warum ein Register je kleiner wird.

Der Testlauf fährt gegen ein echtes PostgreSQL im Container, mit durchlaufenden Migrationen — eine kaputte Migration fällt im Lauf auf, nicht erst beim Ausrollen. Daneben steht ein Backlog-Cockpit mit 68 Tickets, das derselbe Agent liest und schreibt, der die Seiten baut.

Ein Export publizierter Seiten nach PDF, DOCX und EPUB ist gebaut und liegt hinter /api. Er ist token-pflichtig und darum von außen nicht nachprüfbar — hier steht er als vorhanden, nicht als vorgeführt.