tla-ts 0.0.3 → 0.0.4-dev.2a873ee

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 (370) 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 +996 -0
  17. package/dist/prove.js +996 -0
  18. package/dist/run-cli.cjs +37 -20
  19. package/dist/run-cli.js +37 -20
  20. package/dist/tlapm.cjs +10 -0
  21. package/dist/tlapm.js +10 -0
  22. package/dist/transfer.cjs +1387 -18
  23. package/dist/transfer.js +1387 -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 +4 -7
  29. package/src/builtins.ts +29 -11
  30. package/src/bundled-modules.ts +3 -3
  31. package/src/canonical.ts +4 -3
  32. package/src/check.ts +1540 -235
  33. package/src/cli-options.ts +12 -6
  34. package/src/cli.ts +8 -1
  35. package/src/codegen.ts +98 -39
  36. package/src/config.ts +254 -181
  37. package/src/dependencies.ts +2 -2
  38. package/src/environment.ts +540 -140
  39. package/src/errors.ts +284 -4
  40. package/src/evaluate.ts +1043 -293
  41. package/src/exit-codes.ts +22 -43
  42. package/src/fingerprints.ts +46 -11
  43. package/src/index.ts +11 -0
  44. package/src/instances.ts +19 -16
  45. package/src/java-overrides.ts +104 -25
  46. package/src/levels.ts +191 -45
  47. package/src/lexer.ts +127 -30
  48. package/src/live-check.ts +867 -0
  49. package/src/liveness.ts +218 -572
  50. package/src/{obligation-action.ts → obligations/action.ts} +247 -69
  51. package/src/{obligation-anon.ts → obligations/anon.ts} +49 -47
  52. package/src/obligations/ctx.ts +64 -0
  53. package/src/{obligation-deref.ts → obligations/deref.ts} +51 -92
  54. package/src/{obligation-expression.ts → obligations/expression.ts} +117 -57
  55. package/src/{obligation-format.ts → obligations/format.ts} +7 -8
  56. package/src/{obligation-generate.ts → obligations/generate.ts} +170 -192
  57. package/src/{obligations.ts → obligations/index.ts} +32 -16
  58. package/src/{obligation-levels.ts → obligations/levels.ts} +26 -28
  59. package/src/{obligation-module.ts → obligations/module.ts} +113 -121
  60. package/src/obligations/pickle.ts +98 -0
  61. package/src/obligations/pragma.ts +189 -0
  62. package/src/{obligation-printer.ts → obligations/printer.ts} +22 -80
  63. package/src/{obligation-proof.ts → obligations/proof.ts} +7 -2
  64. package/src/{obligation-source.ts → obligations/source.ts} +156 -99
  65. package/src/obligations/temporal.ts +321 -0
  66. package/src/{obligation-tuples.ts → obligations/tuples.ts} +38 -54
  67. package/src/ocaml-marshal.ts +166 -0
  68. package/src/parallel-worker.ts +169 -224
  69. package/src/parallel.ts +140 -81
  70. package/src/parser.ts +456 -147
  71. package/src/pcal-ast.ts +770 -0
  72. package/src/pcal-parse.ts +1523 -0
  73. package/src/pcal-tokenize.ts +516 -0
  74. package/src/pcal-translate.ts +1230 -0
  75. package/src/pcal-validate.ts +454 -0
  76. package/src/prove/decide-pool.ts +95 -0
  77. package/src/prove/deciders.ts +33 -0
  78. package/src/prove/first-order.ts +78 -0
  79. package/src/prove/isabelle/LICENSE +36 -0
  80. package/src/prove/isabelle/LICENSE-tlapm +26 -0
  81. package/src/prove/isabelle/decide.ts +47 -0
  82. package/src/prove/isabelle/encode.ts +446 -0
  83. package/src/prove/isabelle/isar/inner-syntax.ts +579 -0
  84. package/src/prove/isabelle/isar/method.ts +367 -0
  85. package/src/prove/isabelle/isar/proof.ts +28 -0
  86. package/src/prove/isabelle/isar/statement.ts +57 -0
  87. package/src/prove/isabelle/isar/theory.ts +192 -0
  88. package/src/prove/isabelle/isar/type-check.ts +278 -0
  89. package/src/prove/isabelle/provers/blast/blast.ts +258 -0
  90. package/src/prove/isabelle/provers/blast/branch.ts +322 -0
  91. package/src/prove/isabelle/provers/blast/prove.ts +347 -0
  92. package/src/prove/isabelle/provers/blast/rules.ts +330 -0
  93. package/src/prove/isabelle/provers/blast/state.ts +180 -0
  94. package/src/prove/isabelle/provers/blast/term.ts +546 -0
  95. package/src/prove/isabelle/provers/clasimp.ts +150 -0
  96. package/src/prove/isabelle/provers/classical.ts +389 -0
  97. package/src/prove/isabelle/provers/hypsubst.ts +433 -0
  98. package/src/prove/isabelle/pure/bicompose.ts +174 -0
  99. package/src/prove/isabelle/pure/consts.ts +32 -0
  100. package/src/prove/isabelle/pure/conv.ts +79 -0
  101. package/src/prove/isabelle/pure/drule.ts +264 -0
  102. package/src/prove/isabelle/pure/envir.ts +331 -0
  103. package/src/prove/isabelle/pure/goal.ts +53 -0
  104. package/src/prove/isabelle/pure/interrupt.ts +16 -0
  105. package/src/prove/isabelle/pure/list.ts +12 -0
  106. package/src/prove/isabelle/pure/logic.ts +330 -0
  107. package/src/prove/isabelle/pure/name.ts +98 -0
  108. package/src/prove/isabelle/pure/net.ts +215 -0
  109. package/src/prove/isabelle/pure/object-logic.ts +41 -0
  110. package/src/prove/isabelle/pure/pattern.ts +631 -0
  111. package/src/prove/isabelle/pure/raw-simplifier.ts +338 -0
  112. package/src/prove/isabelle/pure/rewriter.ts +602 -0
  113. package/src/prove/isabelle/pure/search.ts +68 -0
  114. package/src/prove/isabelle/pure/seq.ts +133 -0
  115. package/src/prove/isabelle/pure/simplifier.ts +106 -0
  116. package/src/prove/isabelle/pure/table.ts +201 -0
  117. package/src/prove/isabelle/pure/tactic.ts +168 -0
  118. package/src/prove/isabelle/pure/tactical.ts +264 -0
  119. package/src/prove/isabelle/pure/term-ord.ts +105 -0
  120. package/src/prove/isabelle/pure/term.ts +688 -0
  121. package/src/prove/isabelle/pure/thm.ts +783 -0
  122. package/src/prove/isabelle/pure/type.ts +121 -0
  123. package/src/prove/isabelle/pure/unify.ts +753 -0
  124. package/src/prove/isabelle/pure/variable.ts +25 -0
  125. package/src/prove/isabelle/tla/classical-setup.ts +101 -0
  126. package/src/prove/isabelle/tla/context.ts +74 -0
  127. package/src/prove/isabelle/tla/logic-data.ts +5 -0
  128. package/src/prove/isabelle/tla/logic.ts +215 -0
  129. package/src/prove/isabelle/tla/simpdata.ts +241 -0
  130. package/src/prove/isabelle/tools/intuitionistic.ts +132 -0
  131. package/src/prove/ocaml.ts +22 -0
  132. package/src/prove/prep/action.ts +508 -0
  133. package/src/prove/prep/defs.ts +33 -0
  134. package/src/prove/prep/elab.ts +156 -0
  135. package/src/prove/prep/enabled-axioms.ts +189 -0
  136. package/src/prove/prep/enabled.ts +43 -0
  137. package/src/prove/prep/fingerprint.ts +388 -0
  138. package/src/prove/prep/flatten.ts +70 -0
  139. package/src/prove/prep/level-comparison.ts +529 -0
  140. package/src/prove/prep/md5.ts +67 -0
  141. package/src/prove/prep/pragma.ts +221 -0
  142. package/src/prove/prep/trivial.ts +22 -0
  143. package/src/prove/prove-worker.ts +22 -0
  144. package/src/prove/prove.ts +498 -0
  145. package/src/prove/ptl/decide.ts +68 -0
  146. package/src/prove/ptl/encode.ts +255 -0
  147. package/src/prove/ptl/sat.ts +151 -0
  148. package/src/prove/ptl/tableau.ts +276 -0
  149. package/src/prove/smt/axiomatize.ts +69 -0
  150. package/src/prove/smt/axioms.ts +209 -0
  151. package/src/prove/smt/context.ts +108 -0
  152. package/src/prove/smt/data.ts +636 -0
  153. package/src/prove/smt/encode.ts +164 -0
  154. package/src/prove/smt/extensionality.ts +65 -0
  155. package/src/prove/smt/flatten.ts +112 -0
  156. package/src/prove/smt/format.ts +154 -0
  157. package/src/prove/smt/instances.ts +181 -0
  158. package/src/prove/smt/rewrite.ts +772 -0
  159. package/src/prove/smt/simplify.ts +57 -0
  160. package/src/prove/smt/solver/act-cache.ts +265 -0
  161. package/src/prove/smt/solver/arith-rewriter.ts +962 -0
  162. package/src/prove/smt/solver/array.ts +22 -0
  163. package/src/prove/smt/solver/asserted-formulas.ts +469 -0
  164. package/src/prove/smt/solver/ast-lt.ts +157 -0
  165. package/src/prove/smt/solver/ast-util.ts +91 -0
  166. package/src/prove/smt/solver/ast.ts +1315 -0
  167. package/src/prove/smt/solver/auf-solver.ts +572 -0
  168. package/src/prove/smt/solver/case-split-queue.ts +178 -0
  169. package/src/prove/smt/solver/cg-table.ts +175 -0
  170. package/src/prove/smt/solver/clause.ts +276 -0
  171. package/src/prove/smt/solver/conflict-resolution.ts +343 -0
  172. package/src/prove/smt/solver/context.ts +1292 -0
  173. package/src/prove/smt/solver/ctx-simplify.ts +334 -0
  174. package/src/prove/smt/solver/der.ts +224 -0
  175. package/src/prove/smt/solver/dyn-ack.ts +141 -0
  176. package/src/prove/smt/solver/e-matching.ts +659 -0
  177. package/src/prove/smt/solver/enode.ts +259 -0
  178. package/src/prove/smt/solver/expr-ref.ts +21 -0
  179. package/src/prove/smt/solver/expr-safe-replace.ts +172 -0
  180. package/src/prove/smt/solver/fingerprints.ts +92 -0
  181. package/src/prove/smt/solver/flat-literals.ts +51 -0
  182. package/src/prove/smt/solver/goal.ts +138 -0
  183. package/src/prove/smt/solver/hash.ts +173 -0
  184. package/src/prove/smt/solver/hashtable.ts +166 -0
  185. package/src/prove/smt/solver/internalizer.ts +1381 -0
  186. package/src/prove/smt/solver/lbool.ts +5 -0
  187. package/src/prove/smt/solver/literal.ts +24 -0
  188. package/src/prove/smt/solver/lp/bound-propagator.ts +391 -0
  189. package/src/prove/smt/solver/lp/constraints.ts +78 -0
  190. package/src/prove/smt/solver/lp/containers.ts +296 -0
  191. package/src/prove/smt/solver/lp/core-solver.ts +504 -0
  192. package/src/prove/smt/solver/lp/cross-nested.ts +224 -0
  193. package/src/prove/smt/solver/lp/dep-intervals.ts +642 -0
  194. package/src/prove/smt/solver/lp/dependency.ts +51 -0
  195. package/src/prove/smt/solver/lp/dioph-eq.ts +1181 -0
  196. package/src/prove/smt/solver/lp/explanation.ts +46 -0
  197. package/src/prove/smt/solver/lp/gomory.ts +255 -0
  198. package/src/prove/smt/solver/lp/hnf-cutter.ts +125 -0
  199. package/src/prove/smt/solver/lp/hnf.ts +281 -0
  200. package/src/prove/smt/solver/lp/int-cube.ts +295 -0
  201. package/src/prove/smt/solver/lp/int-solver.ts +514 -0
  202. package/src/prove/smt/solver/lp/lar-solver.ts +816 -0
  203. package/src/prove/smt/solver/lp/lar-term.ts +62 -0
  204. package/src/prove/smt/solver/lp/lp-settings.ts +91 -0
  205. package/src/prove/smt/solver/lp/maximize-term.ts +347 -0
  206. package/src/prove/smt/solver/lp/nex-creator.ts +381 -0
  207. package/src/prove/smt/solver/lp/nex.ts +120 -0
  208. package/src/prove/smt/solver/lp/nla-backoff.ts +43 -0
  209. package/src/prove/smt/solver/lp/nla-basics.ts +398 -0
  210. package/src/prove/smt/solver/lp/nla-core.ts +968 -0
  211. package/src/prove/smt/solver/lp/nla-divisions.ts +332 -0
  212. package/src/prove/smt/solver/lp/nla-emonics.ts +373 -0
  213. package/src/prove/smt/solver/lp/nla-factorization.ts +30 -0
  214. package/src/prove/smt/solver/lp/nla-grobner.ts +904 -0
  215. package/src/prove/smt/solver/lp/nla-horner.ts +126 -0
  216. package/src/prove/smt/solver/lp/nla-intervals.ts +265 -0
  217. package/src/prove/smt/solver/lp/nla-monomial-bounds.ts +715 -0
  218. package/src/prove/smt/solver/lp/nla-monotone.ts +59 -0
  219. package/src/prove/smt/solver/lp/nla-order.ts +307 -0
  220. package/src/prove/smt/solver/lp/nla-patcher.ts +112 -0
  221. package/src/prove/smt/solver/lp/nla-tangents.ts +251 -0
  222. package/src/prove/smt/solver/lp/nla-throttle.ts +85 -0
  223. package/src/prove/smt/solver/lp/nla-types.ts +124 -0
  224. package/src/prove/smt/solver/lp/nla-var-eqs.ts +141 -0
  225. package/src/prove/smt/solver/lp/nra-solver.ts +440 -0
  226. package/src/prove/smt/solver/lp/numeric-pair.ts +65 -0
  227. package/src/prove/smt/solver/lp/pdd-interval.ts +31 -0
  228. package/src/prove/smt/solver/lp/pdd-simplifier.ts +184 -0
  229. package/src/prove/smt/solver/lp/pdd-solver.ts +408 -0
  230. package/src/prove/smt/solver/lp/pdd.ts +971 -0
  231. package/src/prove/smt/solver/lp/random-updater.ts +138 -0
  232. package/src/prove/smt/solver/lp/static-matrix.ts +246 -0
  233. package/src/prove/smt/solver/lp/union-find.ts +96 -0
  234. package/src/prove/smt/solver/mam-compiler.ts +847 -0
  235. package/src/prove/smt/solver/mam-interpreter.ts +400 -0
  236. package/src/prove/smt/solver/maximize-ac-sharing.ts +118 -0
  237. package/src/prove/smt/solver/model-checker.ts +347 -0
  238. package/src/prove/smt/solver/model-evaluator.ts +262 -0
  239. package/src/prove/smt/solver/model-finder.ts +155 -0
  240. package/src/prove/smt/solver/model-generator.ts +97 -0
  241. package/src/prove/smt/solver/model-macro-solver.ts +728 -0
  242. package/src/prove/smt/solver/nlsat/algebraic.ts +1161 -0
  243. package/src/prove/smt/solver/nlsat/atoms.ts +238 -0
  244. package/src/prove/smt/solver/nlsat/evaluator.ts +303 -0
  245. package/src/prove/smt/solver/nlsat/explain.ts +607 -0
  246. package/src/prove/smt/solver/nlsat/interval-set.ts +351 -0
  247. package/src/prove/smt/solver/nlsat/levelwise.ts +737 -0
  248. package/src/prove/smt/solver/nlsat/mpbq.ts +161 -0
  249. package/src/prove/smt/solver/nlsat/polynomial.ts +1722 -0
  250. package/src/prove/smt/solver/nlsat/solver.ts +911 -0
  251. package/src/prove/smt/solver/nlsat/types.ts +43 -0
  252. package/src/prove/smt/solver/nlsat/upolynomial-factorization.ts +648 -0
  253. package/src/prove/smt/solver/nlsat/upolynomial.ts +996 -0
  254. package/src/prove/smt/solver/nnf.ts +469 -0
  255. package/src/prove/smt/solver/pattern-inference.ts +351 -0
  256. package/src/prove/smt/solver/poly-rewriter.ts +477 -0
  257. package/src/prove/smt/solver/propagate-values.ts +83 -0
  258. package/src/prove/smt/solver/proto-model.ts +551 -0
  259. package/src/prove/smt/solver/pull-quant.ts +139 -0
  260. package/src/prove/smt/solver/qe-lite-der.ts +526 -0
  261. package/src/prove/smt/solver/qe-lite-fm.ts +576 -0
  262. package/src/prove/smt/solver/qe-lite.ts +381 -0
  263. package/src/prove/smt/solver/qi-queue.ts +362 -0
  264. package/src/prove/smt/solver/quant-tactics.ts +117 -0
  265. package/src/prove/smt/solver/quantifier-analyzer.ts +562 -0
  266. package/src/prove/smt/solver/quantifier-manager.ts +186 -0
  267. package/src/prove/smt/solver/random-gen.ts +10 -0
  268. package/src/prove/smt/solver/rational.ts +165 -0
  269. package/src/prove/smt/solver/ref-vector.ts +62 -0
  270. package/src/prove/smt/solver/relevancy.ts +247 -0
  271. package/src/prove/smt/solver/rewriter-tpl.ts +1159 -0
  272. package/src/prove/smt/solver/rewriter.ts +843 -0
  273. package/src/prove/smt/solver/rlimit.ts +79 -0
  274. package/src/prove/smt/solver/smtlib-parser.ts +526 -0
  275. package/src/prove/smt/solver/solver.ts +71 -0
  276. package/src/prove/smt/solver/sort.ts +35 -0
  277. package/src/prove/smt/solver/sticky-generations.ts +69 -0
  278. package/src/prove/smt/solver/theory-lra-axioms.ts +340 -0
  279. package/src/prove/smt/solver/theory-lra-bounds.ts +226 -0
  280. package/src/prove/smt/solver/theory-lra-final-check.ts +252 -0
  281. package/src/prove/smt/solver/theory-lra-internalize.ts +476 -0
  282. package/src/prove/smt/solver/theory-lra-model.ts +243 -0
  283. package/src/prove/smt/solver/theory-lra-propagate.ts +405 -0
  284. package/src/prove/smt/solver/theory-lra-state.ts +43 -0
  285. package/src/prove/smt/solver/theory-lra.ts +56 -0
  286. package/src/prove/smt/solver/var-subst.ts +258 -0
  287. package/src/prove/smt/solver/z3-license.txt +10 -0
  288. package/src/prove/smt/table.ts +170 -0
  289. package/src/prove/tlapm/tlapm.ts +96 -0
  290. package/src/prove/tlaps-module.ts +510 -0
  291. package/src/prove/verdict.ts +18 -0
  292. package/src/prove/zenon/LICENSE +32 -0
  293. package/src/prove/zenon/check/check.ts +105 -0
  294. package/src/prove/zenon/check/definitions.ts +144 -0
  295. package/src/prove/zenon/check/equality.ts +182 -0
  296. package/src/prove/zenon/check/functions.ts +62 -0
  297. package/src/prove/zenon/check/keys.ts +125 -0
  298. package/src/prove/zenon/check/propositional.ts +104 -0
  299. package/src/prove/zenon/check/records.ts +188 -0
  300. package/src/prove/zenon/check/relations.ts +121 -0
  301. package/src/prove/zenon/check/rewrites.ts +224 -0
  302. package/src/prove/zenon/check/sets.ts +302 -0
  303. package/src/prove/zenon/check/terms.ts +127 -0
  304. package/src/prove/zenon/check/tla.ts +126 -0
  305. package/src/prove/zenon/decide.ts +113 -0
  306. package/src/prove/zenon/encode.ts +379 -0
  307. package/src/prove/zenon/eqrel.ts +300 -0
  308. package/src/prove/zenon/equality-rules.ts +435 -0
  309. package/src/prove/zenon/expr.ts +551 -0
  310. package/src/prove/zenon/index-table.ts +350 -0
  311. package/src/prove/zenon/isar-case.ts +513 -0
  312. package/src/prove/zenon/isar.ts +1249 -0
  313. package/src/prove/zenon/limits.ts +15 -0
  314. package/src/prove/zenon/llproof.ts +173 -0
  315. package/src/prove/zenon/mltoll.ts +1566 -0
  316. package/src/prove/zenon/node.ts +297 -0
  317. package/src/prove/zenon/ocaml.ts +169 -0
  318. package/src/prove/zenon/parse.ts +247 -0
  319. package/src/prove/zenon/phrase.ts +191 -0
  320. package/src/prove/zenon/proof.ts +198 -0
  321. package/src/prove/zenon/propositional-rules.ts +387 -0
  322. package/src/prove/zenon/rules.ts +94 -0
  323. package/src/prove/zenon/search.ts +288 -0
  324. package/src/prove/zenon/tla/functions.ts +151 -0
  325. package/src/prove/zenon/tla/llproof.ts +480 -0
  326. package/src/prove/zenon/tla/records.ts +225 -0
  327. package/src/prove/zenon/tla/rewrites.ts +447 -0
  328. package/src/prove/zenon/tla/sets.ts +304 -0
  329. package/src/prove/zenon/tla/terms.ts +162 -0
  330. package/src/prove/zenon/tla/tla.ts +506 -0
  331. package/src/randomization.ts +24 -7
  332. package/src/resolve.ts +1481 -426
  333. package/src/run-cli.ts +1483 -212
  334. package/src/runtime.ts +19 -1
  335. package/src/sany-builtins.ts +147 -0
  336. package/src/sany-generator.ts +3128 -0
  337. package/src/sany-levels.ts +1208 -0
  338. package/src/sany-lexer.ts +545 -0
  339. package/src/sany-linter.ts +122 -0
  340. package/src/sany-modules.ts +1398 -0
  341. package/src/sany-nodes.ts +463 -0
  342. package/src/sany-parse-error.ts +2161 -0
  343. package/src/sany-report.ts +356 -0
  344. package/src/sany-selectors.ts +738 -0
  345. package/src/sany-source.ts +248 -0
  346. package/src/sany-xml.ts +1017 -0
  347. package/src/spec-description.ts +42 -11
  348. package/src/standard-modules.ts +203 -148
  349. package/src/standard-ranges.ts +116 -0
  350. package/src/state-graph.ts +180 -0
  351. package/src/subexpressions.ts +231 -171
  352. package/src/substitution-levels.ts +38 -17
  353. package/src/successors.ts +241 -110
  354. package/src/symmetry.ts +194 -54
  355. package/src/tableau.ts +54 -25
  356. package/src/tlapm-cache.ts +236 -0
  357. package/src/tlc-ext.ts +42 -29
  358. package/src/tlc-messages.ts +329 -0
  359. package/src/tlc-module.ts +52 -43
  360. package/src/tlc-modules.ts +4 -0
  361. package/src/tlc-order.ts +78 -10
  362. package/src/tlc-random.ts +84 -33
  363. package/src/tlc-replay.ts +655 -0
  364. package/src/tlc-summary.ts +20 -5
  365. package/src/tlc-version.ts +19 -0
  366. package/src/transfer.ts +15 -3
  367. package/src/values.ts +787 -190
  368. package/src/worker.ts +65 -0
  369. package/dist/parallel.cjs +0 -12
  370. package/dist/parallel.js +0 -12
