chase-cps 0.1.0__tar.gz

chase_cps-0.1.0/.dockerignore

@@ -0,0 +1,11 @@
+**/.git
+**/.DS_Store
+.github
+.idea
+.vscode
+build
+install
+cmake-build-*
+legacy
+**/__pycache__
+**/.pytest_cache

chase_cps-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# Build and installation directories of the superbuild
+/build/
+/install/
+cmake-build-*/
+CMakeCache.txt
+CMakeFiles/
+
+# Editors and operating systems
+.idea/
+.vscode/
+.DS_Store
+
+# Python
+venv/
+__pycache__/
+
+# Files generated by the legacy demos
+legacy/demo/Timing/template_0_synthesizable.structuredslugs
+output.smv
+.pytest_cache/
+*.egg-info/
+/dist/
+/wheelhouse/

chase_cps-0.1.0/.gitmodules

@@ -0,0 +1,24 @@
+[submodule "modules/third_party"]
+	path = modules/third_party
+	url = https://github.com/chase-cps/third_party.git
+	branch = main
+[submodule "modules/core-library"]
+	path = modules/core-library
+	url = https://github.com/chase-cps/core-library.git
+	branch = main
+[submodule "modules/chase-backends"]
+	path = modules/chase-backends
+	url = https://github.com/chase-cps/chase-backends.git
+	branch = main
+[submodule "modules/DSL_tool"]
+	path = modules/DSL_tool
+	url = https://github.com/chase-cps/DSL_tool.git
+	branch = main
+[submodule "modules/logics_tool"]
+	path = modules/logics_tool
+	url = https://github.com/chase-cps/logics_tool.git
+	branch = main
+[submodule "demos"]
+	path = demos
+	url = https://github.com/chase-cps/demos.git
+	branch = main

chase_cps-0.1.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+## 0.1.0 (2026-10-25)
+
+First release of the CHASE Python package, `chase-cps`, and of this
+repository as the entry point to CHASE.
+
+### Python package
+
+- Contracts written in the standard LTL syntax (`Contract.from_strings`,
+  `Contract.from_dict`), or read from and written to the logics language of
+  CHASE (`load_spec`, `parse_spec`, `to_spec`).
+- The contract algebra of the core library: composition, conjunction,
+  disjunction, merging, quotient, separation, and saturation.
+- Checks with nuXmv (or NuSMV, where nuXmv cannot be used): implication,
+  satisfiability, refinement, consistency, compatibility, and containment of
+  an environment or an implementation. A failed check returns a counterexample trace.
+  `remove_redundant` drops the terms implied by the others, and
+  `Contract.simplify` rewrites the formulas as the simplify command of
+  logics_tool.
+- GR(1) realizability (`is_realizable`) and synthesis (`synthesize`) with
+  slugs, with the controller or the counter-strategy of the environment.
+- The operations are named with verbs, the same in Python, on the command
+  line, in the MCP server, and in the console of logics_tool: `compose`,
+  `conjoin`, `disjoin`, `merge`, `divide` (quotient), `separate`,
+  `saturate`, `simplify`, `refines`, `verify`, and `synthesize`.
+- Command line: `chase-cps install` installs nuXmv, slugs, and NuSMV in
+  `~/.chase`, `chase-cps doctor` shows the tools found, and `chase-cps check`
+  checks the contracts of a specification and prints the counterexamples.
+- Wheels for Python 3.10 to 3.15 on Linux (x86_64, aarch64) and macOS (arm64,
+  x86_64).
+
+### Core library and tools
+
+- Separation of contracts, and Python bindings for disjunction and merging.
+- The console of logics_tool has the commands `disjoin`, `merge`, and
+  `separate`; `conjunction`, `quotient`, and `refinement` are now `conjoin`,
+  `divide`, and `refines`, and the old names are still accepted. `show`
+  prints the temporal operators (it printed their codes).
+- The quotient follows again the closed form of Incer et al. (MEMOCODE 2018):
+  the guarantees are (G1 & A2) | !(A1 & G2).
+- Primed variables kept their prime when a formula was cloned, and the NuSMV
+  back end writes them as `next(x)`. Before, `x' = x + 1` became `x = x + 1`,
+  which made the refinement checks of the RoboticJoints demo hold vacuously.
+- Errors in a specification raise an exception instead of ending the process.
+- Missing return in the ANTLR runtime, which crashed the Release builds.
+- C++17, CMake 3.18, Python found with FindPython, and relative run paths in
+  all the modules.
+
+### Repository
+
+- The modules are collected as git submodules, built at once by `install.sh`
+  or CMake, and shipped in a Docker image.
+- Continuous integration on Linux and macOS, with the demos and the Python
+  tests.

