#30104 Nächtliche Vorschau-Versionen der Engine mit fester Maven-Version und Änderungsliste statt eines wandernden SNAPSHOT

enhancement

major

#29993

Konfiguration: Jede konfigurierte Funktion wahlweise in Java oder TL-Script implementierbar, mit derselben Konfigurationssyntax (auch im React-Konfigurationseditor)

#30000

Design-System-UI-Durchlauf, Teil 1: ein Auswahlformular; „surface-interactive-selected“ wird zu „surface-interactive-strong“

#30006

Engine-Erweiterungen für die Steueranwendung: beschreibbarer Geheimnisspeicher in der Datenbank, Kontextpfad der Anwendung im Entwicklungsmodus (tl.contextPath) und Instanzsuche nach Attributwert

#30025

React-Oberfläche: Befehle und Einheiten ausblenden, für die der angemeldete Benutzer auf keinem Objekt die nötige Rolle hat

#30031

Datenbank erzwingt keine Eindeutigkeit der Werte von Referenzen ohne Duplikate: eindeutiger Index auf den Link-Tabellen, eigene Link-Tabellen für Bags

#30041

Self-Service-Konten: Einladungen verfallen und ihre Annahme wird protokolliert; Einladungen können in der React-Benutzeroberfläche angenommen und verwaltet werden; lokalisierte E-Mail-Vorlagen

#30045

Ebenen-Slots anzeigen: Bericht über „ <slot-content> “, das „no <slot> “ erreicht, leeres Fallback von „ <slot> “, Slot-Positionen in geteilten Fenstern und in der Seitenleiste

#30053

Agent läuft: Begrenzt die Anzahl paralleler Tool-Aufrufe (AgentLoop.TOOL_WORKERS) und teilt einem Benutzer mit, dessen Chat-Nachricht auf einen freien Worker wartet

#30054

Screenshots von Agenten gehören zu ihrem Chat: Sie werden zusammen mit diesem gelöscht und im Chat als Miniaturansichten angezeigt.

#30057

Verwaltung der React-Benutzeroberfläche: Scheduler (Aufgabenliste, Jetzt ausführen, Stoppen, Aktivieren/Deaktivieren, Cluster-Sperre, Ausführungsverlauf) mit einem einheitlichen Schalter zum Aktivieren/Deaktivieren pro Aufgabe

#30058

Verwaltung der React-Benutzeroberfläche: Speicherverlaufsdiagramm (Speicherauslastung im Zeitverlauf einschließlich Garbage Collection) und die übrigen Überwachungsansichten der klassischen Benutzeroberfläche

#30059

Verwaltung der React-Benutzeroberfläche: Wartungsfunktionen der klassischen Wartungsseiten (Datenbank-Export/Import/Verlaufskomprimierung, SQL-Konsole, Neuladen, Suchindex, Sicherheitsspeicher, Verschlüsselung)

#30061

React UI: Letzte Änderungen des Benutzers mit Rückgängigmachen eines Commits (Benutzermenü)

#30062

Modell-Editor der React-Benutzeroberfläche: Instanz-Browser und Instanz-Import des ausgewählten Typs

#30063

Verwaltung der React-Benutzeroberfläche: Personen (Kontakte mit optionaler Anmeldung) in einem Formular

#30064

Verwaltung der React-Benutzeroberfläche: Anmeldemeldungen (Meldungen, die bei der Anmeldung angezeigt werden, mit Angabe ihrer Gültigkeitsdauer)

#30065

React-Oberfläche: Workflow-Administration mit BPMN-Editor, Schrittansichten aus dem View-Designer und Aufgabenbearbeitung (BPE)

#30066

React-Administration: Wirksame Rechte eines Kontos auf einem Objekt anzeigen und erklären (Rolleninspektor)

#30074

React-Oberfläche: Anmeldung mit Passkeys (WebAuthn) - passwortlos oder als zweiter Faktor neben TOTP, Verwaltung der eigenen Passkeys in den Einstellungen

#30075

