Set up pyright static type checker for the framework

.github/workflows/lint.yml

@@ -32,3 +32,28 @@ jobs:
       - name: Run ruff format check
         working-directory: fastapi_startkit
         run: uv run ruff format --check .
+
+  pyright:
+    name: Pyright (non-blocking)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        working-directory: fastapi_startkit
+        run: uv sync --group dev
+
+      # Type checking is advisory while the existing baseline is worked down;
+      # continue-on-error keeps a failing run from blocking the pipeline.
+      - name: Run pyright
+        continue-on-error: true
+        working-directory: fastapi_startkit
+        run: uv run pyright

fastapi_startkit/pyproject.toml

@@ -105,6 +105,7 @@ dev = [
     "faker>=40.13.0",
     "langchain>=1.0.0",
     "langchain-core>=1.0.0",
+    "pyright>=1.1.411",
 ]
 
 
@@ -118,6 +119,19 @@ fixable = ["F401"]
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401"]
 
+[tool.pyright]
+include = ["src/fastapi_startkit"]
+exclude = [
+    "**/tests",
+    "**/migrations",
+    "**/*.backup",
+    "**/*_backup",
+    "**/__pycache__",
+    "**/.venv",
+]
+typeCheckingMode = "basic"
+pythonVersion = "3.12"
+
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 norecursedirs = ["masoniteorm.backup", ".venv", "dist", "build", "__pycache__"]