tla-ts 0.0.3 → 0.0.4-dev.1a3acf6

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 (381) hide show
  1. package/README.md +46 -115
  2. package/dist/cli.cjs +1 -1
  3. package/dist/cli.js +1 -1
  4. package/dist/deciders.cjs +366 -0
  5. package/dist/deciders.js +366 -0
  6. package/dist/index.cjs +1 -1
  7. package/dist/index.d.cts +194 -8
  8. package/dist/index.d.ts +194 -8
  9. package/dist/index.js +1 -1
  10. package/dist/parallel-worker.cjs +1 -4
  11. package/dist/parallel-worker.js +1 -4
  12. package/dist/prove-worker.cjs +9 -0
  13. package/dist/prove-worker.d.cts +9 -0
  14. package/dist/prove-worker.d.ts +9 -0
  15. package/dist/prove-worker.js +9 -0
  16. package/dist/prove.cjs +1006 -0
  17. package/dist/prove.js +1006 -0
  18. package/dist/run.cjs +45 -0
  19. package/dist/run.js +45 -0
  20. package/dist/tlapm.cjs +10 -0
  21. package/dist/tlapm.js +10 -0
  22. package/dist/transfer.cjs +1377 -18
  23. package/dist/transfer.js +1377 -18
  24. package/dist/worker.cjs +21 -0
  25. package/dist/worker.js +21 -0
  26. package/package.json +24 -11
  27. package/src/ast.ts +149 -8
  28. package/src/bags.ts +26 -30
  29. package/src/builtins.ts +45 -19
  30. package/src/bundled-modules.ts +3 -3
  31. package/src/check.ts +1182 -900
  32. package/src/cli/options.ts +109 -0
  33. package/src/cli/run.ts +63 -0
  34. package/src/cli/shared.ts +106 -0
  35. package/src/cli/tlapm.ts +374 -0
  36. package/src/cli/tlc.ts +941 -0
  37. package/src/cli/xml-exporter.ts +221 -0
  38. package/src/cli.ts +9 -2
  39. package/src/codegen.ts +112 -51
  40. package/src/config.ts +254 -181
  41. package/src/dependencies.ts +5 -7
  42. package/src/environment.ts +579 -184
  43. package/src/errors.ts +287 -4
  44. package/src/evaluate.ts +1095 -365
  45. package/src/exit-codes.ts +22 -43
  46. package/src/fingerprints.ts +49 -14
  47. package/src/index.ts +11 -0
  48. package/src/instances.ts +73 -60
  49. package/src/java-overrides.ts +183 -66
  50. package/src/json.ts +31 -36
  51. package/src/levels.ts +197 -54
  52. package/src/lexer.ts +127 -30
  53. package/src/liveness-checker.ts +894 -0
  54. package/src/liveness.ts +246 -596
  55. package/src/{obligation-action.ts → obligations/action.ts} +248 -74
  56. package/src/{obligation-anon.ts → obligations/anonymize.ts} +55 -57
  57. package/src/obligations/equality.ts +260 -0
  58. package/src/obligations/expression.ts +618 -0
  59. package/src/{obligation-format.ts → obligations/format.ts} +7 -8
  60. package/src/obligations/generate.ts +457 -0
  61. package/src/{obligations.ts → obligations/index.ts} +46 -32
  62. package/src/{obligation-levels.ts → obligations/levels.ts} +44 -40
  63. package/src/obligations/module.ts +445 -0
  64. package/src/obligations/normalize.ts +554 -0
  65. package/src/obligations/operators.ts +176 -0
  66. package/src/obligations/pragma.ts +195 -0
  67. package/src/{obligation-printer.ts → obligations/printer.ts} +65 -230
  68. package/src/{obligation-proof.ts → obligations/proof.ts} +7 -2
  69. package/src/obligations/regroup.ts +100 -0
  70. package/src/{obligation-generate.ts → obligations/simplify.ts} +130 -536
  71. package/src/{obligation-source.ts → obligations/source.ts} +174 -216
  72. package/src/{obligation-deref.ts → obligations/subexpression.ts} +84 -115
  73. package/src/obligations/substitution.ts +261 -0
  74. package/src/obligations/temporal.ts +321 -0
  75. package/src/{obligation-tuples.ts → obligations/tuples.ts} +38 -54
  76. package/src/parallel-worker.ts +184 -235
  77. package/src/parallel.ts +156 -91
  78. package/src/parser.ts +490 -188
  79. package/src/pcal/ast.ts +755 -0
  80. package/src/pcal/parse.ts +1487 -0
  81. package/src/pcal/tokenize.ts +487 -0
  82. package/src/pcal/translate.ts +1151 -0
  83. package/src/pcal/validate.ts +444 -0
  84. package/src/prover/decide-pool.ts +95 -0
  85. package/src/prover/deciders.ts +33 -0
  86. package/src/prover/first-order.ts +175 -0
  87. package/src/prover/isabelle/LICENSE +36 -0
  88. package/src/prover/isabelle/LICENSE-tlapm +26 -0
  89. package/src/prover/isabelle/decide.ts +44 -0
  90. package/src/prover/isabelle/encode.ts +445 -0
  91. package/src/prover/isabelle/isar/inner-syntax.ts +579 -0
  92. package/src/prover/isabelle/isar/method.ts +367 -0
  93. package/src/prover/isabelle/isar/proof.ts +28 -0
  94. package/src/prover/isabelle/isar/statement.ts +57 -0
  95. package/src/prover/isabelle/isar/theory.ts +192 -0
  96. package/src/prover/isabelle/isar/type-check.ts +278 -0
  97. package/src/prover/isabelle/provers/blast/blast.ts +258 -0
  98. package/src/prover/isabelle/provers/blast/branch.ts +322 -0
  99. package/src/prover/isabelle/provers/blast/prove.ts +347 -0
  100. package/src/prover/isabelle/provers/blast/rules.ts +330 -0
  101. package/src/prover/isabelle/provers/blast/state.ts +180 -0
  102. package/src/prover/isabelle/provers/blast/term.ts +546 -0
  103. package/src/prover/isabelle/provers/clasimp.ts +150 -0
  104. package/src/prover/isabelle/provers/classical.ts +389 -0
  105. package/src/prover/isabelle/provers/hypsubst.ts +433 -0
  106. package/src/prover/isabelle/pure/bicompose.ts +174 -0
  107. package/src/prover/isabelle/pure/consts.ts +32 -0
  108. package/src/prover/isabelle/pure/conv.ts +79 -0
  109. package/src/prover/isabelle/pure/drule.ts +264 -0
  110. package/src/prover/isabelle/pure/envir.ts +331 -0
  111. package/src/prover/isabelle/pure/goal.ts +53 -0
  112. package/src/prover/isabelle/pure/interrupt.ts +16 -0
  113. package/src/prover/isabelle/pure/list.ts +12 -0
  114. package/src/prover/isabelle/pure/logic.ts +330 -0
  115. package/src/prover/isabelle/pure/name.ts +98 -0
  116. package/src/prover/isabelle/pure/net.ts +215 -0
  117. package/src/prover/isabelle/pure/object-logic.ts +41 -0
  118. package/src/prover/isabelle/pure/pattern.ts +631 -0
  119. package/src/prover/isabelle/pure/raw-simplifier.ts +338 -0
  120. package/src/prover/isabelle/pure/rewriter.ts +602 -0
  121. package/src/prover/isabelle/pure/search.ts +68 -0
  122. package/src/prover/isabelle/pure/seq.ts +133 -0
  123. package/src/prover/isabelle/pure/simplifier.ts +106 -0
  124. package/src/prover/isabelle/pure/table.ts +201 -0
  125. package/src/prover/isabelle/pure/tactic.ts +168 -0
  126. package/src/prover/isabelle/pure/tactical.ts +264 -0
  127. package/src/prover/isabelle/pure/term-ord.ts +105 -0
  128. package/src/prover/isabelle/pure/term.ts +688 -0
  129. package/src/prover/isabelle/pure/thm.ts +783 -0
  130. package/src/prover/isabelle/pure/type.ts +121 -0
  131. package/src/prover/isabelle/pure/unify.ts +753 -0
  132. package/src/prover/isabelle/pure/variable.ts +25 -0
  133. package/src/prover/isabelle/tla/classical-setup.ts +101 -0
  134. package/src/prover/isabelle/tla/context.ts +74 -0
  135. package/src/prover/isabelle/tla/logic-data.ts +5 -0
  136. package/src/prover/isabelle/tla/logic.ts +215 -0
  137. package/src/prover/isabelle/tla/simpdata.ts +241 -0
  138. package/src/prover/isabelle/tools/intuitionistic.ts +132 -0
  139. package/src/prover/ocaml.ts +22 -0
  140. package/src/prover/prep/action.ts +508 -0
  141. package/src/prover/prep/enabled-axioms.ts +189 -0
  142. package/src/prover/prep/fingerprint.ts +388 -0
  143. package/src/prover/prep/level-comparison.ts +529 -0
  144. package/src/prover/prep/md5.ts +60 -0
  145. package/src/prover/prep/methods.ts +221 -0
  146. package/src/prover/prep/normalize.ts +309 -0
  147. package/src/prover/prove-worker.ts +22 -0
  148. package/src/prover/prove.ts +492 -0
  149. package/src/prover/ptl/decide.ts +68 -0
  150. package/src/prover/ptl/encode.ts +244 -0
  151. package/src/prover/ptl/sat.ts +151 -0
  152. package/src/prover/ptl/tableau.ts +276 -0
  153. package/src/prover/smt/axioms.ts +209 -0
  154. package/src/prover/smt/context.ts +108 -0
  155. package/src/prover/smt/data.ts +636 -0
  156. package/src/prover/smt/encode.ts +275 -0
  157. package/src/prover/smt/extensionality.ts +65 -0
  158. package/src/prover/smt/flatten.ts +112 -0
  159. package/src/prover/smt/format.ts +154 -0
  160. package/src/prover/smt/instances.ts +181 -0
  161. package/src/prover/smt/rewrite.ts +766 -0
  162. package/src/prover/smt/solver/act-cache.ts +265 -0
  163. package/src/prover/smt/solver/arith-rewriter.ts +962 -0
  164. package/src/prover/smt/solver/array.ts +22 -0
  165. package/src/prover/smt/solver/asserted-formulas.ts +469 -0
  166. package/src/prover/smt/solver/ast-lt.ts +157 -0
  167. package/src/prover/smt/solver/ast-util.ts +91 -0
  168. package/src/prover/smt/solver/ast.ts +1315 -0
  169. package/src/prover/smt/solver/auf-solver.ts +572 -0
  170. package/src/prover/smt/solver/case-split-queue.ts +178 -0
  171. package/src/prover/smt/solver/cg-table.ts +175 -0
  172. package/src/prover/smt/solver/clause.ts +276 -0
  173. package/src/prover/smt/solver/conflict-resolution.ts +343 -0
  174. package/src/prover/smt/solver/context.ts +1292 -0
  175. package/src/prover/smt/solver/ctx-simplify.ts +334 -0
  176. package/src/prover/smt/solver/der.ts +224 -0
  177. package/src/prover/smt/solver/dyn-ack.ts +141 -0
  178. package/src/prover/smt/solver/e-matching.ts +659 -0
  179. package/src/prover/smt/solver/enode.ts +259 -0
  180. package/src/prover/smt/solver/expr-ref.ts +21 -0
  181. package/src/prover/smt/solver/expr-safe-replace.ts +172 -0
  182. package/src/prover/smt/solver/fingerprints.ts +92 -0
  183. package/src/prover/smt/solver/flat-literals.ts +51 -0
  184. package/src/prover/smt/solver/goal.ts +138 -0
  185. package/src/prover/smt/solver/hash.ts +173 -0
  186. package/src/prover/smt/solver/hashtable.ts +166 -0
  187. package/src/prover/smt/solver/internalizer.ts +1381 -0
  188. package/src/prover/smt/solver/lbool.ts +5 -0
  189. package/src/prover/smt/solver/literal.ts +24 -0
  190. package/src/prover/smt/solver/lp/bound-propagator.ts +391 -0
  191. package/src/prover/smt/solver/lp/constraints.ts +78 -0
  192. package/src/prover/smt/solver/lp/containers.ts +296 -0
  193. package/src/prover/smt/solver/lp/core-solver.ts +504 -0
  194. package/src/prover/smt/solver/lp/cross-nested.ts +224 -0
  195. package/src/prover/smt/solver/lp/dep-intervals.ts +642 -0
  196. package/src/prover/smt/solver/lp/dependency.ts +51 -0
  197. package/src/prover/smt/solver/lp/dioph-eq.ts +1181 -0
  198. package/src/prover/smt/solver/lp/explanation.ts +46 -0
  199. package/src/prover/smt/solver/lp/gomory.ts +255 -0
  200. package/src/prover/smt/solver/lp/hnf-cutter.ts +125 -0
  201. package/src/prover/smt/solver/lp/hnf.ts +281 -0
  202. package/src/prover/smt/solver/lp/int-cube.ts +295 -0
  203. package/src/prover/smt/solver/lp/int-solver.ts +514 -0
  204. package/src/prover/smt/solver/lp/lar-solver.ts +816 -0
  205. package/src/prover/smt/solver/lp/lar-term.ts +62 -0
  206. package/src/prover/smt/solver/lp/lp-settings.ts +91 -0
  207. package/src/prover/smt/solver/lp/maximize-term.ts +347 -0
  208. package/src/prover/smt/solver/lp/nex-creator.ts +381 -0
  209. package/src/prover/smt/solver/lp/nex.ts +120 -0
  210. package/src/prover/smt/solver/lp/nla-backoff.ts +43 -0
  211. package/src/prover/smt/solver/lp/nla-basics.ts +398 -0
  212. package/src/prover/smt/solver/lp/nla-core.ts +968 -0
  213. package/src/prover/smt/solver/lp/nla-divisions.ts +332 -0
  214. package/src/prover/smt/solver/lp/nla-emonics.ts +373 -0
  215. package/src/prover/smt/solver/lp/nla-factorization.ts +30 -0
  216. package/src/prover/smt/solver/lp/nla-grobner.ts +904 -0
  217. package/src/prover/smt/solver/lp/nla-horner.ts +126 -0
  218. package/src/prover/smt/solver/lp/nla-intervals.ts +265 -0
  219. package/src/prover/smt/solver/lp/nla-monomial-bounds.ts +715 -0
  220. package/src/prover/smt/solver/lp/nla-monotone.ts +59 -0
  221. package/src/prover/smt/solver/lp/nla-order.ts +307 -0
  222. package/src/prover/smt/solver/lp/nla-patcher.ts +112 -0
  223. package/src/prover/smt/solver/lp/nla-tangents.ts +251 -0
  224. package/src/prover/smt/solver/lp/nla-throttle.ts +85 -0
  225. package/src/prover/smt/solver/lp/nla-types.ts +124 -0
  226. package/src/prover/smt/solver/lp/nla-var-eqs.ts +141 -0
  227. package/src/prover/smt/solver/lp/nra-solver.ts +440 -0
  228. package/src/prover/smt/solver/lp/numeric-pair.ts +65 -0
  229. package/src/prover/smt/solver/lp/pdd-interval.ts +31 -0
  230. package/src/prover/smt/solver/lp/pdd-simplifier.ts +184 -0
  231. package/src/prover/smt/solver/lp/pdd-solver.ts +408 -0
  232. package/src/prover/smt/solver/lp/pdd.ts +971 -0
  233. package/src/prover/smt/solver/lp/random-updater.ts +138 -0
  234. package/src/prover/smt/solver/lp/static-matrix.ts +246 -0
  235. package/src/prover/smt/solver/lp/union-find.ts +96 -0
  236. package/src/prover/smt/solver/mam-compiler.ts +847 -0
  237. package/src/prover/smt/solver/mam-interpreter.ts +400 -0
  238. package/src/prover/smt/solver/maximize-ac-sharing.ts +118 -0
  239. package/src/prover/smt/solver/model-checker.ts +347 -0
  240. package/src/prover/smt/solver/model-evaluator.ts +262 -0
  241. package/src/prover/smt/solver/model-finder.ts +155 -0
  242. package/src/prover/smt/solver/model-generator.ts +97 -0
  243. package/src/prover/smt/solver/model-macro-solver.ts +728 -0
  244. package/src/prover/smt/solver/nlsat/algebraic.ts +1161 -0
  245. package/src/prover/smt/solver/nlsat/atoms.ts +238 -0
  246. package/src/prover/smt/solver/nlsat/evaluator.ts +303 -0
  247. package/src/prover/smt/solver/nlsat/explain.ts +607 -0
  248. package/src/prover/smt/solver/nlsat/interval-set.ts +351 -0
  249. package/src/prover/smt/solver/nlsat/levelwise.ts +737 -0
  250. package/src/prover/smt/solver/nlsat/mpbq.ts +161 -0
  251. package/src/prover/smt/solver/nlsat/polynomial.ts +1722 -0
  252. package/src/prover/smt/solver/nlsat/solver.ts +911 -0
  253. package/src/prover/smt/solver/nlsat/types.ts +43 -0
  254. package/src/prover/smt/solver/nlsat/upolynomial-factorization.ts +648 -0
  255. package/src/prover/smt/solver/nlsat/upolynomial.ts +996 -0
  256. package/src/prover/smt/solver/nnf.ts +469 -0
  257. package/src/prover/smt/solver/pattern-inference.ts +351 -0
  258. package/src/prover/smt/solver/poly-rewriter.ts +477 -0
  259. package/src/prover/smt/solver/propagate-values.ts +83 -0
  260. package/src/prover/smt/solver/proto-model.ts +551 -0
  261. package/src/prover/smt/solver/pull-quant.ts +139 -0
  262. package/src/prover/smt/solver/qe-lite-der.ts +526 -0
  263. package/src/prover/smt/solver/qe-lite-fm.ts +576 -0
  264. package/src/prover/smt/solver/qe-lite.ts +381 -0
  265. package/src/prover/smt/solver/qi-queue.ts +362 -0
  266. package/src/prover/smt/solver/quant-tactics.ts +117 -0
  267. package/src/prover/smt/solver/quantifier-analyzer.ts +562 -0
  268. package/src/prover/smt/solver/quantifier-manager.ts +186 -0
  269. package/src/prover/smt/solver/random-gen.ts +10 -0
  270. package/src/prover/smt/solver/rational.ts +165 -0
  271. package/src/prover/smt/solver/ref-vector.ts +62 -0
  272. package/src/prover/smt/solver/relevancy.ts +247 -0
  273. package/src/prover/smt/solver/rewriter-tpl.ts +1159 -0
  274. package/src/prover/smt/solver/rewriter.ts +843 -0
  275. package/src/prover/smt/solver/rlimit.ts +79 -0
  276. package/src/prover/smt/solver/smtlib-parser.ts +526 -0
  277. package/src/prover/smt/solver/solver.ts +71 -0
  278. package/src/prover/smt/solver/sort.ts +35 -0
  279. package/src/prover/smt/solver/sticky-generations.ts +69 -0
  280. package/src/prover/smt/solver/theory-lra-axioms.ts +340 -0
  281. package/src/prover/smt/solver/theory-lra-bounds.ts +226 -0
  282. package/src/prover/smt/solver/theory-lra-final-check.ts +252 -0
  283. package/src/prover/smt/solver/theory-lra-internalize.ts +476 -0
  284. package/src/prover/smt/solver/theory-lra-model.ts +243 -0
  285. package/src/prover/smt/solver/theory-lra-propagate.ts +405 -0
  286. package/src/prover/smt/solver/theory-lra-state.ts +43 -0
  287. package/src/prover/smt/solver/theory-lra.ts +56 -0
  288. package/src/prover/smt/solver/var-subst.ts +258 -0
  289. package/src/prover/smt/solver/z3-license.txt +10 -0
  290. package/src/prover/smt/table.ts +170 -0
  291. package/src/prover/tlapm/cache.ts +236 -0
  292. package/src/prover/tlapm/ocaml-marshal.ts +166 -0
  293. package/src/prover/tlapm/tlapm.ts +96 -0
  294. package/src/prover/tlaps-module.ts +510 -0
  295. package/src/prover/verdict.ts +13 -0
  296. package/src/prover/zenon/LICENSE +32 -0
  297. package/src/prover/zenon/check/check.ts +105 -0
  298. package/src/prover/zenon/check/definitions.ts +144 -0
  299. package/src/prover/zenon/check/equality.ts +182 -0
  300. package/src/prover/zenon/check/functions.ts +62 -0
  301. package/src/prover/zenon/check/keys.ts +125 -0
  302. package/src/prover/zenon/check/propositional.ts +104 -0
  303. package/src/prover/zenon/check/records.ts +188 -0
  304. package/src/prover/zenon/check/relations.ts +121 -0
  305. package/src/prover/zenon/check/rewrites.ts +224 -0
  306. package/src/prover/zenon/check/sets.ts +302 -0
  307. package/src/prover/zenon/check/terms.ts +127 -0
  308. package/src/prover/zenon/check/tla.ts +126 -0
  309. package/src/prover/zenon/decide.ts +107 -0
  310. package/src/prover/zenon/encode.ts +378 -0
  311. package/src/prover/zenon/eqrel.ts +300 -0
  312. package/src/prover/zenon/equality-rules.ts +435 -0
  313. package/src/prover/zenon/expr.ts +551 -0
  314. package/src/prover/zenon/index-table.ts +350 -0
  315. package/src/prover/zenon/isar-case.ts +513 -0
  316. package/src/prover/zenon/isar.ts +1249 -0
  317. package/src/prover/zenon/limits.ts +15 -0
  318. package/src/prover/zenon/llproof.ts +173 -0
  319. package/src/prover/zenon/mltoll.ts +1566 -0
  320. package/src/prover/zenon/node.ts +297 -0
  321. package/src/prover/zenon/ocaml.ts +169 -0
  322. package/src/prover/zenon/parse.ts +247 -0
  323. package/src/prover/zenon/phrase.ts +191 -0
  324. package/src/prover/zenon/proof.ts +198 -0
  325. package/src/prover/zenon/propositional-rules.ts +387 -0
  326. package/src/prover/zenon/rules.ts +94 -0
  327. package/src/prover/zenon/search.ts +288 -0
  328. package/src/prover/zenon/tla/functions.ts +151 -0
  329. package/src/prover/zenon/tla/llproof.ts +480 -0
  330. package/src/prover/zenon/tla/records.ts +225 -0
  331. package/src/prover/zenon/tla/rewrites.ts +447 -0
  332. package/src/prover/zenon/tla/sets.ts +304 -0
  333. package/src/prover/zenon/tla/terms.ts +162 -0
  334. package/src/prover/zenon/tla/tla.ts +506 -0
  335. package/src/randomization.ts +39 -27
  336. package/src/resolve.ts +1474 -426
  337. package/src/runtime.ts +25 -7
  338. package/src/sany/builtins.ts +147 -0
  339. package/src/sany/generator.ts +3111 -0
  340. package/src/sany/levels.ts +1205 -0
  341. package/src/sany/lexer.ts +544 -0
  342. package/src/sany/linter.ts +122 -0
  343. package/src/sany/modules.ts +1398 -0
  344. package/src/sany/nodes.ts +463 -0
  345. package/src/sany/parse-error.ts +2161 -0
  346. package/src/sany/report.ts +355 -0
  347. package/src/sany/selectors.ts +736 -0
  348. package/src/sany/source.ts +247 -0
  349. package/src/sany/xml.ts +1016 -0
  350. package/src/search.ts +969 -0
  351. package/src/spec-description.ts +66 -29
  352. package/src/{standard-levels.ts → standard-definitions.ts} +118 -2
  353. package/src/standard-modules.ts +215 -164
  354. package/src/state-graph.ts +181 -0
  355. package/src/subexpressions.ts +231 -171
  356. package/src/substitution-levels.ts +40 -19
  357. package/src/successors.ts +253 -125
  358. package/src/symmetry.ts +194 -54
  359. package/src/tableau.ts +60 -32
  360. package/src/tlc/fingerprint.ts +214 -0
  361. package/src/{tlc-modules.ts → tlc/jar-data.ts} +4 -0
  362. package/src/tlc/messages.ts +441 -0
  363. package/src/{tlc-order.ts → tlc/order.ts} +84 -16
  364. package/src/{tlc-random.ts → tlc/random.ts} +30 -189
  365. package/src/tlc/replay.ts +659 -0
  366. package/src/{tlc-summary.ts → tlc/summary.ts} +20 -5
  367. package/src/{tlc-module.ts → tlc/tlc-operators.ts} +59 -50
  368. package/src/{tlc-ext.ts → tlc/tlcext-operators.ts} +63 -45
  369. package/src/tlc/version.ts +19 -0
  370. package/src/transfer.ts +44 -32
  371. package/src/values.ts +843 -241
  372. package/src/worker.ts +62 -0
  373. package/dist/parallel.cjs +0 -12
  374. package/dist/parallel.js +0 -12
  375. package/dist/run-cli.cjs +0 -28
  376. package/dist/run-cli.js +0 -28
  377. package/src/canonical.ts +0 -39
  378. package/src/cli-options.ts +0 -58
  379. package/src/obligation-expression.ts +0 -1060
  380. package/src/obligation-module.ts +0 -1042
  381. package/src/run-cli.ts +0 -478
