tla-ts 0.0.9 → 0.0.10-dev.06b481ee0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (631) hide show
  1. package/README.md +30 -1
  2. package/dist/compile.cjs +23 -0
  3. package/dist/compile.js +23 -0
  4. package/dist/deciders.cjs +41 -37
  5. package/dist/deciders.js +48 -44
  6. package/dist/index.cjs +1 -1
  7. package/dist/index.d.cts +122 -12
  8. package/dist/index.d.ts +122 -12
  9. package/dist/index.js +1 -1
  10. package/dist/parallel-worker.cjs +1 -1
  11. package/dist/parallel-worker.js +1 -1
  12. package/dist/prove-worker.cjs +1 -1
  13. package/dist/prove-worker.js +1 -1
  14. package/dist/prove.cjs +2746 -410
  15. package/dist/prove.js +2745 -409
  16. package/dist/run.cjs +144 -31
  17. package/dist/run.js +144 -31
  18. package/dist/tlapm.cjs +2 -2
  19. package/dist/tlapm.js +2 -2
  20. package/dist/transfer.cjs +134 -104
  21. package/dist/transfer.js +134 -104
  22. package/dist/worker.cjs +7 -7
  23. package/dist/worker.js +7 -7
  24. package/package.json +3 -1
  25. package/src/ast.ts +56 -60
  26. package/src/bags.ts +128 -110
  27. package/src/builtins.ts +31 -77
  28. package/src/bundled-modules.ts +1 -8
  29. package/src/check-failure.ts +118 -0
  30. package/src/check-trace.ts +320 -0
  31. package/src/check.ts +1156 -888
  32. package/src/cli/options.ts +12 -32
  33. package/src/cli/run.ts +0 -2
  34. package/src/cli/runtime-invariants.ts +100 -0
  35. package/src/cli/shared.ts +19 -12
  36. package/src/cli/tlapm.ts +433 -82
  37. package/src/cli/tlc-arguments.ts +652 -0
  38. package/src/cli/tlc-output.ts +701 -0
  39. package/src/cli/tlc-usage.ts +360 -0
  40. package/src/cli/tlc.ts +330 -659
  41. package/src/cli/typescript.ts +23 -0
  42. package/src/cli/xml-exporter.ts +27 -49
  43. package/src/cli.ts +0 -1
  44. package/src/codegen.ts +217 -82
  45. package/src/config.ts +140 -109
  46. package/src/coverage.ts +1019 -0
  47. package/src/dependencies.ts +101 -66
  48. package/src/dfid.ts +683 -0
  49. package/src/environment-config.ts +315 -0
  50. package/src/environment.ts +263 -370
  51. package/src/errors.ts +107 -57
  52. package/src/evaluate.ts +898 -369
  53. package/src/exit-codes.ts +63 -13
  54. package/src/fingerprints.ts +75 -11
  55. package/src/index.ts +3 -0
  56. package/src/instances.ts +137 -22
  57. package/src/java-hash.ts +21 -0
  58. package/src/java-overrides.ts +6 -21
  59. package/src/json-reader.ts +455 -0
  60. package/src/json.ts +252 -139
  61. package/src/levels.ts +231 -154
  62. package/src/lexer.ts +83 -101
  63. package/src/liveness-checker.ts +743 -322
  64. package/src/liveness.ts +230 -133
  65. package/src/obligations/action.ts +17 -44
  66. package/src/obligations/anonymize.ts +120 -95
  67. package/src/obligations/enabled-axioms.ts +218 -0
  68. package/src/obligations/equality.ts +1 -3
  69. package/src/obligations/expression.ts +37 -26
  70. package/src/obligations/format.ts +0 -10
  71. package/src/obligations/generate.ts +66 -64
  72. package/src/obligations/index.ts +39 -20
  73. package/src/obligations/levels.ts +27 -18
  74. package/src/obligations/module.ts +28 -55
  75. package/src/obligations/normalize.ts +31 -41
  76. package/src/obligations/operators.ts +0 -3
  77. package/src/obligations/pragma.ts +52 -24
  78. package/src/obligations/printer.ts +94 -63
  79. package/src/obligations/proof.ts +3 -6
  80. package/src/obligations/regroup.ts +0 -5
  81. package/src/obligations/simplify.ts +57 -63
  82. package/src/obligations/source.ts +121 -95
  83. package/src/obligations/subexpression.ts +49 -28
  84. package/src/obligations/substitution.ts +1 -5
  85. package/src/obligations/temporal.ts +12 -20
  86. package/src/obligations/tuples.ts +2 -10
  87. package/src/parallel-worker.ts +36 -60
  88. package/src/parallel.ts +64 -73
  89. package/src/parser.ts +1184 -531
  90. package/src/pcal/ast.ts +53 -86
  91. package/src/pcal/parse.ts +144 -219
  92. package/src/pcal/tokenize.ts +91 -131
  93. package/src/pcal/translate.ts +83 -130
  94. package/src/pcal/validate.ts +48 -68
  95. package/src/pretty-print.ts +7 -8
  96. package/src/prover/decide-pool.ts +8 -13
  97. package/src/prover/deciders.ts +12 -13
  98. package/src/prover/first-order.ts +0 -11
  99. package/src/prover/isabelle/decide.ts +3 -31
  100. package/src/prover/isabelle/encode.ts +82 -64
  101. package/src/prover/isabelle/isar/attrib.ts +250 -0
  102. package/src/prover/isabelle/isar/context.ts +335 -0
  103. package/src/prover/isabelle/isar/induct.ts +382 -0
  104. package/src/prover/isabelle/isar/inner-syntax.ts +262 -117
  105. package/src/prover/isabelle/isar/method.ts +510 -226
  106. package/src/prover/isabelle/isar/proof.ts +570 -23
  107. package/src/prover/isabelle/isar/rule-cases.ts +226 -0
  108. package/src/prover/isabelle/isar/theory.ts +488 -88
  109. package/src/prover/isabelle/isar/toplevel.ts +331 -0
  110. package/src/prover/isabelle/isar/type-check.ts +99 -38
  111. package/src/prover/isabelle/provers/blast/blast.ts +16 -105
  112. package/src/prover/isabelle/provers/blast/branch.ts +0 -33
  113. package/src/prover/isabelle/provers/blast/prove.ts +0 -36
  114. package/src/prover/isabelle/provers/blast/rules.ts +5 -45
  115. package/src/prover/isabelle/provers/blast/state.ts +1 -29
  116. package/src/prover/isabelle/provers/blast/term.ts +8 -37
  117. package/src/prover/isabelle/provers/clasimp.ts +1 -15
  118. package/src/prover/isabelle/provers/classical.ts +58 -61
  119. package/src/prover/isabelle/provers/hypsubst.ts +29 -54
  120. package/src/prover/isabelle/pure/bicompose.ts +24 -39
  121. package/src/prover/isabelle/pure/consts.ts +0 -8
  122. package/src/prover/isabelle/pure/conv.ts +2 -18
  123. package/src/prover/isabelle/pure/drule.ts +95 -45
  124. package/src/prover/isabelle/pure/envir.ts +2 -53
  125. package/src/prover/isabelle/pure/goal.ts +1 -9
  126. package/src/prover/isabelle/pure/interrupt.ts +0 -5
  127. package/src/prover/isabelle/pure/list.ts +0 -3
  128. package/src/prover/isabelle/pure/logic.ts +1 -16
  129. package/src/prover/isabelle/pure/name.ts +1 -10
  130. package/src/prover/isabelle/pure/net.ts +2 -60
  131. package/src/prover/isabelle/pure/object-logic.ts +15 -16
  132. package/src/prover/isabelle/pure/pattern.ts +1 -20
  133. package/src/prover/isabelle/pure/raw-simplifier.ts +16 -63
  134. package/src/prover/isabelle/pure/rewriter.ts +34 -77
  135. package/src/prover/isabelle/pure/search.ts +2 -11
  136. package/src/prover/isabelle/pure/seq.ts +0 -11
  137. package/src/prover/isabelle/pure/simplifier.ts +27 -16
  138. package/src/prover/isabelle/pure/table.ts +2 -33
  139. package/src/prover/isabelle/pure/tactic.ts +11 -23
  140. package/src/prover/isabelle/pure/tactical.ts +47 -48
  141. package/src/prover/isabelle/pure/term-ord.ts +1 -7
  142. package/src/prover/isabelle/pure/term.ts +4 -47
  143. package/src/prover/isabelle/pure/thm.ts +26 -48
  144. package/src/prover/isabelle/pure/type.ts +1 -16
  145. package/src/prover/isabelle/pure/unify.ts +19 -31
  146. package/src/prover/isabelle/pure/variable.ts +2 -8
  147. package/src/prover/isabelle/tla/classical-setup.ts +17 -25
  148. package/src/prover/isabelle/tla/context.ts +65 -26
  149. package/src/prover/isabelle/tla/logic-data.ts +1 -1
  150. package/src/prover/isabelle/tla/logic.ts +53 -32
  151. package/src/prover/isabelle/tla/simpdata.ts +45 -44
  152. package/src/prover/isabelle/tools/intuitionistic.ts +28 -21
  153. package/src/prover/ocaml.ts +4 -7
  154. package/src/prover/prep/action.ts +33 -66
  155. package/src/prover/prep/enabled-axioms.ts +22 -20
  156. package/src/prover/prep/fingerprint.ts +2 -21
  157. package/src/prover/prep/level-comparison.ts +8 -12
  158. package/src/prover/prep/md5.ts +26 -31
  159. package/src/prover/prep/methods.ts +189 -86
  160. package/src/prover/prep/normalize.ts +42 -37
  161. package/src/prover/prove-worker.ts +0 -2
  162. package/src/prover/prove.ts +398 -133
  163. package/src/prover/ptl/decide.ts +96 -56
  164. package/src/prover/ptl/encode.ts +15 -38
  165. package/src/prover/ptl/sat.ts +24 -32
  166. package/src/prover/ptl/tableau.ts +40 -28
  167. package/src/prover/smt/arithmetic.ts +310 -0
  168. package/src/prover/smt/axioms.ts +12 -15
  169. package/src/prover/smt/context.ts +60 -32
  170. package/src/prover/smt/data.ts +517 -401
  171. package/src/prover/smt/encode.ts +155 -85
  172. package/src/prover/smt/extensionality.ts +5 -13
  173. package/src/prover/smt/flatten.ts +7 -28
  174. package/src/prover/smt/format.ts +33 -14
  175. package/src/prover/smt/instances.ts +7 -11
  176. package/src/prover/smt/layout.ts +91 -0
  177. package/src/prover/smt/rewrite.ts +1021 -658
  178. package/src/prover/smt/simplify.ts +441 -0
  179. package/src/prover/smt/solver/ackermannize-bv-tactic.ts +61 -0
  180. package/src/prover/smt/solver/ackr-helper.ts +179 -0
  181. package/src/prover/smt/solver/ackr-model-converter.ts +105 -0
  182. package/src/prover/smt/solver/act-cache.ts +0 -16
  183. package/src/prover/smt/solver/add-bounds-tactic.ts +59 -0
  184. package/src/prover/smt/solver/aig-tactic.ts +52 -0
  185. package/src/prover/smt/solver/aig.ts +889 -0
  186. package/src/prover/smt/solver/arith-rewriter.ts +626 -56
  187. package/src/prover/smt/solver/arith-terms.ts +121 -0
  188. package/src/prover/smt/solver/array-decl-plugin.ts +175 -0
  189. package/src/prover/smt/solver/array-rewriter.ts +319 -0
  190. package/src/prover/smt/solver/array.ts +1 -3
  191. package/src/prover/smt/solver/asserted-formulas.ts +241 -99
  192. package/src/prover/smt/solver/ast-lt.ts +165 -21
  193. package/src/prover/smt/solver/ast-util.ts +160 -7
  194. package/src/prover/smt/solver/ast.ts +1480 -184
  195. package/src/prover/smt/solver/auf-solver.ts +30 -56
  196. package/src/prover/smt/solver/bit-blast-tactic.ts +608 -0
  197. package/src/prover/smt/solver/bit-blaster.ts +871 -0
  198. package/src/prover/smt/solver/blast-term-ite.ts +47 -0
  199. package/src/prover/smt/solver/bound-manager.ts +196 -0
  200. package/src/prover/smt/solver/bound-simplifier.ts +598 -0
  201. package/src/prover/smt/solver/bv-bound-chk.ts +492 -0
  202. package/src/prover/smt/solver/bv-decl-plugin.ts +341 -0
  203. package/src/prover/smt/solver/bv-divrem-bounds.ts +95 -0
  204. package/src/prover/smt/solver/bv-rewriter.ts +1901 -0
  205. package/src/prover/smt/solver/bv1-blast.ts +214 -0
  206. package/src/prover/smt/solver/bv2fpa-converter.ts +174 -0
  207. package/src/prover/smt/solver/bv2int-rewriter.ts +544 -0
  208. package/src/prover/smt/solver/bv2real-rewriter.ts +533 -0
  209. package/src/prover/smt/solver/card2bv.ts +127 -0
  210. package/src/prover/smt/solver/case-split-queue.ts +0 -10
  211. package/src/prover/smt/solver/cg-table.ts +39 -42
  212. package/src/prover/smt/solver/check-logic.ts +330 -0
  213. package/src/prover/smt/solver/clause.ts +0 -27
  214. package/src/prover/smt/solver/cofactor-elim-term-ite.ts +293 -0
  215. package/src/prover/smt/solver/conflict-resolution.ts +78 -11
  216. package/src/prover/smt/solver/context.ts +600 -187
  217. package/src/prover/smt/solver/ctx-simplify.ts +34 -52
  218. package/src/prover/smt/solver/ctx-solver-simplify.ts +122 -0
  219. package/src/prover/smt/solver/datatype-decl-plugin.ts +580 -0
  220. package/src/prover/smt/solver/datatype-rewriter.ts +82 -0
  221. package/src/prover/smt/solver/demodulator.ts +786 -0
  222. package/src/prover/smt/solver/dependent-expr-state.ts +93 -0
  223. package/src/prover/smt/solver/der.ts +39 -30
  224. package/src/prover/smt/solver/diff-neq.ts +205 -0
  225. package/src/prover/smt/solver/distribute-forall.ts +57 -0
  226. package/src/prover/smt/solver/dom-simplify.ts +511 -0
  227. package/src/prover/smt/solver/dt2bv-tactic.ts +296 -0
  228. package/src/prover/smt/solver/dyn-ack.ts +0 -11
  229. package/src/prover/smt/solver/e-matching.ts +9 -41
  230. package/src/prover/smt/solver/elim-bounds.ts +89 -0
  231. package/src/prover/smt/solver/elim-small-bv-tactic.ts +129 -0
  232. package/src/prover/smt/solver/elim-term-ite-tactic.ts +48 -0
  233. package/src/prover/smt/solver/elim-uncnstr.ts +542 -0
  234. package/src/prover/smt/solver/enode.ts +100 -23
  235. package/src/prover/smt/solver/eq2bv-tactic.ts +218 -0
  236. package/src/prover/smt/solver/euf/arith-axioms.ts +403 -0
  237. package/src/prover/smt/solver/euf/arith-internalize.ts +653 -0
  238. package/src/prover/smt/solver/euf/arith-solver.ts +889 -0
  239. package/src/prover/smt/solver/euf/array-axioms.ts +527 -0
  240. package/src/prover/smt/solver/euf/array-internalize.ts +428 -0
  241. package/src/prover/smt/solver/euf/array-solver.ts +306 -0
  242. package/src/prover/smt/solver/euf/bv-ackerman.ts +162 -0
  243. package/src/prover/smt/solver/euf/bv-internalize.ts +748 -0
  244. package/src/prover/smt/solver/euf/bv-solver.ts +449 -0
  245. package/src/prover/smt/solver/euf/dt-solver.ts +618 -0
  246. package/src/prover/smt/solver/euf/egraph.ts +901 -0
  247. package/src/prover/smt/solver/euf/euf-solver.ts +1204 -0
  248. package/src/prover/smt/solver/euf/fpa-solver.ts +317 -0
  249. package/src/prover/smt/solver/euf/mam.ts +1046 -0
  250. package/src/prover/smt/solver/euf/q-ematch.ts +829 -0
  251. package/src/prover/smt/solver/euf/q-mbi.ts +587 -0
  252. package/src/prover/smt/solver/euf/q-model-fixer.ts +296 -0
  253. package/src/prover/smt/solver/euf/q-solver.ts +361 -0
  254. package/src/prover/smt/solver/euf/th-solver.ts +328 -0
  255. package/src/prover/smt/solver/euf/th-solvers.ts +30 -0
  256. package/src/prover/smt/solver/expr-ref.ts +0 -5
  257. package/src/prover/smt/solver/expr-safe-replace.ts +26 -7
  258. package/src/prover/smt/solver/expr2polynomial.ts +271 -0
  259. package/src/prover/smt/solver/factor.ts +163 -0
  260. package/src/prover/smt/solver/fd-solver.ts +734 -0
  261. package/src/prover/smt/solver/fingerprints.ts +15 -26
  262. package/src/prover/smt/solver/fix-dl-var.ts +147 -0
  263. package/src/prover/smt/solver/flat-literals.ts +0 -9
  264. package/src/prover/smt/solver/fm-tactic.ts +884 -0
  265. package/src/prover/smt/solver/fpa-decl-plugin.ts +618 -0
  266. package/src/prover/smt/solver/fpa-rewriter.ts +639 -0
  267. package/src/prover/smt/solver/fpa2bv-converter.ts +2251 -0
  268. package/src/prover/smt/solver/fpa2bv-rewriter.ts +349 -0
  269. package/src/prover/smt/solver/fpa2bv-tactic.ts +73 -0
  270. package/src/prover/smt/solver/goal.ts +179 -28
  271. package/src/prover/smt/solver/goal2nlsat.ts +216 -0
  272. package/src/prover/smt/solver/guard-set.ts +219 -0
  273. package/src/prover/smt/solver/hash.ts +0 -9
  274. package/src/prover/smt/solver/hashtable.ts +30 -23
  275. package/src/prover/smt/solver/inf-eps.ts +63 -0
  276. package/src/prover/smt/solver/inj-axiom.ts +101 -0
  277. package/src/prover/smt/solver/internalizer.ts +113 -133
  278. package/src/prover/smt/solver/lackr.ts +381 -0
  279. package/src/prover/smt/solver/lbool.ts +0 -2
  280. package/src/prover/smt/solver/lia2card.ts +268 -0
  281. package/src/prover/smt/solver/lia2pb.ts +154 -0
  282. package/src/prover/smt/solver/literal.ts +0 -4
  283. package/src/prover/smt/solver/logic-tactics.ts +355 -0
  284. package/src/prover/smt/solver/lp/bound-propagator.ts +7 -26
  285. package/src/prover/smt/solver/lp/constraints.ts +1 -8
  286. package/src/prover/smt/solver/lp/containers.ts +18 -31
  287. package/src/prover/smt/solver/lp/core-solver.ts +35 -37
  288. package/src/prover/smt/solver/lp/cross-nested.ts +4 -21
  289. package/src/prover/smt/solver/lp/dep-intervals.ts +6 -24
  290. package/src/prover/smt/solver/lp/dependency.ts +0 -5
  291. package/src/prover/smt/solver/lp/dioph-eq.ts +8 -103
  292. package/src/prover/smt/solver/lp/explanation.ts +0 -6
  293. package/src/prover/smt/solver/lp/gomory.ts +8 -22
  294. package/src/prover/smt/solver/lp/hnf-cutter.ts +16 -23
  295. package/src/prover/smt/solver/lp/hnf.ts +10 -28
  296. package/src/prover/smt/solver/lp/int-cube.ts +17 -39
  297. package/src/prover/smt/solver/lp/int-solver.ts +3 -35
  298. package/src/prover/smt/solver/lp/lar-solver.ts +70 -83
  299. package/src/prover/smt/solver/lp/lar-term.ts +0 -5
  300. package/src/prover/smt/solver/lp/lp-settings.ts +6 -16
  301. package/src/prover/smt/solver/lp/maximize-term.ts +76 -52
  302. package/src/prover/smt/solver/lp/nex-creator.ts +7 -30
  303. package/src/prover/smt/solver/lp/nex.ts +2 -7
  304. package/src/prover/smt/solver/lp/nla-backoff.ts +0 -5
  305. package/src/prover/smt/solver/lp/nla-basics.ts +48 -30
  306. package/src/prover/smt/solver/lp/nla-core.ts +92 -136
  307. package/src/prover/smt/solver/lp/nla-divisions.ts +31 -43
  308. package/src/prover/smt/solver/lp/nla-emonics.ts +3 -21
  309. package/src/prover/smt/solver/lp/nla-factorization.ts +0 -4
  310. package/src/prover/smt/solver/lp/nla-grobner.ts +177 -149
  311. package/src/prover/smt/solver/lp/nla-horner.ts +2 -12
  312. package/src/prover/smt/solver/lp/nla-intervals.ts +1 -12
  313. package/src/prover/smt/solver/lp/nla-monomial-bounds.ts +15 -42
  314. package/src/prover/smt/solver/lp/nla-monotone.ts +1 -6
  315. package/src/prover/smt/solver/lp/nla-order.ts +0 -13
  316. package/src/prover/smt/solver/lp/nla-patcher.ts +3 -7
  317. package/src/prover/smt/solver/lp/nla-powers.ts +220 -0
  318. package/src/prover/smt/solver/lp/nla-tangents.ts +0 -10
  319. package/src/prover/smt/solver/lp/nla-throttle.ts +0 -6
  320. package/src/prover/smt/solver/lp/nla-transcendentals.ts +324 -0
  321. package/src/prover/smt/solver/lp/nla-types.ts +0 -12
  322. package/src/prover/smt/solver/lp/nla-var-eqs.ts +4 -26
  323. package/src/prover/smt/solver/lp/nra-solver.ts +164 -147
  324. package/src/prover/smt/solver/lp/numeric-pair.ts +0 -4
  325. package/src/prover/smt/solver/lp/pdd-interval.ts +6 -5
  326. package/src/prover/smt/solver/lp/pdd-simplifier.ts +61 -34
  327. package/src/prover/smt/solver/lp/pdd-solver.ts +74 -72
  328. package/src/prover/smt/solver/lp/pdd.ts +730 -358
  329. package/src/prover/smt/solver/lp/random-updater.ts +0 -9
  330. package/src/prover/smt/solver/lp/static-matrix.ts +8 -19
  331. package/src/prover/smt/solver/lp/union-find.ts +5 -5
  332. package/src/prover/smt/solver/macro-finder.ts +530 -0
  333. package/src/prover/smt/solver/mam-compiler.ts +129 -139
  334. package/src/prover/smt/solver/mam-interpreter.ts +0 -21
  335. package/src/prover/smt/solver/max-bv-sharing-tactic.ts +17 -0
  336. package/src/prover/smt/solver/max-cliques.ts +105 -0
  337. package/src/prover/smt/solver/maxcore.ts +310 -0
  338. package/src/prover/smt/solver/maximize-ac-sharing.ts +8 -21
  339. package/src/prover/smt/solver/maxlex.ts +115 -0
  340. package/src/prover/smt/solver/maxsmt-base.ts +106 -0
  341. package/src/prover/smt/solver/maxsmt.ts +92 -0
  342. package/src/prover/smt/solver/mbp/mbp-arith.ts +467 -0
  343. package/src/prover/smt/solver/mbp/mbp-basic-tg.ts +101 -0
  344. package/src/prover/smt/solver/mbp/mbp-plugin.ts +287 -0
  345. package/src/prover/smt/solver/mbp/mbp-qel.ts +48 -0
  346. package/src/prover/smt/solver/mbp/mbp-solve-plugin.ts +271 -0
  347. package/src/prover/smt/solver/mbp/mbp-term-graph.ts +606 -0
  348. package/src/prover/smt/solver/model-based-opt.ts +844 -0
  349. package/src/prover/smt/solver/model-checker.ts +20 -63
  350. package/src/prover/smt/solver/model-evaluator.ts +192 -40
  351. package/src/prover/smt/solver/model-finder.ts +14 -32
  352. package/src/prover/smt/solver/model-generator.ts +104 -46
  353. package/src/prover/smt/solver/model-macro-solver.ts +60 -114
  354. package/src/prover/smt/solver/model-printer.ts +214 -0
  355. package/src/prover/smt/solver/mpf.ts +709 -0
  356. package/src/prover/smt/solver/mus.ts +50 -0
  357. package/src/prover/smt/solver/muz/dl-context.ts +382 -0
  358. package/src/prover/smt/solver/muz/dl-mk-bit-blast.ts +97 -0
  359. package/src/prover/smt/solver/muz/dl-mk-coi-filter.ts +167 -0
  360. package/src/prover/smt/solver/muz/dl-mk-elim-term-ite.ts +125 -0
  361. package/src/prover/smt/solver/muz/dl-mk-interp-tail-simplifier.ts +299 -0
  362. package/src/prover/smt/solver/muz/dl-mk-rule-inliner.ts +455 -0
  363. package/src/prover/smt/solver/muz/dl-mk-slice.ts +340 -0
  364. package/src/prover/smt/solver/muz/dl-mk-subsumption-checker.ts +163 -0
  365. package/src/prover/smt/solver/muz/dl-rule-set.ts +273 -0
  366. package/src/prover/smt/solver/muz/dl-rule-transformer.ts +123 -0
  367. package/src/prover/smt/solver/muz/dl-rule.ts +495 -0
  368. package/src/prover/smt/solver/muz/hnf.ts +201 -0
  369. package/src/prover/smt/solver/muz/horn-subsume-model-converter.ts +176 -0
  370. package/src/prover/smt/solver/muz/horn-tactic.ts +214 -0
  371. package/src/prover/smt/solver/muz/rule-properties.ts +359 -0
  372. package/src/prover/smt/solver/muz/spacer-context.ts +1404 -0
  373. package/src/prover/smt/solver/muz/spacer-dl-interface.ts +52 -0
  374. package/src/prover/smt/solver/muz/spacer-generalizers.ts +241 -0
  375. package/src/prover/smt/solver/muz/spacer-manager.ts +127 -0
  376. package/src/prover/smt/solver/muz/spacer-pdr.ts +219 -0
  377. package/src/prover/smt/solver/muz/spacer-prop-solver.ts +333 -0
  378. package/src/prover/smt/solver/muz/spacer-util.ts +282 -0
  379. package/src/prover/smt/solver/muz/substitution.ts +203 -0
  380. package/src/prover/smt/solver/nla2bv-tactic.ts +285 -0
  381. package/src/prover/smt/solver/nlqsat.ts +484 -0
  382. package/src/prover/smt/solver/nlsat/algebraic.ts +357 -236
  383. package/src/prover/smt/solver/nlsat/atoms.ts +73 -54
  384. package/src/prover/smt/solver/nlsat/evaluator.ts +16 -22
  385. package/src/prover/smt/solver/nlsat/explain.ts +429 -275
  386. package/src/prover/smt/solver/nlsat/interval-set.ts +9 -51
  387. package/src/prover/smt/solver/nlsat/levelwise.ts +477 -344
  388. package/src/prover/smt/solver/nlsat/mpbq.ts +47 -14
  389. package/src/prover/smt/solver/nlsat/polynomial.ts +2385 -832
  390. package/src/prover/smt/solver/nlsat/solver.ts +297 -156
  391. package/src/prover/smt/solver/nlsat/transcendental-eval.ts +310 -0
  392. package/src/prover/smt/solver/nlsat/transcendentals.ts +391 -0
  393. package/src/prover/smt/solver/nlsat/types.ts +0 -9
  394. package/src/prover/smt/solver/nlsat/upolynomial-factorization.ts +9 -51
  395. package/src/prover/smt/solver/nlsat/upolynomial.ts +49 -109
  396. package/src/prover/smt/solver/nlsat-tactic.ts +82 -0
  397. package/src/prover/smt/solver/nnf.ts +112 -61
  398. package/src/prover/smt/solver/normalize-bounds.ts +53 -0
  399. package/src/prover/smt/solver/occf.ts +97 -0
  400. package/src/prover/smt/solver/opt-context.ts +801 -0
  401. package/src/prover/smt/solver/opt-nlsat.ts +386 -0
  402. package/src/prover/smt/solver/opt-pareto.ts +301 -0
  403. package/src/prover/smt/solver/opt-preprocess.ts +101 -0
  404. package/src/prover/smt/solver/opt-solver.ts +312 -0
  405. package/src/prover/smt/solver/opt-value.ts +55 -0
  406. package/src/prover/smt/solver/optsmt.ts +692 -0
  407. package/src/prover/smt/solver/parallel-tactic.ts +299 -0
  408. package/src/prover/smt/solver/pattern-inference.ts +21 -26
  409. package/src/prover/smt/solver/pb-rewriter.ts +281 -0
  410. package/src/prover/smt/solver/pb2bv-tactic.ts +540 -0
  411. package/src/prover/smt/solver/poly-rewriter.ts +261 -79
  412. package/src/prover/smt/solver/probes.ts +577 -0
  413. package/src/prover/smt/solver/propagate-values.ts +37 -30
  414. package/src/prover/smt/solver/proto-model.ts +650 -66
  415. package/src/prover/smt/solver/pull-quant.ts +28 -23
  416. package/src/prover/smt/solver/purify-arith.ts +632 -0
  417. package/src/prover/smt/solver/push-app-ite.ts +37 -0
  418. package/src/prover/smt/solver/qe-arith-plugin.ts +1096 -0
  419. package/src/prover/smt/solver/qe-lite-der.ts +2 -31
  420. package/src/prover/smt/solver/qe-lite-fm.ts +4 -28
  421. package/src/prover/smt/solver/qe-lite.ts +41 -51
  422. package/src/prover/smt/solver/qe-mbp.ts +270 -0
  423. package/src/prover/smt/solver/qe.ts +1499 -0
  424. package/src/prover/smt/solver/qel.ts +25 -0
  425. package/src/prover/smt/solver/qi-queue.ts +0 -16
  426. package/src/prover/smt/solver/qsat.ts +829 -0
  427. package/src/prover/smt/solver/quant-hoist.ts +196 -0
  428. package/src/prover/smt/solver/quant-tactics.ts +17 -74
  429. package/src/prover/smt/solver/quantifier-analyzer.ts +26 -47
  430. package/src/prover/smt/solver/quantifier-manager.ts +22 -32
  431. package/src/prover/smt/solver/quasi-macros.ts +243 -0
  432. package/src/prover/smt/solver/random-gen.ts +0 -2
  433. package/src/prover/smt/solver/rational.ts +45 -8
  434. package/src/prover/smt/solver/recfun-decl-plugin.ts +262 -0
  435. package/src/prover/smt/solver/recfun-rewriter.ts +107 -0
  436. package/src/prover/smt/solver/reduce-args.ts +225 -0
  437. package/src/prover/smt/solver/reduce-bv-size.ts +119 -0
  438. package/src/prover/smt/solver/ref-vector.ts +0 -6
  439. package/src/prover/smt/solver/relevancy.ts +2 -16
  440. package/src/prover/smt/solver/rewriter-tpl.ts +59 -135
  441. package/src/prover/smt/solver/rewriter.ts +507 -144
  442. package/src/prover/smt/solver/rlimit.ts +46 -24
  443. package/src/prover/smt/solver/sat/asymm-branch.ts +325 -0
  444. package/src/prover/smt/solver/sat/big.ts +177 -0
  445. package/src/prover/smt/solver/sat/clause-use-list.ts +71 -0
  446. package/src/prover/smt/solver/sat/clause.ts +203 -0
  447. package/src/prover/smt/solver/sat/cleaner.ts +94 -0
  448. package/src/prover/smt/solver/sat/config.ts +122 -0
  449. package/src/prover/smt/solver/sat/consequences.ts +203 -0
  450. package/src/prover/smt/solver/sat/elim-eqs.ts +142 -0
  451. package/src/prover/smt/solver/sat/goal2sat.ts +579 -0
  452. package/src/prover/smt/solver/sat/inc-sat-solver.ts +464 -0
  453. package/src/prover/smt/solver/sat/model-converter.ts +136 -0
  454. package/src/prover/smt/solver/sat/pb-constraint.ts +268 -0
  455. package/src/prover/smt/solver/sat/pb-solver.ts +1596 -0
  456. package/src/prover/smt/solver/sat/probing.ts +170 -0
  457. package/src/prover/smt/solver/sat/sat-tactic.ts +53 -0
  458. package/src/prover/smt/solver/sat/sat2goal.ts +189 -0
  459. package/src/prover/smt/solver/sat/scc.ts +142 -0
  460. package/src/prover/smt/solver/sat/simplifier.ts +1618 -0
  461. package/src/prover/smt/solver/sat/solver.ts +2107 -0
  462. package/src/prover/smt/solver/sat/var-queue.ts +117 -0
  463. package/src/prover/smt/solver/sat/watch-list.ts +140 -0
  464. package/src/prover/smt/solver/search-tree.ts +284 -0
  465. package/src/prover/smt/solver/seq-axioms.ts +995 -0
  466. package/src/prover/smt/solver/seq-decl-plugin.ts +819 -0
  467. package/src/prover/smt/solver/seq-derive.ts +1298 -0
  468. package/src/prover/smt/solver/seq-eq-approx.ts +236 -0
  469. package/src/prover/smt/solver/seq-eq-solver.ts +439 -0
  470. package/src/prover/smt/solver/seq-factory.ts +89 -0
  471. package/src/prover/smt/solver/seq-monadic.ts +730 -0
  472. package/src/prover/smt/solver/seq-range-predicate.ts +235 -0
  473. package/src/prover/smt/solver/seq-re-rewriter.ts +1171 -0
  474. package/src/prover/smt/solver/seq-re-util.ts +758 -0
  475. package/src/prover/smt/solver/seq-regex-bisim.ts +144 -0
  476. package/src/prover/smt/solver/seq-regex-live.ts +200 -0
  477. package/src/prover/smt/solver/seq-rewriter.ts +2404 -0
  478. package/src/prover/smt/solver/seq-skolem.ts +294 -0
  479. package/src/prover/smt/solver/seq-subset.ts +165 -0
  480. package/src/prover/smt/solver/seq-view-witness.ts +353 -0
  481. package/src/prover/smt/solver/smt-consequences.ts +297 -0
  482. package/src/prover/smt/solver/smt-kernel.ts +124 -0
  483. package/src/prover/smt/solver/smt-logics.ts +66 -0
  484. package/src/prover/smt/solver/smt-setup.ts +589 -0
  485. package/src/prover/smt/solver/smt2-printer.ts +765 -0
  486. package/src/prover/smt/solver/smtlib-parser.ts +3546 -406
  487. package/src/prover/smt/solver/smtlib-script.ts +2134 -0
  488. package/src/prover/smt/solver/solve-eqs.ts +928 -0
  489. package/src/prover/smt/solver/solver.ts +135 -40
  490. package/src/prover/smt/solver/sort.ts +1 -5
  491. package/src/prover/smt/solver/static-features.ts +314 -0
  492. package/src/prover/smt/solver/sticky-generations.ts +0 -6
  493. package/src/prover/smt/solver/tactic.ts +2141 -0
  494. package/src/prover/smt/solver/term-enumeration.ts +205 -0
  495. package/src/prover/smt/solver/theory-array.ts +1240 -0
  496. package/src/prover/smt/solver/theory-bv.ts +1210 -0
  497. package/src/prover/smt/solver/theory-char.ts +355 -0
  498. package/src/prover/smt/solver/theory-datatype.ts +598 -0
  499. package/src/prover/smt/solver/theory-finite-set.ts +30 -0
  500. package/src/prover/smt/solver/theory-fpa.ts +389 -0
  501. package/src/prover/smt/solver/theory-lra-axioms.ts +55 -25
  502. package/src/prover/smt/solver/theory-lra-bounds.ts +31 -11
  503. package/src/prover/smt/solver/theory-lra-final-check.ts +60 -91
  504. package/src/prover/smt/solver/theory-lra-internalize.ts +96 -53
  505. package/src/prover/smt/solver/theory-lra-model.ts +23 -53
  506. package/src/prover/smt/solver/theory-lra-propagate.ts +34 -42
  507. package/src/prover/smt/solver/theory-lra-state.ts +7 -28
  508. package/src/prover/smt/solver/theory-lra.ts +189 -9
  509. package/src/prover/smt/solver/theory-pb.ts +951 -0
  510. package/src/prover/smt/solver/theory-polymorphism.ts +58 -0
  511. package/src/prover/smt/solver/theory-recfun.ts +307 -0
  512. package/src/prover/smt/solver/theory-seq-regex.ts +867 -0
  513. package/src/prover/smt/solver/theory-seq-solve.ts +1373 -0
  514. package/src/prover/smt/solver/theory-seq-state.ts +852 -0
  515. package/src/prover/smt/solver/theory-seq.ts +961 -0
  516. package/src/prover/smt/solver/theory-without-terms.ts +24 -0
  517. package/src/prover/smt/solver/theory.ts +189 -0
  518. package/src/prover/smt/solver/tseitin-cnf.ts +486 -0
  519. package/src/prover/smt/solver/var-subst.ts +37 -39
  520. package/src/prover/smt/table.ts +3 -10
  521. package/src/prover/smt/types.ts +146 -0
  522. package/src/prover/tlapm/cache.ts +74 -48
  523. package/src/prover/tlapm/ocaml-marshal.ts +19 -21
  524. package/src/prover/tlapm/tlapm.ts +21 -20
  525. package/src/prover/tlapm-library.ts +3208 -0
  526. package/src/prover/verdict.ts +9 -2
  527. package/src/prover/zenon/check/check.ts +1 -11
  528. package/src/prover/zenon/check/definitions.ts +5 -15
  529. package/src/prover/zenon/check/equality.ts +0 -8
  530. package/src/prover/zenon/check/functions.ts +0 -4
  531. package/src/prover/zenon/check/keys.ts +0 -7
  532. package/src/prover/zenon/check/propositional.ts +0 -3
  533. package/src/prover/zenon/check/records.ts +1 -6
  534. package/src/prover/zenon/check/relations.ts +2 -14
  535. package/src/prover/zenon/check/rewrites.ts +2 -21
  536. package/src/prover/zenon/check/sets.ts +40 -61
  537. package/src/prover/zenon/check/terms.ts +1 -19
  538. package/src/prover/zenon/check/tla.ts +0 -6
  539. package/src/prover/zenon/decide.ts +10 -19
  540. package/src/prover/zenon/encode.ts +0 -9
  541. package/src/prover/zenon/eqrel.ts +2 -15
  542. package/src/prover/zenon/equality-rules.ts +24 -6
  543. package/src/prover/zenon/expr.ts +29 -28
  544. package/src/prover/zenon/index-table.ts +33 -61
  545. package/src/prover/zenon/isar-case.ts +9 -21
  546. package/src/prover/zenon/isar.ts +37 -67
  547. package/src/prover/zenon/limits.ts +0 -4
  548. package/src/prover/zenon/llproof.ts +2 -22
  549. package/src/prover/zenon/mltoll.ts +66 -106
  550. package/src/prover/zenon/node.ts +20 -15
  551. package/src/prover/zenon/ocaml.ts +1 -17
  552. package/src/prover/zenon/parse.ts +9 -13
  553. package/src/prover/zenon/phrase.ts +2 -14
  554. package/src/prover/zenon/proof.ts +0 -11
  555. package/src/prover/zenon/propositional-rules.ts +0 -7
  556. package/src/prover/zenon/rules.ts +3 -8
  557. package/src/prover/zenon/search.ts +11 -35
  558. package/src/prover/zenon/tla/functions.ts +59 -33
  559. package/src/prover/zenon/tla/llproof.ts +67 -78
  560. package/src/prover/zenon/tla/records.ts +57 -35
  561. package/src/prover/zenon/tla/rewrites.ts +12 -21
  562. package/src/prover/zenon/tla/sets.ts +88 -59
  563. package/src/prover/zenon/tla/terms.ts +0 -8
  564. package/src/prover/zenon/tla/tla.ts +66 -66
  565. package/src/randomization.ts +81 -35
  566. package/src/resolve.ts +1132 -430
  567. package/src/runtime.ts +33 -23
  568. package/src/sany/builtins.ts +11 -14
  569. package/src/sany/generation.ts +383 -0
  570. package/src/sany/generator-def-entries.ts +210 -0
  571. package/src/sany/generator-definitions.ts +688 -0
  572. package/src/sany/generator-expressions.ts +1108 -0
  573. package/src/sany/generator-proofs.ts +665 -0
  574. package/src/sany/generator.ts +192 -2764
  575. package/src/sany/levels.ts +5 -35
  576. package/src/sany/lexer.ts +61 -80
  577. package/src/sany/linter.ts +0 -10
  578. package/src/sany/modules.ts +5 -7
  579. package/src/sany/nodes.ts +6 -44
  580. package/src/sany/parse-error.ts +39 -117
  581. package/src/sany/report.ts +32 -69
  582. package/src/sany/selectors.ts +60 -82
  583. package/src/sany/source.ts +1 -17
  584. package/src/sany/xml.ts +37 -120
  585. package/src/search.ts +913 -227
  586. package/src/simulate.ts +765 -0
  587. package/src/spec-description.ts +198 -104
  588. package/src/standard-definitions.ts +4 -4
  589. package/src/standard-modules.ts +302 -99
  590. package/src/state-graph.ts +52 -33
  591. package/src/subexpressions.ts +578 -166
  592. package/src/substitution-levels.ts +7 -7
  593. package/src/successors.ts +299 -108
  594. package/src/symmetry.ts +37 -28
  595. package/src/tableau.ts +29 -26
  596. package/src/tlc/fingerprint.ts +267 -79
  597. package/src/tlc/jar-data.ts +122 -6
  598. package/src/tlc/messages.ts +127 -56
  599. package/src/tlc/order.ts +53 -72
  600. package/src/tlc/random.ts +38 -49
  601. package/src/tlc/replay.ts +579 -230
  602. package/src/tlc/summary.ts +64 -60
  603. package/src/tlc/tlc-operators.ts +83 -47
  604. package/src/tlc/tlcext-operators.ts +205 -127
  605. package/src/tlc/trace-spec.ts +235 -0
  606. package/src/tlc/value-stream.ts +139 -0
  607. package/src/tlc/version.ts +1 -4
  608. package/src/trace-liveness.ts +529 -0
  609. package/src/transfer.ts +22 -25
  610. package/src/typed-tier.ts +6556 -0
  611. package/src/typescript/actions.ts +479 -0
  612. package/src/typescript/collections.ts +614 -0
  613. package/src/typescript/compile.ts +63 -0
  614. package/src/typescript/context.ts +94 -0
  615. package/src/typescript/emit.ts +121 -0
  616. package/src/typescript/expressions.ts +496 -0
  617. package/src/typescript/formula.ts +154 -0
  618. package/src/typescript/functions.ts +284 -0
  619. package/src/typescript/model.ts +162 -0
  620. package/src/typescript/names.ts +114 -0
  621. package/src/typescript/program.ts +48 -0
  622. package/src/typescript/properties.ts +139 -0
  623. package/src/typescript/scope.ts +112 -0
  624. package/src/typescript/steps.ts +167 -0
  625. package/src/typescript/types.ts +171 -0
  626. package/src/values.ts +945 -526
  627. package/src/worker.ts +7 -8
  628. package/src/prover/isabelle/isar/statement.ts +0 -57
  629. package/src/prover/smt/solver/z3-license.txt +0 -10
  630. package/src/prover/tlaps-module.ts +0 -510
  631. package/src/prover/zenon/LICENSE +0 -32
