migrate ci fully to uv

Author: prassanna-ravishankar

.github/workflows/ci.yml

@@ -21,19 +21,16 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+          enable-cache: true
 
       - name: Install dependencies
-        run: rye sync --all-features
+        run: uv sync --all-extras --group dev
 
       - name: Run lints
-        run: ./scripts/lint
+        run: uv run task ci-lint
 
   build:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
@@ -46,19 +43,16 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+          enable-cache: true
 
       - name: Install dependencies
-        run: rye sync --all-features
+        run: uv sync --all-extras --group dev
 
       - name: Run build
-        run: rye build
+        run: uv run task ci-build
 
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/agentex-sdk-python'
@@ -83,16 +77,13 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+          enable-cache: true
 
       - name: Bootstrap
-        run: ./scripts/bootstrap
+        run: uv run task bootstrap
 
       - name: Run tests
-        run: ./scripts/test
+        run: uv run task ci-test

CLAUDE.md

@@ -6,8 +6,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ### Package Management
 - Use `uv` for dependency management
-- Run `./scripts/bootstrap` to set up the environment
+- Run `uv run task bootstrap` to set up the environment
 - Or use `uv sync --all-extras --group dev` directly
+- Run `uv run task setup-pre-commit` to install pre-commit hooks
 
 Both the main repo and individual tutorials use `uv` for consistency.
 

pyproject.toml

@@ -96,23 +96,41 @@ dev = [
     "nbstripout>=0.8.1",
     "yaspin>=3.1.0",
     "taskipy>=1.12.0",
+    "pre-commit>=3.5.0",
 ]
 
 [tool.taskipy.tasks]
-format = { cmd = "task format:ruff && task format:docs && task fix:ruff && task format:ruff", help = "Format code with ruff and docs" }
-"format:docs" = { cmd = "python scripts/utils/ruffen-docs.py README.md api.md", help = "Format documentation" }
-"format:ruff" = { cmd = "ruff format", help = "Format code with ruff" }
-
-lint = { cmd = "task check:ruff && task typecheck && task check:importable", help = "Run all linting checks" }
-"check:ruff" = { cmd = "ruff check .", help = "Check code with ruff" }
-"fix:ruff" = { cmd = "ruff check --fix .", help = "Fix ruff issues automatically" }
-
-"check:importable" = { cmd = "python -c 'import agentex'", help = "Check that agentex can be imported" }
-
-typecheck = { cmd = "task typecheck:pyright && task typecheck:mypy", help = "Run type checking" }
-"typecheck:pyright" = { cmd = "pyright", help = "Run pyright type checker" }
-"typecheck:verify-types" = { cmd = "pyright --verifytypes agentex --ignoreexternal", help = "Verify types" }
-"typecheck:mypy" = { cmd = "mypy .", help = "Run mypy type checker" }
+# === ATOMIC TASKS (building blocks) ===
+"format-ruff" = { cmd = "ruff format", help = "Format code with ruff" }
+"format-docs" = { cmd = "python scripts/utils/ruffen-docs.py README.md api.md", help = "Format documentation" }
+"check-ruff" = { cmd = "ruff check .", help = "Check code with ruff" }
+"fix-ruff" = { cmd = "ruff check --fix .", help = "Fix ruff issues automatically" }
+"check-types-pyright" = { cmd = "pyright", help = "Run pyright type checker" }
+"check-types-mypy" = { cmd = "mypy .", help = "Run mypy type checker" }
+"check-importable" = { cmd = "python -c 'import agentex'", help = "Check that agentex can be imported" }
+
+# === COMPOSITE TASKS with hooks ===
+format = { cmd = "task format-ruff", help = "Format code with ruff and docs" }
+post_format = "task format-docs"
+
+typecheck = { cmd = "task check-types-pyright", help = "Run type checking" }
+post_typecheck = "task check-types-mypy"
+
+lint = { cmd = "task check-ruff", help = "Run all linting checks" }
+post_lint = "task typecheck && task check-importable"
+
+# === SCRIPT DELEGATION (complex operations) ===
+bootstrap = { cmd = "./scripts/bootstrap", help = "Set up development environment" }
+test = { cmd = "./scripts/test", help = "Run tests with mock server" }
+mock = { cmd = "./scripts/mock", help = "Start mock API server" }
+
+# === DEVELOPMENT SETUP ===
+setup-pre-commit = { cmd = "pre-commit install", help = "Install pre-commit hooks" }
+
+# === CI-SPECIFIC TASKS ===
+ci-lint = { cmd = "task lint", help = "Run linting for CI" }
+ci-test = { cmd = "task test", help = "Run tests for CI" }
+ci-build = { cmd = "uv build", help = "Build package for CI" }
 
 [tool.hatch.build]
 include = [