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.
• add_task tool bug fix: The add_task tool bug (duplicate IDs) was identified, reported, and fixed by the Manager/Coordinator agent. The fix introduced microsecond precision for IDs.

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.
• Log Dashboard: Initial view_live_logs tool implemented; MCP tool registration confirmed functional and syntax errors in mcp_server.py resolved.

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.
• Frontend Validation Task: Message sent to frontend agent requesting validation of aether_interfaces.ts. Task is now In Progress.

4. Infrastructure & Technical Debt

• Agent Bridge Restoration: app/routers/agent_bridge.py inspected; psutil handling confirmed robust. Docker logs for FastAPI containers (ae_api_dev_green, ae_api_dev_red) showed no crashes related to agent_bridge.py or psutil. Task marked as Done.
• Docker Registry Sync Audit: Audit of ae_api_dev_green and ae_api_dev_red against docker-compose.yml completed. Environment variables, volumes, ports, images, and extra hosts were consistent. No critical configuration drift identified. Task marked as Done.

5. ae_obj_info Investigation

• ae_obj_info Investigation: pytz confirmed installed in FastAPI container. Source code for ae_obj_info not located within the workspace despite extensive searching. Further investigation required from other agents.

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, and MCP tool registration issues resolved.
• Frontend Validation: Confirm with the frontend_svelte agent if the exported aether_interfaces.ts meet their requirements. (In Progress - Message sent)

2. Infrastructure & Technical Debt

• Agent Bridge Restoration: Repair the metrics router (agent_bridge.py). Confirmed robust.
• Docker Registry Sync: Audit docker-compose.yml against the actual running containers to ensure env vars and volumes are consistent. Audit completed for FastAPI containers.

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. Issues resolved for ae_obj_info and view_live_logs.

5. ae_obj_info Dependency

• Resolve 'ae_obj_info' Dependency (pytz): Task ID 131939061. New task for backend_fastapi. pytz is installed in container, but ae_obj_info source not found. Further investigation needed from other agents.

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.