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/parallel.ts CHANGED
@@ -1,31 +1,42 @@
1
1
  import type { Expression } from "./ast";
2
- import { createCanonicalizer } from "./canonical";
3
2
  import {
4
3
  checkSequentially,
5
- createSearch,
6
- findAssumptionViolation,
7
4
  type CheckOptions,
5
+ type CheckProgress,
8
6
  type CheckResult,
7
+ type InitialStates,
9
8
  } from "./check";
10
9
  import { parseConfig, type ModelConfig } from "./config";
11
10
  import { createEnvironment } from "./environment";
12
11
  import { TlaEvaluationError } from "./errors";
13
12
  import { isImpure } from "./evaluate";
14
- import { createFingerprintTable, getFingerprintOwner, writeStateFingerprint } from "./fingerprints";
13
+ import {
14
+ createSharedFingerprints,
15
+ growSharedFingerprints,
16
+ insertSharedFingerprint,
17
+ isSharedFingerprintsFull,
18
+ writeStateFingerprint,
19
+ type SharedFingerprints,
20
+ } from "./fingerprints";
21
+ import {
22
+ createSearch,
23
+ findAssumptionViolation,
24
+ reportInitialStatesProgress,
25
+ reportStartup,
26
+ } from "./search";
15
27
  import { getInitialStates } from "./successors";
16
- import { getTlcStringOrder, getTlcVariableOrder } from "./tlc-order";
17
- import { getFingerprintDistance, OUT_DEGREE_BUCKETS } from "./tlc-summary";
28
+ import { getTlcStringOrder, getTlcVariableOrder } from "./tlc/order";
29
+ import { getFingerprintDistance, OUT_DEGREE_BUCKETS } from "./tlc/summary";
18
30
  import { createStateEncoder, type EncodedStates } from "./transfer";
19
- import { getRankedStringCount, setStringOrder, type Value } from "./values";
20
-
21
- const WORKER_THREADS_MODULE = "node:worker_threads";
22
-
23
- export interface Port {
24
- postMessage: (message: unknown, transfer?: unknown[]) => void;
25
- addEventListener: (type: "message", listener: (event: { data: unknown }) => void) => void;
26
- removeEventListener?: (type: "message", listener: (event: { data: unknown }) => void) => void;
27
- start?: () => void;
28
- }
31
+ import type { TlcVersion } from "./tlc/version";
32
+ import {
33
+ createCanonicalizer,
34
+ getRankedStringCount,
35
+ setStringOrder,
36
+ setValueVersion,
37
+ type Value,
38
+ } from "./values";
39
+ import { spawnWorker, type Port } from "./worker";
29
40
 
