.DEBUG

Protokolliert Debug-Meldungen aus Blockly und RAGAI-Events im Live-Debugger (RAGAI.DEBUG).

Hintergrund

log wird typischerweise explizit aus Custom-JS/Blockly aufgerufen. Zusätzlich wird logEventautomatisch für jedes ausgelöste RAGAI.*-Event aufgerufen (über einen Wildcard-Listener RAGAI.EVENTS.on("RAGAI.*", ...), der beim ersten Zugriff auf window.RAGAI registriert wird), sofern das Event-Prefix nicht in RAGAI_DEBUG_FORWARD_EXCLUDED_PREFIXES steht (aktuell RAGAI.DEBUG.*/RAGAI.EVENTS.*, um Duplikate bzw. Listener-Registrierungsrauschen zu vermeiden). Beide Wege senden letztlich per Socket ein blocklyDebugLog/logRagaiEvent-Ereignis an den Server, das im Live-Debugger der Admin-Oberfläche sichtbar wird.

Methoden

.log(title, reason?)

Schreibt eine Debug-Meldung in den Live-Debugger.

Parameter	Typ	Beschreibung
title	string | z.input<typeof debugLogSchema>	Titel/Kurzbeschreibung der Meldung, oder ein Objekt gemäß debugLogSchema.
reason	string	Zusätzlicher Beschreibungstext.

Objekt-Form (validiert über debugLogSchema):

Feld	Typ	Pflicht	Beschreibung
title	string	✔	Titel/Kurzbeschreibung der Debug-Meldung.
reason	string	– (Standard: "")	Zusätzlicher Beschreibungstext.

Rückgabewert: void

.logEvent(hook, params)

Protokolliert ein RAGAI-Event im Live-Debugger.

Parameter	Typ	Beschreibung
hook	string	Name des ausgelösten RAGAI-Events.
params	unknown	Die Event-Parameter.

Rückgabewert: void