codex-overleaf-link 1.9.11 → 1.9.12

package/README.md

@@ -3,7 +3,7 @@
   <h1>Codex Overleaf Link</h1>
   <p><strong>Empower Overleaf with Codex.</strong></p>
   <p>
-    <img src="https://img.shields.io/badge/version-1.9.11-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-1.9.12-blue" alt="version">
     <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="platform">
     <img src="https://img.shields.io/badge/chrome-MV3-green" alt="chrome manifest v3">
     <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="node version">
@@ -38,14 +38,14 @@ One command installs the managed native host **and** managed extension runtime.
 macOS / Linux:
 
 ```bash
-CODEX_OVERLEAF_REF=v1.9.11 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.sh)"
+CODEX_OVERLEAF_REF=v1.9.12 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.12/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v1.9.11'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.12/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v1.9.12'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -56,7 +56,7 @@ Then, in the `chrome://extensions` tab the script opened: enable **Developer mod
 `npm exec` installs the same managed native host and extension runtime without keeping a source checkout. Use it if you prefer a pinned npm package.
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.12 -- install-managed
 ```
 
 Then, in `chrome://extensions`, enable **Developer mode**, click **Load unpacked**, and select the managed extension path printed by the command. The Release extension zip remains available for explicitly unmanaged/manual installations.
@@ -86,9 +86,9 @@ npm installs, updates, and uninstalls the coordinated managed extension/native p
 
 | Action | Command |
 |--------|---------|
-| Install / update | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@1.9.11 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@1.9.12 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@1.9.12 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed` |
 
 Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
 
@@ -98,13 +98,13 @@ Managed installations discover signed stable updates automatically and apply the
 
 ## GitHub Release Artifacts
 
-The v1.9.11 GitHub Release contains:
+The v1.9.12 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v1.9.11.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v1.9.11.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-1.9.11.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
-- `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.9.11` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.11` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v1.9.12.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v1.9.12.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-1.9.12.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.9.12` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.12` when run directly from the release artifact.
 - `uninstall-native-host.mjs`: native host uninstaller that removes the Chrome Native Messaging manifest, bridge executable, and runtime copy.
 - `nativeHostPlatform.js`, `manifest.js`, `runtimeInstaller.js`: helper files required by the loose uninstaller asset.
 - `SHA256SUMS` and `release-manifest.json`: checksum and artifact metadata for release verification.
@@ -115,7 +115,7 @@ The v1.9.11 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed
+npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed
 ```
 
 The same command works on Windows PowerShell. If you installed from a manual checkout or source installer, you can also run `npm run uninstall:native` inside the repo, use `node ~/.codex-overleaf/source/scripts/uninstall-native-host.mjs` on macOS / Linux, or use `node $env:LOCALAPPDATA\CodexOverleaf\source\scripts\uninstall-native-host.mjs` on Windows PowerShell.
@@ -150,13 +150,13 @@ Then remove the extension from `chrome://extensions`. To delete local data: on m
 Linux Chromium install or update:
 
 ```bash
-CODEX_OVERLEAF_REF=v1.9.11 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v1.9.12 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.12/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed --browser chromium
 ```
 
 ## Features