package/src/parallel.ts CHANGED
@@ -4,28 +4,32 @@ import {
4
4
  checkSequentially,
5
5
  createSearch,
6
6
  findAssumptionViolation,
7
+ reportInitialStatesProgress,
8
+ reportStartup,
7
9
  type CheckOptions,
10
+ type CheckProgress,
8
11
  type CheckResult,
12
+ type InitialStates,
9
13
  } from "./check";
10
14
  import { parseConfig, type ModelConfig } from "./config";
11
15
  import { createEnvironment } from "./environment";
12
16
  import { TlaEvaluationError } from "./errors";
13
17
  import { isImpure } from "./evaluate";
14
- import { createFingerprintTable, getFingerprintOwner, writeStateFingerprint } from "./fingerprints";
18
+ import {
19
+ createSharedFingerprints,
20
+ growSharedFingerprints,
21
+ insertSharedFingerprint,
22
+ isSharedFingerprintsFull,
23
+ writeStateFingerprint,
24
+ type SharedFingerprints,
25
+ } from "./fingerprints";
15
26
  import { getInitialStates } from "./successors";
16
27
  import { getTlcStringOrder, getTlcVariableOrder } from "./tlc-order";
17
28
  import { getFingerprintDistance, OUT_DEGREE_BUCKETS } from "./tlc-summary";
