@aeolus-fleet/gateway 0.35.0 → 0.36.1

package/dist/core/people/basket.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The basket (docs/design/bridge, section 9; CC21): answers to questions the
+ * person picked in Bridge and has not sent, kept per fleet and person ship,
+ * one entry per question, by its uuid. Nothing is sent until the person
+ * presses Send N answers; then each entry is stored as sending, and the
+ * gateway sends each on its own, in the order added, until the fleet stores
+ * it or refuses it. An entry keeps what its answer and the basket's list
+ * need, so it is sent, and shown, whatever came of its opened delivery.
+ */
+import type { DeliveryId, FleetId, MessageId, ShipId } from '@aeolus-fleet/common';
+import type { ItemOutcome, Place } from './item-outcome.js';
+import type { Stale } from './stale-question.js';
+/** Where an entry is: waiting for Send, stored as sending, or refused by the fleet, not sent. */
+export type BasketEntryState = 'waiting' | 'sending' | 'refused';
+export interface BasketEntry {
+    readonly fleetId: FleetId;
+    readonly shipId: ShipId;
+    /** The uuid of the question it answers (decision 0038): one entry per question. */
+    readonly questionId: string;
+    readonly deliveryId: DeliveryId;
+    /** The question's message, which the answer is in reply to, and its asker. */
+    readonly messageId: MessageId;
+    readonly senderShipId: ShipId;
+    readonly from: string;
+    readonly title: string;
+    /** When the question was asked. */
+    readonly sentAt: Date;
+    readonly option: number;
+    /** The note that goes with the answer; none when the person wrote none. */
+    readonly note: string | null;
+    /** When it was put in the basket: entries are sent in this order, and changing one keeps its place. */
+    readonly addedAt: Date;
+    readonly state: BasketEntryState;
+    /** Why the fleet refused it, while refused. */
+    readonly refusal: string | null;
+}
+/** Outbound port: the basket of each person ship, by fleet, person ship and question. */
+export interface BasketEntries {
+    /** Keeps it, or keeps it anew when its question has an entry already. */
+    save(entry: BasketEntry): Promise<void>;
+    find(fleetId: FleetId, asked: {
+        shipId: ShipId;
+        questionId: string;
+    }): Promise<BasketEntry | undefined>;
+    /** The person ship's, in the order added. */
+    list(fleetId: FleetId, shipId: ShipId): Promise<BasketEntry[]>;
+    /** How many entries the person ship's basket holds. */
+    count(fleetId: FleetId, shipId: ShipId): Promise<number>;
+    remove(fleetId: FleetId, removed: {
+        shipId: ShipId;
+        questionId: string;
+    }): Promise<void>;
+    /** The person ships with an entry stored as sending, of every fleet, by fleet and ship, after the one given. */
+    sendingShips(page: {
+        after: {
+            fleetId: FleetId;
+            shipId: ShipId;
+        } | null;
+        limit: number;
+    }): Promise<{
+        fleetId: FleetId;
+        shipId: ShipId;
+    }[]>;
+}
+/**
+ * What an entry stands as now: as kept (waiting, sending, refused with
+ * why); its question withdrawn or replaced by its asker (section 9, rule
+ * 5); or dealt with elsewhere, as when Slack or a chat answered it first
+ * (rule 6): either is not sent.
+ */
+export type BasketStanding = {
+    readonly kind: 'waiting';
+} | {
+    readonly kind: 'sending';
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+} | {
+    readonly kind: 'withdrawn';
+} | {
+    readonly kind: 'replaced';
+    readonly replacementId: DeliveryId | null;
+} | {
+    readonly kind: 'dealtElsewhere';
+    readonly place: Place;
+    readonly option: number | null;
+};
+/**
+ * An entry's standing, from what came of its question, if anything did, and
+ * whether its asker withdrew or replaced it. Once sending, the answer goes:
+ * a withdrawal that comes later is the asker's business (section 9).
+ */
+export declare function standingOf(entry: BasketEntry, known: {
+    outcome: ItemOutcome | undefined;
+    stale: Stale | null;
+}): BasketStanding;
+/** The answer an entry sends (decision 0038): its question's uuid, its option, and its note if any. */
+export declare function answerOf(entry: Pick<BasketEntry, 'questionId' | 'option' | 'note'>): {
+    questionId: string;
+    option: number;
+    note?: string;
+};
+/** The key an entry's answer is sent under: the question's, so it is stored once however often it is sent (section 9). */
+export declare function answerKeyOf(entry: Pick<BasketEntry, 'questionId'>): string;