Protokollansicht (React-UI): Details eines Eintrags (Stacktrace) in einem Dialog lesbar anzeigen

#30076

React-Oberfläche: Passwortänderung mit Bestätigungsmeldung und Prüfung vor der Identitätsabfrage; Schutz gegen Durchprobieren von Passwörtern und Einmalcodes

#30081

TL Views: Authenticator-App wechseln (neues TOTP-Geheimnis), Zwei-Faktor-Authentifizierung durch Administrator zurücksetzen

#30086

XML-Import: Die Datei „ <update> “ unter <unless-known> muss die Struktur der untergeordneten Elemente, die sie aktualisiert, wiedergeben.

#30088

Ebene anzeigen: Dokumentieren Sie, wie eine „ChannelSource“ einen Monitor am Laufen hält, während dessen Ansicht ausgeblendet ist, und ihn mit dem Fenster beendet.

#30095

OpenAPI-Client: Parameterwert aus einer Secret-Quelle

#30096

Rechtesystem: Konfigurierbaren Group-Mapper des ElementAccessManager entfernen

#30097

JavaScript-Bibliotheken (umljs, ace, require.js, bpmn-js) im Maven-Build erzeugen statt einzuchecken, bpmn-js auf 18 aktualisieren

#30098

Designsystem als Engine-Modul: Erstellung durch Maven anstelle einer eingecheckten Kopie mit Seals

#30104

Nächtliche Vorschau-Versionen der Engine mit fester Maven-Version und Änderungsliste statt eines wandernden SNAPSHOT

#30108

pac4j-Anmeldung: Die Konto-Zuordnung erhält die ganze Identität des Identity-Providers (Subject, Claims) statt nur eines Login-Namens

#30116

CommonMark: Tabellen (GFM) als HTML-Tabellen darstellen

#30117

Refetch-Timeout nennt nicht den Thread, der die Commit-/Refetch-Sperre hält

#30120

Ebene anzeigen: Optionen eines Zeichenfolgenattributs dürfen keine Anzeigebezeichnungen enthalten

#30122

TLDoclet-Ausnahmen in ext/javadoc/javadoc-ignores abbauen

#30126

tl-chat: Chat-Aktionen laufen als React-Commands des Fensters statt über einen eigenen ChatServlet; der Proxy-Workaround des Chats entfällt zugunsten des Pollings der Engine

#30131

Ebene anzeigen: Den Fallback von „AttributeWithFallbackStorage“ als Platzhalter für ein Formularfeld anzeigen

#30132

Ebene anzeigen: Die Wert-Listener des Modells (<value-listeners>) reagieren über einen UI-unabhängigen Listener-Vertrag auf Feldänderungen im React-Formular.

#30148

RecollateStringColumnsProcessor: ANALYZE nach dem Umstellen der Collation ausführen (PostgreSQL)

#30149

Einem Chat-Agenten soll es ermöglicht werden, Seitenbefehle auszuführen, die auf der Chat-Seite zulässig sind, z. B. einen Dialog zu öffnen

#30150

Stellen Sie einen Anbieter mit aufgezeichneten Musterantworten für die Agentenprüfungen der Bewerbungen bereit

#30151

React-View-Schicht: Befehle ohne HandlerResult - View-Befehle melden Fehler als Exception, React-Befehlshandler liefern ihre Antwort als msgbuf-Nachricht

#30157

React-Oberfläche: Bilder im HTML-Editor einfügen per Strg+V und Drag&Drop, Größe mit Anfassern ändern, nie breiter als der Inhalt

#30158

TL-Chat: Einem Chat-Agenten ermöglichen, die Eingabe eines von ihm ausgeführten Seitenbefehls weiterzugeben

#30160

Albert in eine Anwendung integrieren: fertige React-Chat-Seite, Anleitung und Standardwerte für Archetypen

#30163

SQLFactory: Spaltenänderungen (modifyColumnName/Type/Mandatory) nur mit vollständiger Spaltendefinition erzeugen

