✨ Add quantum teleportation benchmark

[denialhaag]

🤖 AI text below 🤖

Description

Add a fixed quantum teleportation benchmark with C++ and Python APIs, strict empty-parameter instance specifications and manifests, an analytic reference, command-line support, and structured MLIR generation.

The program teleports the fixed |+> state and returns only Bob's X-basis measurement. Outcome 0 denotes success; Alice's measurements remain internal and drive the X and Z corrections. The benchmark reports the probability of recovering the prepared state. This checks the fixed input, not arbitrary-state channel fidelity.

Native reference, generation, and sampling tests protect the output, correction data flow, and deterministic success outcome. A separate Python test covers the benchmark bindings and JSON round trips. These tests reuse the structure and native helpers from #2402.

This PR is stacked on #2402.

AI notice

This PR and its contents were created with the assistance of GPT-5.6 Sol and GPT-6 via Codex.

Checklist

• The pull request only contains commits that are focused and relevant to this change.
• I have added appropriate tests that cover the new/changed functionality.
• I have updated the documentation to reflect these changes.
• I have added entries to the changelog for any noteworthy additions, changes, fixes, or removals.
• I have added migration instructions to the upgrade guide (if needed).
• The changes follow the project's style guidelines and introduce no new warnings.
• The changes are fully tested and pass the CI checks.
• I have reviewed my own code changes.

If PR contains AI-assisted content:

• Any agent that created, edited, or submitted GitHub content was explicitly authorized for that scope, as required by our AI Usage Guidelines.
• Every agent-authored or agent-edited public text body begins with the visible disclosure 🤖 *AI text below* 🤖 (titles are exempt).
• I have disclosed AI assistance in the PR description.
• I confirm that I have personally reviewed and understood all AI-generated content, and accept full responsibility for it.

[codecov]

Codecov Report

❌ Patch coverage is 97.61905% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/bench/JSON.cpp	92.3%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[denialhaag]

Some feedback:

[coderabbitai]

Important

Approval pending

CodeRabbit has no unresolved comments, but it has not reviewed the latest commit.

Use the checkbox below to review the latest commit. CodeRabbit will approve the changes if it finds no blocking issues.

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[burgholzer]

Tweaked the benchmark here a little bit so that it actually benchmarks how well the state was teleported and added simulation tests.
This LGTM now and should also be ready to merge.