@amalgm/shell 0.1.164-main.41281684198 → 0.1.164-main.41285187871
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/PURPOSE.md +9 -1
- package/dist/git/write-files.js +49 -28
- package/dist/git/write-files.js.map +1 -1
- package/dist/ground-database.d.ts +7 -0
- package/dist/ground-database.js +12 -3
- package/dist/ground-database.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/user-ground-host.d.ts +12 -0
- package/dist/user-ground-host.js +56 -6
- package/dist/user-ground-host.js.map +1 -1
- package/dist/watching/host.d.ts +20 -1
- package/dist/watching/host.js +40 -8
- package/dist/watching/host.js.map +1 -1
- package/npm-shrinkwrap.json +7 -16
- package/package.json +5 -5
package/PURPOSE.md
CHANGED
|
@@ -782,7 +782,15 @@ after adoption.
|
|
|
782
782
|
one examination across every configured materialization root. Such a shared
|
|
783
783
|
obligation settles only when every participating root completes against the
|
|
784
784
|
same frozen Watch generation and binding set. Unavailable ground remains
|
|
785
|
-
pending; a changed binding set requires a new complete examination.
|
|
785
|
+
pending; a changed binding set requires a new complete examination. A cut
|
|
786
|
+
frozen under it is proved by root identity, never binding instance: once
|
|
787
|
+
every root it named is bound again and examined completely through its
|
|
788
|
+
generation, by that examination or a returning root's own whole catch-up.
|
|
789
|
+
A named root still away keeps the cut pending and is answered unavailable,
|
|
790
|
+
never settled. The runtime's database is never opened a second time by its
|
|
791
|
+
name: while its home, or a directory down to it, is not the object it was
|
|
792
|
+
opened in, that ground is unavailable and flush says so at once; the file
|
|
793
|
+
alone changing beneath directories that still stand is a fault. Native
|
|
786
794
|
event IDs are diagnostics, never identities or settlement cutoffs. Unexpected
|
|
787
795
|
coverage loss retains one episode through repeated reopen failures; its
|
|
788
796
|
qualifying observation starts only after replacement coverage is healthy.
|
package/dist/git/write-files.js
CHANGED
|
@@ -9,9 +9,18 @@
|
|
|
9
9
|
* the target holds there. Under the lock the writer reads what stands: the
|
|
10
10
|
* target already means nothing to do, so an interrupted Apply resumes; the
|
|
11
11
|
* basis means it writes; anything else means something moved since the read,
|
|
12
|
-
* and Apply starts again from a new read.
|
|
13
|
-
*
|
|
14
|
-
*
|
|
12
|
+
* and Apply starts again from a new read. Nothing standing is an answer: a
|
|
13
|
+
* path that goes while it is read reads as nothing, and a removal that finds
|
|
14
|
+
* nothing has nothing to do. Any other act that finds its path or folder
|
|
15
|
+
* gone, its folder now a file, or a path that becomes another kind while it
|
|
16
|
+
* is read, met ground that moved. Git causes each: it writes and deletes a
|
|
17
|
+
* reflog under its ref's lock rather than the reflog's own, prunes the
|
|
18
|
+
* folders it empties, and writes a ref where such a folder stood.
|
|
19
|
+
* So this writer's lock does not keep Git out of a reflog either: an entry
|
|
20
|
+
* Git appends between Apply's read and its rename is lost, a gap still open.
|
|
21
|
+
* `objects/info/alternates` stands here with this machine's ground in front
|
|
22
|
+
* of each line naming a place in it (@amalgm/live git/alternates.ts), and is
|
|
23
|
+
* judged as it travels. */
|
|
15
24
|
import { lstat, mkdir, open, readFile, readlink, rename, rmdir, symlink, unlink } from "node:fs/promises";
|
|
16
25
|
import { join } from "node:path";
|
|
17
26
|
import { GIT_ALTERNATES_PATH, isGitLockPath, localGitAlternates } from "@amalgm/live";
|
|
@@ -19,19 +28,30 @@ import { blobId, travelling } from "./read-state.js";
|
|
|
19
28
|
const errno = (error) => error.code;
|
|
20
29
|
const same = (left, right) => left === null ? right === null : right !== null && left.mode === right.mode && left.oid === right.oid;
|
|
21
30
|
const moved = (path) => new Error(`${path} changed while Apply wrote it; Apply reads again`);
|
|
22
|
-
|
|
31
|
+
/** Nothing stands at the path: it, or a folder above it, is gone, or that folder is now a file. */
|
|
32
|
+
const gone = (error) => errno(error) === "ENOENT" || errno(error) === "ENOTDIR";
|
|
33
|
+
const alreadyGone = (error) => { if (!gone(error))
|
|
34
|
+
throw error; };
|
|
35
|
+
export function writeGitStep(gitDir, step, travelled, ground) {
|
|
36
|
+
return writeStep(gitDir, step, travelled, ground).catch(error => {
|
|
37
|
+
throw gone(error) ? moved(step.path) : error;
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
async function writeStep(gitDir, step, travelled, ground) {
|
|
23
41
|
const full = join(gitDir, step.path);
|
|
24
42
|
const { target } = step;
|
|
25
43
|
const bytes = step.path === GIT_ALTERNATES_PATH && target?.mode !== "120000"
|
|
26
44
|
? (oid) => Buffer.from(localGitAlternates(travelled(oid), ground)) : travelled;
|
|
27
|
-
const read = (
|
|
45
|
+
const read = () => readAs(full, step.path, travelling(step.path, ground));
|
|
28
46
|
if (target?.mode === "040000") {
|
|
29
47
|
try {
|
|
30
48
|
await mkdir(full);
|
|
31
49
|
}
|
|
32
50
|
catch (error) {
|
|
33
|
-
if (errno(error) !== "EEXIST"
|
|
51
|
+
if (errno(error) !== "EEXIST")
|
|
34
52
|
throw error;
|
|
53
|
+
if ((await read())?.mode !== "040000")
|
|
54
|
+
throw moved(step.path);
|
|
35
55
|
}
|
|
36
56
|
return;
|
|
37
57
|
}
|
|
@@ -51,16 +71,15 @@ export async function writeGitStep(gitDir, step, travelled, ground) {
|
|
|
51
71
|
// A lock file is itself the lock: Apply creates or removes it exclusively.
|
|
52
72
|
if (isGitLockPath(step.path)) {
|
|
53
73
|
if (target === null) {
|
|
54
|
-
const standing = await read(
|
|
74
|
+
const standing = await read();
|
|
55
75
|
if (standing === null)
|
|
56
76
|
return;
|
|
57
77
|
if (!same(standing, step.basis))
|
|
58
78
|
throw moved(step.path);
|
|
59
|
-
await unlink(full).catch(
|
|
60
|
-
throw error; });
|
|
79
|
+
await unlink(full).catch(alreadyGone);
|
|
61
80
|
return;
|
|
62
81
|
}
|
|
63
|
-
if (!await create(full, target, bytes) && !same(await read(
|
|
82
|
+
if (!await create(full, target, bytes) && !same(await read(), target))
|
|
64
83
|
throw moved(step.path);
|
|
65
84
|
return;
|
|
66
85
|
}
|
|
@@ -68,22 +87,24 @@ export async function writeGitStep(gitDir, step, travelled, ground) {
|
|
|
68
87
|
const content = target ?? { mode: "100644", oid: null };
|
|
69
88
|
if (!await create(lock, content, bytes))
|
|
70
89
|
throw new Error(`${step.path}: Git holds its lock here; Apply retries`);
|
|
90
|
+
let renamed = false;
|
|
71
91
|
try {
|
|
72
|
-
const standing = await read(
|
|
92
|
+
const standing = await read();
|
|
73
93
|
if (same(standing, target))
|
|
74
94
|
return;
|
|
75
95
|
if (!same(standing, step.basis))
|
|
76
96
|
throw moved(step.path);
|
|
77
97
|
if (target === null)
|
|
78
|
-
await unlink(full);
|
|
98
|
+
await unlink(full).catch(alreadyGone);
|
|
79
99
|
else {
|
|
80
100
|
await rename(lock, full);
|
|
81
|
-
|
|
101
|
+
renamed = true;
|
|
82
102
|
}
|
|
83
103
|
}
|
|
84
104
|
finally {
|
|
85
|
-
|
|
86
|
-
|
|
105
|
+
// The rename releases the lock, and a Git command may take it at once.
|
|
106
|
+
if (!renamed)
|
|
107
|
+
await unlink(lock).catch(alreadyGone);
|
|
87
108
|
}
|
|
88
109
|
}
|
|
89
110
|
/** Creates `path` exclusively holding the file's bytes, as Git creates a
|
|
@@ -109,29 +130,29 @@ async function create(path, file, bytes) {
|
|
|
109
130
|
}
|
|
110
131
|
catch (error) {
|
|
111
132
|
await handle.close();
|
|
112
|
-
await unlink(path).catch(
|
|
113
|
-
throw gone; });
|
|
133
|
+
await unlink(path).catch(alreadyGone);
|
|
114
134
|
throw error;
|
|
115
135
|
}
|
|
116
136
|
await handle.close();
|
|
117
137
|
return true;
|
|
118
138
|
}
|
|
119
|
-
/** What stands at `path
|
|
120
|
-
* it travels as. */
|
|
121
|
-
async function readAs(path, travels) {
|
|
122
|
-
let stat;
|
|
139
|
+
/** What stands at `path` (the step's `name`), named as the state names it:
|
|
140
|
+
* a file by the bytes it travels as. */
|
|
141
|
+
async function readAs(path, name, travels) {
|
|
123
142
|
try {
|
|
124
|
-
stat = await lstat(path);
|
|
143
|
+
const stat = await lstat(path);
|
|
144
|
+
if (stat.isDirectory())
|
|
145
|
+
return { mode: "040000", oid: null };
|
|
146
|
+
if (stat.isSymbolicLink())
|
|
147
|
+
return { mode: "120000", oid: blobId(await readlink(path, { encoding: "buffer" })) };
|
|
148
|
+
return { mode: (stat.mode & 0o100) !== 0 ? "100755" : "100644", oid: blobId(travels(await readFile(path))) };
|
|
125
149
|
}
|
|
126
150
|
catch (error) {
|
|
127
|
-
if (
|
|
151
|
+
if (gone(error))
|
|
128
152
|
return null;
|
|
153
|
+
if (errno(error) === "EISDIR" || errno(error) === "EINVAL")
|
|
154
|
+
throw moved(name);
|
|
129
155
|
throw error;
|
|
130
156
|
}
|
|
131
|
-
if (stat.isDirectory())
|
|
132
|
-
return { mode: "040000", oid: null };
|
|
133
|
-
if (stat.isSymbolicLink())
|
|
134
|
-
return { mode: "120000", oid: blobId(await readlink(path, { encoding: "buffer" })) };
|
|
135
|
-
return { mode: (stat.mode & 0o100) !== 0 ? "100755" : "100644", oid: blobId(travels(await readFile(path))) };
|
|
136
157
|
}
|
|
137
158
|
//# sourceMappingURL=write-files.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"write-files.js","sourceRoot":"","sources":["../../src/git/write-files.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"write-files.js","sourceRoot":"","sources":["../../src/git/write-files.ts"],"names":[],"mappings":"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"}
|
|
@@ -32,6 +32,13 @@ export declare function migrateGroundDatabase(file: string): GroundMigration;
|
|
|
32
32
|
* behind a commit on its own thread. None checkpoints, so the first one starts the file's
|
|
33
33
|
* checkpoint thread and its saver thread. */
|
|
34
34
|
export declare function openGroundConnection(file: string): Database.Database;
|
|
35
|
+
/** A held name no longer names the object it opened: another stands there, or
|
|
36
|
+
* none. Whether the ground holding it is away or the file alone changed is
|
|
37
|
+
* the host's to judge; either way no second file is ever read. */
|
|
38
|
+
export declare class GroundDatabaseAway extends Error {
|
|
39
|
+
readonly file: string;
|
|
40
|
+
constructor(file: string);
|
|
41
|
+
}
|
|
35
42
|
export declare function groundDatabase(file: string): Database.Database;
|
|
36
43
|
/** Every other owner has closed by now: each content thread lets its read
|
|
37
44
|
* connection go after the job it is running, the saver finishes its queue,
|
package/dist/ground-database.js
CHANGED
|
@@ -341,6 +341,16 @@ export function openGroundConnection(file) {
|
|
|
341
341
|
startGroundSaver(name, objectAt(name));
|
|
342
342
|
return database;
|
|
343
343
|
}
|
|
344
|
+
/** A held name no longer names the object it opened: another stands there, or
|
|
345
|
+
* none. Whether the ground holding it is away or the file alone changed is
|
|
346
|
+
* the host's to judge; either way no second file is ever read. */
|
|
347
|
+
export class GroundDatabaseAway extends Error {
|
|
348
|
+
file;
|
|
349
|
+
constructor(file) {
|
|
350
|
+
super(`the ground database ${JSON.stringify(file)} was replaced beneath its open binding`);
|
|
351
|
+
this.file = file;
|
|
352
|
+
}
|
|
353
|
+
}
|
|
344
354
|
const held = new Map();
|
|
345
355
|
function bound(file) {
|
|
346
356
|
const name = databaseFileName(file);
|
|
@@ -351,9 +361,8 @@ function bound(file) {
|
|
|
351
361
|
held.set(name, entry);
|
|
352
362
|
return entry;
|
|
353
363
|
}
|
|
354
|
-
if (objectAt(name) !== current.key)
|
|
355
|
-
throw new
|
|
356
|
-
}
|
|
364
|
+
if (objectAt(name) !== current.key)
|
|
365
|
+
throw new GroundDatabaseAway(file);
|
|
357
366
|
return current;
|
|
358
367
|
}
|
|
359
368
|
export function groundDatabase(file) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ground-database.js","sourceRoot":"","sources":["../src/ground-database.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"ground-database.js","sourceRoot":"","sources":["../src/ground-database.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ export { FileStateEventStore } from "./state-store.js";
|
|
|
10
10
|
export { FileWorkspaceStore } from "./workspace-store.js";
|
|
11
11
|
export { WireClient, WireRequestError } from "./wire-client.js";
|
|
12
12
|
export type { WireClientOptions } from "./wire-client.js";
|
|
13
|
-
export { UserGroundHost } from "./user-ground-host.js";
|
|
13
|
+
export { GroundNotConverged, UserGroundHost } from "./user-ground-host.js";
|
|
14
14
|
export type { DetectScanEvidence, InstallStage, UserGroundCatchUp, UserGroundClosed, UserGroundHostOptions, } from "./user-ground-host.js";
|
|
15
15
|
export { NodeWatchHost } from "./watching/index.js";
|
|
16
16
|
export type { NativeWatchHandle, NodeWatchHostOptions, OpenNativeWatch, WatchGround, WatchCoverageEvidence, WatchHealth, WatchObservation, WatchCloseOptions, } from "./watching/index.js";
|
package/dist/index.js
CHANGED
|
@@ -5,7 +5,7 @@ export { createShellAuthorization, loadInstallationDeviceKey, promoteInstallatio
|
|
|
5
5
|
export { FileStateEventStore } from "./state-store.js";
|
|
6
6
|
export { FileWorkspaceStore } from "./workspace-store.js";
|
|
7
7
|
export { WireClient, WireRequestError } from "./wire-client.js";
|
|
8
|
-
export { UserGroundHost } from "./user-ground-host.js";
|
|
8
|
+
export { GroundNotConverged, UserGroundHost } from "./user-ground-host.js";
|
|
9
9
|
export { NodeWatchHost } from "./watching/index.js";
|
|
10
10
|
export { MachineHost, defaultMachineName } from "./machine-host.js";
|
|
11
11
|
export { CONTENT_WIRE_ENCODING, encodeContentWireBytes, } from "./content-wire-codec.js";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,+BAA+B,EAC/B,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,+BAA+B,EAC/B,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ3E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAYpE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
|
|
@@ -74,6 +74,11 @@ export interface FlushOutcome {
|
|
|
74
74
|
readonly reason: string;
|
|
75
75
|
}[];
|
|
76
76
|
}
|
|
77
|
+
/** A flush asked before login converged, or after convergence failed: no
|
|
78
|
+
* prefix can be proved, so it never answers as success. */
|
|
79
|
+
export declare class GroundNotConverged extends Error {
|
|
80
|
+
constructor();
|
|
81
|
+
}
|
|
77
82
|
export interface UserGroundHostOptions {
|
|
78
83
|
/** Runtime-owned transport. Standalone host examinations may own their client. */
|
|
79
84
|
readonly wire?: WireClient;
|
|
@@ -287,6 +292,9 @@ export declare class UserGroundHost {
|
|
|
287
292
|
* Add hold the ground they materialize. Unrelated cones never wait. */
|
|
288
293
|
private readonly ground;
|
|
289
294
|
private boundUserRoot;
|
|
295
|
+
/** The directories from the home down to the folder holding this runtime's
|
|
296
|
+
* database, each as the object that stood there when it opened. */
|
|
297
|
+
private databaseGround;
|
|
290
298
|
/** Apply waits on ground without a deadline; shutdown cancels them just
|
|
291
299
|
* before it stops the Apply rail, which resumes from durable intents. */
|
|
292
300
|
private readonly applyWaits;
|
|
@@ -402,6 +410,10 @@ export declare class UserGroundHost {
|
|
|
402
410
|
* refused at that boundary are named: their local rows are current, and
|
|
403
411
|
* their last complete result remains the official one. */
|
|
404
412
|
flush(): Promise<FlushOutcome>;
|
|
413
|
+
/** A database that stands aside with its home is that home's ground away:
|
|
414
|
+
* unavailable, retried on its timer and heard returning by Watch. One whose
|
|
415
|
+
* home stands is a fault, as is a refusal that races the home's return. */
|
|
416
|
+
private databaseCause;
|
|
405
417
|
/** Prove everything owed now, through its current cutoff. Ground still
|
|
406
418
|
* moving when no retry remains names every root the cutoff left unsettled
|
|
407
419
|
* that no unreadable ground explains. */
|
package/dist/user-ground-host.js
CHANGED
|
@@ -13,7 +13,7 @@ import { groundRowProjection, portableGroundRecord as portableRecord, storedWith
|
|
|
13
13
|
import { groundStore } from "./ground-store.js";
|
|
14
14
|
import { RETAINED_BY_KEY, STORED_CHILDREN } from "./ground-inventory-schema.js";
|
|
15
15
|
import { groundSaveDurability, hearOwedExaminations, save, saved as groundSaved } from "./ground-saver.js";
|
|
16
|
-
import { groundDatabase, openGroundConnection, releaseGroundDatabase } from "./ground-database.js";
|
|
16
|
+
import { GroundDatabaseAway, groundDatabase, openGroundConnection, releaseGroundDatabase } from "./ground-database.js";
|
|
17
17
|
import { assertGroundInitialized, initializeGroundDatabase } from "./ground-initialization.js";
|
|
18
18
|
import { GroundBasisChangedError, readGroundRow, rootRevision } from "./ground-basis.js";
|
|
19
19
|
import { createHash, randomUUID } from "node:crypto";
|
|
@@ -183,6 +183,11 @@ function rootScope(suspicion, result) {
|
|
|
183
183
|
answered: result.differences.filter(difference => difference.reason === "returned").map(difference => difference.path),
|
|
184
184
|
};
|
|
185
185
|
}
|
|
186
|
+
/** A flush asked before login converged, or after convergence failed: no
|
|
187
|
+
* prefix can be proved, so it never answers as success. */
|
|
188
|
+
export class GroundNotConverged extends Error {
|
|
189
|
+
constructor() { super("the user ground has not converged, so flush can prove nothing"); }
|
|
190
|
+
}
|
|
186
191
|
/** The production Files port injected into Core. Portable identity remains in
|
|
187
192
|
* Live; this class owns only Node filesystem, SQLite, Watch, and wire effects. */
|
|
188
193
|
export class UserGroundHost {
|
|
@@ -288,6 +293,9 @@ export class UserGroundHost {
|
|
|
288
293
|
* Add hold the ground they materialize. Unrelated cones never wait. */
|
|
289
294
|
ground = new GroundCoordinator();
|
|
290
295
|
boundUserRoot;
|
|
296
|
+
/** The directories from the home down to the folder holding this runtime's
|
|
297
|
+
* database, each as the object that stood there when it opened. */
|
|
298
|
+
databaseGround = [];
|
|
291
299
|
/** Apply waits on ground without a deadline; shutdown cancels them just
|
|
292
300
|
* before it stops the Apply rail, which resumes from durable intents. */
|
|
293
301
|
applyWaits = new AbortController();
|
|
@@ -357,6 +365,7 @@ export class UserGroundHost {
|
|
|
357
365
|
// No ground connection exists before its migration and epoch commit
|
|
358
366
|
// on the bootstrap thread; the main thread only awaits them.
|
|
359
367
|
const initialization = await initializeGroundDatabase(this.databasePath());
|
|
368
|
+
this.databaseGround = standingDirectories(this.userRoot(), physicalPath(this.options.dir));
|
|
360
369
|
this.forgetOwed();
|
|
361
370
|
this.hearingOwed = hearOwedExaminations(this.databasePath(), owed => this.owedExaminations.owe(owed));
|
|
362
371
|
this.stage({ primitive: "detect", stage: "ground-initialization", status: "completed",
|
|
@@ -1279,7 +1288,7 @@ export class UserGroundHost {
|
|
|
1279
1288
|
* their last complete result remains the official one. */
|
|
1280
1289
|
async flush() {
|
|
1281
1290
|
if (!this.converged || !this.activeIdentity || !this.cloudState)
|
|
1282
|
-
|
|
1291
|
+
throw new GroundNotConverged();
|
|
1283
1292
|
const identity = this.activeIdentity;
|
|
1284
1293
|
this.watchHost.suspectAll();
|
|
1285
1294
|
// The complete suspicion above contains everything known at this cutoff.
|
|
@@ -1292,12 +1301,29 @@ export class UserGroundHost {
|
|
|
1292
1301
|
finally {
|
|
1293
1302
|
this.watchHost.release(cutoff);
|
|
1294
1303
|
}
|
|
1295
|
-
|
|
1296
|
-
|
|
1304
|
+
// A lane's cause is already judged; the rails read the same database.
|
|
1305
|
+
try {
|
|
1306
|
+
await this.recordRail?.flush();
|
|
1307
|
+
await this.applyRail?.flush();
|
|
1308
|
+
}
|
|
1309
|
+
catch (error) {
|
|
1310
|
+
throw this.databaseCause(error);
|
|
1311
|
+
}
|
|
1297
1312
|
if (!this.closing)
|
|
1298
1313
|
this.ensureWatchers(identity);
|
|
1299
1314
|
return { refused: [...this.rootRefusals].map(([directory, reason]) => ({ directory, reason })) };
|
|
1300
1315
|
}
|
|
1316
|
+
/** A database that stands aside with its home is that home's ground away:
|
|
1317
|
+
* unavailable, retried on its timer and heard returning by Watch. One whose
|
|
1318
|
+
* home stands is a fault, as is a refusal that races the home's return. */
|
|
1319
|
+
databaseCause(error) {
|
|
1320
|
+
if (!(error instanceof GroundDatabaseAway)
|
|
1321
|
+
|| this.databaseGround.every(({ path, key }) => standingKey(path) === key))
|
|
1322
|
+
return error;
|
|
1323
|
+
const home = this.userRoot();
|
|
1324
|
+
return new DetectUnavailable([{ directory: home,
|
|
1325
|
+
reason: `${home}, which holds this runtime's database, is not where it was opened; its ground stays unexamined until it returns` }]);
|
|
1326
|
+
}
|
|
1301
1327
|
/** Prove everything owed now, through its current cutoff. Ground still
|
|
1302
1328
|
* moving when no retry remains names every root the cutoff left unsettled
|
|
1303
1329
|
* that no unreadable ground explains. */
|
|
@@ -1355,7 +1381,12 @@ export class UserGroundHost {
|
|
|
1355
1381
|
.filter((owner, index, all) => all.findIndex(other => sameAttempt(other, owner)) === index);
|
|
1356
1382
|
const moving = [...new Set(parks.flatMap(({ error }) => error instanceof DetectResidual ? error.roots
|
|
1357
1383
|
: error instanceof ApplyAttributionDeferred ? error.moving : []))].sort();
|
|
1358
|
-
|
|
1384
|
+
// A root this ticket named that is no longer bound cannot be proved
|
|
1385
|
+
// until it returns: it is unavailable, never settled.
|
|
1386
|
+
const away = this.watchHost.unbound(open).map(({ directory, absent }) => ({ directory,
|
|
1387
|
+
reason: absent ? `${directory} is absent; its ground stays unexamined until it returns`
|
|
1388
|
+
: `${directory} is no longer bound` }));
|
|
1389
|
+
const unavailable = unavailableRoots([...parks.flatMap(({ error }) => unavailableOf(error)), ...away]);
|
|
1359
1390
|
const held = [...new Set(parks.flatMap(({ error }) => error instanceof DeclarationHeld ? error.roots : []))].sort();
|
|
1360
1391
|
const idle = !serving && this.namedAttempts.size === 0 && this.groundWaits.size === 0;
|
|
1361
1392
|
// A fault answers once nothing can run it again; no retry timer hides it.
|
|
@@ -1571,7 +1602,8 @@ export class UserGroundHost {
|
|
|
1571
1602
|
* merely stale, ground still moving, and their release's ring reruns it.
|
|
1572
1603
|
* This read and the park share one synchronous turn, so a release after it
|
|
1573
1604
|
* finds the park. Unreadable ownership keeps the wait. */
|
|
1574
|
-
laneCause(
|
|
1605
|
+
laneCause(caught, cuts) {
|
|
1606
|
+
const error = this.databaseCause(caught);
|
|
1575
1607
|
if (detectionBasisAdvanced(error)) {
|
|
1576
1608
|
return new DetectResidual(cuts.map(cut => cut.directory), [], { settlesInMs: settlesAfter(movementOf(error)) });
|
|
1577
1609
|
}
|
|
@@ -4920,6 +4952,24 @@ class DetectUnavailable extends Error {
|
|
|
4920
4952
|
this.roots = roots;
|
|
4921
4953
|
}
|
|
4922
4954
|
}
|
|
4955
|
+
/** Each directory from `home` down to `folder`, as the object standing there
|
|
4956
|
+
* now; `folder` alone when it lies outside `home`. */
|
|
4957
|
+
function standingDirectories(home, folder) {
|
|
4958
|
+
const below = relative(home, folder);
|
|
4959
|
+
const parts = below === "" ? [] : below.split(sep);
|
|
4960
|
+
const paths = below.startsWith("..") || isAbsolute(below) ? [folder]
|
|
4961
|
+
: [home, ...parts.map((_, index) => join(home, ...parts.slice(0, index + 1)))];
|
|
4962
|
+
return paths.map(path => ({ path, key: standingKey(path) }));
|
|
4963
|
+
}
|
|
4964
|
+
/** The object standing at `path` itself, or null when none can be seen there. */
|
|
4965
|
+
const standingKey = (path) => {
|
|
4966
|
+
try {
|
|
4967
|
+
return physicalKey(lstatSync(path, { bigint: true }));
|
|
4968
|
+
}
|
|
4969
|
+
catch {
|
|
4970
|
+
return null;
|
|
4971
|
+
}
|
|
4972
|
+
};
|
|
4923
4973
|
/** Ground still moving, unreadable or held by a Register declaration is
|
|
4924
4974
|
* unsettled: a cause, never a fault. */
|
|
4925
4975
|
const unsettledGround = (error) => error instanceof DetectResidual || error instanceof DetectUnavailable
|