18
29
  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
- }
30
+ import type { TlcVersion } from "./tlc-version";
31
+ import { getRankedStringCount, setStringOrder, setValueVersion, type Value } from "./values";
32
+ import { spawnWorker, type Port } from "./worker";
29
33
 
30
34
  export interface StartMessage {
31
35
  type: "start";
@@ -34,10 +38,15 @@ export interface StartMessage {
34
38
  modules: [string, string | undefined][];
35
39
  classes: [string, Uint8Array | undefined][];
36
40
  index: number;
37
- count: number;
38
41
  ports: (Port | undefined)[];
39
42
  seed: EncodedStates;
40
- seedFingerprints: Int32Array;
43
+ isTool: boolean | undefined;
44
+ isTraceRecorded: boolean | undefined;
45
+ isWarningEnabled: boolean | undefined;
46
+ version: TlcVersion | undefined;
47
+ fingerprints: SharedFingerprints;
48
+ requests: Int32Array;
49
+ remaining: Int32Array;
41
50
  }
42
51
 
43
52
  export interface LevelMessage {
@@ -49,47 +58,56 @@ export interface LevelMessage {
49
58
  fingerprints: BigInt64Array;
50
59
  }
51
60
 
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;
61
+ export type WorkerMessage =
62
+ | { type: "ready" }
63
+ | { type: "abort" }
64
+ | { type: "paused" }
65
+ | LevelMessage;
66
66
 
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
- };
67
+ export type CoordinatorMessage =
68
+ | { type: "level"; level: number }
69
+ | { type: "resize"; fingerprints: SharedFingerprints };
86
70
 
87
71
  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 });
