v1.4 backfill-to-today algorithm, 12-card cap, idempotent spawns; drop dual-path

README.md

@@ -31,15 +31,24 @@ The engine runs from the CLI command `recoreco:run`. Add it to cron **four times
 ```
 
 (Point the path at your install and run it as the user that owns Kanboard's data.) Each run looks
-ahead 12 hours; the runs overlap by 6 hours, so a single missed run is covered by the next one, and
-any occurrence whose time is already past is still caught up. `days before` shifts a copy earlier
-within that lead. You can also run it by hand any time: `php cli recoreco:run`.
+ahead 12 hours; the runs overlap by 6 hours, so a single missed run is covered by the next one.
+
+Each run walks a template forward from its current due date and spawns **every** occurrence whose
+fire time has arrived -- so occurrences already in the past are backfilled, not skipped. To avoid
+flooding the board when a template was set far in the past, a single run spawns at most the **12
+most recent** due occurrences; any older overflow is skipped (contiguous, no gap) and the template
+advances straight to the next future occurrence. `days before` shifts a copy earlier within the
+lead. Runs are idempotent: an occurrence is never spawned twice, so running an extra time is safe.
+
+You can trigger the exact same pass by hand -- either on the CLI (`php cli recoreco:run`) or with
+the **Run now** button under **Settings -> RecoReco** (admin only). The button and cron do the
+identical thing.
 
 ## Status
 
-Working for **monthly by day** (with the last-day rule), driven by cron. The remaining frequencies
-(yearly, weekly, daily, monthly by weekday), the recurrence icons, and the FinanceBuddy
-installment hand-off arrive in the following versions.
+All five frequencies work (yearly, monthly by day, monthly by weekday, weekly, daily) with the
+last-day rule, board recurrence icons, backfill with the 12-occurrence cap, the Run-now button, and
+the FinanceBuddy installment hand-off.
 
 ## Requirements