Initial commit: TrueRecall v2.2 with 30b curator and timer-based curation

tr-continuous/README.md

@@ -0,0 +1,101 @@
+# Turn-Based Curator
+
+Extract gems every N turns instead of waiting for daily curation.
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `curator_turn_based.py` | Main script - checks turn count, extracts gems |
+| `curator_cron.sh` | Cron wrapper to run every minute |
+| `turn-curator.service` | Alternative systemd service (runs on-demand) |
+
+## Usage
+
+### Manual Run
+
+```bash
+# Check current status
+python3 curator_turn_based.py --status
+
+# Preview what would be curated
+python3 curator_turn_based.py --threshold 10 --dry-run
+
+# Execute curation
+python3 curator_turn_based.py --threshold 10 --execute
+```
+
+### Automatic (Cron)
+
+Add to crontab:
+```bash
+* * * * * /root/.openclaw/workspace/.projects/true-recall-v2/tr-continuous/curator_cron.sh
+```
+
+Or use systemd timer:
+```bash
+sudo cp turn-curator.service /etc/systemd/system/
+sudo systemctl enable turn-curator.timer  # If you create a timer
+```
+
+### Automatic (Integrated)
+
+Alternative: Modify `realtime_qdrant_watcher.py` to trigger curation every 10 turns.
+
+## How It Works
+
+1. **Tracks turn count** - Stores last curation turn in `/tmp/curator_turn_state.json`
+2. **Monitors delta** - Compares current turn count vs last curation
+3. **Triggers at threshold** - When 10+ new turns exist, runs curation
+4. **Extracts gems** - Sends conversation to qwen3, gets gems
+5. **Stores results** - Saves gems to `gems_tr` collection
+
+## State File
+
+`/tmp/curator_turn_state.json`:
+```json
+{
+  "last_turn": 150,
+  "last_curation": "2026-02-24T17:00:00Z"
+}
+```
+
+## Comparison with Daily Curator
+
+| Feature | Daily Curator | Turn-Based Curator |
+|---------|--------------|-------------------|
+| Schedule | 2:45 AM daily | Every 10 turns (dynamic) |
+| Time window | 24 hours | Variable (depends on chat frequency) |
+| Trigger | Cron | Turn threshold |
+| Use case | Nightly batch | Real-time-ish extraction |
+| Overlap | Low | Possible with daily curator |
+
+## Recommendation
+
+Use **BOTH**:
+- **Turn-based**: Every 10 turns for active conversations
+- **Daily**: 2:45 AM as backup/catch-all
+
+They'll deduplicate automatically (same embeddings → skipped).
+
+## Testing
+
+```bash
+# Simulate 10 turns
+for i in {1..10}; do
+  echo "Test message $i" > /dev/null
+done
+
+# Check status
+python3 curator_turn_based.py --status
+
+# Run manually
+python3 curator_turn_based.py --threshold 10 --execute
+```
+
+## Status
+
+- ✅ Script created: `curator_turn_based.py`
+- ✅ Cron wrapper: `curator_cron.sh`
+- ⏳ Deployment: Optional (manual or cron)
+- ⏳ Testing: Pending