decision-journal-cli

Keeps a decision log from turning into archaeology by making owner, assumption, and revisit date stay visible.

What it does

The first useful run is a compact view of which decisions are still open, which ones are stale, and who owns them. That is enough to make the next review materially sharper.

Try it locally

python3 decision_journal.py sample_decisions.jsonl --today 2026-04-11

Example output

Total decisions: 3
Open decisions: 2
Closed decisions: 1
Stale decisions: 1

By owner:
- Mickey: 1
- Winston: 2

Stale decisions:
- Consolidate weekly customer notes into a single repo (Winston)

Where it helps

Use this before roadmap reviews, quarterly planning, or any working session where old calls keep resurfacing because the original assumptions and revisit dates were never kept visible enough.