numpy-vector-store 0.6.0__tar.gz → 0.7.0__tar.gz

{numpy_vector_store-0.6.0 → numpy_vector_store-0.7.0}/.github/workflows/checks.yml

@@ -22,10 +22,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.13"
 
@@ -46,7 +46,7 @@ jobs:
         run: uv run --locked ruff format --check .
 
       - name: Run mypy
-        run: uv run --locked mypy src/
+        run: uv run --locked mypy src/ benchmarks/ tools/
 
   tests:
     name: Test Python ${{ matrix.python-version }}
@@ -62,10 +62,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -82,16 +82,42 @@ jobs:
       - name: Run tests
         run: uv run --locked pytest
 
+  windows:
+    name: Test Windows on Python 3.13
+    runs-on: windows-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+
+      - name: Set up Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.32"
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install project dependencies
+        run: uv sync --locked --group dev
+
+      - name: Run tests
+        run: uv run --locked pytest
+
   minimum-numpy:
     name: Test minimum NumPy on Python 3.11
     runs-on: ubuntu-latest
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.11"
 

{numpy_vector_store-0.6.0 → numpy_vector_store-0.7.0}/.github/workflows/publish-pypi.yml

@@ -20,10 +20,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.12"
 
@@ -33,8 +33,13 @@ jobs:
       - name: Build distributions
         run: python -m build
 
