Skip to content

Releases

Qleisli v0.3.0-beta

Qleisli v0.3.0-beta Pre-release
Pre-release

Choose a tag to compare

@MGYamada MGYamada released this 20 Nov 06:46

Qleisli v0.3.0-beta

This prerelease completes the reviewed v0.3.0-beta feature scope for
constitutional edition 2026. The fixed issue audit covers 125 applicable
issues and two approved exclusions. Beta completion record

The beta includes the common frontend, finite algebraic data types, coherent
control and owner folds, explicit ctrl and excl access, checked operation
arrows and Meaning contracts, and the canonical standard library bundled
with this compiler version. Source syntax and public Rust APIs include
incompatible changes from 0.2.9 and the alpha. The Reference and changelog
describe the supported profiles and migration. Generic QFT and the approved
scope exclusions remain deferred. Language Reference · Changelog

Proof scope

The two admitted QLV1 guarantees cover ownership and classical scope of the
original decoded root under their recorded premises. The broader Quantum
Safety, Physical Realizability, quantitative Resource Safety, and exactness
proof and enforcement obligations remain pending. The OpenQASM 3 and QIR
adapters are experimental tools for bounded testing and reference simulation.
They are unsuitable for real quantum hardware. Production proof scope

Verification and assets

The tag, crate, complete source archive and native verifier bundles bind to
checked commit ce71d151427af30f9fffe8d967524b905265701f. In the same
workflow attempt, all 25 jobs passed, including full Lean and native replay,
Rust and MSRV checks, packaging and fresh installation. The attached
release-validation.json and SHA256SUMS record artifact identities.
The Linux x86_64 and macOS arm64 native checker archives are the audited
bundles from this exact run. Full release-readiness CI

The crate name is qleisli and the version is 0.3.0-beta. The complete
source archive retains the release audit inputs, original issue snapshots,
and historical evidence. The companion tools have separate release records.

Copyright 2026 Qleisli Project Contributors. SPDX-License-Identifier: Apache-2.0.
See LICENSE and NOTICE for historical and third-party attribution.

Qleisli v0.3.0-alpha

Qleisli v0.3.0-alpha Pre-release
Pre-release

Choose a tag to compare

@MGYamada MGYamada released this 11 Oct 18:24

Qleisli v0.3.0-alpha

Qleisli is an experimental language for structured quantum algorithms. This
prerelease is a development snapshot, not completion of the v0.3.0 feature goal
or a stable compatibility promise. The crate version is 0.3.0-alpha; the
constitutional edition remains 2026. Source syntax and public Rust APIs
include incompatible changes from 0.2.9; consult the Language Reference and
CHANGELOG for the implemented contracts and migrations.

This snapshot includes the common frontend, explicit classical and quantum
types and ownership, checked operation and Meaning contracts, and independent
native Lean verification. Documentation lives in the single mdBook,
Qleisli Programming Language. Separate ecosystem tools are independent
projects and are not part of this crate release.

The Constitution, adopted QS/PR/RS interpretations and exactness supplement
remain in force. Exactly two scoped QLV1 guarantees are admitted: ownership
and classical scope of the original decoded root, under their recorded
premises. Broader QS, PR, quantitative RS and exactness proof/enforcement
obligations remain pending. Native IR acceptance and successful tests do not
establish full source/runtime preservation or constitutional conformance.

Remaining feature Issues, generic QFT and deferred features are not declared
complete by this publication. The approved snapshot scope and human decision
are recorded in Issue #351 and the repository's release records.

OpenQASM 3 / QIR adapters are experimental test features, unsuitable for and
not recommended on real quantum hardware. macOS distribution is under
consideration; this release provides no macOS installation instructions.

The published tag, crate and attached validation assets must identify the same
checked commit. Release validation retains all required jobs, full proof
replay, independent checks, package/fresh-install checks and representative
--quick corpus reporting. See the release validation assets for the actual
commit, run/attempt and checksums.

Qleisli Project Contributors. Apache-2.0; historical and third-party notices
remain in LICENSE, NOTICE and the source archive.
The registry crate omits historical validation records and experimental
material; the attached complete source archive preserves them for reproduction.

