TASK-144646: Documentation for new curfew module (SparkPost/Momentum#…#845
Open
dkoerichbird wants to merge 6 commits into
Open
TASK-144646: Documentation for new curfew module (SparkPost/Momentum#…#845dkoerichbird wants to merge 6 commits into
dkoerichbird wants to merge 6 commits into
Conversation
…1228) Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
✅ Deploy Preview for support-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
deepakpn
requested changes
May 21, 2026
…parkPost/Momentum#1228) Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
balupillai
reviewed
Jun 2, 2026
|
|
||
| The `curfew` module schedules *quiet hours* (blackout windows) during which Momentum will not attempt deliveries for selected bindings, binding groups, or domains. The schedule is expressed in crontab-style syntax and is read from a plain-text file. | ||
|
|
||
| Curfew replaces *ad-hoc* operator workflows that toggle [`suspend_delivery`](/momentum/4/config/ref-suspend-delivery), e.g., from external cron jobs. Driving suspension state from outside the MTA is fragile: a missed cron firing can leave messages stuck on the spool, and a race between the cron job and a configuration commit can leave the binding suspended forever. Curfew evaluates its rules from inside the suspension decision path on every delivery attempt, so quiet hours engage and lift on schedule without operator intervention and without persistent state changes to the binding/domain scope. |
There was a problem hiding this comment.
Is the above para needed. We implemented curfew as a external cron jobs, using suspension. This is a new feature for customer.
Contributor
Author
There was a problem hiding this comment.
Reworded, please take a second look. Yeah, that would be a new feature for on-prem customers.
…#1228) Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
…1228)
Note
Low Risk
Documentation-only changes with no runtime or configuration behavior in this repo.
Overview
Adds documentation for the Momentum 5.3
curfewmodule (I-1228): scheduled quiet hours that suspend outbound delivery for chosen bindings, binding groups, or domains via a crontab-style schedule file, as an alternative to togglingsuspend_deliveryfrom cron.A new
curfew.mdpage covers configuration (Schedule_File,Timezone,Fuzz_Seconds), schedule file syntax, precedence vs static suspension / Lua / adaptive, logging, and console commands (reload,show,status,fuzz,journal). Index pages are updated: console-commands table, config-options summary (curfewscope and related options), modules index, all-modules summary, and the 5.3.0 changelog entry.Reviewed by Cursor Bugbot for commit 2facc24. Bugbot is set up for automated code reviews on this repo. Configure here.