| name | cleanup |
| description | Clean up .a5c/runs and .a5c/processes directories. Aggregates insights from completed/failed runs into docs/run-history-insights.md, then removes old run data and orphaned process files. |
cleanup
Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
Resolve the active process library with:
babysitter process-library:active --json
Read binding.dir from that JSON and create/run the cleanup process from cradle/cleanup-runs.js#process relative to that active library root. Do not use plugin-cache-relative cradle paths.
Implementation notes (for the process):
- Parse arguments for
--dry-run flag (if present, set dryRun: true in inputs) and --keep-days N (default: 7)
CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
Phase 1 — Scan:
- Scan .a5c/runs/ for all runs
- Classify each as terminal (completed/failed) or active (in-progress/created)
- Identify terminal runs older than the keep-days threshold as removal candidates
- Never mark active/in-progress runs for removal
- Count and report: total runs, terminal, active, removal candidates, disk usage
Phase 2 — Aggregate insights (BEFORE any deletion):
- For EVERY removal candidate, read its run.json and journal/ events
- Extract: processId, prompt, status, event count, created date, task summaries
- Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
- Append a new dated section to docs/run-history-insights.md with:
- Summary statistics (runs removed, disk freed, runs retained)
- Run categories with counts and descriptions
- Key patterns observed (multi-batch convergence, retry behavior, etc.)
- What worked well / what didn't from the run data
- This file MUST be written and verified before proceeding to Phase 3
Phase 3 — Confirm removal:
- In interactive mode, show the user what will be removed via a breakpoint
- In non-interactive mode (yolo), proceed with defaults
- In dry-run mode, stop here and show what would be removed
Phase 4 — Remove:
- Delete the terminal runs older than keep-days threshold
- Identify and remove orphaned process files not referenced by remaining runs
- Show remaining run count and disk usage after cleanup
