@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 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. Native
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.
@@ -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. `objects/info/alternates` stands
13
- * here with this machine's ground in front of each line naming a place in
14
- * it (@amalgm/live git/alternates.ts), and is judged as it travels. */
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
- export async function writeGitStep(gitDir, step, travelled, ground) {
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 = (path) => readAs(path, travelling(step.path, ground));
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" || !(await lstat(full)).isDirectory())
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(full);
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(error => { if (errno(error) !== "ENOENT")
60
- throw error; });
79
+ await unlink(full).catch(alreadyGone);
61
80
  return;
62
81
  }
63
- if (!await create(full, target, bytes) && !same(await read(full), target))
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(full);
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
- return;
101
+ renamed = true;
82
102
  }
83
103
  }
84
104
  finally {
85
- await unlink(lock).catch(error => { if (errno(error) !== "ENOENT")
86
- throw error; });
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(gone => { if (errno(gone) !== "ENOENT")
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`, named as the state names it: a file by the bytes
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 (errno(error) === "ENOENT")
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":"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"}
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,
@@ -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 Error(`the ground database ${JSON.stringify(file)} was replaced beneath its open binding`);
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;AAQvD,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"}
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. */
@@ -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
- return { refused: [] };
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
- await this.recordRail?.flush();
1296
- await this.applyRail?.flush();
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
- const unavailable = unavailableRoots(parks.flatMap(({ error }) => unavailableOf(error)));
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(error, cuts) {
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