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

3.4 KiB

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