build(windows): package and validate PyPI wheels

[IvanaGyro]

Stack

master → #1110 → codex/windows-msvc-cuda-stack (#1116 patch) → #1117 → #1118 → #1119 → #1113

Depends on #1117 and contains the Windows wheel packaging/runtime layer. Runtime dependency metadata is isolated in #1119; workflow invocation is isolated in #1113.

Summary

• add locked OpenBLAS wheel-cpu and wheel-cuda environments;
• install the pybind11 MODULE target through CMake's portable LIBRARY artifact rule into the relocatable cytnx package;
• locate CUDA/cuTENSOR DLLs from the exact installed PyPI distributions with os.add_dll_directory, since Windows has no ELF-style RUNPATH;
• bundle non-CUDA dependencies with delvewheel while keeping CUDA/cuTENSOR in their declared PyPI packages;
• validate clean installed CPU/CUDA wheels;
• use repository-compliant snake_case helper names without leading underscores.

Released users do not need CUDA_PATH, CUTENSOR_ROOT, CUQUANTUM_ROOT, or CONDA_PREFIX. Development roots are not used as a fallback for installed wheels, avoiding accidental binding to an unrelated system CUDA.

Integration layers

• build(release): prepare Windows CUDA wheel metadata #1119 declares the Windows CUDA/cuTENSOR PyPI runtime packages before the repair step externalizes their DLLs;
• ci(windows): build and publish PyPI wheels #1113 runs prepare-windows or prepare-cuda before cibuildwheel and adds the Windows CPU/CUDA jobs.

Linux and macOS

CMake classifies MODULE targets as LIBRARY artifacts on every platform, so the relative install rule preserves Linux/macOS behavior while also installing the Windows .pyd. Existing macOS conda prefixes from master are retained.

Validation

• both wheel environments install from the lock;
• OpenBLAS discovery and import-library layout checks pass;
• an actual CPU wheel repaired with forced openblas.dll inclusion contains cytnx.libs/openblas.dll;
• the generated install script places the .pyd under the relative cytnx package;
• loader, repair, and validation scripts pass syntax and focused CLI checks;
• repository-pinned pre-commit hooks pass.

Part of #1114.

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c05b40b7eb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2d7169602b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d0521d71c0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".