# eval — repo context

> Curated overview for code_search. Source: `direqt-search/eval` (GitHub). Node.js/TypeScript service.

## Purpose
**Evaluation Framework Service** for Direqt Search — a backend service (distinct
from the `search-eval` UI tool) for running search/answer evaluations. Integrates
with Google Sheets/Drive for test data and reporting, and uses OpenAI for
LLM-assisted judging/answers.

## Structure (top-level dirs)
- `eval-api/` — the evaluation API surface
- `src/` — evaluation logic
- `config/`, `docs/`, `test/`

## Tech
Node.js · TypeScript · Express · MongoDB (Mongoose) · **OpenAI** · `googleapis` +
`google-spreadsheet` (Sheets) · `google-auth-library` · Winston · Zod · Mocha tests.
Depends on `@direqt-internal/{search-api,service-framework}`.

_Note: relationship to `search-eval` — `eval` is the server-side evaluation
service; `search-eval` is the web UI/tooling for NDCG scoring._