chase_cps-0.1.0/CITATION.cff

@@ -0,0 +1,33 @@
+cff-version: 1.2.0
+message: "If you use CHASE, please cite the paper below."
+title: "CHASE: Contract-based Heterogeneous Analysis and Systems Exploration"
+type: software
+authors:
+  - family-names: Lora
+    given-names: Michele
+  - family-names: Xiao
+    given-names: Yifeng
+    affiliation: "University of California, Berkeley"
+repository-code: "https://github.com/chase-cps/chase"
+url: "https://chase-cps.github.io"
+license: BSD-3-Clause
+version: 0.1.0
+date-released: 2026-10-25
+preferred-citation:
+  type: conference-paper
+  title: "CHASE: Contract-based requirement engineering for cyber-physical system design"
+  authors:
+    - family-names: Nuzzo
+      given-names: Pierluigi
+    - family-names: Lora
+      given-names: Michele
+    - family-names: Feldman
+      given-names: Yishai A.
+    - family-names: Sangiovanni-Vincentelli
+      given-names: Alberto L.
+  collection-title: "Proceedings of the Design, Automation & Test in Europe Conference & Exhibition (DATE)"
+  publisher:
+    name: IEEE
+  year: 2018
+  start: 839
+  end: 844

chase_cps-0.1.0/CMakeLists.txt

