Method stopTimeTracking

src/services/TaskService.ts:1376–1450

* Stop time tracking for a task

(task: TaskInfo)

	 * Stop time tracking for a task
	 */
	async stopTimeTracking(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 activeSession = this.plugin.getActiveTimeSession(task);
		if (!activeSession) {
			throw new Error("No active time tracking session for this task");
		}

		// Step 1: Construct new state in memory
		const timeTrackingPlan = buildStopTimeTrackingPlan(
			task,
			activeSession,
			getCurrentTimestamp(),
			new Date().toISOString()
		);
		const { updatedTask } = timeTrackingPlan;

		// Step 2: Persist to file
		await this.plugin.app.fileManager.processFrontMatter(file, (frontmatter) => {
			const timeEntriesField = this.plugin.fieldMapper.toUserField("timeEntries");
			const dateModifiedField = this.plugin.fieldMapper.toUserField("dateModified");
			applyStopTimeTrackingFrontmatterChange({
				frontmatter,
				timeEntriesField,
				dateModifiedField,
				activeSession,
				stopTimestamp: timeTrackingPlan.stopTimestamp,
				dateModified: timeTrackingPlan.dateModified,
			});
		});

		// Step 3: Wait for fresh data and update cache
		try {
			// Wait for the metadata cache to have the updated time entries
			if (this.plugin.cacheManager.waitForFreshTaskData) {
				await this.plugin.cacheManager.waitForFreshTaskData(file);
			}
			this.plugin.cacheManager.updateTaskInfoInCache(task.path, updatedTask);
		} catch (cacheError) {
			tasknotesLogger.error("Error updating cache for time tracking stop:", {
				category: "stale-data",
				operation: "updating-cache-time-tracking-stop",
				error: cacheError,
			});
		}

		// Step 4: Notify system of change
		this.plugin.emitter.trigger(EVENT_TASK_UPDATED, {
			path: task.path,
			originalTask: task,
			updatedTask: updatedTask,
		});

		// Trigger webhook for time tracking stop
		if (this.webhookNotifier) {