qcoder 0.5.0a7__tar.gz → 0.5.0a8__tar.gz

{qcoder-0.5.0a7 → qcoder-0.5.0a8}/CHANGELOG.md

@@ -1,16 +1,14 @@
 # Changelog
 
 
-## 0.5.0a7
-
-- Add local read-only qCoder MCP for Cursor-oriented Explorer Launch workflows.
-- Add MCP tools for local circuit analysis, context-pack generation, counts review, bounded findings, claim boundaries, next checks, and share-safe artifact sanitization.
-- Document the Evidence-Grounded Coding Loop and preserve the manual artifact handoff as launch-required even when local MCP is available.
-- Harden Windows-created inputs by accepting UTF-8 BOM in QASM and JSON paths used by local analysis/review.
-- Improve `qcoder review` error guidance for malformed JSON and Qiskit counts input.
-- Add MCP, share-safe, claim-boundary, and Windows/QASM/Qiskit tests plus release-check MCP stdio rehearsal.
-- Preserve launch boundaries: no public hosted MCP claim, no live service calls from MCP, no token requirement, no autonomous code modification, no QPU/simulator submission, and no runtime/fidelity/backend/QPU/correctness/advantage claims.
-- This is release-candidate preparation only until separately published.
+## 0.5.0a8
+
+- Add `qcoder context-bridge mcp serve`, a stdio Context Bridge MCP adapter for eligible Explorer users.
+- Add `qcoder context-bridge mcp smoke --token-file <path> --json` for sanitized install verification.
+- Expose only the approved Context Bridge tools: guided evidence context, prompt context, Evidence Context Pack, Context Session Card, and Run Readiness Card.
+- Read Context Bridge tokens from a local token file only; token values are not printed and are not required in IDE config.
+- Reject raw QASM, raw counts, paths, unsupported artifact lookup, unknown tools, and non-current-context inputs before forwarding.
+- Preserve qCoder OSS local commands, Explorer evidence commands, and archived Pro shell boundaries.
 
 
 ## 0.5.0a6

