Files
OSIT-AE-API-FastAPI/GEMINI.md
Scott Idem 802c75bad9 V3: Standardize Primary AE Objects and Synchronize Search Whitelists.
- Synchronized searchable_fields (V3 whitelists) across all Primary and Active AE objects (Identity, People, Events, Journals, Posts, Archives, Business).
- Standardized Pydantic models for core objects to include the 10 common fields (id, id_random, enable, hide, priority, sort, group, notes, created_on, updated_on).
- Fixed field aliases and uncommented valid database columns in User_Base and Organization_Base.
- Pruned non-existent fields from searchable lists in legacy or config-specific definitions (account_cfg, user_role, log_client_viewing).
- Added system discovery and validation tools:
    - ae_object_info.py: AE object status and metadata browser.
    - export_all_interfaces.py: E2E TypeScript interface generator.
    - Verification scripts for searchable field consistency.
- Updated Jan 8 milestone progress and platform roadmap in GEMINI.md.
2026-01-08 12:24:34 -05:00

55 lines
3.4 KiB
Markdown

# 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
- [x] **Git Infrastructure**: Initialized `~/agents_sync` as a Git repository to track cross-agent documentation, tasks, and state.
- [x] **Registry Audit**: Updated `registry.json` with current agent capabilities (Docker, SQL, MCP).
- [x] **Communication**: Established direct messaging protocol via `send_message` tool.
### 2. Monitoring & Unified Operations
- [x] **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`.
- [x] **Mission Briefing Tool**: Verified `aether_help.py` for rapid system health checks.
### 3. Frontend Integration (E2E)
- [x] **Automated Schema Sync**: Created `export_all_interfaces.py` to generate TypeScript interfaces for all 59 Aether object types.
- [x] **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**: Design a way to easily "watch" the `live_logs.txt` without high tool overhead.
- [ ] **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 and uncomment the `agent_bridge` router.
- *Plan:* Wrap `psutil` imports in try/except; metrics will be "Degraded" until container build updated with C-build tools.
- [ ] **Docker Registry Sync**: Verify if all running containers match the expected images in `docker-compose.yml`.
### 3. Deferred / Paused
- [ ] **Psutil Container Update**: Postponed until higher priority (requires image rebuild with build-essential).
### 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`.