@aeolus-fleet/core 0.25.3 → 0.26.0

package/dist/domain/messaging/report-turn-end.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-turn-end.js","sourceRoot":"","sources":["../../../src/domain/messaging/report-turn-end.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAqC,MAAM,uBAAuB,CAAC;AAGrF,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAiB,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAqC,MAAM,eAAe,CAAC;AAU3E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAA6D,EAC7D,MAA4D;IAE5D,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,oBAAoB,EAAE,YAAY,UAAU,iBAAiB,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"report-turn-end.js","sourceRoot":"","sources":["../../../src/domain/messaging/report-turn-end.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAqC,MAAM,uBAAuB,CAAC;AAGrF,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAiB,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAqC,MAAM,eAAe,CAAC;AAU3E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAA6D,EAC7D,MAA6E;IAE7E,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,oBAAoB,EAAE,YAAY,UAAU,iBAAiB,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}

package/dist/domain/registry/get-installation-fleet.d.ts

@@ -1,6 +1,7 @@
 import type { FleetId } from '@aeolus-fleet/common';
 import type { Clock } from '../shared/clock.js';
 import { type DomainError } from '../shared/errors.js';
+import { type HealthRecords } from '../shared/health.js';
 import { type Result } from '../shared/result.js';
 import { type InstallationFleet } from './installation-fleet.js';
 import type { InstallationFleets, InstallationSettingsRepository } from './ports.js';
@@ -11,5 +12,6 @@ export type GetInstallationFleet = (input: {
 export declare function createGetInstallationFleet(deps: {
     fleets: InstallationFleets;
     settings: InstallationSettingsRepository;
+    health: HealthRecords;
     clock: Clock;
 }): GetInstallationFleet;

package/dist/domain/registry/get-installation-fleet.js

@@ -1,4 +1,5 @@
 import { refuse } from '../shared/errors.js';
+import { readHealthOf } from '../shared/health.js';
 import { ok } from '../shared/result.js';
 import { installationFleet, messageWindow } from './installation-fleet.js';
 /** Use case: one fleet of the installation, described as the list describes it. */
@@ -6,7 +7,10 @@ export function createGetInstallationFleet(deps) {
     return async ({ fleetId }) => {
         const now = deps.clock.now();
         const facts = await deps.fleets.find(fleetId, messageWindow(now));
-        return facts ? ok(installationFleet(facts, { now, installation: await deps.settings.read() })) : refuse('FLEET_NOT_FOUND', `The installation hosts no fleet ${fleetId}`);
+        if (!facts) {
+            return refuse('FLEET_NOT_FOUND', `The installation hosts no fleet ${fleetId}`);
+        }
+        return ok(installationFleet(facts, { now, installation: await deps.settings.read(), health: await readHealthOf(deps.health, { fleetId, now }) }));
     };
 }
 //# sourceMappingURL=get-installation-fleet.js.map

package/dist/domain/registry/get-installation-fleet.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/get-installation-fleet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAKnG,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,IAA4F;IACrI,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAC3K,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/get-installation-fleet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAKnG,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,IAK1C;IACC,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/registry/installation-fleet.d.ts

@@ -1,4 +1,5 @@
 import type { FleetId } from '@aeolus-fleet/common';
+import type { Health } from '../shared/health.js';
 import { type FleetLimit, type InstallationSettings } from './limits.js';
 import type { FleetHealth, InstallationFleetFacts, InstallationFleetWindow } from './ports.js';
 /** How far back an installation's fleet counts its messages, and over how many UTC days. */
@@ -27,11 +28,13 @@ export interface InstallationFleet {
         ships: FleetLimit;
         dailyMessages: FleetLimit;
     };
-    health: FleetHealth;
+    /** Its 0041 figures, and where its deliveries are stuck (decision 0042). */
+    health: FleetHealth & Health;
 }
 /** What a read at `now` counts over: the last 7 times 24 hours, and the last 7 UTC days from the first one's start. */
 export declare function messageWindow(now: Date): InstallationFleetWindow;
 export declare function installationFleet(facts: InstallationFleetFacts, read: {
     now: Date;
     installation: InstallationSettings;
+    health: Health;
 }): InstallationFleet;

package/dist/domain/registry/installation-fleet.js

@@ -14,9 +14,9 @@ export function messageWindow(now) {
     return { since: new Date(now.getTime() - MESSAGE_WINDOW_MS), firstDay: new Date(`${firstDay}T00:00:00.000Z`) };
 }
 export function installationFleet(facts, read) {
-    const { messagesSince, messagesPerUtcDay, limitSettings, ...rest } = facts;
+    const { messagesSince, messagesPerUtcDay, limitSettings, health, ...rest } = facts;
     const messagesPerDay = utcDays(read.now).map((date) => ({ date, count: messagesPerUtcDay.find((day) => day.date === date)?.count ?? 0 }));
     const { ships, dailyMessages } = fleetLimitsOf({ fleetId: facts.fleetId, settings: limitSettings, installation: read.installation });
-    return { ...rest, messagesLast7Days: messagesSince, messagesToday: messagesPerDay.at(-1)?.count ?? 0, messagesPerDay, limits: { ships, dailyMessages } };
+    return { ...rest, health: { ...health, ...read.health }, messagesLast7Days: messagesSince, messagesToday: messagesPerDay.at(-1)?.count ?? 0, messagesPerDay, limits: { ships, dailyMessages } };
 }
 //# sourceMappingURL=installation-fleet.js.map

package/dist/domain/registry/installation-fleet.js.map

@@ -1 +1 @@
-{"version":3,"file":"installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/installation-fleet.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8C,MAAM,aAAa,CAAC;AAGxF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAsB9D,gGAAgG;AAChG,SAAS,OAAO,CAAC,GAAS;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,mBAAmB,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAClK,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,aAAa,CAAC,GAAS;IACrC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,QAAQ,gBAAgB,CAAC,EAAE,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA6B,EAAE,IAAuD;IACtH,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC3E,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1I,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACrI,OAAO,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC;AAC3J,CAAC"}
+{"version":3,"file":"installation-fleet.js","sourceRoot":"","sources":["../../../src/domain/registry/installation-fleet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAA8C,MAAM,aAAa,CAAC;AAGxF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAuB9D,gGAAgG;AAChG,SAAS,OAAO,CAAC,GAAS;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,mBAAmB,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAClK,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,aAAa,CAAC,GAAS;IACrC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,QAAQ,gBAAgB,CAAC,EAAE,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA6B,EAAE,IAAuE;IACtI,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnF,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1I,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACrI,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC;AAClM,CAAC"}

package/dist/domain/registry/list-installation-fleets.d.ts

@@ -1,15 +1,17 @@
 import type { Clock } from '../shared/clock.js';
+import { type HealthRecords } from '../shared/health.js';
 import { type InstallationFleet } from './installation-fleet.js';
 import type { InstallationFleets, InstallationSettingsRepository } from './ports.js';
 export type ListInstallationFleets = () => Promise<InstallationFleet[]>;
 /**
  * Use case: every fleet the installation hosts, oldest first, with its
  * operator, its measures, its messages per UTC day of the last 7 days and the
- * limits that apply to it (docs/blueprint.md, "Installation"). It reads across
- * fleets, so only the installation token reaches it.
+ * limits that apply to it and its health (docs/blueprint.md, "Installation").
+ * It reads across fleets, so only the installation token reaches it.
  */
 export declare function createListInstallationFleets(deps: {
     fleets: InstallationFleets;
     settings: InstallationSettingsRepository;
+    health: HealthRecords;
     clock: Clock;
 }): ListInstallationFleets;

package/dist/domain/registry/list-installation-fleets.js

@@ -1,15 +1,17 @@
+import { readHealthOf } from '../shared/health.js';
 import { installationFleet, messageWindow } from './installation-fleet.js';
 /**
  * Use case: every fleet the installation hosts, oldest first, with its
  * operator, its measures, its messages per UTC day of the last 7 days and the
- * limits that apply to it (docs/blueprint.md, "Installation"). It reads across
- * fleets, so only the installation token reaches it.
+ * limits that apply to it and its health (docs/blueprint.md, "Installation").
+ * It reads across fleets, so only the installation token reaches it.
  */
 export function createListInstallationFleets(deps) {
     return async () => {
         const now = deps.clock.now();
         const installation = await deps.settings.read();
-        return (await deps.fleets.list(messageWindow(now))).map((facts) => installationFleet(facts, { now, installation }));
+        const fleets = await deps.fleets.list(messageWindow(now));
+        return Promise.all(fleets.map(async (facts) => installationFleet(facts, { now, installation, health: await readHealthOf(deps.health, { fleetId: facts.fleetId, now }) })));
     };
 }
 //# sourceMappingURL=list-installation-fleets.js.map

package/dist/domain/registry/list-installation-fleets.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-installation-fleets.js","sourceRoot":"","sources":["../../../src/domain/registry/list-installation-fleets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAKnG;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAA4F;IACvI,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IACtH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"list-installation-fleets.js","sourceRoot":"","sources":["../../../src/domain/registry/list-installation-fleets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAA0B,MAAM,yBAAyB,CAAC;AAKnG;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAK5C;IACC,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7K,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/shared/health.d.ts

@@ -0,0 +1,84 @@
+/**
+ * A fleet's health (decision 0042): where its deliveries are stuck now, with
+ * the ship or type and the machine behind each ship, how many were stuck at
+ * each hour of the last 7 days, and how many were acknowledged in the last 24
+ * hours. Facts read from the fleet's records, never stored.
+ */
+import { type FleetId, type ShipId } from '@aeolus-fleet/common';
+import type { HistoryParty } from './history.js';
+import { type FleetRecords, type StuckPlaceCount } from './stuck.js';
+/** A machine: the trierarch a ship's crew request is assigned to, and when its crew last called. */
+export interface Machine extends HistoryParty {
+    lastSeenAt: Date | null;
+}
+/** A delivery acknowledged in the window: when its message was sent and when it was acknowledged. */
+export interface AcknowledgedDelivery {
+    sentAt: Date;
+    acknowledgedAt: Date;
+}
+/** The deliveries acknowledged in the last 24 hours, the median from send to acknowledgement, and how many in each hour. */
+export interface Acknowledged {
+    count: number;
+    /** None when nothing was acknowledged. */
+    medianMs: number | null;
+    /** Oldest first, each hour ending at `at`, the last one now. */
+    perHour: {
+        at: Date;
+        count: number;
+    }[];
+}
+/** What the health reads: the stuck rule's records, with the machine behind each ship whose crew request is assigned. */
+export interface HealthFacts extends FleetRecords {
+    machines: readonly {
+        shipId: ShipId;
+        machine: Machine;
+    }[];
+}
+/** Outbound port: the records the health reads, always within one fleet. */
+export interface HealthRecords {
+    /**
+     * The fleet's ships and leases not over before `since`, and its deliveries
+     * open now or with a step since then, each with every step it took.
+     */
+    read(fleetId: FleetId, since: Date): Promise<HealthFacts>;
+    /** The fleet's deliveries acknowledged after `since`. */
+    acknowledged(fleetId: FleetId, since: Date): Promise<AcknowledgedDelivery[]>;
+}
+/** Where deliveries are stuck: a ship, by name, with its machine if any, or a type. */
+export type ShownStuckPlace = {
+    kind: 'ship';
+    ship: HistoryParty;
+    machine: Machine | null;
+} | {
+    kind: 'type';
+    type: string;
+};
+export interface StuckPlaceHealth extends Omit<StuckPlaceCount, 'place'> {
+    place: ShownStuckPlace;
+}
+export interface Health {
+    /** Stuck now, by cause and place, the oldest waiting first. */
+    stuck: StuckPlaceHealth[];
+    /** Stuck at each hour of the last 7 days, oldest first, the last one now. */
+    stuckPerHour: {
+        at: Date;
+        count: number;
+    }[];
+    /** Acknowledged in the last 24 hours. */
+    acknowledged: Acknowledged;
+}
+/** Since when the health reads the records for a read at `now`: the first hour of its trend. */
+export declare function healthSince(now: Date): Date;
+/** Since when it counts the acknowledged deliveries for a read at `now`. */
+export declare function acknowledgedSince(now: Date): Date;
+/** Counts the deliveries acknowledged in the 24 hours up to `now`, with their median wait and how many in each hour. */
+export declare function acknowledgedOf(deliveries: readonly AcknowledgedDelivery[], now: Date): Acknowledged;
+/** Reads the fleet's health at `now`: its records over the trend's hours and its acknowledged in the last 24. */
+export declare function readHealthOf(records: HealthRecords, read: {
+    fleetId: FleetId;
+    now: Date;
+}): Promise<Health>;
+export declare function healthOf(facts: HealthFacts, read: {
+    acknowledged: Acknowledged;
+    now: Date;
+}): Health;

package/dist/domain/shared/health.js

@@ -0,0 +1,59 @@
+/**
+ * A fleet's health (decision 0042): where its deliveries are stuck now, with
+ * the ship or type and the machine behind each ship, how many were stuck at
+ * each hour of the last 7 days, and how many were acknowledged in the last 24
+ * hours. Facts read from the fleet's records, never stored.
+ */
+import { ACKNOWLEDGED_HOURS, STUCK_TREND_HOURS } from '@aeolus-fleet/common';
+import { stuckAt, stuckPerHour, stuckPlaces } from './stuck.js';
+const HOUR_MS = 60 * 60 * 1000;
+/** Since when the health reads the records for a read at `now`: the first hour of its trend. */
+export function healthSince(now) {
+    return new Date(now.getTime() - STUCK_TREND_HOURS * HOUR_MS);
+}
+/** Since when it counts the acknowledged deliveries for a read at `now`. */
+export function acknowledgedSince(now) {
+    return new Date(now.getTime() - ACKNOWLEDGED_HOURS * HOUR_MS);
+}
+/** The middle wait, or the mean of the two middle ones; none of none. */
+function medianOf(waits) {
+    const sorted = waits.toSorted((first, second) => first - second);
+    const middle = Math.floor(sorted.length / 2);
+    const upper = sorted[middle];
+    if (upper === undefined) {
+        return null;
+    }
+    const lower = sorted[middle - 1];
+    return sorted.length % 2 === 1 || lower === undefined ? upper : (lower + upper) / 2;
+}
+/** Counts the deliveries acknowledged in the 24 hours up to `now`, with their median wait and how many in each hour. */
+export function acknowledgedOf(deliveries, now) {
+    const inWindow = deliveries.filter((delivery) => delivery.acknowledgedAt > acknowledgedSince(now) && delivery.acknowledgedAt <= now);
+    const perHour = Array.from({ length: ACKNOWLEDGED_HOURS }, (_unused, index) => {
+        const at = new Date(now.getTime() - (ACKNOWLEDGED_HOURS - 1 - index) * HOUR_MS);
+        const from = at.getTime() - HOUR_MS;
+        return { at, count: inWindow.filter((delivery) => delivery.acknowledgedAt.getTime() > from && delivery.acknowledgedAt <= at).length };
+    });
+    return { count: inWindow.length, medianMs: medianOf(inWindow.map((delivery) => delivery.acknowledgedAt.getTime() - delivery.sentAt.getTime())), perHour };
+}
+/** Reads the fleet's health at `now`: its records over the trend's hours and its acknowledged in the last 24. */
+export async function readHealthOf(records, read) {
+    const [facts, acknowledged] = await Promise.all([records.read(read.fleetId, healthSince(read.now)), records.acknowledged(read.fleetId, acknowledgedSince(read.now))]);
+    return healthOf(facts, { acknowledged: acknowledgedOf(acknowledged, read.now), now: read.now });
+}
+export function healthOf(facts, read) {
+    const shown = (place) => {
+        if (place.kind === 'type') {
+            return place;
+        }
+        const name = facts.ships.find((ship) => ship.shipId === place.shipId)?.name ?? place.shipId;
+        const machine = facts.machines.find((assigned) => assigned.shipId === place.shipId)?.machine ?? null;
+        return { kind: 'ship', ship: { id: place.shipId, name }, machine };
+    };
+    return {
+        stuck: stuckPlaces(stuckAt(facts, read.now)).map(({ place, ...counted }) => ({ ...counted, place: shown(place) })),
+        stuckPerHour: stuckPerHour(facts, read.now),
+        acknowledged: read.acknowledged,
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/domain/shared/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/domain/shared/health.ts"],"names":[],"mappings":"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"}

package/dist/domain/shared/history.d.ts

@@ -160,6 +160,10 @@ export interface NeedsAttentionEntry {
     isPushed: boolean;
     /** When it became undeliverable, or was reported not handled. */
     since: Date;
+    /** Why its crew reported it not handled, kept with DeliveryNotHandled (#847); null when undeliverable, or when the crew gave none. */
+    reason: string | null;
+    /** The ship whose attempt made it undeliverable, or whose turn did not handle it. */
+    ship: HistoryParty;
     message: Omit<HistoryMessage, 'delivery'>;
 }
 /** The delivery states Needs attention lists, each waiting for the operator to resend or dismiss it. */

package/dist/domain/shared/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAWlB,MAAM,sBAAsB,CAAC;AAwC9B,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAsCD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AAiID,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,CAAC;QAC3E,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAWlB,MAAM,sBAAsB,CAAC;AAwC9B,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAsCD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AAqID,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,CAAC;QAC3E,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/domain/shared/read-health.d.ts

@@ -0,0 +1,14 @@
+import type { Caller } from './caller.js';
+import type { Clock } from './clock.js';
+import { type Health, type HealthRecords } from './health.js';
+export type ReadHealth = (caller: Caller) => Promise<Health>;
+/**
+ * Use case: the health of the caller's fleet (decision 0042), for the
+ * console's Health: its stuck deliveries by cause and place, the trend over
+ * the last 7 days and what was acknowledged in the last 24 hours. The caller's
+ * scope (fleet:read) is checked before this runs.
+ */
+export declare function createReadHealth(deps: {
+    health: HealthRecords;
+    clock: Clock;
+}): ReadHealth;

package/dist/domain/shared/read-health.js

@@ -0,0 +1,11 @@
+import { readHealthOf } from './health.js';
+/**
+ * Use case: the health of the caller's fleet (decision 0042), for the
+ * console's Health: its stuck deliveries by cause and place, the trend over
+ * the last 7 days and what was acknowledged in the last 24 hours. The caller's
+ * scope (fleet:read) is checked before this runs.
+ */
+export function createReadHealth(deps) {
+    return (caller) => readHealthOf(deps.health, { fleetId: caller.fleetId, now: deps.clock.now() });
+}
+//# sourceMappingURL=read-health.js.map

package/dist/domain/shared/read-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-health.js","sourceRoot":"","sources":["../../../src/domain/shared/read-health.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAmC,MAAM,aAAa,CAAC;AAI5E;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6C;IAC5E,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/dist/domain/shared/stuck.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Stuck deliveries (decision 0042): a delivery that waits on something only a
+ * ship, a crew or the operator can change. One rule, read at any time from the
+ * fleet's records, so the deliveries stuck now and the trend replayed over 7
+ * days count alike. Facts only: no thresholds of its own beyond the clocks the
+ * pushed leases already run (decision 0040).
+ */
+import { type DeliveryId, type DeliveryState, type LeaseId, type MessageId, type ShipId, type StuckCause, type StuckState, type TurnState } from '@aeolus-fleet/common';
+import type { FleetEvent } from './events.js';
+import type { Recipient } from './selector.js';
+/** Where a delivery is stuck: at a ship, or at the type it was sent to. */
+export type StuckPlace = {
+    kind: 'ship';
+    shipId: ShipId;
+} | {
+    kind: 'type';
+    type: string;
+};
+export interface StuckDelivery {
+    deliveryId: DeliveryId;
+    messageId: MessageId;
+    state: StuckState;
+    cause: StuckCause;
+    place: StuckPlace;
+    /** When it entered the state it is stuck in. */
+    since: Date;
+}
+/** A ship as the rule reads it over time; argo and the viewer ship are always crewed. */
+export interface ShipRecord {
+    shipId: ShipId;
+    name: string;
+    type: string;
+    isAlwaysCrewed: boolean;
+    commissionedAt: Date;
+    retiredAt: Date | null;
+}
+/** A turn a pushed session's hooks reported, at the time they saw it. */
+export interface LeaseTurn {
+    state: TurnState;
+    at: Date;
+}
+/** A lease as the rule reads it over time: when it was held, pushed, last seen, and its turns oldest first. */
+export interface LeaseRecord {
+    leaseId: LeaseId;
+    shipId: ShipId;
+    startedAt: Date;
+    endedAt: Date | null;
+    pushedAt: Date | null;
+    /** When its crew last called, else when it started: one column, not a history, so the trend reads it as it is now. */
+    lastSeenAt: Date;
+    turns: readonly LeaseTurn[];
+}
+/**
+ * A change of a delivery's state, to `state` at `at`, by the crew of
+ * `shipId` and `leaseId` when one caused it. A receipt again and a hand-over
+ * once more change no state, so they are no step.
+ */
+export interface DeliveryStep {
+    state: DeliveryState;
+    at: Date;
+    shipId: ShipId | null;
+    leaseId: LeaseId | null;
+}
+/** The step a delivery event is, or none for an event that changes no state: a receipt again, a hand-over once more, or no delivery event at all. */
+export declare function stateStepOf(event: Pick<FleetEvent, 'type' | 'occurredAt' | 'shipId' | 'details'>): DeliveryStep | undefined;
+/** A delivery, pending from when it was sent, then through its steps oldest first. */
+export interface DeliveryRecord {
+    deliveryId: DeliveryId;
+    messageId: MessageId;
+    recipient: Recipient;
+    /** The ships of its type its sender could reach at send time; empty is every ship of the type (decision 0034). */
+    reachableShipIds: readonly ShipId[];
+    sentAt: Date;
+    steps: readonly DeliveryStep[];
+}
+/** What the rule reads: the fleet's ships, leases and deliveries over the time it is read for. */
+export interface FleetRecords {
+    ships: readonly ShipRecord[];
+    leases: readonly LeaseRecord[];
+    deliveries: readonly DeliveryRecord[];
+}
+/** The deliveries stuck at `at`, each with its cause, place and since, oldest first. */
+export declare function stuckAt(records: FleetRecords, at: Date): StuckDelivery[];
+/** How many deliveries were stuck at each hour of the last 7 days, oldest first, the last one now. */
+export declare function stuckPerHour(records: FleetRecords, now: Date): {
+    at: Date;
+    count: number;
+}[];
+/** A place deliveries are stuck in for one cause: how many, and since when the oldest waits. */
+export interface StuckPlaceCount {
+    cause: StuckCause;
+    place: StuckPlace;
+    count: number;
+    oldestSince: Date;
+    /** Each one, oldest first. */
+    deliveries: {
+        deliveryId: DeliveryId;
+        messageId: MessageId;
+        state: StuckState;
+        since: Date;
+    }[];
+}
+/** The stuck deliveries grouped by cause and place, the oldest waiting first. */
+export declare function stuckPlaces(stuck: readonly StuckDelivery[]): StuckPlaceCount[];

package/dist/domain/shared/stuck.js

@@ -0,0 +1,187 @@
+/**
+ * Stuck deliveries (decision 0042): a delivery that waits on something only a
+ * ship, a crew or the operator can change. One rule, read at any time from the
+ * fleet's records, so the deliveries stuck now and the trend replayed over 7
+ * days count alike. Facts only: no thresholds of its own beyond the clocks the
+ * pushed leases already run (decision 0040).
+ */
+import { isId, STUCK_TREND_HOURS } from '@aeolus-fleet/common';
+import { hasClockRunOut, NOT_CONFIRMED_MINUTES } from '../messaging/public.js';
+const MINUTE_MS = 60_000;
+const HOUR_MS = 60 * MINUTE_MS;
+/** The state each delivery event puts its delivery in. */
+const STEP_STATES = {
+    DeliveryReceived: 'received',
+    DeliveryHanded: 'handed',
+    DeliveryReturned: 'pending',
+    DeliveryAcknowledged: 'acknowledged',
+    DeliveryHandled: 'handled',
+    DeliveryNotHandled: 'notHandled',
+    DeliveryUndeliverable: 'undeliverable',
+    DeliveryDismissed: 'dismissed',
+    DeliveryAbandoned: 'abandoned',
+};
+/** The step a delivery event is, or none for an event that changes no state: a receipt again, a hand-over once more, or no delivery event at all. */
+export function stateStepOf(event) {
+    const state = STEP_STATES[event.type];
+    if (state === undefined || event.details.again === true || event.details.onceMore === true) {
+        return undefined;
+    }
+    const { leaseId } = event.details;
+    return { state, at: event.occurredAt, shipId: event.shipId ?? null, leaseId: isId(leaseId, 'lease') ? leaseId : null };
+}
+function stateAt(delivery, at) {
+    if (delivery.sentAt > at) {
+        return undefined;
+    }
+    return delivery.steps
+        .filter((step) => step.at <= at)
+        .reduce((_state, step) => ({ state: step.state, since: step.at, shipId: step.shipId, leaseId: step.leaseId }), {
+        state: 'pending',
+        since: delivery.sentAt,
+        shipId: null,
+        leaseId: null,
+    });
+}
+function isActiveAt(ship, at) {
+    return ship.commissionedAt <= at && (ship.retiredAt === null || ship.retiredAt > at);
+}
+function isHeldAt(lease, at) {
+    return lease.startedAt <= at && (lease.endedAt === null || lease.endedAt > at);
+}
+function isPushedAt(lease, at) {
+    return lease.pushedAt !== null && lease.pushedAt <= at;
+}
+/** The turn its hooks had reported by then, or none yet. */
+function turnAt(lease, at) {
+    return lease.turns.filter((turn) => turn.at <= at).at(-1) ?? null;
+}
+/** Reads the rule at one time over the fleet's records. */
+class FleetAt {
+    records;
+    at;
+    constructor(records, at) {
+        this.records = records;
+        this.at = at;
+    }
+    leaseOf(shipId) {
+        return this.records.leases.find((lease) => lease.shipId === shipId && isHeldAt(lease, this.at));
+    }
+    isCrewed(ship) {
+        return ship.isAlwaysCrewed || this.leaseOf(ship.shipId) !== undefined;
+    }
+    /** The active ships that may take it: its ship, or the reachable ships of its type. */
+    takers(delivery) {
+        const { recipient } = delivery;
+        return this.records.ships.filter((ship) => {
+            if (!isActiveAt(ship, this.at)) {
+                return false;
+            }
+            if (recipient.kind === 'ship') {
+                return ship.shipId === recipient.shipId;
+            }
+            return ship.type === recipient.type && (delivery.reachableShipIds.length === 0 || delivery.reachableShipIds.includes(ship.shipId));
+        });
+    }
+    /** The pushed lease whose clock ran out on a delivery waiting for it, if any. */
+    overdueOn(delivery, leases) {
+        return leases.find((lease) => isPushedAt(lease, this.at) && hasClockRunOut(delivery, { crew: { pushedAt: lease.pushedAt, turn: turnAt(lease, this.at) }, now: this.at }));
+    }
+    stuck(delivery) {
+        const now = stateAt(delivery, this.at);
+        if (now === undefined) {
+            return undefined;
+        }
+        const why = this.whyStuck(delivery, now);
+        return why === undefined ? undefined : { deliveryId: delivery.deliveryId, messageId: delivery.messageId, ...why, since: now.since };
+    }
+    whyStuck(delivery, now) {
+        const inState = (state, why) => (why === undefined ? undefined : { state, ...why });
+        switch (now.state) {
+            case 'undeliverable':
+                return inState('undeliverable', { cause: 'undeliverable', place: now.shipId === null ? placeOf(delivery.recipient) : { kind: 'ship', shipId: now.shipId } });
+            case 'pending':
+                return inState('pending', this.whyPendingStuck(delivery, now.since));
+            case 'received':
+            case 'handed':
+                return inState(now.state, this.whyInFlightStuck({ state: now.state, since: now.since, leaseId: now.leaseId }));
+            case 'acknowledged':
+            case 'handled':
+            case 'notHandled':
+            case 'dismissed':
+            case 'abandoned':
+                return undefined;
+        }
+    }
+    whyPendingStuck(delivery, since) {
+        const takers = this.takers(delivery);
+        if (takers.length === 0) {
+            // A direct delivery to a retired ship is abandoned, so only a type's comes here.
+            return { cause: 'noShipCanTake', place: placeOf(delivery.recipient) };
+        }
+        const crewed = takers.filter((ship) => this.isCrewed(ship));
+        if (crewed.length === 0) {
+            return { cause: 'waitingForCrew', place: placeOf(delivery.recipient) };
+        }
+        const leases = crewed.flatMap((ship) => this.leaseOf(ship.shipId) ?? []);
+        const overdue = this.overdueOn({ state: 'pending', since }, leases);
+        return overdue === undefined ? undefined : { cause: 'stalledInFlight', place: { kind: 'ship', shipId: overdue.shipId } };
+    }
+    whyInFlightStuck(delivery) {
+        const lease = this.records.leases.find((held) => held.leaseId === delivery.leaseId);
+        if (lease === undefined) {
+            return undefined;
+        }
+        const isStalled = isPushedAt(lease, this.at) ? this.overdueOn(delivery, [lease]) !== undefined : isQuietSinceHandOver(lease, { delivery, at: this.at });
+        return isStalled ? { cause: 'stalledInFlight', place: { kind: 'ship', shipId: lease.shipId } } : undefined;
+    }
+}
+/**
+ * A plain lease has no clock (decision 0010): its session is quiet when it was
+ * last seen no later than the hand-over, and the hand-over is as old as the
+ * pushed lease's not confirmed clock.
+ */
+function isQuietSinceHandOver(lease, read) {
+    const { delivery, at } = read;
+    return (delivery.state === 'handed' &&
+        lease.lastSeenAt <= delivery.since &&
+        at.getTime() - delivery.since.getTime() >= NOT_CONFIRMED_MINUTES * MINUTE_MS);
+}
+function placeOf(recipient) {
+    return recipient.kind === 'ship' ? { kind: 'ship', shipId: recipient.shipId } : { kind: 'type', type: recipient.type };
+}
+function bySince(first, second) {
+    return first.since.getTime() - second.since.getTime() || first.deliveryId.localeCompare(second.deliveryId);
+}
+/** The deliveries stuck at `at`, each with its cause, place and since, oldest first. */
+export function stuckAt(records, at) {
+    const fleet = new FleetAt(records, at);
+    return records.deliveries.flatMap((delivery) => fleet.stuck(delivery) ?? []).toSorted(bySince);
+}
+/** How many deliveries were stuck at each hour of the last 7 days, oldest first, the last one now. */
+export function stuckPerHour(records, now) {
+    return Array.from({ length: STUCK_TREND_HOURS }, (_unused, index) => {
+        const at = new Date(now.getTime() - (STUCK_TREND_HOURS - 1 - index) * HOUR_MS);
+        return { at, count: stuckAt(records, at).length };
+    });
+}
+function isSamePlace(first, second) {
+    return first.kind === 'ship' ? second.kind === 'ship' && first.shipId === second.shipId : second.kind === 'type' && first.type === second.type;
+}
+/** The stuck deliveries grouped by cause and place, the oldest waiting first. */
+export function stuckPlaces(stuck) {
+    const places = [];
+    for (const delivery of stuck.toSorted(bySince)) {
+        const index = places.findIndex((counted) => counted.cause === delivery.cause && isSamePlace(counted.place, delivery.place));
+        const counted = places[index];
+        const one = { deliveryId: delivery.deliveryId, messageId: delivery.messageId, state: delivery.state, since: delivery.since };
+        if (counted === undefined) {
+            places.push({ cause: delivery.cause, place: delivery.place, count: 1, oldestSince: delivery.since, deliveries: [one] });
+        }
+        else {
+            places[index] = { ...counted, count: counted.count + 1, deliveries: [...counted.deliveries, one] };
+        }
+    }
+    return places;
+}
+//# sourceMappingURL=stuck.js.map