viva_aion/log

VIVA Aion Logging - Structured logging for deterministic world generation

Usage

import viva_aion/log

// Initialize once at startup
log.configure()

// Log operations
log.generator("New world seed: 0x1A2B3C")
log.pathfinding("Path found: length=42 cost=15.5")
log.bounce("Entropy transfer: 1.45 bits -> new seed")

Log Levels

Debug: Internal details (stack operations, RNG steps)
Info: Normal operations (generation, path found, bounce)
Warning: Edge cases (path not found, low entropy)
Error: Failures (grid corruption)

Values

bounce

</>

pub fn bounce(details: String) -> Nil

Log Big Bounce / Cosmology events

configure

</>

pub fn configure() -> Nil

Initialize logging with pretty Gleam output Call once at application startup

debug

</>

pub fn debug(tag: String, msg: String) -> Nil

Debug level log

disable_debug

</>

pub fn disable_debug() -> Nil

Disable debug logging (Info and above only)

dream

</>

pub fn dream(details: String) -> Nil

Log Memory/Dream consolidation (DRE scoring)

enable_debug

</>

pub fn enable_debug() -> Nil

Enable debug logging

error

</>

pub fn error(tag: String, msg: String) -> Nil

Error level log

fmt_float

</>

pub fn fmt_float(f: Float) -> String

Format float with 4 decimal places

fmt_int

</>

pub fn fmt_int(i: Int) -> String

Format int

fmt_pos

</>

pub fn fmt_pos(x: Int, y: Int) -> String

Format position (x, y)

fmt_seed

</>

pub fn fmt_seed(s: Int) -> String

Format seed

generator

</>

pub fn generator(details: String) -> Nil

Log world generation events

info

</>

pub fn info(tag: String, msg: String) -> Nil

Info level log

pathfinding

</>

pub fn pathfinding(details: String) -> Nil

Log pathfinding operations (BFS, A*, Retrocausal)

rng

</>

pub fn rng(details: String) -> Nil

Log RNG/Seed operations

set_level

</>

pub fn set_level(level: logging.LogLevel) -> Nil

Set minimum log level

warn

</>

pub fn warn(tag: String, msg: String) -> Nil

Warning level log