qcoder 0.4.0a2__tar.gz → 0.5.0a2__tar.gz

{qcoder-0.4.0a2 → qcoder-0.5.0a2}/CHANGELOG.md

@@ -4,6 +4,46 @@ 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.
 
+## Unreleased
+
+## 0.5.0a2 (alpha — public Free + Pro Preview client contract)
+
+Second public alpha for the **Option 3 product line**: unchanged Free local/offline CLI plus an expanded **Pro Preview bootstrap/client contract** (not a generally available hosted Pro product).
+
+### Added
+
+- Public-safe **Pro Preview bootstrap** commands: `qcoder pro signup`, `login`, `install`, `status`, `validate` with local token/config support only.
+- **`qcoder pro workflow --dry-run-manifest`** — writes `qcoder.pro_preview.workflow_manifest.v0` locally (QASM hashes/bytes plus local Free analysis); no network.
+- **Explicit configured manifest-only service submit** — `qcoder pro workflow --submit --service-url <url>` with optional `--manifest-out`; requires token and a non-default configured service URL; sanitizes manifest before POST.
+- Stronger **public package safety** checks, Pro Preview unit tests, and release rehearsal coverage in CI.
+
+### Scope / boundaries
+
+- **No** generally available production hosted Pro service, public account/token issuance from qcoder.ai, or sellable hosted Pro product behavior.
+- **No** artifact upload, source upload, or background upload in this submit slice.
+- **No** local confidential Pro analysis, cards, or `qcoder.pro_v0` in the wheel.
+- **No** telemetry upload or training delivery.
+- **No** QPU, simulator, or provider execution in CLI flows.
+- Free commands (`analyze`, `batch`, `context`, `review`) remain local/offline and useful without Pro.
+
+## 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.0a2}/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.0a2/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: qcoder
+Version: 0.5.0a2
+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` (Pro bootstrap and client contract; non-confidential local plumbing only)
+
+## Pro Preview boundaries
+
+Public `qcoder` ships **Free local commands** plus a **Pro bootstrap/client contract**. It is **not** the sellable hosted Pro product.
+
+- **Free commands** (`analyze`, `batch`, `context`, `review`) run offline. They do not upload data, call a qCoder hosted service, or run QPU/simulator jobs.
+- **`qcoder pro` bootstrap** (`signup`, `login`, `install`, `status`, `validate`) stores local token/config only. It does not upload circuits, run confidential analysis, or generate Pro cards locally.
+- **`qcoder pro workflow --dry-run-manifest`** writes a local JSON contract (`qcoder.pro_preview.workflow_manifest.v0`) and performs **no network calls**. This is the default path for most users.
+- **`qcoder pro workflow --submit`** posts a **sanitized manifest only** to an **explicitly configured** `--service-url` (or `QCODER_PRO_API_URL`). Use it only when QRS has given you a service URL and token. The default `https://qcoder.ai/preview` URL is **not** accepted for submit.
+- There is **no generally available production hosted Pro service**, account/token issuance, or artifact upload in this public-main surface. Production hosted service, Cloud Run/GCS, and confidential analysis are separate/future.
+- **No confidential Pro analysis or cards** are bundled in this package. Token-gating is **access control only**, not a secrecy boundary.
+
+## 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 bootstrap (local contract rehearsal):
+
+```bash
+qcoder pro --help
+qcoder pro signup
+qcoder pro install --token <token-if-provided>
+qcoder pro status
+qcoder pro validate
+qcoder pro workflow --qasm path/to/circuit.qasm --dry-run-manifest pro.workflow.manifest.json
+```
+
+Use **`--dry-run-manifest`** unless QRS has given you a non-default service URL and token for contract rehearsal. Manifest-only submit (no artifact upload) is opt-in:
+
+```bash
+qcoder pro workflow --qasm path/to/circuit.qasm --submit --service-url <url-qrs-provided>
+```
+
+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.0a2/README.md

@@ -0,0 +1,76 @@
+# 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` (Pro bootstrap and client contract; non-confidential local plumbing only)
+
+## Pro Preview boundaries
+
+Public `qcoder` ships **Free local commands** plus a **Pro bootstrap/client contract**. It is **not** the sellable hosted Pro product.
+
+- **Free commands** (`analyze`, `batch`, `context`, `review`) run offline. They do not upload data, call a qCoder hosted service, or run QPU/simulator jobs.
+- **`qcoder pro` bootstrap** (`signup`, `login`, `install`, `status`, `validate`) stores local token/config only. It does not upload circuits, run confidential analysis, or generate Pro cards locally.
+- **`qcoder pro workflow --dry-run-manifest`** writes a local JSON contract (`qcoder.pro_preview.workflow_manifest.v0`) and performs **no network calls**. This is the default path for most users.
+- **`qcoder pro workflow --submit`** posts a **sanitized manifest only** to an **explicitly configured** `--service-url` (or `QCODER_PRO_API_URL`). Use it only when QRS has given you a service URL and token. The default `https://qcoder.ai/preview` URL is **not** accepted for submit.
+- There is **no generally available production hosted Pro service**, account/token issuance, or artifact upload in this public-main surface. Production hosted service, Cloud Run/GCS, and confidential analysis are separate/future.
+- **No confidential Pro analysis or cards** are bundled in this package. Token-gating is **access control only**, not a secrecy boundary.
+
+## 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 bootstrap (local contract rehearsal):
+
+```bash
+qcoder pro --help
+qcoder pro signup
+qcoder pro install --token <token-if-provided>
+qcoder pro status
+qcoder pro validate
+qcoder pro workflow --qasm path/to/circuit.qasm --dry-run-manifest pro.workflow.manifest.json
+```
+
+Use **`--dry-run-manifest`** unless QRS has given you a non-default service URL and token for contract rehearsal. Manifest-only submit (no artifact upload) is opt-in:
+
+```bash
+qcoder pro workflow --qasm path/to/circuit.qasm --submit --service-url <url-qrs-provided>
+```
+
+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.0a2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qcoder"
-version = "0.4.0a2"
+version = "0.5.0a2"
 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.0a2}/src/qcoder/__init__.py

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