[simon1hofmann]

🤖 AI text below 🤖

Description

Report invalid graph-state degrees and negative cardinality depths as argument errors instead of internal tracebacks. Add the supported balanced option to the public type hints, and generate a safe filename component for targets with missing descriptions or path separators.

Extend existing API, CLI, and filename tests. No new dependencies or migration steps.

Validation: full test suite on Qiskit 2.2.3 and 2.6.0 (707 passed and 4 existing expected failures on each); uvx nox -s lint; mypy accepts get_benchmark_alg("dj", 3, balanced=False).

AI assistance: Codex helped implement and test these MQT Bench fixes and prepare this description.

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

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[burgholzer]

LGTM