Development

uv sync --all-groups --python /opt/homebrew/opt/python@3.13/bin/python3.13
uv run pytest        # aim for 100% line and branch coverage (reported, not enforced)
./mkdocs.sh          # these docs (sphinx-build -W)
  • Tests never call a real model: pydantic_ai.models.ALLOW_MODEL_REQUESTS is off in tests/conftest.py. The agents are tested with scripted FunctionModels (tests/scripted.py), on three verses of Ephesians (tests/data/ar.conllu, grc.conllu, silver.jsonl) and small synthetic sentence pairs.

  • New store or MCP features belong in MCParser (generic, with tests), not here.

  • Implementation notes, design decisions, measurements and environment gotchas are in AGENTS.md at the repository root.

Layout

mcaligner/
  lexicon.py    translation table, lexicon export
  rules.py      code-only links, precision measurement
  evaluate.py   P/R/F1, AER
  settings.py   models and run settings
  agents/       prompts, compact answers, read-only toolset, agent team
  pipeline.py   rules → align → score rounds
  cli.py        typer command line