# SIGINT Deployment Summary

**Date:** Mar 14, 2026  
**Status:** ✅ LIVE  
**Subdomain:** sigint.residentliberal.com  
**Auth:** Basic HTTP (see below for credentials)

---

## What's Running

### Monitor Process
- **Script:** `/root/.openclaw/workspace/multi_source_monitor.py`
- **Status:** Running in background (`nohup`)
- **PID:** Check with `ps aux | grep multi_source`
- **Data output:** `/root/.openclaw/workspace/memory/signal_results/`
- **Log:** `/tmp/multi_source_monitor.log`

### Dashboard
- **URL:** https://sigint.residentliberal.com/
- **Files:** `/root/.openclaw/workspace/public/sigint/`
- **Authentication:** Required (basic auth)
- **Nginx config:** `/etc/nginx/sites-enabled/sigint.residentliberal.com`

### Data Collection
- **GDELT** — Real-time news (1 query/5 sec)
- **NewsData** — News aggregation (600 requests/day)
- **NewsAPI** — News filtering (500 requests/day)
- **Reddit** — Community signals (unlimited, read-only)

**Query rotation:** 12 signal queries cycling through all 4 sources  
**Result accumulation:** 91+ files (as of deployment)

---

## DNS Setup Needed

Add DNS record for `sigint.residentliberal.com`:

```
Type:  A or CNAME
Name:  sigint
Value: residentliberal.com (or same IP as claw.residentliberal.com)
TTL:   3600
```

Once DNS propagates:
- Test: `dig sigint.residentliberal.com`
- Browser: https://sigint.residentliberal.com/

---

## Authentication

**Login method:** HTTP Basic Auth  
**Credentials:** Same as other protected routes (`/etc/nginx/.htpasswd`)  
**Username:** (ask for current setup)  
**Password:** (ask for current setup)

To change credentials:
```bash
sudo htpasswd /etc/nginx/.htpasswd username
```

---

## Daily Maintenance

Run health check:
```bash
python3 /root/.openclaw/workspace/sigint_healthcheck.py
```

Expected output:
```
✓ Monitor Status     : Monitor running
✓ Data Freshness    : Fresh data (X min old, Y files)
✓ Disk Usage        : Disk OK (Z MB)
✓ API Health        : GDELT:ok, NewsData:ok, NewsAPI:ok, Reddit:ok
```

See `SIGINT_MAINTENANCE.md` for troubleshooting.

---

## Sharing the URL

Safe to share: `https://sigint.residentliberal.com/`

**Isolation benefits:**
- Separate subdomain (not attached to claw.residentliberal.com)
- Requires authentication
- Only serves the dashboard + documentation
- No access to main OpenClaw interface

---

## Quick Commands

| Task | Command |
|------|---------|
| Check monitor | `ps aux \| grep multi_source` |
| View logs | `tail -f /tmp/multi_source_monitor.log` |
| Restart monitor | `pkill -f multi_source; cd /root/.openclaw/workspace && nohup python3 multi_source_monitor.py > /tmp/multi_source_monitor.log 2>&1 &` |
| View data | `ls -lh /root/.openclaw/workspace/memory/signal_results/` |
| Health check | `python3 /root/.openclaw/workspace/sigint_healthcheck.py` |
| Update dashboard | `nano /root/.openclaw/workspace/public/sigint/index.html` |

---

## Files & Locations

```
/root/.openclaw/workspace/
├── public/sigint/
│   ├── index.html                 (Dashboard)
│   ├── multi_source_monitor.py    (Symlink to main script)
│   ├── README.md
│   └── REDDIT_API_SETUP.md
├── multi_source_monitor.py        (Main monitoring script)
├── memory/
│   └── signal_results/            (69+ JSON result files)
├── SIGINT_MAINTENANCE.md          (Full maintenance guide)
├── SIGINT_DEPLOYMENT.md           (This file)
└── sigint_healthcheck.py          (Daily health check)

/etc/nginx/sites-enabled/
└── sigint.residentliberal.com     (Nginx config)

/tmp/
└── multi_source_monitor.log       (Runtime logs)
```

---

## Sharing & Security

**What to share:**
- ✅ Dashboard URL: `https://sigint.residentliberal.com/`
- ✅ Username/password for auth
- ✅ Basic explanation of what it does

**What NOT to share:**
- ❌ Server IP / SSH details
- ❌ API keys (embedded in script)
- ❌ File paths or server structure
- ❌ Other claw.residentliberal.com URLs

---

## Next Steps (Optional)

1. **Add DNS record** — Currently won't resolve yet
2. **Test access** — Once DNS propagates
3. **Share with team** — If needed
4. **Monitor for anomalies** — Check daily for signal clusters

---

## Support

Maintenance guide: `SIGINT_MAINTENANCE.md`  
Health check: `python3 sigint_healthcheck.py`  
Logs: `tail -f /tmp/multi_source_monitor.log`

---

**Deployed by:** Nix  
**Last updated:** Mar 14, 2026 20:18 UTC  
**Status:** Ready for use
