tools/watchdog-notice.mjs is a one-shot reader. It reads Idunn's incident store unlocked with SingleFileMessagePackBackingStore.pullAll, sends one opening and one closing DM per incident through bifrost-bridge.mjs, and keeps a bifrost.watchdog_notice_execution.v1 journal: a running entry becomes unknown and is never re-posted, a failed one is retried with the same nonce up to five times, terminal entries are pruned once Idunn retires the incident. The exit status is the delivery-failure signal. discord-dm accepts --nonce (at most 25 chars) and sends nonce with enforce_nonce so a retry inside Discord's window returns the original message. The tests run the CLI against the store bytes Idunn wrote (fixture from GameCult/Idunn 7f7528b3) with a counting bridge double, and once through the real bridge with fetch stubbed. docs/watchdog-notice.md states the CultLib >= 8cb3b728 floor. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2 KiB
2 KiB
Watchdog notice reader
tools/watchdog-notice.mjs is a one-shot reader. It turns Idunn's operator
incidents into Discord DMs to the owner. Run it from a timer.
node tools/watchdog-notice.mjs process --incident-store P --journal-store J --receipt-store R [--bridge-cli B]
node tools/watchdog-notice.mjs status --journal-store J
Requirements
- CultLib at
8cb3b728or later. The reader loads@gamecult/cultcache-ts, the name CultLib gave the package in8cb3b728(2026-09-04), from$VOIDBOT_CULTLIB_ROOTor the sibling../CultLib. An older CultLib fails at import withMODULE_NOT_FOUND; the reader reportscultlib-unavailable. The same floor applies to every Bifrost tool that loads CultCache (tools/persona-feedback.mjsand the others). A deployment pairs a Bifrost release with a CultLib commit at or after this one. DISCORD_OWNER_IDin the environment: the only source of the recipient. The reader exits non-zero before writing the journal if it is missing.BIFROST_DISCORD_BOT_TOKENin the environment, read only bybifrost-bridge.mjs, which the reader spawns.
Behaviour
- P is Idunn's
idunn.operator_incident.v1store. The reader reads it without a lock and never writes it. An absent P is a clean no-op. - One notice when an incident opens and one when it closes, each at most once. The closing notice is sent only after the opening notice completed.
- J is Bifrost's journal,
bifrost.watchdog_notice_execution.v1, keyed<incident_key>#openedor<incident_key>#closed. Arunningentry found at start becomesunknownand is never sent again. Afailedentry is retried on later runs with the same nonce, up to five attempts. Terminal entries are deleted once Idunn no longer lists the incident. - The exit status is non-zero while any entry is
unknownor out of attempts, or while P holds a record of this schema that breaks its contract. systemd shows that;statuslists the entries. - Notice text is built from
condition,subjectand ISO UTC times only.