qcoder 0.2.0a1__tar.gz → 0.3.0a1__tar.gz

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 
 The format is based on common practice for pre-1.0 semantic versioning: **`MAJOR.MINOR.PATCH`** with **`aN`** for alpha prereleases.
 
+## 0.3.0a1 (alpha)
+
+Optional Cirq and PennyLane intake alongside the existing Qiskit adapter. All adapters follow the same structural rules: framework object → OpenQASM 2 text → qCoder's shared parser pipeline.
+
+### Added
+
+- **`qcoder[cirq]`** — optional **Cirq** `Circuit` intake via OpenQASM 2 export (`cirq.qasm`) into the same canonical extractor used for `.qasm` files.
+- **`qcoder[pennylane]`** — optional **PennyLane** intake (`QNode`, and **`QuantumScript`** where the installed version exposes it) via OpenQASM 2 export into the same canonical extractor used for `.qasm` files.
+
+### Changed
+
+- **Adapter error handling** — Qiskit intake wraps **`qiskit.qasm2.dumps`** failures and QASM-parse failures at the adapter boundary in actionable **`RuntimeError`** messages aligned with Cirq and PennyLane adapters.
+
+### Unchanged / scope
+
+- **Canonical feature schema** — same version, field order, and feature vector layout as **`0.2.0a1`** (`schema_v0`/compute path).
+- **Intake semantics** — Qiskit, Cirq, and PennyLane adapters are **structure/export intake only**: no transpiler upload, execution, simulator/hardware runs, telemetry, LLM calls, retrieval, or embeddings inside qCoder for these flows.
+
 ## 0.2.0a1 (alpha)
 
 Local-only deterministic CLI tooling for quantum circuit analysis and LLM-ready workflow artifacts.

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qcoder
-Version: 0.2.0a1
+Version: 0.3.0a1
 Summary: Quantum circuit analysis and structured feature extraction tools.
 Author-email: Quantum Ready Solutions <support@qcoder.ai>
 Maintainer-email: Quantum Ready Solutions <support@qcoder.ai>
@@ -22,13 +22,17 @@ License-File: NOTICE
 Requires-Dist: numpy
 Provides-Extra: qiskit
 Requires-Dist: qiskit>=1.0; extra == "qiskit"
+Provides-Extra: cirq
+Requires-Dist: cirq-core>=1.4; extra == "cirq"
+Provides-Extra: pennylane
+Requires-Dist: pennylane>=0.44; extra == "pennylane"
 Dynamic: license-file
 
 # qCoder
 
 **qCoder** helps developers **inspect quantum circuits before they run them.** It reads **OpenQASM** circuits, extracts **repeatable structural features**, and emits **structured JSON** (single file) or **JSONL** (batches)—useful for **notebooks**, **CI**, **pull-request review**, and **AI coding assistants** when you attach or paste deterministic context next to circuit text.
 
