Adopt uv, ruff and typer-invoke

[joaonc]

Closes #16
Closes #17

Changes

Tooling

• uv: replaces pip/pip-tools for dependency management and venv creation
• ruff: replaces black, isort, and flake8 for linting and formatting
• typer-invoke: replaces invoke for task running

Structure

• Added admin/ package with task modules: build, lint, pip, test
• Added admin/utils.py with shared utilities (run(), DryAnnotation, etc.)
• Moved requirements files to admin/requirements/
• Deleted tasks.py and root-level requirements files

Config / Docs

• Updated pyproject.toml: uv_build backend, ruff config, [tool.typer-invoke] config
• Updated GitHub Actions workflows (linting.yml, tests.yml) to use uv
• Updated README.md, docs/develop.md, docs/publish.md
• Added WARP.md with development workflow documentation

Note: To complete the migration, manually uninstall pip from the virtual env:
uv pip uninstall pip

Co-Authored-By: Oz oz-agent@warp.dev

[joaonc]

Summary of Changes

Issue #16 — Adopt uv and ruff

Dependency management (uv replaces pip + pip-tools):

• Updated pyproject.toml build backend to uv_build
• Requirements files moved to admin/requirements/ and regenerated with uv pip compile
• Deleted root-level requirements.in, requirements-dev.in, requirements.txt, requirements-dev.txt
• GitHub Actions workflows updated to use astral-sh/setup-uv@v5 and uv commands

Linting/formatting (ruff replaces black + isort + flake8):

• Removed [tool.black], [tool.isort], [tool.flake8] from pyproject.toml
• Added [tool.ruff], [tool.ruff.lint], [tool.ruff.lint.isort], [tool.ruff.format]
• Updated admin/lint.py to run ruff instead of the old tools

Docs updated: README.md, docs/develop.md, docs/publish.md, WARP.md (new)

Manual step: uninstall pip from the venv with uv pip uninstall pip

---

Issue #17 — Adopt typer-invoke

Task runner (typer-invoke replaces invoke):

• Deleted tasks.py (399 lines)
• Created admin/ package with focused task modules:
  • admin/build.py — version, clean, publish, release
  • admin/lint.py — ruff, mypy
  • admin/pip.py — compile, sync, package, upgrade, install
  • admin/test.py — unit
  • admin/utils.py — shared helpers (run(), DryAnnotation, logging, OS utils)
  • admin/__init__.py — project constants
• Added [tool.typer-invoke] to pyproject.toml pointing to all admin modules
• Tasks are now invoked with uv run inv <module>.<task>