[doc-only] Prepare for cuda-pathfinder v1.4.1 release (#1728)

* Add Linux support for loading libcupti.so.12 and libcupti.so.13

This commit adds support for finding and loading CUPTI libraries on Linux
through cuda.pathfinder. It implements support for all enumerated installation
methods:

- Site-packages: nvidia/cuda_cupti/lib (CUDA 12) and nvidia/cu13/lib (CUDA 13)
- Conda: $CONDA_PREFIX/lib (colocated with other CUDA libraries)
- CTK via CUDA_HOME: $CUDA_HOME/extras/CUPTI/lib64
- CTK via canary probe: system CTK root discovery (similar to nvvm)

Changes:
- Add 'cupti' to supported library names and SONAMEs
- Add site-packages paths for CUDA 12 and 13
- Add cupti to CTK root canary discoverable libraries
- Update find_nvidia_dynamic_lib to handle extras/CUPTI/lib64 path
- Add logic to distinguish CTK (extras/CUPTI/lib64) vs conda (lib) paths
- Update _find_so_using_lib_dir to support versioned libraries via glob
- Add comprehensive mock tests covering all installation methods

Fixes #1572 (Linux support)

Made-with: Cursor

* Update cupti tests to use new SearchContext-based API

Migrated test_load_nvidia_dynamic_lib_using_mocker.py from the old
_FindNvidiaDynamicLib API to the new descriptor-based SearchContext API.

Changes:
- Replace _FindNvidiaDynamicLib imports with search_steps and load_nvidia_dynamic_lib modules
- Update mocks to use run_find_steps, LOADER, and SearchContext
- Use LIB_DESCRIPTORS to get cupti descriptor
- Update all test functions to work with the new search step architecture

Made-with: Cursor

* Remove unused CTK canary variables from supported_nvidia_libs.py

These variables (_CTK_ROOT_CANARY_ANCHOR_LIBNAMES and
_CTK_ROOT_CANARY_DISCOVERABLE_LIBNAMES) were added in the cupti PR but
are not used in the new descriptor-based architecture. The new code
uses desc.ctk_root_canary_anchor_libnames directly from descriptors.

Made-with: Cursor

* Improve comment for change in LinuxSearchPlatform.find_in_lib_dir()

* Add cputi to cu12, cu13 groups in cuda_pathfinder/pyproject.toml

* Add cuda_cupti to cuda-components in .github/actions/fetch_ctk/action.yml

* Add windows_dlls, site_packages_windows, anchor_rel_dirs_windows for cupti in /descriptor_catalog.py

* test: Refactor cupti mock tests to focus on Conda and error paths

Remove tests covered by real CI:
- Site-packages tests (CUDA 12 and 13) - covered by real CI
- CTK tests (CUDA_HOME and canary probe) - covered by real CI
- Search order tests involving site-packages/CTK - covered by real CI

Keep tests not covered by real CI:
- Conda discovery test - Conda not covered by real CI
- Error path test (not found) - error path not covered
- Conda vs CTK search order test - Conda not covered by real CI

Also remove unused imports and helper functions.

Made-with: Cursor

* Add pathfinder release/1.4.1-notes.rst

* Add PR #1731 to release/1.4.1-notes.rst

Author: rwgk

cuda_pathfinder/docs/nv-versions.json

@@ -3,6 +3,10 @@
         "version": "latest",
         "url": "https://nvidia.github.io/cuda-python/cuda-pathfinder/latest/"
     },
+    {
+        "version": "1.4.1",
+        "url": "https://nvidia.github.io/cuda-python/cuda-pathfinder/1.4.1/"
+    },
     {
         "version": "1.4.0",
         "url": "https://nvidia.github.io/cuda-python/cuda-pathfinder/1.4.0/"

cuda_pathfinder/docs/source/release/1.4.1-notes.rst

@@ -0,0 +1,49 @@
+.. SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+.. SPDX-License-Identifier: Apache-2.0
+
+.. py:currentmodule:: cuda.pathfinder
+
+``cuda-pathfinder`` 1.4.1 Release notes
+=======================================
+
+Released on Mar 6, 2026
+
+Highlights
+----------
+
+* Add CTK canary fallback for header discovery. When CUDA headers cannot be
+  found via site-packages, Conda, or ``CUDA_HOME``/``CUDA_PATH``, the system
+  now attempts to discover the CTK root via canary probing (using a
+  system-loaded ``cudart`` library path) and searches the CTK include layout
+  from that root. This improves header discovery in standard and non-standard
+  CTK installations, including containerized environments.
+  (`PR #1731 <https://github.com/NVIDIA/cuda-python/pull/1731>`_)
+
+* Add support for loading CUPTI (CUDA Profiling Tools Interface) dynamic libs
+  via ``load_nvidia_dynamic_lib("cupti")`` on Linux and Windows. CUPTI libraries
+  are discovered in site-packages (CUDA 12 and 13), Conda environments, and
+  CTK installations (via CUDA_HOME/CUDA_PATH or canary probe).
+  Supports ``libcupti.so.12``, ``libcupti.so.13`` on Linux and versioned
+  ``cupti64_*.dll`` files on Windows.
+  (`PR #1693 <https://github.com/NVIDIA/cuda-python/pull/1693>`_)
+
+* Add support for finding static libraries (e.g., ``libcudadevrt.a`` on Linux,
+  ``cudadevrt.lib`` on Windows) via new ``find_static_lib()`` and
+  ``locate_static_lib()`` APIs. These follow the same search order as bitcode
+  libraries: site-packages, Conda, then CUDA_HOME/CUDA_PATH.
+  (`PR #1690 <https://github.com/NVIDIA/cuda-python/pull/1690>`_)
+
+* Fix site-packages search order for virtual environments created with
+  ``--system-site-packages``. The search now correctly prioritizes the venv's
+  site-packages before user-site-packages, conforming to PEP 405.
+  (`PR #1717 <https://github.com/NVIDIA/cuda-python/pull/1717>`_)
+
+Internal refactoring
+--------------------
+
+* Refactor library discovery and loading to use a descriptor-driven architecture.
+  All library metadata (SONAMEs, DLLs, site-packages paths, dependencies, loader
+  flags) is now consolidated into a single ``LibDescriptor`` registry, improving
+  maintainability and extensibility. This is an internal refactoring with no
+  behavioral changes.
+  (`PR #1685 <https://github.com/NVIDIA/cuda-python/pull/1685>`_)