pyproject.toml

[project]
name = "groundworkers"
dynamic = ["version"]
description = "Groundworkers MCP server — read-only agentive access to OMOP vocabularies, concept graphs, and embeddings."
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
  "fastapi>=0.110,<1.0",
  "mcp[cli]>=1,<2",
  "numpy>=1.26,<3",
  "pydantic>=2,<3",
  "pyyaml>=6,<7",
  "SQLAlchemy>=2,<3",
  "psycopg[binary]>=3.1,<4",
  "python-dotenv>=1,<2",
  "psutil>=5.9,<8",
  "oa-configurator>=1.3.0,<2",
  "omop-alchemy>=1.1,<2",
  "omop-graph>=2.1,<3",
  "omop-emb>=2.1,<3",
  "omop-llm>=1,<2",
  "omop-semantics>=0.6,<1",
  "uvicorn[standard]>=0.29,<1.0",
]

[project.optional-dependencies]
xlsx = [
  "openpyxl>=3.1,<4",
]
pdf = [
  "pdfplumber>=0.10",
]
tui = [
  "groundskeeping>=0.8.1,<1",
  "textual>=0.60",
  "rich>=13,<15",
]
# Reads exported embedding bundles during embedding setup.
embedding-artifacts = [
  "h5py>=3.10,<4",
]
docx = [
  "python-docx>=1.0",
]
all_source = [
  "openpyxl>=3.1,<4",
  "pdfplumber>=0.10",
  "python-docx>=1.0",
]
embedding-pgvector = [
  "omop-emb[pgvector]>=2.1,<3",
]
embedding-faiss = [
  "omop-emb[faiss-cpu]>=2.1,<3",
]
dev = [
  "httpx>=0.27,<1",
  "ipython>=8.0",
  "tornado>=6.5.5",
  "pytest>=9.0.3",
  "pytest-cov>=4.0",
  "mypy>=1.8",
  "ty>=0.0.59",
  "ruff>=0.4",
  "textual>=0.60",
  "mkdocs-material>=9.7.1",
  "mkdocstrings-python>=2.0.1",
  "mkdocs>=1.6.1",
  "requests>=2.33.0",
  "mkdocs-mermaid2-plugin"
]

[project.scripts]
groundworkers = "groundworkers.server:main"

[project.entry-points."omop.config"]
groundworkers = "groundworkers.config:GroundworkersConfig"

[build-system]
requires = ["hatchling", "hatch-vcs"]
build-backend = "hatchling.build"

[tool.hatch.version]
source = "vcs"
raw-options = { tag_regex = '^v?(?P<version>[0-9]+\.[0-9]+\.[0-9]+)$' }

[tool.hatch.build.targets.wheel]
packages = ["src/groundworkers"]

[tool.uv]
cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]
constraint-dependencies = ["setuptools>=83.0.0"]

[tool.ruff]
src = ["src", "tests"]

[tool.ruff.lint]
# Pinned explicitly: ruff's implicit default rule set widens between releases
# (0.16 pulled in flake8-bandit, flake8-blind-except and friends), which would
# otherwise break CI on a ruff upgrade rather than on a code change.
select = ["E4", "E7", "E9", "F", "I", "UP", "RUF"]

[tool.ty.src]
include = ["src"]

[tool.pytest.ini_options]
testpaths = ["tests"]
markers = [
  "integration: requires a live backend or database",
  "requires_client: requires an embedding API client",
]