#30167

Datenbank-Defaults für Spalten entfernen: Pflichtspalten per „anlegen, füllen, Pflicht setzen“ hinzufügen

#30172

Konten über eine externe Anmeldung erstellen und ihnen über einen Claim Gruppen zuweisen

#30179

Eine Anwendung, die mit „useSSO=true“ erstellt wurde, bietet die generische OpenID-Anmeldung an, die über die Umgebungsvariablen „tl_pac_*“ aktiviert wird – auch auf dem Entwicklungsserver.

#30183

Self-Service: Offene Selbstregistrierung ohne Einladung

#30190

Entfernen Sie die Steuerungsanwendung „tl-factory“ aus der Engine; sie wird in einem eigenen Repository entwickelt.

#30200

Agent-Zugriff und Aufzeichnung: Kommandos arbeiten auf stabilen Objekt-IDs, fachliche Schlüssel nur für Aufzeichnung und Wiedergabe

#30215

Ebene anzeigen: Ein Wertkanal, dessen Wert pro Benutzer gespeichert wird

#30223

Self-Service-E-Mails: Texte in der Servicekonfiguration bearbeitbar, Sprache der Einladung wählbar

#30225

Modell: Handler, die für ein Attribut (Änderung) oder einen Typ (Erstellung, Löschung) deklariert sind, werden innerhalb des Commit ausgeführt

#30227

Design-System-UI-Übung, Teil 1b: Tabellen mit Tiefenwirkung und sichtbaren Spaltengrenzen

#30250

TL-Ansichten: <start-job> / <job-status> – Schließen-Schaltfläche für einen abgeschlossenen Job, „Point of No Return“, Teilergebnis eines abgebrochenen Jobs, Schließen des Dialogs aus dem Folgejob heraus, der Folgejob sieht die Commits des Jobs

#30253

tl-ai-core bindet die Playwright-Browser (Driver-Bundle, 200 MB) in jede Anwendung ein: Die Browser-Tools werden in das optionale Modul tl-ai-browser ausgelagert.

#30266

React-Konfigurationseditor: Mehrzeilige Texte (HTML, Markdown, Code, mehrzeilig) nutzen standardmäßig die ganze Zeile

#30267

Geheimnisse aus der Administration setzen und entfernen, beschreibbare Verzeichnis-Ablage

#30268

Systemumgebung: Herkunft der Konfigurationsvariablen anzeigen und Variablen aus der Administration setzen

#30276

KI-Agenten: Aussagekräftige Commit-Nachrichten für Änderungen eines Agenten statt "Agent edit"

minor

#30139

TL Views: Einheit und eigenes Zahlenformat für Zahlenfelder

#30188

TL-Script: Binärwert als Text lesen; Webapp-Ressource als Binärwert lesen

#30209

React-Tabelle: Spalten abhängig von Kanalwerten ein- und ausblenden (exists-if)

#30218

ModificationListener: Es gibt keine unterstützte Möglichkeit, dem Benutzer mitzuteilen, was durch eine Modifikation geändert wurde, sobald der Commit erfolgreich war.

defect

critical

#30146

Datenmigration ist beim gleichzeitigen Start mehrerer Cluster-Knoten nicht gegen parallele Ausführung geschützt

#30196

Abbrechen eines Hintergrundjobs (TL Views <start-job>, Scheduler-Task, JMS-Consumer) unterbricht den Thread mitten im Datenbankzugriff und schließt eine eingebettete H2-Datenbank (MVStore panic, Anwendung unbenutzbar)

#30224

TestFlowSvgPortable lässt sich nicht kompilieren: FlowFactory.chart() hat den Parameter „fixedView“

#30301

React-Views: TestTreeTableRowEdit kompiliert auf master nicht mehr (ExpandArguments.ROW_INDEX durch ROW_ID ersetzt)

major

#29847

Der Skript-Test „TestTransactionMonitor-01_RevertRevision“ schlägt fehl, wenn eine geplante Aufgabe gleichzeitig eine Transaktion abschließt.

