Skip to content

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 07:03
· 35 commits to main since this release
4aee1f5

v0.3.0: the MCP server's proof tools

MINOR: new server tools, and no pin moves (ADR-0014 item 2).
tools/pins.py moved v0.2.0 lists nothing, so every pin is v0.2.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

PINS.json changed by one served-state entry only: upstream no longer
serves the pinned tlapm tarball (2026.11.16). The image builds from the
kept copy, as before.

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

  • Five proof tools in tla-kit mcp (Phase 4; ADR-0009, ADR-0016):
    prove, proof_check, proof_results, flip_test and proof_sync. prove
    runs tlapm per request, in a process group of its own killed whole on
    a timeout or a cancel, with a cache the server owns, one run per
    module at a time, and every child reaped before it answers. A failed
    obligation comes back with its text, the backends tried and why each
    failed. proof_results is the only one that writes into the project:
    the skill's dated proof results file.
  • The server handles requests concurrently, and a cancelled request
    gets no response (MCP 2025-06-18).
  • parse and symbols read proof modules: they give SANY the prover's
    library.

The image gains no package.

CI on main at 4aee1f5 (run 44033259889) 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; the MCP
    client test, every tool over stdio against the skill's fixture.
  • reproduce: the commit built twice from nothing, on two runners, gave
    one digest.

On pull requests #21 and #22, in images built from them:

  • server/test_prove.py tried to break each property of
    spec/ProveRequests.tla (ADR-0016 item 7): runs of one module take
    turns, a cancelled request gets no response, a cancel after the
    response changes nothing, a timeout kills the whole group, and no
    backend is left alive or unreaped. All passed. proof_results through
    the server wrote the file that the script, run directly, reproduced
    byte for byte.
  • server/compare_topak.py: the nine model-checking tools against their
    commands on TOPAK's Alone and Coupling, at 5ade81e, 84 comparisons,
    all the same.

spec/ProveRequests.tla, the design the tools follow, has 78 rows, all
as expected; they reproduced byte for byte in v0.2.0 and are
regenerated in CI.

No project pins tla-kit yet. A project that moves from v0.2.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:948e6d1f275d64e4114950f03c2b5d1236068d1f3fe60885de7625789fc8257f

The tag v0.3.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:948e6d1f275d64e4114950f03c2b5d1236068d1f3fe60885de7625789fc8257f --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 4aee1f56e0477a2aba60227bead4a82a5a5f5248 committed 2026-11-17T06:42:52Z

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:948e6d1f275d64e4114950f03c2b5d1236068d1f3fe- │ ubuntu │        0        │    -    │
│ 60885de7625789fc8257f (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).