72
+ const config =
73
+ typeof options.config === "string"
74
+ ? parseConfig(options.config, options.version)
75
+ : options.config;
76
+ const print = options.onPrint ?? console.log;
77
+ const printed = { count: 0 };
78
+ // What each point the search reports is about, such as the invariant TLC warns about.
79
+ const getKey = (progress: CheckProgress) =>
80
+ [
81
+ progress.kind,
82
+ "name" in progress ? progress.name : "",
83
+ "count" in progress ? progress.count : "",
84
+ "text" in progress ? progress.text : "",
85
+ ].join(" ");
86
+ const reported = new Set<string>();
87
+ const report = (progress: CheckProgress) => {
88
+ reported.add(getKey(progress));
89
+ options.onProgress?.(progress);
90
+ };
91
+ // The search on the calling thread prints and reports what this one did while it started, so it
92
+ // skips that.
93
+ const fallBack = () => {
94
+ const skipped = { count: printed.count };
95
+ return checkSequentially({
96
+ ...options,
97
+ config,
98
+ onPrint: (text) => (skipped.count-- > 0 ? undefined : print(text)),
99
+ onProgress: (progress) => {
100
+ if (!reported.has(getKey(progress))) options.onProgress?.(progress);
101
+ },
102
+ });
103
+ };
90
104
  const count = options.workers ?? 1;
