"""Single-line stdout helper with an [HH:MM:SS] prefix.

Used in place of `print(..., flush=True)` for our `[townlet]`-tagged logs so
the Spaces log viewer (which does not prepend timestamps) shows wall-clock
between events. Crucial for diagnosing where time is going during long
drains — most of the visible "pauses" between log lines are LLM inference,
and the timestamps make that obvious at a glance.
"""

from __future__ import annotations

import sys
import time


def tlog(msg: str) -> None:
    sys.stdout.write(f"[{time.strftime('%H:%M:%S')}] {msg}\n")
    sys.stdout.flush()