30
41
  export interface StartMessage {
31
42
  type: "start";
@@ -34,62 +45,75 @@ export interface StartMessage {
34
45
  modules: [string, string | undefined][];
35
46
  classes: [string, Uint8Array | undefined][];
36
47
  index: number;
37
- count: number;
38
48
  ports: (Port | undefined)[];
39
49
  seed: EncodedStates;
40
- seedFingerprints: Int32Array;
50
+ isTool: boolean | undefined;
51
+ isTraceRecorded: boolean | undefined;
52
+ isWarningEnabled: boolean | undefined;
53
+ version: TlcVersion | undefined;
54
+ fingerprints: SharedFingerprints;
55
+ requests: Int32Array;
56
+ remaining: Int32Array;
41
57
  }
42
58
 
43
59
  export interface LevelMessage {
44
60
  type: "level";
45
- level: number;
46
61
  generated: number;
47
62
  added: number;
48
63
  outDegrees: number[];
49
64
  fingerprints: BigInt64Array;
50
65
  }
51
66
 
52
- export type WorkerMessage = { type: "ready" } | { type: "abort" } | LevelMessage;
53
-
54
- interface WorkerHandle {
55
- postMessage: (message: unknown, transfer?: unknown[]) => void;
56
- terminate: () => void;
57
- }
58
-
59
- interface WebWorker {
60
- postMessage: (message: unknown, transfer?: unknown[]) => void;
61
- addEventListener: (type: string, listener: (event: { data: unknown }) => void) => void;
62
- terminate: () => void;
63
- }
64
-
65
- declare const Worker: new (url: URL, options: { type: "module" }) => WebWorker;
67
+ export type WorkerMessage =
68
+ | { type: "ready" }
69
+ | { type: "abort" }
70
+ | { type: "paused" }
71
+ | LevelMessage;
66
72
 
67
- const spawnWorker = async (onMessage: (message: WorkerMessage) => void): Promise<WorkerHandle> => {
68
- if (typeof Worker === "function") {
69
- const worker = new Worker(new URL("./parallel-worker.js", import.meta.url), { type: "module" });
70
- worker.addEventListener("message", (event) => onMessage(event.data as WorkerMessage));
71
- worker.addEventListener("error", () => onMessage({ type: "abort" }));
72
- return worker;
73
- }
74
- const threads: typeof import("node:worker_threads") = await import(
75
- /* @vite-ignore */ /* webpackIgnore: true */ WORKER_THREADS_MODULE
76
- );
77
- const worker = new threads.Worker(new URL("./parallel-worker.js", import.meta.url));
78
- worker.on("message", onMessage);
79
- worker.on("error", () => onMessage({ type: "abort" }));
80
- return {
81
- postMessage: (message, transfer) =>
82
- worker.postMessage(message, transfer as Parameters<typeof worker.postMessage>[1]),
83
- terminate: () => void worker.terminate(),
84
- };
85
- };
73
+ export type CoordinatorMessage =
74
+ | { type: "level" }
75
+ | { type: "resize"; fingerprints: SharedFingerprints };
86
76
 
87
77
  export const check = async (options: CheckOptions): Promise<CheckResult> => {
88
- const config = typeof options.config === "string" ? parseConfig(options.config) : options.config;
89
- const fallBack = () => checkSequentially({ ...options, config });
90
- const count = options.workers ?? 1;
78
+ const config =
79
+ typeof options.config === "string"
80
+ ? parseConfig(options.config, options.version)
81
+ : options.config;
82
+ const print = options.onPrint ?? console.log;
83
+ const printed = { count: 0 };
84
+ // What each point the search reports is about, such as the invariant TLC warns about.
85
+ const getKey = (progress: CheckProgress) =>
86
+ [
87
+ progress.kind,
88
+ "name" in progress ? progress.name : "",
89
+ "count" in progress ? progress.count : "",
90
+ "text" in progress ? progress.text : "",
91
+ ].join(" ");
92
+ const reported = new Set<string>();
93
+ const report = (progress: CheckProgress) => {
94
+ reported.add(getKey(progress));
95
+ options.onProgress?.(progress);
96
+ };
97
+ // The search on the calling thread prints and reports what this one did while it started, so it
98
+ // skips that.
99
+ const fallBack = () => {
100
+ const skipped = { count: printed.count };
101
+ return checkSequentially({
102
+ ...options,
103
+ config,
104
+ onPrint: (text) => (skipped.count-- > 0 ? undefined : print(text)),
105
+ onProgress: (progress) => {
106
+ if (!reported.has(getKey(progress))) options.onProgress?.(progress);
107
+ },
108
+ });
109
+ };
110
+ const workerCount = options.workers ?? 1;
111
+ // TLC's workers write the -dump state graph in whichever order they find it, so one worker
112
+ // writes the graph a single TLC worker does.
91
113
  const isSequential =
92
- count < 2 ||
114
+ workerCount < 2 ||
115
+ typeof SharedArrayBuffer !== "function" ||
116
+ options.dump !== undefined ||
93
117
  config.view !== undefined ||
94
118
  config.postconditions.length > 0 ||
95
119
  config.possible.length > 0;
@@ -107,17 +131,30 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
107
131
  return bytes;
108
132
  };
109
133
  setStringOrder(getTlcStringOrder(options.source, config, loadModule));
134
+ setValueVersion(options.version);
110
135
  const startupStrings = getRankedStringCount();
111
136
  const specification = createEnvironment(config, {
112
137
  source: options.source,
113
138
  loadModule,
114
139
  loadClass,
115
- print: options.onPrint ?? console.log,
140
+ print: (text) => {
141
+ printed.count++;
142
+ print(text);
143
+ },
116
144
  files: { readFile: options.readFile, writeFile: options.writeFile },
145
+ isTool: options.isTool,
146
+ isTraceRecorded: options.isTraceRecorded,
147
+ isSanyReported: options.isSanyReported,
148
+ isWarningEnabled: options.isWarningEnabled,
149
+ version: options.version,
117
150
  });
151
+ reportStartup(specification, config, report);
118
152
  const environment = specification.environment;
119
- const search = createSearch(config, environment, () =>
120
- getTlcVariableOrder(options.source, loadModule),
153
+ const search = createSearch(
154
+ config,
155
+ environment,
156
+ () => getTlcVariableOrder(options.source, loadModule),
157
+ report,
121
158
  );
122
159
  if (findAssumptionViolation(specification.assumptions, environment)) return fallBack();
123
160
  if (
@@ -131,17 +168,15 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
131
168
  }
132
169
 
133
170
  const canonicalize = createCanonicalizer();
134
- const table = createFingerprintTable();
171
+ const shared = { fingerprints: createSharedFingerprints() };
135
172
  const fingerprint = new Int32Array(2);
136
- const seeds = Array.from({ length: count }, () => ({
137
- encoder: createStateEncoder(),
138
- fingerprints: [] as number[],
139
- }));
173
+ const seeds = Array.from({ length: workerCount }, createStateEncoder);
140
174
  const statistics = {
141
175
  generatedStates: 0,
142
176
  distinctStates: 0,
143
177
  queuedStates: 0,
144
178
  depth: 0,
179
+ initialStates: undefined as InitialStates | undefined,
145
180
  outDegrees: Array.from({ length: OUT_DEGREE_BUCKETS }, () => 0),
146
181
  };
147
182
  const tlcFingerprints: BigInt64Array[] = [];
@@ -166,20 +201,19 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
166
201
  const seedInitialStates = (init: Expression) => {
167
202
  const seeded: Value[][] = [];
168
203
  for (const state of getInitialStates(init, environment, search.spec.scope)) {
204
+ reportInitialStatesProgress(statistics.generatedStates, report);
169
205
  canonicalize(state);
170
206
  statistics.generatedStates++;
171
207
  writeStateFingerprint(search.getFingerprintState(state), fingerprint);
172
- if (!table.insert(fingerprint[0], fingerprint[1])) continue;
208
+ if (isSharedFingerprintsFull(shared.fingerprints)) {
209
+ shared.fingerprints = growSharedFingerprints(shared.fingerprints);
210
+ }
211
+ if (!insertSharedFingerprint(shared.fingerprints, fingerprint[0], fingerprint[1])) continue;
173
212
  if (search.findViolatedInvariant(state) || search.findFailedInitialPredicate(state)) {
174
213
  return false;
175
214
  }
176
- if (!search.satisfiesConstraints(state)) {
177
- table.remove(fingerprint[0], fingerprint[1]);
178
- continue;
179
- }
180
- const seed = seeds[getFingerprintOwner(fingerprint[1], count)];
181
- if (!seed.encoder.encode(state)) return false;
182
- seed.fingerprints.push(fingerprint[0], fingerprint[1]);
215
+ if (!search.satisfiesConstraints(state)) continue;
216
+ if (!seeds[seeded.length % workerCount].encode(state)) return false;
183
217
  seeded.push(state);
184
218
  statistics.distinctStates++;
185
219
  }
@@ -189,6 +223,7 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
189
223
  return true;
190
224
  };
191
225
  // The sequential search reports a violation or a failed evaluation in the initial states.
226
+ report({ kind: "initial-states-started" });
192
227
  try {
193
228
  if (!seedInitialStates(search.spec.init)) return fallBack();
194
229
  } catch (error) {
@@ -197,22 +232,38 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
197
232
  }
198
233
  if (getRankedStringCount() !== startupStrings) return fallBack();
199
234
  statistics.depth = statistics.generatedStates === 0 ? 0 : 1;
235
+ statistics.initialStates = {
236
+ generated: statistics.generatedStates,
237
+ distinct: statistics.distinctStates,
238
+ };
239
+ report({ kind: "initial-states-computed", initialStates: statistics.initialStates });
200
240
  if (statistics.distinctStates === 0) return createSuccess();
201
241
 
202
242
  const reports: WorkerMessage[] = [];
203
- const pending = { resolve: (_reports: WorkerMessage[]) => {} };
243
+ const pending = { count: workerCount, resolve: (_reports: WorkerMessage[]) => {} };
204
244
  const onMessage = (message: WorkerMessage) => {
205
245
  reports.push(message);
206
- if (message.type === "abort" || reports.length === count) {
246
+ if (message.type === "abort" || reports.length === pending.count) {
207
247
  pending.resolve(reports.splice(0));
208
248
  }
209
249
  };
210
- const waitForReports = () =>
250
+ const waitForReports = (expected: number) =>
211
251
  new Promise<WorkerMessage[]>((resolve) => {
252
+ pending.count = expected;
212
253
  pending.resolve = resolve;
213
254
  });
214
- const ready = waitForReports();
215
- const workers = await Promise.all(Array.from({ length: count }, () => spawnWorker(onMessage)));
255
+ const ready = waitForReports(workerCount);
256
+ const requests = new Int32Array(new SharedArrayBuffer(workerCount * 4));
257
+ const remaining = new Int32Array(new SharedArrayBuffer(workerCount * 4));
258
+ const workers = await Promise.all(
259
+ Array.from({ length: workerCount }, () =>
260
+ spawnWorker(
261
+ new URL("./parallel-worker.js", import.meta.url),
262
+ (message) => onMessage(message as WorkerMessage),
263
+ () => onMessage({ type: "abort" }),
264
+ ),
265
+ ),
266
+ );
216
267
  const terminate = () => workers.forEach((worker) => worker.terminate());
217
268
  const channels = new Map<string, MessageChannel>();
218
269
  const getPort = (from: number, to: number) => {
@@ -222,11 +273,10 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
222
273
  return (from < to ? channel.port1 : channel.port2) as unknown as Port;
223
274
  };
224
275
  workers.forEach((worker, index) => {
225
- const ports = Array.from({ length: count }, (_, peer) =>
276
+ const ports = Array.from({ length: workerCount }, (_, peer) =>
226
277
  peer === index ? undefined : getPort(index, peer),
227
278
  );
228
- const seed = seeds[index].encoder.finish();
229
- const seedFingerprints = Int32Array.from(seeds[index].fingerprints);
279
+ const seed = seeds[index].finish();
230
280
  const message: StartMessage = {
231
281
  type: "start",
232
282
  source: options.source,
@@ -234,27 +284,42 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
234
284
  modules: [...modules],
235
285
  classes: [...classes],
236
286
  index,
237
- count,
238
287
  ports,
239
288
  seed,
240
- seedFingerprints,
289
+ isTool: options.isTool,
290
+ isTraceRecorded: options.isTraceRecorded,
291
+ isWarningEnabled: options.isWarningEnabled,
292
+ version: options.version,
293
+ fingerprints: shared.fingerprints,
294
+ requests,
295
+ remaining,
241
296
  };
242
- worker.postMessage(message, [
243
- ...ports.filter((port) => port !== undefined),
244
- seed.words.buffer,
245
- seedFingerprints.buffer,
246
- ]);
297
+ worker.postMessage(message, [...ports.filter((port) => port !== undefined), seed.words.buffer]);
247
298
  });
248
299
  const isAborted = (messages: WorkerMessage[]) =>
249
300
  messages.some((message) => message.type === "abort");
301
+ const send = (message: CoordinatorMessage) =>
302
+ workers.forEach((worker) => worker.postMessage(message));
303
+ // Workers pause when the shared table needs to grow, and resume once it has.
304
+ const collectLevels = async (messages: WorkerMessage[]): Promise<WorkerMessage[]> => {
305
+ const paused = messages.filter((message) => message.type === "paused").length;
306
+ if (paused === 0 || isAborted(messages)) return messages;
307
+ shared.fingerprints = growSharedFingerprints(shared.fingerprints);
308
+ const resumed = waitForReports(paused);
309
+ send({ type: "resize", fingerprints: shared.fingerprints });
310
+ const reported = messages.filter((message) => message.type !== "paused");
311
+ return [...reported, ...(await collectLevels(await resumed))];
312
+ };
250
313
  if (isAborted(await ready)) {
251
314
  terminate();
252
315
  return fallBack();
253
316
  }
254
- for (let level = 1; ; level++) {
255
- const reported = waitForReports();
256
- workers.forEach((worker) => worker.postMessage({ type: "level", level }));
257
- const messages = await reported;
317
+ for (;;) {
318
+ const reported = waitForReports(workerCount);
319
+ // Every worker is idle, so peers can ask any of them for states once the level starts.
320
+ requests.forEach((_, index) => Atomics.store(requests, index, 0));
321
+ send({ type: "level" });
322
+ const messages = await collectLevels(await reported);
258
323
  if (isAborted(messages)) {
259
324
  terminate();
260
325
  return fallBack();