✨ Add missing TKET RL actions

[flowerthrower]

🤖 AI text below 🤖

Description

Adds the TKET actions used by the paper prototype but missing from the production registry: KAKDecomposition, GraphPlacement, and NoiseAwarePlacement.

The placement actions translate TKET placement maps into complete Qiskit layouts through the existing layout pipeline. NoiseAwarePlacement receives mean one- and two-qubit gate errors per node and link, while measurement errors are excluded from those averages and supplied separately as readout errors. Registered TKET layout actions must provide exactly one Placement.

TKET layout and routing actions are masked for circuits containing operations wider than two qubits.

Focused tests cover calibration aggregation, wide-operation masking, real graph and noise-aware placement, KAK semantics, and the public placement boundary. The existing assignment test includes an idle qubit without a register; a small recovery test verifies that failed placement preserves the input circuit and unset layout. These three placement cases pass on current dependencies and minimum Qiskit 2.1.1/Python 3.11. Adjacent layout and registration tests and the lint suite pass.

The inherited VF2 search-budget fix is isolated in #831.

Existing RL models must be retrained because the action schema changes.

It depends on #795 and is followed by #797. No new package dependencies are introduced.

Part of #664

Validation after removing AI routing: all 101 non-training compilation tests pass on the combined stack, and full lint passes. The existing action invariants cover the remaining actions. Fresh CI for this rebased head is pending.

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.

[flowerthrower]

@coderabbitai full review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

---

Your included review limit is currently reached under our Fair Usage Limits Policy. This review may still proceed through usage-based billing if eligible. Your next included review will be available in 50 minutes.

[coderabbitai]

Warning

Review limit reached

Next included review available in 50 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 1f2a73f6-8554-4a13-9283-d765cde6befd

📥 Commits

Reviewing files that changed from the base of the PR and between bb3ce81 and 65c9d98.

📒 Files selected for processing (5)

• CHANGELOG.md
• UPGRADING.md
• src/mqt/predictor/rl/actions/registry.py
• src/mqt/predictor/rl/actions/tket_actions.py
• src/mqt/predictor/rl/predictorenv.py

---

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.}

[codecov]

Codecov Report

❌ Patch coverage is 93.02326% with 6 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/mqt/predictor/rl/actions/tket_actions.py	92.8%	6 Missing ⚠️

📢 Thoughts on this report? Let us know!