| # 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. | |