Log a gotcha, error, or operational event to gotchas.md in the project root. Appends timestamped entries for traceability and compliance.

Use MarkdownHeaderTextSplitter if markdown, else fallback to RecursiveCharacterTextSplitter.

Handles chat logic: retrieves relevant docs (hybrid/vector/keyword/MMR), constructs prompt, calls LLM, logs history.

Danger: Delete ALL files and chat history from DB and vectorstore. Requires admin-token.

Ingests a file using adaptive chunking (header-based for markdown, otherwise character-based).

Hybrid retrieval: combines vector search, keyword, and metadata filtering. Always uses strict top-k retrieval (no MMR). :param query:

:param vector_db_path: Path for ChromaDB persistence :param chunking_strategy: 'auto', 'header', or 'character'. If 'auto', use heade

Chat endpoint: supports hybrid retrieval (keywords, metadata, MMR, k). Accepts ChatRequest body or legacy query params.

Danger: Delete ALL files and chat history from DB and vectorstore. Delegates business logic to admin_service. Validates admin token length (8

Delete a file: removes from DB and disk, attempts vectorstore cleanup. Delegates business logic to file_service for DB/disk, keeps vectorstore lo

Health check endpoint: verifies DB, vectorstore, and LLM health.

List all files in the database. Delegates business logic to file_service.

Upload a file and ingest into the RAG pipeline. Delegates business logic to file_service. Validates file extension against SUPPORTED_EXTENSIO