package/src/run-cli.ts DELETED
@@ -1,478 +0,0 @@
1
- import {
2
- existsSync,
3
- globSync,
4
- mkdirSync,
5
- readFileSync,
6
- readSync,
7
- realpathSync,
8
- writeFileSync,
9
- } from "node:fs";
10
- import { spawnSync } from "node:child_process";
11
- import { basename, delimiter, dirname, join, resolve } from "node:path";
12
- import { availableParallelism } from "node:os";
13
- import type { CheckResult, CheckStatus, TraceStep } from "./check";
14
- import { defineCommand, type ParsedArgs } from "./cli-options";
15
- import { parseConfig } from "./config";
16
- import {
17
- getErrorExitCode,
18
- TlaConfigError,
19
- TlaError,
20
- TlaEvaluationError,
21
- TlaProofError,
22
- } from "./errors";
23
- import { EXIT_STATUS } from "./exit-codes";
24
- import type { LineRange } from "./obligation-generate";
25
- import { getAtPrefix, getLocusText } from "./obligation-expression";
26
- import { formatSummary, getObligations, WHOLE_MODULE, type ModuleObligations } from "./obligations";
27
- import { check } from "./parallel";
28
- import { prettyPrint } from "./pretty-print";
29
- import {
30
- formatProbability,
31
- getActualProbability,
32
- getOptimisticProbability,
33
- getOutDegreeSummary,
34
- } from "./tlc-summary";
35
- import { formatValue, type Value } from "./values";
36
-
37
- const EXIT_CODES: Record<CheckStatus, number> = {
38
- success: EXIT_STATUS.success,
39
- "assumption-violation": EXIT_STATUS.assumptionViolation,
40
- deadlock: EXIT_STATUS.deadlock,
41
- "invariant-violation": EXIT_STATUS.safetyViolation,
42
- "property-violation": EXIT_STATUS.safetyViolation,
43
- "liveness-violation": EXIT_STATUS.livenessViolation,
44
- "postcondition-violation": EXIT_STATUS.assumptionViolation,
45
- error: EXIT_STATUS.error,
46
- };
47
-
48
- const CHECK_COMMAND = defineCommand("tla-ts <Spec.tla|Spec.cfg|glob>... {options}", [
49
- { flag: "-config <Spec.cfg>" },
50
- { flag: "-deadlock" },
51
- { flag: "-lncheck <final|default>" },
52
- { flag: "-seed <num>" },
53
- { flag: "-workers <count|auto>" },
54
- ]);
55
-
56
- const PROVE_COMMAND = defineCommand("tla-ts prove {options} <Module.tla|glob>...", [
57
- { flag: "-N", isRequired: true },
58
- { flag: "--toolbox <start> <end>" },
59
- { flag: "--line <num>" },
60
- { flag: "--printallobs" },
61
- { flag: "--summary" },
62
- { flag: "--strict" },
63
- { flag: "-I <directory>", isRepeatable: true },
64
- ]);
65
-
66
- const USAGE = [
67
- `Usage: ${CHECK_COMMAND.usage}`,
68
- ` ${PROVE_COMMAND.usage}`,
69
- " tla-ts prove [<tlapm option>]... <Module.tla|glob>...",
70
- ].join("\n");
71
-
72
- const GLOB_CHARACTERS = /[*?[{]/;
73
-
74
- interface InputPath {
75
- path: string;
76
- isGlobbed: boolean;
77
- }
78
-
79
- const getInputPaths = (paths: string[]): InputPath[] =>
80
- paths.flatMap((arg): InputPath[] =>
81
- GLOB_CHARACTERS.test(arg)
82
- ? globSync(arg)
83
- .sort()
84
- .map((path) => ({ path, isGlobbed: true }))
85
- : [{ path: arg, isGlobbed: false }],
86
- );
87
-
88
- const isJavaLong = (text: string) =>
89
- /^[+-]?\d+$/.test(text) && BigInt.asIntN(64, BigInt(text)) === BigInt(text);
90
-
91
- const getWorkerCount = (values: string[] | undefined) => {
92
- if (!values) return 1;
93
- return values[0] === "auto"
94
- ? availableParallelism()
95
- : Math.max(1, Number.parseInt(values[0], 10) || 1);
96
- };
97
-
98
- const printState = (state: Record<string, Value>) => {
99
- const entries = Object.entries(state);
100
- entries.forEach(([name, value]) =>
101
- console.log(
102
- `${entries.length === 1 ? "" : "/\\ "}${name} = ${prettyPrint(formatValue(value))}`,
103
- ),
104
- );
105
- console.log("");
106
- };
107
-
108
- const printTrace = (trace: TraceStep[], heading = "Error: The behavior up to this point is:") => {
109
- if (trace.length > 0) console.log(heading);
110
- trace.forEach((step, index) => {
111
- console.log(`State ${index + 1}: <${step.label ?? step.action ?? "Initial predicate"}>`);
112
- printState(step.state);
113
- });
114
- };
115
-
116
- const printResult = (result: CheckResult) => {
117
- if (result.failure) {
118
- console.log(`Error: ${result.failure.message}`);
119
- if (result.failure.initialState) {
120
- console.log("While working on the initial state:");
121
- printState(result.failure.initialState);
122
- }
123
- printTrace(result.failure.trace);
124
- } else if (result.violation) {
125
- const violation = result.violation;
126
- const name = violation.name;
127
- const loopStart = violation.loopStart;
128
- // TLC prints a violation by an initial state without the behavior or the statistics.
129
- const isInitial =
130
- loopStart === undefined &&
131
- violation.trace.length === 1 &&
132
- (result.status === "invariant-violation" || result.status === "liveness-violation");
133
- const headline = {
134
- success: "",
135
- error: "",
136
- "assumption-violation": violation.message
137
- ? `Error: Evaluating assumption ${name} failed.\n${violation.message}`
138
- : `Error: Assumption ${name} is false.`,
139
- deadlock: "Error: Deadlock reached.",
140
- "invariant-violation": isInitial
141
- ? `Error: Invariant ${name} is violated by the initial state:`
142
- : `Error: Invariant ${name} is violated.`,
143
- "property-violation": `Error: Property ${name} is violated.`,
144
- "liveness-violation":
145
- loopStart !== undefined
146
- ? `Error: Temporal property ${name} was violated.\n`
147
- : isInitial
148
- ? `Error: Property ${name} is violated by the initial state:`
149
- : `Error: Action property ${name} is violated.`,
150
- "postcondition-violation": `Error: ${violation.message ?? `Postcondition ${name} is false.`}`,
151
- }[result.status];
152
- if (violation.counts) console.log(violation.counts);
153
- console.log(headline);
154
- if (isInitial) printState(violation.trace[0].state);
155
- else if (loopStart === undefined) printTrace(violation.trace);
156
- else {
157
- printTrace(violation.trace, "Error: The following behavior constitutes a counter-example:\n");
158
- const isStuttering = loopStart === violation.trace.length - 1;
159
- console.log(
160
- isStuttering
161
- ? `State ${loopStart + 2}: Stuttering`
162
- : `Back to state ${loopStart + 1}${violation.loopLabel ? `: <${violation.loopLabel}>\n` : ""}`,
163
- );
164
- }
165
- const unwitnessed = violation.unwitnessed;
166
- if (unwitnessed?.counts) console.log(unwitnessed.counts);
167
- if (unwitnessed) console.log(`Error: ${unwitnessed.message}`);
168
- // TLC checks assumptions before it starts the search, so it has no statistics to print.
169
- if (isInitial || result.status === "assumption-violation") return;
170
- } else {
171
- const optimistic = getOptimisticProbability(result.distinctStates, result.generatedStates);
172
- console.log("Model checking completed. No error has been found.");
173
- console.log(" Estimates of the probability that TLC did not check all reachable states");
174
- console.log(" because two distinct states had the same fingerprint:");
175
- console.log(` calculated (optimistic): val = ${formatProbability(optimistic)}`);
176
- if (result.fingerprintDistance !== undefined) {
177
- const actual = getActualProbability(result.fingerprintDistance);
178
- console.log(` based on the actual fingerprints: val = ${formatProbability(actual)}`);
179
- }
180
- }
181
- console.log(
182
- `${result.generatedStates} states generated, ${result.distinctStates} distinct states found, ${result.queuedStates} states left on queue.`,
183
- );
184
- console.log(`The depth of the complete state graph search is ${result.depth}.`);
185
- const outDegree = result.outDegrees && getOutDegreeSummary(result.outDegrees);
186
- if (outDegree) console.log(outDegree);
187
- };
188
-
189
- const checkSpec = async (specPath: string, args: ParsedArgs) => {
190
- if (!existsSync(specPath)) {
191
- console.error(`Cannot find the specification file ${specPath}`);
192
- return EXIT_STATUS.configParseError;
193
- }
194
- const configPath =
195
- args.get("-config")?.[0] ??
196
- (args.has("-config") ? undefined : specPath.replace(/\.tla$/, ".cfg"));
197
- if (!configPath || !existsSync(configPath)) {
198
- console.error(`Cannot find the configuration file ${configPath ?? ""}`);
199
- return EXIT_STATUS.configParseError;
200
- }
201
- const config = parseConfig(readFileSync(configPath, "utf8"));
202
- if (args.has("-deadlock")) config.checkDeadlock = false;
203
- const seed = args.has("-seed") ? args.get("-seed")?.[0] : "0";
204
- if (seed === undefined) {
205
- console.error("Error: seed required.");
206
- return 1;
207
- }
208
- if (!isJavaLong(seed)) {
209
- console.error(`Error: An integer for seed required. But encountered ${seed}`);
210
- return 1;
211
- }
212
- const livenessCheck = args.has("-lncheck") ? args.get("-lncheck")?.[0]?.toLowerCase() : "default";
213
- if (livenessCheck === undefined) {
214
- console.error("Error: expect a strategy such as final for -lncheck option.");
215
- return 1;
216
- }
217
- const directory = dirname(specPath);
218
- console.log(`Checking ${basename(specPath)} with ${basename(configPath)}`);
219
- const result = await check({
220
- workers: getWorkerCount(args.get("-workers")),
221
- livenessCheck: ["final", "seqfinal", "off"].includes(livenessCheck) ? "final" : "default",
222
- seed: BigInt(seed),
223
- source: readFileSync(specPath, "utf8"),
224
- config,
225
- onPause: () => readSync(0, Buffer.alloc(1)),
226
- loadModule: (name) => {
227
- const modulePath = join(directory, `${name}.tla`);
228
- return existsSync(modulePath) ? readFileSync(modulePath, "utf8") : undefined;
229
- },
230
- loadClass: (name) => {
231
- const classPath = join(directory, `${name}.class`);
232
- return existsSync(classPath) ? readFileSync(classPath) : undefined;
233
- },
234
- readFile: (path) => (existsSync(path) ? readFileSync(path, "utf8") : undefined),
235
- writeFile: (path, content) => {
236
- mkdirSync(dirname(resolve(path)), { recursive: true });
237
- writeFileSync(path, content);
238
- },
239
- });
240
- printResult(result);
241
- return result.failure?.exitCode ?? EXIT_CODES[result.status];
242
- };
243
-
244
- // TLC prints the errors it raises itself. tla-ts names the others, such as a module SANY rejects.
245
- const printError = (error: TlaError) => {
246
- if (error instanceof TlaConfigError || error instanceof TlaEvaluationError) {
247
- return console.log(`Error: ${error.message}`);
248
- }
249
- console.error(`${error.name}: ${error.message}`);
250
- };
251
-
252
- // Prints a TlaError and returns its exit code.
253
- const reportErrors = async (run: () => number | Promise<number>) => {
254
- try {
255
- return await run();
256
- } catch (error) {
257
- if (!(error instanceof TlaError)) throw error;
258
- printError(error);
259
- return getErrorExitCode(error);
260
- }
261
- };
262
-
263
- // Runs each path in turn, so an error in one leaves the others to report. The exit code is the
264
- // first that is not success.
265
- const runEach = async (paths: string[], runPath: (path: string) => number | Promise<number>) => {
266
- const exitCodes: number[] = [];
267
- for (const [index, path] of paths.entries()) {
268
- if (index > 0) console.log("");
269
- exitCodes.push(await reportErrors(() => runPath(path)));
270
- }
271
- return exitCodes.find((exitCode) => exitCode !== EXIT_STATUS.success) ?? EXIT_STATUS.success;
272
- };
273
-
274
- // tlapm installs its standard library, with modules such as TLAPS, at lib/tlapm/stdlib beside
275
- // bin/tlapm.
276
- const getTlapmPaths = () =>
277
- (process.env.PATH ?? "")
278
- .split(delimiter)
279
- .map((directory) => join(directory, "tlapm"))
280
- .filter((path) => existsSync(path));
281
-
282
- const getTlapmLibrary = () =>
283
- getTlapmPaths()
284
- .map((path) => join(dirname(dirname(realpathSync(path))), "lib/tlapm/stdlib"))
285
- .find((path) => existsSync(path));
286
-
287
- const expandGlobs = (paths: string[]) =>
288
- paths.flatMap((path) => (GLOB_CHARACTERS.test(path) ? globSync(path).sort() : [path]));
289
-
290
- const proveWithTlapm = (args: string[]) => {
291
- const tlapm = getTlapmPaths()[0];
292
- if (tlapm === undefined) {
293
- console.error(
294
- "Error: tla-ts prove runs tlapm to prove obligations, but tlapm isn't on your PATH. Install tlapm, or pass -N to only generate the obligations.",
295
- );
296
- return 1;
297
- }
298
- return spawnSync(tlapm, expandGlobs(args), { stdio: "inherit" }).status ?? 1;
299
- };
300
-
301
- const readModule = (path: string) =>
302
- existsSync(path) ? { file: path, source: readFileSync(path, "utf8") } : undefined;
303
-
304
- // A message of tlapm's toolbox protocol, which it writes to stderr.
305
- const printToolboxMessage = (fields: string[]) =>
306
- console.error(`@!!BEGIN\n${fields.map((field) => `@!!${field}\n`).join("")}@!!END\n`);
307
-
308
- const TLAPM_VERSION = "5f5037f";
309
-
310
- const quoteArgument = (arg: string) =>
311
- /^[+,\-./0-9:=@A-Z_a-z]+$/.test(arg) ? arg : `'${arg.replaceAll("'", "'\\''")}'`;
312
-
313
- const printToolboxHeader = (args: string[]) => {
314
- const now = new Date();
315
- const pad = (value: number) => String(value).padStart(2, "0");
316
- const date = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
317
- const time = `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
318
- console.log(
319
- `\n\\* TLAPM version ${TLAPM_VERSION}\n\\* launched at ${date} ${time} with command line:\n\\* ${["tla-ts", "prove", ...args].map(quoteArgument).join(" ")}\n`,
320
- );
321
- };
322
-
323
- const STRICT_EXIT_STATUS = { incomplete: 11, emptyTarget: 12 };
324
-
325
- const checkStrictly = (result: ModuleObligations, isTargeted: boolean, isSummary: boolean) => {
326
- const summary = result.summary;
327
- if (!isSummary) {
328
- summary.absent.forEach((locus) => console.error(`Missing proof at ${getLocusText(locus)}`));
329
- summary.omitted.forEach((locus) => console.error(`Omitted proof at ${getLocusText(locus)}`));
330
- }
331
- const isIncomplete = summary.absent.length + summary.omitted.length > 0;
332
- if (isIncomplete) {
333
- console.error(
334
- `${getAtPrefix(result.location)}[ERROR]: Proof incomplete in module ${JSON.stringify(result.name)}: ${summary.absent.length} missing, ${summary.omitted.length} omitted proof step(s).`,
335
- );
336
- }
337
- const isEmpty = isTargeted && result.obligations.length === 0;
338
- if (isEmpty) {
339
- console.error(
340
- `${getAtPrefix(result.location)}[ERROR]: No proof obligation found for the selected target.`,
341
- );
342
- }
343
- return [
344
- ...(isIncomplete ? [STRICT_EXIT_STATUS.incomplete] : []),
345
- ...(isEmpty ? [STRICT_EXIT_STATUS.emptyTarget] : []),
346
- ];
347
- };
348
-
349
- const TLAPM_FAILURE_STATUS = 3;
350
-
351
- const generateObligations = (generate: () => ModuleObligations[]) => {
352
- try {
353
- return generate();
354
- } catch (error) {
355
- if (!(error instanceof TlaProofError)) throw error;
356
- console.error(` tlapm ending abnormally with ${error.exception}\n`);
357
- return undefined;
358
- }
359
- };
360
-
361
- const prove = (args: string[]) => {
362
- if (!args.includes("-N") && !args.includes("--summary")) return proveWithTlapm(args);
363
- const parsed = PROVE_COMMAND.parse(args);
364
- const unsupported = parsed.unknown[0];
365
- if (unsupported !== undefined) {
366
- console.error(`Error: tla-ts prove does not support the tlapm option ${unsupported}.`);
367
- return 1;
368
- }
369
- if (parsed.incomplete) {
370
- console.error(`Error: option '${parsed.incomplete.name}' needs an argument.`);
371
- return 1;
372
- }
373
- const nonInteger = parsed.options.find(
374
- (option) => option.name !== "-I" && option.values.some((value) => !/^-?\d+$/.test(value)),
375
- );
376
- if (nonInteger) {
377
- console.error(`Error: option '${nonInteger.name}' expects an integer.`);
378
- return 1;
379
- }
380
- const files = expandGlobs(parsed.positionals);
381
- const modulePaths = files.map((path) => (path.endsWith(".tla") ? path : `${path}.tla`));
382
- if (modulePaths.length === 0) {
383
- console.error(USAGE);
384
- return 1;
385
- }
386
- const isToolbox = parsed.has("--toolbox") || parsed.has("--line");
387
- if (isToolbox) printToolboxHeader(args);
388
- // Like tlapm, the last of --toolbox and --line wins, and a 0 means the whole module.
389
- const lines = parsed.options.reduce<LineRange>((range, option) => {
390
- const [start, end] = option.values.map(Number);
391
- if (option.name === "--toolbox") return { start, end: end === 0 ? Infinity : end };
392
- if (option.name === "--line") return start === 0 ? WHOLE_MODULE : { start, end: start };
393
- return range;
394
- }, WHOLE_MODULE);
395
- // tlapm searches the current directory and each module's, then its library, then each -I
396
- // directory, the last given first.
397
- const tlapmLibrary = getTlapmLibrary();
398
- const includes = parsed.options.flatMap((option) => (option.name === "-I" ? option.values : []));
399
- const directories = modulePaths.reduce(
400
- (found, path) => (found.includes(dirname(path)) ? found : [dirname(path), ...found]),
401
- [".", ...(tlapmLibrary ? [tlapmLibrary] : []), ...includes.toReversed()],
402
- );
403
- // tlapm names each file it reads by joining a search directory and the name, as in ./Module.tla.
404
- const results = generateObligations(() => {
405
- const missingIndex = modulePaths.findIndex((path) => !existsSync(path));
406
- if (missingIndex !== -1) {
407
- const missing = files[missingIndex];
408
- console.error(`File "<unknown>":\nError: File ${JSON.stringify(missing)} not found`);
409
- throw new TlaProofError(`File ${missing} not found`, { failure: "Module.Parser.parse_file" });
410
- }
411
- return getObligations(
412
- modulePaths.map((path) => ({ file: `./${path}`, source: readFileSync(path, "utf8") })),
413
- (name) =>
414
- directories.map((directory) => readModule(`${directory}/${name}.tla`)).find(Boolean),
415
- {
416
- lines,
417
- onWarning: (warning) => {
418
- if (warning.channel === "stdout") return console.log(warning.text);
419
- const isToolboxMessage =
420
- warning.channel === "toolbox" || warning.channel === "toolboxOnly";
421
- if (isToolbox && isToolboxMessage)
422
- return printToolboxMessage(["type:warning", `msg:${warning.text}`]);
423
- if (warning.channel !== "toolboxOnly") console.error(warning.text);
424
- },
425
- },
426
- );
427
- });
428
- if (!results) return TLAPM_FAILURE_STATUS;
429
- const failures = results.flatMap((result) => {
430
- if (parsed.has("--summary")) console.log(formatSummary(result));
431
- if (isToolbox) {
432
- result.obligations.forEach((obligation) =>
433
- printToolboxMessage([
434
- "type:obligation",
435
- `id:${obligation.id}`,
436
- `loc:${obligation.location}`,
437
- "status:to be proved",
438
- ...(parsed.has("--printallobs") ? [`obl:${obligation.text}`] : []),
439
- ]),
440
- );
441
- printToolboxMessage(["type:obligationsnumber", `count:${result.obligations.length}`]);
442
- }
443
- if (!parsed.has("--strict")) return [];
444
- return checkStrictly(result, lines.start > 0 || lines.end < Infinity, parsed.has("--summary"));
445
- });
446
- return failures.includes(STRICT_EXIT_STATUS.incomplete)
447
- ? STRICT_EXIT_STATUS.incomplete
448
- : (failures[0] ?? EXIT_STATUS.success);
449
- };
450
-
451
- const run = async (args: string[]) => {
452
- if (args[0] === "prove") return reportErrors(() => prove(args.slice(1)));
453
- const parsed = CHECK_COMMAND.parse(args);
454
- const inputs = getInputPaths(parsed.positionals);
455
- const isConfigured = parsed.has("-config");
456
- // A glob also matches modules that only other specs import, which have no configuration.
457
- const specPaths = inputs
458
- .map((input) => ({ ...input, path: input.path.replace(/\.cfg$/, ".tla") }))
459
- .filter(
460
- (input) =>
461
- input.path.endsWith(".tla") &&
462
- (!input.isGlobbed || isConfigured || existsSync(input.path.replace(/\.tla$/, ".cfg"))),
463
- )
464
- .map((input) => input.path);
465
- if (specPaths.length === 0) {
466
- console.error(USAGE);
467
- return 1;
468
- }
469
- if (isConfigured && specPaths.length > 1) {
470
- console.error("Error: -config applies to one specification, but several were given.");
471
- return 1;
472
- }
473
- return runEach([...new Set(specPaths)], (path) => checkSpec(path, parsed));
474
- };
475
-
476
- export const runCli = async () => {
477
- process.exitCode = await run(process.argv.slice(2));
478
- };