db->table('task_has_metadata') ->eq('name', 'recoreco_enabled') ->eq('value', '1') ->findAllByColumn('task_id'); foreach ($task_ids as $task_id) { $spawned += $this->processTemplate((int) $task_id, $now); } return $spawned; } public function processTemplate($task_id, $now) { $task = $this->taskFinderModel->getById($task_id); if (empty($task)) { return 0; } // Native wins: if the card became native-recurring, RecoReco yields (decision 13). if ($task['recurrence_status'] != TaskModel::RECURRING_STATUS_NONE) { $this->taskMetadataModel->save($task_id, array('recoreco_enabled' => 0)); $this->logger->info('RecoReco: disabled on task '.$task_id.' (now native-recurring)'); return 0; } $meta = $this->taskMetadataModel->getAll($task_id); $frequency = isset($meta['recoreco_frequency']) ? $meta['recoreco_frequency'] : ''; // v0.3 handles monthly-by-day only; the rest arrive in v1.1. if ($frequency !== 'monthly_day') { return 0; } $anchor = isset($meta['recoreco_anchor']) ? (int) $meta['recoreco_anchor'] : 0; if ($anchor <= 0) { return 0; } $lastDay = isset($meta['recoreco_last_day']) && $meta['recoreco_last_day'] == 1; $daysBefore = isset($meta['recoreco_days_before']) ? (int) $meta['recoreco_days_before'] : 0; $targetColumn = isset($meta['recoreco_target_column']) ? (int) $meta['recoreco_target_column'] : (int) $task['column_id']; // Default off: only keep the duplicate link when explicitly turned on. $linkCopies = isset($meta['recoreco_link_copies']) && $meta['recoreco_link_copies'] == 1; $cursor = (int) $task['date_due']; $synced = isset($meta['recoreco_synced_due']) ? (int) $meta['recoreco_synced_due'] : null; if ($synced === null) { // First run after enabling: place the cursor on the first occurrence. $cursor = $this->firstCursor($anchor, $frequency, $lastDay, $now); $this->setDue($task_id, $cursor); } elseif ($cursor !== $synced) { // The user hand-edited the due date -> re-anchor to it (a reschedule). $anchor = $cursor; $this->taskMetadataModel->save($task_id, array('recoreco_anchor' => $anchor)); $this->setDue($task_id, $cursor); } // Fire every occurrence whose fire time has arrived, advancing the cursor each time. $spawned = 0; $fireTime = $cursor - $daysBefore * 86400; while ($fireTime <= $now && $spawned < self::CATCHUP_CAP) { $this->spawn($task, $targetColumn, $linkCopies); $next = $this->calculator()->occurrenceFrom($anchor, $frequency, $lastDay, $cursor, false); if ($next === null || $next <= $cursor) { break; } $cursor = $next; $this->setDue($task_id, $cursor); $fireTime = $cursor - $daysBefore * 86400; $spawned++; } return $spawned; } /** * The first occurrence: respect an explicitly future anchor (the due date the user set) as the * first one; otherwise jump to the next occurrence on/after now. */ private function firstCursor($anchor, $frequency, $lastDay, $now) { if ($anchor >= $now) { return $anchor; } return $this->calculator()->occurrenceFrom($anchor, $frequency, $lastDay, $now, true); } private function setDue($task_id, $cursor) { // Advance the template's due date directly (no task events) + mirror it for edit detection. $this->db->table(TaskModel::TABLE)->eq('id', $task_id)->update(array('date_due' => $cursor)); $this->taskMetadataModel->save($task_id, array('recoreco_synced_due' => $cursor)); } private function spawn(array $template, $targetColumn, $linkCopies) { // The template's date_due is already the occurrence (setDue), so duplicate() copies it onto // the clone. duplicate() copies fields + tags + links + subtasks, but NO metadata, so the // clone is not a template. $newId = $this->taskDuplicationModel->duplicate($template['id']); if ($newId === false) { $this->logger->error('RecoReco: duplicate failed for task '.$template['id']); return false; } // duplicate() lands the clone in the source column; move it to the chosen target (top). if ($targetColumn > 0 && $targetColumn != $template['column_id']) { $this->taskPositionModel->movePosition($template['project_id'], $newId, $targetColumn, 1, $template['swimlane_id']); } // Reset the "[DUPLICATE]" prefix back to the source title (no events). $this->taskModificationModel->update(array('id' => $newId, 'title' => $template['title']), false); // Kanboard's duplicate() adds an "is a duplicate of" task link between the template and the // clone. Kept when recoreco_link_copies is on (a running count + one-click navigation to // each copy); stripped when off (the default), to avoid piling up links on frequent // schedules. getAll() returns the opposite task as $link['task_id'] and the row id as 'id'. if (! $linkCopies) { foreach ($this->taskLinkModel->getAll($newId) as $link) { if ((int) $link['task_id'] === (int) $template['id']) { $this->taskLinkModel->remove($link['id']); } } } // Mark the clone: white icon + cannot itself be made recurring; record its source template. $this->taskMetadataModel->save($newId, array( 'recoreco_clone' => 1, 'recoreco_source' => $template['id'], )); // Signal FinanceBuddy (advance the installment). Harmless no-op if nothing listens. $payload = array('source_task_id' => (int) $template['id'], 'new_task_id' => (int) $newId); $this->hook->reference('recoreco:task:spawned', $payload); return $newId; } private function calculator() { if ($this->calc === null) { $this->calc = new OccurrenceCalculator(); } return $this->calc; } }