@giljae/opencode-pstack 0.0.0-stage → 0.0.1

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 (551) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +10 -0
  3. package/README.md +176 -2
  4. package/package.json +42 -4
  5. package/src/agents.ts +110 -0
  6. package/src/commands.ts +37 -0
  7. package/src/content.ts +119 -0
  8. package/src/host.ts +59 -0
  9. package/src/index.ts +21 -0
  10. package/src/install.ts +22 -0
  11. package/src/models.ts +112 -0
  12. package/src/pstack-setup.ts +111 -0
  13. package/src/setup.ts +42 -0
  14. package/src/skills.ts +24 -0
  15. package/vendor/pstack/LICENSE.upstream +21 -0
  16. package/vendor/pstack/README.upstream.md +290 -0
  17. package/vendor/pstack/UPSTREAM.json +545 -0
  18. package/vendor/pstack/agents/comment-sicko.md +32 -0
  19. package/vendor/pstack/agents/poteto-agent.md +10 -0
  20. package/vendor/pstack/docs/guide/01-setup.md +66 -0
  21. package/vendor/pstack/docs/guide/02-poteto-mode.md +139 -0
  22. package/vendor/pstack/docs/guide/03-understand.md +79 -0
  23. package/vendor/pstack/docs/guide/04-design.md +127 -0
  24. package/vendor/pstack/docs/guide/05-build-and-clean.md +83 -0
  25. package/vendor/pstack/docs/guide/06-verify-and-ship.md +162 -0
  26. package/vendor/pstack/docs/guide/07-overnight.md +122 -0
  27. package/vendor/pstack/docs/guide/08-principles.md +72 -0
  28. package/vendor/pstack/docs/guide/09-make-it-yours.md +100 -0
  29. package/vendor/pstack/docs/guide/10-recipes-and-pitfalls.md +182 -0
  30. package/vendor/pstack/docs/guide/README.md +38 -0
  31. package/vendor/pstack/docs/guide/images/design.jpg +0 -0
  32. package/vendor/pstack/docs/guide/images/overnight.jpg +0 -0
  33. package/vendor/pstack/docs/guide/images/recipes.jpg +0 -0
  34. package/vendor/pstack/docs/guide/images/router.jpg +0 -0
  35. package/vendor/pstack/docs/guide/images/understanding.jpg +0 -0
  36. package/vendor/pstack/docs/guide/images/verification.jpg +0 -0
  37. package/vendor/pstack/docs/harness/claude-code.md +68 -0
  38. package/vendor/pstack/skills/architect/SKILL.md +11 -0
  39. package/vendor/pstack/skills/arena/SKILL.md +48 -0
  40. package/vendor/pstack/skills/automate-me/SKILL.md +104 -0
  41. package/vendor/pstack/skills/benchmark-checklist/SKILL.md +39 -0
  42. package/vendor/pstack/skills/blast-radius/SKILL.md +50 -0
  43. package/vendor/pstack/skills/bro/SKILL.md +7 -0
  44. package/vendor/pstack/skills/correct/SKILL.md +32 -0
  45. package/vendor/pstack/skills/create-formal-verification-skill/SKILL.md +43 -0
  46. package/vendor/pstack/skills/create-verification-skill/SKILL.md +44 -0
  47. package/vendor/pstack/skills/create-verification-skill/references/feature-map-example/README.md +47 -0
  48. package/vendor/pstack/skills/create-verification-skill/references/feature-map-example/create-note.md +39 -0
  49. package/vendor/pstack/skills/create-verification-skill/references/feature-map-example/search.md +45 -0
  50. package/vendor/pstack/skills/figure-it-out/SKILL.md +52 -0
  51. package/vendor/pstack/skills/how/SKILL.md +21 -0
  52. package/vendor/pstack/skills/in-your-own-words/SKILL.md +7 -0
  53. package/vendor/pstack/skills/interrogate/SKILL.md +31 -0
  54. package/vendor/pstack/skills/ketchup/SKILL.md +43 -0
  55. package/vendor/pstack/skills/ketchup-video/SKILL.md +29 -0
  56. package/vendor/pstack/skills/maintain-formal-verification-skill/SKILL.md +58 -0
  57. package/vendor/pstack/skills/maintain-verification-skill/SKILL.md +39 -0
  58. package/vendor/pstack/skills/make-bot-ui/SKILL.md +115 -0
  59. package/vendor/pstack/skills/no-comments/SKILL.md +24 -0
  60. package/vendor/pstack/skills/poteto-help/SKILL.md +162 -0
  61. package/vendor/pstack/skills/poteto-help/references/prompting.md +51 -0
  62. package/vendor/pstack/skills/poteto-help/references/recipes.md +51 -0
  63. package/vendor/pstack/skills/poteto-mode/SKILL.md +110 -0
  64. package/vendor/pstack/skills/poteto-mode/playbooks/authoring-a-skill.md +12 -0
  65. package/vendor/pstack/skills/poteto-mode/playbooks/autonomous-run.md +13 -0
  66. package/vendor/pstack/skills/poteto-mode/playbooks/autopilot-full.md +25 -0
  67. package/vendor/pstack/skills/poteto-mode/playbooks/autopilot-stack.md +8 -0
  68. package/vendor/pstack/skills/poteto-mode/playbooks/babysit.md +10 -0
  69. package/vendor/pstack/skills/poteto-mode/playbooks/bug-fix.md +15 -0
  70. package/vendor/pstack/skills/poteto-mode/playbooks/eval.md +25 -0
  71. package/vendor/pstack/skills/poteto-mode/playbooks/feature.md +21 -0
  72. package/vendor/pstack/skills/poteto-mode/playbooks/hillclimb.md +21 -0
  73. package/vendor/pstack/skills/poteto-mode/playbooks/investigation.md +14 -0
  74. package/vendor/pstack/skills/poteto-mode/playbooks/multi-phase-plan.md +11 -0
  75. package/vendor/pstack/skills/poteto-mode/playbooks/opening-a-pr.md +9 -0
  76. package/vendor/pstack/skills/poteto-mode/playbooks/pause-safely.md +10 -0
  77. package/vendor/pstack/skills/poteto-mode/playbooks/perf-issue.md +25 -0
  78. package/vendor/pstack/skills/poteto-mode/playbooks/prototype.md +14 -0
  79. package/vendor/pstack/skills/poteto-mode/playbooks/refactoring.md +16 -0
  80. package/vendor/pstack/skills/poteto-mode/playbooks/runtime-forensics.md +11 -0
  81. package/vendor/pstack/skills/poteto-mode/playbooks/session-pickup.md +11 -0
  82. package/vendor/pstack/skills/poteto-mode/playbooks/shipping.md +12 -0
  83. package/vendor/pstack/skills/poteto-mode/playbooks/trace-forensics.md +14 -0
  84. package/vendor/pstack/skills/poteto-mode/playbooks/visual-parity.md +11 -0
  85. package/vendor/pstack/skills/poteto-mode/playbooks/worktree-cleanup.md +12 -0
  86. package/vendor/pstack/skills/poteto-mode/references/bugbot-triage.md +142 -0
  87. package/vendor/pstack/skills/poteto-mode/scripts/bootstrap.ts +62 -0
  88. package/vendor/pstack/skills/poteto-mode/scripts/bun.lock +67 -0
  89. package/vendor/pstack/skills/poteto-mode/scripts/package.json +16 -0
  90. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/cli.test.ts +224 -0
  91. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/cli.ts +223 -0
  92. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/fakes.test-helper.ts +129 -0
  93. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/github.test.ts +498 -0
  94. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/github.ts +726 -0
  95. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/policy.test.ts +482 -0
  96. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/policy.ts +842 -0
  97. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/render.ts +169 -0
  98. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/tsconfig.json +13 -0
  99. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/types.compile.ts +93 -0
  100. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/types.ts +414 -0
  101. package/vendor/pstack/skills/poteto-mode/scripts/watch-pr/watch-pr +6 -0
  102. package/vendor/pstack/skills/poteto-mode/scripts/worktree-audit.sh +134 -0
  103. package/vendor/pstack/skills/poteto-mode/worker.md +11 -0
  104. package/vendor/pstack/skills/principle-attack-the-premise/SKILL.md +15 -0
  105. package/vendor/pstack/skills/principle-boundary-discipline/SKILL.md +11 -0
  106. package/vendor/pstack/skills/principle-build-the-lever/SKILL.md +14 -0
  107. package/vendor/pstack/skills/principle-encode-lessons-in-structure/SKILL.md +11 -0
  108. package/vendor/pstack/skills/principle-exhaust-the-design-space/SKILL.md +9 -0
  109. package/vendor/pstack/skills/principle-experience-first/SKILL.md +19 -0
  110. package/vendor/pstack/skills/principle-explain-the-number/SKILL.md +14 -0
  111. package/vendor/pstack/skills/principle-fix-root-causes/SKILL.md +14 -0
  112. package/vendor/pstack/skills/principle-foundational-thinking/SKILL.md +13 -0
  113. package/vendor/pstack/skills/principle-guard-the-context-window/SKILL.md +12 -0
  114. package/vendor/pstack/skills/principle-laziness-protocol/SKILL.md +10 -0
  115. package/vendor/pstack/skills/principle-make-operations-idempotent/SKILL.md +15 -0
  116. package/vendor/pstack/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md +14 -0
  117. package/vendor/pstack/skills/principle-minimize-reader-load/SKILL.md +15 -0
  118. package/vendor/pstack/skills/principle-model-the-domain/SKILL.md +15 -0
  119. package/vendor/pstack/skills/principle-never-block-on-the-human/SKILL.md +15 -0
  120. package/vendor/pstack/skills/principle-outcome-oriented-execution/SKILL.md +21 -0
  121. package/vendor/pstack/skills/principle-prove-it-works/SKILL.md +11 -0
  122. package/vendor/pstack/skills/principle-redesign-from-first-principles/SKILL.md +16 -0
  123. package/vendor/pstack/skills/principle-separate-before-serializing-shared-state/SKILL.md +11 -0
  124. package/vendor/pstack/skills/principle-sequence-verifiable-units/SKILL.md +13 -0
  125. package/vendor/pstack/skills/principle-subtract-before-you-add/SKILL.md +18 -0
  126. package/vendor/pstack/skills/principle-test-behavior-not-implementation/SKILL.md +16 -0
  127. package/vendor/pstack/skills/principle-type-system-discipline/SKILL.md +15 -0
  128. package/vendor/pstack/skills/recall/SKILL.md +35 -0
  129. package/vendor/pstack/skills/reflect/SKILL.md +17 -0
  130. package/vendor/pstack/skills/setup-pstack/SKILL.md +78 -0
  131. package/vendor/pstack/skills/sharpen/SKILL.md +16 -0
  132. package/vendor/pstack/skills/show-me-your-work/SKILL.md +82 -0
  133. package/vendor/pstack/skills/show-me-your-work/references/decision-log-template.tsv +1 -0
  134. package/vendor/pstack/skills/show-me-your-work/scripts/log.sh +42 -0
  135. package/vendor/pstack/skills/statechart/SKILL.md +82 -0
  136. package/vendor/pstack/skills/statechart/references/render.md +93 -0
  137. package/vendor/pstack/skills/statechart/scripts/backends/cfg.ts +33 -0
  138. package/vendor/pstack/skills/statechart/scripts/backends/mermaid.ts +249 -0
  139. package/vendor/pstack/skills/statechart/scripts/backends/plain-text.ts +72 -0
  140. package/vendor/pstack/skills/statechart/scripts/backends/report.ts +177 -0
  141. package/vendor/pstack/skills/statechart/scripts/frontends/config.ts +276 -0
  142. package/vendor/pstack/skills/statechart/scripts/frontends/dot.ts +74 -0
  143. package/vendor/pstack/skills/statechart/scripts/frontends/marks.ts +93 -0
  144. package/vendor/pstack/skills/statechart/scripts/frontends/messages.ts +52 -0
  145. package/vendor/pstack/skills/statechart/scripts/frontends/spec.ts +114 -0
  146. package/vendor/pstack/skills/statechart/scripts/frontends/trace.ts +24 -0
  147. package/vendor/pstack/skills/statechart/scripts/frontends/value.ts +166 -0
  148. package/vendor/pstack/skills/statechart/scripts/frontends/verdict.ts +40 -0
  149. package/vendor/pstack/skills/statechart/scripts/frontends/view.ts +119 -0
  150. package/vendor/pstack/skills/statechart/scripts/ir.ts +547 -0
  151. package/vendor/pstack/skills/statechart/scripts/package.json +11 -0
  152. package/vendor/pstack/skills/statechart/scripts/passes/annotate.ts +128 -0
  153. package/vendor/pstack/skills/statechart/scripts/passes/label.ts +269 -0
  154. package/vendor/pstack/skills/statechart/scripts/passes/lift.ts +85 -0
  155. package/vendor/pstack/skills/statechart/scripts/passes/loop-check.ts +68 -0
  156. package/vendor/pstack/skills/statechart/scripts/passes/paths.ts +60 -0
  157. package/vendor/pstack/skills/statechart/scripts/passes/reach.ts +135 -0
  158. package/vendor/pstack/skills/statechart/scripts/passes/region-check.ts +97 -0
  159. package/vendor/pstack/skills/statechart/scripts/passes/regions.ts +295 -0
  160. package/vendor/pstack/skills/statechart/scripts/pipeline.ts +76 -0
  161. package/vendor/pstack/skills/statechart/scripts/run.ts +506 -0
  162. package/vendor/pstack/skills/statechart/scripts/statechart +29 -0
  163. package/vendor/pstack/skills/statechart/scripts/statechart.ts +164 -0
  164. package/vendor/pstack/skills/statechart/scripts/test/ConfigOracle.java +63 -0
  165. package/vendor/pstack/skills/statechart/scripts/test/chart.test.ts +1253 -0
  166. package/vendor/pstack/skills/statechart/scripts/test/charts/Braces.mmd +7 -0
  167. package/vendor/pstack/skills/statechart/scripts/test/charts/Escapes.mmd +11 -0
  168. package/vendor/pstack/skills/statechart/scripts/test/charts/Phases.mmd +29 -0
  169. package/vendor/pstack/skills/statechart/scripts/test/cli.test.ts +1315 -0
  170. package/vendor/pstack/skills/statechart/scripts/test/config-fuzz.test.ts +263 -0
  171. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/ChartRun.out +57 -0
  172. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/Counter.cfg +3 -0
  173. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/Counter.tla +10 -0
  174. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/chart.mmd +9 -0
  175. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/graph.dot +16 -0
  176. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/report.md +7 -0
  177. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/sany.out +2 -0
  178. package/vendor/pstack/skills/statechart/scripts/test/corpus/Counter/verdict-1.out +49 -0
  179. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/ChartRun.out +60 -0
  180. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/CounterAction.cfg +4 -0
  181. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/CounterAction.tla +22 -0
  182. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/chart.mmd +26 -0
  183. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/graph.dot +19 -0
  184. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/report.md +20 -0
  185. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/sany.out +2 -0
  186. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/verdict-1.exit +1 -0
  187. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/verdict-1.out +56 -0
  188. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/verdict-2.exit +1 -0
  189. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/verdict-2.out +82 -0
  190. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterAction/verdict-3.out +57 -0
  191. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/ChartRun.out +59 -0
  192. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/CounterDeadlock.cfg +3 -0
  193. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/CounterDeadlock.tla +11 -0
  194. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/chart.mmd +22 -0
  195. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/graph.dot +16 -0
  196. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/report.md +17 -0
  197. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/sany.out +2 -0
  198. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/verdict-1.exit +1 -0
  199. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/verdict-1.out +56 -0
  200. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/verdict-2.exit +1 -0
  201. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterDeadlock/verdict-2.out +77 -0
  202. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/ChartRun.out +69 -0
  203. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/CounterFan.cfg +2 -0
  204. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/CounterFan.tla +11 -0
  205. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/chart.mmd +85 -0
  206. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/graph.dot +70 -0
  207. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/report.md +12 -0
  208. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/sany.out +2 -0
  209. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/verdict-1.exit +1 -0
  210. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/verdict-1.out +67 -0
  211. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterFan/verdict-2.out +57 -0
  212. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/ChartRun.exit +1 -0
  213. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/ChartRun.out +85 -0
  214. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/CounterGuard.cfg +6 -0
  215. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/CounterGuard.tla +13 -0
  216. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/chart.mmd +5 -0
  217. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/graph.dot +10 -0
  218. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/report.md +31 -0
  219. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/sany.out +2 -0
  220. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/verdict-1.exit +1 -0
  221. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/verdict-1.out +64 -0
  222. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/verdict-2.exit +1 -0
  223. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterGuard/verdict-2.out +77 -0
  224. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/ChartRun.out +55 -0
  225. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/CounterInitPast.cfg +3 -0
  226. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/CounterInitPast.tla +10 -0
  227. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/chart.mmd +12 -0
  228. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/graph.dot +6 -0
  229. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/report.md +12 -0
  230. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/sany.out +2 -0
  231. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/verdict-1.exit +1 -0
  232. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/verdict-1.out +33 -0
  233. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPast/verdict-2.out +54 -0
  234. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/ChartRun.out +54 -0
  235. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/CounterInitPastHolds.cfg +3 -0
  236. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/CounterInitPastHolds.tla +10 -0
  237. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/chart.mmd +1 -0
  238. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/graph.dot +6 -0
  239. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/report.md +7 -0
  240. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/sany.out +2 -0
  241. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInitPastHolds/verdict-1.out +46 -0
  242. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/ChartRun.out +59 -0
  243. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/CounterInstance.cfg +2 -0
  244. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/CounterInstance.tla +10 -0
  245. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/CounterSteps.tla +6 -0
  246. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/chart.mmd +17 -0
  247. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/graph.dot +15 -0
  248. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/report.md +14 -0
  249. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/sany.out +3 -0
  250. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/verdict-1.exit +1 -0
  251. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterInstance/verdict-1.out +78 -0
  252. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/ChartRun.out +59 -0
  253. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/CounterJump.cfg +3 -0
  254. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/CounterJump.tla +19 -0
  255. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/chart.mmd +26 -0
  256. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/graph.dot +22 -0
  257. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/report.md +12 -0
  258. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/sany.out +2 -0
  259. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/verdict-1.exit +1 -0
  260. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/verdict-1.out +58 -0
  261. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterJump/verdict-2.out +57 -0
  262. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/ChartRun.out +57 -0
  263. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/CounterLoop.cfg +2 -0
  264. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/CounterLoop.tla +11 -0
  265. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/chart.mmd +17 -0
  266. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/graph.dot +15 -0
  267. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/report.md +14 -0
  268. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/sany.out +2 -0
  269. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/verdict-1.exit +1 -0
  270. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterLoop/verdict-1.out +76 -0
  271. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/ChartRun.out +59 -0
  272. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/CounterOrder.cfg +3 -0
  273. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/CounterOrder.tla +11 -0
  274. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/chart.mmd +19 -0
  275. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/graph.dot +10 -0
  276. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/report.md +15 -0
  277. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/sany.out +2 -0
  278. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/verdict-1.exit +1 -0
  279. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/verdict-1.out +56 -0
  280. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/verdict-2.exit +1 -0
  281. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterOrder/verdict-2.out +67 -0
  282. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/ChartRun.out +62 -0
  283. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/CounterRules.cfg +6 -0
  284. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/CounterRules.tla +24 -0
  285. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/Moves.tla +5 -0
  286. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/chart.mmd +22 -0
  287. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/graph.dot +10 -0
  288. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/report.md +23 -0
  289. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/sany.out +3 -0
  290. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-1.exit +1 -0
  291. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-1.out +58 -0
  292. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-2.exit +1 -0
  293. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-2.out +66 -0
  294. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-3.exit +1 -0
  295. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-3.out +74 -0
  296. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterRules/verdict-4.out +59 -0
  297. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/ChartRun.out +58 -0
  298. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/CounterStart.cfg +3 -0
  299. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/CounterStart.tla +15 -0
  300. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/chart.mmd +18 -0
  301. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/graph.dot +13 -0
  302. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/report.md +11 -0
  303. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/sany.out +2 -0
  304. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/verdict-1.exit +1 -0
  305. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/verdict-1.out +33 -0
  306. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStart/verdict-2.out +57 -0
  307. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/ChartRun.out +57 -0
  308. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/CounterStop.cfg +3 -0
  309. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/CounterStop.tla +15 -0
  310. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/chart.mmd +7 -0
  311. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/graph.dot +13 -0
  312. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/report.md +6 -0
  313. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/sany.out +2 -0
  314. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterStop/verdict-1.out +49 -0
  315. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/ChartRun.out +61 -0
  316. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/CounterTie.cfg +4 -0
  317. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/CounterTie.tla +14 -0
  318. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/chart.mmd +30 -0
  319. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/graph.dot +19 -0
  320. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/report.md +27 -0
  321. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/sany.out +2 -0
  322. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-1.exit +1 -0
  323. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-1.out +56 -0
  324. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-2.exit +1 -0
  325. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-2.out +64 -0
  326. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-3.exit +1 -0
  327. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-3.out +87 -0
  328. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTie/verdict-4.out +57 -0
  329. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/ChartRun.out +60 -0
  330. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/CounterTieInGraph.cfg +3 -0
  331. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/CounterTieInGraph.tla +12 -0
  332. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/chart.mmd +23 -0
  333. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/graph.dot +19 -0
  334. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/report.md +11 -0
  335. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/sany.out +2 -0
  336. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/verdict-1.exit +1 -0
  337. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/verdict-1.out +56 -0
  338. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterTieInGraph/verdict-2.out +57 -0
  339. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/ChartRun.out +61 -0
  340. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/CounterView.cfg +4 -0
  341. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/CounterView.tla +14 -0
  342. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/chart.mmd +23 -0
  343. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/graph.dot +19 -0
  344. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/report.md +27 -0
  345. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/sany.out +2 -0
  346. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-1.exit +1 -0
  347. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-1.out +56 -0
  348. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-2.exit +1 -0
  349. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-2.out +64 -0
  350. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-3.exit +1 -0
  351. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-3.out +87 -0
  352. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/verdict-4.out +57 -0
  353. package/vendor/pstack/skills/statechart/scripts/test/corpus/CounterView/view.mjs +1 -0
  354. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/ChartRun.out +59 -0
  355. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/DieHard.cfg +4 -0
  356. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/DieHard.tla +38 -0
  357. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/chart.mmd +92 -0
  358. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/graph.dot +126 -0
  359. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/report.md +17 -0
  360. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/sany.out +2 -0
  361. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/verdict-1.exit +1 -0
  362. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/verdict-1.out +91 -0
  363. package/vendor/pstack/skills/statechart/scripts/test/corpus/DieHard/verdict-2.out +57 -0
  364. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/ChartRun.out +61 -0
  365. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/FirstRule.cfg +6 -0
  366. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/FirstRule.tla +11 -0
  367. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/chart.mmd +22 -0
  368. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/graph.dot +16 -0
  369. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/report.md +25 -0
  370. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/sany.out +2 -0
  371. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-1.exit +1 -0
  372. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-1.out +56 -0
  373. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-2.exit +1 -0
  374. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-2.out +64 -0
  375. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-3.exit +1 -0
  376. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-3.out +64 -0
  377. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-4.exit +1 -0
  378. package/vendor/pstack/skills/statechart/scripts/test/corpus/FirstRule/verdict-4.out +77 -0
  379. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/ChartRun.out +57 -0
  380. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/HiddenClock.cfg +4 -0
  381. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/HiddenClock.tla +11 -0
  382. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/chart.mmd +13 -0
  383. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/graph.dot +12 -0
  384. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/report.md +11 -0
  385. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/sany.out +2 -0
  386. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/verdict-1.exit +1 -0
  387. package/vendor/pstack/skills/statechart/scripts/test/corpus/HiddenClock/verdict-1.out +72 -0
  388. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/ChartRun.out +57 -0
  389. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/Login.cfg +3 -0
  390. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/Login.tla +62 -0
  391. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/chart.mmd +28 -0
  392. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/graph.dot +40 -0
  393. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/report.md +7 -0
  394. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/sany.out +1 -0
  395. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/verdict-1.out +47 -0
  396. package/vendor/pstack/skills/statechart/scripts/test/corpus/Login/view.mjs +1 -0
  397. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/ChartRun.out +57 -0
  398. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/LoginGuarded.cfg +2 -0
  399. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/LoginGuarded.tla +64 -0
  400. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/chart.mmd +28 -0
  401. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/graph.dot +37 -0
  402. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/report.md +8 -0
  403. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/sany.out +1 -0
  404. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/verdict-1.out +47 -0
  405. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginGuarded/view.mjs +1 -0
  406. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/ChartRun.out +60 -0
  407. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/LoginParallel.cfg +3 -0
  408. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/LoginParallel.tla +64 -0
  409. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/chart.mmd +44 -0
  410. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/graph.dot +58 -0
  411. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/report.md +17 -0
  412. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/sany.out +1 -0
  413. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/verdict-1.exit +1 -0
  414. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/verdict-1.out +83 -0
  415. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/verdict-2.out +57 -0
  416. package/vendor/pstack/skills/statechart/scripts/test/corpus/LoginParallel/view.mjs +1 -0
  417. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/ChartRun.out +60 -0
  418. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/MediaPlayer.cfg +3 -0
  419. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/MediaPlayer.tla +103 -0
  420. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/chart.mmd +43 -0
  421. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/graph.dot +93 -0
  422. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/report.md +14 -0
  423. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/sany.out +1 -0
  424. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/verdict-1.exit +1 -0
  425. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/verdict-1.out +59 -0
  426. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/verdict-2.out +72 -0
  427. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayer/view.mjs +3 -0
  428. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/ChartRun.out +57 -0
  429. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/MediaPlayerFixed.cfg +2 -0
  430. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/MediaPlayerFixed.tla +100 -0
  431. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/chart.mmd +31 -0
  432. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/graph.dot +85 -0
  433. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/report.md +9 -0
  434. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/sany.out +1 -0
  435. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/verdict-1.out +47 -0
  436. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerFixed/view.mjs +3 -0
  437. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/ChartRun.out +59 -0
  438. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/MediaPlayer.tla +103 -0
  439. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/MediaPlayerProps.cfg +3 -0
  440. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/MediaPlayerProps.tla +6 -0
  441. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/chart.mmd +42 -0
  442. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/graph.dot +93 -0
  443. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/report.md +19 -0
  444. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/sany.out +2 -0
  445. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-1.exit +1 -0
  446. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-1.out +61 -0
  447. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-2.out +59 -0
  448. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-3.out +61 -0
  449. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-4.exit +1 -0
  450. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-4.out +66 -0
  451. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-5.exit +1 -0
  452. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-5.out +58 -0
  453. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/verdict-6.out +49 -0
  454. package/vendor/pstack/skills/statechart/scripts/test/corpus/MediaPlayerProps/view.mjs +3 -0
  455. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/ChartRun.out +57 -0
  456. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/PickWorker.cfg +6 -0
  457. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/PickWorker.tla +11 -0
  458. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/chart.mmd +5 -0
  459. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/graph.dot +11 -0
  460. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/report.md +7 -0
  461. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/sany.out +5 -0
  462. package/vendor/pstack/skills/statechart/scripts/test/corpus/PickWorker/verdict-1.out +70 -0
  463. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/ChartRun.out +61 -0
  464. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/Shadow.cfg +4 -0
  465. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/Shadow.tla +11 -0
  466. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/ShadowLib.tla +6 -0
  467. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/ShadowSub.tla +3 -0
  468. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/chart.mmd +9 -0
  469. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/graph.dot +16 -0
  470. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/report.md +8 -0
  471. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/sany.out +4 -0
  472. package/vendor/pstack/skills/statechart/scripts/test/corpus/Shadow/verdict-1.out +65 -0
  473. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/ChartRun.out +59 -0
  474. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/SpacedNames.cfg +2 -0
  475. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/SpacedNames.tla +9 -0
  476. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/chart.mmd +23 -0
  477. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/graph.dot +17 -0
  478. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/report.md +15 -0
  479. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/sany.out +1 -0
  480. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/verdict-1.exit +1 -0
  481. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/verdict-1.out +65 -0
  482. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/verdict-2.exit +1 -0
  483. package/vendor/pstack/skills/statechart/scripts/test/corpus/SpacedNames/verdict-2.out +75 -0
  484. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/ChartRun.out +69 -0
  485. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/TwoPhase.cfg +3 -0
  486. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/TwoPhase.tla +75 -0
  487. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/chart.mmd +60 -0
  488. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/graph.dot +297 -0
  489. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/report.md +20 -0
  490. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/sany.out +1 -0
  491. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/verdict-1.exit +1 -0
  492. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/verdict-1.out +95 -0
  493. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/verdict-2.out +57 -0
  494. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhase/view.mjs +1 -0
  495. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/ChartRun.out +57 -0
  496. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/TwoPhaseFixed.cfg +3 -0
  497. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/TwoPhaseFixed.tla +75 -0
  498. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/chart.mmd +37 -0
  499. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/graph.dot +223 -0
  500. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/report.md +11 -0
  501. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/sany.out +1 -0
  502. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/verdict-1.out +47 -0
  503. package/vendor/pstack/skills/statechart/scripts/test/corpus/TwoPhaseFixed/view.mjs +1 -0
  504. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/ChartRun.exit +1 -0
  505. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/ChartRun.out +75 -0
  506. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/TypeGuard.cfg +5 -0
  507. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/TypeGuard.tla +11 -0
  508. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/chart.mmd +18 -0
  509. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/graph.dot +14 -0
  510. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/report.md +29 -0
  511. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/sany.out +2 -0
  512. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/verdict-1.exit +1 -0
  513. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/verdict-1.out +64 -0
  514. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/verdict-2.exit +1 -0
  515. package/vendor/pstack/skills/statechart/scripts/test/corpus/TypeGuard/verdict-2.out +75 -0
  516. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/ChartRun.out +58 -0
  517. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/UserNoDeadlock.cfg +2 -0
  518. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/UserNoDeadlock.tla +8 -0
  519. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/chart.mmd +22 -0
  520. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/graph.dot +16 -0
  521. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/report.md +15 -0
  522. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/sany.out +2 -0
  523. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/verdict-1.exit +1 -0
  524. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/verdict-1.out +56 -0
  525. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/verdict-2.exit +1 -0
  526. package/vendor/pstack/skills/statechart/scripts/test/corpus/UserNoDeadlock/verdict-2.out +77 -0
  527. package/vendor/pstack/skills/statechart/scripts/test/corpus.test.ts +441 -0
  528. package/vendor/pstack/skills/statechart/scripts/test/differential.test.ts +565 -0
  529. package/vendor/pstack/skills/statechart/scripts/test/drawn.ts +20 -0
  530. package/vendor/pstack/skills/statechart/scripts/test/grid/Grid.cfg +2 -0
  531. package/vendor/pstack/skills/statechart/scripts/test/grid/Grid.tla +9 -0
  532. package/vendor/pstack/skills/statechart/scripts/test/grid/sany.out +2 -0
  533. package/vendor/pstack/skills/statechart/scripts/test/java.ts +63 -0
  534. package/vendor/pstack/skills/statechart/scripts/test/labels.ts +648 -0
  535. package/vendor/pstack/skills/statechart/scripts/test/messages.test.ts +212 -0
  536. package/vendor/pstack/skills/statechart/scripts/test/pipeline.test.ts +270 -0
  537. package/vendor/pstack/skills/statechart/scripts/test/plain-tlc.test.ts +255 -0
  538. package/vendor/pstack/skills/statechart/scripts/test/render.test.ts +145 -0
  539. package/vendor/pstack/skills/statechart/scripts/test/tlc-out.test.ts +90 -0
  540. package/vendor/pstack/skills/statechart/scripts/test/tlc.ts +158 -0
  541. package/vendor/pstack/skills/statechart/scripts/tsconfig.json +11 -0
  542. package/vendor/pstack/skills/statechart/scripts/worker.ts +35 -0
  543. package/vendor/pstack/skills/swarm/SKILL.md +41 -0
  544. package/vendor/pstack/skills/tdd/SKILL.md +42 -0
  545. package/vendor/pstack/skills/teach/SKILL.md +21 -0
  546. package/vendor/pstack/skills/technical-writing/SKILL.md +70 -0
  547. package/vendor/pstack/skills/typescript-best-practices/SKILL.md +31 -0
  548. package/vendor/pstack/skills/typescript-best-practices/references/patterns.md +328 -0
  549. package/vendor/pstack/skills/unslop/SKILL.md +40 -0
  550. package/vendor/pstack/skills/why/SKILL.md +9 -0
  551. package/vendor/pstack/upstream-plugin.json +21 -0
