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

numpy_vector_store-0.7.1/.github/actionlint.yaml

@@ -0,0 +1,4 @@
+# Blacksmith uses ephemeral runners registered through GitHub's self-hosted API.
+self-hosted-runner:
+  labels:
+    - blacksmith-4vcpu-ubuntu-2404

numpy_vector_store-0.7.1/.github/workflows/checks.yml

@@ -0,0 +1,233 @@
+name: Checks
+
+on:
+  workflow_call:
+    inputs:
+      release-tag:
+        description: Optional v-prefixed tag that must match the distributions
+        required: false
+        type: string
+        default: ""
+    outputs:
+      distributions-artifact-id:
+        description: Artifact ID for the verified wheel and source distribution
+        value: ${{ jobs.distributions.outputs.artifact-id }}
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: checks-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Lint, format, and type-check
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 10
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.7"
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install project dependencies
+        run: uv sync --locked --group dev
+
+      - name: Run Ruff lint checks
+        run: uv run --locked ruff check .
+
+      - name: Check Ruff formatting
+        run: uv run --locked ruff format --check .
+
+      - name: Run mypy
+        run: uv run --locked mypy src/ benchmarks/ tools/
+
+  tests:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.7"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install project dependencies
+        run: uv sync --locked --group dev
+
+      - name: Run tests
+        run: uv run --locked pytest
+
+  windows:
+    name: Test Windows on Python 3.13
+    runs-on: windows-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.7"
+          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: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.7"
+          python-version: "3.11"
+          enable-cache: true
+
+      - name: Run tests with the minimum NumPy version
+        run: >-
+          uv run
+          --isolated
+          --no-project
+          --python 3.11
+          --with-editable .
+          --with numpy==1.23.2
+          --with pytest==8.4.2
+          python -m pytest
+
+  distributions:
+    name: Build and test distributions
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
+    outputs:
+      artifact-id: ${{ steps.upload.outputs.artifact-id }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.11"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.7"
+          python-version: "3.11"
+          enable-cache: true
+
+      - name: Build wheel and source distribution
+        run: uv build --out-dir dist
+
+      - name: Verify release versions
+        env:
+          RELEASE_TAG: ${{ inputs.release-tag }}
+        run: |
+          if [[ -n "$RELEASE_TAG" ]]; then
+            uv run --locked python tools/verify_release_version.py --tag "$RELEASE_TAG"
+          else
+            uv run --locked python tools/verify_release_version.py
+          fi
+
+      - name: Check distribution metadata
+        run: uvx --from twine==7.0.0 twine check --strict dist/*
+
+      - name: Test installed wheel
+        run: >-
+          uv run
+          --isolated
+          --no-project
+          --python 3.11
+          --with ./dist/*.whl
+          python tools/verify_installed_distribution.py
+
+      - name: Test installed source distribution
+        run: >-
+          uv run
+          --isolated
+          --no-project
+          --python 3.11
+          --with ./dist/*.tar.gz
+          python tools/verify_installed_distribution.py
+
+      - name: Upload verified distributions
+        id: upload
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: python-package-distributions-${{ github.run_id }}-${{ github.run_attempt }}
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 7
+          compression-level: 0

numpy_vector_store-0.7.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+concurrency:
+  group: publish-pypi
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Validate release
+    uses: ./.github/workflows/checks.yml
+    with:
+      release-tag: ${{ github.event.release.tag_name }}
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: validate
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/p/numpy-vector-store
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          artifact-ids: ${{ needs.validate.outputs.distributions-artifact-id }}
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1
+        with:
+          packages-dir: dist/

numpy_vector_store-0.7.1/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,40 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: publish-testpypi
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Validate release candidate
+    uses: ./.github/workflows/checks.yml
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: validate
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/numpy-vector-store
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          artifact-ids: ${{ needs.validate.outputs.distributions-artifact-id }}
+          path: dist
+
+      - name: Publish package distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1
+        with:
+          packages-dir: dist/
+          repository-url: https://test.pypi.org/legacy/

{numpy_vector_store-0.7.0 → numpy_vector_store-0.7.1}/.gitignore

@@ -153,6 +153,8 @@ venv.bak/
 
 # mkdocs documentation
 /site
+/.venv-docs/
+/.cache/zensical/
 
 # mypy
 .mypy_cache/

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

@@ -1,8 +1,96 @@
+<!-- --8<-- [start:introduction] -->
+
 # Changelog
 
 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).
+[GitHub releases page](https://github.com/tvr-works/numpy-vector-store/releases).
+
+<!-- --8<-- [end:introduction] -->
+
+## 0.7.1 - 2026-11-13
+
+This patch release corrects two search edge cases without changing the public
+API, runtime requirements, or archive format. It also includes the documentation,
+package-presentation, and release-workflow improvements merged since 0.7.0.
+
+Most applications can upgrade without code changes or data migration. The
+observable corrections are that very small normalized Euclidean distances no
+longer collapse to zero, and valid row filters containing different integer
+types are accepted.
+
+### Search correctness
+
+- Accumulate normalized Euclidean squared differences in `float64` before
+  taking their square root. Previously, a small difference could be represented
+  in `float32` while its square was too small to represent, making a nonzero
+  distance appear to be zero.
+- Preserve nearest-row ordering, `top_k` selection, and zero-distance threshold
+  filtering for these cases, both with and without `within_rows`. Vector
+  storage remains `float32`; raw Euclidean, cosine, and dot-product calculation
+  paths are unchanged.
+- Accept mixed Python and NumPy integer row filters such as
+  `[0, np.uint64(1)]`. NumPy can infer a floating-point array for mixed signed
+  and unsigned integers; validation now retains the original values when that
+  conversion would erase their integer types.
+- Keep bulk validation for ordinary integer lists, tuples, and ranges, and
+  preserve the native NumPy integer-array fast path. Custom integer-index
+  objects continue to use the existing per-element validation fallback.
+- Continue rejecting booleans, floating-point indexes, malformed shapes,
+  duplicate rows, and out-of-range indexes. Validation remains independent of
+  whether the store is empty.
+
+### Documentation and package presentation
+
+- Add the searchable [documentation website](https://vectors.tvr.works/) with
+  getting-started, search/filtering, persistence, ownership, deployment,
+  performance, API-reference, and compatibility guidance.
+- Clarify the README's small-to-medium, in-process search positioning. Explain
+  deployment with an archive shipped alongside application code, where each
+  worker or replica loads its own in-memory store without a separate vector
+  database or shared-write coordination.
+- Update package project links to the existing repository's new
+  `tvr-works/numpy-vector-store` location and add the documentation URL.
+  Distribution and import names remain `numpy-vector-store` and
+  `numpy_vector_store`.
+- Keep documentation source, generated output, build tools, and the independent
+  docs environment out of the source distribution. Wheels remain package-only;
+  documentation tools add no runtime dependency.
+- Build the public reference and executable guide examples against an exact,
+  verified published wheel in a separate locked environment. Development
+  changes and release preparation no longer replace the released API reference.
+  Prepared changelog entries stay out of the public site until its edition is
+  advanced after publication.
+
+### Release validation and publishing
+
+- Build distributions once in the validation workflow, check their versions and
+  metadata, and smoke-test clean wheel and source-distribution installations.
+  The publishing job downloads that verified artifact by its immutable ID
+  rather than rebuilding it with publishing credentials available.
+- Pin the Hatchling build backend and publishing/validation tool revisions.
+  Retain the supported Python matrix, Windows coverage, and minimum-NumPy check.
+- Configure environment-bound Trusted Publishers for the organization-owned
+  repository and document post-upload provenance and installation checks.
+  Production cutover is confirmed only after an authorized upload passes those
+  checks; the new configuration is not treated as verified merely because it
+  is present.
+- Add independent documentation CI that checks the built site and runs rendered
+  examples. Pages publication requires successful docs CI for the exact source
+  commit, and branch previews are marked not to be indexed.
+
+### Upgrade notes
+
+- Continue supporting Python 3.11 through 3.14 and NumPy 1.23.2 or newer.
+- Keep the existing methods, arguments, result types, and input-error categories.
+- Continue reading and writing trusted format-version-1 archives without
+  conversion. Opaque metadata still uses pickle-backed object arrays; do not
+  open untrusted archives.
+- No new feature family, API removal, runtime dependency, or archive migration
+  is introduced. These are corrections within the existing 0.7 contract, not
+  the separate 1.0 stability declaration.
+
+<!-- --8<-- [start:published] -->
 
 ## 0.7.0 - 2026-08-24
 
@@ -540,3 +628,5 @@ intentionally break valid existing usage or change the `.npz` archive format.
 - Environments using NumPy 1.20 must upgrade to NumPy 1.21.3 or newer.
 - Inputs that previously produced `nan`, `inf`, or unreliable rankings now
   raise `ValueError` instead.
+
+<!-- --8<-- [end:published] -->