Method toggleArchive

src/services/TaskService.ts:1118–1293

* Toggle the archive status of a task

(task: TaskInfo)

	 * Toggle the archive status of a task
	 */
	async toggleArchive(task: TaskInfo): Promise<TaskInfo> {
		const file = this.plugin.app.vault.getAbstractFileByPath(task.path);
		if (!(file instanceof TFile)) {
			throw new Error(`Cannot find task file: ${task.path}`);
		}

		const archiveTag = this.plugin.fieldMapper.getMapping().archiveTag;
		const archivePlan = buildTaskArchiveState(task, archiveTag, getCurrentTimestamp());
		const { updatedTask, isCurrentlyArchived, dateModified } = archivePlan;

		// Step 2: Persist to file
		await this.plugin.app.fileManager.processFrontMatter(file, (frontmatter) => {
			const dateModifiedField = this.plugin.fieldMapper.toUserField("dateModified");
			applyTaskArchiveFrontmatterChange({
				frontmatter,
				archiveTag,
				isCurrentlyArchived,
				dateModified,
				dateModifiedField,
			});
		});

		// Step 2.5: Move file based on archive operation and settings
		let movedFile = file;
		const movePlan = buildTaskArchiveMovePlan({
			isCurrentlyArchived,
			moveArchivedTasks: this.plugin.settings.moveArchivedTasks,
			archiveFolderTemplate: this.plugin.settings.archiveFolder,
			tasksFolderTemplate: this.plugin.settings.tasksFolder,
			fileName: file.name,
			taskData: {
				title: updatedTask.title || "",
				priority: updatedTask.priority,
				status: updatedTask.status,
				contexts: updatedTask.contexts,
				projects: updatedTask.projects,
			},
			processFolderTemplate: (folderTemplate, taskData) =>
				this.processFolderTemplate(folderTemplate, taskData),
		});
		if (movePlan) {
			try {
				await ensureFolderExists(this.plugin.app.vault, movePlan.destinationFolder);

				const existingFile = this.plugin.app.vault.getAbstractFileByPath(movePlan.newPath);
				if (existingFile) {
					throw new Error(
						`A file named "${file.name}" already exists in the ${movePlan.destinationKind} folder "${movePlan.destinationFolder}". Cannot move task to avoid overwriting existing file.`
					);
				}

				await this.plugin.app.fileManager.renameFile(file, movePlan.newPath);

				const resolvedMovedFile = this.plugin.app.vault.getAbstractFileByPath(
					movePlan.newPath
				);
				if (!(resolvedMovedFile instanceof TFile)) {
					throw new Error(`Failed to resolve moved task file: ${movePlan.newPath}`);