tla-ts 0.0.10-dev.99796fe03 → 0.0.10-dev.a17d6d9fa

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 (226) hide show
  1. package/dist/compile.cjs +3 -3
  2. package/dist/compile.js +1 -1
  3. package/dist/deciders.cjs +36 -36
  4. package/dist/deciders.js +54 -54
  5. package/dist/index.cjs +1 -1
  6. package/dist/index.d.cts +3 -2
  7. package/dist/index.d.ts +3 -2
  8. package/dist/index.js +1 -1
  9. package/dist/parallel-worker.cjs +1 -1
  10. package/dist/parallel-worker.js +1 -1
  11. package/dist/prove-worker.cjs +1 -1
  12. package/dist/prove-worker.js +1 -1
  13. package/dist/prove.cjs +60 -60
  14. package/dist/prove.js +78 -78
  15. package/dist/run.cjs +42 -44
  16. package/dist/run.js +44 -46
  17. package/dist/tlapm.cjs +1 -1
  18. package/dist/tlapm.js +2 -2
  19. package/dist/transfer.cjs +43 -43
  20. package/dist/transfer.js +39 -39
  21. package/dist/worker.cjs +6 -6
  22. package/dist/worker.js +6 -6
  23. package/package.json +1 -1
  24. package/src/ast.ts +1 -0
  25. package/src/bags.ts +50 -29
  26. package/src/builtins.ts +4 -3
  27. package/src/check-failure.ts +1 -1
  28. package/src/check-trace.ts +90 -51
  29. package/src/check.ts +367 -178
  30. package/src/cli/runtime-invariants.ts +20 -56
  31. package/src/cli/tlc-arguments.ts +2 -2
  32. package/src/cli/tlc-output.ts +1 -2
  33. package/src/cli/tlc.ts +16 -10
  34. package/src/cli/xml-exporter.ts +1 -1
  35. package/src/codegen.ts +26 -9
  36. package/src/dependencies.ts +49 -9
  37. package/src/dfid.ts +22 -10
  38. package/src/environment.ts +58 -33
  39. package/src/errors.ts +7 -0
  40. package/src/evaluate.ts +117 -41
  41. package/src/exit-codes.ts +4 -2
  42. package/src/instances.ts +5 -5
  43. package/src/java-hash.ts +14 -0
  44. package/src/java-overrides.ts +2 -2
  45. package/src/levels.ts +138 -90
  46. package/src/liveness-checker.ts +81 -33
  47. package/src/liveness.ts +49 -11
  48. package/src/obligations/index.ts +1 -1
  49. package/src/obligations/normalize.ts +1 -4
  50. package/src/obligations/printer.ts +5 -5
  51. package/src/parallel-worker.ts +8 -2
  52. package/src/parallel.ts +5 -0
  53. package/src/parser.ts +112 -145
  54. package/src/prover/isabelle/isar/attrib.ts +4 -4
  55. package/src/prover/isabelle/isar/rule-cases.ts +8 -6
  56. package/src/prover/isabelle/provers/clasimp.ts +1 -1
  57. package/src/prover/isabelle/provers/hypsubst.ts +2 -2
  58. package/src/prover/isabelle/pure/rewriter.ts +3 -3
  59. package/src/prover/isabelle/pure/term.ts +3 -3
  60. package/src/prover/prep/md5.ts +26 -29
  61. package/src/prover/smt/rewrite.ts +2 -7
  62. package/src/prover/smt/simplify.ts +1 -1
  63. package/src/prover/smt/solver/arith-rewriter.ts +11 -3
  64. package/src/prover/smt/solver/array-rewriter.ts +12 -2
  65. package/src/prover/smt/solver/asserted-formulas.ts +169 -58
  66. package/src/prover/smt/solver/ast-lt.ts +1 -1
  67. package/src/prover/smt/solver/ast.ts +63 -14
  68. package/src/prover/smt/solver/auf-solver.ts +23 -12
  69. package/src/prover/smt/solver/bit-blast-tactic.ts +26 -0
  70. package/src/prover/smt/solver/blast-term-ite.ts +47 -0
  71. package/src/prover/smt/solver/bound-simplifier.ts +11 -13
  72. package/src/prover/smt/solver/bv-decl-plugin.ts +13 -10
  73. package/src/prover/smt/solver/bv-rewriter.ts +1 -1
  74. package/src/prover/smt/solver/card2bv.ts +32 -18
  75. package/src/prover/smt/solver/cofactor-elim-term-ite.ts +39 -24
  76. package/src/prover/smt/solver/context.ts +47 -9
  77. package/src/prover/smt/solver/ctx-simplify.ts +1 -2
  78. package/src/prover/smt/solver/datatype-decl-plugin.ts +15 -7
  79. package/src/prover/smt/solver/dependent-expr-state.ts +9 -4
  80. package/src/prover/smt/solver/diff-neq.ts +1 -2
  81. package/src/prover/smt/solver/elim-bounds.ts +89 -0
  82. package/src/prover/smt/solver/elim-term-ite-tactic.ts +48 -0
  83. package/src/prover/smt/solver/elim-uncnstr.ts +5 -8
  84. package/src/prover/smt/solver/euf/arith-internalize.ts +1 -1
  85. package/src/prover/smt/solver/euf/array-internalize.ts +1 -1
  86. package/src/prover/smt/solver/euf/bv-internalize.ts +1 -1
  87. package/src/prover/smt/solver/euf/egraph.ts +4 -11
  88. package/src/prover/smt/solver/euf/euf-solver.ts +1 -2
  89. package/src/prover/smt/solver/euf/mam.ts +1 -5
  90. package/src/prover/smt/solver/euf/q-ematch.ts +1 -2
  91. package/src/prover/smt/solver/euf/th-solver.ts +0 -7
  92. package/src/prover/smt/solver/expr2polynomial.ts +204 -79
  93. package/src/prover/smt/solver/factor.ts +36 -14
  94. package/src/prover/smt/solver/fd-solver.ts +2 -0
  95. package/src/prover/smt/solver/fix-dl-var.ts +1 -2
  96. package/src/prover/smt/solver/fpa-rewriter.ts +1 -2
  97. package/src/prover/smt/solver/fpa2bv-converter.ts +3 -1
  98. package/src/prover/smt/solver/fpa2bv-rewriter.ts +1 -0
  99. package/src/prover/smt/solver/goal.ts +6 -3
  100. package/src/prover/smt/solver/goal2nlsat.ts +57 -30
  101. package/src/prover/smt/solver/hashtable.ts +4 -0
  102. package/src/prover/smt/solver/internalizer.ts +1 -1
  103. package/src/prover/smt/solver/logic-tactics.ts +9 -2
  104. package/src/prover/smt/solver/lp/lp-settings.ts +5 -1
  105. package/src/prover/smt/solver/lp/nla-core.ts +1 -1
  106. package/src/prover/smt/solver/lp/nla-grobner.ts +2 -2
  107. package/src/prover/smt/solver/lp/nra-solver.ts +45 -39
  108. package/src/prover/smt/solver/lp/pdd.ts +2 -3
  109. package/src/prover/smt/solver/lp/union-find.ts +1 -1
  110. package/src/prover/smt/solver/mam-compiler.ts +1 -1
  111. package/src/prover/smt/solver/model-based-opt.ts +1 -1
  112. package/src/prover/smt/solver/model-evaluator.ts +2 -0
  113. package/src/prover/smt/solver/model-generator.ts +85 -43
  114. package/src/prover/smt/solver/mpf.ts +2 -4
  115. package/src/prover/smt/solver/mus.ts +2 -3
  116. package/src/prover/smt/solver/muz/dl-context.ts +10 -4
  117. package/src/prover/smt/solver/muz/dl-mk-slice.ts +3 -3
  118. package/src/prover/smt/solver/muz/dl-rule.ts +2 -2
  119. package/src/prover/smt/solver/muz/horn-subsume-model-converter.ts +1 -1
  120. package/src/prover/smt/solver/muz/horn-tactic.ts +1 -1
  121. package/src/prover/smt/solver/muz/spacer-context.ts +2 -4
  122. package/src/prover/smt/solver/muz/spacer-pdr.ts +1 -0
  123. package/src/prover/smt/solver/nlqsat.ts +1 -1
  124. package/src/prover/smt/solver/nlsat/algebraic.ts +196 -92
  125. package/src/prover/smt/solver/nlsat/atoms.ts +52 -33
  126. package/src/prover/smt/solver/nlsat/explain.ts +375 -217
  127. package/src/prover/smt/solver/nlsat/levelwise.ts +460 -240
  128. package/src/prover/smt/solver/nlsat/polynomial.ts +2366 -681
  129. package/src/prover/smt/solver/nlsat/solver.ts +74 -64
  130. package/src/prover/smt/solver/nlsat/transcendentals.ts +41 -17
  131. package/src/prover/smt/solver/nlsat/upolynomial-factorization.ts +8 -4
  132. package/src/prover/smt/solver/nlsat/upolynomial.ts +41 -18
  133. package/src/prover/smt/solver/nlsat-tactic.ts +1 -1
  134. package/src/prover/smt/solver/nnf.ts +6 -2
  135. package/src/prover/smt/solver/opt-context.ts +20 -7
  136. package/src/prover/smt/solver/opt-nlsat.ts +29 -18
  137. package/src/prover/smt/solver/opt-pareto.ts +19 -0
  138. package/src/prover/smt/solver/opt-preprocess.ts +1 -1
  139. package/src/prover/smt/solver/opt-solver.ts +9 -5
  140. package/src/prover/smt/solver/optsmt.ts +1 -1
  141. package/src/prover/smt/solver/pb-rewriter.ts +1 -4
  142. package/src/prover/smt/solver/poly-rewriter.ts +75 -18
  143. package/src/prover/smt/solver/probes.ts +88 -23
  144. package/src/prover/smt/solver/proto-model.ts +8 -8
  145. package/src/prover/smt/solver/push-app-ite.ts +37 -0
  146. package/src/prover/smt/solver/qe-arith-plugin.ts +2 -4
  147. package/src/prover/smt/solver/qe-lite.ts +2 -2
  148. package/src/prover/smt/solver/qe.ts +3 -2
  149. package/src/prover/smt/solver/qsat.ts +16 -6
  150. package/src/prover/smt/solver/quantifier-manager.ts +14 -9
  151. package/src/prover/smt/solver/recfun-decl-plugin.ts +2 -1
  152. package/src/prover/smt/solver/rewriter.ts +31 -25
  153. package/src/prover/smt/solver/rlimit.ts +4 -0
  154. package/src/prover/smt/solver/sat/config.ts +1 -1
  155. package/src/prover/smt/solver/sat/goal2sat.ts +0 -1
  156. package/src/prover/smt/solver/sat/inc-sat-solver.ts +39 -5
  157. package/src/prover/smt/solver/sat/model-converter.ts +1 -1
  158. package/src/prover/smt/solver/sat/pb-solver.ts +1 -1
  159. package/src/prover/smt/solver/sat/sat-tactic.ts +13 -5
  160. package/src/prover/smt/solver/sat/simplifier.ts +1 -1
  161. package/src/prover/smt/solver/sat/solver.ts +25 -47
  162. package/src/prover/smt/solver/seq-axioms.ts +20 -35
  163. package/src/prover/smt/solver/seq-decl-plugin.ts +1 -1
  164. package/src/prover/smt/solver/seq-derive.ts +2 -2
  165. package/src/prover/smt/solver/seq-eq-solver.ts +2 -2
  166. package/src/prover/smt/solver/seq-monadic.ts +7 -5
  167. package/src/prover/smt/solver/seq-re-rewriter.ts +2 -1
  168. package/src/prover/smt/solver/seq-re-util.ts +1 -1
  169. package/src/prover/smt/solver/seq-regex-bisim.ts +1 -1
  170. package/src/prover/smt/solver/seq-regex-live.ts +2 -2
  171. package/src/prover/smt/solver/seq-rewriter.ts +31 -29
  172. package/src/prover/smt/solver/seq-skolem.ts +0 -23
  173. package/src/prover/smt/solver/seq-view-witness.ts +4 -4
  174. package/src/prover/smt/solver/smt-kernel.ts +39 -5
  175. package/src/prover/smt/solver/smt-setup.ts +96 -10
  176. package/src/prover/smt/solver/smtlib-parser.ts +584 -223
  177. package/src/prover/smt/solver/smtlib-script.ts +509 -154
  178. package/src/prover/smt/solver/solve-eqs.ts +36 -37
  179. package/src/prover/smt/solver/solver.ts +18 -3
  180. package/src/prover/smt/solver/tactic.ts +284 -168
  181. package/src/prover/smt/solver/theory-bv.ts +13 -3
  182. package/src/prover/smt/solver/theory-fpa.ts +1 -1
  183. package/src/prover/smt/solver/theory-lra-final-check.ts +1 -0
  184. package/src/prover/smt/solver/theory-lra-internalize.ts +2 -0
  185. package/src/prover/smt/solver/theory-lra-propagate.ts +11 -3
  186. package/src/prover/smt/solver/theory-lra.ts +1 -1
  187. package/src/prover/smt/solver/theory-pb.ts +24 -7
  188. package/src/prover/smt/solver/theory-seq-solve.ts +1 -1
  189. package/src/prover/smt/solver/theory-seq-state.ts +2 -21
  190. package/src/prover/smt/solver/tseitin-cnf.ts +1 -0
  191. package/src/prover/tlapm/cache.ts +8 -8
  192. package/src/prover/zenon/index-table.ts +5 -2
  193. package/src/prover/zenon/isar-case.ts +1 -1
  194. package/src/prover/zenon/isar.ts +2 -2
  195. package/src/prover/zenon/phrase.ts +1 -1
  196. package/src/resolve.ts +959 -243
  197. package/src/runtime.ts +7 -1
  198. package/src/sany/builtins.ts +10 -10
  199. package/src/sany/generation.ts +2 -13
  200. package/src/sany/generator-definitions.ts +3 -1
  201. package/src/sany/generator-expressions.ts +36 -30
  202. package/src/sany/generator-proofs.ts +5 -3
  203. package/src/sany/generator.ts +2 -1
  204. package/src/sany/lexer.ts +3 -3
  205. package/src/sany/modules.ts +4 -2
  206. package/src/sany/nodes.ts +1 -1
  207. package/src/sany/selectors.ts +11 -6
  208. package/src/sany/xml.ts +2 -3
  209. package/src/search.ts +166 -101
  210. package/src/simulate.ts +110 -50
  211. package/src/spec-description.ts +5 -6
  212. package/src/standard-modules.ts +15 -6
  213. package/src/subexpressions.ts +398 -108
  214. package/src/successors.ts +4 -2
  215. package/src/symmetry.ts +1 -1
  216. package/src/tlc/jar-data.ts +10 -0
  217. package/src/tlc/messages.ts +3 -3
  218. package/src/tlc/order.ts +14 -3
  219. package/src/tlc/random.ts +2 -1
  220. package/src/tlc/replay.ts +3 -2
  221. package/src/tlc/tlc-operators.ts +10 -8
  222. package/src/tlc/tlcext-operators.ts +44 -15
  223. package/src/tlc/trace-spec.ts +9 -22
  224. package/src/typed-tier.ts +32 -25
  225. package/src/typescript/types.ts +2 -2
  226. package/src/values.ts +135 -78
