Method toggleRecurringTaskComplete

src/services/TaskService.ts:1624–1759

(task: TaskInfo, date?: Date)

	}

	async toggleRecurringTaskComplete(task: TaskInfo, date?: Date): Promise<TaskInfo> {
		const file = this.plugin.app.vault.getAbstractFileByPath(task.path);
		if (!(file instanceof TFile)) {
			throw new Error(`Cannot find task file: ${task.path}`);
		}

		// Get fresh task data to ensure we have the latest completion state
		const freshTask = (await this.plugin.cacheManager.getTaskInfo(task.path)) || task;

		if (!freshTask.recurrence) {
			throw new Error("Task is not recurring");
		}

		const recurringPlan = buildRecurringTaskCompletePlan({
			freshTask,
			targetDate: this.getRecurringTaskActionDate(freshTask, date),
			currentTimestamp: getCurrentTimestamp(),
			maintainDueDateOffsetInRecurring: this.plugin.settings.maintainDueDateOffsetInRecurring,
		});
		const { updatedTask, dateStr, newComplete, targetDate } = recurringPlan;

		// Step 2: Persist to file
		await this.plugin.app.fileManager.processFrontMatter(file, (frontmatter) => {
			const completeInstancesField = this.plugin.fieldMapper.toUserField("completeInstances");
			const skippedInstancesField = this.plugin.fieldMapper.toUserField("skippedInstances");
			const dateModifiedField = this.plugin.fieldMapper.toUserField("dateModified");
			const scheduledField = this.plugin.fieldMapper.toUserField("scheduled");
			const dueField = this.plugin.fieldMapper.toUserField("due");
			const recurrenceField = this.plugin.fieldMapper.toUserField("recurrence");
			const googleCalendarExceptionOriginalScheduledField =
				this.plugin.fieldMapper.toUserField("googleCalendarExceptionOriginalScheduled");
			const googleCalendarMovedOriginalDatesField = this.plugin.fieldMapper.toUserField(
				"googleCalendarMovedOriginalDates"
			);

			applyRecurringTaskCompleteFrontmatterChange({
				frontmatter,
				completeInstancesField,
				skippedInstancesField,
				dateModifiedField,
				scheduledField,
				dueField,
				recurrenceField,
				googleCalendarExceptionOriginalScheduledField,
				googleCalendarMovedOriginalDatesField,
				plan: recurringPlan,
			});
		});

		// Step 2b: Reset checkboxes in task body when completing (if setting enabled)
		if (newComplete && this.plugin.settings.resetCheckboxesOnRecurrence) {
			const currentContent = await this.plugin.app.vault.read(file);
			const { frontmatter: frontmatterText, body } = splitFrontmatterAndBody(currentContent);
			const { content: resetBody, changed } = resetMarkdownCheckboxes(body);

			if (changed) {
				const frontmatterBlock =
					frontmatterText !== null ? `---\n${frontmatterText}\n---\n\n` : "";