by Michał Antkiewicz, Nov 15, 2026
This release gives the initializer := its meaning: the initial value of a reference. It also fixes six differences in references and initializers that the formalization of the temporal semantics found, makes a path work as a super, and lets ClaferConfigurator configure temporal models. The tools build with GHC 9.12 and no longer depend on unmaintained packages. Binaries for Linux x86_64 are available from the Clafer tools binary distributions page. For the first time since 2017, packages are on Hackage: clafer, claferIG, claferwiki.
Initial values. x -> integer ? := 10 gives x its value when it starts to exist; the value may change afterwards. In a static model, := is the same as =. In a temporal model, each lifetime of x starts with the value: an instance created later is initialized again. A collection is initialized when its parent starts its lifetime: xs -> integer * := 1, 2 gives the parent's first state those values, and members created later are not initialized by it. The value is written in the context of the parent, so this is the parent and names are resolved there. A final or finalref reference keeps the value it starts with. An initializer used to compile to an assertion (#116), so := 10 with [ x = 5 ] had instances; it has none now. Initializers are inherited by strengthening only: a subclafer's own := or = is added to the inherited one, so different initial values need an intermediate abstract clafer. An inherited initializer keeps its original timing. See initial values and the cheat sheet.
Found by the formalization. Kacper Bąk's Lean formalization of the semantics found six places where the outputs disagreed with it or with each other (#120–#125). In temporal models, a reference that refines an inherited one is now the same reference, and an instance has a value only while it exists: an obligation requiring a particular value of an instance fails if the instance disappears while its parent remains alive (if the parent disappears too, the obligation is cancelled with it). The value of an initializer keeps the temporal context of the parent, where it is written. In static and temporal models, the targets of a set reference must be distinct within the same declaration under one parent, also when the reference is inherited, and different subclafers may share targets. This changes the static output: it made the targets of all the instances of a top-level abstract clafer distinct, unlike the temporal output and chocosolver, so such static models can have more instances now. Each of the six reproducers fails with 0.5.7 and passes with 0.5.8.
Paths as supers. h : Person.Head extends the abstract clafer Head of Person, which disambiguates between abstract clafers with the same name, e.g., Dog.Head and Person.Head. Such a path was not resolved: with a constraint on h the compiler crashed, and without one the super was silently dropped, since 0.4.3 at least.
Builds and packages. The tools build with GHC 9.12.4 (Stackage nightly-2026-11-11) and still with GHC 9.6.7. data-stringmap, json-builder, MissingH and the other unmaintained or unused dependencies are gone, with the same outputs on the test models and the case studies, and as fast. The packages build and pass their tests from their source distributions with the dependencies that cabal resolves from Hackage, and are uploaded there as packages.
- clafer compiler, release pull request (0.5.8).
:=is the initial value of a reference (#116); inheritance of initializers by strengthening, with a warning that:=does not redefine an inherited=(#124)- temporal models: refined references (#120), distinct targets of inherited set references (#121), absent references (#122), the temporal context of an initializer's value (#123)
- set references: the targets are distinct within the same declaration under one parent, and different subclafers may share targets; the static output no longer makes the targets of all the instances of a top-level abstract clafer distinct, so such models can have more instances (#125)
- a path as a super, e.g.,
h : Person.Head, and a plain name of a super picks the sibling abstract clafer first let v = e in bodycompiles, with any bound expression (#114); it crashed the compiler- a group cardinality at the start of a line, e.g.,
2..3 baftera, belongs tob(#117); it silently became the cardinality ofa. An expression no longer continues on the next line at the same indentation - fixes: an ambiguous super name is reported as not unique, with the candidates (#115); the Choco output accepts a reference refined to a clafer declared later (#118), as in the wiki model graphReachability; the graph outputs draw clafers named after DOT keywords, e.g.,
Edge
- claferIG Alloy-based instance generator, release pull request (0.5.8).
- uses clafer-0.5.8, with initial values and the corrected references in temporal models
- builds with GHC 9.12.4; no longer depends on
data-stringmapandjson-builder, with the same JSON instances
- chocosolver Choco-based instance generator, release pull request (0.5.8).
- one-to-one mappings, e.g., 28 bubbles onto 28 products, find their first instance in under a second (#46):
-n nstops after the n-th instance, and the default search breaks its ties by the first variable instead of at random, so the wiki model ClaferTools/ClaferMooVizAbstractState has an instance again =,!=,inandnot inon sets of strings, e.g.,[ "ada" in names ], are compiled instead of rejected (#49); the wiki model oclBench/b1 has instances- fixes: a crash on the scope of an abstract clafer in a recursive hierarchy, e.g., the wiki model of the OMG Diagram Definition metamodel (#48)
- one-to-one mappings, e.g., 28 bubbles onto 28 products, find their first instance in under a second (#46):
- claferwiki, release pull request (0.5.8).
- uses clafer-0.5.8; builds with gitit 0.16.1, which also loads plugins when linked dynamically
- Clafer for Visual Studio Code, release pull request (0.5.8).
- for Clafer 0.5.8; install the .vsix file from the GitHub release with
code --install-extension clafer-syntax-0.5.8.vsix
- for Clafer 0.5.8; install the .vsix file from the GitHub release with
- Clafer Tools for Sublime Text, release pull request (0.5.8).
- for Clafer 0.5.8
- Clafer skills for Claude Code, release pull request (0.5.8).
- initial values and their inheritance, and paths as supers
- the explicit form first (
clafer -m clafer), with the syntactic sugar it stands for; encapsulation of abstractions; the practical consequences of the temporal semantics, e.g., where a constraint lives decides how long it lasts
- Web tools: ClaferIDE, ClaferConfigurator, and ClaferMooVisualizer 0.5.8, with the common platform (#15).
- ClaferConfigurator accepts temporal models: their variants are their static configurations, generated by claferIG as traces of length 1; the Choco-based backend is disabled for them
- ClaferIDE: the new example Counter.cfr counts from 1 to 5 and starts over, with an initial value and a chain of transitions
- fixes: in ClaferConfigurator, getting more instances than the model has stops at the last one with "No more instances found."
The Linux binary bundle contains clafer, claferIG with the optimized MiniSat solver, chocosolver.jar with a chocosolver launcher, and the Alloy jars. It runs on Linux x86_64 with glibc 2.39 or newer (Ubuntu 24.04, Debian 13, Arch Linux, Fedora) and needs Java 21 or newer. On Windows, use it through WSL.
Live demos (0.5.8): the Clafer Model Wiki, the Railway Wiki, the Traffic Lights Wiki, ClaferIDE, ClaferConfigurator, and ClaferMooVisualizer.
Note: temporal models and check need the Alloy-based tools: the Choco-based tools, including ClaferMooVisualizer and the Choco-based backend of ClaferConfigurator, work on static models.