Skip to content

Latest commit

 

History

History
64 lines (45 loc) · 2.45 KB

task_plan.md

File metadata and controls

64 lines (45 loc) · 2.45 KB

Task Plan: Queue clear and bounded retention

Goal

Add an explicit allowatron queue prune --all operation and change default queue retention to at most 100 records or 7 days, whichever limit is reached first, with tests and documentation.

Current Phase

Complete

Phases

Phase 1: Confirm current behavior and interfaces

  • Inspect queue pruning, CLI parsing, tests, and documentation.
  • Confirm the default-limit interpretation and destructive-command UX.
  • Status: complete

Phase 2: Implement with TDD

  • Add one failing queue-level test for explicit clear-all behavior.
  • Implement the smallest queue API needed to delete every status safely.
  • Add one failing CLI test for queue prune --all, then wire the flag.
  • Reject --all combined with retention/count overrides.
  • Add failing tests for 7-day and 100-record defaults during explicit and automatic record-time pruning, then change the constants.
  • Status: complete

Phase 3: Document and verify

  • Update README, command reference, help text, and bundled skill guidance.
  • Run focused queue/CLI tests, then the full warning-sensitive suite.
  • Run compilation and git diff --check.
  • Status: complete

Key Questions

  1. Does “100, or 7 days max” mean enforce both limits simultaneously? Assumed yes.
  2. Should --all delete pending, resolved, and dismissed entries? Assumed yes.

Decisions Made

Decision Rationale
Keep prune retention semantics and add explicit --all Makes destructive clearing intentional without changing existing bare-command meaning
Retain at most 100 records and at most 7 days Matches the user's stated review burden; the first exceeded bound triggers deletion
Make --all mutually exclusive with threshold overrides Prevents ambiguous commands whose limits would be ignored
Treat the explicit flag as confirmation Keeps the command scriptable while requiring deliberate destructive syntax
Follow red/green/refactor one behavior at a time Required by repository contribution guidance

Errors Encountered

Error Attempt Resolution
None 1 N/A

Notes

  • Preserve the uncommitted plan-archive changes already in the working tree.
  • Implementation changes were limited to queue behavior, tests, and docs; the prior archive changes remain intact.
  • No commit or push was performed in this implementation turn.