The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jun 20, 2026 5:57am

PR Summary

Medium Risk
Changes how user-selected recurrence compiles to cron (including monthly #/#L and yearly), which directly affects when tasks run; scope is localized and covered by new unit tests, with no backend contract changes.

Overview
Expands the scheduled-task recurrence picker with calendar-style options while still compiling to the same stored cron strings (no API or backend scheduler changes).

UI (RecurrenceSection): Adds a Yearly frequency, per-day Chip toggles for weekly repeat (any weekday mix, with at least one day kept), and a monthly “On” dropdown for day-of-month vs nth-weekday vs last-weekday anchors derived from the launch date. Frequency labels are simplified (e.g. “Weekly” / “Monthly” instead of embedding the launch day in the label).

Recurrence model (recurrence.ts): Introduces MonthlyMode and optional monthlyMode on Recurrence, plus yearly in RecurrenceFrequency. recurrenceToCron emits croner # / #L for monthly weekday rules (clamping a 5th-occurrence nth choice to #L), and fixed month/day for yearly. cronToRecurrence round-trips those patterns (including Sunday as 7), treats #5 as custom to avoid rewriting month-skipping crons, and recognizes yearly crons.

Display: parseCronToHumanReadable normalizes croner's #L to cronstrue's L for labels only.

Tests cover cron build/parse, occurrence expansion for 1#3, and human-readable output for nth/last weekday.

^{Reviewed by Cursor Bugbot for commit 9859dfa. Configure here.}

@greptile

@cursor review

Greptile Summary

This PR extends the scheduled-task recurrence modal to match a Google Calendar-style recurrence picker: weekly multi-day selection via day-toggle chips, monthly nth/last-weekday anchoring, and a new yearly frequency. All changes are front-end only — the UI compiles to a cron string that croner already understands, so no backend schema or API changes are needed.

• New weekly UI: replaces the fixed "Weekly on Mon" label with a row of toggleable day chips; at least one day is always kept selected.
• New monthly modes: nth-weekday (e.g. "third Tuesday") and last-weekday alongside the existing day-of-month option; the ordinal anchor is only offered for the 1st–4th occurrence to avoid months being silently skipped, with a belt-and-suspenders clamp in recurrenceToCron for dates that drift to a 5th occurrence via the date picker.
• New yearly frequency: emits a 5-field cron with month and day-of-month fixed; parseCronToHumanReadable normalizes croner's #L to cronstrue's L so "last Monday" displays correctly.

Confidence Score: 5/5

Safe to merge — all changes are front-end only, compile to cron strings the existing backend already understands, and are well-covered by new unit and integration tests.

The recurrence logic is self-contained: it generates and parses cron strings without touching any schema, API route, or scheduling engine. The 5th-occurrence clamp, the #L display normalization, and the round-trip for alternate Sunday digit (7) are all verified by dedicated tests. The one asymmetry — the weekly comma-separated parser still uses [0-6] while the new # parsers use [0-7] — only affects externally-authored Sunday crons in the weekly path and doesn't corrupt any stored data.

recurrence.ts — the weekly cronToRecurrence branch regex.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User opens Recurrence Section] --> B{Frequency dropdown}
    B -->|daily| C[emit: MIN HOUR * * *]
    B -->|weekdays| D[emit: MIN HOUR * * 1,2,3,4,5]
    B -->|weekly| E[Day-toggle chips]
    E --> F[emit: MIN HOUR * * days]
    B -->|monthly| G[Monthly mode dropdown]
    G -->|day-of-month| H[emit: MIN HOUR DOM * *]
    G -->|nth-weekday ordinal <= 4| I{5th occurrence?}
    I -->|No| J[emit: MIN HOUR * * WD#N]
    I -->|Yes - clamp| K[emit: MIN HOUR * * WD#L]
    G -->|last-weekday| K
    B -->|yearly| L[emit: MIN HOUR DOM MON *]
    B -->|custom| M[pass through raw cron]
    N[parseCronToHumanReadable] -->|normalize WD#L to WDL| O[cronstrue display]
    J --> N
    K --> N

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[User opens Recurrence Section] --> B{Frequency dropdown}
    B -->|daily| C[emit: MIN HOUR * * *]
    B -->|weekdays| D[emit: MIN HOUR * * 1,2,3,4,5]
    B -->|weekly| E[Day-toggle chips]
    E --> F[emit: MIN HOUR * * days]
    B -->|monthly| G[Monthly mode dropdown]
    G -->|day-of-month| H[emit: MIN HOUR DOM * *]
    G -->|nth-weekday ordinal <= 4| I{5th occurrence?}
    I -->|No| J[emit: MIN HOUR * * WD#N]
    I -->|Yes - clamp| K[emit: MIN HOUR * * WD#L]
    G -->|last-weekday| K
    B -->|yearly| L[emit: MIN HOUR DOM MON *]
    B -->|custom| M[pass through raw cron]
    N[parseCronToHumanReadable] -->|normalize WD#L to WDL| O[cronstrue display]
    J --> N
    K --> N

_{Reviews (3): Last reviewed commit: "fix(scheduled-tasks): fold 5th-occurrenc..." | Re-trigger Greptile}

@greptile

@cursor review