qcoder 0.5.0a4__tar.gz → 0.5.0a6__tar.gz

{qcoder-0.5.0a4 → qcoder-0.5.0a6}/CHANGELOG.md

@@ -1,6 +1,26 @@
 # Changelog
 
 
+## 0.5.0a6
+
+- Add share-safe / redacted artifact mode for artifacts intended for ChatGPT, Cursor, email, GitHub issues, or support threads.
+- Add `--share-safe` / `--redact` to OSS artifact commands and Explorer evidence file output.
+- Emit share-safety metadata in JSON artifacts: `share_safe`, `redactions_applied`, `raw_qasm_included`, `local_paths_included`, and `tokens_included`.
+- Add a visible share-safe note to Markdown artifacts.
+- Fix Windows free-text path redaction, including `C:\Users\...` paths, Windows forward-slash paths, UNC paths, home-relative paths, Linux home paths, and WSL-mounted Windows paths.
+- Preserve normal rich local artifacts by default; share-safe mode is opt-in.
+- Share-safe mode is designed for safer sharing and users should still review artifacts before sharing. It is not a privacy guarantee.
+- Remaining P1 hardening: forward-slash UNC variants, broader Linux root patterns, independent post-scan hardening, and expanded docs wording.
+
+
+## 0.5.0a5
+
+- Add `qcoder explorer evidence` as the primary Explorer Beta guided-evidence surface.
+- Add derived-context Explorer evidence for user-owned OpenQASM 2 artifacts without raw hosted QASM upload.
+- Preserve `qcoder student evidence` as a beta compatibility alias.
+- Align public package wording with qCoder OSS and Explorer Beta; Pro is not launched or a current public product.
+- Preserve the OSS local artifact path (`analyze`, `batch`, `context`, `review`) for no-account, no-token local workflows.
+
 ## 0.5.0a4
 
 - Add public Student aliases: `qcoder student status` and `qcoder student demo`.

qcoder-0.5.0a6/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: qcoder
+Version: 0.5.0a6
+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.
+
+The current public local path is **qCoder OSS**. OSS commands run locally 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 explorer` (Explorer Beta account-backed status/demo/evidence checks)
+- `qcoder student` (temporary compatibility alias for Explorer Beta)
+- `qcoder pro` (archived pilot/bootstrap client contract; non-confidential local plumbing only, not a current public product path)
+
+## Current product boundaries
+
+Public `qcoder` ships **OSS local commands** plus Explorer Beta compatibility commands. Pro is not launched and is not a current public product path.
+
+- **OSS commands** (`analyze`, `batch`, `context`, `review`) are Apache-2.0, local-first/offline, and useful without an account or token. They do not upload data, call a qCoder hosted service, or run QPU/simulator jobs.
+- **Explorer Beta commands** (`qcoder explorer status`, `qcoder explorer demo`, `qcoder explorer evidence`) are account-backed checks for Explorer Beta status, built-in guided evidence samples, and derived-context guided evidence for user-owned OpenQASM 2 artifacts. The older `qcoder student ...` commands remain available as beta compatibility aliases.
+- Explorer Beta custom evidence uses locally derived qCoder context/features. The CLI may read QASM locally, but the hosted request must not include raw QASM, raw source text, local paths, operation lists, raw counts, notebooks, prompts, tokens, auth headers, or cookies.
+- Explorer Beta custom evidence is stateless in this v0 slice; it does not create persistent Explorer history.
+- **`qcoder pro` bootstrap/workflow commands** are archived pilot/client-contract surfaces. They are not a Pro purchase path, not a current public signup path, and not generally available hosted Pro.
+- There is **no generally available production hosted Pro service**, Pro account/token issuance, artifact/source upload, telemetry/training ingest, confidential local analyzer/cards, QPU/provider execution, or launched Pro V0.0 behavior in this public-main surface.
+- **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
+```
+
+For artifacts you intend to paste into ChatGPT, Cursor, email, GitHub issues, or support threads, add `--share-safe`:
+
+```bash
+qcoder analyze path/to/circuit.qasm --json --share-safe
+qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md preflight.context.md --share-safe
+qcoder review --counts-json counts.json --format qiskit_counts --preflight-json preflight.context.json --out-json execution.review.json --out-md execution.review.md --share-safe
+```
+
+Share-safe mode is designed for safer sharing: it redacts local paths and token/header-like strings, adds `share_safe=true`, and marks raw QASM/local paths/tokens as not included. Review artifacts before sharing; this is not a guarantee that all sensitive project content has been removed.
+
+Explorer Beta compatibility checks and archived Pro bootstrap:
+
+```bash
+qcoder explorer status
+qcoder explorer demo
+qcoder explorer evidence
+qcoder explorer evidence --qasm path/to/circuit.qasm
+qcoder explorer evidence --context-json preflight.context.json
+qcoder explorer evidence --qasm path/to/circuit.qasm --out-json explorer.json --out-md explorer.md --share-safe
+qcoder pro --help
+```
+
+**Support-safe checklist**
+
+Safe to share with QRS support:
+
+- `qcoder --version`
+- command name
+- HTTP status or CLI error code
+- `job_id`, if produced
+- redacted output
+- manifest schema/version
+
+Do not share:
+
+- bearer tokens
+- secrets
+- source code
+- repository archives
+- notebooks
+- private prompts or chat transcripts
+- raw QASM/source artifacts through unsupported paths
+
+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.0a6/README.md

