@detergent-software/conductor 1.0.0-dev.2 → 1.0.0-dev.21

package/build/notes.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import { ConductorError } from "./errors.js";
+import { notePrefixes, trackerKey } from "./profile.js";
+import { ACTIVE_STATUSES } from "./store.js";
+import { linearApi, LinearRequestError } from "./watchers/linear-api.js";
+import { noteHeading } from "./watchers/linear.js";
+// A note the tracker didn't take. `posted` says whether the worker may post it itself: `no` when
+// the tracker refused it or was never asked, `unknown` when the request to write it may have landed.
+export class NotePostError extends ConductorError {
+    posted;
+    constructor(message, posted, details = []) {
+        super(message, details);
+        this.name = 'NotePostError';
+        this.posted = posted;
+    }
+}
+const ITEM = /^[A-Za-z]+-\d+$/;
+// Worker protocol v1's write-through note (design note, section 4): post it, then record the phase
+// on the worker and the item at once, so the fleet shows it before any watcher pass.
+export function noteService({ store, tracker }) {
+    return {
+        post: async ({ body, item, worker: workerId }) => {
+            if (!ITEM.test(item))
+                throw new ConductorError(`"${item}" is not a tracker item, such as ATK-311`);
+            const named = workerId === undefined ? null : store.getWorker(workerId);
+            if (workerId !== undefined && (!named || !ACTIVE_STATUSES.includes(named.status))) {
+                throw new ConductorError(`no worker ${workerId} in flight`);
+            }
+            const project = named ? projectNamed(store, named.project) : projectFor(store, item);
+            const { aliases, work } = project.profile.skills;
+            const heading = noteHeading(body, notePrefixes(project.profile));
+            if (heading === null) {
+                throw new ConductorError(`a note starts with its heading, such as "## ${work} · Progress"`, [
+                    `${project.name}'s work skill is ${work}${aliases.length > 0 ? ` (also read: ${aliases.join(', ')})` : ''}`,
+                ]);
+            }
+            const { kind, line, phase } = heading;
+            const key = item.toUpperCase();
+            const comment = await tracker.comment(key, body, project.profile);
+            // The phase is the item's worker's: the one named when it works this item, else the project's
+            // live worker on it (a probe works no item of its own).
+            const works = (w) => w.item.toUpperCase() === key;
+            const worker = named
+                ? works(named) ? named : null
+                : (store.listWorkers(ACTIVE_STATUSES).find((w) => !w.probe && w.project === project.name && works(w)) ?? null);
+            const result = { commentId: comment.id, item: key, phase, project: project.name, url: comment.url };
+            // The note is on the tracker now: a failure to record it must not read as "not posted".
+            try {
+                const recorded = store.transaction(() => {
+                    store.saveItemNote({ item: key, phase, project: project.name });
+                    const updated = worker ? store.updateWorker(worker.id, { phase }) : null;
+                    // The heading's kind and the note's commands and links, for the inbox.
+                    store.appendEvent({
+                        data: {
+                            commands: noteCommands(body),
+                            comment: comment.id,
+                            kind,
+                            line,
+                            links: noteLinks(body),
+                            phase,
+                            ...(phase === 'Plan' && planTier(body) !== null ? { tier: planTier(body) } : {}),
+                            url: comment.url,
+                            ...(updated ? { name: updated.name, worker: updated.id } : {}),
+                        },
+                        kind: 'note.posted',
+                        project: project.name,
+                        subject: key,
+                    });
+                    return updated;
+                });
+                return { ...result, worker: recorded };
+            }
+            catch (error) {
+                return { ...result, recordError: error instanceof Error ? error.message : String(error), worker: null };
+            }
+        },
+    };
+}
+const LOOKUP = 'query NoteIssue($id: String!) { issue(id: $id) { id } }';
+const CREATE = 'mutation Note($input: CommentCreateInput!) { commentCreate(input: $input) { success comment { id url } } }';
+const lookupAnswer = z.object({ issue: z.object({ id: z.string() }).nullable() });
+const createAnswer = z.object({
+    commentCreate: z.object({ comment: z.object({ id: z.string(), url: z.string().nullable().optional() }).nullable(), success: z.boolean() }),
+});
+// Linear: the issue's id from its identifier, then `commentCreate`. The key needs Create comments
+// as well as Read; a read-only key is refused, and nothing is posted.
+export function linearNotes(options = {}) {
+    const request = linearApi(options);
+    // `writes` marks the request that creates the comment: when its answer is lost, it may have
+    // landed. Only a refusal (or no key) says it didn't.
+    const ask = async (query, variables, writes) => {
+        try {
+            return await request(query, variables);
+        }
+        catch (error) {
+            if (!(error instanceof LinearRequestError))
+                throw error;
+            const sure = error.kind === 'no-key' || error.kind === 'refused';
+            throw new NotePostError(error.message, writes && !sure ? 'unknown' : 'no', error.details);
+        }
+    };
+    // An issue's id never changes, so each item is looked up once.
+    const ids = new Map();
+    return {
+        comment: async (item, text) => {
+            let id = ids.get(item);
+            if (id === undefined) {
+                const { issue } = lookupAnswer.parse(await ask(LOOKUP, { id: item }, false));
+                if (!issue)
+                    throw new NotePostError(`Linear has no issue ${item}`, 'no');
+                id = issue.id;
+                ids.set(item, id);
+            }
+            const created = createAnswer.safeParse(await ask(CREATE, { input: { body: text, issueId: id } }, true));
+            if (!created.success)
+                throw new NotePostError(`Linear's answer to the comment on ${item} didn't read`, 'unknown');
+            const { commentCreate } = created.data;
+            if (!commentCreate.success || !commentCreate.comment)
+                throw new NotePostError(`Linear didn't create the comment on ${item}`, 'no');
+            return { id: commentCreate.comment.id, url: commentCreate.comment.url ?? null };
+        },
+    };
+}
+// Fences whose lines are commands to run. An untagged or other block is output, a log or a diff.
+const SHELL_FENCES = new Set(['bash', 'cmd', 'console', 'powershell', 'ps1', 'pwsh', 'sh', 'shell']);
+// The exact commands a note hands over: the inline code on its heading (such as `npm stage approve
+// <id> --otp=<code>` on an npm-otp Handoff), and each line of its shell-tagged fenced code blocks.
+export function noteCommands(body) {
+    const lines = body.split(/\r?\n/);
+    const heading = lines.find((l) => l.trim() !== '') ?? '';
+    const commands = [...heading.matchAll(/`([^`]+)`/g)].map((m) => m[1]?.trim() ?? '');
+    // The open fence (``` or ~~~, three or more) and whether its block holds commands.
+    let fence = null;
+    for (const line of lines) {
+        const marker = /^\s*(`{3,}|~{3,})\s*([\w-]*)/.exec(line);
+        if (fence === null && marker?.[1])
+            fence = { marker: marker[1], shell: SHELL_FENCES.has((marker[2] ?? '').toLowerCase()) };
+        else if (fence !== null && marker?.[1]?.startsWith(fence.marker) && marker[2] === '')
+            fence = null;
+        else if (fence?.shell)
+            commands.push(line.trim());
+    }
+    return [...new Set(commands.filter((c) => c !== ''))];
+}
+// Every http(s) URL in a note, once each, without trailing punctuation.
+export function noteLinks(body) {
+    return [...new Set([...body.matchAll(/https?:\/\/[^\s<>()[\]`"']+/g)].map((m) => m[0].replace(/[.,;:!?*_]+$/, '')))];
+}
+// A Plan note's size tier, as work-issue writes it ("**Size tier: S.**", "Tier: M"), for the rules'
+// `plan.tier` and `item.tier`; null when it names none.
+export function planTier(body) {
+    return /\b(?:size\s+)?tier\b[*_\s:]*([SML])\b/i.exec(body)?.[1]?.toUpperCase() ?? null;
+}
+// The registered project whose tracker key is the item's key prefix (ATK-311 is team ATK).
+function projectFor(store, item) {
+    const team = item.split('-')[0]?.toUpperCase();
+    const found = store.listProjects().filter((p) => p.profile && trackerKey(p.profile).toUpperCase() === team);
+    const [only] = found;
+    if (found.length !== 1 || !only?.profile) {
+        throw new ConductorError(found.length === 0 ? `no registered project tracks ${item}` : `several projects track ${item}`, [
+            'pass --worker <worker> to name the worker it is for',
+        ]);
+    }
+    return { name: only.name, profile: only.profile };
+}
+function projectNamed(store, name) {
+    const found = store.listProjects().find((p) => p.name === name);
+    if (!found?.profile)
+        throw new ConductorError(`project "${name}" has a problem: ${found?.problem ?? 'not registered'}`);
+    return { name: found.name, profile: found.profile };
+}
+//# sourceMappingURL=notes.js.map

package/build/notes.js.map

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

package/build/notify.js

@@ -0,0 +1,422 @@
+import { z } from 'zod';
+import { parseLocalTime } from "./clock.js";
+import { BUILT_IN_PROFILES, CHANNELS, DAYS } from "./config.js";
+import { ConductorError } from "./errors.js";
+import { pushMessage } from "./inbox.js";
+import { NO_EXPIRY } from "./store.js";
+export const PROFILE_OVERRIDE = 'notify.profile';
+// An override's value that hands the profile back to config.json's `notify.profile`.
+const CONFIG_PROFILE = '';
+// A channel as the notifier last saw it work: Pushover by its own answers, Remote Control by what
+// the conductor mod reports back from PushNotification.
+export const channelStateSchema = z.object({
+    detail: z.string().nullable(),
+    since: z.string().nullable(),
+    // skipped: the last push wasn't sent to the phone on purpose (Jason was at the terminal).
+    state: z.enum(['failing', 'inactive', 'ok', 'skipped', 'unknown']),
+});
+// The states the conductor mod reports for a Remote Control push.
+export const REPORTED_STATES = ['failing', 'inactive', 'ok', 'skipped'];
+// GET /notify.
+export const notifyStatusSchema = z.object({
+    channels: z.object({ pushover: channelStateSchema, 'remote-control': channelStateSchema }),
+    // Held by quiet hours, waiting for the summary.
+    held: z.number(),
+    profile: z.string(),
+    profiles: z.array(z.string()),
+    // `conduct notify profile` set it, until this time (null: until replaced); null when it's config's.
+    profileSetBy: z.enum(['config', 'conduct notify profile']),
+    profileUntil: z.string().nullable(),
+    quietHours: z.object({ from: z.string(), to: z.string() }).nullable(),
+    quietNow: z.boolean(),
+});
+// POST /notify/test.
+export const testResultSchema = z.object({
+    channels: z.array(z.enum(CHANNELS)),
+    profile: z.string(),
+    quietNow: z.boolean(),
+    results: z.array(z.object({ channel: z.enum(CHANNELS), detail: z.string(), ok: z.boolean() })),
+});
+const raisedData = z.looseObject({ id: z.number() });
+// True when the local time falls in quiet hours, which may run past midnight.
+export function isQuiet(quietHours, at) {
+    return quietHours !== null && inRange(quietHours.from, quietHours.to, at);
+}
+// The notifier (design note, section 10): routes each new inbox item by the active profile's rules
+// to Remote Control (a `notify.requested` event the conductor mod pushes) and Pushover (sent from
+// here). Quiet hours hold pushes and send one summary when they end; a push of the same item, kind
+// and text within dedupeMinutes is skipped; an open item is reminded until it resolves.
+export function notifierService({ config, log, now = () => new Date(), pushover, store }) {
+    const { notify, quietHours } = config;
+    const profiles = { ...BUILT_IN_PROFILES, ...notify.profiles };
+    const channels = {
+        pushover: { detail: null, since: null, state: 'unknown' },
+        'remote-control': { detail: null, since: null, state: 'unknown' },
+    };
+    const inFlight = new Set();
+    let timer;
+    let ticking = null;
+    let lastProfile = null;
+    let stopped = false;
+    const track = (work) => {
+        inFlight.add(work);
+        void work.finally(() => inFlight.delete(work));
+        return work;
+    };
+    // Own names only: `constructor` or `toString` would otherwise pass as a profile.
+    const isProfile = (name) => Object.hasOwn(profiles, name);
+    const active = () => {
+        const override = store.liveOverride(PROFILE_OVERRIDE);
+        if (override && override.value !== CONFIG_PROFILE && isProfile(override.value)) {
+            return { name: override.value, setBy: 'conduct notify profile', until: override.until === NO_EXPIRY ? null : override.until };
+        }
+        return { name: notify.profile, setBy: 'config', until: null };
+    };
+    const route = (item, at) => {
+        const { name } = active();
+        const rules = isProfile(name) ? (profiles[name] ?? []) : [];
+        const index = rules.findIndex((r) => matches(r, item, at));
+        const rule = rules[index];
+        return rule ? { channels: unique(rule.to), remind: rule.remind ?? notify.remind, rule: index } : { channels: [], remind: notify.remind, rule: null };
+    };
+    const setChannel = (channel, state, detail) => {
+        const current = channels[channel];
+        if (current.state !== state) {
+            channels[channel] = { detail, since: now().toISOString(), state };
+            store.appendEvent({ data: { channel, detail, state }, kind: 'notify.channel' });
+        }
+        else {
+            current.detail = detail;
+        }
+        return channels[channel];
+    };
+    // One push on each channel. Remote Control is a request the conductor mod carries out; Pushover
+    // goes out from here, and its answer is the event.
+    const deliver = async (to, message, extra = {}) => Promise.all(to.map(async (channel) => {
+        const base = { channel, inbox: message.inbox, kind: message.kind, ...extra };
+        if (channel === 'remote-control') {
+            store.appendEvent({ data: { ...base, message: message.text }, kind: 'notify.requested', project: message.project, subject: message.item });
+            return { channel, result: { ok: true } };
+        }
+        const result = await track(pushover({
+            message: [message.text, ...message.commands.map((c) => `$ ${c}`)].join('\n'),
+            priority: notify.pushover.priority,
+            title: message.title,
+            ...(message.link ? { url: message.link, urlTitle: 'open' } : {}),
+        }));
+        if (result.ok) {
+            setChannel(channel, 'ok', null);
+            store.appendEvent({ data: base, kind: 'notify.sent', project: message.project, subject: message.item });
+        }
+        else {
+            setChannel(channel, 'failing', result.error);
+            log.log('warn', 'a Pushover push failed', { error: result.error, inbox: message.inbox });
+            store.appendEvent({ data: { ...base, error: result.error }, kind: 'notify.failed', project: message.project, subject: message.item });
+        }
+        return { channel, result };
+    }));
+    const onRaised = async (event) => {
+        const data = raisedData.safeParse(event.data);
+        if (!data.success)
+            return;
+        const item = store.getInbox(data.data.id);
+        if (!item || store.getNotifyState(item.id))
+            return;
+        const at = now();
+        const routed = route(item, at);
+        const state = {
+            channels: routed.channels,
+            dedupeKey: JSON.stringify([item.project, item.item?.toUpperCase() ?? null, item.kind, item.text]),
+            heldAt: null,
+            inbox: item.id,
+            lastSentAt: null,
+            remindAfterMinutes: routed.remind.afterMinutes,
+            remindTimes: routed.remind.times,
+            sends: 0,
+        };
+        const earlier = notify.dedupeMinutes > 0 ? store.lastNotified(state.dedupeKey, new Date(at.getTime() - notify.dedupeMinutes * 60_000).toISOString()) : null;
+        // An earlier push stands for this one only where it went: after a switch to away, the same ask
+        // still goes to Pushover.
+        const prior = earlier && routed.channels.every((c) => earlier.channels.includes(c)) ? earlier : null;
+        const outcome = routed.channels.length === 0 ? 'none'
+            : isQuiet(quietHours, at) ? 'held'
+                : prior ? 'deduped'
+                    : 'sent';
+        if (outcome === 'held')
+            state.heldAt = at.toISOString();
+        if (outcome === 'held' || outcome === 'sent') {
+            // An older copy that never reached the phone (held for the summary, or a first push that
+            // failed) gives way to this one, so the ask is summarized or tried again once.
+            for (const older of store.liveNotifyStates()) {
+                const unsent = older.heldAt !== null || (older.sends === 0 && older.lastSentAt !== null);
+                if (older.dedupeKey === state.dedupeKey && unsent)
+                    store.saveNotifyState({ ...older, channels: [], heldAt: null });
+            }
+        }
+        if (outcome === 'deduped' && prior) {
+            // The earlier push stands for this one, and its reminders carry on here alone: the earlier
+            // item, if still open, would otherwise remind too, each reminder arriving twice.
+            state.sends = prior.sends;
+            state.lastSentAt = prior.lastSentAt;
+            store.saveNotifyState({ ...prior, channels: [] });
+        }
+        if (outcome === 'sent') {
+            state.sends = 1;
+            state.lastSentAt = at.toISOString();
+        }
+        store.saveNotifyState(state);
+        store.appendEvent({
+            data: { channels: routed.channels, inbox: item.id, outcome, profile: active().name, rule: routed.rule, ...(prior && outcome === 'deduped' ? { dedupedOf: prior.inbox } : {}) },
+            kind: 'notify.routed',
+            project: item.project,
+            subject: item.item,
+        });
+        if (outcome !== 'sent')
+            return;
+        const results = await deliver(routed.channels, messageOf(item));
+        // Nothing arrived: it isn't a push to dedupe against, and the reminder pass tries it again.
+        if (results.every((r) => !r.result.ok))
+            store.saveNotifyState({ ...state, sends: 0 });
+    };
+    // Quiet hours are over: one push per channel naming the held items still open, which are then
+    // reminded as if pushed now.
+    const summarize = async (held, at) => {
+        const byChannel = new Map();
+        let resolved = 0;
+        for (const state of held) {
+            const item = store.getInbox(state.inbox);
+            if (!item || item.resolvedAt !== null) {
+                resolved++;
+                store.saveNotifyState({ ...state, heldAt: null });
+                continue;
+            }
+            const routed = route(item, at);
+            for (const channel of routed.channels)
+                byChannel.set(channel, [...(byChannel.get(channel) ?? []), item]);
+            store.saveNotifyState({
+                ...state,
+                channels: routed.channels,
+                heldAt: null,
+                lastSentAt: routed.channels.length > 0 ? at.toISOString() : state.lastSentAt,
+                remindAfterMinutes: routed.remind.afterMinutes,
+                remindTimes: routed.remind.times,
+                sends: routed.channels.length > 0 ? 1 : state.sends,
+            });
+        }
+        await Promise.all([...byChannel.entries()].map(([channel, items]) => {
+            const text = summaryText(items, resolved);
+            return deliver([channel], { commands: [], inbox: null, item: null, kind: 'summary', link: null, project: null, text, title: 'conductor · since quiet hours' }, { held: items.map((i) => i.id), resolved });
+        }));
+    };
+    // Reminders, on the channels the profile in force now gives the item. A first push that reached
+    // no channel (sends 0) is tried again at the same interval, without using up a reminder.
+    const remind = async (states, at) => {
+        for (const state of states) {
+            if (state.heldAt !== null || state.lastSentAt === null || state.channels.length === 0)
+                continue;
+            const retry = state.sends === 0;
+            const reminder = state.sends; // the first push is send 1, so reminder n follows send n
+            if (!retry && reminder > state.remindTimes)
+                continue;
+            if (at.getTime() - Date.parse(state.lastSentAt) < state.remindAfterMinutes * 60_000)
+                continue;
+            const item = store.getInbox(state.inbox);
+            if (!item || item.resolvedAt !== null)
+                continue;
+            const to = route(item, at).channels;
+            if (to.length === 0)
+                continue;
+            const message = messageOf(item);
+            const prefix = `reminder ${reminder}/${state.remindTimes}: `;
+            const results = await deliver(to, retry ? message : { ...message, text: pushMessage({ item: item.item, text: `${prefix}${item.text}` }), title: `${prefix}${message.title}` }, retry ? { retry: true } : { reminder });
+            const arrived = results.some((r) => r.result.ok);
+            store.saveNotifyState({ ...state, channels: to, lastSentAt: at.toISOString(), sends: retry && !arrived ? 0 : state.sends + 1 });
+        }
+    };
+    const tick = async () => {
+        const at = now();
+        const profile = active();
+        if (lastProfile !== null && lastProfile !== profile.name) {
+            store.appendEvent({ data: { from: lastProfile, profile: profile.name, reason: 'the timed profile ran out' }, kind: 'notify.profile' });
+        }
+        lastProfile = profile.name;
+        if (isQuiet(quietHours, at))
+            return;
+        const live = store.liveNotifyStates();
+        const held = live.filter((s) => s.heldAt !== null);
+        if (held.length > 0)
+            await summarize(held, at);
+        await remind(live.filter((s) => s.heldAt === null), at);
+    };
+    const status = () => {
+        const profile = active();
+        return {
+            channels: { pushover: { ...channels.pushover }, 'remote-control': { ...channels['remote-control'] } },
+            held: store.liveNotifyStates().filter((s) => s.heldAt !== null).length,
+            profile: profile.name,
+            profiles: Object.keys(profiles).sort(),
+            profileSetBy: profile.setBy,
+            profileUntil: profile.until,
+            quietHours,
+            quietNow: isQuiet(quietHours, now()),
+        };
+    };
+    return {
+        announce: async (to, { item, project, text }, by) => {
+            if (isQuiet(quietHours, now()))
+                return 'quiet hours';
+            const channels = typeof to === 'string' ? [to] : route({ kind: to.kind, project }, now()).channels;
+            if (channels.length === 0)
+                return 'its profile sends it nowhere';
+            const results = await deliver(channels, { commands: [], inbox: null, item, kind: 'rule', link: null, project, text: pushMessage({ item, text }), title: `conductor · ${item ?? 'rule'}` }, { by });
+            return deliveryProblem(results);
+        },
+        // Nothing after stop: the store closes behind it.
+        observe: (event) => (event.kind === 'inbox.raised' && !stopped ? track(onRaised(event)) : Promise.resolve()),
+        remindNow: async (id, by) => {
+            const item = store.getInbox(id);
+            if (!item || item.resolvedAt !== null)
+                return 'the inbox item is resolved';
+            if (isQuiet(quietHours, now()))
+                return 'quiet hours';
+            const to = route(item, now()).channels;
+            if (to.length === 0)
+                return 'its profile sends it nowhere';
+            const message = messageOf(item);
+            const results = await deliver(to, { ...message, text: pushMessage({ item: item.item, text: `reminder: ${item.text}` }), title: `reminder: ${message.title}` }, { by, reminder: 'rule' });
+            return deliveryProblem(results);
+        },
+        report: (channel, result, state) => {
+            // PushNotification says "Mobile push not sent (Remote Control inactive)" when no phone is connected.
+            const seen = state ?? (/remote control inactive/i.test(result) ? 'inactive' : 'ok');
+            return setChannel(channel, seen, seen === 'ok' ? null : result);
+        },
+        setProfile: (name, until, by = 'conduct notify profile') => {
+            if (!isProfile(name)) {
+                throw new ConductorError(`no notification profile "${name}"`, [`profiles: ${Object.keys(profiles).sort().join(', ')}`]);
+            }
+            if (until !== null && until.getTime() <= now().getTime())
+                throw new ConductorError(`--until ${until.toISOString()} is in the past`);
+            const from = active().name;
+            // Config's own profile with no end hands the choice back to config.json.
+            const value = until === null && name === notify.profile ? CONFIG_PROFILE : name;
+            store.setOverride({ kind: PROFILE_OVERRIDE, project: null, setBy: by, until: until?.toISOString() ?? NO_EXPIRY, value });
+            lastProfile = name;
+            store.appendEvent({ data: { by, from, profile: name, until: until?.toISOString() ?? null }, kind: 'notify.profile', rule: by });
+            return status();
+        },
+        start: () => {
+            lastProfile = active().name;
+            timer = setInterval(() => {
+                if (ticking)
+                    return;
+                ticking = track(tick()
+                    .catch((error) => log.log('error', 'the notifier tick failed', { error: String(error) }))
+                    .finally(() => (ticking = null)));
+            }, notify.tickSeconds * 1000);
+            timer.unref();
+        },
+        status,
+        stop: async () => {
+            stopped = true;
+            clearInterval(timer);
+            await Promise.allSettled([...inFlight]);
+        },
+        test: async (kind, channel) => {
+            const at = now();
+            const sample = { kind, project: null };
+            const to = channel ? [channel] : route(sample, at).channels;
+            const text = `test: a sample ${kind} item (conduct notify test)`;
+            const sent = await deliver(to, { commands: [], inbox: null, item: null, kind, link: null, project: null, text, title: `conductor · test ${kind}` }, { test: true });
+            return {
+                channels: to,
+                profile: active().name,
+                quietNow: isQuiet(quietHours, at),
+                results: sent.map(({ channel: c, result }) => ({
+                    channel: c,
+                    detail: result.ok ? (c === 'remote-control' ? 'requested: the conductor mod in the console pushes it' : 'sent') : result.error,
+                    ok: result.ok,
+                })),
+            };
+        },
+        tick,
+    };
+}
+// `conduct notify`: the profile, quiet hours and each channel's state.
+export function notifyLines(status) {
+    const until = status.profileUntil === null ? '' : ` until ${new Date(status.profileUntil).toLocaleString()}`;
+    const quiet = status.quietHours === null ? 'none' : `${status.quietHours.from}-${status.quietHours.to}${status.quietNow ? ' (now)' : ''}`;
+    const channel = (name) => {
+        const c = status.channels[name];
+        const since = c.since === null ? '' : ` since ${new Date(c.since).toLocaleString()}`;
+        return `  ${name}: ${c.state}${since}${c.detail ? ` (${c.detail})` : ''}`;
+    };
+    return [
+        `profile: ${status.profile}${until} (set by ${status.profileSetBy}; profiles: ${status.profiles.join(', ')})`,
+        `quiet hours: ${quiet}${status.held > 0 ? `; ${status.held} held for the summary` : ''}`,
+        'channels:',
+        channel('remote-control'),
+        channel('pushover'),
+    ];
+}
+// `conduct notify profile … --until`: a local time of day (the next one), or a date and time.
+export function parseUntil(text, now) {
+    const at = parseLocalTime(text, now);
+    if (!at) {
+        throw new ConductorError(`--until "${text}" is not a time`, ['a local time such as 17:00 (the next one), or a date and time such as 2026-10-12T09:00']);
+    }
+    return at;
+}
+// A rule's push as one line: null when every channel took it, else which didn't.
+function deliveryProblem(results) {
+    const failed = results.filter((r) => !r.result.ok).map((r) => r.channel);
+    if (failed.length === 0)
+        return null;
+    return failed.length === results.length ? 'the push failed' : `pushed, but not on ${failed.join(', ')}`;
+}
+function inRange(from, to, at) {
+    const minute = at.getHours() * 60 + at.getMinutes();
+    const start = minutesOf(from);
+    const end = minutesOf(to);
+    return start < end ? minute >= start && minute < end : minute >= start || minute < end;
+}
+function matches(rule, item, at) {
+    if (rule.kinds && !rule.kinds.includes(item.kind))
+        return false;
+    if (rule.projects && (item.project === null || !rule.projects.includes(item.project)))
+        return false;
+    if (rule.days && !rule.days.includes(DAYS[at.getDay()] ?? 'sun'))
+        return false;
+    if (rule.hours) {
+        const [from = '', to = ''] = rule.hours.split('-');
+        if (!inRange(from, to, at))
+            return false;
+    }
+    return true;
+}
+function messageOf(item) {
+    return {
+        commands: item.commands,
+        inbox: item.id,
+        item: item.item,
+        kind: item.kind,
+        link: item.links[0] ?? null,
+        project: item.project,
+        text: pushMessage(item),
+        title: `conductor · ${[item.item, item.kind].filter((x) => x !== null).join(' ')}`,
+    };
+}
+function minutesOf(clock) {
+    const [hours = 0, minutes = 0] = clock.split(':').map(Number);
+    return hours * 60 + minutes;
+}
+// "3 waiting since quiet hours: ATK-1 plan, ATK-2 npm-otp, #7 failed; 1 resolved meanwhile".
+function summaryText(items, resolved) {
+    const names = items.map((i) => `${i.item ?? `#${i.id}`} ${i.kind}`).join(', ');
+    const text = `${items.length} waiting since quiet hours: ${names}${resolved > 0 ? `; ${resolved} resolved meanwhile` : ''}`;
+    return pushMessage({ item: null, text });
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=notify.js.map