@@ -0,0 +1,142 @@
+###############################################################################
+# Superbuild of CHASE.
+#
+# Configures, builds, and installs the CHASE modules (git submodules in the
+# modules/ directory) in the required order:
+#   third_party -> core-library -> chase-backends -> DSL_tool, logics_tool
+#
+# All the modules are installed in the same prefix, which is the value of
+# CMAKE_INSTALL_PREFIX if given, or ${CMAKE_BINARY_DIR}/install otherwise.
+# The installation is performed during the build, i.e., by:
+#   cmake -S . -B build [-DCMAKE_INSTALL_PREFIX=<prefix>]
+#   cmake --build build
+###############################################################################
+cmake_minimum_required(VERSION 3.18)
+project(CHASE_SUPERBUILD NONE)
+
+include(ExternalProject)
+include(ProcessorCount)
+
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build." FORCE)
+endif()
+
+option(CHASE_BUILD_TESTS "Build the tests of the CHASE core library" OFF)
+
+# Installation prefix of the modules. When building the Python wheel
+# (scikit-build-core sets SKBUILD), the modules are staged in the build
+# directory and only the Python modules go into the wheel (see the end).
+if(SKBUILD)
+    set(CMAKE_INSTALL_PREFIX ${CMAKE_BINARY_DIR}/stage CACHE PATH
+        "Installation prefix of the CHASE modules" FORCE)
+elseif(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
+    set(CMAKE_INSTALL_PREFIX ${CMAKE_BINARY_DIR}/install CACHE PATH
+        "Installation prefix of the CHASE modules" FORCE)
+endif()
+get_filename_component(CHASE_PREFIX "${CMAKE_INSTALL_PREFIX}" ABSOLUTE
+    BASE_DIR "${CMAKE_BINARY_DIR}")
+message(STATUS "CHASE installation prefix: ${CHASE_PREFIX}")
+
+ProcessorCount(_nproc)
+if(_nproc EQUAL 0)
+    set(_nproc 1)
+endif()
+set(CHASE_BUILD_JOBS ${_nproc} CACHE STRING
+    "Number of parallel jobs used to build each module")
+
+# Every module reads its installation prefix from the environment variable
+# CHASE_INSTALL_DIR (it ignores -DCMAKE_INSTALL_PREFIX). The variable is also
+# set for the build and install steps, since a module may re-run its own
+# configuration during the build.
+set(_env ${CMAKE_COMMAND} -E env CHASE_INSTALL_DIR=${CHASE_PREFIX})
+
+# Python interpreter: Python_EXECUTABLE is used by FindPython, PYTHON_EXECUTABLE
+# by the older FindPythonInterp/FindPythonLibs. Either one can be given, and
+# both are forwarded to the modules.
+if(PYTHON_EXECUTABLE AND NOT Python_EXECUTABLE)
+    set(Python_EXECUTABLE ${PYTHON_EXECUTABLE})
+elseif(Python_EXECUTABLE AND NOT PYTHON_EXECUTABLE)
+    set(PYTHON_EXECUTABLE ${Python_EXECUTABLE})
+endif()
+
+# pybind11 installed with pip (e.g., in the isolated build of the wheel).
+if(NOT pybind11_DIR AND Python_EXECUTABLE)
+    execute_process(COMMAND ${Python_EXECUTABLE} -m pybind11 --cmakedir
+        OUTPUT_VARIABLE _pybind11_dir OUTPUT_STRIP_TRAILING_WHITESPACE
+        RESULT_VARIABLE _pybind11_found ERROR_QUIET)
+    if(_pybind11_found EQUAL 0 AND EXISTS "${_pybind11_dir}")
+        set(pybind11_DIR ${_pybind11_dir})
+    endif()
+endif()
+
+# Options forwarded to every module. Lists are passed with '|' as separator.
+set(_args -DCMAKE_BUILD_TYPE=${CMAKE_BUILD_TYPE})
+foreach(_var pybind11_DIR CMAKE_PREFIX_PATH Python_EXECUTABLE PYTHON_EXECUTABLE)
+    if(${_var})
+        string(REPLACE ";" "|" _value "${${_var}}")
+        list(APPEND _args "-D${_var}=${_value}")
+    endif()
+endforeach()
+
+set(_generator -G ${CMAKE_GENERATOR})
+if(CMAKE_GENERATOR_PLATFORM)
+    list(APPEND _generator -A ${CMAKE_GENERATOR_PLATFORM})
+endif()
+if(CMAKE_GENERATOR_TOOLSET)
+    list(APPEND _generator -T ${CMAKE_GENERATOR_TOOLSET})
+endif()
+
+# chase_module(<name> [DEPENDS <targets>...] [ARGS <cmake args>...])
+function(chase_module name)
+    cmake_parse_arguments(M "" "" "DEPENDS;ARGS" ${ARGN})
+    set(src ${PROJECT_SOURCE_DIR}/modules/${name})
+    if(NOT EXISTS ${src}/CMakeLists.txt)
+        message(FATAL_ERROR "Module ${name} not found in ${src}. "
+            "Run: git submodule update --init --recursive")
+    endif()
+    ExternalProject_Add(${name}
+        SOURCE_DIR ${src}
+        BINARY_DIR ${CMAKE_BINARY_DIR}/${name}
+        DEPENDS ${M_DEPENDS}
+        LIST_SEPARATOR |
+        CONFIGURE_COMMAND ${_env} ${CMAKE_COMMAND} ${_generator}
+            ${_args} ${M_ARGS} -S <SOURCE_DIR> -B <BINARY_DIR>
+        BUILD_COMMAND ${_env} ${CMAKE_COMMAND} --build <BINARY_DIR>
+            --config ${CMAKE_BUILD_TYPE} --parallel ${CHASE_BUILD_JOBS}
+        INSTALL_COMMAND ${_env} ${CMAKE_COMMAND} --install <BINARY_DIR>
+            --config ${CMAKE_BUILD_TYPE}
+        BUILD_ALWAYS ON
+        USES_TERMINAL_CONFIGURE ON
+        USES_TERMINAL_BUILD ON)
+endfunction()
+
+if(CHASE_BUILD_TESTS)
+    set(_tests ON)
+else()
+    set(_tests OFF)
+endif()
+
+chase_module(third_party)
+# INSTALL_GTEST=OFF keeps googletest (fetched by the tests) out of the prefix.
+chase_module(core-library DEPENDS third_party
+    ARGS -DENABLE_TESTS=${_tests} -DINSTALL_GTEST=OFF)
+chase_module(chase-backends DEPENDS core-library)
+chase_module(DSL_tool DEPENDS chase-backends)
+chase_module(logics_tool DEPENDS chase-backends)
+
+# 'ctest' in the build directory runs the tests of the core library.
+if(CHASE_BUILD_TESTS)
+    enable_testing()
+    add_test(NAME core-library
+        COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -C ${CMAKE_BUILD_TYPE}
+        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}/core-library)
+endif()
+
+# Python wheel: the compiled modules and the ANTLR runtime go into
+# chase_cps/_lib, next to the Python package (python/chase_cps).
+if(SKBUILD)
+    install(DIRECTORY ${CHASE_PREFIX}/chase/lib/ DESTINATION chase_cps/_lib
+        FILES_MATCHING PATTERN "pychase*")
+    install(DIRECTORY ${CHASE_PREFIX}/third_party/antlr4/lib/ DESTINATION chase_cps/_lib
+        FILES_MATCHING PATTERN "libantlr4-runtime*" PATTERN "*.a" EXCLUDE)
+endif()