package/src/search.ts CHANGED
@@ -10,17 +10,39 @@ import type {
10
10
  CheckOptions,
11
11
  InitialStatesProgress,
12
12
  InitialStateViolation,
13
+ ModuleOperator,
13
14
  Postcondition,
14
15
  Violation,
15
16
  } from "./check";
16
- import type { ConfigValue, ModelConfig } from "./config";
17
- import { getReadVariables, isConstantLevel } from "./dependencies";
17
+ import { parseConfig, type ConfigValue, type ModelConfig } from "./config";
18
+ import {
19
+ addCoverageRelation,
20
+ buildCoverage,
21
+ createCoverage,
22
+ createCoverageEnvironment,
23
+ getCoverageLabel,
24
+ getCoverageReport,
25
+ runAtCoverageNode,
26
+ type Coverage,
27
+ type CoverageKind,
28
+ } from "./coverage";
29
+ import {
30
+ getReadVariables,
31
+ isConstantLevel,
32
+ isExpressionImpure,
33
+ isImpureDefinition,
34
+ } from "./dependencies";
35
+ import {
36
+ createEnvironment,
37
+ type ResolvedModuleOperator,
38
+ type RuntimeInvariant,
39
+ } from "./environment";
18
40
  import {
19
- isStackOverflow,
20
41
  TlaConfigError,
21
42
  TlaEvaluationError,
22
43
  TlaModuleError,
23
44
  UNEXPECTED_EXCEPTION,
45
+ formatRange,
24
46
  } from "./errors";
