@overkill-dev/linearizability 0.0.1 → 0.0.2
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.
- package/LICENSE +21 -0
- package/linearizability/check-linearizability.d.ts +3 -0
- package/linearizability/check-linearizability.d.ts.map +1 -0
- package/linearizability/check-linearizability.js +51 -0
- package/linearizability/check-linearizability.js.map +1 -0
- package/linearizability/concurrent-history.js +93 -0
- package/linearizability/concurrent-history.js.map +1 -0
- package/linearizability/linearizability-budget.js +26 -0
- package/linearizability/linearizability-budget.js.map +1 -0
- package/linearizability/linearizability-definition.d.ts +68 -0
- package/linearizability/linearizability-definition.d.ts.map +1 -0
- package/linearizability/linearizability-history.js +37 -0
- package/linearizability/linearizability-history.js.map +1 -0
- package/linearizability/linearizability-search.js +45 -0
- package/linearizability/linearizability-search.js.map +1 -0
- package/linearizability/linearizability-validation.js +58 -0
- package/linearizability/linearizability-validation.js.map +1 -0
- package/linearizability/linearizability.d.ts +4 -0
- package/linearizability/linearizability.d.ts.map +1 -0
- package/linearizability/linearizability.js +87 -0
- package/linearizability/linearizability.js.map +1 -0
- package/package.json +42 -6
- package/packages/linearizability/linearizability.entry-point.d.ts +5 -0
- package/packages/linearizability/linearizability.entry-point.d.ts.map +1 -0
- package/packages/linearizability/linearizability.entry-point.js +3 -0
- package/packages/linearizability/linearizability.entry-point.js.map +1 -0
- package/readme.md +106 -4
- package/software-bill-of-materials.cyclonedx.json +118 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) Overkill contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { LinearizabilityRequest, LinearizabilityResult } from './linearizability-definition.ts';
|
|
2
|
+
export declare function checkLinearizability<State, Operation, Output>(request: LinearizabilityRequest<State, Operation, Output>): Promise<LinearizabilityResult>;
|
|
3
|
+
//# sourceMappingURL=check-linearizability.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check-linearizability.d.ts","sourceRoot":"","sources":["../../../../source/linearizability/check-linearizability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AA8CrG,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAC/D,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,GAC1D,OAAO,CAAC,qBAAqB,CAAC,CAWhC"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { linearizabilityHistory } from "./linearizability-history.js";
|
|
2
|
+
import { linearizabilityBudget } from "./linearizability-budget.js";
|
|
3
|
+
import { linearizabilitySearch } from "./linearizability-search.js";
|
|
4
|
+
import { validateLinearizabilityRequest } from "./linearizability-validation.js";
|
|
5
|
+
async function evaluateHistory(request, budget, history) {
|
|
6
|
+
const root = { state: request.model.initial(), order: [], remaining: history };
|
|
7
|
+
let prefix = [];
|
|
8
|
+
async function search() {
|
|
9
|
+
for await (const node of linearizabilitySearch(root, request.model, budget.charge)) {
|
|
10
|
+
request.signal.throwIfAborted();
|
|
11
|
+
if (node.order.length > prefix.length) {
|
|
12
|
+
prefix = node.order;
|
|
13
|
+
}
|
|
14
|
+
if (node.remaining.every(function pending(operation) {
|
|
15
|
+
return operation.response === Number.POSITIVE_INFINITY;
|
|
16
|
+
})) {
|
|
17
|
+
return Object.freeze({ kind: 'linearizable', order: Object.freeze(node.order), work: budget.work() });
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
request.signal.throwIfAborted();
|
|
21
|
+
return Object.freeze({ kind: 'not-linearizable', prefix: Object.freeze(prefix), work: budget.work() });
|
|
22
|
+
}
|
|
23
|
+
try {
|
|
24
|
+
return await search();
|
|
25
|
+
}
|
|
26
|
+
catch (error) {
|
|
27
|
+
request.signal.throwIfAborted();
|
|
28
|
+
if (!budget.exhausted(error)) {
|
|
29
|
+
throw error;
|
|
30
|
+
}
|
|
31
|
+
return Object.freeze({
|
|
32
|
+
kind: 'inconclusive',
|
|
33
|
+
reason: 'max-work',
|
|
34
|
+
prefix: Object.freeze(prefix),
|
|
35
|
+
work: budget.work()
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
export async function checkLinearizability(request) {
|
|
40
|
+
validateLinearizabilityRequest(request);
|
|
41
|
+
const history = linearizabilityHistory(request.history);
|
|
42
|
+
request.signal.throwIfAborted();
|
|
43
|
+
const snapshot = {
|
|
44
|
+
...request,
|
|
45
|
+
history: request.history,
|
|
46
|
+
model: Object.freeze({ initial: request.model.initial, transition: request.model.transition })
|
|
47
|
+
};
|
|
48
|
+
const budget = linearizabilityBudget(request.maxWork, request.signal);
|
|
49
|
+
return evaluateHistory(snapshot, budget, history);
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=check-linearizability.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check-linearizability.js","sourceRoot":"","sources":["../../../../source/linearizability/check-linearizability.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import { isTestControlError } from "@overkill-dev/engine";
|
|
2
|
+
function asynchronousOutput(value) {
|
|
3
|
+
const candidate = value;
|
|
4
|
+
if (candidate === null) {
|
|
5
|
+
return false;
|
|
6
|
+
}
|
|
7
|
+
return (typeof candidate === 'object' || typeof candidate === 'function') &&
|
|
8
|
+
typeof Reflect.get(candidate, 'then') === 'function';
|
|
9
|
+
}
|
|
10
|
+
function recordOutcome(context, id, outcome) {
|
|
11
|
+
context.signal.throwIfAborted();
|
|
12
|
+
context.record(Object.freeze({ kind: 'respond', id, outcome: Object.freeze(outcome) }));
|
|
13
|
+
}
|
|
14
|
+
function recordError(context, id, error) {
|
|
15
|
+
context.signal.throwIfAborted();
|
|
16
|
+
if (isTestControlError(error)) {
|
|
17
|
+
context.controller.abort(error);
|
|
18
|
+
throw error;
|
|
19
|
+
}
|
|
20
|
+
recordOutcome(context, id, { kind: 'threw', error });
|
|
21
|
+
}
|
|
22
|
+
async function observeAsyncOutput(context, id, output) {
|
|
23
|
+
try {
|
|
24
|
+
recordOutcome(context, id, { kind: 'returned', value: await output });
|
|
25
|
+
}
|
|
26
|
+
catch (error) {
|
|
27
|
+
recordError(context, id, error);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function observeOutput(context, id, output) {
|
|
31
|
+
if (asynchronousOutput(output)) {
|
|
32
|
+
return observeAsyncOutput(context, id, output);
|
|
33
|
+
}
|
|
34
|
+
recordOutcome(context, id, { kind: 'returned', value: output });
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
function invokeOperation(context, id, operation) {
|
|
38
|
+
try {
|
|
39
|
+
return observeOutput(context, id, context.run(operation, context.system, context.signal));
|
|
40
|
+
}
|
|
41
|
+
catch (error) {
|
|
42
|
+
recordError(context, id, error);
|
|
43
|
+
return undefined;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
async function executeLane(context, operations, prediction, laneIndex) {
|
|
47
|
+
const predicted = prediction.values();
|
|
48
|
+
for (const [index, operation] of operations.entries()) {
|
|
49
|
+
context.signal.throwIfAborted();
|
|
50
|
+
const observation = predicted.next();
|
|
51
|
+
if (observation.done === true) {
|
|
52
|
+
throw new TypeError('Missing reconstructed operation.');
|
|
53
|
+
}
|
|
54
|
+
const id = `${laneIndex}:${index}`;
|
|
55
|
+
context.record(Object.freeze({ kind: 'invoke', id, operation: observation.value }));
|
|
56
|
+
await invokeOperation(context, id, operation);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
async function guardedLane(context, operations, prediction, laneIndex) {
|
|
60
|
+
try {
|
|
61
|
+
await executeLane(context, operations, prediction, laneIndex);
|
|
62
|
+
}
|
|
63
|
+
catch (error) {
|
|
64
|
+
if (!context.signal.aborted) {
|
|
65
|
+
context.controller.abort(error);
|
|
66
|
+
}
|
|
67
|
+
throw error;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
export async function concurrentHistory(run, system, programs, parentSignal) {
|
|
71
|
+
const [execution, prediction] = programs;
|
|
72
|
+
const controller = new AbortController();
|
|
73
|
+
const history = [];
|
|
74
|
+
const context = {
|
|
75
|
+
run,
|
|
76
|
+
system,
|
|
77
|
+
controller,
|
|
78
|
+
signal: AbortSignal.any([parentSignal, controller.signal]),
|
|
79
|
+
record(event) {
|
|
80
|
+
history.push(event);
|
|
81
|
+
}
|
|
82
|
+
};
|
|
83
|
+
await Promise.allSettled(execution.map(async function (operations, index) {
|
|
84
|
+
const lane = prediction[index];
|
|
85
|
+
if (lane === undefined) {
|
|
86
|
+
throw new TypeError('Missing reconstructed lane.');
|
|
87
|
+
}
|
|
88
|
+
return guardedLane(context, operations, lane, index);
|
|
89
|
+
}));
|
|
90
|
+
context.signal.throwIfAborted();
|
|
91
|
+
return Object.freeze(history);
|
|
92
|
+
}
|
|
93
|
+
//# sourceMappingURL=concurrent-history.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"concurrent-history.js","sourceRoot":"","sources":["../../../../source/linearizability/concurrent-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAA0C,CAAC;AAe9E,SAAS,kBAAkB,CAAS,KAA+B;IAC/D,MAAM,SAAS,GAAY,KAAK,CAAC;IACjC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,UAAU,CAAC;QACrE,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC;AAC7D,CAAC;AAED,SAAS,aAAa,CAClB,OAAoD,EACpD,EAAU,EACV,OAAuC;IAEvC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,WAAW,CAChB,OAAoD,EACpD,EAAU,EACV,KAAc;IAEd,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,CAAC;IAChB,CAAC;IACD,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC7B,OAAoD,EACpD,EAAU,EACV,MAAuB;IAEvB,IAAI,CAAC;QACD,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAClB,OAAoD,EACpD,EAAU,EACV,MAAgC;IAEhC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CACpB,OAAoD,EACpD,EAAU,EACV,SAAoB;IAEpB,IAAI,CAAC;QACD,OAAO,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9F,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CACtB,OAAoD,EACpD,UAAgC,EAChC,UAAgC,EAChC,SAAiB;IAEjB,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IACtC,KAAK,MAAM,CAAE,KAAK,EAAE,SAAS,CAAE,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAClD,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CACtB,OAAoD,EACpD,UAAgC,EAChC,UAAgC,EAChC,SAAiB;IAEjB,IAAI,CAAC;QACD,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,GAAuD,EACvD,MAAc,EACd,QAAyF,EACzF,YAAyB;IAEzB,MAAM,CAAE,SAAS,EAAE,UAAU,CAAE,GAAG,QAAQ,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAgD;QACzD,GAAG;QACH,MAAM;QACN,UAAU;QACV,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAE,YAAY,EAAE,UAAU,CAAC,MAAM,CAAE,CAAC;QAC5D,MAAM,CAAC,KAAK;YACR,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;KACJ,CAAC;IACF,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,WAAW,UAAU,EAAE,KAAK;QACpE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { setImmediate as yieldToEventLoop } from 'node:timers/promises';
|
|
2
|
+
const yieldInterval = 256;
|
|
3
|
+
export function linearizabilityBudget(maxWork, signal) {
|
|
4
|
+
let work = 0;
|
|
5
|
+
const exhaustion = new Error('Linearizability work budget exhausted.');
|
|
6
|
+
return {
|
|
7
|
+
async charge() {
|
|
8
|
+
signal.throwIfAborted();
|
|
9
|
+
if (work === maxWork) {
|
|
10
|
+
throw exhaustion;
|
|
11
|
+
}
|
|
12
|
+
work += 1;
|
|
13
|
+
if (work % yieldInterval === 0) {
|
|
14
|
+
await yieldToEventLoop();
|
|
15
|
+
}
|
|
16
|
+
signal.throwIfAborted();
|
|
17
|
+
},
|
|
18
|
+
work() {
|
|
19
|
+
return work;
|
|
20
|
+
},
|
|
21
|
+
exhausted(error) {
|
|
22
|
+
return error === exhaustion;
|
|
23
|
+
}
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=linearizability-budget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability-budget.js","sourceRoot":"","sources":["../../../../source/linearizability/linearizability-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,aAAa,GAAG,GAAG,CAAC;AAM1B,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,MAAmB;IACtE,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACvE,OAAO;QACH,KAAK,CAAC,MAAM;YACR,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnB,MAAM,UAAU,CAAC;YACrB,CAAC;YACD,IAAI,IAAI,CAAC,CAAC;YACV,IAAI,IAAI,GAAG,aAAa,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,gBAAgB,EAAE,CAAC;YAC7B,CAAC;YACD,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI;YACA,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,SAAS,CAAC,KAAK;YACX,OAAO,KAAK,KAAK,UAAU,CAAC;QAChC,CAAC;KACJ,CAAC;AACN,CAAC"}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import type { PropertySampleScope } from '@overkill-dev/property';
|
|
2
|
+
import type { ModelTransition } from '@overkill-dev/model';
|
|
3
|
+
type ReturnedOutcome<Output> = {
|
|
4
|
+
readonly kind: 'returned';
|
|
5
|
+
readonly value: Output;
|
|
6
|
+
};
|
|
7
|
+
type ThrownOutcome = {
|
|
8
|
+
readonly kind: 'threw';
|
|
9
|
+
readonly error: unknown;
|
|
10
|
+
};
|
|
11
|
+
export type LinearizabilityOutcome<Output> = ReturnedOutcome<Output> | ThrownOutcome;
|
|
12
|
+
export type LinearizabilityObservation<Operation, Output> = {
|
|
13
|
+
readonly operation: Operation;
|
|
14
|
+
readonly outcome: LinearizabilityOutcome<Output> | {
|
|
15
|
+
readonly kind: 'pending';
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
type Invocation<Operation> = {
|
|
19
|
+
readonly kind: 'invoke';
|
|
20
|
+
readonly id: string;
|
|
21
|
+
readonly operation: Operation;
|
|
22
|
+
};
|
|
23
|
+
type Response<Output> = {
|
|
24
|
+
readonly kind: 'respond';
|
|
25
|
+
readonly id: string;
|
|
26
|
+
readonly outcome: LinearizabilityOutcome<Output>;
|
|
27
|
+
};
|
|
28
|
+
export type LinearizabilityEvent<Operation, Output> = Invocation<Operation> | Response<Output>;
|
|
29
|
+
export type LinearizabilityTransition<State> = ModelTransition<State> | {
|
|
30
|
+
readonly kind: 'alternatives';
|
|
31
|
+
readonly states: readonly [State, State, ...(readonly State[])];
|
|
32
|
+
};
|
|
33
|
+
export type LinearizabilityModel<State, Operation, Output> = {
|
|
34
|
+
readonly initial: () => State;
|
|
35
|
+
readonly transition: (state: Readonly<State>, observation: Readonly<LinearizabilityObservation<Operation, Output>>) => LinearizabilityTransition<State>;
|
|
36
|
+
};
|
|
37
|
+
export type LinearizabilityRequest<State, Operation, Output> = {
|
|
38
|
+
readonly history: readonly LinearizabilityEvent<Operation, Output>[];
|
|
39
|
+
readonly model: LinearizabilityModel<State, Operation, Output>;
|
|
40
|
+
readonly maxWork: number;
|
|
41
|
+
readonly signal: AbortSignal;
|
|
42
|
+
};
|
|
43
|
+
type Linearizable = {
|
|
44
|
+
readonly kind: 'linearizable';
|
|
45
|
+
readonly order: readonly string[];
|
|
46
|
+
readonly work: number;
|
|
47
|
+
};
|
|
48
|
+
type NotLinearizable = {
|
|
49
|
+
readonly kind: 'not-linearizable';
|
|
50
|
+
readonly prefix: readonly string[];
|
|
51
|
+
readonly work: number;
|
|
52
|
+
};
|
|
53
|
+
type Inconclusive = {
|
|
54
|
+
readonly kind: 'inconclusive';
|
|
55
|
+
readonly reason: 'max-work';
|
|
56
|
+
readonly prefix: readonly string[];
|
|
57
|
+
readonly work: number;
|
|
58
|
+
};
|
|
59
|
+
export type LinearizabilityResult = Inconclusive | Linearizable | NotLinearizable;
|
|
60
|
+
export type LinearizabilityProgram<Operation> = readonly (readonly Operation[])[];
|
|
61
|
+
export type LinearizabilityDefinition<State, Operation, Output, System> = {
|
|
62
|
+
readonly model: LinearizabilityModel<State, Operation, Output>;
|
|
63
|
+
readonly maxWork: number;
|
|
64
|
+
readonly create: (sample: PropertySampleScope) => Promise<System> | System;
|
|
65
|
+
readonly run: (operation: Operation, system: System, signal: AbortSignal) => Output | Promise<Output>;
|
|
66
|
+
};
|
|
67
|
+
export {};
|
|
68
|
+
//# sourceMappingURL=linearizability-definition.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability-definition.d.ts","sourceRoot":"","sources":["../../../../source/linearizability/linearizability-definition.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
function snapshotOutcome(outcome) {
|
|
2
|
+
return outcome.kind === 'returned'
|
|
3
|
+
? Object.freeze({ kind: 'returned', value: outcome.value })
|
|
4
|
+
: Object.freeze({ kind: 'threw', error: outcome.error });
|
|
5
|
+
}
|
|
6
|
+
function recordEvent(previous, event, position) {
|
|
7
|
+
if (event.kind === 'invoke') {
|
|
8
|
+
if (previous !== undefined) {
|
|
9
|
+
throw new TypeError('Duplicate invocation ID.');
|
|
10
|
+
}
|
|
11
|
+
return Object.freeze({
|
|
12
|
+
id: event.id,
|
|
13
|
+
invocation: position,
|
|
14
|
+
response: Number.POSITIVE_INFINITY,
|
|
15
|
+
observation: Object.freeze({ operation: event.operation, outcome: Object.freeze({ kind: 'pending' }) })
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
if (previous?.response !== Number.POSITIVE_INFINITY) {
|
|
19
|
+
throw new TypeError('Response requires an unmatched invocation.');
|
|
20
|
+
}
|
|
21
|
+
return Object.freeze({
|
|
22
|
+
...previous,
|
|
23
|
+
response: position,
|
|
24
|
+
observation: Object.freeze({
|
|
25
|
+
operation: previous.observation.operation,
|
|
26
|
+
outcome: snapshotOutcome(event.outcome)
|
|
27
|
+
})
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
export function linearizabilityHistory(history) {
|
|
31
|
+
const operations = new Map();
|
|
32
|
+
for (const [position, event] of history.entries()) {
|
|
33
|
+
operations.set(event.id, recordEvent(operations.get(event.id), event, position));
|
|
34
|
+
}
|
|
35
|
+
return Object.freeze(Array.from(operations.values()));
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=linearizability-history.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability-history.js","sourceRoot":"","sources":["../../../../source/linearizability/linearizability-history.ts"],"names":[],"mappings":"AAaA,SAAS,eAAe,CAAS,OAAuC;IACpE,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;QAC9B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3D,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,WAAW,CAChB,QAA0D,EAC1D,KAA8C,EAC9C,QAAgB;IAEhB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,UAAU,EAAE,QAAQ;YACpB,QAAQ,EAAE,MAAM,CAAC,iBAAiB;YAClC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;SAC1G,CAAC,CAAC;IACP,CAAC;IACD,IAAI,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,SAAS;YACzC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;SAC1C,CAAC;KACL,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,sBAAsB,CAClC,OAA2D;IAE3D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgD,CAAC;IAC3E,KAAK,MAAM,CAAE,QAAQ,EAAE,KAAK,CAAE,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { validateLinearizabilityTransition } from "./linearizability-validation.js";
|
|
2
|
+
function nextStates(transition) {
|
|
3
|
+
validateLinearizabilityTransition(transition);
|
|
4
|
+
if (transition.kind === 'disabled') {
|
|
5
|
+
return [];
|
|
6
|
+
}
|
|
7
|
+
return transition.kind === 'enabled' ? [transition.state] : transition.states;
|
|
8
|
+
}
|
|
9
|
+
async function* successors(node, model, charge) {
|
|
10
|
+
for (const operation of node.remaining) {
|
|
11
|
+
await charge();
|
|
12
|
+
const blocked = node.remaining.some(function precedes(other) {
|
|
13
|
+
return other.response < operation.invocation;
|
|
14
|
+
});
|
|
15
|
+
if (!blocked) {
|
|
16
|
+
await charge();
|
|
17
|
+
const states = nextStates(model.transition(node.state, operation.observation));
|
|
18
|
+
for (const state of states) {
|
|
19
|
+
await charge();
|
|
20
|
+
yield {
|
|
21
|
+
state,
|
|
22
|
+
order: [...node.order, operation.id],
|
|
23
|
+
remaining: node.remaining.filter(function unselected(other) {
|
|
24
|
+
return other !== operation;
|
|
25
|
+
})
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
export async function* linearizabilitySearch(root, model, charge) {
|
|
32
|
+
const stack = [successors(root, model, charge)];
|
|
33
|
+
yield root;
|
|
34
|
+
while (stack.length > 0) {
|
|
35
|
+
const next = await stack.at(-1)?.next();
|
|
36
|
+
if (next === undefined || next.done === true) {
|
|
37
|
+
stack.pop();
|
|
38
|
+
}
|
|
39
|
+
else {
|
|
40
|
+
yield next.value;
|
|
41
|
+
stack.push(successors(next.value, model, charge));
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=linearizability-search.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability-search.js","sourceRoot":"","sources":["../../../../source/linearizability/linearizability-search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAQpF,SAAS,UAAU,CAAQ,UAA4C;IACnE,iCAAiC,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAE,UAAU,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;AACpF,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,UAAU,CACtB,IAA0C,EAC1C,KAAqD,EACrD,MAA2B;IAE3B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,MAAM,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,KAAK;YACvD,OAAO,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,MAAM,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,MAAM,EAAE,CAAC;gBACf,MAAM;oBACF,KAAK;oBACL,KAAK,EAAE,CAAE,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAE;oBACtC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,UAAU,CAAC,KAAK;wBACtD,OAAO,KAAK,KAAK,SAAS,CAAC;oBAC/B,CAAC,CAAC;iBACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,qBAAqB,CACxC,IAA0C,EAC1C,KAAqD,EACrD,MAA2B;IAE3B,MAAM,KAAK,GAAG,CAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAE,CAAC;IAClD,MAAM,IAAI,CAAC;IACX,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3C,KAAK,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,KAAK,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;AACL,CAAC"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
const returned = z
|
|
3
|
+
.object({ kind: z.literal('returned'), value: z.unknown() })
|
|
4
|
+
.refine(function hasValue(value) {
|
|
5
|
+
return Object.hasOwn(value, 'value');
|
|
6
|
+
});
|
|
7
|
+
const threw = z
|
|
8
|
+
.object({ kind: z.literal('threw'), error: z.unknown() })
|
|
9
|
+
.refine(function hasError(value) {
|
|
10
|
+
return Object.hasOwn(value, 'error');
|
|
11
|
+
});
|
|
12
|
+
const invocation = z
|
|
13
|
+
.object({ kind: z.literal('invoke'), id: z.string().trim().min(1), operation: z.unknown() })
|
|
14
|
+
.refine(function hasOperation(value) {
|
|
15
|
+
return Object.hasOwn(value, 'operation');
|
|
16
|
+
});
|
|
17
|
+
const response = z.object({
|
|
18
|
+
kind: z.literal('respond'),
|
|
19
|
+
id: z.string().trim().min(1),
|
|
20
|
+
outcome: z.union([returned, threw])
|
|
21
|
+
});
|
|
22
|
+
const callable = z.custom(function isCallable(value) {
|
|
23
|
+
return typeof value === 'function';
|
|
24
|
+
});
|
|
25
|
+
const requestSchema = z.object({
|
|
26
|
+
history: z.array(z.union([invocation, response])),
|
|
27
|
+
model: z.object({ initial: callable, transition: callable }),
|
|
28
|
+
maxWork: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
|
|
29
|
+
signal: z.instanceof(AbortSignal)
|
|
30
|
+
});
|
|
31
|
+
const minimumAlternatives = 2;
|
|
32
|
+
const alternativeStates = z
|
|
33
|
+
.custom(function dense(value) {
|
|
34
|
+
return Array.isArray(value) && Array.from(value.keys()).every(function present(index) {
|
|
35
|
+
return Object.hasOwn(value, index);
|
|
36
|
+
});
|
|
37
|
+
})
|
|
38
|
+
.pipe(z.array(z.unknown()).min(minimumAlternatives));
|
|
39
|
+
const transitionSchema = z.union([
|
|
40
|
+
z.object({ kind: z.literal('disabled') }),
|
|
41
|
+
z
|
|
42
|
+
.object({ kind: z.literal('enabled'), state: z.unknown() })
|
|
43
|
+
.refine(function hasState(value) {
|
|
44
|
+
return Object.hasOwn(value, 'state');
|
|
45
|
+
}),
|
|
46
|
+
z.object({ kind: z.literal('alternatives'), states: alternativeStates })
|
|
47
|
+
]);
|
|
48
|
+
export function validateLinearizabilityRequest(request) {
|
|
49
|
+
if (!requestSchema.safeParse(request).success) {
|
|
50
|
+
throw new TypeError('Invalid linearizability request.');
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
export function validateLinearizabilityTransition(transition) {
|
|
54
|
+
if (!transitionSchema.safeParse(transition).success) {
|
|
55
|
+
throw new TypeError('Invalid linearizability model transition.');
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=linearizability-validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability-validation.js","sourceRoot":"","sources":["../../../../source/linearizability/linearizability-validation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { PropertyBody } from '@overkill-dev/property';
|
|
2
|
+
import type { LinearizabilityDefinition, LinearizabilityProgram } from './linearizability-definition.ts';
|
|
3
|
+
export declare function linearizability<State, Operation, Output, System>(definition: LinearizabilityDefinition<State, Operation, Output, System>): PropertyBody<LinearizabilityProgram<Operation>>;
|
|
4
|
+
//# sourceMappingURL=linearizability.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability.d.ts","sourceRoot":"","sources":["../../../../source/linearizability/linearizability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,wBAA8C,CAAC;AAGtG,OAAO,KAAK,EACR,yBAAyB,EACzB,sBAAsB,EAEzB,MAAM,iCAAiC,CAAC;AAwEzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAC5D,UAAU,EAAE,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,GACxE,YAAY,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAuBjD"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { defineCompositeAssertion } from "@overkill-dev/assert";
|
|
3
|
+
import { captureSourceLocation, forwardAssertionSourceLocations } from "@overkill-dev/engine";
|
|
4
|
+
import { checkLinearizability } from "./check-linearizability.js";
|
|
5
|
+
import { concurrentHistory } from "./concurrent-history.js";
|
|
6
|
+
const consistentHistory = defineCompositeAssertion({
|
|
7
|
+
name: 'linearizability',
|
|
8
|
+
assert(check, evidence) {
|
|
9
|
+
return check.equal(evidence.result.kind, 'linearizable');
|
|
10
|
+
},
|
|
11
|
+
formatSummary(_context, evidence) {
|
|
12
|
+
return `Linearizability check of ${evidence.history.length} recorded events: ${evidence.result.kind}.`;
|
|
13
|
+
}
|
|
14
|
+
});
|
|
15
|
+
const callable = z.custom(function (value) {
|
|
16
|
+
return typeof value === 'function';
|
|
17
|
+
});
|
|
18
|
+
const definitionSchema = z.object({
|
|
19
|
+
create: callable,
|
|
20
|
+
run: callable,
|
|
21
|
+
model: z.object({ initial: callable, transition: callable }),
|
|
22
|
+
maxWork: z.number().int().positive().max(Number.MAX_SAFE_INTEGER)
|
|
23
|
+
});
|
|
24
|
+
const denseArray = z.custom(function (value) {
|
|
25
|
+
if (!Array.isArray(value)) {
|
|
26
|
+
return false;
|
|
27
|
+
}
|
|
28
|
+
return Array
|
|
29
|
+
.from({ length: value.length }, function (_entry, index) {
|
|
30
|
+
return Object.hasOwn(value, index);
|
|
31
|
+
})
|
|
32
|
+
.every(Boolean);
|
|
33
|
+
});
|
|
34
|
+
const programSchema = denseArray.pipe(z.array(denseArray));
|
|
35
|
+
function reconstructProgram(sample) {
|
|
36
|
+
const program = sample.reconstructInput();
|
|
37
|
+
if (!programSchema.safeParse(program).success) {
|
|
38
|
+
throw new TypeError('Linearizability input requires dense arrays of operation lanes.');
|
|
39
|
+
}
|
|
40
|
+
return Object.freeze(program.map(function (lane) {
|
|
41
|
+
return Object.freeze(Array.from(lane));
|
|
42
|
+
}));
|
|
43
|
+
}
|
|
44
|
+
async function evaluateProgram(definition, sample) {
|
|
45
|
+
sample.signal.throwIfAborted();
|
|
46
|
+
const execution = reconstructProgram(sample);
|
|
47
|
+
const prediction = reconstructProgram(sample);
|
|
48
|
+
if (execution.length !== prediction.length ||
|
|
49
|
+
execution.some(function (lane, index) {
|
|
50
|
+
return lane.length !== prediction[index]?.length;
|
|
51
|
+
})) {
|
|
52
|
+
throw new TypeError('Linearizability reconstruction changed lane lengths.');
|
|
53
|
+
}
|
|
54
|
+
const system = await definition.create(sample);
|
|
55
|
+
sample.signal.throwIfAborted();
|
|
56
|
+
const history = await concurrentHistory(definition.run, system, [execution, prediction], sample.signal);
|
|
57
|
+
const result = await checkLinearizability({
|
|
58
|
+
history,
|
|
59
|
+
model: definition.model,
|
|
60
|
+
maxWork: definition.maxWork,
|
|
61
|
+
signal: sample.signal
|
|
62
|
+
});
|
|
63
|
+
return { history, result };
|
|
64
|
+
}
|
|
65
|
+
export function linearizability(definition) {
|
|
66
|
+
if (!definitionSchema.safeParse(definition).success) {
|
|
67
|
+
throw new TypeError('linearizability() requires create, run, model, and a positive safe-integer maxWork.');
|
|
68
|
+
}
|
|
69
|
+
const snapshot = Object.freeze({
|
|
70
|
+
create: definition.create,
|
|
71
|
+
run: definition.run,
|
|
72
|
+
maxWork: definition.maxWork,
|
|
73
|
+
model: Object.freeze({ initial: definition.model.initial, transition: definition.model.transition })
|
|
74
|
+
});
|
|
75
|
+
const location = captureSourceLocation();
|
|
76
|
+
return async function executeProgram(_program, sample) {
|
|
77
|
+
const evidence = await evaluateProgram(snapshot, sample);
|
|
78
|
+
if (evidence.result.kind === 'inconclusive') {
|
|
79
|
+
sample.inconclusive(`Linearizability search exhausted ${evidence.result.work} work units (${evidence.result.reason}).`);
|
|
80
|
+
}
|
|
81
|
+
forwardAssertionSourceLocations([location], function () {
|
|
82
|
+
sample.assert(consistentHistory, evidence);
|
|
83
|
+
});
|
|
84
|
+
return sample.assert.collect();
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=linearizability.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability.js","sourceRoot":"","sources":["../../../../source/linearizability/linearizability.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,43 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
2
|
+
"author": "Christian Rackerseder <git@echooff.de>",
|
|
3
|
+
"bugs": {
|
|
4
|
+
"url": "https://github.com/enormora/overkill/issues"
|
|
5
|
+
},
|
|
6
|
+
"dependencies": {
|
|
7
|
+
"zod": "4.6.7"
|
|
8
|
+
},
|
|
9
|
+
"description": "Bounded concurrent-history checking above the Overkill model core.",
|
|
10
|
+
"engines": {
|
|
11
|
+
"node": "^26.9.0"
|
|
12
|
+
},
|
|
13
|
+
"exports": {
|
|
14
|
+
".": {
|
|
15
|
+
"import": "./packages/linearizability/linearizability.entry-point.js",
|
|
16
|
+
"types": "./packages/linearizability/linearizability.entry-point.d.ts"
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"homepage": "https://github.com/enormora/overkill#readme",
|
|
20
|
+
"keywords": [
|
|
21
|
+
"tdd",
|
|
22
|
+
"test",
|
|
23
|
+
"tests"
|
|
24
|
+
],
|
|
25
|
+
"license": "MIT",
|
|
26
|
+
"name": "@overkill-dev/linearizability",
|
|
27
|
+
"peerDependencies": {
|
|
28
|
+
"@overkill-dev/assert": "0.0.70",
|
|
29
|
+
"@overkill-dev/engine": "0.0.78",
|
|
30
|
+
"@overkill-dev/model": "0.0.3",
|
|
31
|
+
"@overkill-dev/property": "0.0.4"
|
|
32
|
+
},
|
|
33
|
+
"repository": {
|
|
34
|
+
"type": "git",
|
|
35
|
+
"url": "git+https://github.com/enormora/overkill.git"
|
|
36
|
+
},
|
|
37
|
+
"sideEffects": [
|
|
38
|
+
"./linearizability/linearizability-validation.js",
|
|
39
|
+
"./linearizability/linearizability.js"
|
|
40
|
+
],
|
|
41
|
+
"type": "module",
|
|
42
|
+
"version": "0.0.2"
|
|
43
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { checkLinearizability } from '../../linearizability/check-linearizability.ts';
|
|
2
|
+
export type { LinearizabilityOutcome, LinearizabilityObservation, LinearizabilityEvent, LinearizabilityTransition, LinearizabilityModel, LinearizabilityRequest, LinearizabilityResult } from '../../linearizability/linearizability-definition.ts';
|
|
3
|
+
export { linearizability } from '../../linearizability/linearizability.ts';
|
|
4
|
+
export type { LinearizabilityProgram, LinearizabilityDefinition } from '../../linearizability/linearizability-definition.ts';
|
|
5
|
+
//# sourceMappingURL=linearizability.entry-point.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/linearizability/linearizability.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,YAAY,EACR,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACxB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,YAAY,EACR,sBAAsB,EACtB,yBAAyB,EAC5B,MAAM,qDAAqD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linearizability.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/linearizability/linearizability.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAUtF,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC"}
|
package/readme.md
CHANGED
|
@@ -1,7 +1,109 @@
|
|
|
1
1
|
# @overkill-dev/linearizability
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
deprecated.
|
|
3
|
+
Bounded checking of recorded concurrent histories above Overkill's model layer.
|
|
4
|
+
Install separately from `@overkill-dev/test`.
|
|
6
5
|
|
|
7
|
-
|
|
6
|
+
```ts
|
|
7
|
+
import { checkLinearizability } from '@overkill-dev/linearizability';
|
|
8
|
+
|
|
9
|
+
const result = await checkLinearizability({
|
|
10
|
+
history: [
|
|
11
|
+
{ kind: 'invoke', id: 'write', operation: 1 },
|
|
12
|
+
{ kind: 'respond', id: 'write', outcome: { kind: 'returned', value: undefined } }
|
|
13
|
+
],
|
|
14
|
+
model: {
|
|
15
|
+
initial: () => 0,
|
|
16
|
+
transition: (_state, observation) => ({ kind: 'enabled', state: observation.operation })
|
|
17
|
+
},
|
|
18
|
+
maxWork: 10000,
|
|
19
|
+
signal: new AbortController().signal
|
|
20
|
+
});
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Events use unique nonblank invocation IDs. Responses follow their invocation at
|
|
24
|
+
most once. Array order establishes real-time precedence without clocks. Missing
|
|
25
|
+
responses denote pending operations, which may be omitted or linearized through
|
|
26
|
+
model-approved effects. Every completed operation must appear in the explanation.
|
|
27
|
+
|
|
28
|
+
Models receive the operation and a `returned`, `threw`, or `pending` outcome.
|
|
29
|
+
Return an existing model `enabled` or `disabled` transition, or
|
|
30
|
+
`{ kind: 'alternatives', states: [first, second, ...rest] }`. Callbacks are pure
|
|
31
|
+
and synchronous; preserve earlier states and observations across branches.
|
|
32
|
+
Containers are shallow snapshots; payload graphs remain author-owned.
|
|
33
|
+
|
|
34
|
+
Results distinguish `linearizable` with an operation-ID order,
|
|
35
|
+
`not-linearizable` after exhaustive rejection, and `inconclusive` with reason
|
|
36
|
+
`max-work`. The latter two retain the longest explored valid prefix, with first
|
|
37
|
+
encounter winning ties. This prefix is diagnostic, not a minimal counterexample.
|
|
38
|
+
Never treat inconclusive as a passing or failing consistency verdict.
|
|
39
|
+
|
|
40
|
+
`maxWork` is a required positive safe integer. Each candidate inspection,
|
|
41
|
+
transition call, and successor exploration costs one unit. Validation and model
|
|
42
|
+
callback internals are outside that counter. Search yields every 256 units for
|
|
43
|
+
cancellation; synchronous callbacks remain subject to enclosing supervision.
|
|
44
|
+
Cancellation propagates the abort reason; malformed input throws `TypeError`;
|
|
45
|
+
model exceptions propagate unchanged.
|
|
46
|
+
|
|
47
|
+
Search is deterministic in invocation and alternative declaration order and
|
|
48
|
+
uses no state equality or hashing assumptions. Cost can grow exponentially.
|
|
49
|
+
The standalone checker records no operations. The package adds no test family,
|
|
50
|
+
CLI, or persistence format. Property owns shrinking, witnesses, corpora, and reporting;
|
|
51
|
+
`linearizability(...)` owns concurrent execution.
|
|
52
|
+
|
|
53
|
+
## Concurrent Operation Authoring
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
import { gen, property } from '@overkill-dev/test/property';
|
|
57
|
+
import { linearizability } from '@overkill-dev/linearizability';
|
|
58
|
+
|
|
59
|
+
export const testNode = property({
|
|
60
|
+
title: 'increments are linearizable',
|
|
61
|
+
generator: gen.array(gen.array(gen.integer({ min: 1, max: 3 }))),
|
|
62
|
+
test: linearizability({
|
|
63
|
+
create: () => new Map([ [ 'count', 0 ] ]),
|
|
64
|
+
run(delta: number, counter) {
|
|
65
|
+
const next = (counter.get('count') ?? 0) + delta;
|
|
66
|
+
counter.set('count', next);
|
|
67
|
+
return next;
|
|
68
|
+
},
|
|
69
|
+
model: {
|
|
70
|
+
initial: () => 0,
|
|
71
|
+
transition(state, { operation, outcome }) {
|
|
72
|
+
const next = state + operation;
|
|
73
|
+
return outcome.kind === 'returned' && outcome.value === next
|
|
74
|
+
? { kind: 'enabled', state: next }
|
|
75
|
+
: { kind: 'disabled' };
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
maxWork: 10_000
|
|
79
|
+
})
|
|
80
|
+
});
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
`linearizability({ create, run, model, maxWork })` returns a
|
|
84
|
+
`PropertyBody<LinearizabilityProgram<Operation>>`. Programs are readonly arrays
|
|
85
|
+
of readonly operation arrays. Lanes execute concurrently; operations within each
|
|
86
|
+
lane execute sequentially. Empty programs and lanes are valid.
|
|
87
|
+
|
|
88
|
+
`create(sample)` creates a fresh system for each trial and registers teardown
|
|
89
|
+
with `sample.cleanup`. `run(operation, system, signal)` returns an output or a
|
|
90
|
+
promise. Ordinary throws become recorded outcomes. Cancellation, permission
|
|
91
|
+
denials, and engine control errors stop admission, abort the helper signal, and
|
|
92
|
+
drain admitted work before propagation. Existing timeout supervision may interrupt
|
|
93
|
+
uncooperative work and run cleanup without waiting for it.
|
|
94
|
+
|
|
95
|
+
Execution and model observations use independently reconstructed operation graphs.
|
|
96
|
+
Models are pure; returned output graphs must remain stable after settlement.
|
|
97
|
+
Event order, including synchronous returns and throws, determines precedence.
|
|
98
|
+
The checker budget is separate from property traversal work.
|
|
99
|
+
|
|
100
|
+
Linearizable histories pass, exhaustive rejection fails with bounded history and
|
|
101
|
+
checker diagnostics, and checker exhaustion calls `sample.inconclusive(reason)`.
|
|
102
|
+
This trial-local control requires a nonblank reason. Existing failures take
|
|
103
|
+
precedence; inconclusive confirmation or shrinking cannot erase an established
|
|
104
|
+
failure or create an unconfirmed witness.
|
|
105
|
+
|
|
106
|
+
Use ordinary property generators, examples, codecs, corpora, and nested `forall`.
|
|
107
|
+
Witnesses preserve lane inputs, not event-loop timing. Replay reruns current code;
|
|
108
|
+
property confirmation reports failures that do not reproduce. Property profile
|
|
109
|
+
capability and resource restrictions remain unchanged.
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
|
|
3
|
+
"bomFormat": "CycloneDX",
|
|
4
|
+
"specVersion": "1.6",
|
|
5
|
+
"version": 1,
|
|
6
|
+
"metadata": {
|
|
7
|
+
"tools": {
|
|
8
|
+
"components": [
|
|
9
|
+
{
|
|
10
|
+
"type": "application",
|
|
11
|
+
"name": "packtory",
|
|
12
|
+
"version": "0.0.125"
|
|
13
|
+
}
|
|
14
|
+
]
|
|
15
|
+
},
|
|
16
|
+
"component": {
|
|
17
|
+
"type": "library",
|
|
18
|
+
"name": "@overkill-dev/linearizability",
|
|
19
|
+
"version": "0.0.2",
|
|
20
|
+
"bom-ref": "pkg:npm/@overkill-dev/linearizability@0.0.2",
|
|
21
|
+
"purl": "pkg:npm/@overkill-dev/linearizability@0.0.2"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"components": [
|
|
25
|
+
{
|
|
26
|
+
"type": "library",
|
|
27
|
+
"name": "@overkill-dev/assert",
|
|
28
|
+
"version": "0.0.70",
|
|
29
|
+
"bom-ref": "pkg:npm/@overkill-dev/assert@0.0.70",
|
|
30
|
+
"scope": "optional",
|
|
31
|
+
"licenses": [
|
|
32
|
+
{
|
|
33
|
+
"expression": "MIT"
|
|
34
|
+
}
|
|
35
|
+
],
|
|
36
|
+
"purl": "pkg:npm/@overkill-dev/assert@0.0.70"
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"type": "library",
|
|
40
|
+
"name": "@overkill-dev/engine",
|
|
41
|
+
"version": "0.0.78",
|
|
42
|
+
"bom-ref": "pkg:npm/@overkill-dev/engine@0.0.78",
|
|
43
|
+
"scope": "optional",
|
|
44
|
+
"licenses": [
|
|
45
|
+
{
|
|
46
|
+
"expression": "MIT"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"purl": "pkg:npm/@overkill-dev/engine@0.0.78"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"type": "library",
|
|
53
|
+
"name": "@overkill-dev/model",
|
|
54
|
+
"version": "0.0.3",
|
|
55
|
+
"bom-ref": "pkg:npm/@overkill-dev/model@0.0.3",
|
|
56
|
+
"scope": "optional",
|
|
57
|
+
"licenses": [
|
|
58
|
+
{
|
|
59
|
+
"expression": "MIT"
|
|
60
|
+
}
|
|
61
|
+
],
|
|
62
|
+
"purl": "pkg:npm/@overkill-dev/model@0.0.3"
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"type": "library",
|
|
66
|
+
"name": "@overkill-dev/property",
|
|
67
|
+
"version": "0.0.4",
|
|
68
|
+
"bom-ref": "pkg:npm/@overkill-dev/property@0.0.4",
|
|
69
|
+
"scope": "optional",
|
|
70
|
+
"licenses": [
|
|
71
|
+
{
|
|
72
|
+
"expression": "MIT"
|
|
73
|
+
}
|
|
74
|
+
],
|
|
75
|
+
"purl": "pkg:npm/@overkill-dev/property@0.0.4"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"type": "library",
|
|
79
|
+
"name": "zod",
|
|
80
|
+
"version": "4.6.7",
|
|
81
|
+
"bom-ref": "pkg:npm/zod@4.6.7",
|
|
82
|
+
"scope": "required",
|
|
83
|
+
"licenses": [
|
|
84
|
+
{
|
|
85
|
+
"expression": "MIT"
|
|
86
|
+
}
|
|
87
|
+
],
|
|
88
|
+
"purl": "pkg:npm/zod@4.6.7"
|
|
89
|
+
}
|
|
90
|
+
],
|
|
91
|
+
"dependencies": [
|
|
92
|
+
{
|
|
93
|
+
"ref": "pkg:npm/@overkill-dev/assert@0.0.70"
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"ref": "pkg:npm/@overkill-dev/engine@0.0.78"
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
"ref": "pkg:npm/@overkill-dev/linearizability@0.0.2",
|
|
100
|
+
"dependsOn": [
|
|
101
|
+
"pkg:npm/@overkill-dev/assert@0.0.70",
|
|
102
|
+
"pkg:npm/@overkill-dev/engine@0.0.78",
|
|
103
|
+
"pkg:npm/@overkill-dev/model@0.0.3",
|
|
104
|
+
"pkg:npm/@overkill-dev/property@0.0.4",
|
|
105
|
+
"pkg:npm/zod@4.6.7"
|
|
106
|
+
]
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"ref": "pkg:npm/@overkill-dev/model@0.0.3"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"ref": "pkg:npm/@overkill-dev/property@0.0.4"
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"ref": "pkg:npm/zod@4.6.7"
|
|
116
|
+
}
|
|
117
|
+
]
|
|
118
|
+
}
|