Cursor rule

1---
2description:
3globs:
4alwaysApply: false
5---
6---
7name: Moodle Scheduled Tasks and Background Processing
8---
9 
10# Moodle Scheduled Tasks and Background Processing
11 
12## Purpose
13Ensure long-running and periodic operations are handled using Moodle's scheduled_task API.
14 
15## Instructions
16- Define scheduled tasks in `db/tasks.php`
17- Extend `core\task\scheduled_task` for custom tasks
18- Use `adhoc_task` for one-off background jobs
19- Document task frequency and purpose
20- Use locking to prevent concurrent execution
21- Log task execution and errors
22- Test tasks in both CLI and web environments
23 
24## Examples
25```php
26// File: ./db/tasks.php
27$tasks = [
28    [
29        'classname' => '\mod_myplugin\task\sync',
30        'blocking'  => 0,
31        'minute'    => 'R',
32        'hour'      => '*',
33        'day'       => '*',
34        'month'     => '*',
35        'dayofweek' => '*',
36    ],
37];
38```
39 
40## Exceptions
41- Short operations may use synchronous execution
42