Add CI pipeline, nox multi-version testing, pre-commit hooks, ruff formatting

- Add GitHub Actions CI with 3×4 matrix (Python 3.12/3.13/3.14 × numpy-only/torch/jax/all)
- Add noxfile.py with uv backend for local multi-version testing
- Add uv-pre-commit hook (uv-lock) and local pytest pre-push hook
- Broaden version constraints: requires-python >=3.12, numpy >=2.2.0, torch >=2.6.0, jax >=0.5.0
- Split optional deps into separate torch/jax dependency groups, add nox to dev
- Fix ruff lint errors (unused imports) and reformat all code with ruff
- Suppress pyright reportMissingImports for optional jax/torch imports
- Reorganize tests into per-backend files (test_numpy, test_jax, test_torch)

Author: acecchini

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --group dev
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --group dev
+      - run: uv run pyright src/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+        backend: ["numpy-only", "torch", "jax", "all"]
+    name: test (py${{ matrix.python-version }}, ${{ matrix.backend }})
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install core + dev deps
+        run: uv sync --group dev
+      - name: Install torch
+        if: matrix.backend == 'torch' || matrix.backend == 'all'
+        run: uv sync --group dev --group torch
+      - name: Install jax
+        if: matrix.backend == 'jax' || matrix.backend == 'all'
+        run: uv sync --group dev --group jax
+      - name: Run tests
+        run: uv run pytest tests/ -v

.gitignore

@@ -8,3 +8,7 @@ wheels/
 
 # Virtual environments
 .venv
+.lsp_mcp.port
+.claude/
+!.claude/skills/
+!.claude/commands/

.pre-commit-config.yaml

@@ -0,0 +1,54 @@
+default_install_hook_types: [pre-commit, pre-push, commit-msg]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+    - id: trailing-whitespace
+    - id: end-of-file-fixer
+    - id: check-docstring-first
+    - id: check-yaml
+    - id: check-executables-have-shebangs
+    - id: check-toml
+    - id: debug-statements
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.10.7
+    hooks:
+      - id: uv-lock
+
+  - repo: https://github.com/tsvikas/sync-with-uv
+    rev: v0.5.0
+    hooks:
+      - id: sync-with-uv
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.4 # overwritten by `sync-with-uv` hook
+    hooks:
+      - id: ruff-check
+        args: [--fix, --output-format=concise]
+      - id: ruff-format
+        args: [--output-format=concise]
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1 # overwritten by `sync-with-uv` hook
+    hooks:
+    - id: codespell
+      stages: [pre-commit, commit-msg]
+
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.351 # overwritten by `sync-with-uv` hook
+    hooks:
+    - id: pyright
+      stages: [pre-push]
+      pass_filenames: false
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: uv run pytest tests/ -x -q
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]