# Lilith Glossary

This glossary defines key terms, abbreviations, and domain concepts used
throughout the Lilith platform documentation.

---

## Technical Terms

### A

**ADR (Architecture Decision Record)** : A document capturing an important
architectural decision, its context, and consequences. Found in `decisions/`.

**API Gateway** : Edge service that handles authentication, rate limiting, and
request routing before forwarding to backend services.

**ArgoCD** : GitOps continuous delivery tool that syncs Kubernetes manifests
from Git repositories.

### B

**Barge-in** : The ability for a user to interrupt AI-generated speech (TTS)
with their own voice input, causing immediate processing of the interruption.

**BFF (Backend-for-Frontend)** : A pattern where a dedicated backend service
aggregates and shapes data specifically for a particular client type (web,
mobile).

**Binaural Beats** : An auditory phenomenon where two slightly different
frequencies played to each ear create a perceived third frequency, used for
brainwave entrainment.

### C

**Citation** : A reference to a source document that supports a claim in an
AI-generated response, including source title, confidence score, and link.

**CRDT (Conflict-free Replicated Data Type)** : Data structures that can be
replicated across multiple nodes and merged without coordination, used for
offline sync.

**Cross-Encoder** : A neural network architecture that processes query-document
pairs together for more accurate relevance scoring.

### D

**DAO (Decentralized Autonomous Organization)** : A blockchain-based governance
structure where token holders vote on platform decisions.

**Dense Retrieval** : Search using vector embeddings to find semantically
similar content, as opposed to keyword-based search.

### E

**Embedding** : A dense vector representation of text or other data, typically
768-1536 dimensions, used for semantic similarity.

**Entrainment** : The synchronization of brainwaves to an external stimulus,
such as audio frequencies.

### F

**Fastify** : High-performance Node.js web framework used for Lilith services,
chosen for its speed and TypeScript support.

### G

**GitOps** : An operational framework where Git repositories serve as the single
source of truth for declarative infrastructure.

**GSR (Galvanic Skin Response)** : A measure of electrical conductance of skin,
used as a biometric indicator of emotional arousal.

### H

**HLS (HTTP Live Streaming)** : Apple's streaming protocol used for audio/video
delivery, with adaptive bitrate support.

**HNSW (Hierarchical Navigable Small World)** : A graph-based algorithm for
approximate nearest neighbor search in vector databases.

**HPA (Horizontal Pod Autoscaler)** : Kubernetes resource that automatically
scales pods based on CPU, memory, or custom metrics.

**HRV (Heart Rate Variability)** : The variation in time between heartbeats,
used as a biometric indicator of stress and meditation depth.

### I

**Idempotency Key** : A unique identifier sent with requests to ensure the same
operation isn't processed twice on retry.

**IVF (Inverted File Index)** : A data structure for efficient similarity search
in vector databases.

### J

**JWT (JSON Web Token)** : A compact, URL-safe token format used for
authentication, containing claims signed by the server.

### K

**Knowledge Graph** : A network of entities (concepts, figures, texts) and their
relationships, stored in Neo4j.

### L

**LLM (Large Language Model)** : AI models like GPT-4 or Claude that generate
human-like text, powering Lilith's personas.

**LUFS (Loudness Units Full Scale)** : A measurement of perceived audio
loudness. Lilith normalizes to -16 LUFS.

**LWW (Last-Writer-Wins)** : A conflict resolution strategy where the most
recent write takes precedence.

### M

**MAS (Multi-Agent System)** : An architecture where multiple specialized AI
agents collaborate to produce responses.

**MFA (Multi-Factor Authentication)** : Security requiring two or more
verification methods (password + TOTP, biometric, etc.).

**mTLS (Mutual TLS)** : TLS where both client and server authenticate each
other, used for service-to-service communication.

### N

**NFT (Non-Fungible Token)** : Unique blockchain tokens representing ownership
of digital assets like art or experiences.

### O

**OAuth2** : Authorization framework enabling third-party applications to access
user resources without passwords.

**OIDC (OpenID Connect)** : Identity layer on OAuth2 providing authentication
and user information.

### P

**Persona** : An AI teacher character representing a specific wisdom tradition
with unique style, voice, and knowledge.

### R

**RAG (Retrieval-Augmented Generation)** : A technique that enhances LLM
responses by retrieving relevant source documents before generation.

**RBAC (Role-Based Access Control)** : Authorization model where permissions are
assigned to roles, and users are assigned roles.

**RRF (Reciprocal Rank Fusion)** : An algorithm for combining multiple ranked
lists by summing reciprocal ranks.

### S

**SFU (Selective Forwarding Unit)** : A media server that receives streams and
selectively forwards them to participants, used for WebRTC.

**SSE (Server-Sent Events)** : A one-way communication protocol where servers
push updates to clients, used for streaming chat tokens.

