@amalgm/shell 0.1.164-main.41371688349 → 0.1.164-main.41376189319
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/dist/background-error.js +4 -2
- package/dist/background-error.js.map +1 -1
- package/dist/files-observability.d.ts +1 -1
- package/dist/files-trace.d.ts +2 -2
- package/dist/files-trace.js +6 -6
- package/dist/files-trace.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js.map +1 -1
- package/dist/user-ground-host.d.ts +21 -1
- package/dist/user-ground-host.js +12 -6
- package/dist/user-ground-host.js.map +1 -1
- package/npm-shrinkwrap.json +6 -6
- package/package.json +5 -5
package/dist/background-error.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
/** A cause can lead back to itself, and reporting a failure must not fail. */
|
|
2
|
+
const CAUSES_FOLLOWED = 16;
|
|
1
3
|
/** The log line a failed background pass leaves. A report wraps what failed as
|
|
2
4
|
* its cause, so the place is the innermost stack: only frames and messages,
|
|
3
5
|
* never an error's other fields, which may hold what a log must not. */
|
|
@@ -7,7 +9,7 @@ export function backgroundErrorLine(error) {
|
|
|
7
9
|
: { message: String(error) };
|
|
8
10
|
return `AMALGM_BACKGROUND_ERROR ${JSON.stringify(failure)}\n`;
|
|
9
11
|
}
|
|
10
|
-
function placeOf(error) {
|
|
11
|
-
return error.cause instanceof Error ? placeOf(error.cause) : error.stack;
|
|
12
|
+
function placeOf(error, causesLeft = CAUSES_FOLLOWED) {
|
|
13
|
+
return causesLeft > 0 && error.cause instanceof Error ? placeOf(error.cause, causesLeft - 1) : error.stack;
|
|
12
14
|
}
|
|
13
15
|
//# sourceMappingURL=background-error.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"background-error.js","sourceRoot":"","sources":["../src/background-error.ts"],"names":[],"mappings":"AAAA;;wEAEwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;QACpC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;QACnD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,OAAO,2BAA2B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,KAAY;
|
|
1
|
+
{"version":3,"file":"background-error.js","sourceRoot":"","sources":["../src/background-error.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;wEAEwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;QACpC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;QACnD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/B,OAAO,2BAA2B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,KAAY,EAAE,UAAU,GAAG,eAAe;IACzD,OAAO,UAAU,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;AAC7G,CAAC"}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* evidence emitted by different processes and machines.
|
|
6
6
|
*/
|
|
7
7
|
export type FilesPrimitive = "register" | "upload" | "download" | "watch" | "detect" | "record" | "send" | "receive" | "apply";
|
|
8
|
-
export type FilesStageStatus = "started" | "completed" | "failed" | "observed";
|
|
8
|
+
export type FilesStageStatus = "started" | "completed" | "deferred" | "failed" | "observed";
|
|
9
9
|
export interface FilesStageEvidence {
|
|
10
10
|
readonly primitive: FilesPrimitive;
|
|
11
11
|
readonly stage: string;
|
package/dist/files-trace.d.ts
CHANGED
|
@@ -35,7 +35,7 @@ export declare function serializeStages(stages: readonly FilesStageEvidence[]):
|
|
|
35
35
|
* order it finished, its duration, and the counters that explain the
|
|
36
36
|
* duration. A stage that fires repeatedly — a Watch ring during a long walk
|
|
37
37
|
* — folds into one line carrying the run's count and totals, so the shape of
|
|
38
|
-
* the journey stays visible instead of scrolling past. Failures
|
|
39
|
-
* place and say so.
|
|
38
|
+
* the journey stays visible instead of scrolling past. Failures and
|
|
39
|
+
* deferrals keep their place and say so.
|
|
40
40
|
*/
|
|
41
41
|
export declare function renderStageLedger(stages: readonly Record<string, unknown>[], totalMs: number): string;
|
package/dist/files-trace.js
CHANGED
|
@@ -56,8 +56,8 @@ export function serializeStages(stages) {
|
|
|
56
56
|
* order it finished, its duration, and the counters that explain the
|
|
57
57
|
* duration. A stage that fires repeatedly — a Watch ring during a long walk
|
|
58
58
|
* — folds into one line carrying the run's count and totals, so the shape of
|
|
59
|
-
* the journey stays visible instead of scrolling past. Failures
|
|
60
|
-
* place and say so.
|
|
59
|
+
* the journey stays visible instead of scrolling past. Failures and
|
|
60
|
+
* deferrals keep their place and say so.
|
|
61
61
|
*/
|
|
62
62
|
export function renderStageLedger(stages, totalMs) {
|
|
63
63
|
const rows = [];
|
|
@@ -71,9 +71,9 @@ export function renderStageLedger(stages, totalMs) {
|
|
|
71
71
|
: `${primitive}/${String(stage.stage ?? "")}`;
|
|
72
72
|
const durationMs = typeof stage.durationMs === "number" ? stage.durationMs : null;
|
|
73
73
|
const measurements = (stage.measurements ?? {});
|
|
74
|
-
const
|
|
74
|
+
const said = status === "failed" ? " FAILED" : status === "deferred" ? " DEFERRED" : "";
|
|
75
75
|
const previous = rows[rows.length - 1];
|
|
76
|
-
if (previous && previous.label === label && previous.
|
|
76
|
+
if (previous && previous.label === label && previous.said === said) {
|
|
77
77
|
previous.occurrences += 1;
|
|
78
78
|
previous.durationMs = previous.durationMs === null && durationMs === null
|
|
79
79
|
? null
|
|
@@ -81,7 +81,7 @@ export function renderStageLedger(stages, totalMs) {
|
|
|
81
81
|
previous.measurements = foldMeasurements(previous.measurements, measurements);
|
|
82
82
|
continue;
|
|
83
83
|
}
|
|
84
|
-
rows.push({ label, occurrences: 1, durationMs,
|
|
84
|
+
rows.push({ label, occurrences: 1, durationMs, said, measurements: { ...measurements } });
|
|
85
85
|
}
|
|
86
86
|
const labels = rows.map((row) => row.occurrences > 1 ? `${row.label} ×${row.occurrences}` : row.label);
|
|
87
87
|
const width = labels.reduce((widest, label) => Math.max(widest, label.length), 0);
|
|
@@ -91,7 +91,7 @@ export function renderStageLedger(stages, totalMs) {
|
|
|
91
91
|
.map(([key, value]) => `${key}=${formatMeasurement(key, value)}`)
|
|
92
92
|
.join(" ");
|
|
93
93
|
return ` ${labels[index].padEnd(width)} ${duration.padStart(10)}`
|
|
94
|
-
+ `${row.
|
|
94
|
+
+ `${row.said}${counters ? ` ${counters}` : ""}`;
|
|
95
95
|
});
|
|
96
96
|
return [
|
|
97
97
|
...lines,
|
package/dist/files-trace.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"files-trace.js","sourceRoot":"","sources":["../src/files-trace.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAGA;IAFZ,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE7D,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;IAAG,CAAC;IAE1D;;;;;OAKG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,6EAA6E;IACpE,OAAO,GAAuB,CAAC,QAAQ,EAAE,EAAE;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;QACtB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF;;;2DAGuD;IACvD,KAAK,CAAC,OAAO,CAAI,GAAqB;QAIpC,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAC7B,MAAqC;IAErC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAYD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA0C,EAC1C,OAAe;IAEf,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,SAAS,KAAK,UAAU;YACpC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3B,CAAC,CAAC,GAAG,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAgC,CAAC;QAC/E,MAAM,
|
|
1
|
+
{"version":3,"file":"files-trace.js","sourceRoot":"","sources":["../src/files-trace.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -11,7 +11,7 @@ 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
13
|
export { GroundNotConverged, UserGroundHost } from "./user-ground-host.js";
|
|
14
|
-
export type { DetectScanEvidence, InstallStage, UserGroundCatchUp, UserGroundClosed, UserGroundHostOptions, } from "./user-ground-host.js";
|
|
14
|
+
export type { DetectScanDeferral, 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";
|
|
17
17
|
export { MachineHost, defaultMachineName } from "./machine-host.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,kBAAkB,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;AAS3E,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"}
|
|
@@ -28,8 +28,28 @@ export interface DetectDiscoveryEvidence {
|
|
|
28
28
|
readonly found: number;
|
|
29
29
|
readonly stats?: DiscoveryStats;
|
|
30
30
|
}
|
|
31
|
+
/** Why a scan gave way with nothing of it standing, in its branch's own word.
|
|
32
|
+
* Never error text: what a scan decided is read from this, not parsed. */
|
|
33
|
+
export type DetectScanDeferral =
|
|
34
|
+
/** What it read moved; a later read answers again. */
|
|
35
|
+
"moved"
|
|
36
|
+
/** An unfinished Apply owns this ground; it is read when that Apply ends. */
|
|
37
|
+
| "apply-attribution"
|
|
38
|
+
/** The root stands off the device it was bound on; its ground ringing asks again. */
|
|
39
|
+
| "root-off-device"
|
|
40
|
+
/** A directory above hides the root; access returning is heard. */
|
|
41
|
+
| "root-unreachable"
|
|
42
|
+
/** Not a retry: a named read cannot cover a re-created root, so a complete
|
|
43
|
+
* examination of it must still arrive. */
|
|
44
|
+
| "root-recreated-owes-complete"
|
|
45
|
+
/** An identity crossed this scan's scope, so its result stands nowhere and
|
|
46
|
+
* the root's examination goes wider. */
|
|
47
|
+
| "identity-crossed";
|
|
31
48
|
export interface DetectScanEvidence {
|
|
32
|
-
|
|
49
|
+
/** `deferred` says `reason`, and a later scan answers for this one. Only a
|
|
50
|
+
* scan that threw is `failed`. */
|
|
51
|
+
readonly outcome: "observed" | "deferred" | "failed";
|
|
52
|
+
readonly reason?: DetectScanDeferral;
|
|
33
53
|
readonly error?: string;
|
|
34
54
|
readonly rootId: string;
|
|
35
55
|
readonly directory: string;
|
package/dist/user-ground-host.js
CHANGED
|
@@ -511,12 +511,13 @@ export class UserGroundHost {
|
|
|
511
511
|
this.stage({
|
|
512
512
|
primitive: "detect",
|
|
513
513
|
stage: "scan",
|
|
514
|
-
status: evidence.outcome === "
|
|
514
|
+
status: evidence.outcome === "observed" ? "completed" : evidence.outcome,
|
|
515
515
|
rootId: evidence.rootId,
|
|
516
516
|
path: evidence.directory,
|
|
517
517
|
durationMs: evidence.durationMs,
|
|
518
518
|
measurements: {
|
|
519
519
|
scope: evidence.scope,
|
|
520
|
+
...(evidence.reason ? { reason: evidence.reason } : {}),
|
|
520
521
|
...(evidence.error ? { error: evidence.error } : {}),
|
|
521
522
|
entries: evidence.entries,
|
|
522
523
|
metadataReused: evidence.metadataReused,
|
|
@@ -6344,19 +6345,18 @@ async function reconcileGround(input) {
|
|
|
6344
6345
|
};
|
|
6345
6346
|
const started = performance.now();
|
|
6346
6347
|
let settledHere = 0;
|
|
6347
|
-
const report = async (proposals,
|
|
6348
|
+
const report = async (proposals, decided = { outcome: "observed" }) => {
|
|
6348
6349
|
if (!onScan)
|
|
6349
6350
|
return;
|
|
6350
6351
|
const durationMs = performance.now() - started;
|
|
6351
6352
|
onScan({
|
|
6352
|
-
...(error ? { error: error instanceof Error ? error.message : String(error) } : {}),
|
|
6353
6353
|
rootId,
|
|
6354
6354
|
directory,
|
|
6355
6355
|
scope: parameters.suspects === null || parameters.suspects === undefined
|
|
6356
6356
|
? "complete"
|
|
6357
6357
|
: parameters.suspects.length === 0 ? "none" : "paths",
|
|
6358
6358
|
...counters,
|
|
6359
|
-
|
|
6359
|
+
...decided,
|
|
6360
6360
|
durationMs,
|
|
6361
6361
|
plannedRows: proposals.length,
|
|
6362
6362
|
records: proposals.length,
|
|
@@ -6374,9 +6374,10 @@ async function reconcileGround(input) {
|
|
|
6374
6374
|
});
|
|
6375
6375
|
}
|
|
6376
6376
|
catch (error) {
|
|
6377
|
-
|
|
6377
|
+
const deferred = (reason) => report([], { outcome: "deferred", reason });
|
|
6378
6378
|
const movement = movementOf(error);
|
|
6379
6379
|
if (error instanceof ApplyAttributionDeferred) {
|
|
6380
|
+
await deferred("apply-attribution");
|
|
6380
6381
|
deferredCaptures.push({ directory, owners: error.owners });
|
|
6381
6382
|
return { kind: "deferred", ...movement };
|
|
6382
6383
|
}
|
|
@@ -6384,6 +6385,7 @@ async function reconcileGround(input) {
|
|
|
6384
6385
|
// the domain's absence decisions do not wait on it; a root bound
|
|
6385
6386
|
// beneath it is examined by its own walk, and other roots admit.
|
|
6386
6387
|
if (input.units && error instanceof RootOffDevice) {
|
|
6388
|
+
await deferred("root-off-device");
|
|
6387
6389
|
offDeviceRoots.set(parameters.rootPath, error.message);
|
|
6388
6390
|
for (const [rootId, directory] of domainBindings) {
|
|
6389
6391
|
if (directory === parameters.rootPath)
|
|
@@ -6394,24 +6396,28 @@ async function reconcileGround(input) {
|
|
|
6394
6396
|
// Units: a root the walk could not look at is unread like one whose
|
|
6395
6397
|
// binding the pass could not follow; the domain waits for it.
|
|
6396
6398
|
if (error instanceof RootUnreachable) {
|
|
6399
|
+
await deferred("root-unreachable");
|
|
6397
6400
|
unreachable.push(error.root);
|
|
6398
6401
|
return undefined;
|
|
6399
6402
|
}
|
|
6400
6403
|
// Units: a re-created root owes its complete examination, and the
|
|
6401
6404
|
// domain's absence decisions wait for it.
|
|
6402
6405
|
if (input.units && error instanceof RootRecreated) {
|
|
6406
|
+
await deferred("root-recreated-owes-complete");
|
|
6403
6407
|
promotions.set(parameters.rootPath, "root-recreated");
|
|
6404
6408
|
return undefined;
|
|
6405
6409
|
}
|
|
6406
6410
|
// Units: this root's own evidence moved; other roots still admit.
|
|
6407
6411
|
if (input.units && !isDetectCancelled(error) && moved(error)) {
|
|
6412
|
+
await deferred("moved");
|
|
6408
6413
|
invalidatedRoots.push({ directory: parameters.rootPath, ...movement });
|
|
6409
6414
|
return { kind: "deferred", ...movement };
|
|
6410
6415
|
}
|
|
6416
|
+
await report([], { outcome: "failed", error: error instanceof Error ? error.message : String(error) });
|
|
6411
6417
|
throw error;
|
|
6412
6418
|
}
|
|
6413
6419
|
if (result.kind !== "observed") {
|
|
6414
|
-
await report([]);
|
|
6420
|
+
await report([], result.kind === "crossed" ? { outcome: "deferred", reason: "identity-crossed" } : undefined);
|
|
6415
6421
|
return result.kind === "crossed" ? result : undefined;
|
|
6416
6422
|
}
|
|
6417
6423
|
roots.push({ rootUUID: rootId, directory, units: result.units });
|