+      - name: Verify release versions
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: python tools/verify_release_version.py --tag "$RELEASE_TAG"
+
       - name: Check distribution metadata
         run: python -m twine check dist/*
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1

{numpy_vector_store-0.6.0 → numpy_vector_store-0.7.0}/.github/workflows/publish-testpypi.yml

@@ -18,10 +18,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
         with:
           python-version: "3.12"
 
@@ -31,10 +31,13 @@ jobs:
       - name: Build distributions
         run: python -m build
 
+      - name: Verify distribution versions
+        run: python tools/verify_release_version.py
+
       - name: Check distribution metadata
         run: python -m twine check dist/*
 
       - name: Publish package distributions to TestPyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
         with:
           repository-url: https://test.pypi.org/legacy/

{numpy_vector_store-0.6.0 → numpy_vector_store-0.7.0}/CHANGELOG.md

@@ -4,7 +4,116 @@ This changelog records user-visible changes to NumPy Vector Store. Earlier
 release notes remain available on the
 [GitHub releases page](https://github.com/tvanreenen/numpy-vector-store/releases).
 
-## 0.6.0 - 2026-08-21
+## 0.7.0 - 2026-08-24
+
+This release closes the remaining public contract gaps found during the 1.0
+readiness audit. It rejects two forms of lossy NumPy coercion, makes a bound
+archive path stable for the lifetime of its store, and publishes the API and
+compatibility policy intended for 1.x. It also adds release checks that enforce
+the package version and distribution metadata before publication.
+
+Valid, documented 0.6 usage continues to work. Version 0.7 does not add a new
+feature family, remove a documented API, change search ranking, add a runtime
+dependency, or change archive format version 1.
+
+### Public API and 1.x compatibility policy
+
+The supported package-level imports are now explicit:
+
+```python
+from numpy_vector_store import VectorHit, VectorStore, __version__
+```
+
+- Add a [public API and compatibility policy](COMPATIBILITY.md) that names the
+  supported `VectorStore` methods and properties, `VectorHit` fields, return
+  types, ownership behavior, exception classes, and persistence guarantees.
+- Distinguish the supported top-level interface from private helpers, submodule
+  layout, subclass hooks, exact error wording, allocation details, and internal
+  algorithms.
+- Define the 1.x semantic-versioning, deprecation, removal, Python and NumPy
+  support, and archive-compatibility policies before those promises become
+  long-term commitments in 1.0.
+- Keep `VectorHit` as an immutable result record whose equality and hashability
+  follow its three values. Opaque metadata retains its own comparison and
+  hashing behavior; a hit containing a dictionary remains unhashable.
+
+The API itself remains centered on `VectorStore`, `VectorHit`, three explicit
+metric methods, typed opaque metadata, and the create/open/save/reload
+persistence lifecycle.
+
+### Lossless numeric input handling
+
+- Reject Python row-selector sequences containing a Python or NumPy Boolean,
+  including mixed values such as `[0, True]`, before NumPy can coerce the
+  Boolean to row zero or one.
+- Preserve the vectorized validation path for native NumPy integer selectors,
+  along with the existing shape, uniqueness, and bounds rules.
+- Reject complex vector batches passed to `add()` and complex queries passed to
+  every metric method before conversion to `float32` can discard their
+  imaginary components. This includes complex dtypes whose current values have
+  a zero imaginary part.
+- Apply complex-query validation before empty-store and empty-filter shortcuts,
+  so the accepted query contract does not depend on current store state.
+
+These inputs were accepted only through implicit NumPy conversion. Calls that
+deliberately used Boolean row indexes or complex vectors now raise `TypeError`;
+real-valued integer and floating-point inputs keep their existing behavior.
+
+### Stable archive bindings
+
+- Anchor a relative path to the current working directory when `save(path)` or
+  `VectorStore.open(path)` first binds it.
+- Return that anchored absolute path from `file_path` and keep later `save()` and
+  `reload()` calls pointed at the same archive if the process changes working
+  directory.
+- Preserve extensionless `.npz` resolution and lexical path behavior. Anchoring
+  does not resolve `..` components or dereference symlinks, so ordinary
+  filesystem replacement semantics remain intact.
+- Keep Save As transactional: a new binding becomes visible only after the new
+  archive has been written successfully.
+
+Format version 1 is unchanged, and no archive conversion is required. Code that
+compares `file_path` with a relative path should compare against its anchored
+absolute form. Code that intentionally changed directories to redirect a later
+pathless save should pass the new destination explicitly to `save(path)`.
+
+### Distribution and release safeguards
+
+- Publish the MIT license as an SPDX expression and include `LICENSE` in both
+  the wheel and source distribution.
+- Declare the existing `py.typed` marker through the `Typing :: Typed`
+  classifier and identify 0.7 as the project's beta adoption cycle before 1.0.
+- Verify that the source `__version__`, GitHub release tag, wheel metadata, and
+  source-distribution metadata agree before publishing to PyPI. The verifier
+  also requires exactly one wheel and one source distribution so stale build
+  output cannot be uploaded accidentally.
+- Pin remote GitHub Actions to immutable commits while retaining readable
+  release comments beside each pin.
+- Run the complete test suite on Windows with Python 3.13 in addition to the
+  supported Python 3.11 through 3.14 matrix on Linux and the Python 3.11 minimum
+  NumPy check.
+- Add regression coverage for unexpected archive fields, nonpositive persisted
+  dimensions, malformed persisted array shapes, and platform-specific
+  filesystem exception and permission behavior.
+
+The release verifier and benchmark tools remain outside the runtime wheel and
+add no package dependency.
+
+### Runtime compatibility and upgrade notes
+
+- Continue supporting Python 3.11 through 3.14 and NumPy 1.23.2 or newer.
+- Continue reading and writing self-describing format-version-1 archives,
+  including archives created by the published 0.4 package.
+- Continue treating persistence as a trusted-file feature because opaque
+  metadata uses pickle-backed NumPy object arrays.
+- Require no data migration when upgrading from 0.6.
+
+Most applications can upgrade without code changes. Review only code that used
+Boolean row selectors, supplied complex vectors or queries, compared a bound
+`file_path` with a relative path, or relied on a later working-directory change
+to redirect a bound store.
+
+## 0.6.0 - 2026-08-22
 
 This release makes the existing API's input and failure contracts predictable
 before 1.0. It closes cases where the same invalid call could behave

numpy_vector_store-0.7.0/COMPATIBILITY.md

@@ -0,0 +1,145 @@
+# Public API and compatibility policy
+
+NumPy Vector Store 0.7 publishes the contract intended for 1.0 so applications
+can evaluate it before the project makes a long-term stability commitment. The
+package remains pre-1.0 until the 0.7 API has completed a normal release cycle.
+
+This policy separates the small supported interface from implementation details
+that may continue to improve during 1.x.
+
+## Supported public API
+
+Import supported names from the top-level package:
+
+```python
+from numpy_vector_store import VectorHit, VectorStore, __version__
+```
+
+These are the package-level public names declared by `numpy_vector_store.__all__`:
+
+- `VectorStore`, including its constructor, `len(store)`, and the documented
+  methods and properties below.
+- `VectorHit`, including its read-only `index`, `value`, and `metadata` fields.
+- `__version__`, the installed package version as a string.
+
+The supported `VectorStore` surface is:
+
+| Area | Public interface |
+|---|---|
+| Create | `VectorStore(dimensions, *, normalize=True)` |
+| Inspect configuration | `dimensions`, `normalize`, `file_path` |
+| Inspect rows | `vectors`, `metadata`, `len(store)` |
+| Change rows | `add(vectors, metadata)`, `clear()` |
+| Retrieve one row | `get(index)` |
+| Search | `cosine_search(...)`, `dot_search(...)`, `euclidean_search(...)` |
+| Persist | `VectorStore.open(path)`, `save(path)`, `save()`, `reload()` |
+
+The public contract includes documented signatures, accepted input categories,
+return types, public type annotations, state and ownership behavior, search
+ordering, and exception classes. The `VectorStore` generic parameter describes
+its metadata payload type and flows through row retrieval and search results.
+The contract also includes the documented `float32` vector representation and
+format-version-1 archive schema. Exact exception messages are explanatory text,
+not identifiers for application logic.
+
+Importing from `numpy_vector_store.vector_store` may work, but the submodule
+layout is an implementation detail. Applications should use top-level imports.
+Names beginning with a single underscore, private object state, spare-capacity
+layout, and internal calculation steps are not public API.
+
+`VectorStore` is not designed as a subclass extension framework. Subclassing is
+not prohibited, but overriding methods or depending on private helpers and state
+is outside the compatibility promise. Prefer composition when application code
+needs behavior around a store.
+
+## `VectorHit` and opaque metadata
+
+`VectorHit` is an immutable result record. Its fields cannot be reassigned, but
+the `metadata` value remains the same opaque application object held by the
+store. A mutable metadata payload can still be changed through that object.
+
+Equality and hashability follow the values stored in the three fields. There is
+no package-specific metadata comparison or hashing policy. In particular:
+
+- A hit containing a dictionary or another unhashable payload is unhashable.
+- A metadata type with non-Boolean equality, such as a NumPy array, can make
+  whole-hit equality return a non-Boolean value or raise when converted to a
+  truth value.
+- A metadata type with application-defined equality keeps those semantics.
+
+Use `hit.index` or an immutable application identifier inside `hit.metadata`
+when code needs a stable key. Do not assume every possible metadata payload
+makes the complete `VectorHit` suitable for a set, dictionary key, or Boolean
+equality assertion.
+
+## Semantic versioning after 1.0
+
+Starting with 1.0, release numbers follow
+[Semantic Versioning 2.0.0](https://semver.org/) and communicate changes to the
+documented public API:
+
+- Patch releases contain backward-compatible defect fixes, documentation
+  corrections, and internal improvements. A patch may correct behavior that
+  contradicts the documented contract, and the release notes will identify the
+  affected case.
+- Minor releases add backward-compatible functionality and may deprecate public
+  API. They do not remove or incompatibly change documented public API.
+- Major releases may remove deprecated API or make other incompatible public
+  contract changes.
+
+A public API deprecation will appear in the documentation and changelog and
+will emit a warning where a runtime warning is practical. Removal waits for a
+later major release and will have at least one minor release of prior
+deprecation.
+
+Exact error wording, object representations, private names, submodule layout,
+internal algorithms, allocation strategy, benchmark timings, and undocumented
+side effects may change in any release. Changes to these details must still
+preserve the documented results and ownership rules.
+
+## Archive compatibility
+
+Archive format versions are independent of package versions. Format version 1
+is the stable persistence contract for 1.x:
+
+- Every 1.x release will continue reading and writing valid format-version-1
+  archives.
+- A mandatory replacement for format version 1 requires a major package
+  release and a documented migration path.
+- A new archive format may appear during 1.x only as an explicit opt-in while
+  format-version-1 read and write support remains available.
+- An older reader is not expected to understand an arbitrary newer archive
+  format. Compatibility is a newer-reader promise, not a future-format promise
+  for already published code.
+
+Unversioned archives containing only `vectors` and `metadata` remain outside
+this contract because they do not record dimensions or normalization semantics.
+
+Format compatibility does not make every Python metadata object portable.
+Opaque metadata uses pickle-backed NumPy object arrays and may depend on the
+same application classes, import paths, and compatible dependencies being
+available when it is opened. Archives must come from a trusted source. The
+library does not treat untrusted pickle data as safe input.
+
+## Python and NumPy support
+
+The Python versions listed in package metadata are tested in CI. The declared
+minimum NumPy version is tested with the oldest supported Python version.
+
+Support for a Python or NumPy version may be removed in a minor release after
+its relevant upstream support window or ecosystem compatibility makes continued
+testing impractical. Such a change will be made in package metadata and called
+out in the changelog and release notes. Dropping a runtime version does not
+remove callable API from applications running on a supported interpreter.
+
+## Performance expectations
+
+Search results, metric definitions, threshold behavior, deterministic tie
+ordering, and filtered-row semantics are public behavior. The implementation
+may change how it produces those results.
+
+Published benchmark measurements are reference evidence, not latency or memory
+guarantees. Hardware, NumPy, BLAS, process load, vector shape, and metadata all
+affect observed performance. Structural regressions such as repeated full-store
+copies during ordinary ingestion or unnecessary unfiltered search copies remain
+covered by tests rather than fixed wall-clock promises.

{numpy_vector_store-0.6.0 → numpy_vector_store-0.7.0}/MIGRATION.md

@@ -71,10 +71,11 @@ payload objects by reference.
 Row retrieval deliberately treats vectors and metadata differently:
 
 ```python
-vector, payload = store.get(0)
-
-vector[0] = 10.0           # Independent copy; the store is unchanged.
-payload["reviewed"] = True  # Shared application metadata object.
+row = store.get(0)
+if row is not None:
+    vector, payload = row
+    vector[0] = 10.0           # Independent copy; the store is unchanged.
+    payload["reviewed"] = True  # Shared application metadata object.
 ```
 
 Vectors have one uniform NumPy representation, so copying a single row gives
@@ -180,7 +181,11 @@ different semantics.
 Paths may be strings or string-valued `os.PathLike` objects such as
 `pathlib.Path`. Empty paths raise `ValueError`, while bytes and other non-path
 values raise `TypeError`. A `None` path is meaningful only for `save()`, where
-it reuses an existing binding.
+it reuses an existing binding. A relative path is anchored to the current
+working directory when `save(path)` or `open(path)` binds it. The public
+`file_path` is therefore absolute, and later working-directory changes do not
+redirect pathless saves or reloads. Symlinks and `..` components are not
+canonicalized.
 
 The generic parameter still describes application metadata. It can be kept
 when useful:

numpy_vector_store-0.6.0/README.md → numpy_vector_store-0.7.0/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.5
+Name: numpy-vector-store
+Version: 0.7.0
+Summary: A fast, lightweight, and zero-setup in-memory vector store powered by NumPy
+Project-URL: Homepage, https://github.com/tvanreenen/numpy-vector-store
+Project-URL: Repository, https://github.com/tvanreenen/numpy-vector-store
+Project-URL: Issues, https://github.com/tvanreenen/numpy-vector-store/issues
+Author: Tim VanReenen
+License-Expression: MIT
+License-File: LICENSE
+Keywords: embeddings,numpy,search,store,vector
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.23.2
+Description-Content-Type: text/markdown
+
 # NumPy Vector Store
 
 A fast, lightweight, zero-setup in-memory vector store powered by NumPy.
@@ -6,7 +29,8 @@ A fast, lightweight, zero-setup in-memory vector store powered by NumPy.
 - **Fast exact vector search** using vectorized NumPy operations
 - **Simple typed API** returning `VectorHit(index, value, metadata)`
 - **Composable filtering** by passing prefiltered row indexes with `within_rows`
-- **Portable persistence** as versioned, self-describing trusted local `.npz` files
+- **Single-file persistence** as versioned, self-describing trusted local
+  `.npz` archives
 - **No framework opinions**: bring your own embeddings, chunking, async, and metadata model
 
 ## Why?
@@ -76,6 +100,12 @@ complexity checks in CI, but does not fail shared runners on wall-clock timing.
 uv add numpy-vector-store
 ```
 
+With pip:
+
+```bash
+python -m pip install numpy-vector-store
+```
+
 ## Quick Start
 
 ```python
@@ -111,6 +141,10 @@ Each payload can be a dict, dataclass, tuple, list, string, integer row ID, or
 another Python object that fits your application. Tuple and list payloads remain
 single row values rather than being interpreted as additional array dimensions.
 
+The supported top-level package names are `VectorStore`, `VectorHit`, and
+`__version__`. See the [public API and compatibility policy](COMPATIBILITY.md)
+for the complete interface that the project intends to stabilize at 1.0.
+
 ## Scalar inputs and errors
 
 `dimensions`, `top_k`, and the index passed to `get()` use integer semantics.
@@ -127,6 +161,9 @@ rejected.
 
 `within_rows` must be a one-dimensional sequence of unique integer row indexes.
 Python and NumPy integers are accepted; booleans and non-integer values are not.
+When supplied as a Python sequence, this includes a boolean mixed into otherwise
+integer values; NumPy's implicit conversion of that boolean to zero or one is
+not used as a row index.
 Malformed shapes and duplicate indexes raise `ValueError`, while an index
 outside the current store raises `IndexError`. These checks still run when the
 store is empty.
@@ -167,10 +204,11 @@ payload objects stored inside it.
 `get(index)` has a narrower ownership boundary:
 
 ```python
-vector, payload = store.get(0)
-
-vector[0] = 10.0           # Independent copy; the store is unchanged.
-payload["reviewed"] = True  # Shared application metadata object.
+row = store.get(0)
+if row is not None:
+    vector, payload = row
+    vector[0] = 10.0           # Independent copy; the store is unchanged.
+    payload["reviewed"] = True  # Shared application metadata object.
 ```
 
 The returned vector is an independent `float32` copy. The metadata payload is
@@ -221,9 +259,10 @@ rules apply even when the store or `within_rows` selection is empty.
 ### Numerical inputs
 
 Stored vectors use `float32` to keep the store compact. Vectors and queries must
-remain finite when converted to `float32`, and search thresholds must also be
-finite. Invalid values are rejected before they can affect stored state or
-ranking.
+be real-valued array-like inputs that remain finite when converted to `float32`.
+Complex-valued inputs raise `TypeError` rather than silently losing their
+imaginary components. Search thresholds must also be finite. Invalid values are
+rejected before they can affect stored state or ranking.
 
 Norms and raw metric values use `float64` accumulation where `float32`
 intermediate calculations could overflow or underflow. This allows finite
@@ -378,6 +417,12 @@ store.reload()
 the file is missing, or the archive is invalid. A failed reload leaves the
 current in-memory vectors and metadata unchanged.
 
+When `save(path)` or `open(path)` receives a relative path, the store anchors it
+to the current working directory as part of the binding. `file_path` therefore
+returns an absolute path, and a later working-directory change cannot redirect
+`save()` or `reload()` to another file. Anchoring does not canonicalize the path:
+`..` components and symlinks retain their normal filesystem meaning.
+
 The `.npz` suffix may be omitted. An extensionless path such as `"vectors"` is
 resolved to `"vectors.npz"` for saving, opening, and reloading.
 
@@ -435,7 +480,7 @@ writers can still replace one another, and the library does not promise that a
 successful save has reached durable hardware storage across every operating
 system or power failure.
 
-Version 0.6 reads only self-describing format version 1 archives. Unversioned
+Version 0.7 reads only self-describing format version 1 archives. Unversioned
 archives containing only `vectors` and `metadata` cannot be opened because they
 do not record dimensions or normalization semantics. Recreate those archives
 from source data, or convert them with NumPy Vector Store 0.4 before upgrading.
@@ -455,7 +500,12 @@ the API stabilizes. Changes are documented in the [changelog](CHANGELOG.md) and
 GitHub release notes. Deprecated APIs will keep warning for at least one point
 release before removal.
 
-Version 0.6 supports Python 3.11 through 3.14 and NumPy 1.23.2 or newer. These
+Version 0.7 publishes the proposed 1.x contract for an adoption cycle before
+1.0. The [public API and compatibility policy](COMPATIBILITY.md) identifies the
+supported top-level surface, deprecation rules, archive guarantees, runtime
+support policy, and details that remain implementation-specific.
+
+Version 0.7 supports Python 3.11 through 3.14 and NumPy 1.23.2 or newer. These
 versions are listed in the package metadata and exercised in CI, including a
 dedicated check against the minimum NumPy version. Python 3.10 remains supported
 by the 0.3 release series but is not supported by 0.4 or later.
@@ -479,10 +529,11 @@ uv sync --frozen --group dev
 
 Before submitting a pull request:
 
-1. Run `uv run ruff check`
-2. Run `uv run ruff format --check`
-3. Run `uv run mypy src/`
-4. Run `uv run pytest`
+1. Run `uv lock --check`
+2. Run `uv run --locked ruff check .`
+3. Run `uv run --locked ruff format --check .`
+4. Run `uv run --locked mypy src/ benchmarks/ tools/`
+5. Run `uv run --locked pytest`
 
 ## License