# memory-compactor

Temporal conversational memory compactor for your custom mem0-python-server.

## What it does
- pulls conversational memories for one `user_id`
- clusters by time windows
- detects likely debug-session arcs
- creates a compact summary memory for resolved arcs
- preserves extracted facts (names/phones/emails) in summary + metadata
- deletes older intermediate entries (safe budget + dry-run first)

## Safety defaults
- **dry-run by default** (no writes/deletes)
- keeps recent memories (`--min-age-days`)
- keeps the latest entry in each compacted cluster
- delete cap per run (`--max-deletes`)

## Run
```bash
cd /home/lucky/.openclaw/workspace/memory-compactor
python3 compactor.py --user-id main
```

Apply changes:
```bash
python3 compactor.py --user-id main --apply
```

## Useful options
- `--base-url http://192.168.0.200:8420`
- `--gap-minutes 45`
- `--min-age-days 2`
- `--max-deletes 50`

## Next improvements
- semantic clustering (embeddings) beyond time windows
- better resolution detection (state machine)
- reversible snapshots before apply
- cron wrapper + run history logging