✨ Adopt native multi-program QDMI jobs

[burgholzer]

🤖 AI text below 🤖

Description

Extract native multi-program QDMI jobs from #2226 so that batching can progress independently of payload-capability design. This uses the existing program-format enum and QDMI #509's atomic program setter, program count, and indexed results.

The C++ and Python clients accept lists of text or binary programs and preserve optional shots, byte-exact payloads, session ownership, and existing single-program execution. DDSIM currently accepts one program per native job; the model-only superconducting device does not execute jobs. A dedicated test provider exercises aggregate jobs without inventing unsupported provider lifecycle semantics.

Concurrent single-program submissions remain distinct and unchanged. SDK batching and fallback policy are separate consumers tracked in #2359, including preservation of #2349.

Fixes #2362
Refs #2359, Munich-Quantum-Software-Stack/QDMI#509.

Targets Core 4.1, not 4.0. The development dependency is pinned to QDMI #509; replace it with a released QDMI 1.4 version before release artifacts are published.

Validation

• Native CTest suite: 3,879 passed; one existing skip.
• Python QDMI, Qiskit, and PennyLane tests: 413 passed.
• Python 3.11 minimum dependencies: 412 passed; one expected skip.
• Generated stubs, repository lint, and C++ lint passed.
• Tests cover atomic rollback, copied binary payloads, program ordering, invalid indices, indexed retrieval, optional shots, and existing lifecycle/concurrency behavior.
• Hosted CI remains a separate gate.

AI assistance was used for extraction, implementation, tests, documentation, and this description.

Integration branch

Target v4.1 independently of the driver, metadata-cleanup, and program-capability stacks. Link provider evidence through #2359 before the corresponding standard interface is accepted.

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.71429% with 4 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/qdmi/devices/dd/Device.cpp	95.4%	3 Missing ⚠️
src/qdmi/Client.cpp	98.7%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!