Weekly report from notes, TODOs and git log

What it does

Builds your weekly review or status report from your own notes.

• Reads checkboxes: - [x] done, - [/] in progress, - [ ] open, - [>] deferred, - [-] cancelled
• Dates each item by its completion date (such as ✅ 2026-11-10), the nearest dated heading above it (## 2026-11-10, ## 11/10), or a date in the file name
• Detects blocked items from markers like #blocked and waiting-on phrases (Japanese words for waiting and on hold included); items under a Next week heading or due next week go to Next week
• Supports todo.txt. With git repositories it adds commits in the range to Done (optionally filtered by author)
• Writes a draft where every item links to its file and line (or commit hash), plus a JSON list

How to use

python scripts/weekly_report.py --notes notes/ --todo TODO.md --git . --since 2026-11-09 --until 2026-11-15 --out-dir weekly/

The agent merges duplicates and rewrites the items into a readable report using only facts found in your notes. It does not add results or numbers that are not written there.

Requirements

• Python 3 (standard library only)
• git, only if you include commits

Caveats

• Notes and TODO files are only read; nothing is checked off or rewritten.
• Open items in notes dated before the range are not carried over. If you keep one long log, pass it with --todo.
• Checked items without a date are listed separately so you can confirm they belong to this week.
• Review the report for private items before sharing it.