25
47
  import {
26
48
  describeNode,
@@ -29,11 +51,12 @@ import {
29
51
  evaluateStartupDefinitions,
30
52
  getStartupValue,
31
53
  expectBoolean,
32
- formatRange,
54
+ expectBooleanBody,
33
55
  getDefinition,
34
56
  type Context,
35
57
  type Environment,
36
58
  type Scope,
59
+ type State,
37
60
  } from "./evaluate";
38
61
  import { EXIT_STATUS, setExitCode } from "./exit-codes";
39
62
  import type { JavaOverride } from "./java-overrides";
@@ -45,12 +68,74 @@ import {
45
68
  VARIABLE_LEVEL,
46
69
  } from "./levels";
47
70
  import { expandTemporal, getLevel, type ScopedExpression, type TemporalProperty } from "./liveness";
71
+ import { getLiveExpressions } from "./liveness-checker";
48
72
  import { prettyPrint } from "./pretty-print";
49
73
  import { getPossibleCounts, type CheckerRuntime } from "./runtime";
50
- import { getRepresentative, getSymmetryGroup } from "./symmetry";
51
- import { MESSAGE_CODE, MISSING_INIT_174, withHeadline } from "./tlc/messages";
52
- import { getTlcFingerprint, getTlcFingerprints } from "./tlc/fingerprint";
53
- import { formatValue, isUpdatedElementOf, type Value } from "./values";
74
+ import { createIncompleteSuccessorError } from "./successors";
75
+ import {
76
+ getSpecDescription,
77
+ getSpecificationValue,
78
+ getSubscriptVariables,
79
+ type SpecAction,
80
+ type SpecDescription,
81
+ } from "./spec-description";
82
+ import { getRepresentative, getSymmetryGroup, type Images } from "./symmetry";
83
+ import type { Solution } from "./tableau";
84
+ import {
85
+ formatInnerMessage,
86
+ formatNestedMessage,
87
+ MESSAGE_CODE,
88
+ MISSING_INIT_174,
89
+ withHeadline,
90
+ } from "./tlc/messages";
91
+ import { createTlcOrder } from "./tlc/order";
92
+ import { getPrimedRanges, walkSuccessors } from "./tlc/replay";
93
+ import { getTlcFingerprint, getTlcFingerprints, setFingerprintPolynomial } from "./tlc/fingerprint";
94
+ import type { TlcVersion } from "./tlc/version";
95
+ import {
96
+ createModelValue,
97
+ formatValue,
98
+ freezeStringOrder,
99
+ getWrittenPairs,
100
+ isFunctionValue,
101
+ isUpdatedElementOf,
102
+ markNormalized,
103
+ setAliasName,
104
+ setStringOrder,
105
+ setValueOptions,
106
+ setViewText,
107
+ toFiniteFunction,
108
+ type Value,
109
+ } from "./values";
110
+
111
+ export interface CliSettings {
112
+ readLine?: () => string | undefined;
113
+ runtimeInvariants?: RuntimeInvariant[];
114
+ }
115
+
116
+ interface EnvironmentSettings
117
+ extends
118
+ Pick<
119
+ CheckOptions,
120
+ | "source"
121
+ | "loadModule"
122
+ | "loadClass"
123
+ | "readFile"
124
+ | "writeFile"
125
+ | "makeDirectory"
126
+ | "seed"
127
+ | "isTool"
128
+ | "traceSpec"
129
+ | "isSanyReported"
130
+ | "isWarningEnabled"
131
+ | "version"
132
+ | "moduleOperators"
133
+ | "fingerprintPolynomial"
134
+ | "maxSetSize"
135
+ | "isLazyValueExpanded"
136
+ | "isViewPrinted"
137
+ >,
138
+ CliSettings {}
54
139
 
55
140
  interface NamedExpression {
56
141
  name: string;
@@ -58,14 +143,18 @@ interface NamedExpression {
58
143
  scope: Scope | undefined;
59
144
  }
60
145
 
146
+ interface CoveredCheck {
147
+ expression: Expression;
148
+ scope: Scope | undefined;
149
+ node: number;
150
+ }
151
+
61
152
  interface StateCheck extends NamedExpression {
62
153
  variables: number[] | undefined;
63
154
  membership: Membership | undefined;
64
- // The whole predicate that TLC evaluates for the check, of which the expression is a conjunct.
65
155
  predicate: Expression;
66
156
  }
67
157
 
68
- // A conjunct `x \in S` whose S reads no variables.
69
158
  interface Membership {
70
159
  variable: number;
71
160
  set: Expression;
@@ -84,6 +173,7 @@ interface Specification {
84
173
  next: Expression | undefined;
85
174
  scope: Scope | undefined;
86
175
  temporals: ScopedExpression[];
176
+ isPropertyFairness: boolean;
87
177
  }
88
178
 
89
179
  interface Properties {
@@ -95,13 +185,18 @@ interface Properties {
95
185
 
96
186
  const START: SourceLocation = { line: 0, column: 0 };
97
187
 
98
- export const createIdentifier = (name: string): Expression => ({
188
+ const createIdentifier = (name: string): Expression => ({
99
189
  kind: "Identifier",
100
190
  name,
101
191
  location: START,
102
192
  });
103
193
 
104
- // TLC leaves the kind out when it rejects arguments to the specification or a property.
194
+ const createNamedIdentifier = (name: string): NamedExpression => ({
195
+ name,
196
+ expression: createIdentifier(name),
197
+ scope: undefined,
198
+ });
199
+
105
200
  const UNNAMED_ARGUMENT_KINDS = new Set(["name", "property"]);
106
201
 
107
202
  const getConfigOperator = (kind: string, name: string, environment: Environment) => {
@@ -121,22 +216,18 @@ const getConfigOperator = (kind: string, name: string, environment: Environment)
121
216
  return definition;
122
217
  };
123
218
 
124
- // TLC evaluates every constant definition before it reads the configuration. It keeps a literal
125
- // number or string, and a definition that fails to evaluate, as an operator.
219
+ const isLiteralDefinition = (definition: Definition) =>
220
+ definition.body.kind === "Number" || definition.body.kind === "String";
221
+
126
222
  const getConstantValue = (name: string, definition: Definition, environment: Environment) => {
127
- if (!isConstantLevel(definition, environment)) return undefined;
128
- if (definition.body.kind === "Number" || definition.body.kind === "String") return undefined;
129
- try {
130
- return evaluate(createIdentifier(name), getContext(environment, undefined, undefined));
131
- } catch (error) {
132
- // TLC swallows whatever the definition throws, a stack overflow included.
133
- if (error instanceof TlaEvaluationError || isStackOverflow(error)) return undefined;
134
- throw error;
135
- }
223
+ if (environment.constants.has(name)) return environment.constants.get(name);
224
+ return isLiteralDefinition(definition) ? undefined : getStartupValue(definition, environment);
136
225
  };
137
226
 
138
- // TLC takes for an operator only a definition it hasn't replaced with its value.
139
- export const getConfigDefinition = (kind: string, name: string, environment: Environment) => {
227
+ const getConfigDefinition = (kind: string, name: string, environment: Environment) => {
228
+ if (environment.constants.has(name)) {
229
+ throw new TlaConfigError(`The ${kind} ${name} cannot be a constant.`);
230
+ }
140
231
  const definition = getConfigOperator(kind, name, environment);
141
232
  if (getConstantValue(name, definition, environment) !== undefined) {
142
233
  throw new TlaConfigError(`The ${kind} ${name} cannot be a constant.`);
@@ -144,7 +235,6 @@ export const getConfigDefinition = (kind: string, name: string, environment: Env
144
235
  return definition;
145
236
  };
146
237
 
147
- // TLC also takes a constant that the configuration assigns a value, which must be TRUE.
148
238
  const getConfigPredicate = (kind: string, name: string, environment: Environment) => {
149
239
  const definition = environment.constants.has(name)
150
240
  ? undefined
@@ -167,26 +257,20 @@ export const reportInitialStatesProgress = (
167
257
  }
168
258
  };
169
259
 
170
- // After SANY, TLC computes the constant definitions and warns once about each invariant that is a
171
- // true constant formula, which it doesn't check.
260
+ interface StartupSpecification {
261
+ environment: Environment;
262
+ startupDefinitions: Definition[];
263
+ javaOverrides: JavaOverride[];
264
+ }
265
+
172
266
  export const reportStartup = (
173
- specification: {
174
- environment: Environment;
175
- startupDefinitions: Definition[];
176
- javaOverrides: JavaOverride[];
177
- },
267
+ specification: StartupSpecification,
178
268
  config: ModelConfig,
179
269
  onProgress: CheckOptions["onProgress"],
180
270
  ) => {
181
271
  const environment = specification.environment;
182
- const warned = new Set<string>();
183
- environment.runtime.warn = (code, text) => {
184
- if (warned.has(text)) return;
185
- warned.add(text);
186
- onProgress?.({ kind: "warning", code, text });
187
- };
272
+ environment.runtime.warn = (code, text) => onProgress?.({ kind: "warning", code, text });
188
273
  onProgress?.({ kind: "parsed" });
189
- // TLC loads the classes of the modules before it computes the constant definitions.
190
274
  specification.javaOverrides.forEach((override) =>
191
275
  onProgress?.({ kind: "java-override", ...override }),
192
276
  );
@@ -202,7 +286,7 @@ const getInvariants = (names: string[], environment: Environment) => {
202
286
  const analyzer = createLevelAnalyzer({
203
287
  constants: new Set(environment.constants.keys()),
204
288
  variables: new Set(environment.variables),
205
- getDefinition: (name) => getDefinition(name, environment),
289
+ getDefinition: (name) => environment.definitions.get(name),
206
290
  });
207
291
  return names.flatMap((name) => {
208
292
  const definition = getConfigPredicate("invariant", name, environment);
@@ -220,7 +304,7 @@ const getInvariants = (names: string[], environment: Environment) => {
220
304
  EXIT_STATUS.safetyEvaluationFailure,
221
305
  );
222
306
  }
223
- return [{ name, expression: createIdentifier(name), scope: undefined }];
307
+ return [createNamedIdentifier(name)];
224
308
  });
225
309
  };
226
310
 
@@ -229,9 +313,11 @@ const getConjuncts = (expression: Expression, environment: Environment): Express
229
313
  return expression.operands.flatMap((operand) => getConjuncts(operand, environment));
230
314
  if (expression.kind === "Identifier" && !environment.constants.has(expression.name)) {
231
315
  const definition = getDefinition(expression.name, environment);
232
- if (definition?.kind === "Operator" && definition.params.length === 0) {
233
- return getConjuncts(definition.body, environment);
234
- }
316
+ const isUnfolded =
317
+ definition?.kind === "Operator" &&
318
+ definition.params.length === 0 &&
319
+ getStartupValue(definition, environment) === undefined;
320
+ if (isUnfolded) return getConjuncts(definition.body, environment);
235
321
  }
236
322
  return [expression];
237
323
  };
@@ -256,7 +342,13 @@ const isConstantTrue = (item: ScopedExpression, environment: Environment, usage:
256
342
  return true;
257
343
  };
258
344
 
259
- const getSpecification = (config: ModelConfig, environment: Environment): Specification => {
345
+ const getSpecification = (
346
+ config: ModelConfig,
347
+ environment: Environment,
348
+ variableLocations: SourceLocation[],
349
+ getVariableOrder: () => string[],
350
+ onProgress: CheckOptions["onProgress"],
351
+ ): Specification => {
260
352
  if (config.specification === undefined) {
261
353
  const getOperator = (name: string | undefined, description: string) => {
262
354
  if (name === undefined) return undefined;
@@ -268,6 +360,7 @@ const getSpecification = (config: ModelConfig, environment: Environment): Specif
268
360
  next: getOperator(config.next, "next state action"),
269
361
  scope: undefined,
270
362
  temporals: [],
363
+ isPropertyFairness: false,
271
364
  };
272
365
  }
273
366
  if (config.init !== undefined || config.next !== undefined) {
@@ -278,16 +371,42 @@ const getSpecification = (config: ModelConfig, environment: Environment): Specif
278
371
  const initConjuncts: ScopedExpression[] = [];
279
372
  const nextActions: ScopedExpression[] = [];
280
373
  const temporals: ScopedExpression[] = [];
281
- const definition = getConfigOperator("name", config.specification, environment);
282
- const value = getConstantValue(config.specification, definition, environment);
374
+ const value = environment.constants.has(config.specification)
375
+ ? environment.constants.get(config.specification)
376
+ : getConstantValue(
377
+ config.specification,
378
+ getConfigOperator("name", config.specification, environment),
379
+ environment,
380
+ );
283
381
  if (value !== undefined) {
284
382
  throw new TlaConfigError(
285
383
  `The value of ${config.specification} is equal to ${formatValue(value)}`,
286
384
  );
287
385
  }
386
+ const definition = getConfigOperator("name", config.specification, environment);
387
+ const property = config.properties.length === 1 ? config.properties[0] : undefined;
388
+ let isUntaggedFound = false;
288
389
  expandTemporal(definition.body, undefined, environment, false).forEach((item) => {
289
390
  const conjunct = item.expression;
290
- if (isConstantTrue(item, environment, "spec")) return;
391
+ // TLC takes a state-level definition of the spec whole as an initial predicate.
392
+ const isInitial = item.path.some((name) => {
393
+ const expanded = getDefinition(name, environment);
394
+ return (
395
+ expanded?.kind === "Operator" &&
396
+ getLevel(expanded.body, undefined, environment) === VARIABLE_LEVEL
397
+ );
398
+ });
399
+ if (!isInitial && isConstantTrue(item, environment, "spec")) return;
400
+ const variableIndex =
401
+ conjunct.kind === "Identifier" && !isLocallyResolved(conjunct)
402
+ ? environment.variableIndex.get(conjunct.name)
403
+ : undefined;
404
+ if (!isInitial && conjunct.kind === "Identifier" && variableIndex !== undefined) {
405
+ const range = variableLocations[variableIndex].range;
406
+ throw new TlaConfigError(
407
+ `The operator ${conjunct.name}, which equals ${range ? formatRange(range) : conjunct.name},\ncannot be used as a spec`,
408
+ );
409
+ }
291
410
  if (conjunct.kind === "UnboundedQuantifier" && conjunct.isTemporal) {
292
411
  throw setExitCode(
293
412
  new TlaConfigError(
@@ -297,14 +416,41 @@ const getSpecification = (config: ModelConfig, environment: Environment): Specif
297
416
  );
298
417
  }
299
418
  if (conjunct.kind === "Always" && conjunct.expression.kind === "BoxAction") {
419
+ const variables = getSubscriptVariables(
420
+ conjunct.expression.subscript,
421
+ item.scope,
422
+ environment,
423
+ );
424
+ if (variables === undefined) {
425
+ onProgress?.({
426
+ kind: "warning",
427
+ code: MESSAGE_CODE.subscriptUndetermined,
428
+ text: "TLC could not determine if the subscript of the next-state relation contains\nall state variables. Proceed with fingers crossed.",
429
+ });
430
+ }
431
+ getVariableOrder()
432
+ .filter((name) => variables !== undefined && !variables.includes(name))
433
+ .forEach((name) =>
434
+ onProgress?.({
435
+ kind: "warning",
436
+ code: MESSAGE_CODE.subscriptMissingVariable,
437
+ text: `The subscript of the next-state relation specified by the specification\ndoes not seem to contain the state variable ${name}`,
438
+ }),
439
+ );
440
+ if (nextActions.length > 0) {
441
+ throw new TlaConfigError(
442
+ "The specification contains more than one conjunct of the form [][Next]_v,\nbut TLC can handle only specifications with one next-state relation.",
443
+ );
444
+ }
300
445
  nextActions.push({ expression: conjunct.expression.action, scope: item.scope });
301
446
  return;
302
447
  }
303
448
  if (
304
449
  conjunct.kind === "Always" &&
450
+ conjunct.expression.kind !== "Let" &&
451
+ conjunct.expression.kind !== "Label" &&
305
452
  getLevel(conjunct.expression, item.scope, environment) < ACTION_LEVEL
306
453
  ) {
307
- // TLC accepts the spec and fails when it builds the tableau of the temporal formulas.
308
454
  throw setExitCode(
309
455
  new TlaEvaluationError(
310
456
  `TLC cannot handle the temporal formula ${describeRange(conjunct.expression)}`,
@@ -314,21 +460,17 @@ const getSpecification = (config: ModelConfig, environment: Environment): Specif
314
460
  }
315
461
  const level = getLevel(conjunct, item.scope, environment);
316
462
  if (level === TEMPORAL_LEVEL) {
463
+ if (property === undefined || !item.path.includes(property)) isUntaggedFound = true;
317
464
  temporals.push(item);
318
465
  return;
319
466
  }
320
467
  if (level === ACTION_LEVEL) {
321
468
  throw new TlaConfigError(
322
- `TLC cannot handle the action-level conjunct of the specification ${config.specification}`,
469
+ `TLC cannot handle this conjunct of the spec:\n${describeRange(conjunct)}`,
323
470
  );
324
471
  }
325
472
  initConjuncts.push(item);
326
473
  });
327
- if (nextActions.length > 1) {
328
- throw new TlaConfigError(
329
- `The specification ${config.specification} must contain at most one [][Next]_vars`,
330
- );
331
- }
332
474
  const items = [...initConjuncts, ...nextActions];
333
475
  const getName = (index: number) => `$specification${index}`;
334
476
  const scope = items.reduce<Scope | undefined>(
@@ -367,6 +509,7 @@ const getSpecification = (config: ModelConfig, environment: Environment): Specif
367
509
  next: nextActions.length === 0 ? undefined : getReference(nextActions[0], initConjuncts.length),
368
510
  scope,
369
511
  temporals,
512
+ isPropertyFairness: temporals.length > 0 && !isUntaggedFound,
370
513
  };
371
514
  };
372
515
 
@@ -384,13 +527,9 @@ const getProperties = (
384
527
  config.properties.forEach((name) => {
385
528
  const definition = getConfigPredicate("property", name, environment);
386
529
  if (!definition) return;
387
- // TLC checks a property that is a state formula only on the initial states, so it warns about
388
- // one as it processes the property, before the constraints.
389
530
  if (getLevel(definition.body, undefined, environment) === VARIABLE_LEVEL) {
390
531
  onProgress?.({ kind: "state-level-property", name });
391
532
  }
392
- // TLC 1.7.4 expands a property as it does a specification, so it doesn't unroll one that
393
- // quantifies over a constant set.
394
533
  const isProperty = environment.runtime.version !== "1.7.4";
395
534
  expandTemporal(definition.body, undefined, environment, isProperty).forEach((item) => {
396
535
  const conjunct = item.expression;
@@ -410,9 +549,6 @@ const getProperties = (
410
549
  conjunct.kind === "Always" &&
411
550
  getLevel(conjunct.expression, item.scope, environment) <= VARIABLE_LEVEL
412
551
  ) {
413
- // TLC names the invariant by the operator the property asserts always holds, when it
414
- // applies the operator to no arguments. The name of an operator another module defines
415
- // resolves to its key, so the name comes from its definition.
416
552
  const body = conjunct.expression;
417
553
  const operator =
418
554
  body.kind === "Identifier" && !isLocallyResolved(body)
@@ -435,7 +571,17 @@ const getProperties = (
435
571
  return;
436
572
  }
437
573
  if (level === ACTION_LEVEL) {
438
- throw new TlaConfigError(`The property ${name} is an action-level formula`);
574
+ const location = describeRange(conjunct);
575
+ const book = "Specifying Systems at https://lamport.azurewebsites.net/tla/book.html";
576
+ const advice =
577
+ conjunct.kind === "BoxAction"
578
+ ? `To check that action ${partName} holds in *every* step of the behavior, define a temporal property by applying the "always" temporal operator ([]) to the formula at ${location} (compare page 90 of ${book}).`
579
+ : conjunct.kind === "AngleAction"
580
+ ? `To check that infinitely many ${partName} steps occur, define a temporal property by applying the "always eventually" temporal operator combination ([]<>) to the formula at ${location} (compare page 91 of ${book}).`
581
+ : `To check that action ${partName} holds in *every* step of the behavior, define a temporal property: Let A be the formula at ${location}; rewrite A as [][A]_v, where v is a state function (typically the tuple of variables) (compare page 90 of ${book}).`;
582
+ throw new TlaConfigError(
583
+ `The formula ${partName} at ${location} is an action-level formula (i.e., it contains no temporal operators). Only temporal-level (or state-level) formulas are allowed under PROPERTY or PROPERTIES. ${advice}`,
584
+ );
439
585
  }
440
586
  properties.liveness.push({ name, expression: conjunct, scope: item.scope });
441
587
  });
@@ -443,15 +589,36 @@ const getProperties = (
443
589
  return properties;
444
590
  };
445
591
 
592
+ // The expressions the LET definitions and arguments of a scope stand for, or undefined if it binds
593
+ // an operator only as a function.
594
+ const getScopeExpressions = (scope: Scope | undefined): Expression[] | undefined => {
595
+ const expressions: Expression[] = [];
596
+ const visited = new Set<Scope>();
597
+ const visit = (current: Scope | undefined): boolean => {
598
+ if (current === undefined || visited.has(current)) return true;
599
+ visited.add(current);
600
+ const binding = current.binding;
601
+ if (binding.kind === "Thunk") {
602
+ expressions.push(binding.expression);
603
+ return visit(binding.scope) && visit(current.parent);
604
+ }
605
+ if (binding.kind === "Operator") {
606
+ if (binding.operator.kind !== "Closure") return false;
607
+ expressions.push(binding.operator.body);
608
+ return visit(binding.operator.scope) && visit(current.parent);
609
+ }
610
+ return visit(current.parent);
611
+ };
612
+ return visit(scope) ? expressions : undefined;
613
+ };
614
+
446
615
  const getNamedExpressions = (
447
616
  kind: string,
448
617
  names: string[],
449
618
  environment: Environment,
450
619
  ): NamedExpression[] =>
451
620
  names.flatMap((name) =>
452
- getConfigPredicate(kind, name, environment)
453
- ? [{ name, expression: createIdentifier(name), scope: undefined }]
454
- : [],
621
+ getConfigPredicate(kind, name, environment) ? [createNamedIdentifier(name)] : [],
455
622
  );
456
623
 
457
624
  const getBodyRange = (name: string, environment: Environment) => {
@@ -465,13 +632,13 @@ const getPossiblePredicates = (names: string[], environment: Environment) =>
465
632
  throw new TlaConfigError(`_POSSIBLE lists ${name} more than once`);
466
633
  }
467
634
  getConfigDefinition("possible", name, environment);
468
- const expression = createIdentifier(name);
469
- if (getLevel(expression, undefined, environment) === TEMPORAL_LEVEL) {
635
+ const possible = createNamedIdentifier(name);
636
+ if (getLevel(possible.expression, undefined, environment) === TEMPORAL_LEVEL) {
470
637
  throw new TlaConfigError(
471
638
  `The possible of ${name} is equal to a temporal formula; only state- and action-level predicates are supported`,
472
639
  );
473
640
  }
474
- return { name, expression, scope: undefined };
641
+ return possible;
475
642
  });
476
643
 
477
644
  const getMembership = (
@@ -488,7 +655,6 @@ const getMembership = (
488
655
  : undefined;
489
656
  };
490
657
 
491
- // TLC evaluates the body of an invariant that the configuration names.
492
658
  const getPredicate = (expression: Expression, environment: Environment) => {
493
659
  if (expression.kind !== "Identifier" || environment.constants.has(expression.name)) {
494
660
  return expression;
@@ -500,23 +666,28 @@ const getPredicate = (expression: Expression, environment: Environment) => {
500
666
  };
501
667
 
502
668
  const getStateChecks = (named: NamedExpression[], environment: Environment): StateCheck[] =>
503
- named.flatMap((item) =>
504
- getConjuncts(item.expression, environment).map((expression) => {
505
- // A LET or an argument in the scope can read variables the expression doesn't name.
506
- const variables =
507
- item.scope === undefined ? getReadVariables(expression, environment) : undefined;
508
- return {
509
- name: item.name,
510
- expression,
511
- scope: item.scope,
512
- variables,
513
- membership: getMembership(expression, variables, environment),
514
- predicate: getPredicate(item.expression, environment),
515
- };
516
- }),
517
- );
669
+ named.flatMap((item) => {
670
+ const predicate = getPredicate(item.expression, environment);
671
+ const isImpure =
672
+ item.scope === undefined && getReadVariables(predicate, environment) === undefined;
673
+ // TLC evaluates an invariant whole, so one that prints isn't split into conjuncts.
674
+ return (isImpure ? [predicate] : getConjuncts(item.expression, environment)).map(
675
+ (expression) => {
676
+ const variables =
677
+ item.scope === undefined ? getReadVariables(expression, environment) : undefined;
678
+ return {
679
+ name: item.name,
680
+ expression,
681
+ scope: item.scope,
682
+ variables,
683
+ membership: getMembership(expression, variables, environment),
684
+ predicate,
685
+ };
686
+ },
687
+ );
688
+ });
518
689
 
519
- const isUnchangedFor = (stateCheck: StateCheck, state: Value[], parent: Value[] | undefined) => {
690
+ const isUnchangedFor = (stateCheck: StateCheck, state: State, parent: Value[] | undefined) => {
520
691
  const variables = stateCheck.variables;
521
692
  if (!parent || !variables) return false;
522
693
  for (let index = 0; index < variables.length; index++) {
@@ -534,75 +705,120 @@ const isWideConfigValue = (value: ConfigValue): boolean =>
534
705
  ? WIDE_CHARACTER.test(value.value)
535
706
  : value.kind === "Set" && value.elements.some(isWideConfigValue);
536
707
 
537
- const isWideExpression = (expression: Expression): boolean =>
538
- (expression.kind === "String" && WIDE_CHARACTER.test(expression.value)) ||
539
- (expression.kind === "Apply" && DESERIALIZERS.has(expression.operator)) ||
540
- getChildren(expression).some(isWideExpression);
541
-
542
- // TLC fingerprints a string by the low byte of each character, so it merges states whose
543
- // strings differ only above U+00FF. Strings reach a state from literals, the config, or files.
544
- const hasWideString = (config: ModelConfig, environment: Environment) =>
545
- config.constants.some(
546
- (constant) =>
547
- isWideConfigValue(constant.value) || (constant.args ?? []).some(isWideConfigValue),
548
- ) ||
549
- [...environment.definitions.values()].some(
550
- (definition) =>
551
- isWideExpression(definition.body) ||
552
- (definition.kind === "Function" &&
553
- definition.bounds.some((bound) => isWideExpression(bound.set))),
708
+ const isWideExpression = (expression: Expression, checked: Set<Expression>): boolean => {
709
+ if (expression.kind === "Selection") {
710
+ if (checked.has(expression.expression)) return false;
711
+ checked.add(expression.expression);
712
+ }
713
+ return (
714
+ (expression.kind === "String" && WIDE_CHARACTER.test(expression.value)) ||
715
+ (expression.kind === "Apply" && DESERIALIZERS.has(expression.operator)) ||
716
+ getChildren(expression).some((child) => isWideExpression(child, checked))
717
+ );
718
+ };
719
+
720
+ // TLC fingerprints a string by the low byte of each character, so it merges states whose strings differ only above U+00FF.
721
+ const hasWideString = (config: ModelConfig, environment: Environment) => {
722
+ const checked = new Set<Expression>();
723
+ return (
724
+ config.constants.some(
725
+ (constant) =>
726
+ isWideConfigValue(constant.value) || (constant.args ?? []).some(isWideConfigValue),
727
+ ) ||
728
+ [...environment.definitions.values()].some(
729
+ (definition) =>
730
+ isWideExpression(definition.body, checked) ||
731
+ (definition.kind === "Function" &&
732
+ definition.bounds.some((bound) => isWideExpression(bound.set, checked))),
733
+ )
554
734
  );
735
+ };
555
736
 
556
- interface Search {
737
+ export interface Search {
557
738
  properties: Properties;
739
+ toRecord: (state: Value[]) => Record<string, Value>;
740
+ evaluateAlias: (
741
+ alias: string,
742
+ state: State,
743
+ next: State | undefined,
744
+ isTool: boolean,
745
+ ) => Record<string, Value>;
558
746
  spec: Specification;
559
747
  getFingerprintState: (state: Value[]) => Value[];
560
748
  getStoredFingerprints: (states: Value[][], fingerprintStates: Value[][]) => BigInt64Array;
561
749
  getTlcOrder: () => number[];
562
750
  isSymmetric: boolean;
563
- // TLC drops a constraint that is a true constant formula.
564
751
  isConstrained: boolean;
752
+ getTypedChecks: (liveness: Solution[] | undefined) =>
753
+ | {
754
+ init: Expression;
755
+ next: Expression;
756
+ scope: Scope | undefined;
757
+ invariants: Expression[];
758
+ constraints: Expression[];
759
+ holdsInitialPredicates: (state: Value[]) => boolean;
760
+ actionProperties: ActionProperty[];
761
+ symmetry: Images[] | undefined;
762
+ view: Expression | undefined;
763
+ variableOrder: number[];
764
+ liveness: Solution[] | undefined;
765
+ }
766
+ | undefined;
565
767
  findViolatedInvariant: (state: Value[], parent?: Value[]) => StateCheck | undefined;
566
- // Every invariant an initial state violates, which TLC reports with -continue.
567
- getViolatedInvariants: (state: Value[]) => StateCheck[];
568
- // The checks of a state that TLC evaluates when it replays the computation of the initial states
569
- // or of the successors of a state, with an environment that records the call stack. The first
570
- // returns the check that stops the replay, and the second false where TLC stops it.
571
- // TLC fingerprints a replayed state that satisfies the constraints before it checks the rest.
768
+ forEachViolatedInvariant: (state: Value[], onViolated: (invariant: StateCheck) => void) => void;
572
769
  checkReplayedInitialState: (
573
770
  state: Value[],
574
771
  tracing: Environment,
575
772
  addFingerprint: () => void,
576
- ) => Pick<InitialStateViolation, "status" | "name"> | undefined;
577
- // Adding the fingerprint of a successor tells whether TLC had not seen it yet.
773
+ onViolated: (violation: Pick<InitialStateViolation, "status" | "name">) => void,
774
+ ) => void;
578
775
  checkReplayedSuccessor: (
579
776
  state: Value[],
580
777
  next: Value[],
581
778
  tracing: Environment,
582
779
  addFingerprint: () => boolean,
583
780
  ) => boolean;
584
- satisfiesConstraints: (state: Value[], parent?: Value[]) => boolean;
781
+ satisfiesConstraints: (state: State, parent?: Value[]) => boolean;
585
782
  findFailedInitialPredicate: (state: Value[]) => NamedExpression | undefined;
586
783
  findViolatedActionProperty: (state: Value[], next: Value[]) => ActionProperty | undefined;
587
- satisfiesActionConstraints: (state: Value[], next: Value[]) => boolean;
784
+ satisfiesActionConstraints: (state: Value[], next: State) => boolean;
785
+ getExcludingConstraints: (state: Value[], next: Value[]) => string[];
588
786
  trackStatePossible: (state: Value[]) => void;
589
787
  trackActionPossible: (state: Value[], next: Value[]) => void;
590
788
  findUnwitnessedPossible: () => Postcondition | undefined;
591
- // After a counterexample, TLC skips the postconditions when one of them is constant.
789
+ getReward: (state: Value[] | undefined, next: Value[], fallback: number) => number;
592
790
  findPostconditionViolation: (isAfterViolation?: boolean) => Postcondition | undefined;
593
791
  }
594
792
 
793
+ const toAliasRecord = (value: Value) => {
794
+ if (!isFunctionValue(value)) return undefined;
795
+ const pairs = getWrittenPairs(toFiniteFunction(value));
796
+ if (!pairs.every((pair) => typeof pair[0] === "string")) return undefined;
797
+ return Object.fromEntries(pairs.map((pair) => [String(pair[0]), pair[1]]));
798
+ };
799
+
800
+ export const getIncompleteSuccessorMessage = (
801
+ missing: string[],
802
+ action: string | undefined,
803
+ actionCount: number,
804
+ version: TlcVersion | undefined,
805
+ ) => {
806
+ const subject =
807
+ actionCount === 1 ? "the next-state action" : `action ${action} of the next-state relation`;
808
+ const verb = version === "1.7.4" ? "assigned" : "defined";
809
+ return `Successor state is not completely specified by ${subject}. The following variable${missing.length > 1 ? "s are" : " is"} not ${verb}: ${missing.join(", ")}.\n`;
810
+ };
811
+
595
812
  export const getContext = (
596
813
  environment: Environment,
597
- state: Value[] | undefined,
598
- next: Value[] | undefined,
814
+ state: State | undefined,
815
+ next: State | undefined,
599
816
  scope?: Scope,
600
817
  ) => ({ environment, scope, state, next });
601
818
 
602
819
  const holds = (expression: Expression, context: Context, description: string) =>
603
820
  expectBoolean(evaluate(expression, context), description);
604
821
 
605
- // TLC names a check that is not a boolean by the location of the predicate it evaluates.
606
822
  const holdsLikeTlc = (
607
823
  expression: Expression,
608
824
  context: Context,
@@ -615,20 +831,21 @@ const holdsLikeTlc = (
615
831
  return value;
616
832
  };
617
833
 
618
- const getExpectedBoolean = (expression: Expression, environment: Environment) => {
834
+ const getExpectedValue = (kind: string, expression: Expression, environment: Environment) => {
619
835
  const definition =
620
836
  expression.kind === "Identifier" ? getDefinition(expression.name, environment) : undefined;
621
837
  const body = definition?.kind === "Operator" ? definition.body : expression;
622
838
  const range = definition?.kind === "Operator" ? definition.bodyRange : undefined;
623
839
  const location = range && body.kind !== "Number" ? formatRange(range) : describeNode(body);
624
- return `TLC expected a boolean value, but did not find one. ${location}`;
840
+ return `TLC expected a ${kind} value, but did not find one. ${location}`;
625
841
  };
626
842
 
627
- // TLC evaluates the whole predicate of a check, which fails at a conjunct that isn't a boolean as
628
- // the conjunction does.
843
+ const getExpectedBoolean = (expression: Expression, environment: Environment) =>
844
+ getExpectedValue("boolean", expression, environment);
845
+
629
846
  const holdsAsConjunct = (check: StateCheck, context: Context) =>
630
847
  holdsLikeTlc(check.expression, context, (expression, environment) => {
631
- holdsLikeTlc(check.predicate, context);
848
+ if (check.predicate !== check.expression) holdsLikeTlc(check.predicate, context);
632
849
  return getExpectedBoolean(expression, environment);
633
850
  });
634
851
 
@@ -641,13 +858,9 @@ const trackPossible = (items: NamedExpression[], runtime: CheckerRuntime, contex
641
858
  runtime.possibleCounts.set(item.name, isWitnessed ? count + 1 : count);
642
859
  });
643
860
 
644
- const getConstantFailure = (
645
- expression: Expression,
646
- environment: Environment,
647
- description: string,
648
- ) => {
861
+ const getConstantFailure = (check: (context: Context) => boolean, environment: Environment) => {
649
862
  try {
650
- return holds(expression, getContext(environment, undefined, undefined), description)
863
+ return check(getContext(environment, undefined, undefined))
651
864
  ? undefined
652
865
  : { message: undefined };
653
866
  } catch (error) {
@@ -661,30 +874,223 @@ export const findAssumptionViolation = (
661
874
  environment: Environment,
662
875
  ): Omit<Violation, "loopStart"> | undefined => {
663
876
  for (const assumption of assumptions.filter((candidate) => !candidate.isAxiom)) {
664
- const failure = getConstantFailure(assumption.expression, environment, "an assumption");
877
+ const failure = getConstantFailure(
878
+ (context) =>
879
+ expectBooleanBody(evaluate(assumption.expression, context), assumption.expression),
880
+ environment,
881
+ );
665
882
  if (failure) {
666
- return { name: describeRange(assumption.expression), trace: [], message: failure.message };
883
+ return { name: describeNode(assumption.expression), trace: [], message: failure.message };
667
884
  }
668
885
  }
669
886
  return undefined;
670
887
  };
671
888
 
889
+ export const createCheckEnvironment = (
890
+ config: ModelConfig,
891
+ options: EnvironmentSettings,
892
+ print: (text: string) => void,
893
+ isStringOrderFrozen = false,
894
+ ) => {
895
+ const order = createTlcOrder(options.source, options.loadModule);
896
+ setStringOrder(
897
+ order.getStringOrder(
898
+ config,
899
+ (options.runtimeInvariants ?? []).flatMap((invariant) => invariant.module ?? []),
900
+ ),
901
+ );
902
+ setValueOptions(options);
903
+ setFingerprintPolynomial(options.fingerprintPolynomial ?? 0);
904
+ if (isStringOrderFrozen) freezeStringOrder();
905
+ const specification = createEnvironment(config, {
906
+ source: options.source,
907
+ loadModule: options.loadModule,
908
+ order,
909
+ loadClass: options.loadClass,
910
+ print,
911
+ files: {
912
+ readFile: options.readFile,
913
+ writeFile: options.writeFile,
914
+ makeDirectory: options.makeDirectory,
915
+ },
916
+ seed: options.seed,
917
+ isTool: options.isTool,
918
+ traceFile: options.traceSpec?.traceFile,
919
+ isSanyReported: options.isSanyReported,
920
+ isWarningEnabled: options.isWarningEnabled,
921
+ version: options.version,
922
+ moduleOperators: options.moduleOperators,
923
+ readLine: options.readLine,
924
+ runtimeInvariants: options.runtimeInvariants,
925
+ });
926
+ return { order, specification };
927
+ };
928
+
929
+ export const prepareSearch = (options: CheckOptions) => {
930
+ const config =
931
+ typeof options.config === "string"
932
+ ? parseConfig(options.config, options.version)
933
+ : options.config;
934
+ const created = createCheckEnvironment(config, options, options.onPrint ?? console.log);
935
+ const specification = created.specification;
936
+ reportStartup(specification, config, options.onProgress);
937
+ const coverage =
938
+ options.coverage === undefined
939
+ ? undefined
940
+ : createCoverage(specification.environment.variables.length);
941
+ const environment = coverage
942
+ ? createCoverageEnvironment(specification.environment, coverage)
943
+ : specification.environment;
944
+ let description: SpecDescription | undefined;
945
+ const getDescription = () =>
946
+ (description ??= getSpecDescription(config, environment, specification.instanceActions));
947
+ environment.runtime.getSpecification = () =>
948
+ getSpecificationValue(getDescription(), config, environment, specification.variableLocations);
949
+ const search = createSearch(
950
+ config,
951
+ environment,
952
+ specification.variableLocations,
953
+ () => created.order.getDeclarationOrder("variable"),
954
+ options.onProgress,
955
+ specification.moduleOperators,
956
+ specification.runtimeInvariants,
957
+ );
958
+ const getCoverage = () =>
959
+ coverage &&
960
+ getCoverageReport(
961
+ coverage,
962
+ environment,
963
+ specification.variableLocations,
964
+ search?.getTlcOrder() ?? [],
965
+ );
966
+ return { config, specification, environment, search, getDescription, coverage, getCoverage };
967
+ };
968
+
969
+ export interface CoveredAction extends SpecAction {
970
+ node: number;
971
+ }
972
+
973
+ export const STOP_WALK = new Error("The walk stopped");
974
+
975
+ export const addActionCoverage = (
976
+ coverage: Coverage,
977
+ environment: Environment,
978
+ description: SpecDescription,
979
+ ) => {
980
+ const addRelations = (kind: "init" | "next", actions: SpecAction[]) =>
981
+ actions.map((action): CoveredAction => ({
982
+ ...action,
983
+ node: addCoverageRelation(
984
+ coverage,
985
+ kind,
986
+ getCoverageLabel(action.name, action.expression, environment),
987
+ action.expression,
988
+ action.scope,
989
+ ),
990
+ }));
991
+ const inits = addRelations("init", description.inits);
992
+ const actions = addRelations("next", description.actions);
993
+ buildCoverage(coverage, environment, getPrimedRanges(actions, environment));
994
+ return { inits, actions };
995
+ };
996
+
997
+ export const walkCoveredSuccessors = (
998
+ coverage: Coverage,
999
+ action: CoveredAction,
1000
+ state: Value[],
1001
+ environment: Environment,
1002
+ onState: (successor: Value[]) => void,
1003
+ onIncomplete = (partial: State, name: string | undefined): void => {
1004
+ throw createIncompleteSuccessorError(partial, name, environment);
1005
+ },
1006
+ ) =>
1007
+ walkSuccessors(
1008
+ action,
1009
+ action.node,
1010
+ state,
1011
+ environment,
1012
+ (successor) => {
1013
+ coverage.primary[action.node]++;
1014
+ onState(successor);
1015
+ },
1016
+ (partial) => {
1017
+ coverage.primary[action.node]++;
1018
+ onIncomplete(partial, action.name);
1019
+ return true;
1020
+ },
1021
+ );
1022
+
1023
+ export const reportAssumptionViolation = (
1024
+ assumptions: Assumption[],
1025
+ environment: Environment,
1026
+ message: (code: number, text: string, toolText: string) => void,
1027
+ ) => {
1028
+ const assumption = findAssumptionViolation(assumptions, environment);
1029
+ if (!assumption) return undefined;
1030
+ if (assumption.message === undefined) {
1031
+ const text = `Assumption ${assumption.name} is false.`;
1032
+ message(MESSAGE_CODE.assumptionFalse, text, text);
1033
+ return EXIT_STATUS.assumptionViolation;
1034
+ }
1035
+ const text = `Evaluating assumption ${assumption.name} failed.\n${assumption.message}`;
1036
+ message(
1037
+ MESSAGE_CODE.assumptionEvaluationError,
1038
+ text,
1039
+ formatInnerMessage(MESSAGE_CODE.assumptionEvaluationError, text, true),
1040
+ );
1041
+ return EXIT_STATUS.assumptionViolation;
1042
+ };
1043
+
1044
+ export const createMissingOperatorError = (operator: ModuleOperator) =>
1045
+ setExitCode(
1046
+ new TlaEvaluationError(
1047
+ `${UNEXPECTED_EXCEPTION}Could not find operator: ${operator.operator} in module: ${operator.module}`,
1048
+ ),
1049
+ EXIT_STATUS.error,
1050
+ );
1051
+
672
1052
  export const createSearch = (
673
1053
  config: ModelConfig,
674
1054
  environment: Environment,
1055
+ variableLocations: SourceLocation[],
675
1056
  getVariableOrder: () => string[],
676
1057
  onProgress?: CheckOptions["onProgress"],
1058
+ moduleOperators: ResolvedModuleOperator[] = [],
1059
+ runtimeInvariants: RuntimeInvariant[] = [],
677
1060
  ): Search | undefined => {
1061
+ const getModuleOperators = (kind: ResolvedModuleOperator["kind"]) =>
1062
+ moduleOperators
1063
+ .filter((operator) => operator.kind === kind)
1064
+ .map((operator) => {
1065
+ if (operator.key === undefined) throw createMissingOperatorError(operator);
1066
+ return { name: operator.operator, key: operator.key };
1067
+ });
678
1068
  const configInvariants = getInvariants(config.invariants, environment);
679
- const spec = getSpecification(config, environment);
1069
+ const spec = getSpecification(
1070
+ config,
1071
+ environment,
1072
+ variableLocations,
1073
+ getVariableOrder,
1074
+ onProgress,
1075
+ );
680
1076
  const properties = getProperties(config, environment, onProgress);
681
- const invariants = getStateChecks([...configInvariants, ...properties.invariants], environment);
682
- // The invariants TLC evaluates, each of which may have several conjuncts among the checks.
683
- const invariantPredicates = [
684
- ...new Map(invariants.map((invariant) => [invariant.predicate, invariant])).values(),
685
- ];
1077
+ const live = config.properties[0];
1078
+ const liveRange = live && getDefinition(live, environment)?.location.range;
1079
+ const specName = config.specification;
1080
+ const specRange = specName && getDefinition(specName, environment)?.location.range;
1081
+ if (spec.isPropertyFairness && liveRange && specRange) {
1082
+ onProgress?.({
1083
+ kind: "warning",
1084
+ code: MESSAGE_CODE.fairnessTautology,
1085
+ text: `Implied-temporal checking is a tautology.\nThe temporal formula ${live} at ${formatRange(liveRange)} equals\nthe fairness constraints of the behavior specification ${specName} at ${formatRange(specRange)}.\nTherefore, checking whether ${specName} => ${live} using TLC will never result in a violation of ${live}.`,
1086
+ });
1087
+ }
1088
+ const checkedInvariants = getStateChecks(
1089
+ [...configInvariants, ...properties.invariants],
1090
+ environment,
1091
+ );
686
1092
  const isCheckingBehaviors =
687
- invariants.length > 0 ||
1093
+ checkedInvariants.length > 0 ||
688
1094
  properties.actionProperties.length > 0 ||
689
1095
  properties.liveness.length > 0;
690
1096
  if (
@@ -702,15 +1108,101 @@ export const createSearch = (
702
1108
  if (spec.next === undefined && isCheckingBehaviors) {
703
1109
  throw new TlaConfigError("The configuration file did not specify the next state predicate.");
704
1110
  }
705
- const constraints = getStateChecks(
706
- getNamedExpressions("constraint", config.constraints, environment),
1111
+ const runtimeChecks = getStateChecks(
1112
+ runtimeInvariants.map((invariant) => {
1113
+ const definition = getDefinition(invariant.name, environment);
1114
+ return {
1115
+ name: invariant.name,
1116
+ expression:
1117
+ definition?.kind === "Operator" ? definition.body : createIdentifier(invariant.name),
1118
+ scope: undefined,
1119
+ };
1120
+ }),
707
1121
  environment,
708
1122
  );
1123
+ const invariants = [...checkedInvariants, ...runtimeChecks];
1124
+ const invariantPredicates = [
1125
+ ...new Map(invariants.map((invariant) => [invariant.predicate, invariant])).values(),
1126
+ ];
1127
+ const namedConstraints = getNamedExpressions(
1128
+ "constraint",
1129
+ [...config.constraints, ...getModuleOperators("constraint").map((operator) => operator.name)],
1130
+ environment,
1131
+ );
1132
+ const constraints = getStateChecks(namedConstraints, environment);
709
1133
  const actionConstraints = getNamedExpressions(
710
1134
  "action constraint",
711
1135
  config.actionConstraints,
712
1136
  environment,
713
1137
  );
1138
+ const coverage = environment.coverage;
1139
+ const getCoveredChecks = (kind: CoverageKind, items: NamedExpression[], isDefined = true) =>
1140
+ items.flatMap((item): CoveredCheck[] => {
1141
+ if (!coverage) return [];
1142
+ const expression = isDefined ? getPredicate(item.expression, environment) : item.expression;
1143
+ const label = getCoverageLabel(isDefined ? item.name : undefined, expression, environment);
1144
+ const node = addCoverageRelation(coverage, kind, label, expression, item.scope);
1145
+ return [{ expression, scope: item.scope, node }];
1146
+ });
1147
+ const coveredInvariants = [
1148
+ ...getCoveredChecks("invariant", configInvariants),
1149
+ ...getCoveredChecks("invariant", properties.invariants, false),
1150
+ ];
1151
+ const coveredInvariantChecks = new Map(
1152
+ [...configInvariants, ...properties.invariants].map((item, index) => [
1153
+ getPredicate(item.expression, environment),
1154
+ coveredInvariants[index],
1155
+ ]),
1156
+ );
1157
+ const coveredActionConstraints = getCoveredChecks("constraint", actionConstraints);
1158
+ const coveredConstraints = getCoveredChecks("constraint", namedConstraints);
1159
+ const coveredConstraintChecks = new Map(
1160
+ coveredConstraints.map((check) => [check.expression, check]),
1161
+ );
1162
+ const constraintPredicates = [
1163
+ ...new Map(constraints.map((constraint) => [constraint.predicate, constraint])).values(),
1164
+ ];
1165
+ const coveredInitialPredicates = getCoveredChecks("implied", properties.initialPredicates, false);
1166
+ const coveredActionProperties = getCoveredChecks(
1167
+ "implied",
1168
+ properties.actionProperties.map((property) => ({ ...property, expression: property.box })),
1169
+ false,
1170
+ );
1171
+ const evaluateCovered = (
1172
+ covered: Coverage,
1173
+ check: CoveredCheck,
1174
+ state: State,
1175
+ next: State | undefined,
1176
+ ) => {
1177
+ try {
1178
+ return runAtCoverageNode(covered, check.node, () =>
1179
+ evaluate(check.expression, getContext(environment, state, next, check.scope)),
1180
+ );
1181
+ } catch {
1182
+ return undefined;
1183
+ }
1184
+ };
1185
+ const holdsReplayed = (
1186
+ covered: CoveredCheck | undefined,
1187
+ expression: Expression,
1188
+ context: Context,
1189
+ ) =>
1190
+ coverage && covered
1191
+ ? runAtCoverageNode(coverage, covered.node, () => holdsLikeTlc(covered.expression, context))
1192
+ : holdsLikeTlc(expression, context);
1193
+ const satisfiesCovered = (checks: CoveredCheck[], state: State, next?: State) => {
1194
+ if (!coverage) return undefined;
1195
+ for (const check of checks) {
1196
+ const value = evaluateCovered(coverage, check, state, next);
1197
+ if (typeof value !== "boolean") return undefined;
1198
+ if (!value) {
1199
+ coverage.primary[check.node]++;
1200
+ return false;
1201
+ }
1202
+ coverage.secondary[check.node]++;
1203
+ }
1204
+ return true;
1205
+ };
714
1206
  if (config.rlReward !== undefined) getConfigOperator("rlreward", config.rlReward, environment);
715
1207
  if (config.periodic !== undefined) getConfigOperator("periodic", config.periodic, environment);
716
1208
  const possible = getPossiblePredicates(config.possible, environment);
@@ -719,11 +1211,12 @@ export const createSearch = (
719
1211
  config.symmetry === undefined
720
1212
  ? undefined
721
1213
  : getSymmetryGroup(config.symmetry, environment, config.substitutions);
722
- if (config.view !== undefined) getConfigOperator("view function", config.view, environment);
723
- const view =
1214
+ const viewDefinition =
724
1215
  config.view === undefined
725
1216
  ? undefined
726
- : { name: config.view, expression: createIdentifier(config.view), scope: undefined };
1217
+ : getConfigDefinition("view function", config.view, environment);
1218
+ const viewName = config.view ?? getModuleOperators("view")[0]?.name;
1219
+ const view = viewName === undefined ? undefined : createNamedIdentifier(viewName);
727
1220
  const actionProperties = properties.actionProperties.map((property) => {
728
1221
  const unchanged: Expression = {
729
1222
  kind: "Unchanged",
@@ -737,35 +1230,49 @@ export const createSearch = (
737
1230
  const statePossible = possible.filter((item) => !isActionPossible(item));
738
1231
  const actionPossible = possible.filter(isActionPossible);
739
1232
  const runtime = environment.runtime;
740
- const tlcOrder = { indices: undefined as number[] | undefined };
1233
+ let tlcOrder: number[] | undefined;
741
1234
  const getTlcOrder = () => {
742
- if (tlcOrder.indices) return tlcOrder.indices;
1235
+ if (tlcOrder) return tlcOrder;
743
1236
  const variableOrder = getVariableOrder();
744
1237
  const getTlcPosition = (index: number) => {
745
1238
  const position = variableOrder.indexOf(environment.variables[index]);
746
1239
  return position === -1 ? environment.variables.length : position;
747
1240
  };
748
- tlcOrder.indices = environment.variables
749
- .map((_, index) => index)
1241
+ tlcOrder = environment.variables
1242
+ .map((_variable, index) => index)
750
1243
  .sort((left, right) => getTlcPosition(left) - getTlcPosition(right));
751
- return tlcOrder.indices;
1244
+ return tlcOrder;
752
1245
  };
753
1246
  const getViewValue = (expression: Expression, state: Value[]) =>
754
1247
  evaluate(expression, getContext(environment, state, undefined));
1248
+ const getRepresentativeState = (state: Value[]) => {
1249
+ // TLC's TLCStateMut#fingerPrint deep-normalizes a state before it evaluates the view.
1250
+ if (view !== undefined) state.forEach(markNormalized);
1251
+ return symmetryGroup === undefined
1252
+ ? state
1253
+ : getRepresentative(state, symmetryGroup, getTlcOrder());
1254
+ };
755
1255
  const getTlcStateFingerprint = (state: Value[]) => {
756
- const indices = getTlcOrder();
757
- const representative =
758
- symmetryGroup === undefined ? state : getRepresentative(state, symmetryGroup, indices);
1256
+ const representative = getRepresentativeState(state);
759
1257
  return getTlcFingerprint(
760
1258
  view === undefined
761
- ? indices.map((index) => representative[index])
1259
+ ? getTlcOrder().map((index) => representative[index])
762
1260
  : [getViewValue(view.expression, representative)],
763
1261
  );
764
1262
  };
765
- // With -continue, TLC goes on to the successors of a state that violates an invariant.
1263
+ const findFailedInitialPredicate = (state: Value[]) =>
1264
+ properties.initialPredicates.find((predicate, index) => {
1265
+ const value =
1266
+ coverage && evaluateCovered(coverage, coveredInitialPredicates[index], state, undefined);
1267
+ return typeof value === "boolean"
1268
+ ? !value
1269
+ : !holdsLikeTlc(
1270
+ predicate.expression,
1271
+ getContext(environment, state, undefined, predicate.scope),
1272
+ );
1273
+ });
766
1274
  const violatingStates = new WeakSet<Value[]>();
767
1275
  const isViolated = (invariant: StateCheck, state: Value[], parent: Value[] | undefined) => {
768
- // A parent that satisfies every invariant leaves only what the step changed to fail.
769
1276
  const checkedParent = parent && !violatingStates.has(parent) ? parent : undefined;
770
1277
  if (isUnchangedFor(invariant, state, checkedParent)) return false;
771
1278
  try {
@@ -779,7 +1286,6 @@ export const createSearch = (
779
1286
  )
780
1287
  : !holdsAsConjunct(invariant, context);
781
1288
  } catch (error) {
782
- // TLC reports a failure only on a state after the initial states as an invariant failure.
783
1289
  if (!parent) throw error;
784
1290
  throw withHeadline(
785
1291
  setExitCode(error, EXIT_STATUS.safetyEvaluationFailure),
@@ -788,6 +1294,21 @@ export const createSearch = (
788
1294
  );
789
1295
  }
790
1296
  };
1297
+ const isPredicateViolated = (
1298
+ predicate: StateCheck,
1299
+ state: Value[],
1300
+ parent: Value[] | undefined,
1301
+ ) => {
1302
+ const covered = coveredInvariantChecks.get(predicate.predicate);
1303
+ const value =
1304
+ coverage && covered ? evaluateCovered(coverage, covered, state, undefined) : undefined;
1305
+ return typeof value === "boolean"
1306
+ ? !value
1307
+ : invariants.some(
1308
+ (invariant) =>
1309
+ invariant.predicate === predicate.predicate && isViolated(invariant, state, parent),
1310
+ );
1311
+ };
791
1312
  const isFingerprintedLikeTlc = hasWideString(config, environment);
792
1313
  runtime.getFingerprint = getTlcStateFingerprint;
793
1314
  const findUnwitnessedPossible = () => {
@@ -802,11 +1323,131 @@ export const createSearch = (
802
1323
  counts: prettyPrint(formatValue(getPossibleCounts(runtime), true)),
803
1324
  };
804
1325
  };
1326
+ // Deviation from TLC: a tuple VIEW prints as a state only when its elements are distinct variables, since TLC mislabels <<y, x>> and <<x + 1>>.
1327
+ const viewElements = viewDefinition?.body.kind === "Tuple" ? viewDefinition.body.elements : [];
1328
+ const viewNames = viewElements.flatMap((element) =>
1329
+ element.kind === "Identifier" && environment.variables.includes(element.name)
1330
+ ? [element.name]
1331
+ : [],
1332
+ );
1333
+ const isStateView =
1334
+ viewDefinition?.body.kind === "Tuple" &&
1335
+ viewNames.length === viewElements.length &&
1336
+ new Set(viewNames).size === viewNames.length;
1337
+ const getViewText = (expression: Expression, state: Value[]) =>
1338
+ isStateView
1339
+ ? getTlcOrder()
1340
+ .filter((index) => viewNames.includes(environment.variables[index]))
1341
+ .map(
1342
+ (index) =>
1343
+ `/\\ ${environment.variables[index]} = ${prettyPrint(formatValue(state[index]))}\n`,
1344
+ )
1345
+ .join("")
1346
+ : prettyPrint(formatValue(getViewValue(expression, state)));
1347
+ const holdsActionConstraint = (constraint: NamedExpression, state: Value[], next: State) =>
1348
+ holdsLikeTlc(
1349
+ constraint.expression,
1350
+ getContext(environment, state, next),
1351
+ (expression) => `${UNEXPECTED_EXCEPTION}${getExpectedBoolean(expression, environment)}`,
1352
+ );
1353
+ const toRecord = (state: Value[]): Record<string, Value> => {
1354
+ const record = Object.fromEntries(
1355
+ getTlcOrder().map((index) => [environment.variables[index], state[index]]),
1356
+ );
1357
+ return view === undefined
1358
+ ? record
1359
+ : setViewText(record, () => getViewText(view.expression, state));
1360
+ };
1361
+ runtime.toRecord = toRecord;
805
1362
  return {
806
1363
  properties,
807
1364
  spec,
1365
+ toRecord,
1366
+ evaluateAlias: (alias, state, next, isTool) => {
1367
+ const getStateRecord = () =>
1368
+ toRecord(state.map((value) => value ?? createModelValue("null")));
1369
+ try {
1370
+ getConfigDefinition("alias", alias, environment);
1371
+ const value = evaluate(createIdentifier(alias), getContext(environment, state, next));
1372
+ const record = toAliasRecord(value);
1373
+ return record === undefined ? getStateRecord() : setAliasName(record, alias);
1374
+ } catch (error) {
1375
+ if (!(error instanceof TlaConfigError || error instanceof TlaEvaluationError)) throw error;
1376
+ return { ...getStateRecord(), _ALIASEvalError: formatNestedMessage(error.message, isTool) };
1377
+ }
1378
+ },
808
1379
  isSymmetric: symmetryGroup !== undefined,
809
1380
  isConstrained: constraints.length > 0 || actionConstraints.length > 0,
1381
+ getTypedChecks: (liveness) => {
1382
+ const isInterpreted =
1383
+ coverage !== undefined ||
1384
+ possible.length > 0 ||
1385
+ config.periodic !== undefined ||
1386
+ [...invariants, ...constraints].some((check) => check.scope !== undefined) ||
1387
+ actionConstraints.length > 0 ||
1388
+ properties.actionProperties.some((property) => property.scope !== undefined) ||
1389
+ (properties.liveness.length > 0 && (liveness === undefined || view !== undefined));
1390
+ if (isInterpreted || spec.init === undefined || spec.next === undefined) return undefined;
1391
+ const invariantExpressions = invariantPredicates.map((invariant) => invariant.predicate);
1392
+ const constraintExpressions = [
1393
+ ...new Set(constraints.map((constraint) => constraint.predicate)),
1394
+ ];
1395
+ const initialExpressions = properties.initialPredicates.map(
1396
+ (predicate) => predicate.expression,
1397
+ );
1398
+ const definitions = [...environment.facts.ids.keys()];
1399
+ const scopeExpressions = getScopeExpressions(spec.scope);
1400
+ // The interpreter evaluates again what the tier evaluated before it fell back. TLC evaluates
1401
+ // a constant definition without parameters once as it starts, so one with a startup value
1402
+ // never draws again. An operator a scope binds without its expression can reach any
1403
+ // definition.
1404
+ const isReplayed = (definition: Definition) =>
1405
+ getStartupValue(definition, environment) === undefined &&
1406
+ isImpureDefinition(definition, environment, "replayed");
1407
+ const hasReplayedEffects =
1408
+ scopeExpressions === undefined
1409
+ ? definitions.some(isReplayed)
1410
+ : definitions.some(
1411
+ (definition) =>
1412
+ !(definition.kind === "Operator" && definition.params.length > 0) &&
1413
+ isConstantLevel(definition, environment) &&
1414
+ isReplayed(definition),
1415
+ ) ||
1416
+ isExpressionImpure(
1417
+ [
1418
+ spec.init,
1419
+ spec.next,
1420
+ ...invariantExpressions,
1421
+ ...constraintExpressions,
1422
+ ...initialExpressions,
1423
+ ...properties.actionProperties.flatMap((property) => [
1424
+ property.action,
1425
+ property.subscript,
1426
+ ]),
1427
+ ...(view ? [view.expression] : []),
1428
+ ...scopeExpressions,
1429
+ ...getLiveExpressions(liveness ?? []),
1430
+ ],
1431
+ environment,
1432
+ "replayed",
1433
+ );
1434
+ return hasReplayedEffects
1435
+ ? undefined
1436
+ : {
1437
+ init: spec.init,
1438
+ next: spec.next,
1439
+ scope: spec.scope,
1440
+ invariants: invariantExpressions,
1441
+ constraints: constraintExpressions,
1442
+ holdsInitialPredicates: (state: Value[]) =>
1443
+ findFailedInitialPredicate(state) === undefined,
1444
+ actionProperties: properties.actionProperties,
1445
+ symmetry: symmetryGroup,
1446
+ view: view?.expression,
1447
+ variableOrder: getTlcOrder(),
1448
+ liveness,
1449
+ };
1450
+ },
810
1451
  getTlcOrder,
811
1452
  getStoredFingerprints: (states, fingerprintStates) => {
812
1453
  if (view !== undefined || isFingerprintedLikeTlc) {
@@ -816,85 +1457,97 @@ export const createSearch = (
816
1457
  },
817
1458
  getFingerprintState: (state) => {
818
1459
  if (isFingerprintedLikeTlc) return [String(getTlcStateFingerprint(state))];
819
- // A representative in TLC's variable order is the one whose fingerprint TLC reports.
820
- const representative =
821
- symmetryGroup === undefined
822
- ? state
823
- : getRepresentative(state, symmetryGroup, getTlcOrder());
1460
+ const representative = getRepresentativeState(state);
824
1461
  return view === undefined ? representative : [getViewValue(view.expression, representative)];
825
1462
  },
826
1463
  findViolatedInvariant: (state, parent) => {
827
- const violated = invariants.find((invariant) => isViolated(invariant, state, parent));
1464
+ const violated =
1465
+ coverage === undefined
1466
+ ? invariants.find((invariant) => isViolated(invariant, state, parent))
1467
+ : invariantPredicates.find((predicate) => isPredicateViolated(predicate, state, parent));
828
1468
  if (violated) violatingStates.add(state);
829
1469
  return violated;
830
1470
  },
831
- getViolatedInvariants: (state) => {
832
- const violated = invariantPredicates.filter((predicate) =>
833
- invariants.some(
834
- (invariant) =>
835
- invariant.predicate === predicate.predicate && isViolated(invariant, state, undefined),
1471
+ forEachViolatedInvariant: (state, onViolated) => {
1472
+ for (const predicate of invariantPredicates) {
1473
+ if (!isPredicateViolated(predicate, state, undefined)) continue;
1474
+ violatingStates.add(state);
1475
+ onViolated(predicate);
1476
+ }
1477
+ },
1478
+ checkReplayedInitialState: (state, tracing, addFingerprint, onViolated) => {
1479
+ const holdsIn = (
1480
+ covered: CoveredCheck | undefined,
1481
+ expression: Expression,
1482
+ scope: Scope | undefined,
1483
+ ) => holdsReplayed(covered, expression, getContext(tracing, state, undefined, scope));
1484
+ const isInModel = constraintPredicates.every((constraint) =>
1485
+ holdsIn(
1486
+ coveredConstraintChecks.get(constraint.predicate),
1487
+ constraint.predicate,
1488
+ constraint.scope,
836
1489
  ),
837
1490
  );
838
- if (violated.length > 0) violatingStates.add(state);
839
- return violated;
840
- },
841
- checkReplayedInitialState: (state, tracing, addFingerprint) => {
842
- const holdsIn = (expression: Expression, scope: Scope | undefined) =>
843
- holdsLikeTlc(expression, getContext(tracing, state, undefined, scope));
844
- if (constraints.every((constraint) => holdsIn(constraint.predicate, constraint.scope))) {
845
- addFingerprint();
1491
+ if (isInModel) addFingerprint();
1492
+ for (const invariant of invariantPredicates) {
1493
+ const covered = coveredInvariantChecks.get(invariant.predicate);
1494
+ if (holdsIn(covered, invariant.predicate, invariant.scope)) continue;
1495
+ onViolated({ status: "invariant-violation", name: invariant.name });
846
1496
  }
847
- const invariant = invariantPredicates.find((check) => !holdsIn(check.predicate, check.scope));
848
- if (invariant) return { status: "invariant-violation", name: invariant.name };
849
1497
  const predicate = properties.initialPredicates.find(
850
- (check) => !holdsIn(check.expression, check.scope),
1498
+ (check, index) => !holdsIn(coveredInitialPredicates[index], check.expression, check.scope),
851
1499
  );
852
- return predicate && { status: "liveness-violation", name: predicate.name };
1500
+ if (predicate) onViolated({ status: "liveness-violation", name: predicate.name });
853
1501
  },
854
1502
  checkReplayedSuccessor: (state, next, tracing, addFingerprint) => {
855
- // TLC evaluates the action constraints only on a state that satisfies the constraints.
856
1503
  const isInModel =
857
- constraints.every((constraint) =>
858
- holdsLikeTlc(
1504
+ constraintPredicates.every((constraint) =>
1505
+ holdsReplayed(
1506
+ coveredConstraintChecks.get(constraint.predicate),
859
1507
  constraint.predicate,
860
1508
  getContext(tracing, next, undefined, constraint.scope),
861
1509
  ),
862
1510
  ) &&
863
- actionConstraints.every((constraint) =>
864
- holdsLikeTlc(constraint.expression, getContext(tracing, state, next, constraint.scope)),
1511
+ actionConstraints.every((constraint, index) =>
1512
+ holdsReplayed(
1513
+ coveredActionConstraints[index],
1514
+ constraint.expression,
1515
+ getContext(tracing, state, next, constraint.scope),
1516
+ ),
865
1517
  );
866
- // ModelChecker.doNext checks the invariants of a successor it has not seen, which includes
867
- // one outside the model.
1518
+ // TLC checks the invariants of a successor it has not seen, even outside the model.
868
1519
  const isUnseen = isInModel ? addFingerprint() : true;
869
1520
  return (
870
1521
  (!isUnseen ||
871
1522
  invariantPredicates.every((invariant) =>
872
- holdsLikeTlc(
1523
+ holdsReplayed(
1524
+ coveredInvariantChecks.get(invariant.predicate),
873
1525
  invariant.predicate,
874
1526
  getContext(tracing, next, undefined, invariant.scope),
875
1527
  ),
876
1528
  )) &&
877
- actionProperties.every((property) =>
878
- holdsLikeTlc(property.box, getContext(tracing, state, next, property.scope)),
1529
+ actionProperties.every((property, index) =>
1530
+ holdsReplayed(
1531
+ coveredActionProperties[index],
1532
+ property.box,
1533
+ getContext(tracing, state, next, property.scope),
1534
+ ),
879
1535
  )
880
1536
  );
881
1537
  },
882
1538
  satisfiesConstraints: (state, parent) =>
1539
+ satisfiesCovered(coveredConstraints, state) ??
883
1540
  constraints.every(
884
1541
  (constraint) =>
885
1542
  isUnchangedFor(constraint, state, parent) ||
886
1543
  holdsAsConjunct(constraint, getContext(environment, state, undefined)),
887
1544
  ),
888
- findFailedInitialPredicate: (state) =>
889
- properties.initialPredicates.find(
890
- (predicate) =>
891
- !holdsLikeTlc(
892
- predicate.expression,
893
- getContext(environment, state, undefined, predicate.scope),
894
- ),
895
- ),
1545
+ findFailedInitialPredicate,
896
1546
  findViolatedActionProperty: (state, next) =>
897
- actionProperties.find((property) => {
1547
+ actionProperties.find((property, index) => {
1548
+ const value =
1549
+ coverage && evaluateCovered(coverage, coveredActionProperties[index], state, next);
1550
+ if (typeof value === "boolean") return !value;
898
1551
  try {
899
1552
  return (
900
1553
  !holdsLikeTlc(
@@ -918,13 +1571,20 @@ export const createSearch = (
918
1571
  }
919
1572
  }),
920
1573
  satisfiesActionConstraints: (state, next) =>
921
- actionConstraints.every((constraint) =>
922
- holdsLikeTlc(
923
- constraint.expression,
924
- getContext(environment, state, next),
925
- (expression) => `${UNEXPECTED_EXCEPTION}${getExpectedBoolean(expression, environment)}`,
1574
+ satisfiesCovered(coveredActionConstraints, state, next) ??
1575
+ actionConstraints.every((constraint) => holdsActionConstraint(constraint, state, next)),
1576
+ getExcludingConstraints: (state, next) =>
1577
+ [
1578
+ ...constraints.filter(
1579
+ (constraint) => !holdsAsConjunct(constraint, getContext(environment, next, undefined)),
926
1580
  ),
927
- ),
1581
+ ...actionConstraints.filter(
1582
+ (constraint) => !holdsActionConstraint(constraint, state, next),
1583
+ ),
1584
+ ].map((constraint) => {
1585
+ const range = getBodyRange(constraint.name, environment);
1586
+ return range ? formatRange(range) : constraint.name;
1587
+ }),
928
1588
  trackStatePossible:
929
1589
  statePossible.length === 0
930
1590
  ? ignorePossible
@@ -936,29 +1596,47 @@ export const createSearch = (
936
1596
  : (state, next) =>
937
1597
  trackPossible(actionPossible, runtime, getContext(environment, state, next)),
938
1598
  findUnwitnessedPossible,
1599
+ getReward: (state, next, fallback) => {
1600
+ if (config.rlReward === undefined) return fallback;
1601
+ const expression = createIdentifier(config.rlReward);
1602
+ const value = evaluate(expression, getContext(environment, state, next));
1603
+ if (typeof value !== "number") {
1604
+ throw new TlaEvaluationError(getExpectedValue("integer", expression, environment));
1605
+ }
1606
+ return value;
1607
+ },
939
1608
  findPostconditionViolation: (isAfterViolation = false) => {
940
- // TLC replaces a definition it computes when it starts by its value, and then rejects it as
941
- // a postcondition before it checks any of them.
942
- const constant = config.postconditions.find((name) => {
943
- const definition = getDefinition(name, environment);
944
- return definition !== undefined && getStartupValue(definition, environment) !== undefined;
945
- });
946
- if (constant !== undefined) {
1609
+ const modulePostconditions = getModuleOperators("postcondition");
1610
+ const rejection = config.postconditions
1611
+ .map((name) => {
1612
+ const definition = getDefinition(name, environment);
1613
+ if (!definition) {
1614
+ return `The post condition ${name} specified in the configuration file\nis not defined in the specification.`;
1615
+ }
1616
+ if (definition.kind === "Operator" && definition.params.length > 0) {
1617
+ return `TLC requires post condition not to take any argument, but one was given: ${name}`;
1618
+ }
1619
+ const isConstant =
1620
+ !isLiteralDefinition(definition) &&
1621
+ getStartupValue(definition, environment) !== undefined;
1622
+ return isConstant ? `The post condition ${name} cannot be a constant.` : undefined;
1623
+ })
1624
+ .find((message) => message !== undefined);
1625
+ if (rejection !== undefined) {
947
1626
  if (isAfterViolation) return undefined;
948
- throw setExitCode(
949
- new TlaEvaluationError(
950
- `${UNEXPECTED_EXCEPTION}The post condition ${constant} cannot be a constant.`,
951
- ),
952
- EXIT_STATUS.error,
953
- );
1627
+ throw setExitCode(new TlaEvaluationError(rejection), EXIT_STATUS.configParseError);
954
1628
  }
955
- const unwitnessed = findUnwitnessedPossible();
956
- if (unwitnessed) return unwitnessed;
957
- for (const name of config.postconditions) {
958
- const failure = getConstantFailure(createIdentifier(name), environment, "a postcondition");
959
- if (!failure) continue;
960
- const range = getBodyRange(name, environment);
961
- const location = range ? ` at ${formatRange(range)}` : "";
1629
+ const findViolation = (name: string, key: string) => {
1630
+ const failure = getConstantFailure(
1631
+ (context) => holdsLikeTlc(createIdentifier(key), context),
1632
+ environment,
1633
+ );
1634
+ if (!failure) return undefined;
1635
+ const body = getDefinition(key, environment)?.body;
1636
+ const range = getBodyRange(key, environment);
1637
+ const location = range
1638
+ ? ` at ${body?.kind === "Number" ? describeNode(body) : formatRange(range)}`
1639
+ : "";
962
1640
  return failure.message === undefined
963
1641
  ? {
964
1642
  name,
@@ -970,13 +1648,21 @@ export const createSearch = (
970
1648
  code: MESSAGE_CODE.postconditionFailed,
971
1649
  message: `Evaluating postcondition ${name}${location} failed.\n${failure.message}`,
972
1650
  };
1651
+ };
1652
+ for (const operator of modulePostconditions) {
1653
+ const violation = findViolation(operator.name, operator.key);
1654
+ if (violation) return violation;
1655
+ }
1656
+ const unwitnessed = findUnwitnessedPossible();
1657
+ if (unwitnessed) return unwitnessed;
1658
+ for (const name of config.postconditions) {
1659
+ const violation = findViolation(name, name);
1660
+ if (violation) return violation;
973
1661
  }
974
1662
  return undefined;
975
1663
  },
976
1664
  };
977
1665
  };
978
1666
 
979
- // TLC exits with the code of a standard module's failure only when the failure escapes the
980
- // computation of next states. In every other phase, the phase decides the code.
981
1667
  export const withNextStateExitCode = (error: unknown) =>
982
1668
  error instanceof TlaModuleError ? setExitCode(error, error.exitCode) : error;