Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion skills/statechart/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,9 @@ Work in a scratch folder outside the repo. Write a TLA+ spec and its config. The

`scripts/statechart.ts` is TypeScript, so run it with a runtime that can execute TypeScript.

By default, the command uses mise to find pinned TLC and Java versions. If they are not installed, mise installs them and needs network access. For an offline or pre-provisioned run, set `TLA2TOOLS` to the local `tla2tools.jar` path to bypass mise. Set `JAVA` to a Java 11 or later binary, or leave it unset to use `java` from `PATH`.
By default, the command uses mise to find pinned TLC and Java versions, so `mise` must be on `PATH`. If they are not installed, mise installs them and needs network access. For an offline or pre-provisioned run, set `TLA2TOOLS` to the local `tla2tools.jar` path to bypass mise. With `TLA2TOOLS` set, set `JAVA` to a Java 11 or later binary, or leave it unset to use `java` from `PATH`.

Before you write the spec, check that `TLA2TOOLS` is set or that `mise` is on `PATH`. If neither holds, stop and tell the user the two setups: install mise, or set `TLA2TOOLS` to a `tla2tools.jar` they already have, plus `JAVA` when `java` is not on `PATH`. Do not search the disk for Java or TLC, and do not download them yourself.

## Write the spec

Expand Down
2 changes: 1 addition & 1 deletion upstream.json
Original file line number Diff line number Diff line change
Expand Up @@ -10795,7 +10795,7 @@
"target": "skills/statechart/SKILL.md",
"mode": "100644",
"adaptation": {
"reason": "Correct the compiler-backed report contract to one shortest path per broken invariant or deadlock rule and TLC counterexamples for temporal properties. Remove universal shortest-path wording from constraint guidance. Document default pinned mise provisioning separately from the offline TLA2TOOLS/JAVA alternative, which bypasses mise and requires Java 11 or later.",
"reason": "Correct the compiler-backed report contract to one shortest path per broken invariant or deadlock rule and TLC counterexamples for temporal properties. Remove universal shortest-path wording from constraint guidance. Document default pinned mise provisioning separately from the offline TLA2TOOLS/JAVA alternative, which bypasses mise and requires Java 11 or later. State that the default path needs mise on PATH and that JAVA falls back to java on PATH only with TLA2TOOLS set. Stop before modelling when neither mise nor TLA2TOOLS is available, rather than searching the disk or downloading a Java runtime unasked.",
"verification": {
"kind": "pinned-byte/link inspection",
"artifacts": [
Expand Down
Loading