Skip to content

docs(email-reports): Cloudflare's cron weekday is offset by one - #23

Open
lamminpaa wants to merge 1 commit into
mainfrom
docs/cloudflare-cron-weekday-offset
Open

docs(email-reports): Cloudflare's cron weekday is offset by one#23
lamminpaa wants to merge 1 commit into
mainfrom
docs/cloudflare-cron-weekday-offset

Conversation

@lamminpaa

Copy link
Copy Markdown
Contributor

The example config told readers 0 8 * * 1 means "every Monday at 8:00 UTC". On Cloudflare it fires on Sunday.

How this was established

Not inferred from documentation — measured three ways.

Evidence Result
flarelytics-reports deployment history last deployed 2026-03-30 before today, so the expression has been unchanged throughout
Six reports, 2026-07-19 → 2026-08-23 every one landed Sunday 08:00 UTC
The sending API's own log shows the Sunday 23.8. send, and no send on Monday 24.8. — and its window covers 21.8. 12:37 → 24.8. 09:52, so a Monday run would have appeared
A sibling repo's GitHub Actions workflow, identical 0 4 * * 1 runs Mondays, five consecutive scheduled runs

Same expression, same field, different day. The difference is the scheduler.

So: 1 = Sunday on Cloudflare, 2 = Monday.

What this changes

Only the comment. The schedule stays 0 8 * * 1, because which day the report arrives is a product decision and it has been arriving on Sundays for months — silently matching nobody's stated intent, but matching the actual habit of anyone who reads it.

If Monday is wanted, that is a one-character change to 0 8 * * 2, worth making deliberately rather than folding into a docs fix.

🤖 Generated with Claude Code

https://claude.ai/code/session_01X8eThbPu42vk7AcFstqaRB

The example config told readers `0 8 * * 1` means "every Monday at 8:00 UTC".
On Cloudflare it fires on Sunday.

Established rather than assumed. flarelytics-reports has run this exact
expression since its last deploy on 2026-03-30, and all six reports between
2026-07-19 and 2026-08-23 landed on a Sunday at 08:00 UTC — confirmed
independently by the sending API's own log, which also shows no send on
Monday 2026-08-24 despite covering that morning. A GitHub Actions workflow
in a sibling repo using the identical `0 4 * * 1` runs on Mondays, so the
difference is the scheduler, not the expression.

The schedule itself is untouched: which day the report arrives is a product
decision, and it has been arriving on Sundays for months.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant