qcoder 0.5.0a1__tar.gz → 0.5.0a2__tar.gz

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

@@ -4,6 +4,28 @@ 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).

{qcoder-0.5.0a1 → qcoder-0.5.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qcoder
-Version: 0.5.0a1
+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>
@@ -40,7 +40,18 @@ Free `qcoder` commands run offline and do not call hosted services, upload telem
 - `qcoder batch`
 - `qcoder context`
 - `qcoder review`
-- `qcoder pro` (service-backed Preview shell/stub)
+- `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
 
@@ -63,15 +74,22 @@ qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md p
 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:
+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
 ```
 
-`qcoder pro workflow` is a service-backed stub in this slice; confidential Pro analysis is not bundled in this package.
+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).
 

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.5.0a1 → qcoder-0.5.0a2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qcoder"
-version = "0.5.0a1"
+version = "0.5.0a2"
 description = "Quantum circuit analysis and structured feature extraction tools."
 readme = "README.md"
 requires-python = ">=3.11"

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

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