tla-ts 0.0.9 → 0.0.10-dev.09e53c2a6

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 (625) 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 +57 -53
  6. package/dist/index.cjs +1 -1
  7. package/dist/index.d.cts +109 -10
  8. package/dist/index.d.ts +109 -10
  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 +146 -31
  17. package/dist/run.js +146 -31
  18. package/dist/tlapm.cjs +2 -2
  19. package/dist/tlapm.js +2 -2
  20. package/dist/transfer.cjs +132 -104
  21. package/dist/transfer.js +132 -104
  22. package/dist/worker.cjs +6 -6
  23. package/dist/worker.js +6 -6
  24. package/package.json +3 -1
  25. package/src/ast.ts +45 -59
  26. package/src/bags.ts +99 -102
  27. package/src/builtins.ts +28 -75
  28. package/src/bundled-modules.ts +1 -8
  29. package/src/check-failure.ts +116 -0
  30. package/src/check-trace.ts +282 -0
  31. package/src/check.ts +797 -782
  32. package/src/cli/options.ts +12 -32
  33. package/src/cli/run.ts +0 -2
  34. package/src/cli/runtime-invariants.ts +136 -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 +687 -0
  39. package/src/cli/tlc-usage.ts +360 -0
  40. package/src/cli/tlc.ts +323 -658
  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 +196 -74
  45. package/src/config.ts +140 -109
  46. package/src/coverage.ts +830 -0
  47. package/src/dependencies.ts +36 -54
  48. package/src/dfid.ts +618 -0
  49. package/src/environment-config.ts +315 -0
  50. package/src/environment.ts +178 -339
  51. package/src/errors.ts +100 -57
  52. package/src/evaluate.ts +598 -340
  53. package/src/exit-codes.ts +38 -3
  54. package/src/fingerprints.ts +75 -11
  55. package/src/index.ts +3 -0
  56. package/src/instances.ts +126 -21
  57. package/src/java-hash.ts +7 -0
  58. package/src/java-overrides.ts +4 -19
  59. package/src/json-reader.ts +455 -0
  60. package/src/json.ts +252 -139
  61. package/src/levels.ts +46 -58
  62. package/src/lexer.ts +83 -101
  63. package/src/liveness-checker.ts +590 -311
  64. package/src/liveness.ts +180 -124
  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 +38 -19
  73. package/src/obligations/levels.ts +27 -18
  74. package/src/obligations/module.ts +28 -55
  75. package/src/obligations/normalize.ts +30 -37
  76. package/src/obligations/operators.ts +0 -3
  77. package/src/obligations/pragma.ts +52 -24
  78. package/src/obligations/printer.ts +89 -58
  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 +119 -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 +30 -60
  88. package/src/parallel.ts +59 -73
  89. package/src/parser.ts +1082 -399
  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 +224 -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 +0 -14
  118. package/src/prover/isabelle/provers/classical.ts +58 -61
  119. package/src/prover/isabelle/provers/hypsubst.ts +27 -52
  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 +31 -74
  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 +1 -44
  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 +0 -2
  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 +1026 -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 +615 -53
  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 +309 -0
  190. package/src/prover/smt/solver/array.ts +1 -3
  191. package/src/prover/smt/solver/asserted-formulas.ts +87 -58
  192. package/src/prover/smt/solver/ast-lt.ts +166 -22
  193. package/src/prover/smt/solver/ast-util.ts +160 -7
  194. package/src/prover/smt/solver/ast.ts +1424 -180
  195. package/src/prover/smt/solver/auf-solver.ts +7 -44
  196. package/src/prover/smt/solver/bit-blast-tactic.ts +582 -0
  197. package/src/prover/smt/solver/bit-blaster.ts +871 -0
  198. package/src/prover/smt/solver/bound-manager.ts +196 -0
  199. package/src/prover/smt/solver/bound-simplifier.ts +600 -0
  200. package/src/prover/smt/solver/bv-bound-chk.ts +492 -0
  201. package/src/prover/smt/solver/bv-decl-plugin.ts +338 -0
  202. package/src/prover/smt/solver/bv-divrem-bounds.ts +95 -0
  203. package/src/prover/smt/solver/bv-rewriter.ts +1901 -0
  204. package/src/prover/smt/solver/bv1-blast.ts +214 -0
  205. package/src/prover/smt/solver/bv2fpa-converter.ts +174 -0
  206. package/src/prover/smt/solver/bv2int-rewriter.ts +544 -0
  207. package/src/prover/smt/solver/bv2real-rewriter.ts +533 -0
  208. package/src/prover/smt/solver/card2bv.ts +110 -0
  209. package/src/prover/smt/solver/case-split-queue.ts +0 -10
  210. package/src/prover/smt/solver/cg-table.ts +39 -42
  211. package/src/prover/smt/solver/check-logic.ts +330 -0
  212. package/src/prover/smt/solver/clause.ts +0 -27
  213. package/src/prover/smt/solver/cofactor-elim-term-ite.ts +278 -0
  214. package/src/prover/smt/solver/conflict-resolution.ts +78 -11
  215. package/src/prover/smt/solver/context.ts +519 -175
  216. package/src/prover/smt/solver/ctx-simplify.ts +33 -50
  217. package/src/prover/smt/solver/ctx-solver-simplify.ts +122 -0
  218. package/src/prover/smt/solver/datatype-decl-plugin.ts +572 -0
  219. package/src/prover/smt/solver/datatype-rewriter.ts +82 -0
  220. package/src/prover/smt/solver/demodulator.ts +786 -0
  221. package/src/prover/smt/solver/dependent-expr-state.ts +81 -0
  222. package/src/prover/smt/solver/der.ts +39 -30
  223. package/src/prover/smt/solver/diff-neq.ts +206 -0
  224. package/src/prover/smt/solver/distribute-forall.ts +57 -0
  225. package/src/prover/smt/solver/dom-simplify.ts +511 -0
  226. package/src/prover/smt/solver/dt2bv-tactic.ts +260 -0
  227. package/src/prover/smt/solver/dyn-ack.ts +0 -11
  228. package/src/prover/smt/solver/e-matching.ts +9 -41
  229. package/src/prover/smt/solver/elim-small-bv-tactic.ts +129 -0
  230. package/src/prover/smt/solver/elim-uncnstr.ts +545 -0
  231. package/src/prover/smt/solver/enode.ts +100 -23
  232. package/src/prover/smt/solver/eq2bv-tactic.ts +218 -0
  233. package/src/prover/smt/solver/euf/arith-axioms.ts +403 -0
  234. package/src/prover/smt/solver/euf/arith-internalize.ts +653 -0
  235. package/src/prover/smt/solver/euf/arith-solver.ts +889 -0
  236. package/src/prover/smt/solver/euf/array-axioms.ts +527 -0
  237. package/src/prover/smt/solver/euf/array-internalize.ts +428 -0
  238. package/src/prover/smt/solver/euf/array-solver.ts +306 -0
  239. package/src/prover/smt/solver/euf/bv-ackerman.ts +162 -0
  240. package/src/prover/smt/solver/euf/bv-internalize.ts +748 -0
  241. package/src/prover/smt/solver/euf/bv-solver.ts +449 -0
  242. package/src/prover/smt/solver/euf/dt-solver.ts +618 -0
  243. package/src/prover/smt/solver/euf/egraph.ts +907 -0
  244. package/src/prover/smt/solver/euf/euf-solver.ts +1205 -0
  245. package/src/prover/smt/solver/euf/fpa-solver.ts +317 -0
  246. package/src/prover/smt/solver/euf/mam.ts +1050 -0
  247. package/src/prover/smt/solver/euf/q-ematch.ts +830 -0
  248. package/src/prover/smt/solver/euf/q-mbi.ts +587 -0
  249. package/src/prover/smt/solver/euf/q-model-fixer.ts +296 -0
  250. package/src/prover/smt/solver/euf/q-solver.ts +361 -0
  251. package/src/prover/smt/solver/euf/th-solver.ts +335 -0
  252. package/src/prover/smt/solver/euf/th-solvers.ts +30 -0
  253. package/src/prover/smt/solver/expr-ref.ts +0 -5
  254. package/src/prover/smt/solver/expr-safe-replace.ts +26 -7
  255. package/src/prover/smt/solver/expr2polynomial.ts +146 -0
  256. package/src/prover/smt/solver/factor.ts +141 -0
  257. package/src/prover/smt/solver/fd-solver.ts +265 -0
  258. package/src/prover/smt/solver/fingerprints.ts +15 -26
  259. package/src/prover/smt/solver/fix-dl-var.ts +148 -0
  260. package/src/prover/smt/solver/flat-literals.ts +0 -9
  261. package/src/prover/smt/solver/fm-tactic.ts +884 -0
  262. package/src/prover/smt/solver/fpa-decl-plugin.ts +618 -0
  263. package/src/prover/smt/solver/fpa-rewriter.ts +640 -0
  264. package/src/prover/smt/solver/fpa2bv-converter.ts +2249 -0
  265. package/src/prover/smt/solver/fpa2bv-rewriter.ts +348 -0
  266. package/src/prover/smt/solver/fpa2bv-tactic.ts +73 -0
  267. package/src/prover/smt/solver/goal.ts +176 -28
  268. package/src/prover/smt/solver/goal2nlsat.ts +189 -0
  269. package/src/prover/smt/solver/guard-set.ts +219 -0
  270. package/src/prover/smt/solver/hash.ts +0 -9
  271. package/src/prover/smt/solver/hashtable.ts +26 -23
  272. package/src/prover/smt/solver/inf-eps.ts +63 -0
  273. package/src/prover/smt/solver/inj-axiom.ts +101 -0
  274. package/src/prover/smt/solver/internalizer.ts +112 -132
  275. package/src/prover/smt/solver/lackr.ts +381 -0
  276. package/src/prover/smt/solver/lbool.ts +0 -2
  277. package/src/prover/smt/solver/lia2card.ts +268 -0
  278. package/src/prover/smt/solver/lia2pb.ts +154 -0
  279. package/src/prover/smt/solver/literal.ts +0 -4
  280. package/src/prover/smt/solver/logic-tactics.ts +345 -0
  281. package/src/prover/smt/solver/lp/bound-propagator.ts +7 -26
  282. package/src/prover/smt/solver/lp/constraints.ts +1 -8
  283. package/src/prover/smt/solver/lp/containers.ts +11 -30
  284. package/src/prover/smt/solver/lp/core-solver.ts +23 -29
  285. package/src/prover/smt/solver/lp/cross-nested.ts +5 -20
  286. package/src/prover/smt/solver/lp/dep-intervals.ts +6 -24
  287. package/src/prover/smt/solver/lp/dependency.ts +0 -5
  288. package/src/prover/smt/solver/lp/dioph-eq.ts +8 -103
  289. package/src/prover/smt/solver/lp/explanation.ts +0 -6
  290. package/src/prover/smt/solver/lp/gomory.ts +8 -22
  291. package/src/prover/smt/solver/lp/hnf-cutter.ts +16 -23
  292. package/src/prover/smt/solver/lp/hnf.ts +10 -28
  293. package/src/prover/smt/solver/lp/int-cube.ts +17 -39
  294. package/src/prover/smt/solver/lp/int-solver.ts +3 -35
  295. package/src/prover/smt/solver/lp/lar-solver.ts +69 -82
  296. package/src/prover/smt/solver/lp/lar-term.ts +0 -5
  297. package/src/prover/smt/solver/lp/lp-settings.ts +0 -14
  298. package/src/prover/smt/solver/lp/maximize-term.ts +76 -52
  299. package/src/prover/smt/solver/lp/nex-creator.ts +4 -28
  300. package/src/prover/smt/solver/lp/nex.ts +0 -6
  301. package/src/prover/smt/solver/lp/nla-backoff.ts +0 -5
  302. package/src/prover/smt/solver/lp/nla-basics.ts +48 -30
  303. package/src/prover/smt/solver/lp/nla-core.ts +91 -135
  304. package/src/prover/smt/solver/lp/nla-divisions.ts +31 -43
  305. package/src/prover/smt/solver/lp/nla-emonics.ts +3 -21
  306. package/src/prover/smt/solver/lp/nla-factorization.ts +0 -4
  307. package/src/prover/smt/solver/lp/nla-grobner.ts +22 -72
  308. package/src/prover/smt/solver/lp/nla-horner.ts +2 -12
  309. package/src/prover/smt/solver/lp/nla-intervals.ts +1 -12
  310. package/src/prover/smt/solver/lp/nla-monomial-bounds.ts +15 -42
  311. package/src/prover/smt/solver/lp/nla-monotone.ts +1 -6
  312. package/src/prover/smt/solver/lp/nla-order.ts +0 -13
  313. package/src/prover/smt/solver/lp/nla-patcher.ts +3 -7
  314. package/src/prover/smt/solver/lp/nla-powers.ts +220 -0
  315. package/src/prover/smt/solver/lp/nla-tangents.ts +0 -10
  316. package/src/prover/smt/solver/lp/nla-throttle.ts +0 -6
  317. package/src/prover/smt/solver/lp/nla-transcendentals.ts +324 -0
  318. package/src/prover/smt/solver/lp/nla-types.ts +0 -12
  319. package/src/prover/smt/solver/lp/nla-var-eqs.ts +4 -26
  320. package/src/prover/smt/solver/lp/nra-solver.ts +123 -112
  321. package/src/prover/smt/solver/lp/numeric-pair.ts +0 -4
  322. package/src/prover/smt/solver/lp/pdd-interval.ts +0 -3
  323. package/src/prover/smt/solver/lp/pdd-simplifier.ts +1 -14
  324. package/src/prover/smt/solver/lp/pdd-solver.ts +2 -33
  325. package/src/prover/smt/solver/lp/pdd.ts +7 -70
  326. package/src/prover/smt/solver/lp/random-updater.ts +0 -9
  327. package/src/prover/smt/solver/lp/static-matrix.ts +8 -19
  328. package/src/prover/smt/solver/lp/union-find.ts +5 -5
  329. package/src/prover/smt/solver/macro-finder.ts +530 -0
  330. package/src/prover/smt/solver/mam-compiler.ts +129 -139
  331. package/src/prover/smt/solver/mam-interpreter.ts +0 -21
  332. package/src/prover/smt/solver/max-bv-sharing-tactic.ts +17 -0
  333. package/src/prover/smt/solver/max-cliques.ts +105 -0
  334. package/src/prover/smt/solver/maxcore.ts +309 -0
  335. package/src/prover/smt/solver/maximize-ac-sharing.ts +8 -21
  336. package/src/prover/smt/solver/maxlex.ts +115 -0
  337. package/src/prover/smt/solver/maxsmt-base.ts +105 -0
  338. package/src/prover/smt/solver/maxsmt.ts +92 -0
  339. package/src/prover/smt/solver/mbp/mbp-arith.ts +467 -0
  340. package/src/prover/smt/solver/mbp/mbp-basic-tg.ts +101 -0
  341. package/src/prover/smt/solver/mbp/mbp-plugin.ts +287 -0
  342. package/src/prover/smt/solver/mbp/mbp-qel.ts +48 -0
  343. package/src/prover/smt/solver/mbp/mbp-solve-plugin.ts +271 -0
  344. package/src/prover/smt/solver/mbp/mbp-term-graph.ts +606 -0
  345. package/src/prover/smt/solver/model-based-opt.ts +844 -0
  346. package/src/prover/smt/solver/model-checker.ts +19 -62
  347. package/src/prover/smt/solver/model-evaluator.ts +190 -40
  348. package/src/prover/smt/solver/model-finder.ts +14 -32
  349. package/src/prover/smt/solver/model-generator.ts +56 -40
  350. package/src/prover/smt/solver/model-macro-solver.ts +60 -114
  351. package/src/prover/smt/solver/model-printer.ts +214 -0
  352. package/src/prover/smt/solver/mpf.ts +711 -0
  353. package/src/prover/smt/solver/mus.ts +51 -0
  354. package/src/prover/smt/solver/muz/dl-context.ts +404 -0
  355. package/src/prover/smt/solver/muz/dl-mk-bit-blast.ts +97 -0
  356. package/src/prover/smt/solver/muz/dl-mk-coi-filter.ts +167 -0
  357. package/src/prover/smt/solver/muz/dl-mk-elim-term-ite.ts +125 -0
  358. package/src/prover/smt/solver/muz/dl-mk-interp-tail-simplifier.ts +299 -0
  359. package/src/prover/smt/solver/muz/dl-mk-rule-inliner.ts +455 -0
  360. package/src/prover/smt/solver/muz/dl-mk-slice.ts +340 -0
  361. package/src/prover/smt/solver/muz/dl-mk-subsumption-checker.ts +163 -0
  362. package/src/prover/smt/solver/muz/dl-rule-set.ts +273 -0
  363. package/src/prover/smt/solver/muz/dl-rule-transformer.ts +123 -0
  364. package/src/prover/smt/solver/muz/dl-rule.ts +496 -0
  365. package/src/prover/smt/solver/muz/hnf.ts +201 -0
  366. package/src/prover/smt/solver/muz/horn-subsume-model-converter.ts +176 -0
  367. package/src/prover/smt/solver/muz/horn-tactic.ts +201 -0
  368. package/src/prover/smt/solver/muz/rule-properties.ts +337 -0
  369. package/src/prover/smt/solver/muz/spacer-context.ts +1406 -0
  370. package/src/prover/smt/solver/muz/spacer-dl-interface.ts +52 -0
  371. package/src/prover/smt/solver/muz/spacer-generalizers.ts +241 -0
  372. package/src/prover/smt/solver/muz/spacer-manager.ts +127 -0
  373. package/src/prover/smt/solver/muz/spacer-pdr.ts +218 -0
  374. package/src/prover/smt/solver/muz/spacer-prop-solver.ts +333 -0
  375. package/src/prover/smt/solver/muz/spacer-util.ts +282 -0
  376. package/src/prover/smt/solver/muz/substitution.ts +203 -0
  377. package/src/prover/smt/solver/nla2bv-tactic.ts +285 -0
  378. package/src/prover/smt/solver/nlqsat.ts +484 -0
  379. package/src/prover/smt/solver/nlsat/algebraic.ts +177 -160
  380. package/src/prover/smt/solver/nlsat/atoms.ts +24 -24
  381. package/src/prover/smt/solver/nlsat/evaluator.ts +16 -22
  382. package/src/prover/smt/solver/nlsat/explain.ts +65 -69
  383. package/src/prover/smt/solver/nlsat/interval-set.ts +9 -51
  384. package/src/prover/smt/solver/nlsat/levelwise.ts +48 -135
  385. package/src/prover/smt/solver/nlsat/mpbq.ts +47 -14
  386. package/src/prover/smt/solver/nlsat/polynomial.ts +29 -161
  387. package/src/prover/smt/solver/nlsat/solver.ts +241 -110
  388. package/src/prover/smt/solver/nlsat/transcendental-eval.ts +310 -0
  389. package/src/prover/smt/solver/nlsat/transcendentals.ts +367 -0
  390. package/src/prover/smt/solver/nlsat/types.ts +0 -9
  391. package/src/prover/smt/solver/nlsat/upolynomial-factorization.ts +1 -47
  392. package/src/prover/smt/solver/nlsat/upolynomial.ts +10 -93
  393. package/src/prover/smt/solver/nlsat-tactic.ts +82 -0
  394. package/src/prover/smt/solver/nnf.ts +107 -60
  395. package/src/prover/smt/solver/normalize-bounds.ts +53 -0
  396. package/src/prover/smt/solver/occf.ts +97 -0
  397. package/src/prover/smt/solver/opt-context.ts +787 -0
  398. package/src/prover/smt/solver/opt-nlsat.ts +375 -0
  399. package/src/prover/smt/solver/opt-pareto.ts +282 -0
  400. package/src/prover/smt/solver/opt-preprocess.ts +101 -0
  401. package/src/prover/smt/solver/opt-solver.ts +308 -0
  402. package/src/prover/smt/solver/opt-value.ts +55 -0
  403. package/src/prover/smt/solver/optsmt.ts +692 -0
  404. package/src/prover/smt/solver/parallel-tactic.ts +299 -0
  405. package/src/prover/smt/solver/pattern-inference.ts +21 -26
  406. package/src/prover/smt/solver/pb-rewriter.ts +284 -0
  407. package/src/prover/smt/solver/pb2bv-tactic.ts +540 -0
  408. package/src/prover/smt/solver/poly-rewriter.ts +204 -79
  409. package/src/prover/smt/solver/probes.ts +512 -0
  410. package/src/prover/smt/solver/propagate-values.ts +37 -30
  411. package/src/prover/smt/solver/proto-model.ts +650 -66
  412. package/src/prover/smt/solver/pull-quant.ts +28 -23
  413. package/src/prover/smt/solver/purify-arith.ts +632 -0
  414. package/src/prover/smt/solver/qe-arith-plugin.ts +1098 -0
  415. package/src/prover/smt/solver/qe-lite-der.ts +2 -31
  416. package/src/prover/smt/solver/qe-lite-fm.ts +4 -28
  417. package/src/prover/smt/solver/qe-lite.ts +39 -49
  418. package/src/prover/smt/solver/qe-mbp.ts +270 -0
  419. package/src/prover/smt/solver/qe.ts +1498 -0
  420. package/src/prover/smt/solver/qel.ts +25 -0
  421. package/src/prover/smt/solver/qi-queue.ts +0 -16
  422. package/src/prover/smt/solver/qsat.ts +814 -0
  423. package/src/prover/smt/solver/quant-hoist.ts +196 -0
  424. package/src/prover/smt/solver/quant-tactics.ts +17 -74
  425. package/src/prover/smt/solver/quantifier-analyzer.ts +26 -47
  426. package/src/prover/smt/solver/quantifier-manager.ts +8 -23
  427. package/src/prover/smt/solver/quasi-macros.ts +243 -0
  428. package/src/prover/smt/solver/random-gen.ts +0 -2
  429. package/src/prover/smt/solver/rational.ts +45 -8
  430. package/src/prover/smt/solver/recfun-decl-plugin.ts +261 -0
  431. package/src/prover/smt/solver/recfun-rewriter.ts +107 -0
  432. package/src/prover/smt/solver/reduce-args.ts +225 -0
  433. package/src/prover/smt/solver/reduce-bv-size.ts +119 -0
  434. package/src/prover/smt/solver/ref-vector.ts +0 -6
  435. package/src/prover/smt/solver/relevancy.ts +2 -16
  436. package/src/prover/smt/solver/rewriter-tpl.ts +52 -129
  437. package/src/prover/smt/solver/rewriter.ts +477 -120
  438. package/src/prover/smt/solver/rlimit.ts +39 -21
  439. package/src/prover/smt/solver/sat/asymm-branch.ts +325 -0
  440. package/src/prover/smt/solver/sat/big.ts +177 -0
  441. package/src/prover/smt/solver/sat/clause-use-list.ts +71 -0
  442. package/src/prover/smt/solver/sat/clause.ts +203 -0
  443. package/src/prover/smt/solver/sat/cleaner.ts +94 -0
  444. package/src/prover/smt/solver/sat/config.ts +122 -0
  445. package/src/prover/smt/solver/sat/consequences.ts +203 -0
  446. package/src/prover/smt/solver/sat/elim-eqs.ts +142 -0
  447. package/src/prover/smt/solver/sat/goal2sat.ts +526 -0
  448. package/src/prover/smt/solver/sat/inc-sat-solver.ts +378 -0
  449. package/src/prover/smt/solver/sat/model-converter.ts +136 -0
  450. package/src/prover/smt/solver/sat/pb-constraint.ts +261 -0
  451. package/src/prover/smt/solver/sat/pb-solver.ts +1577 -0
  452. package/src/prover/smt/solver/sat/probing.ts +170 -0
  453. package/src/prover/smt/solver/sat/sat-tactic.ts +43 -0
  454. package/src/prover/smt/solver/sat/sat2goal.ts +165 -0
  455. package/src/prover/smt/solver/sat/scc.ts +142 -0
  456. package/src/prover/smt/solver/sat/simplifier.ts +1618 -0
  457. package/src/prover/smt/solver/sat/solver.ts +2127 -0
  458. package/src/prover/smt/solver/sat/var-queue.ts +117 -0
  459. package/src/prover/smt/solver/sat/watch-list.ts +140 -0
  460. package/src/prover/smt/solver/search-tree.ts +284 -0
  461. package/src/prover/smt/solver/seq-axioms.ts +1010 -0
  462. package/src/prover/smt/solver/seq-decl-plugin.ts +819 -0
  463. package/src/prover/smt/solver/seq-derive.ts +1301 -0
  464. package/src/prover/smt/solver/seq-eq-approx.ts +236 -0
  465. package/src/prover/smt/solver/seq-eq-solver.ts +439 -0
  466. package/src/prover/smt/solver/seq-factory.ts +89 -0
  467. package/src/prover/smt/solver/seq-monadic.ts +728 -0
  468. package/src/prover/smt/solver/seq-range-predicate.ts +235 -0
  469. package/src/prover/smt/solver/seq-re-rewriter.ts +1170 -0
  470. package/src/prover/smt/solver/seq-re-util.ts +758 -0
  471. package/src/prover/smt/solver/seq-regex-bisim.ts +144 -0
  472. package/src/prover/smt/solver/seq-regex-live.ts +200 -0
  473. package/src/prover/smt/solver/seq-rewriter.ts +2402 -0
  474. package/src/prover/smt/solver/seq-skolem.ts +317 -0
  475. package/src/prover/smt/solver/seq-subset.ts +165 -0
  476. package/src/prover/smt/solver/seq-view-witness.ts +353 -0
  477. package/src/prover/smt/solver/smt-consequences.ts +297 -0
  478. package/src/prover/smt/solver/smt-kernel.ts +83 -0
  479. package/src/prover/smt/solver/smt-logics.ts +66 -0
  480. package/src/prover/smt/solver/smt-setup.ts +496 -0
  481. package/src/prover/smt/solver/smt2-printer.ts +765 -0
  482. package/src/prover/smt/solver/smtlib-parser.ts +3140 -365
  483. package/src/prover/smt/solver/smtlib-script.ts +1631 -0
  484. package/src/prover/smt/solver/solve-eqs.ts +929 -0
  485. package/src/prover/smt/solver/solver.ts +119 -39
  486. package/src/prover/smt/solver/sort.ts +1 -5
  487. package/src/prover/smt/solver/static-features.ts +314 -0
  488. package/src/prover/smt/solver/sticky-generations.ts +0 -6
  489. package/src/prover/smt/solver/tactic.ts +1986 -0
  490. package/src/prover/smt/solver/term-enumeration.ts +205 -0
  491. package/src/prover/smt/solver/theory-array.ts +1240 -0
  492. package/src/prover/smt/solver/theory-bv.ts +1200 -0
  493. package/src/prover/smt/solver/theory-char.ts +355 -0
  494. package/src/prover/smt/solver/theory-datatype.ts +598 -0
  495. package/src/prover/smt/solver/theory-finite-set.ts +30 -0
  496. package/src/prover/smt/solver/theory-fpa.ts +389 -0
  497. package/src/prover/smt/solver/theory-lra-axioms.ts +55 -25
  498. package/src/prover/smt/solver/theory-lra-bounds.ts +31 -11
  499. package/src/prover/smt/solver/theory-lra-final-check.ts +59 -91
  500. package/src/prover/smt/solver/theory-lra-internalize.ts +94 -53
  501. package/src/prover/smt/solver/theory-lra-model.ts +23 -53
  502. package/src/prover/smt/solver/theory-lra-propagate.ts +24 -40
  503. package/src/prover/smt/solver/theory-lra-state.ts +6 -27
  504. package/src/prover/smt/solver/theory-lra.ts +188 -8
  505. package/src/prover/smt/solver/theory-pb.ts +934 -0
  506. package/src/prover/smt/solver/theory-polymorphism.ts +58 -0
  507. package/src/prover/smt/solver/theory-recfun.ts +307 -0
  508. package/src/prover/smt/solver/theory-seq-regex.ts +867 -0
  509. package/src/prover/smt/solver/theory-seq-solve.ts +1373 -0
  510. package/src/prover/smt/solver/theory-seq-state.ts +871 -0
  511. package/src/prover/smt/solver/theory-seq.ts +961 -0
  512. package/src/prover/smt/solver/theory.ts +189 -0
  513. package/src/prover/smt/solver/tseitin-cnf.ts +485 -0
  514. package/src/prover/smt/solver/var-subst.ts +37 -39
  515. package/src/prover/smt/table.ts +3 -10
  516. package/src/prover/smt/types.ts +146 -0
  517. package/src/prover/tlapm/cache.ts +67 -41
  518. package/src/prover/tlapm/ocaml-marshal.ts +19 -21
  519. package/src/prover/tlapm/tlapm.ts +21 -20
  520. package/src/prover/tlapm-library.ts +3208 -0
  521. package/src/prover/verdict.ts +9 -2
  522. package/src/prover/zenon/check/check.ts +1 -11
  523. package/src/prover/zenon/check/definitions.ts +5 -15
  524. package/src/prover/zenon/check/equality.ts +0 -8
  525. package/src/prover/zenon/check/functions.ts +0 -4
  526. package/src/prover/zenon/check/keys.ts +0 -7
  527. package/src/prover/zenon/check/propositional.ts +0 -3
  528. package/src/prover/zenon/check/records.ts +1 -6
  529. package/src/prover/zenon/check/relations.ts +2 -14
  530. package/src/prover/zenon/check/rewrites.ts +2 -21
  531. package/src/prover/zenon/check/sets.ts +40 -61
  532. package/src/prover/zenon/check/terms.ts +1 -19
  533. package/src/prover/zenon/check/tla.ts +0 -6
  534. package/src/prover/zenon/decide.ts +10 -19
  535. package/src/prover/zenon/encode.ts +0 -9
  536. package/src/prover/zenon/eqrel.ts +2 -15
  537. package/src/prover/zenon/equality-rules.ts +0 -6
  538. package/src/prover/zenon/expr.ts +8 -28
  539. package/src/prover/zenon/index-table.ts +26 -59
  540. package/src/prover/zenon/isar-case.ts +8 -20
  541. package/src/prover/zenon/isar.ts +35 -65
  542. package/src/prover/zenon/limits.ts +0 -4
  543. package/src/prover/zenon/llproof.ts +2 -22
  544. package/src/prover/zenon/mltoll.ts +66 -106
  545. package/src/prover/zenon/node.ts +20 -15
  546. package/src/prover/zenon/ocaml.ts +1 -17
  547. package/src/prover/zenon/parse.ts +9 -13
  548. package/src/prover/zenon/phrase.ts +1 -13
  549. package/src/prover/zenon/proof.ts +0 -11
  550. package/src/prover/zenon/propositional-rules.ts +0 -7
  551. package/src/prover/zenon/rules.ts +2 -8
  552. package/src/prover/zenon/search.ts +11 -35
  553. package/src/prover/zenon/tla/functions.ts +59 -33
  554. package/src/prover/zenon/tla/llproof.ts +67 -78
  555. package/src/prover/zenon/tla/records.ts +57 -35
  556. package/src/prover/zenon/tla/rewrites.ts +12 -21
  557. package/src/prover/zenon/tla/sets.ts +88 -59
  558. package/src/prover/zenon/tla/terms.ts +0 -8
  559. package/src/prover/zenon/tla/tla.ts +66 -66
  560. package/src/randomization.ts +81 -35
  561. package/src/resolve.ts +67 -185
  562. package/src/runtime.ts +26 -22
  563. package/src/sany/builtins.ts +2 -5
  564. package/src/sany/generation.ts +394 -0
  565. package/src/sany/generator-def-entries.ts +210 -0
  566. package/src/sany/generator-definitions.ts +686 -0
  567. package/src/sany/generator-expressions.ts +1100 -0
  568. package/src/sany/generator-proofs.ts +662 -0
  569. package/src/sany/generator.ts +191 -2764
  570. package/src/sany/levels.ts +5 -35
  571. package/src/sany/lexer.ts +58 -77
  572. package/src/sany/linter.ts +0 -10
  573. package/src/sany/modules.ts +1 -5
  574. package/src/sany/nodes.ts +5 -43
  575. package/src/sany/parse-error.ts +39 -117
  576. package/src/sany/report.ts +32 -69
  577. package/src/sany/selectors.ts +49 -76
  578. package/src/sany/source.ts +1 -17
  579. package/src/sany/xml.ts +35 -117
  580. package/src/search.ts +671 -169
  581. package/src/simulate.ts +712 -0
  582. package/src/spec-description.ts +192 -100
  583. package/src/standard-definitions.ts +4 -4
  584. package/src/standard-modules.ts +264 -95
  585. package/src/state-graph.ts +52 -33
  586. package/src/subexpressions.ts +69 -52
  587. package/src/substitution-levels.ts +7 -7
  588. package/src/successors.ts +267 -100
  589. package/src/symmetry.ts +35 -27
  590. package/src/tableau.ts +29 -26
  591. package/src/tlc/fingerprint.ts +267 -79
  592. package/src/tlc/jar-data.ts +112 -6
  593. package/src/tlc/messages.ts +125 -54
  594. package/src/tlc/order.ts +39 -69
  595. package/src/tlc/random.ts +37 -49
  596. package/src/tlc/replay.ts +553 -228
  597. package/src/tlc/summary.ts +64 -60
  598. package/src/tlc/tlc-operators.ts +78 -44
  599. package/src/tlc/tlcext-operators.ts +171 -122
  600. package/src/tlc/trace-spec.ts +249 -0
  601. package/src/tlc/value-stream.ts +139 -0
  602. package/src/tlc/version.ts +1 -4
  603. package/src/transfer.ts +22 -25
  604. package/src/typed-tier.ts +6535 -0
  605. package/src/typescript/actions.ts +479 -0
  606. package/src/typescript/collections.ts +614 -0
  607. package/src/typescript/compile.ts +63 -0
  608. package/src/typescript/context.ts +94 -0
  609. package/src/typescript/emit.ts +121 -0
  610. package/src/typescript/expressions.ts +496 -0
  611. package/src/typescript/formula.ts +154 -0
  612. package/src/typescript/functions.ts +284 -0
  613. package/src/typescript/model.ts +162 -0
  614. package/src/typescript/names.ts +114 -0
  615. package/src/typescript/program.ts +48 -0
  616. package/src/typescript/properties.ts +139 -0
  617. package/src/typescript/scope.ts +112 -0
  618. package/src/typescript/steps.ts +167 -0
  619. package/src/typescript/types.ts +171 -0
  620. package/src/values.ts +832 -484
  621. package/src/worker.ts +7 -8
  622. package/src/prover/isabelle/isar/statement.ts +0 -57
  623. package/src/prover/smt/solver/z3-license.txt +0 -10
  624. package/src/prover/tlaps-module.ts +0 -510
  625. package/src/prover/zenon/LICENSE +0 -32
