hmath-python 1.0.0__tar.gz → 1.0.1__tar.gz

hmath_python-1.0.1/.clang-format

@@ -0,0 +1,4 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 100
+SortIncludes: CaseSensitive

hmath_python-1.0.1/.github/workflows/docs.yml

@@ -0,0 +1,60 @@
+# SPDX-License-Identifier: MPL-2.0
+name: Documentation
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: documentation-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: requirements-docs.txt
+      - uses: haskell-actions/setup@7fd2bb5ca789761088fbc831406b2910e47e56f1 # v2
+        with:
+          ghc-version: '9.10.3'
+          cabal-version: '3.16.1.0'
+      - uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: build-docs/cabal
+          key: docs-haddock-${{ hashFiles('hmath.cabal', 'cabal.project', 'src/**', 'cbits/**') }}
+          restore-keys: docs-haddock-
+      - name: Build documentation and Haskell reference
+        run: |
+          python -m pip install -r requirements-docs.txt
+          python tools/build_docs.py
+      - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        with:
+          path: site
+
+  deploy:
+    if: github.repository == 'wavefnd/hmath' && github.ref == 'refs/heads/master' && github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-24.04
+    concurrency:
+      group: documentation-pages
+      cancel-in-progress: false
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

hmath_python-1.0.1/.github/workflows/publish-python.yml

