tla-ts 0.0.2 → 0.0.3-dev.3cf2ad0

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