Scott.Idem/OSIT-AE-API-FastAPI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
59d5b81da0d632ca44b48dfd20522f23153ae12e
OSIT-AE-API-FastAPI/GEMINI.md
Scott Idem 59d5b81da0 Arch: Finalize V3 Auth modularization and Unified Agent spec. 
- 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.
2026-01-07 19:07:21 -05:00

3.1 KiB
Raw Blame History

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

  • 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.
  • 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

  • Site Domain Exception: Implemented and verified unauthenticated search for site_domain.
  • Strict Multi-Tenant Isolation: Enforced account_id filtering at the database level for all other V3 endpoints.

3. Unified Agent Platform

  • Initialized aether_platform: Created the orchestrator root at /home/scott/OSIT_dev/aether_platform/.
  • Established Meta-Structure: Linked ae_api, ae_app, and ae_env into the platform root via symbolic links.
  • 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/.
Reference in New Issue View Git Blame Copy Permalink