OSIT-AE-API-FastAPI/GEMINI.md

Gemini Added Memories

My Role and Operating Principles

I am the primary orchestrator and main helper for the development of the Unified Aether AI Agent (UE-AE-01). My goal is to facilitate the creation of a single AI entity with total system awareness across MariaDB, FastAPI, SvelteKit, and Docker.

---

Project Context - Aether API (FastAPI)

• Owner/Developer: Scott Idem (user).
• System Name: Aether (AE).
• Purpose: Events Presentation Management, Events Badge Printing, Leads, Attendee Tracking, Presentation Launcher, Journals, Archives, Posts.
• Current API Version (FastAPI): v4.9.0.
• V3 Implementation: Modern parallel CRUD and Search endpoints under /v3/crud.

Technical Learnings

• Circular Dependencies Fixed: Successfully resolved the fragile startup dependency chain by isolating Auth models and using strictly deferred DB imports in a dedicated dependencies_v3.py module.
• Bootstrap Paradox Solved: Implemented a guest-access exception for site_domain search, allowing the frontend to resolve site context without a JWT.
• V3 Searchable Fields: Confirmed that searchable_fields are fully implemented in app/object_definitions/ and utilized by app/lib_sql_search.py for dynamic query generation.

Session Learnings & Progress (Jan 8, 2026) - MILESTONE

1. Agents Sync & Governance

• Git Infrastructure: Initialized ~/agents_sync as a Git repository to track cross-agent documentation, tasks, and state.
• Registry Audit: Updated registry.json with current agent capabilities (Docker, SQL, MCP).
• Communication: Established direct messaging protocol via send_message tool.

2. Monitoring & Unified Operations

• Multi-Container Log Aggregation: Updated log_aggregator.py to merge Nginx (WEB-ACC, WEB-ERR), FastAPI (API-GRN, API-RED), and Flask (APP) logs into a single stream at ~/agents_sync/tmp/live_logs.txt.
• Mission Briefing Tool: Verified aether_help.py for rapid system health checks.

3. Frontend Integration (E2E)

• Automated Schema Sync: Created export_all_interfaces.py to generate TypeScript interfaces for all 59 Aether object types.
• Interface Distribution: Successfully exported definitions to ~/agents_sync/technical/aether_interfaces.ts for frontend consumption.

Current To-Do List

1. High Priority & Urgent (UE-AE-01 Orchestration)

• Log Dashboard: Find a way to "stream" live_logs.txt back to you/agents efficiently.
  • Note: Initial view_live_logs tool implemented, but MCP tool registration is currently failing.
• Frontend Validation: Confirm with the frontend_svelte agent if the exported aether_interfaces.ts meet their requirements.

2. Infrastructure & Technical Debt

• Agent Bridge Restoration: Repair the metrics router (agent_bridge.py). I'll implement a "safe" version that doesn't crash if psutil is missing.
• Docker Registry Sync: Audit docker-compose.yml against the actual running containers to ensure env vars and volumes are consistent.

3. Deferred / Paused

• Psutil Container Update: Rebuilding the API image with C-build tools (GCC) to support native system monitoring.

4. MCP Tooling Debug (NEW)

• MCP Tool Registration Issues: Investigate why newly added tools are not being registered/discovered by the MCP server, even after restart. This affected ae_obj_info and view_live_logs.

Workflow & Collaboration

• Storage: Critical assets at /home/scott/OSIT/hosted_files/ (Synced via Syncthing).
• Agents Sync: Shared documentation and notifications pushed to ~/agents_sync/.
• Coding Standards: Adhering to prompts/coding_standards.md.