Struct TaskLog 

pub struct TaskLog { /* private fields */ }

Handle to a session’s task log file.

All writes append a single JSON line; reads return events in insertion order. The log is intentionally tiny and synchronous at the line level — one event per line, newline-terminated.

Implementations

impl TaskLog

pub fn for_session(session_id: &str) -> Result<Self>

Open (or lazily create) the log for the given session id.

pub fn at(path: impl Into<PathBuf>) -> Self

Open a log at an explicit path (used by tests).

pub fn path(&self) -> &Path

Path to the underlying .tasks.jsonl file.

pub async fn append(&self, event: &TaskEvent) -> Result<()>

Append a single event as a JSON line.

pub async fn read_all(&self) -> Result<Vec<TaskEvent>>

Read every event, skipping malformed lines.

pub fn read_all_blocking(&self) -> Result<Vec<TaskEvent>>

Blocking read — suitable for sync contexts like system-prompt assembly, which runs on each turn and must not depend on a tokio runtime. The log is small (goal + open tasks), so this is cheap in practice.

pub fn append_blocking(&self, event: &TaskEvent) -> Result<()>

Blocking append — used by the TUI slash-command handler which runs inside an async context but wants a single synchronous write.