package/dist/core/people/basket.js

@@ -0,0 +1,42 @@
+/**
+ * An entry's standing, from what came of its question, if anything did, and
+ * whether its asker withdrew or replaced it. Once sending, the answer goes:
+ * a withdrawal that comes later is the asker's business (section 9).
+ */
+export function standingOf(entry, known) {
+    const { outcome, stale } = known;
+    if (outcome !== undefined) {
+        switch (outcome.kind) {
+            case 'withdrawn':
+                return { kind: 'withdrawn' };
+            case 'replaced':
+                return { kind: 'replaced', replacementId: null };
+            case 'seen':
+            case 'answered':
+            case 'done':
+            case 'cannot':
+            case 'notSent':
+                return { kind: 'dealtElsewhere', place: outcome.place, option: outcome.option };
+        }
+    }
+    switch (entry.state) {
+        case 'sending':
+            return { kind: 'sending' };
+        case 'refused':
+            return { kind: 'refused', reason: entry.refusal ?? 'The fleet refused it' };
+        case 'waiting':
+            if (stale === null) {
+                return { kind: 'waiting' };
+            }
+            return stale.kind === 'withdrawn' ? { kind: 'withdrawn' } : { kind: 'replaced', replacementId: stale.replacementId };
+    }
+}
+/** The answer an entry sends (decision 0038): its question's uuid, its option, and its note if any. */
+export function answerOf(entry) {
+    return { questionId: entry.questionId, option: entry.option, ...(entry.note === null ? {} : { note: entry.note }) };
+}
+/** The key an entry's answer is sent under: the question's, so it is stored once however often it is sent (section 9). */
+export function answerKeyOf(entry) {
+    return `answer-${entry.questionId}`;
+}
+//# sourceMappingURL=basket.js.map

package/dist/core/people/basket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basket.js","sourceRoot":"","sources":["../../../src/core/people/basket.ts"],"names":[],"mappings":"AAoEA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB,EAAE,KAAgE;IAC7G,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,WAAW;gBACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAC/B,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC;YACZ,KAAK,UAAU,CAAC;YAChB,KAAK,MAAM,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS;gBACZ,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACpF,CAAC;IACH,CAAC;IACD,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,sBAAsB,EAAE,CAAC;QAC9E,KAAK,SAAS;YACZ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7B,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IACzH,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAC,KAA0D;IACjF,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;AACtH,CAAC;AAED,0HAA0H;AAC1H,MAAM,UAAU,WAAW,CAAC,KAAsC;IAChE,OAAO,UAAU,KAAK,CAAC,UAAU,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/people/count-basket.d.ts

@@ -0,0 +1,16 @@
+import { type Result } from '../shared/result.js';
+import type { BasketEntries } from './basket.js';
+import type { CrewPersonShip } from './crew-person-ship.js';
+import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+export type CountBasket = (caller: PersonCaller) => Promise<Result<{
+    count: number;
+}, PersonCrewError>>;
+/**
+ * Use case: how many answers the person's basket holds, for Bridge's
+ * navigation on every page (section 9, rule 2): counted in the gateway's
+ * database, nothing read from the fleet.
+ */
+export declare function createCountBasket(deps: {
+    crewPersonShip: CrewPersonShip;
+    entries: BasketEntries;
+}): CountBasket;

package/dist/core/people/count-basket.js

@@ -0,0 +1,14 @@
+import { ok } from '../shared/result.js';
+import { personCrewOf } from './person-crew.js';
+/**
+ * Use case: how many answers the person's basket holds, for Bridge's
+ * navigation on every page (section 9, rule 2): counted in the gateway's
+ * database, nothing read from the fleet.
+ */
+export function createCountBasket(deps) {
+    return async (caller) => {
+        const crew = await personCrewOf(deps.crewPersonShip, caller);
+        return crew.isOk ? ok({ count: await deps.entries.count(caller.fleetId, crew.value.shipId) }) : crew;
+    };
+}
+//# sourceMappingURL=count-basket.js.map

