@openrig/cli 0.6.14 → 0.7.1

package/daemon/dist/domain/gateway/human-mode-account.js

@@ -0,0 +1,112 @@
+import { isBlockerLive } from "../queue-repository.js";
+import { parseSessionName } from "../session-name.js";
+import { DISPOSITION_PREFIX, hasToken, parseQuietHoldNote, QUIET_RELEASE_POLICY, releaseVerdict } from "../policies/quiet-release.js";
+const POSTED_RECEIPT = "slack-owner-notification-posted";
+export const NOT_TRACKED = [
+    "work done while the mode was on: no record ties work to a person",
+    "work that stalled or failed while the mode was on: no record ties it to a person (the mode's own failed or pending effects are listed)",
+];
+export async function modeAccount(input) {
+    const app = input.modes.get(input.applicationId);
+    if (!app || app.entityId !== input.entityId)
+        return { status: "not-found" };
+    if (!app.endedAt)
+        return { status: "still-on", application: app };
+    const current = input.modes.current(input.entityId);
+    return { status: "ok", account: {
+            mode: { applicationId: app.applicationId, modeName: app.modeName, settings: app.settings, startedAt: app.startedAt, startedBy: app.startedBy,
+                scheduledEnd: app.scheduledEnd, endedAt: app.endedAt, endedBy: app.endedBy, endReason: app.endReason },
+            effects: app.effects,
+            unresolved: input.modes.unresolved(input.entityId),
+            now: current ? { applicationId: current.applicationId, modeName: current.modeName } : null,
+            decisions: input.queueRepo.delegatedDecisionsFor(app.applicationId)
+                .map((item) => ({ qitemId: item.qitemId, summary: item.summary ?? null, askedBy: item.sourceSession, decision: item.delegatedDecision })),
+            waiting: await waitingFor(input, app),
+            notTracked: NOT_TRACKED,
+        } };
+}
+/** Asks to the person still open now, plus asks held for their quiet hours while the mode was on that slice 08's release
+ *  set aside as stale. A held ask is classified as the release classifies it; an ask that was never held is still for them. */
+async function waitingFor(input, app) {
+    const db = input.queueRepo.db;
+    // The person's own address, or the `<entityId>@host` custody label a row can be blocked on: a seat that happens to share
+    // their name isn't them.
+    const mine = (session) => {
+        const parsed = session ? parseSessionName(session) : null;
+        return (parsed?.kind === "external" && parsed.local === input.entityId)
+            || (parsed?.kind === "canonical" && parsed.member === input.entityId && parsed.rig === "host");
+    };
+    const open = db.prepare("SELECT qitem_id, destination_session, blocked_on FROM queue_items WHERE state IN ('pending', 'in-progress', 'blocked')")
+        .all()
+        .filter((r) => mine(r.destination_session) || mine(r.blocked_on)).map((r) => r.qitem_id);
+    const heldDuring = db.prepare("SELECT DISTINCT qitem_id FROM queue_transitions WHERE transition_note LIKE 'delivery-decision: quiet-hold %' AND ts >= ? AND ts <= ?")
+        .all(app.startedAt, app.endedAt).map((r) => r.qitem_id);
+    // Whose quiet window held an ask: each window's release job records its person (a replaced window's too), and the
+    // person's current window is in the quiet-hours table. A hold counts only when it was this person's; one whose window
+    // can't be attributed counts only on a row that is theirs.
+    const owners = new Map();
+    for (const j of db.prepare(`SELECT spec_yaml FROM watchdog_jobs WHERE policy = '${QUIET_RELEASE_POLICY}'`).all()) {
+        const windowId = /windowId:\s*"([^"\n]+)"/.exec(j.spec_yaml)?.[1];
+        const entityId = /entityId:\s*"([^"\n]+)"/.exec(j.spec_yaml)?.[1];
+        if (windowId && entityId)
+            owners.set(windowId, entityId);
+    }
+    for (const w of db.prepare("SELECT entity_id, window_id FROM human_quiet_windows").all()) {
+        owners.set(w.window_id, w.entity_id);
+    }
+    const out = [];
+    for (const qitemId of [...new Set([...open, ...heldDuring])]) {
+        const item = input.queueRepo.getById(qitemId);
+        if (!item)
+            continue;
+        const ask = { qitemId, summary: item.summary ?? null, state: item.state };
+        const notes = input.queueRepo.listTransitions(qitemId).map((t) => t.transitionNote ?? "");
+        const rowIsTheirs = mine(item.destinationSession) || mine(item.blockedOn);
+        const hold = [...notes].reverse().map(parseQuietHoldNote)
+            .find((h) => h !== null && (owners.has(h.windowId) ? owners.get(h.windowId) === input.entityId : rowIsTheirs));
+        if (!hold) {
+            // Never held for them: an open ask to them is still theirs; anyone else's, or a closed one, isn't waiting.
+            if (isBlockerLive(item.state) && rowIsTheirs)
+                out.push({ ...ask, standing: "valid", reason: null });
+            continue;
+        }
+        const disposed = notes.find((n) => hasToken(n, DISPOSITION_PREFIX, hold.notificationKey));
+        const disposedReason = disposed ? /reason=(\S+)/.exec(disposed)?.[1] ?? null : null;
+        const posted = notes.some((n) => hasToken(n, POSTED_RECEIPT, hold.notificationKey));
+        if (!rowIsTheirs) {
+            // Held for them once, but the row isn't theirs now. Posted to them when quiet ended: delivered, and what happened after
+            // (answered and unblocked, or re-parked on someone else) isn't theirs. Otherwise it was set aside, and only that stays:
+            // what the row says now isn't theirs to read.
+            if (posted)
+                continue;
+            out.push({ qitemId, summary: null, state: null, standing: "stale", reason: disposedReason ?? "recipient-changed" });
+            continue;
+        }
+        if (disposed) {
+            out.push({ ...ask, standing: "stale", reason: disposedReason });
+            continue;
+        }
+        if (posted) {
+            // Released and posted: still theirs while it's open; closed since, it isn't waiting.
+            if (isBlockerLive(item.state))
+                out.push({ ...ask, standing: "valid", reason: null });
+            continue;
+        }
+        if (!isBlockerLive(item.state)) {
+            out.push({ ...ask, standing: "stale", reason: "row-not-active" });
+            continue;
+        }
+        const verdict = await releaseVerdict({ queueRepo: input.queueRepo, home: input.home, registry: input.registry, entityId: input.entityId,
+            qitemId, notificationKey: hold.notificationKey, now: input.now });
+        if (verdict.kind === "post")
+            out.push({ ...ask, standing: "valid", reason: null });
+        else if (verdict.kind === "quiet")
+            out.push({ ...ask, standing: "held", reason: "quiet hours are still on" });
+        else if (verdict.kind === "disposition")
+            out.push({ ...ask, standing: "stale", reason: verdict.reason });
+        else
+            out.push({ ...ask, standing: "unclassified", reason: verdict.detail });
+    }
+    return out;
+}
+//# sourceMappingURL=human-mode-account.js.map

