chore: add lint script to match linter.yaml from CI (#809)

1. The script invokes Python linters from the CI, JSCPD is not invoked.
2. GitHub action is updated to run pyright using local env to match
versions and make results reproduciable.

<img width="870" height="564" alt="image"
src="https://github.com/user-attachments/assets/ece92c55-b1c3-4475-9cc7-2b9b93cc99f1"
/>

Author: ishymko

.github/workflows/linter.yaml

@@ -45,9 +45,7 @@ jobs:
       - name: Run Pyright (Pylance equivalent)
         id: pyright
         continue-on-error: true
-        uses: jakebailey/pyright-action@v2
-        with:
-          pylance-version: latest-release
+        run: uv run pyright src
 
       - name: Run JSCPD for copy-paste detection
         id: jscpd

pyproject.toml

@@ -127,6 +127,7 @@ dev = [
   "trio",
   "uvicorn>=0.35.0",
   "pytest-timeout>=2.4.0",
+  "pyright",
   "a2a-sdk[all]",
 ]
 

scripts/lint.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Local replica of .github/workflows/linter.yaml (excluding jscpd copy-paste check)
+
+# ANSI color codes for premium output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+FAILED=0
+
+echo -e "${BLUE}${BOLD}=== A2A Python Fixed-and-Lint Suite ===${NC}"
+echo -e "Fixing formatting and linting issues, then verifying types...\n"
+
+# 1. Ruff Linter (with fix)
+echo -e "${YELLOW}${BOLD}--- [1/4] Running Ruff Linter (fix) ---${NC}"
+if uv run ruff check --fix; then
+    echo -e "${GREEN}✓ Ruff Linter passed (and fixed what it could)${NC}"
+else
+    echo -e "${RED}✗ Ruff Linter failed${NC}"
+    FAILED=1
+fi
+
+# 2. Ruff Formatter
+echo -e "\n${YELLOW}${BOLD}--- [2/4] Running Ruff Formatter (apply) ---${NC}"
+if uv run ruff format; then
+    echo -e "${GREEN}✓ Ruff Formatter applied${NC}"
+else
+    echo -e "${RED}✗ Ruff Formatter failed${NC}"
+    FAILED=1
+fi
+
+# 3. MyPy Type Checker
+echo -e "\n${YELLOW}${BOLD}--- [3/4] Running MyPy Type Checker ---${NC}"
+if uv run mypy src; then
+    echo -e "${GREEN}✓ MyPy passed${NC}"
+else
+    echo -e "${RED}✗ MyPy failed${NC}"
+    FAILED=1
+fi
+
+# 4. Pyright Type Checker
+echo -e "\n${YELLOW}${BOLD}--- [4/4] Running Pyright ---${NC}"
+if uv run pyright; then
+    echo -e "${GREEN}✓ Pyright passed${NC}"
+else
+    echo -e "${RED}✗ Pyright failed${NC}"
+    FAILED=1
+fi
+
+echo -e "\n${BLUE}${BOLD}=========================================${NC}"
+if [ $FAILED -eq 0 ]; then
+    echo -e "${GREEN}${BOLD}SUCCESS: All linting and formatting tasks complete!${NC}"
+    exit 0
+else
+    echo -e "${RED}${BOLD}FAILURE: One or more steps failed.${NC}"
+    exit 1
+fi