#29767 Clean up loose design documents (docs/, specs/, module doc folders): valid content into the developer documentation, open work into tickets

enhancement

major

#29658

TL Views: Schwebende Hauptaktion (Floating Action Button) und Aktionsfächer (Speed Dial)

#29704

tl-archetype-app: Neue Anwendung standardmäßig mit React-Oberfläche erzeugen, klassische Oberfläche per Option

#29729

TL Views: Ein Flussdiagramm (flow-diagram) lässt sich nicht für Mehrfachauswahl konfigurieren

#29781

TL Views: Aktionsketten mit benannten Argumenten – Auslöser liefern mehrere Werte, Skripte verwenden sie als implizite Variablen, Aktionen mit Ergebnis führen Folgeaktionen in <with-result> aus

#29856

React UI: consolidate the access check definitions of views, commands and TL-Script functions

#29860

Konfigurationsformulare: Eingabefelder werden über fachliche Annotationen (@MultiLine, @Code, @Html, @Inline, …) gewählt, in klassischer und React-Oberfläche gleich; @ControlProvider und @ConfigControl entfallen

#29865

Configuration layering: removing a list entry whose key the underlying layers do not (or no longer) define fails the application start

#29875

Design System wave 5a: color input, icon select and slider read the design system package

#29877

Developer docs: an article on the persistency configuration of an application (single branch vs. multiple branches, type systems, what changes the schema)

#29880

XIO: Import of an evolving external format: report unknown elements, reject a second composite container with a location, match several values in one <switch> case

#29887

TL Views: Einfügevorschläge für ein Textfeld - per TL-Script berechnete Vorschläge an der Schreibmarke

#29888

view-layer forms: normalize an entered value before it is stored

#29892

view-layer forms: actions that enter and leave edit mode (<enter-edit-mode/>, <leave-edit-mode/>)

#29893

Model upgrade log does not mention a reference whose target type changed

#29896

Typed configuration: config:ref addresses an entry of a keyed list by a globally unique key without naming the path to it; a view overlay addresses every element by its id

#29904

Design System wave 5b: media controls read the design system package

#29905

Switch tl-engine to Java 21

#29906

Design System wave 5c: calendar, kanban, dashboard and value list read the design system package

#29914

Design System wave 5d: foundation pieces and foreign stylesheets read the design system package; tlReactControls.css is removed

#29917

Rollenprofil-Import: implizite Leserechte der umgebenden Sicherheits-Layouts ergänzen

#29941

TL Views: Auswahlfeld, das zusätzlich einen frei eingegebenen Wert annimmt ("auswählen oder neu eingeben")

#29942

TL Views: Erwähnungen im HTML-Editor - Verweise auf Objekte (z.B. Projektmitglieder, Tickets) per @/# einfügen, die zu Links werden

#29944

Konfigurierbare Start-Haken, die nach dem Start aller Services ausgeführt werden

#29947

Steueranwendung: Workspace-Management – leere TopLogic-Anwendung in einem Docker-Container anlegen, starten, stoppen und aufräumen

#29948

Credentials für externe Dienste ohne Geheimnisse in der Konfiguration: Secret-Quellen, Token-basierte Authentifizierung (Keycloak/OIDC, Workload Identity, Azure) und API-Gateway

#29953

Steueranwendung: Agenten-Harness im Workspace – Auftrag an Claude Code, Live-Transkript, Übernahme durch einen Menschen, LLM-Zugang über einen Proxy

#29954

KI: Modellkatalog aus der Dienstkonfiguration des LLM-Anbieter-Dienstes herausnehmen und in einer eigenen Ansicht zeigen

#29955

React-UI: Dienstkonfiguration anzeigen, bearbeiten und speichern (mit Kennzeichnung "Neustart erforderlich")

#29956

Anwendungen und Fragment-Module ohne TopLogic-Parent-POM bauen: BOM, Maven-Packaging tl-app/tl-fragment und Feature-Starter

#29957

React-Oberfläche: Browser-Tab-Titel folgt der angezeigten Ansicht

#29963

Development-Menü im React-UI nur für angemeldete Benutzer anzeigen

#29965

tl-ai-core: LLM-Anbieter ohne Anwendungskonfiguration über Umgebungsvariablen aktivieren

#29968

Filterleiste: Presets mit Zähler und eigener CSS-Klasse

#29973

XML import: <set-translation> stores an empty text and needs a bound language

#29974

XML import: <unless-known> cannot import the attributes of a known element without its structure

