daw-lua-common auf daw_error/v1 umstellen #42

New issue

Open

opened 2026-08-10 07:41:42 +02:00 by michael · 0 comments

michael commented

2026-08-10 07:41:42 +02:00

Owner

Ziel

Alle return nil, "<string>"-Fehlerrueckgaben in daw-lua-common
durch daw_error/v1-Objekte ersetzen.

Begruendung

Bewusste Entscheidung, die private 2.0.0 vor der Veroeffentlichung
noch einmal zu brechen, um den Fehlervertrag jetzt sauber zu ziehen,
statt spaeter 40 Module erneut umzubauen. Umfangs-Check ergab: 171
Stellen mit return nil, ..., verteilt ueber 37 Lua-Dateien (base64,
config_parser, crypto, decimal, fs/, json/, sys, time, uuid,
yaml/*).

Umfang

Datei fuer Datei, base64.lua zuerst als Referenz/Muster fuer den
Rest
Oeffentliche Funktionen erzeugen bei eigenem Fehler ein neues
daw_error/v1-Objekt; beim Weiterreichen eines Fehlers einer
anderen oeffentlichen Funktion wird das empfangene Objekt als
cause eingebettet
Interne (nicht-oeffentliche) Helferfunktionen bauen weiterhin KEIN
eigenes daw_error/v1-Objekt -- sie reichen rohen Text oder eine
einfache Tabelle durch, wie bisher beim String-Praefix-Modell
fragjan clean + make test als Gate nach jeder Datei

Akzeptanzkriterien

Keine return nil, "<string>"-Fehlerrueckgaben oeffentlicher
Funktionen mehr, ausschliesslich daw_error/v1-Objekte
cause-Ketten bei modulübergreifender Fehlerweiterreichung
korrekt eingebettet
fragjan clean und make test bestehen nach jeder Datei
Blockiert durch Issue "Lua-Binding fuer daw_error/v1 bauen"

Bezug

DAW/daw-contracts (daw_error/v1)

## Ziel Alle `return nil, "<string>"`-Fehlerrueckgaben in `daw-lua-common` durch `daw_error/v1`-Objekte ersetzen. ## Begruendung Bewusste Entscheidung, die private 2.0.0 vor der Veroeffentlichung noch einmal zu brechen, um den Fehlervertrag jetzt sauber zu ziehen, statt spaeter 40 Module erneut umzubauen. Umfangs-Check ergab: 171 Stellen mit `return nil, ...`, verteilt ueber 37 Lua-Dateien (base64, config_parser, crypto, decimal, fs/*, json/*, sys, time, uuid, yaml/*). ## Umfang - Datei fuer Datei, `base64.lua` zuerst als Referenz/Muster fuer den Rest - Oeffentliche Funktionen erzeugen bei eigenem Fehler ein neues `daw_error/v1`-Objekt; beim Weiterreichen eines Fehlers einer anderen oeffentlichen Funktion wird das empfangene Objekt als `cause` eingebettet - Interne (nicht-oeffentliche) Helferfunktionen bauen weiterhin KEIN eigenes `daw_error/v1`-Objekt -- sie reichen rohen Text oder eine einfache Tabelle durch, wie bisher beim String-Praefix-Modell - `fragjan clean` + `make test` als Gate nach jeder Datei ## Akzeptanzkriterien - [ ] Keine `return nil, "<string>"`-Fehlerrueckgaben oeffentlicher Funktionen mehr, ausschliesslich `daw_error/v1`-Objekte - [ ] `cause`-Ketten bei modulübergreifender Fehlerweiterreichung korrekt eingebettet - [ ] `fragjan clean` und `make test` bestehen nach jeder Datei - [ ] Blockiert durch Issue "Lua-Binding fuer daw_error/v1 bauen" ## Bezug DAW/daw-contracts (daw_error/v1)

michael added the

coordination/cross-repo

labels

2026-08-10 07:41:42 +02:00