@@ -0,0 +1,1253 @@
1
+ import assert from "node:assert/strict";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { test } from "node:test";
5
+ import { inspect } from "node:util";
6
+ import { fileURLToPath } from "node:url";
7
+ import v8 from "node:v8";
8
+ import vm from "node:vm";
9
+ import { mermaid } from "../backends/mermaid.ts";
10
+ import { report } from "../backends/report.ts";
11
+ import { readConfig } from "../frontends/config.ts";
12
+ import { readChecks, readSany, readSpec } from "../frontends/spec.ts";
13
+ import { checkView, json } from "../frontends/view.ts";
14
+ import {
15
+ type Bug,
16
+ EC,
17
+ type Graph,
18
+ hasSection,
19
+ key,
20
+ type Lasso,
21
+ LEVEL,
22
+ type PathStep,
23
+ type Rule,
24
+ ruleKey,
25
+ show,
26
+ type Spec,
27
+ type State,
28
+ stateRules,
29
+ type Step,
30
+ type Value,
31
+ type Vars,
32
+ type View,
33
+ } from "../ir.ts";
34
+ import { addPast, deadEnds, finder, lasso, mark } from "../passes/annotate.ts";
35
+ import { pathGraph } from "../passes/paths.ts";
36
+ import { bugs, walk } from "../passes/reach.ts";
37
+ import { parseDot } from "../frontends/dot.ts";
38
+ import { parseValue } from "../frontends/value.ts";
39
+ import { readCounterexample, readMarks } from "../frontends/marks.ts";
40
+ import { readMessages } from "../frontends/messages.ts";
41
+ import { readTrace } from "../frontends/trace.ts";
42
+ import { readVerdict } from "../frontends/verdict.ts";
43
+ import { compile, project } from "../pipeline.ts";
44
+ import { fileLines } from "../run.ts";
45
+ import { drawn } from "./drawn.ts";
46
+
47
+ const here = path.dirname(fileURLToPath(import.meta.url));
48
+ const corpus = (name: string, file: string) => path.join(here, "corpus", name, file);
49
+
50
+ const corpusSpec = (name: string) => {
51
+ const configFile = corpus(name, `${name}.cfg`);
52
+ const config = readConfig({ file: configFile, text: fs.readFileSync(configFile, "utf8") });
53
+ return readSpec({
54
+ module: name,
55
+ sany: readSany(fs.readFileSync(corpus(name, "sany.out"), "utf8")),
56
+ checks: readChecks({ configFile, config }),
57
+ });
58
+ };
59
+
60
+ type StateRow = [id: string, vars: Vars, start?: boolean, breaks?: string[]];
61
+ type StepRow = [from: string, to: string, action: string];
62
+
63
+ const graphOf = (states: StateRow[], steps: StepRow[]) => {
64
+ const graph: Graph = { states: new Map(), steps: [] };
65
+ for (const [id, vars, start, breaks = []] of states) {
66
+ const rules: Rule[] = [];
67
+ for (const name of breaks) rules.push({ kind: "invariant", name });
68
+ graph.states.set(id, { vars, start: !!start, breaks: rules });
69
+ }
70
+ for (const [from, to, action] of steps) graph.steps.push({ from, to, action });
71
+ return graph;
72
+ };
73
+
74
+ const lookup = <K, V>(map: ReadonlyMap<K, V>, k: K) => {
75
+ const v = map.get(k);
76
+ assert.ok(v !== undefined, `${inspect(k)} is missing`);
77
+ return v;
78
+ };
79
+
80
+ const field = (value: Value, name: string) => {
81
+ if (typeof value !== "object" || value.kind !== "function")
82
+ throw new Error(`${inspect(value)} is not a function.`);
83
+ for (let i = 0; i < value.keys.length; i++) {
84
+ const k = value.keys[i];
85
+ if (k === name || (typeof k === "object" && k.kind === "model" && k.name === name))
86
+ return value.values[i];
87
+ }
88
+ throw new Error(`${inspect(value)} has no ${name}.`);
89
+ };
90
+
91
+ function draw(graph: Graph, view: View, loops: Bug[] = []) {
92
+ const found = [...bugs(graph), ...loops];
93
+ const { chart, stories } = project(graph, walk(graph), view, found);
94
+ const spec: Spec = {
95
+ module: "Test",
96
+ variables: [],
97
+ invariants: [],
98
+ properties: [],
99
+ deadlock: false,
100
+ written: [],
101
+ };
102
+ const result = {
103
+ spec,
104
+ graph,
105
+ paths: undefined,
106
+ rules: [],
107
+ properties: [],
108
+ stop: undefined,
109
+ drawing: undefined,
110
+ states: { distinct: graph.states.size, initial: 1, complete: true, cut: false },
111
+ };
112
+ return { chart: mermaid(chart), report: report(result, found, chart, stories) };
113
+ }
114
+
115
+ const marked = (chart: string) => {
116
+ const out: { [label: string]: string } = {};
117
+ for (const [, id, cls] of chart.matchAll(/^ {2}class (s\d+) (breaks|mayBreak)$/gm)) {
118
+ const label = chart.match(new RegExp(`^\\s*${id}: (.*)$`, "m"))?.[1];
119
+ assert.ok(label !== undefined, `${id} has no label`);
120
+ out[label] = cls;
121
+ }
122
+ return out;
123
+ };
124
+
125
+ test("TLA+ values reach the view as the skill says: sequences from 1, sets as arrays", () => {
126
+ const seen = (text: string) => json(parseValue(text));
127
+ assert.deepEqual(seen('<<1, "a", <<>>>>'), { 1: 1, 2: "a", 3: {} });
128
+ assert.deepEqual(seen("{r1, -2}"), ["r1", -2]);
129
+ assert.deepEqual(seen("{}"), []);
130
+ assert.deepEqual(seen("-1..2"), [-1, 0, 1, 2]);
131
+ assert.deepEqual(seen('[ok |-> TRUE, msg |-> "say \\"hi\\""]'), {
132
+ ok: true,
133
+ msg: 'say "hi"',
134
+ });
135
+ assert.deepEqual(seen("[]"), {});
136
+ assert.deepEqual(seen('(r1 :> "working" @@ r2 :> "aborted")'), {
137
+ r1: "working",
138
+ r2: "aborted",
139
+ });
140
+ });
141
+
142
+ test("a value outside the grammar TLC prints is an error, never a guess", () => {
143
+ for (const text of [
144
+ "<<1, 2",
145
+ "<<1 2>>",
146
+ "{1,}",
147
+ "[1 |-> 2]",
148
+ "[a |-> 1,]",
149
+ "[,]",
150
+ "(1 :> 2",
151
+ "1..",
152
+ "1..x",
153
+ '"\\q"',
154
+ "x y",
155
+ "",
156
+ "SUBSET {1}",
157
+ "[S -> T]",
158
+ ])
159
+ assert.throws(() => parseValue(text), /cannot read TLA\+ value/, text);
160
+ });
161
+
162
+ test("a label prints each value in TLA+, so values that TLC tells apart look apart", () => {
163
+ const shown = (text: string) => show(parseValue(text));
164
+ for (const text of [
165
+ '"A"',
166
+ "A",
167
+ "<<0>>",
168
+ '("1" :> 0)',
169
+ "[a |-> 1]",
170
+ "[]",
171
+ "1..3",
172
+ "{1, 2, 3}",
173
+ "<<>>",
174
+ "{}",
175
+ "TRUE",
176
+ '"TRUE"',
177
+ '"a\\nb\\tc\\"d\\\\e"',
178
+ '(<<1, 2>> :> {A, "A"} @@ 0 :> -1)',
179
+ ])
180
+ assert.equal(shown(text), text);
181
+ });
182
+
183
+ test("equal TLA+ values share one key and unequal ones do not, as TLC compares them", () => {
184
+ const same = [
185
+ ["1..3", "{1, 2, 3}"],
186
+ ["1..3", "{3, 1, 2, 2}"],
187
+ ["{1..2, {1, 2}}", "{{1, 2}}"],
188
+ ["{}", "1..0"],
189
+ ["{5}", "5..5"],
190
+ ["{0, 1, 2, 4, 5, 7}", "{7, 4, 5, 2, 1, 0}"],
191
+ ["<<0>>", "(1 :> 0)"],
192
+ ["<<4, 5>>", "(2 :> 5 @@ 1 :> 4)"],
193
+ ["[a |-> 1, b |-> 2]", '("b" :> 2 @@ "a" :> 1)'],
194
+ ["[]", "<< >>"],
195
+ ["{A, B}", "{B, A}"],
196
+ ['{"b", "a"}', '{"a", "b"}'],
197
+ ];
198
+ for (const [a, b] of same) assert.equal(key(parseValue(a)), key(parseValue(b)), `${a} = ${b}`);
199
+ const apart = [
200
+ ['"A"', "A"],
201
+ ["<<0>>", '("1" :> 0)'],
202
+ ["<<>>", "{}"],
203
+ ["1..3", "{1, 2}"],
204
+ ["1..3", "{1, 2, 3, 4}"],
205
+ ["{1, 3}", "1..3"],
206
+ ["TRUE", '"TRUE"'],
207
+ ["1", '"1"'],
208
+ ["<<1, 2>>", '"<<1, 2>>"'],
209
+ ["(2 :> 0)", "<<0>>"],
210
+ ["(0 :> 1 @@ 1 :> 2)", "<<1, 2>>"],
211
+ ["[a |-> 1]", "[a |-> 2]"],
212
+ ["{<<1>>}", "{<<2>>}"],
213
+ ];
214
+ for (const [a, b] of apart)
215
+ assert.notEqual(key(parseValue(a)), key(parseValue(b)), `${a} # ${b}`);
216
+ });
217
+
218
+ function replay(name: string, graph: Graph) {
219
+ const spec = corpusSpec(name);
220
+ const names = spec.variables;
221
+ const rules = stateRules(spec);
222
+ const find = finder(graph, names);
223
+ const marks = readMarks(readMessages(fileLines(corpus(name, "ChartRun.out"))), "chart");
224
+ const past = mark(graph, marks, names, rules, find);
225
+ const drawn = !fs.existsSync(corpus(name, "ChartRun.exit"));
226
+ for (const f of fs.readdirSync(path.join(here, "corpus", name)).sort()) {
227
+ if (!/^verdict-\d+\.out$/.test(f)) continue;
228
+ const messages = [...readMessages(fileLines(corpus(name, f)))];
229
+ const { broke } = readVerdict(messages);
230
+ if (!broke) continue;
231
+ let rule: Rule | undefined;
232
+ for (const r of rules)
233
+ if (r.kind === broke.kind && (broke.kind === "deadlock" || r.name === broke.name)) rule = r;
234
+ if (!rule) continue;
235
+ if (rule.kind === "deadlock" && drawn && !hasSection(spec, "CONSTRAINT", "ACTION_CONSTRAINT"))
236
+ deadEnds(graph, rule);
237
+ const counterexample = readCounterexample(messages);
238
+ if (drawn || lasso(graph, { seq: counterexample, loop: undefined }, names, find))
239
+ addPast(
240
+ graph,
241
+ counterexample,
242
+ names,
243
+ rule,
244
+ past,
245
+ hasSection(spec, "ACTION_CONSTRAINT"),
246
+ find,
247
+ );
248
+ }
249
+ }
250
+
251
+ test("each corpus bug path is the shortest way to its rule", () => {
252
+ const paths: { [rule: string]: string[] } = {};
253
+ for (const name of ["DieHard", "MediaPlayer", "LoginParallel", "TwoPhase", "FirstRule"]) {
254
+ const graph = parseDot(fileLines(corpus(name, "graph.dot")));
255
+ replay(name, graph);
256
+ for (const bug of bugs(graph)) {
257
+ paths[bug.rule.name] = [];
258
+ for (const p of bug.path) paths[bug.rule.name].push(p.action);
259
+ }
260
+ }
261
+ assert.deepEqual(paths.NotSolved, [
262
+ "FillBig",
263
+ "BigToSmall",
264
+ "EmptySmall",
265
+ "BigToSmall",
266
+ "FillBig",
267
+ "BigToSmall",
268
+ ]);
269
+ assert.deepEqual(paths.LoudWhenStopped, ["YouTurnItUp"]);
270
+ assert.equal(paths.SignedInWhileLocked.length, 5);
271
+ assert.equal(paths.TCConsistent.length, 5);
272
+ assert.equal(paths.TCConsistent.at(-1), "RMRcvCommitMsg");
273
+ assert.deepEqual(paths.NotOne, ["Next"]);
274
+ assert.deepEqual(paths.NotOneOrThree, ["Next"]);
275
+ assert.deepEqual(paths.AlsoNotOne, ["Next"]);
276
+ assert.deepEqual(paths.NoDeadlock, ["Next", "Next", "Next"]);
277
+ });
278
+
279
+ test("a chart of only the bug paths words each one with the view, asked once for each state and step", () => {
280
+ const spec = corpusSpec("FirstRule");
281
+ const rules = stateRules(spec);
282
+ const drawn = pathGraph(spec.variables);
283
+ const paths: Bug[] = [];
284
+ for (const f of fs.readdirSync(path.join(here, "corpus", "FirstRule")).sort()) {
285
+ if (!/^verdict-\d+\.out$/.test(f)) continue;
286
+ const messages = [...readMessages(fileLines(corpus("FirstRule", f)))];
287
+ const { broke } = readVerdict(messages);
288
+ for (const rule of rules)
289
+ if (broke?.kind === rule.kind && (broke.kind === "deadlock" || rule.name === broke.name))
290
+ paths.push(drawn.bug(rule, readCounterexample(messages)));
291
+ }
292
+ const asked: { [question: string]: number } = {};
293
+ const count = (question: string) => (asked[question] = (asked[question] ?? 0) + 1);
294
+ const view: View = {
295
+ state: (v) => {
296
+ count(`state ${v.x}`);
297
+ return `x is ${v.x}`;
298
+ },
299
+ step: (action, from, to) => {
300
+ count(`step ${from.x} to ${to.x}`);
301
+ return `${action} adds one`;
302
+ },
303
+ };
304
+ const { report: text, files } = compile(
305
+ {
306
+ spec: { ...spec, folder: "" },
307
+ graph: drawn.graph,
308
+ paths,
309
+ rules: [],
310
+ properties: [],
311
+ exit: 1,
312
+ stop: undefined,
313
+ drawing: undefined,
314
+ states: { distinct: 1234, initial: 1, complete: true, cut: false },
315
+ messages: [],
316
+ },
317
+ checkView(view, inspect),
318
+ );
319
+ assert.match(
320
+ text,
321
+ /^TLC reached 1,234 states, more than the chart budget of 500, so the chart draws only the bug paths: 4 states and 3 arrows\.$/m,
322
+ );
323
+ assert.ok(files.has("chart.mmd"));
324
+ for (const rule of ["NotOne", "NotOneOrThree", "AlsoNotOne"])
325
+ assert.match(
326
+ text,
327
+ new RegExp(`^## ${rule} breaks\\n.*\\n0\\. x is 0\\n1\\. Next adds one: x is 1$`, "m"),
328
+ );
329
+ assert.deepEqual(asked, {
330
+ "state 0": 1,
331
+ "step 0 to 1": 1,
332
+ "state 1": 1,
333
+ "step 1 to 2": 1,
334
+ "state 2": 1,
335
+ "step 2 to 3": 1,
336
+ "state 3": 1,
337
+ });
338
+ });
339
+
340
+ test("the graph that parseDot returns keeps none of the text it read", () => {
341
+ v8.setFlagsFromString("--expose-gc");
342
+ const gc: () => void = vm.runInNewContext("gc");
343
+ const heapUsed = () => {
344
+ gc();
345
+ gc();
346
+ return process.memoryUsage().heapUsed;
347
+ };
348
+ const MiB = 1 << 20;
349
+ const pieces = 16;
350
+ function* dot() {
351
+ for (let i = 0; i < pieces; i++) {
352
+ const id = `-${String(i).padStart(18, "7")}`;
353
+ const lines = [
354
+ `${id} [label="n = ${i}"];`,
355
+ `${id} -> ${id} [label="StayAtStateNumber${i}"];`,
356
+ ];
357
+ while (lines.length < 1024) lines.push(`// ${"x".repeat(1020)}`);
358
+ yield* `${lines.join("\n")}\n`.split("\n");
359
+ }
360
+ }
361
+ const before = heapUsed();
362
+ const graph = parseDot(dot());
363
+ const kept = heapUsed() - before;
364
+ assert.equal(graph.states.size, pieces);
365
+ assert.ok(kept < 4 * MiB, `the graph keeps ${(kept / MiB).toFixed(1)} MiB of ${pieces} MiB read`);
366
+ });
367
+
368
+ test("TLC's marks place on their states even when TLC wraps them over lines", () => {
369
+ const spec = corpusSpec("TwoPhase");
370
+ const out = fs.readFileSync(corpus("TwoPhase", "ChartRun.out"), "utf8");
371
+ const graph = parseDot(fs.readFileSync(corpus("TwoPhase", "graph.dot"), "utf8"));
372
+ assert.equal(
373
+ mark(graph, readMarks(readMessages(out), "chart"), spec.variables, stateRules(spec)).size,
374
+ 0,
375
+ );
376
+ const bad: Value[][] = [];
377
+ for (const s of graph.states.values())
378
+ if (s.breaks.length)
379
+ bad.push([field(s.vars.rmState, "r1"), field(s.vars.rmState, "r2")].sort());
380
+ assert.deepEqual(bad, [
381
+ ["aborted", "committed"],
382
+ ["aborted", "committed"],
383
+ ]);
384
+ const cut = out.slice(0, out.indexOf("{r1},"));
385
+ assert.throws(
386
+ () =>
387
+ mark(
388
+ parseDot(fs.readFileSync(corpus("TwoPhase", "graph.dot"), "utf8")),
389
+ readMarks(readMessages(cut), "chart"),
390
+ spec.variables,
391
+ stateRules(spec),
392
+ ),
393
+ {
394
+ message: `TLC's output ends inside a marked state, so the command cannot tell which rules it breaks:\n${cut.slice(cut.lastIndexOf('<< "chart",'))}\n`,
395
+ },
396
+ );
397
+ });
398
+
399
+ test("a chart tuple that TLC prints inside one of its messages is not a mark", () => {
400
+ const chart = '<<"chart", <<2>>, {"Bad"}>>';
401
+ const out = [
402
+ chart,
403
+ "@!@!@STARTMSG 2132:1 @!@!@",
404
+ "The first argument of Assert evaluated to FALSE; the second argument was:",
405
+ chart,
406
+ "@!@!@ENDMSG 2132 @!@!@",
407
+ "",
408
+ ].join("\n");
409
+ const marks = [...readMarks(readMessages(out), "chart")];
410
+ assert.equal(marks.length, 1);
411
+ assert.deepEqual(marks, [...readMarks(readMessages(`${chart}\n`), "chart")]);
412
+ });
413
+
414
+ test("a line that the spec prints in the shape of a mark is spec output, not a mark", () => {
415
+ const out = [
416
+ '<<"chart", <<2>>, {"Bad"}>>',
417
+ '<< "chart-01234",',
418
+ ' <<2>>, {"Bad"}>>',
419
+ '<<"chart-012", 1>>',
420
+ 'x <<"chart-0123", <<2>>, {"Bad"}>>',
421
+ '<< "chart-0123",',
422
+ " <<3>>,",
423
+ ' {"Bad"} >>',
424
+ "",
425
+ ].join("\n");
426
+ assert.deepEqual(
427
+ [...readMarks(readMessages(out), "chart-0123")],
428
+ [{ values: [3], broken: ["Bad"] }],
429
+ );
430
+ });
431
+
432
+ const inv: Rule = { kind: "invariant", name: "Inv" };
433
+
434
+ test("a wrapped mark with a model value named constructor places on its state", () => {
435
+ const graph = graphOf([["s0", { x: parseValue("constructor") }, true]], []);
436
+ assert.equal(
437
+ mark(
438
+ graph,
439
+ readMarks(readMessages('<<"chart",\n<<constructor>>,\n{"Inv"}>>\n'), "chart"),
440
+ ["x"],
441
+ [inv],
442
+ ).size,
443
+ 0,
444
+ );
445
+ assert.deepEqual(graph.states.get("s0")?.breaks, [inv]);
446
+ });
447
+
448
+ test("a tagged line in the wrong shape is an error, not spec output", () => {
449
+ for (const line of [
450
+ '<<"chart", [x |-> 1, y |-> 2], {"Inv"}>>',
451
+ '<<"chart", 1>>',
452
+ '<<"chart", <<1>>, <<"Inv">>>>',
453
+ '<<"chart", <<1>>, {1}>>',
454
+ '<<"chart", <<1>>, {"Inv"}, 2>>',
455
+ ])
456
+ assert.throws(
457
+ () => [...readMarks(readMessages(`${line}\n`), "chart")],
458
+ /TLC printed a mark that the command cannot read/,
459
+ line,
460
+ );
461
+ });
462
+
463
+ const ab: View = { state: (v) => ({ A: `a${v.a}`, B: `b${v.b}` }) };
464
+ const bit = (v: Vars) => `${v.a}${v.b}${v.c}`;
465
+ const xorStates: StateRow[] = [];
466
+ const xorSteps: StepRow[] = [];
467
+ for (const a of [0, 1])
468
+ for (const b of [0, 1])
469
+ for (const c of [0, 1]) {
470
+ const v = { a, b, c };
471
+ xorStates.push([bit(v), v, a === 0]);
472
+ if (a === 0 && b !== c) xorSteps.push([bit(v), bit({ ...v, a: 1 }), "Go"]);
473
+ if (b === 0) xorSteps.push([bit(v), bit({ ...v, b: 1 }), "FlipB"]);
474
+ if (c === 0) xorSteps.push([bit(v), bit({ ...v, c: 1 }), "FlipC"]);
475
+ }
476
+ const truthGraphs: { [name: string]: [Graph, View] } = {
477
+ starts: [
478
+ graphOf(
479
+ [
480
+ ["x0y0", { x: 0, y: 0 }, true],
481
+ ["x1y1", { x: 1, y: 1 }, true],
482
+ ["x1y0", { x: 1, y: 0 }],
483
+ ],
484
+ [["x0y0", "x1y0", "Step"]],
485
+ ),
486
+ { state: (v) => ({ X: `x${v.x}`, Y: `y${v.y}` }) },
487
+ ],
488
+ xor: [
489
+ graphOf(xorStates, xorSteps),
490
+ { state: (v) => ({ A: `a${v.a}`, B: `b${v.b}`, C: `c${v.c}` }) },
491
+ ],
492
+ fork: [
493
+ graphOf(
494
+ [
495
+ ["a0b0", { a: 0, b: 0 }, true],
496
+ ["a1b1", { a: 1, b: 1 }],
497
+ ["a2b2", { a: 2, b: 2 }],
498
+ ],
499
+ [
500
+ ["a0b0", "a1b1", "Sync"],
501
+ ["a0b0", "a2b2", "Sync"],
502
+ ],
503
+ ),
504
+ ab,
505
+ ],
506
+ partial: [
507
+ graphOf(
508
+ [
509
+ ["a0b0", { a: 0, b: 0 }, true],
510
+ ["a1b1", { a: 1, b: 1 }],
511
+ ["a1b0", { a: 1, b: 0 }],
512
+ ],
513
+ [
514
+ ["a0b0", "a1b1", "Act"],
515
+ ["a0b0", "a1b0", "Act"],
516
+ ],
517
+ ),
518
+ ab,
519
+ ],
520
+ lockstep: [
521
+ graphOf(
522
+ [
523
+ ["a0b0", { a: 0, b: 0 }, true],
524
+ ["a1b1", { a: 1, b: 1 }],
525
+ ],
526
+ [["a0b0", "a1b1", "Act"]],
527
+ ),
528
+ ab,
529
+ ],
530
+ interleaved: [
531
+ graphOf(
532
+ [
533
+ ["a0b0", { a: 0, b: 0 }, true],
534
+ ["a1b0", { a: 1, b: 0 }],
535
+ ["a0b1", { a: 0, b: 1 }],
536
+ ["a1b1", { a: 1, b: 1 }],
537
+ ],
538
+ [
539
+ ["a0b0", "a1b0", "Act"],
540
+ ["a0b0", "a0b1", "Act"],
541
+ ["a1b0", "a1b1", "Act"],
542
+ ["a0b1", "a1b1", "Act"],
543
+ ],
544
+ ),
545
+ ab,
546
+ ],
547
+ };
548
+
549
+ for (const [name, regions] of [
550
+ ["starts", false],
551
+ ["xor", false],
552
+ ["fork", false],
553
+ ["partial", false],
554
+ ["lockstep", true],
555
+ ["interleaved", true],
556
+ ] satisfies [string, boolean][]) {
557
+ test(`${name}: the chart uses regions only when they show the model's moves exactly`, () => {
558
+ const { chart, report: text } = draw(...truthGraphs[name]);
559
+ assert.equal(chart.includes('state "At the same time"'), regions);
560
+ assert.equal(/So the chart draws parent states in place of regions\.$/m.test(text), !regions);
561
+ });
562
+ }
563
+
564
+ test("the report says why regions cannot show a shared step that forks", () => {
565
+ assert.match(
566
+ draw(...truthGraphs.fork).report,
567
+ /^The regions chart lets A a0, B b0 go to A a1, B b2 by Sync, which the model never does\./m,
568
+ );
569
+ });
570
+
571
+ const forkToBug = graphOf(
572
+ [
573
+ ["a0b0", { a: 0, b: 0 }, true],
574
+ ["a1b1", { a: 1, b: 1 }],
575
+ ["a2b2", { a: 2, b: 2 }, false, ["Safe"]],
576
+ ],
577
+ [
578
+ ["a0b0", "a1b1", "Sync"],
579
+ ["a0b0", "a2b2", "Sync"],
580
+ ],
581
+ );
582
+
583
+ test("a chart that draws parent states in place of regions still names each region in a bug path", () => {
584
+ const { chart, report: text } = draw(forkToBug, ab);
585
+ assert.match(chart, /^ {2}state "A a2" as s\d+ \{$/m);
586
+ assert.match(text, /^0\. A a0, B b0\n1\. Sync: A a2, B b2$/m);
587
+ });
588
+
589
+ test("the view answers once for each state and step, so a chart of parent states agrees with its report", () => {
590
+ const asked: { [question: string]: number } = {};
591
+ const answer = (question: string) => {
592
+ asked[question] = (asked[question] ?? 0) + 1;
593
+ return asked[question] === 1 ? "first" : "later";
594
+ };
595
+ const { chart, report: text } = draw(forkToBug, {
596
+ state: (v) => {
597
+ const word = answer(`state ${v.a}`);
598
+ return { A: `a${v.a} ${word}`, B: `b${v.b}` };
599
+ },
600
+ step: (action, from, to) => `${action} ${answer(`step ${from.a} to ${to.a}`)}`,
601
+ group: (v) => (answer(`group ${v.a}`) === "first" ? "Calm" : "Busy"),
602
+ colors: { Calm: "blue", Busy: "orange" },
603
+ });
604
+ assert.match(chart, /^ {2}state "A a2 first" as s\d+ \{$/m);
605
+ assert.doesNotMatch(chart, /later|orange/);
606
+ assert.match(text, /^0\. A a0 first, B b0\n1\. Sync first: A a2 first, B b2$/m);
607
+ assert.deepEqual(asked, {
608
+ "state 0": 1,
609
+ "state 1": 1,
610
+ "state 2": 1,
611
+ "step 0 to 1": 1,
612
+ "step 0 to 2": 1,
613
+ "group 0": 1,
614
+ "group 1": 1,
615
+ "group 2": 1,
616
+ });
617
+ });
618
+
619
+ test("a region state is marked when every combination with it can break a rule", () => {
620
+ const graph = graphOf(
621
+ [
622
+ ["a0b0", { a: 0, b: 0 }, true],
623
+ ["a1b0", { a: 1, b: 0 }],
624
+ ["a2b0", { a: 2, b: 0 }, false, ["Safe"]],
625
+ ["a2b1", { a: 2, b: 1 }, false, ["Safe"]],
626
+ ["a0b1", { a: 0, b: 1 }],
627
+ ],
628
+ [
629
+ ["a0b0", "a1b0", "Go"],
630
+ ["a1b0", "a2b0", "Go"],
631
+ ["a2b0", "a2b1", "Flip"],
632
+ ["a0b0", "a0b1", "Flip"],
633
+ ],
634
+ );
635
+ assert.deepEqual(marked(draw(graph, ab).chart), { a2: "breaks" });
636
+ });
637
+
638
+ test("a combination that breaks a rule marks its states when no state of it has a mark", () => {
639
+ const graph = graphOf(
640
+ [
641
+ ["a0b0", { a: 0, b: 0 }, true],
642
+ ["a1b0", { a: 1, b: 0 }],
643
+ ["a0b1", { a: 0, b: 1 }],
644
+ ["a1b1", { a: 1, b: 1 }, false, ["Safe"]],
645
+ ],
646
+ [
647
+ ["a0b0", "a1b0", "GoA"],
648
+ ["a0b0", "a0b1", "GoB"],
649
+ ["a1b0", "a1b1", "GoB"],
650
+ ["a0b1", "a1b1", "GoA"],
651
+ ],
652
+ );
653
+ assert.deepEqual(marked(draw(graph, ab).chart), { a1: "mayBreak", b1: "mayBreak" });
654
+ });
655
+
656
+ test("a bug-path step that stays in one state is a loop in a flat chart only", () => {
657
+ const graph = graphOf(
658
+ [
659
+ ["s0", { x: 0, y: 0 }, true],
660
+ ["s1", { x: 0, y: 1 }, false, ["Safe"]],
661
+ ["s2", { x: 1, y: 0 }],
662
+ ],
663
+ [
664
+ ["s0", "s1", "Tick"],
665
+ ["s0", "s2", "Move"],
666
+ ],
667
+ );
668
+ const flat = draw(graph, { state: (v) => `x${v.x}` });
669
+ assert.match(flat.chart, /^ {2}(s\d+) --> \1: Tick$/m);
670
+ assert.doesNotMatch(flat.report, /does not draw/);
671
+ const regions = draw(graph, { state: (v) => ({ X: `x${v.x}`, Z: "z" }) });
672
+ assert.doesNotMatch(regions.chart, /Tick/);
673
+ assert.match(regions.report, /^The chart does not draw 1 steps that stay in one chart state\.$/m);
674
+ });
675
+
676
+ test("a step that leaves every child of a parent the same way is one arrow from the parent", () => {
677
+ const graph = graphOf(
678
+ [
679
+ ["x", { at: "Open.x" }, true],
680
+ ["y", { at: "Open.y" }],
681
+ ["done", { at: "Closed" }],
682
+ ],
683
+ [
684
+ ["x", "y", "Next"],
685
+ ["x", "done", "Quit"],
686
+ ["y", "done", "Quit"],
687
+ ],
688
+ );
689
+ const { chart } = draw(graph, { state: (v) => String(v.at).split(".") });
690
+ const open = chart.match(/^ {2}state "Open" as (s\d+) \{$/m)?.[1];
691
+ const closed = chart.match(/^ {2}(s\d+): Closed$/m)?.[1];
692
+ const quits = [];
693
+ for (const m of chart.matchAll(/^ {2}(s\d+) --> (s\d+): Quit$/gm)) quits.push([m[1], m[2]]);
694
+ assert.deepEqual(quits, [[open, closed]]);
695
+ });
696
+
697
+ test("a parent's only way in ends at the parent, and its start marker goes on to each state with that step's label", () => {
698
+ const graph = graphOf(
699
+ [
700
+ ["ask", { at: "Asking" }, true],
701
+ ["flat", { at: "Layout.Flat" }],
702
+ ["parents", { at: "Layout.Parents" }],
703
+ ["drawn", { at: "Done.Drawn" }],
704
+ ],
705
+ [
706
+ ["ask", "flat", "String"],
707
+ ["ask", "parents", "Array"],
708
+ ["flat", "drawn", "Draw"],
709
+ ],
710
+ );
711
+ const { chart } = draw(graph, { state: (v) => String(v.at).split(".") });
712
+ assert.deepEqual(drawn(chart).arrows.sort(), [
713
+ "Asking --> Layout",
714
+ "Done start --> Drawn",
715
+ "Flat --> Done: Draw",
716
+ "Layout start --> Flat: String",
717
+ "Layout start --> Parents: Array",
718
+ ]);
719
+ });
720
+
721
+ test("a parent that two states lead into keeps an arrow from each, since one start marker cannot say where each came from", () => {
722
+ const graph = graphOf(
723
+ [
724
+ ["a", { at: "A" }, true],
725
+ ["b", { at: "B" }],
726
+ ["p", { at: "P.p" }],
727
+ ["q", { at: "P.q" }],
728
+ ],
729
+ [
730
+ ["a", "b", "Go"],
731
+ ["a", "p", "Left"],
732
+ ["b", "q", "Right"],
733
+ ],
734
+ );
735
+ const { chart } = draw(graph, { state: (v) => String(v.at).split(".") });
736
+ assert.deepEqual(drawn(chart).arrows.sort(), ["A --> B: Go", "A --> p: Left", "B --> q: Right"]);
737
+ });
738
+
739
+ test("a label codes only the characters that Mermaid reads as syntax, so TLA+ values stay as TLC prints them", () => {
740
+ const graph = graphOf(
741
+ [
742
+ ["s0", { n: 0 }, true],
743
+ ["s1", { n: 1 }],
744
+ ],
745
+ [["s0", "s1", "Go"]],
746
+ );
747
+ const { chart } = draw(graph, {
748
+ state: (v) => (v.n ? 'x: "1";\nnext' : "a <b> #2"),
749
+ step: () => 'say: <<1, "a">> :> [k |-> {}] @@ 2..3',
750
+ });
751
+ assert.match(chart, /^ {2}s\d+: a #60;b> #35;2$/m);
752
+ assert.match(chart, /^ {2}s\d+: x: "1"#59; next$/m);
753
+ assert.match(chart, /^ {2}s\d+ --> s\d+: say: <<1, "a">> :> \[k \|-> \{\}\] @@ 2\.\.3$/m);
754
+ });
755
+
756
+ test("a label with %% stays text and cannot open a Mermaid directive", () => {
757
+ const graph = graphOf(
758
+ [
759
+ ["s0", { n: 0 }, true],
760
+ ["s1", { n: 1 }],
761
+ ],
762
+ [["s0", "s1", "Go"]],
763
+ );
764
+ const { chart } = draw(graph, {
765
+ state: (v) => (v.n ? "%%{init: {}}%%" : "a %%{ b"),
766
+ step: () => "%% go",
767
+ });
768
+ assert.doesNotMatch(chart, /%%/);
769
+ assert.match(chart, /^ {2}s\d+: a #37;%\{ b$/m);
770
+ assert.match(chart, /^ {2}s\d+: #37;%\{init: \{\}\}#37;%$/m);
771
+ assert.match(chart, /^ {2}s\d+ --> s\d+: #37;% go$/m);
772
+ });
773
+
774
+ test("each line break in a label or a colors key is a space, so it cannot start a chart line", () => {
775
+ const graph = graphOf(
776
+ [
777
+ ["s0", { n: 0 }, true],
778
+ ["s1", { n: 1 }],
779
+ ],
780
+ [["s0", "s1", "Go"]],
781
+ );
782
+ const { chart } = draw(graph, {
783
+ state: (v) => (v.n ? "b\r\n\r\v\f\u0085\u2028\u2029\tc" : "a"),
784
+ step: () => "go\r s9: Ghost",
785
+ group: (v) => (v.n ? "Shut\r s99: Ghost state" : "Open"),
786
+ colors: { Open: "blue", "Shut\r s99: Ghost state": "pink" },
787
+ });
788
+ assert.doesNotMatch(chart, /[\r\v\f\u0085\u2028\u2029\t]/);
789
+ assert.match(chart, /^ {2}s\d+: b {9}c$/m);
790
+ assert.match(chart, /^ {2}s\d+ --> s\d+: go {3}s9: Ghost$/m);
791
+ assert.match(chart, /^ {4}lg1: Shut {3}s99: Ghost state$/m);
792
+ assert.doesNotMatch(chart, /^\s*s9{1,2}:/m);
793
+ });
794
+
795
+ test("a label of only white space or with a lone surrogate still has text in the chart", () => {
796
+ const graph = graphOf(
797
+ [
798
+ ["s0", { n: 0 }, true],
799
+ ["s1", { n: 1 }],
800
+ ],
801
+ [["s0", "s1", "Go"]],
802
+ );
803
+ const { chart } = draw(graph, {
804
+ state: (v) => (v.n ? "a\ud800b" : "\t"),
805
+ step: () => " ",
806
+ });
807
+ assert.match(chart, /^ {2}s\d+: #32;$/m);
808
+ assert.match(chart, /^ {2}s\d+: a#65533;b$/m);
809
+ assert.match(chart, /^ {2}s\d+ --> s\d+: #32;$/m);
810
+ });
811
+
812
+ test("NUL and C1 controls in a label are left out, since a browser draws their character references as other characters", () => {
813
+ const graph = graphOf(
814
+ [
815
+ ["s0", { n: 0 }, true],
816
+ ["s1", { n: 1 }],
817
+ ],
818
+ [["s0", "s1", "Go"]],
819
+ );
820
+ const { chart } = draw(graph, {
821
+ state: (v) => (v.n ? ["P\0\x80", "C\u00004Dynamic"] : "\0\x9f"),
822
+ step: () => "a\0\x80b\x85c\x9fd",
823
+ });
824
+ assert.doesNotMatch(chart, /[\0\x80-\x9f]|#0;|#1[2-5]\d;/);
825
+ assert.match(chart, /^ {2}s\d+: #32;$/m);
826
+ assert.match(chart, /^ {2}state "P" as s\d+ \{$/m);
827
+ assert.match(chart, /^ {4}s\d+: C#52;Dynamic$/m);
828
+ assert.match(chart, /^ {2}s\d+ --> s\d+: ab cd$/m);
829
+ });
830
+
831
+ test("a label puts a word joiner inside fl° and ¶ß, since Mermaid decodes a label's text a second time", () => {
832
+ const graph = graphOf(
833
+ [
834
+ ["s0", { n: 0 }, true],
835
+ ["s1", { n: 1 }],
836
+ ],
837
+ [["s0", "s1", "Go"]],
838
+ );
839
+ const { chart } = draw(graph, {
840
+ state: (v) => (v.n ? ["fl\0°lt¶ß", "x"] : "fl°°65¶ßstateß"),
841
+ step: () => "fl ° ¶ ß",
842
+ });
843
+ assert.match(chart, /^ {2}s\d+: fl#8288;#176;#176;65#182;#8288;ßstateß$/m);
844
+ assert.match(chart, /^ {2}state "fl#8288;#176;lt#182;#8288;ß" as s\d+ \{$/m);
845
+ assert.match(chart, /^ {2}s\d+ --> s\d+: fl #176; #182; ß$/m);
846
+ });
847
+
848
+ test('a label puts a word joiner inside marker-end=", since Mermaid rewrites marker-end="url(…# in the drawn SVG', () => {
849
+ const graph = graphOf(
850
+ [
851
+ ["s0", { n: 0 }, true],
852
+ ["s1", { n: 1 }],
853
+ ],
854
+ [["s0", "s1", "Go"]],
855
+ );
856
+ const { chart } = draw(graph, {
857
+ title: 'marker-end="url(a#b',
858
+ state: (v) => (v.n ? ['marker-end="url(p#q', "x"] : 'marker-end="url(a#b'),
859
+ step: () => 'a="b" = "c"',
860
+ });
861
+ assert.match(chart, /^title: "marker-end=fl°°8288¶ß\\"url\(afl°°35¶ßb"$/m);
862
+ assert.match(chart, /^ {2}s\d+: marker-end=#8288;"url\(a#35;b$/m);
863
+ assert.match(chart, /^ {2}state "marker-end=#8288;#34;url\(p#35;q" as s\d+ \{$/m);
864
+ assert.match(chart, /^ {2}s\d+ --> s\d+: a="b" = "c"$/m);
865
+ });
866
+
867
+ test("a parent or region name with [[fork]], [[join]], or [[choice]] stays text", () => {
868
+ const nested = graphOf(
869
+ [
870
+ ["x", { n: 0 }, true],
871
+ ["y", { n: 1 }],
872
+ ],
873
+ [["x", "y", "Go"]],
874
+ );
875
+ const parents = draw(nested, {
876
+ state: (v) => [["a [[fork]]", "[[JOIN]]"][Number(v.n)], "In"],
877
+ }).chart;
878
+ assert.match(parents, /^ {2}state "a #91;\[fork\]\]" as s\d+ \{$/m);
879
+ assert.match(parents, /^ {2}state "#91;\[JOIN\]\]" as s\d+ \{$/m);
880
+ const parallel = graphOf(
881
+ [
882
+ ["s0", { x: 0, y: 0 }, true],
883
+ ["s1", { x: 1, y: 0 }],
884
+ ],
885
+ [["s0", "s1", "GoX"]],
886
+ );
887
+ const regions = draw(parallel, {
888
+ state: (v) => ({ "[[choice]]": `X${v.x}`, Other: `Y${v.y}` }),
889
+ }).chart;
890
+ assert.match(regions, /^ {4}state "#91;\[choice\]\]" as r0 \{$/m);
891
+ assert.doesNotMatch(parents + regions, /\[\[/);
892
+ });
893
+
894
+ test("a label with C4Container, C4Component, C4Dynamic, or C4Deployment keeps the chart a state diagram", () => {
895
+ const graph = graphOf(
896
+ [
897
+ ["s0", { n: 0 }, true],
898
+ ["s1", { n: 1 }],
899
+ ],
900
+ [["s0", "s1", "Go"]],
901
+ );
902
+ const { chart } = draw(graph, {
903
+ state: (v) => (v.n ? ["C4Component", "C4Deployment"] : "aC4Dynamic"),
904
+ step: () => "C4Container C4Context",
905
+ });
906
+ assert.doesNotMatch(chart, /C4(?:Container|Component|Dynamic|Deployment)/);
907
+ assert.match(chart, /^ {2}s\d+: aC#52;Dynamic$/m);
908
+ assert.match(chart, /^ {2}state "C#52;Component" as s\d+ \{$/m);
909
+ assert.match(chart, /^ {4}s\d+: C#52;Deployment$/m);
910
+ assert.match(chart, /^ {2}s\d+ --> s\d+: C#52;Container C4Context$/m);
911
+ });
912
+
913
+ test("a title with < cannot open an HTML tag that rewrites the chart's quotes", () => {
914
+ const graph = graphOf(
915
+ [
916
+ ["s0", { n: 0 }, true],
917
+ ["s1", { n: 1 }],
918
+ ],
919
+ [["s0", "s1", "Go"]],
920
+ );
921
+ const { chart } = draw(graph, { title: "<a=", state: (v) => ["P", `S${v.n}`] });
922
+ assert.doesNotMatch(chart, /</);
923
+ assert.match(chart, /^title: "fl°°60¶ßa="$/m);
924
+ assert.match(chart, /^ {2}state "P" as s\d+ \{$/m);
925
+ });
926
+
927
+ test("the title writes each character outside the allow list in the form Mermaid decodes in a title", () => {
928
+ const graph = graphOf(
929
+ [
930
+ ["s0", { n: 0 }, true],
931
+ ["s1", { n: 1 }],
932
+ ],
933
+ [["s0", "s1", "Go"]],
934
+ );
935
+ const state = (v: Vars) => `S${v.n}`;
936
+ const title = (t: string) =>
937
+ draw(graph, { title: t, state }).chart.match(/^---\ntitle: (.*)\n---\n/)?.[1];
938
+ assert.equal(title("Queue<T> for AT&T"), '"Queuefl°°60¶ßT> for ATfl°°38¶ßT"');
939
+ assert.equal(title("fl°°65¶ß"), '"flfl°°8288¶ßfl°°176¶ßfl°°176¶ß65fl°°182¶ßfl°°8288¶ßß"');
940
+ assert.equal(title('a\0b\x80\n"c"'), '"ab \\"c\\""');
941
+ const blank = draw(graph, { title: "\0\0", state }).chart;
942
+ assert.doesNotMatch(blank, /\0|^---$|^title:/m);
943
+ assert.match(blank, /^stateDiagram-v2$/m);
944
+ });
945
+
946
+ test("labels write the space between direction and LR, RL, TB, or BT as #32;", () => {
947
+ const graph = graphOf(
948
+ [
949
+ ["s0", { n: 0 }, true],
950
+ ["s1", { n: 1 }],
951
+ ["s2", { n: 2 }],
952
+ ["s3", { n: 3 }],
953
+ ],
954
+ [
955
+ ["s0", "s1", "Turn"],
956
+ ["s1", "s2", "Back"],
957
+ ["s2", "s3", "Go"],
958
+ ],
959
+ );
960
+ const steps: { [action: string]: string } = {
961
+ Turn: "turn direction LR",
962
+ Back: "back direction rl",
963
+ Go: "go",
964
+ };
965
+ const { chart } = draw(graph, {
966
+ state: (v) =>
967
+ ["Idle", "Facing direction TB", "Redirection\tlrx", "Up DIRECTION BT"][Number(v.n)],
968
+ step: (a) => steps[a],
969
+ });
970
+ assert.doesNotMatch(chart, /direction\s+(?:LR|RL|TB|BT)/i);
971
+ assert.match(chart, /^ {2}s\d+: Facing direction#32;TB$/m);
972
+ assert.match(chart, /^ {2}s\d+: Redirection#32;lrx$/m);
973
+ assert.match(chart, /^ {2}s\d+: Up DIRECTION#32;BT$/m);
974
+ assert.match(chart, /^ {2}s\d+ --> s\d+: turn direction#32;LR$/m);
975
+ assert.match(chart, /^ {2}s\d+ --> s\d+: back direction#32;rl$/m);
976
+ });
977
+
978
+ test("a view that cannot give a chart says what to change", () => {
979
+ const graph = graphOf(
980
+ [
981
+ ["p", { x: "A" }, true],
982
+ ["q", { x: "A.B" }],
983
+ ],
984
+ [["p", "q", "Go"]],
985
+ );
986
+ assert.throws(
987
+ () => draw(graph, { state: (v) => String(v.x).split(".") }),
988
+ /both as a state and as a parent state/,
989
+ );
990
+ assert.throws(
991
+ () => draw(graph, { state: (v) => (v.x === "A" ? { R: "x" } : { S: "y" }) }),
992
+ /Return the same regions for every state/,
993
+ );
994
+ assert.throws(() => draw(graph, { state: () => [] }), /Return a string, an array of strings/);
995
+ });
996
+
997
+ const keyGraph = () =>
998
+ graphOf(
999
+ [
1000
+ ["idle", { pos: "idle", key: parseValue("[on |-> FALSE, at |-> 0]") }, true],
1001
+ ["waitKeyOff", { pos: "wait", key: parseValue("[on |-> FALSE, at |-> 0]") }],
1002
+ ["waitKeyOn", { pos: "wait", key: parseValue("[on |-> TRUE, at |-> 0]") }],
1003
+ ["done", { pos: "done", key: parseValue("[on |-> TRUE, at |-> 0]") }],
1004
+ ],
1005
+ [
1006
+ ["idle", "waitKeyOff", "Go"],
1007
+ ["idle", "waitKeyOn", "GoKey"],
1008
+ ["waitKeyOff", "waitKeyOff", "Tick"],
1009
+ ["waitKeyOff", "idle", "Back"],
1010
+ ["waitKeyOn", "done", "Open"],
1011
+ ],
1012
+ );
1013
+ const keyState = (header: string, pos: string) => ({
1014
+ code: EC.TLC_STATE_PRINT2,
1015
+ level: LEVEL.STATE,
1016
+ body: [header, `/\\ pos = "${pos}"`, "/\\ key = [at |-> 0, on |-> FALSE]", ""],
1017
+ });
1018
+ const keyTrace = () =>
1019
+ readTrace([
1020
+ keyState("1: <Initial predicate>", "idle"),
1021
+ keyState("2: <Go line 9, col 3 to line 9, col 20 of module Key>", "wait"),
1022
+ { code: EC.TLC_STATE_PRINT3, level: LEVEL.STATE, body: ["3: Stuttering"] },
1023
+ ]);
1024
+
1025
+ test("a loop's trace finds its states when TLC prints record fields in another order", () => {
1026
+ const graph = keyGraph();
1027
+ const bug = lasso(graph, keyTrace(), ["pos", "key"]);
1028
+ assert.ok(bug);
1029
+ assert.equal(bug.start, "idle");
1030
+ const moves = [];
1031
+ for (const p of bug.path) moves.push([p.action, p.state]);
1032
+ assert.deepEqual(moves, [["Go", "waitKeyOff"]]);
1033
+ assert.equal(bug.loop, 1);
1034
+ assert.equal(bug.stutters, true);
1035
+ });
1036
+
1037
+ test("a view may hide a step inside a loop, but not a step out of it", () => {
1038
+ const graph = keyGraph();
1039
+ const found = lasso(graph, keyTrace(), ["pos", "key"]);
1040
+ assert.ok(found);
1041
+ const loop: Bug = { rule: { kind: "property", name: "Opens" }, ...found };
1042
+ const state = (v: Vars) => `${v.pos}, key ${field(v.key, "on") ? "on" : "off"}`;
1043
+ const { report } = draw(graph, { state, step: (a) => (a === "Tick" ? null : a) }, [loop]);
1044
+ assert.match(report, /^The run stops in "wait, key off" forever\.$/m);
1045
+ assert.throws(
1046
+ () => draw(graph, { state, step: (a) => (a === "Back" ? null : a) }, [loop]),
1047
+ /the step Back that changes pos\. It is on the path to the Opens bug or leaves its loop/,
1048
+ );
1049
+ });
1050
+
1051
+ test("a loop that passes one state twice names it once", () => {
1052
+ const graph = graphOf(
1053
+ [
1054
+ ["a", { pos: "a" }, true],
1055
+ ["b", { pos: "b" }],
1056
+ ["c", { pos: "c" }],
1057
+ ],
1058
+ [
1059
+ ["a", "b", "Up"],
1060
+ ["b", "a", "Down"],
1061
+ ["a", "c", "Side"],
1062
+ ["c", "a", "Back"],
1063
+ ],
1064
+ );
1065
+ const path: PathStep[] = [];
1066
+ for (const [from, to] of ["ab", "ba", "ac", "ca"]) {
1067
+ let step: Step | undefined;
1068
+ for (const t of graph.steps)
1069
+ if (t.from === from && t.to === to) {
1070
+ step = t;
1071
+ break;
1072
+ }
1073
+ assert.ok(step);
1074
+ path.push({ action: step.action, state: to, step });
1075
+ }
1076
+ const loop: Bug = {
1077
+ rule: { kind: "property", name: "Settles" },
1078
+ start: "a",
1079
+ path,
1080
+ loop: 0,
1081
+ stutters: false,
1082
+ };
1083
+ const { report } = draw(graph, { state: (v) => v.pos }, [loop]);
1084
+ assert.match(report, /^The run loops through "a", "b" and "c" forever\.$/m);
1085
+ });
1086
+
1087
+ test("a chart that draws a way out of a loop that the loop cannot take stops the command", () => {
1088
+ const graph = keyGraph();
1089
+ const found = lasso(graph, keyTrace(), ["pos", "key"]);
1090
+ assert.ok(found);
1091
+ const loop: Bug = { rule: { kind: "property", name: "Opens" }, ...found };
1092
+ assert.throws(
1093
+ () => draw(graph, { state: (v) => v.pos }, [loop]),
1094
+ /draws the step Open out of wait, but the Opens loop cannot take it there/,
1095
+ );
1096
+ const { chart } = draw(
1097
+ graph,
1098
+ { state: (v) => `${v.pos}, key ${field(v.key, "on") ? "on" : "off"}` },
1099
+ [loop],
1100
+ );
1101
+ const wait = chart.match(/^ {2}(s\d+): wait, key off$/m)?.[1];
1102
+ assert.match(chart, new RegExp(`^ {2}class ${wait} repeats$`, "m"));
1103
+ });
1104
+
1105
+ test("a region named __proto__ is a region like any other", () => {
1106
+ const graph = graphOf(
1107
+ [
1108
+ ["s0", { x: 0, y: 0 }, true],
1109
+ ["s1", { x: 1, y: 0 }],
1110
+ ["s2", { x: 0, y: 1 }],
1111
+ ],
1112
+ [
1113
+ ["s0", "s1", "GoX"],
1114
+ ["s0", "s2", "GoY"],
1115
+ ],
1116
+ );
1117
+ const { chart } = draw(graph, {
1118
+ state: (v): unknown => JSON.parse(`{"__proto__": "X${v.x}", "Other": "Y${v.y}"}`),
1119
+ });
1120
+ assert.match(chart, /^ {4}state "#95;#95;proto#95;#95;" as r0 \{$/m);
1121
+ assert.match(chart, /^ {6}s0 --> s1: GoX \[when Y0\]$/m);
1122
+ assert.match(chart, /^ {4}state "Other" as r1 \{$/m);
1123
+ });
1124
+
1125
+ test("checkView takes a full view and refuses each wrong kind and every bad color", () => {
1126
+ checkView({}, inspect);
1127
+ checkView(
1128
+ {
1129
+ state: (v: Vars) => v.x,
1130
+ step: (a: string) => a,
1131
+ group: () => "Busy",
1132
+ colors: { Busy: "blue" },
1133
+ title: "T",
1134
+ },
1135
+ inspect,
1136
+ );
1137
+ assert.throws(() => checkView({ colors: null }, inspect), /\bcolors\b[\s\S]*\bobject\b/);
1138
+ assert.throws(() => checkView({ colors: ["blue"] }, inspect), /\bcolors\b[\s\S]*\bobject\b/);
1139
+ assert.throws(() => checkView({ state: "Busy" }, inspect), /\bstate\b[\s\S]*\bfunction\b/);
1140
+ assert.throws(
1141
+ () => checkView({ colors: { Busy: "red", Idle: "repeats", Done: "tan" } }, inspect),
1142
+ (error: unknown) =>
1143
+ error instanceof Error &&
1144
+ /\bBusy\b[\s\S]*"red"/.test(error.message) &&
1145
+ /\bIdle\b[\s\S]*"repeats"/.test(error.message) &&
1146
+ !/\bDone\b/.test(error.message),
1147
+ );
1148
+ });
1149
+
1150
+ test("a group named like an Object method still needs its own color", () => {
1151
+ const graph = graphOf([["s0", { x: 0 }, true]], []);
1152
+ assert.throws(
1153
+ () => draw(graph, checkView({ group: () => "toString", colors: {} }, inspect)),
1154
+ /group\(\) returned "toString"/,
1155
+ );
1156
+ });
1157
+
1158
+ test("a message writes each value the way JavaScript shows it", () => {
1159
+ const loop: { self?: unknown } = {};
1160
+ loop.self = loop;
1161
+ assert.throws(
1162
+ () =>
1163
+ checkView(
1164
+ { colors: { Lost: NaN, Far: Infinity, Big: 7n, Boxed: new String("blue"), Loop: loop } },
1165
+ inspect,
1166
+ ),
1167
+ /"Lost" the color NaN, "Far" the color Infinity, "Big" the color 7n, "Boxed" the color \[String: 'blue'\] and "Loop" the color <ref \*1> \{ self: \[Circular \*1\] \}\./,
1168
+ );
1169
+ const graph = graphOf([["s0", { x: 0 }, true]], []);
1170
+ assert.throws(
1171
+ () => draw(graph, checkView({ group: () => NaN, colors: {} }, inspect)),
1172
+ /group\(\) returned NaN,/,
1173
+ );
1174
+ });
1175
+
1176
+ test("checkView takes colors only as a plain object", () => {
1177
+ const bare: object = Object.create(null);
1178
+ checkView({ colors: Object.assign(bare, { Busy: "blue" }) }, inspect);
1179
+ const inherited: object = Object.create({ Busy: "blue" });
1180
+ for (const colors of [new Map([["Busy", "blue"]]), inherited, new String("blue")])
1181
+ assert.throws(() => checkView({ colors }, inspect), {
1182
+ message: "The view's colors must be a plain object.",
1183
+ });
1184
+ });
1185
+
1186
+ test("the chart uses the colors that checkView read once from the view's own keys", () => {
1187
+ const graph = graphOf([["s0", { x: 0 }, true]], []);
1188
+ let reads = 0;
1189
+ const flips = {
1190
+ get Busy() {
1191
+ reads += 1;
1192
+ return reads === 1 ? "blue" : "breaks";
1193
+ },
1194
+ };
1195
+ const changed = { Busy: "blue" };
1196
+ const changes = () => {
1197
+ changed.Busy = "breaks";
1198
+ return "Busy";
1199
+ };
1200
+ for (const view of [
1201
+ { group: () => "Busy", colors: flips },
1202
+ { group: changes, colors: changed },
1203
+ ]) {
1204
+ const { chart } = draw(graph, checkView(view, inspect));
1205
+ assert.match(chart, /^ {2}class s\d+ blue$/m);
1206
+ assert.doesNotMatch(chart, /\bbreaks\b/);
1207
+ }
1208
+ const hidden = Object.defineProperty({}, "Busy", { value: "breaks" });
1209
+ assert.throws(
1210
+ () => draw(graph, checkView({ group: () => "Busy", colors: hidden }, inspect)),
1211
+ /group\(\) returned "Busy", which colors does not name/,
1212
+ );
1213
+ const key = Symbol("Busy");
1214
+ assert.throws(
1215
+ () => draw(graph, checkView({ group: () => key, colors: { [key]: "breaks" } }, inspect)),
1216
+ /group\(\) returned Symbol\(Busy\), which colors does not name/,
1217
+ );
1218
+ });
1219
+
1220
+ test("a chart state with mixed groups gets no color, even when colors names undefined", () => {
1221
+ const graph = graphOf(
1222
+ [
1223
+ ["s0", { x: 0 }, true],
1224
+ ["s1", { x: 1 }],
1225
+ ],
1226
+ [["s0", "s1", "Go"]],
1227
+ );
1228
+ const view: View = {
1229
+ state: () => "Same",
1230
+ group: (v) => (v.x ? "B" : "A"),
1231
+ colors: { A: "blue", B: "teal", undefined: "pink" },
1232
+ };
1233
+ assert.doesNotMatch(draw(graph, view).chart, /^ {2}class /m);
1234
+ });
1235
+
1236
+ test("a graph of 10,000 states draws in seconds with no view", () => {
1237
+ const n = 100;
1238
+ const states: StateRow[] = [];
1239
+ const steps: StepRow[] = [];
1240
+ for (let x = 0; x < n; x++)
1241
+ for (let y = 0; y < n; y++) {
1242
+ const far = x === n - 1 && y === n - 1;
1243
+ states.push([`${x},${y}`, { x, y }, x + y === 0, far ? ["Safe"] : []]);
1244
+ if (x + 1 < n) steps.push([`${x},${y}`, `${x + 1},${y}`, "Right"]);
1245
+ if (y + 1 < n) steps.push([`${x},${y}`, `${x},${y + 1}`, "Down"]);
1246
+ }
1247
+ const start = performance.now();
1248
+ const { chart, report: text } = draw(graphOf(states, steps), {});
1249
+ const seconds = (performance.now() - start) / 1000;
1250
+ assert.match(text, /^The shortest path has 198 steps:$/m);
1251
+ assert.equal(chart.match(/^ {2}s\d+: /gm)?.length, n * n);
1252
+ assert.ok(seconds < 5, `drawing took ${seconds.toFixed(1)} s`);
1253
+ });