#29975

XML import: <resolve-existing> loads only the partition of existing objects an ID belongs to; linking checks membership without reading the whole reference

#29976

View layer: <tree-table> offers no <export> (Excel export) although the export writes trees as outlines

#29977

View layer: <tree-table> has no node display (icon, label, CSS class per cell) and no row-class

#29981

View layer: a table column cannot be declared unsortable, so the groups it forms cannot keep the order of their rows

#29989

Javadoc-Verweise und ungenutzte Imports im Maven-Build prüfen, Eclipse meldet fehlerhaftes Javadoc nur noch als Warnung

#30012

Translator: erkannte Ausgangssprache bei automatischer Spracherkennung zurückgeben

#30017

Build: Git-Merge-Treiber für die generierten Ressourcendateien, damit parallele Pull-Requests nicht bei jedem neuen Schlüssel in Konflikt geraten

#30051

Initiale Gruppen "user" und "superuser" in der Basis anlegen

minor

#29852

TL Views: Mehrwertige Binärwerte als Datei-Chips (oder Werteliste) mit Mehrfach-Upload, Pflichtfeld, Validierung und accept-Filter; <file-list> entfällt

#29872

TL Views: the min/max/step of a number input (slider) are fixed in the configuration and cannot come from a channel or expression

#29873

TL Views: a time input (ReactDatePickerControl.Kind.TIME) cannot enter or show seconds

#29874

TL Views: a select input always sorts its options by label - no way to keep the order of the option list

#29898

Development start (tl-ide-jetty) provides no Jakarta WebSocket container

#29952

React-View-Schicht: Fenster folgen Commits anderer Threads ohne eigene Konfiguration – ersetzt CommitSource und den Refresh-Teil von AgentViewRefreshService

defect

critical

#29926