#30043

TL Views: Ein Wert, den der Server festlegt, während der React-Rich-Text-Editor den Fokus hat, wird nie übernommen; der Editor behält seinen Text nach dem Absenden bei.

#30067

React-Oberfläche: Anmeldung in einem Browser-Tab meldet sofort wieder ab, wenn ein zweiter Tab der Anwendung offen ist

#30077

TL Views: Wizard - ein erneut betretener Auto-Weiter-Schritt ohne eigene Navigation lässt den Benutzer ohne Weg zurück in den Ablauf

#30078

React-Oberfläche: Beim Einrichten der Zwei-Faktor-Authentifizierung wird der Schlüssel für die manuelle Eingabe nicht angezeigt, nur der QR-Code

#30079

Konfigurierte SecurityParents funktionieren nicht mit StructuredElementWrapper

#30082

React-Oberfläche: Reiter eines Dialogs verändern die Adresse der Seite und bleiben nach dem Schließen in der URL stehen

#30090

Scheduler: Ein beim Start fälliger Task wird beim Herunterfahren abgehängt, während er noch läuft (NullPointerException in TaskImpl.getLog())

#30099

Scheduler-Tests: testStartTaskImmediately / testPeriodically laufen seit der Überarbeitung des Schedulers zeitweise in einen Timeout

#30103

tl-maven-plugin: Schlägt das Zusammenführen der View-Overlays beim Bau einer Anwendung fehl, bleibt das Build grün

#30106

tl-chat: Befehle im Kopf einer data-list zeigen ihren Zustand nicht (ausgeblendet, deaktiviert mit Grund); ein Klick auf einen gesperrten Befehl bleibt stumm

#30107

tl-maven-plugin: Schlägt das Erzeugen eines Layouts beim Bau einer Anwendung fehl, bleibt das Build grün

#30109

tl-chat: Nach der Anmeldung im selben Browser-Fenster bleibt der Chat bei „Melde dich an, um den Chat zu nutzen“

#30110

Abgebrochener externer Login (OIDC) hinterlässt eine angemeldete Session ohne Tokens

#30115

delete-module / delete-class räumen hasWrapperAttValue-Daten nicht auf

#30118

Passkeys je Anwendung entweder zum Anmelden ohne Passwort oder als zweiter Faktor, nicht beides zugleich

#30119

AlterColumnProcessor aktualisiert das gespeicherte Schema für abstrakte Typen nicht

#30123

Scheduler meldet fälschlich „There is no thread to remove“, wenn der Start eines Tasks scheitert

#30124

OpenAPI-Server: Fehlermeldung eines gescheiterten Skripts ist unlesbar und wird außerhalb des Interaction-Contexts erzeugt

#30125

Agent-Zugriff: /agent-api antwortet auf eine Anfrage ohne gültige Anmeldedaten mit einer Weiterleitung zur Anmeldeseite statt mit einem 401-Fehler.

#30127

Eine Anwendung im Server-Stammverzeichnis behält ihre Sitzung bei: Das Sitzungs-Cookie wird an alle ihre Pfade gesendet, und die React-Seite zeigt ihr Symbol an.

#30128

Ein Aufruf ohne Anmeldedaten des Anbieters führt zu einem Authentifizierungsfehler, und der HTTP-Code 402 bedeutet bei jedem Anbieter einen Abrechnungsfehler.

#30133

Ebene anzeigen: Ein Feld, das aufgrund der dynamischen Sichtbarkeit als Pflichtfeld gekennzeichnet ist, verliert bei einer Validierungsänderung die Markierung „erforderlich“.

#30141

TypeIndexer: Java 21 als unterstützte Quellversion; Records indizieren

#30143

TL Chat: Während ein Agent mehrere Schritte ausführt, bleibt sein letzter Text sichtbar und die Laufzeile nennt den aktuellen Schritt, statt nur "…" und "Arbeitet …" zu zeigen

#30144