package/src/cli/tlc.ts CHANGED
@@ -1,72 +1,75 @@
1
1
  import {
2
+ appendFileSync,
3
+ closeSync,
2
4
  existsSync,
3
5
  mkdirSync,
6
+ openSync,
4
7
  readFileSync,
5
8
  readSync,
6
9
  realpathSync,
10
+ statSync,
7
11
  writeFileSync,
8
12
  } from "node:fs";
9
13
  import { basename, dirname, isAbsolute, join, resolve } from "node:path";
10
- import { arch, availableParallelism, release, tmpdir, type } from "node:os";
11
- import { pathToFileURL } from "node:url";
12
- import { getHeapStatistics } from "node:v8";
13
- import { version } from "../../package.json";
14
- import type { Expression } from "../ast";
15
- import { describeRange } from "../evaluate";
16
- import type {
17
- CheckProgress,
18
- InitialStateViolation,
19
- OutputLine,
20
- CheckResult,
21
- CheckStatus,
22
- InitialStates,
23
- SearchStatistics,
24
- TraceStep,
25
- Violation,
26
- } from "../check";
14
+ import { tmpdir } from "node:os";
15
+ import type { CheckOptions, ModuleOperator, CheckStatus } from "../check";
27
16
  import { parseConfig } from "../config";
