Skip to content

v0.5.0: Journal Snapshot Command

Latest

Choose a tag to compare

@queelius queelius released this 16 Mar 08:00

New Features

jot stats — LLM-first journal snapshot data

Pre-computed journal snapshot data as JSON, designed for LLM consumption. Five sections, all optional:

jot stats                              # default: summary + overdue + blocked
jot stats --all                        # all five sections
jot stats --section=health             # specific section
jot stats --tags=myproject             # scoped to a tag
jot stats --type=task --status=open    # scoped by type/status

Sections:

Section Description
summary Aggregate counts by type, status, priority, tag count
overdue Active entries past their due date
blocked Entries with status=blocked, sorted by staleness
health Per-tag project health: open/done/blocked/overdue/stale counts
recent Entries modified in the last 7 days

Key design decisions:

  • Always outputs JSON (LLM-first — intelligence stays in the LLM layer)
  • Single filesystem walk regardless of how many sections are requested
  • Reuses existing store.Filter flags for scoping (--tags, --type, --status, --since, etc.)
  • --stale-days flag controls the staleness threshold for the health section (default: 30)

Other improvements

  • EntrySummary now includes blocked_by field (backward-compatible via omitempty)