In einer Anwendung mit modellbasierter Sicherheit sind Chat-Sitzungen für ihren Eigentümer nicht sichtbar.

#30147

React-Oberfläche: Menü "Weitere Aktionen" schließt nicht mit Escape, wenn alle Einträge deaktiviert sind

#30159

Script-Recorder der React-Oberfläche: Aufnahmen von Baum, Mehrfachauswahl und Dropdown-Assertions lassen sich in einer anderen Sitzung wiederholen

#30164

TL-Chat: Ein Lauf, der mit einer Ausnahme fehlschlägt, hinterlässt keinen Fehler im Chat; er verschwindet nach einem Neuladen.

#30165

React: Ein Befehl mit „ignoreStaleUi“ an ein Steuerelement, das nicht mehr auf dem Bildschirm angezeigt wird, schlägt weiterhin mit dem Fehler 404 „Steuerelement nicht gefunden“ fehl.

#30166

TL-Chat: „runPageCommand“ gibt dem Modell die Ablehnung eines Seitenbefehls auf Englisch statt in der Sprache des Benutzers zurück.

#30173

Die OIDC-Anmeldeschaltfläche wird angezeigt, obwohl der Client weder über eine Discovery-URI noch über Anbieter-Metadaten verfügt.

#30176

Der Entwicklungsserver wird über /admin/stop von jeder beliebigen Adresse aus angehalten.

#30177

Der Entwicklungsserver ignoriert X-Forwarded-*-Header, sodass eine relative Callback-URL hinter einem Proxy den falschen Ursprung angibt.

#30184

DeleteTableProcessor entfernt keine <alternative>-Elemente aus dem gespeicherten Schema

#30201

Veto gegen die Modellbeschränkungen einlegen: Bei einem fehlgeschlagenen Auftrag (und dessen Protokoll) wird lediglich „Kann nicht gespeichert werden, Beschränkungen verletzt“ angezeigt, ohne dass die Probleme aufgeführt werden.

#30216

Hintergrundarbeit scheitert mit „Session revision invalid", wenn das Fenster währenddessen speichert (Jobs, KI-Läufe)

#30231

HtmlResKey: Wert auch als Attribut einlesen (Format ergänzen)

#30244

tl-archetype-deploy: Abhängigkeit des Archetyp-Integrationstests auf tl-demo deklarieren

#30247

Migration auf PostgreSQL mit autosave=NEVER: Erwartete SQL-Fehler brechen die Transaktion ab

#30251

tl-ai-core, Anthropic-Anbieter: Claude 5.5-Modelle fehlen im mitgelieferten Modellkatalog, und claude-haiku-5-5 hat ein „Thinking Budget“ zurückgegeben (HTTP 400)

#30252

tl-ai-mcp-server: „tools/list“ wird nicht anhand der Zugriffsrechte des Aufrufers gefiltert, und „/mcp/“ mit einem abschließenden Schrägstrich liefert den Status 404.

#30254

tl-chat: a missing API key is announced as a rejected key ("Das Modell hat den Zugangsschlüssel abgelehnt")

#30255

tl-ai-core: Der Agent-Zug wurde mit der Meldung „Objekte vom Typ … ohne Berechtigung erstellen“ zurückgesetzt, wenn ein Tool ein Teil in einem Objekt erstellt, das im selben Zug erstellt wurde – die doppelte Pre-Commit-Prüfung entfernen, Anfangswerte im TL-Script überprüfen

minor

#29961

React-Anwendungen enthalten Module der klassischen Oberfläche (Self-Service, WYSIWYG-Editor, Code-Editor, Suche, Monitoring, KI-Administration)

#30044

TL-Ansichten: Ein Seitenleisten-Trennzeichen bleibt sichtbar, wenn alle darauf folgenden Elemente ausgeblendet sind; in der anonymen Sitzung wird das System-Trennzeichen angezeigt, unter dem sich nichts befindet.

#30085

Vorgabewerte <country value="..."/> und <time-zone value="..."/> (CountryDefaultProvider, TimeZoneDefaultProvider) nicht nutzbar