@@ -0,0 +1,81 @@
+# SPDX-License-Identifier: MPL-2.0
+name: Publish Python and GitHub Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      index:
+        description: Package index
+        type: choice
+        options: [testpypi, pypi]
+        default: testpypi
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-python-${{ inputs.index }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    if: github.repository == 'wavefnd/hmath' && github.ref == 'refs/heads/master'
+    uses: ./.github/workflows/python-wheels.yml
+
+  publish:
+    needs: build
+    runs-on: ubuntu-24.04
+    environment:
+      name: ${{ inputs.index }}
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-distributions
+          path: dist/
+      - name: Publish to TestPyPI
+        if: inputs.index == 'testpypi'
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+      - name: Publish to PyPI
+        if: inputs.index == 'pypi'
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # release/v1
+
+  github-release:
+    if: inputs.index == 'pypi'
+    needs: [build, publish]
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-distributions
+          path: dist/
+      - name: Create the versioned GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_VERSION: ${{ needs.build.outputs.version }}
+          RELEASE_SHA: ${{ github.sha }}
+        run: |
+          tag="v$RELEASE_VERSION"
+          error_log="$RUNNER_TEMP/release-tag-error.log"
+          if ! existing="$(gh api "repos/$GH_REPO/commits/$tag" --jq .sha 2>"$error_log")"; then
+            if ! grep -Eq '\(HTTP (404|422)\)' "$error_log"; then
+              cat "$error_log" >&2
+              exit 1
+            fi
+            existing=""
+          fi
+          if [ -n "$existing" ] && [ "$existing" != "$RELEASE_SHA" ]; then
+            echo "Tag $tag points to another commit; refusing to publish mismatched artifacts."
+            exit 1
+          fi
+          gh release create "$tag" dist/* \
+            --target "$RELEASE_SHA" \
+            --title "HMath $RELEASE_VERSION" \
+            --generate-notes \
+            --latest

hmath_python-1.0.1/.github/workflows/python-wheels.yml

@@ -0,0 +1,73 @@
+# SPDX-License-Identifier: MPL-2.0
+name: Python wheels
+
+on:
+  push:
+    branches: [master]
+    paths-ignore: ['docs/**', 'mkdocs.yml', 'requirements-docs.txt', 'tools/build_docs.py', 'README.md']
+  pull_request:
+    paths-ignore: ['docs/**', 'mkdocs.yml', 'requirements-docs.txt', 'tools/build_docs.py', 'README.md']
+  workflow_call:
+    outputs:
+      version:
+        description: Version read from the built package metadata
+        value: ${{ jobs.build.outputs.version }}
+
+permissions:
+  contents: read
+
+concurrency:
+  group: python-wheels-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name != 'workflow_dispatch' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - name: Read package version
+        id: version
+        run: |
+          python - <<'PY'
+          import os, pathlib, tomllib
+          version = tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version']
+          with open(os.environ['GITHUB_OUTPUT'], 'a') as output:
+              print('version=' + version, file=output)
+          PY
+      - name: Build self-contained manylinux wheel and source distribution
+        run: |
+          docker run --rm --volume "$PWD:/io" \
+            quay.io/pypa/manylinux_2_28_x86_64@sha256:e0adf18521ad35192df733a6c62d35df7801957d24e0470238aacecfab2188a3 \
+            bash /io/tools/build_python_wheel.sh
+          python -m pip install twine
+          python -m twine check --strict dist/*
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: python-distributions
+          path: dist/*
+          if-no-files-found: error
+
+  test:
+    needs: build
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+    container: python:${{ matrix.python }}-slim-bookworm
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-distributions
+          path: /tmp/hmath-distributions
+      - name: Verify installation without GHC or a system HMath library
+        run: |
+          python -m pip install /tmp/hmath-distributions/*.whl
+          cd "$RUNNER_TEMP"
+          python "$GITHUB_WORKSPACE/tools/check_python_wheel.py"
+          python -m pip install numpy cffi
+          python "$GITHUB_WORKSPACE/tools/check_python_wheel.py" "$GITHUB_WORKSPACE/bindings/python/test_bindings.py"
+          python "$GITHUB_WORKSPACE/tools/check_docs_examples.py"

hmath_python-1.0.1/.github/workflows/validate.yml

@@ -0,0 +1,126 @@
+# SPDX-License-Identifier: MPL-2.0
+name: Validate
+
+on:
+  push:
+    branches: [master]
+    paths-ignore: ['docs/**', 'mkdocs.yml', 'requirements-docs.txt', 'tools/build_docs.py', 'README.md']
+  pull_request:
+    paths-ignore: ['docs/**', 'mkdocs.yml', 'requirements-docs.txt', 'tools/build_docs.py', 'README.md']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: validate-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  linux:
+    strategy:
+      fail-fast: false
+      matrix:
+        ghc: ['9.6.7', '9.10.3']
+        buildtype: [debug, release]
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: haskell-actions/setup@7fd2bb5ca789761088fbc831406b2910e47e56f1 # v2
+        id: haskell
+        with:
+          ghc-version: ${{ matrix.ghc }}
+          cabal-version: '3.16.1.0'
+      - uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: |
+            ~/.cabal/packages
+            ${{ steps.haskell.outputs.cabal-store }}
+            dist-newstyle
+            build-ci/cabal
+            build-interchange/cabal
+          key: cabal-${{ runner.os }}-${{ matrix.ghc }}-${{ matrix.buildtype }}-${{ hashFiles('hmath.cabal', 'cabal.project', 'src/**', 'cbits/**', 'test/**', 'bench/**') }}
+          restore-keys: cabal-${{ runner.os }}-${{ matrix.ghc }}-${{ matrix.buildtype }}-
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - name: Dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y liblapacke-dev libopenblas-dev zlib1g-dev cmake ninja-build clang
+          python -m pip install meson==1.8.5 numpy cffi
+      - name: Differential validation dependencies
+        if: matrix.ghc == '9.10.3' && matrix.buildtype == 'release'
+        run: |
+          python -m pip install scipy h5py pyarrow onnx
+          cabal update
+      - name: Wave compiler
+        if: matrix.ghc == '9.10.3' && matrix.buildtype == 'release'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p "$RUNNER_TEMP/wave"
+          gh release download v0.2.1-pre-beta --repo wavefnd/Wave --pattern wave-v0.2.1-pre-beta-x86_64-linux-gnu.tar.gz --dir "$RUNNER_TEMP/wave"
+          cd "$RUNNER_TEMP/wave"
+          echo '4e5daf46a93414e00b8ea073eda09e4b7aa7d248cc03f2aeb965a36fc9b0fef0  wave-v0.2.1-pre-beta-x86_64-linux-gnu.tar.gz' | sha256sum --check
+          tar -xzf wave-v0.2.1-pre-beta-x86_64-linux-gnu.tar.gz
+          test -n "$(find "$RUNNER_TEMP/wave" -type f -name wavec -print -quit)"
+          find "$RUNNER_TEMP/wave" -type f -name wavec -printf '%h\n' >> "$GITHUB_PATH"
+      - name: Build and integration tests
+        run: |
+          wave_tests=auto
+          if [ '${{ matrix.ghc }}' = '9.10.3' ] && [ '${{ matrix.buildtype }}' = release ]; then
+            wave_tests=enabled
+          fi
+          meson setup build-ci --buildtype=${{ matrix.buildtype }} -Doffline=true -Dwerror=true -Dpython_bindings=enabled -Dwave_bindings="$wave_tests" -Dbenchmarks=true
+          meson compile -C build-ci
+          meson test -C build-ci --print-errorlogs
+          python tools/check_install.py build-ci
+          python tools/check_abi.py build-ci/libhmath.so
+      - name: Properties and interchange
+        if: matrix.ghc == '9.10.3' && matrix.buildtype == 'release'
+        run: |
+          cabal test hmath-properties -fvalidation-frameworks -fcriterion-benchmarks --test-show-details=direct
+          python tools/check_interchange.py --builddir=build-interchange --require-optional
+      - name: Sanitized metadata and DLPack fuzzing
+        if: matrix.ghc == '9.10.3' && matrix.buildtype == 'release'
+        run: python tools/run_fuzz.py --runs=100000 --output=build-ci/fuzz.log
+      - name: Criterion fixture and native benchmark smoke
+        if: matrix.ghc == '9.10.3' && matrix.buildtype == 'release'
+        run: |
+          cabal bench hmath-criterion -fvalidation-frameworks -fcriterion-benchmarks --benchmark-options='--iters 1'
+          python tools/benchmark.py --library=build-ci/libhmath.so --native=build-ci/hmath-native-benchmark --iterations=10 --output=build-ci/benchmark.json
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        if: always()
+        with:
+          name: validation-${{ matrix.ghc }}-${{ matrix.buildtype }}
+          path: |
+            build-ci/meson-logs/
+            build-ci/hmath-build.json
+            build-ci/fuzz.log
+            build-ci/benchmark.*
+
+  portability-build:
+    # Build probes do not establish full native platform support.
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-15, windows-2022]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: haskell-actions/setup@7fd2bb5ca789761088fbc831406b2910e47e56f1 # v2
+        id: haskell
+        with:
+          ghc-version: '9.10.3'
+          cabal-version: '3.16.1.0'
+      - uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4
+        with:
+          path: |
+            ${{ steps.haskell.outputs.cabal-store }}
+            dist-newstyle
+          key: cabal-portability-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('hmath.cabal', 'cabal.project', 'src/**', 'cbits/**') }}
+          restore-keys: cabal-portability-${{ runner.os }}-${{ runner.arch }}-
+      - run: cabal build --offline lib:hmath flib:hmath -f-interchange-zlib --ghc-options="-Wall -Werror"

hmath_python-1.0.1/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 1.0.1
+
+- Bundle the native HMath library and required runtime dependencies in the Linux x86-64 Python wheel, fixing import failures after a normal pip installation.
+- Validate the same release wheel in clean CPython 3.9–3.14 environments without a system HMath library, GHC, or native-library environment overrides.
+- Add a searchable documentation site with installation, guides, language references, and generated Haskell API documentation.
+- Cache Haskell builds and dependencies; run differential validation once rather than repeating it across the compiler/build-type matrix.
+
+## 1.0.0
+
+- Add checked native tensors, ownership and cancellation contracts, and CPU DLPack exchange.
+- Establish C, Python, and Wave as the officially maintained external interfaces.
+- Add configurable BLAS/LAPACK providers and pure reference operations.
+- Add Haskell shape, algebra, buffer, and convergence interfaces and typed array interchange.
+- Add integrated validation, benchmarks, native installation checks, and build metadata.
+
+The first release covers the implemented Haskell numerical modules and the
+C, Python, and Wave interfaces on Linux x86-64. Python distributions in 1.0.0
+contain only bindings and require a separately installed HMath shared library.
+Upgrade to 1.0.1 or newer for a self-contained Linux x86-64 Python wheel.
+
+Package versions follow SemVer: compatible fixes increment the patch, compatible
+features increment the minor, and breaking public API changes increment the major.
+C ABI epoch 1 is reported independently and identifies the calling and ownership
+conventions. Existing legacy C symbols remain available. GPU execution,
+distributed computation, additional platforms, and unchecked goals in the roadmap
+remain future development; they are not prerequisites for this release.

hmath_python-1.0.1/MANIFEST.in

@@ -0,0 +1,15 @@
+include LICENSE README.md CHANGELOG.md ROADMAP.md hmath.cabal cabal.project meson-build.py
+include meson.build meson_options.txt mkdocs.yml requirements-docs.txt fourmolu.yaml .clang-format
+recursive-include src *.hs
+recursive-include cbits *.c *.h
+recursive-include include *.h
+recursive-include bindings/python/_hmath_native/licenses *
+recursive-include bindings/python *.py LICENSE
+recursive-include bindings/wave *.wave
+recursive-include docs *.md
+recursive-include tools *.py *.sh
+recursive-include test *.hs *.c *.py *.txt
+recursive-include examples *.hs *.c *.py
+recursive-include bench *.hs *.c
+recursive-include meson *.in
+recursive-include .github/workflows *.yml

{hmath_python-1.0.0 → hmath_python-1.0.1}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: hmath-python
-Version: 1.0.0
+Version: 1.0.1
 Summary: Python bindings for the Haskell HMath numerical library
 License-Expression: MPL-2.0
 Project-URL: Homepage, https://github.com/wavefnd/hmath
 Project-URL: Source, https://github.com/wavefnd/hmath
 Project-URL: Issues, https://github.com/wavefnd/hmath/issues
+Project-URL: Documentation, https://wavefnd.github.io/hmath/
 Keywords: mathematics,haskell,ffi,tensor
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Operating System :: POSIX :: Linux
@@ -24,14 +25,14 @@ Dynamic: license-file
 
 HMath is a mathematics and numerical computing library with Python bindings, written in Haskell. It also provides native Haskell, C, and Wave interfaces.
 
-The 1.0.0 release targets Linux x86-64. The Python distribution is named **hmath-python** and is imported as `hmath`.
+HMath targets Linux x86-64. The Python distribution is named **hmath-python** and is imported as `hmath`. Version 1.0.1 includes the native library and runtime; GHC is not needed to use its Python wheel.
 
 ## Python quick start
 
 Install the Python package on Linux x86-64:
 
 ```sh
-pip install hmath-python
+python -m pip install --upgrade --only-binary=:all: "hmath-python>=1.0.1"
 ```
 
 ```python
@@ -46,6 +47,8 @@ with Tensor.matrix([1, 2, 3, 4], 2, 2) as matrix:
 
 Use `with` to release native resources automatically. Invalid operations raise `HMathError`. Install `hmath-python[numpy,cffi]` for optional NumPy and cffi support.
 
+See the [documentation](https://wavefnd.github.io/hmath/) for installation requirements, tutorials, API reference, and C/Wave integration.
+
 ## Features
 
 - **Core math:** checked scalar operations, numeric types, constants, units, number theory, and polynomials.

{hmath_python-1.0.0 → hmath_python-1.0.1}/README.md

@@ -2,14 +2,14 @@
 
 HMath is a mathematics and numerical computing library with Python bindings, written in Haskell. It also provides native Haskell, C, and Wave interfaces.
 
-The 1.0.0 release targets Linux x86-64. The Python distribution is named **hmath-python** and is imported as `hmath`.
+HMath targets Linux x86-64. The Python distribution is named **hmath-python** and is imported as `hmath`. Version 1.0.1 includes the native library and runtime; GHC is not needed to use its Python wheel.
 
 ## Python quick start
 
 Install the Python package on Linux x86-64:
 
 ```sh
-pip install hmath-python
+python -m pip install --upgrade --only-binary=:all: "hmath-python>=1.0.1"
 ```
 
 ```python
@@ -24,6 +24,8 @@ with Tensor.matrix([1, 2, 3, 4], 2, 2) as matrix:
 
 Use `with` to release native resources automatically. Invalid operations raise `HMathError`. Install `hmath-python[numpy,cffi]` for optional NumPy and cffi support.
 
+See the [documentation](https://wavefnd.github.io/hmath/) for installation requirements, tutorials, API reference, and C/Wave integration.
+
 ## Features
 
 - **Core math:** checked scalar operations, numeric types, constants, units, number theory, and polynomials.

hmath_python-1.0.1/ROADMAP.md

@@ -0,0 +1,96 @@
+# HMath development roadmap
+
+[Roadmap issue](https://github.com/wavefnd/hmath/issues/1) · [Planning milestone](https://github.com/wavefnd/hmath/milestone/1)
+
+## Status and scope
+
+HMath is preparing its first 1.0.0 release. This roadmap preserves the complete maintainer-provided development checklist: **47 functional areas and 944 individual requirements**. Each area links to an English tracking issue containing its checklist, historical baseline, and completion criteria.
+
+The agreed 1.0.0 scope is the implemented Haskell numerical modules and the C ABI 1, Python, and Wave interfaces on **Linux x86-64**. It includes the reference CPU implementations, tested optional OpenBLAS/LAPACKE integration, numerical interchange, and local build/install validation. GPU execution, explicit SIMD acceleration, distributed execution, additional platforms, and other unfinished checklist goals remain later work. The original checklist is a long-term backlog, not a promise that every item ships in 1.0.0.
+
+Official external language support is limited to **C, Python, and Wave**. Haskell remains the implementation and native API. The counts below preserve the original checklist; the earlier requests for other maintained bindings are superseded by this scope decision in [#45](https://github.com/wavefnd/hmath/issues/45).
+
+## Suggested work order
+
+1. Correct the confirmed matrix, RTS lifecycle, and FFI test defects below.
+2. Agree numerical types and precision, shapes and layouts, error handling, ownership, threading, and API/ABI contracts.
+3. Harden scalar, vector, matrix, and statistics foundations together with meaningful Haskell/C/Python regression tests.
+4. Add selected numerical algorithms, arrays, interoperability, and language bindings in reviewable increments.
+5. Add optional acceleration and advanced domains after their reference behavior and tests exist.
+6. Validate the agreed first-release scope and publish 1.0.0 after review. Continue with compatible fixes in 1.0.x, compatible features in 1.x, and breaking public API changes in 2.0.0 or later.
+
+## Prototype correctness work
+
+- [#2](https://github.com/wavefnd/hmath/issues/2) — Preserve matrix shape and values across zero-dimension operations
+- [#3](https://github.com/wavefnd/hmath/issues/3) — Reject unsupported GHC RTS reinitialization without terminating the host
+- [#4](https://github.com/wavefnd/hmath/issues/4) — Make C and Python FFI tests fail on incorrect numerical results
+
+These are focused starting tasks. They do not replace the broader functional-area requirements.
+
+## Complete feature backlog
+
+| Area | Development goal | Requirements | Priority | Issue |
+| --- | --- | ---: | --- | --- |
+| 1 | Implement core arithmetic, elementary functions, and scalar numerical utilities | 40 | high | [#5](https://github.com/wavefnd/hmath/issues/5) |
+| 2 | Provide mathematical constants, unit conversions, and dimensional safety | 16 | medium | [#6](https://github.com/wavefnd/hmath/issues/6) |
+| 3 | Define numerical types, precision controls, and floating-point semantics | 18 | high | [#7](https://github.com/wavefnd/hmath/issues/7) |
+| 4 | Implement trigonometric, hyperbolic, and angular operations | 12 | medium | [#8](https://github.com/wavefnd/hmath/issues/8) |
+| 5 | Implement number-theoretic algorithms and arithmetic functions | 21 | medium | [#9](https://github.com/wavefnd/hmath/issues/9) |
+| 6 | Implement polynomial operations and algebraic abstractions | 16 | medium | [#10](https://github.com/wavefnd/hmath/issues/10) |
+| 7 | Extend vector and matrix operations with explicit shape contracts | 22 | high | [#11](https://github.com/wavefnd/hmath/issues/11) |
+| 8 | Implement matrix factorizations and linear-system solvers | 20 | medium | [#12](https://github.com/wavefnd/hmath/issues/12) |
+| 9 | Implement sparse matrix representations and numerical operations | 12 | medium | [#13](https://github.com/wavefnd/hmath/issues/13) |
+| 10 | Implement tensors and multidimensional array semantics | 25 | high | [#14](https://github.com/wavefnd/hmath/issues/14) |
+| 11 | Implement numerical differentiation and integration | 19 | medium | [#15](https://github.com/wavefnd/hmath/issues/15) |
+| 12 | Implement ODE solvers and dynamical-system analysis | 15 | medium | [#16](https://github.com/wavefnd/hmath/issues/16) |
+| 13 | Implement PDE grids, discretization operators, and solvers | 13 | low | [#17](https://github.com/wavefnd/hmath/issues/17) |
+| 14 | Implement automatic differentiation and differentiable operations | 18 | medium | [#18](https://github.com/wavefnd/hmath/issues/18) |
+| 15 | Implement local, constrained, and global optimization algorithms | 24 | medium | [#19](https://github.com/wavefnd/hmath/issues/19) |
+| 16 | Implement scalar and multivariate root-finding algorithms | 11 | medium | [#20](https://github.com/wavefnd/hmath/issues/20) |
+| 17 | Expand descriptive statistics and statistical inference | 27 | medium | [#21](https://github.com/wavefnd/hmath/issues/21) |
+| 18 | Add probability distributions and probabilistic inference | 22 | medium | [#22](https://github.com/wavefnd/hmath/issues/22) |
+| 19 | Implement reproducible random number generation and sampling | 19 | medium | [#23](https://github.com/wavefnd/hmath/issues/23) |
+| 20 | Build deep learning numerical primitives | 28 | low | [#24](https://github.com/wavefnd/hmath/issues/24) |
+| 21 | Implement machine learning estimators and preprocessing | 23 | low | [#25](https://github.com/wavefnd/hmath/issues/25) |
+| 22 | Add Fourier transforms and spectral analysis | 18 | medium | [#26](https://github.com/wavefnd/hmath/issues/26) |
+| 23 | Implement digital signal processing and wavelets | 22 | medium | [#27](https://github.com/wavefnd/hmath/issues/27) |
+| 24 | Develop interpolation, approximation, and curve APIs | 18 | medium | [#28](https://github.com/wavefnd/hmath/issues/28) |
+| 25 | Implement special functions with numerical error contracts | 25 | medium | [#29](https://github.com/wavefnd/hmath/issues/29) |
+| 26 | Add complex arithmetic, quaternions, and rotation groups | 15 | medium | [#30](https://github.com/wavefnd/hmath/issues/30) |
+| 27 | Create computational geometry and spatial query APIs | 27 | low | [#31](https://github.com/wavefnd/hmath/issues/31) |
+| 28 | Implement combinatorics and discrete mathematics | 22 | medium | [#32](https://github.com/wavefnd/hmath/issues/32) |
+| 29 | Implement graph representations and algorithms | 26 | low | [#33](https://github.com/wavefnd/hmath/issues/33) |
+| 30 | Build symbolic expression manipulation and evaluation | 25 | low | [#34](https://github.com/wavefnd/hmath/issues/34) |
+| 31 | Implement time series analysis and forecasting | 19 | low | [#35](https://github.com/wavefnd/hmath/issues/35) |
+| 32 | Implement numerical image processing operations | 20 | low | [#36](https://github.com/wavefnd/hmath/issues/36) |
+| 33 | Implement numerical algorithms and data structures | 21 | medium | [#37](https://github.com/wavefnd/hmath/issues/37) |
+| 34 | Implement a bounded numerical expression evaluator | 14 | medium | [#38](https://github.com/wavefnd/hmath/issues/38) |
+| 35 | Add CPU backends and hardware-aware numerical optimization | 18 | low | [#39](https://github.com/wavefnd/hmath/issues/39) |
+| 36 | Integrate configurable BLAS and LAPACK backends | 15 | low | [#40](https://github.com/wavefnd/hmath/issues/40) |
+| 37 | Implement GPU numerical backends and device execution | 19 | low | [#41](https://github.com/wavefnd/hmath/issues/41) |
+| 38 | Implement parallel, streaming, and distributed numerical execution | 15 | low | [#42](https://github.com/wavefnd/hmath/issues/42) |
+| 39 | Define and harden the Haskell API and numerical type contracts | 19 | high | [#43](https://github.com/wavefnd/hmath/issues/43) |
+| 40 | Specify and harden the native C ABI and FFI lifecycle | 21 | high | [#44](https://github.com/wavefnd/hmath/issues/44) |
+| 41 | Provide language bindings with consistent errors and resource cleanup | 19 | medium | [#45](https://github.com/wavefnd/hmath/issues/45) |
+| 42 | Add versioned numerical serialization and array interchange | 16 | medium | [#46](https://github.com/wavefnd/hmath/issues/46) |
+| 43 | Harden builds, packaging, installation, and release artifacts | 28 | high | [#47](https://github.com/wavefnd/hmath/issues/47) |
+| 44 | Establish numerical, FFI, and cross-platform validation | 25 | high | [#48](https://github.com/wavefnd/hmath/issues/48) |
+| 45 | Build reproducible numerical and interoperability benchmarks | 16 | medium | [#49](https://github.com/wavefnd/hmath/issues/49) |
+| 46 | Document numerical contracts, native integration, and practical examples | 19 | medium | [#50](https://github.com/wavefnd/hmath/issues/50) |
+| 47 | Define and satisfy the HMath 1.0.0 release gates | 21 | high | [#51](https://github.com/wavefnd/hmath/issues/51) |
+
+## Working through the backlog
+
+Choose a bounded implementation task from a tracking issue and link any smaller issue or pull request back to it. Define input domains, numerical accuracy, errors, shapes, ownership, and relevant tests before treating that task as complete. Reuse shared primitives across overlapping areas such as FFTs, spatial indexes, Kalman filters, and combinatorics.
+
+Close a feature tracking issue only when its agreed scope and completion criteria are satisfied. Record any explicitly deferred goal rather than silently dropping it. API/ABI freeze and release publication remain future work under [the release-gate issue](https://github.com/wavefnd/hmath/issues/51).
+
+## Reference documentation
+
+- [NumPy routines](https://numpy.org/doc/stable/reference/routines.html)
+- [SciPy API reference](https://docs.scipy.org/doc/scipy/reference/index.html)
+- [GNU Scientific Library manual](https://www.gnu.org/software/gsl/doc/html/)
+- [PyTorch documentation](https://docs.pytorch.org/docs/stable/index.html)
+
+These are the source checklist's reference links, not additional runtime dependencies.
+