{qcoder-0.5.0a7/src/qcoder.egg-info → qcoder-0.5.0a8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qcoder
-Version: 0.5.0a7
+Version: 0.5.0a8
 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>
@@ -15,8 +15,6 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Scientific/Engineering
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -42,17 +40,18 @@ The current public local path is **qCoder OSS**. OSS commands run locally and do
 - `qcoder batch`
 - `qcoder context`
 - `qcoder review`
-- `qcoder mcp` (local read-only Cursor MCP tools)
 - `qcoder explorer` (Explorer Beta account-backed status/demo/evidence checks)
+- `qcoder context-bridge` (token-backed Context Bridge MCP adapter for eligible Explorer users)
 - `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.
+Public `qcoder` ships **OSS local commands**, Explorer Beta compatibility commands, and the Context Bridge adapter command for eligible Explorer users. 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.
+- **Context Bridge adapter commands** (`qcoder context-bridge mcp serve`, `qcoder context-bridge mcp smoke`) are for eligible Explorer users with support-managed Context Bridge token access. They expose bounded current-evidence context tools to configured MCP clients and read tokens from a local token file.
 - 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.
@@ -90,14 +89,6 @@ qcoder review --counts-json counts.json --format qiskit_counts --preflight-json
 
 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.
 
-Local Cursor MCP:
-
-```bash
-qcoder mcp serve
-```
-
-The MCP server uses explicit user-selected local inputs only. It reads, inspects, explains, bounds, and recommends; it does not execute circuits, modify user code, read arbitrary files, call live services, or require tokens. See [Explorer Evidence-Grounded Coding Loop](examples/08_explorer_evidence_grounded_coding_loop.md) for the manual artifact loop, Cursor MCP setup, and claim boundaries.
-
 Explorer Beta compatibility checks and archived Pro bootstrap:
 
 ```bash
@@ -107,6 +98,8 @@ 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 context-bridge mcp serve --help
+qcoder context-bridge mcp smoke --token-file ~/.qcoder/context-bridge/token.txt --json
 qcoder pro --help
 ```
 

{qcoder-0.5.0a7 → qcoder-0.5.0a8}/README.md

@@ -10,17 +10,18 @@ The current public local path is **qCoder OSS**. OSS commands run locally and do
 - `qcoder batch`
 - `qcoder context`
 - `qcoder review`
-- `qcoder mcp` (local read-only Cursor MCP tools)
 - `qcoder explorer` (Explorer Beta account-backed status/demo/evidence checks)
+- `qcoder context-bridge` (token-backed Context Bridge MCP adapter for eligible Explorer users)
 - `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.
+Public `qcoder` ships **OSS local commands**, Explorer Beta compatibility commands, and the Context Bridge adapter command for eligible Explorer users. 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.
+- **Context Bridge adapter commands** (`qcoder context-bridge mcp serve`, `qcoder context-bridge mcp smoke`) are for eligible Explorer users with support-managed Context Bridge token access. They expose bounded current-evidence context tools to configured MCP clients and read tokens from a local token file.
 - 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.
@@ -58,14 +59,6 @@ qcoder review --counts-json counts.json --format qiskit_counts --preflight-json
 
 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.
 
-Local Cursor MCP:
-
-```bash
-qcoder mcp serve
-```
-
-The MCP server uses explicit user-selected local inputs only. It reads, inspects, explains, bounds, and recommends; it does not execute circuits, modify user code, read arbitrary files, call live services, or require tokens. See [Explorer Evidence-Grounded Coding Loop](examples/08_explorer_evidence_grounded_coding_loop.md) for the manual artifact loop, Cursor MCP setup, and claim boundaries.
-
 Explorer Beta compatibility checks and archived Pro bootstrap:
 
 ```bash
@@ -75,6 +68,8 @@ 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 context-bridge mcp serve --help
+qcoder context-bridge mcp smoke --token-file ~/.qcoder/context-bridge/token.txt --json
 qcoder pro --help
 ```
 

{qcoder-0.5.0a7 → qcoder-0.5.0a8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qcoder"
-version = "0.5.0a7"
+version = "0.5.0a8"
 description = "Quantum circuit analysis and structured feature extraction tools."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -23,8 +23,6 @@ classifiers = [
     "Topic :: Scientific/Engineering",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
 ]
 dependencies = ["numpy"]
 

{qcoder-0.5.0a7 → qcoder-0.5.0a8}/src/qcoder/__init__.py

@@ -1,3 +1,3 @@
 __all__ = []
-__version__ = "0.5.0a7"
+__version__ = "0.5.0a8"
 file = __file__

{qcoder-0.5.0a7 → qcoder-0.5.0a8}/src/qcoder/cli.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import argparse
 import json
 import sys
-from json import JSONDecodeError
 from pathlib import Path
 
 from qcoder.pipelines.analyze import analyze_qasm
@@ -285,29 +284,14 @@ def _cmd_review(argv: list[str]) -> int:
     )
     args = p.parse_args(argv)
 
-    try:
-        write_execution_review(
-            counts_json=args.counts_json,
-            counts_format=args.counts_format,
-            preflight_json=args.preflight_json,
-            out_json=args.out_json,
-            out_md=args.out_md,
-            share_safe=args.share_safe,
-        )
-    except JSONDecodeError as exc:
-        print(
-            f"qcoder review: input JSON could not be parsed at line {exc.lineno}, column {exc.colno}. "
-            "Check that the counts/preflight file is UTF-8 JSON.",
-            file=sys.stderr,
-        )
-        return 2
-    except ValueError as exc:
-        print(
-            f"qcoder review: {exc}. For Qiskit counts, use --format qiskit_counts with a JSON object "
-            'like {"00": 10, "11": 6} or {"counts": {"00": 10, "11": 6}}.',
-            file=sys.stderr,
-        )
-        return 2
+    write_execution_review(
+        counts_json=args.counts_json,
+        counts_format=args.counts_format,
+        preflight_json=args.preflight_json,
+        out_json=args.out_json,
+        out_md=args.out_md,
+        share_safe=args.share_safe,
+    )
     json_label = "<redacted-local-path>" if args.share_safe else args.out_json
     md_label = "<redacted-local-path>" if args.share_safe else args.out_md
     print(f"Wrote execution review JSON to {json_label}", file=sys.stderr)
@@ -315,30 +299,6 @@ def _cmd_review(argv: list[str]) -> int:
     return 0
 
 
-def _cmd_mcp(argv: list[str]) -> int:
-    p = argparse.ArgumentParser(
-        prog="qcoder mcp",
-        add_help=True,
-        description=(
-            "Local read-only qCoder MCP for Cursor. Uses explicit user-selected inputs only; "
-            "does not execute circuits, modify code, use tokens, or call live services."
-        ),
-    )
-    sub = p.add_subparsers(dest="mcp_command")
-    p_serve = sub.add_parser("serve", help="Serve qCoder tools over MCP stdio.")
-    p_serve.set_defaults(mcp_command="serve")
-    args = p.parse_args(argv)
-    if args.mcp_command is None:
-        p.print_help()
-        return 0
-    if args.mcp_command == "serve":
-        from qcoder.mcp.server import serve_stdio
-
-        return serve_stdio()
-    p.print_help()
-    return 0
-
-
 def _run_pro_preview_demo_check(
     *,
     base_url_override: str | None,
@@ -859,6 +819,12 @@ def _cmd_student(argv: list[str]) -> int:
     return _cmd_explorer(argv, compatibility_alias=True)
 
 
+def _cmd_context_bridge(argv: list[str]) -> int:
+    from qcoder.context_bridge_mcp import main as context_bridge_main
+
+    return context_bridge_main(argv)
+
+
 def _cmd_pro(argv: list[str]) -> int:
     p = argparse.ArgumentParser(
         prog="qcoder pro",
@@ -1240,16 +1206,16 @@ def _cmd_pro(argv: list[str]) -> int:
 
 def _print_root_help() -> None:
     print(
-        "usage: qcoder [--version | -V] [-h] {analyze,batch,context,review,mcp,explorer,pro,student} ...\n\n"
+        "usage: qcoder [--version | -V] [-h] {analyze,batch,context,review,explorer,context-bridge,pro,student} ...\n\n"
         "Quantum circuit analysis CLI.\n\n"
         "positional arguments:\n"
-        "  {analyze,batch,context,review,mcp,explorer,pro,student}  subcommand\n\n"
+        "  {analyze,batch,context,review,explorer,context-bridge,pro,student}  subcommand\n\n"
         "  analyze          Analyze a QASM file (feature extraction + metadata + run config).\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"
-        "  mcp              Serve local read-only qCoder tools for Cursor over MCP stdio.\n"
         "  explorer         Explorer Beta status/demo/evidence checks.\n"
+        "  context-bridge   Run the Context Bridge MCP adapter for eligible Explorer users.\n"
         "  pro              Archived Pro client-contract shell (not current public product).\n"
         "  student          Compatibility alias for Explorer Beta checks.\n\n"
         "Run `qcoder <subcommand> --help` for subcommand options.",
@@ -1280,17 +1246,17 @@ def main(argv: list[str] | None = None) -> int:
         return _cmd_context(rest)
     if cmd == "review":
         return _cmd_review(rest)
-    if cmd == "mcp":
-        return _cmd_mcp(rest)
     if cmd == "explorer":
         return _cmd_explorer(rest)
+    if cmd == "context-bridge":
+        return _cmd_context_bridge(rest)
     if cmd == "pro":
         return _cmd_pro(rest)
     if cmd == "student":
         return _cmd_student(rest)
 
     print(
-        f"qcoder: unknown subcommand {cmd!r} (expected analyze, batch, context, review, mcp, explorer, pro, or student)",
+        f"qcoder: unknown subcommand {cmd!r} (expected analyze, batch, context, review, explorer, context-bridge, pro, or student)",
         file=sys.stderr,
     )
     print("Run `qcoder --help` for usage.", file=sys.stderr)