Release Policy

New: quantum-cli v3, our PaaS: Runway 🚀

This document describes how we version, release, and support the Quantum CLI.

Versioning #

Quantum CLI follows Semantic Versioning (SemVer):

  • Major versions (e.g., 1.0.0 → 2.0.0): Contain breaking changes that may require updates to your workflows or scripts.
  • Minor versions (e.g., 1.1.0 → 1.2.0): Add new features and functionality in a backwards-compatible manner.
  • Patch versions (e.g., 1.1.0 → 1.1.1): Include bug fixes and security updates without changing functionality.

Release Cadence #

We release new versions of the Quantum CLI on an as-needed basis:

  • Patch releases are issued promptly when security vulnerabilities or critical bugs are discovered.
  • Minor releases happen frequently as new features are developed or dependencies are updated.
  • Major releases occur when significant changes warrant breaking backwards compatibility.

There is no fixed release schedule—we prioritize shipping improvements and fixes as soon as they are ready.

Backwards Compatibility #

We take backwards compatibility seriously:

  • Minor and patch releases maintain backwards compatibility with existing workflows and configurations.
  • Deprecations are announced before removal.
  • Breaking changes are reserved for major releases and are documented in the upgrade guide.

Support Policy #

As a small team, we focus our efforts on maintaining the latest releases. Here’s what you can expect:

  • The current major version receives active development, including new features, bug fixes, and security patches.
  • The previous major version is supported for up to 8 weeks after a new major release, receiving critical bug fixes and security patches only.
  • Versions older than the previous major release are considered end-of-life and no longer receive updates.

Staying Updated #

We recommend keeping your Quantum CLI installation up to date to benefit from the latest features, performance improvements, and security fixes.

Check your current version:

quantum-cli -v

Update to the latest version by following the installation instructions, or via:

quantum-cli selfupdate

Release Notes #

Release notes for each version are published on our CLI page page.