105
+ // TLC's workers write the -dump state graph in whichever order they find it, so one worker
106
+ // writes the graph a single TLC worker does.
91
107
  const isSequential =
92
108
  count < 2 ||
109
+ typeof SharedArrayBuffer !== "function" ||
110
+ options.dump !== undefined ||
93
111
  config.view !== undefined ||
94
112
  config.postconditions.length > 0 ||
95
113
  config.possible.length > 0;
@@ -107,17 +125,30 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
107
125
  return bytes;
108
126
  };
109
127
  setStringOrder(getTlcStringOrder(options.source, config, loadModule));
128
+ setValueVersion(options.version);
110
129
  const startupStrings = getRankedStringCount();
111
130
  const specification = createEnvironment(config, {
112
131
  source: options.source,
113
132
  loadModule,
114
133
  loadClass,
115
- print: options.onPrint ?? console.log,
134
+ print: (text) => {
135
+ printed.count++;
136
+ print(text);
137
+ },
116
138
  files: { readFile: options.readFile, writeFile: options.writeFile },
139
+ isTool: options.isTool,
140
+ isTraceRecorded: options.isTraceRecorded,
141
+ isSanyReported: options.isSanyReported,
142
+ isWarningEnabled: options.isWarningEnabled,
143
+ version: options.version,
117
144
  });