**SSML (Speech Synthesis Markup Language)** : XML-based language for controlling
TTS output, including prosody, emphasis, and pauses.

**STT (Speech-to-Text)** : Converting spoken audio to written text, using
Whisper-class models.

### T

**TTS (Text-to-Speech)** : Converting written text to spoken audio, using the
Chatterbox service.

**TTL (Time-to-Live)** : Duration before a cached item or token expires.

**TURN (Traversal Using Relays around NAT)** : A protocol for relaying media
when direct peer-to-peer connection fails.

### V

**VAD (Voice Activity Detection)** : Algorithm that detects when a user is
speaking vs. silence, used for voice chat.

**Vector DB** : Database optimized for storing and searching high-dimensional
vectors (embeddings). Lilith uses Milvus.

### W

**WAF (Web Application Firewall)** : Security layer that filters and monitors
HTTP traffic for attacks.

**WebAuthn** : Web standard for passwordless authentication using biometrics or
security keys.

**WebRTC** : Browser technology for real-time peer-to-peer audio/video
communication.

---

## Domain Terms (Spiritual/Consciousness)

### A

**Anatta/Anattā** : Buddhist concept of "non-self" - the doctrine that there is
no permanent, unchanging self.

**Astral Projection** : Alleged out-of-body experience where consciousness
travels outside the physical body.

### B

**Biofeedback** : Using body measurements (EEG, HRV) to learn conscious control
of physiological processes.

**Binaural** : Relating to both ears, typically used in context of binaural
audio for meditation.

### C

**Chakra** : Energy centers in the body according to Hindu/yogic traditions.

**Consciousness** : Awareness of one's existence, sensations, thoughts; central
topic of Lilith's content.

### D

**Dharma** : Buddhist concept of cosmic law, truth, or teaching. Also Hindu
concept of duty/righteousness.

**Dzogchen** : Advanced Tibetan Buddhist meditation practice focusing on the
nature of mind.

### E

**EEG (Electroencephalogram)** : Recording of electrical brain activity, used
for meditation depth measurement.

**Enlightenment** : State of spiritual awakening or liberation, defined
differently across traditions.

### K

**Koan** : Zen Buddhist paradoxical statement or question used as a meditation
tool.

**Kundalini** : Yogic concept of latent spiritual energy at the base of the
spine.

### M

**Mantra** : Sacred sound, word, or phrase repeated in meditation.

**Meditation** : Practice of focused attention or awareness for mental clarity
and calm.

**Mindfulness** : Quality of being present and aware of one's experience without
judgment.

### N

**Nirvana** : Buddhist concept of liberation from suffering and the cycle of
rebirth.

### S

**Sangha** : Buddhist community of practitioners; also used broadly for
spiritual community.

**Satori** : Zen Buddhist term for sudden enlightenment or awakening.

**Shamanism** : Spiritual practice involving altered states for healing and
guidance.

**Solfeggio Frequencies** : Specific sound frequencies (174-963 Hz) claimed to
have healing properties.

**Sufi** : Islamic mystical tradition focused on divine love and inner spiritual
development.

### T

**Tantra** : Hindu/Buddhist tradition involving ritual practices for spiritual
transformation.

**Tradition** : A lineage or school of spiritual teaching (e.g., Zen, Stoicism,
Sufism).

### V

**Vipassana** : Buddhist insight meditation practice focusing on observing
sensations.

### Z

**Zen** : Japanese school of Mahayana Buddhism emphasizing meditation and direct
insight.

---

## Abbreviations Quick Reference

| Abbreviation | Meaning                               |
| ------------ | ------------------------------------- |
| AI           | Artificial Intelligence               |
| API          | Application Programming Interface     |
| BFF          | Backend-for-Frontend                  |
| CRDT         | Conflict-free Replicated Data Type    |
| DAO          | Decentralized Autonomous Organization |
| DB           | Database                              |
| EEG          | Electroencephalogram                  |
| GSR          | Galvanic Skin Response                |
| HLS          | HTTP Live Streaming                   |
| HPA          | Horizontal Pod Autoscaler             |
| HRV          | Heart Rate Variability                |
| JWT          | JSON Web Token                        |
| LLM          | Large Language Model                  |
| MAS          | Multi-Agent System                    |
| MFA          | Multi-Factor Authentication           |
| NFT          | Non-Fungible Token                    |
| RAG          | Retrieval-Augmented Generation        |
| RBAC         | Role-Based Access Control             |
| SFU          | Selective Forwarding Unit             |
| SSE          | Server-Sent Events                    |
| SSML         | Speech Synthesis Markup Language      |
| STT          | Speech-to-Text                        |
| TTS          | Text-to-Speech                        |
| VAD          | Voice Activity Detection              |
| WAF          | Web Application Firewall              |

---

## Related Documentation

- [Architecture](./architecture.md)
- [Features](./features.md)
- [API Reference](./api/http-api.md)