#30089

TL-Script-Funktionen `binarySize()` und `modelHealthReset()` liefern Ganzzahl statt Double und protokollieren bei jedem Aufruf einen Fehler

#30121

Kompilierungsfehler in Eclipse in TL 8 alpha12

#30134

Ebene anzeigen: „ <composition-table> “ ignoriert die Sichtbarkeit (dynamic-visibility, hidden, read-only) seines zusammengesetzten Attributs.

#30140

TL Views: „TestViewsLoad“ erkennt keine undefinierte Variable im Wert-Ausdruck einer berechneten Spalte

#30142

CommaSeparatedStringSet: Nicht-deterministische Serialisierung erzeugt doppelte key-attributes in Schema-Baseline

#30180

Flow-Diagram (Gantt): Klick auf Element wählt nichts aus, wenn frozenRows > 0

#30181

Flow-Diagram (Gantt): Diagramm wird immer komplett eingepasst – kein vertikales Scrollen, unlesbar bei vielen Zeilen

#30185

Flow-Diagram (Gantt): Beschriftung von LineDeco (z. B. „Heute“) unter fixierten Kopfzeilen abgeschnitten; Kanten ohne Pfeilspitze

#30187

Diagramm-Export als SVG (reactFlowToSvg, flowToSvg) ist nicht Batik- bzw. druckfähig

#30191

Die Modulabschaltung führt zu keiner Abschaltung des Moduls, wenn die Klasse seines InContext-Jobs nicht geladen werden kann (die Datenbank bleibt in der JVM des Containers geöffnet).

#30197

React-Tabelle: Datumszelle im In-Place-Edit übernimmt jeden Tastatur-Zwischenstand (z. B. Jahr 0002)

#30198

React-Views: Baumtabelle ({{{<tree-table>}}}) ohne Zeilenbearbeitung ({{{row-edit}}}) – kein Ersatz für das klassische Tree-Grid

#30199

React-Views: Zeilenbearbeitende Tabelle zeigt bei verletztem Constraint nur einen roten Rahmen, keinen Meldungstext

#30204

React-Tabelle: Attributspalte bei mehreren Zeilentypen nur am ersten Typ aufgelöst (Beschriftung, Sortierung, Filter)

#30205

React-Tabelle mit Row-Edit: Spalte auf ein abgeleitetes Attribut ist editierbar, Speichern scheitert

#30206

React: Deaktivierter upload-command zeigt keinen Grund; null-input-disabled sperrt ihn immer

#30207

React: button mit Upload-Aktion öffnet keine Dateiauswahl

#30208

React-Tabelle: keine Zellanzeige für externe Links (URL)

#30211

React: Eingebaute Regeln von delete-object und Co. greifen vor den konfigurierten (visible-if wirkungslos)

#30212

React: null-input-disabled prüft nur den ersten Input

#30213

Binärattribut: Abfrage des Inhaltstyps lädt den ganzen Inhalt; BLOB-Spalten in Objekttabellen nur für kleine Werte

#30214

Ebene anzeigen: Tooltips lassen die Zeilenumbrüche ihres Textes weg (.tl-tooltip__body hat „white-space: normal“)

#30226

React-Tabelle: Befehle kennen weder die angezeigten Zeilen noch deren Reihenfolge

#30237

React-UI: Keine Anzeige, während ein Befehl auf dem Server läuft

#30256

React-UI: Farbrolle einer Zeile, Zelle oder Anzeige als eigenes Skript (row-role, cell-role, role) statt der wirkungslosen Statusklassen tl-status-*

#30257

React-UI: Befehle eines Fensters aus einer abgelösten Sitzung erzeugen je Befehl zwei WARN-Zeilen

#30258

React-UI: Reiter nur für einen Typ zeigen geht nur über eine Typabweichung in access-control, und die wird als WARN geloggt

#30259

KB: Committable.rollback() wird nach erfolgreichem Datenbank-Commit aufgerufen, wenn das Veröffentlichen der Änderungen oder Caches scheitert

