[burgholzer]

🤖 AI text below 🤖

Description

mqt-cc --target now compiles from an explicit #mqt.compilation_target attribute without opening a QDMI device. CompilerTarget.__str__() supplies that representation from Python. The existing target parser, validation, mapping, synthesis, and payload selection are reused; --payload-spec remains required and --qdmi-device is mutually exclusive.

Extracted independently from the keynote branch (#2685), based directly on main; no dependency on the other extracted changes. The target-compilation guide includes a complete CLI example and explains snapshot semantics. Review caught an assertion when an empty argument reached MLIR parsing; empty and whitespace-only values now receive the normal invalid-target diagnostic.

Validation: eight native CLI checks and all 15 Python CLI tests pass locally, including serialized Python-to-CLI target handoff. Stub regeneration, whole-file C++ lint, and repository lint pass. The two new native target tests fail on upstream before extraction. Independent ponytail review has no unresolved findings. Hosted CI is pending.

AI assistance covered extraction, independent review, regression fixes, validation, and this description within the user-authorized scope. Human acceptance/review remains.

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.
• 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 91.42857% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
mlir/tools/mqt-cc/mqt-cc.cpp	91.4%	3 Missing ⚠️

📢 Thoughts on this report? Let us know!