chase_cps-0.1.0/Dockerfile

@@ -0,0 +1,102 @@
+###############################################################################
+# Docker image with the complete CHASE toolchain:
+#   - CHASE core-library, chase-backends, DSL_tool, logics_tool (+ Python API)
+#   - external solvers used by the backends: gr1c, slugs, and nuXmv (x86_64
+#     only, when its license is accepted, see below)
+#
+# The CHASE modules are built from the git submodules of this repository,
+# which must be initialized before building the image:
+#   git submodule update --init --recursive
+#   docker build -t chase .
+#
+# nuXmv may be used only for academic and non-commercial purposes
+# (https://nuxmv.fbk.eu/license.html). It is downloaded into the image only
+# when its license is accepted:
+#   docker build --build-arg ACCEPT_NUXMV_LICENSE=yes -t chase .
+#
+# Run the demos:
+#   docker run --rm -it chase
+#   docker run --rm chase /opt/chase/tests/demo-suite.sh
+###############################################################################
+
+ARG UBUNTU_VERSION=24.04
+
+FROM ubuntu:${UBUNTU_VERSION} AS base
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        build-essential cmake git ca-certificates curl pkg-config \
+        python3 python3-dev python3-pytest pybind11-dev uuid-dev \
+        bison flex libboost-dev graphviz less libxml2 libedit2 xz-utils \
+    && rm -rf /var/lib/apt/lists/*
+
+###############################################################################
+# External solvers.
+###############################################################################
+FROM base AS solvers
+ARG GR1C_REF=v0.13.3
+ARG SLUGS_REF=ac09bf652d4ff47a7018d6a41627af73a67a049c
+ARG TARGETARCH
+
+# gr1c (GR(1) synthesis)
+RUN git clone https://github.com/tulip-control/gr1c /tmp/gr1c \
+    && cd /tmp/gr1c && git checkout ${GR1C_REF} \
+    && ./get-deps.sh && ./build-deps.sh \
+    && make -j"$(nproc)" && make install prefix=/usr/local \
+    && rm -rf /tmp/gr1c
+
+# slugs (GR(1) synthesis) and its structured-slugs compiler
+RUN git clone https://github.com/VerifiableRobotics/slugs /opt/slugs \
+    && cd /opt/slugs && git checkout ${SLUGS_REF} \
+    && sed -i 's/#ifndef __x86_64/#if !defined(__x86_64) \&\& !defined(__aarch64__)/' \
+        src/BFAbstractionLibrary/compilerOptionGenerator.c \
+    && cd src && make -j"$(nproc)" \
+    && ln -s /opt/slugs/src/slugs /usr/local/bin/slugs
+
+###############################################################################
+# CHASE.
+###############################################################################
+FROM solvers AS chase
+ARG BUILD_TYPE=Release
+
+COPY CMakeLists.txt /src/chase/
+COPY modules /src/chase/modules
+
+RUN for m in third_party core-library chase-backends DSL_tool logics_tool; do \
+        test -f /src/chase/modules/$m/CMakeLists.txt || { \
+            echo "modules/$m is empty: run 'git submodule update --init --recursive'"; \
+            exit 1; }; \
+    done \
+    && cmake -S /src/chase -B /build \
+        -DCMAKE_INSTALL_PREFIX=/opt/chase \
+        -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
+        -Dpybind11_DIR=/usr/lib/cmake/pybind11 \
+        -DPython_EXECUTABLE=/usr/bin/python3 \
+        -DCHASE_BUILD_TESTS=ON \
+    && cmake --build /build \
+    && (cd /build && ctest --output-on-failure) \
+    && rm -rf /build /src
+
+COPY demos /opt/chase/demos
+COPY tests/demo-suite.sh /opt/chase/tests/demo-suite.sh
+COPY python /opt/chase/python
+
+ENV CHASE_INSTALL_DIR=/opt/chase \
+    CHASE_HOME=/opt/chase/tools \
+    PATH=/opt/chase/tools/bin:/opt/chase/chase/bin:${PATH} \
+    PYTHONPATH=/opt/chase/python:/opt/chase/chase/lib \
+    SLUGSCOMPILER=/opt/slugs/tools/StructuredSlugsParser/compiler.py
+
+# nuXmv (model checking), installed by chase-cps when its license is
+# accepted. FBK ships it for x86_64 Linux only.
+ARG ACCEPT_NUXMV_LICENSE=no
+RUN if [ "${ACCEPT_NUXMV_LICENSE}" = "yes" ] && [ "$(uname -m)" = "x86_64" ]; then \
+        python3 -m chase_cps install nuxmv --accept-license; \
+    elif [ "${ACCEPT_NUXMV_LICENSE}" = "yes" ]; then \
+        echo "nuXmv: no build for $(uname -m), not installed."; \
+    else \
+        echo "nuXmv: license not accepted, not installed" \
+             "(docker build --build-arg ACCEPT_NUXMV_LICENSE=yes)."; \
+    fi
+
+WORKDIR /opt/chase/demos
+CMD ["/bin/bash"]

chase_cps-0.1.0/LICENSE

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Copyright (c) 2015 - 2022 by University of Southern California 
+Copyright (c) 2015 - 2022 by University of Verona
+Copyright (c) 2026 by University of California, Berkeley
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

chase_cps-0.1.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: chase-cps
+Version: 0.1.0
+Summary: CHASE: Contract-based Heterogeneous Analysis and Systems Exploration
+Keywords: contracts,assume-guarantee,LTL,formal methods,cyber-physical systems,requirements,model checking
+Author-Email: Yifeng Xiao <yifengx@berkeley.edu>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Scientific/Engineering
+Classifier: Intended Audience :: Science/Research
+Project-URL: Homepage, https://chase-cps.github.io
+Project-URL: Documentation, https://chase-cps.github.io/api/
+Project-URL: Repository, https://github.com/chase-cps/chase
+Project-URL: Issues, https://github.com/chase-cps/chase/issues
+Project-URL: Changelog, https://github.com/chase-cps/chase/blob/master/CHANGELOG.md
+Requires-Python: >=3.10
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Description-Content-Type: text/markdown
+
+# chase-cps
+
+Python interface to [CHASE][WEB] (Contract-based Heterogeneous Analysis and
+Systems Exploration), a framework for requirement capture, formalization, and
+validation of cyber-physical systems with assume-guarantee contracts.
+
+The package contains the CHASE core library (contract representation and
+algebra) and a common interface to model checkers and synthesis tools.
+
+```python
+from chase_cps import Contract, refinement
+
+spec = Contract.from_strings(inputs=["req"], outputs=["grant"],
+                             assumptions=["G F !req"],
+                             guarantees=["G (req -> F grant)"], name="Spec")
+impl = Contract.from_strings(inputs=["req"], outputs=["grant"],
+                             guarantees=["G (req -> X grant)"], name="Impl")
+
+result = refinement(impl, spec)
+print(result.status)          # valid, or invalid with a counterexample trace
+```
+
+The operations have the names of the commands of `logics_tool`. A contract
+`c` has the methods `compose`, `conjoin`, `disjoin`, `merge`, `divide`
+(quotient), `separate`, `saturate`, and `simplify`, which return new
+contracts. The checks on contracts are `refines`, `verify` (`is_compatible`
+and `is_consistent`), `is_realizable`, `accepts`, and `implements`;
+`synthesize` builds a controller. The checks on formulas are `implies` and
+`is_satisfiable`. `remove_redundant` drops the terms implied by the others. `load_spec` and
+`parse_spec` read the contracts of a specification written in the logics
+language of CHASE, and `to_spec` writes one.
+
+## Installation
+
+`$> pip install chase-cps`
+
+Wheels are available for Python 3.10 to 3.15 on Linux (x86_64 and aarch64,
+glibc 2.28 or later) and macOS 11 or later (arm64 and x86_64). Windows is not
+supported: use WSL or the CHASE Docker image.
+
+## Requirements
+
+The package contains the CHASE library. The checks call external tools,
+which are not installed with the package:
+
+- [nuXmv][NUXMV] for `refines`, `verify`, `implies`, `is_satisfiable`,
+  `remove_redundant`, `accepts`, and `implements`. nuXmv is free for academic and non-commercial
+  use.
+- [slugs][SLUGS] for `is_realizable` and `synthesize`.
+
+The command `chase-cps install` downloads nuXmv from its site, and builds
+slugs from its sources, into `~/.chase`:
+
+````
+$> chase-cps install nuxmv --accept-license    # Linux x86_64, macOS arm64
+$> chase-cps install slugs                     # needs a C++ compiler, make, and Boost
+````
+
+On macOS, nuXmv needs the libraries of Homebrew (`brew install libxml2 gmp
+libedit`). On Linux it needs `libxml2` and `libedit2`, and the C++ library of
+GCC 13 or later (Ubuntu 24.04, Debian 13, Fedora 39, or newer);
+`chase-cps install` says what is missing.
+The tools can also be installed by hand: they are looked up in the `PATH`
+and in `~/.chase/bin`, or given with the environment variables `CHASE_NUXMV`
+and `CHASE_SLUGS`. The command
+
+`$> chase-cps doctor`
+
+shows the tools found and how to install the missing ones.
+
+Where nuXmv cannot be used (e.g. for commercial purposes), the checks run
+with [NuSMV][NUSMV] (LGPL) instead: `chase-cps install nusmv` installs it on
+Linux x86_64, or set `CHASE_NUSMV`.
+
+## Command line
+
+`chase-cps check` checks the contracts of a specification written in the
+logics language of CHASE, or of a JSON file, and prints the counterexamples:
+
+````
+$> chase-cps check specs.ltl                                    # verify every contract
+$> chase-cps check specs.ltl --refines Joint1+Joint2 Joints      # composition refines Joints
+$> chase-cps check specs.ltl --realizable Joint1 --json
+````
+
+The exit status is 0 when every check passes, and 1 when a check fails.
+
+The source code and the installation instructions are in the
+[chase][REPO] repository.
+
+[WEB]: https://chase-cps.github.io
+[REPO]: https://github.com/chase-cps/chase
+[NUXMV]: https://nuxmv.fbk.eu/
+[NUSMV]: https://nusmv.fbk.eu/
+[SLUGS]: https://github.com/VerifiableRobotics/slugs