package/daemon/dist/domain/gateway/human-mode-account.js.map

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

package/daemon/dist/domain/gateway/human-operating-modes.d.ts

@@ -0,0 +1,171 @@
+import type Database from "better-sqlite3";
+import { HumanQuietStore } from "./human-quiet-windows.js";
+export type Availability = "available" | "focus" | "away" | "off";
+/** A quiet rule in the quiet-hours store's own shapes: a daily local rule, or until the application's end. */
+export type QuietRule = {
+    kind: "daily";
+    start: string;
+    end: string;
+    timezone: string;
+} | {
+    kind: "until-end";
+    timezone: string;
+};
+export interface SavedMode {
+    entityId: string;
+    name: string;
+    availability: {
+        value: Availability | null;
+        expectedBack: string | null;
+    };
+    /** Null: no decision room. Never inferred from the mode's name. */
+    decisionRoom: {
+        words: string;
+        exclusions: string[];
+    } | null;
+    delivery: {
+        quiet: QuietRule | null;
+        account: string | null;
+    };
+    setBy: string;
+    setAt: string;
+}
+export type EffectConsumer = "availability" | "quiet" | "decision-room";
+/** `handed-off`: a later mode applied while this effect's restore was still owed took over restoring its prior value. */
+export type EffectState = "active" | "pending" | "failed" | "ended" | "kept" | "handed-off";
+export interface ModeEffect {
+    consumer: EffectConsumer;
+    prior: unknown;
+    changeIdentity: unknown;
+    state: EffectState;
+    detail: string | null;
+    updatedAt: string;
+}
+export interface ModeApplication {
+    applicationId: string;
+    entityId: string;
+    modeName: string;
+    settings: SavedMode;
+    startedBy: string;
+    startedAt: string;
+    scheduledEnd: string | null;
+    endedAt: string | null;
+    endedBy: string | null;
+    endReason: EndReason | null;
+    effects: ModeEffect[];
+}
+export type EndReason = "back" | "scheduled" | "switched";
+export declare class ModeError extends Error {
+    readonly code: "invalid_mode" | "mode_not_found" | "end_required";
+    constructor(code: "invalid_mode" | "mode_not_found" | "end_required", message: string);
+}
+/** The two writers a mode changes outside its own tables; tests inject failing ones. */
+export interface AvailabilityAccess {
+    /** The authored value, and the id of the latest change recorded through the registry's writers (null: none yet). */
+    read(entityId: string): {
+        ok: true;
+        availability: string | undefined;
+        changeId?: string | null;
+        away?: boolean;
+    } | {
+        ok: false;
+        error: string;
+    };
+    /** changeId: the change record this write left (also on an error after the fragment and record were written). */
+    write(entityId: string, value: Availability | "unset"): {
+        ok: true;
+        changeId?: string;
+    } | {
+        ok: false;
+        error: string;
+        changeId?: string;
+    };
+    /** Set the legacy `away` flag. Ending a mode only clears one set while the mode's away was on; one the person had
+     *  before the mode is left as it is. */
+    setLegacyAway?(entityId: string, on: boolean): {
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+export declare function registryAvailability(home: string): AvailabilityAccess;
+/** Mode names are compared in one spelling: lower case, words joined by hyphens ("Away from desk" is away-from-desk). */
+export declare function modeName(raw: string): string;
+export declare const AT_DESK = "at-desk";
+export declare class HumanModeService {
+    private readonly deps;
+    private readonly quiet;
+    /** `availability` is needed only to apply or end a mode; reading saved modes and applications works without it. */
+    /** `armScheduledEnd` arms the timer that ends an application at its scheduled end; it runs with the application's insert,
+     *  so one never commits without the other. */
+    constructor(deps: {
+        db: Database.Database;
+        availability?: AvailabilityAccess;
+        quiet?: HumanQuietStore;
+        now?: () => Date;
+        armScheduledEnd?: (application: {
+            applicationId: string;
+            entityId: string;
+            scheduledEnd: string;
+        }) => void;
+    });
+    private get availability();
+    private now;
+    save(entityId: string, input: {
+        name: string;
+        availability?: {
+            value?: string | null;
+            expectedBack?: string | null;
+        };
+        decisionRoom?: {
+            words?: string | null;
+            exclusions?: string[];
+        } | null;
+        delivery?: {
+            quiet?: QuietRule | null;
+            account?: string | null;
+        };
+    }, actor: string): SavedMode;
+    saved(entityId: string, name: string): SavedMode | null;
+    list(entityId: string): SavedMode[];
+    /** The person's active application, or null: at desk. */
+    current(entityId: string): ModeApplication | null;
+    get(applicationId: string): ModeApplication | null;
+    /** Apply a saved mode. At desk ends the current application and applies nothing. Another active mode is ended first
+     *  (a switch), so a person has at most one. */
+    apply(entityId: string, name: string, input: {
+        scheduledEnd?: Date | null;
+    }, actor: string): {
+        application: ModeApplication | null;
+        ended: ModeApplication | null;
+    };
+    /** End the person's active application: each effect ends only if the latest change is still its own. Returns the
+     *  ended application, or null when none was active. Every time, restorations still pending or failed from earlier
+     *  applications are tried again (see unresolved), so a later mode never hides an older one's. */
+    end(entityId: string, reason: EndReason, actor: string): ModeApplication | null;
+    /** End this application, and only while it's still the one on: a timer armed for it never ends a later mode the person
+     *  switched to. Null when it has already ended. */
+    endIfStill(applicationId: string, reason: EndReason, actor: string): ModeApplication | null;
+    /** Restorations from ended applications that are still pending or failed: owed in the coming-back report, and tried
+     *  again by every end. Oldest application first. */
+    unresolved(entityId: string): Array<{
+        applicationId: string;
+        modeName: string;
+        endedAt: string;
+        effect: ModeEffect;
+    }>;
+    private unresolvedApplicationIds;
+    private endEffects;
+    /** The latest earlier application's still-owed restore of this consumer, if its change is still the live one. */
+    private owedStillOwn;
+    /** Close an earlier effect whose restore a later mode took over: not kept (nobody chose otherwise), not ended (nothing
+     *  was restored yet), but handed to the mode that now restores its prior value. */
+    private handOff;
+    private endAvailability;
+    private endQuiet;
+    private effect;
+    private effects;
+    private application;
+}
+//# sourceMappingURL=human-operating-modes.d.ts.map

package/daemon/dist/domain/gateway/human-operating-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-operating-modes.d.ts","sourceRoot":"","sources":["../../../src/domain/gateway/human-operating-modes.ts"],"names":[],"mappings":"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"}