17
+ import { checkDepthFirst } from "../dfid";
28
18
  import {
29
- getErrorExitCode,
30
19
  TlaConfigError,
31
20
  TlaError,
32
21
  TlaEvaluationError,
22
+ TlaFeatureUnsupportedError,
23
+ TlaMissingCheckpointError,
33
24
  TlaSyntaxError,
34
25
  getUnexpectedException,
35
- UNEXPECTED_EXCEPTION,
36
26
  TlaSanyFatalError,
37
27
  } from "../errors";
38
- import { EXIT_STATUS, setExitCode } from "../exit-codes";
28
+ import { EXIT_STATUS } from "../exit-codes";
39
29
  import { check } from "../parallel";
40
- import { parseModule } from "../parser";
30
+ import { extractModule, parseModule } from "../parser";
31
+ import { simulate } from "../simulate";
32
+ import type { StandardInput } from "../search";
41
33
  import type { StateDump } from "../state-graph";
42
34
  import {
43
- formatProbability,
44
- getActualProbability,
45
- getOptimisticProbability,
46
- getOutDegreeSummary,
47
- } from "../tlc/summary";
48
- import { SANY_174_STANDARD_MODULES, SANY_STANDARD_MODULES } from "../sany/modules";
35
+ getSanyStandardModules,
36
+ SANY_174_STANDARD_MODULES,
37
+ SANY_STANDARD_MODULES,
38
+ } from "../sany/modules";
49
39
  import { getSanyReport, type SanyModuleOrigin } from "../sany/report";