#30265

TL-Script: try() gibt bei throw() und TopLogicException nur den Text der Meldung statt des ResKey an catch

#30269

ModelAccessRights.isAllowed(Person, ...): Prüfung für eine andere Person übernimmt Bypass bzw. Admin-Status des aktuellen Kontexts

task

major

#30046

Entfernen Sie den nicht verwendeten Dienst „ReactComponentRegistry“

update

critical

#30111

Update der RequireJS-Abhängigkeit auf ^2.3.7 [SICHERHEIT]

enhancement

major

#30104

Nächtliche Vorschau-Versionen der Engine mit fester Maven-Version und Änderungsliste statt eines wandernden SNAPSHOT

TLFactory

Kontext

Projekte, die auf dem Entwicklungsstand der Engine aufbauen (z.B. die Steueranwendung TopLogic/tl-factory), hängen von 8.0.0-SNAPSHOT ab. Dieser Stand ändert sich unbemerkt: mvn -U holt, was master zuletzt gebaut hat. Welche Tickets hinzugekommen sind und welche Anpassungen sie verlangen, ist nicht ersichtlich. Ein Bruch zeigt sich erst im Build oder in der laufenden Anwendung.

Beispiel: Mit dem Snapshot vom 31.10.2026 entfielen CommitSource (#29952) und der Anker system-separator der Shell app.view.xml. Ermittelt wurde das erst über einen fehlschlagenden Test bzw. eine Prüfung im Browser.

Der nächtliche Build TL7 baut und testet master bereits vollständig und setzt dabei das Tag BUILD/BUILD-<n>. Feste Maven-Versionen gibt es aber nur für die alpha-Releases, weil eine Version in den pom.xml bisher einen Commit auf master bedeutete. Das soll vermieden werden, damit die Historie der POMs nicht jede Nacht wächst.

Verbesserung

Nach jedem grünen nächtlichen Build (und auf Anforderung für ein beliebiges Build-Tag) wird eine Vorschau-Version mit fester Maven-Version im Release-Repository des Nexus veröffentlicht, zusammen mit der Liste der seit der vorigen Vorschau-Version hinzugekommenen Tickets und ihrer Migrationshinweise. Ein abhängiges Projekt pinnt eine Vorschau-Version (<tl.version>8.0.0-alpha12.813</tl.version>); Renovate schlägt die nächste vor. Ein Versionswechsel ist damit ein bewusster Schritt mit bekannten Tickets und Anpassungen. Bricht er etwas, liegt die Ursache zwischen zwei bekannten Tags.

Lösung

Versionsschema

<X.Y.Z>-alpha<N>.<n>:

X.Y.Z ist die Version von master ohne -SNAPSHOT.
N` ist das höchste alpha-Release dieser Version (Tag `TL_X.Y.Z-alpha<N>), 0, solange es noch keines gibt.
n` ist die Nummer des Build-Tags `BUILD/BUILD-<n>, aus dem die Version gebaut wird. Sie ist eindeutig (auch bei mehreren Builds an einem Tag) und führt direkt zum gebauten Stand.

Nach ComparableVersion von Maven (geprüft mit 3.9.16) sortiert das richtig, auch nach dem Release 8.0.0, wenn master auf 8.1.0-SNAPSHOT steht:

8.0.0-alpha12 < 8.0.0-alpha12.813 < 8.0.0-alpha13 < 8.0.0 < 8.1.0-alpha0.820 < 8.1.0-alpha1 < 8.1.0

Die 0` ist nötig: `8.1.0-alpha.820 sortiert hinter 8.1.0-alpha1. Ein unbekannter Qualifier wie 8.0.0-preview.813 sortiert hinter 8.0.0. Da Vorschau-Versionen Vorabversionen sind, schlägt Renovate sie einem Projekt auf einer stabilen Version nicht vor.

Veröffentlichung ohne Commit auf master (tl-ci)

