previous-draft/store.py

Comment 1, line 1

# -*- coding: utf-8 -*-

"""LLM usage storage: raw events and daily aggregate cache; prefer cached history, retain one year."""

"""Date string in the running machine's local timezone."""

# ---- Collection state: incremental cursors/file offsets ----

# ---- Idempotent event writes ----

"""Insert events and return deduplicated days with newly inserted events."""

# ---- Daily aggregate cache ----

"""Recompute selected dates; historical reads use the cache without revisiting sources."""

# ---- Queries ----

"""Aggregate a date by local hour, tool and model for today's live charts."""