chore: add lint script to match linter.yaml from CI

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.

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