Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 23:06
· 55 commits to main since this release
2bea23e

v0.2.0: the MCP server for model checking

MINOR: a new server tool, and no pin moves (ADR-0014 item 2).
tools/pins.py moved v0.1.0 lists nothing, so every pin is v0.1.0's:

Pin Value
TLC, SANY, PlusCal tla2tools.jar v1.7.4, sha256 936a2620…0e88
TLAPS tlapm 1.6.0-pre at ff40755: binary sha256 6182df63…5bb2, kept in release tlapm-ff40755
Java Temurin JRE 25.0.5+8, in the base
Base eclipse-temurin:25-jre-noble, digest 5b5a79b8…e2f5
apt Ubuntu's snapshot of 2026-11-15T00:00:00Z
The skill's scripts TOPAK 5ade81e

What is new is tla-kit's own code:

  • tla-kit mcp: an MCP server over stdio, standard library only (ADR-0008),
    with nine tools: info, parse, symbols, evaluate, tlc_run, simulate,
    coverage, state_graph and tlc_rows. Only tlc_rows writes into the project,
    and only the skill's generator's results file (ADR-0006).
  • tla-kit: one command for mcp, info and selftest.
  • tla-kit-selftest gains an mcp check.

The image gains no package. Its digest differs from v0.1.0's because these
files are in it.

CI on main at 2bea23e (run 43973837070) passed:

  • records: PINS.json agrees with the Dockerfile and the README, and the
    vendored scripts match TOPAK at 5ade81e.
  • image: the build from the kept prover tarball; the self-test, mcp among its
    checks; the MCP client test, which drives every tool over stdio against the
    skill's fixture.
  • reproduce: the commit built twice from nothing, on two runners, gave one
    digest.

Phase 3's "Done when" was met in CI on pull request #11 (run 43921629481), in
the image built from it: server/compare_topak.py compared each of the nine
tools with the command it stands for on TOPAK's Alone and Coupling, at
5ade81e. All 84 comparisons were the same: every row of both modules through
tlc_run and the skill's tlc_run.py, and each module's results file, byte for
byte, from tlc_rows and tlc_rows.py.

No project pins tla-kit yet. A project that moves from v0.1.0 changes the
digest its CI names, and regenerates nothing: the checker, the prover and
the runtime are the same bytes, so no verdict changes (ADR-0014 item 2,
MINOR).

Cite this image by its digest

ghcr.io/scottcochran/tla-kit@sha256:5554015f9927001f933a4ec9e440fc0e1d37dc5676ce3acd47190b2d6dfc1e5d

The tag v0.2.0 names the same image, for reading; a results file and a project's CI name the digest (ADR-0010
item 4). Check that it was built here, from this tag, by this workflow:

gh attestation verify oci://ghcr.io/scottcochran/tla-kit@sha256:5554015f9927001f933a4ec9e440fc0e1d37dc5676ce3acd47190b2d6dfc1e5d --repo scottcochran/tla-kit

What it holds

The inventory, PINS.json, as committed at the tag, and tla-kit-info --json from the image, are attached. The
prover tarball, with the licence notices and the source of its copyleft parts, is kept in the release
tlapm-ff40755 (ADR-0005 item 2).

checker   /opt/tla/tla2tools.jar sha256 936a262061c914694dfd669a543be24573c45d5aa0ff20a8b96b23d01e050e88
tlc       TLC2 Version 2.19 of 08 August 2024 (rev: 5a47802)
prover    /opt/tlaps/bin/tlapm sha256 6182df63c4513b09c31c8de12c37f8045ace9cab2517c017a2fa75f466685bb2
tlapm     ff40755
backend   Isabelle Isabelle2025
backend   zenon zenon version 0.8.4 [a268] 2017-11-14
backend   Z3 Z3 version 4.8.9 - 64 bit
backend   SMT Z3 version 4.8.9 - 64 bit
backend   LS4 unknown
java      openjdk version "25.0.5" 2026-10-20 LTS
skill     https://github.com/scottcochran/TOPAK at 5ade81efcc50bd9dd4de555b208dc890d5746606
image     https://github.com/scottcochran/tla-kit at 2bea23e99f182dee9306b402e625fe019afa758a committed 2026-11-16T22:50:21Z

The SBOM is attached, and attested with the digest. The vulnerability scan at release time, for packages rated
HIGH or CRITICAL:


Report Summary

┌──────────────────────────────────────────────────────────────────────────────────┬────────┬─────────────────┬─────────┐
│                                      Target                                      │  Type  │ Vulnerabilities │ Secrets │
├──────────────────────────────────────────────────────────────────────────────────┼────────┼─────────────────┼─────────┤
│ ghcr.io/scottcochran/tla-kit@sha256:5554015f9927001f933a4ec9e440fc0e1d37dc5676c- │ ubuntu │        0        │    -    │
│ e3acd47190b2d6dfc1e5d (ubuntu 24.04)                                             │        │                 │         │
└──────────────────────────────────────────────────────────────────────────────────┴────────┴─────────────────┴─────────┘
Legend:
- '-': Not scanned
- '0': Clean (no security findings detected)

Only the latest release is supported. This release stays available, and is never deleted (ADR-0014 items 5 and 7).