What problem does it solve? Long-running agent shifts accumulate punch lists, receipts, shift logs, snag logs, and parking-lot notes in live state files. Without filing, finished work clutters the live workspace and historical evidence gets lost or mixed with open items. ## Core Features & Use Cases - Selective filing: Moves ticked punch-list items into an archive shipped.md, retires receipts of completed items, and files only handled snag-log entries and answered parking-lot questions, leaving open work live. - Dated archive layout: Organizes records under archive/<YYYY-MM-DD>/ or shift-<id>/ per the resolved policy, rewriting receipt links so archived evidence keeps working from its new location. - Retention and indexing: Previews opt-in history pruning via ns retain-history with explicit owner confirmation, and writes a private index of archived shifts for later comparison. - Use Case: After a multi-hour coding shift ends with some items ticked and some open, run Archive to file the completed receipts and logs into a dated folder while keeping open items, unanswered questions, and the contract live for the next shift. ## Quick Start Ask the agent to archive the finished shift's records into a dated archive folder, retiring ticked receipts and leaving open items live.