Der Job tl-ci-release (Repository tl-ci, release/Jenkinsfile, scripts/release.sh) hat die Parameter PREVIEW und PREVIEW_RETENTION_DAYS (Standard 56). Mit PREVIEW veröffentlicht er das Build-Tag FROM_TAG (BUILD/BUILD-<n>) als Vorschau-Version: release:prepare des maven-release-plugin auf einem lokalen Arbeits-Branch am Build-Tag mit pushChanges=false (dieselbe Mechanik wie bei den alpha-Releases, einschließlich der Property tl.version in tl-bom), release:perform mit localCheckout aus dem lokalen Stand, danach wird nur das Tag gepusht. Tests laufen nicht erneut, sie liefen im nächtlichen Build. Kein Branch des Repositorys ändert sich; master bleibt bei X.Y.Z-SNAPSHOT.
Tag: PREVIEW/TL_<version>, z.B. PREVIEW/TL_8.0.0-alpha12.813. Es enthält genau die veröffentlichten Quellen. Der eigene Namensraum hält die Vorschau-Versionen aus den Suchen nach Release-Tags (TL_*) heraus. Existiert das Tag schon, endet der Job erfolgreich ohne Build.
Der nächtliche Build TL7 startet tl-ci-release nach einem erfolgreichen Build mit FROM_TAG=BUILD/BUILD-<n> und PREVIEW=true. Auf Anforderung lässt sich tl-ci-release ebenso für ein beliebiges Build-Tag starten.
Schlägt nach dem Deploy die Änderungsliste, das Gitea-Release oder das Aufräumen fehl, wird der Build instabil (die Version ist dann bereits veröffentlicht).

Änderungsliste

Je Vorschau-Version ein Gitea-Pre-Release am Tag, https://git.top-logic.com/TopLogic/tl-engine-7/releases/tag/PREVIEW/TL_<version>. Es listet die Tickets aus den Commits seit der vorigen Vorschau-Version (ohne vorige Vorschau-Version: seit dem letzten Release-Tag) mit Typ und Zusammenfassung aus Trac, die Abhängigkeits-Aktualisierungen (DependencyUpdate) gesondert. Die Abschnitte == Migration == der Tickets mit dem Schlüsselwort RequiresMigration stehen voran, von Trac-WikiFormatting nach Markdown umgesetzt. Erzeugt wird die Liste vom Unterkommando tl-release preview-notes --since <rev> --until <rev> des Werkzeugs tl-release (Repository tl-dev-mcp), das die Ticket-Ermittlung der Releases wiederverwendet. Das Trac-Konto liest der Job aus dem Jenkins-Credential tl-ci-trac (Benutzername mit Passwort), das er nur für Vorschau-Releases als TRAC_USERNAME / TRAC_PASSWORD bindet.

Renovate verlinkt die Änderungsliste über prBodyNotes im Pull Request; der Entwicklerartikel application-project (Abschnitt Building on the development state: preview versions) beschreibt die Verwendung einer Vorschau-Version und die Renovate-Konfiguration (ignoreUnstable: false, damit Renovate auch über X.Y.Z hinweg zur nächsten Vorschau-Version wechselt).

Anpassungshinweise

Es gilt die bestehende Konvention der Releases: Ein Ticket, das eine API oder Konfiguration inkompatibel ändert, beschreibt in einem Abschnitt == Migration == seiner Beschreibung, was ein abhängiges Projekt ändern muss, und trägt das Schlüsselwort RequiresMigration.

Aufräumen

Vorschau-Tags und ihre Gitea-Releases werden nach 8 Wochen (PREVIEW_RETENTION_DAYS) gelöscht. Im Nexus entfernt eine Cleanup-Policy die Vorschau-Versionen nach derselben Frist.

Voraussetzungen auf den Jenkins-Knoten

uv/`uvx`, xmllint, python3 und curl. uv ist per pipx für den Benutzer jenkins installiert; die Knoten-Variable PATH+LOCAL=/var/lib/jenkins/.local/bin macht es den Builds zugänglich.