@@ -291,7 +291,7 @@ Composer attachments are turn-scoped Codex context. Limits are 8 attachments per
 Re-run any [native host installer](#install), reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This also fixes extension/native version mismatch and native protocol mismatch.
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.12 -- install-managed
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -340,8 +340,8 @@ Use this matrix for release-candidate signoff and compatibility reports. Record
 | Browser/channel/version | Google Chrome channel and version. | Google Chrome channel and version. | Google Chrome channel and version. | Chromium channel/package and version. |
 | Install mode | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout; native host installed with `--browser chromium`. |
 | Extension id | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. |
-| Installer/update command | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@1.9.12 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-managed --browser chromium` |
 | Manifest/registry path | `~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.codex.overleaf.json` | `HKCU\Software\Google\Chrome\NativeMessagingHosts\com.codex.overleaf` -> `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime\com.codex.overleaf.json` | `~/.config/google-chrome/NativeMessagingHosts/com.codex.overleaf.json` | `~/.config/chromium/NativeMessagingHosts/com.codex.overleaf.json` |
 | Bridge/runtime/source path | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `%LOCALAPPDATA%\CodexOverleaf\codex-overleaf-bridge.cmd`; runtime `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime`; source `%LOCALAPPDATA%\CodexOverleaf\source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. |
 | Node/Git/Codex/TeX | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. |
@@ -377,7 +377,7 @@ Contributions are welcome. Please open an issue before submitting large changes
 The recommended v1.9 installation owns one stable unpacked-extension directory and a versioned native-host directory:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.12 -- install-managed
 ```
 
 Load the printed extension path once from `chrome://extensions`. Starting with the next signed stable release, Codex Overleaf Link checks GitHub Releases automatically, downloads and verifies the coordinated extension/native-host bundle, waits until every connected Overleaf tab is saved and idle, and then updates both components together. A failed health check restores the previous version automatically.
@@ -387,11 +387,11 @@ The stable updater ignores drafts and prereleases, performs no telemetry, and ca
 The legacy native-only installer remains available for source or unmanaged extension directories:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- install-native
+npm exec --yes codex-overleaf-link@1.9.12 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-native
+npm exec --yes codex-overleaf-link@1.9.12 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Codex Overleaf Link",
-  "version": "1.9.11",
+  "version": "1.9.12",
   "description": "Connect the active Overleaf project to a local Codex bridge.",
   "icons": {
     "16": "assets/icons/icon16.png",

package/extension/runtime-manifest.json

@@ -44,9 +44,11 @@
     "src/content/composerPanel.js",
     "src/content/themeController.js",
     "src/content/markdownText.js",
-    "src/content/diagnosticsController.js",
-    "src/content/runTimelineView.js",
-    "src/content/sessionManager.js",
+      "src/content/diagnosticsController.js",
+      "src/content/runTimelineView.js",
+      "src/content/projectSettingsCoordinator.js",
+      "src/content/sessionMenuView.js",
+      "src/content/sessionManager.js",
     "src/content/applyResultFormatters.js",
     "src/content/modelPicker.js",
     "src/content/recentProjects.js",

package/extension/src/content/contentRuntime.js

@@ -64,7 +64,7 @@
     undefined,
     getCurrentExtensionId()
   ) || 'curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/main/install.sh | bash -s -- --extension-id <chrome-extension-id>';
-  const PAGE_BRIDGE_SCRIPT_REVISION = '2026-05-21-editor-readiness-v10';
+  const PAGE_BRIDGE_SCRIPT_REVISION = '2026-05-21-editor-readiness-v11';
   const PAGE_BRIDGE_CAPABILITY = createPageBridgeCapability();
   const pageBridgeReady = injectPageBridge();
   const {
@@ -172,6 +172,64 @@
     hasUnsafeRuntimePathSegments
   } = markdownText;
 
+  const projectSettingsCoordinator = window.CodexOverleafProjectSettingsCoordinator.create({
+    CodexOverleafTheme: window.CodexOverleafTheme,
+    GovernanceRules,
+    SettingsPanel,
+    closeContextTray: () => closeContextTray(),
+    closeDiagnosticsMenu: () => closeDiagnosticsMenu(),
+    closeDiagnosticsResult: () => closeDiagnosticsResult(),
+    closeModelConfigPopover: () => closeModelConfigPopover(),
+    closeSlashMenu: () => closeSlashMenu(),
+    getCurrentProjectId: () => getCurrentProjectId(),
+    getLocalSkillsPanel: () => localSkillsPanel,
+    getLocale: () => getLocale(),
+    getPanel: () => panel,
+    getPanelRendererInstance: () => panelRendererInstance,
+    getSettingsPanelInstance: () => settingsPanelInstance,
+    getState: () => state,
+    isProjectEditorRoute,
+    refreshStorageUsageSummary: () => refreshStorageUsageSummary(),
+    renderAuditHistoryPanel: () => renderAuditHistoryPanel(),
+    renderRecentProjectsVariant: (...args) => renderRecentProjectsVariant(...args),
+    saveStateSoon: () => saveStateSoon(),
+    setState: next => { state = next; },
+    tr,
+    tx,
+    window
+  });
+  const {
+    applyPanelTheme,
+    clearProjectSettingsStatus,
+    closeCustomInstructionsSettings,
+    closeSkillsView,
+    getCodexOverleafSkillEnabled,
+    getCustomInstructionsForCurrentProject,
+    getGovernanceRulesForCurrentProject,
+    getSkillLoadingSettings,
+    getThemePreference,
+    isCodexOverleafSkillEnabled,
+    normalizeCustomInstructionsByProject,
+    normalizeGovernanceRules,
+    normalizeGovernanceRulesByProject,
+    normalizeProjectPreferenceKey,
+    openCustomInstructionsSettings,
+    openSkillsView,
+    readGovernanceRulesFromSettings,
+    readSkillLoadingSettingsFromSettings,
+    refreshLocalSkills,
+    renderLocalSkillList,
+    setCodexOverleafSkillEnabled,
+    setCustomInstructionsForProject,
+    setGovernanceRulesForCurrentProject,
+    setProjectSettingsStatus,
+    setSkillLoadingSettings,
+    syncCustomInstructionsEditorForProject,
+    syncProjectSettingsEditorForProject,
+    toggleCustomInstructionsSettings,
+    updateSkillsEntrySummary
+  } = projectSettingsCoordinator;
+
   const otWarmMirror = window.CodexOverleafOtWarmMirror.create({
     tr,
     tx,
@@ -702,8 +760,6 @@
   let slashCodexOverleafSkillsLoaded = false;
   let slashCodexOverleafSkillsLoading = false;
   let renderedSlashCommands = new Map();
-  let customInstructionsEditorProjectId = '';
-  let customInstructionsEditorValue = '';
   let runCancellationRequested = false;
   let activePluginConfirmResolve = null;
   const updateIdleClient = root.CodexOverleafUpdateIdle?.create({
@@ -1175,328 +1231,6 @@
     DiagnosticsPanel.closeMenu(diagnosticsPanelInstance);
   }
 
-  function normalizeCustomInstructionsByProject(value) {
-    const result = {};
-    const textMaxChars = 12000;
-    const keyMaxChars = 160;
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-      return result;
-    }
-    for (const rawKey of Object.keys(value)) {
-      const key = typeof rawKey === 'string' ? rawKey.trim() : '';
-      if (!key) {
-        continue;
-      }
-      const normalizedKey = key.length <= keyMaxChars ? key : key.slice(0, keyMaxChars - 1) + '…';
-      const rawText = typeof value[rawKey] === 'string' ? value[rawKey] : '';
-      result[normalizedKey] = rawText.length <= textMaxChars
-        ? rawText
-        : rawText.slice(0, textMaxChars - 1) + '…';
-    }
-    return result;
-  }
-
-  function getCustomInstructionsForCurrentProject() {
-    const projectId = getCurrentProjectId();
-    const normalizedProject = normalizeCustomInstructionsByProject({ [projectId]: '' });
-    const normalizedProjectId = Object.keys(normalizedProject)[0] || '';
-    if (!normalizedProjectId) {
-      return '';
-    }
-    return normalizeCustomInstructionsByProject(state?.customInstructionsByProject)[normalizedProjectId] || '';
-  }
-
-  function setCustomInstructionsForProject(projectId, value) {
-    const normalizedProject = normalizeCustomInstructionsByProject({ [projectId]: value });
-    const normalizedProjectId = Object.keys(normalizedProject)[0] || '';
-    if (!normalizedProjectId) {
-      return;
-    }
-    state = {
-      ...state,
-      customInstructionsByProject: {
-        ...normalizeCustomInstructionsByProject(state?.customInstructionsByProject),
-        [normalizedProjectId]: normalizedProject[normalizedProjectId]
-      }
-    };
-  }
-
-
-  function openCustomInstructionsSettings() {
-    if (!settingsPanelInstance) {
-      return;
-    }
-    closeDiagnosticsMenu();
-    closeDiagnosticsResult();
-    closeModelConfigPopover();
-    closeContextTray();
-    if (typeof closeSlashMenu === 'function') {
-      closeSlashMenu();
-    }
-    clearProjectSettingsStatus();
-    syncCustomInstructionsEditorForProject(getCurrentProjectId(), { force: true });
-    syncProjectSettingsEditorForProject();
-    panelRendererInstance?.setView?.('settings');
-    SettingsPanel.show(settingsPanelInstance);
-    refreshStorageUsageSummary();
-    // A history card left expanded re-loads on every settings open; the
-    // toggle listener only fires on the closed->open transition.
-    if (settingsPanelInstance?.container?.querySelector('[data-history-card]')?.open) {
-      renderAuditHistoryPanel();
-    }
-    if (typeof refreshLocalSkills === 'function') {
-      refreshLocalSkills().catch(error => setProjectSettingsStatus(tx(`Could not list local skills: ${error.message}`, `无法列出本地技能：${error.message}`), 'failed'));
-    }
-  }
-
-  function toggleCustomInstructionsSettings() {
-    if (SettingsPanel.isVisible(settingsPanelInstance)) {
-      closeCustomInstructionsSettings();
-      return;
-    }
-    openCustomInstructionsSettings();
-  }
-
-  function closeCustomInstructionsSettings() {
-    SettingsPanel.hide(settingsPanelInstance);
-    // Back from settings must return to the variant that matches the current
-    // route, not unconditionally to the per-project session view. On a
-    // non-project URL (e.g. /project, /project/, account / billing) the
-    // session view is meaningless and shows an empty per-project conversation
-    // UI; the user expects to return to the Recent-projects variant they
-    // came from. Mirror the SPA route hook's variant dispatch.
-    if (isProjectEditorRoute(window.location)) {
-      panelRendererInstance?.setView?.('session');
-    } else {
-      renderRecentProjectsVariant().catch(() => { /* swallow */ });
-    }
-  }
-
-  // Skills sub-page: reached from the settings screen's Codex Overleaf skills
-  // entry row. Its in-memory view-state is the panel root's data-view="skills".
-  function openSkillsView() {
-    if (!settingsPanelInstance) {
-      return;
-    }
-    panelRendererInstance?.setView?.('skills');
-    refreshLocalSkills().catch(error => setProjectSettingsStatus(tx(`Could not list local skills: ${error.message}`, `无法列出本地技能：${error.message}`), 'failed'));
-  }
-
-  function closeSkillsView() {
-    // The skills screen's back button returns to the settings screen.
-    panelRendererInstance?.setView?.('settings');
-  }
-
-  function updateSkillsEntrySummary() {
-    if (!settingsPanelInstance) {
-      return;
-    }
-    const summary = getSkillLoadingSettings().loadCodexOverleafSkills === false
-      ? tr('codexOverleafSkillsSummaryOff')
-      : tr('codexOverleafSkillsSummaryCount', { count: countEnabledCodexOverleafSkills() });
-    SettingsPanel.setSkillsSummary(settingsPanelInstance, summary);
-  }
-
-  function countEnabledCodexOverleafSkills() {
-    const skills = Array.isArray(state?.codexOverleafSkills) ? state.codexOverleafSkills : [];
-    return skills.reduce((total, skill) => {
-      const id = String(skill?.id || '').trim();
-      return id && isCodexOverleafSkillEnabled(id) ? total + 1 : total;
-    }, 0);
-  }
-
-  function syncCustomInstructionsEditorForProject(projectId = getCurrentProjectId(), options) {
-    const syncOptions = options || {};
-    const input = panel?.querySelector('[data-custom-instructions-input]');
-    if (!input) {
-      return;
-    }
-    const normalizedProject = normalizeCustomInstructionsByProject({ [projectId]: '' });
-    const normalizedProjectId = Object.keys(normalizedProject)[0] || '';
-    const storedValue = normalizedProjectId
-      ? normalizeCustomInstructionsByProject(state?.customInstructionsByProject)[normalizedProjectId] || ''
-      : '';
-    input.placeholder = tr('customInstructionsPlaceholder');
-    const editorIsOpen = panel?.dataset?.view === 'settings' || panel?.dataset?.view === 'skills';
-    const editorIsDirty = normalizedProjectId
-      && customInstructionsEditorProjectId === normalizedProjectId
-      && input.value !== customInstructionsEditorValue;
-    if (!syncOptions.force && editorIsOpen && editorIsDirty) {
-      return;
-    }
-    input.value = storedValue;
-    customInstructionsEditorProjectId = normalizedProjectId;
-    customInstructionsEditorValue = storedValue;
-  }
-
-  function normalizeGovernanceRulesByProject(value) {
-    const result = {};
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-      return result;
-    }
-    for (const rawKey of Object.keys(value)) {
-      const key = normalizeProjectPreferenceKey(rawKey);
-      if (!key) {
-        continue;
-      }
-      result[key] = normalizeGovernanceRules(value[rawKey]);
-    }
-    return result;
-  }
-
-  function normalizeSelectedLocalSkillIdsByProject(value) {
-    const result = {};
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-      return result;
-    }
-    for (const rawKey of Object.keys(value)) {
-      const key = normalizeProjectPreferenceKey(rawKey);
-      if (!key) {
-        continue;
-      }
-      result[key] = normalizeSelectedLocalSkillIds(value[rawKey]);
-    }
-    return result;
-  }
-
-  function normalizeProjectPreferenceKey(value) {
-    const text = String(value || '').trim();
-    return text.length <= 160 ? text : text.slice(0, 159) + '…';
-  }
-
-  function normalizeGovernanceRules(value = {}) {
-    if (GovernanceRules?.normalizeGovernanceRules) {
-      return GovernanceRules.normalizeGovernanceRules(value);
-    }
-    return {
-      readonlyPatterns: normalizePatternTextList(value.readonlyPatterns),
-      writablePatterns: normalizePatternTextList(value.writablePatterns),
-      sensitiveCheckEnabled: value.sensitiveCheckEnabled !== false,
-      sensitiveConfirmAllowed: value.sensitiveConfirmAllowed === true
-    };
-  }
-
-  function normalizePatternTextList(value) {
-    if (Array.isArray(value)) {
-      return value.map(item => String(item || '').trim()).filter(Boolean);
-    }
-    return String(value || '').split(/\r?\n/).map(item => item.trim()).filter(Boolean);
-  }
-
-  function getGovernanceRulesForCurrentProject() {
-    const projectId = normalizeProjectPreferenceKey(getCurrentProjectId());
-    return normalizeGovernanceRulesByProject(state?.governanceRulesByProject)[projectId] || normalizeGovernanceRules({});
-  }
-
-  function setGovernanceRulesForCurrentProject(rules) {
-    const projectId = normalizeProjectPreferenceKey(getCurrentProjectId());
-    if (!projectId) {
-      return;
-    }
-    state = {
-      ...state,
-      governanceRulesByProject: {
-        ...normalizeGovernanceRulesByProject(state?.governanceRulesByProject),
-        [projectId]: normalizeGovernanceRules(rules)
-      }
-    };
-  }
-
-  // Theme: a global preference (dark / light / auto) applied to the panel root
-  // via themeController. 'auto' resolves through prefers-color-scheme; the
-  // disposer detaches the OS-change listener when switching away from auto.
-  let themeAutoDisposer = null;
-  function getThemePreference() {
-    return CodexOverleafTheme.normalizeThemePreference(state?.theme);
-  }
-  function applyPanelTheme(preference) {
-    const normalized = CodexOverleafTheme.normalizeThemePreference(preference);
-    CodexOverleafTheme.applyTheme(normalized, panel);
-    if (themeAutoDisposer) {
-      themeAutoDisposer();
-      themeAutoDisposer = null;
-    }
-    themeAutoDisposer = CodexOverleafTheme.watchAuto(normalized, panel);
-  }
-
-  function getSkillLoadingSettings() {
-    return {
-      loadCodexLocalSkills: state?.loadCodexLocalSkills !== false,
-      loadCodexOverleafSkills: state?.loadCodexOverleafSkills !== false
-    };
-  }
-
-  function setSkillLoadingSettings(settings = {}) {
-    state = {
-      ...state,
-      loadCodexLocalSkills: settings.loadCodexLocalSkills !== false,
-      loadCodexOverleafSkills: settings.loadCodexOverleafSkills !== false
-    };
-  }
-
-  function getCodexOverleafSkillEnabled() {
-    const map = state?.codexOverleafSkillEnabled;
-    return map && typeof map === 'object' && !Array.isArray(map) ? map : {};
-  }
-
-  function isCodexOverleafSkillEnabled(skillId) {
-    const map = getCodexOverleafSkillEnabled();
-    if (!Object.prototype.hasOwnProperty.call(map, skillId)) {
-      return true; // absent means enabled (default true)
-    }
-    return map[skillId] !== false;
-  }
-
-  function setCodexOverleafSkillEnabled(skillId, enabled) {
-    const map = getCodexOverleafSkillEnabled();
-    state = {
-      ...state,
-      codexOverleafSkillEnabled: {
-        ...map,
-        [skillId]: Boolean(enabled)
-      }
-    };
-    saveStateSoon();
-    renderLocalSkillList();
-  }
-
-  function readSkillLoadingSettingsFromSettings() {
-    return SettingsPanel.readState(settingsPanelInstance).skillToggles;
-  }
-
-  function readGovernanceRulesFromSettings() {
-    return normalizeGovernanceRules(SettingsPanel.readState(settingsPanelInstance).governanceRules);
-  }
-
-  function syncProjectSettingsEditorForProject() {
-    SettingsPanel.loadState(settingsPanelInstance, {
-      governanceRules: getGovernanceRulesForCurrentProject(),
-      skillToggles: getSkillLoadingSettings(),
-      theme: getThemePreference(),
-      language: getLocale()
-    });
-    renderLocalSkillList();
-  }
-
-  function setProjectSettingsStatus(text, status = 'info') {
-    SettingsPanel.setStatus(settingsPanelInstance, text, status);
-  }
-
-  function clearProjectSettingsStatus() {
-    SettingsPanel.clearStatus(settingsPanelInstance);
-  }
-
-  async function refreshLocalSkills() {
-    return localSkillsPanel.refreshLocalSkills();
-  }
-
-  function renderLocalSkillList() {
-    localSkillsPanel.renderLocalSkillList();
-    // Keep the settings-screen entry-row summary in sync with the skill list:
-    // it reflects the enabled-skill count (or "Off" when the master is off).
-    updateSkillsEntrySummary();
-  }
-
   function handleComposerPaste(event) {
     composerAttachmentController.handlePaste(event);
   }
@@ -6082,6 +5816,7 @@
     await injectScriptOnce('src/shared/governanceRules.js', 'codex-overleaf-governance-rules-script');
     await injectScriptOnce('src/shared/sensitiveScan.js', 'codex-overleaf-sensitive-scan-script');
     await injectScriptOnce('src/shared/auditRecords.js', 'codex-overleaf-audit-records-script');
+    await injectScriptOnce('src/page/saveState.js', 'codex-overleaf-save-state-script', { force: true });
     await injectScriptOnce('src/page/overleafCapabilities.js', 'codex-overleaf-capabilities-script');
     await injectScriptOnce('src/page/compileBridge.js', 'codex-overleaf-compile-bridge-script');
     await injectScriptOnce('src/page/overleafEditor.js', 'codex-overleaf-editor-script');