Method startTimeTracking

src/services/TaskService.ts:1298–1371

* Start time tracking for a task

(task: TaskInfo)

	 * Start time tracking for a task
	 */
	async startTimeTracking(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}`);
		}

		// Check if already tracking
		const activeSession = this.plugin.getActiveTimeSession(task);
		if (activeSession) {
			throw new Error("Time tracking is already active for this task");
		}

		// Step 1: Construct new state in memory
		const timeTrackingPlan = buildStartTimeTrackingPlan(
			task,
			getCurrentTimestamp(),
			new Date().toISOString()
		);
		const { updatedTask, newEntry } = 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");
			applyStartTimeTrackingFrontmatterChange({
				frontmatter,
				timeEntriesField,
				dateModifiedField,
				newEntry,
				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 start:", {
				category: "stale-data",
				operation: "updating-cache-time-tracking-start",
				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 start
		if (this.webhookNotifier) {
			try {