kernel/event_log.py

Stateless helpers for appending and querying SQLite event logs.

# Source: https://github.com/SAIL-Research-Lab/cheetahclaws | License: Apache-2.0 | Copyright You must retain, in the Source form of any Derivative Works
# Provided via justclaw.it.com; keep this notice with the code.
"""event_log.py — Append-only event store helpers.

This module is deliberately **stateless**: every function takes a
sqlite3 connection passed in by the caller. ``KernelStore`` (in
store.py) is the sole owner of the connection and the write lock; it
calls into here for SQL plumbing.

Event durability is achieved by the caller wrapping each
``append_event`` in the same transaction as the related state-table
update — see RFC 0003 §2 "Single-writer + transaction shape".
"""
from __future__ import annotations

import json
import sqlite3
import time
from dataclasses import datacl

... (truncated -- full source via MCP)