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
@@ -1,107 +1,46 @@
1
- import { createCanonicalizer } from "./canonical";
2
- import { createSearch } from "./check";
3
1
  import { createEnvironment } from "./environment";
4
- import { createFingerprintTable, getFingerprintOwner, writeStateFingerprint } from "./fingerprints";
5
- import type { LevelMessage, Port, StartMessage, WorkerMessage } from "./parallel";
6
- import { getSuccessors } from "./successors";
7
- import { getTlcStringOrder, getTlcVariableOrder } from "./tlc-order";
8
- import { OUT_DEGREE_BUCKETS } from "./tlc-summary";
2
+ import {
3
+ createFingerprintTable,
4
+ insertSharedFingerprint,
5
+ isSharedFingerprintsFull,
6
+ writeStateFingerprint,
7
+ } from "./fingerprints";
8
+ import type { CoordinatorMessage, LevelMessage, StartMessage, WorkerMessage } from "./parallel";
9
+ import { createSearch } from "./search";
10
+ import { getSuccessors, type Successor } from "./successors";
11
+ import { getTlcStringOrder, getTlcVariableOrder } from "./tlc/order";
12
+ import { OUT_DEGREE_BUCKETS } from "./tlc/summary";
9
13
  import { createStateDecoder, createStateEncoder, type EncodedStates } from "./transfer";
