Skip to content

log

docs/log.jsonl event logging.

CLASS DESCRIPTION
LogEntry

A single docs/log.jsonl entry.

FUNCTION DESCRIPTION
append_log_entry

Append entry as one JSONL line to docs_dir/log.jsonl, never rewriting existing lines.

build_log_entry

Build a log.jsonl entry. Raises ValueError if action isn’t in the allowed set.

Classes

LogEntry dataclass

LogEntry(date: str, action: LogAction, message: str, details: str)

A single docs/log.jsonl entry.

Functions:

append_log_entry

append_log_entry(docs_dir: Path, entry: LogEntry) -> None

Append entry as one JSONL line to docs_dir/log.jsonl, never rewriting existing lines.

build_log_entry

build_log_entry(action: str, message: str, details: str) -> LogEntry

Build a log.jsonl entry. Raises ValueError if action isn’t in the allowed set.