145
+ reportStartup(specification, config, report);
118
146
  const environment = specification.environment;
119
- const search = createSearch(config, environment, () =>
120
- getTlcVariableOrder(options.source, loadModule),
147
+ const search = createSearch(
148
+ config,
149
+ environment,
150
+ () => getTlcVariableOrder(options.source, loadModule),
151
+ report,
121
152
  );
122
153
  if (findAssumptionViolation(specification.assumptions, environment)) return fallBack();
123
154
  if (
@@ -131,17 +162,15 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
131
162
  }
132
163
 
133
164
  const canonicalize = createCanonicalizer();
134
- const table = createFingerprintTable();
165
+ const shared = { fingerprints: createSharedFingerprints() };
135
166
  const fingerprint = new Int32Array(2);
136
- const seeds = Array.from({ length: count }, () => ({
137
- encoder: createStateEncoder(),
138
- fingerprints: [] as number[],
139
- }));
167
+ const seeds = Array.from({ length: count }, createStateEncoder);
140
168
  const statistics = {
141
169
  generatedStates: 0,
142
170
  distinctStates: 0,
143
171
  queuedStates: 0,
144
172
  depth: 0,
173
+ initialStates: undefined as InitialStates | undefined,
145
174
  outDegrees: Array.from({ length: OUT_DEGREE_BUCKETS }, () => 0),
146
175
  };
147
176
  const tlcFingerprints: BigInt64Array[] = [];
@@ -166,20 +195,19 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
166
195
  const seedInitialStates = (init: Expression) => {
167
196
  const seeded: Value[][] = [];
168
197
  for (const state of getInitialStates(init, environment, search.spec.scope)) {
198
+ reportInitialStatesProgress(statistics.generatedStates, report);
169
199
  canonicalize(state);
170
200
  statistics.generatedStates++;
171
201
  writeStateFingerprint(search.getFingerprintState(state), fingerprint);
172
- if (!table.insert(fingerprint[0], fingerprint[1])) continue;
202
+ if (isSharedFingerprintsFull(shared.fingerprints)) {
203
+ shared.fingerprints = growSharedFingerprints(shared.fingerprints);
204
+ }
205
+ if (!insertSharedFingerprint(shared.fingerprints, fingerprint[0], fingerprint[1])) continue;
173
206
  if (search.findViolatedInvariant(state) || search.findFailedInitialPredicate(state)) {
174
207
  return false;
175
208
  }
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]);
209
+ if (!search.satisfiesConstraints(state)) continue;
210
+ if (!seeds[seeded.length % count].encode(state)) return false;
183
211
  seeded.push(state);
184
212
  statistics.distinctStates++;
185
213
  }
