Revival baseline: restore CI, enforce coverage gate, fix packaging and stale docs

[the-lay]

What & why

First maintenance pass in 14 months. This PR restores the feedback loop and fixes everything small-and-broken, ahead of the multiclass Merger work (coming as a separate PR). No behavior changes for valid inputs.

CI (the headline)

This repo currently has zero workflow run records — the README badge literally renders "no status", and there has been no proof the package works on any Python or NumPy version. This PR:

• adds workflow_dispatch so CI can be triggered without a push
• extends the matrix to 3.9–3.14 (3.14 was never tested) plus two NumPy axes: the declared numpy>=1.20 floor and newest 1.x, alongside default 2.x — first CI proof of NumPy 2 compatibility (locally verified: 40/40 tests pass on numpy 2.5.1)
• activates the dormant coverage gate: fail_under = 95 was configured but coverage report was never invoked; actual coverage is 99%, so the gate turns on green
• installs editable in CI so coverage paths map back to the src/ layout (Coveralls has been getting unmappable paths since the 2025 migration)
• release publishing now requires tests to pass first (previously a GitHub release published to PyPI without running a single test)
• actions bumped to current majors and SHA-pinned, with Dependabot keeping pins fresh; pre-commit hooks bumped (ruff v0.11.12→v0.16.1)

Packaging

• PEP 639 SPDX license (license = "MIT" + license-files, setuptools>=77) — replacing the deprecated table before it breaks a release build
• numpy>=1.20 floor — the constraint numpy.typing has imposed since 2021; its absence is exactly what made a user fork the project ([BUG] Incompatible Python and NumPy Versioning #22)
• per-version classifiers 3.9–3.14

Fixes

• tiler.__version__ now exists (CONTRIBUTING's first instruction to bug reporters — python -c "import tiler; print(tiler.__version__)" — used to raise AttributeError)
• channel_dimension=0 bypassed bounds validation due to a truthiness check (if self.channel_dimension: at tiler.py:136), surfacing as a raw IndexError instead of the documented ValueError; now consistent with the nine is not None checks elsewhere in the file
• README's from-source install was a bare pip install (errors as written)
• CONTRIBUTING referenced black (dropped for ruff in 2025)
• misc/docs.sh:1 dereferenced an undefined $file_name — run from the repo root it escaped to the parent directory and ran rm outside the repo; now anchored to the script location with set -euo pipefail

Verification

• 40/40 tests pass (2 new, each observed failing first) on Python 3.12 + numpy 2.5.1, coverage 99%
• pre-commit run --all-files green with the bumped hooks (this is the CI lint job)
• uv build wheel inspected: License-Expression: MIT, Requires-Python: >=3.9, Requires-Dist: numpy>=1.20, py.typed present

Known follow-ups (deliberately not in this PR)

• Multiclass/logit-aware Merger ([IDEA] Figuring out how to use this library with TensorFlow multi-class and binary classification #20, supersedes PR Reworked Merger that supports multiclass #21) — next PR
• Internal typing cleanup: mypy reports 26 errors in src/tiler despite shipping py.typed
• Docs publishing workflow (docs are currently a committed 499 KB artifact behind a manual script)

🤖 Generated with Claude Code

https://claude.ai/code/session_01PvVX1JaNVaXJ2PJEu4KJzE