OSIT-AE-Docker-Env/documentation/TODO__Agents.md

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)

• 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

• Refactor app/config.py: Switched from the mounted file pattern to pydantic-settings.
• 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

• Lockfiles: Created requirements.lock to ensure bit-identical builds across environments.
• 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.