✨ Open the Slurm-allocated QDMI device

[burgholzer]

🤖 AI text below 🤖

Description

Add a focused FoMaC entry point for opening the QDMI device that Slurm already allocated to the current job:

• Session::openAllocatedDevice(overrides) in C++
• mqt.core.fomac.open_allocated_device(...) in Python

The implementation reads SLURM_JOB_LICENSES, matches exactly one local static Slurm license to a registered stable QDMI device ID, requires a count of one, opens a fresh device session with optional job-specific configuration overrides, and checks that the device reports IDLE or BUSY. Unrelated licenses are ignored; ambiguous, malformed, OR, remote-license, and unavailable-device cases fail explicitly.

This is intentionally a separate, scheduler-facing PR. It does not introduce a broker, lease service, resource group, or new SPANK behavior.

Validation

• allocated-device native tests (4/4 passed)
• focused Python tests (8/8 passed)
• prek on all changed files
• prior full branch lint before the current-main merge

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 an entry to the changelog.
• I have added migration instructions to the upgrade guide (not needed).
• The changes follow the project's style guidelines and introduce no new warnings.
• The changes are fully tested and pass the local 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 92.77108% with 6 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/fomac/FoMaC.cpp	81.4%	5 Missing ⚠️
src/qdmi/driver/Driver.cpp	98.2%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!