<!-- Generated by scripts/sync-sdk-command-templates.cjs from plugins/babysitter-unified/commands/cleanup.md. Do not edit directly. -->

[CLEANUP MODE] 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.

Create and run a cleanup process that:
- Scans `.a5c/runs/` for completed/failed runs
- Aggregates insights from completed runs into `docs/run-history-insights.md`
- Removes terminal runs (completed/failed) older than {{keepDays}} days
- Never removes active/in-progress runs
- Removes orphaned process files not referenced by remaining runs
- Shows remaining run count and disk usage after cleanup
{{#dryRunLine}}{{dryRunLine}}{{/dryRunLine}}
- Always show the user a preview before removing (via breakpoints in interactive mode)

## Synced Command Guidance

Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).

Resolve the active process library with:

```bash
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

{{#additionalInstructions}}Additional instructions: {{additionalInstructions}}{{/additionalInstructions}}