package/dist/core/people/count-basket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-basket.js","sourceRoot":"","sources":["../../../src/core/people/count-basket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAIzF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgE;IAChG,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvG,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/done-delivery.d.ts

@@ -1,17 +1,25 @@
+import { type DomainError } from '../shared/errors.js';
 import type { Result } from '../shared/result.js';
-import type { CrewPersonShip } from './crew-person-ship.js';
-import { type Dealt, type DealtError } from './opened-of.js';
-import type { PersonCaller } from './person-crew.js';
-import type { InboxChanges, OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
+import type { Place } from './item-outcome.js';
+import { type Dealt, type DealDeps, type DealtError } from './opened-of.js';
+import { type PersonCaller } from './person-crew.js';
+import { type StepOutcomeKind } from './step-outcome.js';
 export type DoneDelivery = (input: {
     caller: PersonCaller;
+    place: Place;
     deliveryId: string;
-}) => Promise<Result<Dealt, DealtError>>;
-/** Use case: a person is done with a delivery they opened, with no answer (Q20): it is handled. */
-export declare function createDoneDelivery(deps: {
-    crewPersonShip: CrewPersonShip;
-    crews: PersonCrews;
-    door: PersonShipDoor;
-    opened: OpenedDeliveries;
-    changes: InboxChanges;
-}): DoneDelivery;
+    /** How a step ended: done unless named; only a step may end as cannot. */
+    outcome?: StepOutcomeKind;
+    /** The person's note on a step, for done and cannot alike; only a step takes one. */
+    note?: string;
+}) => Promise<Result<Dealt, DealtError | DomainError<'SEND_REFUSED' | 'NOT_A_STEP'>>>;
+/**
+ * Use case: a person is done with a delivery they opened (Q20): it is
+ * handled, done where they were. A step (Bridge, CC14) ends done or cannot,
+ * with the note if they wrote one: its outcome goes to the asker at once,
+ * in reply to the step, never through the basket (CC23), and only then is
+ * it handled. The outcome's key is the delivery's, so one tried again after
+ * the fleet did not take handled is sent once. Any other delivery sends
+ * nothing, so cannot and a note are refused for it.
+ */
+export declare function createDoneDelivery(deps: DealDeps): DoneDelivery;

package/dist/core/people/done-delivery.js

@@ -1,9 +1,39 @@
+import { refuse } from '../shared/errors.js';
 import { handledOf, openedOf } from './opened-of.js';
