src/query/README.md

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.