@@ -0,0 +1,105 @@
+# qCoder
+
+`qcoder` is a local, deterministic quantum circuit evidence CLI.
+
+The current public local path is **qCoder OSS**. OSS commands run locally 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 explorer` (Explorer Beta account-backed status/demo/evidence checks)
+- `qcoder student` (temporary compatibility alias for Explorer Beta)
+- `qcoder pro` (archived pilot/bootstrap client contract; non-confidential local plumbing only, not a current public product path)
+
+## Current product boundaries
+
+Public `qcoder` ships **OSS local commands** plus Explorer Beta compatibility commands. Pro is not launched and is not a current public product path.
+
+- **OSS commands** (`analyze`, `batch`, `context`, `review`) are Apache-2.0, local-first/offline, and useful without an account or token. They do not upload data, call a qCoder hosted service, or run QPU/simulator jobs.
+- **Explorer Beta commands** (`qcoder explorer status`, `qcoder explorer demo`, `qcoder explorer evidence`) are account-backed checks for Explorer Beta status, built-in guided evidence samples, and derived-context guided evidence for user-owned OpenQASM 2 artifacts. The older `qcoder student ...` commands remain available as beta compatibility aliases.
+- Explorer Beta custom evidence uses locally derived qCoder context/features. The CLI may read QASM locally, but the hosted request must not include raw QASM, raw source text, local paths, operation lists, raw counts, notebooks, prompts, tokens, auth headers, or cookies.
+- Explorer Beta custom evidence is stateless in this v0 slice; it does not create persistent Explorer history.
+- **`qcoder pro` bootstrap/workflow commands** are archived pilot/client-contract surfaces. They are not a Pro purchase path, not a current public signup path, and not generally available hosted Pro.
+- There is **no generally available production hosted Pro service**, Pro account/token issuance, artifact/source upload, telemetry/training ingest, confidential local analyzer/cards, QPU/provider execution, or launched Pro V0.0 behavior in this public-main surface.
+- **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
+```
+
+For artifacts you intend to paste into ChatGPT, Cursor, email, GitHub issues, or support threads, add `--share-safe`:
+
+```bash
+qcoder analyze path/to/circuit.qasm --json --share-safe
+qcoder context path/to/circuit.qasm --out-json preflight.context.json --out-md preflight.context.md --share-safe
+qcoder review --counts-json counts.json --format qiskit_counts --preflight-json preflight.context.json --out-json execution.review.json --out-md execution.review.md --share-safe
+```
+
+Share-safe mode is designed for safer sharing: it redacts local paths and token/header-like strings, adds `share_safe=true`, and marks raw QASM/local paths/tokens as not included. Review artifacts before sharing; this is not a guarantee that all sensitive project content has been removed.
+
+Explorer Beta compatibility checks and archived Pro bootstrap:
+
+```bash
+qcoder explorer status
+qcoder explorer demo
+qcoder explorer evidence
+qcoder explorer evidence --qasm path/to/circuit.qasm
+qcoder explorer evidence --context-json preflight.context.json
+qcoder explorer evidence --qasm path/to/circuit.qasm --out-json explorer.json --out-md explorer.md --share-safe
+qcoder pro --help
+```
+
+**Support-safe checklist**
+
+Safe to share with QRS support:
+
+- `qcoder --version`
+- command name
+- HTTP status or CLI error code
+- `job_id`, if produced
+- redacted output
+- manifest schema/version
+
+Do not share:
+
+- bearer tokens
+- secrets
+- source code
+- repository archives
+- notebooks
+- private prompts or chat transcripts
+- raw QASM/source artifacts through unsupported paths
+
+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.0a4 → qcoder-0.5.0a6}/pyproject.toml

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

{qcoder-0.5.0a4 → qcoder-0.5.0a6}/src/qcoder/__init__.py

@@ -1,3 +1,3 @@
 __all__ = []
-__version__ = "0.5.0a4"
+__version__ = "0.5.0a6"
 file = __file__