-**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit** intake: **`pip install "qcoder[qiskit]"`**.
+**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit / Cirq / PennyLane** intake (structure/export only, no simulator or hardware execution): **`pip install "qcoder[qiskit]"`**, **`pip install "qcoder[cirq]"`**, **`pip install "qcoder[pennylane]"`**.
 
 **Company / legal:** Quantum Ready Solutions. **Product docs:** [qcoder.ai](https://qcoder.ai) · [manual](https://qcoder.ai/manual/). **Source:** [github.com/QuantumReadySolutions/qCoder](https://github.com/QuantumReadySolutions/qCoder). **Support:** [support@qcoder.ai](mailto:support@qcoder.ai).
 
@@ -47,6 +51,8 @@ For **this release**, treat the **supported surface** as:
 - **`qcoder review`** — deterministic post-run review artifacts (**JSON + Markdown**) from user-provided counts.
 - **Counts intake normalization** — `qcoder.counts.v0` and `qiskit_counts` normalization into the same deterministic review path.
 - **`qcoder[qiskit]`** — optional `QuantumCircuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[cirq]`** — optional Cirq `Circuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[pennylane]`** — optional PennyLane circuit intake into the **same extractor** as OpenQASM.
 - **Documented feature output** — see [qcoder.ai — Feature reference](https://qcoder.ai/manual/feature-reference/) and `engines/feature_extraction/features/schema_v0.py`; JSON carries a **`schema_version`** alongside named fields.
 
 Other modules under **`src/qcoder`** may exist for prototyping (extra tooling or engines outside the commands above). Unless documented here, **`docs/`**, or **qcoder.ai**, they do **not** share the same stability expectations as the commands and artifact formats listed above.
@@ -59,7 +65,7 @@ Brief notes live in **`docs/architecture.md`**.
 pip install qcoder
 ```
 
-Pre-release lines on PyPI use segments such as **`0.2.0a1`**.
+Pre-release lines on PyPI use segments such as **`0.3.0a1`**.
 
 Optional Qiskit adapter:
 
@@ -67,6 +73,18 @@ Optional Qiskit adapter:
 pip install "qcoder[qiskit]"
 ```
 
+Optional Cirq adapter:
+
+```bash
+pip install "qcoder[cirq]"
+```
+
+Optional PennyLane adapter:
+
+```bash
+pip install "qcoder[pennylane]"
+```
+
 Requires **Python 3.11+**. Runtime dependency: **NumPy**.
 
 Machine-readable JSON from **`qcoder analyze --json`** includes a derived **`feature_map`** object (`name → value`) for easier reading. The canonical circuit feature bundle remains the nested **`features`** object (`schema_version`, **`feature_names`**, **`features`**).
@@ -75,6 +93,8 @@ Optional **`--guidance`** adds heuristic shot-count and simulator/MPS starting-p
 
 `qcoder context` and `qcoder review` generate deterministic local artifacts (JSON + Markdown) intended for user-controlled AI-assisted planning/review workflows. "LLM-ready/RAG-ready" in this project means users can attach or paste these artifacts manually; qCoder itself performs no retrieval, embeddings, network calls, or telemetry/upload in this flow.
 
+The optional Qiskit, Cirq, and PennyLane adapters are structure/export intake paths only. qCoder does not execute simulators or hardware backends in these flows.
+
 ## CLI quickstart
 
 ```bash

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/README.md

@@ -2,7 +2,7 @@
 
 **qCoder** helps developers **inspect quantum circuits before they run them.** It reads **OpenQASM** circuits, extracts **repeatable structural features**, and emits **structured JSON** (single file) or **JSONL** (batches)—useful for **notebooks**, **CI**, **pull-request review**, and **AI coding assistants** when you attach or paste deterministic context next to circuit text.
 
-**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit** intake: **`pip install "qcoder[qiskit]"`**.
+**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit / Cirq / PennyLane** intake (structure/export only, no simulator or hardware execution): **`pip install "qcoder[qiskit]"`**, **`pip install "qcoder[cirq]"`**, **`pip install "qcoder[pennylane]"`**.
 
 **Company / legal:** Quantum Ready Solutions. **Product docs:** [qcoder.ai](https://qcoder.ai) · [manual](https://qcoder.ai/manual/). **Source:** [github.com/QuantumReadySolutions/qCoder](https://github.com/QuantumReadySolutions/qCoder). **Support:** [support@qcoder.ai](mailto:support@qcoder.ai).
 
@@ -21,6 +21,8 @@ For **this release**, treat the **supported surface** as:
 - **`qcoder review`** — deterministic post-run review artifacts (**JSON + Markdown**) from user-provided counts.
 - **Counts intake normalization** — `qcoder.counts.v0` and `qiskit_counts` normalization into the same deterministic review path.
 - **`qcoder[qiskit]`** — optional `QuantumCircuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[cirq]`** — optional Cirq `Circuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[pennylane]`** — optional PennyLane circuit intake into the **same extractor** as OpenQASM.
 - **Documented feature output** — see [qcoder.ai — Feature reference](https://qcoder.ai/manual/feature-reference/) and `engines/feature_extraction/features/schema_v0.py`; JSON carries a **`schema_version`** alongside named fields.
 
 Other modules under **`src/qcoder`** may exist for prototyping (extra tooling or engines outside the commands above). Unless documented here, **`docs/`**, or **qcoder.ai**, they do **not** share the same stability expectations as the commands and artifact formats listed above.
@@ -33,7 +35,7 @@ Brief notes live in **`docs/architecture.md`**.
 pip install qcoder
 ```
 
-Pre-release lines on PyPI use segments such as **`0.2.0a1`**.
+Pre-release lines on PyPI use segments such as **`0.3.0a1`**.
 
 Optional Qiskit adapter:
 
@@ -41,6 +43,18 @@ Optional Qiskit adapter:
 pip install "qcoder[qiskit]"
 ```
 
+Optional Cirq adapter:
+
+```bash
+pip install "qcoder[cirq]"
+```
+
+Optional PennyLane adapter:
+
+```bash
+pip install "qcoder[pennylane]"
+```
+
 Requires **Python 3.11+**. Runtime dependency: **NumPy**.
 
 Machine-readable JSON from **`qcoder analyze --json`** includes a derived **`feature_map`** object (`name → value`) for easier reading. The canonical circuit feature bundle remains the nested **`features`** object (`schema_version`, **`feature_names`**, **`features`**).
@@ -49,6 +63,8 @@ Optional **`--guidance`** adds heuristic shot-count and simulator/MPS starting-p
 
 `qcoder context` and `qcoder review` generate deterministic local artifacts (JSON + Markdown) intended for user-controlled AI-assisted planning/review workflows. "LLM-ready/RAG-ready" in this project means users can attach or paste these artifacts manually; qCoder itself performs no retrieval, embeddings, network calls, or telemetry/upload in this flow.
 
+The optional Qiskit, Cirq, and PennyLane adapters are structure/export intake paths only. qCoder does not execute simulators or hardware backends in these flows.
+
 ## CLI quickstart
 
 ```bash

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/docs/architecture.md

@@ -4,6 +4,8 @@
 
 - Primary path: **OpenQASM / QASM** text analyzed on the developer machine.
 - Optional path: **`qcoder[qiskit]`** can ingest **Qiskit `QuantumCircuit`** objects into the **same extractor** as OpenQASM.
+- Optional path: **`qcoder[cirq]`** can ingest **Cirq `Circuit`** objects into the **same extractor** as OpenQASM.
+- Optional path: **`qcoder[pennylane]`** can ingest **PennyLane circuits** into the **same extractor** as OpenQASM.
 
 The field glossary is defined in **`src/qcoder/engines/feature_extraction/features/schema_v0.py`** (`FEATURE_NAMES_V0`). The [qcoder.ai manual — Feature reference](https://qcoder.ai/manual/feature-reference/) summarizes each field name.
 
@@ -14,10 +16,12 @@ The supported product surface described in **`README.md`** (**Package layout**)
 - **`qcoder context`** for deterministic preflight artifacts (**JSON + Markdown**), with optional `--full-features` glossary appendix.
 - **`qcoder review`** for deterministic post-run review artifacts (**JSON + Markdown**) from user-provided counts.
 - Counts normalization from **`qcoder.counts.v0`** and **`qiskit_counts`** into one deterministic review path.
-- Optional **`qcoder[qiskit]`** ingestion into the same extractor as OpenQASM.
+- Optional **`qcoder[qiskit]`**, **`qcoder[cirq]`**, and **`qcoder[pennylane]`** ingestion into the same extractor as OpenQASM.
 
 The canonical circuit feature schema remains the existing `features` payload (`schema_version`, `feature_names`, `features`) produced by extraction. Guidance/context/review outputs are additive artifact layers and do not change canonical feature schema/version/order.
 
 When requested via CLI flags, qCoder may emit an additional top-level `guidance` block built deterministically from `feature_map`. This guidance is outside the canonical feature schema (`features`) and is intended as transparent heuristic starting points rather than execution-validated recommendations.
 
 The `context` and `review` commands generate deterministic local artifacts (Markdown/JSON) for user-controlled planning and post-run analysis workflows. "LLM-ready/RAG-ready" in this context means users can attach/paste artifacts manually; qCoder itself makes no LLM calls and performs no retrieval, embeddings, network calls, telemetry upload, or database writes. qCoder also does not execute simulators or hardware backends in these flows.
+
+Optional framework adapters perform conversion/intake only; they do not execute circuits, simulators, or hardware.

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qcoder"
-version = "0.2.0a1"
+version = "0.3.0a1"
 description = "Quantum circuit analysis and structured feature extraction tools."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -28,6 +28,8 @@ dependencies = ["numpy"]
 
 [project.optional-dependencies]
 qiskit = ["qiskit>=1.0"]
+cirq = ["cirq-core>=1.4"]
+pennylane = ["pennylane>=0.44"]
 
 [project.urls]
 Homepage = "https://qcoder.ai"

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/src/qcoder/__init__.py

@@ -1,3 +1,3 @@
 __all__ = []
-__version__ = "0.2.0a1"
+__version__ = "0.3.0a1"
 file = __file__

qcoder-0.3.0a1/src/qcoder/engines/feature_extraction/adapters/cirq_intake.py

@@ -0,0 +1,54 @@
+"""
+Optional Cirq Circuit intake via OpenQASM 2 export.
+
+Cirq is imported only when functions in this module are called.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..features.compute_v0 import FeatureVector, compute_features_v0
+from ..ir import CircuitIR
+from ..qasm2_regex_parser import parse_qasm2_text
+
+
+def _load_cirq() -> tuple[type, Any]:
+    try:
+        from cirq import Circuit, qasm
+    except ImportError as e:
+        raise ImportError(
+            "qcoder: Cirq is not installed. "
+            "Install with: pip install cirq-core  or  pip install 'qcoder[cirq]' "
+            "(optional extra)."
+        ) from e
+    return Circuit, qasm
+
+
+def circuit_ir_from_cirq(circuit: Any) -> CircuitIR:
+    """
+    Export ``circuit`` with ``cirq.qasm`` and parse as OpenQASM 2 text.
+
+    Raises ImportError when Cirq is not installed (only at call time).
+    Raises TypeError if ``circuit`` is not a ``cirq.Circuit``.
+    Raises RuntimeError when exported text cannot be parsed by qCoder's QASM parser.
+    """
+    Circuit, qasm = _load_cirq()
+    if not isinstance(circuit, Circuit):
+        raise TypeError(f"expected cirq.Circuit, got {type(circuit).__name__}")
+
+    qasm_text = qasm(circuit)
+    try:
+        return parse_qasm2_text(qasm_text, source_label="cirq.qasm")
+    except Exception as e:  # pragma: no cover - defensive adapter boundary
+        raise RuntimeError(
+            "qcoder: cirq.qasm exported OpenQASM that qCoder could not parse. "
+            "Try simplifying unsupported operations or inspect the exported QASM text."
+        ) from e
+
+
+def extract_features_from_cirq_circuit(circuit: Any) -> FeatureVector:
+    """``circuit_ir_from_cirq`` + ``compute_features_v0`` (same schema as file intake)."""
+    ir = circuit_ir_from_cirq(circuit)
+    return compute_features_v0(ir)
+

qcoder-0.3.0a1/src/qcoder/engines/feature_extraction/adapters/pennylane_intake.py

@@ -0,0 +1,86 @@
+"""
+Optional PennyLane circuit intake via OpenQASM 2 export.
+
+PennyLane is imported only when functions in this module are called.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..features.compute_v0 import FeatureVector, compute_features_v0
+from ..ir import CircuitIR
+from ..qasm2_regex_parser import parse_qasm2_text
+
+
+def _load_pennylane() -> tuple[type, type | None, Any]:
+    try:
+        import pennylane as qml
+        from pennylane import QNode
+        from pennylane.io import to_openqasm
+    except ImportError as e:
+        raise ImportError(
+            "qcoder: PennyLane is not installed. "
+            "Install with: pip install pennylane  or  pip install 'qcoder[pennylane]' "
+            "(optional extra)."
+        ) from e
+
+    # Optional: support QuantumScript when available on this PennyLane version.
+    try:
+        from pennylane.tape import QuantumScript
+    except Exception:  # pragma: no cover - version-dependent optional type
+        QuantumScript = None
+
+    _ = qml  # reserved for future adapter diagnostics
+    return QNode, QuantumScript, to_openqasm
+
+
+def circuit_ir_from_pennylane(circuit: Any, *args: Any, **kwargs: Any) -> CircuitIR:
+    """
+    Export ``circuit`` with ``qml.to_openqasm(..., measure_all=True)`` and parse as OpenQASM 2 text.
+
+    Raises ImportError when PennyLane is not installed (only at call time).
+    Raises TypeError if ``circuit`` is not a supported PennyLane circuit object.
+    Raises RuntimeError when export fails or exported text cannot be parsed by qCoder.
+    """
+    QNode, QuantumScript, to_openqasm = _load_pennylane()
+    accepted_types: tuple[type, ...] = (QNode,) if QuantumScript is None else (QNode, QuantumScript)
+    if not isinstance(circuit, accepted_types):
+        raise TypeError(
+            "expected pennylane.QNode"
+            + ("" if QuantumScript is None else " or pennylane.tape.QuantumScript")
+            + f", got {type(circuit).__name__}"
+        )
+
+    try:
+        exported = to_openqasm(circuit, measure_all=True)
+        # QNode export returns a callable (to supply call args).
+        qasm_text = exported(*args, **kwargs) if callable(exported) else exported
+    except Exception as e:
+        raise RuntimeError(
+            "qcoder: PennyLane OpenQASM export failed via qml.to_openqasm. "
+            "Try a simpler circuit (QASM2-supported ops) or verify provided QNode arguments."
+        ) from e
+
+    if not isinstance(qasm_text, str):
+        raise RuntimeError(
+            "qcoder: PennyLane OpenQASM export did not return text. "
+            "Expected OpenQASM 2 source string from qml.to_openqasm."
+        )
+
+    try:
+        return parse_qasm2_text(qasm_text, source_label="qml.to_openqasm")
+    except Exception as e:  # pragma: no cover - defensive adapter boundary
+        raise RuntimeError(
+            "qcoder: qml.to_openqasm produced OpenQASM that qCoder could not parse. "
+            "Try simplifying unsupported operations or inspect the exported QASM text."
+        ) from e
+
+
+def extract_features_from_pennylane_circuit(
+    circuit: Any, *args: Any, **kwargs: Any
+) -> FeatureVector:
+    """``circuit_ir_from_pennylane`` + ``compute_features_v0`` (same schema as file intake)."""
+    ir = circuit_ir_from_pennylane(circuit, *args, **kwargs)
+    return compute_features_v0(ir)
+

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/src/qcoder/engines/feature_extraction/adapters/qiskit_intake.py

@@ -32,12 +32,27 @@ def circuit_ir_from_qiskit(qc: Any) -> CircuitIR:
 
     Raises ImportError when Qiskit is not installed (only at call time).
     Raises TypeError if ``qc`` is not a ``qiskit.QuantumCircuit``.
+    Raises RuntimeError when export fails or exported text cannot be parsed by qCoder's QASM parser.
     """
     QuantumCircuit, dumps = _load_qiskit()
     if not isinstance(qc, QuantumCircuit):
         raise TypeError(f"expected qiskit.QuantumCircuit, got {type(qc).__name__}")
-    qasm_text = dumps(qc)
-    return parse_qasm2_text(qasm_text, source_label="qiskit.qasm2.dumps")
+
+    try:
+        qasm_text = dumps(qc)
+    except Exception as e:
+        raise RuntimeError(
+            "qcoder: OpenQASM 2 export failed via qiskit.qasm2.dumps. "
+            "Try a circuit supported by OpenQASM 2 export or inspect the circuit for unsupported constructs."
+        ) from e
+
+    try:
+        return parse_qasm2_text(qasm_text, source_label="qiskit.qasm2.dumps")
+    except Exception as e:  # pragma: no cover - defensive adapter boundary
+        raise RuntimeError(
+            "qcoder: qiskit.qasm2.dumps exported OpenQASM that qCoder could not parse. "
+            "Try simplifying unsupported operations or inspect the exported QASM text."
+        ) from e
 
 
 def extract_features_from_qiskit_circuit(qc: Any) -> FeatureVector:

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/src/qcoder.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qcoder
-Version: 0.2.0a1
+Version: 0.3.0a1
 Summary: Quantum circuit analysis and structured feature extraction tools.
 Author-email: Quantum Ready Solutions <support@qcoder.ai>
 Maintainer-email: Quantum Ready Solutions <support@qcoder.ai>
@@ -22,13 +22,17 @@ License-File: NOTICE
 Requires-Dist: numpy
 Provides-Extra: qiskit
 Requires-Dist: qiskit>=1.0; extra == "qiskit"
+Provides-Extra: cirq
+Requires-Dist: cirq-core>=1.4; extra == "cirq"
+Provides-Extra: pennylane
+Requires-Dist: pennylane>=0.44; extra == "pennylane"
 Dynamic: license-file
 
 # qCoder
 
 **qCoder** helps developers **inspect quantum circuits before they run them.** It reads **OpenQASM** circuits, extracts **repeatable structural features**, and emits **structured JSON** (single file) or **JSONL** (batches)—useful for **notebooks**, **CI**, **pull-request review**, and **AI coding assistants** when you attach or paste deterministic context next to circuit text.
 
-**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit** intake: **`pip install "qcoder[qiskit]"`**.
+**CLI:** **`qcoder analyze`**, **`qcoder batch`**, **`qcoder context`**, and **`qcoder review`**. Optional **Qiskit / Cirq / PennyLane** intake (structure/export only, no simulator or hardware execution): **`pip install "qcoder[qiskit]"`**, **`pip install "qcoder[cirq]"`**, **`pip install "qcoder[pennylane]"`**.
 
 **Company / legal:** Quantum Ready Solutions. **Product docs:** [qcoder.ai](https://qcoder.ai) · [manual](https://qcoder.ai/manual/). **Source:** [github.com/QuantumReadySolutions/qCoder](https://github.com/QuantumReadySolutions/qCoder). **Support:** [support@qcoder.ai](mailto:support@qcoder.ai).
 
@@ -47,6 +51,8 @@ For **this release**, treat the **supported surface** as:
 - **`qcoder review`** — deterministic post-run review artifacts (**JSON + Markdown**) from user-provided counts.
 - **Counts intake normalization** — `qcoder.counts.v0` and `qiskit_counts` normalization into the same deterministic review path.
 - **`qcoder[qiskit]`** — optional `QuantumCircuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[cirq]`** — optional Cirq `Circuit` intake into the **same extractor** as OpenQASM.
+- **`qcoder[pennylane]`** — optional PennyLane circuit intake into the **same extractor** as OpenQASM.
 - **Documented feature output** — see [qcoder.ai — Feature reference](https://qcoder.ai/manual/feature-reference/) and `engines/feature_extraction/features/schema_v0.py`; JSON carries a **`schema_version`** alongside named fields.
 
 Other modules under **`src/qcoder`** may exist for prototyping (extra tooling or engines outside the commands above). Unless documented here, **`docs/`**, or **qcoder.ai**, they do **not** share the same stability expectations as the commands and artifact formats listed above.
@@ -59,7 +65,7 @@ Brief notes live in **`docs/architecture.md`**.
 pip install qcoder
 ```
 
-Pre-release lines on PyPI use segments such as **`0.2.0a1`**.
+Pre-release lines on PyPI use segments such as **`0.3.0a1`**.
 
 Optional Qiskit adapter:
 
@@ -67,6 +73,18 @@ Optional Qiskit adapter:
 pip install "qcoder[qiskit]"
 ```
 
+Optional Cirq adapter:
+
+```bash
+pip install "qcoder[cirq]"
+```
+
+Optional PennyLane adapter:
+
+```bash
+pip install "qcoder[pennylane]"
+```
+
 Requires **Python 3.11+**. Runtime dependency: **NumPy**.
 
 Machine-readable JSON from **`qcoder analyze --json`** includes a derived **`feature_map`** object (`name → value`) for easier reading. The canonical circuit feature bundle remains the nested **`features`** object (`schema_version`, **`feature_names`**, **`features`**).
@@ -75,6 +93,8 @@ Optional **`--guidance`** adds heuristic shot-count and simulator/MPS starting-p
 
 `qcoder context` and `qcoder review` generate deterministic local artifacts (JSON + Markdown) intended for user-controlled AI-assisted planning/review workflows. "LLM-ready/RAG-ready" in this project means users can attach or paste these artifacts manually; qCoder itself performs no retrieval, embeddings, network calls, or telemetry/upload in this flow.
 
+The optional Qiskit, Cirq, and PennyLane adapters are structure/export intake paths only. qCoder does not execute simulators or hardware backends in these flows.
+
 ## CLI quickstart
 
 ```bash

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/src/qcoder.egg-info/SOURCES.txt

@@ -29,6 +29,8 @@ src/qcoder/engines/feature_extraction/ir.py
 src/qcoder/engines/feature_extraction/labeling.py
 src/qcoder/engines/feature_extraction/qasm2_regex_parser.py
 src/qcoder/engines/feature_extraction/adapters/__init__.py
+src/qcoder/engines/feature_extraction/adapters/cirq_intake.py
+src/qcoder/engines/feature_extraction/adapters/pennylane_intake.py
 src/qcoder/engines/feature_extraction/adapters/qiskit_intake.py
 src/qcoder/engines/feature_extraction/features/compute_v0.py
 src/qcoder/engines/feature_extraction/features/glossary_v0.py
@@ -85,6 +87,7 @@ tests/test_analyze_pipeline.py
 tests/test_analyze_prediction_integration.py
 tests/test_analyze_shot_scaling.py
 tests/test_batch_pipeline.py
+tests/test_cirq_intake.py
 tests/test_cli_batch_nested_discovery.py
 tests/test_cli_context_review.py
 tests/test_cli_help.py
@@ -100,6 +103,7 @@ tests/test_interaction_graph_metrics.py
 tests/test_join_runs_features.py
 tests/test_mirror_build.py
 tests/test_parse_qasm2_text.py
+tests/test_pennylane_intake.py
 tests/test_predict_baseline.py
 tests/test_prediction_artifact_io.py
 tests/test_prediction_fidelity_curve.py

qcoder-0.3.0a1/src/qcoder.egg-info/requires.txt

@@ -0,0 +1,10 @@
+numpy
+
+[cirq]
+cirq-core>=1.4
+
+[pennylane]
+pennylane>=0.44
+
+[qiskit]
+qiskit>=1.0

qcoder-0.3.0a1/tests/test_cirq_intake.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import importlib
+import importlib.util
+import tempfile
+import unittest
+from pathlib import Path
+
+from qcoder.engines.feature_extraction.features.compute_v0 import compute_features_v0
+from qcoder.engines.feature_extraction.parsers import parse_circuit_file
+
+
+def _cirq_installed() -> bool:
+    return importlib.util.find_spec("cirq") is not None
+
+
+@unittest.skipUnless(_cirq_installed(), "cirq not installed")
+class TestCirqIntakeWithCirq(unittest.TestCase):
+    def test_bell_features_match_tempfile_from_qasm_export(self) -> None:
+        import cirq
+
+        from qcoder.engines.feature_extraction.adapters.cirq_intake import (
+            extract_features_from_cirq_circuit,
+        )
+
+        q0, q1 = cirq.LineQubit.range(2)
+        circuit = cirq.Circuit(
+            cirq.H(q0),
+            cirq.CNOT(q0, q1),
+            cirq.measure(q0, q1, key="m"),
+        )
+        text = cirq.qasm(circuit)
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".qasm", delete=False, encoding="utf-8"
+        ) as f:
+            f.write(text)
+            path = f.name
+        try:
+            ir_file = parse_circuit_file(path)
+            fv_file = compute_features_v0(ir_file)
+        finally:
+            Path(path).unlink(missing_ok=True)
+
+        fv_adapt = extract_features_from_cirq_circuit(circuit)
+        self.assertEqual(fv_adapt.schema_version, fv_file.schema_version)
+        self.assertEqual(fv_adapt.feature_names, fv_file.feature_names)
+        self.assertEqual(fv_adapt.features, fv_file.features)
+
+    def test_circuit_ir_matches_parse_qasm2_text_of_export(self) -> None:
+        import cirq
+
+        from qcoder.engines.feature_extraction.adapters.cirq_intake import (
+            circuit_ir_from_cirq,
+        )
+        from qcoder.engines.feature_extraction.qasm2_regex_parser import parse_qasm2_text
+
+        q0, q1 = cirq.LineQubit.range(2)
+        circuit = cirq.Circuit(
+            cirq.H(q0),
+            cirq.CNOT(q0, q1),
+            cirq.measure(q0, q1, key="m"),
+        )
+        ir_adapt = circuit_ir_from_cirq(circuit)
+        ir_ref = parse_qasm2_text(cirq.qasm(circuit))
+        self.assertEqual(ir_adapt, ir_ref)
+
+    def test_wrong_type_raises_type_error(self) -> None:
+        from qcoder.engines.feature_extraction.adapters.cirq_intake import (
+            circuit_ir_from_cirq,
+        )
+
+        with self.assertRaises(TypeError):
+            circuit_ir_from_cirq("not a circuit")
+
+
+class TestCirqIntakeWithoutCirq(unittest.TestCase):
+    """Runs when cirq is absent; skipped assertions when cirq is present."""
+
+    def test_adapter_module_importable_without_calling_cirq(self) -> None:
+        importlib.import_module("qcoder.engines.feature_extraction.adapters.cirq_intake")
+
+    def test_missing_cirq_raises_import_error_with_hint(self) -> None:
+        if _cirq_installed():
+            self.skipTest("cirq is installed")
+        from qcoder.engines.feature_extraction.adapters.cirq_intake import (
+            circuit_ir_from_cirq,
+        )
+
+        with self.assertRaises(ImportError) as ctx:
+            circuit_ir_from_cirq(None)
+        self.assertIn("Cirq", str(ctx.exception))
+        self.assertIn("pip", str(ctx.exception).lower())
+
+
+if __name__ == "__main__":
+    unittest.main()
+

qcoder-0.3.0a1/tests/test_pennylane_intake.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+import importlib
+import importlib.util
+import tempfile
+import unittest
+from pathlib import Path
+
+from qcoder.engines.feature_extraction.features.compute_v0 import compute_features_v0
+from qcoder.engines.feature_extraction.parsers import parse_circuit_file
+
+
+def _pennylane_installed() -> bool:
+    return importlib.util.find_spec("pennylane") is not None
+
+
+@unittest.skipUnless(_pennylane_installed(), "pennylane not installed")
+class TestPennyLaneIntakeWithPennyLane(unittest.TestCase):
+    @staticmethod
+    def _bell_qnode():
+        import pennylane as qml
+
+        # Analytic device (no device-level shots) avoids shots-on-device deprecation warnings.
+        dev = qml.device("default.qubit", wires=2)
+
+        @qml.qnode(dev)
+        def circuit():
+            qml.Hadamard(wires=0)
+            qml.CNOT(wires=[0, 1])
+            return qml.expval(qml.PauliZ(0))
+
+        return circuit
+
+    def _qasm_from_qnode(self, qnode) -> str:
+        import pennylane as qml
+
+        exported = qml.to_openqasm(qnode, measure_all=True)
+        return exported() if callable(exported) else exported
+
+    def test_bell_features_match_tempfile_from_qasm_export(self) -> None:
+        from qcoder.engines.feature_extraction.adapters.pennylane_intake import (
+            extract_features_from_pennylane_circuit,
+        )
+
+        qnode = self._bell_qnode()
+        text = self._qasm_from_qnode(qnode)
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".qasm", delete=False, encoding="utf-8"
+        ) as f:
+            f.write(text)
+            path = f.name
+        try:
+            ir_file = parse_circuit_file(path)
+            fv_file = compute_features_v0(ir_file)
+        finally:
+            Path(path).unlink(missing_ok=True)
+
+        fv_adapt = extract_features_from_pennylane_circuit(qnode)
+        self.assertEqual(fv_adapt.schema_version, fv_file.schema_version)
+        self.assertEqual(fv_adapt.feature_names, fv_file.feature_names)
+        self.assertEqual(fv_adapt.features, fv_file.features)
+
+    def test_circuit_ir_matches_parse_qasm2_text_of_export(self) -> None:
+        from qcoder.engines.feature_extraction.adapters.pennylane_intake import (
+            circuit_ir_from_pennylane,
+        )
+        from qcoder.engines.feature_extraction.qasm2_regex_parser import parse_qasm2_text
+
+        qnode = self._bell_qnode()
+        ir_adapt = circuit_ir_from_pennylane(qnode)
+        ir_ref = parse_qasm2_text(self._qasm_from_qnode(qnode))
+        self.assertEqual(ir_adapt, ir_ref)
+
+    def test_wrong_type_raises_type_error(self) -> None:
+        from qcoder.engines.feature_extraction.adapters.pennylane_intake import (
+            circuit_ir_from_pennylane,
+        )
+
+        with self.assertRaises(TypeError):
+            circuit_ir_from_pennylane("not a circuit")
+
+
+class TestPennyLaneIntakeWithoutPennyLane(unittest.TestCase):
+    """Runs when pennylane is absent; skipped assertions when pennylane is present."""
+
+    def test_adapter_module_importable_without_calling_pennylane(self) -> None:
+        importlib.import_module("qcoder.engines.feature_extraction.adapters.pennylane_intake")
+
+    def test_missing_pennylane_raises_import_error_with_hint(self) -> None:
+        if _pennylane_installed():
+            self.skipTest("pennylane is installed")
+        from qcoder.engines.feature_extraction.adapters.pennylane_intake import (
+            circuit_ir_from_pennylane,
+        )
+
+        with self.assertRaises(ImportError) as ctx:
+            circuit_ir_from_pennylane(None)
+        self.assertIn("pennylane", str(ctx.exception).lower())
+        self.assertIn("pip", str(ctx.exception).lower())
+        self.assertIn("qcoder[pennylane]", str(ctx.exception))
+
+
+if __name__ == "__main__":
+    unittest.main()
+

{qcoder-0.2.0a1 → qcoder-0.3.0a1}/tests/test_qiskit_intake.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import importlib.util
 import tempfile
 import unittest
+import unittest.mock
 from pathlib import Path
 
 from qcoder.engines.feature_extraction.features.compute_v0 import compute_features_v0
@@ -61,6 +62,46 @@ class TestQiskitIntakeWithQiskit(unittest.TestCase):
         ir_ref = parse_qasm2_text(dumps(qc))
         self.assertEqual(ir_adapt, ir_ref)
 
+    def test_export_failure_raises_runtime_error_with_guidance(self) -> None:
+        from qiskit import QuantumCircuit
+
+        import qcoder.engines.feature_extraction.adapters.qiskit_intake as qi
+
+        qc = QuantumCircuit(1)
+        qc.x(0)
+
+        def bad_dumps(_qc: object) -> str:
+            raise OSError("simulated export failure")
+
+        with unittest.mock.patch.object(
+            qi,
+            "_load_qiskit",
+            return_value=(QuantumCircuit, bad_dumps),
+        ):
+            with self.assertRaises(RuntimeError) as ctx:
+                qi.circuit_ir_from_qiskit(qc)
+        msg = str(ctx.exception)
+        self.assertIn("qcoder", msg.lower())
+        self.assertIn("qiskit.qasm2.dumps", msg.lower())
+
+    def test_parse_failure_raises_runtime_error_with_guidance(self) -> None:
+        from qiskit import QuantumCircuit
+
+        import qcoder.engines.feature_extraction.adapters.qiskit_intake as qi
+
+        qc = QuantumCircuit(1)
+        qc.x(0)
+        with unittest.mock.patch.object(
+            qi,
+            "parse_qasm2_text",
+            side_effect=ValueError("simulated parse failure"),
+        ):
+            with self.assertRaises(RuntimeError) as ctx:
+                qi.circuit_ir_from_qiskit(qc)
+        msg = str(ctx.exception)
+        self.assertIn("qcoder", msg.lower())
+        self.assertIn("could not parse", msg.lower())
+
 
 class TestQiskitIntakeWithoutQiskit(unittest.TestCase):
     """Runs when qiskit is absent; skipped assertions when qiskit is present."""

qcoder-0.2.0a1/src/qcoder.egg-info/requires.txt

@@ -1,4 +0,0 @@
-numpy
-
-[qiskit]
-qiskit>=1.0