# query

Catalog-driven query subsystem. User question → IR → SQL/pandas → result.

Subpackages:
- `ir/` — JSON IR Pydantic models + validator
- `planner/` — LLM step: question + catalog → IR
- `compiler/` — deterministic IR → SQL or pandas op chain (no LLM)
- `executor/` — runs the compiled query against DB or Parquet

See `ARCHITECTURE.md` (root) for the full design.