Logging

Logging

📜 IRzeka exposes a Whisper method for emitting log messages into Eris from your game code. All whispers appear in the Eris UI alongside matter flow.

Three severity levels are available via RzekaMessageType:

• Hint - informational
• Hunch - warning
• Horror - error

// Simple info log (defaults to Hint)
rzeka.Whisper("The Underworld loaded correctly, there is no turning back.");

// With explicit severity
rzeka.Whisper(
    "Mysterious fairy appeared, she warns that the save slots are full.", 
    RzekaMessageType.Hunch);

// Exception - automatically Horror severity
rzeka.Whisper(exception);

// Exception with a message
rzeka.Whisper("Failed to go to heaven oops.", exception);

You can optionally attach Matter instances as circumstances, linking the message to the causal graph:

rzeka.Whisper(
    "Cant set new moon phase when there is no moon.", 
    RzekaMessageType.Horror, 
    triggeringMatter); // 🌱 here!, it takes params [...]

Rzeka itself uses Whisper internally for thread violations and stream errors, so they appear in Eris alongside your own messages.