Method completeTask

src/api/TaskNotesAPI.ts:1960–1985

(
		path: string,
		options?: CompleteTaskOptions,
		context?: TaskNotesMutationContext
	)

	}

	async completeTask(
		path: string,
		options?: CompleteTaskOptions,
		context?: TaskNotesMutationContext
	): Promise<TaskInfo> {
		const task = await this.requireTask(path);
		const targetStatus =
			options?.status ?? this.plugin.statusManager.getCompletedStatuses()[0] ?? "done";

		if (!this.plugin.statusManager.isCompletedStatus(targetStatus)) {
			throw new TaskNotesApiError(
				"invalid_status",
				`Status "${targetStatus}" is not configured as a completed status`,
				{ status: 400, details: { status: targetStatus } }
			);
		}

		if (!options?.status && this.plugin.statusManager.isCompletedStatus(task.status)) {
			return copyTaskInfo(task);
		}

		const updatedTask = await this.withMutationContext([task.path], context, () =>
			this.plugin.taskService.updateProperty(task, "status", targetStatus)
		);
		return copyTaskInfo(updatedTask);
	}

	async rescheduleTask(
		path: string,