-/** Use case: a person is done with a delivery they opened, with no answer (Q20): it is handled. */
+import { asPersonCrew, withOwnRefusal } from './person-crew.js';
+import { noteOf, STEP_OUTCOME_CONTENT_TYPE, stepOutcomePayloadOf } from './step-outcome.js';
+/**
+ * Use case: a person is done with a delivery they opened (Q20): it is
+ * handled, done where they were. A step (Bridge, CC14) ends done or cannot,
+ * with the note if they wrote one: its outcome goes to the asker at once,
+ * in reply to the step, never through the basket (CC23), and only then is
+ * it handled. The outcome's key is the delivery's, so one tried again after
+ * the fleet did not take handled is sent once. Any other delivery sends
+ * nothing, so cannot and a note are refused for it.
+ */
 export function createDoneDelivery(deps) {
-    return async (asked) => {
-        const opened = await openedOf(deps, asked);
-        return opened.isOk ? handledOf(deps, { caller: asked.caller, delivery: opened.value }) : opened;
+    return async ({ caller, place, deliveryId, outcome = 'done', note }) => {
+        const opened = await openedOf(deps, { caller, deliveryId });
+        if (!opened.isOk) {
+            return opened;
+        }
+        const delivery = opened.value;
+        const { stepId } = delivery;
+        if (stepId === null) {
+            if (outcome === 'cannot' || noteOf(note) !== null) {
+                return refuse('NOT_A_STEP', `${delivery.title} is no step: only a step ends as cannot or takes a note. Answer it with your note instead`);
+            }
+            return handledOf(deps, { caller, delivery, as: { place, kind: 'done', option: null } });
+        }
+        const reply = { to: delivery.senderShipId, inReplyTo: delivery.messageId, contentType: STEP_OUTCOME_CONTENT_TYPE, payload: stepOutcomePayloadOf({ stepId, kind: outcome, note: noteOf(note) }), idempotencyKey: `step-outcome-${delivery.deliveryId}` };
+        const sent = await asPersonCrew(deps, { caller, run: (crew) => withOwnRefusal(deps.door.reply(crew.crewToken, reply)) });
+        if (!sent.isOk) {
+            return sent;
+        }
+        if (!sent.value.value.isOk) {
+            return refuse('SEND_REFUSED', `The fleet did not take your outcome: ${sent.value.value.error.message}`);
+        }
+        return handledOf(deps, { caller, delivery, as: { place, kind: outcome, option: null } });
     };
 }
 //# sourceMappingURL=done-delivery.js.map

package/dist/core/people/done-delivery.js.map

@@ -1 +1 @@
-{"version":3,"file":"done-delivery.js","sourceRoot":"","sources":["../../../src/core/people/done-delivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAA+B,MAAM,gBAAgB,CAAC;AAMlF,mGAAmG;AACnG,MAAM,UAAU,kBAAkB,CAAC,IAAmI;IACpK,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAClG,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"done-delivery.js","sourceRoot":"","sources":["../../../src/core/people/done-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAA8C,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,oBAAoB,EAAwB,MAAM,mBAAmB,CAAC;AAYlH;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACrE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC5B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,MAAM,CAAC,YAAY,EAAE,GAAG,QAAQ,CAAC,KAAK,2FAA2F,CAAC,CAAC;YAC5I,CAAC;YACD,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,gBAAgB,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;QACxP,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACzH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,cAAc,EAAE,wCAAwC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/people/finish-own-step.d.ts

@@ -0,0 +1,27 @@
+import type { ConnectionStore } from '../connection/ports.js';
+import type { FinishesOwnStep } from '../party-grants/ports.js';
+import type { SentMessages } from '../mcp-in/ports.js';
+import type { Clock } from '../shared/clock.js';
+import type { ItemOutcomes } from './item-outcome.js';
+import type { InboxChanges, OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
+/**
+ * Use case: a step the gateway's ship sent a person, as to sign in to an
+ * outside server, is done once the gateway sees it complete, with no press
+ * (Bridge, CC14). The gateway's ship reads where the step's delivery stands;
+ * as the person ship's crew the gateway takes it if it is still pending,
+ * acknowledges it if the person had not opened it, and reports it handled.
+ * It is kept done by the gateway, forgotten as opened, and the person's
+ * pages are told. No outcome is sent: the asker is the gateway, which saw
+ * it complete. A step that ended already, or that the fleet does not take
+ * as handled, is left as it is, for the person to mark.
+ */
+export declare function createFinishOwnStep(deps: {
+    connections: Pick<ConnectionStore, 'find'>;
+    sent: SentMessages;
+    crews: Pick<PersonCrews, 'find'>;
+    door: PersonShipDoor;
+    opened: OpenedDeliveries;
+    outcomes: ItemOutcomes;
+    changes: InboxChanges;
+    clock: Clock;
+}): FinishesOwnStep;

package/dist/core/people/finish-own-step.js

@@ -0,0 +1,67 @@
+import { INBOX_LIST_MAX } from './read-inbox.js';
+function finishingOf(state) {
+    switch (state) {
+        case 'pending':
+            return 'takeFirst';
+        case 'received':
+        case 'handed':
+            return 'acknowledgeFirst';
+        case 'acknowledged':
+            return 'handledOnly';
+        case 'handled':
+        case 'notHandled':
+        case 'undeliverable':
+        case 'dismissed':
+        case 'abandoned':
+            return 'ended';
+    }
+}
+/**
+ * Use case: a step the gateway's ship sent a person, as to sign in to an
+ * outside server, is done once the gateway sees it complete, with no press
+ * (Bridge, CC14). The gateway's ship reads where the step's delivery stands;
+ * as the person ship's crew the gateway takes it if it is still pending,
+ * acknowledges it if the person had not opened it, and reports it handled.
+ * It is kept done by the gateway, forgotten as opened, and the person's
+ * pages are told. No outcome is sent: the asker is the gateway, which saw
+ * it complete. A step that ended already, or that the fleet does not take
+ * as handled, is left as it is, for the person to mark.
+ */
+export function createFinishOwnStep(deps) {
+    /** Takes, then acknowledges, the delivery as the finishing needs: whether it is acknowledged now. */
+    const acknowledged = async (crewToken, delivery) => {
+        switch (delivery.finishing) {
+            case 'ended':
+                return false;
+            case 'handledOnly':
+                return true;
+            case 'takeFirst': {
+                const taken = await deps.door.pushReceive(crewToken, { max: INBOX_LIST_MAX });
+                return taken.isOk && taken.value.some(({ deliveryId }) => deliveryId === delivery.deliveryId) && (await deps.door.ack(crewToken, delivery.deliveryId)).isOk;
+            }
+            case 'acknowledgeFirst':
+                return (await deps.door.ack(crewToken, delivery.deliveryId)).isOk;
+        }
+    };
+    return async ({ fleetId, personShipId, stepMessageId }) => {
+        const [gateway, crew] = await Promise.all([deps.connections.find(fleetId), deps.crews.find(fleetId, personShipId)]);
+        if (gateway === undefined || crew === undefined) {
+            return;
+        }
+        const sent = await deps.sent.sentMessage(gateway.crewToken, stepMessageId);
+        if (!sent.isOk) {
+            return;
+        }
+        const { deliveryId } = sent.value;
+        if (!(await acknowledged(crew.crewToken, { deliveryId, finishing: finishingOf(sent.value.state) }))) {
+            return;
+        }
+        if (!(await deps.door.handled(crew.crewToken, deliveryId)).isOk) {
+            return;
+        }
+        await deps.outcomes.save({ fleetId, shipId: personShipId, deliveryId, place: 'gateway', kind: 'done', option: null, at: deps.clock.now() });
+        await deps.opened.remove(fleetId, { shipId: personShipId, deliveryId });
+        await deps.changes.tell({ fleetId, shipId: personShipId });
+    };
+}
+//# sourceMappingURL=finish-own-step.js.map

package/dist/core/people/finish-own-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish-own-step.js","sourceRoot":"","sources":["../../../src/core/people/finish-own-step.ts"],"names":[],"mappings":"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"}

package/dist/core/people/inbox-entry.js

@@ -9,7 +9,7 @@ const MEETING_NOTICE_TITLES = new Map([
 ]);
 /** A question's own title; a meeting notice's in words; any other message's first line, cut to the longest title. */
 export function titleOf(delivery) {
-    const title = delivery.questionTitle ?? MEETING_NOTICE_TITLES.get(delivery.contentType) ?? delivery.payload.split('\n', 1)[0] ?? '';
+    const title = delivery.headline ?? MEETING_NOTICE_TITLES.get(delivery.contentType) ?? delivery.payload.split('\n', 1)[0] ?? '';
     return title.length > TITLE_MAX_LENGTH ? `${title.slice(0, TITLE_MAX_LENGTH - 1)}…` : title;
 }
 export function inboxEntryOf(delivery) {

package/dist/core/people/inbox-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-entry.js","sourceRoot":"","sources":["../../../src/core/people/inbox-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,wBAAwB,EAAmB,MAAM,sBAAsB,CAAC;AAIzI,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAUnC,mGAAmG;AACnG,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,CAAC,0BAA0B,EAAE,6BAA6B,CAAC;IAC3D,CAAC,wBAAwB,EAAE,+BAA+B,CAAC;IAC3D,CAAC,0BAA0B,EAAE,kCAAkC,CAAC;CACjE,CAAC,CAAC;AAEH,qHAAqH;AACrH,MAAM,UAAU,OAAO,CAAC,QAAwB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpI,OAAO,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACzI,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACxH,CAAC"}
+{"version":3,"file":"inbox-entry.js","sourceRoot":"","sources":["../../../src/core/people/inbox-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,wBAAwB,EAAmB,MAAM,sBAAsB,CAAC;AAIzI,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAUnC,mGAAmG;AACnG,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,CAAC,0BAA0B,EAAE,6BAA6B,CAAC;IAC3D,CAAC,wBAAwB,EAAE,+BAA+B,CAAC;IAC3D,CAAC,0BAA0B,EAAE,kCAAkC,CAAC;CACjE,CAAC,CAAC;AAEH,qHAAqH;AACrH,MAAM,UAAU,OAAO,CAAC,QAAwB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/H,OAAO,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACzI,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACxH,CAAC"}

package/dist/core/people/item-job.d.ts

@@ -0,0 +1,9 @@
+/** The step and notice content types (CC14, CC15), as common names them from its release after 0.35.0; they move to common's constants then. */
+export declare const STEP_CONTENT_TYPE = "application/vnd.aeolus.step+json";
+export declare const NOTICE_CONTENT_TYPE = "application/vnd.aeolus.notice+json";
+export type ItemJob = 'decide' | 'do' | 'stay-aware' | 'everything-else';
+/** A content type's essence: media types compare without case and without their parameters (RFC 9110). */
+export declare function essenceOf(contentType: string): string;
+export declare function jobOf(contentType: string): ItemJob;
+/** Whether an item of the job is in what waits and its count, until done. */
+export declare function isCounted(job: ItemJob): boolean;

package/dist/core/people/item-job.js

@@ -0,0 +1,38 @@
+/**
+ * An item's job (docs/design/bridge, section 6): a delivery to the person
+ * ship is known by its content type (CC10). Decide and do wait on the person
+ * and are counted in what waits; stay aware reaches them unasked, outside the
+ * count; everything else is in the record only.
+ */
+import { ALERT_CONTENT_TYPE, QUESTION_CONTENT_TYPE, REPLACEMENT_CONTENT_TYPE } from '@aeolus-fleet/common';
+/** The step and notice content types (CC14, CC15), as common names them from its release after 0.35.0; they move to common's constants then. */
+export const STEP_CONTENT_TYPE = 'application/vnd.aeolus.step+json';
+export const NOTICE_CONTENT_TYPE = 'application/vnd.aeolus.notice+json';
+const JOBS = new Map([
+    [QUESTION_CONTENT_TYPE, 'decide'],
+    // A replacement asks its new question: it is a new item to decide (Bridge, section 9).
+    [REPLACEMENT_CONTENT_TYPE, 'decide'],
+    [STEP_CONTENT_TYPE, 'do'],
+    [ALERT_CONTENT_TYPE, 'stay-aware'],
+    [NOTICE_CONTENT_TYPE, 'stay-aware'],
+]);
+/** A content type's essence: media types compare without case and without their parameters (RFC 9110). */
+export function essenceOf(contentType) {
+    const [essence = ''] = contentType.split(';');
+    return essence.trim().toLowerCase();
+}
+export function jobOf(contentType) {
+    return JOBS.get(essenceOf(contentType)) ?? 'everything-else';
+}
+/** Whether an item of the job is in what waits and its count, until done. */
+export function isCounted(job) {
+    switch (job) {
+        case 'decide':
+        case 'do':
+            return true;
+        case 'stay-aware':
+        case 'everything-else':
+            return false;
+    }
+}
+//# sourceMappingURL=item-job.js.map

package/dist/core/people/item-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-job.js","sourceRoot":"","sources":["../../../src/core/people/item-job.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE3G,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAIxE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAkB;IACpC,CAAC,qBAAqB,EAAE,QAAQ,CAAC;IACjC,uFAAuF;IACvF,CAAC,wBAAwB,EAAE,QAAQ,CAAC;IACpC,CAAC,iBAAiB,EAAE,IAAI,CAAC;IACzB,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAClC,CAAC,mBAAmB,EAAE,YAAY,CAAC;CACpC,CAAC,CAAC;AAEH,0GAA0G;AAC1G,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,WAAmB;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,iBAAiB,CAAC;AAC/D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd,KAAK,YAAY,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/core/people/item-outcome.d.ts

@@ -0,0 +1,37 @@
+/**
+ * What came of an item and where (docs/design/bridge, CC4): the gateway
+ * keeps it when the person acts on a delivery to their person ship, since
+ * core's record keeps the delivery's state but not the place nor the answer.
+ * The first outcome kept for a delivery stays: one answer per question.
+ */
+import type { DeliveryId, FleetId, ShipId } from '@aeolus-fleet/common';
+/** Where the person acted: Bridge, a chat (an MCP client of the gateway), or Slack; or the gateway, which saw a step of its own complete (CC14). */
+export type Place = 'bridge' | 'chat' | 'slack' | 'gateway';
+/**
+ * What the person did: saw it, answered it (with the option they picked, if
+ * any), or marked it done, or a step that they cannot do it; saw a question its asker withdrew or replaced; or
+ * removed an answer from the basket the fleet refused, so it was not sent.
+ */
+export type OutcomeKind = 'seen' | 'answered' | 'done' | 'cannot' | 'withdrawn' | 'replaced' | 'notSent';
+export interface ItemOutcome {
+    readonly fleetId: FleetId;
+    readonly shipId: ShipId;
+    readonly deliveryId: DeliveryId;
+    readonly place: Place;
+    readonly kind: OutcomeKind;
+    /** The option of a question the person answered with; none for a note alone or any other outcome. */
+    readonly option: number | null;
+    readonly at: Date;
+}
+/** Outbound port: the outcomes kept, by fleet, person ship and delivery. */
+export interface ItemOutcomes {
+    /** Keeps it, unless an outcome of the delivery is kept already. */
+    save(outcome: ItemOutcome): Promise<void>;
+    /** The outcomes of these deliveries of the person ship that are kept. */
+    findMany(fleetId: FleetId, asked: {
+        shipId: ShipId;
+        deliveryIds: readonly DeliveryId[];
+    }): Promise<ItemOutcome[]>;
+}
+/** What came of an item and where, in words, as Bridge says it: such as Answered in Slack: option 2. */
+export declare function outcomeTextOf(outcome: Pick<ItemOutcome, 'place' | 'kind' | 'option'>): string;

package/dist/core/people/item-outcome.js

@@ -0,0 +1,21 @@
+const PLACES = {
+    bridge: 'in Bridge',
+    chat: 'in a chat',
+    slack: 'in Slack',
+    gateway: 'by the gateway',
+};
+const KINDS = {
+    seen: 'Seen',
+    answered: 'Answered',
+    done: 'Done',
+    cannot: 'Marked cannot',
+    withdrawn: 'Withdrawn by its asker, seen',
+    replaced: 'Replaced by its asker, seen',
+    notSent: 'Not sent, removed',
+};
+/** What came of an item and where, in words, as Bridge says it: such as Answered in Slack: option 2. */
+export function outcomeTextOf(outcome) {
+    const said = `${KINDS[outcome.kind]} ${PLACES[outcome.place]}`;
+    return outcome.option === null ? said : `${said}: option ${String(outcome.option)}`;
+}
+//# sourceMappingURL=item-outcome.js.map

package/dist/core/people/item-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-outcome.js","sourceRoot":"","sources":["../../../src/core/people/item-outcome.ts"],"names":[],"mappings":"AAqCA,MAAM,MAAM,GAA0B;IACpC,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,gBAAgB;CAC1B,CAAC;AAEF,MAAM,KAAK,GAAgC;IACzC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,8BAA8B;IACzC,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,mBAAmB;CAC7B,CAAC;AAEF,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,OAAuD;IACnF,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/D,OAAO,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACtF,CAAC"}

package/dist/core/people/item-state.d.ts

@@ -0,0 +1,10 @@
+/**
+ * An item's state (docs/design/bridge, section 6), from its delivery's state:
+ * new while the person has not acted on it, seen once they did in any place,
+ * and done once nothing more waits on them. A delivery the fleet ended
+ * without the person (not handled, undeliverable, dismissed or abandoned)
+ * waits on them no more either, so it is done.
+ */
+import type { DeliveryState } from '@aeolus-fleet/common';
+export type ItemState = 'new' | 'seen' | 'done';
+export declare function itemStateOf(state: DeliveryState): ItemState;

package/dist/core/people/item-state.js

@@ -0,0 +1,17 @@
+export function itemStateOf(state) {
+    switch (state) {
+        case 'pending':
+        case 'received':
+        case 'handed':
+            return 'new';
+        case 'acknowledged':
+            return 'seen';
+        case 'handled':
+        case 'notHandled':
+        case 'undeliverable':
+        case 'dismissed':
+        case 'abandoned':
+            return 'done';
+    }
+}
+//# sourceMappingURL=item-state.js.map

package/dist/core/people/item-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-state.js","sourceRoot":"","sources":["../../../src/core/people/item-state.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf,KAAK,cAAc;YACjB,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe,CAAC;QACrB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/core/people/open-delivery.d.ts

@@ -1,30 +1,25 @@
 import type { MeetingId } from '@aeolus-fleet/common';
-import type { Clock } from '../shared/clock.js';
 import { type DomainError } from '../shared/errors.js';
 import { type Result } from '../shared/result.js';
-import type { CrewPersonShip } from './crew-person-ship.js';
 import { type InboxEntry } from './inbox-entry.js';
-import { type PersonCaller, type PersonCrewError } from './person-crew.js';
-import type { InboxChanges, OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
-/** A delivery as a person opens it: whole, with the meeting it belongs to, none outside a meeting. */
+import { type PersonCaller, type PersonCrewError, type PersonCrewToken } from './person-crew.js';
+import type { Place } from './item-outcome.js';
+import { type DealDeps } from './opened-of.js';
+import type { OpenedDelivery, PersonDelivery } from './ports.js';
+import { type Stale } from './stale-question.js';
+/** A delivery as a person opens it: whole, with the meeting it belongs to, none outside a meeting, and stale once its asker withdrew or replaced the question it asks. */
 export interface OpenedView extends InboxEntry {
     readonly contentType: string;
     readonly payload: string;
     readonly meetingId: MeetingId | null;
+    readonly stale: Stale | null;
 }
 type OpenError = PersonCrewError | DomainError<'NO_SUCH_DELIVERY'>;
 export type OpenDelivery = (input: {
     caller: PersonCaller;
     deliveryId: string;
+    place: Place;
 }) => Promise<Result<OpenedView, OpenError>>;
-interface OpenDeps {
-    crewPersonShip: CrewPersonShip;
-    crews: PersonCrews;
-    door: PersonShipDoor;
-    opened: OpenedDeliveries;
-    changes: InboxChanges;
-    clock: Clock;
-}
 /**
  * Use case: a person opens one delivery that waits for their person ship
  * (Q20). Opening is their own act, so the gateway, as the ship's crew,
@@ -34,6 +29,26 @@ interface OpenDeps {
  * opened, from any client, opens again whole as the fleet reads it again,
  * never from a copy, until they answer it or are done (aeolus-fleet #1046).
  * Once acknowledged, the person's pages are told their inbox changed.
+ * Seeing an alert or a notice is all it asks (Bridge, CC16): it is reported
+ * handled at once, seen where the person saw it; one the fleet did not take
+ * handled for stays opened, and opening it again tries once more. So is
+ * looking at a question its asker withdrew or replaced (Bridge, section 9):
+ * it is shown stale and is done, withdrawn with its withdrawal, or replaced;
+ * the replacement is a new item that still waits. Opening a replacement is
+ * done with the question it replaces too.
+ */
+export declare function createOpenDelivery(deps: DealDeps): OpenDelivery;
+/**
+ * The person looked at a delivery (Bridge, section 9): a question its asker
+ * withdrew is done as withdrawn, and its withdrawal as seen; one replaced is
+ * done as replaced. A replacement is done with the question it replaces.
+ * What the fleet does not take now waits for the next look.
  */
-export declare function createOpenDelivery(deps: OpenDeps): OpenDelivery;
+export declare function doneIfStale(deps: DealDeps, look: {
+    caller: PersonCaller;
+    crew: PersonCrewToken;
+    looked: OpenedDelivery;
+    waiting: readonly PersonDelivery[];
+    place: Place;
+}): Promise<Stale | null>;
 export {};