Derived attributes computed by a <query> storage evaluate to null for a user without Discover right on the object (regression of #29782 in 8.0.0-alpha11)

#29994

Build: master verletzt den JavaDoc- und Import-Check von #29989 (tl-chat, tl-ai-core, tl-factory)

major

#29742

Konfigurierte Defaults (<defaults>) wirken nicht innerhalb der Anwendungskonfiguration

#29798

Derived reference reads as empty in the commit check (no user): result filter of AttributeByExpression stays on

#29869

A React view window that lost its SSE connection keeps every later KB revision in memory until its session ends

#29876

KnowledgeBase on H2: deleting objects scans the association tables (the reference indexes start with BRANCH, and H2 seeks an IN list only on the first index column)

#29886

view-layer <confirm>: line breaks of the message are collapsed

#29889

Adding one element to a set reference reads the whole set (quadratic set building)

#29895

deploy/local applies only to the module in the working directory: a module of a multi-module build cannot be started from the reactor root

#29908

React-Tabelle zeigt nach dem Neuladen der Seite in den oberen Zeilen keinen Inhalt

#29916

Rollenprofile: Leserecht eines Dialogs wird auf die öffnende Komponente übertragen

#29918

Design System: a panel's toolbar sticks to the title instead of standing at the end of the title bar

#29920

TL Views: Die Zeilenauswahl in einer React-Tabelle braucht bis zu einer Sekunde, weil jede Auswahl alle Zellen neu überträgt und bei einer Tabelle mit Eingabekanal alle Zellen neu erzeugt

#29922

Composition-Tabelle in einem Formular bekommt keine Höhe, ein Dialog kann nicht mehr bis zur Tabelle scrollen

#29923

React-Oberfläche: Inhalt eines Navigationseintrags mit route="none" erzeugt URLs, die sich nicht öffnen lassen

#29925

TestGenerateJavaIntegration fails with the split local Maven repository of the CI builds

#29931

invert-link-table makes both ends of a link the destination on MySQL

#29932

Gruppen und Adressen sind für Superuser nicht lesbar: tl.accounts:Group und tl.accounts:Address haben keine Rollenquelle

#29933

React-UI: Der Griff eines Split-Panels "läuft weg" beim Ziehen mit der Maus; tiefe Baumknoten brechen um statt waagerecht zu rollen

#29934

View-Designer: Zur Laufzeit geöffnete Sichten (Rahmen eines tile-stack, navigate-push, open-dialog) fehlen im Entwurfsbaum und lassen sich nicht per "Sicht auswählen" anwählen

#29964

React UI: password login sometimes logs out immediately - a command of the replaced window triggers the stale-UI reload of the old window URL

#29967

React-UI: Spaltenauswahl der Tabelle bietet das Gruppieren nach einer Spalte nicht mehr an

#29970

React-Bridge: Ein Sprung, der seine Zielseite erst erzeugt, malt sie ohne die gesetzte Auswahl

#29971

React-Views: Die Ausführbarkeit eines Befehls übersieht einen Commit eines fremden Threads während des Seitenaufbaus

#29978

View layer: <tree-table> does not reveal a selected object under a collapsed node and misses changes while hidden

#29979

Migration: migrations of an application module without a stored version never run, the auto model upgrade runs instead

#29980

Migration: update-class with a new-name in another module does not move the class's associations

#29983

View layer: a tab strip wider than its container neither scrolls nor wraps nor collapses into a menu

#29990

React-UI: Panels und bedingte Inhalte nehmen in Split-Flächen, Tabs und Stacks die falsche Höhe

#29991

View layer: split-panel ignores unit="px" of a pane and treats its size as a weight

#29992

React-Modelleditor: Annotation "Eingabekontrolle" bietet keine Umsetzung zur Auswahl an

#29999

React-UI: Tabelle zeigt nicht mehr an, welche Spalten gefiltert sind

#30001

Entwicklungsmodus: neu geschriebene WEB-INF-Dateien sind über den FileManager erst verzögert sichtbar (Theme-Import zeigt keine Variablen, ThemeEditor_Ticket-24158_Import-export scheitert sporadisch)

#30002

Service-Editor: Konfiguration aller Services fehlerfrei anzeigen

#30005

React-Oberfläche: Ein Einstiegspunkt verliert beim Laden seine View-Datei aus der URL, F5 zeigt die Default-View (Regression #29957)

#30013

TL Views: Auswahlfelder bieten später angelegte Objekte ihres Typs erst nach neuer Anmeldung an

#30014

React-Formulare: Sichtbarkeit beim Anlegen (create-visibility) eines Attributs wird nicht berücksichtigt

#30015

React-Oberfläche: Anlegen in einem Container wird nicht geprüft, solange der Container-Kanal leer ist

#30016

Aufzählungswerte (Klassifikatoren) sind für Benutzer ohne Administratorrechte nicht entdeckbar: Ein Aufzählungs-Attribut kann nicht gesetzt werden

#30019

TABLE.debounce() verwendet globalen Singleton-Timer — Slice-Nachladen schlägt bei mehreren Tabellen fehl

#30024

React-Oberfläche: NullPointerException in ModelAccessPolicy.isGrantable, wenn ein Zugriffs-Parent seine Parent-Typen nicht statisch kennt

#30026

Instabiler Test: TestQueueReporter#testGetReport schlägt fehl, wenn zwei Builds auf demselben Knoten gleichzeitig laufen oder der Rechner ausgelastet ist

#30030

Mail-Server-Daemon: neue Mails anhand der IMAP-UID statt des Gelesen-Flags erkennen, unbekannte Mails standardmäßig im Postfach belassen

#30055

TL Views: a table with active-preset and search-term channels renders every filtered row instead of a window; 15k rows load 88 MB and crash the browser tab

minor

#29515

Inkonsistente Drop-Typ Konfiguration für Drop-Operationen möglich

#29868

KBChangeAnalzyer logs "There is a part id ... but no item for update" for every update of a part of a monomorphic inline-set storage

#29883

A boolean attribute without a value reads as false on a persistent object, as null on a transient one

#29894

Commit einer geänderten Annotation loggt ERROR mit Stacktrace, wenn der alte Wert eines abgeleiteten Attributs (z.B. options) nicht mehr instanziierbar ist

#29935

Popup-Fenster (Skript-Rekorder, Dokumentation) lässt sich nach dem Schließen nicht sofort wieder öffnen (Edge/Chromium): Fehler "Cannot read properties of null (reading 'services')"

#29959

Persönliche Einstellungen werden nicht gespeichert, wenn der Benutzer eine verletzte Modell-Bedingung hat (z. B. root ohne Kontaktdaten)

#29960

React-Oberfläche: Browser-Tab zeigt immer "TopLogic View" statt des Anwendungsnamens

#29969

SecurityConfiguration: Crash durch DeletedObjectAccess

#29972

composition-table im Bearbeitungsmodus: die Lösch-Spalte bekommt den freien Platz statt der letzten Datenspalte

#30056

TL Views: NullPointerException in ReactControl.commitUpdate from the session-timeout notice countdown ("Failed to announce the activity of session")

task

major

#29767

Clean up loose design documents (docs/, specs/, module doc folders): valid content into the developer documentation, open work into tickets

#29924

Integrate the tl-ai repository into tl-engine: its modules become engine modules

#30037

Name the base type of polymorphic configuration properties as wildcard bound (PolymorphicConfiguration<? extends X>) and check the rule in the build

minor

#29921

Renovate hinterlässt in npm-Lock-Dateien verwaiste Einträge, die der nächste Maven-Build wieder entfernt

update

critical

#29949

Update dependency dompurify to ^3.4.17 [SECURITY]

#29950

Update dependency vite to ^6.4.4 [SECURITY]

#29984

Update dependency serialize-javascript to ^7.1.3 [SECURITY]

#30008

Update dependency com.google.guava:guava to v33 [SECURITY]

task

major

#29767

Clean up loose design documents (docs/, specs/, module doc folders): valid content into the developer documentation, open work into tickets

Documentation

Problem

Design documents, implementation plans, specs, mockups and work lists of finished features lay scattered over the engine repository: the folder docs/ (170 files: docs/plans/, docs/superpowers/, docs/sweeps/, docs/prototypes/), the folder specs/, react-integration.md in the root, docs/ and doc/ folders of single modules (com.top_logic.layout.view, com.top_logic.layout.react, tl-ai-core, tl-chat, tl-ai-demo, com.top_logic.element, com.top_logic.reporting, com.top_logic.reporting.office, com.top_logic.template, com.top_logic.search.*) and SPEC-audio-recorder.md. Since #29765 the developer documentation lives in the module jars (<module>/src/main/java/META-INF/tl-docs/), where an application finds it through the tl-mcp tools and the documentation window. Valid content in the loose files was invisible there, unfinished work was tracked only in files, and several loose files described designs that were never built that way.

Solution

All loose design documents are removed. Their content was checked against the current code; what a developer needs today is in the developer documentation, what is not built is in tickets.

New and extended developer articles

tl-core: access-checks (the ModelAccessRights API, creating objects, the can* / filterSecurity functions, secured evaluation in own code), additions to access-configuration (<revoke>, inherit of module grants, role-parent steps, <singleton> steps), the chapter authentication (login in both UIs, single sign-on login methods, authentication/mfa).
tl-security-selfservice: authentication/self-service (password reset, second-factor reset, invitations).
tl-element: change-log (change log of an object and its subtree, <change-subtree>, undo / redo / revert).
tl-layout-view: view-layer/client-server-protocol, a section on <slot> / <slot-content> in view-layer/layout, attribute access in forms and tables in view-layer/access-control, the script recorder in view-layer/diagnostics.
tl-layout-react: view-layer/headless-interface; tl-layout-view-agent: view-layer/agent-access.
tl-ai-core: the detail documents of the AI modules as articles of the ai chapter (logging, environment, deep-research, script-and-scheduled-runs, security/test-bed, and sections in tools-and-skills, limits-and-caching, providers, delegation, memory-and-citations, chat-ui). The test-bed harness scripts and the sample upload of tl-ai-demo moved to tl-ai-demo/src/test/.

References to the deleted files in JavaDoc, comments, configuration comments, the upgrade guide 7.11 → 8.0, the startup message of the old LLMService configuration and the descriptions of #29088, #29092, #29109, #29341 and #29430 point to the articles. The description of #29092 now names the modules that were actually built.

Open work as tickets

Table model: #30036 (and #29341).
Flow diagram: #30033; Gantt chart: #30034; model editor: #30035.
Polymorphic configuration wildcard sweep: #30037.
Login, second factor and password reset defects: #30039; self-service: #30041; change-log tests: #30040.
View layer slots: #30045; unused ReactComponentRegistry: #30046; administration views not yet ported: #30047.
Agent access: #30048; headless interface: #30049; script recorder: #30050; audio transcription: status in #29109.
AI runs: tool worker pool and queued chat messages #30053; screenshots view #30054.

Dropped: the phase-1a UI concepts (ideas without a consumer), the msgbuf feature requests (resolved upstream as msgbuf/msgbuf #9-#11), documents of 2006-2010 (view-based security UML, template syntax draft, reporting documentation and slides) and empty search stubs.

Kept: build notes (HOWTO-GWT-COMPILE.md, HOWTO-RELEASE.md, BUILDING.md, TRIAGE.md) and the vendored HttpUnit distribution in ext.com.meterware.httpunit/doc.