Merge remote-tracking branch 'refs/remotes/origin/pr/1925' into HEAD

# Conflicts:
#	docs/releases/unreleased.md
#	src/services/TaskCalendarSyncService.ts

Author: callumalpass

docs/releases/unreleased.md

@@ -33,3 +33,7 @@ Example:
   - Thanks to @martin-forge for reporting and contributing the fix.
 - (#1912) Fixed "Create subtask" inserting the full path of the parent task in the Projects field instead of using the normal Obsidian link text.
   - Thanks to @pkuehne for reporting and @benmartinek for confirming.
+- (#1921) Fixed Google Calendar and auto-archive side effects falling stale after direct task file edits.
+  - Reconciles lifecycle-relevant frontmatter changes through the existing task file update event, with a first-run fingerprint baseline to avoid bulk startup API writes.
+  - Periodic recovery also cleans up indexed Google Calendar events whose task files were deleted or replaced while TaskNotes was running.
+  - Thanks to @martin-forge for reporting and contributing the fix.

src/bootstrap/pluginBootstrap.ts

@@ -59,6 +59,7 @@ import { EVENT_USER_NOTICE, type UserNoticePayload } from "../core/userNotices";
 const tasknotesLogger = createTaskNotesLogger({ tag: "Bootstrap/PluginBootstrap" });
 
 type FileDeletedEventData = { path: string; prevCache?: unknown };
+type FileUpdatedEventData = { path: string; file?: unknown; updatedTask?: TaskInfo };
 
 type EditorWithCodeMirror = {
 	cm?: unknown;
@@ -344,8 +345,30 @@ export function initializeServicesLazily(plugin: TaskNotesPlugin): void {
 					plugin.taskCalendarSyncService = new (
 						await import("../services/TaskCalendarSyncService")
 					).TaskCalendarSyncService(plugin, plugin.googleCalendarService);
+					await plugin.taskCalendarSyncService.initializeExternalFileReconciliation();
 					plugin.taskCalendarSyncService.startRecoveryQueueProcessor();
 
+					plugin.registerEvent(
+						plugin.emitter.on("file-updated", (data: FileUpdatedEventData) => {
+							if (!plugin.taskCalendarSyncService || !data?.path) {
+								return;
+							}
+
+							plugin.taskCalendarSyncService
+								.handleExternalTaskFileUpdated(data.path, data.updatedTask)
+								.catch((error) => {
+									tasknotesLogger.warn(
+										"Failed to reconcile externally updated task with Google Calendar:",
+										{
+											category: "provider",
+											operation: "reconcile-external-task-file-update",
+											error: error,
+										}
+									);
+								});
+						})
+					);
+
 					plugin.registerEvent(
 						plugin.emitter.on("file-deleted", (data: FileDeletedEventData) => {
 							if (!plugin.taskCalendarSyncService) {