# Aether Platform - Strategic TODO (Agents & Operations)

This document tracks high-impact architectural improvements to the Aether Docker Environment and its connected services. These tasks focus on stability, security, and developer experience (DX).

---

## 🛠️ Infrastructure & Orchestration

### **1. Container Healthchecks (Self-Healing)**
- [x] **FastAPI Healthcheck:** Added a `/health` endpoint to `aether_api_fastapi` that verifies DB and Redis connectivity.
- [ ] **Docker Integration:** Update `docker-compose.yml` to use `healthcheck` for `ae_api` and `ae_app`. (Manual testing complete, next step is automation).
- [ ] **Dependency Ordering:** Use `condition: service_healthy` in `depends_on` blocks to ensure services start in the correct order.

### **2. Environment Abstraction & Safety**
- [ ] **IP Abstraction:** Move the hardcoded workstation IP (`192.168.32.7`) to an `.env` variable (e.g., `AE_HOST_IP`) and reference it in `extra_hosts`.
- [ ] **Env Validation:** Create a `scripts/validate_env.sh` to compare `.env` against `env.default` and catch missing keys or malformed values.
- [ ] **Secret Scanning:** Implement a pre-commit hook or script to ensure no sensitive credentials (from `.env` or backups) are accidentally staged.

### **3. Operational Tooling (The "Easy Button")**
- [ ] **Master Makefile:** Create a `Makefile` in the orchestration root for common commands:
    - `make up` / `make down`
    - `make build-ui` / `make build-api`
    - `make db-backup` / `make db-restore`
    - `make logs`
- [ ] **Unified Logs:** Enhance `ae_ops` to provide a consolidated view of critical system errors across all containers.

---

## 🐍 Backend (FastAPI) Modernization

### **4. Configuration via Pydantic Settings**
- [x] **Refactor `app/config.py`:** Switched from the mounted file pattern to `pydantic-settings`.
- [x] **Environment Injection:** API now inherits all settings directly from Docker environment variables.
- [ ] **V2 Migration:** (Long Term) Prepare for the upgrade to Pydantic V2 and SQLAlchemy 2.0.

### **5. Dependency Management**
- [x] **Lockfiles:** Created `requirements.lock` to ensure bit-identical builds across environments.
- [x] **Pruning:** Conducted a final audit of the FastAPI base image and removed 6 redundant Python dependencies.

---

## 🌐 Frontend (SvelteKit) Enhancements

### **6. Build & Runtime Optimization**
- [ ] **Image Size:** Optimize the multi-stage Dockerfile to further reduce the final runtime image size.
- [ ] **Cache Warming:** Implement a mechanism to warm the SvelteKit / Dexie cache on first load for better UX.

---

## 📝 Governance
- This list is managed by **Scott Idem** and **Aether Agents**.
- Tasks should be moved to the [Kanban Board] (via `ae_task_add`) when active work begins.