refactor: replace ty with pyright and improve configurations

- Replace experimental ty (0.0.1a16) with stable pyright (1.1+)
- Configure pyright with standard type checking mode
- Make pre-commit pytest less aggressive: only run fast tests (-k "not slow")
- Remove -q flag from pytest for better debugging visibility
- Clarify CLAUDE.md framework preferences as general guidelines
- Add missing newline to pre-commit config
- Update all references from ty to pyright in docs and commands

This makes the type checking more reliable while maintaining the
same strict code quality standards.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: dguido

{{cookiecutter.project_slug}}/.pre-commit-config.yaml

@@ -12,9 +12,9 @@ repos:
 
   - repo: local
     hooks:
-      - id: ty
-        name: ty type check
-        entry: uv run ty check src
+      - id: pyright
+        name: pyright type check
+        entry: uv run pyright
         language: system
         types: [python]
         pass_filenames: false
@@ -30,8 +30,8 @@ repos:
       {%- endif %}
 
       - id: pytest
-        name: pytest
-        entry: uv run pytest -q
+        name: pytest (fast tests only)
+        entry: uv run pytest -x --tb=short -k "not slow"
         language: system
         types: [python]
         pass_filenames: false
@@ -42,4 +42,4 @@ repos:
 # Configuration
 ci:
   autofix_prs: true
-  autoupdate_schedule: weekly
+  autoupdate_schedule: weekly

{{cookiecutter.project_slug}}/CLAUDE.md

@@ -33,9 +33,9 @@ make dev
 make check  # Runs lint + tests
 
 # Code quality
-make lint   # ruff format --check + ruff check + ty check
+make lint   # ruff format --check + ruff check + pyright
 make fix    # Auto-fix formatting and lint issues
-make ty     # Run type checker
+make typecheck  # Run pyright type checker
 
 # Testing
 make test   # Run pytest with coverage
@@ -65,11 +65,14 @@ test/
 
 Tests can also live beside source files as `test_*.py` or `*_test.py`.
 
-## Framework Preferences
+## General Python Guidelines
 
-- **Web**: Always use FastAPI, never Flask
-- **Data**: Prefer Polars over Pandas for new code
-- **Async**: Use native async/await, not threading
+These are general preferences for Python development:
+
+- **Web frameworks**: Prefer FastAPI over Flask for new projects
+- **Data processing**: Consider Polars for performance-critical data operations
+- **Async programming**: Use native async/await instead of threading
+- **Type checking**: Always use type hints and run pyright
 
 ## Common Patterns
 
@@ -123,7 +126,7 @@ parser.add_argument(
 ## CI/CD
 
 GitHub Actions run on every push/PR:
-1. **Linting**: ruff format/check + ty type checking
+1. **Linting**: ruff format/check + pyright type checking
 2. **Tests**: pytest with coverage
 3. **Security**: zizmor workflow scanning
 {%- if cookiecutter.documentation == "pdoc" %}
@@ -134,7 +137,7 @@ GitHub Actions run on every push/PR:
 
 1. **Never commit code that violates the quality standards** - refactor instead
 2. **All public APIs need Google-style docstrings**
-3. **Type hints are mandatory** - use `ty check`
+3. **Type hints are mandatory** - use `pyright`
 4. **Tests can live beside code** - prefer colocated tests for better maintainability
 
 ## Project-Specific Instructions

{{cookiecutter.project_slug}}/Makefile

@@ -60,7 +60,7 @@ $(VENV)/pyvenv.cfg: pyproject.toml
 lint: $(VENV)/pyvenv.cfg
 	uv run ruff format --check && \
 		uv run ruff check && \
-		uv run ty check src
+		uv run pyright
 
 	{%- if cookiecutter.docstring_coverage %}
 		uv run interrogate -c pyproject.toml .
@@ -69,9 +69,9 @@ lint: $(VENV)/pyvenv.cfg
 .PHONY: check
 check: lint test
 
-.PHONY: typecheck ty
-typecheck ty: $(VENV)/pyvenv.cfg
-	uv run ty check src
+.PHONY: typecheck
+typecheck: $(VENV)/pyvenv.cfg
+	uv run pyright
 
 .PHONY: fix format reformat
 fix format reformat:
@@ -80,7 +80,7 @@ fix format reformat:
 
 .PHONY: test tests
 test tests: $(VENV)/pyvenv.cfg
-	uv run pytest -q --cov=$(PY_IMPORT) $(T) $(TEST_ARGS)
+	uv run pytest --cov=$(PY_IMPORT) $(T) $(TEST_ARGS)
 	uv run coverage report -m $(COV_ARGS)
 
 .PHONY: doc

{{cookiecutter.project_slug}}/pyproject.toml

@@ -34,7 +34,7 @@ lint = [
     # NOTE: ruff is under active development, so we pin conservatively here
     # and let Dependabot periodically perform this update.
     "ruff ~= 0.6.2",
-    "ty >= 0.0.1a16",
+    "pyright >= 1.1",
     "types-html5lib",
     "types-requests",
     "types-toml",
@@ -59,7 +59,12 @@ Source = "https://github.com/{{ cookiecutter.github_username }}/{{ cookiecutter.
 # don't attempt code coverage for the CLI entrypoints
 omit = ["{{ cookiecutter.__project_src_path }}/_cli.py"]
 
-# ty configuration - using defaults for now as ty is in early alpha
+[tool.pyright]
+# Type checking configuration
+pythonVersion = "3.11"
+typeCheckingMode = "standard"
+useLibraryCodeForTypes = true
+reportMissingTypeStubs = false
 
 [tool.ruff]
 line-length = 100
@@ -121,4 +126,4 @@ fail-under = 100
 testpaths = ["src", "test"]
 python_files = ["test_*.py", "*_test.py"]
 # Show test durations
-addopts = "-q --durations=10"
+addopts = "--durations=10"