todo-archive

What problem does it solve?

Completed and cancelled tasks accumulate in a single TODO.md HISTORY section and eventually exceed practical size limits, causing loss of operational history and making long-term search and accountability difficult.

Core Features & Use Cases

• Parses the HISTORY section of a TODO.md file to identify completed and cancelled tasks using Done/Cancelled dates.
• Partitions archived tasks into monthly satellite files named YYYY-MM.md inside a todo-archives directory and appends under date headers while avoiding duplicates.
• Rebuilds TODO.md safely with backups and persistent shadow copies, updates a todo-archives/INDEX.md manifest, and provides search and stats utilities for archived tasks.
• Use cases: routine housekeeping when TODO.md grows large, forced archival of old history, searching past work by keyword or issue ID, and generating monthly archive summaries.

Quick Start

Run the archive routine to move completed tasks from your TODO.md into monthly archive files while creating backups and verifying integrity.