10
- import { getRankedStringCount, setStringOrder, type Value } from "./values";
11
-
12
- const WORKER_THREADS_MODULE = "node:worker_threads";
13
-
14
- interface Pending {
14
+ import {
15
+ createCanonicalizer,
16
+ getRankedStringCount,
17
+ setStringOrder,
18
+ setValueVersion,
19
+ type Value,
20
+ } from "./values";
21
+ import { getParentPort, type Port } from "./worker";
22
+
23
+ const LOCKED = -1;
24
+
25
+ interface Expansion {
15
26
  states: Value[][];
16
- origins: number[];
17
- fingerprints: number[];
18
- }
19
-
20
- interface PeerMessage {
21
- phase: "query" | "answer" | "sizes" | "balance";
22
- level: number;
23
- from: number;
24
- fingerprints?: Int32Array;
25
- bits?: Uint8Array;
26
- states?: EncodedStates;
27
- unmarks?: Int32Array;
28
- size?: number;
29
- }
30
-
31
- interface Transfer {
32
- from: number;
33
- to: number;
34
- count: number;
27
+ origin: number;
28
+ end: number;
29
+ successors: Successor[] | undefined;
30
+ index: number;
31
+ added: number;
32
+ generated: number;
33
+ outDegrees: number[];
34
+ next: Value[][];
35
+ fingerprintStates: Value[][];
35
36
  }
36
37
 
37
- const getBalancePlan = (sizes: number[]) => {
38
- const total = sizes.reduce((sum, size) => sum + size, 0);
39
- const average = total / sizes.length;
40
- if (Math.max(...sizes) - Math.min(...sizes) <= Math.max(64, average / 4)) return [];
41
- const targets = sizes.map(
42
- (_, index) => Math.floor(average) + (index < total % sizes.length ? 1 : 0),
43
- );
44
- const donors = sizes.flatMap((size, index) =>
45
- size > targets[index] ? [{ index, amount: size - targets[index] }] : [],
46
- );
47
- const receivers = sizes.flatMap((size, index) =>
48
- size < targets[index] ? [{ index, amount: targets[index] - size }] : [],
49
- );
50
- const transfers: Transfer[] = [];
51
- for (const donor of donors) {
52
- for (const receiver of receivers) {
53
- const moved = Math.min(donor.amount, receiver.amount);
54
- if (moved === 0) continue;
55
- transfers.push({ from: donor.index, to: receiver.index, count: moved });
56
- donor.amount -= moved;
57
- receiver.amount -= moved;
58
- }
59
- }
60
- return transfers;
61
- };
62
-
63
- const getParentPort = async () => {
64
- if (typeof (globalThis as { postMessage?: unknown }).postMessage === "function") {
65
- return globalThis as unknown as Port;
66
- }
67
- const threads: typeof import("node:worker_threads") = await import(
68
- /* @vite-ignore */ /* webpackIgnore: true */ WORKER_THREADS_MODULE
69
- );
70
- return threads.parentPort as unknown as Port;
71
- };
72
-
73
- const createInbox = () => {
74
- const messages = new Map<string, PeerMessage[]>();
75
- const waiters = new Map<string, { count: number; resolve: (messages: PeerMessage[]) => void }>();
76
- const getKey = (phase: PeerMessage["phase"], level: number) => `${phase}:${level}`;
77
- const settle = (key: string) => {
78
- const waiter = waiters.get(key);
79
- const received = messages.get(key) ?? [];
80
- if (!waiter || received.length < waiter.count) return;
81
- waiters.delete(key);
82
- messages.delete(key);
83
- waiter.resolve(received);
84
- };
85
- return {
86
- deliver: (message: PeerMessage) => {
87
- const key = getKey(message.phase, message.level);
88
- messages.set(key, [...(messages.get(key) ?? []), message]);
89
- settle(key);
90
- },
91
- receive: (phase: PeerMessage["phase"], level: number, count: number) =>
92
- new Promise<PeerMessage[]>((resolve) => {
93
- const key = getKey(phase, level);
94
- waiters.set(key, { count, resolve });
95
- settle(key);
96
- }),
97
- };
98
- };
99
-
100
- const run = (start: StartMessage, parent: Port) => {
38
+ const runWorker = (start: StartMessage, parent: Port) => {
101
39
  const modules = new Map(start.modules);
102
40
  const loadModule = (name: string) => modules.get(name);
103
41
  const classes = new Map(start.classes);
104
42
  setStringOrder(getTlcStringOrder(start.source, start.config, loadModule));
43
+ setValueVersion(start.version);
105
44
  const startupStrings = getRankedStringCount();
106
45
  const specification = createEnvironment(start.config, {
107
46
  source: start.source,
@@ -109,6 +48,10 @@ const run = (start: StartMessage, parent: Port) => {
109
48
  loadClass: (name) => classes.get(name),
110
49
  print: () => {},
111
50
  files: { readFile: undefined, writeFile: undefined },
51
+ isTool: start.isTool,
52
+ isTraceRecorded: start.isTraceRecorded,
53
+ isWarningEnabled: start.isWarningEnabled,
54
+ version: start.version,
112
55
  });
113
56
  const environment = specification.environment;
114
57
  const search = createSearch(start.config, environment, () =>
@@ -117,175 +60,181 @@ const run = (start: StartMessage, parent: Port) => {
117
60
  const nextAction = search?.spec.next;
118
61
  if (!search || nextAction === undefined)
119
62
  return parent.postMessage({ type: "abort" } satisfies WorkerMessage);
120
- const count = start.count;
121
- const self = start.index;
63
+ const workerIndex = start.index;
122
64
  const canonicalize = createCanonicalizer();
123
65
  const decode = createStateDecoder(environment.variables.length);
124
- const table = createFingerprintTable();
125
- const known = createFingerprintTable();
66
+ const shared = { fingerprints: start.fingerprints };
67
+ const requests = start.requests;
68
+ const remaining = start.remaining;
69
+ // Under symmetry, a successor the worker generated before has the representative it had then,
70
+ // so the worker skips the search for one.
71
+ const generatedStates = search.isSymmetric ? createFingerprintTable() : undefined;
126
72
  const fingerprint = new Int32Array(2);
127
- const inbox = createInbox();
128
- const peers = start.ports.flatMap((port, index) => (port ? [{ port, index }] : []));
129
- peers.forEach((peer) => {
130
- peer.port.addEventListener("message", (event) => inbox.deliver(event.data as PeerMessage));
131
- peer.port.start?.();
73
+ const waiters = { resume: () => {}, loot: (_states: EncodedStates) => {} };
74
+ start.ports.forEach((port) => {
75
+ port?.addEventListener("message", (event) => waiters.loot(event.data as EncodedStates));
76
+ port?.start?.();
132
77
  });
133
- for (let index = 0; index < start.seedFingerprints.length; index += 2) {
134
- table.insert(start.seedFingerprints[index], start.seedFingerprints[index + 1]);
135
- }
136
78
  const frontier = { states: decode(start.seed).map(canonicalize) };
137
- const send = (index: number, message: PeerMessage, transfer: unknown[]) =>
138
- start.ports[index]?.postMessage(message, transfer);
139
79
 
140
- const expand = (states: Value[][], next: Value[][]) => {
141
- const pending: Pending[] = Array.from({ length: count }, () => ({
142
- states: [],
143
- origins: [],
144
- fingerprints: [],
145
- }));
146
- const statistics = { generated: 0 };
147
- const newStates = new Int32Array(states.length);
148
- for (let origin = 0; origin < states.length; origin++) {
149
- const state = states[origin];
150
- const successors = getSuccessors(nextAction, state, environment, search.spec.scope);
151
- statistics.generated += successors.length;
152
- if (successors.length === 0 && start.config.checkDeadlock) return undefined;
153
- for (const successor of successors) {
80
+ // A worker that runs out of states asks a peer for some by writing its index + 1 to the peer's
81
+ // request word. The peer sends half of the states it hasn't started, keeps expanding, and wakes
82
+ // the workers waiting to ask it next.
83
+ const answerRequest = (expansion: Expansion, request: number) => {
84
+ const thief = Atomics.load(requests, workerIndex) - 1;
85
+ const given = Math.floor((expansion.end - expansion.origin - 1) / 2);
86
+ const encoder = createStateEncoder();
87
+ const states = expansion.states.slice(expansion.end - given, expansion.end);
88
+ const isEncoded = given > 0 && states.every(encoder.encode);
89
+ if (isEncoded) expansion.end -= given;
90
+ const loot = isEncoded ? encoder.finish() : createStateEncoder().finish();
91
+ start.ports[thief]?.postMessage(loot, [loot.words.buffer]);
92
+ Atomics.store(requests, workerIndex, request);
93
+ Atomics.notify(requests, workerIndex);
94
+ };
95
+
96
+ // A worker answers any request before it pauses or runs out of states, and takes no more until
97
+ // it resumes.
98
+ const lockRequests = (expansion: Expansion) => {
99
+ Atomics.store(remaining, workerIndex, 0);
100
+ if (Atomics.compareExchange(requests, workerIndex, 0, LOCKED) === 0) return;
101
+ answerRequest(expansion, LOCKED);
102
+ };
103
+
104
+ const unlockRequests = (expansion: Expansion) => {
105
+ Atomics.store(remaining, workerIndex, expansion.end - expansion.origin);
106
+ Atomics.store(requests, workerIndex, 0);
107
+ };
108
+
109
+ // The worker pauses before a successor when the shared table needs to grow, and resumes there.
110
+ const expand = (expansion: Expansion) => {
111
+ for (; expansion.origin < expansion.end; expansion.origin++) {
112
+ const state = expansion.states[expansion.origin];
113
+ if (!expansion.successors) {
114
+ if (Atomics.load(requests, workerIndex) > 0) answerRequest(expansion, 0);
115
+ Atomics.store(remaining, workerIndex, expansion.end - expansion.origin - 1);
116
+ expansion.successors = getSuccessors(nextAction, state, environment, search.spec.scope);
117
+ expansion.generated += expansion.successors.length;
118
+ if (expansion.successors.length === 0 && start.config.checkDeadlock) return undefined;
119
+ }
120
+ const successors = expansion.successors;
121
+ for (; expansion.index < successors.length; expansion.index++) {
122
+ if (isSharedFingerprintsFull(shared.fingerprints)) return "paused";
123
+ const successor = successors[expansion.index];
154
124
  if (search.findViolatedActionProperty(state, successor.state)) return undefined;
155
- if (!search.satisfiesActionConstraints(state, successor.state)) continue;
156
- canonicalize(successor.state);
157
- writeStateFingerprint(search.getFingerprintState(successor.state), fingerprint);
158
- const owner = getFingerprintOwner(fingerprint[1], count);
159
- if (owner === self) {
160
- if (!table.insert(fingerprint[0], fingerprint[1])) continue;
125
+ if (!search.satisfiesActionConstraints(state, successor.state)) {
126
+ // TLC checks the invariants of every successor it has not seen, even outside the model.
161
127
  if (search.findViolatedInvariant(successor.state, state)) return undefined;
162
- if (!search.satisfiesConstraints(successor.state, state)) {
163
- table.remove(fingerprint[0], fingerprint[1]);
164
- continue;
165
- }
166
- next.push(successor.state);
167
- newStates[origin]++;
168
128
  continue;
169
129
  }
170
- if (!known.insert(fingerprint[0], fingerprint[1])) continue;
171
- pending[owner].states.push(successor.state);
172
- pending[owner].origins.push(origin);
173
- pending[owner].fingerprints.push(fingerprint[0], fingerprint[1]);
130
+ if (generatedStates) {
131
+ writeStateFingerprint(successor.state, fingerprint);
132
+ if (!generatedStates.insert(fingerprint[0], fingerprint[1])) continue;
133
+ }
134
+ canonicalize(successor.state);
135
+ const fingerprintState = search.getFingerprintState(successor.state);
136
+ writeStateFingerprint(fingerprintState, fingerprint);
137
+ if (!insertSharedFingerprint(shared.fingerprints, fingerprint[0], fingerprint[1])) continue;
138
+ if (search.findViolatedInvariant(successor.state, state)) return undefined;
139
+ if (!search.satisfiesConstraints(successor.state, state)) continue;
140
+ expansion.next.push(successor.state);
141
+ expansion.fingerprintStates.push(fingerprintState);
142
+ expansion.added++;
174
143
  }
144
+ expansion.outDegrees[Math.min(expansion.added, OUT_DEGREE_BUCKETS - 1)]++;
145
+ expansion.successors = undefined;
146
+ expansion.index = 0;
147
+ expansion.added = 0;
175
148
  }
176
- return { pending, generated: statistics.generated, newStates };
149
+ return "done";
177
150
  };
178
151
 
179
- const answer = (fingerprints: Int32Array | number[]) => {
180
- const bits = new Uint8Array(fingerprints.length / 2);
181
- for (let index = 0; index < bits.length; index++) {
182
- bits[index] = table.insert(fingerprints[index * 2], fingerprints[index * 2 + 1]) ? 1 : 0;
183
- }
184
- return bits;
185
- };
186
-
187
- const commit = (pending: Pending, bits: Uint8Array, next: Value[][], newStates: Int32Array) => {
188
- const unmarks: number[] = [];
189
- for (let index = 0; index < bits.length; index++) {
190
- if (bits[index] === 0) continue;
191
- const state = pending.states[index];
192
- const parentState = frontier.states[pending.origins[index]];
193
- if (search.findViolatedInvariant(state, parentState)) return undefined;
194
- if (search.satisfiesConstraints(state, parentState)) {
195
- next.push(state);
196
- newStates[pending.origins[index]]++;
152
+ // Each attempt asks the peer with the most states left. While another worker's request to that
153
+ // peer is open, the worker waits for the peer to answer it. The worker stops once no peer that
154
+ // takes requests has two states left.
155
+ const steal = async (expansion: Expansion) => {
156
+ const skipped = new Set<number>();
157
+ for (;;) {
158
+ const victim = start.ports.reduce<number | undefined>((best, port, index) => {
159
+ if (!port || skipped.has(index) || Atomics.load(remaining, index) < 2) return best;
160
+ return best === undefined || Atomics.load(remaining, index) > Atomics.load(remaining, best)
161
+ ? index
162
+ : best;
163
+ }, undefined);
164
+ if (victim === undefined) return false;
165
+ const request = Atomics.compareExchange(requests, victim, 0, workerIndex + 1);
166
+ if (request === LOCKED) skipped.add(victim);
167
+ if (request > 0) Atomics.wait(requests, victim, request);
168
+ if (request !== 0) continue;
169
+ const loot = await new Promise<EncodedStates>((resolve) => (waiters.loot = resolve));
170
+ if (loot.count === 0) {
171
+ skipped.add(victim);
197
172
  continue;
198
173
  }
199
- known.remove(pending.fingerprints[index * 2], pending.fingerprints[index * 2 + 1]);
200
- unmarks.push(pending.fingerprints[index * 2], pending.fingerprints[index * 2 + 1]);
201
- }
202
- return Int32Array.from(unmarks);
203
- };
204
-
205
- const removeAll = (fingerprints: Int32Array) => {
206
- for (let index = 0; index < fingerprints.length; index += 2) {
207
- table.remove(fingerprints[index], fingerprints[index + 1]);
174
+ expansion.states = decode(loot).map(canonicalize);
175
+ expansion.origin = 0;
176
+ expansion.end = expansion.states.length;
177
+ unlockRequests(expansion);
178
+ return true;
208
179
  }
209
180
  };
210
181
 
211
- const balance = async (level: number, next: Value[][], sizes: number[]) => {
212
- const transfers = getBalancePlan(sizes);
213
- if (transfers.length === 0) return true;
214
- const outgoing = new Map(peers.map((peer) => [peer.index, createStateEncoder()]));
215
- for (const transfer of transfers.filter((candidate) => candidate.from === self)) {
216
- const encoder = outgoing.get(transfer.to);
217
- const states = next.splice(next.length - transfer.count, transfer.count);
218
- if (!encoder || !states.every(encoder.encode)) return false;
219
- }
220
- outgoing.forEach((encoder, index) => {
221
- const states = encoder.finish();
222
- send(index, { phase: "balance", level, from: self, states }, [states.words.buffer]);
223
- });
224
- const incoming = await inbox.receive("balance", level, peers.length);
225
- incoming.forEach((message) => {
226
- if (message.states) next.push(...decode(message.states).map(canonicalize));
227
- });
228
- return true;
229
- };
182
+ const report = (message: WorkerMessage) =>
183
+ parent.postMessage(message, message.type === "level" ? [message.fingerprints.buffer] : []);
230
184
 
231
- const runLevel = async (level: number): Promise<LevelMessage | undefined> => {
232
- const next: Value[][] = [];
233
- const expanded = expand(frontier.states, next);
234
- if (!expanded || getRankedStringCount() !== startupStrings) return undefined;
235
- peers.forEach((peer) => {
236
- const fingerprints = Int32Array.from(expanded.pending[peer.index].fingerprints);
237
- send(peer.index, { phase: "query", level, from: self, fingerprints }, [fingerprints.buffer]);
238
- });
239
- const queries = await inbox.receive("query", level, peers.length);
240
- queries.forEach((query) => {
241
- const bits = answer(query.fingerprints ?? []);
242
- send(query.from, { phase: "answer", level, from: self, bits }, [bits.buffer]);
243
- });
244
- const answers = await inbox.receive("answer", level, peers.length);
245
- for (const reply of answers) {
246
- const unmarks = commit(
247
- expanded.pending[reply.from],
248
- reply.bits ?? new Uint8Array(),
249
- next,
250
- expanded.newStates,
251
- );
252
- if (!unmarks) return undefined;
253
- send(reply.from, { phase: "sizes", level, from: self, unmarks }, [unmarks.buffer]);
185
+ const runLevel = async (): Promise<LevelMessage | undefined> => {
186
+ const expansion: Expansion = {
187
+ states: frontier.states,
188
+ origin: 0,
189
+ end: frontier.states.length,
190
+ successors: undefined,
191
+ index: 0,
192
+ added: 0,
193
+ generated: 0,
194
+ outDegrees: Array.from({ length: OUT_DEGREE_BUCKETS }, () => 0),
195
+ next: [],
196
+ fingerprintStates: [],
197
+ };
198
+ for (;;) {
199
+ const status = expand(expansion);
200
+ if (status === undefined) return undefined;
201
+ lockRequests(expansion);
202
+ if (status === "paused") {
203
+ const resumed = new Promise<void>((resolve) => (waiters.resume = resolve));
204
+ report({ type: "paused" });
205
+ await resumed;
206
+ unlockRequests(expansion);
207
+ continue;
208
+ }
209
+ if (!(await steal(expansion))) break;
254
210
  }
255
- const added = next.length;
256
- const outDegrees = Array.from({ length: OUT_DEGREE_BUCKETS }, () => 0);
257
- expanded.newStates.forEach((degree) => outDegrees[Math.min(degree, OUT_DEGREE_BUCKETS - 1)]++);
258
- const fingerprints = BigInt64Array.from(next, (state) =>
259
- environment.runtime.getFingerprint(state),
260
- );
261
- const sizes = Array.from({ length: count }, () => 0);
262
- sizes[self] = added;
263
- peers.forEach((peer) =>
264
- send(peer.index, { phase: "sizes", level, from: self, size: added }, []),
265
- );
266
- const received = await inbox.receive("sizes", level, peers.length * 2);
267
- received.forEach((message) => {
268
- if (message.unmarks) removeAll(message.unmarks);
269
- else sizes[message.from] = message.size ?? 0;
270
- });
271
211
  if (getRankedStringCount() !== startupStrings) return undefined;
272
- if (!(await balance(level, next, sizes))) return undefined;
273
- frontier.states = next;
274
- return { type: "level", level, generated: expanded.generated, added, outDegrees, fingerprints };
212
+ frontier.states = expansion.next;
213
+ Atomics.store(remaining, workerIndex, frontier.states.length);
214
+ return {
215
+ type: "level",
216
+ generated: expansion.generated,
217
+ added: expansion.next.length,
218
+ outDegrees: expansion.outDegrees,
219
+ fingerprints: search.getStoredFingerprints(expansion.next, expansion.fingerprintStates),
220
+ };
275
221
  };
276
222
 
277
- const report = (message: WorkerMessage) =>
278
- parent.postMessage(message, message.type === "level" ? [message.fingerprints.buffer] : []);
279
- const step = (level: number) => {
280
- runLevel(level).then(
223
+ const startLevel = () => {
224
+ runLevel().then(
281
225
  (message) => report(message ?? { type: "abort" }),
282
226
  () => report({ type: "abort" }),
283
227
  );
284
228
  };
285
229
  parent.addEventListener("message", (event) => {
286
- const message = event.data as { type: string; level: number };
287
- if (message.type === "level") step(message.level);
230
+ const message = event.data as CoordinatorMessage;
231
+ if (message.type === "level") startLevel();
232
+ if (message.type === "resize") {
233
+ shared.fingerprints = message.fingerprints;
234
+ waiters.resume();
235
+ }
288
236
  });
237
+ Atomics.store(remaining, workerIndex, frontier.states.length);
289
238
  report({ type: "ready" });
290
239
  };
291
240
 
@@ -295,7 +244,7 @@ void getParentPort().then((parent) => {
295
244
  if (message.type !== "start") return;
296
245
  parent.removeEventListener?.("message", onStart);
297
246
  try {
298
- run(message, parent);
247
+ runWorker(message, parent);
299
248
  } catch {
300
249
  parent.postMessage({ type: "abort" } satisfies WorkerMessage);
301
250
  }