qdsv-runtime 0.2.0a1

QDSV Runtime Alpha: the public execution shell for canonical QDSV operation programs.

QDSV Runtime Alpha

QDSV Runtime Alpha is the public execution shell for problem-first QDSV workflows. Its canonical engine is QDSV Operation Compiler v1.

It ties together the public QDSV developer stack:

QIntent -> ProblemSpec -> QDSV Runtime Alpha / Operation Compiler -> operation program
                                                               -> Bridge -> OpenQASM / Qiskit
                                                               -> backend execution + evidence

Qruba -> visual orchestration over the same Runtime/Compiler path
QDSV -> semantic model and private compiler implementation

Runtime Alpha does not embed or expose the private QDSV compiler implementation. It calls the canonical compiler API, records a safe operation-program passport and program digest, and then allows adapters such as Bridge to export the same compiled intent.

Install

For local development:

pip install -e .

When published:

pip install qdsv-runtime

Before the PyPI release, users can install from GitHub after the public repository is created:

pip install git+https://github.com/qdsvquantum-afk/qdsv-runtime.git

CLI Quickstart

Create a workspace:

qdsv init

Validate a QIntent file:

qdsv validate examples/basic.qintent

Compile QIntent into the canonical operation program:

qdsv compile-intent examples/basic.qintent --rows examples/rows.json

Compile a canonical ProblemSpec directly:

qdsv compile examples/problem.json

QIntent compilation is available through the controlled public preview quota. Direct arbitrary ProblemSpec compilation requires an authorized deployment or a local/private QDSV node because it exposes a broader expert surface.

Build a Bridge artifact from a supported Bridge spec:

qdsv build examples/bridge_spec.json --target bridge

Generate a local runtime report:

qdsv report

Docker/private demo images can also include the same CLI:

docker exec qruba-api-private qdsv --help

Python SDK

from qdsv_runtime import QDSVRuntime

runtime = QDSVRuntime()
runtime.init_workspace()
runtime.validate_intent("examples/basic.qintent")
runtime.compile_intent("examples/basic.qintent", rows_path="examples/rows.json")
runtime.compile_problem("examples/problem.json")
runtime.build_bridge("examples/bridge_spec.json")
runtime.write_report()

Public Alpha Scope

This alpha includes:

• workspace creation;
• QIntent-to-operation-program compilation through the canonical engine;
• direct ProblemSpec-to-operation-program compilation;
• Bridge export backed by the same compiler authority;
• safe program digests, capability status, resource summaries and verification status;
• local artifact storage;
• reproducibility report generation;
• CLI commands for small examples.

This alpha does not include:

• private QDSV Runtime internals;
• semantic compiler internals;
• lowering logic;
• backend selection internals;
• private scoring formulas;
• production scheduler;
• user/tenant management;
• marketplace/plugins;
• local execution of the private semantic engine.

Positioning

QDSV Runtime Alpha is not a quantum operating system and Bridge is not its engine. Runtime is the executable product layer around the canonical QDSV operation program; QIntent formulates intent, Qruba orchestrates it, and Bridge exports compatible artifacts without creating a parallel compilation route.