Qleisli and its tools are independent projects and are not affiliated with,
endorsed by, or sponsored by the Rust Project or the Rust Foundation. Rust and
Cargo are trademarks of the Rust Foundation.

Validation: full CI and release readiness, attempt 1, commit 45adec93bc1717d7696d4bfcdf1d386517546e01. All eight validation producers and eight required contexts passed in that attempt. Representative corpus mode: quick-representative-v1; exhaustive validation was not used.

Qleisli v0.2.9 — Lean-only native verification

Choose a tag to compare

@MGYamada MGYamada released this 03 Oct 22:03

Qleisli 0.2.9 makes the native Lean checker the sole production verifier. This release includes an explicitly approved breaking migration before wider adoption (decision #276).

Install

Install the Rust CLI/library from crates.io:

cargo install qleisli --version 0.2.9 --locked

Verification and execution also require the matching qleisli-kernel 0.2.9. Download the archive for your platform and its .sha256 file from this release:

Platform Archive
macOS, Apple Silicon qleisli-kernel-0.2.9-aarch64-apple-darwin.tar.gz
Linux, x86-64 qleisli-kernel-0.2.9-x86_64-unknown-linux-gnu.tar.gz

Verify the checksum (shasum -a 256 -c FILE.sha256 on macOS, or sha256sum -c FILE.sha256 on Linux), then extract the complete archive and preserve its license files. Select its executable using an absolute path:

export QLEISLI_KERNEL="/absolute/path/to/extracted/archive/bin/qleisli-kernel"
qleisli check /path/to/your/qli-project
qleisli run /path/to/your/qli-project

Alternatively, pass --lean-kernel=PATH. The experimental sized API may also select the same executable with QLEISLI_HIERARCHY_KERNEL.

The native archive contains the checker, not the qleisli frontend. Cargo installs the frontend and does not download or install the checker automatically. Native checker users do not need Lean, Lake, Mathlib or Python. Rust 1.85+ is required for Cargo installation. The source-build route uses the pinned Lean 4.30.0 toolchain and (cd lean-kernel && lake build).

Windows and Intel macOS native binaries are not included. The manifest records the tested build environment; the target name alone does not establish compatibility with older operating systems.

Migration and changes

  • CLI, Rust, Python, QIRF, foreign-format adapters and finite/hierarchical contracts use fresh native acceptance. Missing, incompatible or failing checkers reject without a Rust fallback.
  • Replace verify / VerifiedProgram with interchange::native::Kernel and AcceptedProgram. The old src/verify.rs implementation and interchange::dual API are removed.
  • Preserve immutable artifact/request binding and retained function-evidence DAGs. Rust remains responsible for proposal generation, diagnostics, transport and simulation.
  • Repair source-loading, simulation-budget, diagnostic and documentation-generation review findings.
  • Expand the pinned corpus from 78 to 87 small translations and retain the original 799 acceptance comparison pairs.
  • Synchronize AGENTS.md and CLAUDE.md, rename TRUSTBOUNDARY.md, and retain the v0.3 Lean backend plan and imaginary-v1 drafts across the planned documentation cleanup.

Validation and remaining work

The release source is commit a77e68f4d3942cd75cb4c4710350aab9a99f8c8b. Full release CI covers Rust/MSRV, macOS source loading, Python/interop, Lean/Mathlib, native comparison groups, fresh proof replay and clean package installation. Native archives carry SHA-256 files, audited source/file manifests, source-commit metadata and runtime licenses.

General Soundness, Physical Realizability and Resource Safety remain theorem goals. The implementation cutover does not complete their proofs or the source/native-compiler correspondence obligations.

Known follow-ups remain open: batching #274, diagnostic taxonomy #275, 11 deferred capacity/stress regressions #278, and Windows process-tree containment #268. Large inputs can exceed the native bounds; no new maximum-size experiments were performed for this release. README installation clarity #284 is tracked separately.

Apache-2.0. Copyright 2026 Masahiko G. Yamada. Qleisli and Lean runtime licenses/notices are included. No PyPI publication is included in this release.

Qleisli v0.2.8 — dual Rust/Lean checks and corpus expansion

Choose a tag to compare

@MGYamada MGYamada released this 03 Oct 05:12

Qleisli 0.2.8 adds opt-in ordinary Rust/Lean dual verification and expands the approved algorithm corpus while retaining compatible 0.2.x contracts.

  • check, run, sample, emit-ir and verify-ir support --lean-kernel=PATH; the Rust library exposes interchange::dual::Kernel. Both checkers must accept the original artifact/request before execution or emission.
  • Native acceptance is refactored into typed stages and connected to independent finite semantics and ordinary linear ResourceSafe for all 19 raw constructors. Full Soundness/EffectSound, hierarchical S05 and authority-transfer gates remain open. Rust remains authoritative; external schemas remain disabled.
  • The frozen QuantumKatas, Qualtran and PennyLane corpus grows from 69 to 78 cases, with 54 paired semantic faults. Documentation is reduced by roughly 54%, retaining active plans and imaginary-v1; retired contracts remain available at immutable source references.
  • Fix qrate root identity, ancestor traversal permissions, Python QIR-reader identity, structured diagnostic locations/codes, unused QIRF source acceptance, stale documentation references and CI toolchain/environment binding (#181, #192, #239–#244, #247–#249). macOS 11+ and listed Linux architectures require only search permission on ancestors. Older macOS retains its existing descriptor walk/read requirement and deployment targets.
  • Retain the partial #223 test-oriented CI migration. Every native bundle builds and audits; releases use full proof replay. Further driver consolidation/performance work remains open.

Validation binds the release to commit 18020190b1c80037442be29d74e90fd9e07253e0: full exact-source CI, release PR, Rust 1.85/1.98.1, Linux/macOS native checks, installed PyQIR, and clean distribution identity/installation checks. The corpus changes use small systems; existing capacity regressions remain unchanged.

cargo install qleisli --version 0.2.8 --locked

crates.io · API documentation

Apache-2.0. Copyright 2026 Masahiko G. Yamada. Required upstream licenses and notices are retained. This release publishes the Rust crate and GitHub source release; no PyPI package or custom binary assets are published.

Qleisli v0.2.7

Choose a tag to compare

@MGYamada MGYamada released this 02 Oct 15:11

v0.2.7

  • Add native Lean checking for QIRF leaves, finite requests and phase-fixed H, bounded graph/root semantic proofs, and 362 Rust/Lean decoder comparisons.
  • Adopt test-oriented routine CI while retaining native audits/comparisons and the full proof lane for releases and policy-risk changes.
  • Expand the pinned small corpus from 60 to 69 cases and add nine paired semantic faults.
  • Reduce tracked documentation by approximately 55%, preserving active plans and imaginary-v1.
  • Fix #207–#212 and #214: tuple reconstruction, QPE fault-harness CI coverage, kernel source policy, upstream attribution, local-call diagnostics, no-clobber proposal output and host-independent manifest warnings.

Production acceptance remains in Rust. General analytic reader-to-Operator closure, universal decoder/compiler proofs and VM-27 authority-transfer gates remain open. This release does not complete R14 or H1–H5.

Install

cargo install qleisli --version '=0.2.7' --locked

crates.io · API documentation · Changelog

The release uses the annotated tag v0.2.7 at 7844a10d63880a2b6984c093e2dc7a75033d1e1e. Exact-source full CI: https://github.com/MGYamada/Qleisli/actions/runs/37022315738. Publication, installation and source-archive evidence will be retained under tests/fixtures/releases/v0.2.7/; earlier development validation records remain historical.

Rust installation requires no Lean, Python or LLVM. Optional interoperability has separate requirements. No custom binary or Python package is published in this release.

Qleisli v0.2.6

Choose a tag to compare

@MGYamada MGYamada released this 02 Oct 01:08

Qleisli 0.2.6 is a compatible release that extends the independently checked Lean component, improves diagnostics and expands the finite quantum-program corpus.

  • VM-26: observing raw IR, classical SSA/branch phis and freshly retained branch functions. Actual matrix-free coefficients refine the original complex instrument, with bounded CP/TNI and all-outcome TP proofs.
  • Six new small translations from the same frozen QuantumKatas, Qualtran and PennyLane sources: 60 cases, 13,547 semantic probes and 36 detected semantic faults. Licenses and provenance are preserved.
  • At least 50% documentation reduction while retaining current contracts and migration plans. AGENTS.md is limited to 100 lines and 6,000 bytes.
  • Repair tuple binding diagnostics, qrate/JSON root handling, manifest warnings and root spelling, doc help, inventory-marker ordering and strict Lean failure framing (#180, #182–184, #187–189, #193). Host paths are removed from tuple diagnostics; #186's secondary locations remain open.
  • Integrate fail-closed CI selection and dependency archive caching while retaining full validation for releases (#145).

Rust remains the production acceptance authority; external schemas remain disabled. Public APIs, edition 2026, Rust 1.85 minimum and Lean/Mathlib 4.30.0 are unchanged. VM-27–29 and the general Soundness, Physical Realizability and Resource Safety theorems remain open. Validation uses small systems; no new maximum-size corpus was generated.

Install:

cargo install qleisli --version 0.2.6 --locked

The Rust CLI/library needs no Lean, Python or LLVM runtime. The optional Python host and experimental sized-source Lean checker are separate source installations; PyPI and custom binaries are not published with this release.

See the release record, API documentation and source README for scope and installation.

Qleisli v0.2.5

Choose a tag to compare

@MGYamada MGYamada released this 01 Oct 15:07

Qleisli v0.2.5

This compatible release combines VM-25 pure raw-IR checking, internal refactoring,
documentation reduction, six finite corpus additions and the 0.2.4 review repairs.

  • The Mathlib-free Lean kernel checks eleven straight-line pure constructors,
    complete owners/effects, exact retained function attachments and protected
    compute/uncompute scopes. Proofs connect actual definitions to independent
    complex raw action and clean zero return for correlated inputs.
  • Share Rust CLI/frontend, finite simulation and IR transport machinery, and
    simplify Lean conditional checks, limits, protocol and CLI modules while
    retaining public contracts, capacities and independent checking.
  • Simplify terminal phase words and export negative controls, controlled H and
    eighth-turn phases to OpenQASM/QIR. QFT2 uses two physical qubits; QFT3 uses
    four, including one explicitly counted clean synthesis qubit.
  • Add opt-in --qrate source-root selection, compatible manifest warnings and
    clearer import/type/tuple-binding diagnostics. JSON v1's closed code set remains.
  • Preserve macOS deployment compatibility with descriptor-relative source
    loading and check package documentation version links.
  • Retire 17 obsolete documents and reduce repeated prose. Expand the approved
    corpus from 48 to 54 cases with saved first sources, independent small-system
    checks and six new semantic faults; retain licenses and frozen provenance.

Rust 1.85+, Qleisli edition "2026" and existing public Rust/IR/Lean APIs remain.
Ordinary Cargo installation needs no Lean, Python or LLVM runtime. The separate
experimental sized-source path requires an explicitly selected Lean kernel.
Rust remains production-authoritative; external schemas stay disabled.
VM-26–29, general source/runtime correspondence, and Soundness, Physical
Realizability and Resource Safety theorems remain open. Bounded numerical
regressions are not general backend or resource proofs.

cargo install qleisli --version '=0.2.5' --locked

The exact source is 487a01be81718c02d068a1a411447393dfdec694.
All eight CI jobs passed for candidate push, PR and source tag. Local Rust 1.98.1
and MSRV 1.85.0 each passed 555 tests with zero failures/warnings (34 optional
tests ignored). Both Lean builds/audits, compiled runtime checks and fresh replay
pass; the clean macOS/Linux crate and full-source archives have matching hashes.
The packaged executable and a freshly installed Python wheel pass their checks.
See the release record
and complete change list.
PyPI and custom platform binaries are separate from this release.

Qleisli v0.2.4

Choose a tag to compare

@MGYamada MGYamada released this 01 Oct 04:41

Qleisli 0.2.4 is a compatible update to the experimental Rust CLI/library and finite verification foundation.

  • Add sealed std::quantum::{s, sdg, tdg, id, phase_eighth} using existing IR. Preserve exact phase under control/adjoint and linear Q<Unit> ownership, without a scalar-phase ancilla. Modernize bundled QFT and ten active corpus kernels while retaining original attempts and frozen comparison inputs.
  • Expand the finite corpus to 48 translations, sixteen per approved upstream source. Independent checking covers 12,893 complex-entry/protocol probes, four rejection cases and 24 type-correct semantic faults on small systems.
  • Implement the VM-24 experimental Lean finite component and actual-definition proofs for original-circuit reconstruction, independently required encoded equations, arbitrary references, clean return and whole-space inverse laws. Production authority remains Rust; external schemas remain disabled.
  • Fix manifest symlink/non-file rejection and sized entry/provider visibility. Reject --basis on sized check, and diagnose/document the existing Linux procfs requirement.
  • Track the root Cargo.lock, reduce obsolete documentation and clarify realizability with explicit backend workspace and resource/layout obligations. General gate decomposition and pipeline/kernel consolidation remain future work.

Install the Rust CLI with cargo install qleisli --version 0.2.4 --locked. Rust 1.85 or later is required; ordinary Rust use needs no Lean/Python/LLVM installation. Existing source trees retain explicit edition-2026 Qargo.toml manifests. PyPI and platform binaries are separate.

Release validation: all seven CI jobs passed on both the candidate push and PR, including Rust 1.98.1/1.85.0 (544 Linux tests passed, 34 opt-in tests ignored in the base suite), explicit native/Python checks, Lean builds/audits/fresh replay, interop and docs. Clean macOS/Linux distribution archives and the registry dry-run match. The tagged source is 86ce29552696133de989ce2d61893f64cd23d3f5; the validated crate SHA-256 is 349300f79df59a975871acaef5196e0d5dc75400dbea65faa675d87fc819aa10. Candidate CI and release PR retain the validation history. Publication readback and installation results are recorded separately on main after the immutable source tag.

The verified source tag and registry package are immutable. Source verification, finite experiments and scoped proofs do not establish full language soundness, Physical Realizability, Resource Safety or production Lean authority. See the release record and its linked evidence for performed checks and remaining gates.

Qleisli v0.2.3

Choose a tag to compare

@MGYamada MGYamada released this 01 Oct 00:59

Qleisli v0.2.3

Qleisli 0.2.3 introduces explicit language edition 2026, improves QFT/QPE
checking and source diagnostics, and completes the VM-23 exact-arithmetic
proof packet. Rust remains the production verifier.

Source migration

Every filesystem source tree containing .qli or .qlt files requires a
Qargo.toml with:

schema-version = 2

[qrate]
edition = "2026"

Put this manifest at the source-tree root, including trees that are not qrates.
The bundled std qrate has its complete manifest in stdlib/; corpus, examples
and tests use their own manifests. All source trees will migrate to qrate
management in the future. QLT execution remains planned for v0.4.0 or later.
See the edition contract.

This manifest requirement is the user's explicitly selected PATCH compatibility
exception. Existing in-memory source, Rust, IR and evidence APIs retain their
contracts. Rust's implementation edition remains 2024, and the MSRV remains 1.85.

Changes

  • Check equivalent commuting QFT schedules at roots and composed operations,
    preserving phase, axis order, source ports and the original precursor.
  • Reduce redundant generated routing. Named QPE (1,3) accepts both tested
    Fourier schedules at 1,996,759 structural / 708 exact units, under the
    unchanged 2,000,000 allowance. Every independent provider, preparation and
    readout obligation remains checked.
  • Distinguish hidden with_computed captures from consumed owners; retain
    source spans and explain unsupported sized lowering profiles. Support the
    complete quantum provider groups used by the small arithmetic corpus.
  • Fix the subprocess stdin race, add 4,000 finite/sized ownership comparisons,
    and keep Rust/Python sized checking differences explicit in CI.
  • Expand the finite corpus to 42 cases from the three approved sources,
    retaining phase-sensitive counterexamples and source-specific notices.
  • Complete VM-23's actual Lean scalar/matrix meaning, canonicality, reference,
    capacity and aggregate-work proofs. The packet retains 815 native Rust/Lean
    comparisons; production dual integration is a later migration stage.
  • Preserve the three original logo concepts
    and their branch history for v0.4.0 discussion.

Installation and scope

cargo install qleisli --version 0.2.3 --locked

Ordinary CLI/library use requires Rust alone. The experimental sized pipeline
requires a separately built Lean kernel. General soundness, source preservation,
physical realizability and quantitative resource safety remain proof goals.
The broader capacity work (#94), qargo namespace adapter (#96) and VM-24–VM-29
are separate from this release.

Validation

Source commit: ff460549f0630c88c1f65c00a9e7d740d39e7889; tree:
f4c145a98c45af03a141ddb5ad7a5011095b878e.
All seven jobs pass in both the source Linux CI
and PR validation,
including Rust 1.98.1 / MSRV 1.85.0, interop, both Lean proof builds/audits,
fresh native/kernel comparisons, distribution and documentation.

Clean local and Linux distribution checks pass: 2,011 crate files and 2,016
complete source files, required provenance, packaged documentation, installed
quickstarts and extracted-source tests. The generated local lockfile matches the
Linux artifact. cargo publish --dry-run --locked --registry crates-io passes,
with the same crate SHA-256 as both distribution checks.

  • Crate SHA-256: 3e191f2a5cac41a2fdb337e4a71f30b1289b3f01382b51b6cf4b9da9bf350054.
  • Complete source archive SHA-256: 2dadbdb04345e5cd3f0e375e5256089d9a6f8787fa11627a91c624ec8cb45b20.

The annotated v0.2.3 tag binds this source commit. The
crates.io package was published on
2026-10-01 with the matching checksum. A fresh exact-version registry install
passes the shipped Bell text/JSON checks, sampling, embedded QFT2 and ownership
rejection with no helper tools. The registry README renders the matching edition,
manifest and quickstart; all eight pinned documentation/gallery links are live.

The hosted API documentation builds
successfully on docs.rs (build 4662557).

Qleisli v0.2.2

Choose a tag to compare

@MGYamada MGYamada released this 30 Sep 12:28

Qleisli 0.2.2 adds a bounded shared measured-QPE workflow and prepares the staged Rust-to-Lean verification migration.

  • Add six small corpus translations: SWAP, Fredkin, constant XOR, bitwise complement, exact RX and phase kickback, with independent phase/order checks and retained upstream notices.
  • Freeze the VM-22 acceptance inventory, boundary contracts and reproducible comparison fixtures. VM-23–VM-29 remain planned.
  • Add bounded sized-source elaboration, an experimental qleisli sized CLI, fresh hierarchy/named-QPE checking, conditional instrument/reference proofs, reference execution and fresh-shot measured clients.
  • Fix exact-capacity rejection of repeat_static for TH by validating serial copies structurally; add checked narrowing, grouped imports, visible sealed signatures and clearer diagnostics.
  • Bound grouped-import prefix/documentation copying before allocation, render each documented group once, and add fixed-seed differential regressions.
  • Repair QIR block identity and structured interop diagnostic locations. Simplify README/status presentation and retire obsolete documentation while retaining active v0.2.x goals.

Installation

cargo install qleisli --version 0.2.2 --locked

The Rust CLI/library needs no Lean, Python or LLVM. The experimental sized CLI requires a separately built Lean kernel; Cargo does not install it. Python/PyPI distribution is separate.

Verification scope

Rust remains authoritative for production acceptance; external Lean schemas remain disabled. The general Soundness, Physical Realizability and Resource Safety theorems, source/runtime correspondence and the full hierarchy profile remain open. Small-system validation does not establish maximum capacity; named QPE (2,4) still exceeds the existing checking budget.

This is a compatible 0.2.x release. Type/tuple/coefficient breaking changes remain targeted at 0.3.0, and new algorithms stay in corpus before general stdlib growth at 0.5.0.

Release validation

All seven CI jobs on the tagged commit passed. Clean distribution checks, a fresh exact-version crates.io installation and the shipped quickstart passed. The downloaded registry artifact matches the validated package byte for byte.
The hosted API documentation built successfully. GitHub tar.gz and ZIP downloads match all 1,905 tagged source files.

Source commit: 8e39b32b932d8e11d5d83ca4a5991f212381e519.
Registry .crate SHA-256: 5e73c1765cfe13b94af60c5db55bcec1933f50b86e99fad46ace767f9c157a01.