Fresh start - excluded large ROM JSON files

memory/projects/mission-control-python.md

@@ -0,0 +1,189 @@
+---
+## Mission Control Dashboard (Python) — Consolidating
+
+**Status:** 🔄 Combined with Next.js version — See TLC project  
+**Location:** `C:\web\htdocs\mission-control-py`
+**URL:** http://localhost:5050
+**URL (network):** http://192.168.0.34:5050  
+**Tech:** Python/Flask + MySQL + Home Assistant API
+
+---
+
+### Quick Reference
+
+| Command | Where |
+|---------|-------|
+| Run server | `cd C:\web\htdocs\mission-control-py && python app.py` |
+| Restart | Server auto-reloads on file changes |
+| Port | 5050 (Frigate-safe) |
+
+---
+
+### Pages
+
+| Route | File | Purpose |
+|-------|------|---------|
+| `/` | `dashboard.html` | Home: Gateway status, Cron jobs, Weather, Projects, Tasks |
+| `/admin` | `admin.html` | CRUD for Projects/Tasks in MySQL |
+| `/news` | `news.html` | Last 10 news briefs (JSON archive) |
+| `/alerts` | `alerts.html` | System alerts from Job Verifier cron |
+| `/calendar` | `calendar.html` | HA calendar + 24 F1 races |
+| `/memory` | `memory.html` | Memory file stats, cleanup candidates |
+
+---
+
+### File Structure
+
+```
+mission-control-py/
+├── app.py              # Main Flask app, routes
+├── api/
+│   ├── gateway.py      # get_gateway_status(), get_cron_jobs()
+│   ├── ha_calendar.py  # HA calendar API wrapper
+│   └── memory_files.py # Memory file scanner
+├── templates/
+│   ├── base.html       # Master template
+│   ├── dashboard.html  # Home page
+│   ├── admin.html      # Admin CRUD
+│   ├── news.html       # News briefs archive
+│   ├── alerts.html     # System alerts
+│   ├── calendar.html   # HA calendar
+│   └── memory.html     # Memory file stats
+├── static/
+│   └── style.css       # All styles
+├── outputs/
+│   ├── news/           # YYYY-MM-DD.json, latest.json
+│   └── alerts/         # latest.json
+└── models/
+    └── models.py       # Project, Task (MySQL)
+```
+
+---
+
+### Features
+
+#### Caching (5-minute TTL)
+- Gateway status cached in `_cache` dict
+- Cron jobs cached
+- Weather cached
+- Location: `app.py` → `_CACHE_TTL = timedelta(minutes=5)`
+
+#### Weather
+- Source: `weather.home` HA entity
+- API: `GET /api/states/weather.home`
+- Location: `get_weather()` in `app.py`
+- Fallback: Shows "--" if HA unavailable
+
+#### Calendar
+- Source: HA `calendar.appointments` entity
+- Fetch API: `GET /api/calendars/calendar.appointments?start=...&end=...`
+- Add API: `POST /api/services/calendar/create_event`
+- Location: `api/ha_calendar.py`
+- **Known Issue:** Date range filter may not work correctly (March 3 event not showing)
+
+#### News Briefs
+- Source: Cron job output JSON
+- Files: `outputs/news/latest.json` + `outputs/news/YYYY-MM-DD.json`
+- Format: `{title, date, generated_at, content, sources, summary}`
+- Crontab: Daily 8 AM → `openclaw cron run 3cf50074-...`
+
+#### Alerts
+- Source: Job Verifier cron output JSON
+- File: `outputs/alerts/latest.json`
+- Format: `{date, generated_at, alerts: [{level, message, time, ...}]}`
+- Crontab: Daily 9 AM → `openclaw cron run 8e2b06ee-...`
+
+#### Memory Files
+- Source: `C:\Users\admin\.openclaw\workspace\memory\*.md`
+- Features: Line count, TODO count, cleanup scoring
+- Location: `api/memory_files.py`
+
+---
+
+### Known Issues & Fixes
+
+| Issue | Status | Fix |
+|-------|--------|-----|
+| Calendar events beyond 10 days not showing | **KNOWN** | Date range filter bug — March 3 event (11 days out) not displaying |
+| Double "°F" in weather | FIXED | Strip HA unit before adding; `get_weather()` in `app.py` |
+| Calendar agent creates cron jobs instead of calendar events | **KNOWN** | Agent using `cron.add` instead of `ha_calendar.add()` — needs fix |
+
+---
+
+### HA API Reference
+
+**Base URL:** `http://192.168.0.39:8123`
+**Token:** See `TOOLS.md` or `api/ha_calendar.py`
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/states/weather.home` | GET | Current weather state |
+| `/api/calendars` | GET | List calendars |
+| `/api/calendars/calendar.appointments` | GET | Get appointments (params: `start`, `end`) |
+| `/api/services/calendar/create_event` | POST | Add event (body: `entity_id`, `summary`, `start_date_time`, `end_date_time`) |
+
+**Auth:** Header `Authorization: Bearer <token>`
+
+---
+
+### Cron Jobs Integrated
+
+| Job Name | ID | Schedule | Output |
+|----------|-----|----------|--------|
+| Daily News Brief | `3cf50074-8736-423e-ac41-6e6fb807bfee` | 0 8 * * * (8 AM) | JSON + Discord + /news |
+| Job Verifier Daily | `8e2b06ee-f2ea-4b33-ae39-23cf04b1a657` | 0 9 * * * (9 AM) | JSON + /alerts |
+
+---
+
+### Configuration
+
+**MySQL Connection:**
+- Database: `alexai`
+- Tables: `projects`, `tasks`
+- Config: `config.py` → `SQLALCHEMY_DATABASE_URI`
+
+**HA Token:**
+- In `api/ha_calendar.py` and `app.py`
+- Falls back to env var `HA_TOKEN`
+
+---
+
+### Debugging Tips
+
+1. **Check HA directly:**
+   ```bash
+   python -c "
+   import requests
+   r = requests.get('http://192.168.0.39:8123/api/calendars/calendar.appointments',
+                    params={'start': '2026-03-03T00:00:00', 'end': '2026-03-04T00:00:00'},
+                    headers={'Authorization': 'Bearer <token>'})
+   print(r.json())
+   "
+   ```
+
+2. **Test API directly:**
+   ```python
+   from api.ha_calendar import get_calendar_events, add_calendar_event
+   events = get_calendar_events('calendar.appointments', days=14)
+   print([e['summary'] for e in events])
+   ```
+
+3. **Clear cache:** Restart server (auto-reloads)
+
+4. **Check logs:** Terminal output shows "Starting Mission Control..."
+
+---
+
+### Changes Log
+
+| Date | Change |
+|------|--------|
+| 2026-02-19 | Initial build, 5 pages |
+| 2026-02-20 | Added weather, calendar, memory, F1 races (24 races added) |
+| 2026-02-20 | Fixed double °F in weather |
+| 2026-02-20 | Calendar agent created (has bug - creates cron instead of events) |
+
+---
+
+**Last Updated:** 2026-02-20
+**Maintainer:** Corey's Agent