qcoder 0.4.0a2__tar.gz → 0.5.0a1__tar.gz

{qcoder-0.4.0a2 → qcoder-0.5.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.5.0a1 (alpha — public Free + Pro Preview shell)
+
+First public package version for the **Option 3 product line**: local/offline Free CLI plus a service-backed Pro Preview shell. Version **`0.5.0a1`** is distinct from the internal frozen local private-alpha RC **`0.4.0a4`** (not shipped here).
+
+### Changed
+
+- **Package version** — public Free + service-backed Pro Preview shell ships as **`0.5.0a1`**.
+- **Public package** — Free local/offline CLI (`analyze`, `batch`, `context`, `review`) with no cards; confidential local Pro implementation is not included.
+- **`qcoder pro` shell** — service-backed Pro Preview stub (`signup`, `status`, `login`, `workflow`); no local cards or Pro analysis in the wheel.
+- **Release-check** — public Free + Pro shell smoke; wheel/sdist scanned for forbidden Pro artifacts.
+
+### Scope / boundaries
+
+- Free qCoder remains local/offline and useful without Pro.
+- Pro Preview service is not implemented in this repository slice.
+
+---
+
 ## 0.4.0a2 (alpha)
 
 ### Added

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/MANIFEST.in

@@ -4,8 +4,12 @@ include README.md
 include CHANGELOG.md
 include pyproject.toml
 graft src
-graft tests
-recursive-include docs *.md
+prune src/qcoder/pro_v0
+prune tests
+prune docs
+exclude docs/pro-v0-install.md
+exclude docs/private-alpha-quickstart.md
+exclude docs/private-alpha-release-candidate-validation.md
 global-exclude __pycache__
 global-exclude *.py[cod]
 global-exclude .DS_Store

qcoder-0.5.0a1/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: qcoder
+Version: 0.5.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>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://qcoder.ai
+Project-URL: Documentation, https://qcoder.ai/manual/
+Project-URL: Repository, https://github.com/QuantumReadySolutions/qCoder
+Project-URL: Issues, https://github.com/QuantumReadySolutions/qCoder/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+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` is a local, deterministic quantum circuit evidence CLI.
+
+Free `qcoder` commands run offline and do not call hosted services, upload telemetry, or run QPU/simulator jobs.
+
+## Public CLI surface
+
+- `qcoder analyze`
+- `qcoder batch`
+- `qcoder context`
+- `qcoder review`
+- `qcoder pro` (service-backed Preview shell/stub)
+
+## Quick start
+
+Install:
+
+```bash
+pip install qcoder
+```
+
+Analyze a circuit:
+
+```bash
+qcoder analyze path/to/circuit.qasm --json
+```
+
+Create local context and review artifacts:
+
+```bash
+qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md preflight.context.md
+qcoder review --counts-json counts.json --format qiskit_counts --preflight-json preflight.context.json --out-json execution.review.json --out-md execution.review.md
+```
+
+Pro Preview shell:
+
+```bash
+qcoder pro --help
+qcoder pro signup
+qcoder pro status
+```
+
+`qcoder pro workflow` is a service-backed stub in this slice; confidential Pro analysis is not bundled in this package.
+
+Architecture notes: [`docs/architecture.md`](docs/architecture.md).
+
+## Optional extras
+
+```bash
+pip install "qcoder[qiskit]"
+pip install "qcoder[cirq]"
+pip install "qcoder[pennylane]"
+```
+
+## License
+
+Apache-2.0 (see `LICENSE` and `NOTICE`).

qcoder-0.5.0a1/README.md

@@ -0,0 +1,58 @@
+# qCoder
+
+`qcoder` is a local, deterministic quantum circuit evidence CLI.
+
+Free `qcoder` commands run offline and do not call hosted services, upload telemetry, or run QPU/simulator jobs.
+
+## Public CLI surface
+
+- `qcoder analyze`
+- `qcoder batch`
+- `qcoder context`
+- `qcoder review`
+- `qcoder pro` (service-backed Preview shell/stub)
+
+## Quick start
+
+Install:
+
+```bash
+pip install qcoder
+```
+
+Analyze a circuit:
+
+```bash
+qcoder analyze path/to/circuit.qasm --json
+```
+
+Create local context and review artifacts:
+
+```bash
+qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md preflight.context.md
+qcoder review --counts-json counts.json --format qiskit_counts --preflight-json preflight.context.json --out-json execution.review.json --out-md execution.review.md
+```
+
+Pro Preview shell:
+
+```bash
+qcoder pro --help
+qcoder pro signup
+qcoder pro status
+```
+
+`qcoder pro workflow` is a service-backed stub in this slice; confidential Pro analysis is not bundled in this package.
+
+Architecture notes: [`docs/architecture.md`](docs/architecture.md).
+
+## Optional extras
+
+```bash
+pip install "qcoder[qiskit]"
+pip install "qcoder[cirq]"
+pip install "qcoder[pennylane]"
+```
+
+## License
+
+Apache-2.0 (see `LICENSE` and `NOTICE`).

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qcoder"
-version = "0.4.0a2"
+version = "0.5.0a1"
 description = "Quantum circuit analysis and structured feature extraction tools."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -45,6 +45,7 @@ package-dir = {"" = "src"}
 
 [tool.setuptools.packages.find]
 where = ["src"]
+exclude = ["qcoder.pro_v0", "qcoder.pro_v0.*"]
 
 [tool.setuptools.package-data]
 qcoder = ["model_packs/*.json"]

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/src/qcoder/__init__.py

@@ -1,3 +1,3 @@
 __all__ = []
-__version__ = "0.4.0a2"
+__version__ = "0.5.0a1"
 file = __file__

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/src/qcoder/cli.py

@@ -5,20 +5,18 @@ import json
 import sys
 
 from qcoder.pipelines.analyze import analyze_qasm
-from qcoder.tools.batch import analyze_qasm_dir_to_jsonl
 from qcoder.pipelines.context import write_preflight_context
 from qcoder.pipelines.review import write_execution_review
+from qcoder.tools.batch import analyze_qasm_dir_to_jsonl
+
+PREVIEW_SIGNUP_URL = "https://qcoder.ai/preview"
 
 
 def _cmd_analyze(argv: list[str]) -> int:
     p = argparse.ArgumentParser(prog="qcoder analyze", add_help=True)
     p.add_argument("qasm", help="Path to a .qasm file")
-
-    # Circuit identity / metadata
     p.add_argument("--id", dest="circuit_id", default=None, help="Optional circuit id")
     p.add_argument("--name", dest="circuit_name", default=None, help="Optional circuit name")
-
-    # Run config (conditioning vars for predictors; not used by feature extraction)
     p.add_argument(
         "--processor",
         "--backend",
@@ -28,14 +26,22 @@ def _cmd_analyze(argv: list[str]) -> int:
     )
     p.add_argument("--precision", default="single", help="Precision: single|double (aliases: fp32/fp64)")
     p.add_argument("--threshold", type=float, default=None, help="Optional threshold/bond-dim conditioning value")
-    p.add_argument("--mirror-artifacts-dir", default=None, metavar="DIR", help="If set, write mirror QASM to DIR and add adjoint_supported/adjoint_reason/mirror_qasm_ref to output")
-    p.add_argument("--guidance", action="store_true", help="Include heuristic resource guidance (shots and simulator/MPS starting points)")
+    p.add_argument(
+        "--mirror-artifacts-dir",
+        default=None,
+        metavar="DIR",
+        help="If set, write mirror QASM to DIR and add adjoint_supported/adjoint_reason/mirror_qasm_ref to output",
+    )
+    p.add_argument(
+        "--guidance",
+        action="store_true",
+        help="Include heuristic resource guidance (shots and simulator/MPS starting points)",
+    )
     p.add_argument(
         "--profiles",
         action="store_true",
         help="Include derived feature_profiles in JSON output (requires --json for analyze)",
     )
-
     p.add_argument("--json", action="store_true", help="Emit machine-readable JSON")
     args = p.parse_args(argv)
 
@@ -111,7 +117,12 @@ def _cmd_batch(argv: list[str]) -> int:
     p.add_argument("--backend", default=None, help="Backend label (CPU/GPU, etc.)")
     p.add_argument("--precision", default=None, help="Precision: single|double|fp32|fp64")
     p.add_argument("--threshold", type=float, default=None, help="Optional threshold for run_config")
-    p.add_argument("--mirror-artifacts-dir", default=None, metavar="DIR", help="If set, write mirror QASM to DIR and add adjoint_supported/adjoint_reason/mirror_qasm_ref to each record")
+    p.add_argument(
+        "--mirror-artifacts-dir",
+        default=None,
+        metavar="DIR",
+        help="If set, write mirror QASM to DIR and add adjoint_supported/adjoint_reason/mirror_qasm_ref to each record",
+    )
     p.add_argument("--guidance", action="store_true", help="Include heuristic resource guidance block in each successful JSONL record")
     args = p.parse_args(argv)
 
@@ -194,17 +205,101 @@ def _cmd_review(argv: list[str]) -> int:
     return 0
 
 
+def _cmd_pro(argv: list[str]) -> int:
+    p = argparse.ArgumentParser(
+        prog="qcoder pro",
+        add_help=True,
+        description=(
+            "qCoder Pro Preview shell (service-backed).\n"
+            "Confidential Pro analysis is not shipped in this package."
+        ),
+    )
+    p.add_argument(
+        "--json",
+        action="store_true",
+        help="Emit JSON where available.",
+    )
+    sub = p.add_subparsers(dest="pro_command")
+
+    p_signup = sub.add_parser("signup", help="Show Pro Preview signup URL.")
+    p_signup.set_defaults(pro_command="signup")
+
+    p_status = sub.add_parser("status", help="Show local Pro Preview client status.")
+    p_status.set_defaults(pro_command="status")
+
+    p_login = sub.add_parser("login", help="Store Preview token (service validation not available in this slice).")
+    p_login.add_argument("--token", required=False, help="Preview token (optional in this stub).")
+    p_login.set_defaults(pro_command="login")
+
+    p_workflow = sub.add_parser("workflow", help="Submit a Pro workflow to the hosted service (not yet available).")
+    p_workflow.add_argument("--qasm", default=None, help="Path to a single QASM file.")
+    p_workflow.add_argument("--before-qasm", default=None, help="Path to before QASM file.")
+    p_workflow.add_argument("--after-qasm", default=None, help="Path to after QASM file.")
+    p_workflow.add_argument("--project-dir", default=None, help="Local project directory.")
+    p_workflow.set_defaults(pro_command="workflow")
+
+    args, _unknown = p.parse_known_args(argv)
+    cmd = args.pro_command
+
+    if cmd is None:
+        p.print_help()
+        return 0
+
+    if cmd == "signup":
+        payload = {
+            "schema_id": "qcoder.pro_preview_shell.v0",
+            "signup_url": PREVIEW_SIGNUP_URL,
+            "service_backed": True,
+            "local_only": False,
+            "cards_local": False,
+            "status": "signup_required",
+        }
+        if args.json:
+            print(json.dumps(payload, indent=2, sort_keys=True))
+        else:
+            print("qCoder Pro Preview signup")
+            print(f"  url: {PREVIEW_SIGNUP_URL}")
+            print("  mode: service-backed")
+            print("  note: no confidential Pro analysis is bundled locally")
+        return 0
+
+    if cmd == "status":
+        payload = {
+            "schema_id": "qcoder.pro_preview_shell.v0",
+            "service_backed": True,
+            "configured": False,
+            "status": "not_configured",
+            "cards_local": False,
+            "upload_on_explicit_pro_command_only": True,
+        }
+        if args.json:
+            print(json.dumps(payload, indent=2, sort_keys=True))
+        else:
+            print("qCoder Pro status: not configured.")
+            print("  mode: service-backed preview shell")
+            print("  local cards/analysis: disabled in public package")
+            print(f"  signup: {PREVIEW_SIGNUP_URL}")
+        return 0
+
+    print(
+        "qcoder pro: hosted Pro Preview service is not configured in this build.\n"
+        f"Run `qcoder pro signup` for access details: {PREVIEW_SIGNUP_URL}",
+        file=sys.stderr,
+    )
+    return 2
+
+
 def _print_root_help() -> None:
-    """Top-level help (subcommand parsers own analyze/batch --help)."""
     print(
-        "usage: qcoder [--version | -V] [-h] {analyze,batch,context,review} ...\n\n"
+        "usage: qcoder [--version | -V] [-h] {analyze,batch,context,review,pro} ...\n\n"
         "Quantum circuit analysis CLI.\n\n"
         "positional arguments:\n"
-        "  {analyze,batch,context,review}  subcommand\n\n"
+        "  {analyze,batch,context,review,pro}  subcommand\n\n"
         "  analyze          Analyze a QASM file (feature extraction + metadata + run config).\n"
-        "  batch            Batch extract a directory to JSONL (requires --out).\n\n"
+        "  batch            Batch extract a directory to JSONL (requires --out).\n"
         "  context          Build deterministic preflight context artifacts.\n"
-        "  review           Build deterministic execution review artifacts from counts.\n\n"
+        "  review           Build deterministic execution review artifacts from counts.\n"
+        "  pro              Service-backed Pro Preview shell (signup/status/workflow stub).\n\n"
         "Run `qcoder <subcommand> --help` for subcommand options.",
         end="",
     )
@@ -233,9 +328,11 @@ def main(argv: list[str] | None = None) -> int:
         return _cmd_context(rest)
     if cmd == "review":
         return _cmd_review(rest)
+    if cmd == "pro":
+        return _cmd_pro(rest)
 
     print(
-        f"qcoder: unknown subcommand {cmd!r} (expected analyze, batch, context, or review)",
+        f"qcoder: unknown subcommand {cmd!r} (expected analyze, batch, context, review, or pro)",
         file=sys.stderr,
     )
     print("Run `qcoder --help` for usage.", file=sys.stderr)

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/src/qcoder/engines/feature_extraction/ir.py

@@ -21,12 +21,20 @@ class Operation:
         return len(self.qubits)
 
 
+@dataclass(frozen=True)
+class QRegDecl:
+    name: str
+    size: int
+    base: int
+
+
 @dataclass(frozen=True)
 class CircuitIR:
     n_qubits: int
     n_cbits: int
     operations: tuple[Operation, ...]
     qasm_format: str  # "qasm2" | "qasm3" | "unknown"
+    qregs: tuple[QRegDecl, ...] = ()
 
     @property
     def source_format(self) -> str:

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/src/qcoder/engines/feature_extraction/qasm2_regex_parser.py

@@ -4,7 +4,7 @@ import re
 from dataclasses import dataclass
 from pathlib import Path
 
-from .ir import CircuitIR, Operation
+from .ir import CircuitIR, Operation, QRegDecl
 
 
 _RE_QREG = re.compile(r"^\s*qreg\s+([A-Za-z_]\w*)\s*\[\s*(\d+)\s*\]\s*;\s*$")
@@ -26,6 +26,7 @@ _RE_QREF = re.compile(r"([A-Za-z_]\w*)\s*\[\s*(\d+)\s*\]")
 class _Regs:
     qreg_base: dict[str, int]
     qreg_size: dict[str, int]
+    qreg_order: tuple[str, ...]
     n_qubits: int
     n_cbits: int
 
@@ -52,6 +53,7 @@ def _detect_format(lines: list[str]) -> str:
 def _build_regs(lines: list[str]) -> _Regs:
     qreg_base: dict[str, int] = {}
     qreg_size: dict[str, int] = {}
+    qreg_order: list[str] = []
     n_qubits = 0
     n_cbits = 0
 
@@ -67,6 +69,7 @@ def _build_regs(lines: list[str]) -> _Regs:
             if name not in qreg_base:
                 qreg_base[name] = n_qubits
                 qreg_size[name] = size
+                qreg_order.append(name)
                 n_qubits += size
             continue
 
@@ -76,7 +79,13 @@ def _build_regs(lines: list[str]) -> _Regs:
             n_cbits += size
             continue
 
-    return _Regs(qreg_base=qreg_base, qreg_size=qreg_size, n_qubits=n_qubits, n_cbits=n_cbits)
+    return _Regs(
+        qreg_base=qreg_base,
+        qreg_size=qreg_size,
+        qreg_order=tuple(qreg_order),
+        n_qubits=n_qubits,
+        n_cbits=n_cbits,
+    )
 
 
 def _flatten_qubits(arg_str: str, regs: _Regs) -> tuple[int, ...]:
@@ -152,11 +161,15 @@ def _parse_qasm2_lines(lines: list[str]) -> CircuitIR:
         ops.append(Operation(name=name.lower(), qubits=qubits, params=params, line_index=line_index, op_index=op_index, is_custom=is_custom))
         op_index += 1
 
+    qregs = tuple(
+        QRegDecl(name=name, size=regs.qreg_size[name], base=regs.qreg_base[name]) for name in regs.qreg_order
+    )
     return CircuitIR(
         n_qubits=regs.n_qubits,
         n_cbits=regs.n_cbits,
         operations=tuple(ops),
         qasm_format=fmt,
+        qregs=qregs,
     )
 
 

qcoder-0.5.0a1/src/qcoder.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: qcoder
+Version: 0.5.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>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://qcoder.ai
+Project-URL: Documentation, https://qcoder.ai/manual/
+Project-URL: Repository, https://github.com/QuantumReadySolutions/qCoder
+Project-URL: Issues, https://github.com/QuantumReadySolutions/qCoder/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+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` is a local, deterministic quantum circuit evidence CLI.
+
+Free `qcoder` commands run offline and do not call hosted services, upload telemetry, or run QPU/simulator jobs.
+
+## Public CLI surface
+
+- `qcoder analyze`
+- `qcoder batch`
+- `qcoder context`
+- `qcoder review`
+- `qcoder pro` (service-backed Preview shell/stub)
+
+## Quick start
+
+Install:
+
+```bash
+pip install qcoder
+```
+
+Analyze a circuit:
+
+```bash
+qcoder analyze path/to/circuit.qasm --json
+```
+
+Create local context and review artifacts:
+
+```bash
+qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md preflight.context.md
+qcoder review --counts-json counts.json --format qiskit_counts --preflight-json preflight.context.json --out-json execution.review.json --out-md execution.review.md
+```
+
+Pro Preview shell:
+
+```bash
+qcoder pro --help
+qcoder pro signup
+qcoder pro status
+```
+
+`qcoder pro workflow` is a service-backed stub in this slice; confidential Pro analysis is not bundled in this package.
+
+Architecture notes: [`docs/architecture.md`](docs/architecture.md).
+
+## Optional extras
+
+```bash
+pip install "qcoder[qiskit]"
+pip install "qcoder[cirq]"
+pip install "qcoder[pennylane]"
+```
+
+## License
+
+Apache-2.0 (see `LICENSE` and `NOTICE`).

{qcoder-0.4.0a2 → qcoder-0.5.0a1}/src/qcoder.egg-info/SOURCES.txt

@@ -4,8 +4,6 @@ MANIFEST.in
 NOTICE
 README.md
 pyproject.toml
-docs/architecture.md
-docs/model-cards/resource-guidance-local-v0.md
 src/qcoder/__init__.py
 src/qcoder/__main__.py
 src/qcoder/cli.py
@@ -61,32 +59,4 @@ src/qcoder/pipelines/analyze.py
 src/qcoder/pipelines/batch.py
 src/qcoder/pipelines/context.py
 src/qcoder/pipelines/review.py
-src/qcoder/tools/batch.py
-tests/__init__.py
-tests/test_adjoint_eligibility.py
-tests/test_analyze_pipeline.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
-tests/test_context_bundle.py
-tests/test_cut_profile.py
-tests/test_entangling_layers.py
-tests/test_examples_smoke.py
-tests/test_feature_glossary.py
-tests/test_feature_profiles.py
-tests/test_gate_set_stats.py
-tests/test_guidance_model_pack.py
-tests/test_interaction_graph_metrics.py
-tests/test_mirror_build.py
-tests/test_parse_qasm2_text.py
-tests/test_pennylane_intake.py
-tests/test_qiskit_intake.py
-tests/test_resource_guidance.py
-tests/test_review_bundle.py
-tests/test_review_counts_v0.py
-tests/test_review_qiskit_counts.py
-tests/test_schema_stability.py
-tests/test_smoke.py
-tests/test_temporal_spans.py
+src/qcoder/tools/batch.py