Phase 16G - Word Count Synchronisation Audit and Completion

PlotLine/wwwroot/js/word-companion-host.js

@@ -204,6 +204,7 @@
     let isAutoRefreshingScene = false;
     let sceneWordCountSyncTimer = null;
     let sceneWordCountSyncInFlight = false;
+    let sceneWordCountSyncPending = false;
     let lastSyncedSceneId = null;
     let lastSyncedWordCount = null;
     let lastLinkedSceneTitle = "";
@@ -3684,7 +3685,17 @@
         }
     };
 
-    const syncSceneProgress = async () => {
+    const finishSceneWordCountSync = () => {
+        sceneWordCountSyncInFlight = false;
+        updateSceneActionButtons();
+        if (sceneWordCountSyncPending) {
+            sceneWordCountSyncPending = false;
+            scheduleSceneWordCountSync(1000);
+        }
+    };
+
+    const syncSceneProgress = async (options = {}) => {
+        const source = options.source || "manual";
         if (!resolvedSceneId) {
             setSyncStatus("No resolved PlotDirector scene.");
             return;
@@ -3708,11 +3719,14 @@
         }
 
         if (sceneWordCountSyncInFlight) {
+            sceneWordCountSyncPending = true;
+            runtimeDebug("Scene sync deferred; sync already running.");
             return;
         }
 
         clearPendingSceneWordCountSync();
         sceneWordCountSyncInFlight = true;
+        sceneWordCountSyncPending = false;
 
         let wordCount = detectedSceneWordCount;
         try {
@@ -3720,31 +3734,34 @@
         } catch (error) {
             setSyncStatus("Sync failed");
             setDiagnostics({ lastError: errorText(error) });
-            sceneWordCountSyncInFlight = false;
-            updateSceneActionButtons();
+            runtimeDebug("Scene sync failed.");
+            finishSceneWordCountSync();
             return;
         }
 
         if (!Number.isInteger(wordCount) || wordCount < 0) {
             setSyncStatus("Sync failed");
-            sceneWordCountSyncInFlight = false;
-            updateSceneActionButtons();
+            runtimeDebug("Scene sync failed.");
+            finishSceneWordCountSync();
             return;
         }
 
         if (lastSyncedSceneId === resolvedSceneId && lastSyncedWordCount === wordCount) {
             setSyncStatus("Synced");
-            sceneWordCountSyncInFlight = false;
-            updateSceneActionButtons();
+            runtimeDebug("Sync skipped (count unchanged).");
+            finishSceneWordCountSync();
             return;
         }
 
+        runtimeDebug("Scene word count changed.");
+
         if (syncSceneProgressButton) {
             syncSceneProgressButton.disabled = true;
             syncSceneProgressButton.textContent = "Syncing...";
         }
 
         setSyncStatus("Syncing...");
+        runtimeDebug(`Scene sync started (${source}).`);
         try {
             const response = await postJson("/api/word-companion/runtime/scene-word-count", {
                 documentGuid,
@@ -3762,15 +3779,16 @@
             setText(syncLastSynced, formatLastSynced(syncedAt));
             setText(runtimeLastSync, formatLastSynced(syncedAt));
             setSyncStatus("Synced");
+            runtimeDebug("Scene sync succeeded.");
         } catch (error) {
             setSyncStatus("Sync failed");
             setDiagnostics({ lastError: errorText(error) });
+            runtimeDebug("Scene sync failed.");
         } finally {
-            sceneWordCountSyncInFlight = false;
             if (syncSceneProgressButton) {
                 syncSceneProgressButton.textContent = "Sync Current Scene";
             }
-            updateSceneActionButtons();
+            finishSceneWordCountSync();
         }
     };
 
@@ -3782,7 +3800,7 @@
 
         sceneWordCountSyncTimer = window.setTimeout(() => {
             sceneWordCountSyncTimer = null;
-            void syncSceneProgress();
+            void syncSceneProgress({ source: "automatic" });
         }, delayMs);
     };
 
@@ -4495,7 +4513,7 @@
     });
     refreshPlotDirectorSceneButton?.addEventListener("click", refreshPlotDirectorScene);
     refreshCurrentSceneButton?.addEventListener("click", refreshCurrentScene);
-    syncSceneProgressButton?.addEventListener("click", syncSceneProgress);
+    syncSceneProgressButton?.addEventListener("click", () => syncSceneProgress({ source: "manual" }));
     saveSceneLinksButton?.addEventListener("click", saveSceneLinks);
     attachPlotDirectorIdsButton?.addEventListener("click", attachPlotDirectorIds);
     createPlotDirectorChapterButton?.addEventListener("click", createPlotDirectorChapter);