Initial commit

commands/steering-clean.md

@@ -0,0 +1,196 @@
+---
+description: Clean up old archives, logs, and temporary files to free disk space
+---
+
+# Steering Context Generator - Clean
+
+Remove old archives and temporary files to free up disk space.
+
+## Quick Start
+
+```bash
+/steering-clean
+```
+
+This will:
+- Archive current context (backup)
+- Remove archives older than 7 days
+- Clean logs older than 30 days
+- Remove cache files
+- Delete temporary files
+
+## What Gets Cleaned
+
+| Item | Location | Retention | Impact |
+|------|----------|-----------|--------|
+| Old archives | `.claude/memory/archives/` | 7 days | Can regenerate |
+| Old logs | `.claude/logs/` | 30 days | Lost history |
+| Cache files | `.claude/steering/v2.0/cache/` | All | Rebuilt on next use |
+| Temp files | `.claude/memory/**/*.tmp` | All | Safe to delete |
+
+## Implementation
+
+```bash
+bash scripts/cleanup.sh
+```
+
+## Expected Output
+
+```
+🧹 Cleaning Steering Context Generator artifacts...
+
+Artifacts to clean:
+  Archives: 450 MB
+  Logs: 23 MB
+  Cache: 12 MB
+
+Continue? (y/N) y
+
+Archiving current context to .claude/memory/archives/backup_20251102_120000...
+  ✓ Archived 9 files
+
+Cleaning old archives (>7 days)...
+  ✓ Removed 3 old archives (380 MB freed)
+
+Cleaning old logs (>30 days)...
+  ✓ Removed 145 log files (18 MB freed)
+
+Cleaning cache...
+  ✓ Cleared cache (12 MB freed)
+
+Cleaning temporary files...
+  ✓ Removed 23 temp files (2 MB freed)
+
+Cleanup complete!
+Current usage:
+  Archives: 70 MB
+  Logs: 5 MB
+  Total: 250 MB
+
+Total freed: 412 MB
+```
+
+## Safety Features
+
+**Automatic Backup**:
+Before cleaning, current context is archived:
+```
+.claude/memory/archives/backup_YYYYMMDD_HHMMSS/
+├── ARCHITECTURE.md
+├── AI_CONTEXT.md
+├── CODEBASE_GUIDE.md
+└── ...
+```
+
+**Confirmation Prompt**:
+Interactive mode asks for confirmation before deleting.
+
+**Dry Run**:
+See what would be cleaned without actually deleting:
+```bash
+bash scripts/cleanup.sh --dry-run
+```
+
+## Cleanup Options
+
+### Aggressive Cleanup
+
+Remove all archives (not recommended):
+```bash
+# Manual aggressive cleanup
+rm -rf .claude/memory/archives/*
+rm -rf .claude/logs/*
+```
+
+### Selective Cleanup
+
+Clean specific areas only:
+
+**Archives only**:
+```bash
+find .claude/memory/archives -type d -mtime +7 -exec rm -rf {} +
+```
+
+**Logs only**:
+```bash
+find .claude/logs -type f -mtime +30 -delete
+```
+
+**Cache only**:
+```bash
+rm -rf .claude/steering/v2.0/cache/*
+```
+
+### Custom Retention
+
+Edit `scripts/cleanup.sh` to change retention periods:
+```bash
+# Archives: Change from 7 to 30 days
+find .claude/memory/archives -type d -mtime +30 -exec rm -rf {} +
+
+# Logs: Change from 30 to 90 days
+find .claude/logs -type f -mtime +90 -delete
+```
+
+## When to Clean
+
+**Regular Maintenance**:
+- Weekly: For active projects
+- Monthly: For stable projects
+- Before: Major releases
+- When: Low disk space warnings
+
+**Signs You Need Cleaning**:
+- ⚠ Archive size > 500 MB
+- ⚠ Total .claude/ size > 2 GB
+- ⚠ Disk space warnings
+- ⚠ Slow operations
+
+## Recovering Cleaned Data
+
+**Recent Backup**:
+```bash
+# List available backups
+ls -lh .claude/memory/archives/backup_*/
+
+# Restore latest backup
+LATEST=$(ls -t .claude/memory/archives/backup_* | head -1)
+cp -r $LATEST/*.md .claude/steering/
+```
+
+**From Git**:
+If context files are committed:
+```bash
+git log -- .claude/steering/
+git checkout HEAD~1 -- .claude/steering/
+```
+
+**Regenerate**:
+If no backups available:
+```bash
+/steering-generate
+```
+
+## Troubleshooting
+
+### "Permission denied" errors
+```bash
+chmod +x scripts/cleanup.sh
+```
+
+### Cleanup doesn't free space
+Check hidden or locked files:
+```bash
+lsof | grep .claude
+```
+
+### Accidentally deleted current context
+```bash
+# Restore from latest backup
+LATEST=$(ls -t .claude/memory/archives/backup_* | head -1)
+cp -r $LATEST/*.md .claude/steering/
+```
+
+---
+
+**Free up space:** Run `/steering-clean` regularly!