Add documentation for mautic:campaigns:resume-stuck command

[rohitpavaskar]

Description

Document the new command that resumes execution for contacts stuck in campaign workflows. This command helps recover contacts that got stuck due to exceptions, server issues, or events added after contacts had already progressed past that point.

Related to: mautic/mautic#15310

Linked issue

mautic/mautic#15310

Screenshots or screen recordings

[escopecz]

@adiati98 we should probably create the 7.2 branch for these PR, right?

@rohitpavaskar shall we suggest users to also configure this command to run periodically as a cron job? Or only in special cases?

[adiati98]

@escopecz if this aims 7.2, we can create the branch. Would it be based on 7.1 or 7.0?

[escopecz]

It should be based on 7.1

[adiati98]

@escopecz noted. Can we hold on a bit? I'll try to review and merge as much PRs as we can for branch 7.1 before creating 7.2.

[escopecz]

Sure thing!

[rohitpavaskar]

ommand to run periodically as a cron j

Yes, This needs to be set as cron job but separate job for each campaign.

[promptless-for-oss]

Thanks for documenting the new mautic:campaigns:resume-stuck command! The documentation is comprehensive and well-structured.

I noticed two numerical values that don't match the source code and should be corrected:

1. Batch limit default: The docs currently say "Defaults to 1000" but the source code shows the default is 100.

2. Max records per execution: The docs say "5000 records" but the source code shows MAX_ALLOWED_RECORDS_EACH_PROCESS = 500.

---

🤖 Review by Promptless

[adiati98]

@rohitpavaskar can you please check if the review from Promptless here is correct? TIA! ✨

#709 (comment)

[adiati98]

@promptless-for-oss please rebase to 7.2 branch

[adiati98]

It seems like Promptless can't rebase this as it's not opened by it.

@rohitpavaskar as we now have 7.2 branch, can you please rebase this to 7.2? TIA! ✨