Project Structure


aura-symphony/
├── src/
│   ├── api/                  # AI clients, streaming, Firebase, proxy client
│   │   └── virtuosos/        # One module per agent (conductor, visionary, …)
│   ├── components/
│   │   ├── analysis/         # Lens Laboratory, timeline, video player, insights
│   │   ├── conductor/        # The Conductor input (omnibar)
│   │   ├── course/           # Course view, quiz/text/video learning modules
│   │   ├── creator/          # Creator Studio
│   │   ├── landing/          # Landing page
│   │   ├── docs/             # In-app documentation
│   │   ├── lenses/           # Lens palette and prompt modal
│   │   ├── settings/         # AI provider settings
│   │   ├── valhalla/         # Valhalla Gateway
│   │   └── virtuosos/        # Custom Virtuoso builder (Agent Studio)
│   ├── hooks/                # useSymphony, useLensExecution, useCriticGate, …
│   ├── lib/                  # Core systems (bus, planner, sandbox, BKT, …)
│   │   └── lens-handlers/    # Pluggable lens handler registry
│   ├── services/             # Virtuoso registry & profiles
│   ├── workers/              # Media WebWorker
│   └── __tests__/            # Unit tests (438 tests across 20 files)
├── backend/
│   ├── api-proxy/            # Express — key isolation, rate limiting, metering
│   ├── vector-search/        # FastAPI + ChromaDB — semantic search
│   ├── graph-knowledge/      # Express + SQLite — concept graph
│   ├── media-pipeline/       # Express + FFmpeg + WebSocket
│   ├── clip-embeddings/      # FastAPI + CLIP ViT-B/32
│   └── shared/               # CORS helpers
├── docs/                     # Vision & UX documents
├── e2e/                      # Playwright end-to-end specs
├── public/sw.js              # Service Worker (offline-first PWA)
├── specs/                    # Feature specs and task plans
├── docker-compose.yml        # Full backend stack
├── firestore.rules           # Firestore security rules
└── vite.config.ts            # Vite 6 configuration

Key modules at a glance

Module	Responsibility
`src/lib/symphonyBus.ts`	Event bus — task lifecycle, commission chaining
`src/lib/react-planner.ts`	ReAct plan–act–observe loop for the Conductor
`src/lib/conductor-functions.ts`	Function declarations exposed to the LLM
`src/lib/conductor-schemas.ts`	Zod schemas validating every function call
`src/lib/semantic-chunker.ts`	Adaptive semantic transcript chunking
`src/lib/vector-search.ts`	Client for the ChromaDB vector service
`src/lib/clip-embeddings.ts`	Multimodal RAG via CLIP frame embeddings
`src/lib/valhalla-sandbox.ts`	Pyodide sandbox execution engine
`src/lib/knowledge-tracing.ts`	Bayesian Knowledge Tracing (BKT)
`src/lib/federated-learning.ts`	Federated updates with differential privacy
`src/lib/crdt-collaboration.ts`	Yjs CRDT shared state
`src/lib/plugin-marketplace.ts`	Plugin install, integrity check, sandbox
`src/lib/worker-pool.ts`	WebWorker pool with work-stealing
`src/lib/offline-sync.ts`	IndexedDB mutation queue + background sync
`src/lib/nleExport.ts`	FCPXML / EDL / CSV timeline export
`src/lib/telemetry.ts`	Structured logging and timers