@@ -189,6 +217,7 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
189
217
  return true;
190
218
  };
191
219
  // The sequential search reports a violation or a failed evaluation in the initial states.
220
+ report({ kind: "initial-states-started" });
192
221
  try {
193
222
  if (!seedInitialStates(search.spec.init)) return fallBack();
194
223
  } catch (error) {
@@ -197,22 +226,38 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
197
226
  }
198
227
  if (getRankedStringCount() !== startupStrings) return fallBack();
199
228
  statistics.depth = statistics.generatedStates === 0 ? 0 : 1;
229
+ statistics.initialStates = {
230
+ generated: statistics.generatedStates,
231
+ distinct: statistics.distinctStates,
232
+ };
233
+ report({ kind: "initial-states-computed", initialStates: statistics.initialStates });
200
234
  if (statistics.distinctStates === 0) return createSuccess();
201
235
 
202
236
  const reports: WorkerMessage[] = [];
203
- const pending = { resolve: (_reports: WorkerMessage[]) => {} };
237
+ const pending = { count, resolve: (_reports: WorkerMessage[]) => {} };
204
238
  const onMessage = (message: WorkerMessage) => {
205
239
  reports.push(message);
206
- if (message.type === "abort" || reports.length === count) {
240
+ if (message.type === "abort" || reports.length === pending.count) {
207
241
  pending.resolve(reports.splice(0));
208
242
  }
209
243
  };
210
- const waitForReports = () =>
244
+ const waitForReports = (expected: number) =>
211
245
  new Promise<WorkerMessage[]>((resolve) => {
246
+ pending.count = expected;
212
247
  pending.resolve = resolve;
213
248
  });
214
- const ready = waitForReports();
215
- const workers = await Promise.all(Array.from({ length: count }, () => spawnWorker(onMessage)));
249
+ const ready = waitForReports(count);
250
+ const requests = new Int32Array(new SharedArrayBuffer(count * 4));
251
+ const remaining = new Int32Array(new SharedArrayBuffer(count * 4));
252
+ const workers = await Promise.all(
253
+ Array.from({ length: count }, () =>
254
+ spawnWorker(
255
+ new URL("./parallel-worker.js", import.meta.url),
256
+ (message) => onMessage(message as WorkerMessage),
257
+ () => onMessage({ type: "abort" }),
258
+ ),
259
+ ),
260
+ );
216
261
  const terminate = () => workers.forEach((worker) => worker.terminate());
217
262
  const channels = new Map<string, MessageChannel>();
218
263
  const getPort = (from: number, to: number) => {
@@ -225,8 +270,7 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
225
270
  const ports = Array.from({ length: count }, (_, peer) =>
226
271
  peer === index ? undefined : getPort(index, peer),
227
272
  );
228
- const seed = seeds[index].encoder.finish();
229
- const seedFingerprints = Int32Array.from(seeds[index].fingerprints);
273
+ const seed = seeds[index].finish();
230
274
  const message: StartMessage = {
231
275
  type: "start",
232
276
  source: options.source,
@@ -234,27 +278,42 @@ export const check = async (options: CheckOptions): Promise<CheckResult> => {
234
278
  modules: [...modules],
235
279
  classes: [...classes],
236
280
  index,
237
- count,
238
281
  ports,
239
282
  seed,
240
- seedFingerprints,
283
+ isTool: options.isTool,
284
+ isTraceRecorded: options.isTraceRecorded,
285
+ isWarningEnabled: options.isWarningEnabled,
286
+ version: options.version,
287
+ fingerprints: shared.fingerprints,
288
+ requests,
289
+ remaining,
241
290
  };
242
- worker.postMessage(message, [
243
- ...ports.filter((port) => port !== undefined),
244
- seed.words.buffer,
245
- seedFingerprints.buffer,
246
- ]);
291
+ worker.postMessage(message, [...ports.filter((port) => port !== undefined), seed.words.buffer]);
247
292
  });
248
293
  const isAborted = (messages: WorkerMessage[]) =>
249
294
  messages.some((message) => message.type === "abort");
295
+ const send = (message: CoordinatorMessage) =>
296
+ workers.forEach((worker) => worker.postMessage(message));
297
+ // Workers pause when the shared table needs to grow, and resume once it has.
298
+ const collectLevels = async (messages: WorkerMessage[]): Promise<WorkerMessage[]> => {
299
+ const paused = messages.filter((message) => message.type === "paused").length;
300
+ if (paused === 0 || isAborted(messages)) return messages;
301
+ shared.fingerprints = growSharedFingerprints(shared.fingerprints);
302
+ const resumed = waitForReports(paused);
303
+ send({ type: "resize", fingerprints: shared.fingerprints });
304
+ const reported = messages.filter((message) => message.type !== "paused");
305
+ return [...reported, ...(await collectLevels(await resumed))];
306
+ };
250
307
  if (isAborted(await ready)) {
251
308
  terminate();
252
309
  return fallBack();
253
310
  }
254
311
  for (let level = 1; ; level++) {
255
- const reported = waitForReports();
256
- workers.forEach((worker) => worker.postMessage({ type: "level", level }));
257
- const messages = await reported;
312
+ const reported = waitForReports(count);
313
+ // Every worker is idle, so peers can ask any of them for states once the level starts.
314
+ requests.forEach((_, index) => Atomics.store(requests, index, 0));
315
+ send({ type: "level", level });
316
+ const messages = await collectLevels(await reported);
258
317
  if (isAborted(messages)) {
259
318
  terminate();
260
319
  return fallBack();