package/src/search.ts CHANGED
@@ -28,9 +28,12 @@ import {
28
28
  isExpressionImpure,
29
29
  isImpureDefinition,
30
30
  } from "./dependencies";
31
- import { createEnvironment, type ResolvedModuleOperator } from "./environment";
32
31
  import {
33
- isStackOverflow,
32
+ createEnvironment,
33
+ type ResolvedModuleOperator,
34
+ type RuntimeInvariant,
35
+ } from "./environment";
36
+ import {
34
37
  TlaConfigError,
35
38
  TlaEvaluationError,
36
39
  TlaModuleError,
@@ -49,6 +52,7 @@ import {
49
52
  type Context,
50
53
  type Environment,
51
54
  type Scope,
55
+ type State,
52
56
  } from "./evaluate";
53
57
  import { EXIT_STATUS, setExitCode } from "./exit-codes";
54
58
  import type { JavaOverride } from "./java-overrides";
@@ -82,11 +86,13 @@ import { createTlcOrder } from "./tlc/order";
82
86
  import { getTlcFingerprint, getTlcFingerprints, setFingerprintPolynomial } from "./tlc/fingerprint";
83
87
  import type { TlcVersion } from "./tlc/version";
84
88
  import {
89
+ createModelValue,
85
90
  formatValue,
86
91
  freezeStringOrder,
87
92
  getWrittenPairs,
88
93
  isFunctionValue,
89
94
  isUpdatedElementOf,
95
+ markNormalized,
90
96
  setAliasName,
91
97
  setStringOrder,
92
98
  setValueOptions,
@@ -95,8 +101,9 @@ import {
95
101
  type Value,
96
102
  } from "./values";
97
103
 
98
- export interface StandardInput {
104
+ export interface CliSettings {
99
105
  readLine?: () => string | undefined;
106
+ runtimeInvariants?: RuntimeInvariant[];
100
107
  }
101
108
 
102
109
  interface EnvironmentSettings
@@ -121,7 +128,7 @@ interface EnvironmentSettings
121
128
  | "isLazyValueExpanded"
122
129
  | "isViewPrinted"
123
130
  >,
124
- StandardInput {}
131
+ CliSettings {}
125
132
 
126
133
  interface NamedExpression {
127
134
  name: string;
@@ -207,14 +214,7 @@ const isLiteralDefinition = (definition: Definition) =>
207
214
 
208
215
  const getConstantValue = (name: string, definition: Definition, environment: Environment) => {
209
216
  if (environment.constants.has(name)) return environment.constants.get(name);
210
- if (!isConstantLevel(definition, environment) || isLiteralDefinition(definition))
211
- return undefined;
212
- try {
213
- return evaluate(createIdentifier(name), getContext(environment, undefined, undefined));
214
- } catch (error) {
215
- if (error instanceof TlaEvaluationError || isStackOverflow(error)) return undefined;
216
- throw error;
217
- }
217
+ return isLiteralDefinition(definition) ? undefined : getStartupValue(definition, environment);
218
218
  };
219
219
 
220
220
  const getConfigDefinition = (kind: string, name: string, environment: Environment) => {
@@ -381,12 +381,20 @@ const getSpecification = (
381
381
  let isUntaggedFound = false;
382
382
  expandTemporal(definition.body, undefined, environment, false).forEach((item) => {
383
383
  const conjunct = item.expression;
384
- if (isConstantTrue(item, environment, "spec")) return;
384
+ // TLC takes a state-level definition of the spec whole as an initial predicate.
385
+ const isInitial = item.path.some((name) => {
386
+ const expanded = getDefinition(name, environment);
387
+ return (
388
+ expanded?.kind === "Operator" &&
389
+ getLevel(expanded.body, undefined, environment) === VARIABLE_LEVEL
390
+ );
391
+ });
392
+ if (!isInitial && isConstantTrue(item, environment, "spec")) return;
385
393
  const variableIndex =
386
394
  conjunct.kind === "Identifier" && !isLocallyResolved(conjunct)
387
395
  ? environment.variableIndex.get(conjunct.name)
388
396
  : undefined;
389
- if (conjunct.kind === "Identifier" && variableIndex !== undefined) {
397
+ if (!isInitial && conjunct.kind === "Identifier" && variableIndex !== undefined) {
390
398
  const range = variableLocations[variableIndex].range;
391
399
  throw new TlaConfigError(
392
400
  `The operator ${conjunct.name}, which equals ${range ? formatRange(range) : conjunct.name},\ncannot be used as a spec`,
@@ -651,20 +659,26 @@ const getPredicate = (expression: Expression, environment: Environment) => {
651
659
  };
652
660
 
653
661
  const getStateChecks = (named: NamedExpression[], environment: Environment): StateCheck[] =>
654
- named.flatMap((item) =>
655
- getConjuncts(item.expression, environment).map((expression) => {
656
- const variables =
657
- item.scope === undefined ? getReadVariables(expression, environment) : undefined;
658
- return {
659
- name: item.name,
660
- expression,
661
- scope: item.scope,
662
- variables,
663
- membership: getMembership(expression, variables, environment),
664
- predicate: getPredicate(item.expression, environment),
665
- };
666
- }),
667
- );
662
+ named.flatMap((item) => {
663
+ const predicate = getPredicate(item.expression, environment);
664
+ const isImpure =
665
+ item.scope === undefined && getReadVariables(predicate, environment) === undefined;
666
+ // TLC evaluates an invariant whole, so one that prints isn't split into conjuncts.
667
+ return (isImpure ? [predicate] : getConjuncts(item.expression, environment)).map(
668
+ (expression) => {
669
+ const variables =
670
+ item.scope === undefined ? getReadVariables(expression, environment) : undefined;
671
+ return {
672
+ name: item.name,
673
+ expression,
674
+ scope: item.scope,
675
+ variables,
676
+ membership: getMembership(expression, variables, environment),
677
+ predicate,
678
+ };
679
+ },
680
+ );
681
+ });
668
682
 
669
683
  const isUnchangedFor = (stateCheck: StateCheck, state: Value[], parent: Value[] | undefined) => {
670
684
  const variables = stateCheck.variables;
@@ -707,8 +721,8 @@ export interface Search {
707
721
  toRecord: (state: Value[]) => Record<string, Value>;
708
722
  evaluateAlias: (
709
723
  alias: string,
710
- state: Value[],
711
- next: Value[] | undefined,
724
+ state: State,
725
+ next: State | undefined,
712
726
  isTool: boolean,
713
727
  ) => Record<string, Value>;
714
728
  spec: Specification;
@@ -733,12 +747,13 @@ export interface Search {
733
747
  }
734
748
  | undefined;
735
749
  findViolatedInvariant: (state: Value[], parent?: Value[]) => StateCheck | undefined;
736
- getViolatedInvariants: (state: Value[]) => StateCheck[];
750
+ forEachViolatedInvariant: (state: Value[], onViolated: (invariant: StateCheck) => void) => void;
737
751
  checkReplayedInitialState: (
738
752
  state: Value[],
739
753
  tracing: Environment,
740
754
  addFingerprint: () => void,
741
- ) => Pick<InitialStateViolation, "status" | "name"> | undefined;
755
+ onViolated: (violation: Pick<InitialStateViolation, "status" | "name">) => void,
756
+ ) => void;
742
757
  checkReplayedSuccessor: (
743
758
  state: Value[],
744
759
  next: Value[],
@@ -778,8 +793,8 @@ export const getIncompleteSuccessorMessage = (
778
793
 
779
794
  export const getContext = (
780
795
  environment: Environment,
781
- state: Value[] | undefined,
782
- next: Value[] | undefined,
796
+ state: State | undefined,
797
+ next: State | undefined,
783
798
  scope?: Scope,
784
799
  ) => ({ environment, scope, state, next });
785
800
 
@@ -812,7 +827,7 @@ const getExpectedBoolean = (expression: Expression, environment: Environment) =>
812
827
 
813
828
  const holdsAsConjunct = (check: StateCheck, context: Context) =>
814
829
  holdsLikeTlc(check.expression, context, (expression, environment) => {
815
- holdsLikeTlc(check.predicate, context);
830
+ if (check.predicate !== check.expression) holdsLikeTlc(check.predicate, context);
816
831
  return getExpectedBoolean(expression, environment);
817
832
  });
818
833
 
@@ -860,7 +875,12 @@ export const createCheckEnvironment = (
860
875
  isStringOrderFrozen = false,
861
876
  ) => {
862
877
  const order = createTlcOrder(options.source, options.loadModule);
863
- setStringOrder(order.getStringOrder(config));
878
+ setStringOrder(
879
+ order.getStringOrder(
880
+ config,
881
+ (options.runtimeInvariants ?? []).flatMap((invariant) => invariant.module ?? []),
882
+ ),
883
+ );
864
884
  setValueOptions(options);
865
885
  setFingerprintPolynomial(options.fingerprintPolynomial ?? 0);
866
886
  if (isStringOrderFrozen) freezeStringOrder();
@@ -883,6 +903,7 @@ export const createCheckEnvironment = (
883
903
  version: options.version,
884
904
  moduleOperators: options.moduleOperators,
885
905
  readLine: options.readLine,
906
+ runtimeInvariants: options.runtimeInvariants,
886
907
  });
887
908
  return { order, specification };
888
909
  };
@@ -908,6 +929,7 @@ export const prepareSearch = (options: CheckOptions) => {
908
929
  () => created.order.getDeclarationOrder("variable"),
909
930
  options.onProgress,
910
931
  specification.moduleOperators,
932
+ specification.runtimeInvariants,
911
933
  );
912
934
  return { config, specification, environment, search, getDescription };
913
935
  };
@@ -948,6 +970,7 @@ export const createSearch = (
948
970
  getVariableOrder: () => string[],
949
971
  onProgress?: CheckOptions["onProgress"],
950
972
  moduleOperators: ResolvedModuleOperator[] = [],
973
+ runtimeInvariants: RuntimeInvariant[] = [],
951
974
  ): Search | undefined => {
952
975
  const getModuleOperators = (kind: ResolvedModuleOperator["kind"]) =>
953
976
  moduleOperators
@@ -976,12 +999,12 @@ export const createSearch = (
976
999
  text: `Implied-temporal checking is a tautology.\nThe temporal formula ${live} at ${formatRange(liveRange)} equals\nthe fairness constraints of the behavior specification ${specName} at ${formatRange(specRange)}.\nTherefore, checking whether ${specName} => ${live} using TLC will never result in a violation of ${live}.`,
977
1000
  });
978
1001
  }
979
- const invariants = getStateChecks([...configInvariants, ...properties.invariants], environment);
980
- const invariantPredicates = [
981
- ...new Map(invariants.map((invariant) => [invariant.predicate, invariant])).values(),
982
- ];
1002
+ const checkedInvariants = getStateChecks(
1003
+ [...configInvariants, ...properties.invariants],
1004
+ environment,
1005
+ );
983
1006
  const isCheckingBehaviors =
984
- invariants.length > 0 ||
1007
+ checkedInvariants.length > 0 ||
985
1008
  properties.actionProperties.length > 0 ||
986
1009
  properties.liveness.length > 0;
987
1010
  if (
@@ -999,6 +1022,22 @@ export const createSearch = (
999
1022
  if (spec.next === undefined && isCheckingBehaviors) {
1000
1023
  throw new TlaConfigError("The configuration file did not specify the next state predicate.");
1001
1024
  }
1025
+ const runtimeChecks = getStateChecks(
1026
+ runtimeInvariants.map((invariant) => {
1027
+ const definition = getDefinition(invariant.name, environment);
1028
+ return {
1029
+ name: invariant.name,
1030
+ expression:
1031
+ definition?.kind === "Operator" ? definition.body : createIdentifier(invariant.name),
1032
+ scope: undefined,
1033
+ };
1034
+ }),
1035
+ environment,
1036
+ );
1037
+ const invariants = [...checkedInvariants, ...runtimeChecks];
1038
+ const invariantPredicates = [
1039
+ ...new Map(invariants.map((invariant) => [invariant.predicate, invariant])).values(),
1040
+ ];
1002
1041
  const namedConstraints = getNamedExpressions(
1003
1042
  "constraint",
1004
1043
  [...config.constraints, ...getModuleOperators("constraint").map((operator) => operator.name)],
@@ -1023,6 +1062,12 @@ export const createSearch = (
1023
1062
  ...getCoveredChecks("invariant", configInvariants),
1024
1063
  ...getCoveredChecks("invariant", properties.invariants, false),
1025
1064
  ];
1065
+ const coveredInvariantChecks = new Map(
1066
+ [...configInvariants, ...properties.invariants].map((item, index) => [
1067
+ getPredicate(item.expression, environment),
1068
+ coveredInvariants[index],
1069
+ ]),
1070
+ );
1026
1071
  const coveredActionConstraints = getCoveredChecks("constraint", actionConstraints);
1027
1072
  const coveredConstraints = getCoveredChecks("constraint", namedConstraints);
1028
1073
  const coveredInitialPredicates = getCoveredChecks("implied", properties.initialPredicates, false);
@@ -1045,9 +1090,6 @@ export const createSearch = (
1045
1090
  return undefined;
1046
1091
  }
1047
1092
  };
1048
- const isCoveredHeld = (checks: CoveredCheck[], state: Value[], next?: Value[]) =>
1049
- coverage !== undefined &&
1050
- checks.every((check) => evaluateCovered(coverage, check, state, next) === true);
1051
1093
  const satisfiesCovered = (checks: CoveredCheck[], state: Value[], next?: Value[]) => {
1052
1094
  if (!coverage) return undefined;
1053
1095
  for (const check of checks) {
@@ -1103,9 +1145,15 @@ export const createSearch = (
1103
1145
  };
1104
1146
  const getViewValue = (expression: Expression, state: Value[]) =>
1105
1147
  evaluate(expression, getContext(environment, state, undefined));
1148
+ const getRepresentativeState = (state: Value[]) => {
1149
+ // TLC's TLCStateMut#fingerPrint deep-normalizes a state before it evaluates the view.
1150
+ if (view !== undefined) state.forEach(markNormalized);
1151
+ return symmetryGroup === undefined
1152
+ ? state
1153
+ : getRepresentative(state, symmetryGroup, getTlcOrder());
1154
+ };
1106
1155
  const getTlcStateFingerprint = (state: Value[]) => {
1107
- const representative =
1108
- symmetryGroup === undefined ? state : getRepresentative(state, symmetryGroup, getTlcOrder());
1156
+ const representative = getRepresentativeState(state);
1109
1157
  return getTlcFingerprint(
1110
1158
  view === undefined
1111
1159
  ? getTlcOrder().map((index) => representative[index])
@@ -1113,15 +1161,16 @@ export const createSearch = (
1113
1161
  );
1114
1162
  };
1115
1163
  const findFailedInitialPredicate = (state: Value[]) =>
1116
- isCoveredHeld(coveredInitialPredicates, state)
1117
- ? undefined
1118
- : properties.initialPredicates.find(
1119
- (predicate) =>
1120
- !holdsLikeTlc(
1121
- predicate.expression,
1122
- getContext(environment, state, undefined, predicate.scope),
1123
- ),
1124
- );
1164
+ properties.initialPredicates.find((predicate, index) => {
1165
+ const value =
1166
+ coverage && evaluateCovered(coverage, coveredInitialPredicates[index], state, undefined);
1167
+ return typeof value === "boolean"
1168
+ ? !value
1169
+ : !holdsLikeTlc(
1170
+ predicate.expression,
1171
+ getContext(environment, state, undefined, predicate.scope),
1172
+ );
1173
+ });
1125
1174
  const violatingStates = new WeakSet<Value[]>();
1126
1175
  const isViolated = (invariant: StateCheck, state: Value[], parent: Value[] | undefined) => {
1127
1176
  const checkedParent = parent && !violatingStates.has(parent) ? parent : undefined;
@@ -1145,6 +1194,21 @@ export const createSearch = (
1145
1194
  );
1146
1195
  }
1147
1196
  };
1197
+ const isPredicateViolated = (
1198
+ predicate: StateCheck,
1199
+ state: Value[],
1200
+ parent: Value[] | undefined,
1201
+ ) => {
1202
+ const covered = coveredInvariantChecks.get(predicate.predicate);
1203
+ const value =
1204
+ coverage && covered ? evaluateCovered(coverage, covered, state, undefined) : undefined;
1205
+ return typeof value === "boolean"
1206
+ ? !value
1207
+ : invariants.some(
1208
+ (invariant) =>
1209
+ invariant.predicate === predicate.predicate && isViolated(invariant, state, parent),
1210
+ );
1211
+ };
1148
1212
  const isFingerprintedLikeTlc = hasWideString(config, environment);
1149
1213
  runtime.getFingerprint = getTlcStateFingerprint;
1150
1214
  const findUnwitnessedPossible = () => {
@@ -1200,14 +1264,16 @@ export const createSearch = (
1200
1264
  spec,
1201
1265
  toRecord,
1202
1266
  evaluateAlias: (alias, state, next, isTool) => {
1267
+ const getStateRecord = () =>
1268
+ toRecord(state.map((value) => value ?? createModelValue("null")));
1203
1269
  try {
1204
1270
  getConfigDefinition("alias", alias, environment);
1205
1271
  const value = evaluate(createIdentifier(alias), getContext(environment, state, next));
1206
1272
  const record = toAliasRecord(value);
1207
- return record === undefined ? toRecord(state) : setAliasName(record, alias);
1273
+ return record === undefined ? getStateRecord() : setAliasName(record, alias);
1208
1274
  } catch (error) {
1209
1275
  if (!(error instanceof TlaConfigError || error instanceof TlaEvaluationError)) throw error;
1210
- return { ...toRecord(state), _ALIASEvalError: formatNestedMessage(error.message, isTool) };
1276
+ return { ...getStateRecord(), _ALIASEvalError: formatNestedMessage(error.message, isTool) };
1211
1277
  }
1212
1278
  },
1213
1279
  isSymmetric: symmetryGroup !== undefined,
@@ -1291,40 +1357,38 @@ export const createSearch = (
1291
1357
  },
1292
1358
  getFingerprintState: (state) => {
1293
1359
  if (isFingerprintedLikeTlc) return [String(getTlcStateFingerprint(state))];
1294
- const representative =
1295
- symmetryGroup === undefined
1296
- ? state
1297
- : getRepresentative(state, symmetryGroup, getTlcOrder());
1360
+ const representative = getRepresentativeState(state);
1298
1361
  return view === undefined ? representative : [getViewValue(view.expression, representative)];
1299
1362
  },
1300
1363
  findViolatedInvariant: (state, parent) => {
1301
- if (isCoveredHeld(coveredInvariants, state)) return undefined;
1302
- const violated = invariants.find((invariant) => isViolated(invariant, state, parent));
1364
+ const violated =
1365
+ coverage === undefined
1366
+ ? invariants.find((invariant) => isViolated(invariant, state, parent))
1367
+ : invariantPredicates.find((predicate) => isPredicateViolated(predicate, state, parent));
1303
1368
  if (violated) violatingStates.add(state);
1304
1369
  return violated;
1305
1370
  },
1306
- getViolatedInvariants: (state) => {
1307
- const violated = invariantPredicates.filter((predicate) =>
1308
- invariants.some(
1309
- (invariant) =>
1310
- invariant.predicate === predicate.predicate && isViolated(invariant, state, undefined),
1311
- ),
1312
- );
1313
- if (violated.length > 0) violatingStates.add(state);
1314
- return violated;
1371
+ forEachViolatedInvariant: (state, onViolated) => {
1372
+ for (const predicate of invariantPredicates) {
1373
+ if (!isPredicateViolated(predicate, state, undefined)) continue;
1374
+ violatingStates.add(state);
1375
+ onViolated(predicate);
1376
+ }
1315
1377
  },
1316
- checkReplayedInitialState: (state, tracing, addFingerprint) => {
1378
+ checkReplayedInitialState: (state, tracing, addFingerprint, onViolated) => {
1317
1379
  const holdsIn = (expression: Expression, scope: Scope | undefined) =>
1318
1380
  holdsLikeTlc(expression, getContext(tracing, state, undefined, scope));
1319
1381
  if (constraints.every((constraint) => holdsIn(constraint.predicate, constraint.scope))) {
1320
1382
  addFingerprint();
1321
1383
  }
1322
- const invariant = invariantPredicates.find((check) => !holdsIn(check.predicate, check.scope));
1323
- if (invariant) return { status: "invariant-violation", name: invariant.name };
1384
+ for (const invariant of invariantPredicates) {
1385
+ if (holdsIn(invariant.predicate, invariant.scope)) continue;
1386
+ onViolated({ status: "invariant-violation", name: invariant.name });
1387
+ }
1324
1388
  const predicate = properties.initialPredicates.find(
1325
1389
  (check) => !holdsIn(check.expression, check.scope),
1326
1390
  );
1327
- return predicate && { status: "liveness-violation", name: predicate.name };
1391
+ if (predicate) onViolated({ status: "liveness-violation", name: predicate.name });
1328
1392
  },
1329
1393
  checkReplayedSuccessor: (state, next, tracing, addFingerprint) => {
1330
1394
  const isInModel =
@@ -1361,31 +1425,32 @@ export const createSearch = (
1361
1425
  ),
1362
1426
  findFailedInitialPredicate,
1363
1427
  findViolatedActionProperty: (state, next) =>
1364
- isCoveredHeld(coveredActionProperties, state, next)
1365
- ? undefined
1366
- : actionProperties.find((property) => {
1367
- try {
1368
- return (
1369
- !holdsLikeTlc(
1370
- property.action,
1371
- getContext(environment, state, next, property.scope),
1372
- () =>
1373
- `Attempted to evaluate an expression of form [A]_e, but A was not a boolean.\n${describeRange(property.box)}`,
1374
- ) &&
1375
- !holds(
1376
- property.unchanged,
1377
- getContext(environment, state, next, property.scope),
1378
- "a subscript",
1379
- )
1380
- );
1381
- } catch (error) {
1382
- throw withHeadline(
1383
- withNextStateExitCode(error),
1384
- MESSAGE_CODE.actionPropertyEvaluationFailed,
1385
- `Evaluating action property ${property.name} failed.`,
1386
- );
1387
- }
1388
- }),
1428
+ actionProperties.find((property, index) => {
1429
+ const value =
1430
+ coverage && evaluateCovered(coverage, coveredActionProperties[index], state, next);
1431
+ if (typeof value === "boolean") return !value;
1432
+ try {
1433
+ return (
1434
+ !holdsLikeTlc(
1435
+ property.action,
1436
+ getContext(environment, state, next, property.scope),
1437
+ () =>
1438
+ `Attempted to evaluate an expression of form [A]_e, but A was not a boolean.\n${describeRange(property.box)}`,
1439
+ ) &&
1440
+ !holds(
1441
+ property.unchanged,
1442
+ getContext(environment, state, next, property.scope),
1443
+ "a subscript",
1444
+ )
1445
+ );
1446
+ } catch (error) {
1447
+ throw withHeadline(
1448
+ withNextStateExitCode(error),
1449
+ MESSAGE_CODE.actionPropertyEvaluationFailed,
1450
+ `Evaluating action property ${property.name} failed.`,
1451
+ );
1452
+ }
1453
+ }),
1389
1454
  satisfiesActionConstraints: (state, next) =>
1390
1455
  satisfiesCovered(coveredActionConstraints, state, next) ??
1391
1456
  actionConstraints.every((constraint) => holdsActionConstraint(constraint, state, next)),