- Integrated zero-dependency Auth models and dependencies_v3.py. - Successfully resolved circular dependency boot loops. - Verified site_domain search exception via verify_v3_exceptions.py. - Refined Unified Agent Architecture with Storage Layer and API-driven access details. - Updated project roadmap and milestones in GEMINI.md.
53 lines
3.1 KiB
Markdown
53 lines
3.1 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.
|
|
- **VS Code Optimization**: Configured workspace settings to suppress markdownlint noise and enforce 4-space indentation for cleaner documentation.
|
|
|
|
## Session Learnings & Progress (Jan 7, 2026) - MILESTONE
|
|
|
|
### 1. Stability & Architecture
|
|
- [x] **Permanent Dependency Fix**: Migrated `AccountContext` and Auth logic to dedicated modules (`auth_models.py`, `dependencies_v3.py`). This permanently resolved the "Worker failed to boot" issues.
|
|
- [x] **Modularized `lib_general.py`**: Successfully extracted core functionalities into specialized modules:
|
|
- `lib_email.py` (SMTP/Email)
|
|
- `lib_export.py` (CSV/Excel Exports)
|
|
- `lib_jwt.py` (JWT encoding/decoding)
|
|
- `lib_hash.py` (Argon2 hashing)
|
|
|
|
### 2. V3 Search & Security
|
|
- [x] **Site Domain Exception**: Implemented and verified unauthenticated search for `site_domain`.
|
|
- [x] **Strict Multi-Tenant Isolation**: Enforced `account_id` filtering at the database level for all other V3 endpoints.
|
|
|
|
### 3. Unified Agent Platform
|
|
- [x] **Initialized `aether_platform`**: Created the orchestrator root at `/home/scott/OSIT_dev/aether_platform/`.
|
|
- [x] **Established Meta-Structure**: Linked `ae_api`, `ae_app`, and `ae_env` into the platform root via symbolic links.
|
|
- [x] **Unified Agent Specification**: Published and refined the `UNIFIED_AGENT_ARCH.md` incorporating frontend agent feedback.
|
|
|
|
## Current To-Do List
|
|
|
|
### 1. High Priority & Urgent
|
|
- [ ] **Unified Agent Core Logic**: Plan the implementation of the orchestrator's cross-stack diagnostic tools.
|
|
- [ ] **Docker MCP Integration**: Re-attempt environment diagnostics using the correct python path (`./env_mcp/bin/python`).
|
|
|
|
### 2. Infrastructure & Technical Debt
|
|
- [ ] **Agent Bridge Repair**: Fix the `psutil` or syntax issues in `agent_bridge.py`.
|
|
- [ ] **Nginx Configuration**: Finalize Port 8888 route proxying if needed.
|
|
|
|
### Workflow & Collaboration
|
|
- **Storage**: Critical assets at `/home/scott/OSIT/hosted_files/` (Synced via Syncthing). Files are often accessed directly via API download endpoints.
|
|
- **Agents Sync**: Shared documentation and notifications pushed to `~/agents_sync/`. |