50
40
  import { getTlcFingerprint } from "../tlc/fingerprint";
51
41
  import type { TlcVersion } from "../tlc/version";
52
42
  import {
53
43
  createMessagePrinter,
54
44
  formatTlcDate,
55
- formatInnerMessage,
56
45
  formatNestedMessage,
57
46
  formatTlcDuration,
58
47
  MESSAGE_CODE,
59
48
  MESSAGE_LEVEL,
60
49
  type MessagePrinter,
50
+ zeroPad,
61
51
  } from "../tlc/messages";
62
- import { formatState } from "../values";
63
- import { CHECK_COMMAND, USAGE, type ParsedArgs } from "./options";
52
+ import { addRuntimeInvariants } from "./runtime-invariants";
53
+ import { parseTlcArguments, type TlcArguments } from "./tlc-arguments";
54
+ import {
55
+ getClassPath,
56
+ printCheckProgress,
57
+ printCommandLineError,
58
+ printDepthFirst,
59
+ printResult,
60
+ printSimulation,
61
+ printStartupBanner,
62
+ printWelcome,
63
+ type Timing,
64
+ } from "./tlc-output";
65
+ import { getTlcUsage } from "./tlc-usage";
64
66
  import {
65
67
  createModuleLoader,
66
68
  findModuleFile,
67
69
  getInputPaths,
68
70
  getToolsJar,
69
71
  getStandardModulesUrl,
72
+ getTopLevelExitCode,
70
73
  printError,
71
74
  printMissingFile,
72
75
  printMissingFile174,
@@ -75,6 +78,7 @@ import {
75
78
  toLibraryPath,
76
79
  type JavaProperties,
77
80
  } from "./shared";
81
+ import { writeTypeScriptSpec } from "./typescript";
78
82
 
79
83
  const EXIT_CODES: Record<CheckStatus, number> = {
80
84
  success: EXIT_STATUS.success,
@@ -87,19 +91,12 @@ const EXIT_CODES: Record<CheckStatus, number> = {
87
91
  error: EXIT_STATUS.error,
88
92
  };
89
93
 
90
- const isJavaLong = (text: string) =>
91
- /^[+-]?\d+$/.test(text) && BigInt.asIntN(64, BigInt(text)) === BigInt(text);
92
-
93
- const getWorkerCount = (values: string[] | undefined) => {
94
- if (!values) return 1;
95
- return values[0] === "auto"
96
- ? availableParallelism()
97
- : Math.max(1, Number.parseInt(values[0], 10) || 1);
94
+ const checkNotDirectory = (path: string) => {
95
+ if (statSync(path, { throwIfNoEntry: false })?.isDirectory()) {
96
+ throw new TlaEvaluationError(`${path} (Is a directory)`);
97
+ }
98
98
  };
99
99
 
100
- const UNSUPPORTED_DUMP_FORMATS = ["constrained", "stuttering", "strict"];
101
-
102
- // TLC names the file of a -dump by its format unless the name already ends that way.
103
100
  const getDumpPath = (path: string, extension: string) =>
104
101
  path.endsWith(extension) ? path : `${path}${extension}`;
105
102
 
@@ -112,491 +109,15 @@ const getStateDump = (values: string[]): StateDump => {
112
109
  colorize: format.includes("colorize"),
113
110
  actionLabels: format.includes("actionlabels"),
114
111
  snapshot: format.includes("snapshot"),
112
+ constrained: format.includes("constrained"),
113
+ stuttering: format.includes("stuttering"),
114
+ strict: format.includes("strict"),
115
115
  };
116
116
  };
117
117
 
118
- const printInitialStatesProgress = (printer: MessagePrinter, count: number) =>
119
- printer.print(
120
- MESSAGE_CODE.computingInitProgress,
121
- MESSAGE_LEVEL.none,
122
- `Computed ${count} initial states...`,
123
- );
124
-
125
- const getInitialViolationHeadline = (
126
- status: InitialStateViolation["status"],
127
- name: string | undefined,
128
- ) =>
129
- status === "invariant-violation"
130
- ? {
131
- code: MESSAGE_CODE.invariantViolatedInitial,
132
- text: `Invariant ${name} is violated by the initial state:`,
133
- }
134
- : {
135
- code: MESSAGE_CODE.propertyViolatedInitial,
136
- text: `Property ${name} is violated by the initial state:`,
137
- };
138
-
139
- // What the spec prints as TLC rebuilds a trace, before it prints the states or after.
140
- const printTraceOutput = (printer: MessagePrinter, lines: OutputLine[] | undefined) =>
141
- lines?.forEach((line) => {
142
- if (typeof line === "string") return console.log(line);
143
- if (line.kind === "initial-states-progress") {
144
- return printInitialStatesProgress(printer, line.count);
145
- }
146
- const headline = getInitialViolationHeadline(line.status, line.name);
147
- printer.print(
148
- headline.code,
149
- MESSAGE_LEVEL.error,
150
- `${headline.text}\n${formatState(line.state)}`,
151
- );
152
- });
153
-
154
- const printTrace = (
155
- printer: MessagePrinter,
156
- trace: TraceStep[],
157
- heading: { code: number; text: string } = {
158
- code: MESSAGE_CODE.behaviorUpToThisPoint,
159
- text: "The behavior up to this point is:",
160
- },
161
- isRebuiltAfterHeading = false,
162
- ) => {
163
- if (trace.length > 0) printer.print(heading.code, MESSAGE_LEVEL.error, heading.text);
164
- trace.forEach((step, index) => {
165
- if (index > 0 || isRebuiltAfterHeading) printTraceOutput(printer, step.output);
166
- printer.print(
167
- MESSAGE_CODE.statePrint2,
168
- MESSAGE_LEVEL.state,
169
- `${index + 1}: <${step.label ?? step.action ?? "Initial predicate"}>\n${formatState(step.state)}`,
170
- );
171
- });
172
- };
173
-
174
- const COUNTER_EXAMPLE = {
175
- code: MESSAGE_CODE.counterExample,
176
- text: "The following behavior constitutes a counter-example:\n",
177
- };
178
-
179
- // TLC 1.7.4 doesn't name the properties, and later versions name none when they can't tell which.
180
- const getTemporalHeadline = (names: string[], version: TlcVersion) =>
181
- version === "1.7.4" || names.length === 0
182
- ? "Temporal properties were violated.\n"
183
- : names.length === 1
184
- ? `Temporal property ${names[0]} was violated.\n`
185
- : `Temporal properties ${names.slice(0, -1).join(", ")}${names.length > 2 ? "," : ""} and ${names[names.length - 1]} were violated.\n`;
186
-
187
- // TLC's FingerprintException#getTrace: the range of each source, innermost first, skipping a
188
- // source the same as the one inside it.
189
- const formatFingerprintTrace = (sources: Expression[]) =>
190
- sources
191
- .filter((source, index) => source !== sources[index - 1])
192
- .map((source, index) => `${index}) ${describeRange(source)}\n`)
193
- .toReversed()
194
- .join("");
195
-
196
- // TLC's CallStack.toString: the range of each expression, skipping an expression that it evaluates
197
- // again right inside itself.
198
- const formatCallStack = (expressions: Expression[]) => {
199
- if (expressions.length === 0) return " The error call stack is empty.\n";
200
- const lines: string[] = [];
201
- expressions.forEach((expression, index) => {
202
- const range = expression.location.range;
203
- if (expression === expressions[index - 1] || !range) return;
204
- lines.push(
205
- `${lines.length}. Line ${range.start.line}, column ${range.start.column} to line ${range.end.line}, column ${range.end.column} in ${range.module}\n`,
206
- );
207
- });
208
- return `${lines.join("")}\n`;
209
- };
210
-
211
- const printInitialStates = (printer: MessagePrinter, initialStates: InitialStates) => {
212
- const generated = initialStates.generated;
213
- const distinct = initialStates.distinct;
214
- const date = formatTlcDate(new Date());
215
- if (generated === distinct) {
216
- printer.print(
217
- MESSAGE_CODE.initGenerated1,
218
- MESSAGE_LEVEL.none,
219
- `Finished computing initial states: ${distinct} distinct state${distinct === 1 ? "" : "s"} generated at ${date}.`,
220
- );
221
- return;
222
- }
223
- printer.print(
224
- MESSAGE_CODE.initGenerated2,
225
- MESSAGE_LEVEL.none,
226
- `Finished computing initial states: ${generated} state${generated === 1 ? "" : "s"} generated, with ${distinct} of them distinct at ${date}.`,
227
- );
228
- };
229
-
230
- interface Timing {
231
- startTime: number;
232
- // Whether TLC has printed that SANY finished.
233
- isParsed: boolean;
234
- livenessStartTime: number | undefined;
235
- }
236
-
237
- // TLC reports a depth of at least 1, even before it finds a state, and rates a minute only once the
238
- // search has started.
239
- const printProgress = (
240
- printer: MessagePrinter,
241
- statistics: SearchStatistics,
242
- startTime?: number,
243
- ) => {
244
- const minutes = Math.max(Date.now() - (startTime ?? 0), 1) / 60_000;
245
- const formatCount = (count: number) => count.toLocaleString("en-US");
246
- const getRate = (count: number, unit: string) =>
247
- startTime === undefined ? "" : ` (${formatCount(Math.floor(count / minutes))} ${unit}/min)`;
248
- printer.print(
249
- MESSAGE_CODE.progress,
250
- MESSAGE_LEVEL.none,
251
- `Progress(${Math.max(statistics.depth, 1)}) at ${formatTlcDate(new Date())}: ${formatCount(statistics.generatedStates)} states generated${getRate(statistics.generatedStates, "s")}, ${formatCount(statistics.distinctStates)} distinct states found${getRate(statistics.distinctStates, "ds")}, ${formatCount(statistics.queuedStates)} states left on queue.`,
252
- );
253
- };
254
-
255
- const getClassPath = (directory: string, module: string) => join(directory, `${module}.class`);
256
-
257
- const printCheckProgress = (
258
- printer: MessagePrinter,
259
- progress: CheckProgress,
260
- timing: Timing,
261
- directory: string,
262
- ) => {
263
- const print = printer.print;
264
- switch (progress.kind) {
265
- case "parsed":
266
- timing.isParsed = true;
267
- if (printer.isTool) print(MESSAGE_CODE.sanyFinished, MESSAGE_LEVEL.none, "SANY finished.");
268
- print(
269
- MESSAGE_CODE.starting,
270
- MESSAGE_LEVEL.none,
271
- `Starting... (${formatTlcDate(new Date())})`,
272
- );
273
- return;
274
- // TLC 1.7.4 warns about neither a constant-level invariant nor a state-level property.
275
- case "constant-level-invariant":
276
- if (printer.version === "1.7.4") return;
277
- print(
278
- MESSAGE_CODE.constantLevelInvariant,
279
- MESSAGE_LEVEL.warning,
280
- `The invariant ${progress.name} is a constant-level formula (i.e., it contains no variables, primes, or temporal operators) and evaluates to TRUE. To assert constant-level formulas in your spec, use ASSUME ConstInv. If you optionally want to give the assumption a name, write ASSUME YourAssumption == ConstInv instead. See https://explain.tlapl.us/assumptions-and-invariants for additional details.`,
281
- );
282
- return;
283
- case "state-level-property":
284
- if (printer.version === "1.7.4") return;
285
- print(
286
- MESSAGE_CODE.stateLevelProperty,
287
- MESSAGE_LEVEL.warning,
288
- `The formula ${progress.name} is a state-level formula, but it was used as a PROPERTY (or PROPERTIES), where a temporal formula is typically expected. State-level formulas used as PROPERTY or PROPERTIES are only checked in the initial state. To verify that the formula ${progress.name} holds in all states of every behavior, use INVARIANT ${progress.name} instead. Alternatively, applying the "always" temporal operator ([]) to the state-level formula ${progress.name} changes it into a temporal formula, asserting that ${progress.name} holds in all states of every behavior. See https://explain.tlapl.us/invariants-and-properties for additional details.`,
289
- );
290
- return;
291
- case "liveness-initializing":
292
- if (progress.isSymmetric) {
293
- print(
294
- MESSAGE_CODE.livenessSymmetry,
295
- MESSAGE_LEVEL.warning,
296
- "Declaring symmetry during liveness checking is dangerous. It might cause TLC to miss violations of the stated liveness properties. Please check liveness without symmetry defined.",
297
- );
298
- }
299
- // Only TLC 1.7.4 warns about constraints.
300
- if (progress.isConstrained && printer.version === "1.7.4") {
301
- print(
302
- MESSAGE_CODE.livenessConstraints,
303
- MESSAGE_LEVEL.warning,
304
- "Declaring state or action constraints during liveness checking is dangerous: Please read section 14.3.5 on page 247 of Specifying Systems (https://lamport.azurewebsites.net/tla/book.html) and optionally the discussion at https://discuss.tlapl.us/msg00994.html for more details.",
305
- );
306
- }
307
- return;
308
- case "liveness-prepared":
309
- print(
310
- MESSAGE_CODE.temporalBranches,
311
- MESSAGE_LEVEL.none,
312
- `Implied-temporal checking--satisfiability problem has ${progress.branches} branches.`,
313
- );
314
- return;
315
- case "java-override": {
316
- // Class#getResource, which names the class file TLC loads the override from.
317
- const location = pathToFileURL(resolve(getClassPath(directory, progress.module))).href;
318
- print(
319
- progress.isMatched ? MESSAGE_CODE.javaOverrideLoaded : MESSAGE_CODE.javaOverrideMismatch,
320
- progress.isMatched ? MESSAGE_LEVEL.none : MESSAGE_LEVEL.warning,
321
- `${progress.isMatched ? "Loading" : "Failed to match"} ${progress.operator} operator override from ${location.replace("file:///", "file:/")} with signature: <Java Method: ${progress.signature}>.`,
322
- );
323
- return;
324
- }
325
- case "initial-states-started":
326
- print(MESSAGE_CODE.computingInit, MESSAGE_LEVEL.none, "Computing initial states...");
327
- return;
328
- case "initial-states-progress":
329
- printInitialStatesProgress(printer, progress.count);
330
- return;
331
- case "initial-states-computed":
332
- printInitialStates(printer, progress.initialStates);
333
- return;
334
- case "progress":
335
- printProgress(printer, progress.statistics, timing.startTime);
336
- return;
337
- case "liveness-started": {
338
- timing.livenessStartTime = Date.now();
339
- // TLC reports how far the search got before it checks the complete state graph.
340
- if (progress.isComplete) printProgress(printer, progress.statistics);
341
- const branches = progress.branches > 1 ? `${progress.branches} branches of ` : "";
342
- // TLC counts the states of the behavior graph of each branch, without its tableau nodes.
343
- const states = progress.branches * progress.states;
344
- print(
345
- MESSAGE_CODE.checkingTemporal,
346
- MESSAGE_LEVEL.none,
347
- `Checking ${branches}temporal properties for the ${progress.isComplete ? "complete" : "current"} state space with ${states} total distinct states at (${formatTlcDate(new Date())})`,
348
- );
349
- return;
350
- }
351
- case "liveness-finished":
352
- printLivenessEnd(printer, timing);
353
- return;
354
- case "sequential-fallback":
355
- process.stderr.write(
356
- `Warning: the search created the string ${JSON.stringify(progress.string)}, so tla-ts checks the model again with one worker. Workers agree on the order of strings only when the strings exist before the search.\n`,
357
- );
358
- return;
359
- case "warning":
360
- print(progress.code, MESSAGE_LEVEL.warning, progress.text);
361
- return;
362
- case "violation":
363
- printViolation(progress.status, progress.violation, printer);
364
- }
365
- };
366
-
367
- const printLivenessEnd = (printer: MessagePrinter, timing: Timing) => {
368
- if (timing.livenessStartTime === undefined) return;
369
- printer.print(
370
- MESSAGE_CODE.checkingTemporalEnd,
371
- MESSAGE_LEVEL.none,
372
- `Finished checking temporal properties in ${formatTlcDuration(Date.now() - timing.livenessStartTime)} at ${formatTlcDate(new Date())}`,
373
- );
374
- timing.livenessStartTime = undefined;
375
- };
376
-
377
- // Prints a violation, and returns whether TLC goes on to print the statistics of the search.
378
- const printViolation = (status: CheckStatus, violation: Violation, printer: MessagePrinter) => {
379
- const print = printer.print;
380
- const name = violation.name;
381
- const loopStart = violation.loopStart;
382
- // TLC prints a violation by an initial state without the behavior or the statistics.
383
- const isInitial =
384
- loopStart === undefined &&
385
- violation.trace.length === 1 &&
386
- (status === "invariant-violation" || status === "liveness-violation");
387
- const temporal = {
388
- code: MESSAGE_CODE.temporalPropertyViolated,
389
- text: getTemporalHeadline(violation.properties ?? [name], printer.version),
390
- };
391
- const headline = {
392
- success: undefined,
393
- error: undefined,
394
- "assumption-violation": violation.message
395
- ? {
396
- code: MESSAGE_CODE.assumptionEvaluationError,
397
- text: formatInnerMessage(
398
- MESSAGE_CODE.assumptionEvaluationError,
399
- `Evaluating assumption ${name} failed.\n${violation.message}`,
400
- printer.isTool,
401
- ),
402
- }
403
- : { code: MESSAGE_CODE.assumptionFalse, text: `Assumption ${name} is false.` },
404
- deadlock: { code: MESSAGE_CODE.deadlockReached, text: "Deadlock reached." },
405
- "invariant-violation": isInitial
406
- ? getInitialViolationHeadline("invariant-violation", name)
407
- : { code: MESSAGE_CODE.invariantViolatedBehavior, text: `Invariant ${name} is violated.` },
408
- "property-violation": temporal,
409
- "liveness-violation":
410
- loopStart !== undefined
411
- ? temporal
412
- : isInitial
413
- ? getInitialViolationHeadline("liveness-violation", name)
414
- : {
415
- code: MESSAGE_CODE.actionPropertyViolatedBehavior,
416
- text: `Action property ${name} is violated.`,
417
- },
418
- "postcondition-violation": {
419
- code: violation.postcondition?.code ?? MESSAGE_CODE.general,
420
- text: violation.message ?? `Postcondition ${name} is false.`,
421
- },
422
- }[status];
423
- // A safety property's counterexample ends where it breaks, and a liveness one loops back.
424
- const isProperty = status === "property-violation";
425
- const isLasso = loopStart !== undefined && !isProperty;
426
- const isCounterExample = isProperty || isLasso;
427
- // TLC rebuilds a liveness counterexample before it reports the violation, and 1.7.4's
428
- // LiveWorker#printTrace after it prints the heading of the counterexample.
429
- const isRebuiltFirst = isCounterExample && printer.version !== "1.7.4";
430
- if (isRebuiltFirst) printTraceOutput(printer, violation.trace[0]?.output);
431
- if (violation.counts) console.log(violation.counts);
432
- if (headline) {
433
- // TLC prints the initial state that violates a property in the same message.
434
- const text = isInitial
435
- ? `${headline.text}\n${formatState(violation.trace[0].state)}`
436
- : headline.text;
437
- print(headline.code, MESSAGE_LEVEL.error, text);
438
- }
439
- if (!isInitial) {
440
- if (!isCounterExample) printTraceOutput(printer, violation.trace[0]?.output);
441
- printTrace(
442
- printer,
443
- violation.trace,
444
- isCounterExample ? COUNTER_EXAMPLE : undefined,
445
- isCounterExample && !isRebuiltFirst,
446
- );
447
- printTraceOutput(printer, violation.traceOutput);
448
- }
449
- if (isLasso) {
450
- const label = violation.loopLabel;
451
- if (loopStart === violation.trace.length - 1)
452
- print(MESSAGE_CODE.statePrint3, MESSAGE_LEVEL.state, `${loopStart + 2}: Stuttering`);
453
- else if (printer.isTool)
454
- print(
455
- MESSAGE_CODE.backToState,
456
- MESSAGE_LEVEL.state,
457
- `${loopStart + 1}: Back to state${label ? `: <${label}>\n` : ""}`,
458
- );
459
- else console.log(`Back to state ${loopStart + 1}${label ? `: <${label}>\n` : ""}`);
460
- }
461
- // TLC 1.7.4 doesn't explain a stuttering counterexample.
462
- if (violation.warning && printer.version !== "1.7.4")
463
- print(violation.warning.code, MESSAGE_LEVEL.warning, violation.warning.text);
464
- // TLC checks the postconditions after it prints a counterexample.
465
- const postcondition =
466
- violation.unwitnessed ??
467
- (status === "postcondition-violation" ? undefined : violation.postcondition);
468
- if (postcondition?.counts) console.log(postcondition.counts);
469
- if (postcondition) print(postcondition.code, MESSAGE_LEVEL.error, postcondition.message);
470
- // TLC checks assumptions before it starts the search, so it has no statistics to print.
471
- return !isInitial && status !== "assumption-violation";
472
- };
473
-
474
- const printNestedExpressions = (printer: MessagePrinter, callStack: Expression[]) =>
475
- printer.print(
476
- MESSAGE_CODE.nestedExpression,
477
- MESSAGE_LEVEL.error,
478
- `The error occurred when TLC was evaluating the nested\nexpressions at the following positions:\n${formatCallStack(callStack)}`,
479
- );
480
-
481
- const printResult = (result: CheckResult, printer: MessagePrinter, timing: Timing) => {
482
- const print = printer.print;
483
- if (result.failure) {
484
- const failure = result.failure;
485
- const message = printer.isTool ? failure.toolMessage : failure.message;
486
- const printCallStack = () => {
487
- const fingerprint = failure.fingerprint;
488
- if (fingerprint) {
489
- // TLC prints the call stack when the replay has one, and otherwise the sources of the
490
- // values it failed to fingerprint, innermost first. TLC 1.7.4 always prints the sources.
491
- const trace =
492
- failure.callStack?.length && printer.version !== "1.7.4"
493
- ? formatCallStack(failure.callStack)
494
- : formatFingerprintTrace(fingerprint.sources);
495
- print(
496
- MESSAGE_CODE.fingerprintFailed,
497
- MESSAGE_LEVEL.error,
498
- `TLC was unable to fingerprint.\n\nFingerprint Stack Trace:\n${trace}\nReason:\n${formatNestedMessage(fingerprint.reason, printer.isTool)}`,
499
- );
500
- return;
501
- }
502
- if (failure.callStack) printNestedExpressions(printer, failure.callStack);
503
- };
504
- if (failure.isCallStackFirst) printCallStack();
505
- // TLC prints the state as it reports the error, so a state it can't print fails outside the
506
- // checker, which TLC reports as an exception it did not expect.
507
- const initialState =
508
- failure.initialState &&
509
- (() => {
510
- try {
511
- return `While working on the initial state:\n${formatState(failure.initialState)}`;
512
- } catch (error) {
513
- if (!(error instanceof TlaEvaluationError)) throw error;
514
- throw setExitCode(
515
- new TlaEvaluationError(`${UNEXPECTED_EXCEPTION}${error.message}`),
516
- EXIT_STATUS.error,
517
- );
518
- }
519
- })();
520
- // TLC prints an error on an initial state and the state as one message.
521
- print(
522
- initialState ? MESSAGE_CODE.initialState : failure.code,
523
- MESSAGE_LEVEL.error,
524
- initialState ? `${message}\n${initialState}` : message,
525
- );
526
- printTraceOutput(printer, failure.trace[0]?.output);
527
- printTrace(printer, failure.trace);
528
- const traceFailure = failure.traceFailure;
529
- if (traceFailure) {
530
- print(
531
- traceFailure.code,
532
- MESSAGE_LEVEL.error,
533
- printer.isTool ? traceFailure.toolMessage : traceFailure.message,
534
- );
535
- }
536
- printTraceOutput(printer, failure.traceOutput);
537
- const postcondition = failure.postcondition;
538
- if (postcondition?.counts) console.log(postcondition.counts);
539
- if (postcondition) print(postcondition.code, MESSAGE_LEVEL.error, postcondition.message);
540
- if (!failure.isCallStackFirst) printCallStack();
541
- } else if (result.violation) {
542
- if (!printViolation(result.status, result.violation, printer)) return;
543
- // TLC adds a deadlocked state to the behavior graph after it reports the deadlock, which can
544
- // violate a temporal property too.
545
- const additionalViolation = result.additionalViolation;
546
- if (additionalViolation) printViolation("property-violation", additionalViolation, printer);
547
- if (result.liveCallStack) printNestedExpressions(printer, result.liveCallStack);
548
- } else {
549
- printLivenessEnd(printer, timing);
550
- const optimistic = getOptimisticProbability(result.distinctStates, result.generatedStates);
551
- const actual =
552
- result.fingerprintDistance === undefined
553
- ? []
554
- : [
555
- ` based on the actual fingerprints: val = ${formatProbability(getActualProbability(result.fingerprintDistance))}`,
556
- ];
557
- print(
558
- MESSAGE_CODE.success,
559
- MESSAGE_LEVEL.none,
560
- [
561
- "Model checking completed. No error has been found.",
562
- " Estimates of the probability that TLC did not check all reachable states",
563
- " because two distinct states had the same fingerprint:",
564
- ` calculated (optimistic): val = ${formatProbability(optimistic)}`,
565
- ...actual,
566
- ].join("\n"),
567
- );
568
- }
569
- if (result.failure?.isWithoutStatistics) return;
570
- if (result.status !== "success") printLivenessEnd(printer, timing);
571
- if (printer.isTool) printProgress(printer, result, timing.startTime);
572
- print(
573
- MESSAGE_CODE.stats,
574
- MESSAGE_LEVEL.none,
575
- `${result.generatedStates} states generated, ${result.distinctStates} distinct states found, ${result.queuedStates} states left on queue.`,
576
- );
577
- // ModelChecker#printSummary prints the depth, which TLC 1.7.4 prints only after a search it
578
- // reports as successful, and as at least 1, and then the outdegree of a successful search.
579
- const is174 = printer.version === "1.7.4";
580
- const outDegrees = is174 ? (result.outDegrees ?? result.violationOutDegrees) : result.outDegrees;
581
- if (!is174 || outDegrees) {
582
- print(
583
- MESSAGE_CODE.searchDepth,
584
- MESSAGE_LEVEL.none,
585
- `The depth of the complete state graph search is ${is174 ? Math.max(result.depth, 1) : result.depth}.`,
586
- );
587
- }
588
- const outDegree = outDegrees && getOutDegreeSummary(outDegrees);
589
- if (outDegree) print(MESSAGE_CODE.stateGraphOutdegree, MESSAGE_LEVEL.none, outDegree);
590
- };
591
-
592
- // Java's Files.createTempDirectory names a directory by a random unsigned long. tla-ts derives it
593
- // from TLC's fingerprint of what the directory holds, so that each run of a spec prints the same
594
- // files.
118
+ // Deviation from TLC: Java names the directory by a random unsigned long, and tla-ts by what the directory holds, so that each run of a spec prints the same files.
595
119
  const getTemporaryName = (contents: string) => getTlcFingerprint([contents]).toString();
596
120
 
597
- // The file TLC's SANY says it parses each module from: the real path of a module's own file, or a
598
- // copy in a temporary directory of a module from the root module's file or from the jar on the
599
- // class path, followed by where TLC copied it from.
600
121
  const createFileDescriber = (
601
122
  specPath: string,
602
123
  directories: string[],
@@ -611,9 +132,7 @@ const createFileDescriber = (
611
132
  return (name: string, origin: SanyModuleOrigin) => {
612
133
  const fileName = `${name}.tla`;
613
134
  if (origin === "file") return realpathSync(findModuleFile(directories, name) ?? specPath);
614
- // TLC 1.7.4 copies a standard module into the temporary directory itself.
615
135
  if (version === "1.7.4") return join(temporaryDirectory, fileName);
616
- // FileUtil.createTempFile copies a module from the root module's file into the -metadir.
617
136
  if (origin === "root file") {
618
137
  const directory = metadir === undefined ? temporaryDirectory : resolve(metadir);
619
138
  const root = realpathSync(specPath);
@@ -624,100 +143,123 @@ const createFileDescriber = (
624
143
  };
625
144
  };
626
145
 
627
- const printWelcome = (printer: MessagePrinter) =>
628
- printer.print(MESSAGE_CODE.version, MESSAGE_LEVEL.none, `TLC2 Version ${version} (rev: tla-ts)`);
629
-
630
- // TLC.printErrorMsg: TLC says which version it is, then why it can't read its options.
631
- const printCommandLineError = (printer: MessagePrinter, message: string) => {
632
- printWelcome(printer);
633
- printer.print(
634
- MESSAGE_CODE.commandLineError,
635
- MESSAGE_LEVEL.error,
636
- `${message}\nUsage: java tlc2.TLC [-help] [-option] inputfile`,
146
+ const getEmbeddedConfig = (contents: string, name: string) => {
147
+ const lines = contents.split(/\r?\n/);
148
+ const start = lines.findIndex(
149
+ (line) => line.match(/^-----*\s*CONFIG\s+(\S+?)\s*-----*$/)?.[1] === name,
637
150
  );
638
- return 1;
151
+ if (start === -1) return "\n";
152
+ const end = lines.findIndex((line, index) => index > start && line.startsWith("===="));
153
+ return `${lines
154
+ .slice(start + 1, end === -1 ? undefined : end)
155
+ .join("\n")
156
+ .trim()}\n`;
639
157
  };
640
158
 
641
- // TLC.printStartupBanner, with what runs tla-ts in place of the JVM. tla-ts keeps its fingerprints
642
- // and its queue of states in memory.
643
- const printStartupBanner = (printer: MessagePrinter, seed: string, workers: number) =>
644
- printer.print(
645
- MESSAGE_CODE.modelChecking,
646
- MESSAGE_LEVEL.none,
647
- `Running breadth-first search Model-Checking with fp 0 and seed ${BigInt(seed)} with ${workers} worker${workers === 1 ? "" : "s"} on ${availableParallelism()} cores with ${Math.floor(getHeapStatistics().heap_size_limit / 1024 / 1024)}MB heap and 0MB offheap memory [pid: ${process.pid}] (${type()} ${release()} ${arch()}, Node.js ${process.versions.node} ${process.arch.endsWith("64") ? 64 : 32}bit, MemFPSet, MemStateQueue).`,
648
- );
159
+ const getJavaPath = (path: string) => path.replace(/\/+/g, "/").replace(/(.)\/$/, "$1");
160
+
161
+ const getJavaParent = (path: string) => {
162
+ const normalized = getJavaPath(path);
163
+ const separator = normalized.lastIndexOf("/");
164
+ return separator === -1 ? "." : normalized.slice(0, Math.max(separator, 1));
165
+ };
166
+
167
+ const resolveJavaPath = (directory: string, name: string) =>
168
+ directory.endsWith("/") ? `${directory}${name}` : `${directory}/${name}`;
169
+
170
+ const getTraceSpecLocation = (
171
+ args: TlcArguments,
172
+ version: TlcVersion,
173
+ mainFile: string,
174
+ startTime: number,
175
+ ) => {
176
+ const isGenerated =
177
+ version !== "1.7.4" &&
178
+ (args.isTraceSpecForced ||
179
+ (!args.isTraceSpecDisabled &&
180
+ !args.isTool &&
181
+ !args.isContinued &&
182
+ !basename(mainFile).includes("_TTrace")));
183
+ if (!isGenerated) return undefined;
184
+ const output = args.traceSpecPath;
185
+ const module = `${basename(mainFile)}_TTrace_${Math.floor(startTime / 1000)}`;
186
+ const location =
187
+ output === undefined
188
+ ? { directory: getJavaParent(mainFile), module }
189
+ : output.toLowerCase().endsWith(".tla")
190
+ ? { directory: getJavaParent(output), module: basename(output).replace(/\.tla$/, "") }
191
+ : { directory: getJavaPath(output), module };
192
+ return {
193
+ ...location,
194
+ traceFile: args.isTraceBinaryDisabled
195
+ ? undefined
196
+ : resolveJavaPath(location.directory, `${location.module}.bin`),
197
+ };
198
+ };
199
+
200
+ const JAVA_FILE_ERRORS: Record<string, string> = {
201
+ ENOENT: "No such file or directory",
202
+ ENOTDIR: "Not a directory",
203
+ EISDIR: "Is a directory",
204
+ EACCES: "Permission denied",
205
+ };
649
206
 
650
- // TLC loads Integers for the binary trace that its trace exploration spec records. -generateSpecTE
651
- // turns the spec on, and -tool, -continue, -noGenerateSpecTE and -noTE turn it off, as
652
- // -noGenerateSpecTEBin and -noTEBin turn off the binary trace. TLC 1.7.4 records no such trace.
653
- const isTraceRecorded = (args: ParsedArgs, version: TlcVersion) => {
654
- const flags = [...args.unknown, ...args.options.map((option) => option.name)];
655
- const hasFlag = (name: string, alias = name) =>
656
- flags.some((flag) => flag === name || flag.toLowerCase() === alias.toLowerCase());
657
- const isSpecGenerated =
658
- hasFlag("-generateSpecTE") ||
659
- (!hasFlag("-noGenerateSpecTE", "-noTE") && !hasFlag("-tool") && !hasFlag("-continue"));
660
- return version !== "1.7.4" && isSpecGenerated && !hasFlag("-noGenerateSpecTEBin", "-noTEBin");
207
+ const writeJavaFile = (path: string, content: string | Uint8Array) => {
208
+ try {
209
+ writeFileSync(path, content);
210
+ } catch (error) {
211
+ const reason =
212
+ error instanceof Error && "code" in error ? JAVA_FILE_ERRORS[String(error.code)] : undefined;
213
+ if (reason === undefined) throw error;
214
+ throw new TlaEvaluationError(`${path} (${reason})`);
215
+ }
216
+ };
217
+
218
+ // Java's File#mkdirs reports a failure only through its result, which TLC ignores.
219
+ const makeJavaDirectory = (path: string) => {
220
+ try {
221
+ mkdirSync(path, { recursive: true });
222
+ } catch {}
223
+ };
224
+
225
+ const createMetadir = (args: TlcArguments) => {
226
+ const now = new Date();
227
+ const name = `${zeroPad(now.getFullYear() % 100)}-${zeroPad(now.getMonth() + 1)}-${zeroPad(now.getDate())}-${zeroPad(now.getHours())}-${zeroPad(now.getMinutes())}-${zeroPad(now.getSeconds())}.${zeroPad(now.getMilliseconds(), 3)}`;
228
+ const directory = join(args.metadir ?? "states", name);
229
+ mkdirSync(directory, { recursive: true });
230
+ return directory;
661
231
  };
662
232
 
663
233
  const checkSpec = async (
664
234
  specPath: string,
665
- args: ParsedArgs,
235
+ args: TlcArguments,
236
+ dump: StateDump | undefined,
666
237
  java: JavaProperties,
667
238
  printer: MessagePrinter,
668
239
  ) => {
669
- // TLC.handleParameters: TLC reads its options before it says which version it is.
670
- const seed = args.has("-seed") ? args.get("-seed")?.[0] : "0";
671
- if (seed === undefined) return printCommandLineError(printer, "Error: seed required.");
672
- if (!isJavaLong(seed)) {
673
- return printCommandLineError(
674
- printer,
675
- `Error: An integer for seed required. But encountered ${seed}`,
676
- );
677
- }
678
- const livenessCheck = args.has("-lncheck") ? args.get("-lncheck")?.[0]?.toLowerCase() : "default";
679
- if (livenessCheck === undefined) {
680
- return printCommandLineError(
681
- printer,
682
- "Error: expect a strategy such as final for -lncheck option.",
683
- );
684
- }
685
- const dumpValues = args.get("-dump");
686
- if (dumpValues?.length === 0) {
687
- return printCommandLineError(printer, "Error: A file name for dumping states required.");
688
- }
689
- const unsupportedFormat =
690
- dumpValues?.length === 2 &&
691
- UNSUPPORTED_DUMP_FORMATS.find((format) => dumpValues[0].toLowerCase().includes(format));
692
- if (unsupportedFormat) {
693
- console.error(`Error: tla-ts does not support the -dump format ${unsupportedFormat}.`);
694
- return 1;
695
- }
696
- const fingerprintIndex = args.get("-fp")?.[0];
697
- if (fingerprintIndex !== undefined && Number(fingerprintIndex) !== 0) {
698
- console.error(
699
- `Error: tla-ts fingerprints states as TLC does with -fp 0, not -fp ${fingerprintIndex}.`,
700
- );
701
- return 1;
702
- }
703
- const workers = getWorkerCount(args.get("-workers"));
240
+ const livenessCheck = args.livenessCheck;
704
241
  const version = printer.version;
705
242
  printWelcome(printer);
706
- printStartupBanner(printer, seed, workers);
707
- const configPath =
708
- args.get("-config")?.[0] ??
709
- (args.has("-config") ? undefined : specPath.replace(/\.tla$/, ".cfg"));
710
- if (!configPath || !existsSync(configPath)) {
243
+ const recoverDirectory = args.recoverDirectory;
244
+ if (recoverDirectory !== undefined) {
245
+ throw existsSync(join(recoverDirectory, "vars.chkpt"))
246
+ ? new TlaFeatureUnsupportedError(
247
+ `tla-ts can't recover a model check from the checkpoint in ${recoverDirectory}.`,
248
+ )
249
+ : new TlaMissingCheckpointError(recoverDirectory);
250
+ }
251
+ printStartupBanner(printer, args);
252
+ const configPath = args.configPath ?? specPath.replace(/\.tla$/, ".cfg");
253
+ if (!existsSync(configPath)) {
711
254
  printer.print(
712
255
  MESSAGE_CODE.configFileError,
713
256
  MESSAGE_LEVEL.error,
714
- `TLC encountered the following error when trying to read the configuration file ${configPath ?? ""}:\nFile not found.`,
257
+ `TLC encountered the following error when trying to read the configuration file ${configPath}:\nFile not found.`,
715
258
  );
716
259
  return EXIT_STATUS.configParseError;
717
260
  }
718
261
  const fileName = basename(specPath, ".tla");
719
262
  const timing: Timing = { startTime: Date.now(), livenessStartTime: undefined, isParsed: false };
720
- // Without -tool, TLC prints how long it ran for a person to read.
721
263
  const printFinished = () => {
722
264
  const runtime = Date.now() - timing.startTime;
723
265
  printer.print(
@@ -732,7 +274,6 @@ const checkSpec = async (
732
274
  MESSAGE_LEVEL.error,
733
275
  "Parsing or semantic analysis failed.",
734
276
  );
735
- // TLC prints how long it ran even when it stops at an error.
736
277
  const printFailure = (error: TlaError) => {
737
278
  if (error instanceof TlaSyntaxError) {
738
279
  printParsingFailed();
@@ -740,19 +281,22 @@ const checkSpec = async (
740
281
  printError(error, printer);
741
282
  }
742
283
  printFinished();
743
- return getErrorExitCode(error);
284
+ return getTopLevelExitCode(error);
744
285
  };
745
- // TLC reads the configuration file before it parses the spec, and prints how long it ran even
746
- // when it can't read it.
747
286
  const config = (() => {
748
287
  try {
749
- return parseConfig(readFileSync(configPath, "utf8"), version);
288
+ const contents = readFileSync(configPath, "utf8");
289
+ return parseConfig(
290
+ configPath.endsWith(".tla")
291
+ ? getEmbeddedConfig(contents, configPath.replaceAll(".tla", ""))
292
+ : contents,
293
+ version,
294
+ );
750
295
  } catch (error) {
751
296
  if (!(error instanceof TlaConfigError)) throw error;
752
297
  return error;
753
298
  }
754
299
  })();
755
- // TLC 1.7.4 reports a configuration file it can't parse as an exception it didn't expect.
756
300
  if (config instanceof TlaConfigError && version === "1.7.4") {
757
301
  printer.print(
758
302
  MESSAGE_CODE.general,
@@ -763,17 +307,23 @@ const checkSpec = async (
763
307
  return EXIT_STATUS.error;
764
308
  }
765
309
  if (config instanceof TlaConfigError) return printFailure(config);
766
- if (args.has("-deadlock")) config.checkDeadlock = false;
310
+ if (!args.isDeadlockChecked) config.checkDeadlock = false;
767
311
  const directory = dirname(specPath);
768
312
  const directories = [directory, ...java.libraries];
769
313
  const loadModule = createModuleLoader(directories);
770
- const isRecorded = isTraceRecorded(args, version);
314
+ const traceSpec = getTraceSpecLocation(
315
+ args,
316
+ version,
317
+ specPath.replace(/\.tla$/, ""),
318
+ timing.startTime,
319
+ );
320
+ const getOperatorModules = (kind: ModuleOperator["kind"]) =>
321
+ args.moduleOperators
322
+ .filter((operator) => operator.kind === kind)
323
+ .map((operator) => operator.module);
771
324
  if (printer.isTool) {
772
325
  printer.print(MESSAGE_CODE.startingSany, MESSAGE_LEVEL.none, "Starting SANY...");
773
326
  }
774
- // TLC.handleParameters: SANY names the spec as TLC's arguments do, except that TLC runs from the
775
- // directory of a spec given by an absolute path, and names it by its file name. SANY looks for
776
- // the spec's modules in the spec's directory and the TLA-Library directories.
777
327
  const isAbsoluteSpec = isAbsolute(specPath);
778
328
  const specName = isAbsoluteSpec ? fileName : specPath.replace(/\.tla$/, "");
779
329
  const jar = getToolsJar(java);
@@ -790,27 +340,28 @@ const checkSpec = async (
790
340
  [...(isAbsoluteSpec || directory === "." ? [] : [directory]), ...java.libraries],
791
341
  );
792
342
  }
793
- // TLC prints what SANY prints as it parses the spec, and the errors it rejects the spec for.
794
343
  const sany = getSanyReport(
795
344
  specPath,
796
345
  reportMissingFile ? reportMissingModules174(loadModule, reportMissingFile) : loadModule,
797
346
  {
798
347
  fileName: specName,
799
- describeFile: createFileDescriber(
800
- specPath,
801
- directories,
802
- java,
803
- args.get("-metadir")?.[0],
804
- version,
805
- ),
348
+ describeFile: createFileDescriber(specPath, directories, java, args.metadir, version),
806
349
  version,
807
- // TLC's trace exploration spec records the trace with the post condition of _TLCTrace.
808
- rootExtendees: isRecorded ? ["_TLCTrace"] : undefined,
350
+ rootExtendees: [
351
+ ...getOperatorModules("postcondition"),
352
+ ...(traceSpec?.traceFile === undefined ? [] : ["_TLCTrace"]),
353
+ ...args.invariants.flatMap((invariant) => invariant.modules),
354
+ ...getOperatorModules("constraint"),
355
+ ...getOperatorModules("view").slice(0, 1),
356
+ ],
357
+ suppressedCodes: args.suppressedCodes,
358
+ errorCodes: args.errorCodes,
809
359
  onPrint: (text) => process.stdout.write(text),
810
360
  onPrintError: (text) => process.stderr.write(text),
811
361
  },
812
362
  );
813
- if (sany.isFailed) {
363
+ const specification = sany.specification;
364
+ if (sany.isFailed || specification === undefined) {
814
365
  printCheckProgress(printer, { kind: "parsed" }, timing, directory);
815
366
  printParsingFailed();
816
367
  printFinished();
@@ -825,34 +376,101 @@ const checkSpec = async (
825
376
  undefined,
826
377
  );
827
378
  }
828
- const result = await check({
829
- workers,
830
- livenessCheck: ["final", "seqfinal", "off"].includes(livenessCheck) ? "final" : "default",
831
- seed: BigInt(seed),
832
- dump: dumpValues && getStateDump(dumpValues),
379
+ const userFile = args.userFile;
380
+ const standardModules = getSanyStandardModules(version);
381
+ const invariants = addRuntimeInvariants(
382
+ source,
383
+ specification.root,
384
+ args.invariants,
385
+ (name) => loadModule(name) ?? standardModules.get(name) ?? extractModule(source, name),
386
+ version,
387
+ );
388
+ config.invariants.push(...invariants.names);
389
+ const options: CheckOptions & StandardInput = {
390
+ workers: args.workers,
391
+ livenessCheck:
392
+ livenessCheck === "off"
393
+ ? "off"
394
+ : ["final", "seqfinal"].includes(livenessCheck)
395
+ ? "final"
396
+ : "default",
397
+ seed: args.seed,
398
+ fingerprintPolynomial: args.fingerprintIndex,
399
+ maxSetSize: args.maxSetSize,
400
+ isLazyValueExpanded: args.isLazyValueExpanded,
401
+ isViewPrinted: args.isViewPrinted,
402
+ dump,
833
403
  isTool: printer.isTool,
834
- isContinued: args.has("-continue"),
835
- isTraceRecorded: isRecorded,
404
+ isContinued: args.isContinued,
405
+ moduleOperators: args.moduleOperators,
406
+ traceSpec,
407
+ coverage: args.coverage,
836
408
  isSanyReported: true,
837
- isWarningEnabled: !args.has("-nowarning"),
409
+ isWarningEnabled: args.isWarningEnabled,
838
410
  version,
839
411
  onProgress: (progress) => printCheckProgress(printer, progress, timing, directory),
840
- source,
412
+ onPrint: userFile === undefined ? undefined : (text) => appendFileSync(userFile, `${text}\n`),
413
+ source: invariants.source,
841
414
  config,
842
415
  onPause: () => readSync(0, Buffer.alloc(1)),
416
+ readLine: readStandardInputLine,
843
417
  loadModule,
844
418
  loadClass: (name) => {
845
419
  const classPath = getClassPath(directory, name);
846
420
  return existsSync(classPath) ? readFileSync(classPath) : undefined;
847
421
  },
848
- readFile: (path) => (existsSync(path) ? readFileSync(path, "utf8") : undefined),
849
- writeFile: (path, content) => {
850
- mkdirSync(dirname(resolve(path)), { recursive: true });
851
- writeFileSync(path, content);
422
+ readFile: (path) => {
423
+ checkNotDirectory(path);
424
+ return existsSync(path) ? readFileSync(path, "utf8") : undefined;
852
425
  },
853
- });
426
+ writeFile: writeJavaFile,
427
+ makeDirectory: makeJavaDirectory,
428
+ };
429
+ if (args.mode !== "model-check") {
430
+ const status = simulate({
431
+ ...options,
432
+ traceDepth: args.traceDepth,
433
+ traceCount: args.traceCount,
434
+ aril: args.aril,
435
+ isGenerating: args.mode === "generate",
436
+ scheduler: args.scheduler,
437
+ onSimulation: (output) => printSimulation(printer, output),
438
+ });
439
+ printFinished();
440
+ return status;
441
+ }
442
+ if (args.dfidDepth !== undefined) {
443
+ const status = checkDepthFirst({
444
+ ...options,
445
+ maxDepth: args.dfidDepth,
446
+ onOutput: (output) => printDepthFirst(printer, output),
447
+ });
448
+ printFinished();
449
+ return status;
450
+ }
451
+ const result = await check(options);
854
452
  printResult(result, printer, timing);
855
453
  printFinished();
454
+ if (traceSpec && result.traceSpec !== undefined) {
455
+ const path = resolveJavaPath(traceSpec.directory, `${traceSpec.module}.tla`);
456
+ makeJavaDirectory(traceSpec.directory);
457
+ const failure = (() => {
458
+ try {
459
+ writeJavaFile(path, result.traceSpec);
460
+ return undefined;
461
+ } catch (error) {
462
+ if (!(error instanceof TlaEvaluationError)) throw error;
463
+ return error;
464
+ }
465
+ })();
466
+ printer.print(
467
+ failure ? MESSAGE_CODE.traceSpecFailed : MESSAGE_CODE.traceSpecWritten,
468
+ MESSAGE_LEVEL.none,
469
+ failure
470
+ ? `Failed to generate trace exploration spec; error message: ${failure.message}`
471
+ : `Trace exploration spec path: ${path}`,
472
+ );
473
+ }
856
474
  return result.failure?.exitCode ?? EXIT_CODES[result.status];
857
475
  } catch (error) {
858
476
  if (!(error instanceof TlaError)) throw error;
@@ -862,8 +480,18 @@ const checkSpec = async (
862
480
  }
863
481
  };
864
482
 
865
- // What SANY prints about a spec it rejects: a module it can't find or parse is a fatal error, and
866
- // it reports the other errors as semantic errors.
483
+ const readStandardInputLine = () => {
484
+ const bytes: number[] = [];
485
+ const byte = Buffer.alloc(1);
486
+ let isRead = false;
487
+ while (readSync(0, byte) === 1) {
488
+ isRead = true;
489
+ if (byte[0] === 0x0a) break;
490
+ bytes.push(byte[0]);
491
+ }
492
+ return isRead ? Buffer.from(bytes).toString().replace(/\r$/, "") : undefined;
493
+ };
494
+
867
495
  const formatSanyErrors = (error: TlaSyntaxError, specName: string) => {
868
496
  const isFatal = error instanceof TlaSanyFatalError;
869
497
  if (!isFatal && !error.failure)
@@ -878,60 +506,97 @@ const formatSanyErrors = (error: TlaSyntaxError, specName: string) => {
878
506
  };
879
507
 
880
508
  export const checkSpecs = async (args: string[], java: JavaProperties) => {
881
- const parsed = CHECK_COMMAND.parse(args);
882
- const inputs = getInputPaths(parsed.positionals);
883
- const isConfigured = parsed.has("-config");
884
- // Like TLC, a spec named without an extension is the .tla file of that name. A glob also matches
885
- // modules that only other specs import, which have no configuration.
509
+ const version = java.tlcVersion ?? "master";
510
+ const parsed = parseTlcArguments(args);
511
+ if (parsed === "usage") {
512
+ console.log(getTlcUsage());
513
+ return 1;
514
+ }
515
+ if ("error" in parsed) {
516
+ if (parsed.kind === "uncaught") {
517
+ console.error(`Exception in thread "main" ${parsed.error}`);
518
+ return 1;
519
+ }
520
+ return printCommandLineError(parsed.isTool, version, parsed.error);
521
+ }
522
+ const dump = parsed.dump && getStateDump(parsed.dump);
523
+ if (dump?.path.startsWith("${metadir}")) {
524
+ dump.path = dump.path.replaceAll("${metadir}", createMetadir(parsed));
525
+ }
526
+ const dumpPath = dump?.path;
527
+ if (dumpPath !== undefined) {
528
+ try {
529
+ closeSync(openSync(dumpPath, "w"));
530
+ } catch {
531
+ console.log(`Error: Unable to write to file ${dumpPath}`);
532
+ return printCommandLineError(
533
+ parsed.isTool,
534
+ version,
535
+ `Error: Given file name ${dumpPath} for dumping states invalid.`,
536
+ );
537
+ }
538
+ }
539
+ const isConfigured = parsed.configPath !== undefined;
540
+ if (isConfigured && parsed.specs.length > 1) {
541
+ return printCommandLineError(
542
+ parsed.isTool,
543
+ version,
544
+ `Error: more than one input files: ${parsed.specs[0].replace(/\.tla$/, "")} and ${parsed.specs[1]}`,
545
+ );
546
+ }
547
+ const inputs = getInputPaths(parsed.specs);
886
548
  const specPaths = inputs
887
549
  .map((input) => ({
888
550
  ...input,
889
551
  path:
890
- input.isGlobbed || /\.(tla|cfg)$/.test(input.path)
552
+ input.isGlobbed || /\.(tla|cfg|ts)$/.test(input.path)
891
553
  ? input.path.replace(/\.cfg$/, ".tla")
892
554
  : `${input.path}.tla`,
893
555
  }))
894
556
  .filter(
895
557
  (input) =>
896
- input.path.endsWith(".tla") &&
897
- (!input.isGlobbed || isConfigured || existsSync(input.path.replace(/\.tla$/, ".cfg"))),
558
+ input.path.endsWith(".ts") ||
559
+ (input.path.endsWith(".tla") &&
560
+ (!input.isGlobbed || isConfigured || existsSync(input.path.replace(/\.tla$/, ".cfg")))),
898
561
  )
899
562
  .map((input) => input.path);
900
563
  if (specPaths.length === 0) {
901
- console.error(USAGE);
902
- return 1;
564
+ return printCommandLineError(parsed.isTool, version, "Error: Missing input TLA+ module.");
903
565
  }
904
566
  if (isConfigured && specPaths.length > 1) {
905
567
  console.error("Error: -config applies to one specification, but several were given.");
906
568
  return 1;
907
569
  }
908
- // TLC also looks for the spec itself in the library directories.
909
570
  const findSpec = (path: string) =>
910
571
  existsSync(path) || isAbsolute(path)
911
572
  ? path
912
573
  : (java.libraries.map((directory) => join(directory, path)).find(existsSync) ?? path);
913
574
  const paths = [...new Set(specPaths.map(findSpec))];
914
- // Each spec is checked as TLC would in a process of its own, so an error in one leaves the others
915
- // to report. The exit code is the first that is not success.
916
575
  const exitCodes: number[] = [];
917
576
  for (const [index, path] of paths.entries()) {
918
577
  if (index > 0) console.log("");
919
- // TLC checks one spec, so tla-ts names each of several it checks.
920
- if (paths.length > 1)
921
- console.log(`Checking ${basename(path)} with ${basename(path, ".tla")}.cfg`);
922
- const printer = createMessagePrinter(
923
- parsed.has("-tool"),
924
- !parsed.has("-nowarning"),
925
- java.tlcVersion ?? "master",
578
+ const printer = createMessagePrinter({
579
+ isTool: parsed.isTool,
580
+ isWarningEnabled: parsed.isWarningEnabled,
581
+ isDiffTrace: parsed.isDiffTrace,
582
+ version,
583
+ suppressedCodes: parsed.suppressedCodes,
584
+ errorCodes: parsed.errorCodes,
585
+ });
586
+ exitCodes.push(
587
+ await reportErrors(async () => {
588
+ const specPath = path.endsWith(".ts") ? await writeTypeScriptSpec(path) : path;
589
+ // Deviation from TLC: TLC checks one spec, so tla-ts names each of several it checks.
590
+ if (paths.length > 1) {
591
+ console.log(`Checking ${basename(specPath)} with ${basename(specPath, ".tla")}.cfg`);
592
+ }
593
+ return checkSpec(specPath, parsed, dump, java, printer);
594
+ }, printer),
926
595
  );
927
- exitCodes.push(await reportErrors(() => checkSpec(path, parsed, java, printer), printer));
928
596
  }
929
597
  return exitCodes.find((exitCode) => exitCode !== EXIT_STATUS.success) ?? EXIT_STATUS.success;
930
598
  };
931
599
 
932
- // TLC 1.7.4's SimpleFilenameToStream looks for a module in the directory of a spec that TLC is
933
- // given by an absolute path, then in the directory that a relative path names, or else in the
934
- // TLA-Library directories.
935
600
  const createMissingFilePrinter174 = (
936
601
  specPath: string,
937
602
  java: JavaProperties,